ocmm 0.5.3 → 0.6.0

package/dist/runtime-fallback/subagent-429-controller.d.ts

@@ -0,0 +1,167 @@
+import { log as defaultLog } from "../shared/logger.ts";
+import type { FallbackEntry } from "../shared/types.ts";
+import type { FallbackCandidateBlocker, PeekResult } from "./fallback-state.ts";
+import type { RuntimeFallbackConfig } from "../config/schema.ts";
+export type Subagent429Scope = "model" | "provider";
+export type Subagent429Target = {
+    providerID: string;
+    modelID: string;
+    entry: FallbackEntry;
+};
+export type Subagent429Scheduler = {
+    schedule(delayMs: number, run: () => Promise<void>): () => void;
+};
+export type Subagent429DispatchInput = {
+    sessionID: string;
+    snapshotId: number;
+    agent?: string;
+    target: Subagent429Target;
+    reason: string;
+};
+export type Subagent429PreparedSwitch = {
+    target: Subagent429Target;
+    attempt: number;
+    snapshotId: number;
+    commit: () => void;
+};
+export type Subagent429PrepareFailure = Extract<PeekResult, {
+    ok: false;
+}>["reason"] | "dispatch-failed";
+export type Subagent429PrepareResult = {
+    ok: true;
+    prepared: Subagent429PreparedSwitch;
+} | {
+    ok: false;
+    reason: Subagent429PrepareFailure;
+};
+export type Subagent429ErrorInput = {
+    sessionID: string;
+    snapshotId: number;
+    agent?: string;
+    target: Subagent429Target;
+    classification: {
+        reason: string;
+        recoveryDelayMs?: number;
+    };
+    runtimeConfig: RuntimeFallbackConfig;
+    prepareSwitch: (failedTarget: Subagent429Target, isCandidateBlocked: FallbackCandidateBlocker) => Subagent429PrepareResult;
+};
+export type Subagent429GenericHandoff = (activeTarget: Subagent429Target) => Promise<void>;
+export type Subagent429OtherErrorInput = {
+    sessionID: string;
+    snapshotId: number;
+    runGenericFallback: Subagent429GenericHandoff;
+};
+export type Queued429 = {
+    kind: "429";
+    snapshotId: number;
+    dispatchGeneration: number;
+    input: Subagent429ErrorInput;
+    errorIdleObserved: boolean;
+};
+export type QueuedOtherError = {
+    kind: "other";
+    snapshotId: number;
+    dispatchGeneration: number;
+    runGenericFallback: Subagent429GenericHandoff;
+};
+export type QueuedOutcome = Queued429 | QueuedOtherError;
+export type Subagent429Decision = {
+    handled: false;
+} | {
+    handled: true;
+    action: "retry-gated";
+    delayMs: number;
+    retryOrdinal: number;
+    scope: Subagent429Scope;
+} | {
+    handled: true;
+    action: "switch-gated";
+    attempt: number;
+    target: Subagent429Target;
+} | {
+    handled: true;
+    action: "queued-429";
+    dispatchGeneration: number;
+} | {
+    handled: true;
+    action: "duplicate-outcome";
+    dispatchGeneration: number;
+} | {
+    handled: true;
+    action: "observe-only";
+} | {
+    handled: true;
+    action: "stopped";
+    reason: Subagent429PrepareFailure | "dispatch-unavailable";
+};
+export type Subagent429OtherErrorDecision = {
+    handled: false;
+} | {
+    handled: true;
+    action: "queued-other-error";
+    dispatchGeneration: number;
+} | {
+    handled: true;
+    action: "duplicate-outcome";
+    dispatchGeneration: number;
+};
+export type Subagent429IdleResult = {
+    kind: "untracked" | "initial-succeeded" | "error-idle-observed" | "dispatch-idle-observed" | "queued-error-idle-observed" | "retry-succeeded";
+    suppressIdleContinuation: boolean;
+};
+export type SubagentInterruptionCorrelation = {
+    childSessionID: string;
+    parentSessionID: string;
+    callID?: string;
+    agent?: string;
+    taskID?: string;
+    terminalTaskErrorObserved: boolean;
+    retryableChildErrorObserved: boolean;
+    explicitlyAborted: boolean;
+};
+export type SubagentSessionLineageInput = {
+    childSessionID: string;
+    parentSessionID: string;
+    agent?: string;
+};
+export type SubagentTaskPartEvidence = {
+    childSessionID: string;
+    parentSessionID: string;
+    parentPartID?: string;
+    callID?: string;
+    agent?: string;
+    taskID?: string;
+    terminalTaskErrorObserved: true;
+};
+export type SubagentCorrelationLookup = {
+    childSessionID?: string;
+    parentSessionID?: string;
+    parentPartID?: string;
+    taskID?: string;
+};
+export type Subagent429Controller = {
+    onSessionCreated(sessionID: string, isChild: boolean, snapshotId: number): void;
+    on429(input: Subagent429ErrorInput): Subagent429Decision;
+    onOtherError(input: Subagent429OtherErrorInput): Subagent429OtherErrorDecision;
+    onIdle(sessionID: string, snapshotId: number): Subagent429IdleResult;
+    onDeleted(sessionID: string): void;
+    getActiveDispatchTarget(sessionID: string, snapshotId: number): Subagent429Target | undefined;
+    recordSessionLineage(input: SubagentSessionLineageInput): "recorded" | "untracked";
+    recordTaskPart(input: SubagentTaskPartEvidence): "recorded" | "duplicate" | "untracked";
+    markRetryableChildError(childSessionID: string): void;
+    markExplicitAbort(childSessionID: string): void;
+    getInterruptionCorrelation(input: SubagentCorrelationLookup): Readonly<SubagentInterruptionCorrelation> | undefined;
+    claimInterruptionNotice(input: SubagentCorrelationLookup): boolean;
+};
+export type Subagent429ControllerDeps = {
+    isCurrentSnapshot: (snapshotId: number) => boolean;
+    scheduler?: Subagent429Scheduler;
+    clock?: () => number;
+    random?: () => number;
+    dispatchRetry?: (input: Subagent429DispatchInput) => Promise<boolean>;
+    logger?: Pick<typeof defaultLog, "debug" | "info" | "warn">;
+};
+export declare const INACTIVE_CORRELATION_GRACE_MS: number;
+export declare const MAX_INACTIVE_CORRELATION_RECORDS = 256;
+export declare function createSubagent429Controller(deps: Subagent429ControllerDeps): Subagent429Controller;

