llm-agent-runtime 0.1.0 → 0.1.2

package/README.md

@@ -2,4 +2,4 @@
 
 Reusable LangGraph agent runtime (intent routing, sticky flows, checkpointer, tool extractors).
 
-Usage docs deferred until the package is tested end-to-end.
+See **llm-agent-runtime-usage-guide.pdf** in this folder for the usage guide.

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,CAsOvB"}

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,23 @@ 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 finalizeFlow = config.finalizeFlow ??
+        (config.completeOn?.length
+            ? createCompleteOnFinalize({
+                completeOn: config.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 +106,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 +207,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,7 +1,9 @@
 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, type ToolOutputMap, } 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/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,EACxB,KAAK,aAAa,GACnB,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,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/simple-config.d.ts

@@ -0,0 +1,49 @@
+import type { ToolExtractorMap } from "../types.js";
+/**
+ * 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;
+}>;
+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,MAAM,aAAa,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAChC,MAAM,EACJ,MAAM,GACN;IACE,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CACJ,CAAC;AAEF,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,8 @@ 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";
+import type { ToolOutputMap } from "./services/simple-config.js";
+export type { ToolOutputMap };
 /** Intent catalog entry used for embedding routing + sticky-flow rules. */
 export type IntentDefinition = {
     name: string;
@@ -118,12 +120,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 +142,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.2",
   "description": "Reusable LangGraph agent runtime: intent routing, sticky flows, Redis checkpointer, optional answer cache",
   "license": "ISC",
   "type": "module",