agentfootprint 1.23.0 → 2.1.0

package/dist/esm/lib/loop/index.js

@@ -1,3 +0,0 @@
-export { buildAgentLoop, SUBFLOW_MESSAGE_KEY } from './buildAgentLoop';
-export { AgentPattern } from './types';
-//# sourceMappingURL=index.js.map

package/dist/esm/lib/loop/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/loop/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/esm/lib/loop/types.js

@@ -1,71 +0,0 @@
-/**
- * Loop assembler types.
- *
- * The loop assembler wires the three API slots + call stages into a
- * looping flowchart: SystemPrompt → Messages → Tools → CallLLM →
- * ParseResponse → RouteResponse(decider) → {tool-calls | final}
- * → loopTo('call-llm').
- */
-/**
- * Agent loop patterns — determines which stages re-evaluate between iterations.
- *
- * The pattern controls WHERE the loop jumps back to after tool execution:
- * - `Regular`: loops to CallLLM — slots resolve once before the loop
- * - `Dynamic`: loops to SystemPrompt — all three API slots re-evaluate each iteration
- *
- * @example
- * ```typescript
- * import { Agent, AgentPattern } from 'agentfootprint';
- *
- * // Standard ReAct — fixed prompt, tools, memory (default)
- * Agent.create({ provider }).build();
- *
- * // Dynamic ReAct — re-evaluate all slots each iteration
- * Agent.create({ provider })
- *   .pattern(AgentPattern.Dynamic)
- *   .build();
- * ```
- *
- * @example
- * ```typescript
- * // Dynamic ReAct use case: progressive tool authorization
- * // Turn 1: agent calls verify_identity → user is admin
- * // Turn 2: Tools subflow re-evaluates → admin tools now available
- * // Turn 3: agent can use admin tools that were hidden before
- * ```
- */
-export var AgentPattern;
-(function (AgentPattern) {
-    /**
-     * Standard ReAct loop — loops back to CallLLM.
-     *
-     * SystemPrompt, Messages, and Tools subflows resolve ONCE before the loop starts.
-     * Each iteration only re-runs: CallLLM → ParseResponse → RouteResponse → tools.
-     * Best for: most agent use cases with fixed prompt/tools/memory.
-     *
-     * ```
-     * [SystemPrompt] → [Messages] → [Tools] → AssemblePrompt
-     *   → CallLLM → Parse → Route → ExecuteTools → loopTo(CallLLM)
-     *         ↑                                         |
-     *         └─────────────────────────────────────────┘
-     * ```
-     */
-    AgentPattern["Regular"] = "regular";
-    /**
-     * Dynamic ReAct loop — loops back to SystemPrompt.
-     *
-     * All three API slots (SystemPrompt, Messages, Tools) re-evaluate each iteration.
-     * Strategies receive updated context (messages now include tool results, loopCount
-     * incremented) and can return different prompt/tools/memory based on what happened.
-     * Best for: progressive authorization, adaptive prompts, context-dependent tool sets.
-     *
-     * ```
-     * [SystemPrompt] → [Messages] → [Tools] → AssemblePrompt
-     *   → CallLLM → Parse → Route → ExecuteTools → loopTo(SystemPrompt)
-     *  ↑                                                  |
-     *  └──────────────────────────────────────────────────┘
-     * ```
-     */
-    AgentPattern["Dynamic"] = "dynamic";
-})(AgentPattern || (AgentPattern = {}));
-//# sourceMappingURL=types.js.map

package/dist/esm/lib/loop/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/loop/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4FH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAN,IAAY,YAiCX;AAjCD,WAAY,YAAY;IACtB;;;;;;;;;;;;;OAaG;IACH,mCAAmB,CAAA;IAEnB;;;;;;;;;;;;;;OAcG;IACH,mCAAmB,CAAA;AACrB,CAAC,EAjCW,YAAY,KAAZ,YAAY,QAiCvB"}

package/dist/esm/lib/narrative/agentRenderer.js

