@webiny/api-core 0.0.0-unstable.0d717d18dd

package/features/ai/AiSdkTools.js

@@ -0,0 +1,29 @@
+import { AiSdkTool, AiSdkTools } from "./abstractions.js";
+class AiSdkToolsImpl {
+    constructor(tools){
+        this.tools = tools;
+    }
+    getToolSet() {
+        const map = {};
+        for (const t of this.tools)map[t.name] = {
+            description: t.description,
+            inputSchema: t.inputSchema,
+            execute: (input)=>t.execute(input)
+        };
+        return map;
+    }
+}
+const AiSdkTools_AiSdkTools = AiSdkTools.createImplementation({
+    implementation: AiSdkToolsImpl,
+    dependencies: [
+        [
+            AiSdkTool,
+            {
+                multiple: true
+            }
+        ]
+    ]
+});
+export { AiSdkTools_AiSdkTools as AiSdkTools };
+
+//# sourceMappingURL=AiSdkTools.js.map

package/features/ai/AiSdkTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/AiSdkTools.js","sources":["../../../src/features/ai/AiSdkTools.ts"],"sourcesContent":["import { AiSdkTool, AiSdkTools as AiSdkToolsAbstraction } from \"./abstractions.js\";\nimport type { ToolSet } from \"ai\";\n\nclass AiSdkToolsImpl implements AiSdkToolsAbstraction.Interface {\n    constructor(private tools: AiSdkTool.Interface[]) {}\n\n    getToolSet(): ToolSet {\n        const map: ToolSet = {};\n        for (const t of this.tools) {\n            map[t.name] = {\n                description: t.description,\n                inputSchema: t.inputSchema,\n                execute: (input: unknown) => t.execute(input)\n            };\n        }\n        return map;\n    }\n}\n\nexport const AiSdkTools = AiSdkToolsAbstraction.createImplementation({\n    implementation: AiSdkToolsImpl,\n    dependencies: [[AiSdkTool, { multiple: true }]]\n});\n"],"names":["AiSdkToolsImpl","tools","map","t","input","AiSdkTools","AiSdkToolsAbstraction","AiSdkTool"],"mappings":";AAGA,MAAMA;IACF,YAAoBC,KAA4B,CAAE;aAA9BA,KAAK,GAALA;IAA+B;IAEnD,aAAsB;QAClB,MAAMC,MAAe,CAAC;QACtB,KAAK,MAAMC,KAAK,IAAI,CAAC,KAAK,CACtBD,GAAG,CAACC,EAAE,IAAI,CAAC,GAAG;YACV,aAAaA,EAAE,WAAW;YAC1B,aAAaA,EAAE,WAAW;YAC1B,SAAS,CAACC,QAAmBD,EAAE,OAAO,CAACC;QAC3C;QAEJ,OAAOF;IACX;AACJ;AAEO,MAAMG,wBAAaC,WAAAA,oBAA0C,CAAC;IACjE,gBAAgBN;IAChB,cAAc;QAAC;YAACO;YAAW;gBAAE,UAAU;YAAK;SAAE;KAAC;AACnD"}

package/features/ai/AnthropicSdkFactory.d.ts

@@ -0,0 +1,10 @@
+import { AiSdkFactory as AiSdkFactoryAbstraction } from "./abstractions.js";
+import type { IAiSdk, IAiSdkModel } from "./abstractions.js";
+declare class AnthropicSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {
+    readonly id = "anthropic";
+    readonly name = "Anthropic";
+    readonly models: IAiSdkModel[];
+    execute(apiKey?: string): Promise<IAiSdk>;
+}
+export declare const AnthropicSdkFactory: import("@webiny/di").Implementation<typeof AnthropicSdkFactoryImpl>;
+export {};

package/features/ai/AnthropicSdkFactory.js

@@ -0,0 +1,64 @@
+import { createImplementation } from "@webiny/feature/api";
+import { AiSdkFactory } from "./abstractions.js";
+const ANTHROPIC_MODELS = [
+    {
+        id: "claude-opus-5",
+        name: "Claude Opus 5"
+    },
+    {
+        id: "claude-sonnet-5",
+        name: "Claude Sonnet 5"
+    },
+    {
+        id: "claude-fable-5",
+        name: "Claude Fable 5"
+    },
+    {
+        id: "claude-opus-4-7",
+        name: "Claude Opus 4.7"
+    },
+    {
+        id: "claude-opus-4-6",
+        name: "Claude Opus 4.6"
+    },
+    {
+        id: "claude-opus-4-5",
+        name: "Claude Opus 4.5"
+    },
+    {
+        id: "claude-sonnet-4-6",
+        name: "Claude Sonnet 4.6"
+    },
+    {
+        id: "claude-sonnet-4-5",
+        name: "Claude Sonnet 4.5"
+    },
+    {
+        id: "claude-haiku-4-5",
+        name: "Claude Haiku 4.5"
+    }
+];
+class AnthropicSdkFactoryImpl {
+    async execute(apiKey) {
+        const { createAnthropic } = await import("@ai-sdk/anthropic");
+        const provider = createAnthropic({
+            apiKey: apiKey ?? process.env.WEBINY_API_ANTHROPIC_API_KEY
+        });
+        return {
+            languageModel: (modelId)=>provider.chat(modelId)
+        };
+    }
+    constructor(){
+        this.id = "anthropic";
+        this.name = "Anthropic";
+        this.models = ANTHROPIC_MODELS;
+    }
+}
+const AnthropicSdkFactory = createImplementation({
+    abstraction: AiSdkFactory,
+    implementation: AnthropicSdkFactoryImpl,
+    dependencies: []
+});
+export { AnthropicSdkFactory };
+
+//# sourceMappingURL=AnthropicSdkFactory.js.map

