pocket-agent 0.1.0

package/dist/adapters/models/lmstudio.js

@@ -0,0 +1,59 @@
+/**
+ * LM Studio model adapter. Supports OpenAI-compatible API and optional native
+ * streaming (POST /api/v1/chat with stream: true) to separate reasoning from message.
+ */
+import { createOpenAIModelAdapter } from "./openai.js";
+import { lmStudioStreamingChat, getLMStudioBaseUrl } from "./lmStudioStreaming.js";
+const defaultBaseURL = "http://localhost:1234/v1";
+const defaultModel = "local";
+const defaultConfig = () => ({
+    baseURL: process.env.OPENAI_BASE_URL ?? process.env.OPENAI_API_URL ?? defaultBaseURL,
+    model: process.env.OPENAI_MODEL ?? process.env.MODEL ?? defaultModel,
+    maxTokens: process.env.OPENAI_MAX_TOKENS
+        ? parseInt(process.env.OPENAI_MAX_TOKENS, 10)
+        : 4096,
+    useNativeStreaming: process.env.USE_LM_STUDIO_STREAMING === "1" ||
+        process.env.USE_LM_STUDIO_STREAMING === "true",
+    apiKey: process.env.OPENAI_API_KEY ?? "local",
+});
+/**
+ * Creates a ModelAdapter for LM Studio. When useNativeStreaming is true, generate()
+ * uses LM Studio's native streaming API (reasoning and message separated).
+ * Otherwise uses the OpenAI-compatible endpoint. Install the `openai` package for non-streaming.
+ */
+export function createLmStudioModelAdapter(config = {}) {
+    const opts = { ...defaultConfig(), ...config };
+    const useStreaming = opts.useNativeStreaming === true;
+    const baseUrl = opts.baseURL ?? defaultBaseURL;
+    const lmBase = getLMStudioBaseUrl(baseUrl);
+    if (useStreaming && lmBase) {
+        return {
+            async generate(input) {
+                const prompt = typeof input.prompt === "string"
+                    ? input.prompt
+                    : Array.isArray(input.messages) && input.messages.length
+                        ? input.messages
+                            .map((m) => `${m.role}: ${m.content}`)
+                            .join("\n")
+                        : "";
+                const maxTokens = Number.isFinite(opts.maxTokens) && opts.maxTokens > 0 ? opts.maxTokens : 4096;
+                const result = await lmStudioStreamingChat({
+                    baseUrl: lmBase,
+                    model: opts.model ?? defaultModel,
+                    userMessage: prompt,
+                    maxOutputTokens: maxTokens,
+                    apiKey: opts.apiKey,
+                });
+                return { content: result.content, raw: { reasoning: result.reasoning } };
+            },
+        };
+    }
+    const openaiConfig = {
+        apiKey: opts.apiKey ?? "local",
+        baseURL: baseUrl,
+        model: opts.model ?? defaultModel,
+        maxTokens: opts.maxTokens,
+    };
+    return createOpenAIModelAdapter(openaiConfig);
+}
+//# sourceMappingURL=lmstudio.js.map

package/dist/adapters/models/lmstudio.js.map

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

package/dist/adapters/models/ollama.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Ollama model adapter. Uses OpenAI-compatible API at http://localhost:11434/v1 by default.
+ * Optional native streaming (POST /api/chat with stream: true) for content + thinking.
+ * No API key required for local Ollama.
+ * @see https://docs.ollama.com/capabilities/streaming
+ */
+import type { ModelAdapter } from "../../types/models.js";
+export interface OllamaModelConfig {
+    baseURL?: string;
+    model?: string;
+    maxTokens?: number;
+    /** Use native Ollama /api/chat streaming (content + thinking). Default from OLLAMA_USE_STREAMING env. */
+    useNativeStreaming?: boolean;
+}
+/**
+ * Creates a ModelAdapter for Ollama. When useNativeStreaming is true, generate() uses
+ * native /api/chat streaming (content and optional thinking). Otherwise uses the
+ * OpenAI-compatible endpoint. Uses OPENAI_BASE_URL (default http://localhost:11434/v1),
+ * OPENAI_MODEL (default llama3). Install the `openai` package for non-streaming.
+ */
+export declare function createOllamaModelAdapter(config?: OllamaModelConfig): ModelAdapter;
+//# sourceMappingURL=ollama.d.ts.map

