agentfootprint 1.0.0

package/dist/models/providers.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Provider factory functions.
+ * Return ModelConfig — adapters turn these into LLMProvider instances.
+ *
+ * Usage:
+ *   import { anthropic, openai, ollama } from 'agentfootprint';
+ *   const model = anthropic('claude-sonnet-4-20250514');
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bedrock = exports.ollama = exports.openai = exports.anthropic = void 0;
+function anthropic(modelId, options) {
+    return {
+        provider: 'anthropic',
+        modelId,
+        apiKey: options?.apiKey,
+        options,
+    };
+}
+exports.anthropic = anthropic;
+function openai(modelId, options) {
+    return {
+        provider: 'openai',
+        modelId,
+        apiKey: options?.apiKey,
+        baseUrl: options?.baseUrl,
+        options,
+    };
+}
+exports.openai = openai;
+function ollama(modelId, options) {
+    return {
+        provider: 'ollama',
+        modelId,
+        baseUrl: options?.baseUrl ?? 'http://localhost:11434',
+        options,
+    };
+}
+exports.ollama = ollama;
+function bedrock(modelId, options) {
+    return {
+        provider: 'bedrock',
+        modelId,
+        region: options?.region,
+        options,
+    };
+}
+exports.bedrock = bedrock;
+//# sourceMappingURL=providers.js.map

package/dist/models/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/models/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAIH,SAAgB,SAAS,CACvB,OAAe,EACf,OAA4C;IAE5C,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,OAAO;QACP,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,OAAO;KACR,CAAC;AACJ,CAAC;AAVD,8BAUC;AAED,SAAgB,MAAM,CACpB,OAAe,EACf,OAA8D;IAE9D,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,OAAO;QACP,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,OAAO,EAAE,OAAO,EAAE,OAAO;QACzB,OAAO;KACR,CAAC;AACJ,CAAC;AAXD,wBAWC;AAED,SAAgB,MAAM,CACpB,OAAe,EACf,OAA6C;IAE7C,OAAO;QACL,QAAQ,EAAE,QAAQ;QAClB,OAAO;QACP,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,wBAAwB;QACrD,OAAO;KACR,CAAC;AACJ,CAAC;AAVD,wBAUC;AAED,SAAgB,OAAO,CACrB,OAAe,EACf,OAA4C;IAE5C,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,OAAO;QACP,MAAM,EAAE,OAAO,EAAE,MAAM;QACvB,OAAO;KACR,CAAC;AACJ,CAAC;AAVD,0BAUC"}

package/dist/models/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Model configuration types.
+ * Factory functions return ModelConfig — adapters consume it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/models/types.js.map

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

