langflower 0.1.0 → 0.1.2

package/vendor/common-nodes/dist/kb/kb-store.js

@@ -1,290 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { cosineSimilarity } from './cosine.js';
-import { chunkText } from './chunk-text.js';
-import { kbChunksPath, kbCollectionDir, kbManifestPath, kbRootDir, kbVectorsPath, sanitizeCollectionId, } from './kb-paths.js';
-import { embedTextLocal, LOCAL_EMBED_DIMS } from './local-embed.js';
-const emptyManifest = () => ({ collections: [] });
-const readJsonFile = async (filePath, fallback) => {
-    try {
-        const raw = await fs.readFile(filePath, 'utf8');
-        return JSON.parse(raw);
-    }
-    catch (error) {
-        if (typeof error === 'object' &&
-            error !== null &&
-            'code' in error &&
-            error.code === 'ENOENT') {
-            return fallback;
-        }
-        throw error;
-    }
-};
-const ensureDir = async (dir) => {
-    await fs.mkdir(dir, { recursive: true });
-};
-const readChunks = async (projectDir, collectionId) => {
-    const filePath = kbChunksPath(projectDir, collectionId);
-    try {
-        const raw = await fs.readFile(filePath, 'utf8');
-        return raw
-            .split('\n')
-            .map((line) => line.trim())
-            .filter((line) => line.length > 0)
-            .map((line) => JSON.parse(line));
-    }
-    catch (error) {
-        if (typeof error === 'object' &&
-            error !== null &&
-            'code' in error &&
-            error.code === 'ENOENT') {
-            return [];
-        }
-        throw error;
-    }
-};
-const writeChunks = async (projectDir, collectionId, chunks) => {
-    await ensureDir(kbCollectionDir(projectDir, collectionId));
-    const body = chunks.length === 0
-        ? ''
-        : `${chunks.map((chunk) => JSON.stringify(chunk)).join('\n')}\n`;
-    await fs.writeFile(kbChunksPath(projectDir, collectionId), body, 'utf8');
-};
-const readVectors = async (projectDir, collectionId, dims, expectedCount) => {
-    const filePath = kbVectorsPath(projectDir, collectionId);
-    try {
-        const buf = await fs.readFile(filePath);
-        const floats = new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / 4);
-        if (dims <= 0 || floats.length === 0) {
-            return [];
-        }
-        const count = Math.floor(floats.length / dims);
-        const vectors = [];
-        for (let i = 0; i < count; i += 1) {
-            vectors.push(floats.slice(i * dims, (i + 1) * dims));
-        }
-        if (expectedCount > 0 && vectors.length !== expectedCount) {
-            return vectors.slice(0, Math.min(vectors.length, expectedCount));
-        }
-        return vectors;
-    }
-    catch (error) {
-        if (typeof error === 'object' &&
-            error !== null &&
-            'code' in error &&
-            error.code === 'ENOENT') {
-            return [];
-        }
-        throw error;
-    }
-};
-const writeVectors = async (projectDir, collectionId, vectors) => {
-    await ensureDir(kbCollectionDir(projectDir, collectionId));
-    if (vectors.length === 0) {
-        await fs.writeFile(kbVectorsPath(projectDir, collectionId), Buffer.alloc(0));
-        return;
-    }
-    const dims = vectors[0].length;
-    const out = new Float32Array(vectors.length * dims);
-    for (let i = 0; i < vectors.length; i += 1) {
-        const vec = vectors[i];
-        if (vec.length !== dims) {
-            throw new Error('vector dimension mismatch in collection');
-        }
-        out.set(vec, i * dims);
-    }
-    await fs.writeFile(kbVectorsPath(projectDir, collectionId), Buffer.from(out.buffer, out.byteOffset, out.byteLength));
-};
-const touchManifest = async (projectDir, collectionId, chunkCount) => {
-    await ensureDir(kbRootDir(projectDir));
-    const id = sanitizeCollectionId(collectionId);
-    const manifest = await readJsonFile(kbManifestPath(projectDir), emptyManifest());
-    const updatedAt = new Date().toISOString();
-    const others = manifest.collections.filter((entry) => entry.id !== id);
-    const next = {
-        collections: [
-            ...others,
-            { id, updatedAt, chunkCount },
-        ].sort((a, b) => a.id.localeCompare(b.id)),
-    };
-    await fs.writeFile(kbManifestPath(projectDir), `${JSON.stringify(next, null, '\t')}\n`, 'utf8');
-};
-const defaultEmbedTexts = async (texts) => texts.map((text) => embedTextLocal(text));
-export const ingestText = async (args) => {
-    const collectionId = sanitizeCollectionId(args.collectionId);
-    const pieces = chunkText(args.text);
-    if (pieces.length === 0) {
-        return [];
-    }
-    const documentId = args.documentId?.trim() || randomUUID();
-    const existing = await readChunks(args.projectDir, collectionId);
-    const created = pieces.map((text, index) => ({
-        id: `${documentId}:${index}`,
-        text,
-        meta: {
-            documentId,
-            chunkIndex: index,
-            ...(args.source !== undefined && args.source.length > 0
-                ? { source: args.source }
-                : {}),
-        },
-    }));
-    const next = [...existing, ...created];
-    await writeChunks(args.projectDir, collectionId, next);
-    // New chunks invalidate trailing vectors; keep prefix alignment only when
-    // previous vectors match prior chunk count.
-    const priorVectors = await readVectors(args.projectDir, collectionId, LOCAL_EMBED_DIMS, existing.length);
-    const kept = priorVectors.length === existing.length
-        ? priorVectors
-        : [];
-    await writeVectors(args.projectDir, collectionId, kept);
-    await touchManifest(args.projectDir, collectionId, next.length);
-    return created.map((chunk) => chunk.id);
-};
-export const embedCollection = async (args) => {
-    const collectionId = sanitizeCollectionId(args.collectionId);
-    const chunks = await readChunks(args.projectDir, collectionId);
-    if (chunks.length === 0) {
-        return 0;
-    }
-    const embedTexts = args.embedTexts ?? defaultEmbedTexts;
-    const vectors = await embedTexts(chunks.map((chunk) => chunk.text));
-    await writeVectors(args.projectDir, collectionId, vectors);
-    await touchManifest(args.projectDir, collectionId, chunks.length);
-    return vectors.length;
-};
-export const searchCollection = async (args) => {
-    const collectionId = sanitizeCollectionId(args.collectionId);
-    const topK = Math.max(1, args.topK ?? 5);
-    const chunks = await readChunks(args.projectDir, collectionId);
-    if (chunks.length === 0) {
-        return [];
-    }
-    const embedTexts = args.embedTexts ?? defaultEmbedTexts;
-    const queryVec = (await embedTexts([args.query]))[0];
-    if (queryVec === undefined) {
-        return [];
-    }
-    let vectors = await readVectors(args.projectDir, collectionId, queryVec.length, chunks.length);
-    if (vectors.length !== chunks.length) {
-        vectors = [...(await embedTexts(chunks.map((chunk) => chunk.text)))];
-        await writeVectors(args.projectDir, collectionId, vectors);
-    }
-    const ranked = chunks
-        .map((chunk, index) => ({
-        id: chunk.id,
-        text: chunk.text,
-        meta: chunk.meta,
-        score: cosineSimilarity(queryVec, vectors[index]),
-    }))
-        .sort((a, b) => b.score - a.score)
-        .slice(0, topK);
-    return ranked;
-};
-export const listKb = async (args) => {
-    const manifest = await readJsonFile(kbManifestPath(args.projectDir), emptyManifest());
-    const collectionFilter = args.collectionId?.trim();
-    if (collectionFilter === undefined || collectionFilter.length === 0) {
-        return manifest.collections.map((entry) => ({
-            kind: 'collection',
-            id: entry.id,
-            detail: `${entry.chunkCount} chunks`,
-        }));
-    }
-    const collectionId = sanitizeCollectionId(collectionFilter);
-    const chunks = await readChunks(args.projectDir, collectionId);
-    const byDoc = new Map();
-    for (const chunk of chunks) {
-        const documentId = typeof chunk.meta.documentId === 'string'
-            ? chunk.meta.documentId
-            : chunk.id;
-        byDoc.set(documentId, (byDoc.get(documentId) ?? 0) + 1);
-    }
-    return [...byDoc.entries()].map(([id, count]) => ({
-        kind: 'document',
-        id,
-        detail: `${count} chunks`,
-    }));
-};
-export const deleteFromKb = async (args) => {
-    const collectionId = sanitizeCollectionId(args.collectionId);
-    const chunks = await readChunks(args.projectDir, collectionId);
-    if (chunks.length === 0) {
-        return 0;
-    }
-    const chunkIdSet = args.chunkIds !== undefined && args.chunkIds.length > 0
-        ? new Set(args.chunkIds)
-        : null;
-    const documentId = args.documentId?.trim() ?? '';
-    const deleteAll = chunkIdSet === null && documentId.length === 0;
-    if (deleteAll) {
-        await fs.rm(kbCollectionDir(args.projectDir, collectionId), {
-            recursive: true,
-            force: true,
-        });
-        const manifest = await readJsonFile(kbManifestPath(args.projectDir), emptyManifest());
-        const nextManifest = {
-            collections: manifest.collections.filter((entry) => entry.id !== collectionId),
-        };
-        await ensureDir(kbRootDir(args.projectDir));
-        await fs.writeFile(kbManifestPath(args.projectDir), `${JSON.stringify(nextManifest, null, '\t')}\n`, 'utf8');
-        return chunks.length;
-    }
-    const next = chunks.filter((chunk) => {
-        if (chunkIdSet !== null && chunkIdSet.has(chunk.id)) {
-            return false;
-        }
-        if (documentId.length > 0 &&
-            chunk.meta.documentId === documentId) {
-            return false;
-        }
-        return true;
-    });
-    const removed = chunks.length - next.length;
-    await writeChunks(args.projectDir, collectionId, next);
-    // Drop vectors — re-embed after selective delete.
-    await writeVectors(args.projectDir, collectionId, []);
-    await touchManifest(args.projectDir, collectionId, next.length);
-    return removed;
-};
-export const parseStringList = (value) => {
-    if (Array.isArray(value)) {
-        return value.map((item) => String(item));
-    }
-    if (typeof value !== 'string') {
-        return [];
-    }
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-        return [];
-    }
-    if (trimmed.startsWith('[')) {
-        const parsed = JSON.parse(trimmed);
-        if (!Array.isArray(parsed)) {
-            throw new Error('expected JSON array of strings');
-        }
-        return parsed.map((item) => String(item));
-    }
-    return trimmed
-        .split(/[\n,]+/)
-        .map((part) => part.trim())
-        .filter((part) => part.length > 0);
-};
-export const resolveEmbedTexts = (createEmbedding) => {
-    if (createEmbedding === undefined) {
-        return defaultEmbedTexts;
-    }
-    return createEmbedding;
-};
-/** Exposed for tests that need a direct path check. */
-export const kbCollectionExists = async (projectDir, collectionId) => {
-    try {
-        await fs.access(path.join(kbCollectionDir(projectDir, collectionId)));
-        return true;
-    }
-    catch {
-        return false;
-    }
-};
-//# sourceMappingURL=kb-store.js.map