package/features/ai/AnthropicSdkFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/AnthropicSdkFactory.js","sources":["../../../src/features/ai/AnthropicSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\nconst ANTHROPIC_MODELS: IAiSdkModel[] = [\n    { id: \"claude-opus-5\", name: \"Claude Opus 5\" },\n    { id: \"claude-sonnet-5\", name: \"Claude Sonnet 5\" },\n    { id: \"claude-fable-5\", name: \"Claude Fable 5\" },\n    { id: \"claude-opus-4-7\", name: \"Claude Opus 4.7\" },\n    { id: \"claude-opus-4-6\", name: \"Claude Opus 4.6\" },\n    { id: \"claude-opus-4-5\", name: \"Claude Opus 4.5\" },\n    { id: \"claude-sonnet-4-6\", name: \"Claude Sonnet 4.6\" },\n    { id: \"claude-sonnet-4-5\", name: \"Claude Sonnet 4.5\" },\n    { id: \"claude-haiku-4-5\", name: \"Claude Haiku 4.5\" }\n];\n\nclass AnthropicSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"anthropic\";\n    readonly name = \"Anthropic\";\n    readonly models = ANTHROPIC_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createAnthropic } = await import(\"@ai-sdk/anthropic\");\n        const provider = createAnthropic({\n            apiKey: apiKey ?? process.env.WEBINY_API_ANTHROPIC_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const AnthropicSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: AnthropicSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["ANTHROPIC_MODELS","AnthropicSdkFactoryImpl","apiKey","createAnthropic","provider","process","modelId","AnthropicSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AAIA,MAAMA,mBAAkC;IACpC;QAAE,IAAI;QAAiB,MAAM;IAAgB;IAC7C;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAkB,MAAM;IAAiB;IAC/C;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAmB,MAAM;IAAkB;IACjD;QAAE,IAAI;QAAqB,MAAM;IAAoB;IACrD;QAAE,IAAI;QAAqB,MAAM;IAAoB;IACrD;QAAE,IAAI;QAAoB,MAAM;IAAmB;CACtD;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC;QACzC,MAAMC,WAAWD,gBAAgB;YAC7B,QAAQD,UAAUG,QAAQ,GAAG,CAAC,4BAA4B;QAC9D;QACA,OAAO;YACH,eAAeC,CAAAA,UAAWF,SAAS,IAAI,CAACE;QAC5C;IACJ;;aAZS,EAAE,GAAG;aACL,IAAI,GAAG;aACP,MAAM,GAAGN;;AAWtB;AAEO,MAAMO,sBAAsBC,qBAAqB;IACpD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/OpenAiSdkFactory.d.ts

@@ -0,0 +1,10 @@
+import { AiSdkFactory as AiSdkFactoryAbstraction } from "./abstractions.js";
+import type { IAiSdk, IAiSdkModel } from "./abstractions.js";
+declare class OpenAiSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {
+    readonly id = "openai";
+    readonly name = "OpenAI";
+    readonly models: IAiSdkModel[];
+    execute(apiKey?: string): Promise<IAiSdk>;
+}
+export declare const OpenAiSdkFactory: import("@webiny/di").Implementation<typeof OpenAiSdkFactoryImpl>;
+export {};

package/features/ai/OpenAiSdkFactory.js

@@ -0,0 +1,92 @@
+import { createImplementation } from "@webiny/feature/api";
+import { AiSdkFactory } from "./abstractions.js";
+const OPENAI_MODELS = [
+    {
+        id: "gpt-5.6-sol",
+        name: "GPT-5.6 Sol"
+    },
+    {
+        id: "gpt-5.6-terra",
+        name: "GPT-5.6 Terra"
+    },
+    {
+        id: "gpt-5.6-luna",
+        name: "GPT-5.6 Luna"
+    },
+    {
+        id: "gpt-5.5",
+        name: "GPT-5.5"
+    },
+    {
+        id: "gpt-5.4",
+        name: "GPT-5.4"
+    },
+    {
+        id: "gpt-5.4-mini",
+        name: "GPT-5.4 Mini"
+    },
+    {
+        id: "gpt-5.4-nano",
+        name: "GPT-5.4 Nano"
+    },
+    {
+        id: "gpt-5.4-pro",
+        name: "GPT-5.4 Pro"
+    },
+    {
+        id: "gpt-5.3-chat-latest",
+        name: "GPT-5.3 Chat"
+    },
+    {
+        id: "gpt-4.1",
+        name: "GPT-4.1"
+    },
+    {
+        id: "gpt-4.1-mini",
+        name: "GPT-4.1 Mini"
+    },
+    {
+        id: "gpt-4.1-nano",
+        name: "GPT-4.1 Nano"
+    },
+    {
+        id: "gpt-4o",
+        name: "GPT-4o"
+    },
+    {
+        id: "gpt-4o-mini",
+        name: "GPT-4o Mini"
+    },
+    {
+        id: "o4-mini",
+        name: "o4 Mini"
+    },
+    {
+        id: "o3",
+        name: "o3"
+    }
+];
+class OpenAiSdkFactoryImpl {
+    async execute(apiKey) {
+        const { createOpenAI } = await import("@ai-sdk/openai");
+        const provider = createOpenAI({
+            apiKey: apiKey ?? process.env.WEBINY_API_OPENAI_API_KEY
+        });
+        return {
+            languageModel: (modelId)=>provider.chat(modelId)
+        };
+    }
+    constructor(){
+        this.id = "openai";
+        this.name = "OpenAI";
+        this.models = OPENAI_MODELS;
+    }
+}
+const OpenAiSdkFactory = createImplementation({
+    abstraction: AiSdkFactory,
+    implementation: OpenAiSdkFactoryImpl,
+    dependencies: []
+});
+export { OpenAiSdkFactory };
+
+//# sourceMappingURL=OpenAiSdkFactory.js.map

package/features/ai/OpenAiSdkFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/OpenAiSdkFactory.js","sources":["../../../src/features/ai/OpenAiSdkFactory.ts"],"sourcesContent":["import { createImplementation } from \"@webiny/feature/api\";\nimport { AiSdkFactory as AiSdkFactoryAbstraction } from \"./abstractions.js\";\nimport type { IAiSdk, IAiSdkModel } from \"./abstractions.js\";\n\nconst OPENAI_MODELS: IAiSdkModel[] = [\n    { id: \"gpt-5.6-sol\", name: \"GPT-5.6 Sol\" },\n    { id: \"gpt-5.6-terra\", name: \"GPT-5.6 Terra\" },\n    { id: \"gpt-5.6-luna\", name: \"GPT-5.6 Luna\" },\n    { id: \"gpt-5.5\", name: \"GPT-5.5\" },\n    { id: \"gpt-5.4\", name: \"GPT-5.4\" },\n    { id: \"gpt-5.4-mini\", name: \"GPT-5.4 Mini\" },\n    { id: \"gpt-5.4-nano\", name: \"GPT-5.4 Nano\" },\n    { id: \"gpt-5.4-pro\", name: \"GPT-5.4 Pro\" },\n    { id: \"gpt-5.3-chat-latest\", name: \"GPT-5.3 Chat\" },\n    { id: \"gpt-4.1\", name: \"GPT-4.1\" },\n    { id: \"gpt-4.1-mini\", name: \"GPT-4.1 Mini\" },\n    { id: \"gpt-4.1-nano\", name: \"GPT-4.1 Nano\" },\n    { id: \"gpt-4o\", name: \"GPT-4o\" },\n    { id: \"gpt-4o-mini\", name: \"GPT-4o Mini\" },\n    { id: \"o4-mini\", name: \"o4 Mini\" },\n    { id: \"o3\", name: \"o3\" }\n];\n\nclass OpenAiSdkFactoryImpl implements AiSdkFactoryAbstraction.Interface {\n    readonly id = \"openai\";\n    readonly name = \"OpenAI\";\n    readonly models = OPENAI_MODELS;\n\n    async execute(apiKey?: string): Promise<IAiSdk> {\n        const { createOpenAI } = await import(\"@ai-sdk/openai\");\n        const provider = createOpenAI({\n            apiKey: apiKey ?? process.env.WEBINY_API_OPENAI_API_KEY\n        });\n        return {\n            languageModel: modelId => provider.chat(modelId)\n        };\n    }\n}\n\nexport const OpenAiSdkFactory = createImplementation({\n    abstraction: AiSdkFactoryAbstraction,\n    implementation: OpenAiSdkFactoryImpl,\n    dependencies: []\n});\n"],"names":["OPENAI_MODELS","OpenAiSdkFactoryImpl","apiKey","createOpenAI","provider","process","modelId","OpenAiSdkFactory","createImplementation","AiSdkFactoryAbstraction"],"mappings":";;AAIA,MAAMA,gBAA+B;IACjC;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAiB,MAAM;IAAgB;IAC7C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAuB,MAAM;IAAe;IAClD;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAgB,MAAM;IAAe;IAC3C;QAAE,IAAI;QAAU,MAAM;IAAS;IAC/B;QAAE,IAAI;QAAe,MAAM;IAAc;IACzC;QAAE,IAAI;QAAW,MAAM;IAAU;IACjC;QAAE,IAAI;QAAM,MAAM;IAAK;CAC1B;AAED,MAAMC;IAKF,MAAM,QAAQC,MAAe,EAAmB;QAC5C,MAAM,EAAEC,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC;QACtC,MAAMC,WAAWD,aAAa;YAC1B,QAAQD,UAAUG,QAAQ,GAAG,CAAC,yBAAyB;QAC3D;QACA,OAAO;YACH,eAAeC,CAAAA,UAAWF,SAAS,IAAI,CAACE;QAC5C;IACJ;;aAZS,EAAE,GAAG;aACL,IAAI,GAAG;aACP,MAAM,GAAGN;;AAWtB;AAEO,MAAMO,mBAAmBC,qBAAqB;IACjD,aAAaC;IACb,gBAAgBR;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/TextExtractor/DefaultTextExtractor.d.ts

@@ -0,0 +1,9 @@
+import { TextExtractor, type TextExtractorResult } from "./abstractions.js";
+declare class TextExtractorImpl implements TextExtractor.Interface {
+    canExtract(mimeType: string): boolean;
+    extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult>;
+}
+export declare const DefaultTextExtractor: typeof TextExtractorImpl & {
+    __abstraction: import("@webiny/di").Abstraction<import("./abstractions.js").ITextExtractor>;
+};
+export {};

package/features/ai/TextExtractor/DefaultTextExtractor.js

@@ -0,0 +1,28 @@
+import { TextExtractor } from "./abstractions.js";
+import { extractDocxText } from "./parsers/docxParser.js";
+const TEXT_MIME_PREFIX = "text/";
+const SUPPORTED_MIME_TYPES = new Set([
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    "application/json"
+]);
+class TextExtractorImpl {
+    canExtract(mimeType) {
+        return mimeType.startsWith(TEXT_MIME_PREFIX) || SUPPORTED_MIME_TYPES.has(mimeType);
+    }
+    async extract(buffer, mimeType) {
+        if (mimeType.startsWith(TEXT_MIME_PREFIX) || "application/json" === mimeType) return {
+            text: buffer.toString("utf-8")
+        };
+        if ("application/vnd.openxmlformats-officedocument.wordprocessingml.document" === mimeType) return {
+            text: await extractDocxText(buffer)
+        };
+        throw new Error(`Unsupported MIME type: ${mimeType}`);
+    }
+}
+const DefaultTextExtractor = TextExtractor.createImplementation({
+    implementation: TextExtractorImpl,
+    dependencies: []
+});
+export { DefaultTextExtractor };
+
+//# sourceMappingURL=DefaultTextExtractor.js.map

package/features/ai/TextExtractor/DefaultTextExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/TextExtractor/DefaultTextExtractor.js","sources":["../../../../src/features/ai/TextExtractor/DefaultTextExtractor.ts"],"sourcesContent":["import { TextExtractor, type TextExtractorResult } from \"./abstractions.js\";\nimport { extractDocxText } from \"./parsers/docxParser.js\";\n\nconst TEXT_MIME_PREFIX = \"text/\";\n\nconst SUPPORTED_MIME_TYPES = new Set([\n    \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\",\n    \"application/json\"\n]);\n\nclass TextExtractorImpl implements TextExtractor.Interface {\n    canExtract(mimeType: string): boolean {\n        return mimeType.startsWith(TEXT_MIME_PREFIX) || SUPPORTED_MIME_TYPES.has(mimeType);\n    }\n\n    async extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult> {\n        if (mimeType.startsWith(TEXT_MIME_PREFIX) || mimeType === \"application/json\") {\n            return { text: buffer.toString(\"utf-8\") };\n        }\n\n        if (\n            mimeType === \"application/vnd.openxmlformats-officedocument.wordprocessingml.document\"\n        ) {\n            return { text: await extractDocxText(buffer) };\n        }\n\n        throw new Error(`Unsupported MIME type: ${mimeType}`);\n    }\n}\n\nexport const DefaultTextExtractor = TextExtractor.createImplementation({\n    implementation: TextExtractorImpl,\n    dependencies: []\n});\n"],"names":["TEXT_MIME_PREFIX","SUPPORTED_MIME_TYPES","Set","TextExtractorImpl","mimeType","buffer","extractDocxText","Error","DefaultTextExtractor","TextExtractor"],"mappings":";;AAGA,MAAMA,mBAAmB;AAEzB,MAAMC,uBAAuB,IAAIC,IAAI;IACjC;IACA;CACH;AAED,MAAMC;IACF,WAAWC,QAAgB,EAAW;QAClC,OAAOA,SAAS,UAAU,CAACJ,qBAAqBC,qBAAqB,GAAG,CAACG;IAC7E;IAEA,MAAM,QAAQC,MAAc,EAAED,QAAgB,EAAgC;QAC1E,IAAIA,SAAS,UAAU,CAACJ,qBAAqBI,AAAa,uBAAbA,UACzC,OAAO;YAAE,MAAMC,OAAO,QAAQ,CAAC;QAAS;QAG5C,IACID,AAAa,8EAAbA,UAEA,OAAO;YAAE,MAAM,MAAME,gBAAgBD;QAAQ;QAGjD,MAAM,IAAIE,MAAM,CAAC,uBAAuB,EAAEH,UAAU;IACxD;AACJ;AAEO,MAAMI,uBAAuBC,cAAc,oBAAoB,CAAC;IACnE,gBAAgBN;IAChB,cAAc,EAAE;AACpB"}

