pocket-agent 0.1.0

package/README.md

@@ -0,0 +1,140 @@
+# pocket-agent
+
+**Plan-driven agent orchestration for Node.** You plug in a planner, executor, and evaluator (e.g. backed by any LLM); the framework runs the loop-plan → steps → evaluate → retry or replan-so you don’t re-implement it.
+
+**Author:** sam_thewise
+
+---
+
+### In a nutshell
+
+- **Goal in → plan → steps → evaluate → done.** You give a goal; we get a machine-readable plan, run steps in dependency order, evaluate completion, and retry or replan as needed.
+- **You bring:** planner, executor, evaluator (and optional tools). **We bring:** scheduling, lifecycle events, retries, and structured outputs.
+- **Pocket** = small, drop-in. **Agent** = orchestration that turns your LLM into a plan-first workflow.
+
+---
+
+### What this does (plain terms)
+
+You give a **goal** (e.g. “Summarize this contract” or “How does this codebase work?”). The library turns that into a **plan**: a ordered list of **steps**, each with a clear objective and inputs/outputs. It runs the steps one by one (or in order when steps depend on each other), uses your **model** (LLM) and optional **tools** to do the work, then asks an **evaluator** whether each step is actually done. If not, it retries or replans; when everything’s done, you get a single result with all the step outputs. You don’t wire the loop yourself-you plug in *how* to plan, *how* to run a step, and *how* to judge completion; the **runner** does the rest.
+
+**Terms you’ll see:**
+
+| Term | Meaning |
+|------|--------|
+| **Runner** | The thing you create with `createAgentRunner` or `createQuickAgent`. It runs the full loop: create plan → run steps → evaluate → retry/replan → return result. |
+| **Plan** | A list of **steps** (each has an id, objective, inputs, outputs, dependencies). The runner executes steps in an order that respects dependencies. |
+| **Planner** | Your code (or a built-in) that, given a goal and context, produces a **plan**. “What steps do we need to achieve this goal?” |
+| **Executor** | Your code (or a built-in) that runs *one* step. It gets the step definition, resolved inputs, and optional **model** and **tools**; it returns the step’s output (or error). “Do this step.” |
+| **Evaluator** | Your code (or a built-in LLM evaluator) that, given a step and its attempt result, says whether the step is **complete**, should **retry**, **replan**, or **failed**. “Is this step actually done?” |
+| **Tools** | Optional functions the executor can call during a step (e.g. read a file, call an API). The plan says which steps are allowed to use which tools. |
+| **Model** | The LLM (OpenAI, Anthropic, Gemini, Ollama, etc.) used by the executor (and often the evaluator). You pass it via a **provider** + API key or a custom adapter. |
+| **Provider** | Shortcut name for a model backend: `"openai"`, `"anthropic"`, `"gemini"`, `"ollama"`, `"lmstudio"`. Setting `provider` lets the library create the model adapter and a default evaluator from env. |
+
+Once these mean something, the rest of the doc (quick start, fluent plan, default evaluators, contracts) should fall into place.
+
+---
+
+## Features
+
+- **Explicit plans** - Machine-readable step list before execution
+- **Dependency-ordered execution** - Steps run when their dependencies are satisfied
+- **Lifecycle events** - `run.started`, `plan.created`, `step.started`, `step.completed`, `run.completed`, etc.
+- **Bounded retries** - Evaluator-driven completion with configurable retry policy
+- **Structured outputs** - Per-step and final run outputs
+
+## Install
+
+```bash
+npm install pocket-agent
+```
+
+## Examples (quick start)
+
+### 1. Super quick start (one call)
+
+Set your API key in the environment, then create and run in two lines. Uses a single-step plan and the LLM to answer; no planner or executor code to write.
+
+```ts
+import { createQuickAgent } from "pocket-agent";
+
+const runner = createQuickAgent({ provider: "openai" });
+const run = await runner.run({ goal: "What is 2+2? Explain in one sentence." });
+
+console.log(run.outputs?.answer);
+```
+
+Supported `provider`: `"openai"` | `"anthropic"` | `"gemini"` | `"ollama"` | `"lmstudio"`. Each reads from env (e.g. `OPENAI_API_KEY`, `OPENAI_MODEL`). Optional `modelConfig` and `systemPrompt`. No tools in this mode; for tools and multi-step plans, see the docs below.
+
+### 2. Goal-only with LLM-generated steps
+
+Give a goal and let the LLM invent the plan (the list of steps). Use `createGoalDrivenAgent` with `useLLMPlanner: true`:
+
+```ts
+import { createGoalDrivenAgent } from "pocket-agent";
+
+const runner = createGoalDrivenAgent({
+  provider: "openai",
+  useLLMPlanner: true,
+  llmPlannerOptions: { maxSteps: 5, planHint: "Use 2–4 clear steps." },
+});
+
+const run = await runner.run({
+  goal: "Explain what an API is in three short steps: definition, why it matters, one example.",
+});
+
+console.log(run.plan.steps);  // steps were generated by the LLM
+console.log(run.outputs);
+```
+
+### 3. Custom planner and executor
+
+When you want your own plan or execution logic, use `createAgentRunner` with a planner, executor, and evaluator (or `provider` for a default evaluator):
+
+```ts
+import { createAgentRunner } from "pocket-agent";
+
+const runner = createAgentRunner({
+  provider: "openai",
+  planner,   // your Planner or use createFixedPlanPlanner(steps)
+  executor,  // your StepExecutor or use createDefaultExecutor({ model })
+  tools: {}, // optional
+});
+
+const run = await runner.run({
+  goal: "Find the latest contract, extract payment terms, and summarize risks.",
+  context: { customerId: "abc123" },
+});
+```
+
+For fluent step definitions and a minimal planner/executor/evaluator, see the docs below.
+
+---
+
+## Documentation
+
+More guides live under **`docs/`** (links work on GitHub):
+
+| Doc | Description |
+|-----|-------------|
+| [Fluent plan and defaults](docs/fluent-plan-and-defaults.md) | Build plans with `step()` + `createFixedPlanPlanner` and run with `createDefaultExecutor`. |
+| [Custom planner and executor](docs/custom-planner-executor.md) | Minimal planner, executor, and evaluator (full code). |
+| [Default evaluators and providers](docs/default-evaluators-and-providers.md) | Provider table, `provider` in `createAgentRunner`, adapters. |
+| [Contracts](docs/contracts.md) | Planner, StepExecutor, StepEvaluator, Tools. |
+| [Events](docs/events.md) | Event-driven usage with `runner.start()`. |
+| [API key and local models](docs/api-key-and-local-models.md) | Cloud (OpenAI), Ollama, LM Studio, tools, project planner. |
+| [Examples](docs/examples.md) | All runnable scripts (`npm run example:*`). |
+
+## Scripts
+
+- `npm run build` - compile TypeScript to `dist/`
+- `npm test` - run tests
+- `npm run test:watch` - run tests in watch mode
+- `npm run example:quick-start` - quick-start example
+- `npm run example:fluent-plan` - fluent plan example
+- `npm run example:goal-driven-llm` - goal-only with LLM-generated steps
+- `npm run example:minimal` - minimal planner/executor/evaluator (no API key)
+- `npm run example:openai` - full run with tools (OpenAI or local)
+- `npm run example:planner` - project structure from a description
+
+See [docs/examples.md](docs/examples.md) for the full list and what each script does.

