@loopstack/llm-provider-module 0.2.0

package/dist/types/llm.types.d.ts

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import type { UIContentBlock } from '@loopstack/contracts/types';
+export declare const LlmConfigSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type LlmConfig = z.infer<typeof LlmConfigSchema>;
+export declare const LlmContentBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"thinking">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    id: z.ZodString;
+    name: z.ZodString;
+    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"server_tool_use">;
+    id: z.ZodString;
+    name: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"server_tool_result">;
+    toolUseId: z.ZodString;
+    content: z.ZodUnknown;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    toolCallId: z.ZodString;
+    content: z.ZodString;
+    isError: z.ZodBoolean;
+}, z.core.$strip>], "type">;
+export type LlmContentBlock = UIContentBlock;
+export declare const LlmNormalizedMessageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+    }>;
+    content: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"thinking">;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_call">;
+        id: z.ZodString;
+        name: z.ZodString;
+        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"server_tool_use">;
+        id: z.ZodString;
+        name: z.ZodString;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"server_tool_result">;
+        toolUseId: z.ZodString;
+        content: z.ZodUnknown;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tool_result">;
+        toolCallId: z.ZodString;
+        content: z.ZodString;
+        isError: z.ZodBoolean;
+    }, z.core.$strip>], "type">>]>;
+    id: z.ZodOptional<z.ZodString>;
+    stopReason: z.ZodOptional<z.ZodEnum<{
+        end_turn: "end_turn";
+        tool_use: "tool_use";
+        max_tokens: "max_tokens";
+        stop_sequence: "stop_sequence";
+    }>>;
+}, z.core.$strip>;
+export type LlmNormalizedMessage = z.infer<typeof LlmNormalizedMessageSchema>;
+export type LlmStopReason = NonNullable<LlmNormalizedMessage['stopReason']>;
+export interface LlmToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+export interface LlmMessage {
+    role: 'user' | 'assistant';
+    content: string | unknown[];
+}
+export interface LlmGenerateTextArgs<TProviderConfig = Record<string, unknown>> {
+    system?: string;
+    messages?: LlmMessage[];
+    prompt?: string;
+    messagesSearchTag?: string;
+    tools?: string[];
+    model?: string;
+    providerConfig?: TProviderConfig;
+}
+export interface LlmUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+    reasoningTokens?: number;
+}
+export type LlmResultMeta = {
+    provider: string;
+    model: string;
+    usage?: LlmUsage;
+};
+export interface LlmGenerateTextResult {
+    message: LlmNormalizedMessage;
+    response: unknown;
+}
+export interface LlmGenerateObjectArgs<TProviderConfig = Record<string, unknown>> {
+    system?: string;
+    messages?: LlmMessage[];
+    prompt?: string;
+    messagesSearchTag?: string;
+    model?: string;
+    providerConfig?: TProviderConfig;
+    outputSchema: Record<string, unknown>;
+}
+export interface LlmGenerateObjectResult {
+    data: unknown;
+    response: unknown;
+}
+export interface LlmToolResultEntry {
+    type: 'tool_result';
+    toolCallId: string;
+    content?: string;
+    isError?: boolean;
+}
+export interface LlmToolErrorEntry {
+    toolName: string;
+    toolCallId: string;
+    message: string;
+}
+export interface LlmDelegateResult {
+    allCompleted: boolean;
+    toolResults: LlmToolResultEntry[];
+    pendingCount: number;
+    errorCount: number;
+    hasErrors: boolean;
+    errors: LlmToolErrorEntry[];
+}
+export interface LlmToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface LlmServerToolDefinition {
+    name: string;
+    config: unknown;
+}
+export type LlmResolvedTool = ({
+    type: 'tool';
+} & LlmToolDefinition) | ({
+    type: 'server_tool';
+} & LlmServerToolDefinition);
+//# sourceMappingURL=llm.types.d.ts.map

package/dist/types/llm.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.d.ts","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAMjE,eAAO,MAAM,eAAe;;iBAE1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;2BAAuB,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAE7C,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC;AAM5E,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAMD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC;CAC7B;AAMD,MAAM,WAAW,mBAAmB,CAAC,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,cAAc,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAGD,MAAM,MAAM,aAAa,GAAG;IAE1B,QAAQ,EAAE,MAAM,CAAC;IAEjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,oBAAoB,CAAC;IAE9B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD,MAAM,WAAW,qBAAqB,CAAC,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,eAAe,CAAC;IAEjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,uBAAuB;IAEtC,IAAI,EAAE,OAAO,CAAC;IAEd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAMD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GACvB,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,iBAAiB,CAAC,GACtC,CAAC;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG,uBAAuB,CAAC,CAAC"}

package/dist/types/llm.types.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmNormalizedMessageSchema = exports.LlmContentBlockSchema = exports.LlmConfigSchema = void 0;
+const zod_1 = require("zod");
+const types_1 = require("@loopstack/contracts/types");
+exports.LlmConfigSchema = zod_1.z.object({
+    model: zod_1.z.string().optional(),
+});
+exports.LlmContentBlockSchema = types_1.UIContentBlockSchema;
+exports.LlmNormalizedMessageSchema = types_1.UIMessageSchema.extend({
+    id: zod_1.z.string().optional(),
+    stopReason: zod_1.z.enum(['end_turn', 'tool_use', 'max_tokens', 'stop_sequence']).optional(),
+});
+//# sourceMappingURL=llm.types.js.map

package/dist/types/llm.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.js","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,sDAAmF;AAOtE,QAAA,eAAe,GAAG,OAAC,CAAC,MAAM,CAAC;IACtC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAQU,QAAA,qBAAqB,GAAG,4BAAoB,CAAC;AAG7C,QAAA,0BAA0B,GAAG,uBAAe,CAAC,MAAM,CAAC;IAC/D,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE;CACvF,CAAC,CAAC"}

package/dist/utils/extract-text.util.d.ts

@@ -0,0 +1,3 @@
+import type { LlmGenerateTextResult } from '../types';
+export declare function extractText(result: LlmGenerateTextResult): string;
+//# sourceMappingURL=extract-text.util.d.ts.map

package/dist/utils/extract-text.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-text.util.d.ts","sourceRoot":"","sources":["../../src/utils/extract-text.util.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEvE,wBAAgB,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAOjE"}

package/dist/utils/extract-text.util.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractText = extractText;
+function extractText(result) {
+    const content = result.message.content;
+    if (!content || typeof content === 'string')
+        return content ?? '';
+    return content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('\n');
+}
+//# sourceMappingURL=extract-text.util.js.map

package/dist/utils/extract-text.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-text.util.js","sourceRoot":"","sources":["../../src/utils/extract-text.util.ts"],"names":[],"mappings":";;AAEA,kCAOC;AAPD,SAAgB,WAAW,CAAC,MAA6B;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAQ,OAAkB,IAAI,EAAE,CAAC;IAC9E,OAAQ,OAA6B;SAClC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SACxC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAE,KAAwC,CAAC,IAAI,CAAC;SAC9D,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './extract-text.util';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./extract-text.util"), exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@loopstack/llm-provider-module",
+  "displayName": "Loopstack LLM Provider Module",
+  "description": "Shared LLM provider contracts, registry, and helper services for the Loopstack automation framework. Provider modules (Claude, OpenAI, etc.) implement the LlmProviderInterface and register themselves at module init.",
+  "keywords": [
+    "llm",
+    "loopstack",
+    "module",
+    "provider"
+  ],
+  "version": "0.2.0",
+  "license": "MIT",
+  "author": {
+    "name": "Jakob Klippel",
+    "url": "https://www.linkedin.com/in/jakob-klippel/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "nest build",
+    "compile": "tsc --noEmit",
+    "format": "prettier --write .",
+    "lint": "eslint .",
+    "test": "jest --passWithNoTests",
+    "watch": "nest build --watch"
+  },
+  "dependencies": {
+    "@loopstack/contracts": "^0.29.0",
+    "@loopstack/common": "^0.29.0",
+    "@loopstack/core": "^0.29.0",
+    "zod": "^4.3.6"
+  },
+  "files": [
+    "dist"
+  ],
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.ts$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node",
+    "maxWorkers": 1
+  },
+  "loopstack": {
+    "modules": [
+      {
+        "path": "src/llm-provider.module.ts",
+        "className": "LlmProviderModule"
+      }
+    ],
+    "installModes": [
+      "install"
+    ]
+  }
+}