package/features/ai/TextExtractor/abstractions.d.ts

@@ -0,0 +1,12 @@
+export interface TextExtractorResult {
+    text: string;
+}
+export interface ITextExtractor {
+    canExtract(mimeType: string): boolean;
+    extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult>;
+}
+export declare const TextExtractor: import("@webiny/di").Abstraction<ITextExtractor>;
+export declare namespace TextExtractor {
+    type Interface = ITextExtractor;
+    type Result = TextExtractorResult;
+}

package/features/ai/TextExtractor/abstractions.js

@@ -0,0 +1,5 @@
+import { createAbstraction } from "@webiny/feature/api";
+const TextExtractor = createAbstraction("TextExtractor");
+export { TextExtractor };
+
+//# sourceMappingURL=abstractions.js.map

package/features/ai/TextExtractor/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/TextExtractor/abstractions.js","sources":["../../../../src/features/ai/TextExtractor/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\n\nexport interface TextExtractorResult {\n    text: string;\n}\n\nexport interface ITextExtractor {\n    canExtract(mimeType: string): boolean;\n    extract(buffer: Buffer, mimeType: string): Promise<TextExtractorResult>;\n}\n\nexport const TextExtractor = createAbstraction<ITextExtractor>(\"TextExtractor\");\n\nexport namespace TextExtractor {\n    export type Interface = ITextExtractor;\n    export type Result = TextExtractorResult;\n}\n"],"names":["TextExtractor","createAbstraction"],"mappings":";AAWO,MAAMA,gBAAgBC,kBAAkC"}

