agentfootprint 10.2.0 → 10.3.1

package/dist/esm/core/time/windows.js

@@ -1,276 +0,0 @@
-/**
- * core/time/windows — the turn's windows, read from the record (time design
- * § 5.6): the window the person settled in the time ask (`answered`), a
- * `model` reader's one reading waiting for confirmation
- * (`derived-from-reading`) and the clock's `control` window; the quotes still
- * waiting on the person; and what the served sentence names
- * (`readerWindowsOf`).
- *
- * Pattern: Walker over recorded rows — never over words, never the resolver.
- * Role:    the record half of `bind.ts`, split out BY FILE for the synchronous
- *          doors: the Tools mount's `inputMapper` (`agent/buildAgentChart.ts` ·
- *          `timeWindowsArg`) and the evidence gate's lineage read it before
- *          any `import()` can run, and a bundler places a whole file on the
- *          synchronous graph — so this file imports only the leaves and the
- *          row readers, never `convert.ts` or `resolve.ts` (the optional-family
- *          law, `test/lib/trace-toolpack/browserGraph.test.ts`). `bind.ts`
- *          re-exports every public name.
- * Emits:   N/A (pure).
- *
- * @example
- * ```ts
- * readerWindowsOf(ledger);
- * // { now: '2026-10-09T15:40:00Z', windows: [{ source: 'answered', quote: 'yesterday', … }] }
- * ```
- */
-import { sameRange } from './range.js';
-import { answersOf, clockOf, readingsOf, } from './rows.js';
-/**
- * The one window a `model` reading offers, when it waits only for the
- * person's confirmation — a reading, filled as `derived-from-reading`. A
- * `rule` reading settles on nothing: it is a PROPOSAL the time ask offers,
- * and only the person's answer settles it (the owner's decision "Always
- * confirm", time design TQ29).
- */
-function readingCandidate(row) {
-    const choice = row.choice;
-    if (row.reader.kind !== 'model' || choice?.by !== 'open')
-        return undefined;
-    if (choice.open.length !== 1 || choice.open[0] !== 'confirm')
-        return undefined;
-    return row.candidates?.[choice.remaining[0]];
-}
-/**
- * The look-back the library OFFERED for a reading, when the person's answer is
- * exactly it (`last 2 hours` confirmed as offered) — the window then stays a
- * look-back from now. `undefined` for any other answer (an edit, a range).
- */
-export function offeredLookback(row, range) {
-    const offered = row?.candidates?.find((c) => c.window.kind === 'lookback' && sameRange(c.range, range))?.window;
-    return offered?.kind === 'lookback' ? offered.duration : undefined;
-}
-/**
- * What a turn window hands the conversion — its range and, when it was said
- * (and answered) as a look-back, that look-back. THE one input every door
- * that writes a window into a tool's arguments builds (the fill, the time
- * ask's answer, the served line), so the value served to the model and the
- * value the tool is handed are one spelling (time follow-ups, packet "gaps":
- * the served line spelled `15:59:59Z` where the ask's fill handed `16:00:00Z`).
- */
-export function windowToConvert(window) {
-    return {
-        range: window.range,
-        ...(window.lookback !== undefined && { lookback: window.lookback }),
-    };
-}
-/**
- * Whether a mention the person has not answered still waits on THEM — the
- * one owner of "a time the person wrote that the library holds no settled
- * window for" (the lazy ask, the served line's pending half and the window
- * plan all ask it): a reading still `open` (readings to confirm, a zone to
- * name), and words the library holds NO reading of (`by: 'none'` — words the
- * reader could not read, or no candidate). The person said a time either way,
- * so a tool's default never stands in for it (time follow-ups, packet "gaps":
- * an unreadable phrase to a tool whose rule assumed its period ran that
- * default silently). A `model` reading's one window is not open: it fills as
- * a reading. A refused mention (its quote was not in the text) is not the
- * person's words.
- */
-export function isOpenForPerson(row) {
-    if (row.mentions === 0 || row.refused !== undefined || row.quote === undefined)
-        return false;
-    const by = row.choice?.by;
-    if (by !== 'open' && by !== 'none')
-        return false;
-    return readingCandidate(row) === undefined;
-}
-/**
- * This turn's windows, read from the record: per mention, the window the
- * person settled in the time ask (`answered`, its latest `time-answer` row),
- * else a `model` reader's one window waiting for confirmation
- * (`derived-from-reading`); and the clock's `control` window. A `rule`
- * reading the person has not answered, and words the library could not read,
- * are counted and are OPEN ({@link isOpenForPerson}).
- */
-export function turnWindowsOf(readings, clock, answers = []) {
-    const windows = [];
-    const open = [];
-    let mentions = 0;
-    const answered = new Map(answers.map((a) => [a.mention, a]));
-    for (const row of readings) {
-        if (row.mentions === 0 || row.refused !== undefined || row.quote === undefined)
-            continue;
-        mentions++;
-        const answer = row.mention === undefined ? undefined : answered.get(row.mention);
-        if (answer !== undefined) {
-            const range = { from: answer.from, to: answer.to };
-            // The person picked a look-back the library offered: it stays a look-back from now.
-            const lookback = offeredLookback(row, range);
-            windows.push({
-                source: 'answered',
-                mention: answer.mention,
-                quote: row.quote,
-                range,
-                ...(lookback !== undefined && { lookback }),
-                zone: answer.zone,
-                answer: answer.how,
-            });
-            continue;
-        }
-        const candidate = readingCandidate(row);
-        if (candidate === undefined) {
-            const choice = row.choice;
-            const left = choice?.by === 'open'
-                ? choice.remaining.flatMap((i) => {
-                    const c = row.candidates?.[i];
-                    return c === undefined ? [] : [c.range];
-                })
-                : [];
-            // Open with no reading yet (a zone to name, words not read) is still open: nothing to rule
-            // out, and the person is asked — never left to the tool's own rule.
-            if (left.length > 0 || isOpenForPerson(row))
-                open.push(left);
-            continue;
-        }
-        windows.push({
-            source: 'derived-from-reading',
-            ...(row.mention !== undefined && { mention: row.mention }),
-            quote: row.quote,
-            range: candidate.range,
-            ...(candidate.window.kind === 'lookback' && { lookback: candidate.window.duration }),
-            zone: candidate.zone,
-        });
-    }
-    if (clock?.window !== undefined) {
-        mentions++;
-        windows.push({
-            source: 'control',
-            range: { from: clock.window.from, to: clock.window.to },
-            zone: clock.zone,
-        });
-    }
-    return { windows, mentions, ...(open.length > 0 && { open }) };
-}
-/** Whether a call of `turn` ran on a window the model wrote (`call-window` `how: 'model'`). */
-function ranOnSentWindow(ledger, turn) {
-    return (ledger ?? []).some((row) => {
-        const r = row;
-        return (r !== null &&
-            typeof r === 'object' &&
-            r.kind === 'call-window' &&
-            r.turn === turn &&
-            r.how === 'model');
-    });
-}
-/**
- * The person's windows the tools refused this turn (`ReaderWindows.refused`):
- * each `call-window` row `how: 'refused'` whose window was the person's — its
- * `person.mention`'s quote — or, with no range at all, the turn's one open
- * reading (`openQuote`), refused in every reading. Once per (quote, tool).
- */
-function refusedWindowsOf(ledger, turn, readings, openQuote) {
-    const quoteOf = new Map(readings.flatMap((r) => r.quote !== undefined && r.refused === undefined ? [[r.mention ?? 0, r.quote]] : []));
-    const out = [];
-    for (const row of ledger ?? []) {
-        const r = row;
-        if (r === null || typeof r !== 'object' || r.kind !== 'call-window' || r.turn !== turn)
-            continue;
-        if (r.how !== 'refused' || r.refused === undefined || typeof r.toolName !== 'string')
-            continue;
-        const quote = r.person !== undefined
-            ? r.person.mention === undefined
-                ? undefined
-                : quoteOf.get(r.person.mention)
-            : r.asked === undefined && r.form === undefined
-                ? openQuote
-                : undefined;
-        if (quote === undefined)
-            continue;
-        if (out.some((w) => w.quote === quote && w.toolName === r.toolName))
-            continue;
-        out.push({
-            quote,
-            toolName: r.toolName,
-            refused: r.refused,
-            ...(r.argument !== undefined && { argument: r.argument }),
-        });
-    }
-    return out;
-}
-/**
- * The quotes of this turn's mentions still waiting on the person
- * ({@link isOpenForPerson}), not answered in the time ask: a reading to
- * confirm, a zone to name, or words the library could not read (asked with
- * nothing pre-filled). A `model` reading's one window is served as a reading;
- * a refused mention is not the person's words.
- */
-export function pendingQuotesOf(readings, answers = []) {
-    const answered = new Set(answers.map((a) => a.mention));
-    const quotes = [];
-    for (const row of readings) {
-        if (!isOpenForPerson(row))
-            continue;
-        if (row.mention !== undefined && answered.has(row.mention))
-            continue;
-        quotes.push(row.quote);
-    }
-    return quotes;
-}
-/** The quotes among `pending` the library could not read at all (`ReaderWindows.pendingUnread`). */
-function pendingUnreadOf(readings, pending) {
-    return pending.filter((quote) => readings.some((r) => r.quote === quote && r.choice?.by === 'none'));
-}
-/**
- * The quotes among `pending` whose reading offers nothing to confirm yet —
- * no candidate, the choice open on the zone the words name
- * (`ReaderWindows.pendingZones`).
- */
-function pendingZonesOf(readings, pending) {
-    return pending.filter((quote) => readings.some((r) => r.quote === quote &&
-        (r.candidates ?? []).length === 0 &&
-        r.choice?.by === 'open' &&
-        r.choice.open.includes('zone')));
-}
-/**
- * The latest turn's windows of the person's words, read off the ledger (its
- * last `clock` row and that turn's `time-reading` and `time-answer` rows) —
- * `undefined` when the turn has no clock, no settled mention, none pending
- * and no `control` window. A `rule` reading is named as a window only once
- * the person answered it in the time ask; before that its quote is
- * `pending`. The `control` window is no reading: it rides `control`, never
- * `windows`.
- */
-export function readerWindowsOf(ledger) {
-    const clock = clockOf(ledger);
-    if (clock === undefined)
-        return undefined;
-    const turn = clock.turn;
-    const readings = readingsOf(ledger, turn);
-    const answers = answersOf(ledger, turn);
-    const { windows } = turnWindowsOf(readings, undefined, answers);
-    const pending = pendingQuotesOf(readings, answers);
-    const control = clock.window === undefined
-        ? undefined
-        : {
-            source: 'control',
-            range: { from: clock.window.from, to: clock.window.to },
-            zone: clock.zone,
-        };
-    if (windows.length === 0 && pending.length === 0 && control === undefined)
-        return undefined;
-    const zones = pendingZonesOf(readings, pending);
-    const unread = pendingUnreadOf(readings, pending);
-    const refused = refusedWindowsOf(ledger, turn, readings, pending.length === 1 ? pending[0] : undefined);
-    return {
-        now: clock.now,
-        windows,
-        ...(control !== undefined && { control }),
-        ...(pending.length > 0 && { pending }),
-        ...(zones.length > 0 && { pendingZones: zones }),
-        ...(unread.length > 0 && { pendingUnread: unread }),
-        ...(pending.length > 0 && ranOnSentWindow(ledger, turn) && { ranUnconfirmed: true }),
-        ...(refused.length > 0 && { refused }),
-        ...(clock.zoneSource === 'unknown' && { zoneUnknown: true }),
-    };
-}
-//# sourceMappingURL=windows.js.map

