agentfootprint 1.22.0 → 2.0.1

package/dist/models/types.js

@@ -1,7 +0,0 @@
-"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

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

package/dist/observe.barrel.js

@@ -1,37 +0,0 @@
-"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.ExplainRecorder = exports.OTelRecorder = exports.AgentTimelineRecorder = exports.agentTimeline = exports.contextEngineering = 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; } });
-Object.defineProperty(exports, "contextEngineering", { enumerable: true, get: function () { return recorders_1.contextEngineering; } });
-Object.defineProperty(exports, "agentTimeline", { enumerable: true, get: function () { return recorders_1.agentTimeline; } });
-Object.defineProperty(exports, "AgentTimelineRecorder", { enumerable: true, get: function () { return recorders_1.AgentTimelineRecorder; } });
-var OTelRecorder_1 = require("./recorders/OTelRecorder");
-Object.defineProperty(exports, "OTelRecorder", { enumerable: true, get: function () { return OTelRecorder_1.OTelRecorder; } });
-// ExplainRecorder — also available from agentfootprint/explain
-var ExplainRecorder_1 = require("./recorders/ExplainRecorder");
-Object.defineProperty(exports, "ExplainRecorder", { enumerable: true, get: function () { return ExplainRecorder_1.ExplainRecorder; } });
-//# sourceMappingURL=observe.barrel.js.map

package/dist/observe.barrel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"observe.barrel.js","sourceRoot":"","sources":["../src/observe.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,yCAaqB;AAZnB,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;AAClB,+GAAA,kBAAkB,OAAA;AAClB,0GAAA,aAAa,OAAA;AACb,kHAAA,qBAAqB,OAAA;AAGvB,yDAAwD;AAA/C,4GAAA,YAAY,OAAA;AAqCrB,+DAA+D;AAC/D,+DAA8D;AAArD,kHAAA,eAAe,OAAA"}

package/dist/patterns/mapReduce.js

@@ -1,64 +0,0 @@
-"use strict";
-/**
- * mapReduce — fan-out map over N pre-bound mappers, then reduce.
- *
- * Each mapper is a runner with its own input already bound (prepare them with
- * the slice they should process). `Parallel.mergeWithLLM` or a custom reduce
- * function combines the results. Under the hood: a single `Parallel` with N
- * branches and one merge strategy.
- *
- * Why: map-reduce is a common shape — summarize N documents, compare N
- * candidates, evaluate a prompt against N rubrics. Keeping it as a named
- * pattern teaches the shape; each mapper / reducer is still a regular runner.
- *
- * @example
- * ```ts
- * import { LLMCall, anthropic } from 'agentfootprint';
- * import { mapReduce } from 'agentfootprint/patterns';
- *
- * const documents = [doc1, doc2, doc3];
- * const provider = anthropic('claude-sonnet-4');
- *
- * const pipeline = mapReduce({
- *   provider,
- *   mappers: documents.map((doc, i) => ({
- *     id: `doc-${i}`,
- *     description: `Summarize doc ${i}`,
- *     runner: LLMCall.create({ provider })
- *       .system(`Summarize this document:\n\n${doc}`)
- *       .build(),
- *   })),
- *   reduce: { mode: 'llm', prompt: 'Combine the summaries into a single report.' },
- * });
- *
- * const result = await pipeline.run('Produce the report');
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapReduce = void 0;
-const Parallel_1 = require("../concepts/Parallel");
-/**
- * Build a map-reduce pipeline. Returns a `ParallelRunner` — plug it into
- * `FlowChart`, `Conditional`, or `Agent.route()` like any other runner.
- */
-function mapReduce(options) {
-    if (options.mappers.length < 2) {
-        throw new Error('mapReduce requires at least 2 mappers. Use a single runner directly if you only have one.');
-    }
-    const builder = Parallel_1.Parallel.create({
-        provider: options.provider,
-        name: options.name ?? 'mapReduce',
-    });
-    for (const m of options.mappers) {
-        builder.agent(m.id, m.runner, m.description);
-    }
-    if (options.reduce.mode === 'llm') {
-        builder.mergeWithLLM(options.reduce.prompt);
-    }
-    else {
-        builder.merge(options.reduce.fn);
-    }
-    return builder.build();
-}
-exports.mapReduce = mapReduce;
-//# sourceMappingURL=mapReduce.js.map

