langflower 0.0.1

package/vendor/shared/package.json

@@ -0,0 +1,74 @@
+{
+	"name": "@langflower/shared",
+	"version": "0.1.0",
+	"type": "module",
+	"main": "./dist/constants/defaults.js",
+	"types": "./dist/constants/defaults.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/constants/defaults.d.ts",
+			"import": "./dist/constants/defaults.js"
+		},
+		"./constants/defaults": {
+			"types": "./dist/constants/defaults.d.ts",
+			"import": "./dist/constants/defaults.js"
+		},
+		"./constants/defaults.js": {
+			"types": "./dist/constants/defaults.d.ts",
+			"import": "./dist/constants/defaults.js"
+		},
+		"./types/config": {
+			"types": "./dist/types/config.d.ts",
+			"import": "./dist/types/config.js"
+		},
+		"./types/config.js": {
+			"types": "./dist/types/config.d.ts",
+			"import": "./dist/types/config.js"
+		},
+		"./langflower": {
+			"types": "./dist/langflower.d.ts",
+			"import": "./dist/langflower.js"
+		},
+		"./langflower.js": {
+			"types": "./dist/langflower.d.ts",
+			"import": "./dist/langflower.js"
+		},
+		"./langflower-ws-waits": {
+			"types": "./dist/langflower-ws-waits.d.ts",
+			"import": "./dist/langflower-ws-waits.js"
+		},
+		"./langflower-ws-waits.js": {
+			"types": "./dist/langflower-ws-waits.d.ts",
+			"import": "./dist/langflower-ws-waits.js"
+		},
+		"./types/langflower-server": {
+			"types": "./dist/types/langflower-server.d.ts",
+			"import": "./dist/types/langflower-server.js"
+		},
+		"./types/langflower-workflow": {
+			"types": "./dist/types/langflower-workflow.d.ts",
+			"import": "./dist/types/langflower-workflow.js"
+		},
+		"./types/langflower-bootstrap": {
+			"types": "./dist/types/langflower-bootstrap.d.ts",
+			"import": "./dist/types/langflower-bootstrap.js"
+		},
+		"./types/langflower-config": {
+			"types": "./dist/types/langflower-config.d.ts",
+			"import": "./dist/types/langflower-config.js"
+		},
+		"./types/langflower-palette": {
+			"types": "./dist/types/langflower-palette.d.ts",
+			"import": "./dist/types/langflower-palette.js"
+		}
+	},
+	"dependencies": {
+		"@langflower/node-sdk": "file:../node-sdk",
+		"@langflower/runtime": "file:../runtime",
+		"@langflower/websocket-bridge": "file:../websocket-bridge",
+		"rxjs": "^7.8.1"
+	},
+	"files": [
+		"dist"
+	]
+}

package/vendor/tools/dist/builtin-schemas.d.ts

@@ -0,0 +1,10 @@
+export declare const BUILTIN_TOOL_IDS: readonly ["read", "glob", "grep", "edit", "write", "create", "delete", "bash"];
+export type BuiltinToolId = (typeof BUILTIN_TOOL_IDS)[number];
+export type BuiltinToolRegistration = {
+    readonly toolId: string;
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: object;
+};
+export declare const BUILTIN_REGISTRATIONS: readonly BuiltinToolRegistration[];
+//# sourceMappingURL=builtin-schemas.d.ts.map

package/vendor/tools/dist/builtin-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-schemas.d.ts","sourceRoot":"","sources":["../src/builtin-schemas.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,gFASnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC7B,CAAC;AAOF,eAAO,MAAM,qBAAqB,EAAE,SAAS,uBAAuB,EA6InE,CAAC"}

package/vendor/tools/dist/builtin-schemas.js

