@gajae-code/coding-agent 0.16.0 → 0.16.1

package/dist/types/modes/theme/theme.d.ts

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.star" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
 export type SpinnerType = "status" | "activity";
 export declare const THEME_COLOR_KEYS: readonly ["accent", "border", "borderAccent", "borderMuted", "success", "error", "warning", "muted", "dim", "text", "thinkingText", "selectedBg", "userMessageBg", "userMessageText", "customMessageBg", "customMessageText", "customMessageLabel", "toolPendingBg", "toolSuccessBg", "toolErrorBg", "toolTitle", "toolOutput", "mdHeading", "mdLink", "mdLinkUrl", "mdCode", "mdCodeBlock", "mdCodeBlockBorder", "mdQuote", "mdQuoteBorder", "mdHr", "mdListBullet", "toolDiffAdded", "toolDiffRemoved", "toolDiffContext", "syntaxComment", "syntaxKeyword", "syntaxFunction", "syntaxVariable", "syntaxString", "syntaxNumber", "syntaxType", "syntaxOperator", "syntaxPunctuation", "thinkingOff", "thinkingMinimal", "thinkingLow", "thinkingMedium", "thinkingHigh", "thinkingXhigh", "bashMode", "pythonMode", "statusLineBg", "statusLineSep", "statusLineModel", "statusLinePath", "statusLineGitClean", "statusLineGitDirty", "statusLineContext", "statusLineSpend", "statusLineStaged", "statusLineDirty", "statusLineUntracked", "statusLineOutput", "statusLineCost", "statusLineSubagents"];
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";
@@ -128,6 +128,7 @@ export declare class Theme {
         output: string;
         host: string;
         session: string;
+        star: string;
         package: string;
         warning: string;
         rewind: string;

package/dist/types/modes/types.d.ts

@@ -35,6 +35,8 @@ export type CompactionQueuedMessage = {
     text: string;
     mode: "steer" | "followUp";
     followUpQueuePolicy?: "sequential";
+    /** Composer steers stay one per poll even under `steeringMode: "all"`. */
+    steerQueuePolicy?: "sequential";
 };
 export type SubmittedUserInput = {
     text: string;

package/dist/types/sdk/broker/broker.d.ts

@@ -35,7 +35,8 @@ type ResolvedBrokerSettings = {
     spawnPromptLayer?: SpawnPromptLayer;
     masterOrphanGraceMs: number;
 };
-export type BrokerErrorCode = "idempotency_conflict" | "terminal_uncertain" | "broker_restarting" | "unavailable" | "endpoint_stale" | "resource_gone" | "invalid_input" | "spawn_failed" | "ready_then_exited" | "endpoint_unreadable" | "startup_admission_timeout" | "startup_admission_refused" | "readiness_timeout" | "close_refused" | "not_found" | "live_session" | "cleanup_pending" | (string & {});
+export declare function resolveBrokerPackageGeneration(): string;
+export type BrokerErrorCode = "idempotency_conflict" | "terminal_uncertain" | "broker_restarting" | "unavailable" | "endpoint_stale" | "resource_gone" | "invalid_input" | "spawn_failed" | "ready_then_exited" | "endpoint_unreadable" | "startup_admission_timeout" | "startup_admission_refused" | "readiness_timeout" | "worktree_preparation_timeout" | "dependency_preparation_timeout" | "worktree_in_use" | "incarnation_unavailable" | "close_refused" | "not_found" | "live_session" | "cleanup_pending" | (string & {});
 export type BrokerCleanupIdentity = {
     dev: string;
     ino: string;

package/dist/types/sdk/broker/ensure.d.ts

@@ -61,6 +61,7 @@ interface ReapTiming {
     gracefulMs: number;
     killVerifyMs: number;
 }
+type BrokerOwnerIdentity = Pick<BrokerDiscovery, "ownerId" | "pid" | "incarnation">;
 /** Starts the detached broker entrypoint when discovery has no live owner. */
 export declare function ensureBroker(settings: EnsureBrokerSettings): Promise<BrokerDiscovery>;
 /** Starts one fresh fixture broker and returns its sole exact-child close lease. */
@@ -73,6 +74,8 @@ export declare function startFixtureBrokerWithLeaseForTest(settings: EnsureBroke
 export declare function startFixtureBrokerCommandWithLeaseForTest(command: FixtureBrokerCommand): StartedFixtureBrokerCommand;
 /** Test hook: returns a stop handle for the detached broker this process spawned. */
 export declare function brokerOwnerForTest(agentDir: string): BrokerOwner | undefined;
+/** Test hook: verifies the complete broker owner identity used during stale retirement. */
+export declare function brokerOwnerIdentityMatchesForTest(left: BrokerOwnerIdentity | null, right: BrokerOwnerIdentity): boolean;
 /** Test hook: drives the detached-broker reap on a controllable child surface. */
 export declare function reapSpawnedBrokerForTest(child: ChildProcess, timing?: ReapTiming): Promise<void>;
 /** Test hook: resolves the complete broker environment without spawning. */

package/dist/types/sdk/broker/lifecycle-ledger.d.ts

@@ -43,6 +43,7 @@ export interface LifecycleDurableEffectsReceipt {
         cwdDigest: string;
         created: boolean;
         reused: boolean;
+        createdBranch: boolean;
         branchDigest?: string;
     };
     transcript?: {
@@ -50,6 +51,11 @@ export interface LifecycleDurableEffectsReceipt {
         contentDigest: string;
     };
     startup?: LifecycleStartupFailureReceipt;
+    timings?: {
+        worktreePreparationMs?: number;
+        dependencyPreparationMs?: number;
+        spawnAuthorizedAtOffsetMs?: number;
+    };
     digest?: string;
 }
 export interface LifecycleLedgerEntry {

package/dist/types/sdk/broker/lifecycle.d.ts

@@ -1,4 +1,5 @@
 import { type ChildProcess } from "node:child_process";
+import { type GjcLaunchWorktreePlan } from "../../gjc-runtime/launch-worktree";
 import type { SessionLifecycleMcpServer } from "../acp/mcp";
 import { type SdkStartupFailure, type SdkStartupRollbackResult } from "../startup-capability";
 import type { Broker, BrokerCleanupEvidence, BrokerResponse } from "./broker";
@@ -26,10 +27,22 @@ type LifecycleCommand = SdkInternalSpawnCommand | {
     args: string[];
 };
 type LifecycleCommandResolver = () => LifecycleCommand;
+type EnsureLaunchWorktreeForTest = (plan: GjcLaunchWorktreePlan, opts: {
+    signal: AbortSignal;
+    deadlineAt: number;
+}) => Promise<SessionLifecycleWorktreeReceipt & {
+    createdBranch: boolean;
+}>;
+type EnsureReusableNodeModulesForTest = (sourceRoot: string, worktreePath: string, opts: {
+    signal: AbortSignal;
+    deadlineAt: number;
+}) => Promise<"symlink" | "present" | "missing">;
 /** Test-only hook for simulating a crash immediately after one exact lifecycle detach. */
 export declare function setLifecycleCleanupHookForTest(broker: Broker, hook: (() => void) | undefined): void;
 export declare function setLifecycleCommandResolverForTest(broker: Broker, resolver: LifecycleCommandResolver | undefined): void;
 export declare function setLifecycleTimingForTest(broker: Broker, timing: LifecycleTiming | undefined): void;
+export declare function setEnsureLaunchWorktreeForTest(_broker: Broker | undefined, fn?: EnsureLaunchWorktreeForTest | undefined): void;
+export declare function setEnsureReusableNodeModulesForTest(_broker: Broker | undefined, fn?: EnsureReusableNodeModulesForTest | undefined): void;
 /** Deterministic platform seam for Windows-only ready-then-exit tolerance. */
 export declare function setLifecycleHostPlatformForTest(platform: NodeJS.Platform | undefined): void;
 export declare function readyThenExitToleranceEnabledForTest(): boolean;
@@ -45,6 +58,7 @@ export interface SessionLifecycleWorktreeReceipt {
     cwd: string;
     created: boolean;
     reused: boolean;
+    createdBranch: boolean;
     branch?: string;
 }
 export interface SessionLifecycleTranscriptIdentity {

package/dist/types/sdk/broker/startup-budget.d.ts

@@ -2,8 +2,16 @@
 export declare const DEFAULT_READINESS_TIMEOUT_MS = 10000;
 export declare const MIN_READINESS_TIMEOUT_MS = 4000;
 export declare const MAX_READINESS_TIMEOUT_MS = 60000;
+/** Bounded git worktree add/reuse window; independent of child semantic readiness. */
+export declare const DEFAULT_WORKTREE_PREPARATION_TIMEOUT_MS = 30000;
+export declare const MIN_PREPARATION_TIMEOUT_MS = 1000;
+export declare const MAX_PREPARATION_TIMEOUT_MS = 120000;
+/** Bounded workspace install window; independent of child semantic readiness. */
+export declare const DEFAULT_DEPENDENCY_PREPARATION_TIMEOUT_MS = 30000;
 export declare function isValidReadinessTimeoutMs(value: unknown): value is number;
+export declare function isValidPreparationTimeoutMs(value: unknown): value is number;
 export declare const READINESS_TIMEOUT_INVALID_MESSAGE = "readinessTimeoutMs must be an integer between 4000 and 60000.";
+export declare const PREPARATION_TIMEOUT_INVALID_MESSAGE = "worktreePreparationTimeoutMs and dependencyPreparationTimeoutMs must be integers between 1000 and 120000.";
 /**
  * Sleep until the duration elapses or the caller cancels the wait. Queue admission
  * uses this so a granted or refused waiter does not retain its cutoff timer for the
@@ -40,5 +48,49 @@ export declare function lifecycleStartupBudgetMs(requestedReadinessTimeoutMs: nu
  * rather than left unextended: the broker queues it for exactly as long as one that
  * asked, so the common path would otherwise fail client-side while the broker runs
  * the startup to a durably persisted terminal result.
+ *
+ * Worktree launches add independent preparation budgets so git add / install cannot
+ * cut the caller while the broker still owns the request. One-arg
+ * {@link lifecycleStartupBudgetMs} stays queue+readiness for no-worktree callers.
  */
 export declare function lifecycleRequestTimeoutMs(operation: string, input: Record<string, unknown>): number | undefined;
+/**
+ * True when this request will run named or detached worktree preparation.
+ * Coordinator nests the selector at `target.worktree`; Direct/lifecycle service
+ * put `worktree` on the mutation target itself; broker serialization also
+ * accepts `{ worktree: { name } }` without `enabled`.
+ */
+export declare function lifecycleRequestHasWorktree(input: Record<string, unknown>): boolean;
+/**
+ * Sum of worktree and dependency preparation budgets, or 0 when the request
+ * has no worktree. Returns `undefined` when an explicit prep field is present
+ * but invalid so callers fail closed instead of silently dropping prep time.
+ */
+export declare function preparationBudgetMs(input: Record<string, unknown>): number | undefined;
+export interface LifecycleOuterDeadlines {
+    admittedAt: number;
+    worktreePrepTimeoutMs: number;
+    dependencyPrepTimeoutMs: number;
+    requestedReadinessTimeoutMs: number;
+    worktreePreparationDeadlineAt: number;
+    lifecycleCleanupDeadlineAt: number;
+}
+/**
+ * Whole-request outer deadlines for a worktree launch. Child semantic readiness
+ * is still derived later at prepSucceededAt. Dependency start is sequential:
+ * callers clip remaining dep budget against `lifecycleCleanupDeadlineAt`
+ * after worktreeDoneAt.
+ */
+export declare function deriveLifecycleOuterDeadlines(input: {
+    admittedAt: number;
+    worktreePrepTimeoutMs: number;
+    dependencyPrepTimeoutMs: number;
+    requestedReadinessTimeoutMs: number;
+}): LifecycleOuterDeadlines;
+export declare function readPreparationTimeouts(input: Record<string, unknown>): {
+    ok: true;
+    worktreePrepTimeoutMs: number;
+    dependencyPrepTimeoutMs: number;
+} | {
+    ok: false;
+};

package/dist/types/sdk/broker/state-version.d.ts

@@ -1,6 +1,16 @@
 export declare const SDK_STATE_VERSION = 1;
 export declare const SESSION_INDEX_SNAPSHOT_VERSION = 4;
 export declare const SESSION_INDEX_EVENT_VERSION = 4;
+/**
+ * Thrown when a persisted SDK state file carries a version this build does not
+ * support. `assertSupportedStateVersion` fences only generic SDK state (broker
+ * discovery, lifecycle-ledger rows, guide cache meta) whose current format is
+ * exactly `SDK_STATE_VERSION`. Session-index files carry their own versions
+ * (see `assertSupportedSessionIndexEventVersion` and
+ * `assertSupportedSnapshotVersion`) and MUST NOT be validated with the generic
+ * guard — a supported v4 index row would crash with "maximum supported version
+ * is 1" (#5181).
+ */
 export declare class UnsupportedStateVersionError extends Error {
     readonly file: string;
     readonly version: number;
@@ -8,6 +18,13 @@ export declare class UnsupportedStateVersionError extends Error {
     readonly code = "unsupported_state_version";
     constructor(file: string, version: number, maximumSupportedVersion?: number);
 }
+/**
+ * Generic SDK-state fence: rejects any version above `SDK_STATE_VERSION`.
+ * ONLY for generic state whose current format is exactly `SDK_STATE_VERSION`
+ * (broker discovery `broker.json`, lifecycle-ledger rows, guide cache meta).
+ * Never validate session-index rows or snapshots with this guard — they have
+ * dedicated version fences and currently accept v4 (#5181).
+ */
 export declare function assertSupportedStateVersion(file: string, value: unknown): void;
 /** Rejects session-index events outside the known legacy and current formats. */
 export declare function assertSupportedSessionIndexEventVersion(file: string, value: unknown): void;

package/dist/types/sdk/bus/discord-daemon.d.ts

@@ -47,7 +47,7 @@ export declare class DiscordNotificationDaemon {
     /** Posts a safe command outcome to the active mapped conversation. */
     postCommandResult(sessionId: string, content: string): Promise<boolean>;
     close(sessionId: string, endpointGeneration?: number): Promise<void>;
-    recoverCleanup(sessionId: string, endpointGeneration: number): Promise<void>;
+    recoverCleanup(sessionId: string, endpointGeneration: number, authorityId?: string): Promise<boolean>;
     retireAttachment(sessionId: string, endpointGeneration: number): Promise<void>;
     archive(sessionId: string): Promise<void>;
     resume(sessionId: string, endpointGeneration: number, attachmentAuthorityId?: string): Promise<DiscordConversation | undefined>;

package/dist/types/sdk/bus/index.d.ts

@@ -116,7 +116,7 @@ export interface SessionResumeResponseFrame {
     sessionId: string;
     mode: ResumeMode;
 }
-export type LifecycleErrorReason = "unauthorized" | "rate_limited" | "duplicate_conflict" | "invalid_target" | "ambiguous_target" | "spawn_failed" | "discovery_timeout" | "readiness_timeout" | "close_refused" | "not_found" | "terminal_uncertain" | "unsupported_platform";
+export type LifecycleErrorReason = "unauthorized" | "rate_limited" | "duplicate_conflict" | "invalid_target" | "ambiguous_target" | "spawn_failed" | "discovery_timeout" | "readiness_timeout" | "worktree_preparation_timeout" | "dependency_preparation_timeout" | "close_refused" | "not_found" | "terminal_uncertain" | "unsupported_platform";
 export interface ResumeCandidate {
     sessionId: string;
     path?: string;
@@ -310,6 +310,8 @@ interface SessionRuntime {
     disposeGateTerminalController: () => void;
     disposeAckRecoveryParticipant: () => void;
     disposeGateEmitterListener: () => void;
+    /** Deregisters this session's job-fold listener (`bash_folded`). */
+    disposeFoldListener: () => void;
     /** Aborts and fences side turns while notification delivery is disabled. */
     disableEphemeralTurns: () => void;
     waitForGateResolutionQuiescence: () => Promise<void>;

package/dist/types/sdk/bus/kind-aware-reconciliation.d.ts

@@ -1,5 +1,5 @@
 import type { PromptReconciliationStatus, SdkPromptTerminalOutcome, TurnPromptReconciliation } from "../prompt-status";
-import type { ReceiptState } from "../receipt-state";
+import { type ReceiptState } from "../receipt-state";
 import { type TurnResultContent, type TurnResultPage } from "../turn-result";
 import { type PromptCorrelation } from "./prompt-reconciliation";
 import type { DurableReconciliationRecord, ReconciliationKind, ReconciliationStore } from "./reconciliation-store";

package/dist/types/sdk/bus/prompt-reconciliation.d.ts

@@ -23,7 +23,7 @@
  */
 import { PROMPT_FAILURE_CODE_MAX, sanitizePromptFailure } from "../prompt-failure";
 import type { SdkPromptTerminalOutcome } from "../prompt-status";
-import type { ReceiptState } from "../receipt-state";
+import { type ReceiptState } from "../receipt-state";
 export { PROMPT_FAILURE_CODE_MAX, sanitizePromptFailure };
 export declare const PROMPT_RECONCILIATION_ACTIVE_CAPACITY = 128;
 export declare const PROMPT_RECONCILIATION_TERMINAL_CAPACITY = 256;

package/dist/types/sdk/bus/slack-conversation.d.ts

@@ -5,7 +5,7 @@ export interface SlackInboundDispatchReceipt {
     interactionId: string;
     retryKey: string;
     eventContext?: string;
-    kind: "action" | "command";
+    kind: "action" | "command" | "message";
     actionId?: string;
     /** The endpoint generation and SDK effect captured before Socket Mode ACK. */
     endpointGeneration: number;

package/dist/types/sdk/bus/slack-daemon.d.ts

@@ -69,7 +69,7 @@ export declare class SlackNotificationDaemon {
     postCommandResult(sessionId: string, content: string): Promise<boolean>;
     resolveAction(sessionId: string, actionId: string): Promise<void>;
     close(sessionId: string, marker?: string, endpointGeneration?: number): Promise<boolean>;
-    recoverCleanup(sessionId: string, endpointGeneration: number): Promise<void>;
+    recoverCleanup(sessionId: string, endpointGeneration: number, authorityId?: string): Promise<boolean>;
     retireAttachment(sessionId: string, endpointGeneration: number): Promise<void>;
     resume(sessionId: string, body: string, endpointGeneration?: number, publicationId?: string): Promise<SlackConversation>;
     findSession(sessionId: string, includeInactive: boolean): Promise<{

package/dist/types/sdk/bus/telegram-daemon-contract.d.ts

@@ -286,7 +286,7 @@ export declare const SDK_LIFECYCLE_ROUTER_PROTOCOL_VERSION = 1;
  * killing a session's mirroring after one transient rejection and must be
  * replaced across this upgrade.
  */
-export declare const DAEMON_GENERATION = 180;
+export declare const DAEMON_GENERATION = 181;
 /**
  * Serving-compatibility boundary for daemon lifecycle requests. Epoch 7
  * requires durable publication receipts and acknowledged attachment dispatch,

package/dist/types/sdk/cli/rows.d.ts

@@ -40,24 +40,29 @@ export interface SdkSessionRowV1 {
     /** True when the same sessionId maps to more than one stateRoot (cross-repo duplicate). */
     ambiguous?: boolean;
 }
-export interface SdkCheckpointRecordV1 {
+export interface SdkRingPositionV1 {
     revision: number;
     generation: number;
     seq: number;
 }
+export interface SdkCheckpointRecordV1 extends SdkRingPositionV1 {
+    idle: boolean;
+}
 export interface SdkRetentionGapV1 {
     code: "retention_gap";
     missing?: {
         from: number;
         to: number;
     };
-    resync?: SdkCheckpointRecordV1;
+    resync?: SdkRingPositionV1;
 }
 /** One tail item: a retained transcript entry or a live event-ring event. */
 export interface SdkTailItemV1 {
     /** "transcript" for retained transcript entries, otherwise the event-ring kind. */
     kind: string;
     id?: string;
+    /** Durable revision at emission; (revision,generation,seq) is unique per session. generation:seq alone is revision-local. */
+    revision?: number;
     generation?: number;
     seq?: number;
     payload: unknown;
@@ -85,6 +90,7 @@ export declare function toRetentionGapV1(value: unknown): SdkRetentionGapV1 | un
 /** Projects a transcript entry or ring event into a tail item with dedupe keys. */
 export declare function toTailItemV1(value: unknown, fallback: {
     kind: string;
+    revision?: number;
     generation?: number;
     seq?: number;
 }): SdkTailItemV1;

package/dist/types/sdk/cli/session-cli.d.ts

@@ -67,7 +67,8 @@ export declare function parseSessionListScope(value: string | undefined): SdkSes
 /**
  * Resolves the list selection from `--repo` (default: process cwd) under the
  * effective scope. Outside Git, `repo`/`worktree` fail typed and actionable —
- * they never broaden to `all`; `cwd` remains an exact canonical match.
+ * they never broaden to `all`; `cwd` remains an exact canonical match, and
+ * `all` ignores the selection entirely so it works outside any checkout.
  */
 export declare function resolveSessionListSelection(scope: SdkSessionListScope, repoArg: string | undefined): Promise<SdkSessionListSelection>;
 /**

package/dist/types/sdk/host/events.d.ts

@@ -1,6 +1,7 @@
 import type { SdkFrame } from "./types";
 export interface EventFrame extends SdkFrame {
     type: "event";
+    revision?: number;
     generation: number;
     seq: number;
 }

package/dist/types/sdk/host/query/cursor.d.ts

@@ -15,6 +15,7 @@ export interface CursorEnvelope {
     issuedAt?: number;
     /** TTL metadata minted by `CursorRegistry.grant`: wall-clock ms when the cursor expires. */
     expiresAt?: number;
+    purpose?: "checkpoint";
     position: unknown;
     direction: string;
     pageShape: unknown;
@@ -46,6 +47,7 @@ export interface CursorQueryContext {
     resourceId?: string;
     direction: string;
     pageShape: unknown;
+    purpose?: "checkpoint";
 }
 export declare class CursorError extends Error {
     readonly code: "cursor_expired" | "invalid_cursor" | "invalid_input" | "resource_gone" | "snapshot_capacity_exceeded";
@@ -64,13 +66,13 @@ export declare class CursorRegistry {
     private readonly now;
     constructor(sessionToken: string | Uint8Array, revisions: RevisionStore, now?: () => number);
     grant(connectionId: string, envelope: CursorEnvelope, resourceKind: string, resourceId: string): Promise<string>;
-    exchange(cursor: string, connectionId: string, expected: CursorQueryContext, resourceKind: string, resourceId: string): Promise<{
+    exchange(cursor: string, connectionId: string, expected: CursorQueryContext, _resourceKind: string, resourceId: string): Promise<{
         cursor: string;
         envelope: CursorEnvelope;
     }>;
     consume(cursor: string, connectionId: string, expected: CursorQueryContext): CursorEnvelope;
     release(cursor: string): void;
     close(): void;
-    sweep(): void;
+    sweep(exceptCursor?: string, at?: number): void;
     get size(): number;
 }

package/dist/types/sdk/host/query/handlers.d.ts

@@ -105,6 +105,7 @@ export interface SdkCheckpointRecord {
     revision: number;
     generation: number;
     seq: number;
+    idle: boolean;
 }
 export declare function isCheckpointRecord(value: unknown): value is SdkCheckpointRecord;
 export declare class QueryHandlers {

package/dist/types/sdk/host/query/revision-store.d.ts

@@ -55,6 +55,7 @@ export declare class RevisionStore {
         offset: number;
     } | undefined>;
     pin(cursorId: string, resourceKind: string, resourceId: string, id: string): Promise<void>;
+    transferPin(sourceCursorId: string, replacementCursorId: string): void;
     unpin(cursorId: string): void;
     sweep(): void;
     close(): Promise<void>;

package/dist/types/sdk/host/session-runtime.d.ts

@@ -1,6 +1,8 @@
 import { type Settings } from "../../config/settings";
 import type { ExtensionAPI, ExtensionContext } from "../../extensibility/extensions";
 import { type MasterRoleAttestationV2, SessionIndex, type SessionLocatorV2 } from "../broker/session-index";
+import type { SdkPromptTerminalOutcome } from "../prompt-status";
+import { type ReceiptState } from "../receipt-state";
 import { type TurnResultContent } from "../turn-result";
 import { SessionSdkHost, type SessionSdkHostOptions } from "./host";
 import { type SessionSurface } from "./query";
@@ -58,6 +60,8 @@ export interface SdkOnlyInvocationRecord extends InvocationCorrelation {
         code: string;
         message: string;
     };
+    content?: TurnResultContent;
+    receiptState?: Exclude<ReceiptState, "absent">;
     outcome?: unknown;
     pendingOutcome?: unknown;
     skillName?: string;
@@ -207,6 +211,8 @@ export interface CreateSdkSessionRuntimeOptions {
     onLifecycleDrainTimeoutForTests?: () => void;
     /** Test-only observation of bounded failure-diagnostic deduplication state. */
     onFailureDiagnosticKeyCountForTests?: (count: number) => void;
+    /** Test-only observation after a resolved invocation completion is reconciled. */
+    onInvocationCompletionReconciledForTests?: (kind: InvocationKind, correlation: InvocationCorrelation) => void;
 }
 export interface InvocationCorrelation {
     commandId: string;
@@ -214,6 +220,14 @@ export interface InvocationCorrelation {
 }
 export type InvocationKind = "prompt" | "skill" | "steer";
 type InvocationStatus = "accepted" | "in_flight" | "terminal_ok" | "failed" | "uncertain";
+type InvocationOutcome = SdkPromptTerminalOutcome;
+type InvocationOutcomeInput = {
+    kind: string;
+    reason?: unknown;
+    code?: unknown;
+    message?: unknown;
+    provenance?: unknown;
+};
 export interface InvocationReconciliation {
     /** Shared v2 reconciliation owner; present for durable terminal admission. */
     readonly store?: SdkOnlyReconciliationStore;
@@ -224,11 +238,7 @@ export interface InvocationReconciliation {
         type: "agent_start" | "agent_end";
         content?: TurnResultContent;
         hasActivity?: boolean;
-        outcome?: {
-            kind: "stopped";
-            reason: "cancelled";
-            provenance: "client_cancel";
-        };
+        outcome?: InvocationOutcome;
     } | {
         type: "agent_failed";
         error: unknown;
@@ -251,18 +261,8 @@ export interface InvocationReconciliation {
         deadlineMaxAt?: number;
     }>;
     hydrate(): Promise<void>;
-    claimPendingOutcome(kind: InvocationKind, correlation: InvocationCorrelation, outcome: {
-        kind: string;
-        code: string;
-        message: string;
-        provenance?: string;
-    }): Promise<unknown>;
-    finalizeOutcome(kind: InvocationKind, correlation: InvocationCorrelation, outcome?: {
-        kind: string;
-        code: string;
-        message: string;
-        provenance?: string;
-    }, arg4?: (() => boolean) | {
+    claimPendingOutcome(kind: InvocationKind, correlation: InvocationCorrelation, outcome: InvocationOutcomeInput): Promise<InvocationOutcome>;
+    finalizeOutcome(kind: InvocationKind, correlation: InvocationCorrelation, outcome?: InvocationOutcomeInput, arg4?: (() => boolean) | {
         code: string;
         message: string;
     }, arg5?: unknown, arg6?: {
@@ -303,6 +303,7 @@ export interface SdkSurfaceFactoryOptions {
         clientRef?: string;
     }) => unknown;
     hostTools?: boolean | (() => boolean);
+    getRuntimeHost?: () => SessionSdkHost | undefined;
 }
 /** Shared policy, capability, and query-surface factory for every SDK transport. */
 export interface SdkSurfaceFactory {

package/dist/types/sdk/lifecycle-session.d.ts

@@ -1,4 +1,4 @@
-import type { AgentSession } from "../session/agent-session";
+import { type AgentSession } from "../session/agent-session";
 import { type CreateAgentSessionOptions } from "./session";
 import { SdkStartupCapability, type SdkStartupFailure, SdkStartupRollbackTracker } from "./startup-capability";
 export type CreateLifecycleAgentSessionResult = {

package/dist/types/sdk/prompt-deadline-manager.d.ts

@@ -1,5 +1,6 @@
 import type { KindAwareReconciliation } from "./bus/kind-aware-reconciliation";
 import type { InvocationCorrelation, InvocationReconciliation } from "./host/session-runtime";
+import type { SdkPromptTerminalOutcome } from "./prompt-status";
 import type { TurnResultContent } from "./turn-result";
 type DeadlineReconciliation = InvocationReconciliation | KindAwareReconciliation;
 export type PromptDeadlineOutcome = {
@@ -11,11 +12,7 @@ export type PromptDeadlineOutcome = {
 export interface PromptTerminalTransitionEvidence {
     content?: TurnResultContent;
     hasActivity?: boolean;
-    outcome?: {
-        kind: "stopped";
-        reason: "cancelled";
-        provenance: "client_cancel";
-    };
+    outcome?: SdkPromptTerminalOutcome;
 }
 export declare class PromptDeadlineManager {
     #private;

package/dist/types/sdk/receipt-state.d.ts

@@ -14,4 +14,6 @@ export interface TerminalReceiptState {
 }
 export declare function reportableReceipt({ text, artifactPath }: ReceiptSource): boolean;
 export declare function receiptStateForTerminal(source: ReceiptSource): Extract<ReceiptState, "present" | "missing">;
+/** Terminal receipt evidence is monotonic: present > missing > unknown. */
+export declare function reduceReceiptState(existing: Exclude<ReceiptState, "absent"> | undefined, incoming: Exclude<ReceiptState, "absent"> | undefined): Exclude<ReceiptState, "absent"> | undefined;
 export declare function reduceTerminalReceiptState(input: TerminalReceiptInput): TerminalReceiptState;

package/dist/types/sdk/router/session-router.d.ts

@@ -117,10 +117,12 @@ export interface SessionRouterClient {
     send(frame: Record<string, unknown>): void;
 }
 /** One frame after the caller's envelope/payload identity correlation. */
+/** One frame after the caller's envelope/payload identity correlation. */
 export interface SessionRouterFrame {
     readonly body: Record<string, unknown>;
     readonly name: string | undefined;
     readonly sessionId: string | undefined;
+    readonly revision?: number;
     readonly generation: number | undefined;
     readonly commandId?: string;
     readonly turnId?: string;
@@ -144,6 +146,8 @@ export interface SessionRouterDeps {
     onAttachment?: (attachment: SessionAttachment) => Promise<void> | void;
     /** Called only after the opaque capability becomes externally current. */
     onAttachmentReady?: (attachment: SessionAttachment) => Promise<void> | void;
+    /** Called before deferred replay may perform provider-facing mutations. */
+    onReplayReady?: () => Promise<void> | void;
     /** Called when the Broker index no longer reports an attached session as live. */
     onSessionRemoved?: (attachment: SessionAttachment, reason?: "removed" | "replaced" | "replaced_same_generation") => Promise<void> | void;
     /** Narrow provider surface for notification consumers such as Telegram. */

package/dist/types/sdk/turn-result.d.ts

@@ -22,6 +22,7 @@ export interface TurnResultError {
     code: string;
     message: string;
 }
+export type TurnResultReceiptState = "absent" | "present" | "missing" | "unknown";
 export interface TurnResultPage {
     status: TurnResultStatus;
     kind?: "prompt" | "skill";
@@ -31,7 +32,12 @@ export interface TurnResultPage {
     acceptedAt?: number;
     startedAt?: number;
     terminalAt?: number;
+    receiptState?: TurnResultReceiptState;
+    outcome?: unknown;
     content?: TurnResultContent;
     error?: TurnResultError;
 }
 export declare function sanitizeTurnResultContent(text: unknown): TurnResultContent | undefined;
+export declare function reportableTurnResultContent(content: TurnResultContent | undefined): boolean;
+/** First reportable invocation-owned content wins; blank evidence remains replaceable. */
+export declare function reduceTurnResultContent(existing: TurnResultContent | undefined, incoming: TurnResultContent | undefined): TurnResultContent | undefined;