@adecore/agents 0.46.3 → 0.47.0

package/dist/chat/chat-core.d.ts

@@ -1,4 +1,4 @@
-import { type AgentKind, type ChatAttachment, type ChatAttachResult, type ChatAttachmentUpload, type ChatBookmark, type ChatCheckpointDiff, type ChatConfigurePayload, type ChatCreatePayload, type ChatEvent, type ChatHistoryResult, type ChatGoalAction, type ChatInfo, type ChatItem, type ChatQueuedMessage, type ChatUiChoicePayload, type ChatUiQueryPayload, type ChatUiLinkPayload, type ChatSkill, type ChatSubagentPayload, type ChatSubagentResult, type ChatTurnItem, type ChatVisual, type ModelSelection, type RuntimeMode } from '@adecore/agent-contracts';
+import { type AgentKind, type ChatAttachment, type ChatAttachResult, type ChatAttachmentUpload, type ChatBookmark, type ChatCheckpointDiff, type ChatConfigurePayload, type ChatCreatePayload, type ChatEvent, type ChatHistoryResult, type ChatGoalAction, type ChatInfo, type ChatItem, type ChatNoteMessage, type ChatQueuedMessage, type ChatUiChoicePayload, type ChatUiQueryPayload, type ChatUiLinkPayload, type ChatSkill, type ChatSubagentPayload, type ChatSubagentResult, type ChatTurnItem, type ChatVisual, type ModelSelection, type RuntimeMode } from '@adecore/agent-contracts';
 import type { AgentEvent, AgentSink } from '../events.ts';
 import type { OutboxOutcome } from '../outbox/outbox-worker.ts';
 import { type AccountLaunches } from '../providers/accounts/launch.ts';
