@gajae-code/coding-agent 0.11.0 → 0.11.2

package/dist/types/modes/controllers/plan-mode-controller.d.ts

@@ -0,0 +1,65 @@
+import type { CompactionOutcome } from "@gajae-code/agent-core/compaction";
+import { Container, type KeyId } from "@gajae-code/tui";
+import { type PlanApprovalDetails } from "../../plan-mode/approved-plan";
+import type { AgentSession } from "../../session/agent-session";
+import type { SessionContext, SessionManager } from "../../session/session-manager";
+import { type PlanPreviewOptions, type PlanPreviewResult } from "../components/plan-preview-overlay";
+import type { SubmittedUserInput } from "../types";
+import type { ModeGate } from "./mode-gate";
+type PlanModeControllerContext = {
+    readonly session: AgentSession;
+    readonly sessionManager: SessionManager;
+    readonly modeGate: ModeGate;
+    readonly chatContainer: Container;
+    readonly inputCallback: ((input: SubmittedUserInput) => void) | undefined;
+    readonly externalEditorKey: string | undefined;
+    readonly externalEditorKeys: readonly KeyId[];
+    startPendingSubmission(input: {
+        text: string;
+    }): SubmittedUserInput;
+    addChatChild(child: Container): void;
+    requestRender(full?: boolean): void;
+    stopUi(): void;
+    startUi(): void;
+    showStatus(message: string): void;
+    showWarning(message: string): void;
+    showError(message: string): void;
+    showHookConfirm(title: string, message: string): Promise<boolean>;
+    showPlanPreview(content: string | null, options?: PlanPreviewOptions): Promise<PlanPreviewResult>;
+    flushCompactionQueue(options?: {
+        willRetry?: boolean;
+    }): Promise<void>;
+    updatePlanModeStatus(status: {
+        enabled: boolean;
+        paused: boolean;
+    } | undefined): void;
+    handleClearCommand(): Promise<boolean>;
+    handleCompactCommand(instructions?: string): Promise<CompactionOutcome>;
+    updateEditorChrome(): void;
+};
+/** Owns plan-mode state, model scope, plan review, approval, and restoration. */
+export declare class PlanModeController {
+    #private;
+    private readonly ctx;
+    constructor(ctx: PlanModeControllerContext);
+    get enabled(): boolean;
+    get paused(): boolean;
+    get planFilePath(): string | undefined;
+    setEnabledForCompatibility(enabled: boolean): void;
+    setPausedForCompatibility(paused: boolean): void;
+    setPlanFilePathForCompatibility(planFilePath: string | undefined): void;
+    clearReview(): void;
+    restoreFromSession(sessionContext: SessionContext): Promise<void>;
+    enter(options?: {
+        planFilePath?: string;
+        workflow?: "parallel" | "iterative";
+    }): Promise<void>;
+    exit(options?: {
+        silent?: boolean;
+        paused?: boolean;
+    }): Promise<void>;
+    flushPendingModelSwitch(): Promise<void>;
+    handleCommand(initialPrompt?: string): Promise<void>;
+    handleApproval(details: PlanApprovalDetails): Promise<void>;
+}
+export {};

package/dist/types/modes/controllers/selector-controller.d.ts

@@ -1,4 +1,4 @@
-import type { Component } from "@gajae-code/tui";
+import type { Component, SlashCommand } from "@gajae-code/tui";
 import type { ModelProfileConfig } from "../../config/models-config-schema";
 import { type Settings } from "../../config/settings";
 import type { InteractiveModeContext, OAuthSelectorOptions } from "../../modes/types";