package/features/ai/TextExtractor/index.d.ts

@@ -0,0 +1,3 @@
+export { TextExtractor } from "./abstractions.js";
+export type { ITextExtractor, TextExtractorResult } from "./abstractions.js";
+export { DefaultTextExtractor } from "./DefaultTextExtractor.js";

package/features/ai/TextExtractor/index.js

@@ -0,0 +1,2 @@
+export { TextExtractor } from "./abstractions.js";
+export { DefaultTextExtractor } from "./DefaultTextExtractor.js";

package/features/ai/TextExtractor/parsers/docxParser.d.ts

@@ -0,0 +1 @@
+export declare function extractDocxText(buffer: Buffer): Promise<string>;

package/features/ai/TextExtractor/parsers/docxParser.js

@@ -0,0 +1,111 @@
+import { inflateRawSync } from "node:zlib";
+async function extractDocxText(buffer) {
+    const xml = extractFileFromZip(buffer, "word/document.xml");
+    if (!xml) throw new Error("Invalid DOCX: word/document.xml not found.");
+    const stylesXml = extractFileFromZip(buffer, "word/styles.xml");
+    const styleMap = stylesXml ? buildStyleMap(stylesXml) : new Map();
+    return convertToMarkdown(xml, styleMap);
+}
+function buildStyleMap(stylesXml) {
+    const map = new Map();
+    const styleRegex = /<w:style\s[^>]*w:styleId="([^"]*)"[^>]*>[\s\S]*?<\/w:style>/g;
+    let match;
+    while(null !== (match = styleRegex.exec(stylesXml))){
+        const styleId = match[1];
+        const block = match[0];
+        const nameMatch = block.match(/<w:name\s+w:val="([^"]*)"/);
+        if (nameMatch) map.set(styleId, nameMatch[1]);
+    }
+    return map;
+}
+function getHeadingLevel(paragraphXml, styleMap) {
+    const styleMatch = paragraphXml.match(/<w:pStyle\s+w:val="([^"]*)"/);
+    if (!styleMatch) return 0;
+    const styleId = styleMatch[1];
+    const directMatch = styleId.match(/^[Hh]eading(\d)$/);
+    if (directMatch) return parseInt(directMatch[1], 10);
+    const styleName = styleMap.get(styleId) ?? "";
+    const nameMatch = styleName.match(/^[Hh]eading\s*(\d)$/);
+    if (nameMatch) return parseInt(nameMatch[1], 10);
+    if (/title/i.test(styleName) || /title/i.test(styleId)) return 1;
+    return 0;
+}
+function isListItem(paragraphXml) {
+    return /<w:numId\s/.test(paragraphXml);
+}
+function extractRunMarkdown(runXml) {
+    const textRegex = /<w:t(?:\s[^>]*)?>([^<]*)<\/w:t>/g;
+    const texts = [];
+    let match;
+    while(null !== (match = textRegex.exec(runXml)))texts.push(match[1]);
+    if (0 === texts.length) return "";
+    const text = texts.join("");
+    const isBold = /<w:b[\s/>]/.test(runXml) && !/<w:b\s+w:val="(false|0)"/.test(runXml);
+    const isItalic = /<w:i[\s/>]/.test(runXml) && !/<w:i\s+w:val="(false|0)"/.test(runXml);
+    if (isBold && isItalic) return `***${text}***`;
+    if (isBold) return `**${text}**`;
+    if (isItalic) return `*${text}*`;
+    return text;
+}
+function convertToMarkdown(xml, styleMap) {
+    const paragraphs = [];
+    const paragraphRegex = /<w:p[\s>][\s\S]*?<\/w:p>/g;
+    let paragraphMatch;
+    while(null !== (paragraphMatch = paragraphRegex.exec(xml))){
+        const paragraphXml = paragraphMatch[0];
+        const runRegex = /<w:r[\s>][\s\S]*?<\/w:r>/g;
+        const runs = [];
+        let runMatch;
+        while(null !== (runMatch = runRegex.exec(paragraphXml))){
+            const md = extractRunMarkdown(runMatch[0]);
+            if (md) runs.push(md);
+        }
+        if (0 === runs.length) continue;
+        let line = runs.join("");
+        const headingLevel = getHeadingLevel(paragraphXml, styleMap);
+        if (headingLevel > 0 && headingLevel <= 6) line = `${"#".repeat(headingLevel)} ${line}`;
+        else if (isListItem(paragraphXml)) line = `- ${line}`;
+        paragraphs.push(line);
+    }
+    return paragraphs.join("\n\n");
+}
+function extractFileFromZip(buffer, targetPath) {
+    const eocdOffset = findEocd(buffer);
+    if (-1 === eocdOffset) throw new Error("Invalid ZIP: End of Central Directory not found.");
+    const cdOffset = buffer.readUInt32LE(eocdOffset + 16);
+    const cdSize = buffer.readUInt32LE(eocdOffset + 12);
+    const cdEnd = cdOffset + cdSize;
+    let offset = cdOffset;
+    while(offset < cdEnd){
+        const sig = buffer.readUInt32LE(offset);
+        if (0x02014b50 !== sig) break;
+        const compressionMethod = buffer.readUInt16LE(offset + 10);
+        const compressedSize = buffer.readUInt32LE(offset + 20);
+        const fileNameLen = buffer.readUInt16LE(offset + 28);
+        const extraLen = buffer.readUInt16LE(offset + 30);
+        const commentLen = buffer.readUInt16LE(offset + 32);
+        const localHeaderOffset = buffer.readUInt32LE(offset + 42);
+        const fileName = buffer.toString("utf-8", offset + 46, offset + 46 + fileNameLen);
+        if (fileName === targetPath) return readLocalFile(buffer, localHeaderOffset, compressionMethod, compressedSize);
+        offset += 46 + fileNameLen + extraLen + commentLen;
+    }
+    return null;
+}
+function readLocalFile(buffer, offset, compressionMethod, compressedSize) {
+    const sig = buffer.readUInt32LE(offset);
+    if (0x04034b50 !== sig) throw new Error("Invalid ZIP: bad local file header.");
+    const localFileNameLen = buffer.readUInt16LE(offset + 26);
+    const localExtraLen = buffer.readUInt16LE(offset + 28);
+    const dataOffset = offset + 30 + localFileNameLen + localExtraLen;
+    const raw = buffer.subarray(dataOffset, dataOffset + compressedSize);
+    if (0 === compressionMethod) return raw.toString("utf-8");
+    if (8 === compressionMethod) return inflateRawSync(raw).toString("utf-8");
+    throw new Error(`Unsupported ZIP compression method: ${compressionMethod}`);
+}
+function findEocd(buffer) {
+    for(let i = buffer.length - 22; i >= Math.max(0, buffer.length - 65557); i--)if (0x06054b50 === buffer.readUInt32LE(i)) return i;
+    return -1;
+}
+export { extractDocxText };
+
+//# sourceMappingURL=docxParser.js.map