package/dist/runtime-fallback/subagent-429-controller.js

@@ -0,0 +1,334 @@
+import { log as defaultLog } from "../shared/logger.js";
+import { Session429State } from "./subagent-429-session.js";
+import { canonicalizeReviewAgentName } from "../review-agents/names.js";
+const defaultScheduler = {
+    schedule(delayMs, run) {
+        const handle = setTimeout(() => { void run(); }, delayMs);
+        return () => clearTimeout(handle);
+    },
+};
+export const INACTIVE_CORRELATION_GRACE_MS = 5 * 60_000;
+export const MAX_INACTIVE_CORRELATION_RECORDS = 256;
+export function createSubagent429Controller(deps) {
+    const sessions = new Map();
+    const clock = deps.clock ?? Date.now;
+    const stateDeps = {
+        scheduler: deps.scheduler ?? defaultScheduler,
+        clock,
+        random: deps.random ?? Math.random,
+        isCurrentSnapshot: deps.isCurrentSnapshot,
+        ...(deps.dispatchRetry === undefined ? {} : { dispatchRetry: deps.dispatchRetry }),
+        logger: deps.logger ?? defaultLog,
+    };
+    function markInactive(record) {
+        record.inactiveSince = clock();
+    }
+    function refreshInactiveGrace(record) {
+        if (record.retry === undefined)
+            markInactive(record);
+    }
+    function pruneInactiveRecords() {
+        const now = clock();
+        for (const [sessionID, record] of sessions) {
+            if (record.retry !== undefined || record.inactiveSince === undefined)
+                continue;
+            if (now - record.inactiveSince >= INACTIVE_CORRELATION_GRACE_MS)
+                sessions.delete(sessionID);
+        }
+        const inactive = [...sessions.entries()]
+            .filter(([, record]) => record.retry === undefined)
+            .sort(([, left], [, right]) => (left.inactiveSince ?? now) - (right.inactiveSince ?? now));
+        for (const [sessionID] of inactive.slice(0, Math.max(0, inactive.length - MAX_INACTIVE_CORRELATION_RECORDS))) {
+            sessions.delete(sessionID);
+        }
+    }
+    function createRetryState(sessionID, record, snapshotId) {
+        let retry;
+        retry = new Session429State(sessionID, snapshotId, stateDeps, () => {
+            const current = sessions.get(sessionID);
+            return current === record && current.retry === retry;
+        }, () => {
+            // Stop callback clears only retry state. Preserve durable correlation
+            // for the bounded late-event grace window; lazy public-path pruning
+            // removes it when OpenCode omits session.deleted.
+            const current = sessions.get(sessionID);
+            if (current === record && current.retry === retry) {
+                current.retry = undefined;
+                markInactive(current);
+            }
+        });
+        return retry;
+    }
+    function dedupKey(input) {
+        const identity = input.parentPartID ?? input.callID ?? input.taskID ?? input.childSessionID;
+        return `${input.parentSessionID}:${identity}`;
+    }
+    return {
+        onSessionCreated(sessionID, isChild, snapshotId) {
+            pruneInactiveRecords();
+            // OpenCode can replay session.created while the child remains active.
+            // Preserve its retry state and durable correlation in that case. A
+            // session.deleted call removes the record, so delete→recreate still
+            // starts a fresh lifecycle below.
+            const existing = sessions.get(sessionID);
+            if (existing) {
+                const retry = existing.retry;
+                if (retry && (!retry.matchesSnapshot(snapshotId) || !deps.isCurrentSnapshot(snapshotId))) {
+                    retry.stop();
+                    if (isChild && deps.isCurrentSnapshot(snapshotId)) {
+                        existing.retry = createRetryState(sessionID, existing, snapshotId);
+                    }
+                }
+                return;
+            }
+            if (!isChild)
+                return;
+            const record = {
+                seenParentParts: new Set(),
+                parentEvidenceIDs: new Set(),
+                claimedNotices: new Set(),
+            };
+            record.retry = createRetryState(sessionID, record, snapshotId);
+            sessions.set(sessionID, record);
+        },
+        on429(input) {
+            pruneInactiveRecords();
+            const record = sessions.get(input.sessionID);
+            const previousRetry = record?.retry;
+            let retry = previousRetry;
+            if (retry && (!retry.matchesSnapshot(input.snapshotId) || !deps.isCurrentSnapshot(input.snapshotId))) {
+                retry.stop();
+                retry = undefined;
+            }
+            if (!retry && previousRetry && record && deps.isCurrentSnapshot(input.snapshotId)) {
+                retry = createRetryState(input.sessionID, record, input.snapshotId);
+                record.retry = retry;
+            }
+            const decision = retry?.on429(input) ?? { handled: false };
+            pruneInactiveRecords();
+            return decision;
+        },
+        onOtherError(input) {
+            pruneInactiveRecords();
+            const retry = sessions.get(input.sessionID)?.retry;
+            if (retry && (!retry.matchesSnapshot(input.snapshotId) || !deps.isCurrentSnapshot(input.snapshotId))) {
+                retry.stop();
+                pruneInactiveRecords();
+                return { handled: false };
+            }
+            const decision = retry?.onOtherError(input) ?? { handled: false };
+            pruneInactiveRecords();
+            return decision;
+        },
+        onIdle(sessionID, snapshotId) {
+            pruneInactiveRecords();
+            const retry = sessions.get(sessionID)?.retry;
+            if (retry && (!retry.matchesSnapshot(snapshotId) || !deps.isCurrentSnapshot(snapshotId))) {
+                retry.stop();
+                pruneInactiveRecords();
+                return { kind: "untracked", suppressIdleContinuation: false };
+            }
+            const result = retry?.onIdle() ?? { kind: "untracked", suppressIdleContinuation: false };
+            pruneInactiveRecords();
+            return result;
+        },
+        onDeleted(sessionID) {
+            pruneInactiveRecords();
+            const record = sessions.get(sessionID);
+            record?.retry?.stop();
+            sessions.delete(sessionID);
+        },
+        getActiveDispatchTarget(sessionID, snapshotId) {
+            pruneInactiveRecords();
+            const retry = sessions.get(sessionID)?.retry;
+            if (!retry)
+                return undefined;
+            if (!retry.matchesSnapshot(snapshotId) || !deps.isCurrentSnapshot(snapshotId)) {
+                retry.stop();
+                pruneInactiveRecords();
+                return undefined;
+            }
+            return retry.activeTarget();
+        },
+        recordSessionLineage(input) {
+            pruneInactiveRecords();
+            const record = sessions.get(input.childSessionID);
+            if (!record)
+                return "untracked";
+            // Canonicalize a supplied runtime review-agent alias (e.g.
+            // oracle-second -> oracle-2nd). Other agent names are preserved.
+            const canonicalAgent = input.agent === undefined
+                ? undefined
+                : (canonicalizeReviewAgentName(input.agent) ?? input.agent);
+            record.correlation = {
+                childSessionID: input.childSessionID,
+                parentSessionID: input.parentSessionID,
+                ...(canonicalAgent === undefined ? {} : { agent: canonicalAgent }),
+                terminalTaskErrorObserved: false,
+                retryableChildErrorObserved: false,
+                explicitlyAborted: false,
+            };
+            return "recorded";
+        },
+        recordTaskPart(input) {
+            pruneInactiveRecords();
+            const record = sessions.get(input.childSessionID);
+            if (!record)
+                return "untracked";
+            // Require matching child/parent lineage. The correlation must already
+            // exist (recordSessionLineage ran first) OR this is the first evidence
+            // for an already-tracked child - either way the child/parent must match.
+            if (record.correlation) {
+                if (record.correlation.childSessionID !== input.childSessionID
+                    || record.correlation.parentSessionID !== input.parentSessionID) {
+                    return "untracked";
+                }
+            }
+            else {
+                // No correlation yet - create one from the task part evidence. This
+                // supports the "part-first" arrival order where recordSessionLineage
+                // ran but the correlation was empty, OR (defensively) a child that
+                // was tracked but had no lineage recorded. The child/parent match is
+                // implicitly satisfied because the record exists for input.childSessionID.
+                record.correlation = {
+                    childSessionID: input.childSessionID,
+                    parentSessionID: input.parentSessionID,
+                    ...(input.agent === undefined ? {} : {
+                        agent: canonicalizeReviewAgentName(input.agent) ?? input.agent,
+                    }),
+                    terminalTaskErrorObserved: false,
+                    retryableChildErrorObserved: false,
+                    explicitlyAborted: false,
+                };
+            }
+            refreshInactiveGrace(record);
+            const key = dedupKey(input);
+            if (record.seenParentParts.has(key))
+                return "duplicate";
+            record.seenParentParts.add(key);
+            // Store parent evidence IDs for parentPartID and callID lookups. A
+            // provider callID is never stored without the parent-session constraint
+            // (the constraint is enforced by the correlation match above).
+            if (input.parentPartID !== undefined)
+                record.parentEvidenceIDs.add(input.parentPartID);
+            if (input.callID !== undefined)
+                record.parentEvidenceIDs.add(input.callID);
+            // Copy taskID only when evidence supplied one - never fabricate from childSessionID.
+            if (input.taskID !== undefined)
+                record.correlation.taskID = input.taskID;
+            if (input.callID !== undefined && record.correlation.callID === undefined) {
+                record.correlation.callID = input.callID;
+            }
+            if (input.agent !== undefined && record.correlation.agent === undefined) {
+                const canonical = canonicalizeReviewAgentName(input.agent) ?? input.agent;
+                record.correlation.agent = canonical;
+            }
+            record.correlation.terminalTaskErrorObserved = true;
+            return "recorded";
+        },
+        markRetryableChildError(childSessionID) {
+            pruneInactiveRecords();
+            const record = sessions.get(childSessionID);
+            if (!record?.correlation)
+                return;
+            refreshInactiveGrace(record);
+            record.correlation.retryableChildErrorObserved = true;
+        },
+        markExplicitAbort(childSessionID) {
+            pruneInactiveRecords();
+            const record = sessions.get(childSessionID);
+            if (!record)
+                return;
+            if (record.correlation)
+                record.correlation.explicitlyAborted = true;
+            // Stop retry/timers/generations but preserve durable correlation.
+            // The identity-checked stop callback clears record.retry only.
+            record.retry?.stop();
+            if (record.retry === undefined)
+                markInactive(record);
+            pruneInactiveRecords();
+        },
+        getInterruptionCorrelation(input) {
+            pruneInactiveRecords();
+            // Resolve by childSessionID first.
+            let record;
+            if (input.childSessionID !== undefined) {
+                record = sessions.get(input.childSessionID);
+            }
+            // taskID exact lookup scans existing records for a stored taskID.
+            // childSessionID is NEVER treated as taskID.
+            if (!record && input.taskID !== undefined) {
+                for (const candidate of sessions.values()) {
+                    if (candidate.correlation?.taskID === input.taskID) {
+                        record = candidate;
+                        break;
+                    }
+                }
+            }
+            if (!record?.correlation)
+                return undefined;
+            const correlation = record.correlation;
+            // parentSessionID must match when supplied.
+            if (input.parentSessionID !== undefined && correlation.parentSessionID !== input.parentSessionID) {
+                return undefined;
+            }
+            // parentPartID must be in evidence IDs when supplied.
+            if (input.parentPartID !== undefined && !record.parentEvidenceIDs.has(input.parentPartID)) {
+                return undefined;
+            }
+            return correlation;
+        },
+        claimInterruptionNotice(input) {
+            pruneInactiveRecords();
+            // Requires a resolved non-aborted correlation and an explicit lookup.taskID.
+            if (input.taskID === undefined)
+                return false;
+            let record = input.childSessionID !== undefined
+                ? sessions.get(input.childSessionID)
+                : undefined;
+            // Fall back to taskID lookup if childSessionID was not supplied or did not match.
+            if (!record && input.taskID !== undefined) {
+                for (const candidate of sessions.values()) {
+                    if (candidate.correlation?.taskID === input.taskID) {
+                        // Still enforce parentSessionID/parentPartID when supplied.
+                        if (input.parentSessionID !== undefined
+                            && candidate.correlation.parentSessionID !== input.parentSessionID) {
+                            continue;
+                        }
+                        if (input.parentPartID !== undefined
+                            && !candidate.parentEvidenceIDs.has(input.parentPartID)) {
+                            continue;
+                        }
+                        record = candidate;
+                        break;
+                    }
+                }
+            }
+            if (!record?.correlation)
+                return false;
+            const correlation = record.correlation;
+            if (correlation.explicitlyAborted)
+                return false;
+            // parentSessionID must match when supplied.
+            if (input.parentSessionID !== undefined && correlation.parentSessionID !== input.parentSessionID) {
+                return false;
+            }
+            // parentPartID must be in evidence IDs when supplied.
+            if (input.parentPartID !== undefined && !record.parentEvidenceIDs.has(input.parentPartID)) {
+                return false;
+            }
+            // When correlation already stores a task ID, the explicit value must match.
+            if (correlation.taskID !== undefined && correlation.taskID !== input.taskID) {
+                return false;
+            }
+            // When correlation has no stored taskID, accept the explicit output-adapter
+            // taskID without rewriting it as a child ID.
+            const claimKey = `${correlation.parentSessionID}:${input.parentPartID ?? input.taskID}`;
+            if (record.claimedNotices.has(claimKey))
+                return false;
+            record.claimedNotices.add(claimKey);
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=subagent-429-controller.js.map

package/dist/runtime-fallback/subagent-429-controller.js.map

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

package/dist/runtime-fallback/subagent-429-policy.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeFallbackConfig } from "../config/schema.ts";
+import type { FallbackCandidateBlocker } from "./fallback-state.ts";
+import type { Subagent429Scope, Subagent429Target } from "./subagent-429-controller.ts";
+export declare const MAX_RECOVERY_HINT_MS = 600000;
+export type ScopeInfo = {
+    key: string;
+    scope: Subagent429Scope;
+};
+export declare function scopeFor(target: Subagent429Target, config: RuntimeFallbackConfig): ScopeInfo;
+export declare function scheduleDelay(retriesUsed: number, recoveryDelayMs: number | undefined, random: () => number): number;
+export declare function recoveryDeadline(observedAt: number, recoveryDelayMs: number | undefined): number | undefined;
+export declare function blockedUntil(lastRecoveryDeadline: number | undefined, observedAt: number, cooldownSeconds: number): number;
+export declare function candidateBlocker(blocked: ReadonlyMap<string, number>, config: RuntimeFallbackConfig, clock: () => number): FallbackCandidateBlocker;

package/dist/runtime-fallback/subagent-429-policy.js

@@ -0,0 +1,37 @@
+export const MAX_RECOVERY_HINT_MS = 600_000;
+export function scopeFor(target, config) {
+    const scope = config.subagent429.providerScopes[target.providerID] ?? "model";
+    return scope === "provider"
+        ? { key: `provider:${target.providerID}`, scope }
+        : { key: `model:${target.providerID}/${target.modelID}`, scope };
+}
+export function scheduleDelay(retriesUsed, recoveryDelayMs, random) {
+    if (recoveryDelayMs !== undefined) {
+        return recoveryDelayMs > MAX_RECOVERY_HINT_MS ? 0 : Math.max(0, Math.floor(recoveryDelayMs));
+    }
+    const raw = Math.min(30_000, 1_000 * 2 ** retriesUsed);
+    const value = random();
+    const sample = Number.isFinite(value) ? Math.min(Math.max(value, 0), 1 - Number.EPSILON) : 0;
+    return Math.floor(raw / 2 + sample * raw / 2);
+}
+export function recoveryDeadline(observedAt, recoveryDelayMs) {
+    return recoveryDelayMs !== undefined && Number.isFinite(recoveryDelayMs) && recoveryDelayMs > 0
+        ? observedAt + recoveryDelayMs
+        : undefined;
+}
+export function blockedUntil(lastRecoveryDeadline, observedAt, cooldownSeconds) {
+    return lastRecoveryDeadline !== undefined && lastRecoveryDeadline > observedAt
+        ? lastRecoveryDeadline
+        : observedAt + cooldownSeconds * 1_000;
+}
+export function candidateBlocker(blocked, config, clock) {
+    return (entry) => {
+        const target = {
+            providerID: entry.providers[0] ?? "",
+            modelID: entry.model,
+            entry,
+        };
+        return (blocked.get(scopeFor(target, config).key) ?? 0) > clock();
+    };
+}
+//# sourceMappingURL=subagent-429-policy.js.map

package/dist/runtime-fallback/subagent-429-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-429-policy.js","sourceRoot":"","sources":["../../src/runtime-fallback/subagent-429-policy.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,oBAAoB,GAAG,OAAO,CAAA;AAI3C,MAAM,UAAU,QAAQ,CAAC,MAAyB,EAAE,MAA6B;IAC/E,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,OAAO,CAAA;IAC7E,OAAO,KAAK,KAAK,UAAU;QACzB,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE;QACjD,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAA;AACpE,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,WAAmB,EACnB,eAAmC,EACnC,MAAoB;IAEpB,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,eAAe,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAA;IAC9F,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,IAAI,WAAW,CAAC,CAAA;IACtD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAA;IACtB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5F,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,eAAmC;IACtF,OAAO,eAAe,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,CAAC;QAC7F,CAAC,CAAC,UAAU,GAAG,eAAe;QAC9B,CAAC,CAAC,SAAS,CAAA;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,oBAAwC,EACxC,UAAkB,EAClB,eAAuB;IAEvB,OAAO,oBAAoB,KAAK,SAAS,IAAI,oBAAoB,GAAG,UAAU;QAC5E,CAAC,CAAC,oBAAoB;QACtB,CAAC,CAAC,UAAU,GAAG,eAAe,GAAG,KAAK,CAAA;AAC1C,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,OAAoC,EACpC,MAA6B,EAC7B,KAAmB;IAEnB,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,MAAM,GAAsB;YAChC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE;YACpC,OAAO,EAAE,KAAK,CAAC,KAAK;YACpB,KAAK;SACN,CAAA;QACD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE,CAAA;IACnE,CAAC,CAAA;AACH,CAAC"}

package/dist/runtime-fallback/subagent-429-session.d.ts

@@ -0,0 +1,48 @@
+import type { Subagent429Decision, Subagent429DispatchInput, Subagent429ErrorInput, Subagent429IdleResult, Subagent429OtherErrorDecision, Subagent429OtherErrorInput, Subagent429Scheduler, Subagent429Target } from "./subagent-429-controller.ts";
+export type Session429Deps = {
+    scheduler: Subagent429Scheduler;
+    clock: () => number;
+    random: () => number;
+    isCurrentSnapshot: (snapshotId: number) => boolean;
+    dispatchRetry?: (input: Subagent429DispatchInput) => Promise<boolean>;
+    logger: {
+        debug(...args: unknown[]): void;
+        info(...args: unknown[]): void;
+        warn(...args: unknown[]): void;
+    };
+};
+export declare class Session429State {
+    private lifecycleGeneration;
+    private timerGeneration;
+    private nextDispatchGeneration;
+    private initialPending;
+    private pending?;
+    private active?;
+    private readonly retryCounts;
+    private readonly blocked;
+    private readonly lastRecoveryDeadlines;
+    private readonly sessionID;
+    readonly snapshotId: number;
+    private readonly deps;
+    private readonly isLive;
+    private readonly remove;
+    constructor(sessionID: string, snapshotId: number, deps: Session429Deps, isLive: () => boolean, remove: () => void);
+    matchesSnapshot(snapshotId: number): boolean;
+    activeTarget(): Subagent429Target | undefined;
+    stop(): void;
+    on429(input: Subagent429ErrorInput): Subagent429Decision;
+    onOtherError(input: Subagent429OtherErrorInput): Subagent429OtherErrorDecision;
+    onIdle(): Subagent429IdleResult;
+    private restriction;
+    private process429;
+    private queue429;
+    private installGate;
+    private maybeStart;
+    private settle;
+    private processQueued;
+    private account;
+    private isCurrent;
+    private isSnapshotCurrent;
+    private stopIfSnapshotStale;
+    private logTarget;
+}