@namzu/sdk 43.0.0 → 44.0.0

package/dist/types/run/config.d.ts

@@ -1,207 +0,0 @@
-import type { TokenBudget } from '../../run/token-budget.js';
-import type { ModelPricing } from '../../utils/cost.js';
-import type { Logger } from '../../utils/logger.js';
-import type { RunId, SessionId, TenantId } from '../ids/index.js';
-import type { PermissionMode } from '../permission/index.js';
-import type { ProjectId, TopicId } from '../session/ids.js';
-import type { CheckpointStore } from './checkpoint-store.js';
-export interface AgentRunConfig {
-    model: string;
-    /** Total run duration in milliseconds; 0 disables the run deadline. */
-    timeoutMs: number;
-    /**
-     * Maximum silence between provider stream chunks, in milliseconds.
-     *
-     * Defaults to five minutes at the `query()` boundary. This is distinct
-     * from `timeoutMs`, which is checked between agent iterations and cannot
-     * settle a provider iterator whose pending `next()` never returns. Set
-     * `0` to retain unbounded stream silence. Positive values must be integer
-     * milliseconds accepted by the platform timer.
-     */
-    streamIdleTimeoutMs?: number;
-    /**
-     * Maximum accumulated inline image/document payload on one provider request.
-     *
-     * Defaults to 24 MiB. The budget is shared by user attachments and rich
-     * tool-result blocks. When history exceeds it, the provider-bound projection
-     * replaces the oldest values with model-visible omission markers; the run's
-     * canonical messages and durable evidence remain unchanged. Set `0` to keep
-     * the prior unbounded behaviour.
-     */
-    maxRequestRichContentBytes?: number;
-    maxResponseTokens?: number;
-    /**
-     * Extended-thinking request, forwarded on every model call in the run.
-     *
-     * Drivers that do not support it ignore the field. Note that a provider
-     * rejects temperature/top_p/top_k while thinking is enabled, so the
-     * driver omits them rather than sending a request it knows will 400.
-     */
-    thinking?: import('../provider/index.js').ThinkingConfig;
-    /**
-     * How much work the model should spend on each call in the run.
-     *
-     * A SIBLING of {@link AgentRunConfig.thinking}, not a field inside it.
-     * On some models the two are independent controls that apply together —
-     * effort shapes the answer while a budget sets thinking depth — so
-     * nesting one inside the other would make that combination unsayable.
-     *
-     * The failure this closes is the one this codebase keeps finding: the
-     * field existed on the provider params, a driver already read it and
-     * wrote it to the wire, and nothing in the kernel ever set it. So a
-     * caller could not reach it at all, and the symptom — every request
-     * going out at the model's default — reads as "this model ignores
-     * effort" rather than "nobody plumbed it through".
-     *
-     * Run-level rather than per-step, deliberately. It is a property of what
-     * the run is FOR, and a value that moves between steps buys a different
-     * answer shape at the cost of the prompt-cache prefix on every step that
-     * changes it.
-     *
-     * A driver that cannot honour it REFUSES rather than dropping it, on the
-     * same reasoning as `thinking`: paying for a run you believe was
-     * high-effort and silently was not is worse than a startup error.
-     */
-    effort?: import('../provider/index.js').ReasoningEffort;
-    /** Provider-hosted search for this run. Explicit opt-in; no local network permission. */
-    webSearch?: import('../provider/index.js').ChatCompletionParams['webSearch'];
-    /** Cumulative parent-and-descendant tokens; 0 is unlimited with usage accounting. */
-    tokenBudget: number;
-    costLimitUsd?: number;
-    /** Main-loop iterations; 0 disables this guard. Omitted defaults depend on the entry point. */
-    maxIterations?: number;
-    temperature?: number;
-    env?: Record<string, string>;
-    permissionMode?: PermissionMode;
-    sandbox?: {
-        timeoutMs?: number;
-        memoryLimitMb?: number;
-        maxProcesses?: number;
-        /**
-         * What the sandbox is rooted at — see `SandboxConfigSchema.workspace`.
-         * Absent means `'ephemeral'`: a fresh temp directory, which is the
-         * behaviour every sandboxed run had before this existed.
-         */
-        workspace?: 'ephemeral' | 'working-directory';
-    };
-    /**
-     * Iteration-checkpoint cadence: create a checkpoint on every Nth
-     * tool-call iteration (iterations 1, 1+N, 1+2N, …). Default `1` —
-     * a checkpoint per iteration, today's behavior. Values < 1 are
-     * treated as 1. Off-cadence iterations also skip the HITL
-     * `iteration_checkpoint` park (there is no checkpoint id to park on).
-     * Tool-review and plan-approval checkpoints are unaffected — those
-     * exist to anchor a pending HITL decision, not for growth control.
-     */
-    checkpointEvery?: number;
-    /**
-     * After creating an iteration checkpoint, prune the run's checkpoint
-     * set down to the newest N. Default `undefined` — never prune, today's
-     * behavior. Each checkpoint copies the full message array, so long
-     * tool-heavy runs grow O(iterations × history) without this.
-     *
-     * Oldest-first by `createdAt`, across all of the run's checkpoints — but
-     * a checkpoint whose park is UNRESOLVED is never collected, whatever its
-     * age. Those rows are what `findPendingCheckpoint` serves to an approval
-     * queue and what `listExpiredParks` enumerates for a sweep, so pruning
-     * briefly holds more than N while a park is outstanding; the next prune
-     * after the park resolves — by `unpark`, or by `expire` for one that ran
-     * out of time — collects them. A host that needs the bound to hold
-     * regardless should sweep expired parks itself.
-     */
-    pruneKeepLast?: number;
-    /**
-     * How long a human-in-the-loop park stays worth serving, in ms.
-     *
-     * Written onto the park as an ABSOLUTE deadline, so it survives the
-     * process that set it. Every timer in the SDK is an in-process
-     * `setTimeout` and the park-record delay is deliberately `unref`'d, so
-     * nothing in memory can outlive a redeploy: without this a run parks for
-     * approval, the worker is replaced, nobody answers, and the checkpoint
-     * stays outstanding forever — every approval-queue reader keeps serving
-     * it and its workspace is never reclaimed.
-     *
-     * The run timeout does not cover this. It is only checked between
-     * iterations and a park suspends mid-iteration, so a long-lived process
-     * hard-stops the run immediately *after* the human finally approves,
-     * while across a restart the restored elapsed clock excludes parked time
-     * entirely — the same configuration producing two opposite outcomes.
-     *
-     * Expiry is enforced on READ (`findPendingCheckpoint` skips an expired
-     * park) and by a host sweep (`listExpiredParks` + `CheckpointManager
-     * .expire`). An out-of-process timer stays a host concern, consistent
-     * with the same decision made for retention.
-     *
-     * Default `undefined` — no deadline, today's behaviour.
-     */
-    hitlParkTtlMs?: number;
-    /**
-     * Override the logger a run's log lines derive from.
-     *
-     * This is an override of the SOURCE, not a substitute for correlation:
-     * `RunContextFactory.buildLogger` always calls `.child()` on whichever
-     * logger this resolves to, so a host-supplied logger still gains
-     * `namzu.run.id`, `sessionId`, `threadId`, `projectId` and `tenantId` —
-     * the same binding the process default gets. A host that wants its own
-     * sink, format or destination threaded through every record a run
-     * produces sets this once; a host that wants the process default
-     * (`getRootLogger()`) sets nothing, which is what absent has always
-     * meant.
-     */
-    logger?: Logger;
-}
-/**
- * Config for {@link RunPersistence}. `sessionId`, `topicId`, `tenantId`,
- * and `projectId` are required — every Run is attributed across the full
- * five-layer scope (Tenant → Project → Topic → Session → Run,
- * Convention #17).
- */
-export interface RunPersistenceConfig {
-    /** Shared account for this invocation and its delegated descendants. */
-    budget?: TokenBudget;
-    runId: RunId;
-    agentId: string;
-    agentName: string;
-    runConfig: AgentRunConfig;
-    providerId: string;
-    outputDir: string;
-    pricing?: ModelPricing;
-    log: Logger;
-    sessionId: SessionId;
-    topicId: TopicId;
-    tenantId: TenantId;
-    projectId: ProjectId;
-    parentRunId?: RunId;
-    depth?: number;
-    /**
-     * Optional checkpoint persistence override. Defaults to the disk
-     * layout under `outputDir` (a
-     * {@link import('../../store/run/checkpoint-disk.js').DiskCheckpointStore});
-     * hosts inject a scope-keyed backend (e.g. Postgres) here.
-     */
-    checkpointStore?: CheckpointStore;
-    /**
-     * Optional run-evidence persistence override. Defaults to the disk layout
-     * under `outputDir` (a
-     * {@link import('../../store/run/disk.js').RunDiskStore}); hosts inject
-     * their own backend here.
-     *
-     * The sibling of `checkpointStore`, and it should have been one from the
-     * start: checkpoints got an injectable seam while the run record, its
-     * messages, its transcript and its report did not, so the evidence was
-     * the one part of a run that could not leave the local filesystem.
-     */
-    runStore?: import('./store.js').RunStore;
-}
-export interface RunStoreConfig {
-    baseDir: string;
-    logger?: Logger;
-}
-export interface LimitCheckerConfig {
-    tokenBudget: number;
-    timeoutMs: number;
-    costLimitUsd?: number;
-    maxIterations: number;
-    budgetWarningThreshold: number;
-}
-//# sourceMappingURL=config.d.ts.map