package/dist/esm/core/time/windows.js.map

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

package/dist/esm/core/time/wire.d.ts

@@ -1,70 +0,0 @@
-/**
- * core/time/wire — the time layer's JSON that crosses a transport (time
- * design § 7.5): `ctx.time`, the window a call asks for, handed to the tool.
- *
- * Pattern: one versioned shape, the same object in process and on the wire.
- *          In process it is `ToolExecutionContext.time`; over MCP it travels
- *          in the `tools/call` request's `_meta.agentfootprint.time`
- *          (`lib/mcp/mcpClient.ts` sends it, `lib/mcp/mcpServe.ts` hands it
- *          to the served tool); a transport with no metadata slot sends
- *          nothing, and the tool declares its period from its own arguments.
- *          A tool's `period` declaration itself travels in the listing's
- *          `_meta.agentfootprint.period`, judged by `arguments/declare.ts`.
- * Role:    core/ leaf (the time layer). Imports `instant.ts`, `range.ts` and
- *          `zone.ts` only.
- * Emits:   N/A.
- *
- * @example
- * ```ts
- * timeContextOf({ asked: { from: '2026-10-09T08:00:00-07:00', to: '2026-10-09T08:41:00-07:00' } },
- *   { now: '2026-10-09T15:40:00Z', zone: 'America/Los_Angeles' }, '2026-10-09T15:40:02.114Z');
- * // { version: 1, asked: { from: …, to: …, edge: 'exclusive' }, zone: 'America/Los_Angeles',
- * //   now: '2026-10-09T15:40:00Z', dispatchedAt: '2026-10-09T15:40:02.114Z' }
- * ```
- */
-import { type InstantText } from './instant.js';
-import { type TimeRange } from './range.js';
-import { type ZoneName } from './zone.js';
-/** The shape's version — a reader refuses one it does not know. */
-export declare const TIME_CONTEXT_VERSION = 1;
-/** The `_meta.agentfootprint` key the call's time travels under over MCP. */
-export declare const TIME_CONTEXT_META_KEY = "time";
-/**
- * What a tool that declares a period is handed about the call's time
- * (`ctx.time`). `asked` is the half-open range the call asks for — the
- * person's window when the library filled or bound it, the sent value read
- * back otherwise — so a tool can declare the `period.queried` its read covered
- * without parsing its own argument. Absent when no form read the call back.
- */
-export interface TimeContext {
-    readonly version: typeof TIME_CONTEXT_VERSION;
-    readonly asked?: TimeRange & {
-        readonly edge: 'exclusive';
-    };
-    /** The person's zone for this run (the clock's). */
-    readonly zone: ZoneName;
-    /**
-     * The person's zone is NOT known (the clock's `zoneSource: 'unknown'`, G15):
-     * `zone` is only the UTC spelling of the instants, never the person's — a
-     * tool must not read a wall time in it as theirs. Absent when the zone is known.
-     */
-    readonly zoneUnknown?: true;
-    /** The turn's frozen clock (§ 4). */
-    readonly now: InstantText;
-    /** The wall clock when the library handed the call to the tool — the `call` row's. */
-    readonly dispatchedAt: InstantText;
-}
-/** The context for one call, from its `call-window` row's `asked`, the turn's clock and the dispatch moment. */
-export declare function timeContextOf(window: {
-    readonly asked?: TimeRange;
-} | undefined, clock: {
-    readonly now: InstantText;
-    readonly zone: ZoneName;
-    readonly zoneSource?: string;
-}, dispatchedAt: InstantText): TimeContext;
-/**
- * A received context read — the version this runtime knows, every field well
- * formed — or `undefined`. What a served tool is handed from the wire; never
- * repaired.
- */
-export declare function readTimeContext(value: unknown): TimeContext | undefined;