@@ -8,10 +8,14 @@ import { buildNotificationStatusReport, checkNotificationHealth, recoverNotifica
 import { ensureTelegramDaemonRunningDetailed, unregisterNotificationRoot } from "../../sdk/bus/telegram-daemon";
 import { runTelegramSetup } from "../../sdk/bus/telegram-setup";
 import { type CredentialAutoImportStateStore } from "../../setup/credential-auto-import";
+import { type CommandPaletteAction } from "../components/command-palette";
 import type { NotificationsEditorOperations } from "../components/notifications-settings-editor";
-import type { StatusLineSettings } from "../components/status-line";
+import { type PlanPreviewOptions, type PlanPreviewResult } from "../components/plan-preview-overlay";
+import type { StatusLineSettings } from "../components/tool-status-header";
 import type { JobsObserver } from "../jobs-observer";
 import type { SessionObserverRegistry } from "../session-observer-registry";
+import type { TasksAggregator } from "../tasks-aggregator";
+import type { TranscriptItemRegistry } from "../transcript-item-registry";
 /**
  * Snapshot the persisted status-line settings that the status-line component
  * cares about. Preview, cancel-restore, and commit paths all share this so the
@@ -48,7 +52,10 @@ export declare function createNotificationsEditorOperations(ctx: NotificationsEd
 export declare class SelectorController {
     #private;
     private ctx;
-    constructor(ctx: InteractiveModeContext, credentialAutoImportStateStore?: CredentialAutoImportStateStore);
+    private readonly clipboard;
+    constructor(ctx: InteractiveModeContext, credentialAutoImportStateStore?: CredentialAutoImportStateStore, clipboard?: (text: string) => void);
+    isTranscriptViewerOpen(): boolean;
+    refreshTranscriptViewer(identityMap?: ReadonlyMap<string, string>): void;
     /**
      * Shows a selector component in place of the editor.
      * @param create Factory that receives a `done` callback and returns the component and focus target
@@ -57,6 +64,7 @@ export declare class SelectorController {
         component: Component;
         focus: Component;
     }): void;
+    showCommandPalette(commands: SlashCommand[], actions: CommandPaletteAction[], executeSlashCommand: (name: string) => Promise<void>): void;
     showProviderOnboarding(): void;
     showCustomModelPresetWizard(snapshot: ModelProfileConfig): void;
     showCustomProviderWizard(): void;
@@ -92,6 +100,9 @@ export declare class SelectorController {
     showOAuthSelector(mode: "login" | "logout", providerId?: string, options?: OAuthSelectorOptions): Promise<void>;
     showDebugSelector(): void;
     showSessionObserver(registry: SessionObserverRegistry): void;
+    showSessionsDashboard(): Promise<void>;
+    showTranscriptViewer(registry: TranscriptItemRegistry): void;
+    showPlanPreview(content: string | null, options?: PlanPreviewOptions): Promise<PlanPreviewResult>;
     /**
      * Jobs overlay: navigate ongoing monitor + cron jobs (Monitors then Crons,
      * newest-first), drill into per-type detail, and cancel/delete with a y/N
@@ -99,4 +110,5 @@ export declare class SelectorController {
      * stays on the active SelectList.
      */
     showJobsOverlay(observer: JobsObserver): void;
+    showTasksPane(aggregator: TasksAggregator): void;
 }

package/dist/types/modes/controllers/stt-controller.d.ts

@@ -0,0 +1,26 @@
+interface SttEditor {
+    cursorOverride: string | undefined;
+    cursorOverrideWidth: number | undefined;
+    getUseTerminalCursor(): boolean;
+    insertText(text: string): void;
+    setUseTerminalCursor(enabled: boolean): void;
+}
+interface SttUi {
+    getShowHardwareCursor(): boolean;
+    requestRender(): void;
+    setShowHardwareCursor(enabled: boolean): void;
+}
+export interface SttModeContext {
+    editor: SttEditor;
+    showStatus(message: string): void;
+    showWarning(message: string): void;
+    ui: SttUi;
+    updateEditorChrome(): void;
+}
+/** Coordinates STT state with the interactive composer presentation. */
+export declare class SttModeController {
+    #private;
+    toggle(ctx: SttModeContext): Promise<void>;
+    dispose(ctx: Pick<SttModeContext, "editor" | "ui">): void;
+}
+export {};

package/dist/types/modes/interactive-mode.d.ts

@@ -1,14 +1,13 @@
 import { type Agent, type AgentMessage } from "@gajae-code/agent-core";
 import type { CompactionOutcome } from "@gajae-code/agent-core/compaction";
