@ax-llm/ax 9.0.0

package/build/module/src/prompts/prompts.test.js

@@ -0,0 +1,48 @@
+import { Readable } from 'stream';
+import test from 'ava';
+import { AI } from '../ai/index.js';
+import { ChainOfThought } from './cot.js';
+const text = `The technological singularity—or simply the singularity[1]—is a hypothetical future point in time at which technological growth becomes uncontrollable and irreversible.`;
+const examples = [
+    {
+        text: 'Mathematical platonism is a philosophical view that posits the existence of abstract mathematical objects that are independent of human thought and language. According to this view, mathematical entities such as numbers, shapes, and functions exist in a non-physical realm and can be discovered but not invented.',
+        shortSummary: 'A philosophy that suggests mathematical objects exist independently of human thought in a non-physical realm.'
+    },
+    {
+        text: 'Quantum entanglement is a physical phenomenon occurring when pairs or groups of particles are generated, interact, or share spatial proximity in ways such that the quantum state of each particle cannot be described independently of the state of the others, even when the particles are separated by large distances. This leads to correlations between observable physical properties of the particles.',
+        shortSummary: 'A phenomenon where particles remain interconnected and the state of one affects the state of another, regardless of distance.'
+    }
+];
+const mockFetch = async () => {
+    const mockRes = {
+        choices: [
+            {
+                message: {
+                    role: 'assistant',
+                    content: 'Reason: Blah blah blah\nShort Summary: More blah blah blah'
+                }
+            }
+        ]
+    };
+    return new Promise((resolve) => {
+        resolve({
+            ok: true,
+            status: 200,
+            body: Readable.from(JSON.stringify(mockRes)),
+            json: async () => new Promise((resolve) => resolve(mockRes))
+        });
+    });
+};
+test('generate prompt', async (t) => {
+    const options = { fetch: mockFetch };
+    const ai = AI('openai', { apiKey: 'no-key', options });
+    // const ai = AI('ollama', { model: 'nous-hermes2' });
+    const gen = new ChainOfThought(ai, `text -> shortSummary "summarize in 5 to 10 words"`);
+    gen.setExamples(examples);
+    const res = await gen.forward({ text });
+    t.deepEqual(res, {
+        reason: 'Blah blah blah',
+        shortSummary: 'More blah blah blah'
+    });
+});
+//# sourceMappingURL=prompts.test.js.map

package/build/module/src/prompts/prompts.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.test.js","sourceRoot":"","sources":["../../../../src/prompts/prompts.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAElC,OAAO,IAAI,MAAM,KAAK,CAAC;AAEvB,OAAO,EAAE,EAAE,EAAmB,MAAM,gBAAgB,CAAC;AAErD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,IAAI,GAAG,0KAA0K,CAAC;AAExL,MAAM,QAAQ,GAAG;IACf;QACE,IAAI,EAAE,0TAA0T;QAChU,YAAY,EACV,+GAA+G;KAClH;IACD;QACE,IAAI,EAAE,gZAAgZ;QACtZ,YAAY,EACV,+HAA+H;KAClI;CACF,CAAC;AAEF,MAAM,SAAS,GAAG,KAAK,IAAuB,EAAE;IAC9C,MAAM,OAAO,GAAG;QACd,OAAO,EAAE;YACP;gBACE,OAAO,EAAE;oBACP,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,4DAA4D;iBACtE;aACF;SACF;KACF,CAAC;IAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,OAAO,CAAC;YACN,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAC5C,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;SACtC,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,IAAI,CAAC,iBAAiB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;IAClC,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACrC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAgB,CAAC,CAAC;IAErE,sDAAsD;IAEtD,MAAM,GAAG,GAAG,IAAI,cAAc,CAC5B,EAAE,EACF,mDAAmD,CACpD,CAAC;IACF,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAE1B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE;QACf,MAAM,EAAE,gBAAgB;QACxB,YAAY,EAAE,qBAAqB;KACpC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build/module/src/prompts/rag.d.ts