package/dist/adapters/createLLMEvaluator.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Default LLM-based step evaluator. Uses any ModelAdapter to judge whether a step
+ * attempt satisfies the step's completion criteria.
+ */
+import type { StepEvaluator } from "../evaluator/StepEvaluator.js";
+import type { ModelAdapter } from "../types/models.js";
+export interface LLMEvaluatorOptions {
+    /** If true, ask the model to return JSON in a ```json block. Default true. */
+    useJsonBlock?: boolean;
+    /** Max length of rawOutput to include in the prompt. Default 8000. */
+    maxOutputChars?: number;
+}
+/**
+ * Creates a step evaluator that uses the given model to judge whether a step
+ * attempt satisfies the step's completion criteria. Works with any ModelAdapter
+ * (OpenAI, Anthropic, Gemini, or custom).
+ */
+export declare function createLLMEvaluator(model: ModelAdapter, options?: LLMEvaluatorOptions): StepEvaluator;
+//# sourceMappingURL=createLLMEvaluator.d.ts.map

package/dist/adapters/createLLMEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLLMEvaluator.d.ts","sourceRoot":"","sources":["../../src/adapters/createLLMEvaluator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA+HD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,mBAAwB,GAChC,aAAa,CAuBf"}

package/dist/adapters/createLLMEvaluator.js

