langflower 0.1.0 → 0.1.2

package/vendor/shared/dist/types/langflower-workflow.d.ts

@@ -1,146 +0,0 @@
-/**
- * Workflow persistence types for `workflowManagerConfig` WS routes.
- *
- * Intents are client → server; authoritative state arrives as **broadcast
- * snapshots** (`WorkflowListSnapshotPayload`, `WorkflowCurrentSnapshotPayload`)
- * so multiple tabs apply the same slices without RPC-style replies.
- *
- * **Identity (ADR-029):** `workflowId` is the `{stem}.json` filename stem.
- * It is never stored inside `metadata` or on disk — only on bridge/session
- * payloads and as the file name.
- */
-import type { RuntimeEdge } from '@langflower/runtime';
-/** Catalog row — no nodes/edges. Identity = filename stem. */
-export type WorkflowListEntry = {
-    readonly workflowId: string;
-    readonly name: string;
-    readonly description?: string;
-    readonly createdAt: string;
-    readonly updatedAt: string;
-};
-/** User-facing fields stored beside the graph JSON (no identity). */
-export type WorkflowMetadata = {
-    readonly name: string;
-    readonly description?: string;
-    readonly createdAt: string;
-    readonly updatedAt: string;
-};
-/** Canvas layout and display-only node state. */
-export type WorkflowNodeUiState = {
-    readonly position: {
-        readonly x: number;
-        readonly y: number;
-        readonly width?: number;
-        readonly height?: number;
-    };
-    readonly label?: string;
-};
-/**
- * Persisted node — registry `type` + execution params/inputs + UI state.
- *
- * `params` — node definition config (constant value, delay ms, …).
- * `inputs` — **visible UI overrides only** (ADR-028): port has an editable
- * on-node/inspector field, and the value differs from the current definition
- * `defaultValue`. Hidden / wire-only / preview ports and default-equal values
- * are not stored; on load the server connects missing keys from the *current*
- * definition defaults.
- */
-export type WorkflowNodePersisted = {
-    readonly id: string;
-    readonly type: string;
-    readonly params: Readonly<Record<string, unknown>>;
-    readonly inputs: Readonly<Record<string, unknown>>;
-    readonly ui: WorkflowNodeUiState;
-};
-/** Shared canvas viewport — pan origin and zoom scale (flow space). */
-export type CanvasViewport = {
-    readonly x: number;
-    readonly y: number;
-    readonly scale: number;
-};
-/** Full workflow graph body (nodes + edges only). */
-export type WorkflowPersistedGraph = {
-    readonly viewport: CanvasViewport;
-    readonly nodes: readonly WorkflowNodePersisted[];
-    readonly edges: readonly RuntimeEdge[];
-};
-/** Filesystem document shape — server builds this from the session on save. */
-export type WorkflowSavePayload = {
-    readonly workflowId: string;
-    readonly metadata: WorkflowMetadata;
-    readonly graph: WorkflowPersistedGraph;
-    /** When renaming on save — previous file stem to remove. */
-    readonly previousWorkflowId?: string;
-};
-/** Client intent — load one workflow by filename stem. */
-export type WorkflowLoadPayload = {
-    readonly workflowId: string;
-};
-/** Why `workflow.load.failed` rejected a load intent. */
-export type WorkflowLoadFailedCode = 'NOT_FOUND' | 'INVALID_GRAPH' | 'UNSUPPORTED_NODE' | 'INVALID_EDGE' | 'GRAPH_LOCKED' | 'BIND_FAILED';
-/**
- * Load rejected — missing file, invalid graph, bind failure, or locked editor.
- * Unicast to the requester (see `runner.resume.failed`).
- */
-export type WorkflowLoadFailedPayload = {
-    readonly workflowId: string;
-    readonly code: WorkflowLoadFailedCode;
-    readonly message: string;
-};
-/**
- * Load succeeded after stripping unknown nodes / unbindable edges.
- * Unicast to the requester; document is dirty until Save.
- */
-export type WorkflowLoadRepairedPayload = {
-    readonly workflowId: string;
-    readonly droppedNodeIds: readonly string[];
-    readonly droppedEdgeIds: readonly string[];
-    readonly message: string;
-};
-/** Client intent — delete one persisted workflow by filename stem. */
-export type WorkflowDeletePayload = {
-    readonly workflowId: string;
-};
-/** Command — serialize the server's in-memory active workflow to disk. */
-export type WorkflowSaveCurrentPayload = Record<string, never>;
-/**
- * Command — rename the active workflow (display name + filename stem).
- * Server persists metadata and renames `{workflowId}.json` immediately
- * (partial save); unsaved graph edits stay dirty in session.
- */
-export type WorkflowRenameCurrentPayload = {
-    readonly name: string;
-};
-/** Command — start an empty unsaved workflow in the session. */
-export type WorkflowCreatePayload = Record<string, never>;
-/** Command — persist a copy of a catalog workflow and open it. */
-export type WorkflowCopyPayload = {
-    readonly workflowId: string;
-};
-/** Server fact — dirty/pristine state of the session active workflow. */
-export type WorkflowCurrentStatus = 'dirty' | 'pristine';
-export type WorkflowCurrentStatusPayload = {
-    readonly status: WorkflowCurrentStatus;
-};
-/**
- * Active workflow slice. `activeWorkflow` is `null` when none is loaded
- * (e.g. after deleting the active workflow).
- */
-export type WorkflowCurrentSnapshotPayload = {
-    readonly activeWorkflow: WorkflowLoadedPayload | null;
-    readonly currentStatus: WorkflowCurrentStatusPayload;
-};
-/**
- * Loaded workflow document (filename stem + metadata + graph).
- * On disk: optional `$schema` plus `{ metadata, graph }`; `$schema` is preserved
- * on save when present and is not part of this runtime payload.
- */
-export type WorkflowLoadedPayload = {
-    readonly workflowId: string;
-    readonly metadata: WorkflowMetadata;
-    readonly graph: WorkflowPersistedGraph;
-};
-/** Catalog snapshot — metadata rows only, no graphs. */
-export type WorkflowListSnapshotPayload = {
-    readonly workflows: readonly WorkflowListEntry[];
-};

