agentfootprint 10.3.0 → 10.3.1

package/dist/esm/time/axis.js

@@ -0,0 +1,462 @@
+/**
+ * time/axis — a dataset's TIME AXIS: the declaration, its one judge, and
+ * the read-side view that turns the declared column into comparable instants.
+ *
+ * Pattern: declared, never guessed; judged at mint, never repaired; values
+ *          read through ONE view ({@link normaliseInstants}) that never
+ *          touches the stored rows. Moved here from `artifacts/timeAxis.ts`
+ *          (which `artifacts/index.ts` still re-exports), so the axis speaks
+ *          the time layer's one grammar: `interval` is a `duration.ts`
+ *          duration under {@link AXIS_UNITS}, `zone` is a `zone.ts` zone name.
+ * Role:    L0 leaf (the time layer's one owner). Imports `instant.ts`,
+ *          `duration.ts` and `zone.ts`. Asked by `artifacts/minting.ts` ·
+ *          `prepareArtifact` and `artifacts/datasetResult.ts` ·
+ *          `stageDatasetArtifacts` (the judge), and by any consumer that
+ *          compares a dataset's times (the view).
+ * Emits:   N/A.
+ *
+ * ## Why a producer declares it
+ *
+ * A table of rows is a time series only when one column IS time, and the
+ * reader of the rows cannot know that honestly: `ts` holding 1726000000 is
+ * epoch SECONDS to the tool that wrote it and a large integer to everything
+ * else; `'2026-09-14T10:00:00'` is UTC or the collector's wall clock. So the
+ * producer SAYS it, on the ticket (`PutArtifactInput.timeAxis`, carried on
+ * `ArtifactMeta.timeAxis`). A malformed declaration is REFUSED at mint
+ * ({@link timeAxisIssues}) — never trimmed or defaulted — and the shape is
+ * CLOSED: a misspelt `agg` is refused by name, never dropped.
+ *
+ * ## The view — values, not the declaration
+ *
+ * The judge never reads a value; {@link normaliseInstants} does, at read time.
+ * It turns the declared column into UTC `Z` instants spelled at ONE precision,
+ * so a lexicographic compare downstream is chronological, and it is honest
+ * about every value it could not place:
+ *
+ * | Value | Under | Read as |
+ * |-------|-------|---------|
+ * | a number | `epoch-s` / `epoch-ms` | that instant, exactly as written (no float rounding) |
+ * | ISO with `Z` or `±HH:MM` | `iso`, any zone | that instant (the lenient profile — a producer's spelling) |
+ * | ISO with NO offset | `iso`, no `zone` | **naive** — counted, never read as UTC; `status: 'naive-values'`, or refused under `naive: 'refuse'` |
+ * | ISO with no offset | `iso` + `zone` | a wall time in that zone; one instant, or — in a fall-back overlap — the row-order rule below; in a spring-forward gap, counted `dstGap` |
+ * | anything else | — | counted `unreadable` (`missing` when the row lacks the column) |
+ *
+ * **The fall-back rule.** In the hour the clocks go back, one wall time names
+ * two instants. Read in the rows' order, the values before the wall clock
+ * steps back take the earlier offset and those from the step on the later
+ * (a note `{ kind: 'dst-overlap', resolvedBy: 'row-order' }` per value). When
+ * the order cannot tell — a lone `01:30`, no step back, two steps back, or a
+ * column whose wall times are not in order anywhere — the value is counted
+ * `dstAmbiguous` and handled like a naive one. Nothing is picked silently.
+ *
+ * @example
+ * ```ts
+ * timeAxisIssues({ column: 'ts', unit: 'epoch-s', zone: 'UTC' }); // ['timeAxis.zone is for wall-clock ISO values; …']
+ * normaliseInstants([{ ts: 1726300800 }, { ts: 1726304400.5 }], { column: 'ts', unit: 'epoch-s' });
+ * // { status: 'instants', precision: 'millisecond',
+ * //   points: [{ row: 0, at: '2024-09-14T08:00:00.000Z' }, { row: 1, at: '2024-09-14T09:00:00.500Z' }], … }
+ * normaliseInstants([{ t: '2026-09-14T10:00:00' }], { column: 't', unit: 'iso' });
+ * // { status: 'naive-values', count: 1, points: [], … } — never read as UTC
+ * ```
+ */
+import { AXIS_UNITS, durationParts, isDuration } from './duration.js';
+import { instantOf, spellInstant } from './instant.js';
+import { isZoneName, readWall } from './zone.js';
+/** The closed sets, in one place, for the judge and for its own messages. */
+export const TIME_AXIS_UNITS = ['iso', 'epoch-s', 'epoch-ms'];
+export const TIME_AXIS_AGGREGATES = [
+    'avg',
+    'min',
+    'max',
+    'sum',
+    'count',
+    'last',
+];
+const KEYS = new Set(['column', 'unit', 'zone', 'interval', 'aggregate']);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isAggregate(value) {
+    return TIME_AXIS_AGGREGATES.includes(value);
+}
+/**
+ * THE ONE JUDGE of a time-axis declaration. Returns every problem, in words a
+ * producer can act on; an empty list means the declaration is well-formed.
+ * Never throws, never repairs, never reads a value.
+ */
+export function timeAxisIssues(value) {
+    if (!isRecord(value)) {
+        return [`timeAxis must be an object like { column, unit }, got ${describeValue(value)}.`];
+    }
+    const issues = [];
+    for (const key of Object.keys(value)) {
+        if (!KEYS.has(key)) {
+            issues.push(`timeAxis has an unknown key '${key}'; the keys are column, unit, zone, interval, aggregate.`);
+        }
+    }
+    const { column, unit, zone, interval, aggregate } = value;
+    if (typeof column !== 'string' || column.trim() === '') {
+        issues.push(`timeAxis.column must name the time column, got ${describeValue(column)}.`);
+    }
+    if (!TIME_AXIS_UNITS.includes(unit)) {
+        issues.push(`timeAxis.unit must be one of ${TIME_AXIS_UNITS.join(', ')}, got ${describeValue(unit)}.`);
+    }
+    if (zone !== undefined) {
+        if (!isZoneName(zone)) {
+            issues.push(`timeAxis.zone must be an IANA zone such as 'Europe/London' (an abbreviation such as ` +
+                `'PST' or a bare offset is not one), got ${describeValue(zone)}.`);
+        }
+        else if (unit !== 'iso') {
+            issues.push(`timeAxis.zone is for wall-clock ISO values; an epoch is an instant and has no zone — ` +
+                `drop zone or use unit 'iso'.`);
+        }
+    }
+    if (interval !== undefined && !isDuration(interval, AXIS_UNITS)) {
+        issues.push(`timeAxis.interval must be a positive whole number and one of s m h d w ('5m', '1h', '1d'), ` +
+            `got ${describeValue(interval)}.`);
+    }
+    if (aggregate !== undefined && aggregate !== 'raw' && !isAggregate(aggregate)) {
+        if (!isRecord(aggregate)) {
+            issues.push(`timeAxis.aggregate must be 'raw', one of ${TIME_AXIS_AGGREGATES.join(', ')}, or a ` +
+                `record of measure column to one of them, got ${describeValue(aggregate)}.`);
+        }
+        else {
+            const entries = Object.entries(aggregate);
+            if (entries.length === 0) {
+                issues.push('timeAxis.aggregate names no measure; declare at least one, or omit it.');
+            }
+            for (const [measure, how] of entries) {
+                if (measure.trim() === '')
+                    issues.push('timeAxis.aggregate has a blank measure name.');
+                if (measure === column) {
+                    issues.push(`timeAxis.aggregate names the time column '${measure}' as a measure.`);
+                }
+                if (!isAggregate(how)) {
+                    issues.push(`timeAxis.aggregate['${measure}'] must be one of ${TIME_AXIS_AGGREGATES.join(', ')}, ` +
+                        `got ${describeValue(how)}.`);
+                }
+            }
+        }
+    }
+    if (aggregate !== undefined && aggregate !== 'raw' && interval === undefined) {
+        issues.push('timeAxis.aggregate summarises an interval, so timeAxis.interval must say how wide it is.');
+    }
+    if (interval !== undefined && aggregate === undefined) {
+        issues.push(`timeAxis.interval needs timeAxis.aggregate — say how each interval was summarised, or 'raw'.`);
+    }
+    return issues;
+}
+/** Read the declaration off a ticket (`ArtifactMeta`, or anything shaped like
+ *  one). Absent is absent; anything present is judged. */
+export function readTimeAxis(meta) {
+    const value = isRecord(meta) ? meta.timeAxis : undefined;
+    if (value === undefined)
+        return { status: 'absent' };
+    const issues = timeAxisIssues(value);
+    return issues.length > 0
+        ? { status: 'malformed', issues }
+        : { status: 'declared', axis: value };
+}
+// ── The wording ─────────────────────────────────────────────────────────────
+const UNIT_WORDS = {
+    s: 'second',
+    m: 'minute',
+    h: 'hour',
+    d: 'day',
+    w: 'week',
+};
+const SINGLE = {
+    s: 'per-second',
+    m: 'per-minute',
+    h: 'hourly',
+    d: 'daily',
+    w: 'weekly',
+};
+/** `'1h'` → `'hourly'`, `'5m'` → `'5-minute'`. */
+function intervalAdjective(interval) {
+    const parts = durationParts(interval, AXIS_UNITS);
+    if (parts === undefined)
+        return interval;
+    return parts.digits === '1'
+        ? SINGLE[parts.unit]
+        : `${parts.digits}-${UNIT_WORDS[parts.unit]}`;
+}
+/** `'5m'` → `'5 minutes'`, `'1h'` → `'hour'`. */
+function intervalNoun(interval) {
+    const parts = durationParts(interval, AXIS_UNITS);
+    if (parts === undefined)
+        return interval;
+    return parts.digits === '1'
+        ? UNIT_WORDS[parts.unit]
+        : `${parts.digits} ${UNIT_WORDS[parts.unit]}s`;
+}
+function joinWords(words) {
+    if (words.length <= 1)
+        return words[0] ?? '';
+    return `${words.slice(0, -1).join(', ')} and ${words[words.length - 1]}`;
+}
+/**
+ * The declared SUMMARY in words, for a chart title — the one wording every
+ * consumer shares, so two screens never describe one ticket two ways.
+ *
+ *   `{ interval: '1h', aggregate: { a: 'avg', b: 'max' } }` → `'hourly avg and max'`
+ *   `{ interval: '5m', aggregate: 'max' }`                 → `'5-minute max'`
+ *   `{ interval: '5m', aggregate: 'raw' }`                 → `'raw samples every 5 minutes'`
+ *   `{ aggregate: 'raw' }`                                 → `'raw samples'`
+ *
+ * `undefined` when the declaration says nothing about summarising (column and
+ * unit only) — there is no summary to put in a title, and inventing "raw"
+ * would claim something the producer did not.
+ */
+export function describeTimeAxis(axis) {
+    const { aggregate, interval } = axis;
+    if (aggregate === undefined)
+        return undefined;
+    if (aggregate === 'raw') {
+        return interval === undefined ? 'raw samples' : `raw samples every ${intervalNoun(interval)}`;
+    }
+    const words = typeof aggregate === 'string' ? [aggregate] : [...new Set(Object.values(aggregate))];
+    const how = joinWords(words);
+    return interval === undefined ? how : `${intervalAdjective(interval)} ${how}`;
+}
+function describeValue(value) {
+    if (value === undefined)
+        return 'nothing';
+    try {
+        const text = JSON.stringify(value);
+        if (text === undefined)
+            return typeof value;
+        return text.length > 60 ? `${text.slice(0, 57)}...` : text;
+    }
+    catch {
+        return typeof value;
+    }
+}
+const NS_PER_MS = 1000000n;
+/**
+ * An epoch number read EXACTLY as written — through its decimal spelling, so
+ * `1726304400.123` is 123 ms and not the double's nearest neighbour. An
+ * exponent spelling (`1e21`) or a fraction finer than a nanosecond is
+ * unreadable.
+ */
+function epochInstant(value, unit) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return undefined;
+    const m = /^(-?)(\d+)(?:\.(\d+))?$/.exec(String(value));
+    if (m === null)
+        return undefined;
+    const fractionDigits = unit === 'epoch-s' ? 9 : 6; // down to one nanosecond
+    const fraction = m[3] ?? '';
+    if (fraction.length > fractionDigits)
+        return undefined;
+    const magnitude = BigInt(m[2]) * 10n ** BigInt(fractionDigits) +
+        BigInt(fraction.padEnd(fractionDigits, '0') || '0');
+    const ns = m[1] === '-' ? -magnitude : magnitude;
+    let ms = ns / NS_PER_MS;
+    if (ns < 0n && ms * NS_PER_MS !== ns)
+        ms -= 1n; // floor, not truncate
+    const whole = Number(ms);
+    if (!Number.isSafeInteger(whole))
+        return undefined;
+    return { ms: whole, nanos: Number(ns - ms * NS_PER_MS) };
+}
+const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
+/**
+ * An ISO value with no offset, read as a UTC WALL reading only to get its
+ * fields — never as an instant. `undefined` when it is not a date-time (or a
+ * date) with no zone.
+ */
+function naiveFields(value) {
+    const spelled = DATE_ONLY.test(value) ? `${value}T00:00Z` : `${value}Z`;
+    return instantOf(spelled, 'lenient');
+}
+function wallOf(fields) {
+    const d = new Date(fields.ms);
+    return {
+        year: d.getUTCFullYear(),
+        month: d.getUTCMonth() + 1,
+        day: d.getUTCDate(),
+        hour: d.getUTCHours(),
+        minute: d.getUTCMinutes(),
+        second: d.getUTCSeconds(),
+        millisecond: d.getUTCMilliseconds(),
+    };
+}
+function spellable(instant) {
+    return spellInstant(instant, 0) !== undefined;
+}
+function classifyIso(value, zone, walls) {
+    if (typeof value !== 'string')
+        return { kind: 'unreadable' };
+    const instant = instantOf(value, 'lenient');
+    if (instant !== undefined)
+        return { kind: 'instant', instant };
+    const fields = naiveFields(value);
+    if (fields === undefined)
+        return { kind: 'unreadable' };
+    if (zone === undefined)
+        return { kind: 'naive' };
+    const wall = fields.ms;
+    let reading = walls.get(wall);
+    if (reading === undefined) {
+        const w = wallOf(fields);
+        if (w.year > 9999)
+            return { kind: 'unreadable' };
+        reading = readWall(w, zone);
+        walls.set(wall, reading);
+    }
+    const at = (ms) => ({ ms, nanos: fields.nanos });
+    if (reading.kind === 'gap')
+        return { kind: 'gap' };
+    if (reading.kind === 'unique')
+        return { kind: 'instant', instant: at(reading.ms), wall };
+    return {
+        kind: 'overlap',
+        earlier: at(reading.earlier),
+        later: at(reading.later),
+        wall,
+        day: value.slice(0, 10),
+    };
+}
+function classifyEpoch(value, unit) {
+    const instant = epochInstant(value, unit);
+    return instant === undefined ? { kind: 'unreadable' } : { kind: 'instant', instant };
+}
+function classify(row, axis, walls) {
+    if (!isRecord(row))
+        return { kind: 'missing' };
+    const value = row[axis.column];
+    if (value === undefined || value === null)
+        return { kind: 'missing' };
+    const read = axis.unit === 'iso' ? classifyIso(value, axis.zone, walls) : classifyEpoch(value, axis.unit);
+    if (read.kind === 'instant' && !spellable(read.instant))
+        return { kind: 'unreadable' };
+    if (read.kind === 'overlap' && !(spellable(read.earlier) && spellable(read.later))) {
+        return { kind: 'unreadable' };
+    }
+    return read;
+}
+/**
+ * The fall-back rule over the rows' order: for each overlap day, the one
+ * place its wall clock steps back (a value not after the one before it)
+ * splits it into `earlier` then `later`. Any step back that is NOT inside one
+ * overlap day means the rows are not in time order, and every overlap value
+ * is left unplaced; so is a day with no step back or more than one.
+ */
+function resolveOverlaps(read, nanos) {
+    const placed = new Map();
+    const walled = [];
+    for (let i = 0; i < read.length; i++) {
+        const r = read[i];
+        if ((r.kind === 'instant' && r.wall !== undefined) || r.kind === 'overlap')
+            walled.push(i);
+    }
+    const wallAt = (i) => read[i].wall;
+    const stepsByDay = new Map();
+    for (let k = 1; k < walled.length; k++) {
+        const prev = walled[k - 1];
+        const here = walled[k];
+        const notAfter = wallAt(here) < wallAt(prev) || (wallAt(here) === wallAt(prev) && nanos(here) <= nanos(prev));
+        if (!notAfter)
+            continue;
+        const a = read[prev];
+        const b = read[here];
+        if (a.kind !== 'overlap' || b.kind !== 'overlap' || a.day !== b.day)
+            return placed;
+        stepsByDay.set(a.day, [...(stepsByDay.get(a.day) ?? []), here]);
+    }
+    for (const [day, steps] of stepsByDay) {
+        if (steps.length !== 1)
+            continue;
+        const step = steps[0];
+        for (let i = 0; i < read.length; i++) {
+            const r = read[i];
+            if (r.kind === 'overlap' && r.day === day)
+                placed.set(i, i < step ? 'earlier' : 'later');
+        }
+    }
+    return placed;
+}
+const pad = (n, width) => String(n).padStart(width, '0');
+function precisionOf(instants) {
+    let precision = 'second';
+    for (const { ms, nanos } of instants) {
+        if (nanos !== 0)
+            return 'nanosecond';
+        if (((ms % 1000) + 1000) % 1000 !== 0)
+            precision = 'millisecond';
+    }
+    return precision;
+}
+/** `instant` in UTC with exactly the digits `precision` names — fixed width, so text order is time order. */
+function spellAt(instant, precision) {
+    const msPart = ((instant.ms % 1000) + 1000) % 1000;
+    const whole = spellInstant({ ms: instant.ms - msPart, nanos: 0 }, 0);
+    if (precision === 'second')
+        return whole;
+    const fraction = pad(msPart * 1_000_000 + instant.nanos, 9);
+    const digits = precision === 'millisecond' ? fraction.slice(0, 3) : fraction;
+    return `${whole.slice(0, -1)}.${digits}Z`;
+}
+/**
+ * THE READ-SIDE VIEW of a declared time column: every value turned into a UTC
+ * `Z` instant at one precision, sorted in time, with every value it could not
+ * place counted by reason (the module table). The rows are only read — never
+ * copied into, reordered or rewritten — so the stored bytes are unchanged.
+ *
+ * A malformed `axis` throws a `TypeError` naming its issues (read a ticket
+ * with `readTimeAxis` first; a declaration is never repaired).
+ */
+export function normaliseInstants(rows, axis, options = {}) {
+    const issues = timeAxisIssues(axis);
+    if (issues.length > 0) {
+        throw new TypeError(`normaliseInstants: the time axis is malformed — ${issues.join(' ')}`);
+    }
+    const naive = options.naive ?? 'flag';
+    if (naive !== 'flag' && naive !== 'refuse') {
+        throw new TypeError(`normaliseInstants: naive must be 'flag' or 'refuse', got ${describeValue(naive)}.`);
+    }
+    if (!Array.isArray(rows)) {
+        throw new TypeError(`normaliseInstants: rows must be an array, got ${describeValue(rows)}.`);
+    }
+    const walls = new Map();
+    const read = rows.map((row) => classify(row, axis, walls));
+    const nanosOf = (i) => {
+        const r = read[i];
+        return r.kind === 'instant' ? r.instant.nanos : r.kind === 'overlap' ? r.earlier.nanos : 0;
+    };
+    const byOrder = read.some((r) => r.kind === 'overlap')
+        ? resolveOverlaps(read, nanosOf)
+        : new Map();
+    const counts = { naive: 0, dstAmbiguous: 0, dstGap: 0, unreadable: 0, missing: 0 };
+    const placed = [];
+    const notes = [];
+    read.forEach((r, row) => {
+        if (r.kind === 'instant')
+            placed.push({ row, instant: r.instant });
+        else if (r.kind === 'overlap') {
+            const which = byOrder.get(row);
+            if (which === undefined)
+                counts.dstAmbiguous++;
+            else {
+                placed.push({ row, instant: r[which] });
+                notes.push({ kind: 'dst-overlap', resolvedBy: 'row-order', row, which });
+            }
+        }
+        else if (r.kind === 'gap')
+            counts.dstGap++;
+        else
+            counts[r.kind]++;
+    });
+    const count = counts.naive + counts.dstAmbiguous;
+    if (count > 0 && naive === 'refuse') {
+        return { status: 'refused', reason: 'naive-values', count, counts };
+    }
+    placed.sort((a, b) => a.instant.ms - b.instant.ms || a.instant.nanos - b.instant.nanos || a.row - b.row);
+    const precision = precisionOf(placed.map((p) => p.instant));
+    const points = placed.map((p) => ({ row: p.row, at: spellAt(p.instant, precision) }));
+    return count > 0
+        ? { status: 'naive-values', count, points, precision, notes, counts }
+        : { status: 'instants', points, precision, notes, counts };
+}
+//# sourceMappingURL=axis.js.map

