agentfootprint 1.0.0

package/dist/esm/tools/zodToJsonSchema.js

@@ -0,0 +1,65 @@
+/**
+ * Minimal Zod-to-JSON-Schema converter. Duck-typed — no zod dependency.
+ * Handles: object, string, number, boolean, array, enum, optional, default.
+ * @internal
+ */
+export function zodToJsonSchema(zodSchema) {
+    const def = zodSchema._def;
+    if (!def)
+        return { type: 'object' };
+    switch (def.typeName) {
+        case 'ZodObject': {
+            const shape = zodSchema.shape;
+            const properties = {};
+            const required = [];
+            for (const [key, value] of Object.entries(shape)) {
+                properties[key] = zodToJsonSchema(value);
+                if (value._def?.typeName !== 'ZodOptional') {
+                    required.push(key);
+                }
+            }
+            return {
+                type: 'object',
+                properties,
+                ...(required.length > 0 ? { required } : {}),
+            };
+        }
+        case 'ZodString': {
+            const r = { type: 'string' };
+            if (def.description)
+                r.description = def.description;
+            return r;
+        }
+        case 'ZodNumber': {
+            const r = { type: 'number' };
+            if (def.description)
+                r.description = def.description;
+            return r;
+        }
+        case 'ZodBoolean':
+            return { type: 'boolean' };
+        case 'ZodArray':
+            return { type: 'array', items: zodToJsonSchema(def.type) };
+        case 'ZodEnum':
+            return { type: 'string', enum: def.values };
+        case 'ZodOptional':
+            return zodToJsonSchema(def.innerType);
+        case 'ZodDefault':
+            return zodToJsonSchema(def.innerType);
+        case 'ZodNullable': {
+            const inner = zodToJsonSchema(def.innerType);
+            return { ...inner, nullable: true };
+        }
+        case 'ZodLiteral':
+            return { const: def.value };
+        default:
+            return {};
+    }
+}
+/** Duck-type check: is this a Zod schema? */
+export function isZodSchema(value) {
+    return typeof value === 'object' && value !== null
+        && typeof value.safeParse === 'function'
+        && value._def !== undefined;
+}
+//# sourceMappingURL=zodToJsonSchema.js.map

package/dist/esm/tools/zodToJsonSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodToJsonSchema.js","sourceRoot":"","sources":["../../../src/tools/zodToJsonSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAc;IAC5C,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAEpC,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC9B,MAAM,UAAU,GAA4B,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,UAAU,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAY,CAAC,CAAC;gBAChD,IAAK,KAAa,CAAC,IAAI,EAAE,QAAQ,KAAK,aAAa,EAAE,CAAC;oBACpD,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAED,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,UAAU;gBACV,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,CAAC;QACJ,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACtD,IAAI,GAAG,CAAC,WAAW;gBAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,CAAC,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YACtD,IAAI,GAAG,CAAC,WAAW;gBAAE,CAAC,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YACrD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,KAAK,YAAY;YACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7B,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7D,KAAK,SAAS;YACZ,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,aAAa;YAChB,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,YAAY;YACf,OAAO,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACtC,CAAC;QACD,KAAK,YAAY;YACf,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC9B;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;WAC7C,OAAQ,KAAa,CAAC,SAAS,KAAK,UAAU;WAC7C,KAAa,CAAC,IAAI,KAAK,SAAS,CAAC;AACzC,CAAC"}

package/dist/esm/types/adapter.js

@@ -0,0 +1,11 @@
+/**
+ * Adapter result — discriminated union for provider responses.
+ * Adapters normalize any provider's response into one of these shapes.
+ */
+/** Well-known scope paths for adapter stages. */
+export const ADAPTER_PATHS = {
+    REQUEST: 'adapterRequest',
+    RESPONSE: 'adapterRawResponse',
+    RESULT: 'adapterResult',
+};
+//# sourceMappingURL=adapter.js.map

package/dist/esm/types/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/types/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgCH,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,gBAAgB;IACzB,QAAQ,EAAE,oBAAoB;IAC9B,MAAM,EAAE,eAAe;CACf,CAAC"}

package/dist/esm/types/agent.js

@@ -0,0 +1,5 @@
+/**
+ * Agent configuration and result types.
+ */
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/esm/types/agent.js.map

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

package/dist/esm/types/content.js

@@ -0,0 +1,82 @@
+/**
+ * Multi-modal content blocks for LLM messages.
+ * Provider-agnostic — adapters translate to/from provider formats (Anthropic, OpenAI, etc.).
+ *
+ * Design: discriminated union on `type` field, like Anthropic's API.
+ * Every message's `content` is `string | ContentBlock[]` — string for backward compat,
+ * ContentBlock[] for multi-modal (images, tool use, structured results).
+ */
+// ── Factory Functions ───────────────────────────────────────
+export function textBlock(text) {
+    return { type: 'text', text };
+}
+export function imageBlock(source) {
+    return { type: 'image', source };
+}
+export function base64Image(mediaType, data) {
+    return { type: 'image', source: { type: 'base64', mediaType, data } };
+}
+export function urlImage(url) {
+    return { type: 'image', source: { type: 'url', url } };
+}
+export function toolUseBlock(id, name, input) {
+    return { type: 'tool_use', id, name, input };
+}
+export function toolResultBlock(toolUseId, content, isError) {
+    return { type: 'tool_result', toolUseId, content, isError };
+}
+// ── ToolCall ↔ ToolUseBlock Conversion ──────────────────────
+/**
+ * Convert a legacy ToolCall (from AssistantMessage.toolCalls) to a ToolUseBlock.
+ * Bridges the two representations: ToolCall uses `arguments`, ToolUseBlock uses `input`.
+ */
+export function toolCallToBlock(call) {
+    return { type: 'tool_use', id: call.id, name: call.name, input: call.arguments };
+}
+/**
+ * Convert a ToolUseBlock to a legacy ToolCall format.
+ * Bridges the two representations: ToolUseBlock uses `input`, ToolCall uses `arguments`.
+ */
+export function blockToToolCall(block) {
+    return { id: block.id, name: block.name, arguments: block.input };
+}
+// ── Content Helpers ─────────────────────────────────────────
+/**
+ * Extract text from message content, regardless of form.
+ * - string → returned as-is
+ * - ContentBlock[] → concatenates all TextBlock.text values
+ *
+ * Use this instead of `msg.content.length` or string operations on content.
+ */
+export function getTextContent(content) {
+    if (typeof content === 'string')
+        return content;
+    return content
+        .filter((block) => block.type === 'text')
+        .map((block) => block.text)
+        .join('');
+}
+/**
+ * Get the character length of message content (for budget calculations).
+ * Handles both string and ContentBlock[] forms.
+ */
+export function contentLength(content) {
+    return getTextContent(content).length;
+}
+/**
+ * Check if content contains any tool use blocks.
+ */
+export function hasToolUseBlocks(content) {
+    if (typeof content === 'string')
+        return false;
+    return content.some((block) => block.type === 'tool_use');
+}
+/**
+ * Extract tool use blocks from content.
+ */
+export function getToolUseBlocks(content) {
+    if (typeof content === 'string')
+        return [];
+    return content.filter((block) => block.type === 'tool_use');
+}
+//# sourceMappingURL=content.js.map

package/dist/esm/types/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../../src/types/content.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuEH,+DAA+D;AAE/D,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,IAAY;IACzD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,EAAU,EACV,IAAY,EACZ,KAA8B;IAE9B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,SAAiB,EACjB,OAAgC,EAChC,OAAiB;IAEjB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC;AAED,+DAA+D;AAE/D;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAI/B;IACC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB;IAKjD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AACpE,CAAC;AAED,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAuB;IACpD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAsB,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SAC5D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAyB,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;AACrF,CAAC"}

package/dist/esm/types/errors.js