package/vendor/common-nodes/dist/kb/kb-tools/node.d.ts

@@ -1,25 +0,0 @@
-/**
- * Emits KB ToolHandles. Invokers come from `@langflower/tools`; no harness
- * tool-id registry participates in agent inventory.
- */
-export declare const kbToolsNode: {
-    readonly emitOncePerActivation: boolean;
-    readonly stopsRun: boolean;
-    readonly chatEntry: boolean;
-    readonly uiSchema: readonly [];
-    readonly bypassPorts: Record<string, import("@langflower/node-sdk").WireType>;
-    readonly inputsConfigs: readonly [import("@langflower/node-sdk").InputPortMeta<import("@langflower/node-sdk").ExecutionContext<readonly [], Record<string, never>>>, ...import("@langflower/node-sdk").InputPortMeta<unknown>[]];
-    readonly outputsConfigs: (({
-        readonly wireType: string;
-    } | {
-        readonly inferTypeFrom: import("@langflower/node-sdk").InputParams<unknown> | import("@rx-evo/stateful-observable").StatefulObservable<unknown, unknown, import("@langflower/node-sdk").PortMeta>;
-    }) & import("@langflower/node-sdk").OutputParams & import("@langflower/node-sdk").PortMeta)[];
-    readonly getInstance: () => import("@langflower/node-sdk").ReactiveNodeInstance<readonly [], Record<string, never>>;
-    readonly paletteSecondary?: true;
-    readonly description?: string;
-    readonly type: string;
-    readonly displayName: string;
-    readonly category: string | undefined;
-    readonly icon: string | undefined;
-};
-//# sourceMappingURL=node.d.ts.map

package/vendor/common-nodes/dist/kb/kb-tools/node.js

@@ -1,14 +0,0 @@
-import { defineToolRegistrations } from '@langflower/node-sdk';
-import { KB_TOOL_CONFIGS } from '@langflower/tools/domain-tool-configs';
-/**
- * Emits KB ToolHandles. Invokers come from `@langflower/tools`; no harness
- * tool-id registry participates in agent inventory.
- */
-export const kbToolsNode = defineToolRegistrations({
-    type: 'common-kb-tools',
-    displayName: 'KB Tools',
-    category: 'KB',
-    description: 'Emits kb_ingest / kb_embed / kb_search / kb_list / kb_delete with imported handlers for agent inventory.',
-    tools: KB_TOOL_CONFIGS,
-});
-//# sourceMappingURL=node.js.map

package/vendor/common-nodes/dist/kb/local-embed.d.ts

@@ -1,9 +0,0 @@
-/** Fixed local embedding size (hashing trick). Offline MVP for epic 10. */
-export declare const LOCAL_EMBED_DIMS = 64;
-/**
- * Deterministic bag-of-tokens hashing embedder. Good enough for fixture
- * relevance tests without an external embedding API.
- */
-export declare const embedTextLocal: (text: string) => Float32Array;
-export declare const l2Normalize: (vec: Float32Array) => Float32Array;
-//# sourceMappingURL=local-embed.d.ts.map