package/features/ai/TextExtractor/parsers/docxParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/TextExtractor/parsers/docxParser.js","sources":["../../../../../src/features/ai/TextExtractor/parsers/docxParser.ts"],"sourcesContent":["import { inflateRawSync } from \"node:zlib\";\n\nexport async function extractDocxText(buffer: Buffer): Promise<string> {\n    const xml = extractFileFromZip(buffer, \"word/document.xml\");\n    if (!xml) {\n        throw new Error(\"Invalid DOCX: word/document.xml not found.\");\n    }\n\n    const stylesXml = extractFileFromZip(buffer, \"word/styles.xml\");\n    const styleMap = stylesXml ? buildStyleMap(stylesXml) : new Map<string, string>();\n\n    return convertToMarkdown(xml, styleMap);\n}\n\nfunction buildStyleMap(stylesXml: string): Map<string, string> {\n    const map = new Map<string, string>();\n    const styleRegex = /<w:style\\s[^>]*w:styleId=\"([^\"]*)\"[^>]*>[\\s\\S]*?<\\/w:style>/g;\n    let match: RegExpExecArray | null;\n\n    while ((match = styleRegex.exec(stylesXml)) !== null) {\n        const styleId = match[1];\n        const block = match[0];\n        const nameMatch = block.match(/<w:name\\s+w:val=\"([^\"]*)\"/);\n        if (nameMatch) {\n            map.set(styleId, nameMatch[1]);\n        }\n    }\n\n    return map;\n}\n\nfunction getHeadingLevel(paragraphXml: string, styleMap: Map<string, string>): number {\n    const styleMatch = paragraphXml.match(/<w:pStyle\\s+w:val=\"([^\"]*)\"/);\n    if (!styleMatch) {\n        return 0;\n    }\n\n    const styleId = styleMatch[1];\n\n    const directMatch = styleId.match(/^[Hh]eading(\\d)$/);\n    if (directMatch) {\n        return parseInt(directMatch[1], 10);\n    }\n\n    const styleName = styleMap.get(styleId) ?? \"\";\n    const nameMatch = styleName.match(/^[Hh]eading\\s*(\\d)$/);\n    if (nameMatch) {\n        return parseInt(nameMatch[1], 10);\n    }\n\n    if (/title/i.test(styleName) || /title/i.test(styleId)) {\n        return 1;\n    }\n\n    return 0;\n}\n\nfunction isListItem(paragraphXml: string): boolean {\n    return /<w:numId\\s/.test(paragraphXml);\n}\n\nfunction extractRunMarkdown(runXml: string): string {\n    const textRegex = /<w:t(?:\\s[^>]*)?>([^<]*)<\\/w:t>/g;\n    const texts: string[] = [];\n    let match: RegExpExecArray | null;\n    while ((match = textRegex.exec(runXml)) !== null) {\n        texts.push(match[1]);\n    }\n    if (texts.length === 0) {\n        return \"\";\n    }\n\n    const text = texts.join(\"\");\n    const isBold = /<w:b[\\s/>]/.test(runXml) && !/<w:b\\s+w:val=\"(false|0)\"/.test(runXml);\n    const isItalic = /<w:i[\\s/>]/.test(runXml) && !/<w:i\\s+w:val=\"(false|0)\"/.test(runXml);\n\n    if (isBold && isItalic) {\n        return `***${text}***`;\n    }\n    if (isBold) {\n        return `**${text}**`;\n    }\n    if (isItalic) {\n        return `*${text}*`;\n    }\n    return text;\n}\n\nfunction convertToMarkdown(xml: string, styleMap: Map<string, string>): string {\n    const paragraphs: string[] = [];\n    const paragraphRegex = /<w:p[\\s>][\\s\\S]*?<\\/w:p>/g;\n    let paragraphMatch: RegExpExecArray | null;\n\n    while ((paragraphMatch = paragraphRegex.exec(xml)) !== null) {\n        const paragraphXml = paragraphMatch[0];\n\n        const runRegex = /<w:r[\\s>][\\s\\S]*?<\\/w:r>/g;\n        const runs: string[] = [];\n        let runMatch: RegExpExecArray | null;\n        while ((runMatch = runRegex.exec(paragraphXml)) !== null) {\n            const md = extractRunMarkdown(runMatch[0]);\n            if (md) {\n                runs.push(md);\n            }\n        }\n\n        if (runs.length === 0) {\n            continue;\n        }\n\n        let line = runs.join(\"\");\n        const headingLevel = getHeadingLevel(paragraphXml, styleMap);\n\n        if (headingLevel > 0 && headingLevel <= 6) {\n            line = `${\"#\".repeat(headingLevel)} ${line}`;\n        } else if (isListItem(paragraphXml)) {\n            line = `- ${line}`;\n        }\n\n        paragraphs.push(line);\n    }\n\n    return paragraphs.join(\"\\n\\n\");\n}\n\n// --- ZIP utilities (unchanged) ---\n\nfunction extractFileFromZip(buffer: Buffer, targetPath: string): string | null {\n    const eocdOffset = findEocd(buffer);\n    if (eocdOffset === -1) {\n        throw new Error(\"Invalid ZIP: End of Central Directory not found.\");\n    }\n\n    const cdOffset = buffer.readUInt32LE(eocdOffset + 16);\n    const cdSize = buffer.readUInt32LE(eocdOffset + 12);\n    const cdEnd = cdOffset + cdSize;\n    let offset = cdOffset;\n\n    while (offset < cdEnd) {\n        const sig = buffer.readUInt32LE(offset);\n        if (sig !== 0x02014b50) {\n            break;\n        }\n\n        const compressionMethod = buffer.readUInt16LE(offset + 10);\n        const compressedSize = buffer.readUInt32LE(offset + 20);\n        const fileNameLen = buffer.readUInt16LE(offset + 28);\n        const extraLen = buffer.readUInt16LE(offset + 30);\n        const commentLen = buffer.readUInt16LE(offset + 32);\n        const localHeaderOffset = buffer.readUInt32LE(offset + 42);\n        const fileName = buffer.toString(\"utf-8\", offset + 46, offset + 46 + fileNameLen);\n\n        if (fileName === targetPath) {\n            return readLocalFile(buffer, localHeaderOffset, compressionMethod, compressedSize);\n        }\n\n        offset += 46 + fileNameLen + extraLen + commentLen;\n    }\n\n    return null;\n}\n\nfunction readLocalFile(\n    buffer: Buffer,\n    offset: number,\n    compressionMethod: number,\n    compressedSize: number\n): string {\n    const sig = buffer.readUInt32LE(offset);\n    if (sig !== 0x04034b50) {\n        throw new Error(\"Invalid ZIP: bad local file header.\");\n    }\n\n    const localFileNameLen = buffer.readUInt16LE(offset + 26);\n    const localExtraLen = buffer.readUInt16LE(offset + 28);\n    const dataOffset = offset + 30 + localFileNameLen + localExtraLen;\n\n    const raw = buffer.subarray(dataOffset, dataOffset + compressedSize);\n\n    if (compressionMethod === 0) {\n        return raw.toString(\"utf-8\");\n    }\n\n    if (compressionMethod === 8) {\n        return inflateRawSync(raw).toString(\"utf-8\");\n    }\n\n    throw new Error(`Unsupported ZIP compression method: ${compressionMethod}`);\n}\n\nfunction findEocd(buffer: Buffer): number {\n    for (let i = buffer.length - 22; i >= Math.max(0, buffer.length - 65557); i--) {\n        if (buffer.readUInt32LE(i) === 0x06054b50) {\n            return i;\n        }\n    }\n    return -1;\n}\n"],"names":["extractDocxText","buffer","xml","extractFileFromZip","Error","stylesXml","styleMap","buildStyleMap","Map","convertToMarkdown","map","styleRegex","match","styleId","block","nameMatch","getHeadingLevel","paragraphXml","styleMatch","directMatch","parseInt","styleName","isListItem","extractRunMarkdown","runXml","textRegex","texts","text","isBold","isItalic","paragraphs","paragraphRegex","paragraphMatch","runRegex","runs","runMatch","md","line","headingLevel","targetPath","eocdOffset","findEocd","cdOffset","cdSize","cdEnd","offset","sig","compressionMethod","compressedSize","fileNameLen","extraLen","commentLen","localHeaderOffset","fileName","readLocalFile","localFileNameLen","localExtraLen","dataOffset","raw","inflateRawSync","i","Math"],"mappings":"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"}

