@adecore/agent-contracts 0.38.0 → 0.40.0

package/dist/chat.js

@@ -107,9 +107,9 @@ 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.
 /* The reply a quoted passage was taken from, so a client can lead the reader back to it. */
 export const ChatQuoteSourceSchema = z.object({ itemId: z.string().min(1).max(256) });
+// 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),
     // Older saved queues have no reserved turn yet; draining them still mints one.
@@ -430,13 +430,13 @@ export const ChatSubagentUsageSchema = z.object({
     toolUses: z.number().int().nonnegative(),
     durationMs: z.number().int().nonnegative()
 });
+// 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';
 /*
  * One agent the agent delegated to, foreground or background. Its own work stays in the thread as
  * 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'),

package/dist/text.js

@@ -1,4 +1,4 @@
-const graphemes = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+let graphemes;
 /*
  * The longest start of `text` that fits in `max` UTF-16 units, the measure a schema's `max` counts in,
  * cut only between characters as a person sees them. A cut between the halves of a surrogate pair
@@ -8,6 +8,7 @@ export function clipText(text, max) {
     if (text.length <= max) {
         return text;
     }
+    graphemes ??= new Intl.Segmenter(undefined, { granularity: 'grapheme' });
     let end = 0;
     for (const { segment } of graphemes.segment(text)) {
         if (end + segment.length > max) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agent-contracts",
-  "version": "0.38.0",
+  "version": "0.40.0",
   "description": "Schemas and port contracts for agent chats, provider accounts, models and usage.",
   "type": "module",
   "exports": {
@@ -86,11 +86,11 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
-    "@adecore/intelligent-ui": "0.38.0",
-    "zod": "^4.6.5"
+    "@adecore/intelligent-ui": "0.40.0",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@types/bun": "^1.4.2",
+    "@types/bun": "^1.4.4",
     "typescript": "^7.0.2"
   },
   "license": "FSL-1.1-MIT",

package/src/agent.ts

@@ -17,6 +17,7 @@ export const AgentKindSchema = z
     .min(1)
     .max(AGENT_KIND_MAX_LENGTH)
     .regex(/^[a-z][a-z0-9-]*$/);
+
 export type AgentKind = KnownAgentKind | (string & {});
 
 export function isKnownAgentKind(kind: string): kind is KnownAgentKind {

package/src/chat.ts

@@ -60,18 +60,23 @@ const IMAGE_MIME_BY_EXTENSION = new Map([
     ['webp', 'image/webp'],
     ['gif', 'image/gif']
 ]);
+
 const IMAGE_MIME_TYPES = new Set(IMAGE_MIME_BY_EXTENSION.values());
 
 // A generic MIME type from Finder may still name a picture; a declared PDF must stay a PDF.
 export function attachmentImageMime({ name, mime }: { name: string; mime: string }): string | null {
     const type = mime.split(';')[0]!.trim().toLowerCase();
+
     if (IMAGE_MIME_TYPES.has(type)) {
         return type;
     }
+
     if (type !== '' && type !== 'application/octet-stream' && type !== 'binary/octet-stream') {
         return null;
     }
+
     const dot = name.lastIndexOf('.');
+
     return dot < 0 ? null : (IMAGE_MIME_BY_EXTENSION.get(name.slice(dot + 1).toLowerCase()) ?? null);
 }
 
@@ -129,11 +134,11 @@ export const ChatUiAnswerSchema = ChatUiChoiceOriginSchema.extend({
 });
 export type ChatUiAnswer = z.infer<typeof ChatUiAnswerSchema>;
 
-// A message typed while a turn was running; the daemon sends it when that turn settles.
 /* The reply a quoted passage was taken from, so a client can lead the reader back to it. */
 export const ChatQuoteSourceSchema = z.object({ itemId: z.string().min(1).max(256) });
 export type ChatQuoteSource = z.infer<typeof ChatQuoteSourceSchema>;
 
+// 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),
     // Older saved queues have no reserved turn yet; draining them still mints one.
