@mirasoth/soothe-client 0.5.5 → 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_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;
@@ -734,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. */
@@ -798,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>>;
 }
@@ -880,6 +887,30 @@ 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.
  *
@@ -1431,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;
@@ -1594,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 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, 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_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;
@@ -734,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. */
@@ -798,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>>;
 }
@@ -880,6 +887,30 @@ 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.
  *
@@ -1431,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;
@@ -1594,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 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, 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.js

@@ -84,7 +84,7 @@ import {
   subscribeEnvelope,
   unsubscribeEnvelope,
   validateLoopInputIntentHint
-} from "./chunk-XEZBHENR.js";
+} from "./chunk-56Z7SUGW.js";
 
 // src/session.ts
 async function bootstrapLoopSession(client, resumeLoopId, config, loopNew) {
@@ -270,6 +270,10 @@ var CommandClient = class {
   async autopilotGetJob(jobId) {
     return this.request("autopilot_get_job", { job_id: jobId });
   }
+  /** Jobs → goals → loops snapshot for CLI top. */
+  async autopilotTop(includeTerminal = false) {
+    return this.request("autopilot_top", { include_terminal: includeTerminal });
+  }
   async cronAdd(text, priority = 0) {
     const params = { text };
     if (priority > 0) params.priority = priority;
@@ -287,7 +291,7 @@ async function checkDaemonStatus(client, timeout) {
   return client.requestResponse("daemon_status", {}, "daemon_status", timeout ?? 5e3);
 }
 async function isDaemonLive(wsURL, timeout) {
-  const { Client: Client2 } = await import("./client-TQNJNIH2.js");
+  const { Client: Client2 } = await import("./client-CUYIRMFW.js");
   const t = timeout ?? 5e3;
   const client = new Client2(wsURL, defaultConfig());
   try {
@@ -371,7 +375,7 @@ async function fetchLoopMessages(client, loopID, opts) {
   );
 }
 async function connectedWebsocket(wsUrl, fn, timeoutMs = 3e4) {
-  const { Client: Client2 } = await import("./client-TQNJNIH2.js");
+  const { Client: Client2 } = await import("./client-CUYIRMFW.js");
   const client = new Client2(wsUrl, defaultConfig());
   const deadline = Date.now() + timeoutMs;
   try {
@@ -428,6 +432,59 @@ async function protocol1Rpc(wsUrl, method, params = null, opts = {}) {
   }
 }
 
+// src/turn_boundary.ts
+function formatTurnId(loopId, generation) {
+  const lid = String(loopId || "").trim();
+  const gen = Number(generation);
+  if (!lid || !Number.isFinite(gen) || gen <= 0) return "";
+  return `${lid}:${Math.trunc(gen)}`;
+}
+function parseTurnGeneration(turnId) {
+  const raw = String(turnId || "").trim();
+  if (!raw || !raw.includes(":")) return null;
+  const suffix = raw.split(":").pop() ?? "";
+  const gen = Number.parseInt(suffix, 10);
+  return Number.isFinite(gen) && gen > 0 ? gen : null;
+}
+function frameTurnId(frame) {
+  if (!frame || typeof frame !== "object") return null;
+  const tid = frame.turn_id;
+  if (typeof tid === "string" && tid.trim()) return tid.trim();
+  const data = frame.data;
+  if (data && typeof data === "object") {
+    const inner = data.turn_id;
+    if (typeof inner === "string" && inner.trim()) return inner.trim();
+  }
+  return null;
+}
+function frameSeq(frame) {
+  if (!frame || typeof frame !== "object") return null;
+  const raw = frame.seq;
+  if (typeof raw === "boolean") return null;
+  if (typeof raw === "number" && Number.isFinite(raw) && raw >= 0 && Number.isInteger(raw)) {
+    return raw;
+  }
+  return null;
+}
+function turnIdsMatch(expected, candidate) {
+  const exp = String(expected || "").trim();
+  const cand = String(candidate || "").trim();
+  return Boolean(exp) && Boolean(cand) && exp === cand;
+}
+function isTurnTerminalAllowed(opts) {
+  if (!opts.queryStarted || !opts.turnProgressSeen) return false;
+  return turnIdsMatch(opts.expectedTurnId, opts.frameTurnId);
+}
+function isIdleTerminalAllowed(opts) {
+  if (!opts.queryStarted || !String(opts.expectedTurnId || "").trim()) return false;
+  const cand = String(opts.frameTurnId || "").trim();
+  if (cand) {
+    if (!turnIdsMatch(opts.expectedTurnId, cand)) return false;
+    return Boolean(opts.turnProgressSeen || opts.cancellationSeen);
+  }
+  return Boolean(opts.cancellationSeen);
+}
+
 // src/appkit/broadcaster.ts
 var SUBSCRIBER_QUEUE_CAP = 100;
 var SSEBroadcaster = class {
@@ -1384,8 +1441,9 @@ var TURN_END_IDLE = "status.idle";
 var TURN_END_STOPPED = "status.stopped";
 var TurnLifecycleGate = class {
   sawRunning = false;
-  sawStreamPayload = false;
   sawTurnProgress = false;
+  expectedTurnId = null;
+  cancellationSeen = false;
   observe(msg) {
     const frame = normalizeFrame(msg);
     if (!frame) return;
@@ -1393,22 +1451,43 @@ var TurnLifecycleGate = class {
     if (typ === "status") {
       if (String(frame.state ?? "").trim().toLowerCase() === "running") {
         this.sawRunning = true;
+        const statusTurn = frameTurnId(frame);
+        if (statusTurn) {
+          const newGen = parseTurnGeneration(statusTurn);
+          const oldGen = parseTurnGeneration(this.expectedTurnId);
+          if (this.expectedTurnId === null || newGen !== null && (oldGen === null || newGen >= oldGen)) {
+            if (this.expectedTurnId && statusTurn !== this.expectedTurnId) {
+              this.sawTurnProgress = false;
+            }
+            this.expectedTurnId = statusTurn;
+          }
+        }
       }
       return;
     }
     if (typ === "event") {
-      this.sawStreamPayload = true;
       const mode = String(frame.mode ?? "");
       if (isTurnProgressChunk(mode, frame.data)) {
         this.sawTurnProgress = true;
       }
     }
   }
-  allowStreamEnd() {
-    return this.sawRunning && this.sawTurnProgress;
+  allowStreamEnd(frameTurn) {
+    return isTurnTerminalAllowed({
+      expectedTurnId: this.expectedTurnId,
+      frameTurnId: frameTurn,
+      queryStarted: this.sawRunning,
+      turnProgressSeen: this.sawTurnProgress
+    });
   }
-  allowIdleComplete() {
-    return this.sawRunning && this.sawStreamPayload;
+  allowIdleComplete(frameTurn) {
+    return isIdleTerminalAllowed({
+      expectedTurnId: this.expectedTurnId,
+      frameTurnId: frameTurn,
+      queryStarted: this.sawRunning,
+      turnProgressSeen: this.sawTurnProgress,
+      cancellationSeen: this.cancellationSeen
+    });
   }
 };
 var TurnBoundary = class {
@@ -1423,17 +1502,23 @@ var TurnBoundary = class {
     const typ = String(frame.type ?? "");
     if (typ === "status") {
       const state = String(frame.state ?? "").trim().toLowerCase();
+      const frameTurn = frameTurnId(frame);
       if (state === "stopped" && this.gate.sawRunning) {
+        if (this.gate.expectedTurnId && !turnIdsMatch(this.gate.expectedTurnId, frameTurn)) {
+          return [false, ""];
+        }
         return this.mark(TURN_END_STOPPED);
       }
-      if (state === "idle" && this.gate.allowIdleComplete()) {
+      if (state === "idle" && this.gate.allowIdleComplete(frameTurn)) {
         return this.mark(TURN_END_IDLE);
       }
       return [false, ""];
     }
     if (typ === "event") {
       const mode = String(frame.mode ?? "");
-      if (mode === "custom" && isTurnEndCustomData(frame.data) && this.gate.allowStreamEnd()) {
+      const data = frame.data;
+      const dataTurn = frameTurnId(data) || frameTurnId(frame);
+      if (mode === "custom" && isTurnEndCustomData(data) && this.gate.allowStreamEnd(dataTurn)) {
         return this.mark(TURN_END_STREAM_END);
       }
     }
@@ -1459,20 +1544,26 @@ function normalizeFrame(msg) {
       return inner;
     }
     if (inner && typeof inner === "object" && inner.mode) {
-      return {
+      const out = {
         type: "event",
         mode: inner.mode,
         data: inner.data,
         namespace: inner.namespace ?? payload.namespace
       };
+      const tid = inner.turn_id ?? payload.turn_id ?? m.turn_id;
+      if (tid) out.turn_id = tid;
+      return out;
     }
     if (payload.mode) {
-      return {
+      const out = {
         type: "event",
         mode: payload.mode,
         data: payload.data,
         namespace: payload.namespace
       };
+      const tid = payload.turn_id ?? m.turn_id;
+      if (tid) out.turn_id = tid;
+      return out;
     }
     return null;
   }
@@ -2161,7 +2252,7 @@ var DaemonSession = class {
     this.lastTurnErrorMessage = null;
     let queryStarted = false;
     let expectedLoopId = this.loopId;
-    let streamPayloadSeen = false;
+    let expectedTurnId = null;
     let turnProgressSeen = false;
     this.streaming = true;
     const absoluteDeadline = opts.maxWaitMs !== void 0 && opts.maxWaitMs > 0 ? Date.now() + opts.maxWaitMs : null;
@@ -2195,6 +2286,17 @@ var DaemonSession = class {
         if (expectedLoopId && typeof eventLoopId === "string" && eventLoopId && eventLoopId !== expectedLoopId) {
           continue;
         }
+        const evTurnId = frameTurnId(frame);
+        const statusState = eventType === "status" ? String(frame.state ?? "") : "";
+        const isRunningStatus = statusState === "running";
+        const isTerminalStatus = statusState === "idle" || statusState === "stopped";
+        if (expectedTurnId && (eventType === "event" || eventType === "status") && !isRunningStatus) {
+          if (isTerminalStatus) {
+            if (evTurnId && !turnIdsMatch(expectedTurnId, evTurnId)) continue;
+          } else if (!turnIdsMatch(expectedTurnId, evTurnId)) {
+            continue;
+          }
+        }
         if (eventType === "error") {
           const errObj = frame.error ?? {};
           throw new Error(String(errObj.message || frame.message || "daemon error"));
@@ -2205,16 +2307,37 @@ var DaemonSession = class {
             this.loopId = loopEv;
             expectedLoopId = loopEv;
           }
-          const state = String(frame.state ?? "");
-          if (state === "running") {
+          if (statusState === "running") {
             queryStarted = true;
-          } else if (queryStarted && state === "stopped") {
-            this.lastTurnEndState = state;
+            const statusTurn = frameTurnId(frame);
+            if (statusTurn) {
+              const newGen = parseTurnGeneration(statusTurn);
+              const oldGen = parseTurnGeneration(expectedTurnId);
+              if (expectedTurnId === null || newGen !== null && (oldGen === null || newGen >= oldGen)) {
+                if (expectedTurnId && statusTurn !== expectedTurnId) {
+                  turnProgressSeen = false;
+                }
+                expectedTurnId = statusTurn;
+              }
+            }
+          } else if (queryStarted && statusState === "stopped") {
+            const stopTurn = frameTurnId(frame);
+            if (expectedTurnId && !turnIdsMatch(expectedTurnId, stopTurn)) continue;
+            this.lastTurnEndState = statusState;
             yield* this.drainStreamEventsAfterIdle(expectedLoopId);
             break;
-          } else if (queryStarted && state === "idle") {
-            if (!streamPayloadSeen && !this.lastTurnCancellationSeen) continue;
-            this.lastTurnEndState = state;
+          } else if (queryStarted && statusState === "idle") {
+            const idleTurn = frameTurnId(frame);
+            if (!isIdleTerminalAllowed({
+              expectedTurnId,
+              frameTurnId: idleTurn,
+              queryStarted,
+              turnProgressSeen,
+              cancellationSeen: this.lastTurnCancellationSeen
+            })) {
+              continue;
+            }
+            this.lastTurnEndState = statusState;
             yield* this.drainStreamEventsAfterIdle(expectedLoopId);
             break;
           }
@@ -2236,9 +2359,16 @@ var DaemonSession = class {
           continue;
         }
         if (mode === "custom" && isTurnEndCustomData(data)) {
-          if (!queryStarted || !turnProgressSeen) continue;
+          const dataTurn = frameTurnId(data) || evTurnId;
+          if (!isTurnTerminalAllowed({
+            expectedTurnId,
+            frameTurnId: dataTurn,
+            queryStarted,
+            turnProgressSeen
+          })) {
+            continue;
+          }
         }
-        streamPayloadSeen = true;
         if (isTurnProgressChunk(mode, data)) turnProgressSeen = true;
         yield [namespace, mode, data];
         if (mode === "custom" && isTurnEndCustomData(data)) {
@@ -2437,15 +2567,20 @@ export {
   fetchLoopHistory,
   fetchLoopMessages,
   fetchSkillsCatalog,
+  formatTurnId,
+  frameSeq,
+  frameTurnId,
   idleTimeoutForTurn,
   inboundNeedsDeliveryAck,
   inputMessageForLoop,
   isCompletionEvent,
   isDaemonLive,
   isDaemonTurnEndEvent,
+  isIdleTerminalAllowed,
   isSubagentProgressEvent,
   isTurnEndCustomData,
   isTurnProgressChunk,
+  isTurnTerminalAllowed,
   isValidVerbosityLevel,
   loadConfigFromEnv,
   newLoopInputMessage,
@@ -2455,6 +2590,7 @@ export {
   notificationEnvelope,
   parseCardCustomPayload,
   parseNamespace,
+  parseTurnGeneration,
   pingEnvelope,
   pongEnvelope,
   protocol1Rpc,
@@ -2465,6 +2601,7 @@ export {
   shouldShow,
   splitWirePayload,
   subscribeEnvelope,
+  turnIdsMatch,
   unsubscribeEnvelope,
   validateLoopInputIntentHint,
   waitDaemonReady,