package/vendor/common-nodes/dist/kb/local-embed.js

@@ -1,41 +0,0 @@
-/** Fixed local embedding size (hashing trick). Offline MVP for epic 10. */
-export const LOCAL_EMBED_DIMS = 64;
-/**
- * Deterministic bag-of-tokens hashing embedder. Good enough for fixture
- * relevance tests without an external embedding API.
- */
-export const embedTextLocal = (text) => {
-    const vec = new Float32Array(LOCAL_EMBED_DIMS);
-    const tokens = text
-        .toLowerCase()
-        .split(/[^a-z0-9_]+/i)
-        .filter((token) => token.length > 0);
-    for (const token of tokens) {
-        let hash = 2166136261;
-        for (let i = 0; i < token.length; i += 1) {
-            hash ^= token.charCodeAt(i);
-            hash = Math.imul(hash, 16777619);
-        }
-        const index = (hash >>> 0) % LOCAL_EMBED_DIMS;
-        vec[index] += 1;
-        const index2 = ((hash >>> 8) ^ token.length) % LOCAL_EMBED_DIMS;
-        vec[index2] += 0.5;
-    }
-    return l2Normalize(vec);
-};
-export const l2Normalize = (vec) => {
-    let sumSquares = 0;
-    for (let i = 0; i < vec.length; i += 1) {
-        sumSquares += vec[i] * vec[i];
-    }
-    if (sumSquares <= 0) {
-        return vec;
-    }
-    const scale = 1 / Math.sqrt(sumSquares);
-    const out = new Float32Array(vec.length);
-    for (let i = 0; i < vec.length; i += 1) {
-        out[i] = vec[i] * scale;
-    }
-    return out;
-};
-//# sourceMappingURL=local-embed.js.map

package/vendor/common-nodes/dist/kb/parse-string-list.d.ts