package/features/ai/abstractions.d.ts

@@ -0,0 +1,92 @@
+import type { generateText } from "ai";
+import type { streamText } from "ai";
+import type { LanguageModel } from "ai";
+import type { FlexibleSchema, ToolSet } from "ai";
+export interface IAiSdkModel {
+    id: string;
+    name: string;
+}
+export interface IAiSdk {
+    languageModel(modelId: string): LanguageModel;
+}
+/** A single AI SDK instance (e.g. OpenAI, Anthropic) that resolves model instances. */
+export declare const AiSdk: import("@webiny/di").Abstraction<IAiSdk>;
+export declare namespace AiSdk {
+    type Interface = IAiSdk;
+}
+export interface IAiSdkFactory {
+    readonly id: string;
+    readonly name: string;
+    readonly models: readonly IAiSdkModel[];
+    execute(apiKey?: string): Promise<IAiSdk>;
+}
+/** Factory that asynchronously initialises an AI SDK. Register one per provider namespace. */
+export declare const AiSdkFactory: import("@webiny/di").Abstraction<IAiSdkFactory>;
+export declare namespace AiSdkFactory {
+    type Interface = IAiSdkFactory;
+}
+export interface IAiConnectionInline {
+    readonly sdkName: string;
+    readonly apiKey?: string;
+}
+export interface IAiConnection extends IAiConnectionInline {
+    readonly id: string;
+}
+export interface IAiConnectionFactory {
+    execute(): Promise<IAiConnection>;
+}
+/** Factory that asynchronously produces an AiConnection. */
+export declare const AiConnectionFactory: import("@webiny/di").Abstraction<IAiConnectionFactory>;
+export declare namespace AiConnectionFactory {
+    type Interface = IAiConnectionFactory;
+}
+type SDKGenerateTextParams = Parameters<typeof generateText>[0];
+type SDKStreamTextParams = Parameters<typeof streamText>[0];
+export type AiGenerateTextParams = Omit<SDKGenerateTextParams, "model"> & {
+    model: string;
+    connection?: string | IAiConnectionInline;
+};
+export type AiStreamTextParams = Omit<SDKStreamTextParams, "model"> & {
+    model: string;
+    connection?: string | IAiConnectionInline;
+};
+export interface AiModel {
+    providerId: string;
+    providerName: string;
+    modelId: string;
+    modelName: string;
+}
+export interface IAi {
+    generateText(params: AiGenerateTextParams): ReturnType<typeof generateText>;
+    streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>>;
+    listModels(): Promise<AiModel[]>;
+    listModelsByConnections(): Promise<AiModel[]>;
+    listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]>;
+}
+/** Interact with AI language models using registered providers. */
+export declare const Ai: import("@webiny/di").Abstraction<IAi>;
+export declare namespace Ai {
+    type Interface = IAi;
+    type GenerateTextParams = AiGenerateTextParams;
+    type StreamTextParams = AiStreamTextParams;
+}
+export interface IAiSdkTool<TInput = any> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: FlexibleSchema<TInput>;
+    execute(input: TInput): Promise<unknown>;
+}
+/** A single tool that can be provided to AI generateText/streamText calls. */
+export declare const AiSdkTool: import("@webiny/di").Abstraction<IAiSdkTool<any>>;
+export declare namespace AiSdkTool {
+    type Interface = IAiSdkTool;
+}
+export interface IAiSdkTools {
+    getToolSet(): ToolSet;
+}
+/** Collection of AI SDK tools. Returns a ready-to-use ToolSet for generateText/streamText. */
+export declare const AiSdkTools: import("@webiny/di").Abstraction<IAiSdkTools>;
+export declare namespace AiSdkTools {
+    type Interface = IAiSdkTools;
+}
+export {};