package/dist/types/run/config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/types/run/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAA;IACjB;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;;;OAQG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,sBAAsB,EAAE,cAAc,CAAA;IAExD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,EAAE,OAAO,sBAAsB,EAAE,eAAe,CAAA;IACvD,yFAAyF;IACzF,SAAS,CAAC,EAAE,OAAO,sBAAsB,EAAE,oBAAoB,CAAC,WAAW,CAAC,CAAA;IAC5E,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,OAAO,CAAC,EAAE;QACT,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB;;;;WAIG;QACH,SAAS,CAAC,EAAE,WAAW,GAAG,mBAAmB,CAAA;KAC7C,CAAA;IAED;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACpC,wEAAwE;IACxE,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,EAAE,KAAK,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,cAAc,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;IAEX,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,EAAE,SAAS,CAAA;IAEpB,WAAW,CAAC,EAAE,KAAK,CAAA;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;;OAKG;IACH,eAAe,CAAC,EAAE,eAAe,CAAA;IAEjC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,YAAY,EAAE,QAAQ,CAAA;CACxC;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,sBAAsB,EAAE,MAAM,CAAA;CAC9B"}

package/dist/types/run/config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/types/run/config.ts"],"names":[],"mappings":""}

package/dist/types/run/derive-status.d.ts

