@kmmao/happy-wire 0.11.7 → 0.11.8

package/dist/index.cjs

@@ -1493,10 +1493,41 @@ const sessionProgressTodoStatusSchema = z__namespace.enum([
 const sessionProgressTodoSchema = z__namespace.object({
   content: z__namespace.string(),
   status: sessionProgressTodoStatusSchema,
-  stage: z__namespace.string().optional()
+  /** SDK-native: imperative-present form shown when status is in_progress. */
+  activeForm: z__namespace.string().optional(),
+  /** Optional phase/stage label a step belongs to, e.g. "Phase 2". */
+  stage: z__namespace.string().optional(),
+  /**
+   * Carried over from SDK's `TodoWriteOutput.verificationNudgeNeeded` — SDK
+   * flags items it suspects were marked completed without verification.
+   */
+  verificationNudgeNeeded: z__namespace.boolean().optional()
 });
-const sessionProgressStateSchema = z__namespace.object({
+const sessionProgressListSchema = z__namespace.object({
+  /** Stable UUID for tab switching / explicit Agent addressing. */
+  id: z__namespace.string(),
+  /** Short human-readable label; auto-derived from first todo if absent. */
+  label: z__namespace.string().optional(),
   todos: z__namespace.array(sessionProgressTodoSchema),
+  /** Optional overall stage for this list (set via MCP). */
+  currentStage: z__namespace.string().optional(),
+  /** Optional blocker list (set via MCP). */
+  blockers: z__namespace.array(z__namespace.string()).optional(),
+  startedAt: z__namespace.number(),
+  updatedAt: z__namespace.number(),
+  /** When this list stopped being active (got pushed to history). */
+  archivedAt: z__namespace.number().optional()
+});
+const sessionProgressStateSchema = z__namespace.object({
+  /** Ordered by startedAt asc; last item is typically the active one. */
+  lists: z__namespace.array(sessionProgressListSchema).optional(),
+  /** Points at the active list within `lists`. */
+  currentListId: z__namespace.string().optional(),
+  /**
+   * Legacy flat fields. Still written for backward compat with older
+   * readers — kept in sync with `lists[currentListId]` on each update.
+   */
+  todos: z__namespace.array(sessionProgressTodoSchema).optional(),
   currentStage: z__namespace.string().optional(),
   blockers: z__namespace.array(z__namespace.string()).optional(),
   updatedAt: z__namespace.number()
@@ -1653,6 +1684,7 @@ exports.sessionEventSchema = sessionEventSchema;
 exports.sessionFileEventSchema = sessionFileEventSchema;
 exports.sessionModelUsageSchema = sessionModelUsageSchema;
 exports.sessionNeedsContinueEventSchema = sessionNeedsContinueEventSchema;
+exports.sessionProgressListSchema = sessionProgressListSchema;
 exports.sessionProgressStateSchema = sessionProgressStateSchema;
 exports.sessionProgressTodoSchema = sessionProgressTodoSchema;
 exports.sessionProgressTodoStatusSchema = sessionProgressTodoStatusSchema;

package/dist/index.d.cts

@@ -2102,9 +2102,9 @@ declare const KnowledgeEntryTypeSchema: z.ZodEnum<{
 }>;
 type KnowledgeEntryType = z.infer<typeof KnowledgeEntryTypeSchema>;
 declare const KnowledgeContributorTypeSchema: z.ZodEnum<{
-    session: "session";
     user: "user";
     supervisor: "supervisor";
+    session: "session";
 }>;
 type KnowledgeContributorType = z.infer<typeof KnowledgeContributorTypeSchema>;
 declare const KnowledgeActionSchema: z.ZodEnum<{
@@ -2116,8 +2116,8 @@ declare const KnowledgeActionSchema: z.ZodEnum<{
 type KnowledgeAction = z.infer<typeof KnowledgeActionSchema>;
 declare const KnowledgeStatusSchema: z.ZodEnum<{
     active: "active";
-    archived: "archived";
     superseded: "superseded";
+    archived: "archived";
 }>;
 type KnowledgeStatus = z.infer<typeof KnowledgeStatusSchema>;
 declare const KnowledgeConfidenceSchema: z.ZodEnum<{
@@ -2135,9 +2135,9 @@ declare const CreateKnowledgeEntryBodySchema: z.ZodObject<{
         warning: "warning";
     }>;
     contributorType: z.ZodEnum<{
-        session: "session";
         user: "user";
         supervisor: "supervisor";
+        session: "session";
     }>;
     action: z.ZodEnum<{
         create: "create";
@@ -2168,8 +2168,8 @@ type CreateKnowledgeEntryBody = z.infer<typeof CreateKnowledgeEntryBodySchema>;
 declare const UpdateKnowledgeEntryBodySchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<{
         active: "active";
-        archived: "archived";
         superseded: "superseded";
+        archived: "archived";
     }>>;
     pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodOptional<z.ZodString>;
@@ -2192,8 +2192,8 @@ declare const QueryKnowledgeParamsSchema: z.ZodObject<{
     }>>;
     status: z.ZodOptional<z.ZodEnum<{
         active: "active";
-        archived: "archived";
         superseded: "superseded";
+        archived: "archived";
     }>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     search: z.ZodOptional<z.ZodString>;
@@ -2281,8 +2281,8 @@ declare const KnowledgeChainEntrySchema: z.ZodObject<{
     }>;
     status: z.ZodEnum<{
         active: "active";
-        archived: "archived";
         superseded: "superseded";
+        archived: "archived";
     }>;
     title: z.ZodString;
     content: z.ZodString;
@@ -2314,8 +2314,8 @@ declare const KnowledgeChainResponseSchema: z.ZodObject<{
         }>;
         status: z.ZodEnum<{
             active: "active";
-            archived: "archived";
             superseded: "superseded";
+            archived: "archived";
         }>;
         title: z.ZodString;
         content: z.ZodString;
@@ -2614,10 +2614,10 @@ declare const SkillContentSchema: z.ZodObject<{
 type SkillContent = z.infer<typeof SkillContentSchema>;
 
 declare const InboxCategorySchema: z.ZodEnum<{
-    session: "session";
     supervisor: "supervisor";
     task: "task";
     trigger: "trigger";
+    session: "session";
     knowledge: "knowledge";
     system: "system";
 }>;
@@ -2631,10 +2631,10 @@ type InboxSeverity = z.infer<typeof InboxSeveritySchema>;
 declare const InboxItemSummarySchema: z.ZodObject<{
     id: z.ZodString;
     category: z.ZodEnum<{
-        session: "session";
         supervisor: "supervisor";
         task: "task";
         trigger: "trigger";
+        session: "session";
         knowledge: "knowledge";
         system: "system";
     }>;
@@ -2659,10 +2659,10 @@ declare const InboxNewItemSchema: z.ZodObject<{
     item: z.ZodObject<{
         id: z.ZodString;
         category: z.ZodEnum<{
-            session: "session";
             supervisor: "supervisor";
             task: "task";
             trigger: "trigger";
+            session: "session";
             knowledge: "knowledge";
             system: "system";
         }>;
@@ -3432,11 +3432,14 @@ declare function isTrustedRuntimeProfile(runtimeProfile: ResolvedRuntimeProfile
 /**
  * Shared schemas for live session state surfaced to the App's Progress tab.
  *
- * These are written by the Agent via MCP tools (update_progress /
- * update_session_summary) and read by the App through the encrypted
- * `Session.metadata` blob — no new server storage or migration needed.
+ * These live inside the encrypted `Session.metadata` blob — no new server
+ * storage or migration needed. Two sources feed this state:
+ *   1. CLI auto-mirror hook: captures SDK's TodoWrite tool_result and
+ *      writes todos directly (no Agent prompting required).
+ *   2. MCP tools update_progress / update_session_summary: optional
+ *      Agent-driven paths for richer fields the SDK doesn't expose.
  *
- * Keep these fields small: they ride inside the metadata envelope on every
+ * Keep fields small: they ride inside the metadata envelope on every
  * socket update, so avoid attaching large structured content here.
  */
 declare const sessionProgressTodoStatusSchema: z.ZodEnum<{
@@ -3445,6 +3448,10 @@ declare const sessionProgressTodoStatusSchema: z.ZodEnum<{
     in_progress: "in_progress";
 }>;
 type SessionProgressTodoStatus = z.infer<typeof sessionProgressTodoStatusSchema>;
+/**
+ * One checklist item. Mirrors the shape of Claude Code SDK's TodoWriteInput
+ * items, with Happy extensions (`stage`, `verificationNudgeNeeded`).
+ */
 declare const sessionProgressTodoSchema: z.ZodObject<{
     content: z.ZodString;
     status: z.ZodEnum<{
@@ -3452,14 +3459,19 @@ declare const sessionProgressTodoSchema: z.ZodObject<{
         pending: "pending";
         in_progress: "in_progress";
     }>;
+    activeForm: z.ZodOptional<z.ZodString>;
     stage: z.ZodOptional<z.ZodString>;
+    verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type SessionProgressTodo = z.infer<typeof sessionProgressTodoSchema>;
 /**
- * Live progress state. Full rewrite each update — the Agent sends the
- * complete checklist, never a delta.
+ * One task list = one "generation" of the checklist. A session can contain
+ * multiple generations across time; the auto-mirror hook partitions them
+ * by a boundary heuristic (prior list fully completed + low overlap).
  */
-declare const sessionProgressStateSchema: z.ZodObject<{
+declare const sessionProgressListSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
     todos: z.ZodArray<z.ZodObject<{
         content: z.ZodString;
         status: z.ZodEnum<{
@@ -3467,10 +3479,60 @@ declare const sessionProgressStateSchema: z.ZodObject<{
             pending: "pending";
             in_progress: "in_progress";
         }>;
+        activeForm: z.ZodOptional<z.ZodString>;
         stage: z.ZodOptional<z.ZodString>;
+        verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     currentStage: z.ZodOptional<z.ZodString>;
     blockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    startedAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    archivedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type SessionProgressList = z.infer<typeof sessionProgressListSchema>;
+/**
+ * Live progress state. Holds a list-of-lists plus a pointer to the active
+ * one.
+ *
+ * Backward compatibility: older CLI / App versions wrote flat `todos` at
+ * the top level. Readers should prefer `lists[currentListId]` when present
+ * and fall back to the legacy `todos` otherwise.
+ */
+declare const sessionProgressStateSchema: z.ZodObject<{
+    lists: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        todos: z.ZodArray<z.ZodObject<{
+            content: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                pending: "pending";
+                in_progress: "in_progress";
+            }>;
+            activeForm: z.ZodOptional<z.ZodString>;
+            stage: z.ZodOptional<z.ZodString>;
+            verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        currentStage: z.ZodOptional<z.ZodString>;
+        blockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        startedAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        archivedAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    currentListId: z.ZodOptional<z.ZodString>;
+    todos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            pending: "pending";
+            in_progress: "in_progress";
+        }>;
+        activeForm: z.ZodOptional<z.ZodString>;
+        stage: z.ZodOptional<z.ZodString>;
+        verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    currentStage: z.ZodOptional<z.ZodString>;
+    blockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     updatedAt: z.ZodNumber;
 }, z.core.$strip>;
 type SessionProgressState = z.infer<typeof sessionProgressStateSchema>;
@@ -3488,5 +3550,5 @@ declare const sessionSummaryStateSchema: z.ZodObject<{
 }, z.core.$strip>;
 type SessionSummaryState = z.infer<typeof sessionSummaryStateSchema>;
 
-export { AGENT_MSG_PRIORITIES, AGENT_MSG_STATUSES, AGENT_MSG_TYPES, AIBackendProfileSchema, AcceptBodySchema, AgentLoopSummarySchema, AgentMessageSchema, AgentMessageSummarySchema, AgentMsgTypeSchema, AnthropicConfigSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, AutoDreamProfileSummarySchema, AutomationAuditEventSummarySchema, AutomationAuditStatsSchema, AutomationCountsSchema, AutomationGuardianSummarySchema, AutomationGuardianUsageSummarySchema, AutomationJobKindSchema, AutomationJobStatusSchema, AutomationJobSummarySchema, AutomationPrioritySchema, AutomationStateSchema, AutonomyStatsRecentActionSchema, AutonomyStatsSchema, AzureOpenAIConfigSchema, BUILT_IN_AI_BACKEND_PROFILE_IDS, BootstrapProfileSummarySchema, BriefMessageSchema, BuiltInAIBackendProfileIdSchema, CodexConfigSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, CreateSkillBodySchema, CreateTaskBodySchema, CrossProjectSearchResponseSchema, CrossProjectSearchResultSchema, CustomModelSchema, DaemonStateSchema, DefaultPermissionModeSchema, EVIDENCE_KINDS, EnvironmentVariableSchema, InboxCategorySchema, InboxItemSummarySchema, InboxNewItemSchema, InboxSeveritySchema, InboxUnreadCountSchema, KnowledgeActionSchema, KnowledgeChainEntrySchema, KnowledgeChainRelationSchema, KnowledgeChainResponseSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, OpenAIConfigSchema, ProfileCompatibilitySchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION, ResolvedRuntimeProfileSchema, RuntimeProfileSourceSchema, RuntimeProfileTrustSchema, SUGGESTION_ACCEPT_AUDIT_RULES, SUGGESTION_ACCEPT_SOURCES, SUGGESTION_AUTO_ACCEPT_FAILURE_DETAILS, SUGGESTION_AUTO_ACCEPT_REASON_CODES, SUGGESTION_AUTO_ACCEPT_STATUSES, SUGGESTION_BUCKETS, SUGGESTION_STATUSES, SUGGESTION_TYPES, SUPERVISOR_MODES, SessionEventCreatedSchema, SessionEventReportSchema, SessionEventSummarySchema, SessionEventTypeSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, SkillContentSchema, SkillSummarySchema, SuggestionAcceptAuditSchema, SuggestionDecisionPayloadSchema, SuggestionEvidenceSchema, SuggestionGoalPayloadSchema, SuggestionPayloadSchema, SuggestionSkillPayloadSchema, SuggestionTaskPayloadSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TaskOutcomeSchema, TaskPrioritySchema, TaskStatusChangedSchema, TaskStatusReportSchema, TaskStatusSchema, TaskSummarySchema, TaskTriggerDataSchema, TaskTriggerTypeSchema, TmuxConfigSchema, TogetherAIConfigSchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UpdateSkillBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, VoiceTokenAllowedSchema, VoiceTokenDeniedSchema, VoiceTokenResponseSchema, WorldAutonomyPolicySchema, WorldSuggestionUpdatedSchema, createEnvelope, createResolvedRuntimeProfile, getProfileEnvironmentVariables, getSuggestionPayloadSchema, isTrustedRuntimeProfile, normalizeResolvedRuntimeProfile, sessionContextUsageCategorySchema, sessionContextUsageEventSchema, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionProgressStateSchema, sessionProgressTodoSchema, sessionProgressTodoStatusSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionSummaryStateSchema, sessionTaskEndEventSchema, sessionTaskLogEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextDeltaEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema, terminalCloseRequestSchema, terminalExitPayloadSchema, terminalInputPayloadSchema, terminalOutputPayloadSchema, terminalResizeRequestSchema, terminalSpawnRequestSchema, terminalSpawnResponseSchema, validateProfileForAgent };
-export type { AIBackendProfile, AcceptBody, AgentLoopSummary, AgentMessage, AgentMessageSummary, AgentMsgPriority, AgentMsgStatus, AgentMsgType, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, AutoDreamProfileSummary, AutomationAuditEventSummary, AutomationAuditStats, AutomationCounts, AutomationGuardianSummary, AutomationGuardianUsageSummary, AutomationJobKind, AutomationJobStatus, AutomationJobSummary, AutomationPriority, AutomationState, AutonomyStats, BootstrapProfileSummary, BriefMessage, BuiltInAIBackendProfileId, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, CreateKnowledgeEntryBody, CreateSkillBody, CreateTaskBody, CrossProjectSearchResponse, CrossProjectSearchResult, DaemonState, InboxCategory, InboxItemSummary, InboxNewItem, InboxSeverity, InboxUnreadCount, KnowledgeAction, KnowledgeChainEntry, KnowledgeChainRelation, KnowledgeChainResponse, KnowledgeConfidence, KnowledgeContributorType, KnowledgeEntryType, KnowledgeInjectionMode, KnowledgeInjectionRequest, KnowledgeInjectionResponse, KnowledgeStatus, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, ProjectProfile, QueryKnowledgeParams, ResolvedRuntimeProfile, RuntimeProfileSource, RuntimeProfileTrust, SessionContextUsageEvent, SessionEnvelope, SessionEvent, SessionEventCreated, SessionEventReport, SessionEventSummary, SessionEventType, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProgressState, SessionProgressTodo, SessionProgressTodoStatus, SessionProtocolMessage, SessionRole, SessionSummaryState, SessionTurnEndStatus, SkillContent, SkillSummary, SuggestionAcceptAudit, SuggestionAcceptAuditRule, SuggestionAcceptSource, SuggestionAutoAcceptFailureDetail, SuggestionAutoAcceptReasonCode, SuggestionAutoAcceptStatus, SuggestionBucket, SuggestionDecisionPayload, SuggestionEvidence, SuggestionGoalPayload, SuggestionPayload, SuggestionSerialized, SuggestionSkillPayload, SuggestionStatus, SuggestionSummary, SuggestionTaskPayload, SuggestionType, SupervisorMode, TailscaleInfo, TailscaleServeEntry, TaskOutcome, TaskPriority, TaskStatus, TaskStatusChanged, TaskStatusReport, TaskSummary, TaskTriggerData, TaskTriggerType, TerminalCloseRequest, TerminalExitPayload, TerminalInputPayload, TerminalOutputPayload, TerminalResizeRequest, TerminalSpawnRequest, TerminalSpawnResponse, TunnelEntry, TunnelProviderInfo, TunnelState, TurnKnowledgeExtraction, Update, UpdateBody, UpdateKnowledgeEntryBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UpdateSkillBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue, VoiceTokenResponse, WorldAutonomyPolicy, WorldSuggestionUpdated };
+export { AGENT_MSG_PRIORITIES, AGENT_MSG_STATUSES, AGENT_MSG_TYPES, AIBackendProfileSchema, AcceptBodySchema, AgentLoopSummarySchema, AgentMessageSchema, AgentMessageSummarySchema, AgentMsgTypeSchema, AnthropicConfigSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, AutoDreamProfileSummarySchema, AutomationAuditEventSummarySchema, AutomationAuditStatsSchema, AutomationCountsSchema, AutomationGuardianSummarySchema, AutomationGuardianUsageSummarySchema, AutomationJobKindSchema, AutomationJobStatusSchema, AutomationJobSummarySchema, AutomationPrioritySchema, AutomationStateSchema, AutonomyStatsRecentActionSchema, AutonomyStatsSchema, AzureOpenAIConfigSchema, BUILT_IN_AI_BACKEND_PROFILE_IDS, BootstrapProfileSummarySchema, BriefMessageSchema, BuiltInAIBackendProfileIdSchema, CodexConfigSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, CreateSkillBodySchema, CreateTaskBodySchema, CrossProjectSearchResponseSchema, CrossProjectSearchResultSchema, CustomModelSchema, DaemonStateSchema, DefaultPermissionModeSchema, EVIDENCE_KINDS, EnvironmentVariableSchema, InboxCategorySchema, InboxItemSummarySchema, InboxNewItemSchema, InboxSeveritySchema, InboxUnreadCountSchema, KnowledgeActionSchema, KnowledgeChainEntrySchema, KnowledgeChainRelationSchema, KnowledgeChainResponseSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, OpenAIConfigSchema, ProfileCompatibilitySchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION, ResolvedRuntimeProfileSchema, RuntimeProfileSourceSchema, RuntimeProfileTrustSchema, SUGGESTION_ACCEPT_AUDIT_RULES, SUGGESTION_ACCEPT_SOURCES, SUGGESTION_AUTO_ACCEPT_FAILURE_DETAILS, SUGGESTION_AUTO_ACCEPT_REASON_CODES, SUGGESTION_AUTO_ACCEPT_STATUSES, SUGGESTION_BUCKETS, SUGGESTION_STATUSES, SUGGESTION_TYPES, SUPERVISOR_MODES, SessionEventCreatedSchema, SessionEventReportSchema, SessionEventSummarySchema, SessionEventTypeSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, SkillContentSchema, SkillSummarySchema, SuggestionAcceptAuditSchema, SuggestionDecisionPayloadSchema, SuggestionEvidenceSchema, SuggestionGoalPayloadSchema, SuggestionPayloadSchema, SuggestionSkillPayloadSchema, SuggestionTaskPayloadSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TaskOutcomeSchema, TaskPrioritySchema, TaskStatusChangedSchema, TaskStatusReportSchema, TaskStatusSchema, TaskSummarySchema, TaskTriggerDataSchema, TaskTriggerTypeSchema, TmuxConfigSchema, TogetherAIConfigSchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UpdateSkillBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, VoiceTokenAllowedSchema, VoiceTokenDeniedSchema, VoiceTokenResponseSchema, WorldAutonomyPolicySchema, WorldSuggestionUpdatedSchema, createEnvelope, createResolvedRuntimeProfile, getProfileEnvironmentVariables, getSuggestionPayloadSchema, isTrustedRuntimeProfile, normalizeResolvedRuntimeProfile, sessionContextUsageCategorySchema, sessionContextUsageEventSchema, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionProgressListSchema, sessionProgressStateSchema, sessionProgressTodoSchema, sessionProgressTodoStatusSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionSummaryStateSchema, sessionTaskEndEventSchema, sessionTaskLogEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextDeltaEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema, terminalCloseRequestSchema, terminalExitPayloadSchema, terminalInputPayloadSchema, terminalOutputPayloadSchema, terminalResizeRequestSchema, terminalSpawnRequestSchema, terminalSpawnResponseSchema, validateProfileForAgent };
+export type { AIBackendProfile, AcceptBody, AgentLoopSummary, AgentMessage, AgentMessageSummary, AgentMsgPriority, AgentMsgStatus, AgentMsgType, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, AutoDreamProfileSummary, AutomationAuditEventSummary, AutomationAuditStats, AutomationCounts, AutomationGuardianSummary, AutomationGuardianUsageSummary, AutomationJobKind, AutomationJobStatus, AutomationJobSummary, AutomationPriority, AutomationState, AutonomyStats, BootstrapProfileSummary, BriefMessage, BuiltInAIBackendProfileId, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, CreateKnowledgeEntryBody, CreateSkillBody, CreateTaskBody, CrossProjectSearchResponse, CrossProjectSearchResult, DaemonState, InboxCategory, InboxItemSummary, InboxNewItem, InboxSeverity, InboxUnreadCount, KnowledgeAction, KnowledgeChainEntry, KnowledgeChainRelation, KnowledgeChainResponse, KnowledgeConfidence, KnowledgeContributorType, KnowledgeEntryType, KnowledgeInjectionMode, KnowledgeInjectionRequest, KnowledgeInjectionResponse, KnowledgeStatus, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, ProjectProfile, QueryKnowledgeParams, ResolvedRuntimeProfile, RuntimeProfileSource, RuntimeProfileTrust, SessionContextUsageEvent, SessionEnvelope, SessionEvent, SessionEventCreated, SessionEventReport, SessionEventSummary, SessionEventType, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProgressList, SessionProgressState, SessionProgressTodo, SessionProgressTodoStatus, SessionProtocolMessage, SessionRole, SessionSummaryState, SessionTurnEndStatus, SkillContent, SkillSummary, SuggestionAcceptAudit, SuggestionAcceptAuditRule, SuggestionAcceptSource, SuggestionAutoAcceptFailureDetail, SuggestionAutoAcceptReasonCode, SuggestionAutoAcceptStatus, SuggestionBucket, SuggestionDecisionPayload, SuggestionEvidence, SuggestionGoalPayload, SuggestionPayload, SuggestionSerialized, SuggestionSkillPayload, SuggestionStatus, SuggestionSummary, SuggestionTaskPayload, SuggestionType, SupervisorMode, TailscaleInfo, TailscaleServeEntry, TaskOutcome, TaskPriority, TaskStatus, TaskStatusChanged, TaskStatusReport, TaskSummary, TaskTriggerData, TaskTriggerType, TerminalCloseRequest, TerminalExitPayload, TerminalInputPayload, TerminalOutputPayload, TerminalResizeRequest, TerminalSpawnRequest, TerminalSpawnResponse, TunnelEntry, TunnelProviderInfo, TunnelState, TurnKnowledgeExtraction, Update, UpdateBody, UpdateKnowledgeEntryBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UpdateSkillBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue, VoiceTokenResponse, WorldAutonomyPolicy, WorldSuggestionUpdated };

package/dist/index.d.mts

@@ -2102,9 +2102,9 @@ declare const KnowledgeEntryTypeSchema: z.ZodEnum<{
 }>;
 type KnowledgeEntryType = z.infer<typeof KnowledgeEntryTypeSchema>;
 declare const KnowledgeContributorTypeSchema: z.ZodEnum<{
-    session: "session";
     user: "user";
     supervisor: "supervisor";
+    session: "session";
 }>;
 type KnowledgeContributorType = z.infer<typeof KnowledgeContributorTypeSchema>;
 declare const KnowledgeActionSchema: z.ZodEnum<{
@@ -2116,8 +2116,8 @@ declare const KnowledgeActionSchema: z.ZodEnum<{
 type KnowledgeAction = z.infer<typeof KnowledgeActionSchema>;
 declare const KnowledgeStatusSchema: z.ZodEnum<{
     active: "active";
-    archived: "archived";
     superseded: "superseded";
+    archived: "archived";
 }>;
 type KnowledgeStatus = z.infer<typeof KnowledgeStatusSchema>;
 declare const KnowledgeConfidenceSchema: z.ZodEnum<{
@@ -2135,9 +2135,9 @@ declare const CreateKnowledgeEntryBodySchema: z.ZodObject<{
         warning: "warning";
     }>;
     contributorType: z.ZodEnum<{
-        session: "session";
         user: "user";
         supervisor: "supervisor";
+        session: "session";
     }>;
     action: z.ZodEnum<{
         create: "create";
@@ -2168,8 +2168,8 @@ type CreateKnowledgeEntryBody = z.infer<typeof CreateKnowledgeEntryBodySchema>;
 declare const UpdateKnowledgeEntryBodySchema: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<{
         active: "active";
-        archived: "archived";
         superseded: "superseded";
+        archived: "archived";
     }>>;
     pinned: z.ZodOptional<z.ZodBoolean>;
     title: z.ZodOptional<z.ZodString>;
@@ -2192,8 +2192,8 @@ declare const QueryKnowledgeParamsSchema: z.ZodObject<{
     }>>;
     status: z.ZodOptional<z.ZodEnum<{
         active: "active";
-        archived: "archived";
         superseded: "superseded";
+        archived: "archived";
     }>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
     search: z.ZodOptional<z.ZodString>;
@@ -2281,8 +2281,8 @@ declare const KnowledgeChainEntrySchema: z.ZodObject<{
     }>;
     status: z.ZodEnum<{
         active: "active";
-        archived: "archived";
         superseded: "superseded";
+        archived: "archived";
     }>;
     title: z.ZodString;
     content: z.ZodString;
@@ -2314,8 +2314,8 @@ declare const KnowledgeChainResponseSchema: z.ZodObject<{
         }>;
         status: z.ZodEnum<{
             active: "active";
-            archived: "archived";
             superseded: "superseded";
+            archived: "archived";
         }>;
         title: z.ZodString;
         content: z.ZodString;
@@ -2614,10 +2614,10 @@ declare const SkillContentSchema: z.ZodObject<{
 type SkillContent = z.infer<typeof SkillContentSchema>;
 
 declare const InboxCategorySchema: z.ZodEnum<{
-    session: "session";
     supervisor: "supervisor";
     task: "task";
     trigger: "trigger";
+    session: "session";
     knowledge: "knowledge";
     system: "system";
 }>;
@@ -2631,10 +2631,10 @@ type InboxSeverity = z.infer<typeof InboxSeveritySchema>;
 declare const InboxItemSummarySchema: z.ZodObject<{
     id: z.ZodString;
     category: z.ZodEnum<{
-        session: "session";
         supervisor: "supervisor";
         task: "task";
         trigger: "trigger";
+        session: "session";
         knowledge: "knowledge";
         system: "system";
     }>;
@@ -2659,10 +2659,10 @@ declare const InboxNewItemSchema: z.ZodObject<{
     item: z.ZodObject<{
         id: z.ZodString;
         category: z.ZodEnum<{
-            session: "session";
             supervisor: "supervisor";
             task: "task";
             trigger: "trigger";
+            session: "session";
             knowledge: "knowledge";
             system: "system";
         }>;
@@ -3432,11 +3432,14 @@ declare function isTrustedRuntimeProfile(runtimeProfile: ResolvedRuntimeProfile
 /**
  * Shared schemas for live session state surfaced to the App's Progress tab.
  *
- * These are written by the Agent via MCP tools (update_progress /
- * update_session_summary) and read by the App through the encrypted
- * `Session.metadata` blob — no new server storage or migration needed.
+ * These live inside the encrypted `Session.metadata` blob — no new server
+ * storage or migration needed. Two sources feed this state:
+ *   1. CLI auto-mirror hook: captures SDK's TodoWrite tool_result and
+ *      writes todos directly (no Agent prompting required).
+ *   2. MCP tools update_progress / update_session_summary: optional
+ *      Agent-driven paths for richer fields the SDK doesn't expose.
  *
- * Keep these fields small: they ride inside the metadata envelope on every
+ * Keep fields small: they ride inside the metadata envelope on every
  * socket update, so avoid attaching large structured content here.
  */
 declare const sessionProgressTodoStatusSchema: z.ZodEnum<{
@@ -3445,6 +3448,10 @@ declare const sessionProgressTodoStatusSchema: z.ZodEnum<{
     in_progress: "in_progress";
 }>;
 type SessionProgressTodoStatus = z.infer<typeof sessionProgressTodoStatusSchema>;
+/**
+ * One checklist item. Mirrors the shape of Claude Code SDK's TodoWriteInput
+ * items, with Happy extensions (`stage`, `verificationNudgeNeeded`).
+ */
 declare const sessionProgressTodoSchema: z.ZodObject<{
     content: z.ZodString;
     status: z.ZodEnum<{
@@ -3452,14 +3459,19 @@ declare const sessionProgressTodoSchema: z.ZodObject<{
         pending: "pending";
         in_progress: "in_progress";
     }>;
+    activeForm: z.ZodOptional<z.ZodString>;
     stage: z.ZodOptional<z.ZodString>;
+    verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 type SessionProgressTodo = z.infer<typeof sessionProgressTodoSchema>;
 /**
- * Live progress state. Full rewrite each update — the Agent sends the
- * complete checklist, never a delta.
+ * One task list = one "generation" of the checklist. A session can contain
+ * multiple generations across time; the auto-mirror hook partitions them
+ * by a boundary heuristic (prior list fully completed + low overlap).
  */
-declare const sessionProgressStateSchema: z.ZodObject<{
+declare const sessionProgressListSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
     todos: z.ZodArray<z.ZodObject<{
         content: z.ZodString;
         status: z.ZodEnum<{
@@ -3467,10 +3479,60 @@ declare const sessionProgressStateSchema: z.ZodObject<{
             pending: "pending";
             in_progress: "in_progress";
         }>;
+        activeForm: z.ZodOptional<z.ZodString>;
         stage: z.ZodOptional<z.ZodString>;
+        verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
     currentStage: z.ZodOptional<z.ZodString>;
     blockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    startedAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    archivedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type SessionProgressList = z.infer<typeof sessionProgressListSchema>;
+/**
+ * Live progress state. Holds a list-of-lists plus a pointer to the active
+ * one.
+ *
+ * Backward compatibility: older CLI / App versions wrote flat `todos` at
+ * the top level. Readers should prefer `lists[currentListId]` when present
+ * and fall back to the legacy `todos` otherwise.
+ */
+declare const sessionProgressStateSchema: z.ZodObject<{
+    lists: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        todos: z.ZodArray<z.ZodObject<{
+            content: z.ZodString;
+            status: z.ZodEnum<{
+                completed: "completed";
+                pending: "pending";
+                in_progress: "in_progress";
+            }>;
+            activeForm: z.ZodOptional<z.ZodString>;
+            stage: z.ZodOptional<z.ZodString>;
+            verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        currentStage: z.ZodOptional<z.ZodString>;
+        blockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        startedAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        archivedAt: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    currentListId: z.ZodOptional<z.ZodString>;
+    todos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        status: z.ZodEnum<{
+            completed: "completed";
+            pending: "pending";
+            in_progress: "in_progress";
+        }>;
+        activeForm: z.ZodOptional<z.ZodString>;
+        stage: z.ZodOptional<z.ZodString>;
+        verificationNudgeNeeded: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    currentStage: z.ZodOptional<z.ZodString>;
+    blockers: z.ZodOptional<z.ZodArray<z.ZodString>>;
     updatedAt: z.ZodNumber;
 }, z.core.$strip>;
 type SessionProgressState = z.infer<typeof sessionProgressStateSchema>;
@@ -3488,5 +3550,5 @@ declare const sessionSummaryStateSchema: z.ZodObject<{
 }, z.core.$strip>;
 type SessionSummaryState = z.infer<typeof sessionSummaryStateSchema>;
 
-export { AGENT_MSG_PRIORITIES, AGENT_MSG_STATUSES, AGENT_MSG_TYPES, AIBackendProfileSchema, AcceptBodySchema, AgentLoopSummarySchema, AgentMessageSchema, AgentMessageSummarySchema, AgentMsgTypeSchema, AnthropicConfigSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, AutoDreamProfileSummarySchema, AutomationAuditEventSummarySchema, AutomationAuditStatsSchema, AutomationCountsSchema, AutomationGuardianSummarySchema, AutomationGuardianUsageSummarySchema, AutomationJobKindSchema, AutomationJobStatusSchema, AutomationJobSummarySchema, AutomationPrioritySchema, AutomationStateSchema, AutonomyStatsRecentActionSchema, AutonomyStatsSchema, AzureOpenAIConfigSchema, BUILT_IN_AI_BACKEND_PROFILE_IDS, BootstrapProfileSummarySchema, BriefMessageSchema, BuiltInAIBackendProfileIdSchema, CodexConfigSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, CreateSkillBodySchema, CreateTaskBodySchema, CrossProjectSearchResponseSchema, CrossProjectSearchResultSchema, CustomModelSchema, DaemonStateSchema, DefaultPermissionModeSchema, EVIDENCE_KINDS, EnvironmentVariableSchema, InboxCategorySchema, InboxItemSummarySchema, InboxNewItemSchema, InboxSeveritySchema, InboxUnreadCountSchema, KnowledgeActionSchema, KnowledgeChainEntrySchema, KnowledgeChainRelationSchema, KnowledgeChainResponseSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, OpenAIConfigSchema, ProfileCompatibilitySchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION, ResolvedRuntimeProfileSchema, RuntimeProfileSourceSchema, RuntimeProfileTrustSchema, SUGGESTION_ACCEPT_AUDIT_RULES, SUGGESTION_ACCEPT_SOURCES, SUGGESTION_AUTO_ACCEPT_FAILURE_DETAILS, SUGGESTION_AUTO_ACCEPT_REASON_CODES, SUGGESTION_AUTO_ACCEPT_STATUSES, SUGGESTION_BUCKETS, SUGGESTION_STATUSES, SUGGESTION_TYPES, SUPERVISOR_MODES, SessionEventCreatedSchema, SessionEventReportSchema, SessionEventSummarySchema, SessionEventTypeSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, SkillContentSchema, SkillSummarySchema, SuggestionAcceptAuditSchema, SuggestionDecisionPayloadSchema, SuggestionEvidenceSchema, SuggestionGoalPayloadSchema, SuggestionPayloadSchema, SuggestionSkillPayloadSchema, SuggestionTaskPayloadSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TaskOutcomeSchema, TaskPrioritySchema, TaskStatusChangedSchema, TaskStatusReportSchema, TaskStatusSchema, TaskSummarySchema, TaskTriggerDataSchema, TaskTriggerTypeSchema, TmuxConfigSchema, TogetherAIConfigSchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UpdateSkillBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, VoiceTokenAllowedSchema, VoiceTokenDeniedSchema, VoiceTokenResponseSchema, WorldAutonomyPolicySchema, WorldSuggestionUpdatedSchema, createEnvelope, createResolvedRuntimeProfile, getProfileEnvironmentVariables, getSuggestionPayloadSchema, isTrustedRuntimeProfile, normalizeResolvedRuntimeProfile, sessionContextUsageCategorySchema, sessionContextUsageEventSchema, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionProgressStateSchema, sessionProgressTodoSchema, sessionProgressTodoStatusSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionSummaryStateSchema, sessionTaskEndEventSchema, sessionTaskLogEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextDeltaEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema, terminalCloseRequestSchema, terminalExitPayloadSchema, terminalInputPayloadSchema, terminalOutputPayloadSchema, terminalResizeRequestSchema, terminalSpawnRequestSchema, terminalSpawnResponseSchema, validateProfileForAgent };
-export type { AIBackendProfile, AcceptBody, AgentLoopSummary, AgentMessage, AgentMessageSummary, AgentMsgPriority, AgentMsgStatus, AgentMsgType, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, AutoDreamProfileSummary, AutomationAuditEventSummary, AutomationAuditStats, AutomationCounts, AutomationGuardianSummary, AutomationGuardianUsageSummary, AutomationJobKind, AutomationJobStatus, AutomationJobSummary, AutomationPriority, AutomationState, AutonomyStats, BootstrapProfileSummary, BriefMessage, BuiltInAIBackendProfileId, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, CreateKnowledgeEntryBody, CreateSkillBody, CreateTaskBody, CrossProjectSearchResponse, CrossProjectSearchResult, DaemonState, InboxCategory, InboxItemSummary, InboxNewItem, InboxSeverity, InboxUnreadCount, KnowledgeAction, KnowledgeChainEntry, KnowledgeChainRelation, KnowledgeChainResponse, KnowledgeConfidence, KnowledgeContributorType, KnowledgeEntryType, KnowledgeInjectionMode, KnowledgeInjectionRequest, KnowledgeInjectionResponse, KnowledgeStatus, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, ProjectProfile, QueryKnowledgeParams, ResolvedRuntimeProfile, RuntimeProfileSource, RuntimeProfileTrust, SessionContextUsageEvent, SessionEnvelope, SessionEvent, SessionEventCreated, SessionEventReport, SessionEventSummary, SessionEventType, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProgressState, SessionProgressTodo, SessionProgressTodoStatus, SessionProtocolMessage, SessionRole, SessionSummaryState, SessionTurnEndStatus, SkillContent, SkillSummary, SuggestionAcceptAudit, SuggestionAcceptAuditRule, SuggestionAcceptSource, SuggestionAutoAcceptFailureDetail, SuggestionAutoAcceptReasonCode, SuggestionAutoAcceptStatus, SuggestionBucket, SuggestionDecisionPayload, SuggestionEvidence, SuggestionGoalPayload, SuggestionPayload, SuggestionSerialized, SuggestionSkillPayload, SuggestionStatus, SuggestionSummary, SuggestionTaskPayload, SuggestionType, SupervisorMode, TailscaleInfo, TailscaleServeEntry, TaskOutcome, TaskPriority, TaskStatus, TaskStatusChanged, TaskStatusReport, TaskSummary, TaskTriggerData, TaskTriggerType, TerminalCloseRequest, TerminalExitPayload, TerminalInputPayload, TerminalOutputPayload, TerminalResizeRequest, TerminalSpawnRequest, TerminalSpawnResponse, TunnelEntry, TunnelProviderInfo, TunnelState, TurnKnowledgeExtraction, Update, UpdateBody, UpdateKnowledgeEntryBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UpdateSkillBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue, VoiceTokenResponse, WorldAutonomyPolicy, WorldSuggestionUpdated };
+export { AGENT_MSG_PRIORITIES, AGENT_MSG_STATUSES, AGENT_MSG_TYPES, AIBackendProfileSchema, AcceptBodySchema, AgentLoopSummarySchema, AgentMessageSchema, AgentMessageSummarySchema, AgentMsgTypeSchema, AnthropicConfigSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, AutoDreamProfileSummarySchema, AutomationAuditEventSummarySchema, AutomationAuditStatsSchema, AutomationCountsSchema, AutomationGuardianSummarySchema, AutomationGuardianUsageSummarySchema, AutomationJobKindSchema, AutomationJobStatusSchema, AutomationJobSummarySchema, AutomationPrioritySchema, AutomationStateSchema, AutonomyStatsRecentActionSchema, AutonomyStatsSchema, AzureOpenAIConfigSchema, BUILT_IN_AI_BACKEND_PROFILE_IDS, BootstrapProfileSummarySchema, BriefMessageSchema, BuiltInAIBackendProfileIdSchema, CodexConfigSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, CreateSkillBodySchema, CreateTaskBodySchema, CrossProjectSearchResponseSchema, CrossProjectSearchResultSchema, CustomModelSchema, DaemonStateSchema, DefaultPermissionModeSchema, EVIDENCE_KINDS, EnvironmentVariableSchema, InboxCategorySchema, InboxItemSummarySchema, InboxNewItemSchema, InboxSeveritySchema, InboxUnreadCountSchema, KnowledgeActionSchema, KnowledgeChainEntrySchema, KnowledgeChainRelationSchema, KnowledgeChainResponseSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, OpenAIConfigSchema, ProfileCompatibilitySchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION, ResolvedRuntimeProfileSchema, RuntimeProfileSourceSchema, RuntimeProfileTrustSchema, SUGGESTION_ACCEPT_AUDIT_RULES, SUGGESTION_ACCEPT_SOURCES, SUGGESTION_AUTO_ACCEPT_FAILURE_DETAILS, SUGGESTION_AUTO_ACCEPT_REASON_CODES, SUGGESTION_AUTO_ACCEPT_STATUSES, SUGGESTION_BUCKETS, SUGGESTION_STATUSES, SUGGESTION_TYPES, SUPERVISOR_MODES, SessionEventCreatedSchema, SessionEventReportSchema, SessionEventSummarySchema, SessionEventTypeSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, SkillContentSchema, SkillSummarySchema, SuggestionAcceptAuditSchema, SuggestionDecisionPayloadSchema, SuggestionEvidenceSchema, SuggestionGoalPayloadSchema, SuggestionPayloadSchema, SuggestionSkillPayloadSchema, SuggestionTaskPayloadSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TaskOutcomeSchema, TaskPrioritySchema, TaskStatusChangedSchema, TaskStatusReportSchema, TaskStatusSchema, TaskSummarySchema, TaskTriggerDataSchema, TaskTriggerTypeSchema, TmuxConfigSchema, TogetherAIConfigSchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UpdateSkillBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, VoiceTokenAllowedSchema, VoiceTokenDeniedSchema, VoiceTokenResponseSchema, WorldAutonomyPolicySchema, WorldSuggestionUpdatedSchema, createEnvelope, createResolvedRuntimeProfile, getProfileEnvironmentVariables, getSuggestionPayloadSchema, isTrustedRuntimeProfile, normalizeResolvedRuntimeProfile, sessionContextUsageCategorySchema, sessionContextUsageEventSchema, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionProgressListSchema, sessionProgressStateSchema, sessionProgressTodoSchema, sessionProgressTodoStatusSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionSummaryStateSchema, sessionTaskEndEventSchema, sessionTaskLogEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextDeltaEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema, terminalCloseRequestSchema, terminalExitPayloadSchema, terminalInputPayloadSchema, terminalOutputPayloadSchema, terminalResizeRequestSchema, terminalSpawnRequestSchema, terminalSpawnResponseSchema, validateProfileForAgent };
+export type { AIBackendProfile, AcceptBody, AgentLoopSummary, AgentMessage, AgentMessageSummary, AgentMsgPriority, AgentMsgStatus, AgentMsgType, ApiMessage, ApiUpdateMachineState, ApiUpdateNewMessage, ApiUpdateSessionState, AutoDreamProfileSummary, AutomationAuditEventSummary, AutomationAuditStats, AutomationCounts, AutomationGuardianSummary, AutomationGuardianUsageSummary, AutomationJobKind, AutomationJobStatus, AutomationJobSummary, AutomationPriority, AutomationState, AutonomyStats, BootstrapProfileSummary, BriefMessage, BuiltInAIBackendProfileId, CoreUpdateBody, CoreUpdateContainer, CreateEnvelopeOptions, CreateKnowledgeEntryBody, CreateSkillBody, CreateTaskBody, CrossProjectSearchResponse, CrossProjectSearchResult, DaemonState, InboxCategory, InboxItemSummary, InboxNewItem, InboxSeverity, InboxUnreadCount, KnowledgeAction, KnowledgeChainEntry, KnowledgeChainRelation, KnowledgeChainResponse, KnowledgeConfidence, KnowledgeContributorType, KnowledgeEntryType, KnowledgeInjectionMode, KnowledgeInjectionRequest, KnowledgeInjectionResponse, KnowledgeStatus, LegacyMessageContent, MachineMetadata, MessageContent, MessageMeta, ProjectProfile, QueryKnowledgeParams, ResolvedRuntimeProfile, RuntimeProfileSource, RuntimeProfileTrust, SessionContextUsageEvent, SessionEnvelope, SessionEvent, SessionEventCreated, SessionEventReport, SessionEventSummary, SessionEventType, SessionMessage, SessionMessageContent, SessionModelUsage, SessionProgressList, SessionProgressState, SessionProgressTodo, SessionProgressTodoStatus, SessionProtocolMessage, SessionRole, SessionSummaryState, SessionTurnEndStatus, SkillContent, SkillSummary, SuggestionAcceptAudit, SuggestionAcceptAuditRule, SuggestionAcceptSource, SuggestionAutoAcceptFailureDetail, SuggestionAutoAcceptReasonCode, SuggestionAutoAcceptStatus, SuggestionBucket, SuggestionDecisionPayload, SuggestionEvidence, SuggestionGoalPayload, SuggestionPayload, SuggestionSerialized, SuggestionSkillPayload, SuggestionStatus, SuggestionSummary, SuggestionTaskPayload, SuggestionType, SupervisorMode, TailscaleInfo, TailscaleServeEntry, TaskOutcome, TaskPriority, TaskStatus, TaskStatusChanged, TaskStatusReport, TaskSummary, TaskTriggerData, TaskTriggerType, TerminalCloseRequest, TerminalExitPayload, TerminalInputPayload, TerminalOutputPayload, TerminalResizeRequest, TerminalSpawnRequest, TerminalSpawnResponse, TunnelEntry, TunnelProviderInfo, TunnelState, TurnKnowledgeExtraction, Update, UpdateBody, UpdateKnowledgeEntryBody, UpdateMachineBody, UpdateNewMessageBody, UpdateSessionBody, UpdateSkillBody, UserMessage, VersionedEncryptedValue, VersionedMachineEncryptedValue, VersionedNullableEncryptedValue, VoiceTokenResponse, WorldAutonomyPolicy, WorldSuggestionUpdated };

package/dist/index.mjs

@@ -1473,10 +1473,41 @@ const sessionProgressTodoStatusSchema = z.enum([
 const sessionProgressTodoSchema = z.object({
   content: z.string(),
   status: sessionProgressTodoStatusSchema,
-  stage: z.string().optional()
+  /** SDK-native: imperative-present form shown when status is in_progress. */
+  activeForm: z.string().optional(),
+  /** Optional phase/stage label a step belongs to, e.g. "Phase 2". */
+  stage: z.string().optional(),
+  /**
+   * Carried over from SDK's `TodoWriteOutput.verificationNudgeNeeded` — SDK
+   * flags items it suspects were marked completed without verification.
+   */
+  verificationNudgeNeeded: z.boolean().optional()
 });
-const sessionProgressStateSchema = z.object({
+const sessionProgressListSchema = z.object({
+  /** Stable UUID for tab switching / explicit Agent addressing. */
+  id: z.string(),
+  /** Short human-readable label; auto-derived from first todo if absent. */
+  label: z.string().optional(),
   todos: z.array(sessionProgressTodoSchema),
+  /** Optional overall stage for this list (set via MCP). */
+  currentStage: z.string().optional(),
+  /** Optional blocker list (set via MCP). */
+  blockers: z.array(z.string()).optional(),
+  startedAt: z.number(),
+  updatedAt: z.number(),
+  /** When this list stopped being active (got pushed to history). */
+  archivedAt: z.number().optional()
+});
+const sessionProgressStateSchema = z.object({
+  /** Ordered by startedAt asc; last item is typically the active one. */
+  lists: z.array(sessionProgressListSchema).optional(),
+  /** Points at the active list within `lists`. */
+  currentListId: z.string().optional(),
+  /**
+   * Legacy flat fields. Still written for backward compat with older
+   * readers — kept in sync with `lists[currentListId]` on each update.
+   */
+  todos: z.array(sessionProgressTodoSchema).optional(),
   currentStage: z.string().optional(),
   blockers: z.array(z.string()).optional(),
   updatedAt: z.number()
@@ -1490,4 +1521,4 @@ const sessionSummaryStateSchema = z.object({
   updatedAt: z.number()
 });
 
-export { AGENT_MSG_PRIORITIES, AGENT_MSG_STATUSES, AGENT_MSG_TYPES, AIBackendProfileSchema, AcceptBodySchema, AgentLoopSummarySchema, AgentMessageSchema, AgentMessageSummarySchema, AgentMsgTypeSchema, AnthropicConfigSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, AutoDreamProfileSummarySchema, AutomationAuditEventSummarySchema, AutomationAuditStatsSchema, AutomationCountsSchema, AutomationGuardianSummarySchema, AutomationGuardianUsageSummarySchema, AutomationJobKindSchema, AutomationJobStatusSchema, AutomationJobSummarySchema, AutomationPrioritySchema, AutomationStateSchema, AutonomyStatsRecentActionSchema, AutonomyStatsSchema, AzureOpenAIConfigSchema, BUILT_IN_AI_BACKEND_PROFILE_IDS, BootstrapProfileSummarySchema, BriefMessageSchema, BuiltInAIBackendProfileIdSchema, CodexConfigSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, CreateSkillBodySchema, CreateTaskBodySchema, CrossProjectSearchResponseSchema, CrossProjectSearchResultSchema, CustomModelSchema, DaemonStateSchema, DefaultPermissionModeSchema, EVIDENCE_KINDS, EnvironmentVariableSchema, InboxCategorySchema, InboxItemSummarySchema, InboxNewItemSchema, InboxSeveritySchema, InboxUnreadCountSchema, KnowledgeActionSchema, KnowledgeChainEntrySchema, KnowledgeChainRelationSchema, KnowledgeChainResponseSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, OpenAIConfigSchema, ProfileCompatibilitySchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION, ResolvedRuntimeProfileSchema, RuntimeProfileSourceSchema, RuntimeProfileTrustSchema, SUGGESTION_ACCEPT_AUDIT_RULES, SUGGESTION_ACCEPT_SOURCES, SUGGESTION_AUTO_ACCEPT_FAILURE_DETAILS, SUGGESTION_AUTO_ACCEPT_REASON_CODES, SUGGESTION_AUTO_ACCEPT_STATUSES, SUGGESTION_BUCKETS, SUGGESTION_STATUSES, SUGGESTION_TYPES, SUPERVISOR_MODES, SessionEventCreatedSchema, SessionEventReportSchema, SessionEventSummarySchema, SessionEventTypeSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, SkillContentSchema, SkillSummarySchema, SuggestionAcceptAuditSchema, SuggestionDecisionPayloadSchema, SuggestionEvidenceSchema, SuggestionGoalPayloadSchema, SuggestionPayloadSchema, SuggestionSkillPayloadSchema, SuggestionTaskPayloadSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TaskOutcomeSchema, TaskPrioritySchema, TaskStatusChangedSchema, TaskStatusReportSchema, TaskStatusSchema, TaskSummarySchema, TaskTriggerDataSchema, TaskTriggerTypeSchema, TmuxConfigSchema, TogetherAIConfigSchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UpdateSkillBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, VoiceTokenAllowedSchema, VoiceTokenDeniedSchema, VoiceTokenResponseSchema, WorldAutonomyPolicySchema, WorldSuggestionUpdatedSchema, createEnvelope, createResolvedRuntimeProfile, getProfileEnvironmentVariables, getSuggestionPayloadSchema, isTrustedRuntimeProfile, normalizeResolvedRuntimeProfile, sessionContextUsageCategorySchema, sessionContextUsageEventSchema, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionProgressStateSchema, sessionProgressTodoSchema, sessionProgressTodoStatusSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionSummaryStateSchema, sessionTaskEndEventSchema, sessionTaskLogEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextDeltaEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema, terminalCloseRequestSchema, terminalExitPayloadSchema, terminalInputPayloadSchema, terminalOutputPayloadSchema, terminalResizeRequestSchema, terminalSpawnRequestSchema, terminalSpawnResponseSchema, validateProfileForAgent };
+export { AGENT_MSG_PRIORITIES, AGENT_MSG_STATUSES, AGENT_MSG_TYPES, AIBackendProfileSchema, AcceptBodySchema, AgentLoopSummarySchema, AgentMessageSchema, AgentMessageSummarySchema, AgentMsgTypeSchema, AnthropicConfigSchema, ApiMessageSchema, ApiUpdateMachineStateSchema, ApiUpdateNewMessageSchema, ApiUpdateSessionStateSchema, AutoDreamProfileSummarySchema, AutomationAuditEventSummarySchema, AutomationAuditStatsSchema, AutomationCountsSchema, AutomationGuardianSummarySchema, AutomationGuardianUsageSummarySchema, AutomationJobKindSchema, AutomationJobStatusSchema, AutomationJobSummarySchema, AutomationPrioritySchema, AutomationStateSchema, AutonomyStatsRecentActionSchema, AutonomyStatsSchema, AzureOpenAIConfigSchema, BUILT_IN_AI_BACKEND_PROFILE_IDS, BootstrapProfileSummarySchema, BriefMessageSchema, BuiltInAIBackendProfileIdSchema, CodexConfigSchema, CoreUpdateBodySchema, CoreUpdateContainerSchema, CreateKnowledgeEntryBodySchema, CreateSkillBodySchema, CreateTaskBodySchema, CrossProjectSearchResponseSchema, CrossProjectSearchResultSchema, CustomModelSchema, DaemonStateSchema, DefaultPermissionModeSchema, EVIDENCE_KINDS, EnvironmentVariableSchema, InboxCategorySchema, InboxItemSummarySchema, InboxNewItemSchema, InboxSeveritySchema, InboxUnreadCountSchema, KnowledgeActionSchema, KnowledgeChainEntrySchema, KnowledgeChainRelationSchema, KnowledgeChainResponseSchema, KnowledgeConfidenceSchema, KnowledgeContributorTypeSchema, KnowledgeEntryTypeSchema, KnowledgeInjectionModeSchema, KnowledgeInjectionRequestSchema, KnowledgeInjectionResponseSchema, KnowledgeStatusSchema, LegacyMessageContentSchema, MachineMetadataSchema, MessageContentSchema, MessageMetaSchema, OpenAIConfigSchema, ProfileCompatibilitySchema, ProjectProfileSchema, QueryKnowledgeParamsSchema, RESOLVED_RUNTIME_PROFILE_SCHEMA_VERSION, ResolvedRuntimeProfileSchema, RuntimeProfileSourceSchema, RuntimeProfileTrustSchema, SUGGESTION_ACCEPT_AUDIT_RULES, SUGGESTION_ACCEPT_SOURCES, SUGGESTION_AUTO_ACCEPT_FAILURE_DETAILS, SUGGESTION_AUTO_ACCEPT_REASON_CODES, SUGGESTION_AUTO_ACCEPT_STATUSES, SUGGESTION_BUCKETS, SUGGESTION_STATUSES, SUGGESTION_TYPES, SUPERVISOR_MODES, SessionEventCreatedSchema, SessionEventReportSchema, SessionEventSummarySchema, SessionEventTypeSchema, SessionMessageContentSchema, SessionMessageSchema, SessionProtocolMessageSchema, SkillContentSchema, SkillSummarySchema, SuggestionAcceptAuditSchema, SuggestionDecisionPayloadSchema, SuggestionEvidenceSchema, SuggestionGoalPayloadSchema, SuggestionPayloadSchema, SuggestionSkillPayloadSchema, SuggestionTaskPayloadSchema, TailscaleInfoSchema, TailscaleServeEntrySchema, TaskOutcomeSchema, TaskPrioritySchema, TaskStatusChangedSchema, TaskStatusReportSchema, TaskStatusSchema, TaskSummarySchema, TaskTriggerDataSchema, TaskTriggerTypeSchema, TmuxConfigSchema, TogetherAIConfigSchema, TunnelEntrySchema, TunnelProviderInfoSchema, TunnelStateSchema, TurnKnowledgeExtractionSchema, UpdateBodySchema, UpdateKnowledgeEntryBodySchema, UpdateMachineBodySchema, UpdateNewMessageBodySchema, UpdateSchema, UpdateSessionBodySchema, UpdateSkillBodySchema, UserMessageSchema, VersionedEncryptedValueSchema, VersionedMachineEncryptedValueSchema, VersionedNullableEncryptedValueSchema, VoiceTokenAllowedSchema, VoiceTokenDeniedSchema, VoiceTokenResponseSchema, WorldAutonomyPolicySchema, WorldSuggestionUpdatedSchema, createEnvelope, createResolvedRuntimeProfile, getProfileEnvironmentVariables, getSuggestionPayloadSchema, isTrustedRuntimeProfile, normalizeResolvedRuntimeProfile, sessionContextUsageCategorySchema, sessionContextUsageEventSchema, sessionEnvelopeSchema, sessionEventSchema, sessionFileEventSchema, sessionModelUsageSchema, sessionNeedsContinueEventSchema, sessionProgressListSchema, sessionProgressStateSchema, sessionProgressTodoSchema, sessionProgressTodoStatusSchema, sessionPromptSuggestionEventSchema, sessionRoleSchema, sessionServiceMessageEventSchema, sessionStartEventSchema, sessionStateChangedEventSchema, sessionStopEventSchema, sessionSummaryStateSchema, sessionTaskEndEventSchema, sessionTaskLogEventSchema, sessionTaskProgressEventSchema, sessionTaskStartEventSchema, sessionTextDeltaEventSchema, sessionTextEventSchema, sessionToolCallEndEventSchema, sessionToolCallStartEventSchema, sessionToolProgressEventSchema, sessionTurnEndEventSchema, sessionTurnEndStatusSchema, sessionTurnStartEventSchema, sessionUsageUpdateEventSchema, terminalCloseRequestSchema, terminalExitPayloadSchema, terminalInputPayloadSchema, terminalOutputPayloadSchema, terminalResizeRequestSchema, terminalSpawnRequestSchema, terminalSpawnResponseSchema, validateProfileForAgent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmmao/happy-wire",
-  "version": "0.11.7",
+  "version": "0.11.8",
   "description": "Shared message wire types and Zod schemas for Happy clients and services",
   "author": "kmmao",
   "license": "MIT",