langflower 0.0.1

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

@@ -0,0 +1,42 @@
+import type { HandlerContext } from '../types.js';
+export declare const readTool: {
+    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>;
+};
+//# sourceMappingURL=tool.d.ts.map

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

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

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

@@ -0,0 +1,97 @@
+import fs from 'node:fs/promises';
+import { formatNotFound, resolveProjectPath } from '../../path-sandbox.js';
+import { applyPostProcess } from '../apply-post-process.js';
+import { asNumber, asString } from '../args.js';
+import { fenceOptions } from '../fence.js';
+const MAX_READ_CHARS = 200_000;
+const sliceLines = (content, args) => {
+    const lines = content.split(/\r?\n/);
+    const startLine = asNumber(args, 'startLine');
+    const endLine = asNumber(args, 'endLine');
+    const offset = asNumber(args, 'offset');
+    const limit = asNumber(args, 'limit');
+    let start = 0;
+    let end = lines.length;
+    if (startLine !== undefined) {
+        start = Math.max(0, Math.floor(startLine) - 1);
+    }
+    else if (offset !== undefined) {
+        start = Math.max(0, Math.floor(offset));
+    }
+    if (endLine !== undefined) {
+        end = Math.min(lines.length, Math.floor(endLine));
+    }
+    else if (limit !== undefined) {
+        end = Math.min(lines.length, start + Math.max(0, Math.floor(limit)));
+    }
+    const sliced = lines.slice(start, end).join('\n');
+    const truncated = sliced.length > MAX_READ_CHARS
+        ? `${sliced.slice(0, MAX_READ_CHARS)}\n…[truncated at ${MAX_READ_CHARS} chars]`
+        : sliced;
+    if (end < lines.length || start > 0) {
+        return `${truncated}\n\n[lines ${start + 1}-${Math.min(end, lines.length)} of ${lines.length}; continue with startLine=${end + 1}]`;
+    }
+    return truncated;
+};
+const invoke = async (ctx, args) => {
+    const userPath = asString(args, 'path');
+    if (userPath === undefined) {
+        throw new Error('read requires string argument «path».');
+    }
+    const absolute = resolveProjectPath(ctx.projectRoot, userPath, fenceOptions(ctx));
+    let content;
+    try {
+        content = await fs.readFile(absolute, 'utf8');
+    }
+    catch (error) {
+        const code = error !== null && typeof error === 'object' && 'code' in error
+            ? String(error.code)
+            : '';
+        if (code === 'ENOENT') {
+            throw new Error(await formatNotFound(absolute, userPath));
+        }
+        throw error;
+    }
+    return applyPostProcess(args, sliceLines(content, args));
+};
+export const readTool = {
+    id: 'read',
+    registration: {
+        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: {
+                    type: 'string',
+                    description: '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: {
+                    type: 'string',
+                    description: 'Optional source of (res: string) => string applied after a successful read',
+                },
+            },
+            required: ['path'],
+            additionalProperties: false,
+        },
+    },
+    invoke,
+};
+//# sourceMappingURL=tool.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { BuiltinToolRegistration } from '../harness-types.js';
+export type { BuiltinToolRegistration };
+export type HandlerContext = {
+    readonly projectRoot: string;
+    readonly denyPaths: readonly string[];
+    /** Absolute (or project-relative) roots trusted outside the project. */
+    readonly allowedRoots: readonly string[];
+    readonly bashEnabled: boolean;
+};
+export type BuiltinTool<Id extends string = string> = {
+    readonly id: Id;
+    readonly registration: BuiltinToolRegistration;
+    readonly invoke: (ctx: HandlerContext, args: Readonly<Record<string, unknown>>) => Promise<string>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/builtins/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAExC,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,wEAAwE;IACxE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,WAAW,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI;IACrD,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,CAChB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACnC,OAAO,CAAC,MAAM,CAAC,CAAC;CACrB,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/builtins/types.ts"],"names":[],"mappings":""}

package/vendor/tools/dist/builtins/walk-files.d.ts

@@ -0,0 +1,3 @@
+export declare const globToRegExp: (pattern: string) => RegExp;
+export declare const walkFiles: (root: string, dir: string, respectGitignore: boolean) => Promise<readonly string[]>;
+//# sourceMappingURL=walk-files.d.ts.map

package/vendor/tools/dist/builtins/walk-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-files.d.ts","sourceRoot":"","sources":["../../src/builtins/walk-files.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,KAAG,MAU9C,CAAC;AAEF,eAAO,MAAM,SAAS,GACrB,MAAM,MAAM,EACZ,KAAK,MAAM,EACX,kBAAkB,OAAO,KACvB,OAAO,CAAC,SAAS,MAAM,EAAE,CAoC3B,CAAC"}

package/vendor/tools/dist/builtins/walk-files.js

@@ -0,0 +1,47 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { loadGitIgnoreMatcher } from '../gitignore.js';
+export const globToRegExp = (pattern) => {
+    const escaped = pattern
+        .replace(/\\/g, '/')
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+        .replace(/\*\*/g, '::DOUBLESTAR::')
+        .replace(/\*/g, '[^/]*')
+        .replace(/\?/g, '[^/]')
+        .replace(/::DOUBLESTAR::/g, '.*');
+    return new RegExp(`^${escaped}$`);
+};
+export const walkFiles = async (root, dir, respectGitignore) => {
+    const matcher = respectGitignore
+        ? await loadGitIgnoreMatcher(root)
+        : { ignores: () => false };
+    const out = [];
+    const visit = async (absoluteDir) => {
+        let entries;
+        try {
+            entries = await fs.readdir(absoluteDir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const absolute = path.join(absoluteDir, entry.name);
+            const relative = path
+                .relative(root, absolute)
+                .split(path.sep)
+                .join('/');
+            if (matcher.ignores(relative, entry.isDirectory())) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await visit(absolute);
+            }
+            else if (entry.isFile()) {
+                out.push(relative);
+            }
+        }
+    };
+    await visit(dir);
+    return out;
+};
+//# sourceMappingURL=walk-files.js.map

package/vendor/tools/dist/builtins/walk-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-files.js","sourceRoot":"","sources":["../../src/builtins/walk-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAU,EAAE;IACvD,MAAM,OAAO,GAAG,OAAO;SACrB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC;SACpC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC;SAClC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IAEnC,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAC7B,IAAY,EACZ,GAAW,EACX,gBAAyB,EACI,EAAE;IAC/B,MAAM,OAAO,GAAG,gBAAgB;QAC/B,CAAC,CAAC,MAAM,oBAAoB,CAAC,IAAI,CAAC;QAClC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAa,EAAE,CAAC;IAEzB,MAAM,KAAK,GAAG,KAAK,EAAE,WAAmB,EAAiB,EAAE;QAC1D,IAAI,OAAO,CAAC;QAEZ,IAAI,CAAC;YACJ,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACR,OAAO;QACR,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAI;iBACnB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;iBACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC,CAAC;YAEZ,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;gBACpD,SAAS;YACV,CAAC;YAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC3B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;QACF,CAAC;IACF,CAAC,CAAC;IAEF,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC"}

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

@@ -0,0 +1,26 @@
+import type { HandlerContext } from '../types.js';
+export declare const writeTool: {
+    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>;
+};
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/builtins/write/tool.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,aAAa,CAAC;AAyB/D,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;2BAtBhB,cAAc,QACb,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACrC,OAAO,CAAC,MAAM,CAAC;CA4CuB,CAAC"}

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

@@ -0,0 +1,41 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { resolveProjectPath } from '../../path-sandbox.js';
+import { asString } from '../args.js';
+import { fenceOptions } from '../fence.js';
+const invoke = async (ctx, args) => {
+    const userPath = asString(args, 'path');
+    const content = asString(args, 'content');
+    if (userPath === undefined || content === undefined) {
+        throw new Error('write requires string arguments «path» and «content».');
+    }
+    const absolute = resolveProjectPath(ctx.projectRoot, userPath, fenceOptions(ctx));
+    await fs.mkdir(path.dirname(absolute), { recursive: true });
+    await fs.writeFile(absolute, content, 'utf8');
+    return `Wrote «${userPath}» (${content.length} chars).`;
+};
+export const writeTool = {
+    id: 'write',
+    registration: {
+        toolId: 'write',
+        name: 'write',
+        description: 'Write or overwrite a file (creates parent directories). Prefer create for new-only files.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: {
+                    type: 'string',
+                    description: 'Project-relative file path',
+                },
+                content: {
+                    type: 'string',
+                    description: 'Full file contents',
+                },
+            },
+            required: ['path', 'content'],
+            additionalProperties: false,
+        },
+    },
+    invoke,
+};
+//# sourceMappingURL=tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/builtins/write/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,MAAM,MAAM,GAAG,KAAK,EACnB,GAAmB,EACnB,IAAuC,EACrB,EAAE;IACpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAE1C,IAAI,QAAQ,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACd,uDAAuD,CACvD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,CAClC,GAAG,CAAC,WAAW,EACf,QAAQ,EACR,YAAY,CAAC,GAAG,CAAC,CACjB,CAAC;IACF,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,UAAU,QAAQ,MAAM,OAAO,CAAC,MAAM,UAAU,CAAC;AACzD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG;IACxB,EAAE,EAAE,OAAO;IACX,YAAY,EAAE;QACb,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,OAAO;QACb,WAAW,EACV,2FAA2F;QAC5F,WAAW,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACX,IAAI,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,4BAA4B;iBACzC;gBACD,OAAO,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oBAAoB;iBACjC;aACD;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;YAC7B,oBAAoB,EAAE,KAAK;SAC3B;KACD;IACD,MAAM;CACkC,CAAC"}