@@ -0,0 +1,74 @@
+/**
+ * Normalized error types for LLM provider errors.
+ *
+ * All adapters wrap SDK-specific errors into LLMError so that
+ * compositions (withRetry, withFallback, withCircuitBreaker)
+ * can make uniform decisions.
+ */
+export class LLMError extends Error {
+    code;
+    provider;
+    statusCode;
+    retryable;
+    cause;
+    constructor(opts) {
+        super(opts.message);
+        this.name = 'LLMError';
+        this.code = opts.code;
+        this.provider = opts.provider;
+        this.statusCode = opts.statusCode;
+        this.cause = opts.cause;
+        this.retryable = isRetryable(opts.code);
+    }
+}
+function isRetryable(code) {
+    return code === 'rate_limit' || code === 'server' || code === 'timeout' || code === 'network';
+}
+/** Classify an HTTP status code into an LLMErrorCode. */
+export function classifyStatusCode(status) {
+    if (status === 401 || status === 403)
+        return 'auth';
+    if (status === 429)
+        return 'rate_limit';
+    if (status === 400)
+        return 'invalid_request';
+    if (status === 413 || status === 422)
+        return 'context_length';
+    if (status >= 500)
+        return 'server';
+    return 'unknown';
+}
+/** Wrap an unknown SDK error into an LLMError. */
+export function wrapSDKError(err, provider) {
+    if (err instanceof LLMError)
+        return err;
+    const error = err instanceof Error ? err : new Error(String(err));
+    const message = error.message;
+    // AbortError from signal
+    if (error.name === 'AbortError' || message.includes('aborted')) {
+        return new LLMError({ message, code: 'aborted', provider, cause: error });
+    }
+    // Timeout
+    if (message.includes('timeout') || message.includes('ETIMEDOUT')) {
+        return new LLMError({ message, code: 'timeout', provider, cause: error });
+    }
+    // Network
+    if (message.includes('ECONNREFUSED') ||
+        message.includes('ENOTFOUND') ||
+        message.includes('fetch failed')) {
+        return new LLMError({ message, code: 'network', provider, cause: error });
+    }
+    // HTTP status code from SDK errors (Anthropic and OpenAI both expose .status)
+    const statusCode = err.status;
+    if (statusCode) {
+        return new LLMError({
+            message,
+            code: classifyStatusCode(statusCode),
+            provider,
+            statusCode,
+            cause: error,
+        });
+    }
+    return new LLMError({ message, code: 'unknown', provider, cause: error });
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/types/errors.js.map

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

package/dist/esm/types/index.js

@@ -0,0 +1,5 @@
+export { textBlock, imageBlock, base64Image, urlImage, toolUseBlock, toolResultBlock, toolCallToBlock, blockToToolCall, getTextContent, contentLength, hasToolUseBlocks, getToolUseBlocks, } from './content';
+export { systemMessage, userMessage, assistantMessage, toolResultMessage, hasToolCalls, } from './messages';
+export { ADAPTER_PATHS } from './adapter';
+export { LLMError, classifyStatusCode, wrapSDKError } from './errors';
+//# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC;AAWnB,OAAO,EACL,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,YAAY,CAAC;AAqBpB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAe1C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/types/llm.js

@@ -0,0 +1,6 @@
+/**
+ * Provider-agnostic LLM interface.
+ * No SDK dependency — consumers implement for their provider.
+ */
+export {};
+//# sourceMappingURL=llm.js.map

package/dist/esm/types/llm.js.map

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

package/dist/esm/types/messages.js

@@ -0,0 +1,24 @@
+/**
+ * Message types for LLM conversation.
+ * Provider-agnostic — adapters translate to/from provider formats.
+ *
+ * Content can be a plain string (backward compat) or ContentBlock[]
+ * for multi-modal messages (images, structured tool results, etc.).
+ */
+// ── Helpers ──────────────────────────────────────────────────
+export function systemMessage(content) {
+    return { role: 'system', content };
+}
+export function userMessage(content) {
+    return { role: 'user', content };
+}
+export function assistantMessage(content, toolCalls) {
+    return { role: 'assistant', content, toolCalls };
+}
+export function toolResultMessage(content, toolCallId) {
+    return { role: 'tool', content, toolCallId };
+}
+export function hasToolCalls(msg) {
+    return msg.role === 'assistant' && Array.isArray(msg.toolCalls) && msg.toolCalls.length > 0;
+}
+//# sourceMappingURL=messages.js.map

package/dist/esm/types/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/types/messages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkCH,gEAAgE;AAEhE,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAuB;IACjD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAuB,EACvB,SAAsB;IAEtB,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAuB,EAAE,UAAkB;IAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9F,CAAC"}

package/dist/esm/types/multiAgent.js

@@ -0,0 +1,5 @@
+/**
+ * Multi-Agent types — duck-typed interfaces for composing runners into pipelines.
+ */
+export {};
+//# sourceMappingURL=multiAgent.js.map

package/dist/esm/types/multiAgent.js.map

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

package/dist/esm/types/retriever.js

@@ -0,0 +1,6 @@
+/**
+ * Retriever types — the contract for retrieval providers.
+ * Users implement RetrieverProvider for their vector store (Pinecone, Chroma, pg_vector, etc.).
+ */
+export {};
+//# sourceMappingURL=retriever.js.map

package/dist/esm/types/retriever.js.map

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

package/dist/esm/types/tools.js

@@ -0,0 +1,5 @@
+/**
+ * Tool definitions for agent function calling.
+ */
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/esm/types/tools.js.map

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

package/dist/executor/agentLoop.js

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

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

package/dist/executor/index.js

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

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

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * agentfootprint/explain — Understand agent decisions.
+ *
+ * Extract grounding sources (tool results) and LLM claims for hallucination detection.
+ * Verbose narrative mode for full values. AgentScopeKey enum for type-safe queries.
+ *
+ * @example
+ * ```typescript
+ * import { getGroundingSources, getLLMClaims } from 'agentfootprint/explain';
+ *
+ * const entries = agent.getNarrativeEntries();
+ * const sources = getGroundingSources(entries);  // what tools returned
+ * const claims = getLLMClaims(entries);           // what the LLM said
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExplainRecorder = exports.createAgentRenderer = exports.getFullLLMContext = exports.getLLMClaims = exports.getGroundingSources = void 0;
+var narrative_1 = require("./lib/narrative");
+Object.defineProperty(exports, "getGroundingSources", { enumerable: true, get: function () { return narrative_1.getGroundingSources; } });
+Object.defineProperty(exports, "getLLMClaims", { enumerable: true, get: function () { return narrative_1.getLLMClaims; } });
+Object.defineProperty(exports, "getFullLLMContext", { enumerable: true, get: function () { return narrative_1.getFullLLMContext; } });
+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/v2/ExplainRecorder");
+Object.defineProperty(exports, "ExplainRecorder", { enumerable: true, get: function () { return ExplainRecorder_1.ExplainRecorder; } });
+//# sourceMappingURL=explain.barrel.js.map

package/dist/explain.barrel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.barrel.js","sourceRoot":"","sources":["../src/explain.barrel.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,6CAA4G;AAAnG,gHAAA,mBAAmB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAGlF,iFAAiF;AACjF,kEAAiE;AAAxD,kHAAA,eAAe,OAAA"}

package/dist/index.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * agentfootprint — The explainable agent framework.
+ *
+ * Core: builders, tools, providers, messages, types.
+ *
+ * Focused capabilities (also importable from subpaths):
+ *   agentfootprint/instructions  → Conditional context injection
+ *   agentfootprint/observe       → Monitor execution (recorders)
+ *   agentfootprint/resilience    → Retry, fallback, circuit breaker
+ *   agentfootprint/security      → Tool gating, permissions
+ *   agentfootprint/explain       → Narrative, grounding analysis
+ *   agentfootprint/stream        → Real-time lifecycle events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMError = exports.urlImage = exports.base64Image = exports.imageBlock = exports.textBlock = exports.toolResultMessage = exports.assistantMessage = exports.userMessage = exports.systemMessage = exports.postgresStore = exports.dynamoStore = exports.redisStore = exports.InMemoryStore = exports.BrowserOpenAIAdapter = exports.BrowserAnthropicAdapter = exports.BedrockAdapter = exports.OpenAIAdapter = exports.AnthropicAdapter = exports.bedrock = exports.ollama = exports.openai = exports.anthropic = exports.createProvider = exports.MockRetriever = exports.mockRetriever = exports.MockAdapter = exports.mock = exports.ToolRegistry = exports.askHuman = exports.defineTool = exports.ParallelRunner = exports.Parallel = exports.SwarmRunner = exports.Swarm = exports.FlowChartRunner = exports.FlowChart = exports.RAGRunner = exports.RAG = exports.LLMCallRunner = exports.LLMCall = exports.AgentRunner = exports.Agent = void 0;
+// ── Concepts (Builders + Runners) ───────────────────────────
+var concepts_1 = require("./concepts");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return concepts_1.Agent; } });
+Object.defineProperty(exports, "AgentRunner", { enumerable: true, get: function () { return concepts_1.AgentRunner; } });
+Object.defineProperty(exports, "LLMCall", { enumerable: true, get: function () { return concepts_1.LLMCall; } });
+Object.defineProperty(exports, "LLMCallRunner", { enumerable: true, get: function () { return concepts_1.LLMCallRunner; } });
+Object.defineProperty(exports, "RAG", { enumerable: true, get: function () { return concepts_1.RAG; } });
+Object.defineProperty(exports, "RAGRunner", { enumerable: true, get: function () { return concepts_1.RAGRunner; } });
+Object.defineProperty(exports, "FlowChart", { enumerable: true, get: function () { return concepts_1.FlowChart; } });
+Object.defineProperty(exports, "FlowChartRunner", { enumerable: true, get: function () { return concepts_1.FlowChartRunner; } });
+Object.defineProperty(exports, "Swarm", { enumerable: true, get: function () { return concepts_1.Swarm; } });
+Object.defineProperty(exports, "SwarmRunner", { enumerable: true, get: function () { return concepts_1.SwarmRunner; } });
+Object.defineProperty(exports, "Parallel", { enumerable: true, get: function () { return concepts_1.Parallel; } });
+Object.defineProperty(exports, "ParallelRunner", { enumerable: true, get: function () { return concepts_1.ParallelRunner; } });
+// ── Tools ───────────────────────────────────────────────────
+var tools_1 = require("./tools");
+Object.defineProperty(exports, "defineTool", { enumerable: true, get: function () { return tools_1.defineTool; } });
+Object.defineProperty(exports, "askHuman", { enumerable: true, get: function () { return tools_1.askHuman; } });
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return tools_1.ToolRegistry; } });
+// ── Providers (core — you can't build an agent without these) ─
+var adapters_1 = require("./adapters");
+Object.defineProperty(exports, "mock", { enumerable: true, get: function () { return adapters_1.mock; } });
+Object.defineProperty(exports, "MockAdapter", { enumerable: true, get: function () { return adapters_1.MockAdapter; } });
+Object.defineProperty(exports, "mockRetriever", { enumerable: true, get: function () { return adapters_1.mockRetriever; } });
+Object.defineProperty(exports, "MockRetriever", { enumerable: true, get: function () { return adapters_1.MockRetriever; } });
+Object.defineProperty(exports, "createProvider", { enumerable: true, get: function () { return adapters_1.createProvider; } });
+var models_1 = require("./models");
+Object.defineProperty(exports, "anthropic", { enumerable: true, get: function () { return models_1.anthropic; } });
+Object.defineProperty(exports, "openai", { enumerable: true, get: function () { return models_1.openai; } });
+Object.defineProperty(exports, "ollama", { enumerable: true, get: function () { return models_1.ollama; } });
+Object.defineProperty(exports, "bedrock", { enumerable: true, get: function () { return models_1.bedrock; } });
+var adapters_2 = require("./adapters");
+Object.defineProperty(exports, "AnthropicAdapter", { enumerable: true, get: function () { return adapters_2.AnthropicAdapter; } });
+Object.defineProperty(exports, "OpenAIAdapter", { enumerable: true, get: function () { return adapters_2.OpenAIAdapter; } });
+Object.defineProperty(exports, "BedrockAdapter", { enumerable: true, get: function () { return adapters_2.BedrockAdapter; } });
+var adapters_3 = require("./adapters");
+Object.defineProperty(exports, "BrowserAnthropicAdapter", { enumerable: true, get: function () { return adapters_3.BrowserAnthropicAdapter; } });
+Object.defineProperty(exports, "BrowserOpenAIAdapter", { enumerable: true, get: function () { return adapters_3.BrowserOpenAIAdapter; } });
+var inMemory_1 = require("./adapters/memory/inMemory");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return inMemory_1.InMemoryStore; } });
+var stores_1 = require("./adapters/memory/stores");
+Object.defineProperty(exports, "redisStore", { enumerable: true, get: function () { return stores_1.redisStore; } });
+Object.defineProperty(exports, "dynamoStore", { enumerable: true, get: function () { return stores_1.dynamoStore; } });
+Object.defineProperty(exports, "postgresStore", { enumerable: true, get: function () { return stores_1.postgresStore; } });
+// ── Messages + Content ──────────────────────────────────────
+var types_1 = require("./types");
+Object.defineProperty(exports, "systemMessage", { enumerable: true, get: function () { return types_1.systemMessage; } });
+Object.defineProperty(exports, "userMessage", { enumerable: true, get: function () { return types_1.userMessage; } });
+Object.defineProperty(exports, "assistantMessage", { enumerable: true, get: function () { return types_1.assistantMessage; } });
+Object.defineProperty(exports, "toolResultMessage", { enumerable: true, get: function () { return types_1.toolResultMessage; } });
+Object.defineProperty(exports, "textBlock", { enumerable: true, get: function () { return types_1.textBlock; } });
+Object.defineProperty(exports, "imageBlock", { enumerable: true, get: function () { return types_1.imageBlock; } });
+Object.defineProperty(exports, "base64Image", { enumerable: true, get: function () { return types_1.base64Image; } });
+Object.defineProperty(exports, "urlImage", { enumerable: true, get: function () { return types_1.urlImage; } });
+// ── Errors ──────────────────────────────────────────────────
+var types_2 = require("./types");
+Object.defineProperty(exports, "LLMError", { enumerable: true, get: function () { return types_2.LLMError; } });
+//# sourceMappingURL=index.js.map