@adhdev/daemon-core 0.9.82-rc.49 → 0.9.82-rc.491

package/dist/runtime-defaults.d.ts

@@ -9,3 +9,5 @@ export declare const MIN_SESSION_HOST_DIAGNOSTICS_SUBSCRIPTION_INTERVAL_MS = 500
 export declare const DEFAULT_SESSION_HOST_DIAGNOSTICS_SUBSCRIPTION_INTERVAL_MS = 10000;
 export declare const DEFAULT_SESSION_HOST_READY_TIMEOUT_MS = 15000;
 export declare const STANDALONE_CDP_SCAN_INTERVAL_MS = 15000;
+export declare function readMeshTimeoutEnvMs(names: string | string[], defaultMs: number): number;
+export declare const MESH_CONNECT_TIMEOUT_MS: number;

package/dist/session-host/managed-host.d.ts

@@ -0,0 +1,64 @@
+import { type SessionHostEndpoint, type SessionHostRequestType } from '@adhdev/session-host-core';
+/**
+ * Shared managed-session-host process helpers.
+ *
+ * The cloud (`packages/daemon-cloud`) and standalone (`oss/packages/daemon-standalone`)
+ * daemons carried byte-for-byte copies of `buildSessionHostEnv`, `resolveSessionHostEntry`,
+ * `getSessionHostPidFile`, `killPid`, a base `stopManagedSessionHostProcess`, and the
+ * `ensureSessionHostReady` retry-wrapper. Those live here now. The pieces that genuinely
+ * differ between the two daemons (kill windowsHide, quarantine preamble, spawn stdio,
+ * required request types, cloud's socket-owner sweep) are injected via options so the
+ * observable behavior of each daemon is preserved exactly.
+ */
+export interface ManagedSessionHostOptions {
+    /** Session-host namespace (app name). Drives the socket endpoint and pidfile path. */
+    appName: string;
+    /** Capability probe: request types the host must advertise before it's considered ready. */
+    requiredRequestTypes: readonly SessionHostRequestType[];
+    /** Ready timeout for the spawn/poll loop. Defaults to the shared runtime default. */
+    timeoutMs?: number;
+    /**
+     * `killPid` on win32 uses `taskkill /T /F`. Cloud passes `windowsHide: true`; standalone
+     * historically did not. Kept as a flag to preserve each daemon's exact spawn options.
+     */
+    killWindowsHide?: boolean;
+    /**
+     * How the detached host child's stdio is wired. 'ignore' matches standalone; 'logfile'
+     * matches cloud (append to `~/.adhdev/logs/session-host.log`).
+     */
+    spawnStdio?: 'ignore' | 'logfile';
+    /**
+     * Optional preamble run at the start of `ensureReady` (before the first connect probe).
+     * Cloud uses this to quarantine legacy standalone runtime files.
+     */
+    beforeEnsureReady?: () => void;
+    /**
+     * Optional extra stop pass appended to `stopManagedSessionHostProcess`. Cloud sweeps
+     * managed session-host processes that own the default socket but predate pidfile tracking.
+     * Returns true if it stopped anything.
+     */
+    extraStop?: (endpoint: SessionHostEndpoint) => boolean;
+    /**
+     * Optional guard applied to a pidfile-tracked pid before killing it in
+     * `stopManagedSessionHostProcess`. Cloud verifies the command line is an ADHDev
+     * session-host daemon; standalone kills unconditionally (returns true here).
+     */
+    isManagedPid?: (pid: number) => boolean;
+}
+export interface ManagedSessionHost {
+    readonly appName: string;
+    readonly endpoint: SessionHostEndpoint;
+    getPidFile(): string;
+    getPid(): number | null;
+    buildEnv(baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+    resolveEntry(): string;
+    killPid(pid: number): boolean;
+    spawnHost(): void;
+    stopManagedSessionHostProcess(): boolean;
+    ensureReady(): Promise<SessionHostEndpoint>;
+    getStatusPaths(): {
+        pidFile: string;
+        endpoint: SessionHostEndpoint;
+    };
+}
+export declare function createManagedSessionHost(options: ManagedSessionHostOptions): ManagedSessionHost;

package/dist/session-host/runtime-surface.d.ts

@@ -1,16 +1,10 @@
-import type { SessionHostRecord } from '../shared-types.js';
-export type SessionHostSurfaceKind = 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
-export interface SessionHostSurfaceRecordLike {
-    lifecycle?: string | null;
-    meta?: Record<string, unknown> | null;
-}
-export declare function isSessionHostLiveRuntime(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
-export declare function getSessionHostRecoveryLabel(meta: Record<string, unknown> | null | undefined): string | null;
-export declare function isSessionHostRecoverySnapshot(record: SessionHostSurfaceRecordLike | null | undefined): boolean;
-export declare function getSessionHostSurfaceKind(record: SessionHostSurfaceRecordLike | null | undefined): SessionHostSurfaceKind;
-export declare function partitionSessionHostRecords<T extends SessionHostSurfaceRecordLike>(records: T[]): {
-    liveRuntimes: T[];
-    recoverySnapshots: T[];
-    inactiveRecords: T[];
-};
-export declare function partitionSessionHostDiagnosticsSessions(records: SessionHostRecord[] | null | undefined): ReturnType<typeof partitionSessionHostRecords<SessionHostRecord>>;
+/**
+ * Session-host runtime-surface helpers.
+ *
+ * These classification helpers (live_runtime / recovery_snapshot / inactive_record)
+ * are owned by @adhdev/session-host-core as the single source of truth. daemon-core
+ * re-exports them so consumers can keep importing from this path while the behavior
+ * (including the `record.surfaceKind` short-circuit) stays identical across packages.
+ */
+export { getSessionHostRecoveryLabel, getSessionHostSurfaceKind, isSessionHostLiveRuntime, isSessionHostRecoverySnapshot, partitionSessionHostDiagnosticsSessions, partitionSessionHostRecords, } from '@adhdev/session-host-core';
+export type { SessionHostSurfaceKind, SessionHostSurfaceRecordLike, } from '@adhdev/session-host-core';

package/dist/sessions/registry.d.ts

@@ -7,6 +7,25 @@ export interface SessionRuntimeTarget {
     cdpManagerKey?: string;
     adapterKey?: string;
     instanceKey?: string;
+    /** Working directory for CLI/ACP sessions. Used by read_chat to resolve
+     *  native history when there is no live adapter (e.g. subscription path). */
+    workspace?: string;
+    /** Wall clock at register time. native-history readers use it as a
+     *  cutoff so a fresh session can't show records from a prior one. */
+    spawnedAtMs?: number;
+    /**
+     * Authoritative provider-native conversation id for this session (SSOT).
+     * For providers that expose a session id on the CLI (codex/claude/hermes)
+     * this equals that id. For antigravity — which takes no --session-id — this
+     * is the on-disk conversations/<uuid>.db basename, discovered by the
+     * native-history dispatcher and written back here via setProviderSessionId
+     * the first time it resolves. Every downstream reader (read_chat, the
+     * completion probe, the dashboard) should prefer this over re-deriving the
+     * conversation by spawn-floor/mtime heuristics — that re-derivation is the
+     * source of the antigravity conversation crosswire/theft class. Empty until
+     * the first successful native read binds it.
+     */
+    providerSessionId?: string;
 }
 export declare class SessionRegistry {
     private readonly bySessionId;
@@ -15,6 +34,13 @@ export declare class SessionRegistry {
     private readonly byParentSessionId;
     register(target: SessionRuntimeTarget): void;
     get(sessionId: string | undefined | null): SessionRuntimeTarget | undefined;
+    /**
+     * Record the authoritative provider-native conversation id for a session
+     * (SSOT). Idempotent; a no-op when the session is unknown or the value is
+     * empty or unchanged. Never overwrites a known binding with an empty one.
+     * Returns whether the stored value changed.
+     */
+    setProviderSessionId(sessionId: string | undefined | null, providerSessionId: string | undefined | null): boolean;
     unregister(sessionId: string | undefined | null): void;
     unregisterByManagerKey(managerKey: string): void;
     unregisterByInstanceKey(instanceKey: string): void;

package/dist/shared-types-extra.d.ts

@@ -18,12 +18,10 @@ export interface RuntimeAttachedClient {
     readOnly: boolean;
 }
 /** Session status union (used by SessionEntry.status, legacy recent-launch metadata, etc.) */
-export type SessionStatus = 'idle' | 'generating' | 'waiting_approval' | 'error' | 'stopped' | 'starting' | 'panel_hidden' | 'not_monitored' | 'disconnected';
+export type SessionStatus = 'idle' | 'generating' | 'waiting_approval' | 'waiting_choice' | 'error' | 'stopped' | 'starting' | 'panel_hidden' | 'not_monitored' | 'disconnected';
 /** Inbox bucket categories for recent sessions */
 export type RecentSessionBucket = 'needs_attention' | 'working' | 'task_complete' | 'idle';
 /** Terminal backend status */
 export interface TerminalBackendStatus {
-    backend: 'xterm' | 'ghostty-vt';
-    preference: 'auto' | 'xterm' | 'ghostty-vt';
-    ghosttyAvailable: boolean;
+    backend: 'ghostty-vt';
 }

package/dist/shared-types.d.ts

@@ -7,6 +7,7 @@
  * IMPORTANT: This file must remain runtime-free (types only).
  */
 import type { StatusResponse, ChatMessage, ExtensionInfo, SystemInfo, DetectedIde, AgentEntry } from './types.js';
+import type { SessionAttachedClient as CoreSessionAttachedClient, SessionWriteOwner as CoreSessionWriteOwner, SessionHostRecord as CoreSessionHostRecord, SessionHostLogEntry as CoreSessionHostLogEntry, SessionHostRequestTrace as CoreSessionHostRequestTrace, SessionHostRuntimeTransition as CoreSessionHostRuntimeTransition, SessionHostDiagnostics as CoreSessionHostDiagnostics } from '@adhdev/session-host-core';
 export type { StatusResponse, ChatMessage, ExtensionInfo, SystemInfo, DetectedIde, AgentEntry, };
 export type { ProviderState, ProviderStatus, ActiveChatData, IdeProviderState, CliProviderState, AcpProviderState, ExtensionProviderState, ProviderEvent, } from './providers/provider-instance.js';
 export type { ProviderErrorReason } from './providers/provider-instance.js';
@@ -14,6 +15,7 @@ import type { ActiveChatData as _ActiveChatData, ProviderErrorReason as _Provide
 import type { WorkspaceEntry } from './config/workspaces.js';
 import type { ProviderMeshCoordinatorConfig, ProviderResumeCapability } from './providers/contracts.js';
 import type { GitCompactSummary, GitWorkspaceUpdate, WorkspaceGitSubscriptionParams } from './git/git-types.js';
+import type { InteractivePrompt } from './providers/types/interactive-prompt.js';
 export type { GitCommandName, GitCompactSummary, GitDiffSummary, GitFailureReason, GitFileChange, GitFileChangeStatus, GitRepoIdentity, GitRepoStatus, GitSnapshot, GitSnapshotCompareSummary, GitSnapshotReason, GitWorkspaceUpdate, WorkspaceGitSubscriptionParams, } from './git/git-types.js';
 export interface SessionActiveChatData extends Omit<_ActiveChatData, 'messages'> {
     messages?: _ActiveChatData['messages'];
@@ -49,6 +51,14 @@ export interface ReadChatSyncResult {
         message: string;
         buttons: string[];
     } | null;
+    activeInteractivePrompt?: InteractivePrompt | null;
+    /**
+     * Chat source provenance from ChatSourceMachine (A2). Carries the
+     * selected source, transition cause, lock state, and legacy
+     * fallbackReason — opaque to the daemon-core, consumed by web-core
+     * for the source debug badge and SourceTimeline (A3).
+     */
+    messageSource?: Record<string, unknown>;
 }
 export interface ProviderSummaryItem {
     id: string;
@@ -61,64 +71,37 @@ export interface ProviderSummaryItem {
 export interface ProviderSummaryMetadata {
     items: ProviderSummaryItem[];
 }
-export interface SessionHostAttachedClient {
-    clientId: string;
+/**
+ * Wire-subset session-host types.
+ *
+ * These are the shapes daemon-core / web-core see over the wire — a subset of the
+ * authoritative types owned by @adhdev/session-host-core (which additionally carry
+ * transport / category / launchCommand / buffer and stricter union typing on wire
+ * scalars). They are DERIVED from the SSOT via Pick/Omit so shared fields cannot
+ * drift; only the deliberate wire looseness (string-typed `type`/`lifecycle`,
+ * optional `meta`) is re-applied here.
+ */
+export type SessionHostAttachedClient = Omit<CoreSessionAttachedClient, 'type'> & {
+    /** Widened over the wire — the raw client-type string is not re-validated here. */
     type: string;
-    readOnly: boolean;
-    attachedAt: number;
-    lastSeenAt: number;
-}
-export interface SessionHostWriteOwner {
-    clientId: string;
-    ownerType: 'agent' | 'user';
-    acquiredAt: number;
-}
-export interface SessionHostRecord {
-    sessionId: string;
-    runtimeKey: string;
-    displayName: string;
-    workspaceLabel: string;
-    providerType: string;
-    workspace: string;
-    lifecycle: 'starting' | 'running' | 'stopping' | 'stopped' | 'failed' | 'interrupted';
-    surfaceKind?: 'live_runtime' | 'recovery_snapshot' | 'inactive_record';
+};
+export type SessionHostWriteOwner = CoreSessionWriteOwner;
+export type SessionHostRecord = Pick<CoreSessionHostRecord, 'sessionId' | 'runtimeKey' | 'displayName' | 'workspaceLabel' | 'providerType' | 'workspace' | 'lifecycle' | 'surfaceKind' | 'osPid' | 'lastActivityAt' | 'createdAt' | 'startedAt'> & {
     writeOwner: SessionHostWriteOwner | null;
     attachedClients: SessionHostAttachedClient[];
-    osPid?: number;
-    lastActivityAt: number;
-    createdAt: number;
-    startedAt?: number;
+    /** Optional over the wire — omitted when the record carries no metadata. */
     meta?: Record<string, unknown>;
-}
-export interface SessionHostLogEntry {
-    timestamp: number;
-    level: 'debug' | 'info' | 'warn' | 'error';
-    message: string;
-    sessionId?: string;
-}
-export interface SessionHostRequestTrace {
-    timestamp: number;
-    requestId: string;
+};
+export type SessionHostLogEntry = Omit<CoreSessionHostLogEntry, 'data'>;
+export type SessionHostRequestTrace = Omit<CoreSessionHostRequestTrace, 'type'> & {
+    /** Widened over the wire — the request-type union is not re-validated here. */
     type: string;
-    sessionId?: string;
-    clientId?: string;
-    success: boolean;
-    durationMs: number;
-    error?: string;
-}
-export interface SessionHostRuntimeTransition {
-    timestamp: number;
-    sessionId: string;
-    action: string;
+};
+export type SessionHostRuntimeTransition = Omit<CoreSessionHostRuntimeTransition, 'lifecycle'> & {
+    /** Widened over the wire — the lifecycle union is not re-validated here. */
     lifecycle?: string;
-    detail?: string;
-    success?: boolean;
-    error?: string;
-}
-export interface SessionHostDiagnosticsSnapshot {
-    hostStartedAt: number;
-    endpoint: string;
-    runtimeCount: number;
+};
+export type SessionHostDiagnosticsSnapshot = Omit<CoreSessionHostDiagnostics, 'supportedRequestTypes' | 'sessions' | 'liveRuntimes' | 'recoverySnapshots' | 'inactiveRecords' | 'recentLogs' | 'recentRequests' | 'recentTransitions'> & {
     sessions?: SessionHostRecord[];
     liveRuntimes?: SessionHostRecord[];
     recoverySnapshots?: SessionHostRecord[];
@@ -126,7 +109,7 @@ export interface SessionHostDiagnosticsSnapshot {
     recentLogs: SessionHostLogEntry[];
     recentRequests: SessionHostRequestTrace[];
     recentTransitions: SessionHostRuntimeTransition[];
-}
+};
 export type TransportTopic = 'session.chat_tail' | 'session.runtime_output' | 'machine.runtime' | 'session_host.diagnostics' | 'session.modal' | 'daemon.metadata' | 'workspace.git';
 export interface SessionChatTailSubscriptionParams extends ReadChatCursor {
     targetSessionId: string;
@@ -200,6 +183,18 @@ export interface DaemonMetadataUpdate {
     userName?: string;
     seq: number;
     timestamp: number;
+    /**
+     * Per-mesh state-change revision counters (meshId → monotonically increasing
+     * integer), bumped whenever the daemon's mesh graph/queue/mission state for that
+     * mesh changes (onMeshStateChange). Lets the dashboard replace its client-side
+     * mesh_status polling with an event-driven background refresh: when the revision
+     * for the mesh it is viewing advances, it re-fetches the aggregate mesh_status
+     * (SWR, keeping the current graph on screen). This is a lightweight nudge — the
+     * full aggregate snapshot is fetched on demand, not embedded here, so the
+     * daemon.metadata payload stays small. Optional/absent for daemons/builds that
+     * don't emit it (the client then keeps its polling fallback).
+     */
+    meshStateRevisions?: Record<string, number>;
 }
 export interface TopicUpdateEnvelopeMap {
     'session.chat_tail': SessionChatTailUpdate;
@@ -268,6 +263,7 @@ export interface SessionEntry {
     runtimeRecoveryState?: string | null;
     resume?: ProviderResumeCapability;
     activeChat: SessionActiveChatData | null;
+    activeInteractivePrompt?: InteractivePrompt | null;
     capabilities?: SessionCapability[];
     /** Effective message input/media support for this session. Defaults fail-closed to text-only. */
     messageInput?: MessageInputSupport;
@@ -291,7 +287,28 @@ export interface SessionEntry {
     completionMarker?: string;
     seenCompletionMarker?: string;
     surfaceHidden?: boolean;
+    /**
+     * User (or coordinator-policy) muted: suppress attention side-effects
+     * (notifications, toasts, completion audio) for this session WITHOUT removing
+     * it from the inbox list. Distinct from surfaceHidden (which collapses it from
+     * the list). Daemon-owned, in-memory; rides the status snapshot.
+     */
+    muted?: boolean;
     settings?: Record<string, any>;
+    /**
+     * True owning-daemon id for a session a coordinator synthesises into its own
+     * status snapshot (mesh delegated sessions). The dashboard attributes the session
+     * to this daemon instead of the snapshot daemon so the worker node — not the
+     * coordinator — is shown as its machine.
+     */
+    ownerDaemonId?: string;
+    /** True owning-machine display name fallback when the owning daemon is not aggregated. */
+    ownerMachineName?: string;
+    /** Set when this session is acting as a mesh coordinator for the given mesh. */
+    coordinator?: {
+        meshId: string;
+        role: 'coordinator';
+    };
     meshQueueStats?: {
         total?: number;
         active?: number;
@@ -351,6 +368,7 @@ export interface CompactSessionEntry {
     completionMarker?: string;
     seenCompletionMarker?: string;
     surfaceHidden?: boolean;
+    muted?: boolean;
     controlValues?: Record<string, string | number | boolean>;
     providerControls?: ProviderControlSchema[];
     summaryMetadata?: ProviderSummaryMetadata;
@@ -410,7 +428,37 @@ export interface AvailableProviderInfo {
     lastVerification?: MachineProviderCheckResult;
     /** Provider-declared Repo Mesh coordinator/MCP behavior. */
     meshCoordinator?: ProviderMeshCoordinatorConfig;
-}
+    /** BRAIN-ROUTING: suggested model values for the new-session model dropdown. */
+    modelOptions?: string[];
+    /** BRAIN-ROUTING: reasoning-effort values for the new-session thinking dropdown. */
+    thinkingLevelOptions?: string[];
+    /**
+     * Provider trust classification — derived from the on-disk layer the
+     * manifest came from and the shape of the manifest. Dashboards use
+     * this to render a trust badge and gate activation of
+     * `external-untrusted` providers behind a confirm modal.
+     */
+    trust?: ProviderTrust;
+    /** Daemon-side human-readable description of the trust value. */
+    trustDescription?: string;
+    /** True when activation needs a user-side confirmation step. */
+    requiresConfirmation?: boolean;
+    /** Which on-disk layer the manifest lives in. */
+    sourceLayer?: 'user' | 'upstream' | 'external';
+    /** For external providers, the source-name namespace it came from. */
+    sourceName?: string | null;
+    /** Manifest-declared version, e.g. "1.2.1". */
+    providerVersion?: string;
+    /** Underlying executable name (CLI/binary providers). */
+    binary?: string;
+    /** Lifecycle label from the manifest: "Stable", "Beta", … */
+    status?: string;
+    /** One-line provider description from the manifest. */
+    details?: string;
+    /** Manifest-declared links: homepage, docs, repo, … */
+    links?: Record<string, string>;
+}
+export type ProviderTrust = 'user-custom' | 'trusted' | 'trusted-with-scripts' | 'external-safe' | 'external-untrusted';
 export interface MachineProviderCheckResult {
     ok: boolean;
     stage?: 'detection' | 'runnable' | 'verification';
@@ -479,6 +527,13 @@ export interface ProviderControlSchema {
     order?: number;
     /** Hide this control even if it would otherwise render */
     hidden?: boolean;
+    /**
+     * FSM state ids in which this control should be visible. When omitted the
+     * control is always visible. Mirrors the daemon's click-time enforcement so
+     * the bar hides controls the daemon would silently drop. Uses raw FSM state
+     * ids (e.g. 'idle', 'busy'), not the derived dashboard status.
+     */
+    visibleWhenState?: string[];
 }
 /** Machine hardware/OS info (reported by daemon, displayed by web) */
 export interface MachineInfo {
@@ -569,7 +624,7 @@ export interface DashboardBootstrapDaemonEntry extends Partial<CloudDaemonSummar
     p2p?: StatusReportPayload['p2p'];
     timestamp?: number;
 }
-export type DaemonStatusEventName = 'agent:generating_started' | 'agent:waiting_approval' | 'agent:generating_completed' | 'agent:stopped' | 'monitor:long_generating';
+export type DaemonStatusEventName = 'agent:generating_started' | 'agent:waiting_approval' | 'agent:generating_completed' | 'agent:stopped' | 'monitor:no_progress' | 'monitor:long_generating';
 /** Minimal daemon-originated event payload relayed through the server. */
 export interface DaemonStatusEventPayload {
     event: DaemonStatusEventName;

package/dist/status/chat-tail-hot-sessions.d.ts

@@ -16,7 +16,47 @@ export declare function classifyHotChatSessionsForSubscriptionFlush(sessions: Ho
     recentMessageGraceMs?: number;
     activeStatuses?: ReadonlySet<string>;
     activeSessionIds?: ReadonlySet<string>;
+    /**
+     * Per-session `lastMessageAt` of the most recent completion tail that has
+     * already been flushed to subscribers. A completed-but-unseen session is
+     * kept hot for delivery REGARDLESS of the 8s recency timer, but only until
+     * its current tail has been delivered once — bounding the guaranteed
+     * delivery so a slow-finalizing turn is not re-pushed every tick forever.
+     * A newer `lastMessageAt` (fresh turn) re-arms delivery.
+     */
+    deliveredCompletionTailAt?: ReadonlyMap<string, number>;
+    /**
+     * (D8) PER-SUBSCRIPTION ACK gate — the authoritative guaranteed-delivery
+     * signal. Session ids for which at least one currently-subscribed ws has
+     * NOT yet been sent the session's finalized tail (its per-ws
+     * `lastDeliveredSignature` is empty / does not match the session's current
+     * tail). The daemon computes this from its live ws-subscription map; the
+     * classifier keeps every such session hot-for-delivery INDEPENDENT of the
+     * seen/unread badge, so a session whose unread badge cleared (or a fresh
+     * browser that re-subscribed after the single completion flush already
+     * fired) still gets its assistant-final tail delivered. Bounded because a
+     * subscriber's `lastDeliveredSignature` converges to the current tail the
+     * moment it is actually sent, dropping the session out of this set. When
+     * provided, this set is the guaranteed-delivery driver and the
+     * `deliveredCompletionTailAt` recency-watermark path is bypassed for these
+     * sessions (it stays only as the legacy opt-in for callers that don't pass
+     * a per-subscription set).
+     */
+    underDeliveredSessionIds?: ReadonlySet<string>;
 }): {
     active: Set<string>;
     finalizing: Set<string>;
+    guaranteedDelivery: Set<string>;
+};
+/**
+ * Detect sessions that just transitioned from an active/generating state into
+ * a settled/completed-but-unseen state, so their finalized completion tail can
+ * be flushed exactly once regardless of the recency window. Pure: the caller
+ * owns the `previousStatus` map and updates it from the returned `nextStatus`.
+ */
+export declare function detectNewlySettledCompletedSessions(sessions: HotChatSessionLike[], previousStatus: ReadonlyMap<string, string>, options?: {
+    activeStatuses?: ReadonlySet<string>;
+}): {
+    settled: Set<string>;
+    nextStatus: Map<string, string>;
 };

package/dist/status/normalize.d.ts

@@ -1,6 +1,6 @@
 import type { ActiveChatData } from '../providers/provider-instance.js';
 import type { SessionActiveChatData } from '../shared-types.js';
-export type ManagedStatus = 'idle' | 'generating' | 'waiting_approval' | 'error' | 'stopped' | 'starting' | 'panel_hidden' | 'not_monitored' | 'disconnected';
+export type ManagedStatus = 'idle' | 'generating' | 'waiting_approval' | 'waiting_choice' | 'error' | 'stopped' | 'starting' | 'panel_hidden' | 'not_monitored' | 'disconnected';
 export interface NormalizeActiveChatOptions {
     includeMessages?: boolean;
     includeInputContent?: boolean;

package/dist/status/normalize.js

@@ -119,6 +119,7 @@ function normalizeManagedStatus(status, opts) {
   if (hasApprovalButtons(opts?.activeModal)) return "waiting_approval";
   const normalized = String(status || "idle").trim().toLowerCase();
   if (normalized === "waiting_approval") return "waiting_approval";
+  if (normalized === "waiting_choice") return "waiting_choice";
   if (WORKING_STATUSES.has(normalized)) return "generating";
   if (normalized === "error") return "error";
   if (normalized === "stopped") return "stopped";

package/dist/status/normalize.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/status/normalize.ts"],"sourcesContent":["import type { ActiveChatData } from '../providers/provider-instance.js';\nimport type { SessionActiveChatData } from '../shared-types.js';\n\nexport type ManagedStatus =\n    | 'idle'\n    | 'generating'\n    | 'waiting_approval'\n    | 'error'\n    | 'stopped'\n    | 'starting'\n    | 'panel_hidden'\n    | 'not_monitored'\n    | 'disconnected';\n\nconst WORKING_STATUSES = new Set([\n    'generating',\n    'streaming',\n    'loading',\n    'loading_reference',\n    'thinking',\n    'active',\n]);\n\nexport interface NormalizeActiveChatOptions {\n    includeMessages?: boolean;\n    includeInputContent?: boolean;\n    includeActiveModal?: boolean;\n    messageLimit?: number;\n    totalBytesLimit?: number;\n    stringLimit?: number;\n    fallbackStringLimit?: number;\n}\n\n// Full snapshots are still capped, but can carry recent chat context for API/inspection use.\nconst FULL_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: true,\n    includeInputContent: true,\n    includeActiveModal: true,\n    messageLimit: 60,\n    totalBytesLimit: 96 * 1024,\n    stringLimit: 4 * 1024,\n    fallbackStringLimit: 1024,\n};\n\n// Live/metadata snapshots only need routing + UI summary. Current chat text is loaded\n// on demand via `read_chat`, and older history via `chat_history`.\nexport const LIVE_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: false,\n    includeInputContent: false,\n    includeActiveModal: false,\n    messageLimit: 0,\n    totalBytesLimit: 0,\n    stringLimit: 512,\n    fallbackStringLimit: 256,\n};\n\nconst STATUS_MODAL_MESSAGE_LIMIT = 2 * 1024;\nconst STATUS_MODAL_BUTTON_LIMIT = 120;\n\nfunction truncateString(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(0, Math.max(0, maxChars));\n    return `${value.slice(0, maxChars - 12)}...[truncated]`;\n}\n\nfunction truncateStringTail(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(value.length - Math.max(0, maxChars));\n    return `...[truncated]${value.slice(value.length - (maxChars - 12))}`;\n}\n\nfunction trimStructuredStrings(value: unknown, maxChars: number): unknown {\n    if (typeof value === 'string') return truncateString(value, maxChars);\n    if (Array.isArray(value)) return value.map((item) => trimStructuredStrings(item, maxChars));\n    if (!value || typeof value !== 'object') return value;\n    return Object.fromEntries(\n        Object.entries(value).map(([key, nested]) => [key, trimStructuredStrings(nested, maxChars)]),\n    );\n}\n\nfunction estimateBytes(value: unknown): number {\n    try {\n        return JSON.stringify(value).length;\n    } catch {\n        return String(value ?? '').length;\n    }\n}\n\nfunction trimMessageForStatus(message: unknown, stringLimit: number): unknown {\n    if (!message || typeof message !== 'object') return message;\n    return trimStructuredStrings(message, stringLimit);\n}\n\n/**\n * Collapse timestamp / createdAt into receivedAt so downstream consumers\n * only ever need to read a single canonical time field.\n */\nfunction normalizeMessageTime(message: unknown): unknown {\n    if (!message || typeof message !== 'object') return message;\n    const msg = message as Record<string, unknown>;\n    if (msg.receivedAt == null) {\n        const fallback = msg.timestamp ?? msg.createdAt;\n        if (fallback != null) {\n            const ts = typeof fallback === 'string' ? Date.parse(fallback as string) : Number(fallback);\n            if (Number.isFinite(ts) && ts > 0) msg.receivedAt = ts;\n        }\n    }\n    return msg;\n}\n\nfunction trimMessagesForStatus(\n    messages: unknown[] | null | undefined,\n    options: Required<NormalizeActiveChatOptions>,\n): unknown[] {\n    if (!options.includeMessages || options.messageLimit <= 0 || options.totalBytesLimit <= 0) return [];\n    if (!Array.isArray(messages) || messages.length === 0) return [];\n\n    const recent = messages.slice(-options.messageLimit);\n    const kept: unknown[] = [];\n    let totalBytes = 0;\n\n    for (let i = recent.length - 1; i >= 0; i -= 1) {\n        let normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.stringLimit));\n        let size = estimateBytes(normalized);\n\n        if (size > options.totalBytesLimit) {\n            normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.fallbackStringLimit));\n            size = estimateBytes(normalized);\n        }\n\n        if (kept.length > 0 && (totalBytes + size) > options.totalBytesLimit) {\n            continue;\n        }\n\n        kept.push(normalized);\n        totalBytes += size;\n    }\n\n    return kept.reverse();\n}\n\nfunction hasApprovalButtons(activeModal?: { buttons?: unknown[] | null } | null): boolean {\n    return (activeModal?.buttons?.length ?? 0) > 0;\n}\n\nexport function normalizeManagedStatus(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): ManagedStatus {\n    if (hasApprovalButtons(opts?.activeModal)) return 'waiting_approval';\n\n    const normalized = String(status || 'idle').trim().toLowerCase();\n    if (normalized === 'waiting_approval') return 'waiting_approval';\n    if (WORKING_STATUSES.has(normalized)) return 'generating';\n    if (normalized === 'error') return 'error';\n    if (normalized === 'stopped') return 'stopped';\n    if (normalized === 'starting') return 'starting';\n    if (normalized === 'panel_hidden') return 'panel_hidden';\n    if (normalized === 'not_monitored') return 'not_monitored';\n    if (normalized === 'disconnected') return 'disconnected';\n    return 'idle';\n}\n\nexport function isManagedStatusWorking(status?: string | null): boolean {\n    return normalizeManagedStatus(status) === 'generating';\n}\n\nexport function isManagedStatusWaiting(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): boolean {\n    return normalizeManagedStatus(status, opts) === 'waiting_approval';\n}\n\nexport function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(\n    activeChat: T,\n    options: NormalizeActiveChatOptions = FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n): T extends null | undefined ? T : SessionActiveChatData {\n    if (!activeChat) return activeChat as T extends null | undefined ? T : SessionActiveChatData;\n    const resolvedOptions: Required<NormalizeActiveChatOptions> = {\n        ...FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n        ...options,\n    };\n    const {\n        messages: _messages,\n        ...rest\n    } = activeChat;\n    const normalized: SessionActiveChatData = {\n        ...rest,\n        status: normalizeManagedStatus(activeChat.status, { activeModal: activeChat.activeModal }),\n        activeModal: resolvedOptions.includeActiveModal && activeChat.activeModal ? {\n            message: truncateString(activeChat.activeModal.message || '', STATUS_MODAL_MESSAGE_LIMIT),\n            buttons: (activeChat.activeModal.buttons || []).map((button) =>\n                truncateString(String(button || ''), STATUS_MODAL_BUTTON_LIMIT)\n            ),\n        } : null,\n        inputContent: resolvedOptions.includeInputContent && activeChat.inputContent\n            ? truncateString(activeChat.inputContent, 2 * 1024)\n            : undefined,\n    };\n    if (resolvedOptions.includeMessages) {\n        normalized.messages = trimMessagesForStatus(activeChat.messages, resolvedOptions) as SessionActiveChatData['messages'];\n    }\n    return normalized as T extends null | undefined ? T : SessionActiveChatData;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/status/normalize.ts"],"sourcesContent":["import type { ActiveChatData } from '../providers/provider-instance.js';\nimport type { SessionActiveChatData } from '../shared-types.js';\n\nexport type ManagedStatus =\n    | 'idle'\n    | 'generating'\n    | 'waiting_approval'\n    | 'waiting_choice'\n    | 'error'\n    | 'stopped'\n    | 'starting'\n    | 'panel_hidden'\n    | 'not_monitored'\n    | 'disconnected';\n\nconst WORKING_STATUSES = new Set([\n    'generating',\n    'streaming',\n    'loading',\n    'loading_reference',\n    'thinking',\n    'active',\n]);\n\nexport interface NormalizeActiveChatOptions {\n    includeMessages?: boolean;\n    includeInputContent?: boolean;\n    includeActiveModal?: boolean;\n    messageLimit?: number;\n    totalBytesLimit?: number;\n    stringLimit?: number;\n    fallbackStringLimit?: number;\n}\n\n// Full snapshots are still capped, but can carry recent chat context for API/inspection use.\nconst FULL_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: true,\n    includeInputContent: true,\n    includeActiveModal: true,\n    messageLimit: 60,\n    totalBytesLimit: 96 * 1024,\n    stringLimit: 4 * 1024,\n    fallbackStringLimit: 1024,\n};\n\n// Live/metadata snapshots only need routing + UI summary. Current chat text is loaded\n// on demand via `read_chat`, and older history via `chat_history`.\nexport const LIVE_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: false,\n    includeInputContent: false,\n    includeActiveModal: false,\n    messageLimit: 0,\n    totalBytesLimit: 0,\n    stringLimit: 512,\n    fallbackStringLimit: 256,\n};\n\nconst STATUS_MODAL_MESSAGE_LIMIT = 2 * 1024;\nconst STATUS_MODAL_BUTTON_LIMIT = 120;\n\nfunction truncateString(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(0, Math.max(0, maxChars));\n    return `${value.slice(0, maxChars - 12)}...[truncated]`;\n}\n\nfunction truncateStringTail(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(value.length - Math.max(0, maxChars));\n    return `...[truncated]${value.slice(value.length - (maxChars - 12))}`;\n}\n\nfunction trimStructuredStrings(value: unknown, maxChars: number): unknown {\n    if (typeof value === 'string') return truncateString(value, maxChars);\n    if (Array.isArray(value)) return value.map((item) => trimStructuredStrings(item, maxChars));\n    if (!value || typeof value !== 'object') return value;\n    return Object.fromEntries(\n        Object.entries(value).map(([key, nested]) => [key, trimStructuredStrings(nested, maxChars)]),\n    );\n}\n\nfunction estimateBytes(value: unknown): number {\n    try {\n        return JSON.stringify(value).length;\n    } catch {\n        return String(value ?? '').length;\n    }\n}\n\nfunction trimMessageForStatus(message: unknown, stringLimit: number): unknown {\n    if (!message || typeof message !== 'object') return message;\n    return trimStructuredStrings(message, stringLimit);\n}\n\n/**\n * Collapse timestamp / createdAt into receivedAt so downstream consumers\n * only ever need to read a single canonical time field.\n */\nfunction normalizeMessageTime(message: unknown): unknown {\n    if (!message || typeof message !== 'object') return message;\n    const msg = message as Record<string, unknown>;\n    if (msg.receivedAt == null) {\n        const fallback = msg.timestamp ?? msg.createdAt;\n        if (fallback != null) {\n            const ts = typeof fallback === 'string' ? Date.parse(fallback as string) : Number(fallback);\n            if (Number.isFinite(ts) && ts > 0) msg.receivedAt = ts;\n        }\n    }\n    return msg;\n}\n\nfunction trimMessagesForStatus(\n    messages: unknown[] | null | undefined,\n    options: Required<NormalizeActiveChatOptions>,\n): unknown[] {\n    if (!options.includeMessages || options.messageLimit <= 0 || options.totalBytesLimit <= 0) return [];\n    if (!Array.isArray(messages) || messages.length === 0) return [];\n\n    const recent = messages.slice(-options.messageLimit);\n    const kept: unknown[] = [];\n    let totalBytes = 0;\n\n    for (let i = recent.length - 1; i >= 0; i -= 1) {\n        let normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.stringLimit));\n        let size = estimateBytes(normalized);\n\n        if (size > options.totalBytesLimit) {\n            normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.fallbackStringLimit));\n            size = estimateBytes(normalized);\n        }\n\n        if (kept.length > 0 && (totalBytes + size) > options.totalBytesLimit) {\n            continue;\n        }\n\n        kept.push(normalized);\n        totalBytes += size;\n    }\n\n    return kept.reverse();\n}\n\nfunction hasApprovalButtons(activeModal?: { buttons?: unknown[] | null } | null): boolean {\n    return (activeModal?.buttons?.length ?? 0) > 0;\n}\n\nexport function normalizeManagedStatus(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): ManagedStatus {\n    if (hasApprovalButtons(opts?.activeModal)) return 'waiting_approval';\n\n    const normalized = String(status || 'idle').trim().toLowerCase();\n    if (normalized === 'waiting_approval') return 'waiting_approval';\n    if (normalized === 'waiting_choice') return 'waiting_choice';\n    if (WORKING_STATUSES.has(normalized)) return 'generating';\n    if (normalized === 'error') return 'error';\n    if (normalized === 'stopped') return 'stopped';\n    if (normalized === 'starting') return 'starting';\n    if (normalized === 'panel_hidden') return 'panel_hidden';\n    if (normalized === 'not_monitored') return 'not_monitored';\n    if (normalized === 'disconnected') return 'disconnected';\n    return 'idle';\n}\n\nexport function isManagedStatusWorking(status?: string | null): boolean {\n    return normalizeManagedStatus(status) === 'generating';\n}\n\nexport function isManagedStatusWaiting(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): boolean {\n    return normalizeManagedStatus(status, opts) === 'waiting_approval';\n}\n\nexport function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(\n    activeChat: T,\n    options: NormalizeActiveChatOptions = FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n): T extends null | undefined ? T : SessionActiveChatData {\n    if (!activeChat) return activeChat as T extends null | undefined ? T : SessionActiveChatData;\n    const resolvedOptions: Required<NormalizeActiveChatOptions> = {\n        ...FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n        ...options,\n    };\n    const {\n        messages: _messages,\n        ...rest\n    } = activeChat;\n    const normalized: SessionActiveChatData = {\n        ...rest,\n        status: normalizeManagedStatus(activeChat.status, { activeModal: activeChat.activeModal }),\n        activeModal: resolvedOptions.includeActiveModal && activeChat.activeModal ? {\n            message: truncateString(activeChat.activeModal.message || '', STATUS_MODAL_MESSAGE_LIMIT),\n            buttons: (activeChat.activeModal.buttons || []).map((button) =>\n                truncateString(String(button || ''), STATUS_MODAL_BUTTON_LIMIT)\n            ),\n        } : null,\n        inputContent: resolvedOptions.includeInputContent && activeChat.inputContent\n            ? truncateString(activeChat.inputContent, 2 * 1024)\n            : undefined,\n    };\n    if (resolvedOptions.includeMessages) {\n        normalized.messages = trimMessagesForStatus(activeChat.messages, resolvedOptions) as SessionActiveChatData['messages'];\n    }\n    return normalized as T extends null | undefined ? T : SessionActiveChatData;\n}\n"],"mappings":"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","names":[]}

package/dist/status/normalize.mjs

@@ -91,6 +91,7 @@ function normalizeManagedStatus(status, opts) {
   if (hasApprovalButtons(opts?.activeModal)) return "waiting_approval";
   const normalized = String(status || "idle").trim().toLowerCase();
   if (normalized === "waiting_approval") return "waiting_approval";
+  if (normalized === "waiting_choice") return "waiting_choice";
   if (WORKING_STATUSES.has(normalized)) return "generating";
   if (normalized === "error") return "error";
   if (normalized === "stopped") return "stopped";

package/dist/status/normalize.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/status/normalize.ts"],"sourcesContent":["import type { ActiveChatData } from '../providers/provider-instance.js';\nimport type { SessionActiveChatData } from '../shared-types.js';\n\nexport type ManagedStatus =\n    | 'idle'\n    | 'generating'\n    | 'waiting_approval'\n    | 'error'\n    | 'stopped'\n    | 'starting'\n    | 'panel_hidden'\n    | 'not_monitored'\n    | 'disconnected';\n\nconst WORKING_STATUSES = new Set([\n    'generating',\n    'streaming',\n    'loading',\n    'loading_reference',\n    'thinking',\n    'active',\n]);\n\nexport interface NormalizeActiveChatOptions {\n    includeMessages?: boolean;\n    includeInputContent?: boolean;\n    includeActiveModal?: boolean;\n    messageLimit?: number;\n    totalBytesLimit?: number;\n    stringLimit?: number;\n    fallbackStringLimit?: number;\n}\n\n// Full snapshots are still capped, but can carry recent chat context for API/inspection use.\nconst FULL_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: true,\n    includeInputContent: true,\n    includeActiveModal: true,\n    messageLimit: 60,\n    totalBytesLimit: 96 * 1024,\n    stringLimit: 4 * 1024,\n    fallbackStringLimit: 1024,\n};\n\n// Live/metadata snapshots only need routing + UI summary. Current chat text is loaded\n// on demand via `read_chat`, and older history via `chat_history`.\nexport const LIVE_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: false,\n    includeInputContent: false,\n    includeActiveModal: false,\n    messageLimit: 0,\n    totalBytesLimit: 0,\n    stringLimit: 512,\n    fallbackStringLimit: 256,\n};\n\nconst STATUS_MODAL_MESSAGE_LIMIT = 2 * 1024;\nconst STATUS_MODAL_BUTTON_LIMIT = 120;\n\nfunction truncateString(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(0, Math.max(0, maxChars));\n    return `${value.slice(0, maxChars - 12)}...[truncated]`;\n}\n\nfunction truncateStringTail(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(value.length - Math.max(0, maxChars));\n    return `...[truncated]${value.slice(value.length - (maxChars - 12))}`;\n}\n\nfunction trimStructuredStrings(value: unknown, maxChars: number): unknown {\n    if (typeof value === 'string') return truncateString(value, maxChars);\n    if (Array.isArray(value)) return value.map((item) => trimStructuredStrings(item, maxChars));\n    if (!value || typeof value !== 'object') return value;\n    return Object.fromEntries(\n        Object.entries(value).map(([key, nested]) => [key, trimStructuredStrings(nested, maxChars)]),\n    );\n}\n\nfunction estimateBytes(value: unknown): number {\n    try {\n        return JSON.stringify(value).length;\n    } catch {\n        return String(value ?? '').length;\n    }\n}\n\nfunction trimMessageForStatus(message: unknown, stringLimit: number): unknown {\n    if (!message || typeof message !== 'object') return message;\n    return trimStructuredStrings(message, stringLimit);\n}\n\n/**\n * Collapse timestamp / createdAt into receivedAt so downstream consumers\n * only ever need to read a single canonical time field.\n */\nfunction normalizeMessageTime(message: unknown): unknown {\n    if (!message || typeof message !== 'object') return message;\n    const msg = message as Record<string, unknown>;\n    if (msg.receivedAt == null) {\n        const fallback = msg.timestamp ?? msg.createdAt;\n        if (fallback != null) {\n            const ts = typeof fallback === 'string' ? Date.parse(fallback as string) : Number(fallback);\n            if (Number.isFinite(ts) && ts > 0) msg.receivedAt = ts;\n        }\n    }\n    return msg;\n}\n\nfunction trimMessagesForStatus(\n    messages: unknown[] | null | undefined,\n    options: Required<NormalizeActiveChatOptions>,\n): unknown[] {\n    if (!options.includeMessages || options.messageLimit <= 0 || options.totalBytesLimit <= 0) return [];\n    if (!Array.isArray(messages) || messages.length === 0) return [];\n\n    const recent = messages.slice(-options.messageLimit);\n    const kept: unknown[] = [];\n    let totalBytes = 0;\n\n    for (let i = recent.length - 1; i >= 0; i -= 1) {\n        let normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.stringLimit));\n        let size = estimateBytes(normalized);\n\n        if (size > options.totalBytesLimit) {\n            normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.fallbackStringLimit));\n            size = estimateBytes(normalized);\n        }\n\n        if (kept.length > 0 && (totalBytes + size) > options.totalBytesLimit) {\n            continue;\n        }\n\n        kept.push(normalized);\n        totalBytes += size;\n    }\n\n    return kept.reverse();\n}\n\nfunction hasApprovalButtons(activeModal?: { buttons?: unknown[] | null } | null): boolean {\n    return (activeModal?.buttons?.length ?? 0) > 0;\n}\n\nexport function normalizeManagedStatus(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): ManagedStatus {\n    if (hasApprovalButtons(opts?.activeModal)) return 'waiting_approval';\n\n    const normalized = String(status || 'idle').trim().toLowerCase();\n    if (normalized === 'waiting_approval') return 'waiting_approval';\n    if (WORKING_STATUSES.has(normalized)) return 'generating';\n    if (normalized === 'error') return 'error';\n    if (normalized === 'stopped') return 'stopped';\n    if (normalized === 'starting') return 'starting';\n    if (normalized === 'panel_hidden') return 'panel_hidden';\n    if (normalized === 'not_monitored') return 'not_monitored';\n    if (normalized === 'disconnected') return 'disconnected';\n    return 'idle';\n}\n\nexport function isManagedStatusWorking(status?: string | null): boolean {\n    return normalizeManagedStatus(status) === 'generating';\n}\n\nexport function isManagedStatusWaiting(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): boolean {\n    return normalizeManagedStatus(status, opts) === 'waiting_approval';\n}\n\nexport function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(\n    activeChat: T,\n    options: NormalizeActiveChatOptions = FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n): T extends null | undefined ? T : SessionActiveChatData {\n    if (!activeChat) return activeChat as T extends null | undefined ? T : SessionActiveChatData;\n    const resolvedOptions: Required<NormalizeActiveChatOptions> = {\n        ...FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n        ...options,\n    };\n    const {\n        messages: _messages,\n        ...rest\n    } = activeChat;\n    const normalized: SessionActiveChatData = {\n        ...rest,\n        status: normalizeManagedStatus(activeChat.status, { activeModal: activeChat.activeModal }),\n        activeModal: resolvedOptions.includeActiveModal && activeChat.activeModal ? {\n            message: truncateString(activeChat.activeModal.message || '', STATUS_MODAL_MESSAGE_LIMIT),\n            buttons: (activeChat.activeModal.buttons || []).map((button) =>\n                truncateString(String(button || ''), STATUS_MODAL_BUTTON_LIMIT)\n            ),\n        } : null,\n        inputContent: resolvedOptions.includeInputContent && activeChat.inputContent\n            ? truncateString(activeChat.inputContent, 2 * 1024)\n            : undefined,\n    };\n    if (resolvedOptions.includeMessages) {\n        normalized.messages = trimMessagesForStatus(activeChat.messages, resolvedOptions) as SessionActiveChatData['messages'];\n    }\n    return normalized as T extends null | undefined ? T : SessionActiveChatData;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/status/normalize.ts"],"sourcesContent":["import type { ActiveChatData } from '../providers/provider-instance.js';\nimport type { SessionActiveChatData } from '../shared-types.js';\n\nexport type ManagedStatus =\n    | 'idle'\n    | 'generating'\n    | 'waiting_approval'\n    | 'waiting_choice'\n    | 'error'\n    | 'stopped'\n    | 'starting'\n    | 'panel_hidden'\n    | 'not_monitored'\n    | 'disconnected';\n\nconst WORKING_STATUSES = new Set([\n    'generating',\n    'streaming',\n    'loading',\n    'loading_reference',\n    'thinking',\n    'active',\n]);\n\nexport interface NormalizeActiveChatOptions {\n    includeMessages?: boolean;\n    includeInputContent?: boolean;\n    includeActiveModal?: boolean;\n    messageLimit?: number;\n    totalBytesLimit?: number;\n    stringLimit?: number;\n    fallbackStringLimit?: number;\n}\n\n// Full snapshots are still capped, but can carry recent chat context for API/inspection use.\nconst FULL_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: true,\n    includeInputContent: true,\n    includeActiveModal: true,\n    messageLimit: 60,\n    totalBytesLimit: 96 * 1024,\n    stringLimit: 4 * 1024,\n    fallbackStringLimit: 1024,\n};\n\n// Live/metadata snapshots only need routing + UI summary. Current chat text is loaded\n// on demand via `read_chat`, and older history via `chat_history`.\nexport const LIVE_STATUS_ACTIVE_CHAT_OPTIONS: Required<NormalizeActiveChatOptions> = {\n    includeMessages: false,\n    includeInputContent: false,\n    includeActiveModal: false,\n    messageLimit: 0,\n    totalBytesLimit: 0,\n    stringLimit: 512,\n    fallbackStringLimit: 256,\n};\n\nconst STATUS_MODAL_MESSAGE_LIMIT = 2 * 1024;\nconst STATUS_MODAL_BUTTON_LIMIT = 120;\n\nfunction truncateString(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(0, Math.max(0, maxChars));\n    return `${value.slice(0, maxChars - 12)}...[truncated]`;\n}\n\nfunction truncateStringTail(value: string, maxChars: number): string {\n    if (value.length <= maxChars) return value;\n    if (maxChars <= 12) return value.slice(value.length - Math.max(0, maxChars));\n    return `...[truncated]${value.slice(value.length - (maxChars - 12))}`;\n}\n\nfunction trimStructuredStrings(value: unknown, maxChars: number): unknown {\n    if (typeof value === 'string') return truncateString(value, maxChars);\n    if (Array.isArray(value)) return value.map((item) => trimStructuredStrings(item, maxChars));\n    if (!value || typeof value !== 'object') return value;\n    return Object.fromEntries(\n        Object.entries(value).map(([key, nested]) => [key, trimStructuredStrings(nested, maxChars)]),\n    );\n}\n\nfunction estimateBytes(value: unknown): number {\n    try {\n        return JSON.stringify(value).length;\n    } catch {\n        return String(value ?? '').length;\n    }\n}\n\nfunction trimMessageForStatus(message: unknown, stringLimit: number): unknown {\n    if (!message || typeof message !== 'object') return message;\n    return trimStructuredStrings(message, stringLimit);\n}\n\n/**\n * Collapse timestamp / createdAt into receivedAt so downstream consumers\n * only ever need to read a single canonical time field.\n */\nfunction normalizeMessageTime(message: unknown): unknown {\n    if (!message || typeof message !== 'object') return message;\n    const msg = message as Record<string, unknown>;\n    if (msg.receivedAt == null) {\n        const fallback = msg.timestamp ?? msg.createdAt;\n        if (fallback != null) {\n            const ts = typeof fallback === 'string' ? Date.parse(fallback as string) : Number(fallback);\n            if (Number.isFinite(ts) && ts > 0) msg.receivedAt = ts;\n        }\n    }\n    return msg;\n}\n\nfunction trimMessagesForStatus(\n    messages: unknown[] | null | undefined,\n    options: Required<NormalizeActiveChatOptions>,\n): unknown[] {\n    if (!options.includeMessages || options.messageLimit <= 0 || options.totalBytesLimit <= 0) return [];\n    if (!Array.isArray(messages) || messages.length === 0) return [];\n\n    const recent = messages.slice(-options.messageLimit);\n    const kept: unknown[] = [];\n    let totalBytes = 0;\n\n    for (let i = recent.length - 1; i >= 0; i -= 1) {\n        let normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.stringLimit));\n        let size = estimateBytes(normalized);\n\n        if (size > options.totalBytesLimit) {\n            normalized = normalizeMessageTime(trimMessageForStatus(recent[i], options.fallbackStringLimit));\n            size = estimateBytes(normalized);\n        }\n\n        if (kept.length > 0 && (totalBytes + size) > options.totalBytesLimit) {\n            continue;\n        }\n\n        kept.push(normalized);\n        totalBytes += size;\n    }\n\n    return kept.reverse();\n}\n\nfunction hasApprovalButtons(activeModal?: { buttons?: unknown[] | null } | null): boolean {\n    return (activeModal?.buttons?.length ?? 0) > 0;\n}\n\nexport function normalizeManagedStatus(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): ManagedStatus {\n    if (hasApprovalButtons(opts?.activeModal)) return 'waiting_approval';\n\n    const normalized = String(status || 'idle').trim().toLowerCase();\n    if (normalized === 'waiting_approval') return 'waiting_approval';\n    if (normalized === 'waiting_choice') return 'waiting_choice';\n    if (WORKING_STATUSES.has(normalized)) return 'generating';\n    if (normalized === 'error') return 'error';\n    if (normalized === 'stopped') return 'stopped';\n    if (normalized === 'starting') return 'starting';\n    if (normalized === 'panel_hidden') return 'panel_hidden';\n    if (normalized === 'not_monitored') return 'not_monitored';\n    if (normalized === 'disconnected') return 'disconnected';\n    return 'idle';\n}\n\nexport function isManagedStatusWorking(status?: string | null): boolean {\n    return normalizeManagedStatus(status) === 'generating';\n}\n\nexport function isManagedStatusWaiting(\n    status?: string | null,\n    opts?: { activeModal?: { buttons?: unknown[] | null } | null },\n): boolean {\n    return normalizeManagedStatus(status, opts) === 'waiting_approval';\n}\n\nexport function normalizeActiveChatData<T extends ActiveChatData | null | undefined>(\n    activeChat: T,\n    options: NormalizeActiveChatOptions = FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n): T extends null | undefined ? T : SessionActiveChatData {\n    if (!activeChat) return activeChat as T extends null | undefined ? T : SessionActiveChatData;\n    const resolvedOptions: Required<NormalizeActiveChatOptions> = {\n        ...FULL_STATUS_ACTIVE_CHAT_OPTIONS,\n        ...options,\n    };\n    const {\n        messages: _messages,\n        ...rest\n    } = activeChat;\n    const normalized: SessionActiveChatData = {\n        ...rest,\n        status: normalizeManagedStatus(activeChat.status, { activeModal: activeChat.activeModal }),\n        activeModal: resolvedOptions.includeActiveModal && activeChat.activeModal ? {\n            message: truncateString(activeChat.activeModal.message || '', STATUS_MODAL_MESSAGE_LIMIT),\n            buttons: (activeChat.activeModal.buttons || []).map((button) =>\n                truncateString(String(button || ''), STATUS_MODAL_BUTTON_LIMIT)\n            ),\n        } : null,\n        inputContent: resolvedOptions.includeInputContent && activeChat.inputContent\n            ? truncateString(activeChat.inputContent, 2 * 1024)\n            : undefined,\n    };\n    if (resolvedOptions.includeMessages) {\n        normalized.messages = trimMessagesForStatus(activeChat.messages, resolvedOptions) as SessionActiveChatData['messages'];\n    }\n    return normalized as T extends null | undefined ? T : SessionActiveChatData;\n}\n"],"mappings":"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","names":[]}

package/dist/status/reporter.d.ts

@@ -46,6 +46,8 @@ export declare class DaemonStatusReporter {
     private lastStatusSentAt;
     private statusPendingThrottle;
     private lastP2PStatusHash;
+    private lastP2PStatusSentAt;
+    private p2pDebounceTimer;
     private lastServerStatusHash;
     private lastStatusSummary;
     private statusTimer;