package/dist/observe.barrel.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * agentfootprint/observe — Monitor agent execution.
+ *
+ * Track tokens, cost, tool usage, quality, guardrails. Attach via `.recorder()`.
+ *
+ * @example
+ * ```typescript
+ * import { agentObservability } from 'agentfootprint/observe';
+ *
+ * const obs = agentObservability({ pricing: { 'claude-sonnet': { input: 3, output: 15 } } });
+ * const agent = Agent.create({ provider }).recorder(obs).build();
+ * await agent.run('hello');
+ * console.log(obs.tokens()); // { totalCalls, totalInputTokens, ... }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OTelRecorder = exports.agentObservability = exports.CompositeRecorder = exports.PermissionRecorder = exports.GuardrailRecorder = exports.QualityRecorder = exports.ToolUsageRecorder = exports.TurnRecorder = exports.CostRecorder = exports.TokenRecorder = void 0;
+var recorders_1 = require("./recorders");
+Object.defineProperty(exports, "TokenRecorder", { enumerable: true, get: function () { return recorders_1.TokenRecorder; } });
+Object.defineProperty(exports, "CostRecorder", { enumerable: true, get: function () { return recorders_1.CostRecorder; } });
+Object.defineProperty(exports, "TurnRecorder", { enumerable: true, get: function () { return recorders_1.TurnRecorder; } });
+Object.defineProperty(exports, "ToolUsageRecorder", { enumerable: true, get: function () { return recorders_1.ToolUsageRecorder; } });
+Object.defineProperty(exports, "QualityRecorder", { enumerable: true, get: function () { return recorders_1.QualityRecorder; } });
+Object.defineProperty(exports, "GuardrailRecorder", { enumerable: true, get: function () { return recorders_1.GuardrailRecorder; } });
+Object.defineProperty(exports, "PermissionRecorder", { enumerable: true, get: function () { return recorders_1.PermissionRecorder; } });
+Object.defineProperty(exports, "CompositeRecorder", { enumerable: true, get: function () { return recorders_1.CompositeRecorder; } });
+Object.defineProperty(exports, "agentObservability", { enumerable: true, get: function () { return recorders_1.agentObservability; } });
+var OTelRecorder_1 = require("./recorders/v2/OTelRecorder");
+Object.defineProperty(exports, "OTelRecorder", { enumerable: true, get: function () { return OTelRecorder_1.OTelRecorder; } });
+//# sourceMappingURL=observe.barrel.js.map

package/dist/observe.barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.barrel.js","sourceRoot":"","sources":["../src/observe.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yCAUqB;AATnB,0GAAA,aAAa,OAAA;AACb,yGAAA,YAAY,OAAA;AACZ,yGAAA,YAAY,OAAA;AACZ,8GAAA,iBAAiB,OAAA;AACjB,4GAAA,eAAe,OAAA;AACf,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAGpB,4DAA2D;AAAlD,4GAAA,YAAY,OAAA"}

package/dist/providers/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * providers/ — Built-in active strategy implementations.
+ *
+ * Each sub-module provides strategies for one provider interface:
+ *   prompt/    → PromptProvider strategies
+ *   messages/  → MessageStrategy strategies
+ *   tools/     → ToolProvider strategies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PermissionPolicy = exports.gatedTools = exports.compositeTools = exports.agentAsTool = exports.noTools = exports.dynamicTools = exports.staticTools = exports.InMemoryStore = exports.persistentHistory = exports.compositeMessages = exports.summaryStrategy = exports.withToolPairSafety = exports.charBudget = exports.slidingWindow = exports.fullHistory = exports.compositePrompt = exports.skillBasedPrompt = exports.templatePrompt = exports.staticPrompt = void 0;
+var prompt_1 = require("./prompt");
+Object.defineProperty(exports, "staticPrompt", { enumerable: true, get: function () { return prompt_1.staticPrompt; } });
+Object.defineProperty(exports, "templatePrompt", { enumerable: true, get: function () { return prompt_1.templatePrompt; } });
+Object.defineProperty(exports, "skillBasedPrompt", { enumerable: true, get: function () { return prompt_1.skillBasedPrompt; } });
+Object.defineProperty(exports, "compositePrompt", { enumerable: true, get: function () { return prompt_1.compositePrompt; } });
+var messages_1 = require("./messages");
+Object.defineProperty(exports, "fullHistory", { enumerable: true, get: function () { return messages_1.fullHistory; } });
+Object.defineProperty(exports, "slidingWindow", { enumerable: true, get: function () { return messages_1.slidingWindow; } });
+Object.defineProperty(exports, "charBudget", { enumerable: true, get: function () { return messages_1.charBudget; } });
+Object.defineProperty(exports, "withToolPairSafety", { enumerable: true, get: function () { return messages_1.withToolPairSafety; } });
+Object.defineProperty(exports, "summaryStrategy", { enumerable: true, get: function () { return messages_1.summaryStrategy; } });
+Object.defineProperty(exports, "compositeMessages", { enumerable: true, get: function () { return messages_1.compositeMessages; } });
+Object.defineProperty(exports, "persistentHistory", { enumerable: true, get: function () { return messages_1.persistentHistory; } });
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return messages_1.InMemoryStore; } });
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "staticTools", { enumerable: true, get: function () { return tools_1.staticTools; } });
+Object.defineProperty(exports, "dynamicTools", { enumerable: true, get: function () { return tools_1.dynamicTools; } });
+Object.defineProperty(exports, "noTools", { enumerable: true, get: function () { return tools_1.noTools; } });
+Object.defineProperty(exports, "agentAsTool", { enumerable: true, get: function () { return tools_1.agentAsTool; } });
+Object.defineProperty(exports, "compositeTools", { enumerable: true, get: function () { return tools_1.compositeTools; } });
+Object.defineProperty(exports, "gatedTools", { enumerable: true, get: function () { return tools_1.gatedTools; } });
+Object.defineProperty(exports, "PermissionPolicy", { enumerable: true, get: function () { return tools_1.PermissionPolicy; } });
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,mCAA2F;AAAlF,sGAAA,YAAY,OAAA;AAAE,wGAAA,cAAc,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,yGAAA,eAAe,OAAA;AAExE,uCASoB;AARlB,uGAAA,WAAW,OAAA;AACX,yGAAA,aAAa,OAAA;AACb,sGAAA,UAAU,OAAA;AACV,8GAAA,kBAAkB,OAAA;AAClB,2GAAA,eAAe,OAAA;AACf,6GAAA,iBAAiB,OAAA;AACjB,6GAAA,iBAAiB,OAAA;AACjB,yGAAA,aAAa,OAAA;AASf,iCAAwH;AAA/G,oGAAA,WAAW,OAAA;AAAE,qGAAA,YAAY,OAAA;AAAE,gGAAA,OAAO,OAAA;AAAE,oGAAA,WAAW,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,mGAAA,UAAU,OAAA;AAAE,yGAAA,gBAAgB,OAAA"}

package/dist/providers/messages/charBudget.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * charBudget — MessageStrategy that keeps messages within a character budget.
+ *
+ * Uses character count as a rough proxy for tokens (~4 chars/token).
+ * Always preserves system messages. Fills budget from most recent messages first.
+ *
+ * For precise token counting, implement MessageStrategy directly with a
+ * provider-specific tokenizer (e.g. tiktoken).
+ *
+ * Usage:
+ *   agentLoop().messageStrategy(charBudget({ maxChars: 16000 })) // ~4k tokens
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.charBudget = void 0;
+const content_1 = require("../../types/content");
+function charBudget(options) {
+    const { maxChars } = options;
+    return {
+        prepare: (history) => {
+            const system = history.filter((m) => m.role === 'system');
+            const rest = history.filter((m) => m.role !== 'system');
+            let totalChars = system.reduce((sum, m) => sum + (0, content_1.contentLength)(m.content), 0);
+            const kept = [];
+            // Walk backwards — keep most recent messages first
+            for (let i = rest.length - 1; i >= 0; i--) {
+                const msgChars = (0, content_1.contentLength)(rest[i].content);
+                if (totalChars + msgChars > maxChars)
+                    break;
+                totalChars += msgChars;
+                kept.unshift(rest[i]);
+            }
+            const result = [...system, ...kept];
+            return {
+                value: result,
+                chosen: 'char-budget',
+                rationale: `kept ${result.length} of ${history.length} (${totalChars} chars)`,
+            };
+        },
+    };
+}
+exports.charBudget = charBudget;
+//# sourceMappingURL=charBudget.js.map

package/dist/providers/messages/charBudget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charBudget.js","sourceRoot":"","sources":["../../../src/providers/messages/charBudget.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAGH,iDAAoD;AAQpD,SAAgB,UAAU,CAAC,OAA0B;IACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAE7B,OAAO;QACL,OAAO,EAAE,CAAC,OAAkB,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAExD,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAA,uBAAa,EAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9E,MAAM,IAAI,GAAc,EAAE,CAAC;YAE3B,mDAAmD;YACnD,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,QAAQ,GAAG,IAAA,uBAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAChD,IAAI,UAAU,GAAG,QAAQ,GAAG,QAAQ;oBAAE,MAAM;gBAC5C,UAAU,IAAI,QAAQ,CAAC;gBACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;YACpC,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,aAAa;gBACrB,SAAS,EAAE,QAAQ,MAAM,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,SAAS;aAC9E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AA3BD,gCA2BC"}

package/dist/providers/messages/compositeMessages.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * compositeMessages — MessageStrategy that chains multiple strategies.
+ *
+ * Strategies execute in order: the output of one becomes the input of the next.
+ * This enables layered processing: e.g., summarize → sliding window → tool pair safety.
+ *
+ * Usage:
+ *   agentLoop().messageStrategy(compositeMessages([
+ *     summaryStrategy({ keepLast: 20, summarize: mySummarizer }),
+ *     slidingWindow({ maxMessages: 10 }),
+ *     withToolPairSafety,
+ *   ]))
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compositeMessages = void 0;
+function compositeMessages(strategies) {
+    return {
+        prepare: async (history, context) => {
+            let messages = history;
+            const labels = [];
+            for (const strategy of strategies) {
+                const decision = await strategy.prepare(messages, context);
+                messages = decision.value;
+                if (decision.chosen !== 'static')
+                    labels.push(decision.chosen);
+            }
+            return {
+                value: messages,
+                chosen: labels.length > 0 ? `composite: ${labels.join(' → ')}` : 'composite',
+                rationale: `${messages.length} messages after ${strategies.length} strategies`,
+            };
+        },
+    };
+}
+exports.compositeMessages = compositeMessages;
+//# sourceMappingURL=compositeMessages.js.map

package/dist/providers/messages/compositeMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositeMessages.js","sourceRoot":"","sources":["../../../src/providers/messages/compositeMessages.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAKH,SAAgB,iBAAiB,CAAC,UAAsC;IACtE,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAkB,EAAE,OAAuB,EAAE,EAAE;YAC7D,IAAI,QAAQ,GAAG,OAAO,CAAC;YACvB,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAClC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC3D,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC;gBAC1B,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ;oBAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjE,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,QAAQ;gBACf,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW;gBAC5E,SAAS,EAAE,GAAG,QAAQ,CAAC,MAAM,mBAAmB,UAAU,CAAC,MAAM,aAAa;aAC/E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAjBD,8CAiBC"}

package/dist/providers/messages/fullHistory.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * fullHistory — MessageStrategy that sends the entire conversation to the LLM.
+ *
+ * The simplest strategy. No truncation, no summarization.
+ * Use when conversations are short or context windows are large.
+ *
+ * Usage:
+ *   agentLoop().messageStrategy(fullHistory())
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fullHistory = void 0;
+function fullHistory() {
+    return {
+        prepare: (history) => ({ value: history, chosen: 'full-history', rationale: `${history.length} messages` }),
+    };
+}
+exports.fullHistory = fullHistory;
+//# sourceMappingURL=fullHistory.js.map

package/dist/providers/messages/fullHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fullHistory.js","sourceRoot":"","sources":["../../../src/providers/messages/fullHistory.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAKH,SAAgB,WAAW;IACzB,OAAO;QACL,OAAO,EAAE,CAAC,OAAkB,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,WAAW,EAAE,CAAC;KACvH,CAAC;AACJ,CAAC;AAJD,kCAIC"}

package/dist/providers/messages/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * providers/messages/ — Built-in MessageStrategy implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStore = exports.persistentHistory = exports.compositeMessages = exports.summaryStrategy = exports.withToolPairSafety = exports.charBudget = exports.slidingWindow = exports.fullHistory = void 0;
+var fullHistory_1 = require("./fullHistory");
+Object.defineProperty(exports, "fullHistory", { enumerable: true, get: function () { return fullHistory_1.fullHistory; } });
+var slidingWindow_1 = require("./slidingWindow");
+Object.defineProperty(exports, "slidingWindow", { enumerable: true, get: function () { return slidingWindow_1.slidingWindow; } });
+var charBudget_1 = require("./charBudget");
+Object.defineProperty(exports, "charBudget", { enumerable: true, get: function () { return charBudget_1.charBudget; } });
+var withToolPairSafety_1 = require("./withToolPairSafety");
+Object.defineProperty(exports, "withToolPairSafety", { enumerable: true, get: function () { return withToolPairSafety_1.withToolPairSafety; } });
+var summaryStrategy_1 = require("./summaryStrategy");
+Object.defineProperty(exports, "summaryStrategy", { enumerable: true, get: function () { return summaryStrategy_1.summaryStrategy; } });
+var compositeMessages_1 = require("./compositeMessages");
+Object.defineProperty(exports, "compositeMessages", { enumerable: true, get: function () { return compositeMessages_1.compositeMessages; } });
+var persistentHistory_1 = require("./persistentHistory");
+Object.defineProperty(exports, "persistentHistory", { enumerable: true, get: function () { return persistentHistory_1.persistentHistory; } });
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return persistentHistory_1.InMemoryStore; } });
+//# sourceMappingURL=index.js.map

package/dist/providers/messages/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/messages/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AAEtB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAEnB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AAExB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,yDAAuE;AAA9D,sHAAA,iBAAiB,OAAA;AAAE,kHAAA,aAAa,OAAA"}

package/dist/providers/messages/persistentHistory.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * persistentHistory — MessageStrategy that stores and loads conversation
+ * history across sessions via a storage adapter.
+ *
+ * On each `prepare` call:
+ *   1. Loads stored messages from the adapter
+ *   2. Merges with current history (stored first, then current)
+ *   3. Saves the merged result back to the adapter
+ *   4. Returns the merged messages
+ *
+ * Storage adapter lives in adapters/memory/ — same adapter-swap pattern
+ * as LLM providers. ConversationStore and InMemoryStore are re-exported
+ * here for backward compatibility.
+ *
+ * Usage:
+ *   const store = new InMemoryStore();
+ *   agentLoop().messageStrategy(persistentHistory({
+ *     conversationId: 'conv-123',
+ *     store,
+ *   }))
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.persistentHistory = exports.InMemoryStore = void 0;
+var inMemory_1 = require("../../adapters/memory/inMemory");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return inMemory_1.InMemoryStore; } });
+// ── Factory ──────────────────────────────────────────────────
+function persistentHistory(options) {
+    const { conversationId, store } = options;
+    return {
+        prepare: async (history) => {
+            const stored = (await store.load(conversationId)) ?? [];
+            // Merge: stored history first, then new messages not in stored
+            const merged = stored.length > 0 ? [...stored, ...history.slice(stored.length)] : history;
+            await store.save(conversationId, merged);
+            return {
+                value: merged,
+                chosen: 'persistent',
+                rationale: stored.length > 0 ? `loaded ${stored.length} stored + ${history.length - stored.length} new` : `${history.length} messages (first turn)`,
+            };
+        },
+    };
+}
+exports.persistentHistory = persistentHistory;
+//# sourceMappingURL=persistentHistory.js.map

package/dist/providers/messages/persistentHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistentHistory.js","sourceRoot":"","sources":["../../../src/providers/messages/persistentHistory.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAOH,2DAA+D;AAAtD,yGAAA,aAAa,OAAA;AAStB,gEAAgE;AAEhE,SAAgB,iBAAiB,CAAC,OAAiC;IACjE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAE1C,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAkB,EAAE,EAAE;YACpC,MAAM,MAAM,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;YAExD,+DAA+D;YAC/D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAE1F,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;YACzC,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,YAAY;gBACpB,SAAS,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,MAAM,aAAa,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,wBAAwB;aACpJ,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAlBD,8CAkBC"}

package/dist/providers/messages/slidingWindow.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * slidingWindow — MessageStrategy that keeps the N most recent messages.
+ *
+ * Always preserves system messages regardless of window size.
+ * Non-system messages are taken from the end of the history.
+ *
+ * Usage:
+ *   agentLoop().messageStrategy(slidingWindow({ maxMessages: 20 }))
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slidingWindow = void 0;
+function slidingWindow(options) {
+    const { maxMessages } = options;
+    return {
+        prepare: (history) => {
+            if (history.length <= maxMessages) {
+                return { value: history, chosen: 'sliding-window', rationale: `${history.length} messages (within limit)` };
+            }
+            const system = history.filter((m) => m.role === 'system');
+            const rest = history.filter((m) => m.role !== 'system');
+            const kept = rest.slice(-maxMessages);
+            return { value: [...system, ...kept], chosen: 'sliding-window', rationale: `kept ${kept.length + system.length} of ${history.length}` };
+        },
+    };
+}
+exports.slidingWindow = slidingWindow;
+//# sourceMappingURL=slidingWindow.js.map

package/dist/providers/messages/slidingWindow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slidingWindow.js","sourceRoot":"","sources":["../../../src/providers/messages/slidingWindow.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAUH,SAAgB,aAAa,CAAC,OAA6B;IACzD,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAEhC,OAAO;QACL,OAAO,EAAE,CAAC,OAAkB,EAAE,EAAE;YAC9B,IAAI,OAAO,CAAC,MAAM,IAAI,WAAW,EAAE,CAAC;gBAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,0BAA0B,EAAE,CAAC;YAC9G,CAAC;YAED,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,CAAC;YAEtC,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1I,CAAC;KACF,CAAC;AACJ,CAAC;AAhBD,sCAgBC"}

package/dist/providers/messages/summaryStrategy.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * summaryStrategy — MessageStrategy that compresses old messages into a summary.
+ *
+ * Keeps the N most recent messages verbatim. Older messages are compressed
+ * into a single system message via a user-provided summarizer function.
+ * The summarizer can be LLM-powered or rule-based.
+ *
+ * System messages are always preserved. The summary is inserted after system
+ * messages and before the kept conversation window.
+ *
+ * Usage:
+ *   agentLoop().messageStrategy(summaryStrategy({
+ *     keepLast: 10,
+ *     summarize: async (msgs) => {
+ *       const text = msgs.map(m => `${m.role}: ${m.content}`).join('\n');
+ *       return `Previous conversation summary:\n${await llm.summarize(text)}`;
+ *     },
+ *   }))
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summaryStrategy = void 0;
+const messages_1 = require("../../types/messages");
+function summaryStrategy(options) {
+    const { keepLast, summarize } = options;
+    return {
+        prepare: async (history) => {
+            const system = history.filter((m) => m.role === 'system');
+            const rest = history.filter((m) => m.role !== 'system');
+            if (rest.length <= keepLast) {
+                return { value: history, chosen: 'summary', rationale: `${history.length} messages (within limit)` };
+            }
+            const old = rest.slice(0, rest.length - keepLast);
+            const kept = rest.slice(-keepLast);
+            const summary = await summarize(old);
+            if (!summary) {
+                return { value: [...system, ...kept], chosen: 'summary', rationale: `summarized ${old.length} old messages (summary empty)` };
+            }
+            const result = [...system, (0, messages_1.systemMessage)(summary), ...kept];
+            return { value: result, chosen: 'summary', rationale: `summarized ${old.length} old, kept ${kept.length} recent` };
+        },
+    };
+}
+exports.summaryStrategy = summaryStrategy;
+//# sourceMappingURL=summaryStrategy.js.map

package/dist/providers/messages/summaryStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summaryStrategy.js","sourceRoot":"","sources":["../../../src/providers/messages/summaryStrategy.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAGH,mDAAqD;AAUrD,SAAgB,eAAe,CAAC,OAA+B;IAC7D,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAExC,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAkB,EAAE,EAAE;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAExD,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC5B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,0BAA0B,EAAE,CAAC;YACvG,CAAC;YAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;YAEnC,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,GAAG,CAAC,MAAM,+BAA+B,EAAE,CAAC;YAChI,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,IAAA,wBAAa,EAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;YAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,GAAG,CAAC,MAAM,cAAc,IAAI,CAAC,MAAM,SAAS,EAAE,CAAC;QACrH,CAAC;KACF,CAAC;AACJ,CAAC;AAxBD,0CAwBC"}

package/dist/providers/messages/withToolPairSafety.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * withToolPairSafety — wraps any MessageStrategy to ensure tool-call/tool-result
+ * pairs are never orphaned after truncation.
+ *
+ * Problem: if a sliding window or budget strategy drops an assistant message that
+ * had toolCalls, the corresponding tool result messages become orphaned. Most LLM
+ * APIs reject or misinterpret orphaned tool results.
+ *
+ * Solution: after the inner strategy runs, scan for orphaned tool results and
+ * remove them. Also remove assistant toolCall messages whose results were dropped.
+ *
+ * Usage:
+ *   agentLoop().messageStrategy(
+ *     withToolPairSafety(slidingWindow({ maxMessages: 20 }))
+ *   )
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withToolPairSafety = void 0;
+function withToolPairSafety(inner) {
+    return {
+        prepare: (history, context) => {
+            const decision = inner.prepare(history, context);
+            // Handle both sync and async strategies
+            if (decision instanceof Promise) {
+                return decision.then((d) => {
+                    const sanitized = sanitize(d.value);
+                    const dropped = d.value.length - sanitized.length;
+                    return {
+                        value: sanitized,
+                        chosen: d.chosen,
+                        rationale: dropped > 0
+                            ? `${d.rationale ?? ''}; dropped ${dropped} orphaned tool messages`
+                            : d.rationale,
+                    };
+                });
+            }
+            const sanitized = sanitize(decision.value);
+            const dropped = decision.value.length - sanitized.length;
+            return {
+                value: sanitized,
+                chosen: decision.chosen,
+                rationale: dropped > 0
+                    ? `${decision.rationale ?? ''}; dropped ${dropped} orphaned tool messages`
+                    : decision.rationale,
+            };
+        },
+    };
+}
+exports.withToolPairSafety = withToolPairSafety;
+function sanitize(messages) {
+    // Collect all tool call IDs from assistant messages in this set
+    const availableCallIds = new Set();
+    // Collect all tool result IDs
+    const availableResultIds = new Set();
+    for (const msg of messages) {
+        if (msg.role === 'assistant' && msg.toolCalls) {
+            for (const tc of msg.toolCalls) {
+                availableCallIds.add(tc.id);
+            }
+        }
+        if (msg.role === 'tool') {
+            availableResultIds.add(msg.toolCallId);
+        }
+    }
+    return messages.filter((msg) => {
+        // Drop tool results whose assistant request was truncated
+        if (msg.role === 'tool') {
+            return availableCallIds.has(msg.toolCallId);
+        }
+        // Drop assistant toolCall messages whose results were truncated
+        if (msg.role === 'assistant' && msg.toolCalls && msg.toolCalls.length > 0) {
+            const hasAnyResult = msg.toolCalls.some((tc) => availableResultIds.has(tc.id));
+            if (!hasAnyResult)
+                return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=withToolPairSafety.js.map

package/dist/providers/messages/withToolPairSafety.js.map

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

package/dist/providers/prompt/compositePrompt.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * compositePrompt — PromptProvider that chains multiple providers together.
+ *
+ * Resolves each provider in order and concatenates results with a separator.
+ * Supports both sync and async providers. Empty results are filtered out.
+ *
+ * Usage:
+ *   const prompt = compositePrompt([
+ *     staticPrompt('You are a helpful assistant.'),
+ *     skillBasedPrompt(skills),
+ *     templatePrompt('Current turn: {{turnNumber}}.'),
+ *   ]);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compositePrompt = void 0;
+function compositePrompt(providers, options = {}) {
+    const { separator = '\n\n' } = options;
+    return {
+        resolve: async (ctx) => {
+            const decisions = await Promise.all(providers.map((p) => p.resolve(ctx)));
+            const values = decisions.map((d) => d.value).filter((v) => v.length > 0);
+            const labels = decisions.map((d) => d.chosen).filter((c) => c !== 'static');
+            return {
+                value: values.join(separator),
+                chosen: labels.length > 0 ? `composite: ${labels.join(' + ')}` : 'composite',
+            };
+        },
+    };
+}
+exports.compositePrompt = compositePrompt;
+//# sourceMappingURL=compositePrompt.js.map

package/dist/providers/prompt/compositePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositePrompt.js","sourceRoot":"","sources":["../../../src/providers/prompt/compositePrompt.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AASH,SAAgB,eAAe,CAC7B,SAAoC,EACpC,UAAkC,EAAE;IAEpC,MAAM,EAAE,SAAS,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IAEvC,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,GAAkB,EAAE,EAAE;YACpC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC1E,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;YAC5E,OAAO;gBACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW;aAC7E,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAjBD,0CAiBC"}

package/dist/providers/prompt/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * providers/prompt/ — Built-in PromptProvider strategies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compositePrompt = exports.skillBasedPrompt = exports.templatePrompt = exports.staticPrompt = void 0;
+var static_1 = require("./static");
+Object.defineProperty(exports, "staticPrompt", { enumerable: true, get: function () { return static_1.staticPrompt; } });
+var template_1 = require("./template");
+Object.defineProperty(exports, "templatePrompt", { enumerable: true, get: function () { return template_1.templatePrompt; } });
+var skillBasedPrompt_1 = require("./skillBasedPrompt");
+Object.defineProperty(exports, "skillBasedPrompt", { enumerable: true, get: function () { return skillBasedPrompt_1.skillBasedPrompt; } });
+var compositePrompt_1 = require("./compositePrompt");
+Object.defineProperty(exports, "compositePrompt", { enumerable: true, get: function () { return compositePrompt_1.compositePrompt; } });
+//# sourceMappingURL=index.js.map

package/dist/providers/prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/prompt/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AAEzB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA"}

package/dist/providers/prompt/skillBasedPrompt.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * skillBasedPrompt — PromptProvider that selects prompt fragments ("skills")
+ * based on conversation context.
+ *
+ * A "skill" is a prompt fragment with a matcher function. On each turn the
+ * provider evaluates all skills, selects the ones whose `match` returns true,
+ * and composes them into a single system prompt.
+ *
+ * Usage:
+ *   const prompt = skillBasedPrompt([
+ *     { id: 'code', content: 'You write clean code.', match: (ctx) => ctx.message.includes('code') },
+ *     { id: 'math', content: 'You solve math problems.', match: (ctx) => ctx.message.includes('math') },
+ *   ], { base: 'You are a helpful assistant.' });
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skillBasedPrompt = void 0;
+// ── Factory ──────────────────────────────────────────────────
+function skillBasedPrompt(skills, options = {}) {
+    const { base, separator = '\n\n', fallback = '' } = options;
+    return {
+        resolve: (ctx) => {
+            const matched = skills.filter((s) => s.match(ctx));
+            const parts = [];
+            if (base)
+                parts.push(base);
+            for (const skill of matched) {
+                parts.push(skill.content);
+            }
+            const value = parts.length === 0 ? fallback : parts.join(separator);
+            const matchedIds = matched.map((s) => s.id);
+            return {
+                value,
+                chosen: matchedIds.length > 0 ? `skills: ${matchedIds.join(', ')}` : 'fallback',
+                rationale: matchedIds.length > 0 ? `${matchedIds.length} skills matched` : 'no skills matched',
+            };
+        },
+    };
+}
+exports.skillBasedPrompt = skillBasedPrompt;
+//# sourceMappingURL=skillBasedPrompt.js.map

package/dist/providers/prompt/skillBasedPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillBasedPrompt.js","sourceRoot":"","sources":["../../../src/providers/prompt/skillBasedPrompt.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAwBH,gEAAgE;AAEhE,SAAgB,gBAAgB,CAC9B,MAAwB,EACxB,UAAmC,EAAE;IAErC,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,QAAQ,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE5D,OAAO;QACL,OAAO,EAAE,CAAC,GAAkB,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;YACnD,MAAM,KAAK,GAAa,EAAE,CAAC;YAE3B,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;YAED,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC5C,OAAO;gBACL,KAAK;gBACL,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU;gBAC/E,SAAS,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,iBAAiB,CAAC,CAAC,CAAC,mBAAmB;aAC/F,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAzBD,4CAyBC"}

package/dist/providers/prompt/static.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * staticPrompt — simplest PromptProvider. Returns the same string every turn.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.staticPrompt = void 0;
+function staticPrompt(prompt) {
+    return {
+        resolve: () => ({ value: prompt, chosen: 'static' }),
+    };
+}
+exports.staticPrompt = staticPrompt;
+//# sourceMappingURL=static.js.map

package/dist/providers/prompt/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../../../src/providers/prompt/static.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH,SAAgB,YAAY,CAAC,MAAc;IACzC,OAAO;QACL,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC;AAJD,oCAIC"}