@@ -0,0 +1,23 @@
+import { type GenerateOptions } from '../dsp/index.js';
+import { type ProgramForwardOptions } from '../dsp/program.js';
+import type { AIService } from '../text/types.js';
+import { ChainOfThought } from './cot.js';
+export declare class RAG extends ChainOfThought<{
+    context: string[];
+    question: string;
+}, {
+    answer: string;
+}> {
+    private genQuery;
+    private queryFn;
+    private maxHops;
+    constructor(ai: AIService, queryFn: (query: string) => Promise<string>, options: Readonly<GenerateOptions & {
+        maxHops?: number;
+    }>);
+    forward({ question }: Readonly<{
+        question: string;
+    }>, options?: Readonly<ProgramForwardOptions>): Promise<{
+        answer: string;
+        reason: string;
+    }>;
+}

package/build/module/src/prompts/rag.js

@@ -0,0 +1,30 @@
+import { dedup, Generate, Signature } from '../dsp/index.js';
+import {} from '../dsp/program.js';
+import { ChainOfThought } from './cot.js';
+export class RAG extends ChainOfThought {
+    genQuery;
+    queryFn;
+    maxHops;
+    constructor(ai, queryFn, options) {
+        const sig = '"Answer questions with short factoid answers." context:string[] "may contain relevant facts", question -> answer';
+        super(ai, sig, options);
+        this.maxHops = options?.maxHops ?? 3;
+        const qsig = new Signature('"Write a simple search query that will help answer a complex question." context?:string[] "may contain relevant facts", question -> query "question to further our understanding"');
+        this.genQuery = new Generate(ai, qsig);
+        this.queryFn = queryFn;
+        this.register(this.genQuery);
+    }
+    async forward({ question }, options) {
+        let context = [];
+        for (let i = 0; i < this.maxHops; i++) {
+            const { query } = await this.genQuery.forward({
+                context,
+                question
+            }, options);
+            const val = await this.queryFn(query);
+            context = dedup([...context, val]);
+        }
+        return super.forward({ context, question }, options);
+    }
+}
+//# sourceMappingURL=rag.js.map

package/build/module/src/prompts/rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.js","sourceRoot":"","sources":["../../../../src/prompts/rag.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,QAAQ,EAER,SAAS,EACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAA8B,MAAM,mBAAmB,CAAC;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,OAAO,GAAI,SAAQ,cAGxB;IACS,QAAQ,CAGd;IACM,OAAO,CAAqC;IAC5C,OAAO,CAAS;IAExB,YACE,EAAa,EACb,OAA2C,EAC3C,OAAyD;QAEzD,MAAM,GAAG,GACP,kHAAkH,CAAC;QACrH,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAExB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC;QAErC,MAAM,IAAI,GAAG,IAAI,SAAS,CACxB,mLAAmL,CACpL,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAG1B,EAAE,EAAE,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAEe,KAAK,CAAC,OAAO,CAC3B,EAAE,QAAQ,EAAkC,EAC5C,OAAyC;QAEzC,IAAI,OAAO,GAAa,EAAE,CAAC;QAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAC3C;gBACE,OAAO;gBACP,QAAQ;aACT,EACD,OAAO,CACR,CAAC;YACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtC,OAAO,GAAG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IACvD,CAAC;CACF"}

package/build/module/src/prompts/react.d.ts

@@ -0,0 +1,8 @@
+import type { GenerateOptions } from '../dsp/generate.js';
+import type { GenIn, GenOut } from '../dsp/program.js';
+import { Signature } from '../dsp/sig.js';
+import type { AIService } from '../text/types.js';
+import { ChainOfThought } from './cot.js';
+export declare class ReAct<IN extends GenIn = GenIn, OUT extends GenOut = GenOut> extends ChainOfThought<IN, OUT> {
+    constructor(ai: AIService, signature: Readonly<Signature | string>, options: Readonly<GenerateOptions>);
+}

package/build/module/src/prompts/react.js

