@adecore/agent-contracts 0.20.1 → 0.21.1

package/dist/protocol.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { ChatAddBookmarkPayloadSchema, ChatAnswerPayloadSchema, ChatApprovePayloadSchema, ChatAttachPayloadSchema, ChatAttachResultSchema, ChatBookmarksEventSchema, ChatBookmarksResultSchema, ChatCancelPayloadSchema, ChatClearPayloadSchema, ChatConfigurePayloadSchema, ChatContinueOnPayloadSchema, ChatContinueOnResultSchema, ChatCreatePayloadSchema, ChatDismissPayloadSchema, ChatEventEnvelopeSchema, ChatForkInfoPayloadSchema, ChatForkInfoResultSchema, ChatForkPayloadSchema, ChatForkResultSchema, ChatHistoryPayloadSchema, ChatHistoryResultSchema, ChatInfoSchema, ChatListResultSchema, ChatPreferencesPayloadSchema, ChatQueuePayloadSchema, ChatRemoveBookmarkPayloadSchema, ChatRemoveVisualPayloadSchema, ChatRenameBookmarkPayloadSchema, ChatSendPayloadSchema, ChatSendResultSchema, ChatStatusEventSchema, ChatStopSubagentPayloadSchema, ChatStopTaskPayloadSchema, ChatSubagentChangedEventSchema, ChatSubagentPayloadSchema, ChatSubagentResultSchema, ChatSummarizePayloadSchema, ChatSummarizeResultSchema, ChatTargetPayloadSchema, ChatTurnDiffPayloadSchema, ChatTurnDiffResultSchema, ChatUnqueueResultSchema, ChatVisualsEventSchema, ChatVisualsResultSchema, SkillsListPayloadSchema, SkillsListResultSchema } from './chat.js';
+import { ChatAddBookmarkPayloadSchema, ChatAnswerPayloadSchema, ChatApprovePayloadSchema, ChatAttachPayloadSchema, ChatAttachResultSchema, ChatBookmarksEventSchema, ChatBookmarksResultSchema, ChatCancelPayloadSchema, ChatClearPayloadSchema, ChatConfigurePayloadSchema, ChatContinueOnPayloadSchema, ChatContinueOnResultSchema, ChatCreatePayloadSchema, ChatDismissPayloadSchema, ChatEventEnvelopeSchema, ChatForkInfoPayloadSchema, ChatForkInfoResultSchema, ChatForkPayloadSchema, ChatForkResultSchema, ChatHistoryPayloadSchema, ChatHistoryResultSchema, ChatInfoSchema, ChatListResultSchema, ChatPreferencesPayloadSchema, ChatQueuePayloadSchema, ChatRemoveBookmarkPayloadSchema, ChatRemoveVisualPayloadSchema, ChatRenameBookmarkPayloadSchema, ChatSendPayloadSchema, ChatSendResultSchema, ChatUiChoicePayloadSchema, ChatUiLinkPayloadSchema, ChatUiLinkReadingSchema, ChatUiQueryPayloadSchema, ChatUiQueryReadingSchema, ChatStatusEventSchema, ChatStopSubagentPayloadSchema, ChatStopTaskPayloadSchema, ChatSubagentChangedEventSchema, ChatSubagentPayloadSchema, ChatSubagentResultSchema, ChatSummarizePayloadSchema, ChatSummarizeResultSchema, ChatTargetPayloadSchema, ChatTurnDiffPayloadSchema, ChatTurnDiffResultSchema, ChatUnqueueResultSchema, ChatVisualsEventSchema, ChatVisualsResultSchema, SkillsListPayloadSchema, SkillsListResultSchema } from './chat.js';
 import { ProviderListResultSchema } from './model.js';
 import { ProviderAccountCreatePayloadSchema, ProviderAccountCreateResultSchema, ProviderAccountWatchLoginPayloadSchema, ProviderAccountsSavePayloadSchema, ProviderAccountsSchema } from './provider-accounts.js';
 import { UsageChangedEventSchema, UsageLimitsSnapshotSchema, UsageSummaryPayloadSchema, UsageSummaryResultSchema } from './usage.js';