package/vendor/shared/dist/types/langflower-workflow.js

@@ -1,12 +0,0 @@
-/**
- * Workflow persistence types for `workflowManagerConfig` WS routes.
- *
- * Intents are client → server; authoritative state arrives as **broadcast
- * snapshots** (`WorkflowListSnapshotPayload`, `WorkflowCurrentSnapshotPayload`)
- * so multiple tabs apply the same slices without RPC-style replies.
- *
- * **Identity (ADR-029):** `workflowId` is the `{stem}.json` filename stem.
- * It is never stored inside `metadata` or on disk — only on bridge/session
- * payloads and as the file name.
- */
-export {};

package/vendor/shared/dist/types/workflow-checkpoint.d.ts

@@ -1,60 +0,0 @@
-/**
- * Durable workflow-run checkpoint (ADR-018 D — explicit boundaries).
- *
- * Stored under `.langflower/runs/<workflowId>/<runId>/checkpoint.json`.
- * Only JSON-safe port values are persisted; unsupported values fail closed.
- * Writes fire only when an author-placed boundary is crossed
- * (`createCheckpoint` output meta / `common-checkpoint` node).
- */
-export type WorkflowCheckpointJsonValue = null | boolean | number | string | readonly WorkflowCheckpointJsonValue[] | {
-    readonly [key: string]: WorkflowCheckpointJsonValue;
-};
-export type WorkflowCheckpointPortSnapshot = {
-    readonly state: 'value';
-    readonly value: WorkflowCheckpointJsonValue;
-};
-export type WorkflowCheckpointStatus = 'running' | 'stopped' | 'completed' | 'failed';
-export type WorkflowCheckpoint = {
-    readonly schemaVersion: 1;
-    readonly runId: string;
-    readonly workflowId: string;
-    readonly workflowFingerprint: string;
-    readonly updatedAt: string;
-    readonly status: WorkflowCheckpointStatus;
-    readonly completedNodeIds: readonly string[];
-    readonly outputSnapshots: Readonly<Record<string, Readonly<Record<string, WorkflowCheckpointPortSnapshot>>>>;
-    /** Human-readable boundary label when the author provided one. */
-    readonly label?: string;
-};
-export type WorkflowCheckpointSummary = {
-    readonly runId: string;
-    readonly workflowId: string;
-    readonly status: WorkflowCheckpointStatus;
-    readonly updatedAt: string;
-    readonly completedNodeIds: readonly string[];
-    /** Human-readable boundary label when present. */
-    readonly label?: string;
-    /**
-     * True when the checkpoint fingerprint does not match the active
-     * workflow topology — Continue is refused; Discard remains available.
-     */
-    readonly stale?: boolean;
-    /** Present when on-disk JSON failed validation — Continue is disabled. */
-    readonly corrupt?: boolean;
-};
-export type RunnerCheckpointsSnapshotPayload = {
-    readonly workflowId: string | null;
-    readonly checkpoints: readonly WorkflowCheckpointSummary[];
-};
-export type RunnerResumeFailedCode = 'CORRUPT' | 'STALE_WORKFLOW' | 'UNSUPPORTED_VALUE' | 'NOT_FOUND' | 'BUSY' | 'NO_WORKFLOW';
-export type RunnerResumeFailedPayload = {
-    readonly code: RunnerResumeFailedCode;
-    readonly message: string;
-    readonly runId?: string;
-};
-export type RunnerResumeRequestedPayload = {
-    readonly runId: string;
-};
-export type RunnerCheckpointDiscardRequestedPayload = {
-    readonly runId: string;
-};

package/vendor/shared/dist/types/workflow-checkpoint.js

@@ -1,9 +0,0 @@
-/**
- * Durable workflow-run checkpoint (ADR-018 D — explicit boundaries).
- *
- * Stored under `.langflower/runs/<workflowId>/<runId>/checkpoint.json`.
- * Only JSON-safe port values are persisted; unsupported values fail closed.
- * Writes fire only when an author-placed boundary is crossed
- * (`createCheckpoint` output meta / `common-checkpoint` node).
- */
-export {};

package/vendor/shared/package.json

@@ -1,74 +0,0 @@
-{
-	"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

@@ -1,10 +0,0 @@
-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.js

@@ -1,144 +0,0 @@
-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/builtins/apply-post-process.d.ts

@@ -1 +0,0 @@
-export declare const applyPostProcess: (args: Readonly<Record<string, unknown>>, text: string) => string;

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

@@ -1,9 +0,0 @@
-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);
-};

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

@@ -1,3 +0,0 @@
-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;

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

@@ -1,14 +0,0 @@
-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;
-};

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

@@ -1,25 +0,0 @@
-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>;
-};

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

@@ -1,72 +0,0 @@
-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,
-};