agentfootprint 9.128.1 → 9.131.0

package/dist/types/core/agent/arguments/declare.d.ts

@@ -34,12 +34,24 @@
  *
  * Which argument bounds the period the answer covers, and how its values are
  * SPELLED: `lookback` (`30m`, `24h`, `7d`, `2w`), `signed-lookback` (`-24h`),
- * or `iso-range` (two ISO 8601 instants joined by `..`). Declared formats, never
- * phrases: the library checks a value parses under its spelling and never turns
- * one into a duration. A period on an argument with no rule is refused
- * (adopted Q13): a period argument is exactly what a rule is for.
+ * `iso-range` (two ISO 8601 instants joined by `..`) or `wall-range` (two wall
+ * times joined by `..`, with the zone in `zoneArgument`). Declared formats,
+ * never phrases. A period on an argument with no rule is refused (adopted
+ * Q13): a period argument is exactly what a rule is for.
+ *
+ * Since the time layer's step T5a the single-argument form is SUGAR over
+ * `forms` (`core/time/convert.ts` · `sugarForms`): a tool declares every shape
+ * its period takes — two arguments (`bounds`), one joined string, an object, a
+ * `day`, a look-back with its `units` — and the facts about its source
+ * (`direction`, `retention`, `maxRange`, `granularity`, `filtersToAsked`).
+ * Under `.time()` the library fills a period the model left out from the
+ * turn's one window, binds a sent one to the person's window, and hands the
+ * tool `ctx.time` (`core/time/bind.ts`). Without `.time()` a period is judged
+ * and read exactly as before.
  */
 import { type InputValue } from '../../inputRequest.js';
+import { PERIOD_SPELLINGS, type PeriodDirection, type PeriodFacts, type PeriodForm, type PeriodSpelling } from '../../time/periodForm.js';
+import { type DurationText } from '../../time/duration.js';
 /**
  * One allowed answer to an `ask` rule: a bare value, or a value with phrases
  * the author vouches for as meaning it (`{ value: '7d', said: ['last week'] }`).
@@ -65,25 +77,51 @@ export type ArgumentRule = {
 };
 /** Per argument name, its rule. Arguments with no rule run free. */
 export type AskOrAssume = Readonly<Record<string, ArgumentRule>>;
-/** The declared formats a period argument's values may be spelled in. */
-export type PeriodSpelling = 'lookback' | 'signed-lookback' | 'iso-range';
+export type { PeriodSpelling, PeriodForm, PeriodFacts } from '../../time/periodForm.js';
+export { PERIOD_SPELLINGS };
 /**
- * Which argument sets the period a tool's answer covers, and how its values
- * are spelled. The one period shape's TOOL half; the result half
- * (`DeclaredPeriod`: what a read queried and what the store holds) belongs to
- * the result doors.
+ * Which arguments set the period a tool's answer covers, how their values are
+ * spelled, and the facts about the source. The one period shape's TOOL half;
+ * the result half (`DeclaredPeriod`: what a read queried and what the store
+ * holds) belongs to the result doors.
+ *
+ * Two ways to name the shape, never both: today's single argument
+ * (`argument` + `spelling`, or `accepts` for several spellings, and
+ * `zoneArgument` beside a `wall-range`), which is sugar over the general
+ * `forms` — every shape the tool accepts, in preference order.
  *
  * @example
  * ```ts
  * period: { argument: 'window', spelling: 'lookback' }  // '2h', '24h', '7d'
+ * period: {
+ *   forms: [{ kind: 'bounds',
+ *             from: { argument: 'start_time', as: 'epoch-ms' },
+ *             to:   { argument: 'end_time',   as: 'epoch-ms', edge: 'exclusive' } }],
+ *   direction: 'past', retention: '30d',
+ * }
  * ```
  */
 export interface ToolPeriod {
-    readonly argument: string;
+    readonly argument?: string;
     readonly spelling?: PeriodSpelling;
+    /** Every single-argument spelling the argument takes, in preference order. */
+    readonly accepts?: readonly PeriodSpelling[];
+    /** The argument that carries the zone of a `wall-range`. */
+    readonly zoneArgument?: string;
+    readonly forms?: readonly PeriodForm[];
+    /** A `wall` / `date` / `day` form with no zone argument reads in the app's `.time({ zone })` — explicit, never implied. */
+    readonly wallZone?: 'app';
+    /** Which side of now the source can hold; absent: not checked. */
+    readonly direction?: PeriodDirection;
+    /** The oldest data the source keeps (`30d`). */
+    readonly retention?: DurationText;
+    /** The widest window the tool accepts at once (`24h`). */
+    readonly maxRange?: DurationText;
+    /** The source's smallest step (`1m`). */
+    readonly granularity?: DurationText;
+    /** The tool reads `ctx.time.asked` and drops rows outside it. */
+    readonly filtersToAsked?: boolean;
 }