-import { type AssistantMessage, type ImageContent, type Message, type UsageReport } from "@gajae-code/ai";
-import type { Component, EditorTheme } from "@gajae-code/tui";
+import type { AssistantMessage, ImageContent, Message, UsageReport } from "@gajae-code/ai";
+import type { Component, EditorTheme, SlashCommand } from "@gajae-code/tui";
 import { Container, Loader, Spacer, Text, TUI } from "@gajae-code/tui";
 import { KeybindingsManager } from "../config/keybindings";
 import { type Settings } from "../config/settings";
 import type { ExtensionUIContext, ExtensionUIDialogOptions, ExtensionWidgetContent, ExtensionWidgetOptions } from "../extensibility/extensions";
 import type { CompactOptions } from "../extensibility/extensions/types";
 import { type Skill } from "../extensibility/skills";
-import { type PlanApprovalDetails } from "../plan-mode/approved-plan";
 import type { NotificationSessionReconcileResult, NotificationSessionStatus } from "../sdk/bus/session-control";
 import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
 import { HistoryStorage } from "../session/history-storage";
@@ -17,19 +16,22 @@ import type { LspStartupServerInfo } from "../tools";
 import type { EventBus } from "../utils/event-bus";
 import type { AssistantMessageComponent } from "./components/assistant-message";
 import type { BashExecutionComponent } from "./components/bash-execution";
+import type { CommandPaletteAction } from "./components/command-palette";
 import { CustomEditor } from "./components/custom-editor";
 import type { EvalExecutionComponent } from "./components/eval-execution";
 import { GajaePetWidget, type PetMode } from "./components/gajae-pet-widget";
 import type { HookEditorComponent } from "./components/hook-editor";
 import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent } from "./components/hook-selector";
-import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
+import { StatusLineComponent } from "./components/tool-status-header";
 import { type WelcomeLogoMode } from "./components/welcome";
+import { GoalModeController } from "./controllers/goal-mode-controller";
+import { PlanModeController } from "./controllers/plan-mode-controller";
 import { IrcObservationLedger } from "./irc-observation-ledger";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
-import type { CompactionQueuedMessage, InteractiveModeContext, IrcArrivalSnapshot, SubmittedUserInput, TodoItem, TodoPhase, TranscriptRebuildPolicy } from "./types";
+import { type CompactionQueuedMessage, type ComposerSubmissionOptions, type InteractiveModeContext, type IrcArrivalSnapshot, type SubmittedUserInput, type TodoItem, type TodoPhase, type TranscriptRebuildPolicy } from "./types";
 import type { ParsedIrcMessage } from "./utils/irc-message";
 export declare const DEFAULT_COMPOSER_PLACEHOLDER: string;
 export declare function getWelcomeTranscriptReservedRows(chatContainer: Container, width: number): number;
@@ -76,11 +78,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     isBashNoContext: boolean;
     toolOutputExpanded: boolean;
     todoExpanded: boolean;
-    planModeEnabled: boolean;
-    planModePaused: boolean;
-    goalModeEnabled: boolean;
-    goalModePaused: boolean;
-    planModePlanFilePath: string | undefined;
     todoPhases: TodoPhase[];
     hideThinkingBlock: boolean;
     pendingImages: ImageContent[];
@@ -119,10 +116,14 @@ export declare class InteractiveMode implements InteractiveModeContext {
     oauthManualInput: OAuthManualInputManager;
     readonly lspServers: LspStartupServerInfo[] | undefined;
     mcpManager?: import("../runtime-mcp").MCPManager;
+    /** Direct controller capabilities for consumers that coordinate mode transitions. */
+    get planModeController(): PlanModeController;
+    get goalModeController(): GoalModeController;
     constructor(session: AgentSession, version: string, changelogMarkdown?: string | undefined, setToolUIContext?: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers?: LspStartupServerInfo[] | undefined, mcpManager?: import("../runtime-mcp").MCPManager, eventBus?: EventBus);
     getCurrentSessionNotificationStatus(): NotificationSessionStatus | undefined;
     setCurrentSessionNotificationsEnabled(enabled: boolean): Promise<NotificationSessionReconcileResult | undefined>;
     init(): Promise<void>;
+    getSlashCommands(): readonly SlashCommand[];
     /** Reload slash commands and autocomplete for the provided working directory. */
     refreshSlashCommandState(cwd?: string): Promise<void>;
     getUserInput(): Promise<SubmittedUserInput>;
@@ -135,7 +136,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
         images?: ImageContent[];
         customType?: string;
         display?: boolean;
-    }): SubmittedUserInput;
+    }, options?: ComposerSubmissionOptions): SubmittedUserInput;
     cancelPendingSubmission(): boolean;
     markPendingSubmissionStarted(input: SubmittedUserInput): boolean;
     finishPendingSubmission(input: SubmittedUserInput): void;
