mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-08-24 11:07:14 +00:00
e9dd584792
* feat(api): support global API key from config.yaml (api.global_api_key) Accept a config-defined global API key anywhere a web-UI key is accepted (X-API-Key / Bearer), with no login session and no DB record. Useful for automated deployments and AI agents (HTTP API + MCP). Defaults to empty (disabled); does not require the lbk_ prefix. - templates/config.yaml: add api.global_api_key with security notes - service/apikey.py: verify_api_key checks global key first (constant-time) - docs/API_KEY_AUTH.md: document the global key + security guidance - tests: cover global-key match, prefix-free, fallback-to-db, disabled * feat(mcp): expose LangBot management as an MCP server at /mcp Add an MCP (Model Context Protocol) server so external AI agents can manage a LangBot instance. Reuses the same API-key auth as the HTTP API (including the config.yaml global API key). - pkg/api/mcp/server.py: FastMCP server wrapping the service layer; 21 curated tools across system/bots/pipelines/models/knowledge/mcp-servers/skills - pkg/api/mcp/mount.py: ASGI dispatcher fronting Quart; authenticates /mcp requests with an API key, runs the streamable-HTTP session manager lifespan - controller/main.py: serve the wrapped ASGI app via hypercorn (was run_task) - web: new 'MCP' tab in the API integration dialog showing endpoint, auth, and client config; i18n for 8 locales - tests/manual/mcp_smoke.py: e2e check (401 unauth, list tools, call tools) Tool surface is intentionally curated (not all ~25 route groups) to keep the agent surface small, safe, and maintainable. Extend deliberately. * feat(skills): add in-repo skills/ as the single source of truth Migrate the agent skills + QA/e2e test harness from the (now archived) langbot-app/langbot-skills repo into LangBot/skills/, and add four new skills. Migrated: - langbot-plugin-dev, langbot-testing (e2e), langbot-env-setup, langbot-skills-maintenance, langbot-eba-adapter-dev - the bin/lbs CLI (src/, test/, scripts/, schemas/, qa-agent-docs/) New: - langbot-dev core backend + web development - langbot-deploy Docker/K8s deployment + config.yaml + global API key - langbot-mcp-ops operating the LangBot MCP server (/mcp) - langbot-space-ops operating the Space marketplace MCP server - src/cli.ts repoRoot(): recognize the skills assets root (skills.index.json + bin/lbs) so the CLI works when nested inside the LangBot repo - README.md: unified skill catalog; skills.index.json regenerated Parity with source verified: bin/lbs validate + node test suite match the source repo (only the uncommitted .lbpkg build-artifact fixture differs). * docs(agents): document agent-facing surfaces + API/MCP/skills sync rule * docs(readme): add 'Built for AI Agents' section across all locales Highlight MCP server, in-repo skills (single source of truth), AGENTS.md sync rule, and llms.txt. Cross-link LangBot Space MCP marketplace. * style(mcp): fix ruff format + prettier lint in MCP server and API panel * style(web): prettier format MCP i18n locale entries * docs(skills): note MCP instance control in dev/testing skills All development-guidance skills now point to the LangBot instance MCP server (/mcp) and the Space marketplace MCP server, reusing API keys.
154 lines
5.4 KiB
JavaScript
154 lines
5.4 KiB
JavaScript
#!/usr/bin/env node
|
|
|
|
import { spawn } from "node:child_process";
|
|
import { existsSync } from "node:fs";
|
|
import { mkdir, writeFile } from "node:fs/promises";
|
|
import { join, resolve } from "node:path";
|
|
import { env } from "node:process";
|
|
|
|
function timestampSlug(date = new Date()) {
|
|
return date.toISOString().replace(/\.\d{3}Z$/, "Z").replace(/[^0-9A-Za-z]+/g, "-").replace(/^-|-$/g, "");
|
|
}
|
|
|
|
function localIsoWithOffset(date = new Date()) {
|
|
const offsetMinutes = -date.getTimezoneOffset();
|
|
const sign = offsetMinutes >= 0 ? "+" : "-";
|
|
const absolute = Math.abs(offsetMinutes);
|
|
const pad = (value) => String(value).padStart(2, "0");
|
|
return [
|
|
`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`,
|
|
`T${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}.${String(date.getMilliseconds()).padStart(3, "0")}`,
|
|
`${sign}${pad(Math.floor(absolute / 60))}:${pad(absolute % 60)}`,
|
|
].join("");
|
|
}
|
|
|
|
function run(command, timeoutMs, childEnv) {
|
|
return new Promise((resolveDone) => {
|
|
const child = spawn(command.executable, command.args, {
|
|
cwd: command.cwd,
|
|
detached: true,
|
|
env: childEnv,
|
|
stdio: ["ignore", "pipe", "pipe"],
|
|
});
|
|
let stdout = "";
|
|
let stderr = "";
|
|
let timedOut = false;
|
|
const timeout = setTimeout(() => {
|
|
timedOut = true;
|
|
try {
|
|
process.kill(-child.pid, "SIGTERM");
|
|
} catch {
|
|
child.kill("SIGTERM");
|
|
}
|
|
}, timeoutMs);
|
|
child.stdout.setEncoding("utf8");
|
|
child.stderr.setEncoding("utf8");
|
|
child.stdout.on("data", (chunk) => {
|
|
stdout += chunk;
|
|
});
|
|
child.stderr.on("data", (chunk) => {
|
|
stderr += chunk;
|
|
});
|
|
child.on("error", (error) => {
|
|
clearTimeout(timeout);
|
|
resolveDone({ stdout, stderr, error, timedOut, status: null, signal: null });
|
|
});
|
|
child.on("close", (status, signal) => {
|
|
clearTimeout(timeout);
|
|
resolveDone({ stdout, stderr, error: null, timedOut, status, signal });
|
|
});
|
|
});
|
|
}
|
|
|
|
const script = `
|
|
import asyncio
|
|
import aiosqlite
|
|
|
|
async def main():
|
|
async with aiosqlite.connect(':memory:') as db:
|
|
await db.execute('create table t(id integer primary key)')
|
|
await db.commit()
|
|
print('AIOSQLITE_READY')
|
|
|
|
asyncio.run(main())
|
|
`;
|
|
|
|
async function main() {
|
|
const root = resolve(env.LBS_ROOT || process.cwd());
|
|
const caseId = "agent-runner-async-db-readiness";
|
|
const runId = env.LBS_RUN_ID || `${timestampSlug()}-${caseId}`;
|
|
const evidenceDir = resolve(env.LBS_EVIDENCE_DIR || join(root, "reports", "evidence", runId));
|
|
await mkdir(evidenceDir, { recursive: true });
|
|
const startedAt = new Date();
|
|
const langbotRepo = resolve(root, env.LANGBOT_REPO || "../LangBot");
|
|
const stdoutLog = join(evidenceDir, "probe-stdout.log");
|
|
const stderrLog = join(evidenceDir, "probe-stderr.log");
|
|
const automationResultJson = join(evidenceDir, "automation-result.json");
|
|
const resultJson = join(evidenceDir, "result.json");
|
|
const timeoutMs = Number(env.LANGBOT_ASYNC_DB_READINESS_TIMEOUT_MS || "5000");
|
|
const command = { executable: "rtk", args: ["uv", "run", "python", "-c", script], cwd: langbotRepo };
|
|
const result = {
|
|
source: "automation",
|
|
probe: "aiosqlite-readiness",
|
|
case_id: caseId,
|
|
run_id: runId,
|
|
started_at: startedAt.toISOString(),
|
|
started_at_local: localIsoWithOffset(startedAt),
|
|
finished_at: "",
|
|
finished_at_local: "",
|
|
duration_ms: 0,
|
|
status: "fail",
|
|
reason: "",
|
|
repo_path: langbotRepo,
|
|
command,
|
|
timeout_ms: timeoutMs,
|
|
exit_status: null,
|
|
signal: null,
|
|
evidence: { stdout_log: stdoutLog, stderr_log: stderrLog, automation_result_json: automationResultJson, result_json: resultJson },
|
|
evidence_collected: ["filesystem"],
|
|
};
|
|
try {
|
|
if (!existsSync(langbotRepo)) {
|
|
result.status = "env_issue";
|
|
result.reason = `LANGBOT_REPO/default ../LangBot did not resolve: ${langbotRepo}`;
|
|
} else {
|
|
const proc = await run(command, timeoutMs, {
|
|
...process.env,
|
|
UV_CACHE_DIR: env.UV_CACHE_DIR || join(evidenceDir, ".uv-cache"),
|
|
});
|
|
await writeFile(stdoutLog, proc.stdout, "utf8");
|
|
await writeFile(stderrLog, proc.stderr, "utf8");
|
|
result.exit_status = proc.status;
|
|
result.signal = proc.signal;
|
|
if (proc.error) {
|
|
result.status = "env_issue";
|
|
result.reason = proc.error.message;
|
|
} else if (proc.timedOut) {
|
|
result.status = "env_issue";
|
|
result.reason = `aiosqlite readiness timed out after ${timeoutMs}ms`;
|
|
} else if (proc.status === 0 && proc.stdout.includes("AIOSQLITE_READY")) {
|
|
result.status = "pass";
|
|
result.reason = "aiosqlite readiness passed";
|
|
} else {
|
|
result.status = "env_issue";
|
|
result.reason = `aiosqlite readiness exited with status ${proc.status}`;
|
|
}
|
|
}
|
|
} catch (error) {
|
|
result.status = "env_issue";
|
|
result.reason = error instanceof Error ? error.message : String(error);
|
|
} finally {
|
|
const finishedAt = new Date();
|
|
result.finished_at = finishedAt.toISOString();
|
|
result.finished_at_local = localIsoWithOffset(finishedAt);
|
|
result.duration_ms = finishedAt.getTime() - startedAt.getTime();
|
|
const resultText = `${JSON.stringify(result, null, 2)}\n`;
|
|
await writeFile(automationResultJson, resultText, "utf8");
|
|
await writeFile(resultJson, resultText, "utf8");
|
|
console.log(JSON.stringify(result, null, 2));
|
|
}
|
|
process.exit(result.status === "pass" ? 0 : result.status === "env_issue" ? 2 : 1);
|
|
}
|
|
|
|
await main();
|