@adecore/agent-contracts 0.17.0-beta.2 → 0.17.0

package/dist/chat.d.ts

@@ -3372,6 +3372,36 @@ export declare const ChatBookmarksEventSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ChatBookmarksEvent = z.infer<typeof ChatBookmarksEventSchema>;
+export declare const ChatRemoveVisualPayloadSchema: z.ZodObject<{
+    chatId: z.ZodString;
+    visualId: z.ZodString;
+}, z.core.$strip>;
+export type ChatRemoveVisualPayload = z.infer<typeof ChatRemoveVisualPayloadSchema>;
+export declare const ChatVisualsResultSchema: z.ZodObject<{
+    visuals: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        at: z.ZodNumber;
+        maxHeight: z.ZodNumber;
+        heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+        size: z.ZodNumber;
+        turnId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ChatVisualsResult = z.infer<typeof ChatVisualsResultSchema>;
+export declare const ChatVisualsEventSchema: z.ZodObject<{
+    chatId: z.ZodString;
+    visuals: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        at: z.ZodNumber;
+        maxHeight: z.ZodNumber;
+        heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+        size: z.ZodNumber;
+        turnId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ChatVisualsEvent = z.infer<typeof ChatVisualsEventSchema>;
 export declare const ChatAttachResultSchema: z.ZodObject<{
     info: z.ZodObject<{
         chatId: z.ZodString;
@@ -4780,6 +4810,15 @@ export declare const ChatAttachResultSchema: z.ZodObject<{
         excerpt: z.ZodString;
         createdAt: z.ZodNumber;
     }, z.core.$strip>>>;
+    visuals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        at: z.ZodNumber;
+        maxHeight: z.ZodNumber;
+        heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+        size: z.ZodNumber;
+        turnId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type ChatAttachResult = z.infer<typeof ChatAttachResultSchema>;
 export declare const ChatSendPayloadSchema: z.ZodObject<{

package/dist/chat.js

@@ -3,6 +3,7 @@ import { AgentKindSchema, AgentStatusSchema, SuggestedTitleSchema } from './agen
 import { WorktreeSchema } from './worktree.js';
 import { ModelSelectionSchema, RuntimeModeSchema } from './model.js';
 import { ProviderAccountIdSchema } from './provider-accounts.js';
+import { ChatVisualsSchema } from './visual.js';
 // The client picks the id (its node id), like a terminal session.
 export const ChatIdSchema = z.string().min(1);
 // The daemon's estimate of what `contextTokens` is made of, scaled to add up to it; `system` is whatever the thread cannot account for.
@@ -617,6 +618,11 @@ export const ChatRemoveBookmarkPayloadSchema = ChatTargetPayloadSchema.extend({
 export const ChatBookmarksResultSchema = z.object({ bookmarks: ChatBookmarksSchema });
 // The whole list after every change, to every client attached to the chat.
 export const ChatBookmarksEventSchema = z.object({ chatId: ChatIdSchema, bookmarks: ChatBookmarksSchema });
+// A person takes a visual out of the thread from its card; one that is already gone is no refusal.
+export const ChatRemoveVisualPayloadSchema = ChatTargetPayloadSchema.extend({ visualId: z.string().min(1) });
+export const ChatVisualsResultSchema = z.object({ visuals: ChatVisualsSchema });
+// The whole list after every change, to every client attached to the chat.
+export const ChatVisualsEventSchema = z.object({ chatId: ChatIdSchema, visuals: ChatVisualsSchema });
 export const ChatAttachResultSchema = z.object({
     info: ChatInfoSchema,
     items: z.array(ChatItemSchema),
@@ -626,7 +632,9 @@ export const ChatAttachResultSchema = z.object({
     // Only when `since` was honored: what happened after it, in order; `items` is then empty.
     events: z.array(ChatEventSchema).optional(),
     // Absent from a daemon that keeps no bookmarks.
-    bookmarks: ChatBookmarksSchema.optional()
+    bookmarks: ChatBookmarksSchema.optional(),
+    // Absent from a host that keeps no visuals.
+    visuals: ChatVisualsSchema.optional()
 });
 export const ChatSendPayloadSchema = z
     .object({

package/dist/index.d.ts

@@ -8,5 +8,6 @@ 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';

package/dist/index.js

@@ -8,4 +8,5 @@ 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';

package/dist/protocol.d.ts

@@ -1833,6 +1833,15 @@ export declare const AGENT_REQUEST_SCHEMAS: {
                 excerpt: z.ZodString;
                 createdAt: z.ZodNumber;
             }, z.core.$strip>>>;
+            visuals: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                at: z.ZodNumber;
+                maxHeight: z.ZodNumber;
+                heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                size: z.ZodNumber;
+                turnId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>;
     };
     readonly 'chat.detach': {
@@ -2861,6 +2870,23 @@ export declare const AGENT_REQUEST_SCHEMAS: {
             }, z.core.$strip>>;
         }, z.core.$strip>;
     };
+    readonly 'chat.removeVisual': {
+        readonly payload: z.ZodObject<{
+            chatId: z.ZodString;
+            visualId: z.ZodString;
+        }, z.core.$strip>;
+        readonly result: z.ZodObject<{
+            visuals: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                at: z.ZodNumber;
+                maxHeight: z.ZodNumber;
+                heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+                size: z.ZodNumber;
+                turnId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+    };
     readonly 'skills.list': {
         readonly payload: z.ZodObject<{
             chatId: z.ZodString;
@@ -4481,6 +4507,18 @@ export declare const AGENT_EVENT_SCHEMAS: {
             createdAt: z.ZodNumber;
         }, z.core.$strip>>;
     }, z.core.$strip>;
+    readonly 'chat.visuals': z.ZodObject<{
+        chatId: z.ZodString;
+        visuals: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            at: z.ZodNumber;
+            maxHeight: z.ZodNumber;
+            heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+            size: z.ZodNumber;
+            turnId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
     readonly 'usage.changed': z.ZodObject<{
         scannedAt: z.ZodNumber;
     }, z.core.$strip>;

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, ChatRenameBookmarkPayloadSchema, ChatSendPayloadSchema, ChatSendResultSchema, ChatStatusEventSchema, ChatStopSubagentPayloadSchema, ChatStopTaskPayloadSchema, ChatSubagentChangedEventSchema, ChatSubagentPayloadSchema, ChatSubagentResultSchema, ChatSummarizePayloadSchema, ChatSummarizeResultSchema, ChatTargetPayloadSchema, ChatTurnDiffPayloadSchema, ChatTurnDiffResultSchema, ChatUnqueueResultSchema, 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, 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';
@@ -36,6 +36,7 @@ export const AGENT_REQUEST_SCHEMAS = {
     'chat.addBookmark': { payload: ChatAddBookmarkPayloadSchema, result: ChatBookmarksResultSchema },
     'chat.renameBookmark': { payload: ChatRenameBookmarkPayloadSchema, result: ChatBookmarksResultSchema },
     'chat.removeBookmark': { payload: ChatRemoveBookmarkPayloadSchema, result: ChatBookmarksResultSchema },
+    'chat.removeVisual': { payload: ChatRemoveVisualPayloadSchema, result: ChatVisualsResultSchema },
     'skills.list': { payload: SkillsListPayloadSchema, result: SkillsListResultSchema },
     'provider.list': { payload: EmptySchema, result: ProviderListResultSchema },
     'accounts.list': { payload: EmptySchema, result: ProviderAccountsSchema },
@@ -58,6 +59,7 @@ export const AGENT_EVENT_SCHEMAS = {
     'chat.status': ChatStatusEventSchema,
     'chat.subagentChanged': ChatSubagentChangedEventSchema,
     'chat.bookmarks': ChatBookmarksEventSchema,
+    'chat.visuals': ChatVisualsEventSchema,
     'usage.changed': UsageChangedEventSchema,
     'usage.limitsChanged': UsageLimitsSnapshotSchema,
     'accounts.changed': ProviderAccountsSchema

package/dist/visual.d.ts

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+export declare const VISUAL_LIMITS: {
+    readonly title: 200;
+    readonly minHeight: 80;
+    readonly maxHeight: 2000;
+    readonly bytes: number;
+    readonly heights: 24;
+};
+export declare const VISUAL_MEASURE_WIDTHS: readonly number[];
+export declare const VisualHeightSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+export type VisualHeight = z.infer<typeof VisualHeightSchema>;
+export declare const ChatVisualSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    at: z.ZodNumber;
+    maxHeight: z.ZodNumber;
+    heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+    size: z.ZodNumber;
+    turnId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ChatVisual = z.infer<typeof ChatVisualSchema>;
+export declare const ChatVisualsSchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    at: z.ZodNumber;
+    maxHeight: z.ZodNumber;
+    heights: z.ZodOptional<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>;
+    size: z.ZodNumber;
+    turnId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare function visualFrameHeight(visual: Pick<ChatVisual, 'maxHeight' | 'heights'>, width: number): number | undefined;
+export declare const VISUAL_BRIDGE_METHODS: {
+    readonly sandboxProxyReady: 'ui/notifications/sandbox-proxy-ready';
+    readonly sandboxResourceReady: 'ui/notifications/sandbox-resource-ready';
+    readonly hostContextChanged: 'ui/notifications/host-context-changed';
+    readonly sizeChanged: 'ui/notifications/size-changed';
+    readonly openLink: 'ui/open-link';
+};
+export type VisualAppearance = 'light' | 'dark';
+export interface VisualTheme {
+    appearance: VisualAppearance;
+    variables: Readonly<Record<string, string>>;
+}
+export type VisualRequestId = string | number;
+export type VisualMessage = {
+    method: typeof VISUAL_BRIDGE_METHODS.sandboxProxyReady;
+} | {
+    method: typeof VISUAL_BRIDGE_METHODS.sandboxResourceReady;
+    html: string;
+} | {
+    method: typeof VISUAL_BRIDGE_METHODS.hostContextChanged;
+    theme: VisualTheme;
+} | {
+    method: typeof VISUAL_BRIDGE_METHODS.sizeChanged;
+    width?: number;
+    height: number;
+} | {
+    method: typeof VISUAL_BRIDGE_METHODS.openLink;
+    id: VisualRequestId;
+    url: string;
+};
+export declare function visualProxyReadyMessage(): {
+    readonly jsonrpc: '2.0';
+    readonly method: "ui/notifications/sandbox-proxy-ready";
+};
+export declare function visualResourceReadyMessage(html: string): {
+    readonly jsonrpc: '2.0';
+    readonly method: "ui/notifications/sandbox-resource-ready";
+    readonly params: {
+        readonly html: string;
+    };
+};
+export declare function visualHostContextMessage(theme: VisualTheme): {
+    readonly jsonrpc: '2.0';
+    readonly method: "ui/notifications/host-context-changed";
+    readonly params: {
+        readonly theme: VisualAppearance;
+        readonly styles: {
+            readonly variables: {
+                readonly [x: string]: string;
+            };
+        };
+    };
+};
+export declare function visualSizeChangedMessage(size: {
+    width: number;
+    height: number;
+}): {
+    readonly jsonrpc: '2.0';
+    readonly method: "ui/notifications/size-changed";
+    readonly params: {
+        readonly width: number;
+        readonly height: number;
+    };
+};
+export declare function visualOpenLinkRequest(id: VisualRequestId, url: string): {
+    readonly jsonrpc: '2.0';
+    readonly id: VisualRequestId;
+    readonly method: "ui/open-link";
+    readonly params: {
+        readonly url: string;
+    };
+};
+export declare function visualOpenLinkResult(id: VisualRequestId): {
+    readonly jsonrpc: '2.0';
+    readonly id: VisualRequestId;
+    readonly result: {};
+};
+export declare function parseVisualMessage(data: unknown): VisualMessage | undefined;
+export declare const VISUAL_THEME_VARIABLES: readonly ['--background', '--foreground', '--muted', '--muted-foreground', '--card', '--card-foreground', '--popover', '--popover-foreground', '--secondary', '--secondary-foreground', '--border', '--input', '--ring', '--primary', '--primary-foreground', '--accent', '--accent-foreground', '--destructive', '--destructive-foreground', '--warning', '--warning-foreground', '--success', '--success-foreground', '--info', '--info-foreground', '--code-background', '--code-foreground', '--chart-1', '--chart-2', '--chart-3', '--chart-4', '--chart-5', '--chart-6', '--radius', '--font-sans', '--font-mono'];
+export type VisualThemeVariable = (typeof VISUAL_THEME_VARIABLES)[number];
+export declare const VISUAL_LIGHT_THEME: VisualTheme;
+export declare const VISUAL_DARK_THEME: VisualTheme;
+export declare function cleanVisualVariables(input: unknown): Record<string, string>;
+export declare function visualThemeFragment(theme: VisualTheme): string;
+export declare const VISUAL_PAGE_RULES: string;
+export declare const VISUAL_LAYOUT_GUIDE: string;
+export declare const VISUAL_THEME_GUIDE: string;
+export declare function injectVisualBootstrap(html: string): string;
+export declare const VISUAL_HOST_PAGE: string;