@@ -1,29 +0,0 @@
-import type { RunExecutionStatus } from '../common/index.js';
-import type { PendingDecision } from '../hitl/index.js';
-import type { RunStatus } from './status.js';
-/**
- * Project what the SDK records about a run onto the session-layer
- * {@link RunStatus}.
- *
- * `Run.status` is an {@link RunExecutionStatus} — six values, none of which can
- * say "a human owes this run an answer". `RunStatus` has the vocabulary for
- * that and is consumed by session-status derivation and by handoff gating,
- * but nothing in the repo ever produced it: a host implementing a resolver
- * had to invent the projection, and the two `awaiting_hitl*` variants in
- * particular had no producer at all. `awaiting_hitl_resolution` documented
- * a "persisted wait after a HITL timeout" for a timeout nothing could
- * raise.
- *
- * The park record is the missing input. It is durable, it is what an
- * approval queue already reads, and it carries the deadline that separates
- * "waiting" from "waited too long".
- */
-export declare function deriveRunStatus(input: {
-    /** What the run itself recorded. */
-    readonly status: RunExecutionStatus;
-    /** The run's outstanding park, if it has one. */
-    readonly park?: PendingDecision;
-    /** Injectable for tests; defaults to now. */
-    readonly now?: number;
-}): RunStatus;
-//# sourceMappingURL=derive-status.d.ts.map

package/dist/types/run/derive-status.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"derive-status.d.ts","sourceRoot":"","sources":["../../../src/types/run/derive-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACtC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAA;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACrB,GAAG,SAAS,CAiCZ"}

package/dist/types/run/derive-status.js

