dodo-mcp 1.0.0

package/dist/tools/semanticTools.js

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+import { defineTool } from './context.js';
+import { DodoError } from '../errors.js';
+const looseData = z.looseObject({});
+const TS_EXT = /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs)$/i;
+/** Route a file to the built-in TypeScript provider or an owner-registered LSP. */
+export function providerFor(ctx, file) {
+    const rel = ctx.services.wfs.normalizeRel(file);
+    if (TS_EXT.test(rel))
+        return { kind: 'ts' };
+    const language = ctx.services.lsp?.languageFor(rel);
+    if (language) {
+        const avail = ctx.services.lsp?.available(language);
+        if (avail && !avail.ok) {
+            throw new DodoError('UNSUPPORTED_LANGUAGE', `language server for ${language} is registered but unavailable: ${avail.reason ?? 'unknown'}`);
+        }
+        return { kind: 'lsp', language };
+    }
+    throw new DodoError('UNSUPPORTED_LANGUAGE', 'semantic tools cover TypeScript/JavaScript built-in; other languages need an owner-registered language server', {
+        recovery: 'on the server machine: dodo lsp add <language> --command <server> --args ... --ext .py (see docs/LSP.md)',
+    });
+}
+export const symbolsTool = defineTool({
+    name: 'symbols',
+    title: 'Symbols (TS/JS semantic)',
+    description: 'Semantic symbol declarations. TypeScript/JavaScript use the bundled language service; other languages use an owner-registered language server (dodo lsp add python/go/rust…). Provide either "file" (workspace-relative file → its declarations) or "query" (project-wide symbol search; set language for a non-TS server). Unregistered languages return UNSUPPORTED_LANGUAGE — this is a real semantic provider, not grep.',
+    input: {
+        file: z.string().max(1024).optional(),
+        query: z.string().min(1).max(256).optional(),
+        language: z.string().max(32).optional().describe('for query mode: a registered LSP language id (default: TypeScript/JavaScript)'),
+        maxResults: z.number().int().min(1).max(500).default(100),
+    },
+    output: looseData,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    requiredScope: 'dodo:read',
+    action: 'read',
+    handler: async (args, ctx) => {
+        if ((args.file === undefined) === (args.query === undefined)) {
+            throw new DodoError('INVALID_INPUT', 'provide exactly one of "file" or "query"');
+        }
+        if (args.file !== undefined) {
+            const p = providerFor(ctx, args.file);
+            if (p.kind === 'lsp') {
+                const r = await ctx.services.lsp.symbolsInFile(args.file, args.maxResults);
+                return { data: { symbols: r.symbols, provider: r.meta.server, language: r.meta.language }, warnings: r.meta.degraded ? [r.meta.degradedReason ?? 'degraded'] : [] };
+            }
+            const res = await ctx.services.intel.symbolsInFile(args.file, args.maxResults);
+            const warnings = [];
+            if (res.meta?.degraded)
+                warnings.push(res.meta.degradedReason ?? 'semantic analysis is degraded (project size limits)');
+            return { data: { symbols: res.symbols, projectFiles: res.meta?.projectFiles ?? 0, provider: 'typescript' }, warnings };
+        }
+        if (args.language !== undefined && !/^(typescript|javascript)$/i.test(args.language)) {
+            if (!ctx.services.lsp)
+                throw new DodoError('UNSUPPORTED_LANGUAGE', 'no language servers registered (dodo lsp add ...)');
+            const r = await ctx.services.lsp.symbolsQuery(args.language, args.query, args.maxResults);
+            return { data: { symbols: r.symbols, provider: r.meta.server, language: r.meta.language }, warnings: r.meta.degraded ? [r.meta.degradedReason ?? 'degraded'] : [] };
+        }
+        const res = await ctx.services.intel.symbolsQuery(args.query, args.maxResults);
+        const warnings = [];
+        if (res.meta?.degraded)
+            warnings.push(res.meta.degradedReason ?? 'semantic analysis is degraded (project size limits)');
+        return { data: { symbols: res.symbols, projectFiles: res.meta?.projectFiles ?? 0, provider: 'typescript' }, warnings };
+    },
+});
+export const referencesTool = defineTool({
+    name: 'references',
+    title: 'References (TS/JS semantic)',
+    description: 'Actual semantic references (not text matches) for the symbol at file/line/column (1-based line; 1-based UTF-16 column, as returned by read_files/search_code). Includes definition flags and per-reference line text. References outside the workspace are counted but never disclosed.',
+    input: {
+        file: z.string().max(1024),
+        line: z.number().int().min(1),
+        column: z.number().int().min(1),
+        maxResults: z.number().int().min(1).max(500).default(200),
+    },
+    output: looseData,
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    requiredScope: 'dodo:read',
+    action: 'read',
+    handler: async (args, ctx) => {
+        const p = providerFor(ctx, args.file);
+        if (p.kind === 'lsp') {
+            const r = await ctx.services.lsp.references(args.file, { line: args.line, column: args.column }, args.maxResults);
+            const w = [];
+            if (r.outOfScopeCount > 0)
+                w.push(`${r.outOfScopeCount} reference(s) are outside the workspace scope and were not listed`);
+            if (r.meta.degraded)
+                w.push(r.meta.degradedReason ?? 'degraded');
+            return { data: { references: r.references, outOfScopeCount: r.outOfScopeCount, provider: r.meta.server, language: r.meta.language }, warnings: w };
+        }
+        const res = await ctx.services.intel.references(args.file, { line: args.line, column: args.column }, args.maxResults);
+        const warnings = [];
+        if (res.outOfScopeCount > 0)
+            warnings.push(`${res.outOfScopeCount} reference(s) are outside the workspace scope and were not listed`);
+        if (res.meta?.degraded)
+            warnings.push(res.meta.degradedReason ?? 'semantic analysis is degraded');
+        return { data: { references: res.references, outOfScopeCount: res.outOfScopeCount }, warnings };
+    },
+});
+export const previewRenameTool = defineTool({
+    name: 'preview_rename',
+    title: 'Preview rename (TS/JS semantic)',
+    description: 'Build an immutable change plan that renames the symbol at file/line/column to newName using semantic rename locations (string/comment homonyms untouched). Nothing is applied — review the returned diffs, then call apply_changes with planId + planHash. Refused when the rename would need edits outside the workspace or inside dependencies.',
+    input: {
+        file: z.string().max(1024),
+        line: z.number().int().min(1),
+        column: z.number().int().min(1),
+        newName: z.string().min(1).max(128),
+    },
+    output: looseData,
+    annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    requiredScope: 'dodo:write',
+    action: 'plan',
+    handler: async (args, ctx) => {
+        const p = providerFor(ctx, args.file);
+        const { result } = p.kind === 'lsp'
+            ? await ctx.services.lsp.rename(args.file, { line: args.line, column: args.column }, args.newName)
+            : await ctx.services.intel.rename(args.file, { line: args.line, column: args.column }, args.newName);
+        if (result.outOfScopeCount > 0) {
+            throw new DodoError('CONFLICT', `rename would change ${result.outOfScopeCount} location(s) outside the workspace scope (e.g. ${result.outOfScopeSample.join(', ')}); a partial rename would break the code, so it is refused`, { detail: { outOfScopeCount: result.outOfScopeCount } });
+        }
+        if (result.locations.length === 0) {
+            throw new DodoError('NOT_FOUND', 'no rename locations found');
+        }
+        const ops = result.locations.map((f) => ({
+            op: 'span_edit',
+            path: f.path,
+            edits: f.edits.map((e) => ({ start: e.start, end: e.end, newText: e.newText })),
+        }));
+        const preview = ctx.services.planner.preview({
+            ops,
+            workspaceId: ctx.services.workspaceId,
+            epoch: ctx.services.epoch,
+            principal: ctx.principal.grantId,
+            trustMode: ctx.trustMode,
+            source: 'preview_rename',
+        });
+        return { data: { ...preview, symbolName: result.symbolName, renamedTo: args.newName } };
+    },
+});
+//# sourceMappingURL=semanticTools.js.map

package/dist/tools/semanticTools.js.map

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

package/dist/tools/subagentTools.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { defineTool, policyGate } from './context.js';
+import { DodoError } from '../errors.js';
+const data = z.looseObject({});
+const service = (ctx) => { const ai = ctx.services.installation?.ai; if (!ai)
+    throw new DodoError('NOT_SUPPORTED', 'AI runtime is unavailable'); return ai; };
+const runService = (ctx, runId) => { const ai = service(ctx); const run = ai.status(runId, ctx.principal); const project = ai.installation.list(ctx.principal).find(p => p.projectId === run.projectId); if (project?.workspaceId !== ctx.services.workspaceId)
+    throw new DodoError('WORKSPACE_MISMATCH', 'run belongs to a different target project'); return ai; };
+const read = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+export const SUBAGENT_TOOLS = [
+    defineTool({ name: 'subagent_spawn', title: 'Spawn a bounded AI coding agent', description: 'Run an enabled owner-configured AI profile on this target project. Requires exec scope; managed mode also requires explicit project/profile/client permission. Returns a durable run ID; it never approves actions, widens scopes, or disables guards.',
+        input: { profileId: z.string().min(1), task: z.string().min(1).max(16000), idempotencyKey: z.string().min(8).max(128) }, output: data,
+        requiredScope: 'dodo:exec', action: 'exec', annotations: { ...read, readOnlyHint: false, idempotentHint: false, openWorldHint: true },
+        handler: async (args, ctx) => {
+            const ai = service(ctx);
+            const project = ai.installation.list(ctx.principal).find(p => p.workspaceId === ctx.services.workspaceId);
+            if (!project)
+                throw new DodoError('FORBIDDEN', 'register and authorize this project before spawning an agent');
+            policyGate(ctx, { tool: 'subagent_spawn', action: 'exec', approvalAction: args, summary: 'Use a paid/local AI profile for a bounded coding task' });
+            return { data: await ai.spawn({ projectId: project.projectId, profileId: args.profileId, task: args.task, idempotencyKey: args.idempotencyKey }, ctx.principal, ctx.services) };
+        },
+    }),
+    ...['subagent_status', 'subagent_result'].map(name => defineTool({ name, title: name === 'subagent_status' ? 'AI run status' : 'AI run result', description: 'Inspect an owned AI run and its actual tool/test results. Does not expose provider secrets or private reasoning.',
+        input: { runId: z.string().min(1), after: z.number().int().nonnegative().default(0) }, output: data, requiredScope: 'dodo:read', action: 'read', annotations: read,
+        handler: async (args, ctx) => ({ data: name === 'subagent_result' ? runService(ctx, args.runId).result(args.runId, ctx.principal, args.after) : runService(ctx, args.runId).status(args.runId, ctx.principal) }),
+    })),
+    defineTool({ name: 'subagent_control', title: 'Control an owned AI run', description: 'Pause, cancel, or explicitly resume an owned run. Resume re-checks live authority and cannot replay an uncertain outcome.',
+        input: { runId: z.string().min(1), action: z.enum(['pause', 'resume', 'cancel']) }, output: data, requiredScope: 'dodo:exec', action: 'job-control', annotations: { ...read, readOnlyHint: false },
+        handler: async (args, ctx) => ({ data: await runService(ctx, args.runId).control(args.runId, args.action, ctx.principal) }),
+    }),
+];
+//# sourceMappingURL=subagentTools.js.map

package/dist/tools/subagentTools.js.map

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