@@ -1,364 +0,0 @@
-/**
- * Agent NarrativeFormatter — LLM-optimized narrative for agent loop execution.
- *
- * Designed for LLM follow-up reasoning: the narrative answers "what happened?"
- * so a downstream LLM can ask informed questions about the agent's execution.
- *
- * Key design decisions:
- *   1. Enrichment keys (llmCall, responseType, resolvedTools, promptSummary)
- *      are promoted — their values ARE the narrative, shown directly.
- *   2. Internal keys (memory_*, loopCount, adapter internals) are suppressed.
- *   3. Core keys (messages, result) get smart formatting with counts/previews.
- *   4. Most reads are suppressed — writes tell the story, reads are noise.
- *      Exception: `parsedResponse` reads are shown in tool execution (tool names + args).
- *   5. Stage headers use agent terminology, not generic "The process began."
- *   6. Subflow boundaries use slot names: "Preparing system prompt."
- *   7. Loop/break use agent language: "Tool loop iteration N", "Agent completed."
- *
- * The entry types (stage, step, subflow, loop, break, error, condition, fork,
- * selector) and stageId/subflowId fields are preserved by the recorder — the
- * renderer only controls the text. Time-travel UI sync is unaffected.
- */
-// ── Stage name → agent-specific label ────────────────────────────────────────
-const STAGE_LABELS = {
-    Seed: 'Initialized agent state',
-    ResolvePrompt: 'Resolved system prompt',
-    LoadHistory: 'Loaded conversation history',
-    ApplyStrategy: 'Applied message strategy',
-    TrackPrepared: 'Tracked prepared messages',
-    ResolveTools: 'Resolved available tools',
-    AssemblePrompt: 'Assembled final prompt',
-    CallLLM: 'Called LLM',
-    ParseResponse: 'Parsed LLM response',
-    ExecuteToolCalls: 'Executed tool calls',
-    HandleResponse: 'Processed response',
-    CommitMemory: 'Committed conversation history',
-    // Swarm-specific stages
-    RouteSpecialist: 'Route to specialist',
-    ExecuteExtraTool: 'Executed extra tool',
-    Finalize: 'Extract final answer and stop the loop',
-};
-// ── Subflow name → agent-specific entry label ────────────────────────────────
-const SUBFLOW_ENTRY_LABELS = {
-    SystemPrompt: 'Preparing system prompt',
-    Messages: 'Preparing conversation history',
-    Tools: 'Resolving available tools',
-    PrepareMemory: 'Preparing memory',
-    ExecuteTools: 'Executing tool calls',
-};
-// ── Promoted keys: pre-formatted enrichment summaries ────────────────────────
-const PROMOTED_LABELS = {
-    llmCall: 'LLM',
-    responseType: 'Response',
-    resolvedTools: 'Tools',
-    promptSummary: 'Prompt',
-    // SlotDecision labels — shown when non-static (dynamic providers explain their choice)
-    promptDecision: 'Chose',
-    toolDecision: 'Chose',
-    specialistResult: 'Specialist returned',
-};
-// ── Suppressed keys: true internals that add noise, not insight ──────────────
-//
-// Design principle: suppress ONLY implementation plumbing. If an LLM reading
-// this trace would need the value to answer a follow-up question, don't suppress.
-const SUPPRESSED_KEYS = new Set([
-    // Loop control (the loop entry itself shows iteration count)
-    'loopCount',
-    'maxIterations',
-    'updatedLoopCount',
-    // Memory internals (memory subflow stages already narrate this)
-    'memory_preparedMessages',
-    // adapterResult is redundant with parsedResponse
-    'adapterResult',
-    // adapterRawResponse is now shown — contains LLM reasoning + token usage
-    // Swarm internals (the decision is shown by RouteSpecialist, not these keys)
-    'specialistMessage',
-    'specialistToolCallId',
-    // Subflow intermediate state
-    'currentMessages',
-    // Enrichment summaries (avoid double-reporting — the promoted labels above show these)
-    'llmCall',
-    'responseType',
-    'resolvedTools',
-    'promptSummary',
-]);
-const DEFAULT_LIMITS = {
-    result: 100,
-    systemPrompt: 200,
-    parsedContent: 100,
-    // Tool results can contain diagnostic fields the library injects for
-    // debuggers — `expectedSchema`, `receivedArguments`, `escalation`,
-    // `repeatedFailures`. Truncating at 80 hides those after the opening
-    // `{"error":true,"message":"..."}` prefix, making it look like the LLM
-    // is being fed a bare error when in fact it has all the context it needs
-    // to self-correct. Bump to 400 so the fields are visible in BTS. Consumers
-    // who want the raw content use `verbose: true` (Infinity).
-    toolResult: 400,
-    toolArgs: 60,
-    message: 100,
-};
-const VERBOSE_LIMITS = {
-    result: Infinity,
-    systemPrompt: Infinity,
-    parsedContent: Infinity,
-    toolResult: Infinity,
-    toolArgs: Infinity,
-    message: Infinity,
-};
-function truncate(value, max) {
-    if (max === Infinity || value.length <= max)
-        return value;
-    return value.slice(0, max) + '...';
-}
-// ── Helpers ──────────────────────────────────────────────────────────────────
-function formatMessages(rawValue) {
-    if (!Array.isArray(rawValue))
-        return 'Messages: (empty)';
-    const messages = rawValue;
-    const count = messages.length;
-    if (count === 0)
-        return 'Messages: (empty)';
-    const roles = new Map();
-    for (const m of messages) {
-        const role = m.role ?? 'unknown';
-        roles.set(role, (roles.get(role) ?? 0) + 1);
-    }
-    const breakdown = [...roles.entries()].map(([r, n]) => `${n} ${r}`).join(', ');
-    return `Messages: ${count} (${breakdown})`;
-}
-function formatResult(rawValue, limits) {
-    if (typeof rawValue !== 'string')
-        return 'Result: (non-string)';
-    if (rawValue.length === 0)
-        return 'Result: (empty)';
-    return `Result: "${truncate(rawValue, limits.result)}"`;
-}
-function formatSystemPrompt(rawValue, limits) {
-    if (typeof rawValue !== 'string' || rawValue.length === 0)
-        return 'System prompt: (none)';
-    return `System prompt: "${truncate(rawValue, limits.systemPrompt)}"`;
-}
-function formatToolDescriptions(rawValue) {
-    if (!Array.isArray(rawValue) || rawValue.length === 0)
-        return 'Tools: (none)';
-    const names = rawValue.map((t) => t.name ?? '?').join(', ');
-    return `Tools: [${names}]`;
-}
-/**
- * Format a single tool call as `name({...})` — always including the paren
- * group so that empty arguments render as `name({})` rather than `name`.
- *
- * This matters for debugging: when the LLM calls a tool with missing
- * required fields, the bug signal is precisely that `arguments` is `{}`
- * (or contains the wrong keys). Hiding that behind a bare `name` used to
- * make every failing-loop narrative look like a healthy one — you couldn't
- * tell that the args were empty until you dug into the raw snapshot.
- */
-function formatToolCallSignature(tc, limits) {
-    const name = tc.name ?? '?';
-    const args = tc.arguments ?? {};
-    const argsStr = JSON.stringify(args);
-    return `${name}(${truncate(argsStr, limits.toolArgs)})`;
-}
-function formatParsedResponse(rawValue, limits) {
-    if (!rawValue || typeof rawValue !== 'object')
-        return 'Parsed: (unknown)';
-    const r = rawValue;
-    if (r.hasToolCalls && Array.isArray(r.toolCalls)) {
-        const toolSummaries = r.toolCalls.map((tc) => formatToolCallSignature(tc, limits));
-        return `Parsed: tool_calls → [${toolSummaries.join(', ')}]`;
-    }
-    if (typeof r.content === 'string') {
-        return `Parsed: final → "${truncate(r.content, limits.parsedContent)}"`;
-    }
-    return 'Parsed: (unknown)';
-}
-function formatToolResultMessages(rawValue, limits) {
-    if (!Array.isArray(rawValue) || rawValue.length === 0)
-        return 'Tool results: (none)';
-    const results = rawValue;
-    const summaries = results.map((msg) => {
-        const content = typeof msg.content === 'string' ? msg.content : '';
-        return `"${truncate(content, limits.toolResult)}"`;
-    });
-    return `Tool results: ${summaries.join('; ')}`;
-}
-function formatAdapterRawResponse(rawValue, limits) {
-    if (!rawValue || typeof rawValue !== 'object')
-        return 'LLM response: (unknown)';
-    const r = rawValue;
-    const parts = [];
-    // Model + tokens
-    if (r.model || r.usage) {
-        const model = r.model ?? 'unknown';
-        const usage = r.usage
-            ? `${r.usage.inputTokens ?? '?'}in / ${r.usage.outputTokens ?? '?'}out`
-            : '';
-        parts.push(`LLM: ${model}${usage ? ` (${usage})` : ''}`);
-    }
-    // LLM reasoning text (the key insight — why it chose to call tools)
-    if (r.content && r.content.length > 0) {
-        parts.push(`Reasoning: "${truncate(r.content, limits.parsedContent)}"`);
-    }
-    // Tool calls summary — include arguments so the reader can see at a glance
-    // whether the LLM actually passed required fields. Previously this showed
-    // only names, which hid the common failure mode where the LLM retries the
-    // same call with empty / wrong arguments.
-    if (r.toolCalls && r.toolCalls.length > 0) {
-        const signatures = r.toolCalls.map((tc) => formatToolCallSignature(tc, limits)).join(', ');
-        parts.push(`→ tool_calls: [${signatures}]`);
-    }
-    return parts.join('\n  ');
-}
-// ── Renderer factory ─────────────────────────────────────────────────────────
-/**
- * Create an agent-optimized narrative formatter.
- *
- * Returns the `NarrativeRenderer` type (structurally identical to
- * footprintjs's new `NarrativeFormatter`). Once a newer footprintjs
- * release is consumed here, migrate the return type to
- * `NarrativeFormatter` — no behavioural change.
- *
- * Usage:
- * ```typescript
- * import { createAgentRenderer } from 'agentfootprint';
- *
- * executor.enableNarrative({ renderer: createAgentRenderer() });
- * ```
- *
- * Or with the narrative() factory:
- * ```typescript
- * import { narrative } from 'footprintjs/recorders';
- * import { createAgentRenderer } from 'agentfootprint';
- *
- * const rec = narrative({ renderer: createAgentRenderer() });
- * ```
- */
-export function createAgentRenderer(options) {
-    const limits = options?.verbose ? VERBOSE_LIMITS : DEFAULT_LIMITS;
-    return {
-        renderStage(ctx) {
-            const label = STAGE_LABELS[ctx.stageName];
-            if (label)
-                return `[${ctx.stageName}] ${label}`;
-            // Unknown stage — use description if available
-            if (ctx.description)
-                return `[${ctx.stageName}] ${ctx.description}`;
-            return `[${ctx.stageName}]`;
-        },
-        renderOp(ctx) {
-            const { key, type, rawValue, operation } = ctx;
-            // Suppress all reads — writes tell the story.
-            // parsedResponse is already shown at the ParseResponse write stage.
-            if (type === 'read')
-                return null;
-            // Suppress internal keys
-            if (SUPPRESSED_KEYS.has(key))
-                return null;
-            // Promoted keys: their value IS the narrative
-            if (PROMOTED_LABELS[key]) {
-                // Suppress when value is undefined/null (e.g., static providers don't set decision keys)
-                if (rawValue == null)
-                    return null;
-                return `${PROMOTED_LABELS[key]}: ${String(rawValue)}`;
-            }
-            // Delete operation
-            if (operation === 'delete')
-                return `Cleared ${key}`;
-            // ── Key-specific formatters (actual values for LLM context) ──
-            if (key === 'messages')
-                return formatMessages(rawValue);
-            if (key === 'result')
-                return formatResult(rawValue, limits);
-            if (key === 'systemPrompt')
-                return formatSystemPrompt(rawValue, limits);
-            if (key === 'toolDescriptions')
-                return formatToolDescriptions(rawValue);
-            if (key === 'parsedResponse')
-                return formatParsedResponse(rawValue, limits);
-            if (key === 'toolResultMessages')
-                return formatToolResultMessages(rawValue, limits);
-            if (key === 'adapterRawResponse')
-                return formatAdapterRawResponse(rawValue, limits);
-            // message (singular): user input in subflow mode
-            if (key === 'message' && typeof rawValue === 'string') {
-                return `User: "${truncate(rawValue, limits.message)}"`;
-            }
-            // Default: simple write summary
-            return `${operation === 'update' ? 'Updated' : 'Set'} ${key} = ${ctx.valueSummary}`;
-        },
-        renderSubflow(ctx) {
-            if (ctx.direction === 'exit')
-                return `Done: ${ctx.name}`;
-            return SUBFLOW_ENTRY_LABELS[ctx.name] ?? `Entering ${ctx.name}`;
-        },
-        renderLoop(ctx) {
-            return `Tool loop iteration ${ctx.iteration}: re-calling LLM`;
-        },
-        renderBreak(ctx) {
-            return `Agent completed at ${ctx.stageName}`;
-        },
-        renderError(ctx) {
-            let text = `Error at ${ctx.stageName}: ${ctx.message}`;
-            if (ctx.validationIssues)
-                text += ` (${ctx.validationIssues})`;
-            return text;
-        },
-        renderDecision(ctx) {
-            // Keep it concise — the stage header already has the description.
-            // Only add rationale if it differs from the description.
-            if (ctx.rationale && ctx.rationale !== ctx.description) {
-                return `Chose ${ctx.chosen} (${ctx.rationale})`;
-            }
-            return `Chose ${ctx.chosen}`;
-        },
-        renderFork(ctx) {
-            return `Parallel: ${ctx.children.join(', ')}`;
-        },
-        renderSelected(ctx) {
-            return `Selected ${ctx.selected.length}/${ctx.total}: ${ctx.selected.join(', ')}`;
-        },
-        /**
-         * Custom render for agentfootprint's emit-channel events. Recognizes the
-         * adapter-level request/response events and produces compact, diagnostic
-         * narrative lines that surface the exact shape of what the adapter sent
-         * and received — the key visibility for debugging LLM behavior like
-         * "why is the model calling with empty args?".
-         *
-         * Returns `undefined` for unrecognized event names so the default
-         * library template handles them.
-         */
-        renderEmit(ctx) {
-            if (ctx.name === 'agentfootprint.llm.request') {
-                const p = ctx.payload;
-                const toolsDetail = p.toolsWithRequired
-                    .map((t) => {
-                    const req = t.required.length ? ` required:[${t.required.join(',')}]` : '';
-                    return `${t.name}${req}`;
-                })
-                    .join(', ');
-                return (`LLM request (iter ${p.iteration}): ${p.messageCount} msgs [${p.messageRoles.join(',')}], ` + `${p.toolCount} tools — ${toolsDetail}`);
-            }
-            if (ctx.name === 'agentfootprint.llm.response') {
-                const p = ctx.payload;
-                const usage = p.usage
-                    ? `${p.usage.inputTokens ?? '?'}in/${p.usage.outputTokens ?? '?'}out`
-                    : '';
-                const stop = p.stopReason ? ` stop=${p.stopReason}` : '';
-                const toolCallsDetail = p.toolCalls.length
-                    ? ` calls=[${p.toolCalls
-                        .map((tc) => `${tc.name}(${JSON.stringify(tc.arguments)})`)
-                        .join(', ')}]`
-                    : '';
-                const contentPreview = p.content && p.content.length > 0
-                    ? ` content="${p.content.length > 60 ? p.content.slice(0, 57) + '...' : p.content}"`
-                    : '';
-                return (`LLM response (iter ${p.iteration}, ${p.latencyMs}ms, ${usage}${stop}):` +
-                    `${contentPreview}${toolCallsDetail}`);
-            }
-            // Unrecognized event — fall back to default library template.
-            return undefined;
-        },
-    };
-}
-//# sourceMappingURL=agentRenderer.js.map