package/vendor/tools/dist/create-crawl-context.d.ts

@@ -0,0 +1,23 @@
+/** Structural match for node-sdk `CrawlSavedPage`. */
+export type CrawlSavedPage = {
+    readonly url: string;
+    readonly html: string;
+    readonly text: string;
+    readonly title?: string;
+    readonly savedPath: string;
+};
+/** Structural match for node-sdk `CrawlContext`. */
+export type CrawlContext = {
+    readonly runId: string;
+    readonly savePage: (page: {
+        readonly url: string;
+        readonly html: string;
+        readonly text: string;
+        readonly title?: string;
+    }) => Promise<CrawlSavedPage>;
+};
+/**
+ * Persist crawl pages under `<project>/.langflower/crawl/{runId}/`.
+ */
+export declare const createCrawlContext: (projectDir: string, runId: string) => CrawlContext;
+//# sourceMappingURL=create-crawl-context.d.ts.map

package/vendor/tools/dist/create-crawl-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-crawl-context.d.ts","sourceRoot":"","sources":["../src/create-crawl-context.ts"],"names":[],"mappings":"AAGA,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;QACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACxB,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CAC9B,CAAC;AAKF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC9B,YAAY,MAAM,EAClB,OAAO,MAAM,KACX,YAkCF,CAAC"}