@@ -0,0 +1,22 @@
+import { Signature } from '../dsp/sig.js';
+import { ChainOfThought } from './cot.js';
+export class ReAct extends ChainOfThought {
+    constructor(ai, signature, options) {
+        if (!options?.functions || options.functions.length === 0) {
+            throw new Error('No functions provided');
+        }
+        const functions = [...options.functions];
+        const funcList = functions.map((f) => `'${f.name}'`).join(', ');
+        const sig = new Signature(signature);
+        sig.setDescription(`Use the provided functions ${funcList} to complete the task and return the result if any.`);
+        // sig.addInputField({
+        //   name: 'observation',
+        //   description: 'Result value from executed function',
+        //   isOptional: true,
+        //   type: { name: 'string', isArray: true }
+        // });
+        sig.setOutputFields(sig.getOutputFields().map((v) => ({ ...v, isOptional: true })));
+        super(ai, sig, options);
+    }
+}
+//# sourceMappingURL=react.js.map

package/build/module/src/prompts/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../../src/prompts/react.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,OAAO,KAGX,SAAQ,cAAuB;IAC/B,YACE,EAAa,EACb,SAAuC,EACvC,OAAkC;QAElC,IAAI,CAAC,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,SAAS,CAAC,CAAC;QACrC,GAAG,CAAC,cAAc,CAChB,8BAA8B,QAAQ,qDAAqD,CAC5F,CAAC;QAEF,sBAAsB;QACtB,yBAAyB;QACzB,wDAAwD;QACxD,sBAAsB;QACtB,4CAA4C;QAC5C,MAAM;QAEN,GAAG,CAAC,eAAe,CACjB,GAAG,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAC/D,CAAC;QAEF,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/build/module/src/text/functions.d.ts

@@ -0,0 +1,25 @@
+import type { TextResponseFunctionCall } from '../ai/types.js';
+import type { AIServiceActionOptions, FunctionExec } from './types.js';
+export type AITextFunctionHandler = (args?: any, extra?: Readonly<AIServiceActionOptions>) => unknown;
+export type FunctionJSONSchema = {
+    type: string;
+    properties?: Record<string, FunctionJSONSchema & {
+        enum?: string[];
+        default?: unknown;
+        description: string;
+    }>;
+    required?: string[];
+    items?: FunctionJSONSchema;
+};
+export type AITextFunction = {
+    name: string;
+    description: string;
+    parameters?: FunctionJSONSchema;
+    func?: AITextFunctionHandler;
+};
+export declare class FunctionProcessor {
+    private funcList;
+    constructor(funcList: readonly AITextFunction[]);
+    private executeFunction;
+    execute: (func: Readonly<TextResponseFunctionCall>, options?: Readonly<AIServiceActionOptions>) => Promise<FunctionExec>;
+}

package/build/module/src/text/functions.js

@@ -0,0 +1,55 @@
+import JSON5 from 'json5';
+import { validateJSONSchema } from './jsonschema.js';
+export class FunctionProcessor {
+    funcList;
+    constructor(funcList) {
+        funcList
+            .filter((v) => v.parameters)
+            .forEach((v) => validateJSONSchema(v.parameters));
+        this.funcList = funcList;
+    }
+    executeFunction = async (fnSpec, func, options) => {
+        if (!fnSpec.func) {
+            throw new Error(`Function handler for ${fnSpec.name} not implemented`);
+        }
+        let argOBj;
+        if (func.args && func.args.length > 0) {
+            argOBj = JSON5.parse(func.args);
+        }
+        if (!fnSpec.parameters) {
+            const res = fnSpec.func.length === 1
+                ? await fnSpec.func(options)
+                : await fnSpec.func();
+            return {
+                name: fnSpec.name,
+                result: JSON.stringify(res, null, 2)
+            };
+        }
+        const res = fnSpec.func.length === 2
+            ? await fnSpec.func(argOBj, options)
+            : await fnSpec.func(argOBj);
+        return {
+            id: func.id,
+            name: func.name,
+            args: func.args,
+            result: JSON.stringify(res, null, 2)
+        };
+    };
+    execute = async (func, options) => {
+        const fnSpec = this.funcList.find((v) => v.name.localeCompare(func.name) === 0);
+        if (!fnSpec) {
+            throw new Error(`Function not found: ` + func.name);
+        }
+        if (!fnSpec.func) {
+            throw new Error('No handler for function: ' + func.name);
+        }
+        // execute value function calls
+        const funcExec = await this.executeFunction(fnSpec, func, options);
+        // // signal error if no data returned
+        // if (!funcExec.result || funcExec.result.length === 0) {
+        //   funcExec.result = `No data returned by function`;
+        // }
+        return funcExec;
+    };
+}
+//# sourceMappingURL=functions.js.map

