@pikku/addon-graph 0.12.4 → 0.12.6

package/dist/src/functions/network/http-request.function.test.js

@@ -0,0 +1,119 @@
+import { describe, test, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { httpRequest } from './http-request.function.js';
+let captured;
+const realFetch = globalThis.fetch;
+const secrets = {
+    getSecret: async (key) => {
+        const store = {
+            'my-token': 'sk-abc123',
+            'basic-cred': 'alice:s3cret',
+        };
+        if (!(key in store))
+            throw new Error(`Secret "${key}" not found`);
+        return store[key];
+    },
+};
+const call = (data) => httpRequest.func({ secrets }, data);
+beforeEach(() => {
+    captured = undefined;
+    globalThis.fetch = (async (url, opts) => {
+        captured = {
+            url: url.toString(),
+            headers: { ...(opts?.headers ?? {}) },
+        };
+        return {
+            status: 200,
+            text: async () => JSON.stringify({ ok: true }),
+        };
+    });
+});
+afterEach(() => {
+    globalThis.fetch = realFetch;
+});
+describe('graph:httpRequest auth injection', () => {
+    test('no auth descriptor behaves as before — no Authorization header', async () => {
+        await call({ method: 'GET', url: 'https://api.test/thing' });
+        assert.equal(captured.url, 'https://api.test/thing');
+        assert.equal(captured.headers['Authorization'], undefined);
+    });
+    test('bearer mode injects Authorization: Bearer <secret>', async () => {
+        await call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            auth: { mode: 'bearer', credential: 'my-token' },
+        });
+        assert.equal(captured.headers['Authorization'], 'Bearer sk-abc123');
+    });
+    test('apiKeyHeader mode uses the given header name with the raw secret', async () => {
+        await call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            auth: {
+                mode: 'apiKeyHeader',
+                credential: 'my-token',
+                headerName: 'X-API-Key',
+            },
+        });
+        assert.equal(captured.headers['X-API-Key'], 'sk-abc123');
+        assert.equal(captured.headers['Authorization'], undefined);
+    });
+    test('apiKeyHeader defaults the header name to Authorization', async () => {
+        await call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            auth: { mode: 'apiKeyHeader', credential: 'my-token' },
+        });
+        assert.equal(captured.headers['Authorization'], 'sk-abc123');
+    });
+    test('apiKeyQuery mode appends the secret as a query param', async () => {
+        await call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            auth: {
+                mode: 'apiKeyQuery',
+                credential: 'my-token',
+                queryName: 'api_key',
+            },
+        });
+        assert.match(captured.url, /[?&]api_key=sk-abc123/);
+    });
+    test('basic mode base64-encodes user:pass into Authorization: Basic', async () => {
+        await call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            auth: { mode: 'basic', credential: 'basic-cred' },
+        });
+        const expected = 'Basic ' + Buffer.from('alice:s3cret').toString('base64');
+        assert.equal(captured.headers['Authorization'], expected);
+    });
+    test('extraHeaders are merged and never overwrite an explicit user header', async () => {
+        await call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            headers: { 'Notion-Version': '2099-01-01' },
+            auth: {
+                mode: 'bearer',
+                credential: 'my-token',
+                extraHeaders: { 'Notion-Version': '2022-06-28' },
+            },
+        });
+        assert.equal(captured.headers['Notion-Version'], '2099-01-01');
+        assert.equal(captured.headers['Authorization'], 'Bearer sk-abc123');
+    });
+    test('a missing secret throws an error naming the credential', async () => {
+        await assert.rejects(call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            auth: { mode: 'bearer', credential: 'not-provisioned' },
+        }), /not-provisioned/);
+    });
+    test('oauth2 mode throws a clear not-yet-supported error', async () => {
+        await assert.rejects(call({
+            method: 'GET',
+            url: 'https://api.test/thing',
+            auth: { mode: 'oauth2', credential: 'my-token' },
+        }), /OAuth2/i);
+    });
+});
+//# sourceMappingURL=http-request.function.test.js.map