@@ -1,49 +0,0 @@
-/**
- * Project what the SDK records about a run onto the session-layer
- * {@link RunStatus}.
- *
- * `Run.status` is an {@link RunExecutionStatus} — six values, none of which can
- * say "a human owes this run an answer". `RunStatus` has the vocabulary for
- * that and is consumed by session-status derivation and by handoff gating,
- * but nothing in the repo ever produced it: a host implementing a resolver
- * had to invent the projection, and the two `awaiting_hitl*` variants in
- * particular had no producer at all. `awaiting_hitl_resolution` documented
- * a "persisted wait after a HITL timeout" for a timeout nothing could
- * raise.
- *
- * The park record is the missing input. It is durable, it is what an
- * approval queue already reads, and it carries the deadline that separates
- * "waiting" from "waited too long".
- */
-export function deriveRunStatus(input) {
-    const { status, park } = input;
-    const now = input.now ?? Date.now();
-    // Terminal beats parked. A run that finished, failed or was cancelled
-    // is not waiting for anyone, whatever a stale park record says.
-    switch (status) {
-        case 'completed':
-            return 'succeeded';
-        case 'failed':
-            return 'failed';
-        case 'cancelled':
-            return 'cancelled';
-        case 'idle':
-        case 'pending':
-        case 'running':
-            break;
-        default: {
-            const _exhaustive = status;
-            throw new Error(`Unmapped agent status: ${_exhaustive}`);
-        }
-    }
-    if (park && park.resolvedAt === undefined) {
-        // A deadline that has passed means the window closed with nobody
-        // answering. The work is not lost and the run stays resumable from
-        // its checkpoint, so this is a persisted wait rather than a terminal
-        // state — which is exactly what the reserved variant describes.
-        const expired = park.deadlineAt !== undefined && now >= park.deadlineAt;
-        return expired ? 'awaiting_hitl_resolution' : 'awaiting_hitl';
-    }
-    return status === 'running' ? 'running' : 'queued';
-}
-//# sourceMappingURL=derive-status.js.map

package/dist/types/run/derive-status.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"derive-status.js","sourceRoot":"","sources":["../../../src/types/run/derive-status.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,KAO/B;IACA,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAC9B,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAA;IAEnC,sEAAsE;IACtE,gEAAgE;IAChE,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,WAAW;YACf,OAAO,WAAW,CAAA;QACnB,KAAK,QAAQ;YACZ,OAAO,QAAQ,CAAA;QAChB,KAAK,WAAW;YACf,OAAO,WAAW,CAAA;QACnB,KAAK,MAAM,CAAC;QACZ,KAAK,SAAS,CAAC;QACf,KAAK,SAAS;YACb,MAAK;QACN,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,WAAW,GAAU,MAAM,CAAA;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,WAAqB,EAAE,CAAC,CAAA;QACnE,CAAC;IACF,CAAC;IAED,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC3C,iEAAiE;QACjE,mEAAmE;QACnE,qEAAqE;QACrE,gEAAgE;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,CAAA;QACvE,OAAO,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,eAAe,CAAA;IAC9D,CAAC;IAED,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAA;AACnD,CAAC"}

package/dist/types/run/emergency.d.ts

@@ -1,32 +0,0 @@
-import { z } from 'zod';
-import type { TokenUsage } from '../common/index.js';
-import type { EmergencySaveId, RunId } from '../ids/index.js';
-import type { Message } from '../message/index.js';
-import type { TokenBudgetBinding } from './token-budget-store.js';
-export interface EmergencySaveData {
-    /** Reference to the canonical tree ledger; a checkpoint never resets it. */
-    readonly budgetBinding?: TokenBudgetBinding;
-    /** Also present for non-durable accounts; those require the live authority on resume. */
-    readonly budgetAccountId?: string;
-    id: EmergencySaveId;
-    runId: RunId;
-    messages: Message[];
-    tokenUsage: TokenUsage;
-    currentIteration: number;
-    startedAt: number;
-    savedAt: number;
-    processSignal: string;
-    lastError?: string;
-}
-export declare const EmergencySaveConfigSchema: z.ZodObject<{
-    enabled: z.ZodDefault<z.ZodBoolean>;
-    emergencyDir: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    enabled: boolean;
-    emergencyDir?: string | undefined;
-}, {
-    enabled?: boolean | undefined;
-    emergencyDir?: string | undefined;
-}>;
-export type EmergencySaveConfig = z.infer<typeof EmergencySaveConfigSchema>;
-//# sourceMappingURL=emergency.d.ts.map