package/dist/adapters/models/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../../../src/adapters/models/ollama.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yGAAyG;IACzG,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAgBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,iBAAsB,GAAG,YAAY,CAqCrF"}

package/dist/adapters/models/ollama.js

@@ -0,0 +1,61 @@
+/**
+ * Ollama model adapter. Uses OpenAI-compatible API at http://localhost:11434/v1 by default.
+ * Optional native streaming (POST /api/chat with stream: true) for content + thinking.
+ * No API key required for local Ollama.
+ * @see https://docs.ollama.com/capabilities/streaming
+ */
+import { createOpenAIModelAdapter } from "./openai.js";
+import { ollamaStreamingChat, getOllamaBaseUrl } from "./ollamaStreaming.js";
+const defaultBaseURL = "http://localhost:11434/v1";
+const defaultModel = "llama3";
+const defaultConfig = () => ({
+    apiKey: "local",
+    baseURL: process.env.OPENAI_BASE_URL ?? process.env.OPENAI_API_URL ?? defaultBaseURL,
+    model: process.env.OPENAI_MODEL ?? process.env.MODEL ?? defaultModel,
+    maxTokens: process.env.OPENAI_MAX_TOKENS
+        ? parseInt(process.env.OPENAI_MAX_TOKENS, 10)
+        : 4096,
+    useNativeStreaming: process.env.OLLAMA_USE_STREAMING === "1" || process.env.OLLAMA_USE_STREAMING === "true",
+});
+/**
+ * Creates a ModelAdapter for Ollama. When useNativeStreaming is true, generate() uses
+ * native /api/chat streaming (content and optional thinking). Otherwise uses the
+ * OpenAI-compatible endpoint. Uses OPENAI_BASE_URL (default http://localhost:11434/v1),
+ * OPENAI_MODEL (default llama3). Install the `openai` package for non-streaming.
+ */
+export function createOllamaModelAdapter(config = {}) {
+    const opts = { ...defaultConfig(), ...config };
+    const useStreaming = opts.useNativeStreaming === true;
+    const baseURL = opts.baseURL ?? defaultBaseURL;
+    const ollamaBase = getOllamaBaseUrl(baseURL);
+    if (useStreaming) {
+        return {
+            async generate(input) {
+                const message = typeof input.prompt === "string"
+                    ? input.prompt
+                    : Array.isArray(input.messages) && input.messages.length
+                        ? input.messages
+                            .map((m) => `${m.role}: ${m.content}`)
+                            .join("\n")
+                        : "";
+                const result = await ollamaStreamingChat({
+                    baseUrl: ollamaBase,
+                    model: opts.model ?? defaultModel,
+                    message,
+                });
+                return {
+                    content: result.content,
+                    raw: result.reasoning != null ? { reasoning: result.reasoning } : undefined,
+                };
+            },
+        };
+    }
+    const openaiOpts = {
+        apiKey: "local",
+        baseURL,
+        model: opts.model ?? defaultModel,
+        maxTokens: opts.maxTokens,
+    };
+    return createOpenAIModelAdapter(openaiOpts);
+}
+//# sourceMappingURL=ollama.js.map

package/dist/adapters/models/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../../src/adapters/models/ollama.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAU7E,MAAM,cAAc,GAAG,2BAA2B,CAAC;AACnD,MAAM,YAAY,GAAG,QAAQ,CAAC;AAE9B,MAAM,aAAa,GAAG,GAAyD,EAAE,CAAC,CAAC;IACjF,MAAM,EAAE,OAAO;IACf,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,cAAc;IACpF,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,YAAY;IACpE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACtC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC7C,CAAC,CAAC,IAAI;IACR,kBAAkB,EAChB,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,MAAM;CAC1F,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAA4B,EAAE;IACrE,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,KAAK,IAAI,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,cAAc,CAAC;IAC/C,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE7C,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO;YACL,KAAK,CAAC,QAAQ,CAAC,KAAyB;gBACtC,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;oBAC9B,CAAC,CAAC,KAAK,CAAC,MAAM;oBACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM;wBACtD,CAAC,CAAE,KAAK,CAAC,QAAgD;6BACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;6BACrC,IAAI,CAAC,IAAI,CAAC;wBACf,CAAC,CAAC,EAAE,CAAC;gBACX,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;oBACvC,OAAO,EAAE,UAAU;oBACnB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,YAAY;oBACjC,OAAO;iBACR,CAAC,CAAC;gBACH,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,GAAG,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS;iBAC5E,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAsB;QACpC,MAAM,EAAE,OAAO;QACf,OAAO;QACP,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,YAAY;QACjC,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC;IACF,OAAO,wBAAwB,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC"}

package/dist/adapters/models/ollamaStreaming.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ollama native streaming: POST /api/chat with stream: true (default).
+ * Accumulates content and optional thinking from NDJSON chunks.
+ * @see https://docs.ollama.com/capabilities/streaming
+ * @see https://docs.ollama.com/api/chat
+ */
+export interface OllamaStreamingOptions {
+    /** Base URL of Ollama server (e.g. http://localhost:11434), without /v1 or /api. */
+    baseUrl: string;
+    model: string;
+    /** User message content. */
+    message: string;
+    /** Optional system prompt. */
+    system?: string;
+}
+export interface OllamaStreamingResult {
+    content: string;
+    /** Present for thinking-capable models; reasoning trace. */
+    reasoning?: string;
+}
+/**
+ * Returns the Ollama server base URL (no /v1). Use this when calling native /api/chat.
+ */
+export declare function getOllamaBaseUrl(openAIBaseUrl: string | undefined): string;
+/**
+ * Call Ollama /api/chat with stream: true; accumulate content and optional thinking from chunks.
+ * Response is application/x-ndjson: each line is a JSON object with message.content, message.thinking?, done.
+ */
+export declare function ollamaStreamingChat(options: OllamaStreamingOptions): Promise<OllamaStreamingResult>;
+//# sourceMappingURL=ollamaStreaming.d.ts.map

package/dist/adapters/models/ollamaStreaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollamaStreaming.d.ts","sourceRoot":"","sources":["../../../src/adapters/models/ollamaStreaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI1E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAyEhC"}

package/dist/adapters/models/ollamaStreaming.js

