@adecore/agent-contracts 0.23.1 → 0.24.1

package/dist/chat.d.ts

@@ -132,6 +132,32 @@ export declare const ChatTurnLimitSchema: z.ZodObject<{
     resetsAt: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ChatTurnLimit = z.infer<typeof ChatTurnLimitSchema>;
+export declare const ChatGoalStatusSchema: z.ZodEnum<{
+    active: "active";
+    blocked: "blocked";
+    "budget-limited": "budget-limited";
+    complete: "complete";
+    paused: "paused";
+    "usage-limited": "usage-limited";
+}>;
+export type ChatGoalStatus = z.infer<typeof ChatGoalStatusSchema>;
+export declare const ChatGoalSchema: z.ZodObject<{
+    objective: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        blocked: "blocked";
+        "budget-limited": "budget-limited";
+        complete: "complete";
+        paused: "paused";
+        "usage-limited": "usage-limited";
+    }>;
+    checks: z.ZodOptional<z.ZodNumber>;
+    lastCheck: z.ZodOptional<z.ZodString>;
+    tokensUsed: z.ZodOptional<z.ZodNumber>;
+    tokenBudget: z.ZodOptional<z.ZodNumber>;
+    secondsUsed: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ChatGoal = z.infer<typeof ChatGoalSchema>;
 export declare const ChatQuestionSchema: z.ZodObject<{
     id: z.ZodString;
     header: z.ZodString;
@@ -364,6 +390,22 @@ export declare const ChatInfoSchema: z.ZodObject<{
             async: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
     }, z.core.$strip>>>;
+    goal: z.ZodOptional<z.ZodObject<{
+        objective: z.ZodString;
+        status: z.ZodEnum<{
+            active: "active";
+            blocked: "blocked";
+            "budget-limited": "budget-limited";
+            complete: "complete";
+            paused: "paused";
+            "usage-limited": "usage-limited";
+        }>;
+        checks: z.ZodOptional<z.ZodNumber>;
+        lastCheck: z.ZodOptional<z.ZodString>;
+        tokensUsed: z.ZodOptional<z.ZodNumber>;
+        tokenBudget: z.ZodOptional<z.ZodNumber>;
+        secondsUsed: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
     createdAt: z.ZodNumber;
 }, z.core.$strip>;
 export type ChatInfo = z.infer<typeof ChatInfoSchema>;
@@ -740,6 +782,7 @@ export declare const ChatSubagentUsageSchema: z.ZodObject<{
     durationMs: z.ZodNumber;
 }, z.core.$strip>;
 export type ChatSubagentUsage = z.infer<typeof ChatSubagentUsageSchema>;
+export declare const HOST_TASK_ORIGIN = "ruimte";
 export declare const ChatSubagentItemSchema: z.ZodObject<{
     id: z.ZodString;
     createdAt: z.ZodNumber;
@@ -1830,6 +1873,22 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 async: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        goal: z.ZodOptional<z.ZodObject<{
+            objective: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                blocked: "blocked";
+                "budget-limited": "budget-limited";
+                complete: "complete";
+                paused: "paused";
+                "usage-limited": "usage-limited";
+            }>;
+            checks: z.ZodOptional<z.ZodNumber>;
+            lastCheck: z.ZodOptional<z.ZodString>;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            tokenBudget: z.ZodOptional<z.ZodNumber>;
+            secondsUsed: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         createdAt: z.ZodNumber;
     }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
@@ -1984,6 +2043,22 @@ export declare const ChatEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 async: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        goal: z.ZodOptional<z.ZodObject<{
+            objective: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                blocked: "blocked";
+                "budget-limited": "budget-limited";
+                complete: "complete";
+                paused: "paused";
+                "usage-limited": "usage-limited";
+            }>;
+            checks: z.ZodOptional<z.ZodNumber>;
+            lastCheck: z.ZodOptional<z.ZodString>;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            tokenBudget: z.ZodOptional<z.ZodNumber>;
+            secondsUsed: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         createdAt: z.ZodNumber;
     }, z.core.$strip>;
     items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2849,6 +2924,22 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
                     async: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
+            goal: z.ZodOptional<z.ZodObject<{
+                objective: z.ZodString;
+                status: z.ZodEnum<{
+                    active: "active";
+                    blocked: "blocked";
+                    "budget-limited": "budget-limited";
+                    complete: "complete";
+                    paused: "paused";
+                    "usage-limited": "usage-limited";
+                }>;
+                checks: z.ZodOptional<z.ZodNumber>;
+                lastCheck: z.ZodOptional<z.ZodString>;
+                tokensUsed: z.ZodOptional<z.ZodNumber>;
+                tokenBudget: z.ZodOptional<z.ZodNumber>;
+                secondsUsed: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
             createdAt: z.ZodNumber;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
@@ -3003,6 +3094,22 @@ export declare const ChatEventEnvelopeSchema: z.ZodObject<{
                     async: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
+            goal: z.ZodOptional<z.ZodObject<{
+                objective: z.ZodString;
+                status: z.ZodEnum<{
+                    active: "active";
+                    blocked: "blocked";
+                    "budget-limited": "budget-limited";
+                    complete: "complete";
+                    paused: "paused";
+                    "usage-limited": "usage-limited";
+                }>;
+                checks: z.ZodOptional<z.ZodNumber>;
+                lastCheck: z.ZodOptional<z.ZodString>;
+                tokensUsed: z.ZodOptional<z.ZodNumber>;
+                tokenBudget: z.ZodOptional<z.ZodNumber>;
+                secondsUsed: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
             createdAt: z.ZodNumber;
         }, z.core.$strip>;
         items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -3780,6 +3887,21 @@ export declare const ChatStopSubagentPayloadSchema: z.ZodObject<{
     toolUseId: z.ZodString;
 }, z.core.$strip>;
 export type ChatStopSubagentPayload = z.infer<typeof ChatStopSubagentPayloadSchema>;
+export declare const ChatGoalActionSchema: z.ZodEnum<{
+    clear: "clear";
+    pause: "pause";
+    resume: "resume";
+}>;
+export type ChatGoalAction = z.infer<typeof ChatGoalActionSchema>;
+export declare const ChatGoalPayloadSchema: z.ZodObject<{
+    chatId: z.ZodString;
+    action: z.ZodEnum<{
+        clear: "clear";
+        pause: "pause";
+        resume: "resume";
+    }>;
+}, z.core.$strip>;
+export type ChatGoalPayload = z.infer<typeof ChatGoalPayloadSchema>;
 export declare const ChatStopTaskPayloadSchema: z.ZodObject<{
     chatId: z.ZodString;
     taskId: z.ZodString;
@@ -4341,6 +4463,22 @@ export declare const ChatStatusEventSchema: z.ZodObject<{
                 async: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        goal: z.ZodOptional<z.ZodObject<{
+            objective: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                blocked: "blocked";
+                "budget-limited": "budget-limited";
+                complete: "complete";
+                paused: "paused";
+                "usage-limited": "usage-limited";
+            }>;
+            checks: z.ZodOptional<z.ZodNumber>;
+            lastCheck: z.ZodOptional<z.ZodString>;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            tokenBudget: z.ZodOptional<z.ZodNumber>;
+            secondsUsed: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         createdAt: z.ZodNumber;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -4593,6 +4731,22 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
                 async: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        goal: z.ZodOptional<z.ZodObject<{
+            objective: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                blocked: "blocked";
+                "budget-limited": "budget-limited";
+                complete: "complete";
+                paused: "paused";
+                "usage-limited": "usage-limited";
+            }>;
+            checks: z.ZodOptional<z.ZodNumber>;
+            lastCheck: z.ZodOptional<z.ZodString>;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            tokenBudget: z.ZodOptional<z.ZodNumber>;
+            secondsUsed: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         createdAt: z.ZodNumber;
     }, z.core.$strip>;
     items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -5784,6 +5938,22 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
                     async: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
+            goal: z.ZodOptional<z.ZodObject<{
+                objective: z.ZodString;
+                status: z.ZodEnum<{
+                    active: "active";
+                    blocked: "blocked";
+                    "budget-limited": "budget-limited";
+                    complete: "complete";
+                    paused: "paused";
+                    "usage-limited": "usage-limited";
+                }>;
+                checks: z.ZodOptional<z.ZodNumber>;
+                lastCheck: z.ZodOptional<z.ZodString>;
+                tokensUsed: z.ZodOptional<z.ZodNumber>;
+                tokenBudget: z.ZodOptional<z.ZodNumber>;
+                secondsUsed: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
             createdAt: z.ZodNumber;
         }, z.core.$strip>;
     }, z.core.$strip>, z.ZodObject<{
@@ -5938,6 +6108,22 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
                     async: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
+            goal: z.ZodOptional<z.ZodObject<{
+                objective: z.ZodString;
+                status: z.ZodEnum<{
+                    active: "active";
+                    blocked: "blocked";
+                    "budget-limited": "budget-limited";
+                    complete: "complete";
+                    paused: "paused";
+                    "usage-limited": "usage-limited";
+                }>;
+                checks: z.ZodOptional<z.ZodNumber>;
+                lastCheck: z.ZodOptional<z.ZodString>;
+                tokensUsed: z.ZodOptional<z.ZodNumber>;
+                tokenBudget: z.ZodOptional<z.ZodNumber>;
+                secondsUsed: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
             createdAt: z.ZodNumber;
         }, z.core.$strip>;
         items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -6610,6 +6796,22 @@ export declare const ChatForkResultSchema: z.ZodObject<{
                 async: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        goal: z.ZodOptional<z.ZodObject<{
+            objective: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                blocked: "blocked";
+                "budget-limited": "budget-limited";
+                complete: "complete";
+                paused: "paused";
+                "usage-limited": "usage-limited";
+            }>;
+            checks: z.ZodOptional<z.ZodNumber>;
+            lastCheck: z.ZodOptional<z.ZodString>;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            tokenBudget: z.ZodOptional<z.ZodNumber>;
+            secondsUsed: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         createdAt: z.ZodNumber;
     }, z.core.$strip>;
     nodeId: z.ZodString;
@@ -6795,6 +6997,22 @@ export declare const ChatContinueOnResultSchema: z.ZodObject<{
                     async: z.ZodOptional<z.ZodBoolean>;
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
+            goal: z.ZodOptional<z.ZodObject<{
+                objective: z.ZodString;
+                status: z.ZodEnum<{
+                    active: "active";
+                    blocked: "blocked";
+                    "budget-limited": "budget-limited";
+                    complete: "complete";
+                    paused: "paused";
+                    "usage-limited": "usage-limited";
+                }>;
+                checks: z.ZodOptional<z.ZodNumber>;
+                lastCheck: z.ZodOptional<z.ZodString>;
+                tokensUsed: z.ZodOptional<z.ZodNumber>;
+                tokenBudget: z.ZodOptional<z.ZodNumber>;
+                secondsUsed: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
             createdAt: z.ZodNumber;
         }, z.core.$strip>;
         nodeId: z.ZodString;
@@ -6994,6 +7212,22 @@ export declare const ChatListResultSchema: z.ZodObject<{
                 async: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        goal: z.ZodOptional<z.ZodObject<{
+            objective: z.ZodString;
+            status: z.ZodEnum<{
+                active: "active";
+                blocked: "blocked";
+                "budget-limited": "budget-limited";
+                complete: "complete";
+                paused: "paused";
+                "usage-limited": "usage-limited";
+            }>;
+            checks: z.ZodOptional<z.ZodNumber>;
+            lastCheck: z.ZodOptional<z.ZodString>;
+            tokensUsed: z.ZodOptional<z.ZodNumber>;
+            tokenBudget: z.ZodOptional<z.ZodNumber>;
+            secondsUsed: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
         createdAt: z.ZodNumber;
     }, z.core.$strip>>;
 }, z.core.$strip>;

package/dist/chat.js

@@ -137,6 +137,24 @@ export const ChatTurnLimitSchema = z.object({
     // When the limit lifts, in milliseconds since the epoch; absent when the CLI named no time.
     resetsAt: z.number().optional()
 });
+/*
+ * A goal the chat's CLI works toward on its own, turn after turn, until it is met: Claude Code's and Codex's
+ * `/goal`. The statuses are this schema's own, so a client that validates a chat payload whole never meets
+ * a new value inside one it already knew. `usage-limited` and `budget-limited` are Codex's: the plan's limit,
+ * or the token budget the goal was given.
+ */
+export const ChatGoalStatusSchema = z.enum(['active', 'paused', 'blocked', 'usage-limited', 'budget-limited', 'complete']);
+export const ChatGoalSchema = z.object({
+    objective: z.string(),
+    status: ChatGoalStatusSchema,
+    // How often the CLI's own check found the goal not met yet and sent the agent on; absent from a CLI that counts tokens instead.
+    checks: z.number().int().nonnegative().optional(),
+    // What that check last said was still missing.
+    lastCheck: z.string().optional(),
+    tokensUsed: z.number().int().nonnegative().optional(),
+    tokenBudget: z.number().int().positive().optional(),
+    secondsUsed: z.number().int().nonnegative().optional()
+});
 export const ChatQuestionSchema = z.object({
     id: z.string(),
     header: z.string(),
@@ -235,6 +253,8 @@ export const ChatInfoSchema = z.object({
     resumeAt: z.number().optional(),
     // What the chat waits on a person for, oldest first and at most `CHAT_REQUEST_LIMITS.perChat`; absent while nothing waits.
     requests: z.array(ChatRequestSummarySchema).optional(),
+    // The goal the CLI works toward, from the moment one is set until it is cleared; absent while there is none.
+    goal: ChatGoalSchema.optional(),
     createdAt: z.number()
 });
 // Where a skill was found: the person's own folder, the chat's folder, or a plugin.
@@ -387,6 +407,8 @@ export const ChatSubagentUsageSchema = z.object({
  * ordinary items that carry `parentToolUseId`, so streaming keeps working; the timeline gathers
  * them under this row. `result` is the report it ended with, as markdown.
  */
+// The `origin` of a subagent row a host opened with a task of its own rather than the CLI with its tool; a legacy spelling that stored threads carry.
+export const HOST_TASK_ORIGIN = 'ruimte';
 export const ChatSubagentItemSchema = z.object({
     ...base,
     kind: z.literal('subagent'),
@@ -415,8 +437,7 @@ export const ChatSubagentItemSchema = z.object({
     // Where the CLI keeps this subagent's own conversation; set once the daemon found it.
     native: z.object({ agentId: z.string().optional(), threadId: z.string().optional() }).optional(),
     // Who opened it: the CLI with its own tool, or a verb with `--task` that made a node; absent is `native`.
-    // The second value keeps its legacy spelling, since stored threads carry it.
-    origin: z.enum(['native', 'ruimte']).optional(),
+    origin: z.enum(['native', HOST_TASK_ORIGIN]).optional(),
     // The node a `--task` opened, whose own conversation this row stands for.
     childId: z.string().optional(),
     // Set for an agent a subagent opened, with the id of that subagent's own Agent call; its row hangs under that one.
@@ -628,6 +649,9 @@ export const ChatStopSubagentPayloadSchema = ChatTargetPayloadSchema.extend({
     // A running row of the chat's own thread: a task's node is stopped, a subagent of the CLI's own only marked.
     toolUseId: z.string().min(1).max(256)
 });
+// What a person does to a chat's goal without a turn of its own; `pause` and `resume` only where the CLI's protocol has them.
+export const ChatGoalActionSchema = z.enum(['pause', 'resume', 'clear']);
+export const ChatGoalPayloadSchema = ChatTargetPayloadSchema.extend({ action: ChatGoalActionSchema });
 export const ChatStopTaskPayloadSchema = ChatTargetPayloadSchema.extend({ taskId: z.string().min(1).max(256) });
 // `start` is the place in the conversation for a source that numbers it; a Codex thread pages by its own cursor only.
 export const ChatSubagentPageSchema = z.object({

package/dist/index.d.ts

@@ -1,13 +1,14 @@
-export * from './agent.ts';
-export * from './chat.ts';
-export * from './envelope.ts';
-export * from './ids.ts';
-export * from './model.ts';
-export * from './protocol.ts';
-export * from './provider-accounts.ts';
-export * from './task.ts';
-export * from './text.ts';
-export * from './usage.ts';
-export * from './visual.ts';
-export * from './worktree.ts';
-export type * from './port.ts';
+export { AgentKindSchema, type AgentKind, AgentStatusSchema, type AgentStatus, SUGGESTED_TITLE_LIMIT, SuggestedTitleSchema, AgentRequestSchema, type AgentRequest, AgentInfoSchema, type AgentInfo, SessionStatusEventSchema, type SessionStatusEvent, AgentResumePayloadSchema, type AgentResumePayload, ApprovalChoiceSchema, type ApprovalChoice, ApprovalRequestSchema, type ApprovalRequest, SessionApprovalsEventSchema, type SessionApprovalsEvent, ApprovalAnswerPayloadSchema, type ApprovalAnswerPayload, ApprovalAnswerResultSchema, type ApprovalAnswerResult, ApprovalPreferencePayloadSchema, type ApprovalPreferencePayload } from './agent.ts';
+export { ChatIdSchema, type ChatId, ChatContextBreakdownSchema, type ChatContextBreakdown, ChatUsageSchema, type ChatUsage, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, type ChatAttachmentUpload, ChatAttachmentUploadsSchema, ChatAttachmentSchema, type ChatAttachment, ChatUiChoiceOriginSchema, type ChatUiChoiceOrigin, ChatUiAnswerSchema, type ChatUiAnswer, ChatQuoteSourceSchema, type ChatQuoteSource, ChatQueuedMessageSchema, type ChatQueuedMessage, ChatBackgroundTaskSchema, type ChatBackgroundTask, ChatTurnLimitSchema, type ChatTurnLimit, ChatGoalStatusSchema, type ChatGoalStatus, ChatGoalSchema, type ChatGoal, ChatQuestionSchema, type ChatQuestion, ChatRequestKindSchema, type ChatRequestKind, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, type ChatRequestApproval, ChatRequestSummarySchema, type ChatRequestSummary, ChatInfoSchema, type ChatInfo, ChatSkillSourceSchema, type ChatSkillSource, ChatSkillSchema, type ChatSkill, SkillsListPayloadSchema, type SkillsListPayload, SkillsListResultSchema, type SkillsListResult, ChatUserItemSchema, ChatUiQueryReadingSchema, type ChatUiQueryReading, ChatUiLinkReadingSchema, type ChatUiLinkReading, ChatUiQueryStateSchema, type ChatUiQueryState, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, type ChatToolState, ChatToolProgressSchema, type ChatToolProgress, ChatFileChangeSchema, type ChatFileChange, ChatSubagentStatusSchema, type ChatSubagentStatus, ChatWorkflowPhaseSchema, type ChatWorkflowPhase, ChatWorkflowAgentSchema, type ChatWorkflowAgent, ChatWorkflowSchema, type ChatWorkflow, workflowAgentRef, workflowAgentIdOf, ChatToolItemSchema, ChatSubagentUsageSchema, type ChatSubagentUsage, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, type ChatApprovalDecision, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, type ChatCheckpointFile, ChatCheckpointDiffSchema, type ChatCheckpointDiff, ChatTurnItemSchema, notResumedNote, abortedByMachine, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, type ChatItem, type ChatUserItem, type ChatAssistantItem, type ChatThinkingItem, type ChatToolItem, type ChatSubagentItem, type ChatApprovalItem, type ChatQuestionItem, type ChatTurnItem, type ChatNoteItem, type ChatCompactionItem, ChatEventSchema, type ChatEvent, ChatEventEnvelopeSchema, type ChatEventEnvelope, ChatCreatePayloadSchema, type ChatCreatePayload, ChatConfigurePayloadSchema, type ChatConfigurePayload, ChatPreferencesPayloadSchema, type ChatPreferencesPayload, ChatTargetPayloadSchema, type ChatTargetPayload, ChatClearPayloadSchema, type ChatClearPayload, ChatCancelPayloadSchema, type ChatCancelPayload, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, type ChatHistoryResult, ChatSubagentPayloadSchema, type ChatSubagentPayload, ChatStopSubagentPayloadSchema, type ChatStopSubagentPayload, ChatGoalActionSchema, type ChatGoalAction, ChatGoalPayloadSchema, type ChatGoalPayload, ChatStopTaskPayloadSchema, type ChatStopTaskPayload, ChatSubagentPageSchema, ChatSubagentSourceSchema, type ChatSubagentSource, ChatSubagentResultSchema, type ChatSubagentResult, ChatStatusEventSchema, type ChatStatusEvent, ChatSubagentChangedEventSchema, type ChatSubagentChangedEvent, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, type ChatBookmark, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, type ChatAddBookmarkPayload, ChatRenameBookmarkPayloadSchema, type ChatRenameBookmarkPayload, ChatRemoveBookmarkPayloadSchema, type ChatRemoveBookmarkPayload, ChatBookmarksResultSchema, type ChatBookmarksResult, ChatBookmarksEventSchema, type ChatBookmarksEvent, ChatRemoveVisualPayloadSchema, type ChatRemoveVisualPayload, ChatVisualsResultSchema, type ChatVisualsResult, ChatVisualsEventSchema, type ChatVisualsEvent, ChatAttachResultSchema, type ChatAttachResult, ChatDeliverySchema, type ChatDelivery, ChatSendPayloadSchema, type ChatSendPayload, ChatSendResultSchema, type ChatSendResult, ChatUiChoicePayloadSchema, type ChatUiChoicePayload, ChatUiQueryPayloadSchema, type ChatUiQueryPayload, ChatUiLinkPayloadSchema, type ChatUiLinkPayload, ChatQueuePayloadSchema, type ChatQueuePayload, ChatUnqueueResultSchema, type ChatUnqueueResult, ChatApprovePayloadSchema, type ChatApprovePayload, ChatDismissPayloadSchema, type ChatDismissPayload, ChatAnswerPayloadSchema, type ChatAnswerPayload, ChatTurnDiffPayloadSchema, type ChatTurnDiffPayload, ChatTurnDiffResultSchema, type ChatTurnDiffResult, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, type ChatForkPayload, ChatForkResultSchema, type ChatForkResult, ChatContinueOnPayloadSchema, type ChatContinueOnPayload, ChatContinueOnResultSchema, type ChatContinueOnResult, ChatSummarizePayloadSchema, type ChatSummarizePayload, ChatSummarizeResultSchema, type ChatSummarizeResult, ChatForkInfoPayloadSchema, type ChatForkInfoPayload, ChatForkInfoResultSchema, type ChatForkInfoResult, ChatListResultSchema, type ChatListResult, GeneratedImageInputSchema, type GeneratedImageInput, generatedImageAttachment } from './chat.ts';
+export { ErrorSchema, type WireError, RequestSchema, type Request, ReplyOkSchema, type ReplyOk, ReplyErrorSchema, type ReplyError, ReplySchema, type Reply, EventSchema, type Event, ServerFrameSchema, type ServerFrame, type ParseResult, parseRequest, parseServerFrame } from './envelope.ts';
+export { SessionIdSchema, type SessionId } from './ids.ts';
+export { ModelOptionChoiceSchema, type ModelOptionChoice, ModelOptionDescriptorSchema, type ModelOptionDescriptor, ModelInfoSchema, type ModelInfo, ModelSelectionSchema, type ModelSelection, ModelCatalogProfileSchema, type ModelCatalogProfile, ModelCatalogEntrySchema, type ModelCatalogEntry, ModelCatalogDataSchema, type ModelCatalogData, RuntimeModeSchema, type RuntimeMode, ProviderCapabilitiesSchema, type ProviderCapabilities, ProviderInfoSchema, type ProviderInfo, ProviderListResultSchema, type ProviderListResult, resumeCommandFor } from './model.ts';
+export type { FramePort } from './port.ts';
+export { EmptySchema, AGENT_REQUEST_SCHEMAS, AGENT_EVENT_SCHEMAS, type AgentRequestType, type AgentEventType } from './protocol.ts';
+export { ProviderAccountIdSchema, type ProviderAccountId, ProviderAccountVariableSchema, type ProviderAccountVariable, ProviderAccountSchema, type ProviderAccount, ProviderAccountStateSchema, type ProviderAccountState, ProviderAccountStatusSchema, type ProviderAccountStatus, ProviderAccountMapSchema, type ProviderAccountMap, ProviderAccountsSchema, type ProviderAccounts, ProviderAccountsSavePayloadSchema, type ProviderAccountsSavePayload, ProviderAccountCreatePayloadSchema, type ProviderAccountCreatePayload, ProviderAccountCreateResultSchema, type ProviderAccountCreateResult, ProviderAccountWatchLoginPayloadSchema, type ProviderAccountWatchLoginPayload } from './provider-accounts.ts';
+export { isRecord } from './record.ts';
+export { TaskStatusSchema, type TaskStatus, TaskResultSchema, type TaskResult, TaskSchema, type Task, TaskChangedEventSchema, type TaskChangedEvent } from './task.ts';
+export { clipText, TOOL_OUTPUT_TAIL, appendToolOutput } from './text.ts';
+export { UsageProviderSchema, type UsageProvider, USAGE_PROVIDERS, UsageResolutionSchema, type UsageResolution, UsageTotalsSchema, type UsageTotals, EMPTY_TOTALS, totalTokensOf, addTotals, UsageAccountSchema, type UsageAccount, UsageBucketSchema, type UsageBucket, UsagePriceBasisSchema, type UsagePriceBasis, UsageModelSchema, type UsageModel, UsageProjectSchema, type UsageProject, UsageSummaryPayloadSchema, type UsageSummaryPayload, UsageScanSchema, type UsageScan, UsagePricingSchema, type UsagePricing, UsageRootSchema, type UsageRoot, UsageRateSchema, type UsageRate, UsageSummaryResultSchema, type UsageSummaryResult, UsageChangedEventSchema, type UsageChangedEvent, UsageWindowSchema, type UsageWindow, UsageLimitsProviderSchema, type UsageLimitsProvider, UsageLimitsSnapshotSchema, type UsageLimitsSnapshot } from './usage.ts';
+export { VISUAL_LIMITS, VISUAL_MEASURE_WIDTHS, VisualHeightSchema, type VisualHeight, VisualLayoutSchema, type VisualLayout, ChatVisualSchema, type ChatVisual, ChatVisualsSchema, visualFrameHeight, VISUAL_BRIDGE_METHODS, type VisualAppearance, type VisualTheme, type VisualRequestId, type VisualViewport, type VisualScrollRequest, visualViewportMessage, visualScrollMessage, type VisualMessage, visualProxyReadyMessage, visualResourceReadyMessage, visualHostContextMessage, visualSizeChangedMessage, visualOpenLinkRequest, visualOpenLinkResult, parseVisualMessage, VISUAL_THEME_VARIABLES, type VisualThemeVariable, VISUAL_LIGHT_THEME, VISUAL_DARK_THEME, cleanVisualVariables, visualThemeFragment, VISUAL_PAGE_RULES, VISUAL_LAYOUT_GUIDE, VISUAL_THEME_GUIDE, injectVisualBootstrap, VISUAL_HOST_PAGE } from './visual.ts';
+export { WorktreeWorkSchema, type WorktreeWork, WorktreeSchema, type Worktree } from './worktree.ts';

package/dist/index.js

@@ -1,12 +1,14 @@
-export * from './agent.js';
-export * from './chat.js';
-export * from './envelope.js';
-export * from './ids.js';
-export * from './model.js';
-export * from './protocol.js';
-export * from './provider-accounts.js';
-export * from './task.js';
-export * from './text.js';
-export * from './usage.js';
-export * from './visual.js';
-export * from './worktree.js';
+// Public API: exports.test.ts snapshots this list, so a name added or dropped here is an API change.
+export { AgentKindSchema, AgentStatusSchema, SUGGESTED_TITLE_LIMIT, SuggestedTitleSchema, AgentRequestSchema, AgentInfoSchema, SessionStatusEventSchema, AgentResumePayloadSchema, ApprovalChoiceSchema, ApprovalRequestSchema, SessionApprovalsEventSchema, ApprovalAnswerPayloadSchema, ApprovalAnswerResultSchema, ApprovalPreferencePayloadSchema } from './agent.js';
+export { ChatIdSchema, ChatContextBreakdownSchema, ChatUsageSchema, CHAT_ATTACHMENTS_MAX_BYTES, CHAT_ATTACHMENT_MAX_BYTES, CHAT_ATTACHMENTS_MAX_COUNT, attachmentBytes, attachmentImageMime, ChatAttachmentUploadSchema, ChatAttachmentUploadsSchema, ChatAttachmentSchema, ChatUiChoiceOriginSchema, ChatUiAnswerSchema, ChatQuoteSourceSchema, ChatQueuedMessageSchema, ChatBackgroundTaskSchema, ChatTurnLimitSchema, ChatGoalStatusSchema, ChatGoalSchema, ChatQuestionSchema, ChatRequestKindSchema, CHAT_REQUEST_LIMITS, ChatRequestApprovalSchema, ChatRequestSummarySchema, ChatInfoSchema, ChatSkillSourceSchema, ChatSkillSchema, SkillsListPayloadSchema, SkillsListResultSchema, ChatUserItemSchema, ChatUiQueryReadingSchema, ChatUiLinkReadingSchema, ChatUiQueryStateSchema, ChatAssistantItemSchema, ChatThinkingItemSchema, ChatToolStateSchema, ChatToolProgressSchema, ChatFileChangeSchema, ChatSubagentStatusSchema, ChatWorkflowPhaseSchema, ChatWorkflowAgentSchema, ChatWorkflowSchema, workflowAgentRef, workflowAgentIdOf, ChatToolItemSchema, ChatSubagentUsageSchema, HOST_TASK_ORIGIN, ChatSubagentItemSchema, ChatApprovalDecisionSchema, ChatApprovalItemSchema, ChatQuestionItemSchema, ChatCheckpointFileSchema, ChatCheckpointDiffSchema, ChatTurnItemSchema, notResumedNote, abortedByMachine, WAITING_NOTE_PREFIX, ChatNoteItemSchema, ChatCompactionItemSchema, ChatItemSchema, ChatEventSchema, ChatEventEnvelopeSchema, ChatCreatePayloadSchema, ChatConfigurePayloadSchema, ChatPreferencesPayloadSchema, ChatTargetPayloadSchema, ChatClearPayloadSchema, ChatCancelPayloadSchema, ChatAttachPayloadSchema, ChatHistoryPayloadSchema, ChatHistoryPageSchema, ChatHistoryResultSchema, ChatSubagentPayloadSchema, ChatStopSubagentPayloadSchema, ChatGoalActionSchema, ChatGoalPayloadSchema, ChatStopTaskPayloadSchema, ChatSubagentPageSchema, ChatSubagentSourceSchema, ChatSubagentResultSchema, ChatStatusEventSchema, ChatSubagentChangedEventSchema, CHAT_BOOKMARK_LIMITS, ChatBookmarkSchema, ChatBookmarksSchema, ChatAddBookmarkPayloadSchema, ChatRenameBookmarkPayloadSchema, ChatRemoveBookmarkPayloadSchema, ChatBookmarksResultSchema, ChatBookmarksEventSchema, ChatRemoveVisualPayloadSchema, ChatVisualsResultSchema, ChatVisualsEventSchema, ChatAttachResultSchema, ChatDeliverySchema, ChatSendPayloadSchema, ChatSendResultSchema, ChatUiChoicePayloadSchema, ChatUiQueryPayloadSchema, ChatUiLinkPayloadSchema, ChatQueuePayloadSchema, ChatUnqueueResultSchema, ChatApprovePayloadSchema, ChatDismissPayloadSchema, ChatAnswerPayloadSchema, ChatTurnDiffPayloadSchema, ChatTurnDiffResultSchema, CHAT_FORK_TITLE_MAX, ChatForkPayloadSchema, ChatForkResultSchema, ChatContinueOnPayloadSchema, ChatContinueOnResultSchema, ChatSummarizePayloadSchema, ChatSummarizeResultSchema, ChatForkInfoPayloadSchema, ChatForkInfoResultSchema, ChatListResultSchema, GeneratedImageInputSchema, generatedImageAttachment } from './chat.js';
+export { ErrorSchema, RequestSchema, ReplyOkSchema, ReplyErrorSchema, ReplySchema, EventSchema, ServerFrameSchema, parseRequest, parseServerFrame } from './envelope.js';
+export { SessionIdSchema } from './ids.js';
+export { ModelOptionChoiceSchema, ModelOptionDescriptorSchema, ModelInfoSchema, ModelSelectionSchema, ModelCatalogProfileSchema, ModelCatalogEntrySchema, ModelCatalogDataSchema, RuntimeModeSchema, ProviderCapabilitiesSchema, ProviderInfoSchema, ProviderListResultSchema, resumeCommandFor } from './model.js';
+export { EmptySchema, AGENT_REQUEST_SCHEMAS, AGENT_EVENT_SCHEMAS } from './protocol.js';
+export { ProviderAccountIdSchema, ProviderAccountVariableSchema, ProviderAccountSchema, ProviderAccountStateSchema, ProviderAccountStatusSchema, ProviderAccountMapSchema, ProviderAccountsSchema, ProviderAccountsSavePayloadSchema, ProviderAccountCreatePayloadSchema, ProviderAccountCreateResultSchema, ProviderAccountWatchLoginPayloadSchema } from './provider-accounts.js';
+export { isRecord } from './record.js';
+export { TaskStatusSchema, TaskResultSchema, TaskSchema, TaskChangedEventSchema } from './task.js';
+export { clipText, TOOL_OUTPUT_TAIL, appendToolOutput } from './text.js';
+export { UsageProviderSchema, USAGE_PROVIDERS, UsageResolutionSchema, UsageTotalsSchema, EMPTY_TOTALS, totalTokensOf, addTotals, UsageAccountSchema, UsageBucketSchema, UsagePriceBasisSchema, UsageModelSchema, UsageProjectSchema, UsageSummaryPayloadSchema, UsageScanSchema, UsagePricingSchema, UsageRootSchema, UsageRateSchema, UsageSummaryResultSchema, UsageChangedEventSchema, UsageWindowSchema, UsageLimitsProviderSchema, UsageLimitsSnapshotSchema } from './usage.js';
+export { VISUAL_LIMITS, VISUAL_MEASURE_WIDTHS, VisualHeightSchema, VisualLayoutSchema, ChatVisualSchema, ChatVisualsSchema, visualFrameHeight, VISUAL_BRIDGE_METHODS, visualViewportMessage, visualScrollMessage, visualProxyReadyMessage, visualResourceReadyMessage, visualHostContextMessage, visualSizeChangedMessage, visualOpenLinkRequest, visualOpenLinkResult, parseVisualMessage, VISUAL_THEME_VARIABLES, VISUAL_LIGHT_THEME, VISUAL_DARK_THEME, cleanVisualVariables, visualThemeFragment, VISUAL_PAGE_RULES, VISUAL_LAYOUT_GUIDE, VISUAL_THEME_GUIDE, injectVisualBootstrap, VISUAL_HOST_PAGE } from './visual.js';
+export { WorktreeWorkSchema, WorktreeSchema } from './worktree.js';

package/dist/model.d.ts

@@ -141,6 +141,7 @@ export declare const ProviderCapabilitiesSchema: z.ZodObject<{
     denyReason: z.ZodBoolean;
     allowAlways: z.ZodBoolean;
     asyncQuestions: z.ZodBoolean;
+    steer: z.ZodOptional<z.ZodBoolean>;
     compaction: z.ZodEnum<{
         native: "native";
         none: "none";
@@ -150,6 +151,10 @@ export declare const ProviderCapabilitiesSchema: z.ZodObject<{
     reportsContextWindow: z.ZodBoolean;
     reportsThinking: z.ZodBoolean;
     slashCommands: z.ZodBoolean;
+    goals: z.ZodOptional<z.ZodEnum<{
+        command: "command";
+        native: "native";
+    }>>;
 }, z.core.$strip>;
 export type ProviderCapabilities = z.infer<typeof ProviderCapabilitiesSchema>;
 export declare const ProviderInfoSchema: z.ZodObject<{
@@ -204,6 +209,7 @@ export declare const ProviderInfoSchema: z.ZodObject<{
         denyReason: z.ZodBoolean;
         allowAlways: z.ZodBoolean;
         asyncQuestions: z.ZodBoolean;
+        steer: z.ZodOptional<z.ZodBoolean>;
         compaction: z.ZodEnum<{
             native: "native";
             none: "none";
@@ -213,6 +219,10 @@ export declare const ProviderInfoSchema: z.ZodObject<{
         reportsContextWindow: z.ZodBoolean;
         reportsThinking: z.ZodBoolean;
         slashCommands: z.ZodBoolean;
+        goals: z.ZodOptional<z.ZodEnum<{
+            command: "command";
+            native: "native";
+        }>>;
     }, z.core.$strip>;
     resumeCommand: z.ZodString;
 }, z.core.$strip>;
@@ -270,6 +280,7 @@ export declare const ProviderListResultSchema: z.ZodObject<{
             denyReason: z.ZodBoolean;
             allowAlways: z.ZodBoolean;
             asyncQuestions: z.ZodBoolean;
+            steer: z.ZodOptional<z.ZodBoolean>;
             compaction: z.ZodEnum<{
                 native: "native";
                 none: "none";
@@ -279,6 +290,10 @@ export declare const ProviderListResultSchema: z.ZodObject<{
             reportsContextWindow: z.ZodBoolean;
             reportsThinking: z.ZodBoolean;
             slashCommands: z.ZodBoolean;
+            goals: z.ZodOptional<z.ZodEnum<{
+                command: "command";
+                native: "native";
+            }>>;
         }, z.core.$strip>;
         resumeCommand: z.ZodString;
     }, z.core.$strip>>;

package/dist/model.js

@@ -91,13 +91,19 @@ export const ProviderCapabilitiesSchema = z.object({
     allowAlways: z.boolean(),
     // A question the person may leave alone while the turn goes on.
     asyncQuestions: z.boolean(),
+    // Whether a message sent while a turn runs can join that turn rather than wait for the next;
+    // absent where it cannot, which is also what a host from before this field reports.
+    steer: z.boolean().optional(),
     // Folding the context: a call of its own, a slash command sent as a turn, or nothing.
     compaction: z.enum(['native', 'prompt', 'none']),
     reportsCost: z.boolean(),
     reportsContextWindow: z.boolean(),
     // Whether the CLI hands over what the model thought before it answered.
     reportsThinking: z.boolean(),
-    slashCommands: z.boolean()
+    slashCommands: z.boolean(),
+    // How `/goal` reaches the CLI: through a protocol of its own that pauses, resumes and clears (`native`),
+    // or as the slash command alone (`command`); absent where the CLI has no goals.
+    goals: z.enum(['native', 'command']).optional()
 });
 export const ProviderInfoSchema = z.object({
     kind: AgentKindSchema,