package/build/module/src/text/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../../src/text/functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AA8BrD,MAAM,OAAO,iBAAiB;IACpB,QAAQ,CAA4B;IAE5C,YAAY,QAAmC;QAC7C,QAAQ;aACL,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;aAC3B,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAW,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,eAAe,GAAG,KAAK,EAC7B,MAAgC,EAChC,IAAwC,EACxC,OAA0C,EACnB,EAAE;QACzB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,CAAC,IAAI,kBAAkB,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,MAAM,CAAC;QACX,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,GAAG,GACP,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBACtB,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;gBAC5B,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAE1B,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;aACrC,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GACP,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YACtB,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC;YACpC,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhC,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;SACrC,CAAC;IACJ,CAAC,CAAC;IAEK,OAAO,GAAG,KAAK,EACpB,IAAwC,EACxC,OAA0C,EACnB,EAAE;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAC/B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAC7C,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;QAED,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAEnE,sCAAsC;QACtC,0DAA0D;QAC1D,sDAAsD;QACtD,IAAI;QACJ,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;CACH"}

package/build/module/src/text/index.d.ts

@@ -0,0 +1,3 @@
+export * from './memory.js';
+export * from './types.js';
+export * from './functions.js';

package/build/module/src/text/index.js

@@ -0,0 +1,4 @@
+export * from './memory.js';
+export * from './types.js';
+export * from './functions.js';
+//# sourceMappingURL=index.js.map

package/build/module/src/text/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/text/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/build/module/src/text/jsonschema.d.ts

@@ -0,0 +1,2 @@
+import type { FunctionJSONSchema } from './functions.js';
+export declare const validateJSONSchema: (schema: Readonly<FunctionJSONSchema>) => void;

package/build/module/src/text/jsonschema.js

@@ -0,0 +1,96 @@
+export const validateJSONSchema = (schema) => {
+    const errors = [];
+    const validateSchemaObject = (schema, path = '') => {
+        const validTypes = [
+            'array',
+            'integer',
+            'number',
+            'string',
+            'boolean',
+            'null',
+            'object'
+        ];
+        if (!validTypes.includes(schema.type)) {
+            errors.push(`Invalid type '${schema.type}' at ${path || 'root'}`);
+            return;
+        }
+        if (schema.type === 'object' && schema.properties) {
+            if (typeof schema.properties !== 'object' ||
+                Array.isArray(schema.properties)) {
+                errors.push(`Invalid properties object at ${path || 'root'}`);
+            }
+            else {
+                for (const key in schema.properties) {
+                    const value = schema.properties[key];
+                    if (typeof value !== 'object') {
+                        errors.push(`Invalid schema object at ${path}${key}`);
+                        continue;
+                    }
+                    validateSchemaObject(value, `${path}${key}.`);
+                }
+            }
+            if (schema.required && !Array.isArray(schema.required)) {
+                errors.push(`'required' should be an array at ${path || 'root'}`);
+            }
+        }
+        if (schema.type === 'array' && schema.items) {
+            if (typeof schema.items !== 'object') {
+                errors.push(`Invalid items schema at ${path || 'root'}`);
+            }
+            else {
+                validateSchemaObject(schema.items, `${path}items.`);
+            }
+        }
+    };
+    validateSchemaObject(schema);
+    if (errors.length > 0) {
+        throw new Error(errors.join('; '));
+    }
+};
+// Example Usage:
+/*
+const validSchema: FunctionJSONSchema = {
+  type: 'object',
+  properties: {
+    id: { type: 'integer' },
+    name: { type: 'string' },
+    email: { type: 'string' },
+    isActive: { type: 'boolean' },
+    tags: {
+      type: 'array',
+      items: { type: 'string' }
+    }
+  },
+  required: ['id', 'name', 'email']
+};
+
+const invalidSchema: any = {
+  type: 'object',
+  properties: {
+    id: { type: 'integer' },
+    name: { type: 'string' },
+    email: { type: 'unknownType' }, // Invalid type
+    isActive: { type: 'boolean' },
+    tags: {
+      type: 'array',
+      items: { type: 'string' }
+    }
+  },
+  required: 'id,name,email' // Invalid 'required' field
+};
+
+try {
+  validateSchemaStructure(validSchema);
+  console.log('Schema is valid!');
+} catch (error) {
+  console.error('Schema validation failed:', error.message);
+}
+
+try {
+  validateSchemaStructure(invalidSchema);
+  console.log('Schema is valid!');
+} catch (error) {
+  console.error('Schema validation failed:', error.message);
+}
+*/
+//# sourceMappingURL=jsonschema.js.map