@@ -0,0 +1,88 @@
+/**
+ * Ollama native streaming: POST /api/chat with stream: true (default).
+ * Accumulates content and optional thinking from NDJSON chunks.
+ * @see https://docs.ollama.com/capabilities/streaming
+ * @see https://docs.ollama.com/api/chat
+ */
+/**
+ * Returns the Ollama server base URL (no /v1). Use this when calling native /api/chat.
+ */
+export function getOllamaBaseUrl(openAIBaseUrl) {
+    if (!openAIBaseUrl)
+        return "http://localhost:11434";
+    const u = openAIBaseUrl.replace(/\/v1\/?$/, "").replace(/\/api\/?$/, "").trim();
+    return u || "http://localhost:11434";
+}
+/**
+ * Call Ollama /api/chat with stream: true; accumulate content and optional thinking from chunks.
+ * Response is application/x-ndjson: each line is a JSON object with message.content, message.thinking?, done.
+ */
+export async function ollamaStreamingChat(options) {
+    const { baseUrl, model, message, system } = options;
+    const url = `${baseUrl.replace(/\/$/, "")}/api/chat`;
+    const body = {
+        model,
+        messages: [{ role: "user", content: message }],
+        stream: true,
+    };
+    if (system != null && system !== "") {
+        body.messages = [
+            { role: "system", content: system },
+            { role: "user", content: message },
+        ];
+    }
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok || !res.body) {
+        throw new Error(`Ollama chat failed: ${res.status} ${res.statusText}`);
+    }
+    const contentChunks = [];
+    const thinkingChunks = [];
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for await (const chunk of res.body) {
+        buffer += decoder.decode(chunk, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const data = JSON.parse(trimmed);
+                const msg = data.message;
+                if (msg?.thinking != null && typeof msg.thinking === "string") {
+                    thinkingChunks.push(msg.thinking);
+                }
+                if (msg?.content != null && typeof msg.content === "string") {
+                    contentChunks.push(msg.content);
+                }
+            }
+            catch {
+                // skip malformed line
+            }
+        }
+    }
+    if (buffer.trim()) {
+        try {
+            const data = JSON.parse(buffer.trim());
+            const msg = data.message;
+            if (msg?.thinking != null && typeof msg.thinking === "string") {
+                thinkingChunks.push(msg.thinking);
+            }
+            if (msg?.content != null && typeof msg.content === "string") {
+                contentChunks.push(msg.content);
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    const content = contentChunks.join("").trim();
+    const reasoning = thinkingChunks.length > 0 ? thinkingChunks.join("") : undefined;
+    return { content, reasoning };
+}
+//# sourceMappingURL=ollamaStreaming.js.map

package/dist/adapters/models/ollamaStreaming.js.map

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

package/dist/adapters/models/openai.d.ts

@@ -0,0 +1,17 @@
+/**
+ * OpenAI (and OpenAI-compatible) model adapter. Uses OPENAI_API_KEY, OPENAI_BASE_URL,
+ * OPENAI_MODEL, OPENAI_MAX_TOKENS from env when not provided.
+ */
+import type { ModelAdapter } from "../../types/models.js";
+export interface OpenAIModelConfig {
+    apiKey?: string;
+    baseURL?: string;
+    model?: string;
+    maxTokens?: number;
+}
+/**
+ * Creates a ModelAdapter for OpenAI or any OpenAI-compatible API (Ollama, LM Studio, etc.).
+ * Install the `openai` package: npm install openai
+ */
+export declare function createOpenAIModelAdapter(config?: OpenAIModelConfig): ModelAdapter;
+//# sourceMappingURL=openai.d.ts.map

package/dist/adapters/models/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/adapters/models/openai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,iBAAsB,GAAG,YAAY,CAsCrF"}

package/dist/adapters/models/openai.js

@@ -0,0 +1,50 @@
+/**
+ * OpenAI (and OpenAI-compatible) model adapter. Uses OPENAI_API_KEY, OPENAI_BASE_URL,
+ * OPENAI_MODEL, OPENAI_MAX_TOKENS from env when not provided.
+ */
+const defaultConfig = () => ({
+    apiKey: process.env.OPENAI_API_KEY,
+    baseURL: process.env.OPENAI_BASE_URL ?? process.env.OPENAI_API_URL,
+    model: process.env.OPENAI_MODEL ?? process.env.MODEL ?? "gpt-4o-mini",
+    maxTokens: process.env.OPENAI_MAX_TOKENS
+        ? parseInt(process.env.OPENAI_MAX_TOKENS, 10)
+        : 4096,
+});
+/**
+ * Creates a ModelAdapter for OpenAI or any OpenAI-compatible API (Ollama, LM Studio, etc.).
+ * Install the `openai` package: npm install openai
+ */
+export function createOpenAIModelAdapter(config = {}) {
+    const opts = { ...defaultConfig(), ...config };
+    const apiKey = opts.apiKey ?? (opts.baseURL ? "local" : undefined);
+    if (!apiKey && !opts.baseURL) {
+        throw new Error("OpenAI adapter requires OPENAI_API_KEY (or baseURL for local endpoints). Set OPENAI_API_KEY in env or pass apiKey in config.");
+    }
+    return {
+        async generate(input) {
+            const openai = await import("openai").catch(() => {
+                throw new Error("OpenAI adapter requires the 'openai' package. Install it: npm install openai");
+            });
+            const client = new openai.default({
+                apiKey: apiKey ?? "local",
+                baseURL: opts.baseURL,
+            });
+            const prompt = typeof input.prompt === "string"
+                ? input.prompt
+                : Array.isArray(input.messages) && input.messages.length
+                    ? input.messages
+                        .map((m) => `${m.role}: ${m.content}`)
+                        .join("\n")
+                    : "";
+            const maxTokens = Number.isFinite(opts.maxTokens) && opts.maxTokens > 0 ? opts.maxTokens : 4096;
+            const completion = await client.chat.completions.create({
+                model: opts.model ?? "gpt-4o-mini",
+                messages: [{ role: "user", content: prompt }],
+                max_tokens: maxTokens,
+            });
+            const content = completion.choices[0]?.message?.content ?? "";
+            return { content, raw: completion };
+        },
+    };
+}
+//# sourceMappingURL=openai.js.map

package/dist/adapters/models/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../src/adapters/models/openai.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,aAAa,GAAG,GAAsB,EAAE,CAAC,CAAC;IAC9C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;IAClC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc;IAClE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,aAAa;IACrE,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;QACtC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC;QAC7C,CAAC,CAAC,IAAI;CACT,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAA4B,EAAE;IACrE,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,8HAA8H,CAC/H,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC/C,MAAM,IAAI,KAAK,CACb,8EAA8E,CAC/E,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC;gBAChC,MAAM,EAAE,MAAM,IAAI,OAAO;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAC;YACH,MAAM,MAAM,GACV,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAC9B,CAAC,CAAC,KAAK,CAAC,MAAM;gBACd,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM;oBACtD,CAAC,CAAE,KAAK,CAAC,QAAgD;yBACpD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;yBACrC,IAAI,CAAC,IAAI,CAAC;oBACf,CAAC,CAAC,EAAE,CAAC;YACX,MAAM,SAAS,GACb,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAU,CAAC,CAAC,CAAC,IAAI,CAAC;YAClF,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;gBACtD,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,aAAa;gBAClC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC7C,UAAU,EAAE,SAAS;aACtB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;YAC9D,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/defaults/defaultExecutor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Default executor that runs each step by calling the model with the step objective
+ * and resolved inputs. No tool-calling; use for transform-only plans (e.g. quick start).
+ */
+import type { StepExecutor } from "../executor/StepExecutor.js";
+import type { ModelAdapter } from "../types/models.js";
+export interface DefaultExecutorOptions {
+    /** Model used to generate step output. Required. */
+    model: ModelAdapter;
+    /** Optional instruction appended to every prompt (e.g. "Respond concisely."). */
+    systemPrompt?: string;
+}
+/**
+ * Creates an executor that runs each step by prompting the model with the step's
+ * objective and resolved inputs, then mapping the model output to the step's first
+ * output key. No tools; use for simple transform steps. For tool-calling steps,
+ * use a custom executor or see the run-with-openai example.
+ */
+export declare function createDefaultExecutor(options: DefaultExecutorOptions): StepExecutor;
+//# sourceMappingURL=defaultExecutor.d.ts.map

package/dist/defaults/defaultExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultExecutor.d.ts","sourceRoot":"","sources":["../../src/defaults/defaultExecutor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,KAAK,EAAE,YAAY,CAAC;IACpB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,YAAY,CAsDnF"}

package/dist/defaults/defaultExecutor.js

@@ -0,0 +1,67 @@
+/**
+ * Default executor that runs each step by calling the model with the step objective
+ * and resolved inputs. No tool-calling; use for transform-only plans (e.g. quick start).
+ */
+import { nowISO } from "../utils/time.js";
+/**
+ * Creates an executor that runs each step by prompting the model with the step's
+ * objective and resolved inputs, then mapping the model output to the step's first
+ * output key. No tools; use for simple transform steps. For tool-calling steps,
+ * use a custom executor or see the run-with-openai example.
+ */
+export function createDefaultExecutor(options) {
+    const { model, systemPrompt } = options;
+    return {
+        async execute(input) {
+            const startedAt = nowISO();
+            const outKey = input.step.outputs?.[0] ?? "output";
+            if (!model) {
+                const completedAt = nowISO();
+                return {
+                    stepId: input.step.id,
+                    attempt: input.attempt,
+                    status: "error",
+                    error: { code: "NO_MODEL", message: "No model adapter provided." },
+                    startedAt,
+                    completedAt,
+                    durationMs: 0,
+                };
+            }
+            try {
+                const contextStr = JSON.stringify(input.resolvedInputs, null, 2);
+                const prompt = (systemPrompt ? systemPrompt + "\n\n" : "") +
+                    `Step: ${input.step.name}\nObjective: ${input.step.objective}\n\nContext from previous steps and run:\n${contextStr}\n\nProduce a single result for the output "${outKey}". Write only the answer content, no preamble.`;
+                const out = await model.generate({ prompt });
+                const content = (out.content ?? "").trim();
+                const completedAt = nowISO();
+                const durationMs = new Date(completedAt).getTime() - new Date(startedAt).getTime();
+                return {
+                    stepId: input.step.id,
+                    attempt: input.attempt,
+                    status: "success",
+                    structuredOutput: { [outKey]: content },
+                    rawOutput: content,
+                    startedAt,
+                    completedAt,
+                    durationMs,
+                };
+            }
+            catch (err) {
+                const completedAt = nowISO();
+                return {
+                    stepId: input.step.id,
+                    attempt: input.attempt,
+                    status: "error",
+                    error: {
+                        code: "EXEC_ERROR",
+                        message: err instanceof Error ? err.message : String(err),
+                    },
+                    startedAt,
+                    completedAt,
+                    durationMs: new Date(completedAt).getTime() - new Date(startedAt).getTime(),
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=defaultExecutor.js.map

package/dist/defaults/defaultExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultExecutor.js","sourceRoot":"","sources":["../../src/defaults/defaultExecutor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAS1C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IACxC,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,KAAyB;YACrC,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;YACnD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC;gBAC7B,OAAO;oBACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;oBACrB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,4BAA4B,EAAE;oBAClE,SAAS;oBACT,WAAW;oBACX,UAAU,EAAE,CAAC;iBACd,CAAC;YACJ,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACjE,MAAM,MAAM,GACV,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3C,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,gBAAgB,KAAK,CAAC,IAAI,CAAC,SAAS,6CAA6C,UAAU,+CAA+C,MAAM,gDAAgD,CAAC;gBAC3N,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC7C,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC3C,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC;gBAC7B,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;gBACnF,OAAO;oBACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;oBACrB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM,EAAE,SAAS;oBACjB,gBAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE;oBACvC,SAAS,EAAE,OAAO;oBAClB,SAAS;oBACT,WAAW;oBACX,UAAU;iBACX,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC;gBAC7B,OAAO;oBACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;oBACrB,OAAO,EAAE,KAAK,CAAC,OAAO;oBACtB,MAAM,EAAE,OAAO;oBACf,KAAK,EAAE;wBACL,IAAI,EAAE,YAAY;wBAClB,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;qBAC1D;oBACD,SAAS;oBACT,WAAW;oBACX,UAAU,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;iBAC5E,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/defaults/llmPlanner.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Planner that uses an LLM to generate steps from the goal and context.
+ * Lets you run goal-only (no predefined steps); the model defines the plan.
+ */
+import type { Planner } from "../planner/Planner.js";
+import type { ModelAdapter } from "../types/models.js";
+export interface LLMPlannerOptions {
+    /** If true, prompt asks for transform-only steps (no tools). Default true. */
+    transformOnly?: boolean;
+    /** Max steps to allow. Default 10. */
+    maxSteps?: number;
+    /** System hint for the plan (e.g. "Keep plans to 2–3 steps."). */
+    planHint?: string;
+}
+/**
+ * Creates a planner that calls the model to generate a plan from the goal and context.
+ * Use for goal-only runs: no steps defined upfront; the LLM proposes the steps.
+ */
+export declare function createLLMPlanner(model: ModelAdapter, options?: LLMPlannerOptions): Planner;
+//# sourceMappingURL=llmPlanner.d.ts.map

package/dist/defaults/llmPlanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmPlanner.d.ts","sourceRoot":"","sources":["../../src/defaults/llmPlanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AA2DvD,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA8CD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CA2DT"}

package/dist/defaults/llmPlanner.js

@@ -0,0 +1,151 @@
+/**
+ * Planner that uses an LLM to generate steps from the goal and context.
+ * Lets you run goal-only (no predefined steps); the model defines the plan.
+ */
+import { buildPlan } from "./planBuilder.js";
+const DEFAULT_RETRY = { maxAttempts: 2, strategy: "retry_with_feedback" };
+function parseStepsFromContent(content) {
+    const trimmed = content.trim();
+    const block = trimmed.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const jsonStr = block ? block[1].trim() : trimmed;
+    let data;
+    try {
+        data = JSON.parse(jsonStr);
+    }
+    catch {
+        return [];
+    }
+    const steps = data.steps;
+    if (!Array.isArray(steps) || steps.length === 0)
+        return [];
+    return steps;
+}
+function specToStepDefinition(spec, index) {
+    const id = (spec.id ?? `step_${index}`).replace(/\s+/g, "_").slice(0, 80);
+    const name = spec.name ?? id;
+    const objective = spec.objective ?? "Complete this step.";
+    const outputs = Array.isArray(spec.outputs) && spec.outputs.length > 0 ? spec.outputs : ["output"];
+    const dependencies = Array.isArray(spec.dependencies) ? spec.dependencies : [];
+    const inputs = [];
+    for (const key of spec.inputsFromContext ?? []) {
+        inputs.push({ source: "runContext", key });
+    }
+    for (const { stepId, key } of spec.inputsFromStep ?? []) {
+        if (stepId && key)
+            inputs.push({ source: "stepOutput", stepId, key });
+    }
+    return {
+        id,
+        name,
+        type: "transform",
+        objective,
+        dependencies,
+        allowedTools: [],
+        inputs,
+        outputs,
+        completionCriteria: outputs.map((k) => `Output "${k}" is produced.`),
+        retryPolicy: DEFAULT_RETRY,
+    };
+}
+const DEFAULT_OPTIONS = {
+    transformOnly: true,
+    maxSteps: 10,
+    planHint: undefined,
+};
+function buildPlanPrompt(input, options) {
+    const { goal, context, constraints } = input;
+    const hint = options.planHint ?? "Use 1–4 steps. Each step should have a clear objective and output key(s).";
+    const toolList = input.availableTools.length > 0
+        ? `Available tools (use only if needed): ${input.availableTools.map((t) => t.name).join(", ")}.`
+        : "No tools are available; use only reasoning/transform steps.";
+    const constraintStr = constraints.length > 0 ? `Constraints: ${constraints.join("; ")}` : "";
+    return `You are a planning assistant. Given a goal and context, output a plan as a single JSON object.
+
+Goal: ${goal}
+
+Context (key-value): ${JSON.stringify(context)}
+
+${constraintStr ? constraintStr + "\n\n" : ""}${toolList}
+
+${hint}
+
+Respond with ONLY a JSON object in this exact shape (no markdown, no explanation):
+\`\`\`json
+{
+  "steps": [
+    {
+      "id": "unique_snake_case_id",
+      "name": "Human-readable step name",
+      "objective": "What this step must do",
+      "outputs": ["output_key"],
+      "dependencies": [],
+      "inputsFromContext": ["goal"],
+      "inputsFromStep": []
+    }
+  ]
+}
+\`\`\`
+
+Rules: Step ids must be unique. Later steps can list earlier step ids in "dependencies" and reference their outputs in "inputsFromStep" as { "stepId": "id", "key": "output_key" }. Use "inputsFromContext" for keys from the run context (e.g. "goal"). Output only the JSON block.`;
+}
+/**
+ * Creates a planner that calls the model to generate a plan from the goal and context.
+ * Use for goal-only runs: no steps defined upfront; the LLM proposes the steps.
+ */
+export function createLLMPlanner(model, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    return {
+        async createPlan(input) {
+            const prompt = buildPlanPrompt(input, opts);
+            const out = await model.generate({ prompt });
+            const content = (out.content ?? "").trim();
+            const specs = parseStepsFromContent(content);
+            const steps = specs
+                .slice(0, opts.maxSteps)
+                .map((s, i) => specToStepDefinition(s, i));
+            if (steps.length === 0) {
+                const fallback = {
+                    id: "answer",
+                    name: "Answer",
+                    type: "transform",
+                    objective: input.goal,
+                    dependencies: [],
+                    allowedTools: [],
+                    inputs: [{ source: "runContext", key: "goal" }],
+                    outputs: ["answer"],
+                    completionCriteria: ["Answer is produced."],
+                    retryPolicy: DEFAULT_RETRY,
+                };
+                return buildPlan(input.goal, [fallback]);
+            }
+            return buildPlan(input.goal, steps);
+        },
+        async replan(input) {
+            const prompt = buildPlanPrompt({
+                goal: input.goal,
+                context: input.context,
+                constraints: input.constraints,
+                availableTools: input.availableTools,
+                options: input.options,
+            }, opts) +
+                `\n\nPrevious plan failed at step "${input.failedStepId}". Suggest a revised plan (you may simplify or add recovery steps). Same JSON format.`;
+            const out = await model.generate({ prompt });
+            const content = (out.content ?? "").trim();
+            const specs = parseStepsFromContent(content);
+            const steps = specs
+                .slice(0, opts.maxSteps)
+                .map((s, i) => specToStepDefinition(s, i));
+            if (steps.length === 0) {
+                return {
+                    ...input.currentPlan,
+                    version: input.currentPlan.version + 1,
+                };
+            }
+            return buildPlan(input.goal, steps, {
+                planId: input.currentPlan.id,
+                version: input.currentPlan.version + 1,
+            });
+        },
+    };
+}
+//# sourceMappingURL=llmPlanner.js.map