agentfootprint 9.128.1 → 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/artifacts/datasetResult.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stageDatasetArtifacts = exports.withDatasetArtifacts = void 0;
 const types_js_1 = require("./types.js");
-const timeAxis_js_1 = require("./timeAxis.js");
+const axis_js_1 = require("../core/time/axis.js");
 const projection_js_1 = require("../lib/semantics/projection.js");
 /**
  * Adapt any local, HTTP-backed or MCP Tool using the SAME already-bound execution capability.
@@ -109,7 +109,7 @@ function assertInputs(datasets) {
             // store would come back as a 'store-unavailable' receipt, which is a
             // different fact from "the producer declared something unreadable".
             if (input.timeAxis !== undefined) {
-                const issues = (0, timeAxis_js_1.timeAxisIssues)(input.timeAxis);
+                const issues = (0, axis_js_1.timeAxisIssues)(input.timeAxis);
                 if (issues.length > 0) {
                     throw new types_js_1.InvalidArtifactError(`Dataset '${entry.key}': ${issues.join(' ')}`);
                 }

package/dist/artifacts/datasetResult.js.map

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

package/dist/artifacts/index.js

@@ -11,7 +11,7 @@
  * this folder for the one-job map and the import direction.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TIME_AXIS_UNITS = exports.TIME_AXIS_AGGREGATES = exports.timeAxisIssues = exports.readTimeAxis = exports.describeTimeAxis = exports.stageDatasetArtifacts = exports.withDatasetArtifacts = exports.placedToolResult = exports.placedResultKind = exports.isPlacedToolResult = exports.assertArtifactPlacement = exports.runArtifactStoreConformance = exports.runArtifactStoreCase = exports.formatArtifactStoreReport = exports.artifactStoreConformance = exports.UnserializableRecordingError = exports.chartWalkPutInput = exports.CHART_WALK_ARTIFACT_KIND = exports.RECORDING_MEDIA_TYPE = exports.RECORDING_ARTIFACT_KIND = exports.recordingPutInput = exports.presentArtifact = exports.PRESENT_TOOL_NAME = exports.wantsNeedsStoreRefusal = exports.resolveToolWants = exports.assertToolWants = exports.unconfiguredArtifacts = exports.bindArtifacts = exports.collectStream = exports.canStreamArtifacts = exports.canPutArtifactStream = exports.canGetArtifactStream = exports.bytesAsStream = exports.assertStreamBytes = exports.gcsArtifacts = exports.s3Artifacts = exports.UnreadableArtifactStoreError = exports.sqliteArtifacts = exports.UnreadableArtifactFileError = exports.fileArtifacts = exports.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION = exports.inMemoryArtifacts = exports.mintArtifactRef = exports.isArtifactRef = exports.ARTIFACT_REF_PREFIX = exports.UnknownParentRefError = exports.InvalidArtifactError = exports.ArtifactIntegrityError = void 0;
+exports.TIME_AXIS_UNITS = exports.TIME_AXIS_AGGREGATES = exports.timeAxisIssues = exports.readTimeAxis = exports.normaliseInstants = exports.describeTimeAxis = exports.stageDatasetArtifacts = exports.withDatasetArtifacts = exports.placedToolResult = exports.placedResultKind = exports.isPlacedToolResult = exports.assertArtifactPlacement = exports.runArtifactStoreConformance = exports.runArtifactStoreCase = exports.formatArtifactStoreReport = exports.artifactStoreConformance = exports.UnserializableRecordingError = exports.chartWalkPutInput = exports.CHART_WALK_ARTIFACT_KIND = exports.RECORDING_MEDIA_TYPE = exports.RECORDING_ARTIFACT_KIND = exports.recordingPutInput = exports.presentArtifact = exports.PRESENT_TOOL_NAME = exports.wantsNeedsStoreRefusal = exports.resolveToolWants = exports.assertToolWants = exports.unconfiguredArtifacts = exports.bindArtifacts = exports.collectStream = exports.canStreamArtifacts = exports.canPutArtifactStream = exports.canGetArtifactStream = exports.bytesAsStream = exports.assertStreamBytes = exports.gcsArtifacts = exports.s3Artifacts = exports.UnreadableArtifactStoreError = exports.sqliteArtifacts = exports.UnreadableArtifactFileError = exports.fileArtifacts = exports.DEFAULT_IN_MEMORY_ARTIFACT_RETENTION = exports.inMemoryArtifacts = exports.mintArtifactRef = exports.isArtifactRef = exports.ARTIFACT_REF_PREFIX = exports.UnknownParentRefError = exports.InvalidArtifactError = exports.ArtifactIntegrityError = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "ArtifactIntegrityError", { enumerable: true, get: function () { return types_js_1.ArtifactIntegrityError; } });
 Object.defineProperty(exports, "InvalidArtifactError", { enumerable: true, get: function () { return types_js_1.InvalidArtifactError; } });
@@ -74,11 +74,13 @@ Object.defineProperty(exports, "placedToolResult", { enumerable: true, get: func
 var datasetResult_js_1 = require("./datasetResult.js");
 Object.defineProperty(exports, "withDatasetArtifacts", { enumerable: true, get: function () { return datasetResult_js_1.withDatasetArtifacts; } });
 Object.defineProperty(exports, "stageDatasetArtifacts", { enumerable: true, get: function () { return datasetResult_js_1.stageDatasetArtifacts; } });
-// A dataset's declared TIME AXIS — judged at mint, read by consumers.
-var timeAxis_js_1 = require("./timeAxis.js");
-Object.defineProperty(exports, "describeTimeAxis", { enumerable: true, get: function () { return timeAxis_js_1.describeTimeAxis; } });
-Object.defineProperty(exports, "readTimeAxis", { enumerable: true, get: function () { return timeAxis_js_1.readTimeAxis; } });
-Object.defineProperty(exports, "timeAxisIssues", { enumerable: true, get: function () { return timeAxis_js_1.timeAxisIssues; } });
-Object.defineProperty(exports, "TIME_AXIS_AGGREGATES", { enumerable: true, get: function () { return timeAxis_js_1.TIME_AXIS_AGGREGATES; } });
-Object.defineProperty(exports, "TIME_AXIS_UNITS", { enumerable: true, get: function () { return timeAxis_js_1.TIME_AXIS_UNITS; } });
+// A dataset's declared TIME AXIS — judged at mint, read by consumers. Owned by
+// the time layer (`core/time/axis.ts`); re-exported here, where datasets live.
+var axis_js_1 = require("../core/time/axis.js");
+Object.defineProperty(exports, "describeTimeAxis", { enumerable: true, get: function () { return axis_js_1.describeTimeAxis; } });
+Object.defineProperty(exports, "normaliseInstants", { enumerable: true, get: function () { return axis_js_1.normaliseInstants; } });
+Object.defineProperty(exports, "readTimeAxis", { enumerable: true, get: function () { return axis_js_1.readTimeAxis; } });
+Object.defineProperty(exports, "timeAxisIssues", { enumerable: true, get: function () { return axis_js_1.timeAxisIssues; } });
+Object.defineProperty(exports, "TIME_AXIS_AGGREGATES", { enumerable: true, get: function () { return axis_js_1.TIME_AXIS_AGGREGATES; } });
+Object.defineProperty(exports, "TIME_AXIS_UNITS", { enumerable: true, get: function () { return axis_js_1.TIME_AXIS_UNITS; } });
 //# sourceMappingURL=index.js.map

package/dist/artifacts/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,uCAkBoB;AAjBlB,kHAAA,sBAAsB,OAAA;AACtB,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AAgBvB,yCAAkF;AAAzE,gHAAA,mBAAmB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAE5D,+DAKgC;AAJ9B,yHAAA,iBAAiB,OAAA;AACjB,4IAAA,oCAAoC,OAAA;AAItC,uDAI4B;AAH1B,iHAAA,aAAa,OAAA;AACb,+HAAA,2BAA2B,OAAA;AAG7B,2DAK8B;AAJ5B,qHAAA,eAAe,OAAA;AACf,kIAAA,4BAA4B,OAAA;AAI9B,mDAAwE;AAA/D,6GAAA,WAAW,OAAA;AACpB,qDAA2E;AAAlE,+GAAA,YAAY,OAAA;AACrB,+CAUwB;AATtB,iHAAA,iBAAiB,OAAA;AACjB,6GAAA,aAAa,OAAA;AACb,oHAAA,oBAAoB,OAAA;AACpB,oHAAA,oBAAoB,OAAA;AACpB,kHAAA,kBAAkB,OAAA;AAClB,6GAAA,aAAa,OAAA;AAKf,iDAUyB;AATvB,8GAAA,aAAa,OAAA;AACb,sHAAA,qBAAqB,OAAA;AASvB,uCAOoB;AANlB,2GAAA,eAAe,OAAA;AACf,4GAAA,gBAAgB,OAAA;AAChB,kHAAA,sBAAsB,OAAA;AAKxB,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,6GAAA,eAAe,OAAA;AAKjB,+DASgC;AAR9B,yHAAA,iBAAiB,OAAA;AACjB,+HAAA,uBAAuB,OAAA;AACvB,4HAAA,oBAAoB,OAAA;AACpB,gIAAA,wBAAwB,OAAA;AACxB,yHAAA,iBAAiB,OAAA;AACjB,oIAAA,4BAA4B,OAAA;AAI9B,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,mCAAmC;AACnC,mDAagC;AAZ9B,oHAAA,wBAAwB,OAAA;AACxB,qHAAA,yBAAyB,OAAA;AACzB,gHAAA,oBAAoB,OAAA;AACpB,uHAAA,2BAA2B,OAAA;AAU7B,+CAOwB;AANtB,uHAAA,uBAAuB,OAAA;AACvB,kHAAA,kBAAkB,OAAA;AAClB,gHAAA,gBAAgB,OAAA;AAChB,gHAAA,gBAAgB,OAAA;AAIlB,uDAQ4B;AAP1B,wHAAA,oBAAoB,OAAA;AACpB,yHAAA,qBAAqB,OAAA;AAOvB,sEAAsE;AACtE,6CAUuB;AATrB,+GAAA,gBAAgB,OAAA;AAChB,2GAAA,YAAY,OAAA;AACZ,6GAAA,cAAc,OAAA;AACd,mHAAA,oBAAoB,OAAA;AACpB,8GAAA,eAAe,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/artifacts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,uCAkBoB;AAjBlB,kHAAA,sBAAsB,OAAA;AACtB,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AAgBvB,yCAAkF;AAAzE,gHAAA,mBAAmB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAAE,4GAAA,eAAe,OAAA;AAE5D,+DAKgC;AAJ9B,yHAAA,iBAAiB,OAAA;AACjB,4IAAA,oCAAoC,OAAA;AAItC,uDAI4B;AAH1B,iHAAA,aAAa,OAAA;AACb,+HAAA,2BAA2B,OAAA;AAG7B,2DAK8B;AAJ5B,qHAAA,eAAe,OAAA;AACf,kIAAA,4BAA4B,OAAA;AAI9B,mDAAwE;AAA/D,6GAAA,WAAW,OAAA;AACpB,qDAA2E;AAAlE,+GAAA,YAAY,OAAA;AACrB,+CAUwB;AATtB,iHAAA,iBAAiB,OAAA;AACjB,6GAAA,aAAa,OAAA;AACb,oHAAA,oBAAoB,OAAA;AACpB,oHAAA,oBAAoB,OAAA;AACpB,kHAAA,kBAAkB,OAAA;AAClB,6GAAA,aAAa,OAAA;AAKf,iDAUyB;AATvB,8GAAA,aAAa,OAAA;AACb,sHAAA,qBAAqB,OAAA;AASvB,uCAOoB;AANlB,2GAAA,eAAe,OAAA;AACf,4GAAA,gBAAgB,OAAA;AAChB,kHAAA,sBAAsB,OAAA;AAKxB,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,6GAAA,eAAe,OAAA;AAKjB,+DASgC;AAR9B,yHAAA,iBAAiB,OAAA;AACjB,+HAAA,uBAAuB,OAAA;AACvB,4HAAA,oBAAoB,OAAA;AACpB,gIAAA,wBAAwB,OAAA;AACxB,yHAAA,iBAAiB,OAAA;AACjB,oIAAA,4BAA4B,OAAA;AAI9B,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,mCAAmC;AACnC,mDAagC;AAZ9B,oHAAA,wBAAwB,OAAA;AACxB,qHAAA,yBAAyB,OAAA;AACzB,gHAAA,oBAAoB,OAAA;AACpB,uHAAA,2BAA2B,OAAA;AAU7B,+CAOwB;AANtB,uHAAA,uBAAuB,OAAA;AACvB,kHAAA,kBAAkB,OAAA;AAClB,gHAAA,gBAAgB,OAAA;AAChB,gHAAA,gBAAgB,OAAA;AAIlB,uDAQ4B;AAP1B,wHAAA,oBAAoB,OAAA;AACpB,yHAAA,qBAAqB,OAAA;AAOvB,+EAA+E;AAC/E,+EAA+E;AAC/E,gDAkB8B;AAjB5B,2GAAA,gBAAgB,OAAA;AAChB,4GAAA,iBAAiB,OAAA;AACjB,uGAAA,YAAY,OAAA;AACZ,yGAAA,cAAc,OAAA;AACd,+GAAA,oBAAoB,OAAA;AACpB,0GAAA,eAAe,OAAA"}

package/dist/artifacts/minting.js

@@ -15,7 +15,7 @@ exports.prepareArtifact = void 0;
 const naming_js_1 = require("./naming.js");
 const payload_js_1 = require("./payload.js");
 const retention_js_1 = require("./retention.js");
-const timeAxis_js_1 = require("./timeAxis.js");
+const axis_js_1 = require("../core/time/axis.js");
 const types_js_1 = require("./types.js");
 /**
  * Validate a put and build the meta it mints.
@@ -49,7 +49,7 @@ async function prepareArtifact(input, resolveParent, retention, now) {
     // A declared time axis is judged, never repaired: a ticket whose
     // description the store had "fixed" would carry a promise nobody made.
     if (input.timeAxis !== undefined) {
-        const issues = (0, timeAxis_js_1.timeAxisIssues)(input.timeAxis);
+        const issues = (0, axis_js_1.timeAxisIssues)(input.timeAxis);
         if (issues.length > 0)
             throw new types_js_1.InvalidArtifactError(issues.join(' '));
     }

package/dist/artifacts/minting.js.map

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

package/dist/core/Agent.js

@@ -153,6 +153,8 @@ const conversation_js_1 = require("./conversation.js");
 const inputRequest_js_1 = require("./inputRequest.js");
 const outputSchema_js_1 = require("./outputSchema.js");
 const runInput_js_1 = require("./runInput.js");
+const rows_js_1 = require("./time/rows.js");
+const clock_js_1 = require("./time/clock.js");
 const outputRetry_js_1 = require("./agent/stages/outputRetry.js");
 const RunnerBase_js_1 = require("./RunnerBase.js");
 const validators_js_1 = require("./agent/validators.js");
@@ -365,6 +367,20 @@ class Agent extends RunnerBase_js_1.RunnerBase {
      *  ask, and that undefined is the whole zero-cost guarantee: no stage, no
      *  witness row, no stamp, no event, no bridge. */
     answerLayerOption;