package/build/module/src/text/jsonschema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.js","sourceRoot":"","sources":["../../../../src/text/jsonschema.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,MAAoC,EAC9B,EAAE;IACR,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,oBAAoB,GAAG,CAC3B,MAAoC,EACpC,OAAe,EAAE,EACX,EAAE;QACR,MAAM,UAAU,GAAG;YACjB,OAAO;YACP,SAAS;YACT,QAAQ;YACR,QAAQ;YACR,SAAS;YACT,MAAM;YACN,QAAQ;SACT,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,IAAI,QAAQ,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAClD,IACE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;gBACrC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAChC,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;YAChE,CAAC;iBAAM,CAAC;gBACN,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;oBACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBAC9B,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC;wBACtD,SAAS;oBACX,CAAC;oBACD,oBAAoB,CAAC,KAAK,EAAE,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;YAED,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC5C,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACrC,MAAM,CAAC,IAAI,CAAC,2BAA2B,IAAI,IAAI,MAAM,EAAE,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,QAAQ,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAE7B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;AACH,CAAC,CAAC;AAEF,iBAAiB;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4CE"}

package/build/module/src/text/memory.d.ts

@@ -0,0 +1,21 @@
+import type { TextResponseResult } from '../ai/types.js';
+import type { AITextChatRequest } from '../types/index.js';
+import type { AIMemory } from './types.js';
+/**
+ * A memory class to store ai interactions
+ * @export
+ */
+export declare class Memory implements AIMemory {
+    private data;
+    private sdata;
+    private limit;
+    constructor(limit?: number);
+    add(value: Readonly<AITextChatRequest['chatPrompt'][0] | AITextChatRequest['chatPrompt']>, sessionId?: string): void;
+    addResult({ content, name, functionCalls }: Readonly<TextResponseResult>, sessionId?: string): void;
+    updateResult({ content, name, functionCalls }: Readonly<TextResponseResult>, sessionId?: string): void;
+    history(sessionId?: string): AITextChatRequest['chatPrompt'];
+    peek(sessionId?: string): AITextChatRequest['chatPrompt'];
+    getLast(sessionId?: string): AITextChatRequest['chatPrompt'][0] | undefined;
+    reset(sessionId?: string): void;
+    private get;
+}

package/build/module/src/text/memory.js

@@ -0,0 +1,73 @@
+/**
+ * A memory class to store ai interactions
+ * @export
+ */
+export class Memory {
+    data = [];
+    sdata = new Map();
+    limit;
+    constructor(limit = 50) {
+        if (limit <= 0) {
+            throw Error("argument 'last' must be greater than 0");
+        }
+        this.limit = limit;
+    }
+    add(value, sessionId) {
+        const d = this.get(sessionId);
+        let n = 0;
+        if (Array.isArray(value)) {
+            n = d.push(...structuredClone(value));
+        }
+        else {
+            n = d.push({
+                ...structuredClone(value)
+            });
+        }
+        if (d.length > this.limit) {
+            d.splice(0, this.limit + n - this.limit);
+        }
+    }
+    addResult({ content, name, functionCalls }, sessionId) {
+        this.add({ content, name, role: 'assistant', functionCalls }, sessionId);
+    }
+    updateResult({ content, name, functionCalls }, sessionId) {
+        const item = this.get(sessionId);
+        if ('content' in item && content) {
+            item.content = content;
+        }
+        if ('name' in item && name) {
+            item.name = name;
+        }
+        if ('functionCalls' in item && functionCalls) {
+            item.functionCalls = functionCalls;
+        }
+    }
+    history(sessionId) {
+        return this.get(sessionId);
+    }
+    peek(sessionId) {
+        return this.get(sessionId);
+    }
+    getLast(sessionId) {
+        const d = this.get(sessionId);
+        return d.at(-1);
+    }
+    reset(sessionId) {
+        if (!sessionId) {
+            this.data = [];
+        }
+        else {
+            this.sdata.set(sessionId, []);
+        }
+    }
+    get(sessionId) {
+        if (!sessionId) {
+            return this.data;
+        }
+        if (!this.sdata.has(sessionId)) {
+            this.sdata.set(sessionId, []);
+        }
+        return this.sdata.get(sessionId) || [];
+    }
+}
+//# sourceMappingURL=memory.js.map

package/build/module/src/text/memory.js.map

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

package/build/module/src/text/types.d.ts

@@ -0,0 +1,57 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { ReadableStream } from 'stream/web';
+import type { EmbedResponse, RateLimiterFunction, TextModelConfig, TextModelInfo, TextResponse, TextResponseResult } from '../ai/types.js';
+import type { Tracer } from '../trace/index.js';
+import type { AITextChatRequest, AITextEmbedRequest } from '../types/index.js';
+export type FunctionExec = {
+    id?: string;
+    name: string;
+    args?: any;
+    result?: string;
+};
+export type AITextResponse<T> = {
+    prompt: string;
+    sessionId?: string;
+    value(): T;
+};
+export interface AIMemory {
+    add(result: Readonly<AITextChatRequest['chatPrompt'] | AITextChatRequest['chatPrompt'][0]>, sessionId?: string): void;
+    addResult(result: Readonly<TextResponseResult>, sessionId?: string): void;
+    updateResult(result: Readonly<TextResponseResult>, sessionId?: string): void;
+    history(sessionId?: string): AITextChatRequest['chatPrompt'];
+    peek(sessionId?: string): AITextChatRequest['chatPrompt'];
+    reset(sessionId?: string): void;
+    getLast(sessionId?: string): AITextChatRequest['chatPrompt'][0] | undefined;
+}
+export type AIPromptConfig = {
+    stream?: boolean;
+};
+export type AITranscribeConfig = {
+    language?: string;
+};
+export type AIServiceOptions = {
+    debug?: boolean;
+    rateLimiter?: RateLimiterFunction;
+    fetch?: typeof fetch;
+    tracer?: Tracer;
+};
+export type AIServiceActionOptions = {
+    sessionId?: string;
+    traceId?: string;
+};
+export interface AIService {
+    getName(): string;
+    getModelInfo(): Readonly<TextModelInfo & {
+        provider: string;
+    }>;
+    getEmbedModelInfo(): Readonly<TextModelInfo> | undefined;
+    getModelConfig(): Readonly<TextModelConfig>;
+    getFeatures(): {
+        functions: boolean;
+        streaming: boolean;
+    };
+    chat(req: Readonly<AITextChatRequest>, options?: Readonly<AIPromptConfig & AIServiceActionOptions>): Promise<TextResponse | ReadableStream<TextResponse>>;
+    embed(req: Readonly<AITextEmbedRequest>, options?: Readonly<AIServiceActionOptions & AIServiceActionOptions>): Promise<EmbedResponse>;
+    setOptions(options: Readonly<AIServiceOptions>): void;
+}

package/build/module/src/text/types.js

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

package/build/module/src/text/types.js.map

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