@mirasoth/soothe-client 0.5.4 → 0.5.7

package/dist/index.d.cts

@@ -170,7 +170,7 @@ declare const DEFAULT_CLIENT_CAPABILITIES: string[];
 declare const CLIENT_VERSION = "0.5.3";
 type MessageType = "connection_init" | "connection_ack" | "request" | "response" | "notification" | "subscribe" | "next" | "error" | "complete" | "unsubscribe" | "ping" | "pong" | "receipt_response" | "disconnect" | "status";
 /** Method names carried in the envelope `method` field. */
-type MethodName = "loop_list" | "loop_get" | "loop_tree" | "loop_prune" | "loop_delete" | "loop_new" | "loop_reattach" | "loop_detach" | "loop_input" | "loop_messages" | "loop_state_get" | "loop_state_update" | "loop_cards_fetch" | "loop_history_fetch" | "loop_events" | "autopilot_events" | "job_create" | "job_status" | "job_pause" | "job_resume" | "job_cancel" | "job_dag" | "job_guidance" | "autopilot_status" | "autopilot_submit" | "autopilot_list_goals" | "autopilot_get_goal" | "autopilot_cancel_goal" | "autopilot_cancel_all" | "autopilot_wake" | "autopilot_dream" | "autopilot_resume" | "autopilot_list_jobs" | "autopilot_get_job" | "daemon_status" | "daemon_shutdown" | "config_get" | "config_reload" | "skills_list" | "invoke_skill" | "models_list" | "mcp_status" | "auth" | "auth_refresh" | "slash_command" | "rpc_command" | "delivery_ack" | "cron_add" | "cron_list" | "cron_show" | "cron_cancel" | "disconnect";
+type MethodName = "loop_list" | "loop_get" | "loop_tree" | "loop_prune" | "loop_delete" | "loop_new" | "loop_reattach" | "loop_detach" | "loop_input" | "loop_messages" | "loop_state_get" | "loop_state_update" | "loop_history_fetch" | "loop_events" | "autopilot_events" | "job_create" | "job_status" | "job_pause" | "job_resume" | "job_cancel" | "job_dag" | "job_guidance" | "autopilot_status" | "autopilot_submit" | "autopilot_list_goals" | "autopilot_get_goal" | "autopilot_cancel_goal" | "autopilot_cancel_all" | "autopilot_wake" | "autopilot_dream" | "autopilot_resume" | "autopilot_list_jobs" | "autopilot_get_job" | "autopilot_top" | "daemon_status" | "daemon_shutdown" | "config_get" | "config_reload" | "skills_list" | "invoke_skill" | "models_list" | "mcp_status" | "auth" | "auth_refresh" | "slash_command" | "rpc_command" | "delivery_ack" | "cron_add" | "cron_list" | "cron_show" | "cron_cancel" | "disconnect";
 /** Base fields shared by every protocol-1 message. */
 interface BaseEnvelope {
     proto: string;
@@ -668,8 +668,6 @@ declare class Client extends EventEmitter {
     sendLoopStateGet(loopID: string): Promise<void>;
     /** Applies partial checkpoint values. */
     sendLoopStateUpdate(loopID: string, values: Record<string, unknown>, asNode?: string): Promise<void>;
-    /** Requests display card ledger snapshot. */
-    sendLoopCardsFetch(loopID: string): Promise<void>;
     /** Requests the full loop history. */
     sendLoopHistoryFetch(loopID: string): Promise<void>;
     /** Requests MCP server status. */
@@ -686,8 +684,6 @@ declare class Client extends EventEmitter {
     getLoopState(loopID: string, timeout?: number): Promise<Record<string, unknown>>;
     /** Updates loop state and waits for response. */
     updateLoopState(loopID: string, values: Record<string, unknown>, asNode?: string, timeout?: number): Promise<Record<string, unknown>>;
-    /** Requests display cards and waits for response. */
-    fetchLoopCards(loopID: string, timeout?: number): Promise<Record<string, unknown>>;
     /** Requests MCP status and waits for response. */
     getMCPStatus(timeout?: number): Promise<Record<string, unknown>>;
     /** Requests loop history and waits for response. */
@@ -738,6 +734,11 @@ declare class Client extends EventEmitter {
     autopilotListJobs(timeout?: number): Promise<Record<string, unknown>>;
     /** Get a root job with DAG snapshot. Prefer getJobStatus / getJobDag. */
     autopilotGetJob(jobId: string, timeout?: number): Promise<Record<string, unknown>>;
+    /** Jobs → goals → loops snapshot for CLI top. */
+    autopilotTop(timeoutOrOptions?: number | {
+        includeTerminal?: boolean;
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
     /** Subscribes to autopilot worker events. */
     autopilotSubscribe(timeout?: number): Promise<string>;
     /** Unsubscribes from autopilot worker events. */
@@ -802,6 +803,8 @@ declare class CommandClient {
     autopilotListJobs(): Promise<Record<string, unknown>>;
     /** Get a root job with DAG snapshot. Prefer jobStatus / getJobDag. */
     autopilotGetJob(jobId: string): Promise<Record<string, unknown>>;
+    /** Jobs → goals → loops snapshot for CLI top. */
+    autopilotTop(includeTerminal?: boolean): Promise<Record<string, unknown>>;
     cronAdd(text: string, priority?: number): Promise<Record<string, unknown>>;
     cronList(status?: string): Promise<Record<string, unknown>>;
 }
@@ -828,8 +831,6 @@ declare function fetchLoopHistory(client: Client, loopID: string, timeout?: numb
 declare function authenticate(client: Client, accessKey: string, secretKey: string, timeout?: number): Promise<Record<string, unknown>>;
 /** Refreshes the daemon-side auth token and waits for the response. */
 declare function refreshAuthToken(client: Client, refreshToken: string, timeout?: number): Promise<Record<string, unknown>>;
-/** Fetch bound display-card snapshot for a loop. */
-declare function fetchLoopCards(client: Client, loopID: string, timeout?: number): Promise<Record<string, unknown>>;
 /** Fetch persisted conversation/activity rows for a loop. */
 declare function fetchLoopMessages(client: Client, loopID: string, opts?: {
     limit?: number;
@@ -886,10 +887,34 @@ declare function isTurnProgressChunk(mode: string, data: unknown): boolean;
 /** True when the client should bump delivery_ack sequence for this frame. */
 declare function inboundNeedsDeliveryAck(event: Record<string, unknown>): boolean;
 
+/**
+ * Turn / stream boundary helpers (`turn_id` / `seq`).
+ * Used by DaemonSession for demuxing concurrent goal turns.
+ */
+declare function formatTurnId(loopId: string, generation: number): string;
+declare function parseTurnGeneration(turnId: string | null | undefined): number | null;
+declare function frameTurnId(frame: Record<string, unknown> | null | undefined): string | null;
+declare function frameSeq(frame: Record<string, unknown> | null | undefined): number | null;
+/** Absent ids never match. */
+declare function turnIdsMatch(expected: string | null | undefined, candidate: string | null | undefined): boolean;
+declare function isTurnTerminalAllowed(opts: {
+    expectedTurnId: string | null | undefined;
+    frameTurnId: string | null | undefined;
+    queryStarted: boolean;
+    turnProgressSeen: boolean;
+}): boolean;
+declare function isIdleTerminalAllowed(opts: {
+    expectedTurnId: string | null | undefined;
+    frameTurnId: string | null | undefined;
+    queryStarted: boolean;
+    turnProgressSeen: boolean;
+    cancellationSeen?: boolean;
+}): boolean;
+
 /**
  * Persistence seam for appkit.
  *
- * SessionStore abstracts per-application storage: the session↔loop-id mapping
+ * LoopSessionStore abstracts per-application storage: the session↔loop-id mapping
  * that ConnectionPool consults to decide bootstrap vs reattach, and the
  * message rows TurnRunner writes back when a turn completes. Applications
  * implement this against their own store (Postgres, Redis, in-memory, …).
@@ -897,7 +922,7 @@ declare function inboundNeedsDeliveryAck(event: Record<string, unknown>): boolea
  * Implementations must be safe for concurrent use.
  */
 /** Persisted mapping between an application session id and the daemon loop id. */
-interface SessionEntry {
+interface LoopSessionEntry {
     workspaceID: string;
     sessionID: string;
     loopID: string;
@@ -926,9 +951,9 @@ interface SessionMessage {
  * loop id once bootstrapped. TurnRunner persists the final assistant reply
  * and error rows via appendMessage.
  */
-interface SessionStore {
+interface LoopSessionStore {
     /** Returns the persisted entry for sessionID, or null if no record exists. */
-    getSession(sessionID: string): Promise<SessionEntry | null>;
+    getSession(sessionID: string): Promise<LoopSessionEntry | null>;
     /** Persists a new session↔loop mapping. */
     createSession(workspaceID: string, sessionID: string, loopID: string, sessionType: string): Promise<void>;
     /** Stamps the session's last-used timestamp. */
@@ -1219,7 +1244,7 @@ type BootstrapFunc = (client: ManagedClient, workspaceID: string, userID: string
  * active connection when still live, otherwise bootstraps a fresh loop
  * (loop_new + subscribe) or reattaches an existing one (loop_reattach +
  * subscribe + reattachAndProbe). Persistence of session↔loop mappings is
- * abstracted behind SessionStore.
+ * abstracted behind LoopSessionStore.
  *
  * The app-agnostic successor to triarch's SoothePoolManager connection
  * mechanics.
@@ -1274,7 +1299,7 @@ declare class ConnectionPool {
      * defaultPoolConfig is used; if scfg is null, defaultConfig is used; nil
      * factory/bootstrap fall back to the defaults.
      */
-    constructor(url: string, store: SessionStore, cfg?: PoolConfig | null, scfg?: Config | null, factory?: ClientFactory | null);
+    constructor(url: string, store: LoopSessionStore, cfg?: PoolConfig | null, scfg?: Config | null, factory?: ClientFactory | null);
     /** Overrides the loop bootstrap function (useful for test fakes). */
     withBootstrap(f: BootstrapFunc): ConnectionPool;
     /**
@@ -1411,7 +1436,7 @@ declare class TurnRunner {
     private buildInput;
     private onComplete;
     private onError;
-    constructor(pool: ConnectionPool, gate: QueryGate, classifier: EventClassifier, store: SessionStore, broadcaster: SSEBroadcaster | null, cfg: TurnConfig);
+    constructor(pool: ConnectionPool, gate: QueryGate, classifier: EventClassifier, store: LoopSessionStore, broadcaster: SSEBroadcaster | null, cfg: TurnConfig);
     withInputBuilder(f: typeof inputMessageForLoop): TurnRunner;
     withOnComplete(f: OnComplete): TurnRunner;
     withOnError(f: OnError): TurnRunner;
@@ -1437,11 +1462,12 @@ declare const TURN_END_IDLE = "status.idle";
 declare const TURN_END_STOPPED = "status.stopped";
 declare class TurnLifecycleGate {
     sawRunning: boolean;
-    sawStreamPayload: boolean;
     sawTurnProgress: boolean;
+    expectedTurnId: string | null;
+    cancellationSeen: boolean;
     observe(msg: unknown): void;
-    allowStreamEnd(): boolean;
-    allowIdleComplete(): boolean;
+    allowStreamEnd(frameTurn: string | null): boolean;
+    allowIdleComplete(frameTurn: string | null): boolean;
 }
 declare class TurnBoundary {
     readonly gate: TurnLifecycleGate;
@@ -1545,12 +1571,6 @@ declare class DaemonSession {
     private withRpcLock;
     private ensureRpcConnected;
     listLoops(_limit?: number): Promise<Record<string, unknown>>;
-    fetchLoopCards(loopId: string): Promise<{
-        cards: unknown[];
-        seq: number;
-        contextTokens: number;
-        success: boolean;
-    }>;
     fetchLoopHistory(loopId: string): Promise<{
         goals: unknown[];
         liveCards: unknown[];
@@ -1606,4 +1626,4 @@ declare class CardProjection {
     apply(data: unknown): boolean;
 }
 
-export { type Attachment, type BaseEnvelope, CLIENT_VERSION, CardProjection, type CardWireDict, type ChatEventResult, ChatEventTerminal, type ClassifierConfig, Client, CommandClient, type CompactImageOptions, type CompleteEnvelope, type Config, type ConnectionAckEnvelope, ConnectionError, type ConnectionInitEnvelope, ConnectionPool, DEFAULT_CLIENT_CAPABILITIES, DEFAULT_DELIVERABLE_PHASES, DEFAULT_POST_IDLE_DRAIN_MS, DEFAULT_THINKING_STEP_EVENTS, DaemonError, DaemonSession, type DaemonSessionOptions, type DecodedMessage, DisconnectCause, type DisconnectEnvelope, ErrIdleTimeout, ErrPoolExhausted, ErrQueryBusy, ErrQueryTimeout, type ErrorEnvelope, EventAutopilotGoalCompleted, EventAutopilotGoalCreated, EventAutopilotGoalProgress, EventAutopilotGoalStatus, EventAutopilotWorkerAssigned, EventAutopilotWorkerUnassigned, EventCardCreated, EventCardFinalized, EventCardReplayBegin, EventCardReplayEnd, EventCardUpdated, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventFinalReport, EventGeneralFailed, EventLoopReattachedWire, EventMessageReceived, EventMessageSent, EventPlanCreated, EventReplayComplete, EventStrangeLoopCompleted, EventStrangeLoopContextCompacted, EventStrangeLoopPlanDecision, EventStrangeLoopReasoned, EventStrangeLoopStarted, EventStrangeLoopStepCompleted, EventStrangeLoopStepQueued, EventStrangeLoopStepStarted, EventStreamToolCallUpdate, EventToolCallUpdatesBatch, EventToolCompleted, EventToolError, EventToolStarted, INTENT_HINT_EMBED, INTENT_HINT_IMAGE_TO_TEXT, INTENT_HINT_OCR, INTENT_HINT_TEXT_COMPLETION, type InputOptions, type InputOpts, type IntentHint, LOOP_ASSISTANT_OUTPUT_PHASES, type LoopAssistantOutputPhase, type LoopInputIntentHint, type LoopInputParams, type LoopNewOptions, type MessageType, type MethodName, type NegotiatedCapabilities, type NextEnvelope, type NotificationEnvelope, type OnComplete, type OnError, PROTO_VERSION, type ParsedCardFrame, type PingEnvelope, type PongEnvelope, type PoolConfig, PooledConn, QueryGate, REMOVED_INTENT_HINTS, type ReceiptResponseEnvelope, ReconnectError, type RemovedIntentHint, type RequestEnvelope, type ResponseEnvelope, SSEBroadcaster, type SSEEvent, STREAM_END, type SessionEntry, type SessionMessage, type SessionStore, StaleLoopError, type StatusFrame, StreamCloseFail, type StreamClosePolicy, StreamCloseSoftComplete, type StreamEventPayload, type SubscribeEnvelope, TURN_END_IDLE, TURN_END_STOPPED, TURN_END_STREAM_END, TimeoutError, TimeoutPolicy, TurnBoundary, type TurnChunk, type TurnConfig, TurnEventStats, TurnLifecycleGate, TurnRunner, type UnsubscribeEnvelope, type VerbosityLevel, VerbosityTier, authenticate, bootstrapLoopSession, checkDaemonStatus, classifyEventVerbosity, compactAttachments, compactImageAttachment, connectWithRetries, connectedWebsocket, connectionInitEnvelope, decodeMessage, defaultConfig, defaultPoolConfig, disconnectCauseName, disconnectEnvelope, encodeMessage, extractSootheLoopID, extractThinkingStep, fetchConfigSection, fetchLoopCards, fetchLoopHistory, fetchLoopMessages, fetchSkillsCatalog, idleTimeoutForTurn, inboundNeedsDeliveryAck, inputMessageForLoop, isCompletionEvent, isDaemonLive, isDaemonTurnEndEvent, isSubagentProgressEvent, isTurnEndCustomData, isTurnProgressChunk, isValidVerbosityLevel, loadConfigFromEnv, newLoopInputMessage, newLoopNewMessage, newLoopSubscribeMessage, newRequestID, notificationEnvelope, parseCardCustomPayload, parseNamespace, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };
+export { type Attachment, type BaseEnvelope, CLIENT_VERSION, CardProjection, type CardWireDict, type ChatEventResult, ChatEventTerminal, type ClassifierConfig, Client, CommandClient, type CompactImageOptions, type CompleteEnvelope, type Config, type ConnectionAckEnvelope, ConnectionError, type ConnectionInitEnvelope, ConnectionPool, DEFAULT_CLIENT_CAPABILITIES, DEFAULT_DELIVERABLE_PHASES, DEFAULT_POST_IDLE_DRAIN_MS, DEFAULT_THINKING_STEP_EVENTS, DaemonError, DaemonSession, type DaemonSessionOptions, type DecodedMessage, DisconnectCause, type DisconnectEnvelope, ErrIdleTimeout, ErrPoolExhausted, ErrQueryBusy, ErrQueryTimeout, type ErrorEnvelope, EventAutopilotGoalCompleted, EventAutopilotGoalCreated, EventAutopilotGoalProgress, EventAutopilotGoalStatus, EventAutopilotWorkerAssigned, EventAutopilotWorkerUnassigned, EventCardCreated, EventCardFinalized, EventCardReplayBegin, EventCardReplayEnd, EventCardUpdated, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventFinalReport, EventGeneralFailed, EventLoopReattachedWire, EventMessageReceived, EventMessageSent, EventPlanCreated, EventReplayComplete, EventStrangeLoopCompleted, EventStrangeLoopContextCompacted, EventStrangeLoopPlanDecision, EventStrangeLoopReasoned, EventStrangeLoopStarted, EventStrangeLoopStepCompleted, EventStrangeLoopStepQueued, EventStrangeLoopStepStarted, EventStreamToolCallUpdate, EventToolCallUpdatesBatch, EventToolCompleted, EventToolError, EventToolStarted, INTENT_HINT_EMBED, INTENT_HINT_IMAGE_TO_TEXT, INTENT_HINT_OCR, INTENT_HINT_TEXT_COMPLETION, type InputOptions, type InputOpts, type IntentHint, LOOP_ASSISTANT_OUTPUT_PHASES, type LoopAssistantOutputPhase, type LoopInputIntentHint, type LoopInputParams, type LoopNewOptions, type LoopSessionEntry, type LoopSessionStore, type MessageType, type MethodName, type NegotiatedCapabilities, type NextEnvelope, type NotificationEnvelope, type OnComplete, type OnError, PROTO_VERSION, type ParsedCardFrame, type PingEnvelope, type PongEnvelope, type PoolConfig, PooledConn, QueryGate, REMOVED_INTENT_HINTS, type ReceiptResponseEnvelope, ReconnectError, type RemovedIntentHint, type RequestEnvelope, type ResponseEnvelope, SSEBroadcaster, type SSEEvent, STREAM_END, type SessionMessage, StaleLoopError, type StatusFrame, StreamCloseFail, type StreamClosePolicy, StreamCloseSoftComplete, type StreamEventPayload, type SubscribeEnvelope, TURN_END_IDLE, TURN_END_STOPPED, TURN_END_STREAM_END, TimeoutError, TimeoutPolicy, TurnBoundary, type TurnChunk, type TurnConfig, TurnEventStats, TurnLifecycleGate, TurnRunner, type UnsubscribeEnvelope, type VerbosityLevel, VerbosityTier, authenticate, bootstrapLoopSession, checkDaemonStatus, classifyEventVerbosity, compactAttachments, compactImageAttachment, connectWithRetries, connectedWebsocket, connectionInitEnvelope, decodeMessage, defaultConfig, defaultPoolConfig, disconnectCauseName, disconnectEnvelope, encodeMessage, extractSootheLoopID, extractThinkingStep, fetchConfigSection, fetchLoopHistory, fetchLoopMessages, fetchSkillsCatalog, formatTurnId, frameSeq, frameTurnId, idleTimeoutForTurn, inboundNeedsDeliveryAck, inputMessageForLoop, isCompletionEvent, isDaemonLive, isDaemonTurnEndEvent, isIdleTerminalAllowed, isSubagentProgressEvent, isTurnEndCustomData, isTurnProgressChunk, isTurnTerminalAllowed, isValidVerbosityLevel, loadConfigFromEnv, newLoopInputMessage, newLoopNewMessage, newLoopSubscribeMessage, newRequestID, notificationEnvelope, parseCardCustomPayload, parseNamespace, parseTurnGeneration, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, turnIdsMatch, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };

package/dist/index.d.ts

@@ -170,7 +170,7 @@ declare const DEFAULT_CLIENT_CAPABILITIES: string[];
 declare const CLIENT_VERSION = "0.5.3";
 type MessageType = "connection_init" | "connection_ack" | "request" | "response" | "notification" | "subscribe" | "next" | "error" | "complete" | "unsubscribe" | "ping" | "pong" | "receipt_response" | "disconnect" | "status";
 /** Method names carried in the envelope `method` field. */
-type MethodName = "loop_list" | "loop_get" | "loop_tree" | "loop_prune" | "loop_delete" | "loop_new" | "loop_reattach" | "loop_detach" | "loop_input" | "loop_messages" | "loop_state_get" | "loop_state_update" | "loop_cards_fetch" | "loop_history_fetch" | "loop_events" | "autopilot_events" | "job_create" | "job_status" | "job_pause" | "job_resume" | "job_cancel" | "job_dag" | "job_guidance" | "autopilot_status" | "autopilot_submit" | "autopilot_list_goals" | "autopilot_get_goal" | "autopilot_cancel_goal" | "autopilot_cancel_all" | "autopilot_wake" | "autopilot_dream" | "autopilot_resume" | "autopilot_list_jobs" | "autopilot_get_job" | "daemon_status" | "daemon_shutdown" | "config_get" | "config_reload" | "skills_list" | "invoke_skill" | "models_list" | "mcp_status" | "auth" | "auth_refresh" | "slash_command" | "rpc_command" | "delivery_ack" | "cron_add" | "cron_list" | "cron_show" | "cron_cancel" | "disconnect";
+type MethodName = "loop_list" | "loop_get" | "loop_tree" | "loop_prune" | "loop_delete" | "loop_new" | "loop_reattach" | "loop_detach" | "loop_input" | "loop_messages" | "loop_state_get" | "loop_state_update" | "loop_history_fetch" | "loop_events" | "autopilot_events" | "job_create" | "job_status" | "job_pause" | "job_resume" | "job_cancel" | "job_dag" | "job_guidance" | "autopilot_status" | "autopilot_submit" | "autopilot_list_goals" | "autopilot_get_goal" | "autopilot_cancel_goal" | "autopilot_cancel_all" | "autopilot_wake" | "autopilot_dream" | "autopilot_resume" | "autopilot_list_jobs" | "autopilot_get_job" | "autopilot_top" | "daemon_status" | "daemon_shutdown" | "config_get" | "config_reload" | "skills_list" | "invoke_skill" | "models_list" | "mcp_status" | "auth" | "auth_refresh" | "slash_command" | "rpc_command" | "delivery_ack" | "cron_add" | "cron_list" | "cron_show" | "cron_cancel" | "disconnect";
 /** Base fields shared by every protocol-1 message. */
 interface BaseEnvelope {
     proto: string;
@@ -668,8 +668,6 @@ declare class Client extends EventEmitter {
     sendLoopStateGet(loopID: string): Promise<void>;
     /** Applies partial checkpoint values. */
     sendLoopStateUpdate(loopID: string, values: Record<string, unknown>, asNode?: string): Promise<void>;
-    /** Requests display card ledger snapshot. */
-    sendLoopCardsFetch(loopID: string): Promise<void>;
     /** Requests the full loop history. */
     sendLoopHistoryFetch(loopID: string): Promise<void>;
     /** Requests MCP server status. */
@@ -686,8 +684,6 @@ declare class Client extends EventEmitter {
     getLoopState(loopID: string, timeout?: number): Promise<Record<string, unknown>>;
     /** Updates loop state and waits for response. */
     updateLoopState(loopID: string, values: Record<string, unknown>, asNode?: string, timeout?: number): Promise<Record<string, unknown>>;
-    /** Requests display cards and waits for response. */
-    fetchLoopCards(loopID: string, timeout?: number): Promise<Record<string, unknown>>;
     /** Requests MCP status and waits for response. */
     getMCPStatus(timeout?: number): Promise<Record<string, unknown>>;
     /** Requests loop history and waits for response. */
@@ -738,6 +734,11 @@ declare class Client extends EventEmitter {
     autopilotListJobs(timeout?: number): Promise<Record<string, unknown>>;
     /** Get a root job with DAG snapshot. Prefer getJobStatus / getJobDag. */
     autopilotGetJob(jobId: string, timeout?: number): Promise<Record<string, unknown>>;
+    /** Jobs → goals → loops snapshot for CLI top. */
+    autopilotTop(timeoutOrOptions?: number | {
+        includeTerminal?: boolean;
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
     /** Subscribes to autopilot worker events. */
     autopilotSubscribe(timeout?: number): Promise<string>;
     /** Unsubscribes from autopilot worker events. */
@@ -802,6 +803,8 @@ declare class CommandClient {
     autopilotListJobs(): Promise<Record<string, unknown>>;
     /** Get a root job with DAG snapshot. Prefer jobStatus / getJobDag. */
     autopilotGetJob(jobId: string): Promise<Record<string, unknown>>;
+    /** Jobs → goals → loops snapshot for CLI top. */
+    autopilotTop(includeTerminal?: boolean): Promise<Record<string, unknown>>;
     cronAdd(text: string, priority?: number): Promise<Record<string, unknown>>;
     cronList(status?: string): Promise<Record<string, unknown>>;
 }
@@ -828,8 +831,6 @@ declare function fetchLoopHistory(client: Client, loopID: string, timeout?: numb
 declare function authenticate(client: Client, accessKey: string, secretKey: string, timeout?: number): Promise<Record<string, unknown>>;
 /** Refreshes the daemon-side auth token and waits for the response. */
 declare function refreshAuthToken(client: Client, refreshToken: string, timeout?: number): Promise<Record<string, unknown>>;
-/** Fetch bound display-card snapshot for a loop. */
-declare function fetchLoopCards(client: Client, loopID: string, timeout?: number): Promise<Record<string, unknown>>;
 /** Fetch persisted conversation/activity rows for a loop. */
 declare function fetchLoopMessages(client: Client, loopID: string, opts?: {
     limit?: number;
@@ -886,10 +887,34 @@ declare function isTurnProgressChunk(mode: string, data: unknown): boolean;
 /** True when the client should bump delivery_ack sequence for this frame. */
 declare function inboundNeedsDeliveryAck(event: Record<string, unknown>): boolean;
 
+/**
+ * Turn / stream boundary helpers (`turn_id` / `seq`).
+ * Used by DaemonSession for demuxing concurrent goal turns.
+ */
+declare function formatTurnId(loopId: string, generation: number): string;
+declare function parseTurnGeneration(turnId: string | null | undefined): number | null;
+declare function frameTurnId(frame: Record<string, unknown> | null | undefined): string | null;
+declare function frameSeq(frame: Record<string, unknown> | null | undefined): number | null;
+/** Absent ids never match. */
+declare function turnIdsMatch(expected: string | null | undefined, candidate: string | null | undefined): boolean;
+declare function isTurnTerminalAllowed(opts: {
+    expectedTurnId: string | null | undefined;
+    frameTurnId: string | null | undefined;
+    queryStarted: boolean;
+    turnProgressSeen: boolean;
+}): boolean;
+declare function isIdleTerminalAllowed(opts: {
+    expectedTurnId: string | null | undefined;
+    frameTurnId: string | null | undefined;
+    queryStarted: boolean;
+    turnProgressSeen: boolean;
+    cancellationSeen?: boolean;
+}): boolean;
+
 /**
  * Persistence seam for appkit.
  *
- * SessionStore abstracts per-application storage: the session↔loop-id mapping
+ * LoopSessionStore abstracts per-application storage: the session↔loop-id mapping
  * that ConnectionPool consults to decide bootstrap vs reattach, and the
  * message rows TurnRunner writes back when a turn completes. Applications
  * implement this against their own store (Postgres, Redis, in-memory, …).
@@ -897,7 +922,7 @@ declare function inboundNeedsDeliveryAck(event: Record<string, unknown>): boolea
  * Implementations must be safe for concurrent use.
  */
 /** Persisted mapping between an application session id and the daemon loop id. */
-interface SessionEntry {
+interface LoopSessionEntry {
     workspaceID: string;
     sessionID: string;
     loopID: string;
@@ -926,9 +951,9 @@ interface SessionMessage {
  * loop id once bootstrapped. TurnRunner persists the final assistant reply
  * and error rows via appendMessage.
  */
-interface SessionStore {
+interface LoopSessionStore {
     /** Returns the persisted entry for sessionID, or null if no record exists. */
-    getSession(sessionID: string): Promise<SessionEntry | null>;
+    getSession(sessionID: string): Promise<LoopSessionEntry | null>;
     /** Persists a new session↔loop mapping. */
     createSession(workspaceID: string, sessionID: string, loopID: string, sessionType: string): Promise<void>;
     /** Stamps the session's last-used timestamp. */
@@ -1219,7 +1244,7 @@ type BootstrapFunc = (client: ManagedClient, workspaceID: string, userID: string
  * active connection when still live, otherwise bootstraps a fresh loop
  * (loop_new + subscribe) or reattaches an existing one (loop_reattach +
  * subscribe + reattachAndProbe). Persistence of session↔loop mappings is
- * abstracted behind SessionStore.
+ * abstracted behind LoopSessionStore.
  *
  * The app-agnostic successor to triarch's SoothePoolManager connection
  * mechanics.
@@ -1274,7 +1299,7 @@ declare class ConnectionPool {
      * defaultPoolConfig is used; if scfg is null, defaultConfig is used; nil
      * factory/bootstrap fall back to the defaults.
      */
-    constructor(url: string, store: SessionStore, cfg?: PoolConfig | null, scfg?: Config | null, factory?: ClientFactory | null);
+    constructor(url: string, store: LoopSessionStore, cfg?: PoolConfig | null, scfg?: Config | null, factory?: ClientFactory | null);
     /** Overrides the loop bootstrap function (useful for test fakes). */
     withBootstrap(f: BootstrapFunc): ConnectionPool;
     /**
@@ -1411,7 +1436,7 @@ declare class TurnRunner {
     private buildInput;
     private onComplete;
     private onError;
-    constructor(pool: ConnectionPool, gate: QueryGate, classifier: EventClassifier, store: SessionStore, broadcaster: SSEBroadcaster | null, cfg: TurnConfig);
+    constructor(pool: ConnectionPool, gate: QueryGate, classifier: EventClassifier, store: LoopSessionStore, broadcaster: SSEBroadcaster | null, cfg: TurnConfig);
     withInputBuilder(f: typeof inputMessageForLoop): TurnRunner;
     withOnComplete(f: OnComplete): TurnRunner;
     withOnError(f: OnError): TurnRunner;
@@ -1437,11 +1462,12 @@ declare const TURN_END_IDLE = "status.idle";
 declare const TURN_END_STOPPED = "status.stopped";
 declare class TurnLifecycleGate {
     sawRunning: boolean;
-    sawStreamPayload: boolean;
     sawTurnProgress: boolean;
+    expectedTurnId: string | null;
+    cancellationSeen: boolean;
     observe(msg: unknown): void;
-    allowStreamEnd(): boolean;
-    allowIdleComplete(): boolean;
+    allowStreamEnd(frameTurn: string | null): boolean;
+    allowIdleComplete(frameTurn: string | null): boolean;
 }
 declare class TurnBoundary {
     readonly gate: TurnLifecycleGate;
@@ -1545,12 +1571,6 @@ declare class DaemonSession {
     private withRpcLock;
     private ensureRpcConnected;
     listLoops(_limit?: number): Promise<Record<string, unknown>>;
-    fetchLoopCards(loopId: string): Promise<{
-        cards: unknown[];
-        seq: number;
-        contextTokens: number;
-        success: boolean;
-    }>;
     fetchLoopHistory(loopId: string): Promise<{
         goals: unknown[];
         liveCards: unknown[];
@@ -1606,4 +1626,4 @@ declare class CardProjection {
     apply(data: unknown): boolean;
 }
 
-export { type Attachment, type BaseEnvelope, CLIENT_VERSION, CardProjection, type CardWireDict, type ChatEventResult, ChatEventTerminal, type ClassifierConfig, Client, CommandClient, type CompactImageOptions, type CompleteEnvelope, type Config, type ConnectionAckEnvelope, ConnectionError, type ConnectionInitEnvelope, ConnectionPool, DEFAULT_CLIENT_CAPABILITIES, DEFAULT_DELIVERABLE_PHASES, DEFAULT_POST_IDLE_DRAIN_MS, DEFAULT_THINKING_STEP_EVENTS, DaemonError, DaemonSession, type DaemonSessionOptions, type DecodedMessage, DisconnectCause, type DisconnectEnvelope, ErrIdleTimeout, ErrPoolExhausted, ErrQueryBusy, ErrQueryTimeout, type ErrorEnvelope, EventAutopilotGoalCompleted, EventAutopilotGoalCreated, EventAutopilotGoalProgress, EventAutopilotGoalStatus, EventAutopilotWorkerAssigned, EventAutopilotWorkerUnassigned, EventCardCreated, EventCardFinalized, EventCardReplayBegin, EventCardReplayEnd, EventCardUpdated, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventFinalReport, EventGeneralFailed, EventLoopReattachedWire, EventMessageReceived, EventMessageSent, EventPlanCreated, EventReplayComplete, EventStrangeLoopCompleted, EventStrangeLoopContextCompacted, EventStrangeLoopPlanDecision, EventStrangeLoopReasoned, EventStrangeLoopStarted, EventStrangeLoopStepCompleted, EventStrangeLoopStepQueued, EventStrangeLoopStepStarted, EventStreamToolCallUpdate, EventToolCallUpdatesBatch, EventToolCompleted, EventToolError, EventToolStarted, INTENT_HINT_EMBED, INTENT_HINT_IMAGE_TO_TEXT, INTENT_HINT_OCR, INTENT_HINT_TEXT_COMPLETION, type InputOptions, type InputOpts, type IntentHint, LOOP_ASSISTANT_OUTPUT_PHASES, type LoopAssistantOutputPhase, type LoopInputIntentHint, type LoopInputParams, type LoopNewOptions, type MessageType, type MethodName, type NegotiatedCapabilities, type NextEnvelope, type NotificationEnvelope, type OnComplete, type OnError, PROTO_VERSION, type ParsedCardFrame, type PingEnvelope, type PongEnvelope, type PoolConfig, PooledConn, QueryGate, REMOVED_INTENT_HINTS, type ReceiptResponseEnvelope, ReconnectError, type RemovedIntentHint, type RequestEnvelope, type ResponseEnvelope, SSEBroadcaster, type SSEEvent, STREAM_END, type SessionEntry, type SessionMessage, type SessionStore, StaleLoopError, type StatusFrame, StreamCloseFail, type StreamClosePolicy, StreamCloseSoftComplete, type StreamEventPayload, type SubscribeEnvelope, TURN_END_IDLE, TURN_END_STOPPED, TURN_END_STREAM_END, TimeoutError, TimeoutPolicy, TurnBoundary, type TurnChunk, type TurnConfig, TurnEventStats, TurnLifecycleGate, TurnRunner, type UnsubscribeEnvelope, type VerbosityLevel, VerbosityTier, authenticate, bootstrapLoopSession, checkDaemonStatus, classifyEventVerbosity, compactAttachments, compactImageAttachment, connectWithRetries, connectedWebsocket, connectionInitEnvelope, decodeMessage, defaultConfig, defaultPoolConfig, disconnectCauseName, disconnectEnvelope, encodeMessage, extractSootheLoopID, extractThinkingStep, fetchConfigSection, fetchLoopCards, fetchLoopHistory, fetchLoopMessages, fetchSkillsCatalog, idleTimeoutForTurn, inboundNeedsDeliveryAck, inputMessageForLoop, isCompletionEvent, isDaemonLive, isDaemonTurnEndEvent, isSubagentProgressEvent, isTurnEndCustomData, isTurnProgressChunk, isValidVerbosityLevel, loadConfigFromEnv, newLoopInputMessage, newLoopNewMessage, newLoopSubscribeMessage, newRequestID, notificationEnvelope, parseCardCustomPayload, parseNamespace, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };
+export { type Attachment, type BaseEnvelope, CLIENT_VERSION, CardProjection, type CardWireDict, type ChatEventResult, ChatEventTerminal, type ClassifierConfig, Client, CommandClient, type CompactImageOptions, type CompleteEnvelope, type Config, type ConnectionAckEnvelope, ConnectionError, type ConnectionInitEnvelope, ConnectionPool, DEFAULT_CLIENT_CAPABILITIES, DEFAULT_DELIVERABLE_PHASES, DEFAULT_POST_IDLE_DRAIN_MS, DEFAULT_THINKING_STEP_EVENTS, DaemonError, DaemonSession, type DaemonSessionOptions, type DecodedMessage, DisconnectCause, type DisconnectEnvelope, ErrIdleTimeout, ErrPoolExhausted, ErrQueryBusy, ErrQueryTimeout, type ErrorEnvelope, EventAutopilotGoalCompleted, EventAutopilotGoalCreated, EventAutopilotGoalProgress, EventAutopilotGoalStatus, EventAutopilotWorkerAssigned, EventAutopilotWorkerUnassigned, EventCardCreated, EventCardFinalized, EventCardReplayBegin, EventCardReplayEnd, EventCardUpdated, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventFinalReport, EventGeneralFailed, EventLoopReattachedWire, EventMessageReceived, EventMessageSent, EventPlanCreated, EventReplayComplete, EventStrangeLoopCompleted, EventStrangeLoopContextCompacted, EventStrangeLoopPlanDecision, EventStrangeLoopReasoned, EventStrangeLoopStarted, EventStrangeLoopStepCompleted, EventStrangeLoopStepQueued, EventStrangeLoopStepStarted, EventStreamToolCallUpdate, EventToolCallUpdatesBatch, EventToolCompleted, EventToolError, EventToolStarted, INTENT_HINT_EMBED, INTENT_HINT_IMAGE_TO_TEXT, INTENT_HINT_OCR, INTENT_HINT_TEXT_COMPLETION, type InputOptions, type InputOpts, type IntentHint, LOOP_ASSISTANT_OUTPUT_PHASES, type LoopAssistantOutputPhase, type LoopInputIntentHint, type LoopInputParams, type LoopNewOptions, type LoopSessionEntry, type LoopSessionStore, type MessageType, type MethodName, type NegotiatedCapabilities, type NextEnvelope, type NotificationEnvelope, type OnComplete, type OnError, PROTO_VERSION, type ParsedCardFrame, type PingEnvelope, type PongEnvelope, type PoolConfig, PooledConn, QueryGate, REMOVED_INTENT_HINTS, type ReceiptResponseEnvelope, ReconnectError, type RemovedIntentHint, type RequestEnvelope, type ResponseEnvelope, SSEBroadcaster, type SSEEvent, STREAM_END, type SessionMessage, StaleLoopError, type StatusFrame, StreamCloseFail, type StreamClosePolicy, StreamCloseSoftComplete, type StreamEventPayload, type SubscribeEnvelope, TURN_END_IDLE, TURN_END_STOPPED, TURN_END_STREAM_END, TimeoutError, TimeoutPolicy, TurnBoundary, type TurnChunk, type TurnConfig, TurnEventStats, TurnLifecycleGate, TurnRunner, type UnsubscribeEnvelope, type VerbosityLevel, VerbosityTier, authenticate, bootstrapLoopSession, checkDaemonStatus, classifyEventVerbosity, compactAttachments, compactImageAttachment, connectWithRetries, connectedWebsocket, connectionInitEnvelope, decodeMessage, defaultConfig, defaultPoolConfig, disconnectCauseName, disconnectEnvelope, encodeMessage, extractSootheLoopID, extractThinkingStep, fetchConfigSection, fetchLoopHistory, fetchLoopMessages, fetchSkillsCatalog, formatTurnId, frameSeq, frameTurnId, idleTimeoutForTurn, inboundNeedsDeliveryAck, inputMessageForLoop, isCompletionEvent, isDaemonLive, isDaemonTurnEndEvent, isIdleTerminalAllowed, isSubagentProgressEvent, isTurnEndCustomData, isTurnProgressChunk, isTurnTerminalAllowed, isValidVerbosityLevel, loadConfigFromEnv, newLoopInputMessage, newLoopNewMessage, newLoopSubscribeMessage, newRequestID, notificationEnvelope, parseCardCustomPayload, parseNamespace, parseTurnGeneration, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, turnIdsMatch, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };