agentfootprint 1.22.0 → 2.0.1

package/dist/executor/agentLoop.js

@@ -1,158 +0,0 @@
-"use strict";
-/**
- * agentLoop — the core execution engine.
- *
- * Takes an AgentLoopConfig (providers + recorders + options) and executes
- * a single turn of the agent loop:
- *   1. Resolve system prompt (PromptProvider)
- *   2. Prepare messages (MessageStrategy)
- *   3. Call LLM
- *   4. If tool calls → execute tools → loop to step 3
- *   5. If final response → return result
- *
- * Built on footprintjs flowchart (SeedScope → Prompt → LLM → Parse → Handle → loop).
- * All observation happens through AgentRecorders attached to the config.
- *
- * Usage:
- *   const result = await agentLoop(config, 'Hello', { signal, timeoutMs });
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentLoop = void 0;
-const trace_1 = require("footprintjs/trace");
-const messages_1 = require("../types/messages");
-const content_1 = require("../types/content");
-// ── Engine ───────────────────────────────────────────────────
-async function agentLoop(config, message, options = {}) {
-    const { promptProvider, messageStrategy, toolProvider, llmProvider, maxIterations, recorders } = config;
-    const signal = options.signal;
-    const turnNumber = options.turnNumber ?? 0;
-    const history = [...(options.history ?? [])];
-    // Add user message
-    history.push((0, messages_1.userMessage)(message));
-    // Notify recorders: turn start
-    const startEvent = { turnNumber, message };
-    dispatchRecorderEvent(recorders, 'onTurnStart', startEvent);
-    try {
-        // 1. Resolve system prompt
-        const promptCtx = { message, turnNumber, history, signal };
-        const systemPrompt = await promptProvider.resolve(promptCtx);
-        let loopIteration = 0;
-        const executionCounter = (0, trace_1.createExecutionCounter)();
-        let finalContent = '';
-        while (loopIteration < maxIterations) {
-            checkAborted(signal);
-            // 2. Prepare messages
-            const messageCtx = { message, turnNumber, loopIteration, signal };
-            const messageDecision = await messageStrategy.prepare(history, messageCtx);
-            const preparedMessages = messageDecision.value;
-            // 3. Call LLM
-            const toolDecision = await toolProvider.resolve({
-                message,
-                turnNumber,
-                loopIteration,
-                messages: preparedMessages,
-                signal,
-            });
-            const toolDescriptions = toolDecision.value;
-            const llmStart = Date.now();
-            const llmResponse = await llmProvider.chat(preparedMessages, {
-                tools: toolDescriptions.length > 0 ? toolDescriptions : undefined,
-                signal,
-                ...(systemPrompt ? {} : {}),
-            });
-            const llmLatency = Date.now() - llmStart;
-            // Notify recorders: LLM call
-            const llmEvent = {
-                model: undefined,
-                usage: llmResponse.usage,
-                latencyMs: llmLatency,
-                turnNumber,
-                loopIteration,
-                finishReason: llmResponse.finishReason,
-                runtimeStageId: (0, trace_1.buildRuntimeStageId)('call-llm', executionCounter.value++),
-            };
-            dispatchRecorderEvent(recorders, 'onLLMCall', llmEvent);
-            loopIteration++;
-            // Add assistant message to history
-            const assistantContent = (0, content_1.getTextContent)(llmResponse.content);
-            const assistantMsg = (0, messages_1.assistantMessage)(assistantContent, llmResponse.toolCalls);
-            history.push(assistantMsg);
-            // 4. Check for tool calls
-            if ((0, messages_1.hasToolCalls)(assistantMsg) && assistantMsg.toolCalls.length > 0) {
-                // Execute each tool call
-                for (const toolCall of assistantMsg.toolCalls) {
-                    checkAborted(signal);
-                    const toolStart = Date.now();
-                    let toolResult;
-                    if (toolProvider.execute) {
-                        toolResult = await toolProvider.execute(toolCall, signal);
-                    }
-                    else {
-                        toolResult = { content: `No executor for tool: ${toolCall.name}`, error: true };
-                    }
-                    const toolLatency = Date.now() - toolStart;
-                    // Notify recorders: tool call
-                    const toolEvent = {
-                        toolName: toolCall.name,
-                        args: toolCall.arguments,
-                        result: toolResult,
-                        latencyMs: toolLatency,
-                        runtimeStageId: (0, trace_1.buildRuntimeStageId)('execute-tools', executionCounter.value++),
-                    };
-                    dispatchRecorderEvent(recorders, 'onToolCall', toolEvent);
-                    // Add tool result to history
-                    history.push((0, messages_1.toolResultMessage)(toolResult.content, toolCall.id));
-                }
-                // Continue loop — LLM needs to process tool results
-                continue;
-            }
-            // 5. Final response — no tool calls
-            finalContent = assistantContent;
-            break;
-        }
-        // Notify recorders: turn complete
-        const completeEvent = {
-            turnNumber,
-            messageCount: history.length,
-            totalLoopIterations: loopIteration,
-            content: finalContent,
-        };
-        dispatchRecorderEvent(recorders, 'onTurnComplete', completeEvent);
-        return {
-            content: finalContent,
-            messages: history,
-            loopIterations: loopIteration,
-        };
-    }
-    catch (err) {
-        // Notify recorders: error
-        const errorEvent = {
-            phase: 'llm',
-            error: err,
-            turnNumber,
-        };
-        dispatchRecorderEvent(recorders, 'onError', errorEvent);
-        throw err;
-    }
-}
-exports.agentLoop = agentLoop;
-// ── Helpers ──────────────────────────────────────────────────
-function checkAborted(signal) {
-    if (signal?.aborted) {
-        throw signal.reason ?? new Error('Aborted');
-    }
-}
-function dispatchRecorderEvent(recorders, hook, event) {
-    for (const recorder of recorders) {
-        try {
-            const fn = recorder[hook];
-            if (typeof fn === 'function') {
-                fn.call(recorder, event);
-            }
-        }
-        catch {
-            // Error isolation
-        }
-    }
-}
-//# sourceMappingURL=agentLoop.js.map

package/dist/executor/agentLoop.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentLoop.js","sourceRoot":"","sources":["../../src/executor/agentLoop.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,6CAAgF;AAWhF,gDAAmG;AACnG,8CAAkD;AAsBlD,gEAAgE;AAEzD,KAAK,UAAU,SAAS,CAC7B,MAAuB,EACvB,OAAe,EACf,UAA4B,EAAE;IAE9B,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,GAC5F,MAAM,CAAC;IAET,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAc,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IAExD,mBAAmB;IACnB,OAAO,CAAC,IAAI,CAAC,IAAA,sBAAW,EAAC,OAAO,CAAC,CAAC,CAAC;IAEnC,+BAA+B;IAC/B,MAAM,UAAU,GAAmB,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IAC3D,qBAAqB,CAAC,SAAS,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAC3D,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE7D,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,MAAM,gBAAgB,GAAG,IAAA,8BAAsB,GAAE,CAAC;QAClD,IAAI,YAAY,GAAG,EAAE,CAAC;QAEtB,OAAO,aAAa,GAAG,aAAa,EAAE,CAAC;YACrC,YAAY,CAAC,MAAM,CAAC,CAAC;YAErB,sBAAsB;YACtB,MAAM,UAAU,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;YAClE,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAC3E,MAAM,gBAAgB,GAAG,eAAe,CAAC,KAAK,CAAC;YAE/C,cAAc;YACd,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC;gBAC9C,OAAO;gBACP,UAAU;gBACV,aAAa;gBACb,QAAQ,EAAE,gBAAgB;gBAC1B,MAAM;aACP,CAAC,CAAC;YACH,MAAM,gBAAgB,GAAG,YAAY,CAAC,KAAK,CAAC;YAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAC3D,KAAK,EAAE,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;gBACjE,MAAM;gBACN,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5B,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;YAEzC,6BAA6B;YAC7B,MAAM,QAAQ,GAAiB;gBAC7B,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,WAAW,CAAC,KAAK;gBACxB,SAAS,EAAE,UAAU;gBACrB,UAAU;gBACV,aAAa;gBACb,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,cAAc,EAAE,IAAA,2BAAmB,EAAC,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC;aAC1E,CAAC;YACF,qBAAqB,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;YAExD,aAAa,EAAE,CAAC;YAEhB,mCAAmC;YACnC,MAAM,gBAAgB,GAAG,IAAA,wBAAc,EAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC7D,MAAM,YAAY,GAAG,IAAA,2BAAgB,EAAC,gBAAgB,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;YAC/E,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAE3B,0BAA0B;YAC1B,IAAI,IAAA,uBAAY,EAAC,YAAY,CAAC,IAAI,YAAY,CAAC,SAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrE,yBAAyB;gBACzB,KAAK,MAAM,QAAQ,IAAI,YAAY,CAAC,SAAU,EAAE,CAAC;oBAC/C,YAAY,CAAC,MAAM,CAAC,CAAC;oBAErB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,IAAI,UAAU,CAAC;oBAEf,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;wBACzB,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAC5D,CAAC;yBAAM,CAAC;wBACN,UAAU,GAAG,EAAE,OAAO,EAAE,yBAAyB,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;oBAClF,CAAC;oBAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;oBAE3C,8BAA8B;oBAC9B,MAAM,SAAS,GAAkB;wBAC/B,QAAQ,EAAE,QAAQ,CAAC,IAAI;wBACvB,IAAI,EAAE,QAAQ,CAAC,SAAS;wBACxB,MAAM,EAAE,UAAU;wBAClB,SAAS,EAAE,WAAW;wBACtB,cAAc,EAAE,IAAA,2BAAmB,EAAC,eAAe,EAAE,gBAAgB,CAAC,KAAK,EAAE,CAAC;qBAC/E,CAAC;oBACF,qBAAqB,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;oBAE1D,6BAA6B;oBAC7B,OAAO,CAAC,IAAI,CAAC,IAAA,4BAAiB,EAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;gBACnE,CAAC;gBAED,oDAAoD;gBACpD,SAAS;YACX,CAAC;YAED,oCAAoC;YACpC,YAAY,GAAG,gBAAgB,CAAC;YAChC,MAAM;QACR,CAAC;QAED,kCAAkC;QAClC,MAAM,aAAa,GAAsB;YACvC,UAAU;YACV,YAAY,EAAE,OAAO,CAAC,MAAM;YAC5B,mBAAmB,EAAE,aAAa;YAClC,OAAO,EAAE,YAAY;SACtB,CAAC;QACF,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;QAElE,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,QAAQ,EAAE,OAAO;YACjB,cAAc,EAAE,aAAa;SAC9B,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,0BAA0B;QAC1B,MAAM,UAAU,GAAoB;YAClC,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,GAAG;YACV,UAAU;SACX,CAAC;QACF,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAzID,8BAyIC;AAED,gEAAgE;AAEhE,SAAS,YAAY,CAAC,MAAoB;IACxC,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAC5B,SAA0B,EAC1B,IAAyB,EACzB,KAAc;IAEd,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;gBAC5B,EAA2B,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/executor/index.js

@@ -1,9 +0,0 @@
-"use strict";
-/**
- * executor/ — The agentLoop execution engine.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.agentLoop = void 0;
-var agentLoop_1 = require("./agentLoop");
-Object.defineProperty(exports, "agentLoop", { enumerable: true, get: function () { return agentLoop_1.agentLoop; } });
-//# sourceMappingURL=index.js.map

package/dist/executor/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/executor/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAAwC;AAA/B,sGAAA,SAAS,OAAA"}

package/dist/explain.barrel.js

@@ -1,29 +0,0 @@
-"use strict";
-/**
- * agentfootprint/explain — Understand agent decisions.
- *
- * ExplainRecorder collects grounding data during traversal — sources (tool results),
- * claims (LLM outputs), and decisions (tool calls). No post-processing.
- *
- * @example
- * ```typescript
- * import { ExplainRecorder } from 'agentfootprint/explain';
- *
- * const explain = new ExplainRecorder();
- * agent.recorder(explain);
- * await agent.run('Check order');
- *
- * const report = explain.explain();
- * console.log(report.sources);   // what tools returned
- * console.log(report.claims);    // what the LLM said
- * console.log(report.decisions); // what the LLM chose to do
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExplainRecorder = exports.createAgentRenderer = void 0;
-var narrative_1 = require("./lib/narrative");
-Object.defineProperty(exports, "createAgentRenderer", { enumerable: true, get: function () { return narrative_1.createAgentRenderer; } });
-// ExplainRecorder — collect grounding data during traversal (no post-processing)
-var ExplainRecorder_1 = require("./recorders/ExplainRecorder");
-Object.defineProperty(exports, "ExplainRecorder", { enumerable: true, get: function () { return ExplainRecorder_1.ExplainRecorder; } });
-//# sourceMappingURL=explain.barrel.js.map

package/dist/explain.barrel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"explain.barrel.js","sourceRoot":"","sources":["../src/explain.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,6CAAsD;AAA7C,gHAAA,mBAAmB,OAAA;AAG5B,iFAAiF;AACjF,+DAA8D;AAArD,kHAAA,eAAe,OAAA"}

package/dist/exportTrace.js

@@ -1,75 +0,0 @@
-"use strict";
-/**
- * exportTrace — capture an agent run's full state into a portable JSON
- * blob for sharing externally (paste into a viewer, ship to support, log
- * for debugging, store in a database).
- *
- * Defaults to **redacted** output: snapshots come from
- * `getSnapshot({ redact: true })` (footprintjs 4.14+), so values for keys
- * listed in `RedactionPolicy.keys` / matching `patterns` arrive as
- * `'REDACTED'` instead of raw. The commit log is already redacted at
- * write-time. Combined with `emitPatterns` (also redacted at origin), the
- * exported trace is safe to share when the caller has configured a policy.
- *
- * **Without a redaction policy, this helper still emits a trace — but
- * `sharedState` will contain raw values.** Configure `setRedactionPolicy`
- * before calling this for any externally shared trace.
- *
- * @example
- * ```ts
- * import { Agent, exportTrace, anthropic } from 'agentfootprint';
- *
- * const agent = Agent.create({ provider: anthropic('claude-sonnet-4') })
- *   .system('You are a customer support agent.')
- *   .build();
- *
- * await agent.run('My credit card 4242-4242-4242-4242 was declined');
- *
- * // Configure policy on the underlying executor for full safety
- * // (concept-level recorder API for this is a follow-up).
- * const trace = exportTrace(agent);
- * console.log(JSON.stringify(trace, null, 2));
- * // → paste into the playground viewer, send to support, etc.
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.exportTrace = void 0;
-/**
- * Capture a full execution trace from any runner exposing the standard
- * introspection surface (`getSnapshot`, `getNarrative*`, `getSpec`).
- * All of those methods are optional — missing methods skip the field.
- *
- * Always returns a JSON-stringify-safe object.
- */
-function exportTrace(runner, options) {
-    const redact = options?.redact !== false; // default true
-    const r = runner;
-    // `getSnapshot` may be the older 0-arg form — still safe to call with
-    // an arg (JS ignores extras), but keep our intent explicit so older
-    // overloads with strict signatures don't trip the type checker.
-    let snapshot;
-    try {
-        snapshot = r.getSnapshot?.({ redact });
-    }
-    catch {
-        // Fall back to the 0-arg form if the runner's signature rejects the
-        // options object (older custom runners). Result will be raw — caller
-        // is responsible for the safety implication when this happens.
-        try {
-            snapshot = r.getSnapshot?.();
-        }
-        catch {
-            snapshot = undefined;
-        }
-    }
-    return {
-        schemaVersion: 1,
-        exportedAt: new Date().toISOString(),
-        redacted: redact,
-        snapshot,
-        narrativeEntries: r.getNarrativeEntries?.(),
-        spec: r.getSpec?.(),
-    };
-}
-exports.exportTrace = exportTrace;
-//# sourceMappingURL=exportTrace.js.map