package/vendor/tools/dist/create-crawl-context.js

@@ -0,0 +1,35 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const sanitizeSegment = (value) => value.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 80);
+/**
+ * Persist crawl pages under `<project>/.langflower/crawl/{runId}/`.
+ */
+export const createCrawlContext = (projectDir, runId) => {
+    const safeRunId = sanitizeSegment(runId || 'run');
+    const rootDir = path.join(projectDir, '.langflower', 'crawl', safeRunId);
+    let sequence = 0;
+    return {
+        runId: safeRunId,
+        savePage: async (page) => {
+            await fs.mkdir(rootDir, { recursive: true });
+            sequence += 1;
+            const stem = `${String(sequence).padStart(4, '0')}-${sanitizeSegment(page.url)}`;
+            const fileName = `${stem}.json`;
+            const savedPath = path.join(rootDir, fileName);
+            const record = {
+                url: page.url,
+                html: page.html,
+                text: page.text,
+                ...(page.title !== undefined && page.title.length > 0
+                    ? { title: page.title }
+                    : {}),
+                savedPath: path
+                    .relative(projectDir, savedPath)
+                    .replace(/\\/g, '/'),
+            };
+            await fs.writeFile(savedPath, `${JSON.stringify(record, null, 2)}\n`, 'utf8');
+            return record;
+        },
+    };
+};
+//# sourceMappingURL=create-crawl-context.js.map