-/** The spellings, in the order the docs list them. */
-export declare const PERIOD_SPELLINGS: readonly PeriodSpelling[];
 /** The JSON Schema types a ruled argument may have — flat primitives only (v1). */
 export declare const RULED_TYPES: readonly string[];
 /** An `ask` question's bound — the typed ask's own (`core/inputRequest.ts`). */
@@ -122,8 +160,10 @@ export declare function sameArgumentValue(a: unknown, b: unknown): boolean;
  * Whether `value` is spelled the way `spelling` declares. `lookback` is a
  * positive integer and a unit (`m`, `h`, `d`, `w`); `signed-lookback` the
  * same with a leading minus; `iso-range` two ISO 8601 instants WITH a zone,
- * joined by `..`. A format check, never a conversion: nothing is ever turned
- * into a duration, and no instant is compared with "now".
+ * joined by `..`, each a day that exists (`2026-02-30` and hour `24` are
+ * refused — `Date.parse` used to roll them forward). A format check, never a
+ * conversion: nothing is ever turned into a duration, and no instant is
+ * compared with "now".
  */
 export declare function parsesUnderSpelling(value: unknown, spelling: PeriodSpelling): boolean;
 /**
@@ -138,6 +178,8 @@ export declare function parsesUnderSpelling(value: unknown, spelling: PeriodSpel
 export declare function convertSpelling(value: InputValue, from: PeriodSpelling, to: PeriodSpelling): InputValue | undefined;
 declare class DeclarationRefused extends Error {
 }
+/** Forms per period — a tool spells its period in a handful of shapes, never dozens. */
+export declare const MAX_PERIOD_FORMS = 8;
 /**
  * Judge a tool's `askOrAssume` and `period`, at definition — and again at
  * dispatch (`rulesOf`) and at MCP ingest, by this same function. Throws an
@@ -199,6 +241,25 @@ export interface ToolRules {
     readonly ruled: readonly RuledArgument[];
     readonly period?: ToolPeriod;
 }
+/**
+ * Every form a tool's period takes, the sugar read (`core/time/convert.ts` ·
+ * `sugarForms`) — empty when it declares none, or names an argument and no
+ * spelling.
+ */
+export declare function periodFormsOf(period: ToolPeriod | undefined): readonly PeriodForm[];
+/**
+ * Every argument a period names — the single argument, or each form's bound,
+ * object and zone arguments. What a row's `period: true` marks.
+ */
+export declare function periodArgumentsOf(period: ToolPeriod | undefined): ReadonlySet<string>;
+/**
+ * The ONE argument a period is known by — the single `argument`, else the
+ * first form's first bound. The results layer's join key (a `period` row names
+ * it, and joins the call's `argument` row by it).
+ */
+export declare function periodArgumentOf(period: ToolPeriod | undefined): string | undefined;
+/** The facts a period declares about its source, only those it declares. */
+export declare function periodFactsOf(period: ToolPeriod | undefined): PeriodFacts;
 /** Why a tool's rules could not be read — the assert's own sentence. */
 export interface RulesRefused {
     readonly refused: string;

package/dist/types/core/agent/arguments/declare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"declare.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/declare.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"declare.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/declare.ts"],"names":[],"mappings":"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"}

package/dist/types/core/agent/arguments/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAIL,kBAAkB,EAElB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE;IAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,EACvE,SAAS,EAAE,MAAM,GAChB,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAQzC;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAM9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACpD,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAC/D,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAAG,SAAS,GACzC,SAAS,MAAM,EAAE,CAUnB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAAG,SAAS,GACzC,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,OAAO,EAAE,QAAQ,GAChB,SAAS,YAAY,EAAE,CAGzB;AAaD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,OAAO,EAAE,QAAQ,EACjB,QAAQ,CAAC,EAAE,QAAQ,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAiBR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAgBzF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,IAAI,EAAE,SAAS,kBAAkB,EAAE,GAClC,SAAS,kBAAkB,EAAE,CAE/B;AAKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAIL,kBAAkB,EAElB,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE;IAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAAE,EACvE,SAAS,EAAE,MAAM,GAChB,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAQzC;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,kBAAkB,GAAG,SAAS,GAAG,QAAQ,CAM9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACpD,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAC/D,IAAI,CAgBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAAG,SAAS,GACzC,SAAS,MAAM,EAAE,CAcnB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,EAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,kBAAkB,GAAG,SAAS,GACzC,MAAM,CAER;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,OAAO,EAAE,QAAQ,GAChB,SAAS,YAAY,EAAE,CAGzB;AAaD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,UAAU,EAAE,kBAAkB,GAAG,SAAS,EAC1C,OAAO,EAAE,QAAQ,EACjB,QAAQ,CAAC,EAAE,QAAQ,EACnB,OAAO,CAAC,EAAE,YAAY,GACrB,MAAM,CAuCR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAgBzF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,GAAG,SAAS,EACtB,IAAI,EAAE,SAAS,kBAAkB,EAAE,GAClC,SAAS,kBAAkB,EAAE,CAE/B;AAKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYzD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}