package/dist/exportTrace.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"exportTrace.js","sourceRoot":"","sources":["../src/exportTrace.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;;;AA0DH;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,MAAkB,EAAE,OAA4B;IAC1E,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,eAAe;IACzD,MAAM,CAAC,GAAG,MAA0B,CAAC;IAErC,sEAAsE;IACtE,oEAAoE;IACpE,gEAAgE;IAChE,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,qEAAqE;QACrE,+DAA+D;QAC/D,IAAI,CAAC;YACH,QAAQ,GAAI,CAAC,CAAC,WAA2C,EAAE,EAAE,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,SAAS,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,QAAQ,EAAE,MAAM;QAChB,QAAQ;QACR,gBAAgB,EAAE,CAAC,CAAC,mBAAmB,EAAE,EAAE;QAC3C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE;KACpB,CAAC;AACJ,CAAC;AA7BD,kCA6BC"}

package/dist/instructions.barrel.js

@@ -1,30 +0,0 @@
-"use strict";
-/**
- * agentfootprint/instructions — Make agents smart with conditional context injection.
- *
- * Define rules that inject into system prompt, tools, and tool-result recency window
- * based on accumulated Decision Scope state.
- *
- * @example
- * ```typescript
- * import { defineInstruction, AgentPattern } from 'agentfootprint/instructions';
- *
- * const refund = defineInstruction({
- *   id: 'refund-handling',
- *   activeWhen: (d) => d.orderStatus === 'denied',
- *   prompt: 'Be empathetic.',
- *   tools: [processRefund],
- * });
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InstructionRecorder = exports.AgentPattern = exports.quickBind = exports.follow = exports.defineInstruction = void 0;
-var instructions_1 = require("./lib/instructions");
-Object.defineProperty(exports, "defineInstruction", { enumerable: true, get: function () { return instructions_1.defineInstruction; } });
-Object.defineProperty(exports, "follow", { enumerable: true, get: function () { return instructions_1.follow; } });
-Object.defineProperty(exports, "quickBind", { enumerable: true, get: function () { return instructions_1.quickBind; } });
-var loop_1 = require("./lib/loop");
-Object.defineProperty(exports, "AgentPattern", { enumerable: true, get: function () { return loop_1.AgentPattern; } });
-var instructions_2 = require("./lib/instructions");
-Object.defineProperty(exports, "InstructionRecorder", { enumerable: true, get: function () { return instructions_2.InstructionRecorder; } });
-//# sourceMappingURL=instructions.barrel.js.map

package/dist/instructions.barrel.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"instructions.barrel.js","sourceRoot":"","sources":["../src/instructions.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,mDAA0E;AAAjE,iHAAA,iBAAiB,OAAA;AAAE,sGAAA,MAAM,OAAA;AAAE,yGAAA,SAAS,OAAA;AAS7C,mCAA0C;AAAjC,oGAAA,YAAY,OAAA;AACrB,mDAAyD;AAAhD,mHAAA,mBAAmB,OAAA"}

package/dist/lib/call/callLLMStage.js

@@ -1,104 +0,0 @@
-"use strict";
-/**
- * CallLLM stage — sends messages + tools to the LLM provider.
- *
- * Reads from scope:
- *   - messages (set by Messages slot or prior stages)
- *   - toolDescriptions (set by Tools slot)
- *
- * Writes to scope:
- *   - adapterResult (discriminated union: 'final' | 'tools' | 'error')
- *   - adapterRawResponse (raw LLM response for recorders)
- *   - llmCall (narrative summary of the LLM call)
- *
- * Emits on the footprintjs emit channel:
- *   - `agentfootprint.llm.request` — outgoing LLM shape (messages/tools/etc.)
- *   - `agentfootprint.llm.response` — raw adapter response
- *   - `agentfootprint.stream.llm_start`  (full AgentStreamEvent as payload)
- *   - `agentfootprint.stream.llm_end`    (full AgentStreamEvent as payload)
- *
- * Stream events route via emit so there's zero closure capture of
- * per-run callbacks. `AgentRunner` attaches a `StreamEventRecorder`
- * that translates these emits to the caller's `{ onEvent }` callback.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCallLLMStage = void 0;
-const streaming_1 = require("../../streaming");
-const helpers_1 = require("./helpers");
-/**
- * Create the CallLLM stage function.
- */
-function createCallLLMStage(provider, options) {
-    if (!provider) {
-        throw new Error('createCallLLMStage: provider is required');
-    }
-    const responseFormat = options?.responseFormat;
-    return async (scope) => {
-        const messages = scope.messages ?? [];
-        const tools = scope.toolDescriptions ?? [];
-        const signal = scope.$getEnv()?.signal;
-        const iteration = (scope.loopCount ?? 0) + 1;
-        const startMs = Date.now();
-        scope.$emit(`${streaming_1.STREAM_EMIT_PREFIX}llm_start`, { type: 'llm_start', iteration });
-        // ── Emit: request-side ─────────────────────────────────────────────
-        scope.$emit('agentfootprint.llm.request', {
-            iteration,
-            messageCount: messages.length,
-            messageRoles: messages.map((m) => m.role),
-            toolCount: tools.length,
-            toolNames: tools.map((t) => t.name),
-            toolsWithRequired: tools.map((t) => ({
-                name: t.name,
-                description: t.description,
-                required: t.inputSchema?.required ?? [],
-            })),
-            hasResponseFormat: !!responseFormat,
-        });
-        const callOpts = {
-            ...(tools.length > 0 ? { tools } : {}),
-            ...(signal ? { signal } : {}),
-            ...(responseFormat ? { responseFormat } : {}),
-        };
-        const response = await provider.chat(messages, Object.keys(callOpts).length > 0 ? callOpts : undefined);
-        // Write raw response for recorders to observe
-        scope.adapterRawResponse = response;
-        // Normalize to AdapterResult
-        scope.adapterResult = (0, helpers_1.normalizeAdapterResponse)(response);
-        // Write summary for narrative visibility
-        const model = response.model ?? 'unknown';
-        const usage = response.usage;
-        const usageSummary = usage
-            ? `${usage.inputTokens ?? '?'}in / ${usage.outputTokens ?? '?'}out`
-            : 'no usage data';
-        scope.llmCall = `${model} (${usageSummary})`;
-        const latencyMs = Date.now() - startMs;
-        // ── Emit: response-side ─────────────────────────────────────────────
-        scope.$emit('agentfootprint.llm.response', {
-            iteration,
-            model: response.model,
-            stopReason: response.finishReason,
-            usage: response.usage,
-            content: response.content,
-            toolCalls: (response.toolCalls ?? []).map((tc) => ({
-                name: tc.name,
-                arguments: tc.arguments,
-            })),
-            latencyMs,
-        });
-        scope.$emit(`${streaming_1.STREAM_EMIT_PREFIX}llm_end`, {
-            type: 'llm_end',
-            iteration,
-            toolCallCount: response.toolCalls?.length ?? 0,
-            content: response.content,
-            model: response.model,
-            latencyMs,
-            // Forward usage + stopReason so downstream consumers (Lens,
-            // token counters, billing) don't have to subscribe to the
-            // richer `agentfootprint.llm.response` event just to get tokens.
-            usage: response.usage,
-            stopReason: response.finishReason,
-        });
-    };
-}
-exports.createCallLLMStage = createCallLLMStage;
-//# sourceMappingURL=callLLMStage.js.map

package/dist/lib/call/callLLMStage.js.map

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