package/dist/patterns/mapReduce.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mapReduce.js","sourceRoot":"","sources":["../../src/patterns/mapReduce.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,mDAAwF;AAwBxF;;;GAGG;AACH,SAAgB,SAAS,CAAC,OAAyB;IACjD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,mBAAQ,CAAC,MAAM,CAAC;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW;KAClC,CAAC,CAAC;IACH,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAnBD,8BAmBC"}

package/dist/patterns/planExecute.js

@@ -1,47 +0,0 @@
-"use strict";
-/**
- * planExecute — Planner → Executor composition.
- *
- * Two runners chained sequentially: the planner takes the user request and
- * produces a plan; the executor takes that plan (as the planner's output) and
- * carries it out. Pure composition over `FlowChart` — no new primitives,
- * readable as a teaching example.
- *
- * Why: separating planning from execution is often cheaper (small model
- * plans, capable model executes) and safer (plan visible in narrative before
- * any tool fires).
- *
- * @example
- * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import { planExecute } from 'agentfootprint/patterns';
- *
- * const planner = Agent.create({ provider: anthropic('claude-haiku-4-5') })
- *   .system('Produce a numbered plan. Do not execute.')
- *   .build();
- *
- * const executor = Agent.create({ provider: anthropic('claude-sonnet-4') })
- *   .system('Execute the given plan step by step.')
- *   .tools([...])
- *   .build();
- *
- * const runner = planExecute({ planner, executor });
- * const result = await runner.run('Research competitors and draft a brief.');
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.planExecute = void 0;
-const FlowChart_1 = require("../concepts/FlowChart");
-/**
- * Build a planner → executor pipeline. Returns a `FlowChartRunner` — plug it
- * into `Parallel`, `FlowChart`, `Conditional`, or `Agent.route()` like any
- * other runner.
- */
-function planExecute(options) {
-    return FlowChart_1.FlowChart.create()
-        .agent('plan', options.planName ?? 'Plan', options.planner)
-        .agent('execute', options.executeName ?? 'Execute', options.executor)
-        .build();
-}
-exports.planExecute = planExecute;
-//# sourceMappingURL=planExecute.js.map

package/dist/patterns/planExecute.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"planExecute.js","sourceRoot":"","sources":["../../src/patterns/planExecute.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;;AAEH,qDAAwE;AAcxE;;;;GAIG;AACH,SAAgB,WAAW,CAAC,OAA2B;IACrD,OAAO,qBAAS,CAAC,MAAM,EAAE;SACtB,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;SAC1D,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,IAAI,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC;SACpE,KAAK,EAAE,CAAC;AACb,CAAC;AALD,kCAKC"}

package/dist/patterns/reflexion.js

@@ -1,62 +0,0 @@
-"use strict";
-/**
- * reflexion — Solve → Critique → Improve (single-pass).
- *
- * Three runners chained sequentially: a solver produces a draft, a critic
- * reviews it, an improver integrates the critique. Shinn et al. 2023's
- * Reflexion pattern has a quality-gated loop; this is the simplest form —
- * one reflection pass. For multi-iteration Reflexion, wrap this pattern
- * inside `Conditional` to rerun while a quality predicate fails.
- *
- * Why: a single self-review pass catches a surprising number of errors in
- * reasoning / code / plans. Exposing the three runners individually lets
- * users pick cheap models for critic/improver while keeping a strong solver.
- *
- * Under the hood:
- *   FlowChart[ solver, critic, improver ]
- *
- * Each runner receives the previous runner's output as its input message.
- *
- * @example
- * ```ts
- * import { Agent, anthropic } from 'agentfootprint';
- * import { reflexion } from 'agentfootprint/patterns';
- *
- * const provider = anthropic('claude-sonnet-4');
- *
- * const reviewer = reflexion({
- *   solver: Agent.create({ provider }).system('Draft an answer.').build(),
- *   critic: Agent.create({ provider }).system('List weaknesses in the draft.').build(),
- *   improver: Agent.create({ provider })
- *     .system('Apply the critique to improve the draft.')
- *     .build(),
- * });
- *
- * const result = await reviewer.run('Explain monads in plain English.');
- * ```
- *
- * For multi-iteration Reflexion (loop until quality gate passes), compose
- * with `Conditional`:
- * ```ts
- * import { Conditional } from 'agentfootprint';
- * const iterative = Conditional.create()
- *   .when((s) => qualityOf(s) < 0.8, reviewer)
- *   .otherwise(doneRunner)
- *   .build();
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.reflexion = void 0;
-const FlowChart_1 = require("../concepts/FlowChart");
-/**
- * Build a Solve → Critique → Improve pipeline. Returns a `FlowChartRunner`.
- */
-function reflexion(options) {
-    return FlowChart_1.FlowChart.create()
-        .agent('solve', options.solveName ?? 'Solve', options.solver)
-        .agent('critique', options.critiqueName ?? 'Critique', options.critic)
-        .agent('improve', options.improveName ?? 'Improve', options.improver)
-        .build();
-}
-exports.reflexion = reflexion;
-//# sourceMappingURL=reflexion.js.map