package/vendor/tools/dist/create-crawl-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-crawl-context.js","sourceRoot":"","sources":["../src/create-crawl-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAsB7B,MAAM,eAAe,GAAG,CAAC,KAAa,EAAU,EAAE,CACjD,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,UAAkB,EAClB,KAAa,EACE,EAAE;IACjB,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACzE,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,OAAO;QACN,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,KAAK,EAAE,IAAI,EAA2B,EAAE;YACjD,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,QAAQ,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACjF,MAAM,QAAQ,GAAG,GAAG,IAAI,OAAO,CAAC;YAChC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAmB;gBAC9B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;oBACpD,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE;oBACvB,CAAC,CAAC,EAAE,CAAC;gBACN,SAAS,EAAE,IAAI;qBACb,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;qBAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;aACrB,CAAC;YAEF,MAAM,EAAE,CAAC,SAAS,CACjB,SAAS,EACT,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EACtC,MAAM,CACN,CAAC;YAEF,OAAO,MAAM,CAAC;QACf,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/vendor/tools/dist/create-memory-context.d.ts

@@ -0,0 +1,12 @@
+export type MemoryContext = {
+    readonly runId: string;
+    readonly get: (key: string) => Promise<string | undefined>;
+    readonly set: (key: string, value: string) => Promise<void>;
+    readonly list: () => Promise<readonly string[]>;
+    readonly delete: (key: string) => Promise<boolean>;
+};
+/**
+ * Run-scoped key/value store under `.langflower/runs/{runId}/memory/`.
+ */
+export declare const createMemoryContext: (projectDir: string, runId: string) => MemoryContext;
+//# sourceMappingURL=create-memory-context.d.ts.map

package/vendor/tools/dist/create-memory-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-memory-context.d.ts","sourceRoot":"","sources":["../src/create-memory-context.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,aAAa,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC3D,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACnD,CAAC;AAuBF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC/B,YAAY,MAAM,EAClB,OAAO,MAAM,KACX,aA+EF,CAAC"}

package/vendor/tools/dist/create-memory-context.js