package/dist/types/run/emergency.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emergency.d.ts","sourceRoot":"","sources":["../../../src/types/run/emergency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,MAAM,WAAW,iBAAiB;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAA;IAC3C,yFAAyF;IACzF,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,EAAE,EAAE,eAAe,CAAA;IACnB,KAAK,EAAE,KAAK,CAAA;IACZ,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,UAAU,EAAE,UAAU,CAAA;IACtB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;EAGpC,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA"}

package/dist/types/run/emergency.js

@@ -1,6 +0,0 @@
-import { z } from 'zod';
-export const EmergencySaveConfigSchema = z.object({
-    enabled: z.boolean().default(true),
-    emergencyDir: z.string().optional(),
-});
-//# sourceMappingURL=emergency.js.map

package/dist/types/run/emergency.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"emergency.js","sourceRoot":"","sources":["../../../src/types/run/emergency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAsBvB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAA"}

package/dist/types/run/entity.d.ts

@@ -1,151 +0,0 @@
-import type { TokenBudgetSummary } from '../../run/token-budget.js';
-import type { CostInfo, RunExecutionStatus, TokenUsage } from '../common/index.js';
-import type { RunId } from '../ids/index.js';
-import type { Message } from '../message/index.js';
-import type { ProviderErrorInfo } from '../provider/index.js';
-import type { AgentRunConfig } from './config.js';
-import type { ReplayAttribution } from './replay.js';
-import type { StepResult } from './step.js';
-import type { StopReason } from './stop-reason.js';
-import type { TokenBudgetBinding } from './token-budget-store.js';
-export interface RunStateMetadata {
-    /** This invocation's owner, independent of a shared ancestor token account. */
-    readonly scope?: {
-        readonly tenantId: string;
-        readonly projectId: string;
-        readonly sessionId: string;
-        readonly runId: string;
-    };
-    agentId: string;
-    agentName: string;
-    config: AgentRunConfig;
-    /**
-     * The provider the run was CONFIGURED with — the head of the chain, and
-     * the counterpart of `config.model` beside it.
-     *
-     * It is a declaration, not an observation, and it stays one. After a
-     * provider chain falls over it still names the head, which is correct for
-     * a field that answers "what was asked for"; it was only ever misleading
-     * because nothing else answered "what served". See {@link servingProvider}
-     * for the run-level answer and `steps[].servedBy` for the per-step one.
-     */
-    provider: string;
-    /**
-     * The chain member the run was routed to at the end, when that is not the
-     * one it was configured with.
-     *
-     * Absent means the declared provider served every call. That reading holds
-     * for stored records too, with one bounded exception: the sdk major that
-     * shipped the chain could fall over without recording it, so a run from
-     * that release reads as "no swap" whether or not there was one. Its
-     * transcript still carries the `provider_fallback` events. The exception
-     * is one release wide and it is stated rather than migrated away, because
-     * a migration would have to invent the answer for exactly the records that
-     * do not have it.
-     *
-     * **This is the durable half.** `RunDiskStore.writeRunMeta` writes
-     * `metadata` and not `steps`, so on the built-in store this field is the
-     * whole of what survives the process. `steps[].servedBy` is the finer
-     * record — the one to read for "which member answered turn 4" — and it
-     * reaches a host only on the returned `Run`.
-     *
-     * It also covers the case no step ledger can: a run that falls over and
-     * then dies before a single step is recorded still has to be able to say
-     * whose failure ended it. That is why the wording is "routed to" and not
-     * "served by" — this member was asked, and on that path it answered with
-     * an error. It is never a member that was merely selected: the chain
-     * announces a replacement when it issues its request, not when it picks
-     * it, so a run cancelled at the swap notice does not name one.
-     */
-    servingProvider?: string;
-}
-/**
- * Domain Run entity — the persistence record for a single agent invocation
- * under a {@link import('../session/entity.js').Session}. Renamed from
- * `AgentRun` on 2026-04-21 (ses_010 commit 7) to match the 5-layer hierarchy
- * (`Project → Thread → Session → SubSession → Run`) ratified in ses_001.
- *
- * The wire counterpart is `WireRun` under `contracts/api.ts` — the two stay
- * decoupled so the HTTP field shape can evolve independently from this
- * persistence record.
- */
-export interface Run {
-    id: RunId;
-    status: RunExecutionStatus;
-    metadata: RunStateMetadata;
-    messages: Message[];
-    /** Usage of this invocation only; descendant spend is in budget. */
-    tokenUsage: TokenUsage;
-    budget?: TokenBudgetSummary;
-    budgetBinding?: TokenBudgetBinding;
-    costInfo: CostInfo;
-    currentIteration: number;
-    startedAt: number;
-    endedAt?: number;
-    stopReason?: StopReason;
-    lastError?: string;
-    lastProviderError?: ProviderErrorInfo;
-    result?: string;
-    /**
-     * Per-iteration record of what the loop did. Absent on a run that
-     * never entered the loop.
-     *
-     * A host that persists the returned `Run` used to lose all per-step
-     * attribution: "which step cost the most" required correlating raw
-     * RunEvents by iteration and diffing cumulative counters.
-     */
-    steps?: readonly StepResult[];
-    /**
-     * Schema-validated final output, when `structuredOutput` was requested
-     * and the model produced one. Absent otherwise — check `stopReason`
-     * for `structured_output_failed`.
-     */
-    structuredOutput?: unknown;
-    /**
-     * Delegated tasks that were still running when this run ended.
-     *
-     * A run can settle while a worker it launched is still going — the model
-     * answered, a terminal tool decided the result, a `stopWhen` fired. The
-     * worker is NOT cancelled: giving up on a wait is a statement about the
-     * waiter, not about the work, and killing a child that may be mid-write
-     * because its parent finished early is a policy only the host can judge.
-     * A host that wants them stopped has `cancel_task` and the run controller.
-     *
-     * What the kernel owes instead is not pretending the results arrived.
-     * These ids are the honest form of that: the run says which work it walked
-     * away from, so a host can reconcile, cancel, or wait on them itself.
-     * Absent when a run ended with nothing outstanding.
-     */
-    abandonedTaskIds?: readonly string[];
-    /**
-     * Background jobs the model was waiting on that were still running when
-     * this run ended.
-     *
-     * Only jobs `wait_for_job` named: a dev server nobody awaited is not work
-     * this run walked away from, it is work it deliberately left behind. The
-     * run holds itself open for these, bounded, and names the ones the bound
-     * ran out on — the same honesty `abandonedTaskIds` owes for a delegated
-     * worker, and with the same limit: naming a job is not stopping it. A
-     * run-owned job is still stopped by the run's own teardown; one bound to
-     * the host's session keeps running, which is what it was started for.
-     */
-    abandonedJobIds?: readonly string[];
-    parentRunId?: RunId;
-    depth?: number;
-    /**
-     * Present when this run was produced by {@link replay}. `undefined` for
-     * original runs. See `ses_005-deterministic-replay` for the primitive.
-     */
-    replayOf?: ReplayAttribution;
-}
-/**
- * @deprecated Use {@link Run}. Alias retained for the 0.4.x compatibility
- * window; scheduled for removal in a later session.
- */
-export type AgentRun = Run;
-/**
- * @deprecated Use {@link Run}. Alias retained for the 0.4.x compatibility
- * window; scheduled for removal in a later session.
- */
-export type AgentSession = Run;
-//# sourceMappingURL=entity.d.ts.map