package/dist/patterns/reflexion.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reflexion.js","sourceRoot":"","sources":["../../src/patterns/reflexion.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;;;AAEH,qDAAwE;AAgBxE;;GAEG;AACH,SAAgB,SAAS,CAAC,OAAyB;IACjD,OAAO,qBAAS,CAAC,MAAM,EAAE;SACtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;SAC5D,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,IAAI,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC;SACrE,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,IAAI,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC;SACpE,KAAK,EAAE,CAAC;AACb,CAAC;AAND,8BAMC"}

package/dist/patterns/treeOfThoughts.js

@@ -1,75 +0,0 @@
-"use strict";
-/**
- * treeOfThoughts — N parallel thinkers → one judge picks best.
- *
- * Fan out N parallel thinkers (each a runner, typically same prompt + higher
- * temperature variance), format their outputs as context, then hand to a
- * judge runner that picks or synthesizes the best answer.
- *
- * Why: for problems where one-shot answers are often wrong, generating
- * multiple independent attempts and judging them catches errors that a
- * single chain-of-thought would miss. Tree-of-Thoughts (Yao et al. 2023)
- * formalized this pattern.
- *
- * Under the hood:
- *   FlowChart[ Parallel({ t0, t1, ..., tN-1, merge: labelled-concat }),
- *              judge ]
- *
- * The merge step concatenates each thinker's output under its id so the
- * judge sees them as labeled candidates. The judge receives that
- * concatenation as its input string.
- *
- * @example
- * ```ts
- * import { Agent, LLMCall, anthropic } from 'agentfootprint';
- * import { treeOfThoughts } from 'agentfootprint/patterns';
- *
- * const provider = anthropic('claude-sonnet-4');
- *
- * const tot = treeOfThoughts({
- *   provider,
- *   branches: 3,
- *   thinker: (i) =>
- *     LLMCall.create({ provider }).system(`Thinker ${i + 1}: propose a different solution.`).build(),
- *   judge: Agent.create({ provider })
- *     .system('Pick the single best answer and explain why.')
- *     .build(),
- * });
- *
- * const result = await tot.run('What is the fastest sort for nearly-sorted data?');
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.treeOfThoughts = void 0;
-const FlowChart_1 = require("../concepts/FlowChart");
-const Parallel_1 = require("../concepts/Parallel");
-/**
- * Build a Tree-of-Thoughts pipeline. Returns a `FlowChartRunner`.
- *
- * Throws if `branches < 2` — use a single runner directly when you don't need
- * multiple candidates. Throws if `branches > 10` (Parallel's cap).
- */
-function treeOfThoughts(options) {
-    if (options.branches < 2) {
-        throw new Error(`treeOfThoughts requires at least 2 branches (got ${options.branches}). Use a single runner for 1-candidate flows.`);
-    }
-    const parallel = Parallel_1.Parallel.create({
-        provider: options.provider,
-        name: `${options.name ?? 'treeOfThoughts'}:thinkers`,
-    });
-    for (let i = 0; i < options.branches; i++) {
-        parallel.agent(`thinker-${i}`, options.thinker(i), `Thinker ${i + 1}`);
-    }
-    // Merge: label each thought so the judge can reference them by id.
-    // Kept as a pure function so the merge itself uses no LLM call — the judge
-    // is the only decision-maker and should be budgeted as such.
-    parallel.merge((results) => Object.entries(results)
-        .map(([id, r]) => `=== ${id} ===\n${r.content}`)
-        .join('\n\n'));
-    return FlowChart_1.FlowChart.create()
-        .agent('thinkers', 'Think', parallel.build())
-        .agent('judge', 'Judge', options.judge)
-        .build();
-}
-exports.treeOfThoughts = treeOfThoughts;
-//# sourceMappingURL=treeOfThoughts.js.map

