@mirasoth/soothe-client 0.5.0 → 0.5.2

package/dist/index.d.cts

@@ -124,7 +124,7 @@ declare function defaultConfig(): Config;
 declare function loadConfigFromEnv(): Config;
 
 /**
- * Daemon ``loop_input`` intent_hint values (direct model turns, no agent graph).
+ * Daemon ``loop_input`` intent_hint values (non-agent turns).
  */
 /** Text-only chat completion via the configured ``default`` role. */
 declare const INTENT_HINT_TEXT_COMPLETION: "text_completion";
@@ -134,23 +134,23 @@ declare const INTENT_HINT_IMAGE_TO_TEXT: "image_to_text";
 declare const INTENT_HINT_OCR: "ocr";
 /** Embedding via the configured ``embedding`` role (text-only; JSON vector response). */
 declare const INTENT_HINT_EMBED: "embed";
-/** Supported daemon direct-model intent hints. */
+/** 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"];
+declare const REMOVED_INTENT_HINTS: readonly ["direct_llm", "quiz", "direct_model"];
 type RemovedIntentHint = (typeof REMOVED_INTENT_HINTS)[number];
 /**
- * Wire ``loop_input.intent_hint``: direct model hints or agent-path pass-through
- * (e.g. ``resume_clarification``, ``skill:foo``). Legacy ``direct_llm`` and
- * ``quiz`` are rejected before send.
+ * 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.
  */
 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", "direct_model", "text_completion", "image_to_text", "ocr", "embed", "plan_direct"];
+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];
-/** Default deliverable phases for triarch-style apps (direct hints + agent outputs). */
+/** Default deliverable phases for triarch-style apps (intent hints + agent outputs). */
 declare const DEFAULT_DELIVERABLE_PHASES: ReadonlySet<string>;
 
 /**
@@ -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.0";
+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";
@@ -460,7 +460,7 @@ interface InputOptions {
     model?: string;
     modelParams?: Record<string, unknown>;
     attachments?: Record<string, unknown>[];
-    /** Daemon direct-model hint or agent-path pass-through (resume_clarification, skill:foo). */
+    /** Daemon intent_hint or agent-path pass-through (resume_clarification, skill:foo). */
     intentHint?: LoopInputIntentHint;
     /** JSON Schema for structured output (text_completion or image_to_text). */
     responseSchema?: Record<string, unknown>;
@@ -1050,7 +1050,7 @@ interface ChatEventResult {
 /**
  * Product-specific decisions an EventClassifier needs. The DeliverablePhases
  * set is the key product knob: which message `phase` values count as
- * user-facing deliverables (triarch uses quiz, goal_completion, direct_model, and
+ * user-facing deliverables (triarch uses quiz, goal_completion, chitchat, and
  * direct intent_hint phases text_completion, image_to_text, ocr, embed;
  * other apps pass their own).
  */
@@ -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 direct-model turns).
-     * Default false keeps Continue-on-status behaviour.
+     * Standalone classify only. Prefer TurnRunner + TurnBoundary for turn end
+     * (DaemonSession contract). Default false.
      */
     treatStatusIdleAsComplete?: boolean;
 }