@@ -0,0 +1,144 @@
+export const BUILTIN_TOOL_IDS = [
+    'read',
+    'glob',
+    'grep',
+    'edit',
+    'write',
+    'create',
+    'delete',
+    'bash',
+];
+const stringProp = (description) => ({
+    type: 'string',
+    description,
+});
+export const BUILTIN_REGISTRATIONS = [
+    {
+        toolId: 'read',
+        name: 'read',
+        description: 'Read a file under the project root. Optional startLine/endLine (1-based) or offset/limit (byte-ish line slices). Optional postProcess: source of (res: string) => string.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: stringProp('Project-relative file path'),
+                startLine: { type: 'number', description: '1-based start line' },
+                endLine: { type: 'number', description: '1-based end line (inclusive)' },
+                offset: { type: 'number', description: '0-based line offset' },
+                limit: { type: 'number', description: 'Max lines to return' },
+                postProcess: stringProp('Optional source of (res: string) => string applied after a successful read'),
+            },
+            required: ['path'],
+            additionalProperties: false,
+        },
+    },
+    {
+        toolId: 'glob',
+        name: 'glob',
+        description: 'List files matching a glob under the project root (gitignore-aware by default). Optional postProcess.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pattern: stringProp('Glob pattern, e.g. **/*.ts'),
+                cwd: stringProp('Optional subdirectory relative to project root'),
+                respectGitignore: {
+                    type: 'boolean',
+                    description: 'Default true',
+                },
+                postProcess: stringProp('Optional source of (res: string) => string'),
+            },
+            required: ['pattern'],
+            additionalProperties: false,
+        },
+    },
+    {
+        toolId: 'grep',
+        name: 'grep',
+        description: 'Regex search across project files (gitignore-aware by default; Node walk — not ripgrep). Optional postProcess.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                pattern: stringProp('JavaScript RegExp source'),
+                path: stringProp('Optional subdirectory or file to search'),
+                caseInsensitive: { type: 'boolean' },
+                respectGitignore: {
+                    type: 'boolean',
+                    description: 'Default true',
+                },
+                postProcess: stringProp('Optional source of (res: string) => string'),
+            },
+            required: ['pattern'],
+            additionalProperties: false,
+        },
+    },
+    {
+        toolId: 'edit',
+        name: 'edit',
+        description: 'Exact string replace in a file. Fails if oldString is missing or not unique.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: stringProp('Project-relative file path'),
+                oldString: stringProp('Exact text to find'),
+                newString: stringProp('Replacement text'),
+            },
+            required: ['path', 'oldString', 'newString'],
+            additionalProperties: false,
+        },
+    },
+    {
+        toolId: 'write',
+        name: 'write',
+        description: 'Write or overwrite a file (creates parent directories). Prefer create for new-only files.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: stringProp('Project-relative file path'),
+                content: stringProp('Full file contents'),
+            },
+            required: ['path', 'content'],
+            additionalProperties: false,
+        },
+    },
+    {
+        toolId: 'create',
+        name: 'create',
+        description: 'Create a new file. Fails if the path already exists (use write to overwrite).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: stringProp('Project-relative file path'),
+                content: stringProp('Initial file contents'),
+            },
+            required: ['path', 'content'],
+            additionalProperties: false,
+        },
+    },
+    {
+        toolId: 'delete',
+        name: 'delete',
+        description: 'Delete a file under the project root.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: stringProp('Project-relative file path'),
+            },
+            required: ['path'],
+            additionalProperties: false,
+        },
+    },
+    {
+        toolId: 'bash',
+        name: 'bash',
+        description: 'Run a shell command in the project root. Disabled unless the harness enables bash (default-deny). Not read-class — no postProcess.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                command: stringProp('Shell command to run'),
+                cwd: stringProp('Optional subdirectory relative to project root'),
+            },
+            required: ['command'],
+            additionalProperties: false,
+        },
+    },
+];
+//# sourceMappingURL=builtin-schemas.js.map

package/vendor/tools/dist/builtin-schemas.js.map

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

package/vendor/tools/dist/builtins/apply-post-process.d.ts

@@ -0,0 +1,2 @@
+export declare const applyPostProcess: (args: Readonly<Record<string, unknown>>, text: string) => string;
+//# sourceMappingURL=apply-post-process.d.ts.map

package/vendor/tools/dist/builtins/apply-post-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-post-process.d.ts","sourceRoot":"","sources":["../../src/builtins/apply-post-process.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,gBAAgB,GAC5B,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,MAAM,MAAM,KACV,MAQF,CAAC"}

package/vendor/tools/dist/builtins/apply-post-process.js

@@ -0,0 +1,10 @@
+import { runReadClassPostProcess } from '../post-process.js';
+import { asString } from './args.js';
+export const applyPostProcess = (args, text) => {
+    const source = asString(args, 'postProcess');
+    if (source === undefined || source.trim().length === 0) {
+        return text;
+    }
+    return runReadClassPostProcess(source, text);
+};
+//# sourceMappingURL=apply-post-process.js.map

package/vendor/tools/dist/builtins/apply-post-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-post-process.js","sourceRoot":"","sources":["../../src/builtins/apply-post-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC/B,IAAuC,EACvC,IAAY,EACH,EAAE;IACX,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAE7C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9C,CAAC,CAAC"}

package/vendor/tools/dist/builtins/args.d.ts

@@ -0,0 +1,4 @@
+export declare const asString: (args: Readonly<Record<string, unknown>>, key: string) => string | undefined;
+export declare const asNumber: (args: Readonly<Record<string, unknown>>, key: string) => number | undefined;
+export declare const asBoolean: (args: Readonly<Record<string, unknown>>, key: string, defaultValue: boolean) => boolean;
+//# sourceMappingURL=args.d.ts.map

package/vendor/tools/dist/builtins/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/builtins/args.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,GACpB,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,KAAK,MAAM,KACT,MAAM,GAAG,SAGX,CAAC;AAEF,eAAO,MAAM,QAAQ,GACpB,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,KAAK,MAAM,KACT,MAAM,GAAG,SAKX,CAAC;AAEF,eAAO,MAAM,SAAS,GACrB,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACvC,KAAK,MAAM,EACX,cAAc,OAAO,KACnB,OAGF,CAAC"}

package/vendor/tools/dist/builtins/args.js

@@ -0,0 +1,15 @@
+export const asString = (args, key) => {
+    const value = args[key];
+    return typeof value === 'string' ? value : undefined;
+};
+export const asNumber = (args, key) => {
+    const value = args[key];
+    return typeof value === 'number' && Number.isFinite(value)
+        ? value
+        : undefined;
+};
+export const asBoolean = (args, key, defaultValue) => {
+    const value = args[key];
+    return typeof value === 'boolean' ? value : defaultValue;
+};
+//# sourceMappingURL=args.js.map

package/vendor/tools/dist/builtins/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/builtins/args.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CACvB,IAAuC,EACvC,GAAW,EACU,EAAE;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,CACvB,IAAuC,EACvC,GAAW,EACU,EAAE;IACvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACzD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CACxB,IAAuC,EACvC,GAAW,EACX,YAAqB,EACX,EAAE;IACZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC,CAAC"}

package/vendor/tools/dist/builtins/bash/tool.d.ts

@@ -0,0 +1,26 @@
+import type { HandlerContext } from '../types.js';
+export declare const bashTool: {
+    readonly id: "bash";
+    readonly registration: {
+        readonly toolId: "bash";
+        readonly name: "bash";
+        readonly description: "Run a shell command in the project root. Disabled unless the harness enables bash (default-deny). Not read-class — no postProcess.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly command: {
+                    readonly type: "string";
+                    readonly description: "Shell command to run";
+                };
+                readonly cwd: {
+                    readonly type: "string";
+                    readonly description: "Optional subdirectory relative to project root";
+                };
+            };
+            readonly required: readonly ["command"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+};
+//# sourceMappingURL=tool.d.ts.map

package/vendor/tools/dist/builtins/bash/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/builtins/bash/tool.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AA0D/D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;2BArDf,cAAc,QACb,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACrC,OAAO,CAAC,MAAM,CAAC;CA4EsB,CAAC"}

package/vendor/tools/dist/builtins/bash/tool.js

@@ -0,0 +1,73 @@
+import { spawn } from 'node:child_process';
+import { resolveProjectPath } from '../../path-sandbox.js';
+import { asString } from '../args.js';
+import { fenceOptions } from '../fence.js';
+const MAX_BASH_OUTPUT = 100_000;
+const invoke = async (ctx, args) => {
+    if (!ctx.bashEnabled) {
+        throw new Error('bash is disabled (default-deny). Enable bash on the project harness to run shell commands.');
+    }
+    const command = asString(args, 'command');
+    if (command === undefined || command.trim().length === 0) {
+        throw new Error('bash requires string argument «command».');
+    }
+    const cwdArg = asString(args, 'cwd') ?? '.';
+    const cwd = resolveProjectPath(ctx.projectRoot, cwdArg, fenceOptions(ctx));
+    return await new Promise((resolve, reject) => {
+        const child = spawn(command, {
+            cwd,
+            shell: true,
+            windowsHide: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (chunk) => {
+            stdout += String(chunk);
+            if (stdout.length > MAX_BASH_OUTPUT) {
+                stdout = stdout.slice(0, MAX_BASH_OUTPUT);
+            }
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += String(chunk);
+            if (stderr.length > MAX_BASH_OUTPUT) {
+                stderr = stderr.slice(0, MAX_BASH_OUTPUT);
+            }
+        });
+        child.on('error', (error) => {
+            reject(error);
+        });
+        child.on('close', (code) => {
+            const combined = [
+                `exit ${code ?? 'null'}`,
+                stdout.length > 0 ? `stdout:\n${stdout}` : 'stdout: (empty)',
+                stderr.length > 0 ? `stderr:\n${stderr}` : 'stderr: (empty)',
+            ].join('\n');
+            resolve(combined);
+        });
+    });
+};
+export const bashTool = {
+    id: 'bash',
+    registration: {
+        toolId: 'bash',
+        name: 'bash',
+        description: 'Run a shell command in the project root. Disabled unless the harness enables bash (default-deny). Not read-class — no postProcess.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                command: {
+                    type: 'string',
+                    description: 'Shell command to run',
+                },
+                cwd: {
+                    type: 'string',
+                    description: 'Optional subdirectory relative to project root',
+                },
+            },
+            required: ['command'],
+            additionalProperties: false,
+        },
+    },
+    invoke,
+};
+//# sourceMappingURL=tool.js.map

package/vendor/tools/dist/builtins/bash/tool.js.map

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

package/vendor/tools/dist/builtins/catalog.d.ts

@@ -0,0 +1,229 @@
+import type { BuiltinToolRegistration, HandlerContext } from './types.js';
+/** Composer: builtin order for inventory + invoke dispatch. */
+export declare const BUILTIN_TOOLS: readonly [{
+    readonly id: "read";
+    readonly registration: {
+        readonly toolId: "read";
+        readonly name: "read";
+        readonly description: "Read a file under the project root. Optional startLine/endLine (1-based) or offset/limit (byte-ish line slices). Optional postProcess: source of (res: string) => string.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                    readonly description: "Project-relative file path";
+                };
+                readonly startLine: {
+                    readonly type: "number";
+                    readonly description: "1-based start line";
+                };
+                readonly endLine: {
+                    readonly type: "number";
+                    readonly description: "1-based end line (inclusive)";
+                };
+                readonly offset: {
+                    readonly type: "number";
+                    readonly description: "0-based line offset";
+                };
+                readonly limit: {
+                    readonly type: "number";
+                    readonly description: "Max lines to return";
+                };
+                readonly postProcess: {
+                    readonly type: "string";
+                    readonly description: "Optional source of (res: string) => string applied after a successful read";
+                };
+            };
+            readonly required: readonly ["path"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}, {
+    readonly id: "glob";
+    readonly registration: {
+        readonly toolId: "glob";
+        readonly name: "glob";
+        readonly description: "List files matching a glob under the project root (gitignore-aware by default). Optional postProcess.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly pattern: {
+                    readonly type: "string";
+                    readonly description: "Glob pattern, e.g. **/*.ts";
+                };
+                readonly cwd: {
+                    readonly type: "string";
+                    readonly description: "Optional subdirectory relative to project root";
+                };
+                readonly respectGitignore: {
+                    readonly type: "boolean";
+                    readonly description: "Default true";
+                };
+                readonly postProcess: {
+                    readonly type: "string";
+                    readonly description: "Optional source of (res: string) => string";
+                };
+            };
+            readonly required: readonly ["pattern"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}, {
+    readonly id: "grep";
+    readonly registration: {
+        readonly toolId: "grep";
+        readonly name: "grep";
+        readonly description: "Regex search across project files (gitignore-aware by default; Node walk — not ripgrep). Optional postProcess.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly pattern: {
+                    readonly type: "string";
+                    readonly description: "JavaScript RegExp source";
+                };
+                readonly path: {
+                    readonly type: "string";
+                    readonly description: "Optional subdirectory or file to search";
+                };
+                readonly caseInsensitive: {
+                    readonly type: "boolean";
+                };
+                readonly respectGitignore: {
+                    readonly type: "boolean";
+                    readonly description: "Default true";
+                };
+                readonly postProcess: {
+                    readonly type: "string";
+                    readonly description: "Optional source of (res: string) => string";
+                };
+            };
+            readonly required: readonly ["pattern"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}, {
+    readonly id: "edit";
+    readonly registration: {
+        readonly toolId: "edit";
+        readonly name: "edit";
+        readonly description: "Exact string replace in a file. Fails if oldString is missing or not unique.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                    readonly description: "Project-relative file path";
+                };
+                readonly oldString: {
+                    readonly type: "string";
+                    readonly description: "Exact text to find";
+                };
+                readonly newString: {
+                    readonly type: "string";
+                    readonly description: "Replacement text";
+                };
+            };
+            readonly required: readonly ["path", "oldString", "newString"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}, {
+    readonly id: "write";
+    readonly registration: {
+        readonly toolId: "write";
+        readonly name: "write";
+        readonly description: "Write or overwrite a file (creates parent directories). Prefer create for new-only files.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                    readonly description: "Project-relative file path";
+                };
+                readonly content: {
+                    readonly type: "string";
+                    readonly description: "Full file contents";
+                };
+            };
+            readonly required: readonly ["path", "content"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}, {
+    readonly id: "create";
+    readonly registration: {
+        readonly toolId: "create";
+        readonly name: "create";
+        readonly description: "Create a new file. Fails if the path already exists (use write to overwrite).";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                    readonly description: "Project-relative file path";
+                };
+                readonly content: {
+                    readonly type: "string";
+                    readonly description: "Initial file contents";
+                };
+            };
+            readonly required: readonly ["path", "content"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}, {
+    readonly id: "delete";
+    readonly registration: {
+        readonly toolId: "delete";
+        readonly name: "delete";
+        readonly description: "Delete a file under the project root.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly path: {
+                    readonly type: "string";
+                    readonly description: "Project-relative file path";
+                };
+            };
+            readonly required: readonly ["path"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}, {
+    readonly id: "bash";
+    readonly registration: {
+        readonly toolId: "bash";
+        readonly name: "bash";
+        readonly description: "Run a shell command in the project root. Disabled unless the harness enables bash (default-deny). Not read-class — no postProcess.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly command: {
+                    readonly type: "string";
+                    readonly description: "Shell command to run";
+                };
+                readonly cwd: {
+                    readonly type: "string";
+                    readonly description: "Optional subdirectory relative to project root";
+                };
+            };
+            readonly required: readonly ["command"];
+            readonly additionalProperties: false;
+        };
+    };
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+}];
+export type BuiltinToolId = (typeof BUILTIN_TOOLS)[number]['id'];
+export declare const BUILTIN_TOOL_IDS: readonly BuiltinToolId[];
+export declare const BUILTIN_REGISTRATIONS: readonly BuiltinToolRegistration[];
+export declare const isBuiltinToolId: (toolId: string) => toolId is BuiltinToolId;
+export declare const invokeBuiltin: (toolId: BuiltinToolId, ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+export type { BuiltinToolRegistration, HandlerContext };
+//# sourceMappingURL=catalog.d.ts.map

package/vendor/tools/dist/builtins/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/builtins/catalog.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,uBAAuB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG1E,+DAA+D;AAC/D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAShB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EAEpD,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,uBAAuB,EACrB,CAAC;AAQhD,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI,aAC/B,CAAC;AAE7B,eAAO,MAAM,aAAa,GACzB,QAAQ,aAAa,EACrB,KAAK,cAAc,EACnB,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACrC,OAAO,CAAC,MAAM,CAAmC,CAAC;AAErD,YAAY,EAAE,uBAAuB,EAAE,cAAc,EAAE,CAAC"}