package/features/ai/abstractions.js

@@ -0,0 +1,10 @@
+import { createAbstraction } from "@webiny/feature/api";
+const AiSdk = createAbstraction("AiSdk");
+const AiSdkFactory = createAbstraction("AiSdkFactory");
+const AiConnectionFactory = createAbstraction("AiConnectionFactory");
+const Ai = createAbstraction("Ai");
+const AiSdkTool = createAbstraction("AiSdkTool");
+const AiSdkTools = createAbstraction("AiSdkTools");
+export { Ai, AiConnectionFactory, AiSdk, AiSdkFactory, AiSdkTool, AiSdkTools };
+
+//# sourceMappingURL=abstractions.js.map

package/features/ai/abstractions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features/ai/abstractions.js","sources":["../../../src/features/ai/abstractions.ts"],"sourcesContent":["import { createAbstraction } from \"@webiny/feature/api\";\nimport type { generateText } from \"ai\";\nimport type { streamText } from \"ai\";\nimport type { LanguageModel } from \"ai\";\nimport type { FlexibleSchema, ToolSet } from \"ai\";\n\n// AiSdk\n\nexport interface IAiSdkModel {\n    id: string; // raw model id, e.g. \"claude-sonnet-4-5\"\n    name: string; // human-friendly name, e.g. \"Claude Sonnet 4.5\"\n}\n\nexport interface IAiSdk {\n    languageModel(modelId: string): LanguageModel;\n}\n\n/** A single AI SDK instance (e.g. OpenAI, Anthropic) that resolves model instances. */\nexport const AiSdk = createAbstraction<IAiSdk>(\"AiSdk\");\n\nexport namespace AiSdk {\n    export type Interface = IAiSdk;\n}\n\n// AiSdkFactory\n\nexport interface IAiSdkFactory {\n    readonly id: string; // machine id, e.g. \"anthropic\"\n    readonly name: string; // human-friendly name, e.g. \"Anthropic\"\n    readonly models: readonly IAiSdkModel[]; // static model list, no API call needed\n    execute(apiKey?: string): Promise<IAiSdk>;\n}\n\n/** Factory that asynchronously initialises an AI SDK. Register one per provider namespace. */\nexport const AiSdkFactory = createAbstraction<IAiSdkFactory>(\"AiSdkFactory\");\n\nexport namespace AiSdkFactory {\n    export type Interface = IAiSdkFactory;\n}\n\n// AiConnection\n\nexport interface IAiConnectionInline {\n    readonly sdkName: string;\n    readonly apiKey?: string;\n}\n\nexport interface IAiConnection extends IAiConnectionInline {\n    readonly id: string;\n}\n\n// AiConnectionFactory\n\nexport interface IAiConnectionFactory {\n    execute(): Promise<IAiConnection>;\n}\n\n/** Factory that asynchronously produces an AiConnection. */\nexport const AiConnectionFactory = createAbstraction<IAiConnectionFactory>(\"AiConnectionFactory\");\n\nexport namespace AiConnectionFactory {\n    export type Interface = IAiConnectionFactory;\n}\n\n// Ai\n\ntype SDKGenerateTextParams = Parameters<typeof generateText>[0];\ntype SDKStreamTextParams = Parameters<typeof streamText>[0];\n\nexport type AiGenerateTextParams = Omit<SDKGenerateTextParams, \"model\"> & {\n    model: string;\n    connection?: string | IAiConnectionInline;\n};\nexport type AiStreamTextParams = Omit<SDKStreamTextParams, \"model\"> & {\n    model: string;\n    connection?: string | IAiConnectionInline;\n};\n\nexport interface AiModel {\n    providerId: string; // e.g. \"anthropic\"\n    providerName: string; // e.g. \"Anthropic\"\n    modelId: string; // e.g. \"claude-sonnet-4-5\"\n    modelName: string; // e.g. \"Claude Sonnet 4.5\"\n}\n\nexport interface IAi {\n    generateText(params: AiGenerateTextParams): ReturnType<typeof generateText>;\n    streamText(params: AiStreamTextParams): Promise<ReturnType<typeof streamText>>;\n    listModels(): Promise<AiModel[]>;\n    listModelsByConnections(): Promise<AiModel[]>;\n    listModelsByConnection(connection: string | IAiConnectionInline): Promise<AiModel[]>;\n}\n\n/** Interact with AI language models using registered providers. */\nexport const Ai = createAbstraction<IAi>(\"Ai\");\n\nexport namespace Ai {\n    export type Interface = IAi;\n    export type GenerateTextParams = AiGenerateTextParams;\n    export type StreamTextParams = AiStreamTextParams;\n}\n\n// AiSdkTool\n\nexport interface IAiSdkTool<TInput = any> {\n    readonly name: string;\n    readonly description: string;\n    readonly inputSchema: FlexibleSchema<TInput>;\n    execute(input: TInput): Promise<unknown>;\n}\n\n/** A single tool that can be provided to AI generateText/streamText calls. */\nexport const AiSdkTool = createAbstraction<IAiSdkTool>(\"AiSdkTool\");\n\nexport namespace AiSdkTool {\n    export type Interface = IAiSdkTool;\n}\n\n// AiSdkTools\n\nexport interface IAiSdkTools {\n    getToolSet(): ToolSet;\n}\n\n/** Collection of AI SDK tools. Returns a ready-to-use ToolSet for generateText/streamText. */\nexport const AiSdkTools = createAbstraction<IAiSdkTools>(\"AiSdkTools\");\n\nexport namespace AiSdkTools {\n    export type Interface = IAiSdkTools;\n}\n"],"names":["AiSdk","createAbstraction","AiSdkFactory","AiConnectionFactory","Ai","AiSdkTool","AiSdkTools"],"mappings":";AAkBO,MAAMA,QAAQC,kBAA0B;AAgBxC,MAAMC,eAAeD,kBAAiC;AAwBtD,MAAME,sBAAsBF,kBAAwC;AAoCpE,MAAMG,KAAKH,kBAAuB;AAkBlC,MAAMI,YAAYJ,kBAA8B;AAahD,MAAMK,aAAaL,kBAA+B"}

