@mirasoth/soothe-client 0.5.5 → 0.5.8

package/dist/index.d.cts

@@ -136,17 +136,11 @@ declare const INTENT_HINT_OCR: "ocr";
 declare const INTENT_HINT_EMBED: "embed";
 /** Supported daemon intent_hint values for non-agent turns. */
 type IntentHint = typeof INTENT_HINT_TEXT_COMPLETION | typeof INTENT_HINT_IMAGE_TO_TEXT | typeof INTENT_HINT_OCR | typeof INTENT_HINT_EMBED;
-/** Legacy intent_hint values removed from the daemon wire contract. */
-declare const REMOVED_INTENT_HINTS: readonly ["direct_llm", "quiz", "direct_model"];
-type RemovedIntentHint = (typeof REMOVED_INTENT_HINTS)[number];
 /**
  * Wire ``loop_input.intent_hint``: intent-hint values or agent-path pass-through
- * (e.g. ``resume_clarification``, ``skill:foo``). Legacy ``direct_llm``, ``quiz``,
- * and ``direct_model`` are rejected before send.
+ * (e.g. ``resume_clarification``, ``skill:foo``).
  */
 type LoopInputIntentHint = IntentHint | (string & {});
-/** Returns an error message when ``hint`` is a removed legacy value; otherwise null. */
-declare function validateLoopInputIntentHint(hint: string): string | null;
 /** Phases emitted on ``mode=messages`` for user-visible loop assistant output. */
 declare const LOOP_ASSISTANT_OUTPUT_PHASES: readonly ["goal_completion", "quiz", "autonomous_goal", "chitchat", "text_completion", "image_to_text", "ocr", "embed", "plan_direct"];
 type LoopAssistantOutputPhase = (typeof LOOP_ASSISTANT_OUTPUT_PHASES)[number];
