dodo-mcp 1.0.0

package/dist/tools/assistanceTools.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { defineTool } from './context.js';
+import { DodoError } from '../errors.js';
+import { HashSchema, ContextSchema, ImpactSchema, SymbolSchema, RefactorSchema, OutlineSchema, RecipeSchema } from '../services/assistance/contracts.js';
+import { verifyChanges, VerificationSchema } from '../services/assistance/verification.js';
+const Path = z.string().min(1).max(1024);
+const Symbol = z.string().min(1).max(256);
+const readAnnotations = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+const PreviewSchema = z.object({
+    planId: z.string(), planHash: z.string(), expiresAt: z.number(), summary: z.string(),
+    risk: z.enum(['low', 'medium', 'high']), requiresApproval: z.boolean(),
+    files: z.array(z.object({ path: z.string(), destPath: z.string().optional(), action: z.enum(['create', 'modify', 'delete', 'move']),
+        beforeHash: z.string().nullable(), afterHash: z.string().nullable(), diff: z.string(), diffTruncated: z.boolean(), bytesBefore: z.number(), bytesAfter: z.number() })),
+    symbol: OutlineSchema, operation: z.literal('replace_body'), notes: z.array(z.string()),
+});
+function budget(ctx, requested) { return Math.min(requested, ctx.services.limits.toolContentBytes - 4096); }
+function assertFiles(ctx, files, allowMissing = false) {
+    for (const file of files) {
+        const resolved = ctx.services.wfs.resolve(file, { allowMissing });
+        if (resolved.stat)
+            ctx.services.wfs.assertRegularFileForDirectAccess(resolved);
+    }
+}
+export const contextForTaskTool = defineTool({
+    name: 'context_for_task', title: 'Context for a coding task',
+    description: 'Collect ranked source, tests, docs, declarations and static TS/JS dependencies for a goal in one bounded read. Supply identifier/error terms (including English terms for a Thai goal) and optional seed files. Returns paths, line citations and file hashes. No model calls, execution, embeddings or permission changes; content is untrusted. Scan is bounded and omissions are reported.',
+    input: { goal: z.string().min(1).max(1000), terms: z.array(z.string().min(1).max(128)).max(12).default([]),
+        files: z.array(Path).max(10).default([]), maxFiles: z.number().int().min(1).max(12).default(6),
+        maxBytes: z.number().int().min(4096).max(32768).default(16000) },
+    output: ContextSchema.extend({ tasks: z.array(RecipeSchema) }), annotations: readAnnotations, requiredScope: 'dodo:read', action: 'read',
+    handler: async (args, ctx) => {
+        assertFiles(ctx, args.files);
+        const limit = budget(ctx, args.maxBytes);
+        const data = ContextSchema.parse(await ctx.services.intel.assist({ op: 'assist_context', ...args, maxBytes: Math.max(2048, limit - 1500) }));
+        const tasks = ctx.services.overview.discoverTasks(ctx.services.projectConfig).filter(t => /(?:test|lint|typecheck|build|check|vet|clippy)/.test(t.id)).slice(0, 6)
+            .map(t => ({ taskId: t.id, recipeDigest: t.recipeDigest, title: t.title }));
+        while (tasks.length && Buffer.byteLength(JSON.stringify({ ...data, tasks }), 'utf8') > limit) {
+            tasks.pop();
+            data.truncated = true;
+        }
+        return { data: { ...data, tasks }, truncated: data.truncated };
+    },
+});
+export const analyzeImpactTool = defineTool({
+    name: 'analyze_impact', title: 'Analyze static change impact',
+    description: 'Before editing, find direct/transitive TS/JS import and re-export dependents of workspace files, with evidence lines, hashes and related test paths. Uses the bundled TypeScript parser/resolver, not grep. Missing targets, dynamic loading, external dependencies and scan limits are explicit. This is conservative file-level impact, not a runtime call graph or a reason to skip the full relevant test gate. Read-only.',
+    input: { files: z.array(Path).min(1).max(10), maxResults: z.number().int().min(1).max(100).default(40), maxDepth: z.number().int().min(1).max(10).default(5) },
+    output: ImpactSchema, annotations: readAnnotations, requiredScope: 'dodo:read', action: 'read',
+    handler: async (args, ctx) => {
+        assertFiles(ctx, args.files, true);
+        const data = ImpactSchema.parse(await ctx.services.intel.assist({ op: 'assist_impact', ...args }));
+        while (data.impacted.length && Buffer.byteLength(JSON.stringify(data), 'utf8') > budget(ctx, 32768)) {
+            data.impacted.pop();
+            data.truncated = true;
+            data.relatedTests = data.relatedTests.filter(p => data.impacted.some(i => i.path === p) || args.files.includes(p));
+        }
+        if (Buffer.byteLength(JSON.stringify(data), 'utf8') > budget(ctx, 32768))
+            throw new DodoError('RESOURCE_LIMIT', 'impact metadata exceeds output budget; request fewer targets');
+        return { data, truncated: data.truncated };
+    },
+});
+export const readSymbolTool = defineTool({
+    name: 'read_symbol', title: 'Read one function, class or method',
+    description: 'Read the exact TS/JS AST declaration of a named function/class/method/variable, with file hash and line range. Use a qualified name such as Class.method and optionally a line to disambiguate overloads/nesting. Large content is explicitly truncated. Only block-bodied functions/methods can currently be edited through preview_refactor. No execution.',
+    input: { file: Path, symbol: Symbol, line: z.number().int().positive().optional(), maxBytes: z.number().int().min(1024).max(32768).default(12000) },
+    output: SymbolSchema, annotations: readAnnotations, requiredScope: 'dodo:read', action: 'read',
+    handler: async (args, ctx) => {
+        assertFiles(ctx, [args.file]);
+        const data = SymbolSchema.parse(await ctx.services.intel.assist({ op: 'assist_symbol', file: args.file, symbol: args.symbol, ...(args.line !== undefined ? { line: args.line } : {}), maxBytes: budget(ctx, args.maxBytes) }));
+        return { data, truncated: data.truncated };
+    },
+});
+export const previewRefactorTool = defineTool({
+    name: 'preview_refactor', title: 'Preview a symbol-body edit',
+    description: 'Preview replacement of the INTERIOR of one TS/JS function/method block body. Read read_symbol first and supply its exact file hash; ambiguous, stale, unsupported or invalid syntax is refused. body excludes outer braces. Preserves unrelated file bytes and original CRLF style. Does not apply edits or prove type/behavior correctness. Apply using existing apply_changes(planId, planHash, idempotencyKey), then verify_changes; rollback uses the existing journal.',
+    input: { file: Path, symbol: Symbol, line: z.number().int().positive().optional(), expectedHash: HashSchema,
+        operation: z.literal('replace_body').default('replace_body'), body: z.string().max(512 * 1024) },
+    output: PreviewSchema, annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false }, requiredScope: 'dodo:write', action: 'plan',
+    handler: async (args, ctx) => {
+        assertFiles(ctx, [args.file]);
+        if (Buffer.byteLength(args.body, 'utf8') > Math.min(ctx.services.limits.readFileBytes, 512 * 1024))
+            throw new DodoError('FILE_TOO_LARGE', 'replacement exceeds the active AST byte budget');
+        const data = RefactorSchema.parse(await ctx.services.intel.assist({ op: 'assist_refactor', file: args.file, symbol: args.symbol, expectedHash: args.expectedHash, body: args.body, ...(args.line !== undefined ? { line: args.line } : {}) }));
+        const s = ctx.services;
+        const preview = s.planner.preview({ ops: [{ op: 'replace_file', path: data.path, content: data.content, expectedHash: data.beforeHash }],
+            workspaceId: s.workspaceId, epoch: s.epoch, principal: ctx.principal.grantId, trustMode: ctx.trustMode, source: 'preview_changes' });
+        return { data: { ...preview, symbol: data.symbol, operation: data.operation,
+                notes: ['Syntax checked only; typecheck and behavior tests are still required.', 'Apply and rollback use the existing approval/path/hash/journal machinery.'] }, truncated: preview.files.some(f => f.diffTruncated) };
+    },
+});
+export const verifyChangesTool = defineTool({
+    name: 'verify_changes', title: 'Plan, run and report verification',
+    description: 'mode=plan discovers verification recipes and a guarded source digest without execution. mode=run requires explicitly selected tasks with recipeDigest, sourceDigest from the plan, and an idempotencyKey; runs them through the EXISTING exec approval/sandbox policy. mode=report takes verificationId and never reruns. Reports exits, recognized Vitest/Jest JSON or Vitest text test counts, missing checks and source drift; zero/unknown tests are not a verified test pass. Requires exec scope even for plan/report because this tool can execute. No automatic fixes, retries, installs or security changes. Poll report or existing job_* tools for running jobs.',
+    input: { mode: z.enum(['plan', 'run', 'report']).default('plan'), files: z.array(Path).max(10).default([]),
+        tasks: z.array(z.object({ taskId: z.string().min(1).max(128), recipeDigest: HashSchema }).strict()).max(4).default([]),
+        sourceDigest: HashSchema.optional(), verificationId: z.string().regex(/^verify_[a-z0-9]+$/).max(128).optional(),
+        idempotencyKey: z.string().min(8).max(128).optional(), timeoutMs: z.number().int().min(1000).max(1800000).default(300000),
+        waitMs: z.number().int().min(0).max(10000).default(1000) },
+    output: VerificationSchema, annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true }, requiredScope: 'dodo:exec', action: 'exec',
+    handler: async (args, ctx) => {
+        const data = VerificationSchema.parse(await verifyChanges(ctx, args));
+        // Keep structured and legacy output bounded, without dropping status or freshness.
+        let truncated = false;
+        const max = ctx.services.limits.toolContentBytes - 1024;
+        while (Buffer.byteLength(JSON.stringify(data), 'utf8') > max) {
+            const withFailures = data.checks.find(c => c.tests.failures.length > 0);
+            if (withFailures)
+                withFailures.tests.failures.pop();
+            else if (data.freshness.changedPaths.length) {
+                data.freshness.changedPaths.pop();
+                data.freshness.changedPathsTruncated = true;
+            }
+            else if (data.recommendedTasks.length)
+                data.recommendedTasks.pop();
+            else if (data.files.length)
+                data.files.pop();
+            else if (data.notRun.length)
+                data.notRun.pop();
+            else
+                break;
+            truncated = true;
+        }
+        return { data, truncated };
+    },
+});
+//# sourceMappingURL=assistanceTools.js.map

