@adecore/agents 0.40.2 → 0.40.4

package/dist/async.d.ts

@@ -5,3 +5,6 @@ export interface DeadlineTimer {
 }
 export declare function withDeadline<T>(promise: Promise<T>, ms: number, message: string, timer?: DeadlineTimer): Promise<T>;
 export declare function withTimeout<T>(promise: Promise<T>, ms: number, message: string): Promise<T>;
+export type Timer = (ms: number, run: () => void) => () => void;
+export declare const cancellableTimeout: Timer;
+export declare const unrefTimeout: Timer;

package/dist/async.js

@@ -32,3 +32,13 @@ export function withDeadline(promise, ms, message, timer = SYSTEM_TIMER) {
 export function withTimeout(promise, ms, message) {
     return withDeadline(promise, ms, message);
 }
+export const cancellableTimeout = (ms, run) => {
+    const timer = setTimeout(run, ms);
+    return () => clearTimeout(timer);
+};
+/* The same, without holding the process open for it. */
+export const unrefTimeout = (ms, run) => {
+    const timer = setTimeout(run, ms);
+    timer.unref?.();
+    return () => clearTimeout(timer);
+};

package/dist/chat/chat-core.js

@@ -1,5 +1,5 @@
 import { join } from 'node:path';
-import { ChatAttachmentUploadsSchema, generatedImageAttachment, HOST_TASK_ORIGIN } from '@adecore/agent-contracts';
+import { ChatAttachmentUploadsSchema, generatedImageAttachment, holdsConversation, HOST_TASK_ORIGIN } from '@adecore/agent-contracts';
 import { ClientSinks } from '../client-sinks.js';
 import { errorText } from '../error-text.js';
 import { AccountError, definedEnv, isDefaultAccountOf, launchEnv, storedAccount } from '../providers/accounts/launch.js';
@@ -371,8 +371,7 @@ export class ChatCore {
         }
         // As named, so a switch to the default account is refused while it is turned off.
         this.requireAccount(kind, requested);
-        const spoke = session.info.agentSessionId !== null || session.info.usage.turns > 0;
-        if (spoke && !this.canContinue(kind, from, to)) {
+        if (holdsConversation(session.info) && !this.canContinue(kind, from, to)) {
             const label = this.accountLabel(kind, to);
             throw new AccountError('account-incompatible', `This conversation is kept by the account '${this.accountLabel(kind, from)}', which '${label}' cannot read. Fork the chat to go on under '${label}'.`);
         }
@@ -409,6 +408,7 @@ export class ChatCore {
             items: session.previewItems(page.items),
             pending: session.previewItems(session.thread.pending()),
             subagents: session.thread.subagentsBefore(page.history.start),
+            outline: session.thread.outlineBefore(page.history.start),
             seq: log.seq
         };
     }
@@ -440,6 +440,11 @@ export class ChatCore {
             ]);
         } while (this.listChanges.get(chatId) !== changes);
         const result = this.attach(chatId, clientId, historyLimit, since);