package/dist/esm/time/axis.js.map

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

package/dist/esm/time/bind.d.ts

@@ -0,0 +1,147 @@
+/**
+ * time/bind — which of the person's windows a tool call carries (time
+ * design § 5.6, § 7.3): fill from one mention, bind by quote, and record a
+ * differing model window and run it.
+ *
+ * Pattern: Walker over recorded rows. The turn's WINDOWS are read from what
+ *          the record already holds — this turn's `time-answer` rows (a
+ *          mention the person settled in the time ask), a `model` reader's
+ *          `time-reading` rows (a reading, never the person's) and the
+ *          `clock` row's `control` window — never from words. A `rule`
+ *          reading settles nothing: it is a proposal the person confirms
+ *          (the owner's decision "Always confirm", time design TQ29). One call's decision
+ *          ({@link callWindowOf}) is a pure function of its arguments, the
+ *          tool's forms and those windows.
+ * Role:    L0 leaf (the time layer). Imports `convert.ts`, `range.ts`,
+ *          `rows.ts`, `resolve.ts`' types and `zone.ts` only. Asked by the
+ *          inputs layer (`arguments/resolve.ts`), which files the argument
+ *          rows and the `call-window` row the decision implies.
+ * Emits:   N/A.
+ *
+ * ## The laws
+ *
+ * - **Fill only when the turn has exactly one window.** A message holding two
+ *   mentions ("this morning vs yesterday morning") fills nothing: which one a
+ *   call means is the model's to say, through the quote. A mention whose
+ *   reading is still open (the person has not chosen) is counted and fills
+ *   nothing; a refused mention (its quote was not in the message) is not the
+ *   person's words and is not counted. A `control` window (`time.window`, set
+ *   in a UI) counts as one more mention with no quote.
+ * - **Fill only what the model left out — exactly, else wider, never
+ *   narrower.** Every argument of every form must be missing; the window goes
+ *   into the first form that holds it exactly (`convert.ts` · `convertExact`),
+ *   else the first that holds MORE (`convertWidened`: a whole day, the
+ *   covering look-back — recorded with what it adds). No such form → the call
+ *   is REFUSED, `no-form-holds` (`convert.ts` · `convertForTool`, the one
+ *   answer): the tool's own rule never stands in for the person's window, so
+ *   an assumed `1h` never silently reads a time the person did not ask about.
+ * - **Refuse before dispatch what the tool cannot honestly read (step
+ *   T5b).** A window — the person's to fill, or the model's sent — outside
+ *   the tool's declared `direction`, wholly beyond its `retention` or wider
+ *   than its `maxRange`; a range across days for a tool whose every form is a
+ *   `day`; a window of the person's no form can read (`no-form-holds`); a
+ *   sent wall time the zone skips. A window only partly beyond `retention`
+ *   runs, marked. An open reading the tool can read in NO reading is refused
+ *   too, and never asked.
+ * - **A present window is never written over.** Bound by quote (the model's
+ *   declared `user` quote names a recorded mention) or by value (the sent
+ *   value, read back, IS a window of this turn); otherwise it runs as sent and
+ *   is recorded `model-chosen` beside the person's window — a drill-down, a
+ *   comparison and a baseline call are normal work.
+ */
+import { type Conversion, type PeriodFacts, type PeriodForm, type TimeRefusal, type WidenedConversion } from './convert.js';
+import type { InstantText } from './instant.js';
+import type { TimeRange } from './range.js';
+import type { ZoneName } from './zone.js';
+export { isOpenForPerson, offeredLookback, pendingQuotesOf, readerWindowsOf, turnWindowsOf, windowToConvert, type ReaderWindows, type RefusedWindow, type TurnWindow, type TurnWindows, type WindowSource, } from './windows.js';
+import { type TurnWindow, type TurnWindows } from './windows.js';
+/** What the inputs layer knows about one call to a tool that declares period forms. */
+export interface CallToBind {
+    readonly args: Readonly<Record<string, unknown>>;
+    readonly forms: readonly PeriodForm[];
+    /** The argument is missing from the call (`tools/declare.ts` · `isMissing`). */
+    readonly isMissing: (argument: string) => boolean;
+    /**
+     * Under declared sources: the quotes the model declared (`source: 'user'`)
+     * for this call's period arguments. Absent when the arm is off.
+     */
+    readonly quotes?: readonly string[];
+    /**
+     * The tool's declared facts (`direction`, `retention`, `maxRange`,
+     * `filtersToAsked`) — a call whose window breaks one is refused before
+     * dispatch (step T5b). Absent: nothing is checked.
+     */
+    readonly facts?: PeriodFacts;
+}
+/** The clock and zones a decision reads. */
+export interface BindContext {
+    readonly now: InstantText;
+    readonly zone: ZoneName;
+    readonly appZone?: ZoneName;
+    readonly granularityMs: number;
+}
+/** The decision for one call — see {@link callWindowOf}. */
+export type CallWindow = 
+/** The model left every period argument out and the turn's one window went into `form` exactly. */
+{
+    readonly how: 'filled';
+    readonly window: TurnWindow;
+    /** Exact, or — when no form holds the window exactly — WIDENED (it carries `sent` and `extra`). */
+    readonly conversion: Conversion | WidenedConversion;
+    /** Widened, and the tool declares `filtersToAsked`: it trims its rows to the asked window. */
+    readonly trimmedByTool?: true;
+    readonly partlyBeyondRetention?: true;
+}
+/** The sent window IS one of the turn's windows — named by the model's quote (`quote`) or equal in value (`value`). */
+ | {
+    readonly how: 'bound';
+    readonly form: number;
+    readonly asked: TimeRange;
+    readonly window: TurnWindow;
+    readonly by: 'quote' | 'value';
+    readonly partlyBeyondRetention?: true;
+}
+/** The sent window differs from the person's: it runs as sent (§ 7.3, the v1 law). `person` when one window is the person's. */
+ | {
+    readonly how: 'model-chosen';
+    readonly form: number;
+    readonly asked: TimeRange;
+    readonly person?: TurnWindow;
+    readonly partlyBeyondRetention?: true;
+}
+/** The sent window, and no window of the person's to compare it with. */
+ | {
+    readonly how: 'model';
+    readonly form: number;
+    readonly asked: TimeRange;
+    readonly partlyBeyondRetention?: true;
+}
+/**
+ * Refused before dispatch (step T5b): the window breaks one of the tool's
+ * facts, spans days for a tool that reads one, or a sent wall time is one
+ * the zone skips (`argument` names it). `asked` and `person` when known.
+ */
+ | {
+    readonly how: 'refused';
+    readonly refused: TimeRefusal;
+    readonly form?: number;
+    readonly asked?: TimeRange;
+    readonly person?: TurnWindow;
+    readonly argument?: string;
+}
+/** A period argument was sent, and no form reads the call's arguments back as a range. */
+ | {
+    readonly how: 'unread';
+}
+/** The model left the period out and nothing was filled — why. */
+ | {
+    readonly how: 'not-filled';
+    readonly why: 'no-window' | 'several-mentions' | 'open-reading';
+};
+/**
+ * Which window one call carries (the module laws). Pure: the same call, forms
+ * and windows always give the same decision.
+ */
+export declare function callWindowOf(call: CallToBind, turn: TurnWindows, ctx: BindContext): CallWindow;
+/** The range a decision says the call asks for — the person's on a fill, the sent one otherwise. */
+export declare function askedRangeOf(decision: CallWindow): TimeRange | undefined;