agentfootprint 9.129.0 → 9.131.0

package/dist/adapters/llm/retryAfter.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * retryAfter — the wait a vendor's response headers state, for an adapter to
+ * DECLARE on the error it raises (`retryAfterMs`).
+ *
+ * Pattern: pure reader (no I/O). Role: outer ring, below the adapters.
+ *
+ * `withRetry` never reads headers or prose — it reads the declared field
+ * (resilience/statedWait.ts · statedRetryAfterMs). Each adapter knows its own
+ * wire, so the reading happens here, once, for every adapter that can see
+ * headers:
+ *
+ *   - `retry-after-ms` — milliseconds, sent by the Anthropic and OpenAI APIs
+ *     (their own SDKs read it first too);
+ *   - `retry-after` — the standard header, delta-seconds or an HTTP-date
+ *     (lib/mcp/throttleRetry.ts · parseRetryAfter, the one parser of it).
+ *
+ * Headers arrive as a fetch `Headers` (anything with `get`) or a plain record
+ * (older SDKs, the AWS SDK's `$response.headers`); both are read
+ * case-insensitively. Anything unreadable is absent, never a guess.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retryAfterMsFromError = exports.retryAfterMsFromHeaders = void 0;
+const throttleRetry_js_1 = require("../../lib/mcp/throttleRetry.js");
+/** The stated wait in ms, or `undefined` when the headers state none. */
+function retryAfterMsFromHeaders(headers) {
+    const ms = headerValue(headers, 'retry-after-ms');
+    if (ms !== undefined) {
+        const value = Number(ms.trim());
+        if (ms.trim() !== '' && Number.isFinite(value) && value >= 0)
+            return value;
+    }
+    return (0, throttleRetry_js_1.parseRetryAfter)(headerValue(headers, 'retry-after'));
+}
+exports.retryAfterMsFromHeaders = retryAfterMsFromHeaders;
+/**
+ * The same wait read off an SDK error: `err.headers` (Anthropic and OpenAI SDK
+ * `APIError`) or `err.$response.headers` (AWS SDK v3 exceptions).
+ */
+function retryAfterMsFromError(err) {
+    if (err === null || typeof err !== 'object')
+        return undefined;
+    const e = err;
+    return retryAfterMsFromHeaders(e.headers) ?? retryAfterMsFromHeaders(e.$response?.headers);
+}
+exports.retryAfterMsFromError = retryAfterMsFromError;
+function headerValue(headers, name) {
+    if (headers === null || typeof headers !== 'object')
+        return undefined;
+    const getter = headers.get;
+    if (typeof getter === 'function') {
+        const value = getter.call(headers, name);
+        return typeof value === 'string' ? value : undefined;
+    }
+    for (const [key, value] of Object.entries(headers)) {
+        if (key.toLowerCase() === name && typeof value === 'string')
+            return value;
+    }
+    return undefined;
+}
+//# sourceMappingURL=retryAfter.js.map

package/dist/adapters/llm/retryAfter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retryAfter.js","sourceRoot":"","sources":["../../../src/adapters/llm/retryAfter.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,qEAAiE;AAEjE,yEAAyE;AACzE,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAClD,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;IAC7E,CAAC;IACD,OAAO,IAAA,kCAAe,EAAC,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AAC9D,CAAC;AAPD,0DAOC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAAY;IAChD,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,CAAC,GAAG,GAA+D,CAAC;IAC1E,OAAO,uBAAuB,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,uBAAuB,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAC7F,CAAC;AAJD,sDAIC;AAED,SAAS,WAAW,CAAC,OAAgB,EAAE,IAAY;IACjD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,MAAM,GAAI,OAA6B,CAAC,GAAG,CAAC;IAClD,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,KAAK,GAAI,MAAiC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACrE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAkC,CAAC,EAAE,CAAC;QAC9E,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IAC5E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/adapters/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAwNH;;;;GAIG;AACU,QAAA,2BAA2B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC5E,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAusBH;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,OAAsC,EACtC,UAAgC;IAEhC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAPD,wCAOC;AAqID;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,kBAAkB,CAAC;AAgGpD;uDACuD;AACvD,SAAgB,kBAAkB,CAChC,OAAoB;IAEpB,OAAO,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC;AACnD,CAAC;AAJD,gDAIC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAwNH;;;;GAIG;AACU,QAAA,2BAA2B,GAAwB,MAAM,CAAC,MAAM,CAAC;IAC5E,MAAM;IACN,WAAW;CACZ,CAAC,CAAC;AAgtBH;;;;;;GAMG;AACH,SAAgB,cAAc,CAC5B,OAAsC,EACtC,UAAgC;IAEhC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;AACxD,CAAC;AAPD,wCAOC;AAqID;;;;;;;;;GASG;AACU,QAAA,iBAAiB,GAAG,kBAAkB,CAAC;AAgGpD;uDACuD;AACvD,SAAgB,kBAAkB,CAChC,OAAoB;IAEpB,OAAO,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,CAAC;AACnD,CAAC;AAJD,gDAIC"}

package/dist/core/Agent.js

@@ -4312,6 +4312,16 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             // The inputs layer (honesty layer 2): the same site decorates a ruled
             // tool's schema first — value-conditional, the same grammar.
             ...(inputsArmed && { inputsLayer: true }),
+            // …and, under `.time({ reader })` (step T6b), the ONE served time sentence on each tool
+            // that declares a period: the windows the reader settled this turn, in that tool's form.
+            ...(inputsArmed &&
+                this.timeOptions?.reader !== undefined && {
+                timeWindows: {
+                    ...(this.timeOptions.zone !== undefined && { appZone: this.timeOptions.zone }),
+                },
+            }),
+            // …and, under `.time()` (step T8), the turn's time limits in the same line.
+            ...(inputsArmed && this.timeOptions !== undefined && { timeLimits: true }),
             // …and, under declared sources, plants `_findings.from` on ruled tools only.
             ...(argumentSources && { argumentSources: true }),
             // Tool choice by classifier (9.105.0): the pick and the narrowing live
@@ -4363,6 +4373,10 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             // constant on every call, under the one gate — an unarmed agent reads
             // no new key.
             ...(this.ontology !== undefined && { ontology: true }),
+            // The time layer's served line (step T6b): read only where the Tools
+            // mount can compose it — the `timeReader` arm of the chart deps.
+            // Step T8 widens it to `.time()`: the same line then carries the turn's time limits.
+            ...(inputsArmed && this.timeOptions !== undefined && { timeLine: true }),
             // The receipt's salt (9.88.0) — read per call, like seed's own accessor.
             getRunId: () => this.currentRunContext?.runId,
             // …and its off switch. Value-conditional, so an agent on the default
@@ -4529,6 +4543,9 @@ class Agent extends RunnerBase_js_1.RunnerBase {
                         return rules.ruled.find((r) => r.argument === argument)?.assume;
                     }),
                     answeredValues: route_js_2.answeredValuesOf,