@@ -147,11 +148,6 @@ export declare class InteractiveMode implements InteractiveModeContext {
     commitPetPreviewMode(mode: PetMode): boolean;
     restoreComposer(): void;
     rebuildChatFromMessages(policy: TranscriptRebuildPolicy): void;
-    /** Apply any deferred model switch after the current stream ends. */
-    flushPendingModelSwitch(): Promise<void>;
-    handlePlanModeCommand(initialPrompt?: string): Promise<void>;
-    handleGoalModeCommand(rest?: string): Promise<void>;
-    handlePlanApproval(details: PlanApprovalDetails): Promise<void>;
     stop(): void;
     shutdown(): Promise<void>;
     checkShutdownRequested(): Promise<void>;
@@ -171,7 +167,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     showNewVersionNotification(newVersion: string): void;
     clearEditor(): void;
     updatePendingMessagesDisplay(): void;
-    queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;
+    queueCompactionMessage(text: string, mode: "steer" | "followUp", options?: ComposerSubmissionOptions): void;
     flushCompactionQueue(options?: {
         willRetry?: boolean;
     }): Promise<void>;
@@ -211,9 +207,9 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleHelpCommand(): void;
     handleToolsCommand(): void;
     handleContextCommand(): void;
-    handleClearCommand(): Promise<void>;
+    handleClearCommand(): Promise<boolean>;
     handleContextClearCommand(): Promise<void>;
-    handleDropCommand(): Promise<void>;
+    handleDropCommand(): Promise<boolean>;
     handleForkCommand(): Promise<void>;
     handleMoveCommand(targetPath: string): Promise<void>;
     handleRenameCommand(title: string): Promise<void>;
@@ -221,7 +217,12 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleSTTToggle(): Promise<void>;
     showDebugSelector(): void;
     showSessionObserver(): void;
+    showSessionsDashboard(): void;
+    isTranscriptViewerOpen(): boolean;
+    refreshTranscriptViewer(): void;
+    showTranscriptViewer(): void;
     showJobsOverlay(): void;
+    showTasksPane(): void;
     resetObserverRegistry(): void;
     handleBashCommand(command: string, excludeFromContext?: boolean): Promise<void>;
     handlePythonCommand(code: string, excludeFromContext?: boolean): Promise<void>;
@@ -232,6 +233,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleContributionPrepCommand(customInstructions?: string): Promise<void>;
     executeCompaction(customInstructionsOrOptions?: string | CompactOptions, isAuto?: boolean): Promise<CompactionOutcome>;
     openInBrowser(urlOrPath: string): void;
+    showCommandPalette(commands: SlashCommand[], actions: CommandPaletteAction[], executeSlashCommand: (name: string) => Promise<void>): void;
     showSettingsSelector(): void;
     showThemeSelector(): void;
     showPetSelector(): void;

package/dist/types/modes/jobs-observer.d.ts

@@ -27,6 +27,8 @@ export interface CronJobView {
     prompt: string;
     recurring: boolean;
     nextFireAt?: number;
+    /** A cron firing whose spawned job is currently running. */
+    firing?: boolean;
     createdAt: number;
 }
 export interface JobsSnapshot {

package/dist/types/modes/shared/agent-wire/deep-interview-gate.d.ts

@@ -10,17 +10,8 @@
  * This is the pure mapping primitive used by SDK-native workflow gate emitters.
  */
 import type { OpenGateInput } from "./workflow-gate-broker";
-import type { WorkflowGateKind, WorkflowStage } from "./workflow-gate-types";
-/** "Other (type your own)" sentinel, mirroring the interactive ask tool. */
-export declare const GATE_OTHER_OPTION = "Other (type your own)";
-/** Optional structured deep-interview round metadata supplied by the agent. */
-export interface AskGateDeepInterviewState {
-    round_id?: string;
-    round: number;
-    component: string;
-    dimension: string;
-    ambiguity: number;
-}
+import { type AskGateDeepInterviewState, type WorkflowGateKind, type WorkflowStage } from "./workflow-gate-types";
+export { type AskGateDeepInterviewState, buildAskGateAnswerSchema, GATE_OTHER_OPTION, validateAskGateStageState, } from "./workflow-gate-types";
 export interface AskGateWorkflowGateMeta {
     stage: WorkflowStage;
     kind: WorkflowGateKind;
@@ -81,6 +72,8 @@ export declare class DeepInterviewGateError extends Error {
     readonly code: "invalid_answer_shape" | "unknown_option" | "multi_not_allowed" | "missing_custom" | "missing_clarification" | "empty_selection" | "duplicate_selection";
     constructor(code: "invalid_answer_shape" | "unknown_option" | "multi_not_allowed" | "missing_custom" | "missing_clarification" | "empty_selection" | "duplicate_selection", message: string);
 }
+/** Build and validate exact producer-compatible `stage_state` metadata for one ask question. */
+export declare function buildAskGateStageState(question: AskGateQuestion, labels: string[]): Record<string, unknown>;
 /** Build the `workflow_gate` open-input for one ask question. */
 export declare function questionToGate(question: AskGateQuestion): OpenGateInput;
 /**

package/dist/types/modes/shared/agent-wire/workflow-gate-broker.d.ts

@@ -73,6 +73,10 @@ export interface WorkflowGateEmitter {
     setAckRecoveryParticipant?(participant: AskSelectedAckRecoveryParticipant | null): void;
     /** Explicit host hook for same-process accepted-but-unadvanced recovery. */
     recoverAcceptedGates?(): Promise<string[]>;
+    /** Reads a durable completed resolution before any presentation claim. */
+    lookupCompletedResolution?(response: WorkflowGateResponse): WorkflowGateCompletedResolutionLookup;
+    /** Supplies the active runtime turn captured immediately before a gate is opened. */
+    setRuntimeTurnProvider?(provider: (() => string | undefined) | null): void;
     /** Permanently revoke all in-process continuation authority and reject their waiters. */
     fence?(): void;
     /** Temporarily make this emitter unavailable while a session transition is reversible. */
@@ -90,9 +94,11 @@ export declare class BrokerWorkflowGateEmitter implements WorkflowGateEmitter {
     #private;
     constructor(runId: string, store: GateStore, emitterHooks?: Pick<BrokerHooks, "advance">);
     isUnattended(): boolean;
+    setRuntimeTurnProvider(provider: (() => string | undefined) | null): void;
     emitGate(input: OpenGateInput): Promise<unknown>;
     onGateEmitted(listener: (gate: WorkflowGate) => void): () => void;
     resolveGate(response: WorkflowGateResponse): Promise<WorkflowGateResolution>;
+    lookupCompletedResolution(response: WorkflowGateResponse): WorkflowGateCompletedResolutionLookup;
     prepareTerminalization(gateId: string, proof: WorkflowGateTerminalProof): boolean;
     clearPreparedTerminalization(gateId: string): void;
     listPendingGates(): WorkflowGate[];
@@ -145,6 +151,7 @@ export declare class MemoryGateStore implements GateStore {
     beginRuntimeInstance(instanceId: string): void;
     list(): PersistedGate[];
 }
+export declare function isUnsupportedWindowsDirectorySyncError(error: unknown, platform?: NodeJS.Platform): boolean;
 /** A write may have reached `rename` but not the directory fsync durability barrier. */
 export declare class GateStoreWriteError extends Error {
     readonly certainty: "not_committed" | "uncertain";
@@ -234,10 +241,21 @@ export interface OpenGateInput {
     context?: WorkflowGateContext;
     /** Optional diagnostic gate replaced by this newly persisted gate. */
     supersedesGateId?: string;
+    /** Optional immutable runtime turn captured by the emitter before broker persistence. */
+    runtimeTurnId?: string;
 }
+/** Durable resolution state used to safely replay direct control after presentation retirement. */
+export type WorkflowGateCompletedResolutionLookup = {
+    kind: "none";
+} | {
+    kind: "completed";
+    resolution: WorkflowGateResolution;
+} | {
+    kind: "accepted_incomplete";
+};
 export declare class WorkflowGateBrokerError extends Error {
-    readonly code: "unknown_gate" | "already_resolved" | "idempotency_conflict" | "invalid_workflow_stage";
-    constructor(code: "unknown_gate" | "already_resolved" | "idempotency_conflict" | "invalid_workflow_stage", message: string);
+    readonly code: "unknown_gate" | "already_resolved" | "idempotency_conflict" | "invalid_workflow_stage" | "invalid_runtime_turn";
+    constructor(code: "unknown_gate" | "already_resolved" | "idempotency_conflict" | "invalid_workflow_stage" | "invalid_runtime_turn", message: string);
 }
 export declare class WorkflowGateBroker {
     #private;
@@ -253,6 +271,7 @@ export declare class WorkflowGateBroker {
     classifyDisposition(gateId: string, answer: unknown): PersistedSemanticDisposition;
     validationError(gateId: string, keyword: string, message: string): WorkflowGateValidationError;
     updateAckPolicy(gateId: string, ackPolicy: PersistedAckPolicy): void;
+    lookupCompletedResolution(response: WorkflowGateResponse): WorkflowGateCompletedResolutionLookup;
     private runShort;
     private hasLiveContinuation;
     hasRecoverableAcceptedGate(): boolean;

package/dist/types/modes/shared/agent-wire/workflow-gate-types.d.ts

@@ -1,9 +1,38 @@
 /** Transport-neutral workflow gate contract used by SDK workflow coordination. */
 /** Lifecycle stages that emit machine-addressable SDK workflow gates. */
 export type WorkflowStage = "deep-interview" | "ralplan" | "ultragoal";
+/** Lifecycle stages included in the v1 workflow-gate contract. */
+export declare const WORKFLOW_GATE_V1_STAGES: readonly WorkflowStage[];
 /** Reserved stage names that are explicitly not part of the v1 contract. */
 export declare const RESERVED_WORKFLOW_STAGES: readonly string[];
 export type WorkflowGateKind = "question" | "approval" | "execution";
+/** "Other (type your own)" sentinel, mirroring the interactive ask tool. */
+export declare const GATE_OTHER_OPTION = "Other (type your own)";
+export interface AskGateDeepInterviewState {
+    round_id?: string;
+    round: number;
+    component: string;
+    dimension: string;
+    ambiguity: number;
+}
+export interface AskGateStageStateInput {
+    id: string;
+    multi?: boolean;
+    allowEmpty?: boolean;
+    navigationLabel?: "Next" | "Done";
+    deepInterview?: AskGateDeepInterviewState;
+    fallbackState?: Record<string, unknown>;
+}
+export interface AskGateSchemaInput {
+    multi?: boolean;
+    allowEmpty?: boolean;
+}
+/** Rejects stage state that is not exactly compatible with the generic ask-gate producer. */
+export declare function validateAskGateStageState(value: unknown): asserts value is Record<string, unknown>;
+/** Builds the canonical generic ask answer schema. */
+export declare function buildAskGateAnswerSchema(question: AskGateSchemaInput, labels: string[]): JsonSchema;
+/** Builds and validates exact generic ask stage-state metadata. */
+export declare function buildAskGateStageState(input: AskGateStageStateInput, labels: string[]): Record<string, unknown>;
 /** The documented JSON Schema 2020-12 subset supported by the gate validator. */
 export interface JsonSchema {
     type?: "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
@@ -57,6 +86,8 @@ export interface WorkflowGate {
     context: WorkflowGateContext;
     created_at: string;
     required: true;
+    /** Immutable runtime turn correlation captured before durable gate visibility. */
+    runtime_turn_id?: string;
 }
 /** Non-actionable durable-gate state retained for restart diagnostics. */
 export interface WorkflowGateLifecycle {

package/dist/types/modes/tasks-aggregator.d.ts

@@ -0,0 +1,39 @@
+import type { AsyncJob, AsyncJobManager, SubagentRecord } from "../async/job-manager";
+import type { CronJobView, JobsObserver } from "./jobs-observer";
+import type { ObservableSession, SessionObserverRegistry } from "./session-observer-registry";
+export type TaskStatus = "running" | "waiting" | "done" | "failed" | "cancelled";
+export type TaskKind = "bash" | "subagent" | "cron";
+export interface TaskRow {
+    id: string;
+    kind: TaskKind;
+    label: string;
+    status: TaskStatus;
+    startedAt: number;
+    resumable?: boolean;
+    monitorOutputLines?: number;
+}
+export interface TasksSnapshot {
+    rows: TaskRow[];
+    worstState: TaskStatus | "none";
+    failedUnacknowledged: boolean;
+}
+export declare const EMPTY_TASKS_SNAPSHOT: TasksSnapshot;
+export declare function mapAsyncJobStatus(status: AsyncJob["status"]): TaskStatus;
+export declare function mapSessionStatus(status: ObservableSession["status"]): TaskStatus;
+export declare function mapSubagentStatus(status: SubagentRecord["status"]): TaskStatus;
+export declare function mapCronStatus(cron: Pick<CronJobView, "firing">): TaskStatus;
+/** Joins manager jobs, monitor/cron views, and live session metadata. Stable
+ * subagent records are canonical for lifecycle state; the registry contributes
+ * only the current display label and timestamp. */
+export declare class TasksAggregator {
+    #private;
+    readonly manager: AsyncJobManager;
+    readonly jobsObserver: JobsObserver;
+    readonly sessions: SessionObserverRegistry;
+    readonly ownerId?: string | undefined;
+    constructor(manager: AsyncJobManager, jobsObserver: JobsObserver, sessions: SessionObserverRegistry, ownerId?: string | undefined);
+    onChange(cb: () => void): () => void;
+    getSnapshot(): TasksSnapshot;
+    acknowledgeFailures(): void;
+    dispose(): void;
+}

package/dist/types/modes/transcript-item-registry.d.ts

@@ -0,0 +1,60 @@
+export type TranscriptItemKind = "user" | "assistant-text" | "assistant-thinking" | "tool" | "read-group" | "custom";
+export type TranscriptItemCapabilities = {
+    copyable: boolean;
+    foldable: boolean;
+    rawViewable: boolean;
+};
+export type TranscriptSourcePayload = {
+    text: string;
+    metadata: Readonly<Record<string, unknown>>;
+    source: unknown;
+};
+export type TranscriptItem = {
+    id: string;
+    kind: TranscriptItemKind;
+    source: unknown;
+    getPayload?: (source: unknown) => TranscriptSourcePayload;
+    capabilities?: Partial<TranscriptItemCapabilities>;
+};
+export type RegisterTranscriptItem = Omit<TranscriptItem, "id"> & {
+    id?: string;
+};
+export type StreamingItemOptions = Omit<RegisterTranscriptItem, "id" | "kind"> & {
+    promptGeneration: number | string;
+    messageOrdinal: number;
+    kind?: "assistant-text" | "assistant-thinking";
+};
+/** Stable transcript identities shared by the inline and overlay projections. */
+export declare const transcriptItemId: {
+    entry: (entryId: string) => string;
+    assistantContent: (entryId: string, contentIndex: number) => string;
+    tool: (toolCallId: string) => string;
+    readGroup: (groupId: string) => string;
+    custom: (customId: string) => string;
+    stream: (promptGeneration: number | string, messageOrdinal: number) => string;
+};
+/**
+ * A session-local index of transcript projection items. It deliberately stores only
+ * structural sources, allowing interactive mode to supply live streaming objects
+ * and persisted session records without importing either implementation here.
+ */
+export declare class TranscriptItemRegistry {
+    #private;
+    get sessionId(): string | undefined;
+    /** Ordered snapshot for read-only transcript projections. */
+    items(): readonly TranscriptItem[];
+    register(item: RegisterTranscriptItem): string;
+    replace(id: string, item: Omit<TranscriptItem, "id">): boolean;
+    startStream(options: StreamingItemOptions): string;
+    /** Reconciles one exact live stream with its persisted canonical item. */
+    endStream(streamId: string, item: RegisterTranscriptItem): string | undefined;
+    retireStream(id: string): boolean;
+    coalesceReadGroup(groupId: string, source: unknown, toolCallIds?: readonly string[]): string;
+    rebuild(items: readonly RegisterTranscriptItem[]): void;
+    evict(id: string): boolean;
+    switchSession(sessionId: string): void;
+    resolveSourcePayload(id: string): TranscriptSourcePayload | undefined;
+    capabilities(id: string): TranscriptItemCapabilities | undefined;
+    has(id: string): boolean;
+    canonicalId(id: string): string | undefined;
+}