package/dist/esm/lib/narrative/agentRenderer.js.map

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

package/dist/esm/lib/narrative/index.js

@@ -1,2 +0,0 @@
-export { createAgentRenderer } from './agentRenderer.js';
-//# sourceMappingURL=index.js.map

package/dist/esm/lib/narrative/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/narrative/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/lib/skills/defineSkill.js

@@ -1,13 +0,0 @@
-export function defineSkill(skill) {
-    // Dev-mode: warn on empty description (panel #3: descriptions ≤200 chars
-    // are load-bearing for classification; empty strings are almost certainly
-    // a bug).
-    if (typeof process !== 'undefined' &&
-        process.env?.['NODE_ENV'] !== 'production' &&
-        skill.description.trim().length === 0) {
-        // eslint-disable-next-line no-console
-        console.warn(`[agentfootprint] defineSkill('${skill.id}'): empty description — the model classifies skills by description, an empty one will never be picked.`);
-    }
-    return skill;
-}
-//# sourceMappingURL=defineSkill.js.map

package/dist/esm/lib/skills/defineSkill.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"defineSkill.js","sourceRoot":"","sources":["../../../../src/lib/skills/defineSkill.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,WAAW,CAAsB,KAAuB;IACtE,yEAAyE;IACzE,0EAA0E;IAC1E,UAAU;IACV,IACE,OAAO,OAAO,KAAK,WAAW;QAC9B,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,YAAY;QAC1C,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EACrC,CAAC;QACD,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,iCAAiC,KAAK,CAAC,EAAE,wGAAwG,CAClJ,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/lib/skills/index.js

@@ -1,5 +0,0 @@
-export { defineSkill } from './defineSkill';
-export { SkillRegistry } from './registry';
-export { renderSkillBody, resolveSkillBody } from './renderBody';
-export { resolveSurfaceMode, parseAnthropicVersion, isClaudeStrongAdherence } from './surfaceMode';
-//# sourceMappingURL=index.js.map

package/dist/esm/lib/skills/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/skills/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}