@indigoai-us/hq-cli 5.313.0 → 5.314.0

package/dist/lib/lanes/types.d.ts

@@ -1,1030 +0,0 @@
-/**
- * Lane record, question routing record, envelope, and config types (spec §3,
- * §4, §5.5, §6.2). Finite sets are string-literal unions plus `const` arrays
- * so the command layer can validate flags explicitly.
- */
-export declare const LANE_SCHEMA_VERSION: "hq-lane.v1";
-export declare const QUESTION_SCHEMA_VERSION: "hq-lane-question.v1";
-export declare const ENVELOPE_SCHEMA_VERSION: "hq-lane-envelope.v1";
-export declare const CONFIG_SCHEMA_VERSION: "hq-lanes-config.v1";
-/** Lane terminal reason for an envelope still invalid after its one repair turn. */
-export declare const ENVELOPE_INVALID_REASON: "envelope_invalid";
-/**
- * The envelope contract as a JSON schema. `parseLaneEnvelope` is the runtime
- * check; this is the text handed to a worker on the repair turn (spec §4) so
- * the two never drift apart in what they name.
- */
-export declare const LANE_ENVELOPE_JSON_SCHEMA: {
-    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
-    readonly title: "hq-lane-envelope.v1";
-    readonly type: "object";
-    readonly additionalProperties: false;
-    readonly required: readonly ["schema_version", "decision", "summary", "story_status", "artifacts"];
-    readonly properties: {
-        readonly schema_version: {
-            readonly const: "hq-lane-envelope.v1";
-        };
-        readonly decision: {
-            readonly enum: readonly ["done", "ask", "blocked"];
-        };
-        readonly summary: {
-            readonly type: "string";
-            readonly minLength: 1;
-        };
-        readonly next_check_at: {
-            readonly type: "string";
-            readonly description: "Optional ISO date-time for a clock-based keep-alive check; invalid values are ignored.";
-        };
-        readonly questions: {
-            readonly type: "array";
-            readonly items: {
-                readonly type: "object";
-                readonly additionalProperties: false;
-                readonly required: readonly ["question", "context", "options"];
-                readonly properties: {
-                    readonly id: {
-                        readonly type: "string";
-                        readonly minLength: 1;
-                        readonly pattern: "\\S";
-                    };
-                    readonly question: {
-                        readonly type: "string";
-                    };
-                    readonly context: {
-                        readonly type: "string";
-                    };
-                    readonly options: {
-                        readonly type: "array";
-                        readonly items: {
-                            readonly type: "string";
-                        };
-                    };
-                    readonly recommended: {
-                        readonly type: "string";
-                    };
-                };
-            };
-        };
-        readonly story_status: {
-            readonly enum: readonly ["queued", "in_progress", "review", "done"];
-        };
-        readonly artifacts: {
-            readonly type: "array";
-        };
-        readonly blocked_reason: {
-            readonly type: "string";
-        };
-        readonly story_complete: {
-            readonly type: "boolean";
-        };
-        readonly story_complete_reason: {
-            readonly type: "string";
-            readonly minLength: 1;
-        };
-    };
-    readonly allOf: readonly [{
-        readonly if: {
-            readonly properties: {
-                readonly decision: {
-                    readonly const: "ask";
-                };
-            };
-        };
-        readonly then: {
-            readonly required: readonly ["questions"];
-            readonly properties: {
-                readonly questions: {
-                    readonly minItems: 1;
-                };
-            };
-        };
-        readonly else: {
-            readonly not: {
-                readonly required: readonly ["questions"];
-            };
-        };
-    }, {
-        readonly if: {
-            readonly properties: {
-                readonly decision: {
-                    readonly const: "blocked";
-                };
-            };
-        };
-        readonly then: {
-            readonly required: readonly ["blocked_reason"];
-            readonly properties: {
-                readonly blocked_reason: {
-                    readonly minLength: 1;
-                };
-            };
-        };
-        readonly else: {
-            readonly not: {
-                readonly required: readonly ["blocked_reason"];
-            };
-        };
-    }, {
-        readonly if: {
-            readonly required: readonly ["story_complete"];
-            readonly properties: {
-                readonly story_complete: {
-                    readonly const: true;
-                };
-            };
-        };
-        readonly then: {
-            readonly required: readonly ["story_complete_reason"];
-            readonly properties: {
-                readonly story_status: {
-                    readonly const: "done";
-                };
-                readonly story_complete_reason: {
-                    readonly minLength: 1;
-                };
-            };
-        };
-        readonly else: {
-            readonly if: {
-                readonly required: readonly ["story_complete"];
-            };
-            readonly then: {
-                readonly required: readonly ["story_complete_reason"];
-                readonly properties: {
-                    readonly story_status: {
-                        readonly not: {
-                            readonly const: "done";
-                        };
-                    };
-                    readonly story_complete_reason: {
-                        readonly minLength: 1;
-                    };
-                };
-            };
-            readonly else: {
-                readonly not: {
-                    readonly required: readonly ["story_complete_reason"];
-                };
-            };
-        };
-    }];
-    readonly description: string;
-};
-export declare const LANE_STATES: readonly ["queued", "running", "awaiting_input", "blocked", "done", "failed", "interrupted", "cancelled", "killed"];
-export type LaneState = (typeof LANE_STATES)[number];
-/** Exact terminal set from spec §6.7. `awaiting_input` and `blocked` are not terminal. */
-export declare const TERMINAL_LANE_STATES: readonly ["done", "failed", "interrupted", "cancelled", "killed"];
-export type TerminalLaneState = (typeof TERMINAL_LANE_STATES)[number];
-export declare const LANE_PROVIDERS: readonly ["claude", "codex", "grok"];
-export type LaneProvider = (typeof LANE_PROVIDERS)[number];
-export declare const QUEUED_REASONS: readonly ["cap", "provider_cap", "account_cap", "profile_cap", "queue_position", "throttle", "provider_binary_missing", "account_retry", "worker_profile_changed", "low_disk"];
-export type QueuedReason = (typeof QUEUED_REASONS)[number];
-export type QueuedDetails = {
-    reason: "worker_profile_changed";
-    expected_hash: string | null;
-    actual_hash: string;
-    recovery_command: string;
-} | {
-    reason: "outpost_dispatch_unknown";
-    outcome_unknown: true;
-    command_id: string | null;
-} | {
-    reason: "low_disk";
-    hq_free_bytes: number;
-    provider_free_bytes: number;
-    measured_at: string;
-};
-export declare function isQueuedReason(value: unknown): value is QueuedReason;
-export declare const HOST_KINDS: readonly ["local", "outpost"];
-export type HostKind = (typeof HOST_KINDS)[number];
-export declare const SENIOR_KINDS: readonly ["session", "lane", "user"];
-export type SeniorKind = (typeof SENIOR_KINDS)[number];
-export declare const ENVELOPE_DECISIONS: readonly ["done", "ask", "blocked"];
-export type EnvelopeDecision = (typeof ENVELOPE_DECISIONS)[number];
-export declare const STORY_STATUSES: readonly ["queued", "in_progress", "review", "done"];
-export type StoryStatus = (typeof STORY_STATUSES)[number];
-/** Durable Board status for a story carried by a lane. */
-export declare const LANE_STORY_STATUSES: readonly ["in_progress", "blocked", "review", "done"];
-export type LaneStoryStatus = (typeof LANE_STORY_STATUSES)[number];
-/**
- * `expired` is accepted on read for records that already carry it. Spec §9
- * ageing advances hop with `unanswered_timeout` and never expires a question,
- * so reconcile (the only writer that may age without an operator) does not
- * write this value. Kept in the enum so `--status expired` and old files parse.
- */
-export declare const QUESTION_STATUSES: readonly ["pending", "answered", "cancelled", "expired"];
-export type QuestionStatus = (typeof QUESTION_STATUSES)[number];
-export declare const RAISED_VIA: readonly ["cli", "envelope"];
-export type RaisedVia = (typeof RAISED_VIA)[number];
-export declare const ROUTING_REASONS: readonly ["asked", "escalated", "audience_ended", "reparented", "unanswered_timeout", "cancelled"];
-export type RoutingReason = (typeof ROUTING_REASONS)[number];
-export declare const QUESTION_BODY_STORES: readonly ["company", "personal"];
-export type QuestionBodyStore = (typeof QUESTION_BODY_STORES)[number];
-export declare const LIVENESS_STATES: readonly ["live", "idle", "ended", "lost"];
-export type LivenessState = (typeof LIVENESS_STATES)[number];
-export declare const HISTORY_CAP = 50;
-export declare function isLaneState(value: unknown): value is LaneState;
-export declare function isTerminalLaneState(value: unknown): value is TerminalLaneState;
-export declare function isLaneProvider(value: unknown): value is LaneProvider;
-export declare function isSeniorKind(value: unknown): value is SeniorKind;
-export declare function isHostKind(value: unknown): value is HostKind;
-export declare function isEnvelopeDecision(value: unknown): value is EnvelopeDecision;
-export declare function isQuestionStatus(value: unknown): value is QuestionStatus;
-export declare function isLivenessState(value: unknown): value is LivenessState;
-export declare function parseLaneProvider(value: unknown): LaneProvider;
-export declare function parseLaneState(value: unknown): LaneState;
-export declare function parseQuestionStatus(value: unknown): QuestionStatus;
-export declare function parseLivenessState(value: unknown): LivenessState;
-export declare function parseSeniorKind(value: unknown): SeniorKind;
-export interface LaneCompanyRef {
-    slug: string;
-    uid: string;
-}
-export interface SeniorRef {
-    kind: SeniorKind;
-    /** Required for session and lane; omitted for the user terminal. */
-    id?: string;
-}
-export interface LaneHost {
-    kind: HostKind;
-    id: string;
-}
-export interface LaneAccountSelectionHostCount {
-    host: LaneHost;
-    enabled: boolean;
-    logged_in: boolean | null;
-    live_lanes: number | null;
-    lane_counts: {
-        running: number | null;
-        queued: number | null;
-        awaiting_input: number | null;
-    };
-    count_source: "lane_list" | "capacity" | "capacity_partial" | "unavailable";
-}
-export interface LaneAccountSelectionConsidered {
-    account: string;
-    eligible: boolean;
-    ineligible_reason?: string;
-    live_lanes: number;
-    counts_complete: boolean;
-    usage: {
-        five_hour_percent?: number;
-        weekly_percent?: number;
-        sampled_at?: string;
-    } | null;
-    /** Latest completed run in the recent-usage window, when lane snapshots are complete. */
-    recent_usage_at?: string | null;
-    hosts: LaneAccountSelectionHostCount[];
-}
-/** Decision evidence saved with a Claude lane when account balancing is active. */
-export interface LaneAccountSelection {
-    account: string;
-    signal: "usage" | "recent_usage" | "lane_count" | "explicit";
-    reason: "least_loaded" | "explicit";
-    target_host: LaneHost;
-    selected_at: string;
-    considered: LaneAccountSelectionConsidered[];
-    skipped_accounts: Array<{
-        account: string;
-        host: LaneHost;
-        reason: string;
-    }>;
-    unavailable_hosts: Array<{
-        host: LaneHost | {
-            kind: "unknown";
-            id: "unknown";
-        };
-        reason: string;
-    }>;
-}
-export interface SeniorHistoryEntry {
-    from: SeniorRef;
-    to: SeniorRef;
-    at: string;
-    by: string;
-    reason: string;
-}
-export interface LaneStopHistoryEntry {
-    at: string;
-    reason: string;
-}
-/** One `hq lanes set` change; it takes effect when the lane next resumes. */
-export interface LaneSettingsHistoryEntry {
-    at: string;
-    actor: string;
-    model?: {
-        from: string | null;
-        to: string;
-    };
-    effort?: {
-        from: string | null;
-        to: string;
-    };
-    reason?: string;
-}
-/** Evidence for a senior-authorized Outpost worker-profile content re-pin. */
-export interface WorkerProfileRepinHistoryEntry {
-    old_hash: string | null;
-    new_hash: string;
-    actor: string;
-    at: string;
-    reason: string;
-}
-/** The registry worker identity and approval contract pinned at lane creation. */
-export interface RegistryWorkerRecord {
-    id: string;
-    path: string;
-    worker_yaml_sha256: string;
-    approval_required: boolean;
-    human_checkpoints: string[];
-}
-/** Append-only approval and consumption events for registry worker checkpoints. */
-export type RegistryWorkerApprovalHistoryEntry = {
-    event: "approved";
-    approval_id: string;
-    checkpoint: string;
-    /** Pins this approval to the registry worker version that received it. */
-    registry_worker_id?: string;
-    worker_yaml_sha256?: string;
-    reason: string;
-    actor: string;
-    at: string;
-} | {
-    event: "consumed";
-    approval_id: string;
-    envelope_ref: string;
-    at: string;
-};
-export interface AttributionHistoryEntry {
-    project_id: string;
-    story_id: string;
-    message_id: string;
-    at: string;
-    story_switch_unacknowledged?: StorySwitchUnacknowledgedNote;
-}
-export interface StorySwitchPending {
-    previous_project_id: string;
-    previous_story_id: string;
-    project_id: string;
-    story_id: string;
-    message_id: string;
-    at: string;
-    previous_artifact_keys: string[];
-}
-export interface StorySwitchUnacknowledgedNote {
-    event: "story_switch_unacknowledged";
-    previous_project_id: string;
-    previous_story_id: string;
-    project_id: string;
-    story_id: string;
-    message_id: string;
-    envelope_ref: string;
-    at: string;
-    artifact_keys: string[];
-}
-export interface LastEnvelopeRef {
-    ref: string;
-    decision: EnvelopeDecision;
-    at: string;
-    /** PR and merge references carried by the worker envelope. */
-    artifacts?: unknown[];
-    blocked_reason?: string;
-    next_check_at?: string;
-}
-export interface ManagerStatusGate {
-    turn_started_at: string;
-    status_mtime_at_start: number | null;
-    status_updated_at_at_start: string | null;
-    status_path: string;
-    turn_id: string;
-    consecutive_misses: number;
-}
-export interface ManagerStatusGateHistoryEntry {
-    event: "status_missed";
-    turn_id: string;
-    path: string;
-    at: string;
-    identified_by: "story_id" | "worker_profile" | "juniors";
-    resume_queued?: boolean;
-    resume_skipped_reason?: "open_question" | "blocked" | "miss_limit" | "no_provider_session";
-}
-export interface BlockerFreshnessState {
-    /** Stable hashes of the stale blocker labels seen at the last completed turn. */
-    stale_keys: string[];
-    stale_labels: string[];
-    /** Hash of the last stale set already escalated to the senior. */
-    escalated_fingerprint?: string;
-    /** The same escalation was recorded locally because a session inbox was unavailable. */
-    undeliverable_fingerprint?: string;
-    undeliverable_reason?: string;
-}
-export interface BlockerFreshnessHistoryEntry {
-    event: "blocker_stale" | "blocker_stale_escalated" | "blocker_stale_escalation_undeliverable";
-    turn_id: string;
-    path: string;
-    at: string;
-    labels: string[];
-    count: number;
-    fingerprint: string;
-    resume_queued?: boolean;
-    resume_skipped_reason?: "open_question" | "blocked" | "miss_limit" | "no_provider_session";
-    delivery_failed?: true;
-    reason?: string;
-    delivery_recovered?: true;
-}
-export interface KrFreshnessState {
-    /** Stable fingerprint of the last stalled KPI set, which is resumed once. */
-    stalled_fingerprint?: string;
-}
-export interface KeepAliveBlockedHistoryEntry {
-    event: "keep_alive_blocked_grace" | "keep_alive_blocked_resumed" | "keep_alive_blocked_escalated";
-    at: string;
-    terminal_at: string;
-    resume_skipped_reason?: "open_question" | "blocked_grace";
-    resume_queued?: boolean;
-}
-export interface KeepAliveResumeHistoryEntry {
-    at: string;
-    resumed_from: "done" | "interrupted" | "blocked";
-    account: string | null;
-}
-/** Bounded audit entry for every lane worker start after its first start. */
-export interface LaneResumeHistoryEntry {
-    at: string;
-    /** Stable trigger class; path-specific starts may use their path name. */
-    trigger: string;
-    /** HQ lane id for an agent caller, or `user` for an explicit human CLI action. */
-    caller?: string;
-}
-export interface FallbackQuestionCancellationFailure {
-    at: string;
-    caller: string;
-    trigger: "message" | "resume";
-    question_ids: string[];
-    error: string;
-}
-export interface KrFreshnessHistoryEntry {
-    event: "kr_stalled";
-    turn_id: string;
-    path: string;
-    at: string;
-    names: string[];
-    count: number;
-    fingerprint: string;
-    resume_queued?: boolean;
-    resume_skipped_reason?: "open_question" | "blocked" | "miss_limit" | "no_provider_session";
-}
-export interface EnvelopeRepairContinueHistoryEntry {
-    event: "envelope_repair_continued";
-    at: string;
-    envelope_ref: string;
-    session_id: string;
-}
-export type LaneGateHistoryEntry = ManagerStatusGateHistoryEntry | BlockerFreshnessHistoryEntry | KrFreshnessHistoryEntry | EnvelopeRepairContinueHistoryEntry | KeepAliveBlockedHistoryEntry;
-export interface LaneStory {
-    project_id: string;
-    story_id: string;
-    status: LaneStoryStatus;
-    added_at: string;
-    updated_at: string;
-    blocked_reason?: string;
-    verified_at?: string;
-    verified_by?: SeniorRef;
-}
-export interface LaneRecord {
-    schema_version: typeof LANE_SCHEMA_VERSION | string;
-    lane_id: string;
-    /** CLI release that most recently wrote this lane record. Absent on legacy rows. */
-    written_by_version?: string;
-    /** CLI release that most recently wrote the owner-host copy synced to primary. */
-    owner_written_by_version?: string;
-    /** `null` is a core/personal lane (spec §6.2 / §10). Not an empty slug. */
-    company: LaneCompanyRef | null;
-    /** Explicit Work Mesh attribution for a personal lane; never inferred from cwd. */
-    mesh_company?: LaneCompanyRef;
-    project_id: string;
-    story_id: string;
-    /** Explicit reason a lane was created without a project story. */
-    no_story_reason?: string;
-    /** Last failed story-ledger synchronization, cleared after a successful retry. */
-    ledger_sync_error?: string;
-    /** Pending question ids owned by this lane. */
-    pending_question_ids?: string[];
-    /**
-     * Stories currently carried by this lane. Old records omit this field and
-     * are migrated in memory from project_id/story_id on read.
-     */
-    stories?: LaneStory[];
-    thread_id?: string;
-    depth: number;
-    senior: SeniorRef;
-    senior_history: SeniorHistoryEntry[];
-    state: LaneState;
-    queued_reason?: QueuedReason;
-    queued_details?: QueuedDetails;
-    /** Time the current queue turn began; old records fall back to created_at. */
-    queued_at?: string;
-    /** Short-lived slot reservation between create persistence and worker spawn. */
-    admission_reserved_at?: string;
-    /**
-     * Set by `hq lanes pickup` when it stores an outpost lane and cleared by
-     * the account bind once the model probe has finished. While set, the
-     * reconcile pass does not admit the lane: a spawn during the probe would
-     * leave a running worker behind a record the probe result then rewrites.
-     */
-    pickup_validation_pending?: true;
-    /** When the pickup validation marker was written. */
-    pickup_validation_pending_since?: string;
-    priority: number;
-    worker?: string;
-    /** Registry-relative directory of the resolved worker, when --worker was set. */
-    worker_path?: string;
-    /** Package name when the worker's realpath is under core/packages. */
-    worker_pack?: string;
-    /** Personal worker profile id applied to every spawn. */
-    worker_profile?: string;
-    /** Whether this lead lane should resume completed turns while its story is open. */
-    keep_alive?: boolean;
-    /** Whether completed keep-alive stories wait for queued work after a done turn. */
-    keep_alive_standing?: boolean;
-    /** Time this lane most recently explicitly opted into keep-alive. */
-    keep_alive_opted_in_at?: string;
-    /** Why reconcile declined to resume this lane most recently. */
-    keep_alive_blocked_reason?: "not_opted_in" | "missing_opt_in_time" | "envelope_before_opt_in" | "interruption_before_opt_in" | "missing_interruption_time" | "retired" | "superseded" | "retired_list_invalid" | "terminal_state";
-    /** Consecutive automatic keep-alive resumes since the last human reset. */
-    keep_alive_resume_count?: number;
-    /** Bounded audit trail of automatic keep-alive resumes; human resets never clear it. */
-    keep_alive_history?: KeepAliveResumeHistoryEntry[];
-    /** Blocked keep-alive resumes in the current blocked episode. */
-    keep_alive_blocked_resume_streak?: number;
-    /** Time the most recent automatic keep-alive resume was queued. */
-    keep_alive_last_resume_at?: string;
-    /** Earliest time the next consecutive automatic resume may be queued. */
-    keep_alive_next_eligible_at?: string;
-    /** Time the automatic resume cap was reached for this run of the story. */
-    keep_alive_exhausted_at?: string;
-    /** Maximum number of direct child lanes this lane may keep alive; old records default to 0. */
-    hire_grant?: number;
-    /** Content hash of the profile last applied to this lane. */
-    worker_profile_hash?: string;
-    /** Registry persona selected by the profile, pinned at lane creation. */
-    registry_worker?: RegistryWorkerRecord;
-    /** Append-only approvals and one-envelope consumption records. */
-    registry_worker_approval_history?: RegistryWorkerApprovalHistoryEntry[];
-    /** Bounded audit history of authorized Outpost profile hash re-pins. */
-    worker_profile_repin_history?: WorkerProfileRepinHistoryEntry[];
-    /** Profile fields intentionally unsupported by the selected provider. */
-    worker_profile_ignored?: string[];
-    /** How policy files were delivered on the most recent profile spawn. */
-    worker_policy_delivery?: "hook" | "prompt";
-    provider: LaneProvider;
-    account?: string;
-    /** Recent Claude account-selection evidence for a create or automatic resume move. */
-    account_selection?: LaneAccountSelection;
-    /** Eligible accounts for a queue entry created without an explicit account. */
-    admission_accounts?: string[];
-    /**
-     * Moves of the lane's session to another account of the same provider,
-     * newest last and capped like the other histories.
-     */
-    account_history?: AccountHistoryEntry[];
-    /** Bounded audit history for explicitly authorized resumes from failed. */
-    failed_resume_history?: FailedResumeHistoryEntry[];
-    /**
-     * Set by an account move (`--account`) until the spawn claims the lane:
-     * the turn the move was asked to run. While set it reserves a slot on the
-     * account for the capacity check of later moves. When the target was at
-     * its cap the lane is queued there and the reconcile pass resumes the
-     * recorded session with this turn instead of starting fresh from the brief.
-     */
-    pending_resume?: PendingResume;
-    placement_default?: LanePlacementPolicy;
-    host: LaneHost;
-    /**
-     * Creating machine's identity when `host.kind` is `outpost` (spec §5.2).
-     * Distinct from `host`, which names where the lane is meant to run.
-     */
-    origin_host?: string;
-    /** How `origin_host` was resolved. Required to compare like-with-like. */
-    origin_host_source?: "imds" | "hostname";
-    version: number;
-    created_at: string;
-    updated_at: string;
-    /** Owner-host completion time copied to a primary mirror during reconcile. */
-    ended_at?: string;
-    /** Summary from the owner's latest terminal envelope, copied to a mirror. */
-    envelope_summary?: string;
-    attribution_history: AttributionHistoryEntry[];
-    last_envelope?: LastEnvelopeRef;
-    /** Pending attribution change, consumed by the next terminal envelope. */
-    story_switch_pending?: StorySwitchPending;
-    /** Last completion suppressed because the new story repeated prior evidence. */
-    story_switch_unacknowledged?: StorySwitchUnacknowledgedNote;
-    /** Effective model id recorded at create/spawn. Omitted when the provider chooses. */
-    model?: string;
-    /** Where the effective model came from; repaired models stay pinned across the account move. */
-    model_source?: "cli" | "profile" | "account" | "provider" | "preserved" | "none";
-    /** Effective effort level passed to the provider at the last spawn (effort.ts). */
-    effort?: string;
-    /** Where `effort` came from. `cli` pins it across later spawns. */
-    effort_source?: "cli" | "profile" | "account" | "provider" | "default_rule" | "none";
-    /** Whether the last spawn used Codex fast mode, including false when disabled. */
-    fast_mode?: boolean;
-    /** Time of the last operator message accepted for this lane. Drives compaction. */
-    last_message_at?: string;
-    /** Turn-start baseline used by the optional manager status gate. */
-    status_gate?: ManagerStatusGate;
-    /** Bounded audit history of manager turns that missed their declared status artifact. */
-    status_gate_history?: LaneGateHistoryEntry[];
-    /** Last blocker-freshness state used to detect consecutive stale turns. */
-    blocker_freshness_state?: BlockerFreshnessState;
-    /** Last stalled KR set already offered one automatic resume. */
-    kr_freshness_state?: KrFreshnessState;
-    /** Last automatic compaction of a resumed session (compaction.ts). */
-    last_compaction?: LaneCompactionRecord;
-    /**
-     * Copied from the last ingested envelope. Omitted when no envelope has
-     * been ingested — absence is not false.
-     */
-    story_complete?: boolean;
-    story_complete_reason?: string;
-    /** Copied from the last ingested envelope when present. */
-    story_status?: StoryStatus;
-    /** Envelope parser failures retained when a usable ask is recovered. */
-    envelope_validation_errors?: string[];
-    /** Set by the reconcile pass when `--timeout` has passed (spec §5.7). */
-    overdue?: boolean;
-    overdue_at?: string;
-    /** Executing-host heartbeat; stale values mean the host stopped reporting. */
-    last_host_report_at?: string;
-    /**
-     * Set by the watcher when a running worker has made no tool call and
-     * produced no output for the silence window; cleared on the next progress
-     * signal or terminal write. Not a verdict: a long single tool call looks
-     * the same as a hang. See watcher.ts.
-     */
-    stalled?: boolean;
-    stalled_at?: string;
-    stalled_reason?: string;
-    /** Set when the reconcile pass force-admits under the starvation bound. */
-    admitted_reason?: string;
-    terminal_reason?: string;
-    /** Reasons supplied to explicit stop commands, retained independently of optional project ledgers. */
-    stop_history?: LaneStopHistoryEntry[];
-    /** Model and effort changes made with `hq lanes set`. */
-    settings_history?: LaneSettingsHistoryEntry[];
-    /**
-     * Model or effort from `hq lanes set` on a running lane. The running turn
-     * keeps its launched values (quota classification reads `model`); the next
-     * spawn applies these and clears them.
-     */
-    pending_settings?: {
-        model?: string;
-        effort?: string;
-    };
-    /** Classification time when this lane entered interrupted; stable across later metadata writes. */
-    interrupted_at?: string;
-    /**
-     * Structured detail behind a named `terminal_reason` (dispatch, pickup and
-     * spawn failures), the missing-binary search path behind
-     * `provider_binary_missing`, or the provider's own message, status, model
-     * and account behind `provider_rejected`. Written by the command, spawn
-     * and watcher writers.
-     */
-    terminal_details?: Record<string, unknown>;
-    /** SSM command id of the `hq outposts exec` pickup that started this lane. */
-    outpost_command_id?: string;
-    /**
-     * Provider reset time copied from a 429 result. Absent when the text
-     * named none. Distinct from the operator's account enabled switch.
-     */
-    quota_reset_at?: string;
-    /** Set when a 429 refused one model for credits, e.g. "needs credits for claude-fable-5-1". */
-    model_quota_marker?: string;
-    /**
-     * Provider session id parsed from the worker's own stdout when a resumable
-     * provider exits: Claude's JSON `result.session_id`, Codex's
-     * `thread.started.thread_id`. Absent when the provider has none or the
-     * output carried none; `provider_session_id_absent` names why. Never a
-     * guessed or path-derived value.
-     */
-    provider_session_id?: string;
-    provider_session_id_absent?: string;
-    /** Provider home used by the most recently spawned run, for transcript recovery. */
-    provider_home_at_spawn?: string;
-    /** Set at spawn when this run continued a recorded session instead of starting fresh. */
-    last_resume?: LaneResumeRecord;
-    /** Last 50 lane worker starts after the initial start, including actor provenance. */
-    resume_history?: LaneResumeHistoryEntry[];
-    /** Bounded failures while closing escalated questions after a fallback resume. */
-    fallback_question_cancellation_failures?: FallbackQuestionCancellationFailure[];
-    /** Cache counters from the last exited run's result. Nothing else from the payload. */
-    last_run_usage?: LaneRunUsage;
-    /** Completion time paired with last_run_usage; written by the watcher. */
-    last_run_usage_at?: string;
-    /**
-     * Spec §4: one repair turn per expected envelope slot when the final output
-     * is invalid or missing. Written before repair spawn and updated on repair
-     * exit. Absent when each slot's first envelope parsed successfully.
-     */
-    envelope_repair?: LaneEnvelopeRepair;
-    /** Last successful lane_progress mesh delivery, preserved across watcher restarts. */
-    last_progress_event_at?: string;
-}
-/** The v1 fields that must exist on every durable lane record (spec §3). */
-export declare const REQUIRED_LANE_RECORD_FIELDS: readonly ["schema_version", "lane_id", "company", "project_id", "story_id", "depth", "senior", "senior_history", "state", "priority", "provider", "host", "version", "created_at", "updated_at", "attribution_history"];
-export declare const LANE_WRITERS: readonly ["creator", "command", "watcher", "reconcile", "spawn", "story-ledger"];
-export type LaneWriter = (typeof LANE_WRITERS)[number];
-/** Field ownership at the durable-record mutation boundary (spec §10.1). */
-export declare const LANE_FIELD_WRITERS: Readonly<Record<keyof LaneRecord, readonly LaneWriter[]>>;
-export interface LaneEnvelopeRepair {
-    /** False when the parse failed but no repair turn could run (see `skipped_reason`). */
-    attempted: boolean;
-    /**
-     * How the repair turn ran: `resume` continues the recorded session (claude,
-     * codex); `fresh_turn` is a new single-turn invocation carrying the raw
-     * output (grok). Absent when no repair ran.
-     */
-    mode?: "resume" | "fresh_turn";
-    succeeded: boolean;
-    first_error: string;
-    /** Parser error from the repair run's output, when that also failed. */
-    second_error?: string;
-    /** Why no repair turn ran: the provider cannot resume, or no session id was recorded. */
-    skipped_reason?: string;
-    /** Envelope slot the repair was asked to rewrite. */
-    envelope_ref?: string;
-    at: string;
-}
-export interface AccountHistoryEntry {
-    from: string | null;
-    to: string;
-    at: string;
-    reason: "first_assignment" | "model_change" | "usage_limit" | "account_unavailable" | "recorded_account_logged_out" | "load_balance" | "keep_alive_resume" | "operator_move";
-}
-export interface FailedResumeHistoryEntry {
-    at: string;
-    actor: string;
-    reason: string;
-    failure: string;
-}
-export interface PendingResume {
-    /** Fresh answered-question launches need no previous session id. */
-    session_id?: string;
-    trigger: "answered_questions" | "message" | "monitor_event" | "system_notice" | "resume" | "watcher";
-    /** True when this queued resume was initiated automatically by keep-alive. */
-    keep_alive?: true;
-    resumed_from?: "interrupted" | "done" | "blocked" | "failed" | "awaiting_input";
-    from_failed?: true;
-    /** Senior that authorized a failed-lane resume, rechecked at the claim CAS. */
-    expected_senior?: SeniorRef;
-    text?: string;
-    message_id?: string;
-    /** The text is already framed as untrusted monitor data, not an operator instruction. */
-    monitor_event?: true;
-    /** Caller identity captured when a deferred start was requested, when known. */
-    caller?: string;
-    /** False when the command passed --no-compact; the deferred spawn honours it. */
-    compact?: boolean;
-    at: string;
-}
-/** Where child lanes created by this manager should be placed by default. */
-export type LanePlacementPolicy = {
-    kind: "local";
-} | {
-    kind: "auto";
-} | {
-    kind: "outpost";
-    id: string;
-};
-export interface LaneResumeRecord {
-    session_id: string;
-    at: string;
-    /** Account the resumed run was bound to. */
-    account?: string;
-    trigger: "answered_questions" | "message" | "monitor_event" | "system_notice" | "resume" | "watcher";
-    /** True when this was an automatic keep-alive resume. */
-    keep_alive?: true;
-    message_id?: string;
-    monitor_event?: true;
-    /**
-     * `hq lanes resume` only: the state the lane was in when the operator
-     * resumed it (`interrupted`, `done`, `blocked`, `failed` or `awaiting_input`)
-     * and the text they sent.
-     */
-    resumed_from?: "interrupted" | "done" | "blocked" | "failed" | "awaiting_input";
-    from_failed?: true;
-    text?: string;
-    /** False when the continued turn explicitly skipped compaction. */
-    compact?: boolean;
-}
-export interface LaneRunUsage {
-    cache_read_input_tokens: number | null;
-    cache_creation_input_tokens: number | null;
-}
-export interface LaneCompactionRecord {
-    at: string;
-    /** `claude_print_compact`: `claude -p --resume <sid> "/compact"` before the resume. */
-    mechanism: "claude_print_compact";
-    session_id: string;
-    /** `compacted` only when the session transcript gained a compact boundary. */
-    outcome: "compacted" | "no_effect" | "failed";
-    reason?: string;
-    duration_ms: number;
-    /** Milliseconds between the reference time and the resume that compacted. */
-    elapsed_ms: number;
-    /** `last_message_at`, or `created_at` when no message was ever sent. */
-    reference_at: string;
-    /** Context size the provider recorded at the compact boundary. */
-    pre_tokens: number | null;
-    /** Usage of the last run before compaction. */
-    before: LaneRunUsage | null;
-    /** Usage of the first run after compaction, once that run has exited. */
-    after: LaneRunUsage | null;
-    /** `last_resume.at` of the run that followed this compaction. */
-    resume_at?: string;
-}
-export interface QuestionBodyRef {
-    store: QuestionBodyStore;
-    ref: string;
-    digest: string;
-}
-export interface RoutingHistoryEntry {
-    hop: number;
-    audience: SeniorRef;
-    at: string;
-    reason: RoutingReason;
-}
-export interface QuestionAnswer {
-    choice: string;
-    /** Whether the answer selected an offered option or supplied new text. */
-    answer_kind?: "option" | "freeform";
-    notes_ref?: string;
-    answered_by: string;
-    answered_at: string;
-    answered_level: number;
-}
-/**
- * A question whose options amount to "continue" or "stop" the brief's own
- * work. The brief already authorises finishing everything it lists, so such a
- * question is flagged for the operator; nothing answers it automatically.
- */
-export type QuestionKind = "continue";
-export type QuestionPriority = "P0" | "P1" | "P2";
-export interface QuestionRecord {
-    schema_version: typeof QUESTION_SCHEMA_VERSION | string;
-    question_id: string;
-    lane_id: string;
-    /** Set by the raiser when the options are only continue/stop. */
-    question_kind?: QuestionKind;
-    /** Urgency selected by the lane author; absent on pre-priority records. */
-    priority?: QuestionPriority;
-    /** `null` when the originating lane has no company. */
-    company: LaneCompanyRef | null;
-    project_id: string;
-    story_id: string;
-    thread_id?: string;
-    raised_via: RaisedVia;
-    asked_at: string;
-    origin: {
-        kind: "lane";
-        id: string;
-    };
-    hop: number;
-    status: QuestionStatus;
-    version: number;
-    /** Null until the owner starts a resume carrying this answer; absent on old records. */
-    delivered_at?: string | null;
-    body: QuestionBodyRef;
-    routing_history: RoutingHistoryEntry[];
-    answer?: QuestionAnswer;
-    /** Merge-on-read preservation of answers retained by conflict sidecars. */
-    answer_history?: QuestionAnswer[];
-}
-export interface EnvelopeQuestion {
-    /** Optional for compatibility with existing v1 envelopes; repair prompts request it. */
-    id?: string;
-    question: string;
-    context: string;
-    options: string[];
-    recommended?: string;
-}
-export interface LaneEnvelope {
-    schema_version: typeof ENVELOPE_SCHEMA_VERSION;
-    decision: EnvelopeDecision;
-    summary: string;
-    next_check_at?: string;
-    questions?: EnvelopeQuestion[];
-    story_status: StoryStatus;
-    artifacts: unknown[];
-    blocked_reason?: string;
-    story_complete?: boolean;
-    story_complete_reason?: string;
-}
-export interface AccountConfig {
-    home: string;
-    /** Optional account home overrides keyed by the owning host's hostname. */
-    hosts?: Record<string, AccountHostHome>;
-    enabled: boolean;
-    disabled_reason?: string;
-    max_running?: number;
-    /** Default model for this account. Beats the provider default; beaten by --model. */
-    model?: string;
-    /** Default effort for this account. Beats the provider default; beaten by --effort. */
-    effort?: string;
-}
-export interface AccountHostHome {
-    home: string;
-}
-export interface ProviderConfig {
-    max_running: number;
-    max_queued: number;
-    /**
-     * Accepted and ignored for selection. Kept so existing config files parse.
-     * Account pick is least-loaded among enabled, logged-in accounts.
-     */
-    default_account?: string;
-    /** Ordered account preferences used only for a lane's first assignment. */
-    preferred_accounts?: string[];
-    /** Default model for this provider when the account does not set one. */
-    model?: string;
-    /** Default effort for this provider when the account does not set one. */
-    effort?: string;
-    /** Codex model ids that should use the provider's fast service tier. */
-    fast_mode_models?: string[];
-    /**
-     * Resume-time compaction threshold: a resumed session whose last message is
-     * at least this old is compacted first. Absent means the one-hour default.
-     */
-    compact_after_ms?: number;
-    /** Claude Code auto-compaction threshold, in tokens. */
-    auto_compact_tokens?: number;
-    /**
-     * Watcher throttle for `lane_progress` thread events: at most one per this
-     * interval, and only on a tick that saw new tool activity or output. Absent
-     * means the five-minute default.
-     */
-    progress_event_min_interval_ms?: number;
-    /**
-     * Hold applied to an account after a 429 whose message names no reset
-     * time: the account is skipped for this long. Absent means the
-     * fifteen-minute default.
-     */
-    quota_default_hold_ms?: number;
-    accounts: Record<string, AccountConfig>;
-}
-export interface ThrottleConfig {
-    cpu_busy_pause: number;
-    cpu_busy_resume: number;
-    min_available_mem_mb: number;
-}
-/** Session liveness windows from spec §9. Missing keys keep these documented defaults. */
-export interface LivenessWindows {
-    /** Last event within this window (or connected presence) → live. Default 10 minutes. */
-    live_within_ms: number;
-    /** `turn_start` with no later `turn_end` after this window → lost. Default 2 hours. */
-    turn_start_lost_ms: number;
-    /** No event at all for this window (and no `session_end`) → lost. Default 12 hours. */
-    silent_lost_ms: number;
-}
-/** Age limits used by `hq lanes checks`; each value is a positive millisecond count. */
-export interface TrackerChecksConfig {
-    owner_question_surface_ms: number;
-    open_question_age_ms: number;
-    status_stale_ms: number;
-    task_list_stale_ms: number;
-    blocker_max_age_ms: number;
-    kpi_value_max_age_ms: number;
-    directive_ack_timeout_ms: number;
-}
-export interface RunawaySearchGuardConfig {
-    /** Wall-time threshold before an unbounded descendant search is stopped. */
-    max_age_seconds: number;
-    /** `find` searches at this depth or less are left alone. */
-    find_maxdepth_exempt: number;
-}
-export interface LanesConfig {
-    schema_version: typeof CONFIG_SCHEMA_VERSION | string;
-    providers: Record<LaneProvider, ProviderConfig>;
-    throttle: ThrottleConfig;
-    liveness: LivenessWindows;
-    tracker: {
-        checks: TrackerChecksConfig;
-    };
-    runaway_search_guard?: RunawaySearchGuardConfig;
-    /** Optional free-space threshold override for the low-disk admission gate. */
-    low_disk_min_free_bytes?: number;
-    /** Retention ages for Codex session rollout maintenance. */
-    codex_rollout_compress_after_hours?: number;
-    codex_rollout_delete_after_days?: number;
-    /** Seconds an unanswered question waits at a session audience before advancing. */
-    session_question_timeout_secs: number;
-    /** Age in hours after which an open manager blocker must be re-verified. */
-    blocker_freshness_hours: number;
-    /** Age in hours after which a manager KPI is considered stalled. */
-    kr_freshness_hours: number;
-}
-export declare function isIsoDateTime(value: string): boolean;
-export declare function parseMajorSchema(schemaVersion: string, expectedPrefix: string, expectedMajor: number): void;
-export declare function parseLaneEnvelope(raw: unknown): LaneEnvelope;
-//# sourceMappingURL=types.d.ts.map