agentfootprint 3.0.0 → 3.1.1

package/dist/types/resilience/withRetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"withRetry.d.ts","sourceRoot":"","sources":["../../../src/resilience/withRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAY,WAAW,EAA2B,MAAM,sBAAsB,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAuC5F"}
+{"version":3,"file":"withRetry.d.ts","sourceRoot":"","sources":["../../../src/resilience/withRetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAY,WAAW,EAA2B,MAAM,sBAAsB,CAAC;AAE3F,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAuC5F"}

package/dist/types/strategies/compose.d.ts

@@ -35,8 +35,8 @@ import type { ObservabilityStrategy, CostStrategy, LiveStatusStrategy, LensStrat
  * @example
  *   const all = composeObservability([
  *     consoleObservability(),
- *     datadogObservability({ apiKey }),
- *     otelObservability(tracer),
+ *     cloudwatchObservability({ logGroupName: '/agent/prod' }),
+ *     otelObservability({ serviceName: 'my-agent-prod' }),
  *   ]);
  */
 export declare function composeObservability(children: readonly ObservabilityStrategy[]): ObservabilityStrategy;

package/dist/types/tool-providers/skillScopedTools.d.ts

@@ -13,11 +13,11 @@
  *
  * @example  One skill's tools, scoped by activation
  *   const billingTools = skillScopedTools('billing', [refundTool, chargeTool]);
- *   billingTools.list({ iteration: 1, activeSkillId: 'billing', identity: ... });
+ *   billingTools.list({ iteration: 1, activeSkillId: 'billing' });
  *   // → [refundTool, chargeTool]
- *   billingTools.list({ iteration: 1, activeSkillId: 'refund', identity: ... });
+ *   billingTools.list({ iteration: 1, activeSkillId: 'refund' });
  *   // → [] (different skill active)
- *   billingTools.list({ iteration: 1, identity: ... });
+ *   billingTools.list({ iteration: 1 });
  *   // → [] (no skill active)
  *
  * @example  Compose with baseline + multiple skills

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "The explainable agent framework — build AI agents you can explain, audit, and trust. Built on footprintjs.",
   "license": "MIT",
   "author": "Sanjay Krishna Anbalagan",
@@ -49,10 +49,10 @@
   },
   "scripts": {
     "clean": "rm -rf dist coverage node_modules package-lock.json",
-    "build": "tsc && tsc -p tsconfig.esm.json",
+    "build": "tsc && tsc -p tsconfig.esm.json && node scripts/postbuild-esm.mjs",
     "watch": "tsc -w",
     "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
+    "test:coverage": "vitest run --coverage --coverage.reporter=json-summary --coverage.reporter=text-summary --coverage.reportsDirectory=coverage",
     "test:examples": "tsc -p examples/tsconfig.json && bash scripts/run-all-examples.sh",
     "test:examples:typecheck": "tsc -p examples/tsconfig.json",
     "examples:readme": "node scripts/generate-examples-readme.mjs",
@@ -66,7 +66,8 @@
     "format:fix": "prettier --config .prettierrc.js --write 'src/**/*.ts' 'test/**/*.ts'",
     "release:patch": "bash scripts/release.sh patch",
     "release:minor": "bash scripts/release.sh minor",
-    "release:major": "bash scripts/release.sh major"
+    "release:major": "bash scripts/release.sh major",
+    "coverage:badge": "npm run test:coverage; node scripts/coverage-badge.mjs"
   },
   "files": [
     "dist/**/*",
@@ -175,7 +176,10 @@
       "require": "./dist/status.js"
     }
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "**/cache/strategies/*.js",
+    "**/cache/index.js"
+  ],
   "peerDependencies": {
     "@anthropic-ai/sdk": "*",
     "@aws-sdk/client-bedrock-agent-runtime": "*",
@@ -226,6 +230,7 @@
     "@typescript-eslint/eslint-plugin": "^5.61.0",
     "@typescript-eslint/parser": "^5.61.0",
     "@vitest/coverage-v8": "^4.1.5",
+    "esbuild": "^0.28.0",
     "eslint": "^8.44.0",
     "eslint-config-prettier": "^6.15.0",
     "footprintjs": "^6.0.0",

package/dist/core/agent/stages/iterationStart.js

@@ -1,24 +0,0 @@
-"use strict";
-/**
- * iterationStart — per-iteration marker stage.
- *
- * Emits `agentfootprint.agent.iteration_start` so observability adapters
- * + recorders can bracket each ReAct iteration. Fires AFTER the slot
- * subflows (SystemPrompt, Messages, Tools, CacheDecision, CacheGate)
- * have produced this iteration's prompt assembly and BEFORE CallLLM.
- *
- * `turnIndex: 0` is intentional — the agent currently runs ONE turn per
- * `agent.run()`. The turn index is reserved for future multi-turn
- * orchestration; iteration index is the per-iteration counter.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.iterationStartStage = void 0;
-const typedEmit_js_1 = require("../../../recorders/core/typedEmit.js");
-const iterationStartStage = (scope) => {
-    (0, typedEmit_js_1.typedEmit)(scope, 'agentfootprint.agent.iteration_start', {
-        turnIndex: 0,
-        iterIndex: scope.iteration,
-    });
-};
-exports.iterationStartStage = iterationStartStage;
-//# sourceMappingURL=iterationStart.js.map

package/dist/core/agent/stages/iterationStart.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"iterationStart.js","sourceRoot":"","sources":["../../../../src/core/agent/stages/iterationStart.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAGH,uEAAiE;AAG1D,MAAM,mBAAmB,GAAG,CAAC,KAA6B,EAAQ,EAAE;IACzE,IAAA,wBAAS,EAAC,KAAK,EAAE,sCAAsC,EAAE;QACvD,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC,CAAC;AALW,QAAA,mBAAmB,uBAK9B"}

package/dist/esm/core/agent/stages/iterationStart.js

@@ -1,20 +0,0 @@
-/**
- * iterationStart — per-iteration marker stage.
- *
- * Emits `agentfootprint.agent.iteration_start` so observability adapters
- * + recorders can bracket each ReAct iteration. Fires AFTER the slot
- * subflows (SystemPrompt, Messages, Tools, CacheDecision, CacheGate)
- * have produced this iteration's prompt assembly and BEFORE CallLLM.
- *
- * `turnIndex: 0` is intentional — the agent currently runs ONE turn per
- * `agent.run()`. The turn index is reserved for future multi-turn
- * orchestration; iteration index is the per-iteration counter.
- */
-import { typedEmit } from '../../../recorders/core/typedEmit.js';
-export const iterationStartStage = (scope) => {
-    typedEmit(scope, 'agentfootprint.agent.iteration_start', {
-        turnIndex: 0,
-        iterIndex: scope.iteration,
-    });
-};
-//# sourceMappingURL=iterationStart.js.map

package/dist/esm/core/agent/stages/iterationStart.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"iterationStart.js","sourceRoot":"","sources":["../../../../../src/core/agent/stages/iterationStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAGjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAA6B,EAAQ,EAAE;IACzE,SAAS,CAAC,KAAK,EAAE,sCAAsC,EAAE;QACvD,SAAS,EAAE,CAAC;QACZ,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/types/core/agent/stages/iterationStart.d.ts

@@ -1,16 +0,0 @@
-/**
- * iterationStart — per-iteration marker stage.
- *
- * Emits `agentfootprint.agent.iteration_start` so observability adapters
- * + recorders can bracket each ReAct iteration. Fires AFTER the slot
- * subflows (SystemPrompt, Messages, Tools, CacheDecision, CacheGate)
- * have produced this iteration's prompt assembly and BEFORE CallLLM.
- *
- * `turnIndex: 0` is intentional — the agent currently runs ONE turn per
- * `agent.run()`. The turn index is reserved for future multi-turn
- * orchestration; iteration index is the per-iteration counter.
- */
-import type { TypedScope } from 'footprintjs';
-import type { AgentState } from '../types.js';
-export declare const iterationStartStage: (scope: TypedScope<AgentState>) => void;
-//# sourceMappingURL=iterationStart.d.ts.map

package/dist/types/core/agent/stages/iterationStart.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"iterationStart.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/iterationStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,eAAO,MAAM,mBAAmB,UAAW,WAAW,UAAU,CAAC,KAAG,IAKnE,CAAC"}