package/dist/src/functions/network/http-request.function.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-request.function.test.js","sourceRoot":"","sources":["../../../../src/functions/network/http-request.function.test.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/transform/concat.function.d.ts

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+export declare const ConcatInput: z.ZodObject<{
+    inputs: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const ConcatOutput: z.ZodObject<{
+    items: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strip>;
+export declare const concat: import("#pikku").PikkuFunctionConfig<{
+    inputs: unknown[];
+}, {
+    items: unknown[];
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    inputs: unknown[];
+}, {
+    items: unknown[];
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    inputs: unknown[];
+}, {
+    items: unknown[];
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=concat.function.d.ts.map

package/dist/src/functions/transform/concat.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/transform/concat.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,WAAW;;iBAMtB,CAAA;AAEF,eAAO,MAAM,YAAY;;iBAIvB,CAAA;AAIF,eAAO,MAAM,MAAM;;;;;;;;;;;;uEAQjB,CAAA"}

package/dist/src/functions/transform/concat.function.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const ConcatInput = z.object({
+    inputs: z
+        .array(z.unknown())
+        .describe('The input streams to concatenate; each array is flattened one level, each non-array counts as a single item'),
+});
+export const ConcatOutput = z.object({
+    items: z
+        .array(z.unknown())
+        .describe('All input items concatenated in input order'),
+});
+export const concat = pikkuSessionlessFunc({
+    description: 'Concatenate multiple input streams into one list',
+    node: { displayName: 'Concat', category: 'Transform', type: 'action' },
+    input: ConcatInput,
+    output: ConcatOutput,
+    func: async (_services, data) => ({
+        items: data.inputs.flatMap((v) => (Array.isArray(v) ? v : [v])),
+    }),
+});
+//# sourceMappingURL=concat.function.js.map

package/dist/src/functions/transform/concat.function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.function.js","sourceRoot":"","sources":["../../../../src/functions/transform/concat.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAE7C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC;SACN,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAClB,QAAQ,CACP,6GAA6G,CAC9G;CACJ,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;SAClB,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,MAAM,GAAG,oBAAoB,CAAC;IACzC,WAAW,EAAE,kDAAkD;IAC/D,IAAI,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE;IACtE,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAChC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAChE,CAAC;CACH,CAAC,CAAA"}

package/dist/src/functions/transform/concat.function.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=concat.function.test.d.ts.map

package/dist/src/functions/transform/concat.function.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.function.test.d.ts","sourceRoot":"","sources":["../../../../src/functions/transform/concat.function.test.ts"],"names":[],"mappings":""}

package/dist/src/functions/transform/concat.function.test.js

@@ -0,0 +1,23 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert/strict';
+import { concat } from './concat.function.js';
+const call = (data) => concat.func({}, data);
+describe('graph:concat', () => {
+    test('concatenates two array streams in order', async () => {
+        const out = await call({
+            inputs: [[{ id: 1 }, { id: 2 }], [{ id: 3 }]],
+        });
+        assert.deepEqual(out, { items: [{ id: 1 }, { id: 2 }, { id: 3 }] });
+    });
+    test('wraps non-array inputs (a single object counts as one item)', async () => {
+        const out = await call({
+            inputs: [{ a: 1 }, [{ b: 2 }, { b: 3 }]],
+        });
+        assert.deepEqual(out, { items: [{ a: 1 }, { b: 2 }, { b: 3 }] });
+    });
+    test('an empty input list yields an empty stream', async () => {
+        const out = await call({ inputs: [] });
+        assert.deepEqual(out, { items: [] });
+    });
+});
+//# sourceMappingURL=concat.function.test.js.map

package/dist/src/functions/transform/concat.function.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.function.test.js","sourceRoot":"","sources":["../../../../src/functions/transform/concat.function.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,MAAM,MAAM,oBAAoB,CAAA;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,MAAM,IAAI,GAAG,CAAC,IAAS,EAAE,EAAE,CAAE,MAAc,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;AAE1D,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC;YACrB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;SAC9C,CAAC,CAAA;QACF,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IACrE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC7E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC;YACrB,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;SACzC,CAAC,CAAA;QACF,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAClE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QACtC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;IACtC,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/functions/transform/edit-fields.function.d.ts

@@ -12,9 +12,12 @@ export declare const EditFieldsInput: z.ZodObject<{
         newName: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export declare const EditFieldsOutput: z.ZodObject<{
-    item: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strip>;
+/**
+ * The transformed object, exposed directly as the output so downstream graph
+ * nodes can reference its fields (`ref('setNode', 'email')`) rather than having
+ * to reach through an `item` wrapper.
+ */
+export declare const EditFieldsOutput: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 export declare const editFields: import("#pikku").PikkuFunctionConfig<{
     item: Record<string, unknown>;
     operations: {
@@ -23,9 +26,7 @@ export declare const editFields: import("#pikku").PikkuFunctionConfig<{
         value?: unknown;
         newName?: string | undefined;
     }[];
-}, {
-    item: Record<string, unknown>;
-}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+}, Record<string, unknown>, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
     item: Record<string, unknown>;
     operations: {
         field: string;
@@ -33,9 +34,7 @@ export declare const editFields: import("#pikku").PikkuFunctionConfig<{
         value?: unknown;
         newName?: string | undefined;
     }[];
-}, {
-    item: Record<string, unknown>;
-}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+}, Record<string, unknown>, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
     item: Record<string, unknown>;
     operations: {
         field: string;
@@ -43,7 +42,5 @@ export declare const editFields: import("#pikku").PikkuFunctionConfig<{
         value?: unknown;
         newName?: string | undefined;
     }[];
-}, {
-    item: Record<string, unknown>;
-}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+}, Record<string, unknown>, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
 //# sourceMappingURL=edit-fields.function.d.ts.map

package/dist/src/functions/transform/edit-fields.function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edit-fields.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/transform/edit-fields.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoBvB,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAO1B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;iBAE3B,CAAA;AA0DF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uEA4BrB,CAAA"}
+{"version":3,"file":"edit-fields.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/transform/edit-fields.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoBvB,eAAO,MAAM,eAAe;;;;;;;;;;;;iBAO1B,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,wCAEQ,CAAA;AAwDrC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;gGA4BrB,CAAA"}

package/dist/src/functions/transform/edit-fields.function.js

@@ -24,9 +24,14 @@ export const EditFieldsInput = z.object({
         .array(FieldOperationSchema)
         .describe('List of field operations to perform'),
 });
-export const EditFieldsOutput = z.object({
-    item: z.record(z.string(), z.unknown()).describe('The transformed object'),
-});
+/**
+ * The transformed object, exposed directly as the output so downstream graph
+ * nodes can reference its fields (`ref('setNode', 'email')`) rather than having
+ * to reach through an `item` wrapper.
+ */
+export const EditFieldsOutput = z
+    .record(z.string(), z.unknown())
+    .describe('The transformed object');
 const setNestedValue = (obj, path, value) => {
     const keys = path.split('.');
     let current = obj;
@@ -89,7 +94,7 @@ export const editFields = pikkuSessionlessFunc({
                     break;
             }
         }
-        return { item: result };
+        return result;
     },
 });
 //# sourceMappingURL=edit-fields.function.js.map

package/dist/src/functions/transform/edit-fields.function.js.map

@@ -1 +1 @@
-{"version":3,"file":"edit-fields.function.js","sourceRoot":"","sources":["../../../../src/functions/transform/edit-fields.function.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"edit-fields.function.js","sourceRoot":"","sources":["../../../../src/functions/transform/edit-fields.function.ts"],"names":[],"mappings":"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"}

package/dist/src/functions/transform/split-text.function.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+export declare const SplitTextInput: z.ZodObject<{
+    text: z.ZodString;
+    strategy: z.ZodOptional<z.ZodEnum<{
+        token: "token";
+        recursive: "recursive";
+        character: "character";
+    }>>;
+    chunkSize: z.ZodOptional<z.ZodNumber>;
+    chunkOverlap: z.ZodOptional<z.ZodNumber>;
+    separator: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SplitTextOutput: z.ZodObject<{
+    chunks: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const splitText: import("#pikku").PikkuFunctionConfig<{
+    text: string;
+    strategy?: "token" | "recursive" | "character" | undefined;
+    chunkSize?: number | undefined;
+    chunkOverlap?: number | undefined;
+    separator?: string | undefined;
+}, {
+    chunks: string[];
+}, "rpc" | "session", import("#pikku").PikkuFunctionSessionless<{
+    text: string;
+    strategy?: "token" | "recursive" | "character" | undefined;
+    chunkSize?: number | undefined;
+    chunkOverlap?: number | undefined;
+    separator?: string | undefined;
+}, {
+    chunks: string[];
+}, "rpc" | "session", import("#pikku").Services> | import("#pikku").PikkuFunction<{
+    text: string;
+    strategy?: "token" | "recursive" | "character" | undefined;
+    chunkSize?: number | undefined;
+    chunkOverlap?: number | undefined;
+    separator?: string | undefined;
+}, {
+    chunks: string[];
+}, "rpc" | "session", import("#pikku").Services>, undefined, undefined>;
+//# sourceMappingURL=split-text.function.d.ts.map

package/dist/src/functions/transform/split-text.function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-text.function.d.ts","sourceRoot":"","sources":["../../../../src/functions/transform/split-text.function.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,cAAc;;;;;;;;;;iBA0BzB,CAAA;AAEF,eAAO,MAAM,eAAe;;iBAE1B,CAAA;AA2FF,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;uEAqCpB,CAAA"}

package/dist/src/functions/transform/split-text.function.js

@@ -0,0 +1,116 @@
+import { z } from 'zod';
+import { pikkuSessionlessFunc } from '#pikku';
+export const SplitTextInput = z.object({
+    text: z.string().describe('The text to split into chunks'),
+    strategy: z
+        .enum(['recursive', 'character', 'token'])
+        .optional()
+        .describe('Splitting strategy: recursive (paragraph→line→word hierarchy, default), character (single separator), or token (approximate token budget)'),
+    chunkSize: z
+        .number()
+        .min(1)
+        .optional()
+        .describe('Maximum size of each chunk (characters, or tokens for the token strategy; default 1000)'),
+    chunkOverlap: z
+        .number()
+        .min(0)
+        .optional()
+        .describe('Amount of overlap carried between consecutive chunks (default 200)'),
+    separator: z
+        .string()
+        .optional()
+        .describe('Separator for the character strategy (default "\\n\\n")'),
+});
+export const SplitTextOutput = z.object({
+    chunks: z.array(z.string()).describe('The resulting text chunks'),
+});
+const RECURSIVE_SEPARATORS = ['\n\n', '\n', ' ', ''];
+const CHARS_PER_TOKEN = 4;
+/**
+ * Merge a list of pieces (already split on `separator`) into chunks no larger
+ * than `chunkSize`, carrying `chunkOverlap` worth of trailing pieces into the
+ * next chunk. Mirrors LangChain's `mergeSplits`.
+ */
+function mergeSplits(splits, separator, chunkSize, chunkOverlap) {
+    const chunks = [];
+    const current = [];
+    let total = 0;
+    const sepLen = separator.length;
+    const currentLength = () => {
+        if (current.length === 0)
+            return 0;
+        const contentLen = current.reduce((sum, piece) => sum + piece.length, 0);
+        return contentLen + sepLen * (current.length - 1);
+    };
+    for (const piece of splits) {
+        if (piece.length === 0)
+            continue;
+        const addedLen = piece.length + (current.length > 0 ? sepLen : 0);
+        if (total + addedLen > chunkSize && current.length > 0) {
+            chunks.push(current.join(separator));
+            while (current.length > 0 &&
+                (total > chunkOverlap || (total + addedLen > chunkSize && total > 0))) {
+                const removed = current.shift();
+                total -= removed.length + (current.length > 0 ? sepLen : 0);
+            }
+        }
+        current.push(piece);
+        total = currentLength();
+    }
+    if (current.length > 0)
+        chunks.push(current.join(separator));
+    return chunks;
+}
+function recursiveSplit(text, separators, chunkSize, chunkOverlap) {
+    const [separator, ...rest] = separators.length ? separators : [''];
+    const pieces = separator === '' ? text.split('') : text.split(separator);
+    const finalChunks = [];
+    let goodSplits = [];
+    const flush = () => {
+        if (goodSplits.length > 0) {
+            finalChunks.push(...mergeSplits(goodSplits, separator, chunkSize, chunkOverlap));
+            goodSplits = [];
+        }
+    };
+    for (const piece of pieces) {
+        if (piece.length <= chunkSize) {
+            goodSplits.push(piece);
+        }
+        else {
+            flush();
+            if (rest.length > 0) {
+                finalChunks.push(...recursiveSplit(piece, rest, chunkSize, chunkOverlap));
+            }
+            else {
+                finalChunks.push(piece);
+            }
+        }
+    }
+    flush();
+    return finalChunks;
+}
+export const splitText = pikkuSessionlessFunc({
+    description: 'Split text into overlapping chunks for embedding/RAG (recursive, character, or token strategy)',
+    node: { displayName: 'Split Text', category: 'Transform', type: 'action' },
+    input: SplitTextInput,
+    output: SplitTextOutput,
+    func: async (_services, data) => {
+        const strategy = data.strategy ?? 'recursive';
+        const chunkOverlap = data.chunkOverlap ?? 200;
+        const requestedSize = data.chunkSize ?? 1000;
+        if (data.text.length === 0)
+            return { chunks: [] };
+        let chunks;
+        if (strategy === 'character') {
+            const separator = data.separator ?? '\n\n';
+            chunks = mergeSplits(separator === '' ? data.text.split('') : data.text.split(separator), separator, requestedSize, chunkOverlap);
+        }
+        else {
+            const chunkSize = strategy === 'token' ? requestedSize * CHARS_PER_TOKEN : requestedSize;
+            const overlap = strategy === 'token' ? chunkOverlap * CHARS_PER_TOKEN : chunkOverlap;
+            chunks = recursiveSplit(data.text, RECURSIVE_SEPARATORS, chunkSize, Math.min(overlap, chunkSize - 1));
+        }
+        return { chunks: chunks.filter((c) => c.length > 0) };
+    },
+});
+//# sourceMappingURL=split-text.function.js.map

package/dist/src/functions/transform/split-text.function.js.map

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

package/dist/src/functions/transform/split-text.function.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=split-text.function.test.d.ts.map

package/dist/src/functions/transform/split-text.function.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-text.function.test.d.ts","sourceRoot":"","sources":["../../../../src/functions/transform/split-text.function.test.ts"],"names":[],"mappings":""}

package/dist/src/functions/transform/split-text.function.test.js

@@ -0,0 +1,66 @@
+import { describe, test } from 'node:test';
+import assert from 'node:assert/strict';
+import { splitText } from './split-text.function.js';
+const call = (data) => splitText.func({}, data);
+describe('graph:splitText', () => {
+    test('text shorter than chunkSize returns a single chunk', async () => {
+        const out = await call({ text: 'hello world', chunkSize: 100 });
+        assert.deepEqual(out, { chunks: ['hello world'] });
+    });
+    test('recursive strategy splits on paragraph boundaries into bounded chunks', async () => {
+        const para = 'a'.repeat(40);
+        const text = [para, para, para].join('\n\n');
+        const out = await call({
+            text,
+            strategy: 'recursive',
+            chunkSize: 50,
+            chunkOverlap: 0,
+        });
+        assert.ok(out.chunks.length >= 3, 'expected each 40-char paragraph in its own chunk');
+        for (const c of out.chunks) {
+            assert.ok(c.length <= 50, `chunk exceeded chunkSize: ${c.length}`);
+        }
+        // reconstructable content — every paragraph survives
+        assert.ok(out.chunks.every((c) => c.includes('a')));
+    });
+    test('default strategy behaves as recursive', async () => {
+        const text = ['x'.repeat(30), 'y'.repeat(30)].join('\n\n');
+        const withDefault = await call({ text, chunkSize: 40, chunkOverlap: 0 });
+        const withRecursive = await call({
+            text,
+            strategy: 'recursive',
+            chunkSize: 40,
+            chunkOverlap: 0,
+        });
+        assert.deepEqual(withDefault, withRecursive);
+    });
+    test('overlap carries trailing content into the next chunk', async () => {
+        const words = Array.from({ length: 12 }, (_, i) => `w${i}`).join(' ');
+        const out = await call({
+            text: words,
+            strategy: 'recursive',
+            chunkSize: 12,
+            chunkOverlap: 6,
+        });
+        assert.ok(out.chunks.length > 1, 'expected multiple chunks');
+        // consecutive chunks share at least one word due to overlap
+        const first = out.chunks[0].split(' ');
+        const second = out.chunks[1].split(' ');
+        assert.ok(first.some((w) => second.includes(w)), 'expected overlapping word between consecutive chunks');
+    });
+    test('character strategy splits on the double-newline separator', async () => {
+        const text = ['one', 'two', 'three'].join('\n\n');
+        const out = await call({
+            text,
+            strategy: 'character',
+            chunkSize: 3,
+            chunkOverlap: 0,
+        });
+        assert.deepEqual(out.chunks, ['one', 'two', 'three']);
+    });
+    test('empty text yields no chunks', async () => {
+        const out = await call({ text: '', chunkSize: 100 });
+        assert.deepEqual(out, { chunks: [] });
+    });
+});
+//# sourceMappingURL=split-text.function.test.js.map

package/dist/src/functions/transform/split-text.function.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-text.function.test.js","sourceRoot":"","sources":["../../../../src/functions/transform/split-text.function.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/addon-graph",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "type": "module",
   "imports": {
     "#pikku": {
@@ -31,9 +31,9 @@
     "zod": "^4"
   },
   "devDependencies": {
-    "@pikku/cli": "^0.12.46",
+    "@pikku/cli": "^0.12.83",
     "@pikku/core": "*",
-    "typescript": "^5.9.3",
+    "typescript": "^6.0.3",
     "zod": "^4"
   },
   "dependencies": {