llm-agent-runtime 0.1.0 → 0.1.5

package/README.md

@@ -1,5 +1,5 @@
 # llm-agent-runtime
 
-Reusable LangGraph agent runtime (intent routing, sticky flows, checkpointer, tool extractors).
+Reusable LangGraph agent runtime: intent routing, sticky flows, checkpointer, tool outputs.
 
-Usage docs deferred until the package is tested end-to-end.
+**Docs:** [USAGE.md](./USAGE.md)

package/USAGE.md

@@ -0,0 +1,391 @@
+# llm-agent-runtime
+
+Reusable LangGraph agent engine. Your app supplies **intents, prompts, and tools**. The package runs:
+
+`resolveFlow → runAgent → extract tool outputs → finalize`
+
+Same shape as Xel-agent, but flexible for any product.
+
+---
+
+## Install
+
+```bash
+npm install llm-agent-runtime
+# or
+pnpm add llm-agent-runtime
+```
+
+**Peer dependencies** (usually already in a LangChain app):
+
+- `@langchain/core`
+- `@langchain/langgraph`
+- `@langchain/langgraph-checkpoint`
+- `zod`
+
+---
+
+## Quick start
+
+```ts
+import { createAgentRuntime } from "llm-agent-runtime";
+import { tool } from "@langchain/core/tools";
+import { z } from "zod";
+
+const greet = tool(async () => "ok", {
+  name: "noop",
+  description: "No-op",
+  schema: z.object({}),
+});
+
+const runtime = await createAgentRuntime({
+  redisUrl: process.env.REDIS_URL, // omit → in-memory checkpointer
+  // llm omitted → reads process.env (see Env vars below)
+
+  intents: [
+    {
+      name: "greetings",
+      examples: ["hi", "hello", "good morning"],
+      description: "hello or small talk",
+    },
+    {
+      name: "create_campaign",
+      examples: ["create a campaign", "start fundraising"],
+      sticky: true,
+      description: "new campaign wizard",
+    },
+  ],
+
+  intentRegistry: {
+    greetings: {
+      prompt: (ctx) =>
+        `Greet the user. Name: ${ctx.context?.contactName ?? "friend"}.`,
+      tools: () => [greet],
+    },
+    create_campaign: {
+      prompt: () => "Help create a campaign step by step. Call create_campaign when ready.",
+      tools: (phoneKey) => [/* your tools scoped by phoneKey */],
+    },
+  },
+
+  toolOutputMap: {
+    create_campaign: "campaign",
+  },
+});
+
+await runtime.connect();
+
+const result = await runtime.invoke({
+  message: "hi",
+  threadId: "user-123",
+  context: { contactName: "Ada" },
+});
+
+console.log(result.answer, result.intent, result.flow, result.toolOutputs);
+```
+
+---
+
+## What you pass vs what the library does
+
+| You configure | Library handles |
+| --- | --- |
+| `intents` (examples + `sticky`) | Hybrid LLM + embedding router |
+| `intentRegistry` (prompt + tools) | LangGraph agent + Redis/memory checkpointer |
+| `toolOutputMap` | Parse tool calls into structured outputs |
+| `completeOn` | Sticky-flow completion + Redis flow state |
+| `menuMap` (optional) | Digit → intent after a numbered menu |
+| Prompts, API tools, webhooks | — stay in your app |
+
+---
+
+## Config reference
+
+### `createAgentRuntime(config)`
+
+#### Required
+
+```ts
+intents: IntentDefinition[]
+intentRegistry: Record<string, { prompt: (ctx) => string; tools: (phoneKey) => Tool[] }>
+```
+
+#### Common optional
+
+| Option | Default | Purpose |
+| --- | --- | --- |
+| `redisUrl` | none (MemorySaver) | Checkpointer + flow state + optional answer cache |
+| `llm` | `llmConfigFromEnv()` | Provider / models |
+| `cache.enabled` | `false` | Exact-match answer cache (needs Redis) |
+| `toolOutputMap` | raw tool args | Map tool name → output key |
+| `completeOn` | keys of `toolOutputMap` | Tool names that finish a sticky flow |
+| `menuMap` | `{}` | `{ "1": "create_campaign" }` for digit menus |
+| `intentAliases` | `{}` | Legacy name → catalog name |
+| `defaultIntent` | first intent | Fallback intent |
+| `buildSystemPrompt` | registry `prompt` | One builder for all intents |
+| `resolvePhoneKey` | `phoneKey ?? threadId` | Key passed to `tools(phoneKey)` |
+
+---
+
+## Intents
+
+```ts
+intents: [
+  {
+    name: "greetings",
+    examples: ["hi", "hello"],
+    description: "Shown to the LLM router",
+  },
+  {
+    name: "create_campaign",
+    examples: ["create a campaign"],
+    sticky: true, // keep this flow across turns until completeOn fires
+  },
+]
+```
+
+- **examples** — embedding routing  
+- **sticky** — multi-step wizards  
+- **description** — LLM intent router  
+
+---
+
+## Prompts & tools (`intentRegistry`)
+
+```ts
+intentRegistry: {
+  greetings: {
+    prompt: (ctx) => string,
+    tools: (phoneKey) => DynamicStructuredTool[],
+  },
+}
+```
+
+`prompt` receives:
+
+```ts
+{
+  hasConversationHistory: boolean
+  intent: string
+  intentScore?: number
+  message?: string
+  context?: Record<string, unknown>  // whatever you passed to invoke()
+}
+```
+
+Or use one builder for everything:
+
+```ts
+buildSystemPrompt: (ctx) => combineGeneralAndIntent(ctx)
+```
+
+---
+
+## Tool outputs (`toolOutputMap`)
+
+Replaces hand-written extractors:
+
+```ts
+toolOutputMap: {
+  create_campaign: "campaign",
+  buy_airtime: "buyAirtime",
+  // Nested field on args + seed:
+  propose_tickets: { as: "tickets", from: "tickets", initial: [] },
+}
+```
+
+Result lands on `result.toolOutputs` and completed keys on `result.extras`.
+
+---
+
+## Flow completion (`completeOn`)
+
+Pass tool **names**. When any of them produces output, the sticky flow ends:
+
+```ts
+completeOn: ["create_campaign", "buy_airtime", "add_airtime"]
+```
+
+If you omit `completeOn`, the library defaults `completeOn` to the keys of `toolOutputMap`.
+
+This is tuned to Xel-style wizards: when a sticky flow is already active and the user message looks like wizard input (digits / yes-no), the router LLM call is skipped for that turn to reduce tokens.
+
+---
+
+## Menu digits (`menuMap`)
+
+Optional. Needed only if users pick a numbered menu (`1`, `2`, …).
+
+The **prompt** shows the menu text. **`menuMap`** tells the **router** that `"1"` means `create_campaign`. Without it, a bare `"1"` is not reliably routed.
+
+```ts
+menuMap: {
+  "1": "create_campaign",
+  "2": "support_campaign",
+  "3": "buy_airtime_and_data",
+}
+```
+
+---
+
+## Invoke
+
+```ts
+const result = await runtime.invoke({
+  message: "hi",
+  threadId: "whatsapp:234...",   // conversation / checkpoint id
+  phoneKey: "234...",            // optional; passed to tools()
+  explicitIntent: "greetings",   // optional; skips hybrid router
+  context: {
+    contactName: "Ada",
+    userInfo: { email: "ada@example.com" },
+  },
+});
+```
+
+**Result**
+
+```ts
+{
+  messages: unknown[]
+  answer?: string
+  intent: { intent: string, score: number }
+  flow: { active: boolean, intent: string | null }
+  toolOutputs: Record<string, unknown>
+  flowCompleted: boolean
+  extras?: Record<string, unknown>
+  router?: { action: "continue" | "switch" | "cancel", reason?: string }
+}
+```
+
+---
+
+## Lifecycle
+
+```ts
+await runtime.connect()       // Redis (if redisUrl set)
+await runtime.invoke(...)
+await runtime.clearFlow(id)   // drop sticky flow state
+await runtime.disconnect()
+```
+
+---
+
+## Env vars (when `llm` is omitted)
+
+| Variable | Notes |
+| --- | --- |
+| `LLM_PROVIDER` | `ollama` (default) or `openai` |
+| `EMBEDDINGS_PROVIDER` | defaults to `LLM_PROVIDER` |
+| `OLLAMA_MODEL` | default `qwen2.5:7b` |
+| `OLLAMA_BASE_URL` | e.g. `http://localhost:11434` |
+| `INTENT_ROUTER_MODEL` | optional smaller router model |
+| `OLLAMA_EMBEDDINGS_MODEL` | default `mxbai-embed-large:latest` |
+| `OPENAI_API_KEY` | required for openai |
+| `OPENAI_MODEL` | default `gpt-4o-mini` |
+| `OPENAI_EMBEDDINGS_MODEL` | default `text-embedding-3-small` |
+| `REDIS_URL` | your app usually passes this as `redisUrl` |
+| `ANSWER_CACHE` | app convention: `"1"` to enable cache |
+
+Or pass LLM explicitly:
+
+```ts
+import { llmConfigFromEnv } from "llm-agent-runtime";
+
+createAgentRuntime({
+  llm: llmConfigFromEnv(),
+  // or
+  llm: { provider: "openai", model: "gpt-4o-mini", apiKey: "..." },
+})
+```
+
+---
+
+## Minimal app shape (recommended)
+
+```
+your-app/
+  agent/
+    runtime.ts      # createAgentRuntime({ ... })
+    intents.ts      # intents + menuMap + aliases
+    prompts/        # prompt strings
+    tools/          # LangChain tools / API clients
+  controllers/      # HTTP / WhatsApp — call runtime.invoke()
+```
+
+Keep channel adapters and product APIs **out** of this package.
+
+---
+
+## Full example (Xel-like)
+
+```ts
+import { createAgentRuntime } from "llm-agent-runtime";
+
+const runtime = await createAgentRuntime({
+  redisUrl: process.env.REDIS_URL ?? "redis://localhost:6379",
+  cache: { enabled: process.env.ANSWER_CACHE === "1" },
+
+  intents: [
+    { name: "greetings", examples: ["hi", "hello"] },
+    {
+      name: "create_campaign",
+      examples: ["create a campaign"],
+      sticky: true,
+    },
+    {
+      name: "buy_airtime_and_data",
+      examples: ["buy airtime", "vend airtime"],
+      sticky: true,
+    },
+  ],
+
+  menuMap: {
+    "1": "create_campaign",
+    "4": "buy_airtime_and_data",
+  },
+
+  intentAliases: {
+    buy_airtime: "buy_airtime_and_data",
+  },
+
+  intentRegistry: {
+    greetings: {
+      prompt: (ctx) => `Greet ${ctx.context?.contactName ?? "there"}. Show menu 1–7.`,
+      tools: () => [],
+    },
+    create_campaign: {
+      prompt: () => "Walk through campaign creation.",
+      tools: (phoneKey) => createCampaignTools(phoneKey),
+    },
+    buy_airtime_and_data: {
+      prompt: () => "Help buy airtime/data.",
+      tools: (phoneKey) => airtimeTools(phoneKey),
+    },
+  },
+
+  toolOutputMap: {
+    create_campaign: "campaign",
+    buy_airtime: "buyAirtime",
+    add_airtime: "addAirtime",
+  },
+  completeOn: ["create_campaign", "buy_airtime", "add_airtime"],
+});
+
+await runtime.connect();
+```
+
+---
+
+## Exports
+
+```ts
+import {
+  createAgentRuntime,
+  llmConfigFromEnv,
+  getLastMessageContent,
+  // advanced (usually not needed)
+  createToolOutputExtractor,
+  toolOutputMapToExtractors,
+} from "llm-agent-runtime";
+```