@@ -518,14 +523,14 @@ export const ChatSubagentUsageSchema = z.object({
 });
 export type ChatSubagentUsage = z.infer<typeof ChatSubagentUsageSchema>;
 
+// 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';
+
 /*
  * One agent the agent delegated to, foreground or background. Its own work stays in the thread as
  * 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'),
@@ -733,6 +738,7 @@ export function activeSubagents(items: readonly ChatItem[]): ChatSubagentItem[]
     const lastMessageAt = lastMessage < 0 ? null : items[lastMessage]!.createdAt;
     const rows = items.flatMap((item, index) => (item.kind === 'subagent' ? [{ item, index }] : []));
     const turns = new Set(rows.flatMap(({ item }) => (item.status === 'running' && item.turnId !== null ? [item.turnId] : [])));
+
     return rows
         .filter(
             ({ item, index }) =>
@@ -824,14 +830,17 @@ export const ChatAttachPayloadSchema = ChatTargetPayloadSchema.extend({
     // The last seq this client saw; honored when the daemon still holds everything after it.
     since: z.number().int().nonnegative().optional()
 });
+
 export const ChatHistoryPayloadSchema = ChatTargetPayloadSchema.extend({
     cursor: z.string().min(1).max(128),
     limit: z.number().int().min(1).max(100).optional()
 });
+
 export const ChatHistoryPageSchema = z.object({
     start: z.number().int().nonnegative(),
     cursor: z.string().nullable()
 });
+
 export const ChatHistoryResultSchema = z.object({ items: z.array(ChatItemSchema), history: ChatHistoryPageSchema });
 export type ChatHistoryResult = z.infer<typeof ChatHistoryResultSchema>;
 
@@ -1159,6 +1168,8 @@ 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/envelope.ts

@@ -47,6 +47,7 @@ function toResult<T>(parsed: z.ZodSafeParseResult<T>): ParseResult<T> {
     if (parsed.success) {
         return { ok: true, value: parsed.data };
     }
+
     return { ok: false, message: z.prettifyError(parsed.error) };
 }
 

package/src/model.ts

@@ -155,6 +155,7 @@ export const ProviderInstallSchema = z.object({
     signIn: z.array(z.unknown()).transform((ways) =>
         ways.flatMap((way) => {
             const parsed = ProviderSignInSchema.safeParse(way);
+
             return parsed.success ? [parsed.data] : [];
         })
     )
@@ -204,7 +205,9 @@ export function pickerGroupsOf<T extends { kind: AgentKind; name: string }>(prov
     nameCollator ??= new Intl.Collator(undefined, { sensitivity: 'base' });
     const collator = nameCollator;
     const sorted = [...providers].sort((a, b) => collator.compare(a.name, b.name));
+
     const inGroup = (group: ProviderPickerGroup): T[] => sorted.filter((provider) => providerGroupOf(provider.kind) === group);
+
     return { frontier: inGroup('frontier'), others: inGroup('others'), api: inGroup('api') };
 }
 
@@ -220,6 +223,7 @@ export type ProviderListResult = z.infer<typeof ProviderListResultSchema>;
  */
 export function resumeCommandFor(template: string, agentSessionId: string, flags: string[] = []): string {
     const id = `'${agentSessionId.replaceAll("'", `'\\''`)}'`;
+
     return template
         .split(' ')
         .flatMap((word) => (word === '{flags}' ? flags : [word.replace('{id}', id)]))

package/src/text.ts

@@ -1,4 +1,4 @@
-const graphemes = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+let graphemes: Intl.Segmenter | undefined;
 
 /*
  * The longest start of `text` that fits in `max` UTF-16 units, the measure a schema's `max` counts in,
@@ -9,13 +9,18 @@ export function clipText(text: string, max: number): string {
     if (text.length <= max) {
         return text;
     }
+
+    graphemes ??= new Intl.Segmenter(undefined, { granularity: 'grapheme' });
     let end = 0;
+
     for (const { segment } of graphemes.segment(text)) {
         if (end + segment.length > max) {
             break;
         }
+
         end += segment.length;
     }
+
     return text.slice(0, end);
 }
 
@@ -26,12 +31,16 @@ export const TOOL_OUTPUT_TAIL = 64 * 1024;
 export function appendToolOutput(output: string | null, text: string): string {
     const whole = (output ?? '') + text;
     let start = whole.length - TOOL_OUTPUT_TAIL;
+
     if (start <= 0) {
         return whole;
     }
+
     const unit = whole.charCodeAt(start);
+
     if (unit >= 0xdc00 && unit <= 0xdfff) {
         start += 1;
     }
+
     return whole.slice(start);
 }

package/src/usage.ts

@@ -4,6 +4,7 @@ import { ProviderAccountIdSchema } from './provider-accounts.ts';
 /* The providers whose usage the daemon reads: the CLIs' own records, and the log a host keeps of what it calls itself. A subset of `AgentKindSchema`: it grows with the readers. */
 export const UsageProviderSchema = z.enum(['claude', 'codex', 'nanogpt', 'grok', 'copilot', 'anthropic-claude-api']);
 export type UsageProvider = z.infer<typeof UsageProviderSchema>;
+
 export const USAGE_PROVIDERS = UsageProviderSchema.options;
 
 export const UsageResolutionSchema = z.enum(['hour', 'day']);
@@ -194,8 +195,10 @@ export function evenPace(window: UsageWindow, now: number): EvenPace | null {
     if (window.resetsAt === null || window.durationMs === null || window.durationMs <= 0) {
         return null;
     }
+
     const percent = Math.round(Math.min(1, Math.max(0, 1 - (window.resetsAt - now) / window.durationMs)) * 100);
     const used = Math.round(window.used * 100);
+
     return { percent, standing: used > percent ? 'ahead' : used < percent ? 'behind' : 'even' };
 }
 

package/src/visual.ts

@@ -63,17 +63,21 @@ function clampHeight(height: number): number {
 export function visualFrameHeight(visual: Pick<ChatVisual, 'maxHeight' | 'heights'>, width: number): number | undefined {
     let below: VisualHeight | undefined;
     let above: VisualHeight | undefined;
+
     for (const measured of visual.heights ?? []) {
         if (measured[0] <= width && (below === undefined || measured[0] > below[0])) {
             below = measured;
         }
+
         if (measured[0] >= width && (above === undefined || measured[0] < above[0])) {
             above = measured;
         }
     }
+
     if (below === undefined && above === undefined) {
         return undefined;
     }
+
     return clampHeight(Math.min(Math.max(below?.[1] ?? 0, above?.[1] ?? 0), visual.maxHeight));
 }
 
@@ -174,8 +178,10 @@ function webUrl(value: unknown): string | undefined {
     if (typeof value !== 'string') {
         return undefined;
     }
+
     try {
         const url = new (globalThis as unknown as { URL: UrlParser }).URL(value);
+
         return url.protocol === 'http:' || url.protocol === 'https:' ? url.href : undefined;
     } catch {
         return undefined;
@@ -190,7 +196,9 @@ export function parseVisualMessage(data: unknown): VisualMessage | undefined {
     if (!isRecord(data) || data.jsonrpc !== '2.0' || typeof data.method !== 'string') {
         return undefined;
     }
+
     const params = isRecord(data.params) ? data.params : {};
+
     switch (data.method) {
         case VISUAL_BRIDGE_METHODS.sandboxProxyReady:
             return { method: data.method };
@@ -200,15 +208,19 @@ export function parseVisualMessage(data: unknown): VisualMessage | undefined {
             if (params.theme !== 'light' && params.theme !== 'dark') {
                 return undefined;
             }
+
             const styles = isRecord(params.styles) ? params.styles : {};
+
             return { method: data.method, theme: { appearance: params.theme, variables: cleanVisualVariables(styles.variables) } };
         }
         case VISUAL_BRIDGE_METHODS.sizeChanged: {
             const height = sizeOf(params.height);
             const width = sizeOf(params.width);
+
             if (height === undefined) {
                 return undefined;
             }
+
             return width === undefined ? { method: data.method, height } : { method: data.method, width, height };
         }
         case VISUAL_BRIDGE_METHODS.viewportReady:
@@ -217,26 +229,33 @@ export function parseVisualMessage(data: unknown): VisualMessage | undefined {
             if (data.params === null) {
                 return { method: data.method, viewport: null };
             }
+
             const top = sizeOf(params.top);
             const height = sizeOf(params.height);
+
             return top !== undefined && height !== undefined && height > 0 ? { method: data.method, viewport: { top, height } } : undefined;
         }
         case VISUAL_BRIDGE_METHODS.scrollRequest: {
             if (typeof params.by === 'number' && Number.isFinite(params.by)) {
                 return { method: data.method, request: { by: Math.max(-100_000, Math.min(params.by, 100_000)) } };
             }
+
             const top = sizeOf(params.to);
+
             if (top !== undefined) {
                 return { method: data.method, request: { to: top } };
             }
+
             return params.edge === 'start' || params.edge === 'end' ? { method: data.method, request: { edge: params.edge } } : undefined;
         }
         case VISUAL_BRIDGE_METHODS.openLink: {
             const url = webUrl(params.url);
             const id = data.id;
+
             if (url === undefined || !(typeof id === 'string' || (typeof id === 'number' && Number.isFinite(id)))) {
                 return undefined;
             }
+
             return { method: data.method, id, url };
         }
         default:
@@ -377,14 +396,17 @@ const MAX_VALUE_LENGTH = 512;
 /* The variables of a theme a page may be given, from anything: the names it may hold and the values that cannot break out of their rule. */
 export function cleanVisualVariables(input: unknown): Record<string, string> {
     const clean: Record<string, string> = {};
+
     if (!isRecord(input)) {
         return clean;
     }
+
     for (const [name, value] of Object.entries(input)) {
         if (VARIABLE_NAME.test(name) && typeof value === 'string' && value.length <= MAX_VALUE_LENGTH && !UNSAFE_VALUE.test(value) && value.trim() !== '') {
             clean[name] = value.trim();
         }
     }
+
     return clean;
 }
 
@@ -421,6 +443,7 @@ const BASE_CSS = [
 
 function rootRule(theme: VisualTheme): string {
     const declarations = Object.entries(theme.variables).map(([name, value]) => `${name}:${value};`);
+
     return `:root{color-scheme:${theme.appearance};\n${declarations.join('\n')}\n}`;
 }
 
@@ -445,6 +468,7 @@ function bootstrapScript(): string {
         sizeChanged: VISUAL_BRIDGE_METHODS.sizeChanged,
         openLink: VISUAL_BRIDGE_METHODS.openLink
     };
+
     return `(function () {
 var script = document.currentScript;
 var style = script && script.previousElementSibling;
@@ -540,6 +564,7 @@ if (framed && typeof ResizeObserver === 'function') {
 
 function bootstrapMarkup(viewport: boolean): string {
     const theme = `${rootRule(VISUAL_DARK_THEME)}\n@media (prefers-color-scheme: light){\n${rootRule(VISUAL_LIGHT_THEME)}\n}\n${BASE_CSS}`;
+
     return [
         // Always first: the stored file is UTF-8 whatever the page declares, and the first charset wins.
         '<meta charset="utf-8">',
@@ -564,41 +589,56 @@ function commentEnd(html: string, from: number): number {
     if (html.startsWith('>', from)) {
         return from + 1;
     }
+
     if (html.startsWith('->', from)) {
         return from + 2;
     }
+
     const ends = [html.indexOf('-->', from), html.indexOf('--!>', from)].filter((index) => index >= 0);
+
     if (ends.length === 0) {
         return html.length;
     }
+
     const end = Math.min(...ends);
+
     return end + (html.startsWith('-->', end) ? 3 : 4);
 }
 
 // Past the `>` of a tag, skipping a quoted attribute value, which may hold one.
 function tagEnd(html: string, from: number): number {
     let at = from;
+
     while (at < html.length) {
         const char = html[at];
+
         if (char === '>') {
             return at + 1;
         }
+
         at++;
+
         if (char !== '=') {
             continue;
         }
+
         while (at < html.length && /\s/.test(html[at]!)) {
             at++;
         }
+
         const quote = html[at];
+
         if (quote === '"' || quote === "'") {
             const close = html.indexOf(quote, at + 1);
+
             if (close < 0) {
                 return html.length;
             }
+
             at = close + 1;
         }
     }
+
     return html.length;
 }
 
@@ -606,9 +646,11 @@ function rawTextEnd(html: string, name: string, from: number): number {
     if (name === 'plaintext') {
         return html.length;
     }
+
     const close = new RegExp(`</${name}[\\s/>]`, 'gi');
     close.lastIndex = from;
     const found = close.exec(html);
+
     return found === null ? html.length : tagEnd(html, found.index + 2);
 }
 
@@ -618,15 +660,20 @@ function rawTextEnd(html: string, name: string, from: number): number {
  */
 function* tokens(html: string): Generator<Token> {
     let at = 0;
+
     while (at < html.length) {
         const open = html.indexOf('<', at);
+
         if (open < 0) {
             yield { kind: 'text', name: '', start: at, end: html.length };
+
             return;
         }
+
         const next = html[open + 1] ?? '';
         let token: Token | null = null;
         let resume = 0;
+
         if (html.startsWith('<!--', open)) {
             token = { kind: 'comment', name: '', start: open, end: commentEnd(html, open + 4) };
         } else if (next === '!' || next === '?') {
@@ -639,21 +686,26 @@ function* tokens(html: string): Generator<Token> {
         } else if (/[a-z]/i.test(next)) {
             const name = /^<([a-z][^\s/>]*)/i.exec(html.slice(open, open + 64))![1]!.toLowerCase();
             token = { kind: 'start', name, start: open, end: tagEnd(html, open + 1 + name.length) };
+
             if (RAW_TEXT.has(name)) {
                 resume = rawTextEnd(html, name, token.end);
             }
         }
+
         if (token === null) {
             // A `<` that opens nothing is text, which goes on to the next `<`.
             const following = html.indexOf('<', open + 1);
             const end = following < 0 ? html.length : following;
             yield { kind: 'text', name: '', start: at, end };
             at = end;
+
             continue;
         }
+
         if (open > at) {
             yield { kind: 'text', name: '', start: at, end: open };
         }
+
         yield token;
         at = Math.max(token.end, resume);
     }
@@ -672,20 +724,25 @@ function bootstrapPlace(html: string): { at: number; head: boolean } {
         if (token.kind === 'comment' || token.kind === 'doctype' || (token.kind === 'text' && BLANK.test(html.slice(token.start, token.end)))) {
             continue;
         }
+
         if (token.kind === 'start' && token.name === 'html') {
             continue;
         }
+
         if (token.kind === 'start' && token.name === 'head') {
             return { at: token.end, head: true };
         }
+
         return { at: token.start, head: false };
     }
+
     return { at: html.length, head: false };
 }
 
 // Whether the page sets its own viewport, outside a template.
 function hasViewport(html: string): boolean {
     let templates = 0;
+
     for (const token of tokens(html)) {
         if (token.name === 'template') {
             templates = Math.max(0, templates + (token.kind === 'start' ? 1 : token.kind === 'end' ? -1 : 0));
@@ -695,6 +752,7 @@ function hasViewport(html: string): boolean {
             }
         }
     }
+
     return false;
 }
 
@@ -706,11 +764,13 @@ function hasViewport(html: string): boolean {
 export function injectVisualBootstrap(html: string): string {
     const place = bootstrapPlace(html);
     const bootstrap = bootstrapMarkup(!hasViewport(html));
+
     return html.slice(0, place.at) + (place.head ? bootstrap : `<head>${bootstrap}</head>`) + html.slice(place.at);
 }
 
 function hostPageScript(): string {
     const methods = { ready: VISUAL_BRIDGE_METHODS.sandboxProxyReady, resource: VISUAL_BRIDGE_METHODS.sandboxResourceReady };
+
     return `(function () {
 if (window.parent === window) { return; }
 var methods = ${inlineJson(methods)};