@@ -180,7 +180,7 @@ export declare class ChatCore {
     writeRecord(chatId: string, info: ChatInfo, items: ChatItem[], preambles?: string[]): Promise<void>;
     deleteRecord(chatId: string): Promise<boolean>;
     lastTurn(chatId: string): Promise<ChatTurnItem | null>;
-    addNote(chatId: string, level: 'info' | 'warning' | 'error', text: string): Promise<void>;
+    addNote(chatId: string, level: 'info' | 'warning' | 'error', text: string, message?: ChatNoteMessage): Promise<void>;
     deliverNote(chatId: string, delivery: {
         noteId: string;
         note: string;

package/dist/chat/chat-core.js

@@ -643,7 +643,7 @@ export class ChatCore {
         return stored?.items.findLast((item) => item.kind === 'turn') ?? null;
     }
     /* A line from the host in a chat's thread, loading the chat when nobody has; nothing for a chat that is gone. */
-    async addNote(chatId, level, text) {
+    async addNote(chatId, level, text, message) {
         await this.loaded(chatId);
         if (!(await this.hasStored(chatId))) {
             return;
@@ -651,7 +651,7 @@ export class ChatCore {
         if (!this.chats.has(chatId)) {
             await this.create({ chatId });
         }
-        this.chats.get(chatId)?.addNote(level, text);
+        this.chats.get(chatId)?.addNote(level, text, message);
     }
     /*
      * Leaves a note and its preamble in a chat, loading that chat when nobody has; false when it was

package/dist/chat/chat-session.d.ts

@@ -1,4 +1,4 @@
-import type { ChatAttachment, ChatCheckpointDiff, ChatEvent, ChatGoalAction, ChatInfo, ChatItem, ChatQueuedMessage, ChatQuoteSource, ChatSkill, ChatUiChoiceOrigin, ChatUiChoicePayload, ChatUiQueryState, ModelSelection, RuntimeMode } from '@adecore/agent-contracts';
+import type { ChatAttachment, ChatCheckpointDiff, ChatEvent, ChatGoalAction, ChatInfo, ChatItem, ChatNoteMessage, ChatQueuedMessage, ChatQuoteSource, ChatSkill, ChatUiChoiceOrigin, ChatUiChoicePayload, ChatUiQueryState, ModelSelection, RuntimeMode } from '@adecore/agent-contracts';
 import type { ChatProvider } from '../providers/provider.ts';
 import type { LimitsUpdate } from '../usage/limits/normalize.ts';
 import type { BackendLaunch } from './backend.ts';
@@ -211,7 +211,7 @@ export declare class ChatSession {
         preamble: string;
     }): boolean;
     upsertItems(items: readonly ChatItem[]): void;
-    addNote(level: 'info' | 'warning' | 'error', text: string): void;
+    addNote(level: 'info' | 'warning' | 'error', text: string, message?: ChatNoteMessage): void;
     end(reason: string): void;
     restart(): Promise<void>;
     dropProcess(): Promise<void>;

package/dist/chat/chat-session.js

@@ -1057,8 +1057,18 @@ export class ChatSession {
         this.options.persistSoon();
     }
     /* A line in the thread outside any turn, for something the host has to say about work it gave up on. */
-    addNote(level, text) {
-        this.emit([this.thread.upsert({ id: newId('note'), kind: 'note', createdAt: Date.now(), turnId: null, level, text })]);
+    addNote(level, text, message) {
+        this.emit([
+            this.thread.upsert({
+                id: newId('note'),
+                kind: 'note',
+                createdAt: Date.now(),
+                turnId: null,
+                level,
+                text,
+                ...(message === undefined ? {} : { message })
+            })
+        ]);
         this.options.persist();
     }
     /*

package/dist/messages/deliver-notice.d.ts

@@ -1,4 +1,4 @@
-import type { ChatItem } from '@adecore/agent-contracts';
+import type { ChatItem, ChatNoteMessage } from '@adecore/agent-contracts';
 import type { ChatCore } from '../chat/chat-core.ts';
 import type { Notice, NoticeStore } from './notice-store.ts';
 export interface MessageWords {
@@ -20,6 +20,7 @@ export declare function chatNoticeTargets(chats: Pick<ChatCore, 'get' | 'hasStor
 export declare function deliverToChat(store: Pick<NoticeStore, 'put'>, targets: ChatNoticeTargets, notice: Omit<Notice, 'createdAt'>): Promise<ChatDelivery>;
 export interface NoticeChat {
     has(id: string): Promise<boolean>;
-    note(id: string, text: string): Promise<void>;
+    note(id: string, text: string, message: ChatNoteMessage): Promise<void>;
 }
+export declare function noticeMessage(notice: Notice): ChatNoteMessage;
 export declare function showNotices(store: Pick<NoticeStore, 'show'>, chat: NoticeChat, words: Pick<MessageWords, 'shown'>, targetId: string): Promise<void>;

package/dist/messages/deliver-notice.js

@@ -57,6 +57,10 @@ export async function deliverToChat(store, targets, notice) {
     }
     return { outcome: 'wake', waiting };
 }
+/* The message itself on the line in the thread, so a client can draw it as said to the chat. */
+export function noticeMessage(notice) {
+    return { from: notice.from, title: notice.fromTitle, text: notice.text };
+}
 /*
  * Shows a person the message in the chat's thread the moment it lands, not when the model gets round
  * to it. An id no chat holds shows and marks nothing, so a chat that opens on it later still has all of it.
@@ -66,6 +70,6 @@ export async function showNotices(store, chat, words, targetId) {
         return;
     }
     for (const notice of await store.show(targetId)) {
-        await chat.note(targetId, words.shown(notice));
+        await chat.note(targetId, words.shown(notice), noticeMessage(notice));
     }
 }

package/dist/messages/notice-notes.d.ts

@@ -1,5 +1,6 @@
+import type { ChatNoteMessage } from '@adecore/agent-contracts';
 import type { PromptNotes } from '../chat/chat-session.ts';
-import type { MessageWords } from './deliver-notice.ts';
+import { type MessageWords } from './deliver-notice.ts';
 import type { NoticeStore } from './notice-store.ts';
 export declare class NoticeNotes implements PromptNotes {
     private readonly store;
@@ -12,4 +13,7 @@ export declare class NoticeNotes implements PromptNotes {
     };
     reset(): void;
 }
-export declare function unshownNotes(store: Pick<NoticeStore, 'show'>, chatId: string, words: Pick<MessageWords, 'shown'>): Promise<string[]>;
+export declare function unshownNotes(store: Pick<NoticeStore, 'show'>, chatId: string, words: Pick<MessageWords, 'shown'>): Promise<{
+    text: string;
+    message: ChatNoteMessage;
+}[]>;

package/dist/messages/notice-notes.js

@@ -1,3 +1,4 @@
+import { noticeMessage } from './deliver-notice.js';
 /*
  * What another node left for a chat, taken from the queue in front of its next prompt so the model
  * hears it once. Nothing of it is shown: a person read each message in the thread as it landed
@@ -22,5 +23,5 @@ export class NoticeNotes {
  * reload writes none again. The model still hears the messages themselves from the queue.
  */
 export async function unshownNotes(store, chatId, words) {
-    return (await store.show(chatId)).map((notice) => words.shown(notice));
+    return (await store.show(chatId)).map((notice) => ({ text: words.shown(notice), message: noticeMessage(notice) }));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents",
-  "version": "0.46.3",
+  "version": "0.47.0",
   "description": "Node-compatible agent chat hosts, providers, accounts, usage and durable task coordination.",
   "type": "module",
   "exports": {
@@ -93,8 +93,8 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
-    "@adecore/agent-contracts": "0.46.3",
-    "@adecore/intelligent-ui": "0.46.3",
+    "@adecore/agent-contracts": "0.47.0",
+    "@adecore/intelligent-ui": "0.47.0",
     "zod": "^4.6.7"
   },
   "devDependencies": {

package/src/chat/chat-core.ts

@@ -17,6 +17,7 @@ import {
     type ChatGoalAction,
     type ChatInfo,
     type ChatItem,
+    type ChatNoteMessage,
     type ChatQueuedMessage,
     type ChatUiChoicePayload,
     type ChatUiQueryPayload,
@@ -974,7 +975,7 @@ export class ChatCore {
     }
 
     /* A line from the host in a chat's thread, loading the chat when nobody has; nothing for a chat that is gone. */
-    async addNote(chatId: string, level: 'info' | 'warning' | 'error', text: string): Promise<void> {
+    async addNote(chatId: string, level: 'info' | 'warning' | 'error', text: string, message?: ChatNoteMessage): Promise<void> {
         await this.loaded(chatId);
 
         if (!(await this.hasStored(chatId))) {
@@ -985,7 +986,7 @@ export class ChatCore {
             await this.create({ chatId });
         }
 
-        this.chats.get(chatId)?.addNote(level, text);
+        this.chats.get(chatId)?.addNote(level, text, message);
     }
 
     /*

package/src/chat/chat-session.ts

@@ -6,6 +6,7 @@ import type {
     ChatGoalAction,
     ChatInfo,
     ChatItem,
+    ChatNoteMessage,
     ChatQueuedMessage,
     ChatQuoteSource,
     ChatSkill,
@@ -1470,8 +1471,18 @@ export class ChatSession {
     }
 
     /* A line in the thread outside any turn, for something the host has to say about work it gave up on. */
-    addNote(level: 'info' | 'warning' | 'error', text: string): void {
-        this.emit([this.thread.upsert({ id: newId('note'), kind: 'note', createdAt: Date.now(), turnId: null, level, text })]);
+    addNote(level: 'info' | 'warning' | 'error', text: string, message?: ChatNoteMessage): void {
+        this.emit([
+            this.thread.upsert({
+                id: newId('note'),
+                kind: 'note',
+                createdAt: Date.now(),
+                turnId: null,
+                level,
+                text,
+                ...(message === undefined ? {} : { message })
+            })
+        ]);
         this.options.persist();
     }
 

package/src/messages/deliver-notice.ts

@@ -1,4 +1,4 @@
-import type { ChatItem } from '@adecore/agent-contracts';
+import type { ChatItem, ChatNoteMessage } from '@adecore/agent-contracts';
 import type { ChatCore } from '../chat/chat-core.ts';
 import type { Notice, NoticeStore } from './notice-store.ts';
 
@@ -111,7 +111,12 @@ export interface NoticeChat {
     /* Whether the host holds a chat under the id, running or on disk. */
     has(id: string): Promise<boolean>;
     /* Puts a line in that chat's thread, loading the chat when nobody has. */
-    note(id: string, text: string): Promise<void>;
+    note(id: string, text: string, message: ChatNoteMessage): Promise<void>;
+}
+
+/* The message itself on the line in the thread, so a client can draw it as said to the chat. */
+export function noticeMessage(notice: Notice): ChatNoteMessage {
+    return { from: notice.from, title: notice.fromTitle, text: notice.text };
 }
 
 /*
@@ -124,6 +129,6 @@ export async function showNotices(store: Pick<NoticeStore, 'show'>, chat: Notice
     }
 
     for (const notice of await store.show(targetId)) {
-        await chat.note(targetId, words.shown(notice));
+        await chat.note(targetId, words.shown(notice), noticeMessage(notice));
     }
 }

package/src/messages/notice-notes.ts

@@ -1,5 +1,6 @@
+import type { ChatNoteMessage } from '@adecore/agent-contracts';
 import type { PromptNotes } from '../chat/chat-session.ts';
-import type { MessageWords } from './deliver-notice.ts';
+import { noticeMessage, type MessageWords } from './deliver-notice.ts';
 import type { NoticeStore } from './notice-store.ts';
 
 /*
@@ -29,6 +30,10 @@ export class NoticeNotes implements PromptNotes {
  * The lines a chat that just loaded owes a person for what landed while nobody held it, marked so a
  * reload writes none again. The model still hears the messages themselves from the queue.
  */
-export async function unshownNotes(store: Pick<NoticeStore, 'show'>, chatId: string, words: Pick<MessageWords, 'shown'>): Promise<string[]> {
-    return (await store.show(chatId)).map((notice) => words.shown(notice));
+export async function unshownNotes(
+    store: Pick<NoticeStore, 'show'>,
+    chatId: string,
+    words: Pick<MessageWords, 'shown'>
+): Promise<{ text: string; message: ChatNoteMessage }[]> {
+    return (await store.show(chatId)).map((notice) => ({ text: words.shown(notice), message: noticeMessage(notice) }));
 }