package/dist/create-runtime.d.ts

@@ -4,6 +4,8 @@ export type AgentRuntime = {
     connect: () => Promise<void>;
     disconnect: () => Promise<void>;
     clearFlow: (threadId: string) => Promise<void>;
+    /** Clears LangGraph checkpoint thread (conversation memory). */
+    clearThread: (threadId: string) => Promise<void>;
     getCachedAnswer: (message: string) => Promise<string | undefined>;
     setCachedAnswer: (message: string, answer: string) => Promise<void>;
     /** Invalidate embedding cache after changing intent examples at runtime. */

package/dist/create-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../src/create-runtime.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAC;AAepB,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,4EAA4E;IAC5E,0BAA0B,EAAE,MAAM,IAAI,CAAC;CACxC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,YAAY,CAAC,CA6MvB"}
+{"version":3,"file":"create-runtime.d.ts","sourceRoot":"","sources":["../src/create-runtime.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,YAAY,EAEb,MAAM,YAAY,CAAC;AAepB,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,gEAAgE;IAChE,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,4EAA4E;IAC5E,0BAA0B,EAAE,MAAM,IAAI,CAAC;CACxC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,YAAY,CAAC,CA0OvB"}

package/dist/create-runtime.js

@@ -1,10 +1,12 @@
 import { createAgentFactory } from "./agent.js";
 import { createModels } from "./llm.js";
+import { llmConfigFromEnv } from "./env-llm.js";
 import { createRedis } from "./redis.js";
 import { createAgentRunner } from "./services/agent-runner.js";
 import { createChatCache } from "./services/chat-cache.js";
 import { createConversationService } from "./services/conversation.js";
 import { createToolOutputExtractor, extractRawToolOutputs } from "./services/extract.js";
+import { createCompleteOnFinalize, toolOutputMapToExtractors, } from "./services/simple-config.js";
 import { createFlowRouter, stickySetFromIntents, } from "./services/flow-router.js";
 import { createIntentEmbeddings } from "./services/intent-embeddings.js";
 import { createIntentRouter } from "./services/intent-router.js";
@@ -40,10 +42,25 @@ export async function createAgentRuntime(config) {
     };
     const stickyFlows = stickySetFromIntents(config.intents);
     const menuMap = config.menuMap ?? {};
-    const created = createModels(config.llm);
+    const llm = config.llm ?? llmConfigFromEnv();
+    const created = createModels(llm);
     const chat = config.models?.chat ?? created.chat;
     const intentRouterModel = config.models?.intentRouter ?? created.intentRouter;
     const embeddings = config.models?.embeddings ?? created.embeddings;
+    const fromMap = config.toolOutputMap
+        ? toolOutputMapToExtractors(config.toolOutputMap)
+        : null;
+    const toolExtractors = config.toolExtractors ?? fromMap?.toolExtractors;
+    const initialToolOutputs = config.initialToolOutputs ?? fromMap?.initialToolOutputs;
+    const completeOn = config.completeOn ??
+        (config.toolOutputMap ? Object.keys(config.toolOutputMap) : undefined);
+    const finalizeFlow = config.finalizeFlow ??
+        (completeOn?.length
+            ? createCompleteOnFinalize({
+                completeOn,
+                toolOutputMap: config.toolOutputMap,
+            })
+            : undefined);
     // Redis client when redisUrl is set (flow state + optional answer cache)
     const redis = config.redisUrl
         ? createRedis(config.redisUrl)
@@ -91,12 +108,14 @@ export async function createAgentRuntime(config) {
         classifyIntentWithLlm: intentRouter.classifyIntentWithLlm,
         mergeIntentResults: intentRouter.mergeIntentResults,
         chatCache,
-        finalizeFlow: config.finalizeFlow,
+        finalizeFlow,
         thresholds: config.thresholds,
     });
     const extractToolOutputs = config.extractToolOutputs ??
-        (config.toolExtractors
-            ? createToolOutputExtractor(config.toolExtractors, config.initialToolOutputs, { includeUnknown: config.includeUnknownToolOutputs ?? false })
+        (toolExtractors
+            ? createToolOutputExtractor(toolExtractors, initialToolOutputs, {
+                includeUnknown: config.includeUnknownToolOutputs ?? false,
+            })
             : extractRawToolOutputs);
     const buildSystemPrompt = config.buildSystemPrompt ??
         ((ctx) => {
@@ -190,6 +209,13 @@ export async function createAgentRuntime(config) {
             await redis?.disconnect();
         },
         clearFlow: chatCache.clearChatCacheFlowState,
+        clearThread: async (threadId) => {
+            const saver = agentFactory.checkpointer;
+            if (typeof saver.deleteThread === "function") {
+                await saver.deleteThread(threadId);
+            }
+            await chatCache.clearChatCacheFlowState(threadId);
+        },
         getCachedAnswer: chatCache.getCachedAnswer,
         setCachedAnswer: chatCache.setCachedAnswer,
         invalidateIntentEmbeddings: intentEmbeddings.invalidate,

package/dist/env-llm.d.ts

@@ -0,0 +1,13 @@
+import type { LlmConfig } from "./types.js";
+/**
+ * Build LlmConfig from process.env (Xel / recharge defaults).
+ *
+ * Env knobs:
+ * - LLM_PROVIDER / EMBEDDINGS_PROVIDER — ollama | openai
+ * - OLLAMA_MODEL / OPENAI_MODEL
+ * - INTENT_ROUTER_MODEL / OPENAI_INTENT_ROUTER_MODEL
+ * - OLLAMA_EMBEDDINGS_MODEL / OPENAI_EMBEDDINGS_MODEL
+ * - OLLAMA_BASE_URL / OPENAI_API_KEY
+ */
+export declare function llmConfigFromEnv(env?: NodeJS.ProcessEnv): LlmConfig;
+//# sourceMappingURL=env-llm.d.ts.map

package/dist/env-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-llm.d.ts","sourceRoot":"","sources":["../src/env-llm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC;AAezD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,SAAS,CA6BX"}

package/dist/env-llm.js

@@ -0,0 +1,44 @@
+const asProvider = (value, fallback) => {
+    const normalized = value?.trim().toLowerCase();
+    if (normalized === "openai" ||
+        normalized === "gpt" ||
+        normalized === "chatgpt") {
+        return "openai";
+    }
+    if (normalized === "ollama")
+        return "ollama";
+    return fallback;
+};
+/**
+ * Build LlmConfig from process.env (Xel / recharge defaults).
+ *
+ * Env knobs:
+ * - LLM_PROVIDER / EMBEDDINGS_PROVIDER — ollama | openai
+ * - OLLAMA_MODEL / OPENAI_MODEL
+ * - INTENT_ROUTER_MODEL / OPENAI_INTENT_ROUTER_MODEL
+ * - OLLAMA_EMBEDDINGS_MODEL / OPENAI_EMBEDDINGS_MODEL
+ * - OLLAMA_BASE_URL / OPENAI_API_KEY
+ */
+export function llmConfigFromEnv(env = process.env) {
+    const provider = asProvider(env.LLM_PROVIDER, "ollama");
+    const embeddingsProvider = asProvider(env.EMBEDDINGS_PROVIDER ?? env.LLM_PROVIDER, provider);
+    return {
+        provider,
+        embeddingsProvider,
+        model: provider === "openai"
+            ? (env.OPENAI_MODEL ?? "gpt-4o-mini")
+            : (env.OLLAMA_MODEL ?? "qwen2.5:7b"),
+        intentRouterModel: provider === "openai"
+            ? (env.OPENAI_INTENT_ROUTER_MODEL ??
+                env.OPENAI_MODEL ??
+                "gpt-4o-mini")
+            : (env.INTENT_ROUTER_MODEL ??
+                env.OLLAMA_INTENT_ROUTER_MODEL ??
+                "qwen2.5:7b"),
+        embeddingsModel: embeddingsProvider === "openai"
+            ? (env.OPENAI_EMBEDDINGS_MODEL ?? "text-embedding-3-small")
+            : (env.OLLAMA_EMBEDDINGS_MODEL ?? "mxbai-embed-large:latest"),
+        baseUrl: env.OLLAMA_BASE_URL,
+        apiKey: env.OPENAI_API_KEY,
+    };
+}

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export { createAgentRuntime, type AgentRuntime } from "./create-runtime.js";
 export { createModels } from "./llm.js";
+export { llmConfigFromEnv } from "./env-llm.js";
 export { createRedis } from "./redis.js";
 export { extractRawToolOutputs, extractToolCallArgs, getToolCallsFromMessages, createToolOutputExtractor, } from "./services/extract.js";
+export { toolOutputMapToExtractors, createCompleteOnFinalize, } from "./services/simple-config.js";
 export { isWizardInput } from "./services/flow-router.js";
 export { getLastMessageContent } from "./utils/message.js";
 export { normalize } from "./utils/normalize.js";
-export type { AgentRuntimeConfig, CacheConfig, ChatFlowState, DetectedIntentResult, FinalizeFlowInput, FinalizeFlowResult, FlowResolution, FlowState, IntentBinding, IntentDefinition, IntentRegistry, InvokeInput, InvokeResult, LlmConfig, LlmIntentResult, LlmProvider, PromptContext, ToolCall, ToolExtractor, ToolExtractorMap, TracingConfig, } from "./types.js";
+export type { AgentRuntimeConfig, CacheConfig, ChatFlowState, DetectedIntentResult, FinalizeFlowInput, FinalizeFlowResult, FlowResolution, FlowState, IntentBinding, IntentDefinition, IntentRegistry, InvokeInput, InvokeResult, LlmConfig, LlmIntentResult, LlmProvider, PromptContext, ToolCall, ToolExtractor, ToolExtractorMap, ToolOutputMap, TracingConfig, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,aAAa,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,SAAS,EACT,eAAe,EACf,WAAW,EACX,aAAa,EACb,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,7 +1,9 @@
 export { createAgentRuntime } from "./create-runtime.js";
 export { createModels } from "./llm.js";
+export { llmConfigFromEnv } from "./env-llm.js";
 export { createRedis } from "./redis.js";
 export { extractRawToolOutputs, extractToolCallArgs, getToolCallsFromMessages, createToolOutputExtractor, } from "./services/extract.js";
+export { toolOutputMapToExtractors, createCompleteOnFinalize, } from "./services/simple-config.js";
 export { isWizardInput } from "./services/flow-router.js";
 export { getLastMessageContent } from "./utils/message.js";
 export { normalize } from "./utils/normalize.js";

package/dist/services/conversation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/services/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY;+CACV,MAAM;kDAsCT,OAAO,EAAE,KAAG,MAAM;gDAe3D,MAAM,KACf,OAAO,CAAC,MAAM,CAAC;EAUnB"}
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../src/services/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,YAAY;+CAWV,MAAM;kDAwCT,OAAO,EAAE,KAAG,MAAM;gDAkB3D,MAAM,KACf,OAAO,CAAC,MAAM,CAAC;EAUnB"}

package/dist/services/conversation.js

@@ -1,15 +1,26 @@
 export function createConversationService(agentFactory) {
+    // Keep intent-router prompts small (matches Xel-agent defaults).
+    const AGENT_HISTORY_LIMIT = 4;
+    const INTENT_ROUTER_HISTORY_LIMIT = 3;
+    const INTENT_ROUTER_MESSAGE_CHAR_LIMIT = 200;
+    const isHumanOrAiMessage = (message) => {
+        const type = message._getType?.() ?? message.type ?? "";
+        return type === "human" || type === "ai";
+    };
     const getManagedConversationMessages = async (threadId) => {
         const state = await agentFactory.getAgentState(threadId);
         const messages = state.values.messages ?? [];
         return messages
             .filter((message) => {
-            const content = String(message?.content ?? "").toLowerCase();
-            return (!content.includes("tool failed") &&
-                !content.includes("error") &&
-                !content.includes("undefined"));
+            if (!isHumanOrAiMessage(message))
+                return false;
+            const content = String(message?.content ?? "")
+                .toLowerCase();
+            return !(content.includes("tool failed") ||
+                content.includes("error") ||
+                content.includes("undefined"));
         })
-            .slice(-8);
+            .slice(-AGENT_HISTORY_LIMIT);
     };
     const getMessageRole = (message) => {
         const type = message._getType?.() ?? message.type ?? "";
@@ -17,7 +28,8 @@ export function createConversationService(agentFactory) {
             return "User";
         if (type === "ai")
             return "Assistant";
-        return "System";
+        // Should not happen due to isHumanOrAiMessage filter.
+        return "User";
     };
     const getMessageText = (message) => {
         const content = message.content;
@@ -35,10 +47,10 @@ export function createConversationService(agentFactory) {
         if (messages.length === 0)
             return "(no prior messages)";
         return messages
-            .slice(-6)
+            .slice(-INTENT_ROUTER_HISTORY_LIMIT)
             .map((message) => {
             const role = getMessageRole(message);
-            const text = getMessageText(message).slice(0, 300);
+            const text = getMessageText(message).slice(0, INTENT_ROUTER_MESSAGE_CHAR_LIMIT);
             return text ? `${role}: ${text}` : null;
         })
             .filter(Boolean)

package/dist/services/flow-router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow-router.d.ts","sourceRoot":"","sources":["../../src/services/flow-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,OAI/C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,kBAAkB,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC,CAAC;IAC3E,sBAAsB,EAAE,CACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,KAC9C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACrC,qBAAqB,EAAE,CAAC,KAAK,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/B,kBAAkB,EAAE,CAClB,YAAY,EAAE,oBAAoB,EAClC,SAAS,EAAE,eAAe,KACvB,oBAAoB,GAAG;QAAE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC;IAClE,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,CACb,KAAK,EAAE,iBAAiB,KACrB,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;sFAoBI;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;QACtC,mBAAmB,EAAE,MAAM,CAAC;KAC7B,KAAG,OAAO,CAAC,cAAc,CAAC;+BA6JlB,iBAAiB,KACvB,OAAO,CAAC,kBAAkB,CAAC;EAkB/B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAE7E;AAED,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"flow-router.d.ts","sourceRoot":"","sources":["../../src/services/flow-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,eAAe,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAOjD,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,OAI/C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,kBAAkB,EAAE,MAAM,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC,CAAC;IAC3E,sBAAsB,EAAE,CACtB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,KAC9C,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACrC,qBAAqB,EAAE,CAAC,KAAK,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAC;QAChB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/B,kBAAkB,EAAE,CAClB,YAAY,EAAE,oBAAoB,EAClC,SAAS,EAAE,eAAe,KACvB,oBAAoB,GAAG;QAAE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAC;IAClE,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,CACb,KAAK,EAAE,iBAAiB,KACrB,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE;QACX,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;sFAoBI;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;QACtC,mBAAmB,EAAE,MAAM,CAAC;KAC7B,KAAG,OAAO,CAAC,cAAc,CAAC;+BA4KlB,iBAAiB,KACvB,OAAO,CAAC,kBAAkB,CAAC;EAkB/B;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAE7E;AAED,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}

package/dist/services/flow-router.js

@@ -31,6 +31,18 @@ export function createFlowRouter(options) {
         const cachedIntent = cachedFlowState?.intent
             ? options.normalizeIntent(cachedFlowState.intent)
             : null;
+        // Token reduction: when we already know a sticky wizard intent,
+        // and the user replies with wizard-like input, skip router LLM.
+        // (Xel-agent equivalent: shouldSkipIntentClassification()).
+        if (cachedIntent !== null &&
+            options.stickyFlows.has(cachedIntent) &&
+            isWizardInput(message)) {
+            return {
+                messageIntent: { intent: cachedIntent, score: 1 },
+                flow: { active: true, intent: cachedIntent },
+                promptIntent: cachedIntent,
+            };
+        }
         const menuIntent = resolveGreetingMenuSelection(message, cachedIntent);
         if (menuIntent) {
             const sticky = options.stickyFlows.has(menuIntent);

package/dist/services/simple-config.d.ts

@@ -0,0 +1,32 @@
+import type { ToolExtractorMap, ToolOutputMap } from "../types.js";
+export type { ToolOutputMap };
+export declare function resolveToolOutputKey(toolName: string, map: ToolOutputMap): string;
+/** Build first-wins extractors + initial seed from a simple map. */
+export declare function toolOutputMapToExtractors(map: ToolOutputMap): {
+    toolExtractors: ToolExtractorMap;
+    initialToolOutputs: () => Record<string, unknown>;
+};
+/**
+ * Default finalize: complete sticky flow when any listed tool produced output.
+ * `completeOn` is tool names (keys of toolOutputMap / LangChain tool name).
+ */
+export declare function createCompleteOnFinalize(options: {
+    completeOn: string[];
+    toolOutputMap?: ToolOutputMap;
+}): ({ flow, toolOutputs, }: {
+    threadId: string;
+    promptIntent: string;
+    flow: {
+        active: boolean;
+        intent: string | null;
+    };
+    toolOutputs: Record<string, unknown>;
+}) => {
+    flowCompleted: boolean;
+    flow: {
+        active: boolean;
+        intent: string | null;
+    };
+    extras: Record<string, unknown>;
+};
+//# sourceMappingURL=simple-config.d.ts.map

package/dist/services/simple-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple-config.d.ts","sourceRoot":"","sources":["../../src/services/simple-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEnE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,aAAa,GACjB,MAAM,CAIR;AAED,oEAAoE;AACpE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,aAAa,GAAG;IAC7D,cAAc,EAAE,gBAAgB,CAAC;IACjC,kBAAkB,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnD,CAkCA;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,IAGS,wBAGL;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;;;;;;;EA0BF"}

package/dist/services/simple-config.js

@@ -0,0 +1,70 @@
+export function resolveToolOutputKey(toolName, map) {
+    const entry = map[toolName];
+    if (!entry)
+        return toolName;
+    return typeof entry === "string" ? entry : entry.as;
+}
+/** Build first-wins extractors + initial seed from a simple map. */
+export function toolOutputMapToExtractors(map) {
+    const toolExtractors = {};
+    const initial = {};
+    for (const [toolName, entry] of Object.entries(map)) {
+        if (typeof entry === "string") {
+            toolExtractors[toolName] = (args, acc) => {
+                if (acc[entry] !== undefined)
+                    return;
+                acc[entry] = args;
+            };
+            continue;
+        }
+        const key = entry.as;
+        if (entry.initial !== undefined && !(key in initial)) {
+            initial[key] = entry.initial;
+        }
+        toolExtractors[toolName] = (args, acc) => {
+            const current = acc[key];
+            if (Array.isArray(current) && current.length > 0)
+                return;
+            if (current !== undefined && !Array.isArray(current))
+                return;
+            acc[key] =
+                entry.from !== undefined
+                    ? (args[entry.from] ?? entry.initial ?? [])
+                    : args;
+        };
+    }
+    return {
+        toolExtractors,
+        initialToolOutputs: () => ({ ...initial }),
+    };
+}
+/**
+ * Default finalize: complete sticky flow when any listed tool produced output.
+ * `completeOn` is tool names (keys of toolOutputMap / LangChain tool name).
+ */
+export function createCompleteOnFinalize(options) {
+    const { completeOn, toolOutputMap = {} } = options;
+    return ({ flow, toolOutputs, }) => {
+        const extras = {};
+        let flowCompleted = false;
+        for (const toolName of completeOn) {
+            const key = resolveToolOutputKey(toolName, toolOutputMap);
+            const value = toolOutputs[key];
+            const hit = Array.isArray(value)
+                ? value.length > 0
+                : value !== undefined && value !== null;
+            if (hit) {
+                flowCompleted = true;
+                extras[key] = value;
+            }
+        }
+        return {
+            flowCompleted,
+            flow: {
+                active: flow.active && !flowCompleted,
+                intent: flowCompleted ? null : flow.intent,
+            },
+            extras,
+        };
+    };
+}

package/dist/types.d.ts

@@ -2,6 +2,24 @@ import type { BaseChatModel } from "@langchain/core/language_models/chat_models"
 import type { Embeddings } from "@langchain/core/embeddings";
 import type { DynamicStructuredTool } from "@langchain/core/tools";
 import type { BaseCheckpointSaver } from "@langchain/langgraph-checkpoint";
+/**
+ * Simple tool → output key map.
+ *
+ * @example
+ * {
+ *   create_campaign: "campaign",
+ *   buy_airtime: "buyAirtime",
+ *   propose_tickets: { as: "tickets", from: "tickets", initial: [] },
+ * }
+ */
+export type ToolOutputMap = Record<string, string | {
+    /** Key written onto toolOutputs / extras. */
+    as: string;
+    /** Nested field on tool args (e.g. args.tickets). */
+    from?: string;
+    /** Seed value when nothing extracted yet. */
+    initial?: unknown;
+}>;
 /** Intent catalog entry used for embedding routing + sticky-flow rules. */
 export type IntentDefinition = {
     name: string;
@@ -118,12 +136,19 @@ export type InvokeResult = {
 };
 export type AgentRuntimeConfig = {
     redisUrl?: string;
-    llm: LlmConfig;
+    /**
+     * LLM config. Omit to use `llmConfigFromEnv()` (OLLAMA_* / OPENAI_* env vars).
+     */
+    llm?: LlmConfig;
     /** Intent catalog for embeddings + sticky flags. */
     intents: IntentDefinition[];
     /** Per-intent prompt + tools factory. */
     intentRegistry: IntentRegistry;
-    /** Digit / short-code → intent (e.g. greeting menu "1" → create_campaign). */
+    /**
+     * Optional digit → intent routing (e.g. menu "1" → create_campaign).
+     * Prompt text alone cannot switch intent when the user types a number —
+     * keep this if you use a numbered menu. Safe to omit otherwise.
+     */
     menuMap?: Record<string, string>;
     /** Map legacy/alias names onto catalog intents. */
     intentAliases?: Record<string, string>;
@@ -133,19 +158,27 @@ export type AgentRuntimeConfig = {
     /** Custom system prompt builder; default uses intentRegistry[intent].prompt. */
     buildSystemPrompt?: (ctx: PromptContext) => string;
     /**
-     * Per-tool extractors (Xel extractToolCall style).
-     * Prefer this over a custom `extractToolOutputs` unless you need full control.
+     * Simple toolName → output key map (preferred).
+     * @example { create_campaign: "campaign", buy_airtime: "buyAirtime" }
+     */
+    toolOutputMap?: ToolOutputMap;
+    /**
+     * Tool names that complete a sticky flow when they produce output.
+     * Library owns finalize logic — you only pass the list.
+     */
+    completeOn?: string[];
+    /**
+     * Per-tool extractors (advanced). Prefer `toolOutputMap` instead.
      */
     toolExtractors?: ToolExtractorMap;
     /** Seed object for tool extractors (e.g. () => ({ tickets: [] })). */
     initialToolOutputs?: () => Record<string, unknown>;
     /** If true, unknown tool names are kept as raw args. Default false when using toolExtractors. */
     includeUnknownToolOutputs?: boolean;
-    /** Full custom extractor. Overrides toolExtractors when provided. */
+    /** Full custom extractor. Overrides toolOutputMap / toolExtractors when provided. */
     extractToolOutputs?: (messages: unknown[]) => Record<string, unknown>;
     /**
-     * Decide when a sticky flow is done.
-     * Default: never auto-complete (app must clear via finalize or clearFlow).
+     * Custom finalize. Prefer `completeOn` for the common case.
      */
     finalizeFlow?: (input: FinalizeFlowInput) => FinalizeFlowResult | Promise<FinalizeFlowResult>;
     /** Derive phone/session key for tools. Default: phoneKey ?? threadId. */

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-agent-runtime",
-  "version": "0.1.0",
+  "version": "0.1.5",
   "description": "Reusable LangGraph agent runtime: intent routing, sticky flows, Redis checkpointer, optional answer cache",
   "license": "ISC",
   "type": "module",
@@ -13,13 +13,15 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "USAGE.md",
+    "README.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "dev": "tsc -p tsconfig.json --watch",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "tsx --test src/**/*.test.ts",
+    "test": "tsx --test src/services/extract.test.ts && tsx --test src/services/simple-config.test.ts",
     "prepublishOnly": "pnpm build && pnpm test"
   },
   "publishConfig": {