@@ -1,3 +0,0 @@
-/** Parse a JSON string array, comma/newline list, or string[]. */
-export declare const parseStringList: (value: unknown) => readonly string[];
-//# sourceMappingURL=parse-string-list.d.ts.map

package/vendor/common-nodes/dist/kb/parse-string-list.js

@@ -1,25 +0,0 @@
-/** Parse a JSON string array, comma/newline list, or string[]. */
-export const parseStringList = (value) => {
-    if (Array.isArray(value)) {
-        return value.map((item) => String(item));
-    }
-    if (typeof value !== 'string') {
-        return [];
-    }
-    const trimmed = value.trim();
-    if (trimmed.length === 0) {
-        return [];
-    }
-    if (trimmed.startsWith('[')) {
-        const parsed = JSON.parse(trimmed);
-        if (!Array.isArray(parsed)) {
-            throw new Error('expected JSON array of strings');
-        }
-        return parsed.map((item) => String(item));
-    }
-    return trimmed
-        .split(/[\n,]+/)
-        .map((part) => part.trim())
-        .filter((part) => part.length > 0);
-};
-//# sourceMappingURL=parse-string-list.js.map

package/vendor/common-nodes/dist/kb/tool-defs.d.ts

@@ -1,85 +0,0 @@
-export declare const KB_TOOL_DEFS: readonly [{
-    readonly toolId: "kb_ingest";
-    readonly description: "Ingest text into a KB collection (chunked).";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly collectionId: {
-                readonly type: "string";
-            };
-            readonly text: {
-                readonly type: "string";
-            };
-            readonly documentId: {
-                readonly type: "string";
-            };
-            readonly source: {
-                readonly type: "string";
-            };
-        };
-        readonly required: readonly ["collectionId", "text"];
-    };
-}, {
-    readonly toolId: "kb_embed";
-    readonly description: "Embed pending chunks in a KB collection.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly collectionId: {
-                readonly type: "string";
-            };
-        };
-        readonly required: readonly ["collectionId"];
-    };
-}, {
-    readonly toolId: "kb_search";
-    readonly description: "Semantic search over a KB collection.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly collectionId: {
-                readonly type: "string";
-            };
-            readonly query: {
-                readonly type: "string";
-            };
-            readonly topK: {
-                readonly type: "number";
-            };
-        };
-        readonly required: readonly ["collectionId", "query"];
-    };
-}, {
-    readonly toolId: "kb_list";
-    readonly description: "List collections, documents, or chunks.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly collectionId: {
-                readonly type: "string";
-            };
-        };
-    };
-}, {
-    readonly toolId: "kb_delete";
-    readonly description: "Delete a collection, document, or chunk ids.";
-    readonly inputSchema: {
-        readonly type: "object";
-        readonly properties: {
-            readonly collectionId: {
-                readonly type: "string";
-            };
-            readonly documentId: {
-                readonly type: "string";
-            };
-            readonly chunkIds: {
-                readonly type: "array";
-                readonly items: {
-                    readonly type: "string";
-                };
-            };
-        };
-        readonly required: readonly ["collectionId"];
-    };
-}];
-//# sourceMappingURL=tool-defs.d.ts.map

package/vendor/common-nodes/dist/kb/tool-defs.js

@@ -1,67 +0,0 @@
-export const KB_TOOL_DEFS = [
-    {
-        toolId: 'kb_ingest',
-        description: 'Ingest text into a KB collection (chunked).',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                collectionId: { type: 'string' },
-                text: { type: 'string' },
-                documentId: { type: 'string' },
-                source: { type: 'string' },
-            },
-            required: ['collectionId', 'text'],
-        },
-    },
-    {
-        toolId: 'kb_embed',
-        description: 'Embed pending chunks in a KB collection.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                collectionId: { type: 'string' },
-            },
-            required: ['collectionId'],
-        },
-    },
-    {
-        toolId: 'kb_search',
-        description: 'Semantic search over a KB collection.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                collectionId: { type: 'string' },
-                query: { type: 'string' },
-                topK: { type: 'number' },
-            },
-            required: ['collectionId', 'query'],
-        },
-    },
-    {
-        toolId: 'kb_list',
-        description: 'List collections, documents, or chunks.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                collectionId: { type: 'string' },
-            },
-        },
-    },
-    {
-        toolId: 'kb_delete',
-        description: 'Delete a collection, document, or chunk ids.',
-        inputSchema: {
-            type: 'object',
-            properties: {
-                collectionId: { type: 'string' },
-                documentId: { type: 'string' },
-                chunkIds: {
-                    type: 'array',
-                    items: { type: 'string' },
-                },
-            },
-            required: ['collectionId'],
-        },
-    },
-];
-//# sourceMappingURL=tool-defs.js.map