@@ -15,6 +15,9 @@ export const AGENT_REQUEST_SCHEMAS = {
     'chat.attach': { payload: ChatAttachPayloadSchema, result: ChatAttachResultSchema },
     'chat.detach': { payload: ChatTargetPayloadSchema, result: EmptySchema },
     'chat.send': { payload: ChatSendPayloadSchema, result: ChatSendResultSchema },
+    'chat.uiChoice': { payload: ChatUiChoicePayloadSchema, result: ChatSendResultSchema },
+    'ui.link': { payload: ChatUiLinkPayloadSchema, result: ChatUiLinkReadingSchema },
+    'ui.query': { payload: ChatUiQueryPayloadSchema, result: ChatUiQueryReadingSchema },
     'chat.unqueue': { payload: ChatQueuePayloadSchema, result: ChatUnqueueResultSchema },
     'chat.sendNow': { payload: ChatQueuePayloadSchema, result: EmptySchema },
     'chat.cancel': { payload: ChatCancelPayloadSchema, result: EmptySchema },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agent-contracts",
-  "version": "0.20.1",
+  "version": "0.21.1",
   "description": "Schemas and port contracts for agent chats, provider accounts, models and usage.",
   "type": "module",
   "exports": {
@@ -81,6 +81,7 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
+    "@adecore/intelligent-ui": "0.21.1",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/chat.ts

@@ -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.ts';
 import { WorktreeSchema } from './worktree.ts';
 import { ModelSelectionSchema, RuntimeModeSchema } from './model.ts';
@@ -95,10 +97,31 @@ 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 type ChatAttachment = z.infer<typeof ChatAttachmentSchema>;
 
+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 type ChatUiChoiceOrigin = z.infer<typeof ChatUiChoiceOriginSchema>;
+
+export const ChatUiAnswerSchema = ChatUiChoiceOriginSchema.extend({
+    queued: z.boolean(),
+    turnId: z.string().min(1)
+});
+export type ChatUiAnswer = z.infer<typeof ChatUiAnswerSchema>;
+
 // A message typed while a turn was running; the daemon sends it when that turn settles.
 export const ChatQueuedMessageSchema = z.object({
     id: z.string().min(1),
@@ -109,7 +132,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()
 });
 export type ChatQueuedMessage = z.infer<typeof ChatQueuedMessageSchema>;
 
@@ -279,12 +303,47 @@ 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 type ChatUiQueryReading = z.infer<typeof ChatUiQueryReadingSchema>;
+
+export const ChatUiLinkReadingSchema = UiLinkResolutionSchema;
+export type ChatUiLinkReading = z.infer<typeof ChatUiLinkReadingSchema>;
+
+// 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 type ChatUiQueryState = z.infer<typeof ChatUiQueryStateSchema>;
+
 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.
@@ -584,7 +643,14 @@ export type ChatCompactionItem = z.infer<typeof ChatCompactionItemSchema>;
 // 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) })
 ]);
@@ -696,6 +762,8 @@ export type ChatSubagentSource = z.infer<typeof ChatSubagentSourceSchema>;
 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.
@@ -809,6 +877,30 @@ export type ChatSendPayload = z.infer<typeof ChatSendPayloadSchema>;
 export const ChatSendResultSchema = z.object({ queued: z.boolean(), turnId: z.string().min(1).optional() });
 export type ChatSendResult = z.infer<typeof ChatSendResultSchema>;
 
+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 type ChatUiChoicePayload = z.infer<typeof ChatUiChoicePayloadSchema>;
+
+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 type ChatUiQueryPayload = z.infer<typeof ChatUiQueryPayloadSchema>;
+
+export const ChatUiLinkPayloadSchema = ChatUiChoicePayloadSchema.omit({ choiceId: true }).extend({ nodeId: z.string().min(1).max(256) });
+export type ChatUiLinkPayload = z.infer<typeof ChatUiLinkPayloadSchema>;
+
 export const ChatQueuePayloadSchema = z.object({
     chatId: ChatIdSchema,
     messageId: z.string().min(1)
@@ -940,3 +1032,18 @@ export const ChatListResultSchema = z.object({
     chats: z.array(ChatInfoSchema)
 });
 export type ChatListResult = z.infer<typeof ChatListResultSchema>;
+
+export const GeneratedImageInputSchema = z.object({
+    attachment: ChatAttachmentSchema.optional(),
+    revisedPrompt: z.string().optional(),
+    transparentBackground: z.boolean().optional()
+});
+export type GeneratedImageInput = z.infer<typeof GeneratedImageInputSchema>;
+
+export function generatedImageAttachment(item: ChatItem): ChatAttachment | null {
+    if (item.kind !== 'tool' || item.name !== 'ImageGeneration') {
+        return null;
+    }
+    const parsed = GeneratedImageInputSchema.safeParse(item.input);
+    return parsed.success ? (parsed.data.attachment ?? null) : null;
+}

package/src/protocol.ts

@@ -30,6 +30,11 @@ import {
     ChatRenameBookmarkPayloadSchema,
     ChatSendPayloadSchema,
     ChatSendResultSchema,
+    ChatUiChoicePayloadSchema,
+    ChatUiLinkPayloadSchema,
+    ChatUiLinkReadingSchema,
+    ChatUiQueryPayloadSchema,
+    ChatUiQueryReadingSchema,
     ChatStatusEventSchema,
     ChatStopSubagentPayloadSchema,
     ChatStopTaskPayloadSchema,
@@ -70,6 +75,9 @@ export const AGENT_REQUEST_SCHEMAS = {
     'chat.attach': { payload: ChatAttachPayloadSchema, result: ChatAttachResultSchema },
     'chat.detach': { payload: ChatTargetPayloadSchema, result: EmptySchema },
     'chat.send': { payload: ChatSendPayloadSchema, result: ChatSendResultSchema },
+    'chat.uiChoice': { payload: ChatUiChoicePayloadSchema, result: ChatSendResultSchema },
+    'ui.link': { payload: ChatUiLinkPayloadSchema, result: ChatUiLinkReadingSchema },
+    'ui.query': { payload: ChatUiQueryPayloadSchema, result: ChatUiQueryReadingSchema },
     'chat.unqueue': { payload: ChatQueuePayloadSchema, result: ChatUnqueueResultSchema },
     'chat.sendNow': { payload: ChatQueuePayloadSchema, result: EmptySchema },
     'chat.cancel': { payload: ChatCancelPayloadSchema, result: EmptySchema },