@@ -170,7 +164,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;
@@ -294,11 +288,8 @@ type DecodedMessage = RequestEnvelope | ResponseEnvelope | NotificationEnvelope
 interface LoopInputParams {
     loop_id: string;
     content: string;
-    autonomous?: boolean;
-    max_iterations?: number;
     preferred_subagent?: string;
-    /** @deprecated Ignored by daemon; loop_input always uses non-interactive autonomous mode. */
-    interactive?: boolean;
+    intake_scope?: "trivial" | "simple" | "complex";
     model?: string;
     model_params?: Record<string, unknown>;
     attachments?: Record<string, unknown>[];
@@ -450,11 +441,9 @@ declare function isSubagentProgressEvent(eventType: string): boolean;
 interface InputOptions {
     /** Subscribed StrangeLoop id (required for loop_input). */
     loopID?: string;
-    autonomous?: boolean;
-    maxIterations?: number;
     subagent?: string;
-    /** @deprecated Ignored by daemon; loop_input always uses non-interactive autonomous mode. */
-    interactive?: boolean;
+    /** Forced StrangeLoop intake scope (trivial|simple|complex). */
+    intakeScope?: "trivial" | "simple" | "complex";
     model?: string;
     modelParams?: Record<string, unknown>;
     attachments?: Record<string, unknown>[];
@@ -734,6 +723,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 +792,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 +876,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.
  *
@@ -1375,6 +1395,7 @@ interface TurnConfig {
 interface InputOpts {
     intentHint?: LoopInputIntentHint;
     preferredSubagent?: string;
+    intakeScope?: "trivial" | "simple" | "complex";
     responseSchema?: Record<string, unknown>;
     responseSchemaName?: string;
     responseSchemaStrict?: boolean;
@@ -1431,11 +1452,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;
@@ -1521,8 +1543,6 @@ declare class DaemonSession {
     close(): Promise<void>;
     detach(): Promise<void>;
     sendTurn(text: string, options?: {
-        autonomous?: boolean;
-        maxIterations?: number;
         preferredSubagent?: string;
         model?: string;
         modelParams?: Record<string, unknown>;
@@ -1594,4 +1614,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, type ReceiptResponseEnvelope, ReconnectError, 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, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };

package/dist/index.d.ts

@@ -136,17 +136,11 @@ declare const INTENT_HINT_OCR: "ocr";
 declare const INTENT_HINT_EMBED: "embed";
 /** Supported daemon intent_hint values for non-agent turns. */
 type IntentHint = typeof INTENT_HINT_TEXT_COMPLETION | typeof INTENT_HINT_IMAGE_TO_TEXT | typeof INTENT_HINT_OCR | typeof INTENT_HINT_EMBED;
-/** Legacy intent_hint values removed from the daemon wire contract. */
-declare const REMOVED_INTENT_HINTS: readonly ["direct_llm", "quiz", "direct_model"];
-type RemovedIntentHint = (typeof REMOVED_INTENT_HINTS)[number];
 /**
  * Wire ``loop_input.intent_hint``: intent-hint values or agent-path pass-through
- * (e.g. ``resume_clarification``, ``skill:foo``). Legacy ``direct_llm``, ``quiz``,
- * and ``direct_model`` are rejected before send.
+ * (e.g. ``resume_clarification``, ``skill:foo``).
  */
 type LoopInputIntentHint = IntentHint | (string & {});
-/** Returns an error message when ``hint`` is a removed legacy value; otherwise null. */
-declare function validateLoopInputIntentHint(hint: string): string | null;
 /** Phases emitted on ``mode=messages`` for user-visible loop assistant output. */
 declare const LOOP_ASSISTANT_OUTPUT_PHASES: readonly ["goal_completion", "quiz", "autonomous_goal", "chitchat", "text_completion", "image_to_text", "ocr", "embed", "plan_direct"];
 type LoopAssistantOutputPhase = (typeof LOOP_ASSISTANT_OUTPUT_PHASES)[number];
@@ -170,7 +164,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;
@@ -294,11 +288,8 @@ type DecodedMessage = RequestEnvelope | ResponseEnvelope | NotificationEnvelope
 interface LoopInputParams {
     loop_id: string;
     content: string;
-    autonomous?: boolean;
-    max_iterations?: number;
     preferred_subagent?: string;
-    /** @deprecated Ignored by daemon; loop_input always uses non-interactive autonomous mode. */
-    interactive?: boolean;
+    intake_scope?: "trivial" | "simple" | "complex";
     model?: string;
     model_params?: Record<string, unknown>;
     attachments?: Record<string, unknown>[];
@@ -450,11 +441,9 @@ declare function isSubagentProgressEvent(eventType: string): boolean;
 interface InputOptions {
     /** Subscribed StrangeLoop id (required for loop_input). */
     loopID?: string;
-    autonomous?: boolean;
-    maxIterations?: number;
     subagent?: string;
-    /** @deprecated Ignored by daemon; loop_input always uses non-interactive autonomous mode. */
-    interactive?: boolean;
+    /** Forced StrangeLoop intake scope (trivial|simple|complex). */
+    intakeScope?: "trivial" | "simple" | "complex";
     model?: string;
     modelParams?: Record<string, unknown>;
     attachments?: Record<string, unknown>[];
@@ -734,6 +723,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 +792,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 +876,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.
  *
@@ -1375,6 +1395,7 @@ interface TurnConfig {
 interface InputOpts {
     intentHint?: LoopInputIntentHint;
     preferredSubagent?: string;
+    intakeScope?: "trivial" | "simple" | "complex";
     responseSchema?: Record<string, unknown>;
     responseSchemaName?: string;
     responseSchemaStrict?: boolean;
@@ -1431,11 +1452,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;
@@ -1521,8 +1543,6 @@ declare class DaemonSession {
     close(): Promise<void>;
     detach(): Promise<void>;
     sendTurn(text: string, options?: {
-        autonomous?: boolean;
-        maxIterations?: number;
         preferredSubagent?: string;
         model?: string;
         modelParams?: Record<string, unknown>;
@@ -1594,4 +1614,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, type ReceiptResponseEnvelope, ReconnectError, 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, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };