ctxr-cli 0.34.0 → 0.35.0

package/dist/core/mcp/tools/index.js

@@ -1,22 +1,38 @@
 import { packagedTemplate } from '../../templates.js';
-import { asToolRefusal, capture, CAPTURE_INPUT_SCHEMA, parseCaptureArgs } from './capture.js';
-import { EDIT_INPUT_SCHEMA, editTool, parseEditArgs, parseWriteArgs, WRITE_INPUT_SCHEMA, writeTool } from './edit.js';
+import { packagedCliEntry } from '../cli-runner.js';
+import { asToolRefusal } from '../sessions.js';
+import { TOOL_REGISTRY } from '../tool-map.js';
+import { capture, CAPTURE_INPUT_SCHEMA, parseCaptureArgs } from './capture.js';
+import { CTXR_INPUT_SCHEMA, CTXR_WRITE_INPUT_SCHEMA, ctxrTool, ctxrWriteTool, parseCliArgs, renderCli } from './cli.js';
+import { DELETE_INPUT_SCHEMA, deleteTool, EDIT_INPUT_SCHEMA, editTool, MOVE_INPUT_SCHEMA, moveTool, parseDeleteArgs, parseEditArgs, parseMoveArgs, parseWriteArgs, WRITE_INPUT_SCHEMA, writeTool, } from './edit.js';
 import { GLOB_INPUT_SCHEMA, globTool, GREP_INPUT_SCHEMA, grepTool, parseGlobArgs, parseGrepArgs, parseReadArgs, READ_INPUT_SCHEMA, readTool, renderGlob, renderGrep, renderRead, } from './files.js';
 import { find, FIND_INPUT_SCHEMA, parseFindArgs } from './find.js';
 import { GATHER_INPUT_SCHEMA, gatherWithBodies, parseGatherArgs } from './gather.js';
+import { SESSION_DISCARD_INPUT_SCHEMA, SESSION_LIST_INPUT_SCHEMA, SESSION_REBASE_INPUT_SCHEMA, SESSION_START_INPUT_SCHEMA, SESSION_STATUS_INPUT_SCHEMA, SESSION_SUBMIT_INPUT_SCHEMA, sessionDiscardTool, sessionListTool, sessionRebaseTool, sessionStartTool, sessionStatusTool, sessionSubmitTool, } from './sessions.js';
 /**
  * The remote surface's tool set and the prose that describes it
  * (templates/mcp/, shipped-prose-lives-in-templates). Built per request from
- * the server's current state. Reads go through `view.read`, so each sees one
- * commit and names it; writes go through the one mutex (design.md D9, D13).
+ * the server's current state. Reads of the served commit go through
+ * `view.read`, so each sees one commit and names it; every write goes through
+ * the one mutex (serve-the-store-over-mcp design.md D9, D13).
+ *
+ * serve-the-session-lifecycle-to-chat-apps D8, D9 and revision 6: the
+ * registry is `tool-map.ts`'s — this module supplies each listed tool's
+ * implementation and annotations, and refuses to build when the two differ.
  */
 export function serverInstructions(storeName) {
     return packagedTemplate('mcp', 'server-instructions').replaceAll('__STORE_NAME__', storeName);
 }
-/** Writes surface a WriteRefusal as a refusal the client model can read. */
-async function writing(ctx, fn) {
+/** D8: changes nothing; asking twice answers the same. */
+const READ_ONLY = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+/** D8: changes a session or the forge, reviewably: nothing it does is lost or lands without a decision. */
+const WRITES = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+/** D8: removes work. */
+const DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: false };
+/** A refusal from the core or the write side, readable by the client model; writes one at a time. */
+async function refusing(fn) {
     try {
-        return await ctx.mutex.run(fn);
+        return await fn();
     }
     catch (err) {
         throw asToolRefusal(err);
@@ -24,106 +40,193 @@ async function writing(ctx, fn) {
 }
 export function buildTools(ctx) {
     const read = (fn) => ctx.view.read(ctx.syncDeps, fn);
-    return [
-        {
-            name: 'find',
+    const writing = (fn) => refusing(() => ctx.mutex.run(fn));
+    const files = { view: ctx.view, syncDeps: ctx.syncDeps, write: ctx.write };
+    const cli = { ...files, entry: ctx.cliEntry ?? packagedCliEntry(), timeoutMs: ctx.cliTimeoutMs };
+    const prose = (name) => packagedTemplate('mcp', name);
+    const implementations = {
+        find: {
             title: 'Find in the store',
-            description: packagedTemplate('mcp', 'find'),
+            description: prose('find'),
             inputSchema: FIND_INPUT_SCHEMA,
             scope: 'read',
-            readOnly: true,
+            annotations: READ_ONLY,
             run: (args) => {
                 const parsed = parseFindArgs(args);
                 return read((snapshot) => find(snapshot, parsed, ctx.baseUrl));
             },
         },
-        {
-            name: 'gather',
+        gather: {
             title: 'Gather related notes',
-            description: packagedTemplate('mcp', 'gather'),
+            description: prose('gather'),
             inputSchema: GATHER_INPUT_SCHEMA,
             scope: 'read',
-            readOnly: true,
+            annotations: READ_ONLY,
             run: (args) => {
                 const parsed = parseGatherArgs(args);
                 return read((snapshot) => gatherWithBodies(snapshot, parsed));
             },
         },
-        {
-            name: 'Read',
+        Read: {
             title: 'Read a file',
-            description: packagedTemplate('mcp', 'Read'),
+            description: prose('Read'),
             inputSchema: READ_INPUT_SCHEMA,
             scope: 'read',
-            readOnly: true,
+            annotations: READ_ONLY,
             render: renderRead,
-            run: (args, principal) => {
-                const parsed = parseReadArgs(args);
-                return read((snapshot) => readTool(snapshot, ctx.write, principal.email, parsed));
-            },
+            run: (args, principal) => refusing(() => readTool(files, principal.email, parseReadArgs(args))),
         },
-        {
-            name: 'Grep',
+        Grep: {
             title: 'Search file contents',
-            description: packagedTemplate('mcp', 'Grep'),
+            description: prose('Grep'),
             inputSchema: GREP_INPUT_SCHEMA,
             scope: 'read',
-            readOnly: true,
+            annotations: READ_ONLY,
             render: renderGrep,
-            run: (args) => {
-                const parsed = parseGrepArgs(args);
-                return read((snapshot) => grepTool(snapshot, parsed));
-            },
+            run: (args, principal) => refusing(() => grepTool(files, principal.email, parseGrepArgs(args))),
         },
-        {
-            name: 'Glob',
+        Glob: {
             title: 'Find files by name',
-            description: packagedTemplate('mcp', 'Glob'),
+            description: prose('Glob'),
             inputSchema: GLOB_INPUT_SCHEMA,
             scope: 'read',
-            readOnly: true,
+            annotations: READ_ONLY,
             render: renderGlob,
-            run: (args) => {
-                const parsed = parseGlobArgs(args);
-                return read((snapshot) => globTool(snapshot, parsed));
-            },
+            run: (args, principal) => refusing(() => globTool(files, principal.email, parseGlobArgs(args))),
         },
-        {
-            name: 'capture',
+        capture: {
             title: 'Capture into the store',
-            description: packagedTemplate('mcp', 'capture'),
+            description: prose('capture'),
             inputSchema: CAPTURE_INPUT_SCHEMA,
             scope: 'capture',
-            readOnly: false,
+            annotations: WRITES,
             run: (args, principal) => {
                 const parsed = parseCaptureArgs(args);
-                return writing(ctx, () => capture({ view: ctx.view, syncDeps: ctx.syncDeps, write: ctx.write }, principal.email, parsed));
+                return writing(() => capture(files, principal.email, parsed));
             },
         },
-        {
-            name: 'Edit',
-            title: 'Edit a note',
-            description: packagedTemplate('mcp', 'Edit'),
+        session_start: {
+            title: 'Start a session',
+            description: prose('session_start'),
+            inputSchema: SESSION_START_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: WRITES,
+            run: (args, principal) => writing(() => sessionStartTool(ctx.write, principal.email, args)),
+        },
+        session_list: {
+            title: 'List your sessions',
+            description: prose('session_list'),
+            inputSchema: SESSION_LIST_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: READ_ONLY,
+            run: (_args, principal) => refusing(() => sessionListTool(ctx.write, principal.email)),
+        },
+        session_status: {
+            title: 'Re-scan a session',
+            description: prose('session_status'),
+            inputSchema: SESSION_STATUS_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: READ_ONLY,
+            run: (args, principal) => refusing(() => sessionStatusTool(ctx.write, principal.email, args)),
+        },
+        Edit: {
+            title: 'Edit a file in a session',
+            description: prose('Edit'),
             inputSchema: EDIT_INPUT_SCHEMA,
             scope: 'edit',
-            readOnly: false,
+            annotations: WRITES,
             run: (args, principal) => {
                 const parsed = parseEditArgs(args);
-                return writing(ctx, () => editTool({ view: ctx.view, syncDeps: ctx.syncDeps, write: ctx.write }, principal.email, parsed));
+                return writing(() => editTool(ctx.write, principal.email, parsed));
             },
         },
-        {
-            name: 'Write',
-            title: 'Create a note',
-            description: packagedTemplate('mcp', 'Write'),
+        Write: {
+            title: 'Create a file in a session',
+            description: prose('Write'),
             inputSchema: WRITE_INPUT_SCHEMA,
             scope: 'edit',
-            readOnly: false,
+            annotations: WRITES,
             run: (args, principal) => {
                 const parsed = parseWriteArgs(args);
-                return writing(ctx, () => writeTool({ view: ctx.view, syncDeps: ctx.syncDeps, write: ctx.write }, principal.email, parsed));
+                return writing(() => writeTool(ctx.write, principal.email, parsed));
             },
         },
-    ];
+        Move: {
+            title: 'Move a file in a session',
+            description: prose('Move'),
+            inputSchema: MOVE_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: WRITES,
+            run: (args, principal) => {
+                const parsed = parseMoveArgs(args);
+                return writing(() => moveTool(ctx.write, principal.email, parsed));
+            },
+        },
+        Delete: {
+            title: 'Delete a file in a session',
+            description: prose('Delete'),
+            inputSchema: DELETE_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: DESTRUCTIVE,
+            run: (args, principal) => {
+                const parsed = parseDeleteArgs(args);
+                return writing(() => deleteTool(ctx.write, principal.email, parsed));
+            },
+        },
+        session_submit: {
+            title: 'Submit a session for approval',
+            description: prose('session_submit'),
+            inputSchema: SESSION_SUBMIT_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: WRITES,
+            run: (args, principal) => writing(() => sessionSubmitTool(ctx.write, principal.email, args)),
+        },
+        session_rebase: {
+            title: 'Rebase a session',
+            description: prose('session_rebase'),
+            inputSchema: SESSION_REBASE_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: WRITES,
+            run: (args, principal) => writing(() => sessionRebaseTool(ctx.write, principal.email, args)),
+        },
+        session_discard: {
+            title: 'Discard a session',
+            description: prose('session_discard'),
+            inputSchema: SESSION_DISCARD_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: DESTRUCTIVE,
+            run: (args, principal) => writing(() => sessionDiscardTool(ctx.write, principal.email, args)),
+        },
+        ctxr: {
+            title: 'Run a read-only ctxr command',
+            description: prose('ctxr'),
+            inputSchema: CTXR_INPUT_SCHEMA,
+            scope: 'read',
+            annotations: READ_ONLY,
+            render: renderCli,
+            run: (args, principal) => {
+                const parsed = parseCliArgs(args, false);
+                return refusing(() => ctxrTool(cli, principal.email, parsed));
+            },
+        },
+        ctxr_write: {
+            title: 'Run a writing ctxr command in a session',
+            description: prose('ctxr_write'),
+            inputSchema: CTXR_WRITE_INPUT_SCHEMA,
+            scope: 'edit',
+            annotations: WRITES,
+            render: renderCli,
+            run: (args, principal) => {
+                const parsed = parseCliArgs(args, true);
+                return writing(() => ctxrWriteTool(cli, principal.email, parsed));
+            },
+        },
+    };
+    const unregistered = Object.keys(implementations).filter((name) => !TOOL_REGISTRY.some((t) => t.name === name));
+    const unimplemented = TOOL_REGISTRY.filter((t) => implementations[t.name] === undefined).map((t) => t.name);
+    if (unregistered.length > 0 || unimplemented.length > 0) {
+        throw new Error(`the MCP tool registry and its implementations differ: unregistered ${unregistered.join(', ') || 'none'}; unimplemented ${unimplemented.join(', ') || 'none'}`);
+    }
+    return TOOL_REGISTRY.map((entry) => ({ name: entry.name, ...implementations[entry.name] }));
 }
 //# sourceMappingURL=index.js.map

package/dist/core/mcp/tools/index.js.map

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

package/dist/core/mcp/tools/sessions.d.ts

@@ -0,0 +1,145 @@
+import { type WriteDeps } from '../sessions.js';
+/**
+ * serve-the-session-lifecycle-to-chat-apps D3 (remote-access spec, *A member
+ * works in named sessions of their own*, *`session_submit` validates, commits
+ * as the member and opens the pull request*, *A member's session can be
+ * rebased or discarded*): one tool per `ctxr session <verb>`, each calling the
+ * same core the command calls, with the command's options as fields. The MCP
+ * layer adds the ownership check, the member as commit author, and the
+ * confinement to sessions started over MCP. Server paths never leave: a
+ * session is named by its directory and addressed by its store-relative root.
+ */
+/** D3: `session_status`'s unified diff is bounded to this many bytes. */
+export declare const STATUS_DIFF_MAX_BYTES: number;
+export declare const SESSION_START_INPUT_SCHEMA: {
+    readonly type: 'object';
+    readonly properties: {
+        readonly label: {
+            readonly type: 'string';
+            readonly description: 'A short name for what the session is for, e.g. "kestrel-launch"; it becomes part of the branch and directory name. Optional.';
+        };
+    };
+};
+export interface SessionStartResult {
+    session: string;
+    root: string;
+    branch: string;
+    label: string | null;
+    message: string;
+}
+/** Under the write mutex. */
+export declare function sessionStartTool(write: WriteDeps, email: string, args: Record<string, unknown>): Promise<SessionStartResult>;
+export declare const SESSION_LIST_INPUT_SCHEMA: {
+    readonly type: 'object';
+    readonly properties: {};
+};
+export interface SessionRow {
+    session: string;
+    root: string;
+    branch: string;
+    label: string | null;
+    /** `capture` for a session the capture tool opened, which the session cap does not count. */
+    kind: 'session' | 'capture';
+    started_at: string | null;
+    uncommitted: boolean;
+    ahead: number;
+    pull_request: {
+        number: number | null;
+        state: 'open' | 'unknown';
+        url: string | null;
+    } | null;
+    /** With change approval declared: the decision `ctxr review list` reports for the open pull request. */
+    review: {
+        state: string;
+        comment: string | null;
+    } | null;
+}
+export declare function sessionListTool(write: WriteDeps, email: string): Promise<{
+    sessions: SessionRow[];
+    forge_reachable: boolean;
+    limit: number;
+}>;
+export declare const SESSION_STATUS_INPUT_SCHEMA: {
+    readonly type: 'object';
+    readonly properties: {
+        readonly session: {
+            readonly type: 'string';
+            readonly description: 'The session\'s directory name, as session_start or session_list gave it.';
+        };
+        readonly diff: {
+            readonly type: 'boolean';
+            readonly description: "Also return the unified diff of uncommitted work, up to 100 KB.";
+        };
+    };
+    readonly required: readonly ['session'];
+};
+export declare function sessionStatusTool(write: WriteDeps, email: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare const SESSION_SUBMIT_INPUT_SCHEMA: {
+    readonly type: 'object';
+    readonly properties: {
+        readonly session: {
+            readonly type: 'string';
+            readonly description: 'The session\'s directory name, as session_start or session_list gave it.';
+        };
+        readonly branch: {
+            readonly type: 'string';
+            readonly description: 'The branch name the pull request carries, e.g. "notes/kestrel-intro"; the session\'s branch is renamed to it.';
+        };
+        readonly message: {
+            readonly type: 'string';
+            readonly description: 'The commit message: a subject line, a blank line, then what changed and why.';
+        };
+        readonly title: {
+            readonly type: 'string';
+            readonly description: 'The pull request title.';
+        };
+        readonly body: {
+            readonly type: 'string';
+            readonly description: 'The pull request body: why, what changed, route, verification and follow-ups. The Pages and Knowledge changes sections are appended for you; leave them out.';
+        };
+    };
+    readonly required: readonly ['session', 'branch', 'message', 'title', 'body'];
+};
+/** Under the write mutex. */
+export declare function sessionSubmitTool(write: WriteDeps, email: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare const SESSION_REBASE_INPUT_SCHEMA: {
+    readonly type: 'object';
+    readonly properties: {
+        readonly session: {
+            readonly type: 'string';
+            readonly description: 'The session\'s directory name, as session_start or session_list gave it.';
+        };
+        readonly continue: {
+            readonly type: 'boolean';
+            readonly description: 'Stage the resolved files and continue the rebase in progress.';
+        };
+        readonly abort: {
+            readonly type: 'boolean';
+            readonly description: 'Abort the rebase in progress and restore the session as it was.';
+        };
+    };
+    readonly required: readonly ['session'];
+};
+/** Under the write mutex. A conflict is a result, not a refusal: the conflicting files are returned with both sides. */
+export declare function sessionRebaseTool(write: WriteDeps, email: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+export declare const SESSION_DISCARD_INPUT_SCHEMA: {
+    readonly type: 'object';
+    readonly properties: {
+        readonly session: {
+            readonly type: 'string';
+            readonly description: 'The session\'s directory name, as session_start or session_list gave it.';
+        };
+        readonly force: {
+            readonly type: 'boolean';
+            readonly description: 'Discard uncommitted changes and commits the remote branch lacks. Without it, a session holding unpublished work is refused.';
+        };
+        readonly close_pull_request: {
+            readonly type: 'boolean';
+            readonly description: "Also close the session's open pull request.";
+        };
+    };
+    readonly required: readonly ['session'];
+};
+/** Under the write mutex. Destructive. */
+export declare function sessionDiscardTool(write: WriteDeps, email: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/core/mcp/tools/sessions.d.ts.map

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