@adecore/agents 0.25.3 → 0.25.4

package/dist/lineage.d.ts

@@ -15,6 +15,9 @@ declare const LineageSchema: z.ZodObject<{
     }>>;
     createdAt: z.ZodNumber;
     endedAt: z.ZodOptional<z.ZodNumber>;
+    peer: z.ZodOptional<z.ZodObject<{
+        machineId: z.ZodString;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type Lineage = z.infer<typeof LineageSchema>;
 export declare class AgentLineageStore {
@@ -33,6 +36,9 @@ export declare class AgentLineageStore {
         openedBy: string;
     }>;
     ceilingOf(nodeId: string): RuntimeMode | null;
+    peerOf(nodeId: string): {
+        machineId: string;
+    } | null;
     depthOf(nodeId: string): number;
     openedCount(callerId: string, include?: (nodeId: string) => boolean): number;
     madeBy(nodeId: string): string | null;

package/dist/lineage.js

@@ -18,7 +18,9 @@ const LineageSchema = z.object({
     ceiling: RuntimeModeSchema.optional(),
     createdAt: z.number(),
     /* When stopping or deleting the node that opened it ended this one too; a cascade never ends a node twice. */
-    endedAt: z.number().optional()
+    endedAt: z.number().optional(),
+    /* Set when the agent that opened this one runs on another machine; `openedBy` then names it there, not a node here. */
+    peer: z.object({ machineId: z.string().min(1) }).optional()
 });
 /* Opened by the agent it names, which is what every rule about children is about; a fork lives on its own. */
 function openedByAgent(entry) {
@@ -96,6 +98,10 @@ export class AgentLineageStore {
         const entry = this.opened.get(nodeId);
         return entry !== undefined && openedByAgent(entry) ? (entry.ceiling ?? null) : null;
     }
+    /* The machine whose agent opened this node, or null for a node opened on this one. */
+    peerOf(nodeId) {
+        return this.opened.get(nodeId)?.peer ?? null;
+    }
     /* How deep a node sits. A node nobody wrote down is one a person made, which is where a chain starts. */
     depthOf(nodeId) {
         return this.opened.get(nodeId)?.depth ?? 0;

package/dist/tasks/task-coordinator.d.ts

@@ -34,6 +34,7 @@ export declare class TaskCoordinator {
     constructor(deps: TaskCoordinatorDeps);
     stop(): void;
     settled(): Promise<void>;
+    settleFromElsewhere(taskId: string, result: TaskResult, status?: 'done' | 'failed'): Promise<Task | null>;
     chatEvent(event: AgentEvent): void;
     agentEnded(childId: string, text: string): void;
     startFailed(childId: string, error: unknown): void;
@@ -41,6 +42,7 @@ export declare class TaskCoordinator {
     done(childId: string, text: string): Promise<Task | null>;
     outlasted(childId: string, commands: readonly string[], cause?: 'limit' | 'restart'): Promise<Task | null>;
     cancelled(tasks: readonly Task[]): void;
+    private localTask;
     private failed;
     private answers;
     private turnEnded;

package/dist/tasks/task-coordinator.js

@@ -75,6 +75,18 @@ export class TaskCoordinator {
         }
         await this.deps.tasks.settled();
     }
+    /*
+     * Settles a task whose child runs on another machine, which no chat here observes: the answer comes
+     * from there. Wakes the parent once however often it is told; null when the task is no such task or
+     * was not open any more.
+     */
+    async settleFromElsewhere(taskId, result, status = 'done') {
+        const task = this.deps.tasks.get(taskId);
+        if (task?.machine === undefined || task.status !== 'open') {
+            return null;
+        }
+        return this.settleNow(task, status, result);
+    }
     chatEvent(event) {
         if (this.stopped || event.event !== 'chat.event') {
             return;
@@ -105,7 +117,7 @@ export class TaskCoordinator {
         if (this.stopped) {
             return;
         }
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         if (!task || !this.deps.placed(childId)) {
             return;
         }
@@ -120,7 +132,7 @@ export class TaskCoordinator {
     }
     /* `done` from the child itself, which wins over whatever else was about to settle it. */
     async done(childId, text) {
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         if (!task) {
             return null;
         }
@@ -132,7 +144,7 @@ export class TaskCoordinator {
      * does when the CLI goes within one run.
      */
     async outlasted(childId, commands, cause = 'limit') {
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         const items = this.deps.chatItems(childId);
         if (this.stopped || !task || items === null || this.delegating(childId)) {
             return null;
@@ -153,9 +165,14 @@ export class TaskCoordinator {
             this.recheck(task.parentId);
         }
     }
+    /* The open task a chat here works on; one whose child runs on another machine is settled from there. */
+    localTask(childId) {
+        const task = this.deps.tasks.openFor(childId);
+        return task?.machine === undefined ? task : undefined;
+    }
     /* An open task of this child that nothing can carry any more. */
     failed(childId, text) {
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         if (!task || this.stopped) {
             return;
         }
@@ -179,7 +196,7 @@ export class TaskCoordinator {
         return own === -1 ? task.requiresTaskTurn !== true && turn.createdAt >= task.createdAt : own < items.findIndex((item) => item.id === turn.id);
     }
     turnEnded(chatId, turn) {
-        const task = this.deps.tasks.openFor(chatId);
+        const task = this.localTask(chatId);
         const items = this.deps.chatItems(chatId);
         if (!task || items === null || !this.answers(items, turn, task) || this.delegating(chatId)) {
             return;
@@ -297,7 +314,7 @@ export class TaskCoordinator {
     }
     /* A child that took up work again is no longer waiting out a limit. */
     turnStarted(chatId) {
-        const task = this.deps.tasks.openFor(chatId);
+        const task = this.localTask(chatId);
         if (task?.paused !== undefined) {
             this.hold(task, null);
         }
@@ -306,7 +323,7 @@ export class TaskCoordinator {
         void this.deps.tasks.pause(task.id, paused).catch((e) => console.error(`Pausing task ${task.id} failed:`, errorText(e)));
     }
     recheck(chatId) {
-        const task = this.deps.tasks.openFor(chatId);
+        const task = this.localTask(chatId);
         const items = this.deps.chatItems(chatId);
         if (!task || items === null || this.delegating(chatId)) {
             return;

package/dist/tasks/task-store.d.ts

@@ -25,6 +25,7 @@ export declare class TaskStore {
         prompt: string;
         batchId?: string;
         requiresTaskTurn?: boolean;
+        machine?: string;
     }, now: number): Promise<Task>;
     all(): Task[];
     settled(): Promise<void>;

package/dist/tasks/wiring.d.ts

@@ -12,6 +12,7 @@ export interface TaskRecord {
     childId: string;
     title: string;
     prompt: string;
+    machine?: string;
 }
 export interface TaskVerbs {
     open(record: TaskRecord & {

package/dist/tasks/wiring.js

@@ -56,7 +56,15 @@ export function wireTasks(deps) {
         }
     });
     const requests = chatRequests(chats);
-    const waiting = new WaitingObserver({ openTask: (childId) => deps.tasks.openFor(childId), enqueue, now });
+    const waiting = new WaitingObserver({
+        // A child on another machine asks its questions there.
+        openTask: (childId) => {
+            const task = deps.tasks.openFor(childId);
+            return task?.machine === undefined ? task : undefined;
+        },
+        enqueue,
+        now
+    });
     chats.observe((event) => {
         coordinator.chatEvent(event);
         waiting.chatEvent(event);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents",
-  "version": "0.25.3",
+  "version": "0.25.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.25.3",
-    "@adecore/intelligent-ui": "0.25.3",
+    "@adecore/agent-contracts": "0.25.4",
+    "@adecore/intelligent-ui": "0.25.4",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/lineage.ts

@@ -19,7 +19,9 @@ const LineageSchema = z.object({
     ceiling: RuntimeModeSchema.optional(),
     createdAt: z.number(),
     /* When stopping or deleting the node that opened it ended this one too; a cascade never ends a node twice. */
-    endedAt: z.number().optional()
+    endedAt: z.number().optional(),
+    /* Set when the agent that opened this one runs on another machine; `openedBy` then names it there, not a node here. */
+    peer: z.object({ machineId: z.string().min(1) }).optional()
 });
 
 type Lineage = z.infer<typeof LineageSchema>;
@@ -115,6 +117,11 @@ export class AgentLineageStore {
         return entry !== undefined && openedByAgent(entry) ? (entry.ceiling ?? null) : null;
     }
 
+    /* The machine whose agent opened this node, or null for a node opened on this one. */
+    peerOf(nodeId: string): { machineId: string } | null {
+        return this.opened.get(nodeId)?.peer ?? null;
+    }
+
     /* How deep a node sits. A node nobody wrote down is one a person made, which is where a chain starts. */
     depthOf(nodeId: string): number {
         return this.opened.get(nodeId)?.depth ?? 0;

package/src/tasks/task-coordinator.ts

@@ -126,6 +126,19 @@ export class TaskCoordinator {
         await this.deps.tasks.settled();
     }
 
+    /*
+     * Settles a task whose child runs on another machine, which no chat here observes: the answer comes
+     * from there. Wakes the parent once however often it is told; null when the task is no such task or
+     * was not open any more.
+     */
+    async settleFromElsewhere(taskId: string, result: TaskResult, status: 'done' | 'failed' = 'done'): Promise<Task | null> {
+        const task = this.deps.tasks.get(taskId);
+        if (task?.machine === undefined || task.status !== 'open') {
+            return null;
+        }
+        return this.settleNow(task, status, result);
+    }
+
     chatEvent(event: AgentEvent): void {
         if (this.stopped || event.event !== 'chat.event') {
             return;
@@ -154,7 +167,7 @@ export class TaskCoordinator {
         if (this.stopped) {
             return;
         }
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         if (!task || !this.deps.placed(childId)) {
             return;
         }
@@ -172,7 +185,7 @@ export class TaskCoordinator {
 
     /* `done` from the child itself, which wins over whatever else was about to settle it. */
     async done(childId: string, text: string): Promise<Task | null> {
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         if (!task) {
             return null;
         }
@@ -185,7 +198,7 @@ export class TaskCoordinator {
      * does when the CLI goes within one run.
      */
     async outlasted(childId: string, commands: readonly string[], cause: 'limit' | 'restart' = 'limit'): Promise<Task | null> {
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         const items = this.deps.chatItems(childId);
         if (this.stopped || !task || items === null || this.delegating(childId)) {
             return null;
@@ -208,9 +221,15 @@ export class TaskCoordinator {
         }
     }
 
+    /* The open task a chat here works on; one whose child runs on another machine is settled from there. */
+    private localTask(childId: string): Task | undefined {
+        const task = this.deps.tasks.openFor(childId);
+        return task?.machine === undefined ? task : undefined;
+    }
+
     /* An open task of this child that nothing can carry any more. */
     private failed(childId: string, text: string): void {
-        const task = this.deps.tasks.openFor(childId);
+        const task = this.localTask(childId);
         if (!task || this.stopped) {
             return;
         }
@@ -236,7 +255,7 @@ export class TaskCoordinator {
     }
 
     private turnEnded(chatId: string, turn: ChatTurnItem): void {
-        const task = this.deps.tasks.openFor(chatId);
+        const task = this.localTask(chatId);
         const items = this.deps.chatItems(chatId);
         if (!task || items === null || !this.answers(items, turn, task) || this.delegating(chatId)) {
             return;
@@ -360,7 +379,7 @@ export class TaskCoordinator {
 
     /* A child that took up work again is no longer waiting out a limit. */
     private turnStarted(chatId: string): void {
-        const task = this.deps.tasks.openFor(chatId);
+        const task = this.localTask(chatId);
         if (task?.paused !== undefined) {
             this.hold(task, null);
         }
@@ -371,7 +390,7 @@ export class TaskCoordinator {
     }
 
     private recheck(chatId: string): void {
-        const task = this.deps.tasks.openFor(chatId);
+        const task = this.localTask(chatId);
         const items = this.deps.chatItems(chatId);
         if (!task || items === null || this.delegating(chatId)) {
             return;

package/src/tasks/task-store.ts

@@ -51,7 +51,16 @@ export class TaskStore {
     }
 
     async open(
-        record: { projectId: string; parentId: string; childId: string; title: string; prompt: string; batchId?: string; requiresTaskTurn?: boolean },
+        record: {
+            projectId: string;
+            parentId: string;
+            childId: string;
+            title: string;
+            prompt: string;
+            batchId?: string;
+            requiresTaskTurn?: boolean;
+            machine?: string;
+        },
         now: number
     ): Promise<Task> {
         const task: Task = {

package/src/tasks/wiring.ts

@@ -22,6 +22,8 @@ export interface TaskRecord {
     childId: string;
     title: string;
     prompt: string;
+    /* The machine the child runs on, when it is not this one. */
+    machine?: string;
 }
 
 /* What the verbs of a context CLI reach of the tasks. */
@@ -127,7 +129,15 @@ export function wireTasks(deps: TaskWiringDeps): TaskWiring {
     });
 
     const requests = chatRequests(chats);
-    const waiting = new WaitingObserver({ openTask: (childId) => deps.tasks.openFor(childId), enqueue, now });
+    const waiting = new WaitingObserver({
+        // A child on another machine asks its questions there.
+        openTask: (childId) => {
+            const task = deps.tasks.openFor(childId);
+            return task?.machine === undefined ? task : undefined;
+        },
+        enqueue,
+        now
+    });
 
     chats.observe((event) => {
         coordinator.chatEvent(event);