@mirasoth/soothe-client 0.5.1 → 0.5.2

package/dist/index.d.cts

@@ -167,7 +167,7 @@ declare const PROTO_VERSION = "1";
 /** Default client capabilities declared in the connection_init handshake. */
 declare const DEFAULT_CLIENT_CAPABILITIES: string[];
 /** Client version reported in the connection_init handshake. */
-declare const CLIENT_VERSION = "0.5.1";
+declare const CLIENT_VERSION = "0.5.2";
 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";
@@ -1064,9 +1064,8 @@ interface ClassifierConfig {
     /** Optional app override of the default thinking-step event allowlist. */
     thinkingStepEvents?: ReadonlySet<string>;
     /**
-     * When true, a status frame with state=idle and non-empty accumulated
-     * assistant text is DeliverableComplete (typical for intent-hint turns).
-     * Default false keeps Continue-on-status behaviour.
+     * Standalone classify only. Prefer TurnRunner + TurnBoundary for turn end
+     * (DaemonSession contract). Default false.
      */
     treatStatusIdleAsComplete?: boolean;
 }
@@ -1336,11 +1335,10 @@ declare function compactAttachments(atts: Record<string, unknown>[], opts?: Comp
  * Turn runner for appkit.
  *
  * Executes one query turn end-to-end: acquire a pooled connection, enforce
- * single-flight, send loop_input, consume the event stream, classify events,
- * resolve the deliverable, persist the reply, and broadcast completion.
+ * single-flight, send loop_input, consume the event stream, persist/broadcast.
  *
- * Supports lifecycle knobs: idle timeout, soft-complete
- * policies, attachment compaction, and stream-close soft-complete.
+ * Turn end is owned by TurnBoundary (DaemonSession.iterTurnChunks contract).
+ * EventClassifier selects content and may early-complete on deliverable phases.
  */
 
 /** Returned when a turn exceeds the configured timeout and policy is Fail. */
@@ -1430,6 +1428,32 @@ declare class TurnRunner {
     private broadcastError;
 }
 
+/**
+ * DaemonSession turn-end contract for the pool TurnRunner path.
+ * TurnRunner owns one TurnBoundary per execute; EventClassifier may
+ * early-complete on deliverable phases for UX only.
+ */
+
+declare const TURN_END_STREAM_END = "soothe.stream.end";
+declare const TURN_END_IDLE = "status.idle";
+declare const TURN_END_STOPPED = "status.stopped";
+declare class TurnLifecycleGate {
+    sawRunning: boolean;
+    sawStreamPayload: boolean;
+    sawTurnProgress: boolean;
+    observe(msg: unknown): void;
+    allowStreamEnd(): boolean;
+    allowIdleComplete(): boolean;
+}
+declare class TurnBoundary {
+    readonly gate: TurnLifecycleGate;
+    ended: boolean;
+    reason: string;
+    feed(msg: unknown): [boolean, string];
+    private mark;
+}
+declare function isDaemonTurnEndEvent(completionEvent: string): boolean;
+
 /**
  * Per-turn observability counters for daemon stream consumption.
  */
@@ -1546,4 +1570,4 @@ declare class DaemonSession {
     }): AsyncGenerator<TurnChunk>;
 }
 
-export { type Attachment, type BaseEnvelope, CLIENT_VERSION, 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, EventCardReplayBegin, EventCardReplayEnd, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventExplorerCompleted, EventExplorerMilestone, EventExplorerStarted, EventExplorerStepCompleted, 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 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, TimeoutError, TimeoutPolicy, type TurnChunk, type TurnConfig, TurnEventStats, 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, isSubagentProgressEvent, isTurnEndCustomData, isTurnProgressChunk, isValidVerbosityLevel, loadConfigFromEnv, newLoopInputMessage, newLoopNewMessage, newLoopSubscribeMessage, newRequestID, notificationEnvelope, parseNamespace, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };
+export { type Attachment, type BaseEnvelope, CLIENT_VERSION, 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, EventCardReplayBegin, EventCardReplayEnd, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventExplorerCompleted, EventExplorerMilestone, EventExplorerStarted, EventExplorerStepCompleted, 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 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, parseNamespace, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };

package/dist/index.d.ts

@@ -167,7 +167,7 @@ declare const PROTO_VERSION = "1";
 /** Default client capabilities declared in the connection_init handshake. */
 declare const DEFAULT_CLIENT_CAPABILITIES: string[];
 /** Client version reported in the connection_init handshake. */
-declare const CLIENT_VERSION = "0.5.1";
+declare const CLIENT_VERSION = "0.5.2";
 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";
@@ -1064,9 +1064,8 @@ interface ClassifierConfig {
     /** Optional app override of the default thinking-step event allowlist. */
     thinkingStepEvents?: ReadonlySet<string>;
     /**
-     * When true, a status frame with state=idle and non-empty accumulated
-     * assistant text is DeliverableComplete (typical for intent-hint turns).
-     * Default false keeps Continue-on-status behaviour.
+     * Standalone classify only. Prefer TurnRunner + TurnBoundary for turn end
+     * (DaemonSession contract). Default false.
      */
     treatStatusIdleAsComplete?: boolean;
 }
@@ -1336,11 +1335,10 @@ declare function compactAttachments(atts: Record<string, unknown>[], opts?: Comp
  * Turn runner for appkit.
  *
  * Executes one query turn end-to-end: acquire a pooled connection, enforce
- * single-flight, send loop_input, consume the event stream, classify events,
- * resolve the deliverable, persist the reply, and broadcast completion.
+ * single-flight, send loop_input, consume the event stream, persist/broadcast.
  *
- * Supports lifecycle knobs: idle timeout, soft-complete
- * policies, attachment compaction, and stream-close soft-complete.
+ * Turn end is owned by TurnBoundary (DaemonSession.iterTurnChunks contract).
+ * EventClassifier selects content and may early-complete on deliverable phases.
  */
 
 /** Returned when a turn exceeds the configured timeout and policy is Fail. */
@@ -1430,6 +1428,32 @@ declare class TurnRunner {
     private broadcastError;
 }
 
+/**
+ * DaemonSession turn-end contract for the pool TurnRunner path.
+ * TurnRunner owns one TurnBoundary per execute; EventClassifier may
+ * early-complete on deliverable phases for UX only.
+ */
+
+declare const TURN_END_STREAM_END = "soothe.stream.end";
+declare const TURN_END_IDLE = "status.idle";
+declare const TURN_END_STOPPED = "status.stopped";
+declare class TurnLifecycleGate {
+    sawRunning: boolean;
+    sawStreamPayload: boolean;
+    sawTurnProgress: boolean;
+    observe(msg: unknown): void;
+    allowStreamEnd(): boolean;
+    allowIdleComplete(): boolean;
+}
+declare class TurnBoundary {
+    readonly gate: TurnLifecycleGate;
+    ended: boolean;
+    reason: string;
+    feed(msg: unknown): [boolean, string];
+    private mark;
+}
+declare function isDaemonTurnEndEvent(completionEvent: string): boolean;
+
 /**
  * Per-turn observability counters for daemon stream consumption.
  */
@@ -1546,4 +1570,4 @@ declare class DaemonSession {
     }): AsyncGenerator<TurnChunk>;
 }
 
