aicodeman 1.41.0 → 1.42.0

package/dist/mcp-server.d.ts

@@ -0,0 +1,114 @@
+import { type AgentContext, type ApiRequest } from './cli-agent.js';
+/** Revisions served with per-request `_meta` (no handshake). */
+export declare const MODERN_PROTOCOL_VERSIONS: readonly ["2026-07-28"];
+/** Revisions served after an `initialize` handshake, newest first. */
+export declare const LEGACY_PROTOCOL_VERSIONS: readonly ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+/** JSON-RPC error codes this server emits. */
+export declare const RPC_ERROR: {
+    readonly parse: -32700;
+    readonly invalidRequest: -32600;
+    readonly methodNotFound: -32601;
+    readonly invalidParams: -32602;
+    readonly internal: -32603;
+    readonly unsupportedProtocolVersion: -32022;
+};
+/** Default wait: under Codex's 60 s MCP tool timeout, so a default call never gets cut off. */
+export declare const DEFAULT_WAIT_MS = 45000;
+/** The server's own ceiling for one wait (`MAX_WAIT_MS` in config/agent-wait.ts). */
+export declare const MAX_WAIT_MS = 600000;
+/** Cap on text handed back to the model, so one read cannot flood its context. */
+export declare const MAX_OUTPUT_CHARS = 40000;
+export interface McpConfig {
+    /** Codeman server URL; undefined = not configured, and every tool says how to fix it. */
+    apiUrl?: string;
+    /** Why the URL given was refused, when one was given. */
+    urlError?: string;
+    /** This process's own session, when it runs inside a Codeman pane. */
+    selfId?: string;
+    auth?: AgentContext['auth'];
+    /** `--allow-any-session`: prompt, interrupt and delete sessions this server did not start. */
+    allowAnySession: boolean;
+    version: string;
+}
+/**
+ * Resolve the configuration from flags and the environment. Never guesses a URL: only
+ * `--url` or `CODEMAN_API_URL` set one. A session id counts only inside a Codeman pane
+ * (`CODEMAN_MUX=1`); a desktop client's environment has no session of its own.
+ */
+export declare function resolveMcpConfig(options: {
+    url?: string;
+    allowAnySession?: boolean;
+    version: string;
+}, env?: NodeJS.ProcessEnv, envFile?: () => Record<string, string>): McpConfig;
+export interface ToolDefinition {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint?: boolean;
+        idempotentHint?: boolean;
+        openWorldHint: boolean;
+    };
+}
+/**
+ * The tools, in a fixed order (the spec asks for deterministic `tools/list` output, which
+ * also keeps a client's prompt cache warm). `modes` are the run modes start_session
+ * offers, from the CLI registry.
+ */
+export declare function buildToolDefinitions(modes: readonly string[]): ToolDefinition[];
+/** Run modes start_session offers: every enabled registry entry, in registry order. */
+export declare function registryModes(): string[];
+export interface ToolResult {
+    text: string;
+    structured?: Record<string, unknown>;
+    isError?: boolean;
+}
+/** A refusal or failure the model can act on: becomes an `isError` result, never a JSON-RPC error. */
+export declare class ToolError extends Error {
+}
+export interface ToolRunnerDeps {
+    config: McpConfig;
+    request: ApiRequest;
+    /** Ids of sessions this process started: the default allowlist for prompting and deleting. */
+    started: Set<string>;
+    /** Exactly-once tag for this process's input (`seq` is the clock, kept strictly increasing). */
+    clientId: string;
+    now?: () => number;
+}
+export declare function createToolRunner(deps: ToolRunnerDeps): {
+    has(name: string): boolean;
+    run(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<ToolResult>;
+};
+export interface McpServerOptions {
+    config: McpConfig;
+    /** One JSON-RPC message out (a line on stdout in production). */
+    write: (message: Record<string, unknown>) => void;
+    log?: (line: string) => void;
+    request?: ApiRequest;
+    /** Run modes start_session offers; defaults to the registry's enabled entries. */
+    modes?: readonly string[];
+    now?: () => number;
+}
+/**
+ * The protocol core, transport-free so tests drive it message by message. Requests run
+ * concurrently (a long wait must not hold up a list), each answered once, by id.
+ */
+export declare function createMcpServer(options: McpServerOptions): {
+    /** One stdin line. Resolves when that message is fully handled. */
+    handleLine(line: string): Promise<void>;
+    /** Stop: abort every in-flight call and write nothing more. */
+    close(): void;
+    inflightCount(): number;
+};
+/**
+ * Serve MCP on this process's stdin/stdout until stdin closes (the client's shutdown
+ * signal), then abort whatever is still in flight.
+ */
+export declare function runMcpStdio(config: McpConfig, io?: {
+    stdin: NodeJS.ReadableStream;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+}): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}