agent-kb 0.1.0

package/dist/cli/index.d.ts

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { AgentKbEngine, OpenKbDeps, OpenedKb, Config } from '../api/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
+/**
+ * MCP server construction (T23, T38, T40).
+ *
+ * `createMcpServer` is the config-gated entry point: it throws `FEATURE_DISABLED`
+ * when `opts.mcpEnabled` is false, and otherwise constructs a `McpServer` with
+ * the 16 tools registered. The server holds NO state — every tool call is routed
+ * straight to the engine passed in.
+ */
+
+interface CreateMcpServerOpts {
+    engine: AgentKbEngine;
+    mcpEnabled: boolean;
+}
+
+/**
+ * `agent-kb mcp` — config-gated stdio MCP launcher.
+ *
+ * Transport layer ONLY (mirrors `src/cli/index.ts`'s charter). This module wires
+ * the SDK's `StdioServerTransport` to the existing `createMcpServer`, so the MCP
+ * transport becomes reachable via `npx agent-kb mcp`. No business logic lives
+ * here — gating + tool definitions belong to `@/config` and `@/mcp`.
+ *
+ * `runMcp` is async (the stdio transport keeps the event loop alive until the
+ * client disconnects), unlike the synchronous `runCli`. All side-effecting
+ * collaborators (openKb / loadConfig / createServer / connect) are injectable so
+ * the launcher is fully unit-testable without touching real stdio.
+ *
+ * Dependency direction: this file imports `@/mcp` (which transitively pulls the
+ * SDK into `dist/cli/index.js` via tsup). It MUST NOT import `@/cli/index` — the
+ * router (`main`) lives there and imports from here, keeping the edge one-way.
+ */
+
+interface RunMcpDeps {
+    openKb?: (deps: OpenKbDeps) => OpenedKb;
+    loadConfig?: (root: string) => Config;
+    createServer?: (opts: CreateMcpServerOpts) => McpServer;
+    connect?: (server: McpServer) => Promise<void>;
+    out?: NodeJS.WritableStream;
+    err?: NodeJS.WritableStream;
+    cwd?: string;
+}
+
+/**
+ * Agent KB CLI — T22
+ *
+ * Transport layer ONLY. Each subcommand maps to exactly ONE engine method.
+ * No business logic lives here — it's all in the engine.
+ *
+ * Convention: `from: 'node'` — argv is expected to include the node executable
+ * and script name as the first two entries (i.e. full process.argv). Tests pass
+ * `['node', 'agent-kb', ...]`.
+ */
+
+interface RunCliDeps {
+    openKb?: (deps: OpenKbDeps) => OpenedKb;
+    out?: NodeJS.WritableStream;
+    err?: NodeJS.WritableStream;
+    cwd?: string;
+    /**
+     * Override `os.homedir()` — inject a temp path in tests to avoid writing to
+     * the real ~/.claude when testing global skill installation.
+     */
+    homedir?: () => string;
+}
+/**
+ * Build and run the CLI. Returns the exit code — does NOT call process.exit.
+ * argv is expected in full node form: ['node', 'agent-kb', ...args].
+ */
+declare function runCli(argv: string[], deps?: RunCliDeps): number;
+/**
+ * Async entry router. Routes a `mcp` invocation to the async `runMcp` launcher
+ * (which wires the stdio transport and runs until the client disconnects); every
+ * other invocation goes to the synchronous `runCli`. argv is full node form.
+ *
+ * Returns an exit code — does NOT call process.exit. `runCli` stays synchronous;
+ * this wrapper simply lifts its result into the Promise the `mcp` path needs.
+ */
+declare function main(argv: string[], deps?: RunMcpDeps): Promise<number>;
+
+export { type RunCliDeps, main, runCli };