+        // A reply before the page has a tick only while a bookmark is on it, which only this read knows.
+        if (result.outline !== undefined && result.history !== undefined && bookmarks !== undefined && bookmarks.length > 0) {
+            const marked = new Set(bookmarks.map((bookmark) => bookmark.itemId));
+            result.outline = this.require(chatId).thread.outlineBefore(result.history.start, marked);
+        }
         return { ...result, ...(bookmarks === undefined ? {} : { bookmarks }), ...(visuals === undefined ? {} : { visuals }) };
     }
     listChanged(chatId) {

package/dist/chat/thread.d.ts

@@ -30,6 +30,7 @@ export declare class ChatThread {
     private syncRequests;
     history(limit?: number, cursor?: string): ChatHistoryResult;
     subagentsBefore(start: number): ChatSubagentItem[];
+    outlineBefore(start: number, marked?: ReadonlySet<string>): ChatItem[];
     snapshot(): {
         info: ChatInfo;
         items: ChatItem[];

package/dist/chat/thread.js

@@ -1,5 +1,5 @@
 import { randomUUID } from 'node:crypto';
-import { activeSubagents } from '@adecore/agent-contracts';
+import { activeSubagents, outlineItems } from '@adecore/agent-contracts';
 import { appendToolOutput } from '@adecore/agent-contracts/text';
 import { ChatError } from './errors.js';
 import { requestSummaries } from './request-summary.js';
@@ -185,6 +185,10 @@ export class ChatThread {
     subagentsBefore(start) {
         return activeSubagents(this.list()).filter((item) => this.indices.get(item.id) < start);
     }
+    /* The outline of what a page that begins at `start` leaves out, with the replies in `marked` that a bookmark is on. */
+    outlineBefore(start, marked) {
+        return outlineItems(this.order.slice(0, start).map((id) => this.items.get(id)), marked);
+    }
     snapshot() {
         return { info: this.info, items: this.list() };
     }

package/dist/client-sinks.d.ts

@@ -7,3 +7,11 @@ export declare class ClientSinks<TEvent> {
     to(clientId: string, event: TEvent): void;
     clientIds(): string[];
 }
+export declare class WatchedSinks<TEvent> {
+    private readonly sinks;
+    private readonly watching;
+    subscribe(clientId: string, sink: (event: TEvent) => void): () => void;
+    watch(clientId: string): void;
+    unwatch(clientId: string): void;
+    emit(event: TEvent): void;
+}

package/dist/client-sinks.js

@@ -32,3 +32,26 @@ export class ClientSinks {
         return [...this.sinks.keys()];
     }
 }
+/* The clients of a part that hear its events only after they asked for them with `<area>.watch`. */
+export class WatchedSinks {
+    sinks = new ClientSinks();
+    watching = new Set();
+    subscribe(clientId, sink) {
+        const unsubscribe = this.sinks.subscribe(clientId, sink);
+        return () => {
+            this.watching.delete(clientId);
+            unsubscribe();
+        };
+    }
+    watch(clientId) {
+        this.watching.add(clientId);
+    }
+    unwatch(clientId) {
+        this.watching.delete(clientId);
+    }
+    emit(event) {
+        for (const clientId of this.watching) {
+            this.sinks.to(clientId, event);
+        }
+    }
+}

package/dist/host/index.d.ts

@@ -3,5 +3,5 @@ export { RUIMTE_SESSION_VARIABLES, cliEnvironment, type CliEnvironmentPolicy } f
 export { type AgentHandler, type AgentHandlers, chatHandlers, accountHandlers, usageHandlers, type AgentRequestMap, type ChatRequestType } from './handlers.ts';
 export { memoryPortPair } from './memory-port.ts';
 export { type AgentWiring, wireAgents, type AgentWiringOptions } from './wiring.ts';
-export { ClientSinks } from '../client-sinks.ts';
+export { ClientSinks, WatchedSinks } from '../client-sinks.ts';
 export type { AgentEvent, AgentEventMap, AgentSink } from '../events.ts';

package/dist/host/index.js

@@ -4,4 +4,4 @@ export { RUIMTE_SESSION_VARIABLES, cliEnvironment } from './environment.js';
 export { chatHandlers, accountHandlers, usageHandlers } from './handlers.js';
 export { memoryPortPair } from './memory-port.js';
 export { wireAgents } from './wiring.js';
-export { ClientSinks } from '../client-sinks.js';
+export { ClientSinks, WatchedSinks } from '../client-sinks.js';

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-export { wait, withTimeout } from './async.ts';
+export { wait, withTimeout, cancellableTimeout, unrefTimeout, type Timer } from './async.ts';
 export { CodedError } from './coded-error.ts';
 export { describeError, setErrorStacks, errorText } from './error-text.ts';
-export { tempNameFor, writeAtomic, replaceSync, writeAtomicSync, isNotFound, fileExists, entryExists, type WriteAtomicOptions } from './fs.ts';
+export { tempNameFor, writeAtomic, replaceSync, writeAtomicSync, hasErrorCode, isNotFound, fileExists, entryExists, type WriteAtomicOptions } from './fs.ts';
 export { RecordDirectory, type RecordDirectoryOptions } from './record-directory.ts';
 export { runProcess, type ProcessResult, type RunProcessOptions } from './run-process.ts';
 export { Serializer, KeyedSerializer } from './serializer.ts';
+export { SingleFlight } from './single-flight.ts';
 export { cleanTitle, readLines } from './title-file.ts';
 export { type DirectoryWatcher, type WatchSeams, supportsRecursive, SYSTEM_WATCH, type Settled, settled, PerClientWatches, type WatchDirectory, type Schedule } from './watch-seam.ts';

package/dist/index.js

@@ -1,10 +1,11 @@
 // Public API: exports.test.ts snapshots this list, so a name added or dropped here is an API change.
-export { wait, withTimeout } from './async.js';
+export { wait, withTimeout, cancellableTimeout, unrefTimeout } from './async.js';
 export { CodedError } from './coded-error.js';
 export { describeError, setErrorStacks, errorText } from './error-text.js';
-export { tempNameFor, writeAtomic, replaceSync, writeAtomicSync, isNotFound, fileExists, entryExists } from './fs.js';
+export { tempNameFor, writeAtomic, replaceSync, writeAtomicSync, hasErrorCode, isNotFound, fileExists, entryExists } from './fs.js';
 export { RecordDirectory } from './record-directory.js';
 export { runProcess } from './run-process.js';
 export { Serializer, KeyedSerializer } from './serializer.js';
+export { SingleFlight } from './single-flight.js';
 export { cleanTitle, readLines } from './title-file.js';
 export { supportsRecursive, SYSTEM_WATCH, settled, PerClientWatches } from './watch-seam.js';

package/dist/providers/claude-models.json

@@ -104,9 +104,9 @@
   "models": [
     { "slug": "claude-fable-5-1", "name": "Claude Fable 5.1", "profile": "frontier", "aliases": ["fable"] },
     { "slug": "claude-opus-5-5", "name": "Claude Opus 5.5", "badge": "new", "profile": "opus", "aliases": ["opus"] },
-    { "slug": "claude-opus-5", "name": "Claude Opus 5", "profile": "opus" },
+    { "slug": "claude-opus-5", "name": "Claude Opus 5", "profile": "opus", "legacy": true },
     { "slug": "claude-sonnet-5-5", "name": "Claude Sonnet 5.5", "badge": "new", "profile": "sonnet", "aliases": ["sonnet"] },
-    { "slug": "claude-sonnet-5", "name": "Claude Sonnet 5", "profile": "sonnet" },
+    { "slug": "claude-sonnet-5", "name": "Claude Sonnet 5", "profile": "sonnet", "legacy": true },
     { "slug": "claude-haiku-5-5", "name": "Claude Haiku 5.5", "badge": "new", "profile": "sonnet", "aliases": ["haiku"] },
     { "slug": "claude-opus-4-6", "name": "Claude Opus 4.6", "profile": "frontier", "legacy": true },
     { "slug": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6", "profile": "sonnet", "legacy": true },

package/dist/single-flight.d.ts

@@ -0,0 +1,6 @@
+export declare class SingleFlight<T> {
+    private readonly flights;
+    get(key: string): Promise<T> | undefined;
+    has(key: string): boolean;
+    run(key: string, work: () => Promise<T>): Promise<T>;
+}

package/dist/single-flight.js

@@ -0,0 +1,27 @@
+/*
+ * Work that runs once per key at a time: a caller that asks while it runs shares its outcome, and
+ * a key that settled leaves nothing behind.
+ */
+export class SingleFlight {
+    flights = new Map();
+    /* The run in flight for `key`, if any. */
+    get(key) {
+        return this.flights.get(key);
+    }
+    has(key) {
+        return this.flights.has(key);
+    }
+    run(key, work) {
+        const running = this.flights.get(key);
+        if (running !== undefined) {
+            return running;
+        }
+        const flight = work().finally(() => {
+            if (this.flights.get(key) === flight) {
+                this.flights.delete(key);
+            }
+        });
+        this.flights.set(key, flight);
+        return flight;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents",
-  "version": "0.40.2",
+  "version": "0.40.4",
   "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.40.2",
-    "@adecore/intelligent-ui": "0.40.2",
+    "@adecore/agent-contracts": "0.40.4",
+    "@adecore/intelligent-ui": "0.40.4",
     "zod": "^4.6.7"
   },
   "devDependencies": {

package/src/async.ts

@@ -50,3 +50,20 @@ export function withDeadline<T>(promise: Promise<T>, ms: number, message: string
 export function withTimeout<T>(promise: Promise<T>, ms: number, message: string): Promise<T> {
     return withDeadline(promise, ms, message);
 }
+
+/* Runs `run` after `ms` and answers how to call it off. */
+export type Timer = (ms: number, run: () => void) => () => void;
+
+export const cancellableTimeout: Timer = (ms, run) => {
+    const timer = setTimeout(run, ms);
+
+    return () => clearTimeout(timer);
+};
+
+/* The same, without holding the process open for it. */
+export const unrefTimeout: Timer = (ms, run) => {
+    const timer = setTimeout(run, ms);
+    timer.unref?.();
+
+    return () => clearTimeout(timer);
+};

package/src/chat/chat-core.ts

@@ -2,6 +2,7 @@ import { join } from 'node:path';
 import {
     ChatAttachmentUploadsSchema,
     generatedImageAttachment,
+    holdsConversation,
     HOST_TASK_ORIGIN,
     type AgentKind,
     type ChatAttachment,
@@ -612,9 +613,7 @@ export class ChatCore {
 
         // As named, so a switch to the default account is refused while it is turned off.
         this.requireAccount(kind, requested);
-        const spoke = session.info.agentSessionId !== null || session.info.usage.turns > 0;
-
-        if (spoke && !this.canContinue(kind, from, to)) {
+        if (holdsConversation(session.info) && !this.canContinue(kind, from, to)) {
             const label = this.accountLabel(kind, to);
 
             throw new AccountError(
@@ -664,6 +663,7 @@ export class ChatCore {
             items: session.previewItems(page.items),
             pending: session.previewItems(session.thread.pending()),
             subagents: session.thread.subagentsBefore(page.history.start),
+            outline: session.thread.outlineBefore(page.history.start),
             seq: log.seq
         };
     }
@@ -705,6 +705,12 @@ export class ChatCore {
 
         const result = this.attach(chatId, clientId, historyLimit, since);
 
+        // A reply before the page has a tick only while a bookmark is on it, which only this read knows.
+        if (result.outline !== undefined && result.history !== undefined && bookmarks !== undefined && bookmarks.length > 0) {
+            const marked = new Set(bookmarks.map((bookmark) => bookmark.itemId));
+            result.outline = this.require(chatId).thread.outlineBefore(result.history.start, marked);
+        }
+
         return { ...result, ...(bookmarks === undefined ? {} : { bookmarks }), ...(visuals === undefined ? {} : { visuals }) };
     }
 

package/src/chat/thread.ts

@@ -1,6 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import {
     activeSubagents,
+    outlineItems,
     type AgentStatus,
     type ChatApprovalItem,
     type ChatEvent,
@@ -246,6 +247,14 @@ export class ChatThread {
         return activeSubagents(this.list()).filter((item) => this.indices.get(item.id)! < start);
     }
 
+    /* The outline of what a page that begins at `start` leaves out, with the replies in `marked` that a bookmark is on. */
+    outlineBefore(start: number, marked?: ReadonlySet<string>): ChatItem[] {
+        return outlineItems(
+            this.order.slice(0, start).map((id) => this.items.get(id)!),
+            marked
+        );
+    }
+
     snapshot(): { info: ChatInfo; items: ChatItem[] } {
         return { info: this.info, items: this.list() };
     }

package/src/client-sinks.ts

@@ -39,3 +39,32 @@ export class ClientSinks<TEvent> {
         return [...this.sinks.keys()];
     }
 }
+
+/* The clients of a part that hear its events only after they asked for them with `<area>.watch`. */
+export class WatchedSinks<TEvent> {
+    private readonly sinks = new ClientSinks<TEvent>();
+    private readonly watching = new Set<string>();
+
+    subscribe(clientId: string, sink: (event: TEvent) => void): () => void {
+        const unsubscribe = this.sinks.subscribe(clientId, sink);
+
+        return () => {
+            this.watching.delete(clientId);
+            unsubscribe();
+        };
+    }
+
+    watch(clientId: string): void {
+        this.watching.add(clientId);
+    }
+
+    unwatch(clientId: string): void {
+        this.watching.delete(clientId);
+    }
+
+    emit(event: TEvent): void {
+        for (const clientId of this.watching) {
+            this.sinks.to(clientId, event);
+        }
+    }
+}

package/src/host/index.ts

@@ -4,5 +4,5 @@ export { RUIMTE_SESSION_VARIABLES, cliEnvironment, type CliEnvironmentPolicy } f
 export { type AgentHandler, type AgentHandlers, chatHandlers, accountHandlers, usageHandlers, type AgentRequestMap, type ChatRequestType } from './handlers.ts';
 export { memoryPortPair } from './memory-port.ts';
 export { type AgentWiring, wireAgents, type AgentWiringOptions } from './wiring.ts';
-export { ClientSinks } from '../client-sinks.ts';
+export { ClientSinks, WatchedSinks } from '../client-sinks.ts';
 export type { AgentEvent, AgentEventMap, AgentSink } from '../events.ts';

package/src/index.ts

@@ -1,11 +1,12 @@
 // Public API: exports.test.ts snapshots this list, so a name added or dropped here is an API change.
-export { wait, withTimeout } from './async.ts';
+export { wait, withTimeout, cancellableTimeout, unrefTimeout, type Timer } from './async.ts';
 export { CodedError } from './coded-error.ts';
 export { describeError, setErrorStacks, errorText } from './error-text.ts';
-export { tempNameFor, writeAtomic, replaceSync, writeAtomicSync, isNotFound, fileExists, entryExists, type WriteAtomicOptions } from './fs.ts';
+export { tempNameFor, writeAtomic, replaceSync, writeAtomicSync, hasErrorCode, isNotFound, fileExists, entryExists, type WriteAtomicOptions } from './fs.ts';
 export { RecordDirectory, type RecordDirectoryOptions } from './record-directory.ts';
 export { runProcess, type ProcessResult, type RunProcessOptions } from './run-process.ts';
 export { Serializer, KeyedSerializer } from './serializer.ts';
+export { SingleFlight } from './single-flight.ts';
 export { cleanTitle, readLines } from './title-file.ts';
 
 export {

package/src/providers/claude-models.json

@@ -104,9 +104,9 @@
   "models": [
     { "slug": "claude-fable-5-1", "name": "Claude Fable 5.1", "profile": "frontier", "aliases": ["fable"] },
     { "slug": "claude-opus-5-5", "name": "Claude Opus 5.5", "badge": "new", "profile": "opus", "aliases": ["opus"] },
-    { "slug": "claude-opus-5", "name": "Claude Opus 5", "profile": "opus" },
+    { "slug": "claude-opus-5", "name": "Claude Opus 5", "profile": "opus", "legacy": true },
     { "slug": "claude-sonnet-5-5", "name": "Claude Sonnet 5.5", "badge": "new", "profile": "sonnet", "aliases": ["sonnet"] },
-    { "slug": "claude-sonnet-5", "name": "Claude Sonnet 5", "profile": "sonnet" },
+    { "slug": "claude-sonnet-5", "name": "Claude Sonnet 5", "profile": "sonnet", "legacy": true },
     { "slug": "claude-haiku-5-5", "name": "Claude Haiku 5.5", "badge": "new", "profile": "sonnet", "aliases": ["haiku"] },
     { "slug": "claude-opus-4-6", "name": "Claude Opus 4.6", "profile": "frontier", "legacy": true },
     { "slug": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6", "profile": "sonnet", "legacy": true },

package/src/single-flight.ts

@@ -0,0 +1,33 @@
+/*
+ * Work that runs once per key at a time: a caller that asks while it runs shares its outcome, and
+ * a key that settled leaves nothing behind.
+ */
+export class SingleFlight<T> {
+    private readonly flights = new Map<string, Promise<T>>();
+
+    /* The run in flight for `key`, if any. */
+    get(key: string): Promise<T> | undefined {
+        return this.flights.get(key);
+    }
+
+    has(key: string): boolean {
+        return this.flights.has(key);
+    }
+
+    run(key: string, work: () => Promise<T>): Promise<T> {
+        const running = this.flights.get(key);
+
+        if (running !== undefined) {
+            return running;
+        }
+
+        const flight = work().finally(() => {
+            if (this.flights.get(key) === flight) {
+                this.flights.delete(key);
+            }
+        });
+        this.flights.set(key, flight);
+
+        return flight;
+    }
+}