package/vendor/common-nodes/dist/langflower-tools/emit-registration-tools.d.ts

@@ -1,18 +0,0 @@
-import { type ToolHandle, type ToolHandler } from '@langflower/node-sdk';
-import { type Observable } from 'rxjs';
-type RegistrationTool = {
-    readonly toolId: string;
-    readonly name?: string;
-    readonly description: string;
-    readonly inputSchema: object;
-    readonly handler: ToolHandler;
-};
-/**
- * Emit a `tools` pack, peeking **this** node's EC at invoke so bus RPC
- * stays on the pack instance (not agent `toolCtx`). Local to this folder —
- * not the author SDK factory.
- */
-export declare const emitRegistrationTools: (ctx: {
-    readonly value$: Observable<unknown>;
-}, tools: readonly RegistrationTool[]) => import("@rx-evo/stateful-observable").StatefulObservable<ToolHandle[], unknown, undefined>;
-export {};

package/vendor/common-nodes/dist/langflower-tools/emit-registration-tools.js

@@ -1,29 +0,0 @@
-import { statefulObservable } from '@rx-evo/stateful-observable';
-import { of } from 'rxjs';
-const peekNodeContext = (source) => {
-    let peeked;
-    const sub = source.value$.subscribe((value) => {
-        peeked = value;
-    });
-    sub.unsubscribe();
-    return typeof peeked === 'object' && peeked !== null
-        ? peeked
-        : undefined;
-};
-/**
- * Emit a `tools` pack, peeking **this** node's EC at invoke so bus RPC
- * stays on the pack instance (not agent `toolCtx`). Local to this folder —
- * not the author SDK factory.
- */
-export const emitRegistrationTools = (ctx, tools) => statefulObservable({
-    loader: () => of(tools.map((tool) => ({
-        toolId: tool.toolId,
-        name: tool.name ?? tool.toolId,
-        description: tool.description,
-        inputSchema: tool.inputSchema,
-        invoke: (args, agentCtx) => {
-            const nodeCtx = peekNodeContext(ctx);
-            return tool.handler(args, nodeCtx ?? agentCtx);
-        },
-    }))),
-});

package/vendor/common-nodes/dist/langflower-tools/node.d.ts

@@ -1,20 +0,0 @@
-/**
- * Emits Langflower bus tools for agent inventory. Recompile is unsafe:
- * wire this node’s `tools` into the agent (starter Helper / Writer).
- */
-export declare const langflowerToolsNode: {
-    readonly emitOncePerActivation: boolean;
-    readonly stopsRun: boolean;
-    readonly chatEntry: boolean;
-    readonly uiSchema: readonly [];
-    readonly bypassPorts: Record<string, import("@langflower/node-sdk").WireType>;
-    readonly inputsConfigs: readonly [import("@langflower/node-sdk").InputPortMeta<import("@langflower/node-sdk").ExecutionContext<readonly [], Record<string, never>>>, ...import("@langflower/node-sdk").InputPortMeta<unknown>[]];
-    readonly outputsConfigs: (import("@langflower/node-sdk").OutputParams & import("@langflower/node-sdk").PortMeta)[];
-    readonly getInstance: () => import("@langflower/node-sdk").ReactiveNodeInstance<readonly [], Record<string, never>>;
-    readonly paletteSecondary?: true;
-    readonly description?: string;
-    readonly type: string;
-    readonly displayName: string;
-    readonly category: string | undefined;
-    readonly icon: string | undefined;
-};