-export { type Attachment, type BaseEnvelope, CLIENT_VERSION, 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, EventCardReplayBegin, EventCardReplayEnd, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventExplorerCompleted, EventExplorerMilestone, EventExplorerStarted, EventExplorerStepCompleted, 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 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, TimeoutError, TimeoutPolicy, type TurnChunk, type TurnConfig, TurnEventStats, 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, isSubagentProgressEvent, isTurnEndCustomData, isTurnProgressChunk, isValidVerbosityLevel, loadConfigFromEnv, newLoopInputMessage, newLoopNewMessage, newLoopSubscribeMessage, newRequestID, notificationEnvelope, parseNamespace, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };
+export { type Attachment, type BaseEnvelope, CLIENT_VERSION, 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, EventCardReplayBegin, EventCardReplayEnd, EventClassifier, EventDeepResearchCompleted, EventDeepResearchCrawlSummary, EventDeepResearchGatherSummary, EventDeepResearchProgress, EventDeepResearchStarted, EventDeepResearchStepCompleted, EventExplorerCompleted, EventExplorerMilestone, EventExplorerStarted, EventExplorerStepCompleted, 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 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, parseNamespace, pingEnvelope, pongEnvelope, protocol1Rpc, refreshAuthToken, requestDaemonConfigReload, requestDaemonShutdown, requestEnvelope, shouldShow, splitWirePayload, subscribeEnvelope, unsubscribeEnvelope, validateLoopInputIntentHint, waitDaemonReady, waitLoopStatusWithID, waitSubscriptionConfirmed };

package/dist/index.js

