@padua/cli 2.0.24 → 2.2.0

package/dist/mcp/code-mode/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * code-mode module barrel export.
+ *
+ * Exports the public API surface for the code-mode feature:
+ *   - CodeModeProvider: MCP provider that registers call_tool_chain + search_tools
+ *   - InstrumentedToolRegistrar: wraps a ToolRegistrar to capture tool registrations
+ *   - Types used by callers
+ */
+export { CodeModeProvider } from './provider.js';
+export { InstrumentedToolRegistrar, deriveNamespaceAndFunction } from './tool-registry.js';
+export type { ToolEntry, ExecutionResult, ExecutionOptions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/code-mode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/code-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAC3F,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/mcp/code-mode/index.js

@@ -0,0 +1,11 @@
+/**
+ * code-mode module barrel export.
+ *
+ * Exports the public API surface for the code-mode feature:
+ *   - CodeModeProvider: MCP provider that registers call_tool_chain + search_tools
+ *   - InstrumentedToolRegistrar: wraps a ToolRegistrar to capture tool registrations
+ *   - Types used by callers
+ */
+export { CodeModeProvider } from './provider.js';
+export { InstrumentedToolRegistrar, deriveNamespaceAndFunction } from './tool-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/code-mode/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/code-mode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/code-mode/interface-generator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * InterfaceGenerator — converts tool Zod/JSON schemas to TypeScript interfaces.
+ *
+ * Produces TypeScript interface strings grouped by namespace so agents can
+ * understand tool parameter shapes before calling them.
+ */
+import type { ToolEntry } from './types.js';
+export declare class InterfaceGenerator {
+    private readonly tools;
+    constructor(tools: ToolEntry[]);
+    /**
+     * Generate TypeScript interface definitions for all tools.
+     *
+     * Groups tools by namespace into ambient namespace declarations so that
+     * code running in the sandbox can reference `gitlab.list_issues({ ... })`.
+     */
+    generateAll(): string;
+    /**
+     * Generate a TypeScript interface for a single tool by name.
+     *
+     * Returns a string containing the interface definition and JSDoc comment,
+     * or a comment indicating the tool was not found.
+     */
+    generateForToolByName(toolName: string): string;
+    /**
+     * Generate a TypeScript interface for a single ToolEntry.
+     *
+     * @param tool       The tool to generate an interface for.
+     * @param indented   When true, indent by 2 spaces (for namespace blocks).
+     */
+    private generateForTool;
+    /**
+     * Return a map of tool name → interface string for all tools.
+     * Used to set up __getToolInterface() inside the sandbox.
+     */
+    buildInterfaceMap(): Record<string, string>;
+}
+//# sourceMappingURL=interface-generator.d.ts.map

package/dist/mcp/code-mode/interface-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface-generator.d.ts","sourceRoot":"","sources":["../../../src/mcp/code-mode/interface-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAgE5C,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,SAAS,EAAE;IAE/C;;;;;OAKG;IACH,WAAW,IAAI,MAAM;IAyBrB;;;;;OAKG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAM/C;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IA2CvB;;;OAGG;IACH,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAO5C"}

package/dist/mcp/code-mode/interface-generator.js

@@ -0,0 +1,159 @@
+/**
+ * InterfaceGenerator — converts tool Zod/JSON schemas to TypeScript interfaces.
+ *
+ * Produces TypeScript interface strings grouped by namespace so agents can
+ * understand tool parameter shapes before calling them.
+ */
+// ---------------------------------------------------------------------------
+// Type helpers
+// ---------------------------------------------------------------------------
+/** Convert a JSON Schema type descriptor to a TypeScript type string. */
+function jsonSchemaTypeToTs(schema) {
+    if (!schema || typeof schema !== 'object')
+        return 'unknown';
+    const s = schema;
+    // Handle enum
+    if (s.enum && Array.isArray(s.enum)) {
+        return s.enum
+            .map(v => (typeof v === 'string' ? JSON.stringify(v) : String(v)))
+            .join(' | ');
+    }
+    // Handle oneOf / union
+    if (s.oneOf && Array.isArray(s.oneOf)) {
+        return s.oneOf.map(jsonSchemaTypeToTs).join(' | ');
+    }
+    switch (s.type) {
+        case 'string':
+            return 'string';
+        case 'number':
+        case 'integer':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'null':
+            return 'null';
+        case 'array': {
+            const itemType = s.items ? jsonSchemaTypeToTs(s.items) : 'unknown';
+            return `(${itemType})[]`;
+        }
+        case 'object': {
+            if (s.properties && typeof s.properties === 'object') {
+                const props = Object.entries(s.properties)
+                    .map(([k, v]) => {
+                    const required = Array.isArray(s.required) && s.required.includes(k);
+                    return `${k}${required ? '' : '?'}: ${jsonSchemaTypeToTs(v)}`;
+                })
+                    .join('; ');
+                return `{ ${props} }`;
+            }
+            return '{ [key: string]: unknown }';
+        }
+        case 'any':
+        default:
+            return 'unknown';
+    }
+}
+/** Escape a string for safe use inside a JSDoc comment. */
+function escapeComment(text) {
+    return text.replace(/\*\//g, '*\\/').replace(/\n/g, ' ');
+}
+// ---------------------------------------------------------------------------
+// InterfaceGenerator
+// ---------------------------------------------------------------------------
+export class InterfaceGenerator {
+    tools;
+    constructor(tools) {
+        this.tools = tools;
+    }
+    /**
+     * Generate TypeScript interface definitions for all tools.
+     *
+     * Groups tools by namespace into ambient namespace declarations so that
+     * code running in the sandbox can reference `gitlab.list_issues({ ... })`.
+     */
+    generateAll() {
+        const byNamespace = new Map();
+        for (const tool of this.tools) {
+            const ns = tool.namespace;
+            if (!byNamespace.has(ns))
+                byNamespace.set(ns, []);
+            byNamespace.get(ns).push(tool);
+        }
+        const parts = [
+            '// Auto-generated TypeScript interfaces for Padua MCP tools',
+            '',
+        ];
+        for (const [ns, nsTools] of byNamespace) {
+            parts.push(`declare namespace ${ns} {`);
+            for (const tool of nsTools) {
+                parts.push(this.generateForTool(tool, true));
+            }
+            parts.push('}');
+            parts.push('');
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Generate a TypeScript interface for a single tool by name.
+     *
+     * Returns a string containing the interface definition and JSDoc comment,
+     * or a comment indicating the tool was not found.
+     */
+    generateForToolByName(toolName) {
+        const tool = this.tools.find(t => t.name === toolName);
+        if (!tool)
+            return `// Tool '${toolName}' not found`;
+        return this.generateForTool(tool, false);
+    }
+    /**
+     * Generate a TypeScript interface for a single ToolEntry.
+     *
+     * @param tool       The tool to generate an interface for.
+     * @param indented   When true, indent by 2 spaces (for namespace blocks).
+     */
+    generateForTool(tool, indented) {
+        const indent = indented ? '  ' : '';
+        const lines = [];
+        lines.push(`${indent}/**`);
+        lines.push(`${indent} * ${escapeComment(tool.description)}`);
+        lines.push(`${indent} * Access as: ${tool.namespace}.${tool.functionName}(args)`);
+        lines.push(`${indent} */`);
+        // Input interface name
+        const inputIfName = `${tool.functionName}Input`;
+        lines.push(`${indent}interface ${inputIfName} {`);
+        const schema = tool.inputSchema;
+        if (schema &&
+            schema.type === 'object' &&
+            schema.properties &&
+            typeof schema.properties === 'object') {
+            const props = schema.properties;
+            const required = Array.isArray(schema.required) ? schema.required : [];
+            for (const [propName, propSchema] of Object.entries(props)) {
+                const isReq = required.includes(propName);
+                const desc = propSchema.description;
+                if (desc) {
+                    lines.push(`${indent}  /** ${escapeComment(String(desc))} */`);
+                }
+                lines.push(`${indent}  ${propName}${isReq ? '' : '?'}: ${jsonSchemaTypeToTs(propSchema)};`);
+            }
+        }
+        else {
+            lines.push(`${indent}  [key: string]: unknown;`);
+        }
+        lines.push(`${indent}}`);
+        lines.push('');
+        return lines.join('\n');
+    }
+    /**
+     * Return a map of tool name → interface string for all tools.
+     * Used to set up __getToolInterface() inside the sandbox.
+     */
+    buildInterfaceMap() {
+        const map = {};
+        for (const tool of this.tools) {
+            map[tool.name] = this.generateForTool(tool, false);
+        }
+        return map;
+    }
+}
+//# sourceMappingURL=interface-generator.js.map

package/dist/mcp/code-mode/interface-generator.js.map

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

package/dist/mcp/code-mode/provider.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CodeModeProvider — MCP provider for code-mode execution tools.
+ *
+ * Registers two MCP tools:
+ *   - call_tool_chain: execute JavaScript in an isolated V8 sandbox with
+ *     all registered MCP tools available as synchronous functions
+ *   - search_tools: keyword search over registered tools
+ *
+ * Implements the Provider interface and integrates via the existing
+ * ProviderRegistry → McpServerAdapter composition root.
+ */
+import type { Provider, ToolRegistrar } from '../providers/types.js';
+import type { ToolEntry } from './types.js';
+export declare class CodeModeProvider implements Provider {
+    readonly name = "code-mode";
+    private readonly executor;
+    private readonly searchIndex;
+    constructor(tools: ToolEntry[]);
+    registerTools(registrar: ToolRegistrar): void;
+    registerResources(_registrar: ToolRegistrar): void;
+    ready(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/mcp/code-mode/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/mcp/code-mode/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAIrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAwC5C,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,IAAI,eAAe;IAE5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;gBAElC,KAAK,EAAE,SAAS,EAAE;IAK9B,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAuC7C,iBAAiB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IAI5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}

package/dist/mcp/code-mode/provider.js

@@ -0,0 +1,93 @@
+/**
+ * CodeModeProvider — MCP provider for code-mode execution tools.
+ *
+ * Registers two MCP tools:
+ *   - call_tool_chain: execute JavaScript in an isolated V8 sandbox with
+ *     all registered MCP tools available as synchronous functions
+ *   - search_tools: keyword search over registered tools
+ *
+ * Implements the Provider interface and integrates via the existing
+ * ProviderRegistry → McpServerAdapter composition root.
+ */
+import { z } from 'zod';
+import { toMcpResult } from '../providers/tool-helpers.js';
+import { CodeExecutor } from './executor.js';
+import { ToolSearchIndex } from './search.js';
+// ---------------------------------------------------------------------------
+// Input schemas
+// ---------------------------------------------------------------------------
+const callToolChainSchema = z.object({
+    code: z
+        .string()
+        .min(1)
+        .describe('JavaScript code to execute in the sandbox. All MCP tools are available as ' +
+        'namespaced synchronous functions (e.g. gitlab.list_issues({...})). ' +
+        'Use return to return a value.'),
+    timeout: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Execution timeout in milliseconds (default: 30000)'),
+    memoryLimitMb: z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Memory limit for the sandbox in megabytes (default: 128)'),
+});
+const searchToolsSchema = z.object({
+    query: z
+        .string()
+        .min(1)
+        .describe('Keyword query to search for matching tools by name or description'),
+});
+// ---------------------------------------------------------------------------
+// CodeModeProvider
+// ---------------------------------------------------------------------------
+export class CodeModeProvider {
+    name = 'code-mode';
+    executor;
+    searchIndex;
+    constructor(tools) {
+        this.executor = new CodeExecutor(tools);
+        this.searchIndex = new ToolSearchIndex(tools);
+    }
+    registerTools(registrar) {
+        // call_tool_chain
+        registrar.registerTool('call_tool_chain', {
+            description: 'Execute JavaScript code in a secure isolated-vm V8 sandbox. All registered MCP tools ' +
+                'are available as synchronous namespaced functions (gitlab.*, jira.*, confluence.*). ' +
+                'Console output is captured and returned alongside the execution result. ' +
+                'Use __interfaces to see all tool type definitions, or __getToolInterface(name) ' +
+                'to look up a specific tool.',
+            inputSchema: callToolChainSchema,
+        }, async (args) => {
+            const { result, logs } = await this.executor.execute(args.code, {
+                timeout: args.timeout,
+                memoryLimitMb: args.memoryLimitMb,
+            });
+            return toMcpResult({ result, logs });
+        });
+        // search_tools
+        registrar.registerTool('search_tools', {
+            description: 'Search for registered MCP tools by keyword. Returns tools whose name or description ' +
+                'matches the query, each with its full schema information.',
+            inputSchema: searchToolsSchema,
+            annotations: { readOnlyHint: true },
+        }, async (args) => {
+            const results = this.searchIndex.search(args.query);
+            return toMcpResult(results);
+        });
+    }
+    registerResources(_registrar) {
+        // No resources — code-mode is tools-only
+    }
+    async ready() {
+        // Always ready — no external service dependency
+    }
+    async shutdown() {
+        // No-op — no persistent state to clean up
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/mcp/code-mode/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/mcp/code-mode/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACP,4EAA4E;QAC5E,qEAAqE;QACrE,+BAA+B,CAChC;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,WAAW,CAAC;IAEX,QAAQ,CAAe;IACvB,WAAW,CAAkB;IAE9C,YAAY,KAAkB;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,aAAa,CAAC,SAAwB;QACpC,kBAAkB;QAClB,SAAS,CAAC,YAAY,CACpB,iBAAiB,EACjB;YACE,WAAW,EACT,uFAAuF;gBACvF,sFAAsF;gBACtF,0EAA0E;gBAC1E,iFAAiF;gBACjF,6BAA6B;YAC/B,WAAW,EAAE,mBAAmB;SACjC,EACD,KAAK,EAAE,IAAyC,EAAE,EAAE;YAClD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC9D,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAC,CAAC;YACH,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC,CACF,CAAC;QAEF,eAAe;QACf,SAAS,CAAC,YAAY,CACpB,cAAc,EACd;YACE,WAAW,EACT,sFAAsF;gBACtF,2DAA2D;YAC7D,WAAW,EAAE,iBAAiB;YAC9B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;SACpC,EACD,KAAK,EAAE,IAAuC,EAAE,EAAE;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC,CACF,CAAC;IACJ,CAAC;IAED,iBAAiB,CAAC,UAAyB;QACzC,yCAAyC;IAC3C,CAAC;IAED,KAAK,CAAC,KAAK;QACT,gDAAgD;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,0CAA0C;IAC5C,CAAC;CACF"}

package/dist/mcp/code-mode/search.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ToolSearchIndex — keyword-based search over registered MCP tools.
+ *
+ * Implements case-insensitive substring matching against both tool name
+ * and description. Returns matching tools with their full schema information.
+ */
+import type { ToolEntry } from './types.js';
+/** A search result entry — subset of ToolEntry returned to callers. */
+export interface ToolSearchResult {
+    name: string;
+    description: string;
+    namespace: string;
+    functionName: string;
+    inputSchema?: Record<string, unknown>;
+}
+export declare class ToolSearchIndex {
+    private readonly tools;
+    constructor(tools: ToolEntry[]);
+    /**
+     * Search tools by keyword query.
+     *
+     * Performs case-insensitive substring matching against both the tool name
+     * and description. Returns an empty array if query is blank.
+     *
+     * @param query  Keyword string to search for.
+     * @returns      Array of matching ToolSearchResult entries.
+     */
+    search(query: string): ToolSearchResult[];
+    /** Return all tools as search results (no filtering). */
+    getAll(): ToolSearchResult[];
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/mcp/code-mode/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/code-mode/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;gBAExB,KAAK,EAAE,SAAS,EAAE;IAI9B;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAmBzC,yDAAyD;IACzD,MAAM,IAAI,gBAAgB,EAAE;CAS7B"}

package/dist/mcp/code-mode/search.js

@@ -0,0 +1,47 @@
+/**
+ * ToolSearchIndex — keyword-based search over registered MCP tools.
+ *
+ * Implements case-insensitive substring matching against both tool name
+ * and description. Returns matching tools with their full schema information.
+ */
+export class ToolSearchIndex {
+    tools;
+    constructor(tools) {
+        this.tools = tools;
+    }
+    /**
+     * Search tools by keyword query.
+     *
+     * Performs case-insensitive substring matching against both the tool name
+     * and description. Returns an empty array if query is blank.
+     *
+     * @param query  Keyword string to search for.
+     * @returns      Array of matching ToolSearchResult entries.
+     */
+    search(query) {
+        const q = query.trim().toLowerCase();
+        if (!q)
+            return [];
+        return this.tools
+            .filter(t => t.name.toLowerCase().includes(q) ||
+            t.description.toLowerCase().includes(q))
+            .map(t => ({
+            name: t.name,
+            description: t.description,
+            namespace: t.namespace,
+            functionName: t.functionName,
+            inputSchema: t.inputSchema,
+        }));
+    }
+    /** Return all tools as search results (no filtering). */
+    getAll() {
+        return this.tools.map(t => ({
+            name: t.name,
+            description: t.description,
+            namespace: t.namespace,
+            functionName: t.functionName,
+            inputSchema: t.inputSchema,
+        }));
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/mcp/code-mode/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../src/mcp/code-mode/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,MAAM,OAAO,eAAe;IACT,KAAK,CAAc;IAEpC,YAAY,KAAkB;QAC5B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAa;QAClB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAElB,OAAO,IAAI,CAAC,KAAK;aACd,MAAM,CACL,CAAC,CAAC,EAAE,CACF,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC1C;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACT,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;IACR,CAAC;IAED,yDAAyD;IACzD,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/mcp/code-mode/tool-registry.d.ts

@@ -0,0 +1,44 @@
+/**
+ * InstrumentedToolRegistrar — wraps a ToolRegistrar and records all registered tools.
+ *
+ * The code-mode module needs a snapshot of all registered tools (name, description,
+ * inputSchema, handler) to build the sandbox tool bridge. This class wraps the real
+ * ToolRegistrar, delegating every registration call to it while also recording each
+ * tool in an internal list.
+ *
+ * Usage in the composition root:
+ *   const instrumented = new InstrumentedToolRegistrar(adapter);
+ *   registry.registerAll(instrumented);           // all 49 tools recorded
+ *   const tools = instrumented.getTools();         // snapshot passed to CodeModeProvider
+ */
+import type { ToolRegistrar } from '../providers/types.js';
+import type { ToolEntry } from './types.js';
+/**
+ * Derive the sandbox namespace and function name from an MCP tool name.
+ *
+ * Mapping rules:
+ *   - 'gitlab_*'            → namespace='gitlab',     functionName='*'
+ *   - 'atlassian_jira_*'    → namespace='jira',        functionName='*'
+ *   - 'atlassian_confluence_*' → namespace='confluence', functionName='*'
+ *   - anything else         → namespace='tools',       functionName=sanitized(name)
+ */
+export declare function deriveNamespaceAndFunction(toolName: string): {
+    namespace: string;
+    functionName: string;
+};
+/** Replace non-alphanumeric/underscore characters with underscores. */
+export declare function sanitizeIdentifier(name: string): string;
+/**
+ * Wraps a ToolRegistrar, records every tool registration, and delegates
+ * registration to the underlying registrar.
+ */
+export declare class InstrumentedToolRegistrar implements ToolRegistrar {
+    private readonly delegate;
+    private readonly tools;
+    constructor(delegate: ToolRegistrar);
+    registerTool(name: string, schema: unknown, handler: unknown): void;
+    registerResource(template: unknown, handler: unknown): void;
+    /** Return a snapshot of all registered tools. */
+    getTools(): ToolEntry[];
+}
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/mcp/code-mode/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../../src/mcp/code-mode/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAazD;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CASA;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AA8ID;;;GAGG;AACH,qBAAa,yBAA0B,YAAW,aAAa;IAGjD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAEZ,QAAQ,EAAE,aAAa;IAEpD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAiBnE,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAI3D,iDAAiD;IACjD,QAAQ,IAAI,SAAS,EAAE;CAGxB"}