package/dist/patterns/treeOfThoughts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"treeOfThoughts.js","sourceRoot":"","sources":["../../src/patterns/treeOfThoughts.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;;AAEH,qDAAwE;AACxE,mDAAmE;AAmBnE;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,OAA8B;IAC3D,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,oDAAoD,OAAO,CAAC,QAAQ,+CAA+C,CACpH,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,mBAAQ,CAAC,MAAM,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,gBAAgB,WAAW;KACrD,CAAC,CAAC;IACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,mEAAmE;IACnE,2EAA2E;IAC3E,6DAA6D;IAC7D,QAAQ,CAAC,KAAK,CAAC,CAAC,OAAqC,EAAE,EAAE,CACvD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;SACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;SAC/C,IAAI,CAAC,MAAM,CAAC,CAChB,CAAC;IAEF,OAAO,qBAAS,CAAC,MAAM,EAAE;SACtB,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;SAC5C,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC;SACtC,KAAK,EAAE,CAAC;AACb,CAAC;AA3BD,wCA2BC"}

package/dist/patterns.barrel.js

@@ -1,24 +0,0 @@
-"use strict";
-/**
- * agentfootprint/patterns — canonical composition patterns.
- *
- * See `src/patterns/index.ts` for the patterns themselves. This file is the
- * subpath barrel used by package.json `exports['./patterns']`.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./patterns/index"), exports);
-//# sourceMappingURL=patterns.barrel.js.map

package/dist/patterns.barrel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"patterns.barrel.js","sourceRoot":"","sources":["../src/patterns.barrel.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,mDAAiC"}

package/dist/providers/index.js

@@ -1,32 +0,0 @@
-"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.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; } });
-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

@@ -1 +0,0 @@
-{"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,uCAOoB;AANlB,uGAAA,WAAW,OAAA;AACX,yGAAA,aAAa,OAAA;AACb,sGAAA,UAAU,OAAA;AACV,8GAAA,kBAAkB,OAAA;AAClB,2GAAA,eAAe,OAAA;AACf,6GAAA,iBAAiB,OAAA;AAGnB,iCAQiB;AAPf,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AACZ,gGAAA,OAAO,OAAA;AACP,oGAAA,WAAW,OAAA;AACX,uGAAA,cAAc,OAAA;AACd,mGAAA,UAAU,OAAA;AACV,yGAAA,gBAAgB,OAAA"}

package/dist/providers/messages/charBudget.js

@@ -1,43 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,37 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,23 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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;YAChC,KAAK,EAAE,OAAO;YACd,MAAM,EAAE,cAAc;YACtB,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,WAAW;SACxC,CAAC;KACH,CAAC;AACJ,CAAC;AARD,kCAQC"}

package/dist/providers/messages/index.js

@@ -1,19 +0,0 @@
-"use strict";
-/**
- * providers/messages/ — Built-in MessageStrategy implementations.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-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; } });
-//# sourceMappingURL=index.js.map

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

@@ -1 +0,0 @@
-{"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"}

package/dist/providers/messages/slidingWindow.js

@@ -1,36 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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;oBACL,KAAK,EAAE,OAAO;oBACd,MAAM,EAAE,gBAAgB;oBACxB,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,0BAA0B;iBACvD,CAAC;YACJ,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;gBACL,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;gBAC3B,MAAM,EAAE,gBAAgB;gBACxB,SAAS,EAAE,QAAQ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,OAAO,OAAO,CAAC,MAAM,EAAE;aACtE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAxBD,sCAwBC"}

package/dist/providers/messages/summaryStrategy.js

@@ -1,57 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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;oBACL,KAAK,EAAE,OAAO;oBACd,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,0BAA0B;iBACvD,CAAC;YACJ,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;oBACL,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;oBAC3B,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,cAAc,GAAG,CAAC,MAAM,+BAA+B;iBACnE,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,EAAE,IAAA,wBAAa,EAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;YAC5D,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,cAAc,GAAG,CAAC,MAAM,cAAc,IAAI,CAAC,MAAM,SAAS;aACtE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AApCD,0CAoCC"}