+    /** `.time()` (the time layer, `core/time/`): the fallback zone, as read.
+     *  Undefined on every agent that did not ask — then no clock is read, no
+     *  time row is filed and `time` on a run is refused. */
+    timeOptions;
+    /** The clock the CURRENT `run()`'s seed stamps — set by `run()` (refusing a
+     *  run with no zone), read by seed through `SeedStageDeps.timeClock`, and
+     *  cleared when `run()` ends, so a later turn this agent did not start (its
+     *  chart mounted in a composition) never stamps a clock nobody declared for
+     *  it (`seedClockDraft`). */
+    runClockDraft;
+    /** The `time` the CURRENT resume passed, as read — TAKEN once by the first
+     *  ToolCalls pass of the resumed leg (`ToolCallsHandlerDeps.time`), and
+     *  cleared when `run()` or `resume()` ends. */
+    resumePassedTime;
     /** Tool choice by classifier (9.105.0, `.toolChoice()`): the classifier,
      *  the serve dial and the app's own doors. Threaded to the tools slot (the
      *  pick and the narrowing), to call-llm (`toolChoice: true`, the outcome
@@ -804,6 +820,18 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         else if (typeof opts.answerLayer === 'object' && opts.answerLayer !== null) {
             this.answerLayerOption = opts.answerLayer.standingLine === true ? { standingLine: true } : {};
         }
+        // The time layer's door (`.time()` / `AgentOptions.time`): `true` or the
+        // options, read once; a malformed zone is refused here, at build.
+        if (opts.time !== undefined) {
+            const read = (0, clock_js_1.readTimeOptions)(opts.time === true ? undefined : opts.time);
+            if ('problem' in read)
+                throw new Error(`Agent: time ${read.problem}.`);
+            this.timeOptions = read.value;
+            // The reader reads only a person's message — a composition hands the
+            // `messageFrom: 'composed'` marker only to a runner that reads it.
+            if (read.value.reader !== undefined)
+                (0, messageFrom_js_1.readsMessageFrom)(this);
+        }
         if (opts.findings?.argumentSources === true || inputsLayer?.argumentSources === true) {
             this.argumentSourcesArmed = true;
             // Declared sources read `AgentInput.messageFrom` — a composition hands
@@ -1493,6 +1521,10 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         // not at the resume of a pause it would have made impossible to resume.
         (0, callerIdentity_js_1.assertIdentityShape)(runInput.identity, 'Agent.run');
         (0, callerIdentity_js_1.assertIdentityShape)(options?.identity, 'Agent.run');
+        // The run's clock (the time layer): read or refused HERE, before the turn
+        // starts — a run with no zone anywhere never runs on the server's zone.
+        const clockDraft = this.clockDraftFor(runInput.time ?? options?.time, 'Agent.run');
+        const engineOptions = withoutTime(options);
         // Timing next, and before the executor exists: both of these refuse a call
         // that would have SUCCEEDED into corrupted per-instance state or an
         // orphaned human question. See ./conversation.ts for why they are throws.
@@ -1524,7 +1556,8 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         // (helper used in the catch block below — module-private function
         // declared at file end via hoisting)
         this.answeredAsk = undefined;
-        const executor = this.createExecutor(options);
+        this.resumePassedTime = undefined;
+        const executor = this.createExecutor(engineOptions);
         this.inFlightRunId = this.currentRunContext.runId;
         // One disposition ledger per run (9.60.0) — registration mirrors what
         // this agent's configuration makes applicable; dev posture runs the
@@ -1549,22 +1582,28 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         this.lastRunAnswer = undefined;
         // One run can never raise on another run's consent block.
         this.consentOutstanding.clear();
+        // Set here, beside the `try` whose `finally` clears it, so no exit path
+        // can leave it behind for a turn this `run()` did not start.
+        this.runClockDraft = clockDraft;
         try {
             const result = await executor.run({
                 input: {
                     message: runInput.message,
                     ...(this.lastRunIdentity !== undefined && { identity: this.lastRunIdentity }),
                     // A composed message reaches seed only on an agent that reads it
-                    // (declared sources) — every other run's input is the bytes it was.
+                    // (declared sources, or the time layer's reader) — every other run's
+                    // input is the bytes it was.
                     ...(messageFrom === 'composed' &&
-                        this.argumentSourcesArmed === true && { messageFrom: 'composed' }),
+                        (this.argumentSourcesArmed === true || this.timeOptions?.reader !== undefined) && {
+                        messageFrom: 'composed',
+                    }),
                 },
                 // Co-engineered boundary (#16): the engine's loop-iteration limit
                 // (footprintjs 9 default 1000) must never fire BELOW the agent's own
                 // budget — give it headroom (×2 + 10 covers double-hop loop shapes).
                 // Consumer-provided options win.
                 maxIterations: this.maxIterations * 2 + 10,
-                ...(options ?? {}),
+                ...(engineOptions ?? {}),
             });
             const finalized = this.finalizeResult(executor, result);
             if (typeof finalized === 'string')
@@ -1658,6 +1697,11 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             throw cause;
         }
         finally {
+            // The time layer's per-run inputs end with the run: a stale draft would
+            // be stamped by the next seed this agent did not start (a composition
+            // mounting its chart) as if the app had declared it.
+            this.runClockDraft = undefined;
+            this.resumePassedTime = undefined;
             // The run's disposition rows, on EVERY path — success, failure, pause —
             // and BEFORE the recording stops, so a recording carries its run's
             // checker accounting (9.60.0).
@@ -1841,6 +1885,79 @@ class Agent extends RunnerBase_js_1.RunnerBase {
     identityFor(options, cp) {
         return options?.identity ?? cp.identity;
     }
+    /**
+     * A run's `time`, read into the turn's clock draft (the time layer) — or
+     * refused, before the turn starts: `time` on an agent without `.time()`, a
+     * malformed value, or no zone anywhere (the run's, else the builder's).
+     * `undefined` on an agent without the layer.
+     *
+     * @internal
+     */
+    clockDraftFor(time, runner) {
+        const passed = this.passedTimeFor(time, runner);
+        if (this.timeOptions === undefined)
+            return undefined;
+        const draft = (0, clock_js_1.draftClock)(passed, this.timeOptions);
+        if (draft === 'no-zone') {
+            throw new runInput_js_1.InvalidRunInputError({
+                runner,
+                received: 'a run with no time zone',
+                hint: "this agent's time layer needs the person's zone — pass run({ message, time: { zone: " +
+                    "'America/Los_Angeles' } }) or declare a fallback with .time({ zone }); the server's " +
+                    'zone is never used',
+            });
+        }
+        return draft;
+    }
+    /**
+     * The clock draft seed stamps (the time layer): the one `run()` read — or,
+     * for a turn this agent's `run()` did not start (its chart mounted in a
+     * composition, which passes no `time`), the builder's fallback zone with
+     * the turn's start as `now` (`zoneSource: 'builder'`, `nowSource:
+     * 'default'` — the same record a `run()` with no `time` files). With no
+     * fallback zone that turn is refused, as `run()` refuses it: the server's
+     * zone is never used.
+     *
+     * @internal
+     */
+    seedClockDraft() {
+        if (this.runClockDraft !== undefined)
+            return this.runClockDraft;
+        const draft = (0, clock_js_1.draftClock)(undefined, this.timeOptions ?? {});
+        if (draft === 'no-zone') {
+            throw new runInput_js_1.InvalidRunInputError({
+                runner: 'Agent (mounted in a composition)',
+                received: 'a turn with no time zone',
+                hint: "this agent's time layer needs the person's zone, and a composition passes no time to " +
+                    "the agents it mounts — declare a fallback with .time({ zone: 'America/Los_Angeles' }); " +
+                    "the server's zone is never used",
+            });
+        }
+        return draft;
+    }
+    /**
+     * A `time` passed to a run or a resume, read — or refused by name: passed to
+     * an agent without `.time()` (a door that ignored it would look configured
+     * and do nothing), or malformed.
+     *
+     * @internal
+     */
+    passedTimeFor(time, runner) {
+        if (time === undefined)
+            return undefined;
+        if (this.timeOptions === undefined) {
+            throw new runInput_js_1.InvalidRunInputError({
+                runner,
+                received: 'time',
+                hint: 'this agent reads no clock — arm the time layer with .time() to pass time',
+            });
+        }
+        const read = (0, clock_js_1.readRunTime)(time);
+        if ('problem' in read) {
+            throw new runInput_js_1.InvalidRunInputError({ runner, received: 'a malformed time', hint: read.problem });
+        }
+        return read.value;
+    }
     /**
      * Install a per-run checkpoint tracker. Listens for the agent's
      * own iteration_end events on `this.dispatcher` and snapshots the
@@ -1936,6 +2053,11 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         // answer is a value (often a string) and must stay accepted, so the only
         // sound question is "what was asked?".
         (0, callerIdentity_js_1.assertIdentityShape)(options?.identity, 'Agent.resume');
+        // A resume's `time` (the time layer) is read or refused before anything
+        // moves; it is never applied — the paused turn's clock is kept, and a
+        // differing value is recorded by the ToolCalls resume door.
+        const passedTime = this.passedTimeFor(options?.time, 'Agent.resume');
+        options = withoutTime(options);
         const gate = (0, pause_js_1.pauseDemandsDecision)(checkpoint.pauseData);
         if (gate && !(0, checkin_js_1.isCheckInDecision)(input))
             throw new pause_js_1.DecisionRequiredError(gate, input);
@@ -1967,7 +2089,7 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         let answeredAsk;
         if (awaitingInput !== undefined) {
             this.assertNotRunning('Agent.resume');
-            const answered = (0, inputRequest_js_1.applyInputResponse)(awaitingInput, input);
+            const answered = (0, inputRequest_js_1.applyInputResponse)(awaitingInput, input, this.timeAnswerContextOf(checkpoint.sharedState));
             if ('cancel' in answered) {
                 throw new TypeError('[input request] Cancel a hosted request through its host, or abandonPause() before starting another run.');
             }
@@ -2048,6 +2170,8 @@ class Agent extends RunnerBase_js_1.RunnerBase {
         this.lastRunAnswer = undefined;
         // One run can never raise on another run's consent block.
         this.consentOutstanding.clear();
+        // Beside the `try` whose `finally` clears it (the fresh-run path's terms).
+        this.resumePassedTime = passedTime;
         try {
             const result = await executor.resume(checkpoint, input, resumeOptions);
             const finalized = this.finalizeResult(executor, result);
@@ -2067,6 +2191,8 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             throw cause;
         }
         finally {
+            // A resume's passed `time` ends with the resume (the fresh-run path's terms).
+            this.resumePassedTime = undefined;
             // Same terms as the fresh-run path: rows on every exit, before the
             // recording stops (9.60.0).
             this.fileIntegrityDisposition();
@@ -2242,6 +2368,26 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             return undefined;
         return structuredClone(spans);
     }
+    /**
+     * What the resume door checks a time field's answer with (the time design
+     * § 6.2, step T4): the paused turn's clock zone — the kept `clock` row, so
+     * a resume that passes another `time` changes nothing — and the app's
+     * catalog overrides. `undefined` without `.time()`: a `format` field is
+     * then judged for shape, order and offset only, in the default words.
+     *
+     * @internal
+     */
+    timeAnswerContextOf(state) {
+        if (this.timeOptions === undefined)
+            return undefined;
+        const ledger = state?.findingsLedger;
+        const zone = (0, rows_js_1.clockOf)(Array.isArray(ledger) ? ledger : undefined)?.zone;
+        const messages = this.timeOptions.messages;
+        return {
+            ...(zone !== undefined && { zone }),
+            ...(messages !== undefined && { messages }),
+        };
+    }
     /**
      * The findings ledger for a checkpoint (9.101.0) — `foldedSpansOf`'s twin:
      * one reader for `checkpoint()` and the crash carrier, `undefined` when the
@@ -3683,6 +3829,16 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             get honestyLayers() {
                 return seededHonestyLayers;
             },
+            // The time layer's clock: the draft `run()` read (refusing a run with no
+            // zone), stamped by seed as the turn's one `clock` row. Absent → the
+            // deps object seed always had.
+            ...(this.timeOptions !== undefined && { timeClock: () => this.seedClockDraft() }),
+            // The time layer's reader: seed reads the person's words once per turn,
+            // after the clock. Absent → nothing is read.
+            ...(this.timeOptions?.reader !== undefined &&
+                this.timeOptions.policy !== undefined && {
+                timeReader: { reader: this.timeOptions.reader, policy: this.timeOptions.policy },
+            }),
             // Declared sources (honesty layer 2): the seed twin plants `_findings.from`
             // on ruled tools, and the run's `messageFrom` constant is written — only
             // under the arm (refused at build without the inputs layer).
@@ -3937,6 +4093,10 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             });
             ledgerRestoreArmed = true;
         }
+        // The time layer's rows ride the same ledger: a continued conversation
+        // keeps its earlier turns' clocks (each turn files its own).
+        if (this.timeOptions !== undefined)
+            ledgerRestoreArmed = true;
         // The gate's admissible set, for the record (9.50.0): declared hops from
         // the cursor plus the open skills — the SAME two resolvers the read_skill
         // offer and the refusal messages are built from (`readSkillOfferFor`),
@@ -4152,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
@@ -4203,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
@@ -4369,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, 
@@ -4552,6 +4729,28 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             // never allocates it.
             currentRun: () => this.toolRunFacts(),
             answeredAsk: () => this.answeredAsk,
+            // The time layer: each dispatched call files its `call` row, and the
+            // resume door compares a resume's passed `time` with the kept clock.
+            ...(this.timeOptions !== undefined && {
+                time: {
+                    takePassedOnResume: () => {
+                        const passed = this.resumePassedTime;
+                        this.resumePassedTime = undefined;
+                        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),
             toolSessions: () => this.toolSessions(),
             // 8.6.0 — what a run does when a declared credential needs 3LO consent.
@@ -4643,6 +4842,13 @@ class Agent extends RunnerBase_js_1.RunnerBase {
                 inputsLayer: {
                     toolOf: (toolName) => resolveForLayer(toolName).tool,
                     ...(this.toolMiddleware.length > 0 && { rewrites: true }),
+                    // The time layer (step T5a): a tool whose period declares forms is filled from the
+                    // turn's one window, bound to the person's window, or recorded as the model's.
+                    ...(this.timeOptions !== undefined && {
+                        time: {
+                            ...(this.timeOptions.zone !== undefined && { appZone: this.timeOptions.zone }),
+                        },
+                    }),
                     // Declared sources: the layer reads `_findings.from` and checks it against
                     // the corpora the mount hands in — the app's `externalGrounds` among them.
                     ...(argumentSources && {
@@ -4703,6 +4909,12 @@ class Agent extends RunnerBase_js_1.RunnerBase {
             // gets the stage that appends nothing and carries the limits as data.
             ...(this.limitsTravelWithTheAnswerValue && !limitsAsData && { attachCoverageLimits: true }),
             ...(limitsAsData && { coverageLimitsAsData: true }),
+            // 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
@@ -4766,4 +4978,16 @@ function boundInsertionOrder(held, max) {
         held.delete(oldest.value);
     }
 }
+/**
+ * The run options without the time layer's `time` — what the engine is handed.
+ * The SAME object when it carries no `time` key, so a run that passed none
+ * hands the executor exactly the options it always did.
+ */
+function withoutTime(options) {
+    if (options === undefined || !('time' in options))
+        return options;
+    const { time: _time, ...rest } = options;
+    void _time;
+    return rest;
+}
 //# sourceMappingURL=Agent.js.map