@@ -1113,8 +1112,8 @@ declare class EventClassifier {
     private classifyMessagesMode;
     /**
      * Extracts plain assistant text from mode="messages" events that carry a
-     * terminal AIMessage without loop-tagged phase metadata (legacy direct_llm turns
-     * before phase tagging; prefer deliverablePhases including text_completion).
+     * terminal AIMessage without loop-tagged phase metadata (prefer named
+     * deliverablePhases such as text_completion).
      */
     private messagesModeAssistantContent;
     /** soothe output/responded events that carry user-facing final text. */
@@ -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

@@ -124,7 +124,7 @@ declare function defaultConfig(): Config;
 declare function loadConfigFromEnv(): Config;
 
 /**
- * Daemon ``loop_input`` intent_hint values (direct model turns, no agent graph).
+ * Daemon ``loop_input`` intent_hint values (non-agent turns).
  */
 /** Text-only chat completion via the configured ``default`` role. */
 declare const INTENT_HINT_TEXT_COMPLETION: "text_completion";
@@ -134,23 +134,23 @@ declare const INTENT_HINT_IMAGE_TO_TEXT: "image_to_text";
 declare const INTENT_HINT_OCR: "ocr";
 /** Embedding via the configured ``embedding`` role (text-only; JSON vector response). */
 declare const INTENT_HINT_EMBED: "embed";
-/** Supported daemon direct-model intent hints. */
+/** 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"];
+declare const REMOVED_INTENT_HINTS: readonly ["direct_llm", "quiz", "direct_model"];
 type RemovedIntentHint = (typeof REMOVED_INTENT_HINTS)[number];
 /**
- * Wire ``loop_input.intent_hint``: direct model hints or agent-path pass-through
- * (e.g. ``resume_clarification``, ``skill:foo``). Legacy ``direct_llm`` and
- * ``quiz`` are rejected before send.
+ * 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.
  */
 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", "direct_model", "text_completion", "image_to_text", "ocr", "embed", "plan_direct"];
+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];
-/** Default deliverable phases for triarch-style apps (direct hints + agent outputs). */
+/** Default deliverable phases for triarch-style apps (intent hints + agent outputs). */
 declare const DEFAULT_DELIVERABLE_PHASES: ReadonlySet<string>;
 
 /**
@@ -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.0";
+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";
@@ -460,7 +460,7 @@ interface InputOptions {
     model?: string;
     modelParams?: Record<string, unknown>;
     attachments?: Record<string, unknown>[];
-    /** Daemon direct-model hint or agent-path pass-through (resume_clarification, skill:foo). */
+    /** Daemon intent_hint or agent-path pass-through (resume_clarification, skill:foo). */
     intentHint?: LoopInputIntentHint;
     /** JSON Schema for structured output (text_completion or image_to_text). */
     responseSchema?: Record<string, unknown>;
@@ -1050,7 +1050,7 @@ interface ChatEventResult {
 /**
  * Product-specific decisions an EventClassifier needs. The DeliverablePhases
  * set is the key product knob: which message `phase` values count as
- * user-facing deliverables (triarch uses quiz, goal_completion, direct_model, and
+ * user-facing deliverables (triarch uses quiz, goal_completion, chitchat, and
  * direct intent_hint phases text_completion, image_to_text, ocr, embed;
  * other apps pass their own).
  */
@@ -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 direct-model turns).
-     * Default false keeps Continue-on-status behaviour.
+     * Standalone classify only. Prefer TurnRunner + TurnBoundary for turn end
+     * (DaemonSession contract). Default false.
      */
     treatStatusIdleAsComplete?: boolean;
 }
@@ -1113,8 +1112,8 @@ declare class EventClassifier {
     private classifyMessagesMode;
     /**
      * Extracts plain assistant text from mode="messages" events that carry a
-     * terminal AIMessage without loop-tagged phase metadata (legacy direct_llm turns
-     * before phase tagging; prefer deliverablePhases including text_completion).
+     * terminal AIMessage without loop-tagged phase metadata (prefer named
+     * deliverablePhases such as text_completion).
      */
     private messagesModeAssistantContent;
     /** soothe output/responded events that carry user-facing final text. */
@@ -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-A6WGUBQE.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-UEBVV6HI.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-UEBVV6HI.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":
@@ -872,9 +874,9 @@ var EventClassifier = class {
         return this.continueResult(content);
       }
     }
-    const [directContent, directOk] = this.messagesModeAssistantContent(data);
-    if (directOk && this.isSubstantiveAssistantReply(directContent)) {
-      return this.deliverableResult(directContent, "soothe.protocol.message.direct_model");
+    const [unphasedContent, unphasedOk] = this.messagesModeAssistantContent(data);
+    if (unphasedOk) {
+      return this.continueResult(unphasedContent);
     }
     if (hasPayload && rawContent) {
       if (isTerminalMessageType(msgType) || msgType === "") {
@@ -889,8 +891,8 @@ var EventClassifier = class {
   }
   /**
    * Extracts plain assistant text from mode="messages" events that carry a
-   * terminal AIMessage without loop-tagged phase metadata (legacy direct_llm turns
-   * before phase tagging; prefer deliverablePhases including text_completion).
+   * terminal AIMessage without loop-tagged phase metadata (prefer named
+   * deliverablePhases such as text_completion).
    */
   messagesModeAssistantContent(data) {
     if (!Array.isArray(data) || data.length === 0) return ["", false];
@@ -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,