+                    // Under `.time()` (step T7): the turn's time spellings by
+                    // lineage — said ones exempt, derived ones filed, not flagged.
+                    ...(this.timeOptions !== undefined && { timeLineage: true }),
                 }),
             }
             : undefined, 
@@ -4722,6 +4739,16 @@ class Agent extends RunnerBase_js_1.RunnerBase {
                         return passed;
                     },
                     ...(this.timeOptions.zone !== undefined && { appZone: this.timeOptions.zone }),
+                    // The reader (step T6b): the batch ask asks an open mention's window.
+                    ...(this.timeOptions.reader !== undefined &&
+                        this.timeOptions.policy !== undefined && {
+                        reader: {
+                            policy: this.timeOptions.policy,
+                            ...(this.timeOptions.messages !== undefined && {
+                                messages: this.timeOptions.messages,
+                            }),
+                        },
+                    }),
                 },
             }),
             emitForRun: (type, payload, runContext) => this.emitLateFact(type, payload, runContext),
@@ -4885,6 +4912,9 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             // The time layer: the prose limits block renders its `Period:` lines in
             // the run's clock zone. Absent → the final stage it always mounted.
             ...(this.timeOptions !== undefined && { timeLayer: true }),
+            // The reader (step T6b): the Tools mount hands the slot the turn's settled windows.
+            ...(inputsArmed && this.timeOptions?.reader !== undefined && { timeReader: true }),
+            ...(inputsArmed && this.timeOptions !== undefined && { timeLimits: true }),
             ...(this.answerValidationConfig !== undefined && { hasAnswerValidation: true }),
             // The out-of-budget wrap-up branch (9.56.0) — the conditional-mount law
             // above, decided once beside the Route decider that routes to it so the