package/dist/types/core/agent/arguments/resolve.d.ts

@@ -58,6 +58,10 @@
  * and never repaired.
  */
 import type { InputValue } from '../../inputRequest.js';
+import { type CallWindow, type TurnWindows, type WindowSource } from '../../time/bind.js';
+import type { InstantText } from '../../time/instant.js';
+import type { CallWindowRow } from '../../time/rows.js';
+import type { ZoneName } from '../../time/zone.js';
 import { type SourceCheck, type SourceCorpus } from './checks.js';
 import { type RuledToolLike } from './declare.js';
 import { type KeptAnswer } from './kept.js';
@@ -128,6 +132,28 @@ export interface CheckedArgument {
      * reads `'REDACTED'` on the row and rides no ask.
      */
     readonly quoteShown?: true;
+    /**
+     * Under `.time()`: the library fills the value from the turn's ONE window of
+     * the person's (`core/time/bind.ts`) — who that window is. Set with `filled`.
+     */
+    readonly window?: WindowSource;
+}
+/**
+ * Under `.time()` (the time layer, step T5a): the turn's windows and clock, as
+ * the record holds them — the `time-reading` rows and the `clock` row of this
+ * turn, read by `core/time/bind.ts` · `turnWindowsOf`. A tool whose period
+ * declares forms is then filled from the turn's one window, bound to the
+ * person's window, or recorded as the model's (`callWindowOf`). Absent → the
+ * arm is off and every call is resolved exactly as before.
+ */
+export interface TimeArm {
+    readonly turn: TurnWindows;
+    /** The turn's frozen clock. */
+    readonly now: InstantText;
+    /** The clock's zone. */
+    readonly zone: ZoneName;
+    /** The app's `.time({ zone })` — a form declaring `wallZone: 'app'` reads in it. */
+    readonly appZone?: ZoneName;
 }
 /**
  * The declared sources, as the layer's stages are handed them: each call's
@@ -150,13 +176,36 @@ export interface SourcesArm {
 }
 /**
  * One value the library fills into a call, raw: the declared default
- * (`default`), or the person's answer to the batch ask (`answered`).
+ * (`default`), the person's answer to the batch ask (`answered`), or — under
+ * `.time()` — the turn's one window of the person's, converted into the tool's
+ * form (`window`; `from` says whose window: their words, a model reader's
+ * reading, a UI control). A window fill of an `object` form is an object.
  */