@@ -86,7 +86,7 @@ import {
   subscribeEnvelope,
   unsubscribeEnvelope,
   validateLoopInputIntentHint
-} from "./chunk-R43B23MJ.js";
+} from "./chunk-NSWLUFSA.js";
 
 // src/session.ts
 async function bootstrapLoopSession(client, resumeLoopId, config, loopNew) {
@@ -289,7 +289,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-SCSBM3EL.js");
+  const { Client: Client2 } = await import("./client-YTWVWNAN.js");
   const t = timeout ?? 5e3;
   const client = new Client2(wsURL, defaultConfig());
   try {
@@ -376,7 +376,7 @@ async function fetchLoopMessages(client, loopID, opts) {
   );
 }
 async function connectedWebsocket(wsUrl, fn, timeoutMs = 3e4) {
-  const { Client: Client2 } = await import("./client-SCSBM3EL.js");
+  const { Client: Client2 } = await import("./client-YTWVWNAN.js");
   const client = new Client2(wsUrl, defaultConfig());
   const deadline = Date.now() + timeoutMs;
   try {
@@ -679,6 +679,8 @@ var EventClassifier = class {
     if (!eventType) return false;
     switch (eventType) {
       case "status.idle":
+      case "status.stopped":
+      case "soothe.stream.end":
       case "idle_timeout":
       case "query_timeout":
       case "stream_closed":
@@ -1381,6 +1383,107 @@ async function compactAttachments(atts, opts) {
   return out;
 }
 
+// src/appkit/turn_boundary.ts
+var TURN_END_STREAM_END = STREAM_END;
+var TURN_END_IDLE = "status.idle";
+var TURN_END_STOPPED = "status.stopped";
+var TurnLifecycleGate = class {
+  sawRunning = false;
+  sawStreamPayload = false;
+  sawTurnProgress = false;
+  observe(msg) {
+    const frame = normalizeFrame(msg);
+    if (!frame) return;
+    const typ = String(frame.type ?? "");
+    if (typ === "status") {
+      if (String(frame.state ?? "").trim().toLowerCase() === "running") {
+        this.sawRunning = true;
+      }
+      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;
+  }
+  allowIdleComplete() {
+    return this.sawRunning && this.sawStreamPayload;
+  }
+};
+var TurnBoundary = class {
+  gate = new TurnLifecycleGate();
+  ended = false;
+  reason = "";
+  feed(msg) {
+    if (this.ended) return [true, this.reason];
+    this.gate.observe(msg);
+    const frame = normalizeFrame(msg);
+    if (!frame) return [false, ""];
+    const typ = String(frame.type ?? "");
+    if (typ === "status") {
+      const state = String(frame.state ?? "").trim().toLowerCase();
+      if (state === "stopped" && this.gate.sawRunning) {
+        return this.mark(TURN_END_STOPPED);
+      }
+      if (state === "idle" && this.gate.allowIdleComplete()) {
+        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()) {
+        return this.mark(TURN_END_STREAM_END);
+      }
+    }
+    return [false, ""];
+  }
+  mark(reason) {
+    this.ended = true;
+    this.reason = reason;
+    return [true, reason];
+  }
+};
+function isDaemonTurnEndEvent(completionEvent) {
+  const e = (completionEvent ?? "").trim();
+  return e === TURN_END_STREAM_END || e === TURN_END_IDLE || e === TURN_END_STOPPED;
+}
+function normalizeFrame(msg) {
+  if (!msg || typeof msg !== "object") return null;
+  const m = msg;
+  if (m.type === "next") {
+    const payload = m.payload ?? {};
+    const inner = payload.data;
+    if (inner && typeof inner === "object" && inner.type === "status") {
+      return inner;
+    }
+    if (inner && typeof inner === "object" && inner.mode) {
+      return {
+        type: "event",
+        mode: inner.mode,
+        data: inner.data,
+        namespace: inner.namespace ?? payload.namespace
+      };
+    }
+    if (payload.mode) {
+      return {
+        type: "event",
+        mode: payload.mode,
+        data: payload.data,
+        namespace: payload.namespace
+      };
+    }
+    return null;
+  }
+  return m;
+}
+
 // src/appkit/turn_runner.ts
 var ErrQueryTimeout = class extends Error {
   constructor() {
@@ -1521,6 +1624,7 @@ var TurnRunner = class {
       }
       let assistantContent = "";
       const startedAt = Date.now();
+      const boundary = new TurnBoundary();
       const idleForTurn = idleTimeoutForTurn(this.cfg, (attachments?.length ?? 0) > 0);
       let idleReject = null;
       const armIdle = () => {
@@ -1613,6 +1717,7 @@ var TurnRunner = class {
         }
         idleRace = armIdle();
         const msg = res.value;
+        const [ended, endReason] = boundary.feed(msg);
         const eventResult = this.classifier.classify(msg, assistantContent);
         if (eventResult.err && eventResult.terminal === 2 /* FailedComplete */) {
           clearIdle();
@@ -1634,7 +1739,7 @@ var TurnRunner = class {
           eventResult,
           assistantContent
         );
-        if (deliverable) {
+        if (deliverable && !isDaemonTurnEndEvent(eventResult.completionEvent ?? "")) {
           clearIdle();
           await this.completeTurn(
             sessionID,
@@ -1645,6 +1750,24 @@ var TurnRunner = class {
           );
           return;
         }
+        if (ended) {
+          clearIdle();
+          if (this.classifier.isSubstantiveAssistantReply(assistantContent)) {
+            await this.completeTurn(
+              sessionID,
+              loopID,
+              assistantContent.trim(),
+              startedAt,
+              endReason
+            );
+            return;
+          }
+          const err = new Error(`turn ended (${endReason}) with no assistant content`);
+          await this.persistFailed(sessionID, loopID, err);
+          this.broadcastError(sessionID, err);
+          this.onError?.(sessionID, loopID, err);
+          throw err;
+        }
       }
     } finally {
       clearIdle();
@@ -2231,9 +2354,14 @@ export {
   StaleLoopError,
   StreamCloseFail,
   StreamCloseSoftComplete,
+  TURN_END_IDLE,
+  TURN_END_STOPPED,
+  TURN_END_STREAM_END,
   TimeoutError,
   TimeoutPolicy,
+  TurnBoundary,
   TurnEventStats,
+  TurnLifecycleGate,
   TurnRunner,
   VerbosityTier,
   authenticate,
@@ -2263,6 +2391,7 @@ export {
   inputMessageForLoop,
   isCompletionEvent,
   isDaemonLive,
+  isDaemonTurnEndEvent,
   isSubagentProgressEvent,
   isTurnEndCustomData,
   isTurnProgressChunk,