@@ -0,0 +1,150 @@
+/**
+ * Default LLM-based step evaluator. Uses any ModelAdapter to judge whether a step
+ * attempt satisfies the step's completion criteria.
+ */
+const DEFAULT_OPTIONS = {
+    useJsonBlock: true,
+    maxOutputChars: 8000,
+};
+function truncate(s, max) {
+    if (s.length <= max)
+        return s;
+    return s.slice(0, max) + "\n...[truncated]";
+}
+function buildPrompt(input, options) {
+    const { step, attemptResult, priorAttempts } = input;
+    const rawStr = attemptResult.rawOutput != null
+        ? typeof attemptResult.rawOutput === "string"
+            ? attemptResult.rawOutput
+            : JSON.stringify(attemptResult.rawOutput, null, 2)
+        : "";
+    const structuredStr = attemptResult.structuredOutput != null
+        ? JSON.stringify(attemptResult.structuredOutput, null, 2)
+        : "(none)";
+    const rawTruncated = truncate(rawStr, options.maxOutputChars);
+    const criteria = (step.completionCriteria ?? []).join("\n- ");
+    const priorSummary = priorAttempts.length > 0
+        ? `\nPrior attempts: ${priorAttempts.length}. Last had status: ${priorAttempts[priorAttempts.length - 1]?.status}.`
+        : "";
+    const jsonInstruction = options.useJsonBlock
+        ? `Respond with a single JSON object in a fenced code block (\\\`\\\`\\\`json ... \\\`\\\`\\\`). The JSON must have:
+- "verdict": one of "complete", "retry", "needs_replan", "failed"
+- "reasons": array of short strings explaining your decision
+- "missingCriteria" (optional): array of criteria not yet satisfied
+- "confidence" (optional): number 0-1
+- "suggestedAction" (optional): string for retry/replan`
+        : `Respond with exactly:
+VERDICT: complete|retry|needs_replan|failed
+REASONS: one or more short lines
+Optional lines: MISSING_CRITERIA: ... CONFIDENCE: 0-1 SUGGESTED_ACTION: ...`;
+    return `You are evaluating whether a step in a plan-driven agent run is complete.
+
+Step:
+- id: ${step.id}
+- name: ${step.name ?? step.id}
+- objective: ${step.objective}
+- expected outputs: ${(step.outputs ?? []).join(", ")}
+
+Completion criteria (all should be satisfied for "complete"):
+- ${criteria || "(none specified)"}
+
+Attempt result:
+- status: ${attemptResult.status}
+- structuredOutput: ${structuredStr}
+- rawOutput (excerpt): ${rawTruncated}${priorSummary}
+
+Is this step complete, should we retry, replan, or mark failed?
+
+${jsonInstruction}`;
+}
+function parseResponse(content, stepId, attempt, useJsonBlock) {
+    const verdicts = ["complete", "retry", "needs_replan", "failed"];
+    let verdict = "complete";
+    let reasons = [];
+    let missingCriteria;
+    let confidence;
+    let suggestedAction;
+    if (useJsonBlock) {
+        const blockMatch = content.match(/```(?:json)?\s*([\s\S]*?)```/);
+        const jsonStr = blockMatch ? blockMatch[1].trim() : content.trim();
+        try {
+            const obj = JSON.parse(jsonStr);
+            const v = obj.verdict;
+            if (typeof v === "string" && verdicts.includes(v)) {
+                verdict = v;
+            }
+            if (Array.isArray(obj.reasons)) {
+                reasons = obj.reasons.filter((r) => typeof r === "string");
+            }
+            else if (typeof obj.reasons === "string") {
+                reasons = [obj.reasons];
+            }
+            if (Array.isArray(obj.missingCriteria)) {
+                missingCriteria = obj.missingCriteria.filter((m) => typeof m === "string");
+            }
+            if (typeof obj.confidence === "number")
+                confidence = obj.confidence;
+            if (typeof obj.suggestedAction === "string")
+                suggestedAction = obj.suggestedAction;
+        }
+        catch {
+            reasons = ["Could not parse model JSON; treating as complete"];
+        }
+    }
+    else {
+        const lineMap = {};
+        for (const line of content.split("\n")) {
+            const [key, ...rest] = line.split(":");
+            const value = rest.join(":").trim();
+            if (key && value)
+                lineMap[key.trim().toUpperCase()] = value;
+        }
+        const v = lineMap["VERDICT"]?.toLowerCase();
+        if (v && verdicts.includes(v))
+            verdict = v;
+        if (lineMap["REASONS"])
+            reasons = [lineMap["REASONS"]];
+        if (lineMap["MISSING_CRITERIA"])
+            missingCriteria = [lineMap["MISSING_CRITERIA"]];
+        if (lineMap["CONFIDENCE"])
+            confidence = parseFloat(lineMap["CONFIDENCE"]);
+        if (lineMap["SUGGESTED_ACTION"])
+            suggestedAction = lineMap["SUGGESTED_ACTION"];
+    }
+    if (reasons.length === 0)
+        reasons = [verdict === "complete" ? "Criteria satisfied" : "See verdict"];
+    return {
+        stepId,
+        attempt,
+        verdict,
+        reasons,
+        missingCriteria,
+        confidence,
+        suggestedAction,
+    };
+}
+/**
+ * Creates a step evaluator that uses the given model to judge whether a step
+ * attempt satisfies the step's completion criteria. Works with any ModelAdapter
+ * (OpenAI, Anthropic, Gemini, or custom).
+ */
+export function createLLMEvaluator(model, options = {}) {
+    const opts = { ...DEFAULT_OPTIONS, ...options };
+    return {
+        async evaluate(input) {
+            const prompt = buildPrompt(input, opts);
+            const out = await model.generate({ prompt });
+            const content = (out.content ?? "").trim();
+            if (!content) {
+                return {
+                    stepId: input.step.id,
+                    attempt: input.attemptResult.attempt,
+                    verdict: "retry",
+                    reasons: ["Model returned no content for evaluation"],
+                };
+            }
+            return parseResponse(content, input.step.id, input.attemptResult.attempt, opts.useJsonBlock);
+        },
+    };
+}
+//# sourceMappingURL=createLLMEvaluator.js.map