-export interface ArgumentFill {
+export type ArgumentFill = {
     readonly argument: string;
     readonly value: InputValue;
-    readonly source: 'default' | 'answered';
-}
+    readonly source: 'default';
+} | {
+    readonly argument: string;
+    /** A window answered for an `object` form is an object (the lazy word-driven ask). */
+    readonly value: InputValue | Readonly<Record<string, InputValue>>;
+    readonly source: 'answered';
+    /** The value was written by the library from the WINDOW the person chose (the lazy word-driven ask). */
+    readonly window?: true;
+    /** …and no form held that window exactly, so it reads a wider one (as a `window` fill's `wider`). */
+    readonly wider?: 'reads-more' | 'tool-trims';
+} | {
+    readonly argument: string;
+    readonly value: InputValue | Readonly<Record<string, InputValue>>;
+    readonly source: 'window';
+    readonly from: WindowSource;
+    /**
+     * No form holds the window exactly, so the value reads a WIDER one (step
+     * T5b): `reads-more` — the call reads parts nobody asked for;
+     * `tool-trims` — the tool declares `filtersToAsked` and drops them.
+     */
+    readonly wider?: 'reads-more' | 'tool-trims';
+};
 /**
  * What ToolCalls applies to ONE call of the batch the layer resolved: the
  * values to fill, or the sentence the call reads instead of running. Working
@@ -190,6 +239,14 @@ export interface ArgumentResolution {
         readonly argument: string;
         readonly quote: string;
     }[];
+    /**
+     * Under `.time({ reader })`: the call left its period out while the turn's
+     * one mention was still OPEN (`core/time/bind.ts` · `not-filled` /
+     * `open-reading`) — its period arguments in `ask` are asked as that
+     * mention's window, in one field for the batch (`ask.ts` · `planAskFields`,
+     * the lazy word-driven ask of time design § 5.2), not one by one.
+     */
+    readonly window?: true;
 }
 /**
  * Every call of the batch whose tool carries rules — read through `rulesOf`,
@@ -200,6 +257,19 @@ export interface ArgumentResolution {
  * arguments: that argument is planned FREE, to be checked and filed.
  */
 export declare function declareBatch(calls: readonly BatchCall[], toolOf: ToolOf, sources?: SourcesArm): PlannedCall[];
+/**
+ * Under `.time()`: per planned call whose tool's period declares forms, which
+ * window the call carries (`core/time/bind.ts` · `callWindowOf`) — a pure
+ * function of the call, the tool's forms and facts, the turn's windows and the
+ * model's declared quotes. Empty when the arm is off. Every stage asks it
+ * afresh (the same inputs, the same answer), so no decision is staged twice.
+ */
+export declare function timeDecisionsOf(plan: readonly PlannedCall[], calls: readonly BatchCall[], toolOf: ToolOf, time: TimeArm | undefined, sources?: SourcesArm): ReadonlyMap<string, CallWindow>;
+/** The `call-window` rows for this batch's decisions, in batch order (`core/time/rows.ts`). */
+export declare function callWindowRowsOf(decisions: ReadonlyMap<string, CallWindow>, calls: readonly BatchCall[], stamp: {
+    readonly turn: number;
+    readonly iteration: number;
+}): CallWindowRow[];
 /**
  * Where each ruled value of each planned call came from, by the table above.
  * Unarmed (no `sources`), a present value either IS the declared default (an
@@ -210,7 +280,7 @@ export declare function declareBatch(calls: readonly BatchCall[], toolOf: ToolOf
  * names — is checked (`checks.ts` · `checkSource`), and an untraced value on
  * an `ask` rule is asked about (`asked: 'unverified'`).
  */
-export declare function verifyPlan(plan: readonly PlannedCall[], calls: readonly BatchCall[], toolOf: ToolOf, kept?: readonly KeptAnswer[], sources?: SourcesArm): CheckedArgument[];
+export declare function verifyPlan(plan: readonly PlannedCall[], calls: readonly BatchCall[], toolOf: ToolOf, kept?: readonly KeptAnswer[], sources?: SourcesArm, time?: TimeArm): CheckedArgument[];
 /**
  * One row per checked argument, its value in the tool's OWN argument view
  * (`shownArgsOf`) — a fill is shown as the call will run with it, a model's
@@ -226,7 +296,7 @@ export declare function verifyPlan(plan: readonly PlannedCall[], calls: readonly
 export declare function rowsOf(checked: readonly CheckedArgument[], calls: readonly BatchCall[], toolOf: ToolOf, stamp: {
     readonly turn: number;
     readonly iteration: number;
-}, kept?: readonly KeptAnswer[], sources?: SourcesArm): ArgumentRow[];
+}, kept?: readonly KeptAnswer[], sources?: SourcesArm, decisions?: ReadonlyMap<string, CallWindow>): ArgumentRow[];
 /**
  * What ToolCalls applies: per call, the declared defaults and the kept answers
  * to fill and the `ask` arguments to ask the person for (with, under declared
@@ -234,5 +304,5 @@ export declare function rowsOf(checked: readonly CheckedArgument[], calls: reado
  * rules could not be read — the sentence it reads instead of running. Nothing
  * for a call that runs as the model sent it.
  */
-export declare function resolutionsOf(plan: readonly PlannedCall[], checked: readonly CheckedArgument[], toolOf: ToolOf, iteration: number, kept?: readonly KeptAnswer[], sources?: SourcesArm): ArgumentResolution[];
+export declare function resolutionsOf(plan: readonly PlannedCall[], checked: readonly CheckedArgument[], toolOf: ToolOf, iteration: number, kept?: readonly KeptAnswer[], sources?: SourcesArm, decisions?: ReadonlyMap<string, CallWindow>): ArgumentResolution[];
 //# sourceMappingURL=resolve.d.ts.map

package/dist/types/core/agent/arguments/resolve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAyB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAML,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,cAAc,CAAC;AAEhE,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD;AAED,mFAAmF;AACnF,MAAM,MAAM,MAAM,GAAG,CACnB,QAAQ,EAAE,MAAM,KACb,CAAC,aAAa,GAAG;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,GAAG,SAAS,CAAC;AAElF,6FAA6F;AAC7F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,sGAAsG;AACtG,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IACvB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC/E;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC1C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACpD,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpF;AAeD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,UAAU,GACnB,WAAW,EAAE,CA2Bf;AA2HD;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,EAC5B,OAAO,CAAC,EAAE,UAAU,GACnB,eAAe,EAAE,CAiEnB;AAmHD;;;;;;;;;;;GAWG;AACH,wBAAgB,MAAM,CACpB,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC5D,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,EAC5B,OAAO,CAAC,EAAE,UAAU,GACnB,WAAW,EAAE,CAqBf;AAkBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,WAAW,EAAE,EAC5B,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,EAC5B,OAAO,CAAC,EAAE,UAAU,GACnB,kBAAkB,EAAE,CA4CtB"}
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/resolve.ts"],"names":[],"mappings":"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"}

package/dist/types/core/agent/arguments/rows.d.ts

