@loopstack/ai-module 0.16.0 → 0.16.1

package/.prettierrc

@@ -0,0 +1,4 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all"
+}

package/README.md

@@ -1,2 +1,261 @@
-# Loopstack AI Module
+# @loopstack/ai-module
 
+> A module for the [Loopstack AI](https://loopstack.ai) automation framework.
+
+This module provides tools for integrating Large Language Models (LLMs) into your workflows, with support for OpenAI and Anthropic providers.
+
+## Overview
+
+The AI Module enables workflows to leverage LLM capabilities for text generation, structured object generation, and agentic tool calling patterns. It abstracts provider-specific implementations behind a unified interface.
+
+By using this module, you'll be able to:
+
+- Generate text responses using OpenAI or Anthropic models
+- Generate structured objects that conform to document schemas
+- Build agentic workflows with LLM tool calling
+- Create AI-powered conversational interfaces
+
+This module is essential for workflows that need natural language processing, content generation, or AI-driven decision making.
+
+## Installation
+
+### Prerequisites
+
+Create a new Loopstack project if you haven't already:
+
+```bash
+npx create-loopstack-app my-project
+cd my-project
+```
+
+Start Environment
+
+```bash
+cd my-project
+docker compose up -d
+```
+
+### Install the Module
+
+#### As Node Dependency via Npm:
+
+```bash
+npm install --save @loopstack/ai-module
+```
+
+#### OR: Copy Sources via Loopstack CLI
+
+```bash
+loopstack add @loopstack/ai-module
+```
+
+### Configure API Keys
+
+Set your provider API keys as environment variables:
+
+```bash
+# OpenAI
+OPENAI_API_KEY=sk-...
+
+# Anthropic
+ANTHROPIC_API_KEY=sk-ant-...
+```
+
+## Setup
+
+### 1. Import the Module
+
+Add `AiModule` to your `default.module.ts` (included in the skeleton app) or to your own module:
+
+```typescript
+import { Module } from '@nestjs/common';
+import { LoopCoreModule } from '@loopstack/core';
+import { AiModule } from '@loopstack/ai-module';
+import { DefaultWorkspace } from './default.workspace';
+
+@Module({
+  imports: [LoopCoreModule, AiModule],
+  providers: [DefaultWorkspace],
+})
+export class DefaultModule {}
+```
+
+### 2. Use in Your Workflow
+
+Inject the tools and documents in your workflow class:
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { BlockConfig, Document, Tool, Helper } from '@loopstack/common';
+import { WorkflowBase } from '@loopstack/core';
+import {
+  AiGenerateText,
+  AiGenerateObject,
+  AiGenerateDocument,
+  DelegateToolCall,
+  AiMessageDocument,
+} from '@loopstack/ai-module';
+
+@Injectable()
+@BlockConfig({
+  configFile: __dirname + '/my.workflow.yaml',
+})
+export class MyWorkflow extends WorkflowBase {
+  // Tools
+  @Tool() aiGenerateText: AiGenerateText;
+  @Tool() aiGenerateObject: AiGenerateObject;
+  @Tool() aiGenerateDocument: AiGenerateDocument;
+  @Tool() delegateToolCall: DelegateToolCall;
+
+  // Documents
+  @Document() aiMessageDocument: AiMessageDocument;
+}
+```
+
+## Tool Reference
+
+### AiGenerateText
+
+Generates text using an LLM with optional tool calling support.
+
+#### Arguments
+
+| Argument | Type | Required | Description |
+|----------|------|----------|-------------|
+| `llm.provider` | string | No | Provider name (`openai` or `anthropic`) |
+| `llm.model` | string | No | Model identifier (e.g., `gpt-4o`, `claude-3-sonnet`) |
+| `llm.envApiKey` | string | No | Environment variable name for API key |
+| `prompt` | string | No | Simple text prompt |
+| `messages` | array | No | Array of message objects with `role` and `content` |
+| `messagesSearchTag` | string | No | Tag to search for messages in workflow documents |
+| `tools` | string[] | No | Array of tool names to make available to the LLM |
+
+#### Example
+
+```yaml
+- tool: aiGenerateText
+  args:
+    llm:
+      provider: openai
+      model: gpt-4o
+    messagesSearchTag: message
+    tools:
+      - getWeather
+  assign:
+    llmResponse: ${ result.data }
+```
+
+### AiGenerateObject
+
+Generates a structured object using an LLM that conforms to a document schema.
+
+#### Arguments
+
+| Argument | Type | Required | Description |
+|----------|------|----------|-------------|
+| `llm.provider` | string | No | Provider name |
+| `llm.model` | string | No | Model identifier |
+| `prompt` | string | No | Simple text prompt |
+| `messages` | array | No | Array of message objects |
+| `messagesSearchTag` | string | No | Tag to search for messages |
+| `response.document` | string | Yes | Document name whose schema defines the output structure |
+| `response.id` | string | No | Custom ID for the generated object |
+
+#### Example
+
+```yaml
+- tool: aiGenerateObject
+  args:
+    llm:
+      provider: anthropic
+      model: claude-3-sonnet
+    prompt: "Extract the key information from this text: {{ inputText }}"
+    response:
+      document: infoDocument
+  assign:
+    entities: ${ result.data }
+```
+
+### AiGenerateDocument
+
+Combines `AiGenerateObject` and `CreateDocument` into a single operation. Generates a structured object and immediately creates it as a document.
+
+#### Arguments
+
+Same as `AiGenerateObject`. The generated object is automatically created as a document using the specified document type.
+
+#### Example
+
+```yaml
+- tool: aiGenerateDocument
+  args:
+    llm:
+      provider: openai
+      model: gpt-4o
+    messagesSearchTag: message
+    response:
+      document: summaryDocument
+```
+
+### DelegateToolCall
+
+Executes tool calls requested by the LLM and returns the results in the expected format.
+
+#### Arguments
+
+| Argument | Type | Required | Description |
+|----------|------|----------|-------------|
+| `message` | object | Yes | The LLM response message containing tool call parts |
+| `message.id` | string | Yes | Message identifier |
+| `message.parts` | array | Yes | Array of tool call parts with `type`, `input`, and `toolCallId` |
+
+#### Example
+
+```yaml
+- tool: delegateToolCall
+  args:
+    message: ${ llmResponse }
+  assign:
+    toolCallResult: ${ result.data }
+```
+
+## Document Types
+
+### AiMessageDocument
+
+Represents an AI conversation message with support for multi-part content (text, tool calls, tool results).
+
+**Schema:**
+```typescript
+{
+  id?: string;                          // Message identifier
+  role: 'system' | 'user' | 'assistant'; // Message role
+  metadata?: any;                        // Optional metadata
+  parts: any[];                          // Message content parts
+}
+```
+
+**Example:**
+```yaml
+- tool: createDocument
+  args:
+    document: aiMessageDocument
+    update:
+      content:
+        role: user
+        parts:
+          - type: text
+            text: How is the weather in Berlin?
+```
+
+## About
+
+Author: [Jakob Klippel](https://www.linkedin.com/in/jakob-klippel/)
+
+License: Apache-2.0
+
+### Additional Resources
+
+- [Loopstack Documentation](https://loopstack.ai/docs)
+- [Getting Started with Loopstack](https://loopstack.ai/docs/getting-started)
+- For more examples how to use this module look for `@loopstack/ai-module` in the [Loopstack Registry](https://loopstack.ai/registry)

package/dist/ai.module.js

@@ -26,16 +26,20 @@ exports.AiModule = AiModule = __decorate([
     (0, common_1.Module)({
         imports: [core_1.LoopCoreModule, core_ui_module_1.CoreUiModule, core_2.DiscoveryModule],
         providers: [
+            // services
             services_1.AiMessagesHelperService,
             services_2.AiProviderModelHelperService,
             services_3.AiToolsHelperService,
             ai_provider_registry_service_1.AiProviderRegistryService,
+            // ai providers
             openai_provider_1.OpenAiProviderService,
             anthropic_provider_1.AnthropicProviderService,
+            // tools
             tools_1.AiGenerateDocument,
             tools_1.AiGenerateObject,
             tools_1.AiGenerateText,
             tools_1.DelegateToolCall,
+            // documents
             documents_1.AiMessageDocument,
         ],
         exports: [

package/dist/ai.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.module.js","sourceRoot":"","sources":["../src/ai.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,0CAAiD;AACjD,0FAAoF;AACpF,iEAAoE;AACpE,uEAA0E;AAC1E,uCAA+C;AAC/C,yCAAqD;AACrD,yCAA0D;AAC1D,yCAAkD;AAClD,mCAKiB;AACjB,2CAAgD;AAChD,8DAAyD;AAgClD,IAAM,QAAQ,GAAd,MAAM,QAAQ;CAAG,CAAA;AAAX,4BAAQ;mBAAR,QAAQ;IA9BpB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAc,EAAE,6BAAY,EAAE,sBAAe,CAAC;QACxD,SAAS,EAAE;YAET,kCAAuB;YACvB,uCAA4B;YAC5B,+BAAoB;YACpB,wDAAyB;YAGzB,uCAAqB;YACrB,6CAAwB;YAGxB,0BAAkB;YAClB,wBAAgB;YAChB,sBAAc;YACd,wBAAgB;YAGhB,6BAAiB;SAClB;QACD,OAAO,EAAE;YACP,0BAAkB;YAClB,wBAAgB;YAChB,sBAAc;YACd,wBAAgB;YAChB,6BAAiB;SAClB;KACF,CAAC;GACW,QAAQ,CAAG"}
+{"version":3,"file":"ai.module.js","sourceRoot":"","sources":["../src/ai.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,0CAAiD;AACjD,0FAAoF;AACpF,iEAAoE;AACpE,uEAA0E;AAC1E,uCAA+C;AAC/C,yCAAqD;AACrD,yCAA0D;AAC1D,yCAAkD;AAClD,mCAKiB;AACjB,2CAAgD;AAChD,8DAAyD;AAgClD,IAAM,QAAQ,GAAd,MAAM,QAAQ;CAAG,CAAA;AAAX,4BAAQ;mBAAR,QAAQ;IA9BpB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,qBAAc,EAAE,6BAAY,EAAE,sBAAe,CAAC;QACxD,SAAS,EAAE;YACT,WAAW;YACX,kCAAuB;YACvB,uCAA4B;YAC5B,+BAAoB;YACpB,wDAAyB;YAEzB,eAAe;YACf,uCAAqB;YACrB,6CAAwB;YAExB,QAAQ;YACR,0BAAkB;YAClB,wBAAgB;YAChB,sBAAc;YACd,wBAAgB;YAEhB,YAAY;YACZ,6BAAiB;SAClB;QACD,OAAO,EAAE;YACP,0BAAkB;YAClB,wBAAgB;YAChB,sBAAc;YACd,wBAAgB;YAChB,6BAAiB;SAClB;KACF,CAAC;GACW,QAAQ,CAAG"}

package/dist/schemas/ai-generate-tool-base.schema.d.ts

@@ -6,52 +6,52 @@ export declare const AiGenerateToolBaseSchema: z.ZodObject<{
         envApiKey: z.ZodOptional<z.ZodString>;
         cacheResponse: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
     }, {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
     }>>;
     messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<["system", "assistant", "user", "tool"]>;
         content: z.ZodAny;
     }, "strip", z.ZodTypeAny, {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
     }, {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
     }>, "many">>;
     prompt: z.ZodOptional<z.ZodString>;
     messagesSearchTag: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     llm?: {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
-    } | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
+    };
     messages?: {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
-    }[] | undefined;
-    prompt?: string | undefined;
-    messagesSearchTag?: string | undefined;
+    }[];
+    prompt?: string;
+    messagesSearchTag?: string;
 }, {
     llm?: {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
-    } | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
+    };
     messages?: {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
-    }[] | undefined;
-    prompt?: string | undefined;
-    messagesSearchTag?: string | undefined;
+    }[];
+    prompt?: string;
+    messagesSearchTag?: string;
 }>;

package/dist/services/ai-tools-helper.service.js

@@ -10,6 +10,7 @@ exports.AiToolsHelperService = void 0;
 const common_1 = require("@nestjs/common");
 let AiToolsHelperService = class AiToolsHelperService {
     getTools(tools, parent) {
+        // using any instead of ToolSet bc ai sdk types have some nesting issue
         const toolDefinitions = {};
         for (const toolName of tools) {
             const tool = parent.getTool(toolName);
@@ -21,7 +22,7 @@ let AiToolsHelperService = class AiToolsHelperService {
                 toolDefinitions[toolName] = {
                     description: tool.config.description,
                     inputSchema,
-                };
+                }; // using any bc ai sdk types have some nesting issue
             }
         }
         return Object.keys(toolDefinitions).length ? toolDefinitions : undefined;

package/dist/services/ai-tools-helper.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools-helper.service.js","sourceRoot":"","sources":["../../src/services/ai-tools-helper.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAIrC,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,QAAQ,CACN,KAAe,EACf,MAAoB;QAGpB,MAAM,eAAe,GAAwB,EAAE,CAAC;QAEhD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,qCAAqC,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;YAEpC,IAAI,WAAW,EAAE,CAAC;gBAChB,eAAe,CAAC,QAAQ,CAAC,GAAG;oBAC1B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;oBACpC,WAAW;iBACL,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,CAAC;CACF,CAAA;AA5BY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;GACA,oBAAoB,CA4BhC"}
+{"version":3,"file":"ai-tools-helper.service.js","sourceRoot":"","sources":["../../src/services/ai-tools-helper.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAIrC,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,QAAQ,CACN,KAAe,EACf,MAAoB;QAEpB,uEAAuE;QACvE,MAAM,eAAe,GAAwB,EAAE,CAAC;QAEhD,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CACb,kBAAkB,QAAQ,qCAAqC,CAChE,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;YAEpC,IAAI,WAAW,EAAE,CAAC;gBAChB,eAAe,CAAC,QAAQ,CAAC,GAAG;oBAC1B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;oBACpC,WAAW;iBACL,CAAC,CAAC,oDAAoD;YAChE,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,CAAC;CACF,CAAA;AA5BY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,GAAE;GACA,oBAAoB,CA4BhC"}

package/dist/tools/ai-generate-object.tool.d.ts

@@ -11,24 +11,24 @@ export declare const AiGenerateObjectSchema: z.ZodObject<{
         envApiKey: z.ZodOptional<z.ZodString>;
         cacheResponse: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
     }, {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
     }>>;
     messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<["system", "assistant", "user", "tool"]>;
         content: z.ZodAny;
     }, "strip", z.ZodTypeAny, {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
     }, {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
     }>, "many">>;
     prompt: z.ZodOptional<z.ZodString>;
@@ -38,46 +38,46 @@ export declare const AiGenerateObjectSchema: z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         document: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        document: string;
-        id?: string | undefined;
+        id?: string;
+        document?: string;
     }, {
-        document: string;
-        id?: string | undefined;
+        id?: string;
+        document?: string;
     }>;
 }, "strict", z.ZodTypeAny, {
-    response: {
-        document: string;
-        id?: string | undefined;
-    };
     llm?: {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
-    } | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
+    };
     messages?: {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
-    }[] | undefined;
-    prompt?: string | undefined;
-    messagesSearchTag?: string | undefined;
-}, {
-    response: {
-        document: string;
-        id?: string | undefined;
+    }[];
+    prompt?: string;
+    messagesSearchTag?: string;
+    response?: {
+        id?: string;
+        document?: string;
     };
+}, {
     llm?: {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
-    } | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
+    };
     messages?: {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
-    }[] | undefined;
-    prompt?: string | undefined;
-    messagesSearchTag?: string | undefined;
+    }[];
+    prompt?: string;
+    messagesSearchTag?: string;
+    response?: {
+        id?: string;
+        document?: string;
+    };
 }>;
 export type AiGenerateObjectArgsType = z.infer<typeof AiGenerateObjectSchema>;
 export declare class AiGenerateObject extends ToolBase<AiGenerateObjectArgsType> {

package/dist/tools/ai-generate-text.tool.d.ts

@@ -12,24 +12,24 @@ export declare const AiGenerateTextSchema: z.ZodObject<{
         envApiKey: z.ZodOptional<z.ZodString>;
         cacheResponse: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
     }, {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
     }>>;
     messages: z.ZodOptional<z.ZodArray<z.ZodObject<{
         role: z.ZodEnum<["system", "assistant", "user", "tool"]>;
         content: z.ZodAny;
     }, "strip", z.ZodTypeAny, {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
     }, {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
     }>, "many">>;
     prompt: z.ZodOptional<z.ZodString>;
@@ -38,32 +38,32 @@ export declare const AiGenerateTextSchema: z.ZodObject<{
     tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
     llm?: {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
-    } | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
+    };
     messages?: {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
-    }[] | undefined;
-    prompt?: string | undefined;
-    messagesSearchTag?: string | undefined;
-    tools?: string[] | undefined;
+    }[];
+    prompt?: string;
+    messagesSearchTag?: string;
+    tools?: string[];
 }, {
     llm?: {
-        model?: string | undefined;
-        provider?: string | undefined;
-        envApiKey?: string | undefined;
-        cacheResponse?: boolean | undefined;
-    } | undefined;
+        model?: string;
+        provider?: string;
+        envApiKey?: string;
+        cacheResponse?: boolean;
+    };
     messages?: {
-        role: "system" | "assistant" | "user" | "tool";
+        role?: "system" | "assistant" | "user" | "tool";
         content?: any;
-    }[] | undefined;
-    prompt?: string | undefined;
-    messagesSearchTag?: string | undefined;
-    tools?: string[] | undefined;
+    }[];
+    prompt?: string;
+    messagesSearchTag?: string;
+    tools?: string[];
 }>;
 type AiGenerateTextArgsType = z.infer<typeof AiGenerateTextSchema>;
 export declare class AiGenerateText extends ToolBase<AiGenerateTextArgsType> {

package/dist/tools/ai-generate-text.tool.js

@@ -72,6 +72,7 @@ let AiGenerateText = class AiGenerateText extends core_1.ToolBase {
                         resolve(data.responseMessage);
                     },
                 });
+                // Consume the stream to trigger execution
                 (async () => {
                     try {
                         const reader = stream.getReader();

package/dist/tools/ai-generate-text.tool.js.map

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

package/dist/tools/delegate-tool-call.tool.d.ts

@@ -10,45 +10,45 @@ declare const DelegateToolCallsToolSchema: z.ZodObject<{
             input: z.ZodAny;
             toolCallId: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            type: string;
-            toolCallId: string;
+            type?: string;
             input?: any;
+            toolCallId?: string;
         }, {
-            type: string;
-            toolCallId: string;
+            type?: string;
             input?: any;
+            toolCallId?: string;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        id: string;
-        parts: {
-            type: string;
-            toolCallId: string;
+        id?: string;
+        parts?: {
+            type?: string;
             input?: any;
+            toolCallId?: string;
         }[];
     }, {
-        id: string;
-        parts: {
-            type: string;
-            toolCallId: string;
+        id?: string;
+        parts?: {
+            type?: string;
             input?: any;
+            toolCallId?: string;
         }[];
     }>;
 }, "strip", z.ZodTypeAny, {
-    message: {
-        id: string;
-        parts: {
-            type: string;
-            toolCallId: string;
+    message?: {
+        id?: string;
+        parts?: {
+            type?: string;
             input?: any;
+            toolCallId?: string;
         }[];
     };
 }, {
-    message: {
-        id: string;
-        parts: {
-            type: string;
-            toolCallId: string;
+    message?: {
+        id?: string;
+        parts?: {
+            type?: string;
             input?: any;
+            toolCallId?: string;
         }[];
     };
 }>;

package/package.json

@@ -2,7 +2,7 @@
   "name": "@loopstack/ai-module",
   "displayName": "Loopstack Ai Module",
   "description": "A collection of useful tools for performing AI actions using model provider APIs such as OpenAI and Anthropic",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "author": {
     "name": "Jakob Klippel",
     "url": "https://www.linkedin.com/in/jakob-klippel/"