@@ -0,0 +1,84 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const sanitizeKey = (key) => {
+    const trimmed = key.trim();
+    if (trimmed.length === 0) {
+        throw new Error('Memory key is required.');
+    }
+    if (trimmed.includes('..') ||
+        trimmed.includes('/') ||
+        trimmed.includes('\\')) {
+        throw new Error(`Invalid memory key «${key}».`);
+    }
+    return trimmed.replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 120);
+};
+const sanitizeRunId = (runId) => (runId || 'run').replace(/[^a-zA-Z0-9._-]+/g, '_').slice(0, 80);
+/**
+ * Run-scoped key/value store under `.langflower/runs/{runId}/memory/`.
+ */
+export const createMemoryContext = (projectDir, runId) => {
+    const safeRunId = sanitizeRunId(runId);
+    const rootDir = path.join(projectDir, '.langflower', 'runs', safeRunId, 'memory');
+    const filePath = (key) => path.join(rootDir, `${sanitizeKey(key)}.txt`);
+    return {
+        runId: safeRunId,
+        get: async (key) => {
+            try {
+                return await fs.readFile(filePath(key), 'utf8');
+            }
+            catch (error) {
+                const code = error !== null &&
+                    typeof error === 'object' &&
+                    'code' in error
+                    ? String(error.code)
+                    : '';
+                if (code === 'ENOENT') {
+                    return undefined;
+                }
+                throw error;
+            }
+        },
+        set: async (key, value) => {
+            await fs.mkdir(rootDir, { recursive: true });
+            await fs.writeFile(filePath(key), value, 'utf8');
+        },
+        list: async () => {
+            try {
+                const entries = await fs.readdir(rootDir);
+                return entries
+                    .filter((name) => name.endsWith('.txt'))
+                    .map((name) => name.slice(0, -'.txt'.length))
+                    .sort((a, b) => a.localeCompare(b));
+            }
+            catch (error) {
+                const code = error !== null &&
+                    typeof error === 'object' &&
+                    'code' in error
+                    ? String(error.code)
+                    : '';
+                if (code === 'ENOENT') {
+                    return [];
+                }
+                throw error;
+            }
+        },
+        delete: async (key) => {
+            try {
+                await fs.unlink(filePath(key));
+                return true;
+            }
+            catch (error) {
+                const code = error !== null &&
+                    typeof error === 'object' &&
+                    'code' in error
+                    ? String(error.code)
+                    : '';
+                if (code === 'ENOENT') {
+                    return false;
+                }
+                throw error;
+            }
+        },
+    };
+};
+//# sourceMappingURL=create-memory-context.js.map

package/vendor/tools/dist/create-memory-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-memory-context.js","sourceRoot":"","sources":["../src/create-memory-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAU7B,MAAM,WAAW,GAAG,CAAC,GAAW,EAAU,EAAE;IAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C,CAAC;IAED,IACC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EACrB,CAAC;QACF,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE,CAC/C,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAClC,UAAkB,EAClB,KAAa,EACG,EAAE;IAClB,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACxB,UAAU,EACV,aAAa,EACb,MAAM,EACN,SAAS,EACT,QAAQ,CACR,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAU,EAAE,CACxC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/C,OAAO;QACN,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YAClB,IAAI,CAAC;gBACJ,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,IAAI,GACT,KAAK,KAAK,IAAI;oBACd,OAAO,KAAK,KAAK,QAAQ;oBACzB,MAAM,IAAI,KAAK;oBACd,CAAC,CAAC,MAAM,CAAE,KAA2B,CAAC,IAAI,CAAC;oBAC3C,CAAC,CAAC,EAAE,CAAC;gBAEP,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvB,OAAO,SAAS,CAAC;gBAClB,CAAC;gBAED,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;QACD,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACzB,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,CAAC;gBACJ,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC1C,OAAO,OAAO;qBACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;qBACvC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;qBAC5C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,IAAI,GACT,KAAK,KAAK,IAAI;oBACd,OAAO,KAAK,KAAK,QAAQ;oBACzB,MAAM,IAAI,KAAK;oBACd,CAAC,CAAC,MAAM,CAAE,KAA2B,CAAC,IAAI,CAAC;oBAC3C,CAAC,CAAC,EAAE,CAAC;gBAEP,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvB,OAAO,EAAE,CAAC;gBACX,CAAC;gBAED,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;YACrB,IAAI,CAAC;gBACJ,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACb,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBAChB,MAAM,IAAI,GACT,KAAK,KAAK,IAAI;oBACd,OAAO,KAAK,KAAK,QAAQ;oBACzB,MAAM,IAAI,KAAK;oBACd,CAAC,CAAC,MAAM,CAAE,KAA2B,CAAC,IAAI,CAAC;oBAC3C,CAAC,CAAC,EAAE,CAAC;gBAEP,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACvB,OAAO,KAAK,CAAC;gBACd,CAAC;gBAED,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC,CAAC"}