@@ -89,7 +89,14 @@ export interface ArgumentRow {
      */
     readonly proposed?: string;
     readonly claimed?: ArgumentClaim;
-    readonly matched?: 'quote' | 'phrase' | 'spelling';
+    /**
+     * How the value was traced to its source: the quote holds it, a declared
+     * phrase names it, an earlier answer in another spelling — or, under
+     * `.time()`, it IS the window of a mention the reader recorded (`mention`:
+     * the library filled it from that window, or the model's quote named that
+     * mention and its value equals the window).
+     */
+    readonly matched?: ArgumentMatched;
     /**
      * The model's `quote`, clipped (`QUOTE_CHARS`) — `'REDACTED'` on an agent
      * where ANY tool in reach can hide arguments (it registers a tool that
@@ -108,7 +115,10 @@ export interface ArgumentRow {
     readonly malformed?: number;
     readonly failed?: ArgumentCheckFailed;
 }
+/** How a traced value was matched — see {@link ArgumentRow.matched}. */
+export type ArgumentMatched = 'quote' | 'phrase' | 'spelling' | 'mention';
 /** The closed vocabularies, for the checkpoint door and the event. */
+export declare const ARGUMENT_MATCHED: readonly ArgumentMatched[];
 export declare const ARGUMENT_SOURCES: readonly ArgumentSource[];
 export declare const ARGUMENT_ASKED: readonly ArgumentAsked[];
 export declare const ARGUMENT_CLAIMS: readonly ArgumentClaim[];
@@ -176,6 +186,25 @@ export declare function argumentRowOf(verdict: ArgumentVerdict, stamp: {
     readonly turn: number;
     readonly iteration: number;
 }): ArgumentRow;
+/**
+ * The row for a value the library filled from the turn's ONE window of the
+ * person's (the time layer, `core/time/bind.ts`): from the window the person
+ * settled in the time ask (`answered`, `matched: 'mention'`), from a `model`
+ * reader's unconfirmed reading of their words (`said`, `matched: 'mention'`
+ * and `reading` — it can support "not sure", never "known"), or from a window
+ * set in a UI (`app`, `appSource: 'time.window'`). A `said` window with no
+ * `reading` is read back only from a record an earlier version filed. The
+ * call's `call-window` row names the window and the form.
+ */
+export declare function windowRowOf(who: ArgumentIdentity & {
+    readonly shownValue: unknown;
+    readonly window: 'said' | 'derived-from-reading' | 'answered' | 'control';
+}, stamp: {
+    readonly turn: number;
+    readonly iteration: number;
+}): ArgumentRow;
+/** The `appSource` of a value filled from the run's `time.window` (a UI control). */
+export declare const TIME_WINDOW_SOURCE = "time.window";
 /**
  * A quote's bound on a row — the bound a basis row's one-line texts carry
  * (`findings/types.ts` · `PROPOSITION_CHARS`, which this leaf cannot import),
@@ -208,7 +237,7 @@ export interface SourcedVerdict {
     /** The model's own value, in the shown view — on a `default` row (V1) and an asked row. */
     readonly shownProposed?: unknown;
     readonly claimed: ArgumentClaim;
-    readonly matched?: 'quote' | 'phrase' | 'spelling';
+    readonly matched?: ArgumentMatched;
     /** The model's quote — `'REDACTED'` while any tool in reach can hide arguments (`resolve.ts` · `quotesMayShow`). */
     readonly shownQuoteText?: string;
     readonly reading?: true;

package/dist/types/core/agent/arguments/rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/rows.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/rows.ts"],"names":[],"mappings":"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"}

package/dist/types/core/agent/arguments/serve.d.ts

@@ -28,8 +28,12 @@
  */
 import type { LLMToolSchema } from '../../../adapters/types.js';
 import type { InputValue } from '../../inputRequest.js';
-import { ASSUMED_BLOCK_HEADING } from '../coverage/answer.js';
+import { ASSUMED_BLOCK_HEADING, type TimeLimitLines } from '../coverage/answer.js';
+import type { TimeLimitFacts } from '../coverage/timeLimitFacts.js';
 import { type RuledToolLike } from './declare.js';
+import { type PeriodFacts, type TimeRefusal } from '../../time/convert.js';
+import type { ReaderWindows } from '../../time/bind.js';
+import type { ZoneName } from '../../time/zone.js';
 /** A declared value as a sentence prints it: a string quoted, a number or boolean bare. */
 export declare function printedValue(value: InputValue): string;
 /**
@@ -108,13 +112,123 @@ export declare function withArgumentRules(schema: LLMToolSchema, tool: RuledTool
  * tool whose author owns `_findings`, which does not.
  */
 export declare function rulesOnWire(served: readonly LLMToolSchema[], winningTools: ReadonlyMap<string, RuledToolLike>, optionsOf?: (schema: LLMToolSchema) => ServeOptions | undefined): readonly LLMToolSchema[];
+/**
+ * What the served line reads: the turn's SETTLED windows of the person's
+ * words (`core/time/windows.ts` · `readerWindowsOf` — each mention's quote and
+ * its one window: the one the person confirmed or gave in the time ask, or a
+ * `model` reader's reading), the quotes still PENDING (a proposal the person
+ * has not answered), the turn's clock, and the app's `.time({ zone })`. An
+ * unreadable mention is in neither list.
+ */
+export interface ServedWindows extends ReaderWindows {
+    readonly appZone?: ZoneName;
+}
+/**
+ * The ONE served time line (TQ13; step T6b's serving placement): one
+ * request-only `user` line appended LAST to the request, at the decision
+ * point — composed at the tools slot's one decoration site
+ * (`core/slots/buildToolsSlot.ts` · `commitWire`) from the tools it really
+ * serves, carried to `callLLM` on `timeLine`, and rebuilt by
+ * `lib/time-travel/servedView.ts` from the same committed key. Two halves:
+ *
+ * - SETTLED — each window the person confirmed or gave in the time ask (or a
+ *   `model` reader's reading), in the person's zone, WHOSE it is, and each
+ *   served period tool's values for it — the exact conversion, else the wider
+ *   one the fill would use (said so); a value the tool's view hides is named
+ *   hidden. So the model never re-derives a window from words, and the answer
+ *   states the window it was built on.
+ * - PENDING — a proposal the person has not answered is no window yet, and a
+ *   call that writes its own window runs as sent, unconfirmed (§ 7.3). The
+ *   line names the next step — the call with the period arguments left out,
+ *   so the library's own form confirms the window with the person — and the
+ *   two moves that are not it (a question about the time in the reply, a
+ *   written window). Once a call of the turn already ran on a written window
+ *   (`ranUnconfirmed`), it names the limit an answer states instead.
+ *
+ * `undefined` when no served tool declares a period or neither half has
+ * anything to say — a turn with no time words serves no line at all.
+ *
+ * @example
+ * ```ts
+ * timeWindowsLine(served, winningTools, { now, windows: [], pending: ['yesterday'] });
+ * // 'The window for “yesterday” is not settled yet: the person confirms it in the library's own
+ * //  form, which shows its reading of those words with the zone and opens when client_activity
+ * //  is called with start_time, end_time left out (or the call is refused with the reason). So
+ * //  the next step is that call — not a question about the time in the reply, and not a window
+ * //  written into the call, which would run unconfirmed.'
+ * ```
+ */
+export declare function timeWindowsLine(served: readonly LLMToolSchema[], winningTools: ReadonlyMap<string, RuledToolLike>, windows: ServedWindows): string | undefined;
+/**
+ * The served time limits from the Tools mount's `timeLimits` FACTS
+ * (`coverage/timeLimitFacts.ts` · `TimeLimitFacts`): rendered for the MODEL
+ * (`coverage/timeLimits.ts` · `renderTimeLimits` — the one composer the
+ * limits block asks too), then {@link timeLimitsSentence}. The facts cross
+ * the mount unrendered so the renderer loads here, under the arm, and never
+ * on the graph a plain agent loads.
+ *
+ * @example
+ * ```ts
+ * timeLimitsLine(undefined); // undefined — the turn's reads match what was asked
+ * ```
+ */
+export declare function timeLimitsLine(facts: TimeLimitFacts | undefined): string | undefined;
+/**
+ * The time limits an answer states (time step T8's serving placement): the
+ * result checks that hold this turn — a read narrower, wider or shifted from
+ * what was asked, a window older than the source keeps, sources on different
+ * clocks — served to the MODEL as the library's conclusion, LATE, at the
+ * decision point, in the ONE served time line (TQ13) after the windows'
+ * halves. The step-7b bench showed why: raw facts on a result are not
+ * compared by the model, a conclusion served at the decision point is.
+ *
+ * `undefined` when nothing holds — a turn whose reads match what was asked
+ * serves no sentence at all.
+ *
+ * @example
+ * ```ts
+ * timeLimitsSentence({ period: ['client_activity read less than was asked — asked: …; read: …'], clocks: [] });
+ * // "[A note from the library that ran the tools, not from the person: answer the person directly,
+ * //  as you would from the tool results alone.] The time the tools read is not the time asked about — client_activity read less than was asked —
+ * //  asked: …; read: …. So the answer to the person states the time each result read and claims
+ * //  nothing about time no result read."
+ * ```
+ */
+export declare function timeLimitsSentence(lines: TimeLimitLines | undefined): string | undefined;
+/**
+ * The line's opening: WHO says it. The line is a request-only `user`
+ * message, and the T8 bench's first paid round (stopped at 41 runs) showed
+ * the model reading an unmarked one as the person correcting it — 15 of 15
+ * served answers opened "You're right" / "I apologize"; naming the library
+ * alone (round 1, stopped at 46) still drew "Thank you for the
+ * clarification". The opening now also says how to use it: answer the person
+ * directly, as from the tool results alone.
+ */
+export declare const TIME_LIMITS_SOURCE = "[A note from the library that ran the tools, not from the person: answer the person directly, as you would from the tool results alone.]";
 /** One filled argument, as the note names it. */
 export interface FilledArgument {
     readonly argument: string;
-    readonly value: InputValue;
+    /** A window fill of an `object` form is an object (printed as JSON). */
+    readonly value: InputValue | Readonly<Record<string, InputValue>>;
     readonly hidden: boolean;
-    /** `answered`: the person's answer to the batch ask filled it. Absent: the tool's rule assumed it. */
-    readonly source?: 'answered';
+    /**
+     * `answered`: the person's answer to the batch ask filled it. `window`: the
+     * turn's one window of the person's did (the time layer), `from` saying
+     * whose. Absent: the tool's rule assumed it.
+     */
+    readonly source?: 'answered' | 'window';
+    /**
+     * On a `window` fill: the person's words, a `model` reader's unconfirmed
+     * reading of them, a UI control — or the window the person CHOSE when the
+     * library asked about their words (`answered`, the lazy word-driven ask).
+     */
+    readonly from?: 'said' | 'derived-from-reading' | 'control' | 'answered';
+    /**
+     * On a `window` fill: no form held the window exactly, so the value reads a
+     * WIDER one (the time layer, step T5b) — `reads-more`, or `tool-trims` when
+     * the tool declares that it drops the rows outside the asked window.
+     */
+    readonly wider?: 'reads-more' | 'tool-trims';
     /**
      * The value the call had CARRIED, which the person's answer replaced
      * (declared sources: an untraced value is asked about). Absent: the call
@@ -180,6 +294,21 @@ export declare function unansweredRefusal(toolName: string, unanswered: readonly
  * not finish; nothing about it is decided for the person.
  */
 export declare function secondPauseRefusal(toolName: string, why: 'check-in' | 'tool-pause'): string;
+/**
+ * The result a call reads when it was refused BEFORE DISPATCH on its window
+ * (the time layer, step T5b — time design § 7.2): the window breaks one of the
+ * tool's declared facts, spans days for a tool that reads one day per call, or
+ * a sent wall time is one the zone's clocks skip. Splitting a window into
+ * several calls is the model's choice, never the library's.
+ *
+ * @example
+ * ```ts
+ * timeRefusal('search_logs', 'time-future', { direction: 'past' });
+ * // 'search_logs was not run on that call: the window it asked for had not happened yet, and the
+ * //  tool declares that its source holds only the past.'
+ * ```
+ */
+export declare function timeRefusal(toolName: string, refusal: TimeRefusal, facts: PeriodFacts, argument?: string): string;
 /**
  * The clause a refusal by the one-question law gains when the refused call
  * carried the person's answers: they were KEPT for the tool's next call that

package/dist/types/core/agent/arguments/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/serve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/arguments/serve.ts"],"names":[],"mappings":"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"}