@adecore/agent-contracts 0.20.1 → 0.21.1

package/dist/chat.js

@@ -1,4 +1,6 @@
+import { UiLinkResolutionSchema } from '@adecore/intelligent-ui/links';
 import { z } from 'zod';
+import { UiBlocksSchema } from '@adecore/intelligent-ui/protocol';
 import { AgentKindSchema, AgentStatusSchema, SuggestedTitleSchema } from './agent.js';
 import { WorktreeSchema } from './worktree.js';
 import { ModelSelectionSchema, RuntimeModeSchema } from './model.js';
@@ -80,7 +82,24 @@ export const ChatAttachmentSchema = z.object({
     mime: z.string(),
     size: z.number().int().nonnegative(),
     // Absolute, on the machine the daemon runs on.
-    path: z.string()
+    path: z.string(),
+    width: z.number().int().positive().optional(),
+    height: z.number().int().positive().optional()
+});
+export const ChatUiChoiceOriginSchema = z.object({
+    itemId: z.string().min(1),
+    blockId: z.string().min(1),
+    revision: z.string().min(1),
+    choiceId: z.string().min(1),
+    label: z.string().min(1),
+    sourceAt: z.number().nonnegative(),
+    older: z.boolean(),
+    values: z.record(z.string(), z.unknown()).optional(),
+    at: z.number().nonnegative()
+});
+export const ChatUiAnswerSchema = ChatUiChoiceOriginSchema.extend({
+    queued: z.boolean(),
+    turnId: z.string().min(1)
 });
 // A message typed while a turn was running; the daemon sends it when that turn settles.
 export const ChatQueuedMessageSchema = z.object({
@@ -92,7 +111,8 @@ export const ChatQueuedMessageSchema = z.object({
     skills: z.array(z.string()).optional(),
     chats: z.array(z.string()).optional(),
     attachments: z.array(ChatAttachmentSchema).optional(),
-    createdAt: z.number()
+    createdAt: z.number(),
+    uiChoice: ChatUiChoiceOriginSchema.optional()
 });
 // A command or a monitor the CLI keeps running beside its turns, until it ends or its process does.
 export const ChatBackgroundTaskSchema = z.object({
@@ -236,11 +256,37 @@ export const ChatUserItemSchema = z.object({
     skills: z.array(z.string()).optional(),
     // Chats of the same project the person picked with `@`. Only their ids travel; the agent reads them itself.
     chats: z.array(z.string()).optional(),
-    attachments: z.array(ChatAttachmentSchema).optional()
+    attachments: z.array(ChatAttachmentSchema).optional(),
+    uiChoice: ChatUiChoiceOriginSchema.optional()
+});
+// `state` is a frozen set: native clients validate these payloads whole, so a new state would fail them.
+export const ChatUiQueryReadingSchema = z.object({
+    state: z.enum(['fresh', 'failed', 'refused']),
+    value: z.unknown().optional(),
+    readId: z.string().optional(),
+    readAt: z.number().nonnegative(),
+    // A code that names the reason across versions, for a client that says it in its own words; open, so a new one fails nobody.
+    code: z.string().optional(),
+    reason: z.string().optional()
+});
+export const ChatUiLinkReadingSchema = UiLinkResolutionSchema;
+// The writer's captured access stays on the daemon; a record from before that still parses and drops it.
+export const ChatUiQueryStateSchema = z.object({
+    authorChatId: z.string(),
+    blocks: z.record(z.string(), z.object({
+        revision: z.string(),
+        readings: z.record(z.string(), ChatUiQueryReadingSchema),
+        fallback: z.string(),
+        links: z.record(z.string(), ChatUiLinkReadingSchema).optional()
+    }))
 });
 export const ChatAssistantItemSchema = z.object({
     ...base,
     kind: z.literal('assistant'),
+    ui: UiBlocksSchema.optional(),
+    uiAnswers: z.record(z.string(), ChatUiAnswerSchema).optional(),
+    uiQueries: ChatUiQueryStateSchema.optional(),
+    phase: z.string().optional(),
     text: z.string(),
     streaming: z.boolean(),
     // Set for text a subagent wrote, with the id of the Agent call that spawned it.
@@ -486,7 +532,14 @@ export const ChatItemSchema = z.discriminatedUnion('kind', [
 // Events apply after the `chat.attach` snapshot; item ids make upserts and streamed deltas replayable.
 export const ChatEventSchema = z.discriminatedUnion('type', [
     z.object({ type: z.literal('item'), item: ChatItemSchema, historyIndex: z.number().int().nonnegative().optional() }),
-    z.object({ type: z.literal('delta'), itemId: z.string(), text: z.string() }),
+    z.object({
+        type: z.literal('delta'),
+        itemId: z.string(),
+        text: z.string(),
+        ui: UiBlocksSchema.optional(),
+        uiQueries: ChatUiQueryStateSchema.optional(),
+        textLength: z.number().int().nonnegative().optional()
+    }),
     z.object({ type: z.literal('info'), info: ChatInfoSchema }),
     z.object({ type: z.literal('reset'), info: ChatInfoSchema, items: z.array(ChatItemSchema) })
 ]);
@@ -571,6 +624,8 @@ export const ChatSubagentSourceSchema = z.enum(['claude-transcript', 'codex-thre
 export const ChatSubagentResultSchema = z.object({
     items: z.array(ChatItemSchema),
     history: ChatSubagentPageSchema,
+    // A request still waiting must remain answerable after it leaves the newest page.
+    pending: z.array(z.union([ChatApprovalItemSchema, ChatQuestionItemSchema])).optional(),
     source: ChatSubagentSourceSchema,
     context: z.object({ provider: AgentKindSchema, cwd: z.string(), chatId: ChatIdSchema.optional() }).optional(),
     // Whether the subagent is still writing, so a client knows to keep reading.
@@ -650,6 +705,24 @@ export const ChatSendPayloadSchema = z
     .refine((payload) => payload.text.trim() !== '' || (payload.attachments?.length ?? 0) > 0, { message: 'A message needs text or an attachment' });
 // Daemons before completion follow-ups omit `turnId`; keeping it optional lets newer clients finish the send.
 export const ChatSendResultSchema = z.object({ queued: z.boolean(), turnId: z.string().min(1).optional() });
+export const ChatUiChoicePayloadSchema = z.object({
+    chatId: ChatIdSchema,
+    itemId: z.string().min(1).max(256),
+    blockId: z.string().min(1).max(256),
+    revision: z.string().min(1).max(128),
+    choiceId: z.string().min(1).max(256),
+    reads: z.record(z.string().max(128), z.string().max(128)).optional(),
+    values: z.record(z.string().max(128), z.unknown()).optional()
+});
+export const ChatUiQueryPayloadSchema = z.object({
+    chatId: ChatIdSchema,
+    itemId: z.string().min(1).max(256),
+    blockId: z.string().min(1).max(256),
+    revision: z.string().min(1).max(128),
+    query: z.string().min(1).max(128),
+    values: z.record(z.string().max(128), z.unknown()).optional()
+});
+export const ChatUiLinkPayloadSchema = ChatUiChoicePayloadSchema.omit({ choiceId: true }).extend({ nodeId: z.string().min(1).max(256) });
 export const ChatQueuePayloadSchema = z.object({
     chatId: ChatIdSchema,
     messageId: z.string().min(1)
@@ -749,3 +822,15 @@ export const ChatForkInfoResultSchema = z.object({
 export const ChatListResultSchema = z.object({
     chats: z.array(ChatInfoSchema)
 });
+export const GeneratedImageInputSchema = z.object({
+    attachment: ChatAttachmentSchema.optional(),
+    revisedPrompt: z.string().optional(),
+    transparentBackground: z.boolean().optional()
+});
+export function generatedImageAttachment(item) {
+    if (item.kind !== 'tool' || item.name !== 'ImageGeneration') {
+        return null;
+    }
+    const parsed = GeneratedImageInputSchema.safeParse(item.input);
+    return parsed.success ? (parsed.data.attachment ?? null) : null;
+}