package/dist/adapters/createLLMEvaluator.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * Anthropic Claude model adapter. Uses ANTHROPIC_API_KEY, ANTHROPIC_MODEL,
+ * ANTHROPIC_MAX_TOKENS from env when not provided.
+ */
+import type { ModelAdapter } from "../../types/models.js";
+export interface AnthropicModelConfig {
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+}
+/**
+ * Creates a ModelAdapter for Anthropic Claude. Install the SDK: npm install @anthropic-ai/sdk
+ */
+export declare function createAnthropicModelAdapter(config?: AnthropicModelConfig): ModelAdapter;
+//# sourceMappingURL=anthropic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/adapters/models/anthropic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,GAAE,oBAAyB,GAAG,YAAY,CAqC3F"}

package/dist/adapters/models/anthropic.js

@@ -0,0 +1,45 @@
+/**
+ * Anthropic Claude model adapter. Uses ANTHROPIC_API_KEY, ANTHROPIC_MODEL,
+ * ANTHROPIC_MAX_TOKENS from env when not provided.
+ */
+const defaultConfig = () => ({
+    apiKey: process.env.ANTHROPIC_API_KEY,
+    model: process.env.ANTHROPIC_MODEL ?? process.env.MODEL ?? "claude-3-5-sonnet-20241022",
+    maxTokens: process.env.ANTHROPIC_MAX_TOKENS
+        ? parseInt(process.env.ANTHROPIC_MAX_TOKENS, 10)
+        : 4096,
+});
+/**
+ * Creates a ModelAdapter for Anthropic Claude. Install the SDK: npm install @anthropic-ai/sdk
+ */
+export function createAnthropicModelAdapter(config = {}) {
+    const opts = { ...defaultConfig(), ...config };
+    if (!opts.apiKey) {
+        throw new Error("Anthropic adapter requires ANTHROPIC_API_KEY. Set it in env or pass apiKey in config.");
+    }
+    return {
+        async generate(input) {
+            const Anthropic = (await import("@anthropic-ai/sdk").catch(() => {
+                throw new Error("Anthropic adapter requires the '@anthropic-ai/sdk' package. Install it: npm install @anthropic-ai/sdk");
+            })).default;
+            const client = new Anthropic({ apiKey: opts.apiKey });
+            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 message = await client.messages.create({
+                model: opts.model ?? "claude-3-5-sonnet-20241022",
+                max_tokens: maxTokens,
+                messages: [{ role: "user", content: prompt }],
+            });
+            const textBlock = message.content?.find((b) => b.type === "text");
+            const content = textBlock?.text ?? "";
+            return { content, raw: message };
+        },
+    };
+}
+//# sourceMappingURL=anthropic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../src/adapters/models/anthropic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,aAAa,GAAG,GAAyB,EAAE,CAAC,CAAC;IACjD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;IACrC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,4BAA4B;IACvF,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;QACzC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAChD,CAAC,CAAC,IAAI;CACT,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAA+B,EAAE;IAC3E,MAAM,IAAI,GAAG,EAAE,GAAG,aAAa,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,MAAM,SAAS,GAAG,CAAC,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;gBAC9D,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;YACJ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACZ,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACtD,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,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC3C,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,4BAA4B;gBACjD,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;aAC9C,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,CACrC,CAAC,CAAkC,EAAuC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAC/F,CAAC;YACF,MAAM,OAAO,GAAG,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC;YACtC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Google Gemini model adapter. Uses GEMINI_API_KEY (or GOOGLE_GENAI_API_KEY),
+ * GEMINI_MODEL, GEMINI_MAX_TOKENS from env when not provided.
+ * Uses the @google/genai SDK (recommended); falls back to @google/generative-ai if needed.
+ */
+import type { ModelAdapter } from "../../types/models.js";
+export interface GeminiModelConfig {
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+}
+/**
+ * Creates a ModelAdapter for Google Gemini. Install the SDK: npm install @google/genai
+ */
+export declare function createGeminiModelAdapter(config?: GeminiModelConfig): ModelAdapter;
+//# sourceMappingURL=gemini.d.ts.map

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

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

package/dist/adapters/models/gemini.js

@@ -0,0 +1,58 @@
+/**
+ * Google Gemini model adapter. Uses GEMINI_API_KEY (or GOOGLE_GENAI_API_KEY),
+ * GEMINI_MODEL, GEMINI_MAX_TOKENS from env when not provided.
+ * Uses the @google/genai SDK (recommended); falls back to @google/generative-ai if needed.
+ */
+const defaultConfig = () => ({
+    apiKey: process.env.GEMINI_API_KEY ?? process.env.GOOGLE_GENAI_API_KEY ?? process.env.GOOGLE_API_KEY,
+    model: process.env.GEMINI_MODEL ?? process.env.MODEL ?? "gemini-2.0-flash",
+    maxTokens: process.env.GEMINI_MAX_TOKENS
+        ? parseInt(process.env.GEMINI_MAX_TOKENS, 10)
+        : 4096,
+});
+/**
+ * Creates a ModelAdapter for Google Gemini. Install the SDK: npm install @google/genai
+ */
+export function createGeminiModelAdapter(config = {}) {
+    const opts = { ...defaultConfig(), ...config };
+    if (!opts.apiKey) {
+        throw new Error("Gemini adapter requires GEMINI_API_KEY (or GOOGLE_GENAI_API_KEY). Set it in env or pass apiKey in config.");
+    }
+    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;
+            // Prefer @google/genai (new SDK)
+            try {
+                const { GoogleGenAI } = await import("@google/genai");
+                const ai = new GoogleGenAI({ apiKey: opts.apiKey });
+                const res = await ai.models.generateContent({
+                    model: opts.model ?? "gemini-2.0-flash",
+                    contents: prompt,
+                    config: { maxOutputTokens: maxTokens },
+                });
+                const text = res.text ??
+                    res
+                        .candidates?.[0]?.content?.parts?.filter((p) => typeof p.text === "string")
+                        .map((p) => p.text)
+                        .join("") ??
+                    "";
+                return { content: text, raw: res };
+            }
+            catch (e) {
+                const err = e;
+                if (err?.code === "ERR_MODULE_NOT_FOUND" || err?.message?.includes("Cannot find module")) {
+                    throw new Error("Gemini adapter requires the '@google/genai' package. Install it: npm install @google/genai");
+                }
+                throw e;
+            }
+        },
+    };
+}
+//# sourceMappingURL=gemini.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * LM Studio native streaming: POST /api/v1/chat with stream: true.
+ * Separates reasoning from message content. See https://lmstudio.ai/docs/developer/rest/streaming-events
+ */
+export interface LMStudioStreamingOptions {
+    baseUrl: string;
+    model: string;
+    systemPrompt?: string;
+    userMessage: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    apiKey?: string;
+}
+export interface LMStudioStreamingResult {
+    content: string;
+    reasoning?: string;
+}
+export declare function lmStudioStreamingChat(options: LMStudioStreamingOptions): Promise<LMStudioStreamingResult>;
+/** Strip /v1 from base URL for LM Studio native API. */
+export declare function getLMStudioBaseUrl(openAIBaseUrl: string | undefined): string | null;
+//# sourceMappingURL=lmStudioStreaming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lmStudioStreaming.d.ts","sourceRoot":"","sources":["../../../src/adapters/models/lmStudioStreaming.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CA6FlC;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAInF"}