package/dist/tools/assistanceTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistanceTools.js","sourceRoot":"","sources":["../../src/tools/assistanceTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACzJ,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE3F,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1C,MAAM,eAAe,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AACnH,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACpF,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE;IACtE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjI,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxK,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACxF,CAAC,CAAC;AACH,SAAS,MAAM,CAAC,GAAY,EAAE,SAAiB,IAAY,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AACrI,SAAS,WAAW,CAAC,GAAY,EAAE,KAAe,EAAE,YAAY,GAAG,KAAK;IACtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAClE,IAAI,QAAQ,CAAC,IAAI;YAAE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,gCAAgC,CAAC,QAAQ,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;IAC3C,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,2BAA2B;IAC5D,WAAW,EAAE,+XAA+X;IAC5Y,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACxG,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC9F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;IAClE,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IACxI,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,gBAAgB,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7I,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,gDAAgD,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aAC/J,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;YAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAAC,CAAC;QACrI,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IACjE,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,8BAA8B;IAC7D,WAAW,EAAE,gaAAga;IAC7a,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;IAC9J,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAC9F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;QACnG,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC;YACpG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAAC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YAC3C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,8DAA8D,CAAC,CAAC;QAChL,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAC7C,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;IACvC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,oCAAoC;IAChE,WAAW,EAAE,8VAA8V;IAC3W,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;IACnJ,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAC9F,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/N,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;IAC7C,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;IAC5C,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,4BAA4B;IAC7D,WAAW,EAAE,6cAA6c;IAC1d,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,UAAU;QACzG,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE;IAClG,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IAC7K,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,gDAAgD,CAAC,CAAC;QAC5L,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/O,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;QACvB,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YACtI,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;QACvI,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzE,KAAK,EAAE,CAAC,uEAAuE,EAAE,2EAA2E,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC;IAC3N,CAAC;CACF,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,mCAAmC;IAClE,WAAW,EAAE,6oBAA6oB;IAC1pB,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACxG,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACtH,YAAY,EAAE,UAAU,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;QAC/G,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACzH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;IAC5D,MAAM,EAAE,kBAAkB,EAAE,WAAW,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;IAC/K,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;QACtE,mFAAmF;QACnF,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;QACxD,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;YAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxE,IAAI,YAAY;gBAAE,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;iBAC/C,IAAI,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;gBAAC,IAAI,CAAC,SAAS,CAAC,qBAAqB,GAAG,IAAI,CAAC;YAAC,CAAC;iBAC3H,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM;gBAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,CAAC;iBAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;iBACxC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;gBAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;;gBAC1C,MAAM;YACX,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/brainTools.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { DodoError } from '../errors.js';
+import { BRAIN_QUERY_MAX, BrainControlResult, BrainEdgeType, BrainNode, BrainNodeType, BrainQueryResult, BrainStatus, } from '../services/brain/contracts.js';
+import { liveAccess } from '../services/multimodal/storage.js';
+import { defineTool, policyGate } from './context.js';
+const read = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+const control = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false };
+function use(ctx) {
+    const brain = ctx.services.brain;
+    if (!brain)
+        throw new DodoError('NOT_SUPPORTED', 'Project Brain is unavailable in this running build');
+    return brain;
+}
+const brainStatusTool = defineTool({
+    name: 'brain_status',
+    title: 'Inspect Project Brain status',
+    description: 'Return bounded Project Brain freshness, parser/schema versions, latest run state and graph counts for the active workspace. Cached index rows are evidence only and never grant source access.',
+    input: {},
+    output: BrainStatus,
+    requiredScope: 'dodo:read',
+    action: 'read',
+    annotations: read,
+    handler: async (_args, ctx) => { liveAccess(ctx, 'dodo:read'); return { data: use(ctx).status() }; },
+});
+const brainQueryTool = defineTool({
+    name: 'brain_query',
+    title: 'Query project structure',
+    description: 'Query bounded files, symbols, routes, tests, dependencies and relationship edges from the active Project Brain. Every returned row is re-authorized and checked against the current guarded source SHA-256; stale rows are omitted by default.',
+    input: {
+        query: z.string().min(1).max(256).optional(),
+        path: z.string().min(1).max(1024).optional(),
+        nodeTypes: z.array(BrainNodeType).min(1).max(5).optional(),
+        edgeTypes: z.array(BrainEdgeType).min(1).max(6).optional(),
+        includeStale: z.boolean().default(false),
+        limit: z.number().int().min(1).max(BRAIN_QUERY_MAX).default(50),
+        cursor: z.string().max(2048).optional(),
+    },
+    output: BrainQueryResult,
+    requiredScope: 'dodo:read',
+    action: 'read',
+    annotations: read,
+    handler: async (args, ctx) => {
+        const input = {
+            includeStale: args.includeStale,
+            limit: args.limit,
+            ...(args.query !== undefined ? { query: args.query } : {}),
+            ...(args.path !== undefined ? { path: args.path } : {}),
+            ...(args.nodeTypes !== undefined ? { nodeTypes: args.nodeTypes } : {}),
+            ...(args.edgeTypes !== undefined ? { edgeTypes: args.edgeTypes } : {}),
+            ...(args.cursor !== undefined ? { cursor: args.cursor } : {}),
+        };
+        const result = await use(ctx).query(ctx, input);
+        return { data: result.data, truncated: result.truncated, nextCursor: result.nextCursor };
+    },
+});
+const brainSymbolTool = defineTool({
+    name: 'brain_symbol',
+    title: 'Resolve a stable Project Brain symbol',
+    description: 'Resolve one symbol:// project entity URI. The stable identity survives an exact-content file move, while the result reports the current path and source freshness.',
+    input: { uri: z.string().min(1).max(1024).regex(/^symbol:\/\//) },
+    output: BrainNode,
+    requiredScope: 'dodo:read',
+    action: 'read',
+    annotations: read,
+    handler: async (args, ctx) => ({ data: await use(ctx).symbol(ctx, args.uri) }),
+});
+const brainRebuildTool = defineTool({
+    name: 'brain_rebuild',
+    title: 'Rebuild Project Brain',
+    description: 'Start one bounded incremental or full Project Brain rebuild. Repository code, plugins and scripts are never executed. This owner-controlled maintenance action retains the active trust/approval policy.',
+    input: {
+        mode: z.enum(['incremental', 'full']).default('incremental'),
+        waitMs: z.number().int().min(0).max(10_000).default(0),
+    },
+    output: BrainControlResult,
+    requiredScope: 'dodo:exec',
+    action: 'exec',
+    annotations: control,
+    handler: async (args, ctx) => {
+        liveAccess(ctx, 'dodo:exec');
+        policyGate(ctx, { tool: 'brain_rebuild', action: 'exec', approvalAction: { mode: args.mode }, summary: `rebuild the active Project Brain (${args.mode})` });
+        const brain = use(ctx);
+        const started = await brain.start(args.mode);
+        const status = args.waitMs > 0 ? await brain.wait(started.runId, args.waitMs) : brain.status();
+        return { data: { runId: started.runId, changed: started.changed, status } };
+    },
+});
+const brainPauseTool = defineTool({
+    name: 'brain_pause',
+    title: 'Pause or resume Project Brain refresh',
+    description: 'Pause or resume automatic indexing for the active workspace. Pausing cancels an in-progress uncommitted index transaction; it never changes source files or permissions.',
+    input: { paused: z.boolean().default(true) },
+    output: BrainControlResult,
+    requiredScope: 'dodo:exec',
+    action: 'exec',
+    annotations: control,
+    handler: async (args, ctx) => {
+        liveAccess(ctx, 'dodo:exec');
+        policyGate(ctx, { tool: 'brain_pause', action: 'exec', approvalAction: { paused: args.paused }, summary: `${args.paused ? 'pause' : 'resume'} automatic Project Brain indexing` });
+        const brain = use(ctx);
+        const result = await brain.pause(args.paused);
+        return { data: { runId: null, changed: result.changed, status: brain.status() } };
+    },
+});
+const brainCancelTool = defineTool({
+    name: 'brain_cancel',
+    title: 'Cancel a Project Brain rebuild',
+    description: 'Cancel the active Project Brain parser run before commit. Existing committed index data stays available and source files are never modified.',
+    input: { runId: z.string().min(1).max(128).optional() },
+    output: BrainControlResult,
+    requiredScope: 'dodo:exec',
+    action: 'exec',
+    annotations: control,
+    handler: async (args, ctx) => {
+        liveAccess(ctx, 'dodo:exec');
+        policyGate(ctx, { tool: 'brain_cancel', action: 'exec', approvalAction: { runId: args.runId ?? null }, summary: 'cancel the active Project Brain rebuild' });
+        const brain = use(ctx);
+        const result = await brain.cancel(args.runId);
+        return { data: { runId: args.runId ?? null, changed: result.changed, status: brain.status() } };
+    },
+});
+export const BRAIN_TOOLS = [
+    brainStatusTool,
+    brainQueryTool,
+    brainSymbolTool,
+    brainRebuildTool,
+    brainPauseTool,
+    brainCancelTool,
+];
+//# sourceMappingURL=brainTools.js.map

package/dist/tools/brainTools.js.map

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

package/dist/tools/catalog.js

@@ -0,0 +1,30 @@
+import { SUBAGENT_TOOLS } from './subagentTools.js';
+import { registerTool } from './context.js';
+import { CORE_TOOL_CATALOG } from './coreCatalog.js';
+import { AGENT_RUNTIME_TOOLS } from './agentRuntimeTools.js';
+/**
+ * The tool catalog in a FIXED, stable order. Every listed tool is fully
+ * implemented; nothing here is a stub, and no roadmap tool is registered.
+ *
+ * Tiers share one policy and one journal:
+ *  - understand: overview / list / read / search / glob / images / instructions
+ *  - direct edits: write / edit / patch / bulk replace / delete / move / mkdir
+ *  - semantics: TS/JS built in, other languages via owner-registered LSP
+ *  - reviewed changes: preview_* → apply_changes → rollback
+ *  - git: status / diff / log / commit
+ *  - run: run_command(s) (shell, parallel, background, sandbox) + job_* polling,
+ *    run_task recipes, exec_command (argv)
+ *  - agent workflow: todo, environment, fetch_url, diagnostics, handoff
+ */
+export const TOOL_CATALOG = [
+    ...CORE_TOOL_CATALOG,
+    // Durable plan/hypothesis/lock/snapshot/skill coordination. Existing 104 names stay an exact prefix.
+    ...AGENT_RUNTIME_TOOLS,
+    ...SUBAGENT_TOOLS,
+];
+export function registerCatalog(server, services) {
+    for (const def of TOOL_CATALOG) {
+        registerTool(server, services, def);
+    }
+}
+//# sourceMappingURL=catalog.js.map

package/dist/tools/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/tools/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAqC,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,GAAG,iBAAiB;IACpB,qGAAqG;IACrG,GAAG,mBAAmB;IACtB,GAAG,cAAc;CAClB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,QAAqB;IACtE,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/tools/changeTools.js

@@ -0,0 +1,188 @@
+import { z } from 'zod';
+import { MAX_FILE_BYTES } from '../config/limits.js';
+import { policyGate, defineTool } from './context.js';
+import { DodoError } from '../errors.js';
+import { digestOf } from '../util/hash.js';
+const looseData = z.looseObject({});
+const OperationSchema = z.discriminatedUnion('op', [
+    z
+        .object({
+        op: z.literal('create'),
+        path: z.string().max(1024),
+        content: z.string().max(MAX_FILE_BYTES),
+        createParents: z.boolean().default(false),
+    })
+        .strict(),
+    z
+        .object({
+        op: z.literal('replace_file'),
+        path: z.string().max(1024),
+        content: z.string().max(MAX_FILE_BYTES),
+        expectedHash: z.string().max(128).optional(),
+    })
+        .strict(),
+    z
+        .object({
+        op: z.literal('replace_exact'),
+        path: z.string().max(1024),
+        find: z.string().min(1).max(MAX_FILE_BYTES),
+        replace: z.string().max(MAX_FILE_BYTES),
+        expectedCount: z.number().int().min(1).max(1000).default(1),
+        expectedHash: z.string().max(128).optional(),
+    })
+        .strict(),
+    z.object({ op: z.literal('delete'), path: z.string().max(1024), expectedHash: z.string().max(128).optional() }).strict(),
+    z
+        .object({
+        op: z.literal('move'),
+        path: z.string().max(1024),
+        destPath: z.string().max(1024),
+        expectedHash: z.string().max(128).optional(),
+    })
+        .strict(),
+]);
+export const previewChangesTool = defineTool({
+    name: 'preview_changes',
+    title: 'Preview changes',
+    description: 'Validate a batch of file operations (create / replace_file / replace_exact / delete / move) and produce an IMMUTABLE plan with per-file diffs, raw-byte before/after SHA-256 hashes, risk and expiry. The workspace is NOT modified. replace_exact requires the target text to occur exactly expectedCount times (default 1) — mismatches fail with AMBIGUOUS_EDIT instead of fuzzy-editing. Apply with apply_changes(planId, planHash, idempotencyKey).',
+    input: {
+        operations: z.array(OperationSchema).min(1).max(50),
+    },
+    output: looseData,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    requiredScope: 'dodo:write',
+    action: 'plan',
+    handler: async (args, ctx) => {
+        const preview = ctx.services.planner.preview({
+            ops: args.operations,
+            workspaceId: ctx.services.workspaceId,
+            epoch: ctx.services.epoch,
+            principal: ctx.principal.grantId,
+            trustMode: ctx.trustMode,
+            source: 'preview_changes',
+        });
+        return { data: preview };
+    },
+});
+const IdempotencyKey = z.string().min(8).max(128).describe('Client-generated key; reuse the SAME key when retrying this exact call');
+/**
+ * Durable idempotency wrapper (spec §12.3): reserve → side effect → receipt.
+ * Same key + same payload replays the stored receipt; same key + different
+ * payload is IDEMPOTENCY_CONFLICT; a reservation without a receipt reports an
+ * uncertain in-progress/interrupted state and is never blindly re-run.
+ */
+export async function withIdempotency(ctx, tool, key, payload, fn) {
+    const store = ctx.services.store;
+    const ids = { key, principal: ctx.principal.grantId, workspaceId: ctx.services.workspaceId, tool };
+    const payloadHash = digestOf(payload);
+    const reservation = store.reserveIdempotency({ ...ids, payloadHash });
+    if (reservation.outcome === 'conflict') {
+        throw new DodoError('IDEMPOTENCY_CONFLICT', 'this idempotencyKey was already used with different arguments', {
+            recovery: 'use a fresh idempotencyKey for a new operation',
+        });
+    }
+    if (reservation.outcome === 'duplicate') {
+        if (reservation.state === 'completed' && reservation.result !== null) {
+            return { result: JSON.parse(reservation.result), replayed: true };
+        }
+        throw new DodoError('RECOVERY_REQUIRED', 'an operation with this key is in progress or was interrupted; its outcome is uncertain', {
+            retryable: true,
+            recovery: 'wait and retry with the same key to check again; use a NEW key only if you intend to run the operation again',
+        });
+    }
+    try {
+        const result = await fn();
+        store.completeIdempotency(ids, JSON.stringify(result));
+        return { result, replayed: false };
+    }
+    catch (err) {
+        const je = err instanceof DodoError ? err : undefined;
+        if (je?.code !== 'PARTIAL_RECOVERY_REQUIRED' && je?.code !== 'RECOVERY_REQUIRED') {
+            store.releaseIdempotency(ids);
+        }
+        throw err;
+    }
+}
+export const applyChangesTool = defineTool({
+    name: 'apply_changes',
+    title: 'Apply changes',
+    description: 'Apply a previously previewed immutable plan. Requires planId + planHash from preview_changes/preview_rename and a client idempotencyKey (retry-safe: the same key returns the same receipt and never creates a second changeset). Every file hash is re-verified before writing; changed files fail with FILE_CHANGED. In inspect mode this needs a local owner approval first (the error tells you the approval id).',
+    input: {
+        planId: z.string().max(128),
+        planHash: z.string().max(128),
+        idempotencyKey: IdempotencyKey,
+    },
+    output: looseData,
+    annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    requiredScope: 'dodo:write',
+    action: 'mutate-files',
+    handler: async (args, ctx) => {
+        policyGate(ctx, {
+            tool: 'apply_changes',
+            action: 'mutate-files',
+            approvalAction: { planId: args.planId, planHash: args.planHash },
+            summary: `apply change plan ${args.planId}`,
+        });
+        const { result, replayed } = await withIdempotency(ctx, 'apply_changes', args.idempotencyKey, { planId: args.planId, planHash: args.planHash }, () => ctx.services.applier.apply({
+            planId: args.planId,
+            planHash: args.planHash,
+            workspaceId: ctx.services.workspaceId,
+            epoch: ctx.services.epoch,
+            principal: ctx.principal.grantId,
+        }));
+        return { data: { ...result, replayed } };
+    },
+});
+export const rollbackChangesTool = defineTool({
+    name: 'rollback_changes',
+    title: 'Rollback changes',
+    description: 'Restore the files of a committed changeset to their pre-apply bytes from durable backups. Refused with per-file conflicts if ANY affected file was edited after the apply (human work is never overwritten). Takes the changesetId from apply_changes and a fresh idempotencyKey.',
+    input: {
+        changesetId: z.string().max(128),
+        idempotencyKey: IdempotencyKey,
+    },
+    output: looseData,
+    annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+    requiredScope: 'dodo:write',
+    action: 'mutate-files',
+    handler: async (args, ctx) => {
+        policyGate(ctx, {
+            tool: 'rollback_changes',
+            action: 'mutate-files',
+            approvalAction: { changesetId: args.changesetId },
+            summary: `rollback changeset ${args.changesetId}`,
+        });
+        const { result, replayed } = await withIdempotency(ctx, 'rollback_changes', args.idempotencyKey, { changesetId: args.changesetId }, () => ctx.services.applier.rollback({
+            changesetId: args.changesetId,
+            workspaceId: ctx.services.workspaceId,
+            epoch: ctx.services.epoch,
+            principal: ctx.principal.grantId,
+        }));
+        return { data: { ...result, replayed } };
+    },
+});
+export const changeHistoryTool = defineTool({
+    name: 'change_history',
+    title: 'Change history',
+    description: 'List DODO changesets for this workspace (id, kind, status, summary, timestamps). Only DODO-made changes appear here — external edits are not tracked.',
+    input: {
+        limit: z.number().int().min(1).max(100).default(20),
+    },
+    output: looseData,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    requiredScope: 'dodo:read',
+    action: 'read',
+    handler: async (args, ctx) => {
+        const rows = ctx.services.store.listChangesets(ctx.services.workspaceId, args.limit).map((c) => ({
+            changesetId: c.id,
+            kind: c.kind,
+            status: c.status,
+            summary: c.summary,
+            createdAt: c.createdAt,
+            committedAt: c.committedAt,
+            planId: c.planId,
+        }));
+        return { data: { changesets: rows } };
+    },
+});
+//# sourceMappingURL=changeTools.js.map

package/dist/tools/changeTools.js.map

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