package/features/ai/events.d.ts

@@ -0,0 +1,59 @@
+import { DomainEvent } from "../../features/eventPublisher/index.js";
+import type { IEventHandler } from "../../features/eventPublisher/index.js";
+import type { AiGenerateTextParams, AiStreamTextParams } from "./abstractions.js";
+import type { generateText } from "ai";
+export interface AiBeforeGenerateTextPayload {
+    requestId: string;
+    params: AiGenerateTextParams;
+}
+export declare class AiBeforeGenerateTextEvent extends DomainEvent<AiBeforeGenerateTextPayload> {
+    eventType: "ai.beforeGenerateText";
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<IEventHandler<AiBeforeGenerateTextEvent>>;
+}
+export declare const AiBeforeGenerateTextEventHandler: import("@webiny/di").Abstraction<IEventHandler<AiBeforeGenerateTextEvent>>;
+export declare namespace AiBeforeGenerateTextEventHandler {
+    type Interface = IEventHandler<AiBeforeGenerateTextEvent>;
+    type Event = AiBeforeGenerateTextEvent;
+}
+export interface AiAfterGenerateTextPayload {
+    requestId: string;
+    params: AiGenerateTextParams;
+    result: Awaited<ReturnType<typeof generateText>>;
+    duration: number;
+}
+export declare class AiAfterGenerateTextEvent extends DomainEvent<AiAfterGenerateTextPayload> {
+    eventType: "ai.afterGenerateText";
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<IEventHandler<AiAfterGenerateTextEvent>>;
+}
+export declare const AiAfterGenerateTextEventHandler: import("@webiny/di").Abstraction<IEventHandler<AiAfterGenerateTextEvent>>;
+export declare namespace AiAfterGenerateTextEventHandler {
+    type Interface = IEventHandler<AiAfterGenerateTextEvent>;
+    type Event = AiAfterGenerateTextEvent;
+}
+export interface AiGenerateTextErrorPayload {
+    requestId: string;
+    params: AiGenerateTextParams;
+    error: Error;
+    duration: number;
+}
+export declare class AiGenerateTextErrorEvent extends DomainEvent<AiGenerateTextErrorPayload> {
+    eventType: "ai.generateTextError";
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<IEventHandler<AiGenerateTextErrorEvent>>;
+}
+export declare const AiGenerateTextErrorEventHandler: import("@webiny/di").Abstraction<IEventHandler<AiGenerateTextErrorEvent>>;
+export declare namespace AiGenerateTextErrorEventHandler {
+    type Interface = IEventHandler<AiGenerateTextErrorEvent>;
+    type Event = AiGenerateTextErrorEvent;
+}
+export interface AiBeforeStreamTextPayload {
+    params: AiStreamTextParams;
+}
+export declare class AiBeforeStreamTextEvent extends DomainEvent<AiBeforeStreamTextPayload> {
+    eventType: "ai.beforeStreamText";
+    getHandlerAbstraction(): import("@webiny/di").Abstraction<IEventHandler<AiBeforeStreamTextEvent>>;
+}
+export declare const AiBeforeStreamTextEventHandler: import("@webiny/di").Abstraction<IEventHandler<AiBeforeStreamTextEvent>>;
+export declare namespace AiBeforeStreamTextEventHandler {
+    type Interface = IEventHandler<AiBeforeStreamTextEvent>;
+    type Event = AiBeforeStreamTextEvent;
+}