package/dist/types/run/entity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../../src/types/run/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAClF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,MAAM,WAAW,gBAAgB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,cAAc,CAAA;IACtB;;;;;;;;;OASG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,GAAG;IACnB,EAAE,EAAE,KAAK,CAAA;IACT,MAAM,EAAE,kBAAkB,CAAA;IAC1B,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,oEAAoE;IACpE,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,aAAa,CAAC,EAAE,kBAAkB,CAAA;IAClC,QAAQ,EAAE,QAAQ,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IAE7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAE1B;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAEpC;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAEnC,WAAW,CAAC,EAAE,KAAK,CAAA;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAA;AAE1B;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,GAAG,CAAA"}

package/dist/types/run/entity.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=entity.js.map

package/dist/types/run/entity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/types/run/entity.ts"],"names":[],"mappings":""}

package/dist/types/run/event-cursor.d.ts

@@ -1,90 +0,0 @@
-/**
- * Where a reconnecting consumer left off, and whether the kernel can honour it.
- *
- * The shortfall is a VALUE here, not a sentence in a document. A consumer that
- * asks for everything after sequence 400 and silently receives a splice from a
- * different generation of the run is wrong and has no way to find out; a
- * consumer handed `{ status: 'unavailable', reason: 'cursor_ahead' }` re-derives
- * from the transcript and is right. That is refuse-do-not-degrade applied to a
- * subscription rather than to a capability.
- */
-import type { FencingToken } from './checkpoint-store.js';
-import type { PersistedRunEvent } from './events.js';
-/** What a consumer holds when it comes back. */
-export interface RunEventCursor {
-    /**
-     * The last `seq` the consumer actually received, from the envelope. Zero —
-     * or the field absent — means "from the beginning".
-     */
-    readonly sinceSeq: number;
-    /**
-     * The `generation` carried on the events the consumer received, when they
-     * carried one.
-     *
-     * Compared for equality only. Absent on both sides is not a match and not a
-     * mismatch: it is an unfenced run, where the sequence is the only evidence
-     * available and the log persisting is the assumption.
-     */
-    readonly generation?: FencingToken;
-}
-/** Why a cursor could not be honoured. */
-export type RunEventReplayRefusal = 
-/**
- * The consumer claims to have seen more than the log holds.
- *
- * The ordinary cause is not a lying client: it is a log that did not
- * survive. An in-memory run store on a restarted process seeds at zero
- * while the consumer still holds 400, and this is the verdict that says so
- * instead of reporting a serene "you are up to date".
- */
-'cursor_ahead'
-/**
- * The run has been taken over since. The consumer's sequence numbers were
- * minted under an older claim and address a different sequence space, so
- * they are not comparable — not merely stale.
- */
- | 'generation_changed'
-/**
- * The store answered, and its oldest available event is above the one after
- * the cursor. A pruning or windowed backend, caught at the boundary rather
- * than delivered as a continuous stream with a hole in it.
- */
- | 'gap';
-/** What came of a cursor. */
-export type RunEventReplay = 
-/** The cursor is already at the log's head. Nothing was missed. */
-{
-    readonly status: 'complete';
-}
-/** Contiguous from `sinceSeq + 1`, oldest first. */
- | {
-    readonly status: 'replayed';
-    readonly events: readonly PersistedRunEvent[];
-}
-/** Nothing is delivered. The consumer re-derives from the transcript. */
- | {
-    readonly status: 'unavailable';
-    readonly reason: RunEventReplayRefusal;
-};
-/** The log's present state, as the store reports it. */
-export interface RunEventLogHead {
-    /** Highest sequence in the log; zero when it is empty. */
-    readonly lastSeq: number;
-    /** The fence the run is being written under, when it holds a claim. */
-    readonly generation?: FencingToken;
-}
-/**
- * Decide what a cursor is owed, given what the log holds.
- *
- * Pure, and ordered deliberately: a takeover invalidates the sequence space, so
- * comparing sequences across generations would be arithmetic on two different
- * scales. The generation check therefore runs FIRST, before the numbers are
- * allowed to mean anything.
- *
- * `events` is what the store returned for `{ sinceSeq: cursor.sinceSeq }`. It is
- * passed in rather than fetched here so this stays a function of its arguments
- * — the property "no gap, no duplicate" is decidable from the three inputs, and
- * a test can drive every branch without a store.
- */
-export declare function resolveRunEventReplay(cursor: RunEventCursor, head: RunEventLogHead, events: readonly PersistedRunEvent[]): RunEventReplay;
-//# sourceMappingURL=event-cursor.d.ts.map

package/dist/types/run/event-cursor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-cursor.d.ts","sourceRoot":"","sources":["../../../src/types/run/event-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;CAClC;AAED,0CAA0C;AAC1C,MAAM,MAAM,qBAAqB;AAChC;;;;;;;GAOG;AACD,cAAc;AAChB;;;;GAIG;GACD,oBAAoB;AACtB;;;;GAIG;GACD,KAAK,CAAA;AAER,6BAA6B;AAC7B,MAAM,MAAM,cAAc;AACzB,mEAAmE;AACjE;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE;AACjC,oDAAoD;GAClD;IAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAAE;AAChF,yEAAyE;GACvE;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAA;AAE7E,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAA;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACpC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,SAAS,iBAAiB,EAAE,GAClC,cAAc,CA2BhB"}