@adecore/agents 0.25.6 → 0.25.7

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

@@ -108,6 +108,7 @@ export declare class ChatSession {
     private readonly stopping;
     private readonly orphans;
     private pendingPreambles;
+    private pendingHints;
     private submission;
     private readonly steering;
     private readonly capturedUiAccess;

package/dist/chat/chat-session.js

@@ -79,6 +79,8 @@ export class ChatSession {
     // Background subagents a load found running whose transcript did not show an end yet; no CLI here will report them.
     orphans = new Set();
     pendingPreambles;
+    // Said once like the preambles, but never drawn as a note; kept in memory only, since a lost hint costs nothing.
+    pendingHints = [];
     submission = null;
     steering = new Set();
     capturedUiAccess;
@@ -95,8 +97,13 @@ export class ChatSession {
             clock: options.clock ?? systemClock,
             ...(options.ui ? { host: options.ui } : {}),
             emit: (event) => options.emit(event),
-            repair: (note) => {
-                if (!this.pendingPreambles.includes(note)) {
+            repair: (note, audience) => {
+                if (audience === 'agent') {
+                    if (!this.pendingHints.includes(note)) {
+                        this.pendingHints = [...this.pendingHints, note];
+                    }
+                }
+                else if (!this.pendingPreambles.includes(note)) {
                     this.pendingPreambles = [...this.pendingPreambles, note];
                 }
             }
@@ -647,6 +654,7 @@ export class ChatSession {
         this.options.promptNotes?.reset();
         // A cleared chat starts a new conversation, which what was waiting to be said no longer describes.
         this.pendingPreambles = [];
+        this.pendingHints = [];
         this.submission = null;
         this.staleResults = 0;
         this.sendAfterStop = false;
@@ -1430,9 +1438,11 @@ export class ChatSession {
         const preambles = this.preambles;
         this.pendingPreambles = [];
         this.submission = null;
+        const hints = this.pendingHints;
+        this.pendingHints = [];
         const read = [...preambles, ...host.shown];
         const joined = (parts) => (parts.length === 0 ? null : parts.join('\n\n'));
-        return { preamble: joined([...read, ...host.heard]), note: joined(read) };
+        return { preamble: joined([...read, ...host.heard, ...hints]), note: joined(read) };
     }
     submit(turnId, input) {
         this.pendingPreambles = this.preambles;

package/dist/chat/ui-replies.d.ts

@@ -12,7 +12,7 @@ export interface UiRepliesOptions {
     clock: OutboxClock;
     host?: UiReplyHost;
     emit(event: ChatEvent): void;
-    repair(note: string): void;
+    repair(note: string, audience: 'person' | 'agent'): void;
 }
 export declare class UiReplies {
     private readonly options;
@@ -25,6 +25,7 @@ export declare class UiReplies {
     previews(): ChatEvent[];
     previewItems(items: ChatItem[]): ChatItem[];
     pass(event: ChatEvent): void;
+    private repair;
     clear(): void;
     private unscannedText;
     private forgetScan;

package/dist/chat/ui-replies.js

@@ -89,15 +89,22 @@ export class UiReplies {
             .map((block) => ({ ...block, revision: createHash('sha256').update(JSON.stringify(block)).digest('hex') }));
         this.streams.delete(item.id);
         this.compiled.delete(item.id);
-        const diagnostics = [...new Set(ui.flatMap((block) => block.diagnostics.map((diagnostic) => diagnostic.message)))].slice(0, 6);
-        if (diagnostics.length > 0) {
-            this.options.repair(`Your last ${this.options.fenceLanguage} block had these diagnostics: ${diagnostics.join(' ')} Use the catalog's supported props and components.`.slice(0, 1200));
-        }
+        this.repair(ui.flatMap((block) => block.diagnostics));
         const current = thread.get(item.id);
         const completed = { ...item, ui, ...(current?.kind === 'assistant' && current.uiQueries ? { uiQueries: current.uiQueries } : {}) };
         emit(thread.upsert(completed));
         this.options.host?.observe(completed, true);
     }
+    repair(diagnostics) {
+        const say = (found, audience) => {
+            const messages = [...new Set(found.map((diagnostic) => diagnostic.message))].slice(0, 6);
+            if (messages.length > 0) {
+                this.options.repair(`Your last ${this.options.fenceLanguage} block had these diagnostics: ${messages.join(' ')} Use the catalog's supported props and components.`.slice(0, 1200), audience);
+            }
+        };
+        say(diagnostics.filter((diagnostic) => diagnostic.severity !== 'warning'), 'person');
+        say(diagnostics.filter((diagnostic) => diagnostic.severity === 'warning'), 'agent');
+    }
     clear() {
         for (const stream of this.streams.values()) {
             stream.dispose();

package/package.json

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

package/src/chat/chat-session.ts

@@ -205,6 +205,8 @@ export class ChatSession {
     // Background subagents a load found running whose transcript did not show an end yet; no CLI here will report them.
     private readonly orphans = new Set<string>();
     private pendingPreambles: readonly string[];
+    // Said once like the preambles, but never drawn as a note; kept in memory only, since a lost hint costs nothing.
+    private pendingHints: readonly string[] = [];
     private submission: { turnId: string; input: TurnInput } | null = null;
     private readonly steering = new Set<string>();
     private readonly capturedUiAccess: Map<string, unknown>;
@@ -222,8 +224,12 @@ export class ChatSession {
             clock: options.clock ?? systemClock,
             ...(options.ui ? { host: options.ui } : {}),
             emit: (event) => options.emit(event),
-            repair: (note) => {
-                if (!this.pendingPreambles.includes(note)) {
+            repair: (note, audience) => {
+                if (audience === 'agent') {
+                    if (!this.pendingHints.includes(note)) {
+                        this.pendingHints = [...this.pendingHints, note];
+                    }
+                } else if (!this.pendingPreambles.includes(note)) {
                     this.pendingPreambles = [...this.pendingPreambles, note];
                 }
             }
@@ -828,6 +834,7 @@ export class ChatSession {
         this.options.promptNotes?.reset();
         // A cleared chat starts a new conversation, which what was waiting to be said no longer describes.
         this.pendingPreambles = [];
+        this.pendingHints = [];
         this.submission = null;
         this.staleResults = 0;
         this.sendAfterStop = false;
@@ -1658,9 +1665,11 @@ export class ChatSession {
         const preambles = this.preambles;
         this.pendingPreambles = [];
         this.submission = null;
+        const hints = this.pendingHints;
+        this.pendingHints = [];
         const read = [...preambles, ...host.shown];
         const joined = (parts: string[]): string | null => (parts.length === 0 ? null : parts.join('\n\n'));
-        return { preamble: joined([...read, ...host.heard]), note: joined(read) };
+        return { preamble: joined([...read, ...host.heard, ...hints]), note: joined(read) };
     }
 
     private submit(turnId: string, input: TurnInput): void {

package/src/chat/ui-replies.ts

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { GeneratedImageInputSchema, type ChatAssistantItem, type ChatEvent, type ChatItem } from '@adecore/agent-contracts';
-import { uiHasFence, uiMayReferenceHost } from '@adecore/intelligent-ui';
+import { uiHasFence, uiMayReferenceHost, type UiDiagnostic } from '@adecore/intelligent-ui';
 import type { UiCompileOptions } from '@adecore/intelligent-ui/compiler';
 import { UiStream, type UiStreamPreview } from '@adecore/intelligent-ui/stream';
 import type { OutboxClock } from '../outbox/outbox-worker.ts';
@@ -21,8 +21,12 @@ export interface UiRepliesOptions {
     clock: OutboxClock;
     host?: UiReplyHost;
     emit(event: ChatEvent): void;
-    // What the agent hears in front of its next prompt about a block that compiled with diagnostics.
-    repair(note: string): void;
+    /*
+     * What the agent hears in front of its next prompt about a block that compiled with diagnostics.
+     * `agent` is for a warning: the person sees the block, not the note. `person` is for an error,
+     * which the thread shows as a note.
+     */
+    repair(note: string, audience: 'person' | 'agent'): void;
 }
 
 /*
@@ -114,21 +118,36 @@ export class UiReplies {
             .map((block) => ({ ...block, revision: createHash('sha256').update(JSON.stringify(block)).digest('hex') }));
         this.streams.delete(item.id);
         this.compiled.delete(item.id);
-        const diagnostics = [...new Set(ui.flatMap((block) => block.diagnostics.map((diagnostic) => diagnostic.message)))].slice(0, 6);
-        if (diagnostics.length > 0) {
-            this.options.repair(
-                `Your last ${this.options.fenceLanguage} block had these diagnostics: ${diagnostics.join(' ')} Use the catalog's supported props and components.`.slice(
-                    0,
-                    1200
-                )
-            );
-        }
+        this.repair(ui.flatMap((block) => block.diagnostics));
         const current = thread.get(item.id);
         const completed = { ...item, ui, ...(current?.kind === 'assistant' && current.uiQueries ? { uiQueries: current.uiQueries } : {}) };
         emit(thread.upsert(completed));
         this.options.host?.observe(completed, true);
     }
 
+    private repair(diagnostics: UiDiagnostic[]): void {
+        const say = (found: UiDiagnostic[], audience: 'person' | 'agent') => {
+            const messages = [...new Set(found.map((diagnostic) => diagnostic.message))].slice(0, 6);
+            if (messages.length > 0) {
+                this.options.repair(
+                    `Your last ${this.options.fenceLanguage} block had these diagnostics: ${messages.join(' ')} Use the catalog's supported props and components.`.slice(
+                        0,
+                        1200
+                    ),
+                    audience
+                );
+            }
+        };
+        say(
+            diagnostics.filter((diagnostic) => diagnostic.severity !== 'warning'),
+            'person'
+        );
+        say(
+            diagnostics.filter((diagnostic) => diagnostic.severity === 'warning'),
+            'agent'
+        );
+    }
+
     clear(): void {
         for (const stream of this.streams.values()) {
             stream.dispose();