package/vendor/tools/dist/create-project-files-context.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Permission-free project file I/O for palette graph nodes (Text Read/Write/Append).
+ * Author placing the node is the allow decision — no HITL ask.
+ * Absolute paths are rejected; only project-relative paths under the fence.
+ */
+export type ProjectFilesContext = {
+    readonly read: (relativePath: string) => Promise<string>;
+    readonly write: (relativePath: string, content: string) => Promise<void>;
+    readonly append: (relativePath: string, content: string, delimiter: string) => Promise<void>;
+};
+export type CreateProjectFilesContextOptions = {
+    readonly projectRoot: string;
+    readonly denyPaths?: readonly string[];
+};
+/**
+ * Project-root file helpers for graph nodes. Fence + deny list only —
+ * no permission gate (unlike harness builtins).
+ */
+export declare const createProjectFilesContext: (options: CreateProjectFilesContextOptions) => ProjectFilesContext;
+//# sourceMappingURL=create-project-files-context.d.ts.map

package/vendor/tools/dist/create-project-files-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project-files-context.d.ts","sourceRoot":"","sources":["../src/create-project-files-context.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,QAAQ,CAAC,MAAM,EAAE,CAChB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC9C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,CAAC;AA+BF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACrC,SAAS,gCAAgC,KACvC,mBA+DF,CAAC"}

package/vendor/tools/dist/create-project-files-context.js

@@ -0,0 +1,76 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { formatNotFound, resolveProjectPath } from './path-sandbox.js';
+const assertProjectRelativePath = (userPath) => {
+    const trimmed = userPath.trim();
+    if (trimmed.length === 0) {
+        throw new Error('Path is required.');
+    }
+    if (path.isAbsolute(trimmed)) {
+        throw new Error(`Absolute paths are not allowed: «${userPath}». Use a path relative to the project root.`);
+    }
+    return trimmed;
+};
+const resolveRelativeUnderProject = (projectRoot, userPath, denyPaths) => {
+    const relative = assertProjectRelativePath(userPath);
+    return resolveProjectPath(projectRoot, relative, {
+        ...(denyPaths !== undefined ? { denyPaths } : {}),
+        allowedRoots: [],
+    });
+};
+/**
+ * Project-root file helpers for graph nodes. Fence + deny list only —
+ * no permission gate (unlike harness builtins).
+ */
+export const createProjectFilesContext = (options) => {
+    const projectRoot = options.projectRoot;
+    const denyPaths = options.denyPaths;
+    const resolve = (userPath) => resolveRelativeUnderProject(projectRoot, userPath, denyPaths);
+    return {
+        read: async (relativePath) => {
+            const absolute = resolve(relativePath);
+            try {
+                return await fs.readFile(absolute, 'utf8');
+            }
+            catch (error) {
+                const code = error !== null &&
+                    typeof error === 'object' &&
+                    'code' in error
+                    ? String(error.code)
+                    : '';
+                if (code === 'ENOENT') {
+                    throw new Error(await formatNotFound(absolute, relativePath.trim()));
+                }
+                throw error;
+            }
+        },
+        write: async (relativePath, content) => {
+            const absolute = resolve(relativePath);
+            await fs.mkdir(path.dirname(absolute), { recursive: true });
+            await fs.writeFile(absolute, content, 'utf8');
+        },
+        append: async (relativePath, content, delimiter) => {
+            const absolute = resolve(relativePath);
+            let existing = '';
+            try {
+                existing = await fs.readFile(absolute, 'utf8');
+            }
+            catch (error) {
+                const code = error !== null &&
+                    typeof error === 'object' &&
+                    'code' in error
+                    ? String(error.code)
+                    : '';
+                if (code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+            const next = existing.length === 0
+                ? content
+                : `${existing}${delimiter}${content}`;
+            await fs.mkdir(path.dirname(absolute), { recursive: true });
+            await fs.writeFile(absolute, next, 'utf8');
+        },
+    };
+};
+//# sourceMappingURL=create-project-files-context.js.map

package/vendor/tools/dist/create-project-files-context.js.map

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