package/dist/esm/core/time/wire.js

@@ -1,85 +0,0 @@
-/**
- * core/time/wire — the time layer's JSON that crosses a transport (time
- * design § 7.5): `ctx.time`, the window a call asks for, handed to the tool.
- *
- * Pattern: one versioned shape, the same object in process and on the wire.
- *          In process it is `ToolExecutionContext.time`; over MCP it travels
- *          in the `tools/call` request's `_meta.agentfootprint.time`
- *          (`lib/mcp/mcpClient.ts` sends it, `lib/mcp/mcpServe.ts` hands it
- *          to the served tool); a transport with no metadata slot sends
- *          nothing, and the tool declares its period from its own arguments.
- *          A tool's `period` declaration itself travels in the listing's
- *          `_meta.agentfootprint.period`, judged by `arguments/declare.ts`.
- * Role:    core/ leaf (the time layer). Imports `instant.ts`, `range.ts` and
- *          `zone.ts` only.
- * Emits:   N/A.
- *
- * @example
- * ```ts
- * timeContextOf({ asked: { from: '2026-10-09T08:00:00-07:00', to: '2026-10-09T08:41:00-07:00' } },
- *   { now: '2026-10-09T15:40:00Z', zone: 'America/Los_Angeles' }, '2026-10-09T15:40:02.114Z');
- * // { version: 1, asked: { from: …, to: …, edge: 'exclusive' }, zone: 'America/Los_Angeles',
- * //   now: '2026-10-09T15:40:00Z', dispatchedAt: '2026-10-09T15:40:02.114Z' }
- * ```
- */
-import { instantOf } from './instant.js';
-import { isTimeRange } from './range.js';
-import { isZoneName } from './zone.js';
-/** The shape's version — a reader refuses one it does not know. */
-export const TIME_CONTEXT_VERSION = 1;
-/** The `_meta.agentfootprint` key the call's time travels under over MCP. */
-export const TIME_CONTEXT_META_KEY = 'time';
-/** The context for one call, from its `call-window` row's `asked`, the turn's clock and the dispatch moment. */
-export function timeContextOf(window, clock, dispatchedAt) {
-    const asked = window?.asked;
-    return {
-        version: TIME_CONTEXT_VERSION,
-        ...(asked !== undefined && {
-            asked: { from: asked.from, to: asked.to, edge: 'exclusive' },
-        }),
-        zone: clock.zone,
-        ...(clock.zoneSource === 'unknown' && { zoneUnknown: true }),
-        now: clock.now,
-        dispatchedAt,
-    };
-}
-/**
- * A received context read — the version this runtime knows, every field well
- * formed — or `undefined`. What a served tool is handed from the wire; never
- * repaired.
- */
-export function readTimeContext(value) {
-    if (value === null || typeof value !== 'object' || Array.isArray(value))
-        return undefined;
-    const v = value;
-    const keys = Object.keys(v);
-    if (!keys.every((k) => ['version', 'asked', 'zone', 'zoneUnknown', 'now', 'dispatchedAt'].includes(k))) {
-        return undefined;
-    }
-    if (v.version !== TIME_CONTEXT_VERSION || !isZoneName(v.zone))
-        return undefined;
-    if (v.zoneUnknown !== undefined && v.zoneUnknown !== true)
-        return undefined;
-    if (instantOf(v.now, 'strict') === undefined ||
-        instantOf(v.dispatchedAt, 'strict') === undefined) {
-        return undefined;
-    }
-    let asked;
-    if (v.asked !== undefined) {
-        if (v.asked === null || typeof v.asked !== 'object' || Array.isArray(v.asked))
-            return undefined;
-        const { edge, ...range } = v.asked;
-        if (edge !== 'exclusive' || !isTimeRange(range))
-            return undefined;
-        asked = { from: range.from, to: range.to, edge };
-    }
-    return {
-        version: TIME_CONTEXT_VERSION,
-        ...(asked !== undefined && { asked }),
-        zone: v.zone,
-        ...(v.zoneUnknown === true && { zoneUnknown: true }),
-        now: v.now,
-        dispatchedAt: v.dispatchedAt,
-    };
-}
-//# sourceMappingURL=wire.js.map