package/dist/adapters/models/lmStudioStreaming.js

@@ -0,0 +1,90 @@
+/**
+ * LM Studio native streaming: POST /api/v1/chat with stream: true.
+ * Separates reasoning from message content. See https://lmstudio.ai/docs/developer/rest/streaming-events
+ */
+export async function lmStudioStreamingChat(options) {
+    const { baseUrl, model, systemPrompt, userMessage, temperature, maxOutputTokens, apiKey, } = options;
+    const url = `${baseUrl.replace(/\/$/, "")}/api/v1/chat`;
+    const body = {
+        model,
+        input: userMessage,
+        stream: true,
+    };
+    if (systemPrompt != null && systemPrompt !== "")
+        body.system_prompt = systemPrompt;
+    if (temperature != null)
+        body.temperature = temperature;
+    if (maxOutputTokens != null && maxOutputTokens > 0)
+        body.max_output_tokens = maxOutputTokens;
+    const headers = { "Content-Type": "application/json" };
+    if (apiKey && apiKey !== "local")
+        headers.Authorization = `Bearer ${apiKey}`;
+    const res = await fetch(url, { method: "POST", headers, body: JSON.stringify(body) });
+    if (!res.ok || !res.body) {
+        throw new Error(`LM Studio chat failed: ${res.status} ${res.statusText}`);
+    }
+    const reasoningChunks = [];
+    const messageChunks = [];
+    let currentEvent = null;
+    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) {
+            if (line.startsWith("event: ")) {
+                currentEvent = line.slice(7).trim();
+                continue;
+            }
+            if (line.startsWith("data: ")) {
+                const dataStr = line.slice(6).trim();
+                if (dataStr === "" || dataStr === "[DONE]") {
+                    currentEvent = null;
+                    continue;
+                }
+                try {
+                    const data = JSON.parse(dataStr);
+                    const eventType = (currentEvent ?? data.type);
+                    if (eventType === "reasoning.delta" && typeof data.content === "string") {
+                        reasoningChunks.push(data.content);
+                    }
+                    if (eventType === "message.delta" && typeof data.content === "string") {
+                        messageChunks.push(data.content);
+                    }
+                    if (eventType === "chat.end") {
+                        const result = (data.result ?? data);
+                        const output = result?.output ?? (Array.isArray(data.output) ? data.output : null);
+                        if (Array.isArray(output)) {
+                            const messages = output
+                                .filter((item) => item?.type === "message" && typeof item.content === "string")
+                                .map((item) => item.content);
+                            if (messages.length > 0) {
+                                messageChunks.length = 0;
+                                messageChunks.push(messages.join("\n"));
+                            }
+                        }
+                    }
+                }
+                catch {
+                    // ignore malformed data line
+                }
+                currentEvent = null;
+            }
+        }
+    }
+    const content = messageChunks.join("").trim();
+    const reasoning = reasoningChunks.length > 0 ? reasoningChunks.join("") : undefined;
+    if (!content && res.ok) {
+        throw new Error("LM Studio stream returned no message content (check event format or use OpenAI-compatible endpoint)");
+    }
+    return { content, reasoning };
+}
+/** Strip /v1 from base URL for LM Studio native API. */
+export function getLMStudioBaseUrl(openAIBaseUrl) {
+    if (!openAIBaseUrl)
+        return null;
+    const u = openAIBaseUrl.replace(/\/v1\/?$/, "");
+    return u || null;
+}
+//# sourceMappingURL=lmStudioStreaming.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * 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 type { ModelAdapter } from "../../types/models.js";
+export interface LmStudioModelConfig {
+    baseURL?: string;
+    model?: string;
+    maxTokens?: number;
+    /** Use LM Studio native streaming for generate() when true. Default from USE_LM_STUDIO_STREAMING env. */
+    useNativeStreaming?: boolean;
+    apiKey?: string;
+}
+/**
+ * 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 declare function createLmStudioModelAdapter(config?: LmStudioModelConfig): ModelAdapter;
+//# sourceMappingURL=lmstudio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lmstudio.d.ts","sourceRoot":"","sources":["../../../src/adapters/models/lmstudio.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAM1D,MAAM,WAAW,mBAAmB;IAClC,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;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,mBAAwB,GAAG,YAAY,CAsCzF"}