newmark-agent 0.5.14 → 0.6.0

package/dist/core/subagent.d.ts

@@ -2,6 +2,7 @@ import { NewmarkToolResult } from './compat';
 import type { AgentMode } from './types';
 export type SubagentStatus = 'idle' | 'queued' | 'working' | 'completed' | 'closed' | 'error';
 export type SubagentMessageKind = 'directive' | 'question' | 'result' | 'handoff';
+export declare const SUBAGENT_RECOVERY_PROMPT = "[Peer runtime recovery] Continue the unfinished work from the persisted working history. Preserve completed tool results and follow the latest instruction; do not repeat completed work.";
 export interface SubagentMessage {
     id: string;
     conversationId: string;
@@ -10,6 +11,15 @@ export interface SubagentMessage {
     toAgentId: string;
     kind: SubagentMessageKind;
     body: string;
+    wakeup: boolean;
+    /** A message accepted by an existing job must survive that job settling. */
+    acceptedWhileActive: boolean;
+    /** Runtime-consumed control messages never become model continuation input. */
+    control?: {
+        action: 'stop';
+        runId: string;
+        force: boolean;
+    };
     correlationId?: string;
     replyTo?: string;
     createdAt: string;
@@ -23,8 +33,16 @@ export interface SubagentRootMessage {
     toAgentId: string;
     kind: SubagentMessageKind;
     body: string;
+    wakeup: boolean;
     createdAt: string;
     readAt?: string;
+    /** Only runtime-generated completion notices carry this provenance. */
+    source?: 'automatic-settlement';
+    settlementRevision?: number;
+}
+export interface SubagentSettlementReceipt {
+    peerId: string;
+    revision: number;
 }
 export interface SubagentMessageRecord {
     role: string;
@@ -69,6 +87,8 @@ export interface SubagentInstance {
     queueSequence?: number;
     messages: Array<SubagentMessageRecord>;
     result: string | null;
+    /** Monotonic per-peer result version, independent of timestamps/content. */
+    settlementRevision?: number;
     error?: string;
     createdAt: string;
     startedAt?: string;
@@ -94,6 +114,8 @@ export interface SubagentState {
     nextSequence: number;
     /** Cooperative root-run stop gate. Pending peers stay durable but cannot start until the next root run resumes scheduling. */
     schedulingPaused?: boolean;
+    /** Exact queued/in-flight inputs survive a restart between mailbox dispatch and child transcript persistence. */
+    jobs?: PendingJob[];
     records: SubagentInstance[];
     mailbox: SubagentMessage[];
     rootInbox: SubagentRootMessage[];
@@ -142,7 +164,7 @@ export interface SubagentReadSnapshot {
         inbound: number;
         outbound: number;
         unread: number;
-        latest: Array<Pick<SubagentMessage, 'id' | 'sequence' | 'fromAgentId' | 'toAgentId' | 'kind' | 'body' | 'createdAt' | 'readAt'>>;
+        latest: Array<Pick<SubagentMessage, 'id' | 'sequence' | 'fromAgentId' | 'toAgentId' | 'kind' | 'body' | 'wakeup' | 'acceptedWhileActive' | 'createdAt' | 'readAt'>>;
     };
     truncated: boolean;
 }
@@ -167,6 +189,14 @@ export interface SubagentManagerOptions {
     onRootInboxMessage?: (message: SubagentRootMessage) => boolean;
     onSettled?: (record: SubagentInstance) => void;
 }
+interface PendingJob {
+    id: string;
+    prompt: string;
+    flowName: string;
+    sequence: number;
+    reason: SubagentExecutionJob['reason'];
+    inputCommitted?: boolean;
+}
 /** Conversation-owned flat peer-agent coordinator with durable FIFO scheduling. */
 export declare class SubagentManager {
     private subs;
@@ -174,6 +204,7 @@ export declare class SubagentManager {
     private rootInbox;
     private pending;
     private running;
+    private activeJobs;
     private schedulingPaused;
     private nextSequence;
     private concurrency;
@@ -182,33 +213,46 @@ export declare class SubagentManager {
     private persist?;
     private onMailboxMessage?;
     private rootInboxListeners;
+    private bindingOwner?;
+    private ownerBindings;
     private onSettled?;
     private changedQueued;
     private settledWaiters;
     readonly conversationId: string;
     readonly rootAgentId: string;
     hasRecords(): boolean;
+    hasPendingWork(): boolean;
     reset(): void;
     constructor(options?: SubagentManagerOptions);
     bind(options: Pick<SubagentManagerOptions, 'concurrency' | 'executor' | 'onChange' | 'persist' | 'onMailboxMessage' | 'onRootInboxMessage' | 'onSettled'>): void;
+    ownsExecutionBinding(listener: (message: SubagentRootMessage) => boolean): boolean;
+    private rememberOwnerBinding;
     removeRootInboxListener(listener: (message: SubagentRootMessage) => boolean): void;
+    /** Detach one facade without clearing a newer owner's callbacks or live jobs. */
+    releaseOwnerBinding(listener: (message: SubagentRootMessage) => boolean): boolean;
     create(name: string, prompt: string, model?: string, inputMode?: string, agentMode?: AgentMode, createdByAgentId?: string, flowName?: string, goalObjective?: string, flowPc?: number, buildRunId?: string, intelligenceTier?: string): string;
     get(id: string): SubagentInstance | undefined;
-    send(id: string, prompt: string): boolean;
+    send(id: string, prompt: string, wakeup?: boolean): boolean;
+    broadcastStop(fromAgentId: string, runId: string, force?: boolean): {
+        count: number;
+        ids: string[];
+        peerIds: string[];
+    };
     sendMessage(fromAgentId: string, toAgentId: string, body: string, kind?: SubagentMessageKind, details?: {
         correlationId?: string;
         replyTo?: string;
-    }): {
+    }, wakeup?: boolean): {
         ok: boolean;
         message?: SubagentMessage;
         error?: string;
     };
-    sendRootMessage(fromAgentId: string, body: string, kind?: SubagentMessageKind): {
+    sendRootMessage(fromAgentId: string, body: string, kind?: SubagentMessageKind, settlementRevision?: number, wakeup?: boolean): {
         ok: boolean;
         message?: SubagentRootMessage;
         error?: string;
     };
     readRootInbox(): SubagentRootMessage[];
+    acknowledgeSettlementResults(receipts: SubagentSettlementReceipt[]): string[];
     acknowledgeRootInbox(messageId: string): boolean;
     consumeMailbox(agentId: string): SubagentMessage[];
     acknowledgeMailbox(agentId: string, messageId: string): boolean;
@@ -219,7 +263,8 @@ export declare class SubagentManager {
         error?: string;
     };
     appendAssistant(id: string, content: string): void;
-    replaceContext(id: string, history: Array<Record<string, unknown>>, compression: SubagentCompressionState | null): void;
+    replaceContext(id: string, history: Array<Record<string, unknown>>, compression: SubagentCompressionState | null, inputCommitted?: boolean): void;
+    patchMetadata(id: string, patch: Record<string, unknown>): void;
     complete(id: string, result: string): void;
     fail(id: string, error: string): void;
     markWorking(id: string): void;
@@ -235,6 +280,44 @@ export declare class SubagentManager {
     boundedResultTranscript(idOrName: string): string;
     listActive(): SubagentInstance[];
     listAll(): SubagentInstance[];
+    /** Model-facing list: detailed transcripts and request cache remain private. */
+    listSummaries(status?: string): {
+        id: string;
+        shortId: string;
+        natureSlug: string;
+        displayName: string;
+        qualifiedName: string;
+        name: string;
+        conversationId: string;
+        createdByAgentId: string;
+        buildRunId: string | undefined;
+        intelligenceTier: string | undefined;
+        prompt: string;
+        model: string;
+        inputMode: string;
+        agentMode: AgentMode;
+        mode: AgentMode;
+        status: SubagentStatus;
+        active: boolean;
+        goalObjective: string | undefined;
+        flowName: string | undefined;
+        flowPc: number | undefined;
+        queueSequence: number | undefined;
+        resultAvailable: boolean;
+        resultChars: number;
+        settlementRevision: number | undefined;
+        messageCount: number;
+        error: string | undefined;
+        createdAt: string;
+        startedAt: string | undefined;
+        updatedAt: string;
+        completedAt: string | undefined;
+        closedAt: string | undefined;
+        mailbox: {
+            total: number;
+            unread: number;
+        };
+    }[];
     activeCountForBuild(buildRunId: string): number;
     setConcurrencyLimit(value: number): void;
     concurrencyLimit(): number;
@@ -258,4 +341,5 @@ export declare class SubagentManager {
 }
 export declare function sharedSubagentManager(key: string, options: SubagentManagerOptions): SubagentManager;
 export declare function releaseSharedSubagentManager(key: string): void;
+export {};
 //# sourceMappingURL=subagent.d.ts.map