package/dist/esm/core/time/wire.js.map

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

package/dist/esm/core/time/zone.d.ts

@@ -1,147 +0,0 @@
-/**
- * core/time/zone — IANA zone names and offset arithmetic, through `Intl`.
- *
- * Pattern: the platform's tz database behind two small questions — "what is
- *          the offset of this zone at this instant?" and "which instant is
- *          this wall time in this zone?" — with Temporal's four DST words for
- *          the second. No dependency: `Intl.DateTimeFormat` carries the
- *          database the runtime ships.
- * Role:    core/ leaf (the time layer's one owner). Imports `instant.ts` only.
- * Emits:   N/A.
- *
- * ## A zone is an IANA name, never an abbreviation
- *
- * `Intl` is more forgiving than this layer: it accepts `PST` (and reads it as
- * `America/Los_Angeles`, whose October offset is -07:00, not PST's -08:00),
- * `EST` (as `America/Panama`), and a bare offset such as `+05:30`. Each of
- * those turns a person's words into a zone without saying so, so
- * {@link isZoneName} refuses them: a name is accepted when it has an
- * `Area/Location` shape (`America/Los_Angeles`, `Etc/GMT+5`) or is `UTC` /
- * `GMT`, AND `Intl` knows it. An abbreviation reaches a zone only through a
- * recorded map (a later step), never here.
- *
- * ## Cost — one `formatToParts` per (zone, instant), memoised
- *
- * Asking `Intl` is the whole cost of this module (a `formatToParts` is
- * microseconds; everything else is arithmetic), and a resolution asks the
- * same instants again: every candidate a DST probe validates is then spelled
- * with its offset. So the formatter is built once per zone and the reading of
- * each (zone, instant) is kept — the tz database cannot change inside a
- * process — in a bounded memo cleared when full, like the formatter cache.
- * `readWall` also skips the one probe it can prove redundant: when the offset
- * a day before, at, and a day after the wall time agree, no change falls in
- * that window, so the one candidate needs no check. What this buys is pinned
- * as a COUNT by the performance case of test/core/time/resolve.test.ts, not a
- * duration.
- *
- * ## DST — the four words
- *
- * | Wall time | `compatible` | `earlier` | `later` | `reject` |
- * |-----------|--------------|-----------|---------|----------|
- * | exists once | it | it | it | it |
- * | exists twice (fall back, `01:30`) | the first | the first | the second | `undefined` |
- * | never exists (spring forward, `02:30`) | shifted forward by the gap (`03:30`) | shifted back (`01:30`) | shifted forward | `undefined` |
- *
- * @example
- * ```ts
- * isZoneName('America/Los_Angeles'); // true
- * isZoneName('PST');                 // false — an abbreviation
- * offsetAt('America/Los_Angeles', Date.parse('2026-10-09T15:00:00Z')); // -420
- * readWall({ year: 2026, month: 11, day: 1, hour: 1, minute: 30 }, 'America/Los_Angeles');
- * // { kind: 'overlap', earlier: …08:30Z, later: …09:30Z }
- * ```
- */
-/** An IANA zone name, checked through `Intl`. Never an abbreviation, never a bare offset. */
-export type ZoneName = string;
-/** A wall-clock reading with no zone. `second` and `millisecond` default to 0. */
-export interface WallTime {
-    readonly year: number;
-    readonly month: number;
-    readonly day: number;
-    readonly hour: number;
-    readonly minute: number;
-    readonly second?: number;
-    readonly millisecond?: number;
-}
-/** Temporal's four words for a wall time a DST change doubles or skips. */
-export type Disambiguation = 'compatible' | 'earlier' | 'later' | 'reject';
-/** What a wall time names in a zone: one instant, two (fall back), or none (spring forward). */
-export type WallReading = {
-    readonly kind: 'unique';
-    readonly ms: number;
-} | {
-    readonly kind: 'overlap';
-    readonly earlier: number;
-    readonly later: number;
-} | {
-    readonly kind: 'gap';
-    readonly earlier: number;
-    readonly later: number;
-};
-/** Whether `value` is an IANA zone name this runtime's tz database knows — see the module header for what is refused. */
-export declare function isZoneName(value: unknown): value is ZoneName;
-/** The runtime's canonical spelling of a zone (`america/los_angeles` → `America/Los_Angeles`), or `undefined` when it is not a zone name. */
-export declare function canonicalZone(value: unknown): ZoneName | undefined;
-/** The wall time an instant shows in `zone` (milliseconds kept). Frozen: the reading is shared through the memo. */
-export declare function wallAt(zone: ZoneName, ms: number): WallTime;
-/**
- * The offset of `zone` at the instant `ms`, in minutes east of UTC
- * (`America/Los_Angeles` in October: -420). A historical local-mean-time
- * offset can be a fraction of a minute.
- */
-export declare function offsetAt(zone: ZoneName, ms: number): number;
-/** Whether a wall time's fields name a real calendar time (any zone aside). */
-export declare function isWallTime(value: unknown): value is WallTime;
-/**
- * What `wall` names in `zone`: one instant, two (a fall-back overlap:
- * `earlier`, `later`), or none (a spring-forward gap: `earlier` is the wall
- * time read with the offset after the change, `later` with the offset before
- * it — Temporal's two readings). Throws a `TypeError` on a wall time that is
- * not a calendar time or a zone that is not a zone name.
- */
-export declare function readWall(wall: WallTime, zone: ZoneName): WallReading;
-/**
- * The instant `wall` names in `zone` under `disambiguation` (the module
- * table), or `undefined` under `'reject'` when the wall time is doubled or
- * skipped.
- */
-export declare function wallToInstant(wall: WallTime, zone: ZoneName, disambiguation: Disambiguation): number | undefined;
-/**
- * The tz database version this runtime's `Intl` carries — Node names it
- * (`process.versions.tz`, e.g. `'2025b'`); any other runtime answers
- * `'unknown'`. Recorded on every `time-reading` row: zone data changes
- * between releases, so a reading is re-derivable only with it.
- */
-export declare function tzdataVersion(): string;
-/**
- * The ONE zone a place name names in this runtime's tz database, or
- * `undefined` when it names none or more than one. `London` → `Europe/London`,
- * `New York` → `America/New_York`; `India`, `Pacific`, `Eastern` → `undefined`
- * (no zone ends in them — a region is not a place). Looked up two ways, both
- * the tz database's own data: the zones whose last segment is the place, and
- * `Area/Place` under each geographic area (which admits a renamed city's link,
- * `Kyiv`). Every hit is compared by its canonical name, so a link and its
- * target are one zone. Memoised; the runtime's database does not change.
- *
- * @example
- * ```ts
- * zoneOfPlace('London');   // 'Europe/London'
- * zoneOfPlace('New York'); // 'America/New_York'
- * zoneOfPlace('India');    // undefined — asked, never guessed
- * ```
- */
-export declare function zoneOfPlace(place: string): ZoneName | undefined;
-/**
- * The IANA zone that is a fixed offset, for a whole-hour offset the tz
- * database names (`Etc/GMT+8` is −08:00 — POSIX signs, inverted), else
- * `undefined`. How a window read at a literal offset, or typed with one no
- * other zone shows, names its zone without claiming a place's.
- *
- * @example
- * ```ts
- * fixedOffsetZone(-480); // 'Etc/GMT+8'
- * fixedOffsetZone(0);    // 'UTC'
- * fixedOffsetZone(330);  // undefined — no Etc zone for +05:30
- * ```
- */
-export declare function fixedOffsetZone(minutes: number): ZoneName | undefined;