@amaster.ai/dsh-a2a 0.1.37 → 0.1.39

package/lib/types/bridge.d.ts

@@ -79,6 +79,7 @@ export declare class A2aBridge {
     private readonly executing;
     private readonly asked;
     private readonly approvals;
+    private readonly preparing;
     private readonly codec;
     private readonly delegation;
     private readonly children;
@@ -96,8 +97,8 @@ export declare class A2aBridge {
     }>;
     private ensureTaskInner;
     private createAgent;
-    /** A2A parts → dsh content blocks; throws only when no part is usable. */
-    buildContent(message: Message, contextId: string): Promise<ContentBlock[]>;
+    /** A2A parts → dsh content blocks; rejects unusable messages and cancellation. */
+    buildContent(message: Message, contextId: string, signal?: AbortSignal, taskId?: string): Promise<ContentBlock[]>;
     isClearing(contextId: string): boolean;
     /** Called before the SDK starts an executor, so a bad reply cannot fail the live task. */
     validateApprovalMessage(message: Message): boolean;

package/lib/types/content.d.ts

@@ -26,6 +26,7 @@ export interface A2aFileMaterializer {
         bytes: Uint8Array;
         filename: string;
         mediaType: string;
+        signal?: AbortSignal;
     }): Promise<{
         readablePath: string;
     }>;
@@ -40,7 +41,7 @@ export interface UrlDownloadOptions {
     /** Private/loopback hosts are refused unless explicitly named here. */
     allowedHosts?: readonly string[];
 }
-export declare function buildMessageContent(parts: readonly Part[], attachments: AttachmentStore | undefined, dir: string, materialization?: Materialization, downloads?: UrlDownloadOptions): Promise<ContentBlock[]>;
+export declare function buildMessageContent(parts: readonly Part[], attachments: AttachmentStore | undefined, dir: string, materialization?: Materialization, downloads?: UrlDownloadOptions, signal?: AbortSignal): Promise<ContentBlock[]>;
 /** The directory non-image file parts persist into without a materializer. */
 export declare function uploadsDir(root?: string): string;
 export {};

package/lib/types/inbox.d.ts

@@ -56,14 +56,16 @@ declare module '@deepseek-ai/cordis' {
 }
 /** Same-process queue control; wire messages and task subscriptions remain standard A2A. */
 export interface A2aInbox {
+    /** Scoped, conservative candidates; discovery never resolves or wakes an agent. */
+    recoveryCandidates(context?: ServerCallContext): Promise<string[]>;
     get(contextId: string, page?: InboxPageOptions): Promise<InboxSnapshot>;
     update(contextId: string, id: string, message: Message, page?: InboxPageOptions): Promise<InboxSnapshot>;
     move(contextId: string, id: string, index: number, page?: InboxPageOptions): Promise<InboxSnapshot>;
     remove(contextId: string, id: string, page?: InboxPageOptions): Promise<InboxSnapshot>;
     clearPending(contextId: string, page?: InboxPageOptions): Promise<InboxSnapshot>;
     executePending(contextId: string, id?: string, page?: InboxPageOptions): Promise<InboxSnapshot>;
-    resolve(contextId: string): Promise<Agent>;
-    content(message: Message, contextId: string): Promise<ContentBlock[]>;
+    resolve(contextId: string, context?: ServerCallContext): Promise<Agent>;
+    content(message: Message, contextId: string, signal?: AbortSignal): Promise<ContentBlock[]>;
     /** Admit a same-process host follow-up under an existing task's durable identity. */
     enqueue(taskId: string, message: Message, options?: {
         target?: InboxTarget;
@@ -116,8 +118,9 @@ export declare class NativeInbox implements A2aInbox {
     private readonly persistence?;
     constructor(ctx: Context, bridge: A2aBridge, store: ManagedTaskStore, retainPending?: boolean, notifications?: boolean);
     private unloading;
-    content(message: Message, contextId: string): Promise<ContentBlock[]>;
-    resolve(contextId: string): Promise<Agent>;
+    content(message: Message, contextId: string, signal?: AbortSignal): Promise<ContentBlock[]>;
+    resolve(contextId: string, context?: ServerCallContext): Promise<Agent>;
+    recoveryCandidates(context?: ServerCallContext): Promise<string[]>;
     get(contextId: string, page?: InboxPageOptions): Promise<InboxSnapshot>;
     private editQueue;
     private queued;
@@ -152,9 +155,9 @@ export declare class NativeInbox implements A2aInbox {
     /** Reattach a cold task before the SDK decides whether cancellation has a live executor. */
     beforeTask(taskId: string, context: ServerCallContext): Promise<void>;
     private outcome;
-    private terminal;
     private admit;
     execute(request: RequestContext, bus: ExecutionEventBus): Promise<void>;
+    private committedInputs;
     private restoreTask;
     private select;
     private protocolMessage;

package/lib/types/stores/filesystem.d.ts

@@ -11,5 +11,7 @@ export declare class FilesystemTaskStore implements ManagedTaskStore {
     save(task: Task, context: ServerCallContext): Promise<void>;
     load(id: string, context: ServerCallContext): Promise<Task | undefined>;
     delete(id: string, context: ServerCallContext): Promise<void>;
+    private shells;
+    recoveryCandidates(context: ServerCallContext): Promise<string[]>;
     list(params: ListTasksRequest, context: ServerCallContext): Promise<ListTasksResponse>;
 }

package/lib/types/stores/gcs.d.ts

@@ -29,6 +29,8 @@ export declare class GcsTaskStore implements ManagedTaskStore {
     save(task: Task, context: ServerCallContext): Promise<void>;
     load(taskId: string, context: ServerCallContext): Promise<Task | undefined>;
     delete(taskId: string, context: ServerCallContext): Promise<void>;
+    private shells;
+    recoveryCandidates(context: ServerCallContext): Promise<string[]>;
     list(params: ListTasksRequest, context: ServerCallContext): Promise<ListTasksResponse>;
     /**
      * Tar + gzip the workspace directory to `tasks/{scope}/{taskId}/workspace.tar.gz`.

package/lib/types/stores/listing.d.ts

@@ -0,0 +1,10 @@
+import type { ListTasksRequest, ListTasksResponse, Task } from '@a2a-js/sdk';
+export declare const LIST_PREFIX_BYTES = 8192;
+/** Only the fields needed by listShells; never retain history or status-message content. */
+export declare function taskListShell(task: Task): Task;
+export declare function parseListShell(value: unknown): Task | undefined;
+/** A JSON-compatible header shares the snapshot's atomic write, including on older readers. */
+export declare function serializeTaskSnapshot(task: Task, json?: unknown): string;
+export declare function snapshotListShell(prefix: string): Task | undefined;
+/** Hydrate only the selected page, with bounded I/O and the existing artifact semantics. */
+export declare function loadTaskPage(shells: Task[], params: ListTasksRequest, load: (ids: string[]) => Promise<Array<Task | undefined>>): Promise<ListTasksResponse>;

package/lib/types/stores/redis.d.ts

@@ -25,6 +25,8 @@ export declare class RedisTaskStore implements ManagedTaskStore {
     save(task: Task, context: ServerCallContext): Promise<void>;
     load(taskId: string, context: ServerCallContext): Promise<Task | undefined>;
     delete(taskId: string, context: ServerCallContext): Promise<void>;
+    private shells;
+    recoveryCandidates(context: ServerCallContext): Promise<string[]>;
     list(params: ListTasksRequest, context: ServerCallContext): Promise<ListTasksResponse>;
     close(): Promise<void>;
 }

package/lib/types/task-store.d.ts

@@ -24,12 +24,18 @@ export declare function commitInboxInput(history: Message[], message: Message):
 export declare function sanitizeTask(task: Task): Task;
 /** TaskStore with the optional lifecycle our backends add. */
 export interface ManagedTaskStore extends TaskStore {
+    /** Conservative discovery only; does not establish that input is safe to execute. */
+    recoveryCandidates?(context: ServerCallContext): Promise<string[]>;
     /** Durable admission checkpoint even when task state has not changed. */
     checkpoint?(task: Task, context: ServerCallContext): Promise<void>;
     init?(): Promise<void>;
     delete(taskId: string, context: ServerCallContext): Promise<void>;
     close?(): Promise<void>;
 }
+export declare function isTerminalTask(task: Task): boolean;
+export declare function recoveryContextIds(tasks: Task[]): string[];
+/** Custom stores retain a complete, if more expensive, discovery path. */
+export declare function findRecoveryCandidates(store: ManagedTaskStore, context: ServerCallContext): Promise<string[]>;
 /** A safe path/key segment for the SDK's tenant and owner scope. */
 export declare function taskScopeKey(context: ServerCallContext): string;
 /** The SDK memory store has no delete operation; keep the same shell contract. */
@@ -39,6 +45,7 @@ export declare class MemoryTaskStore implements ManagedTaskStore {
     save(task: Task, context: ServerCallContext): Promise<void>;
     load(taskId: string, context: ServerCallContext): Promise<Task | undefined>;
     list(params: ListTasksRequest, context: ServerCallContext): Promise<ListTasksResponse>;
+    recoveryCandidates(context: ServerCallContext): Promise<string[]>;
     delete(taskId: string, context: ServerCallContext): Promise<void>;
 }
 /** Saves task snapshots on state transitions while keeping active deltas in process. */
@@ -59,6 +66,7 @@ export declare class SanitizedTaskStore implements ManagedTaskStore {
     save(task: Task, context: ServerCallContext, checkpoint?: boolean): Promise<void>;
     load(taskId: string, context: ServerCallContext): Promise<Task | undefined>;
     list(params: ListTasksRequest, context: ServerCallContext): Promise<ListTasksResponse>;
+    recoveryCandidates(context: ServerCallContext): Promise<string[]>;
 }
 /**
  * Shared `listTasks` semantics for the backends: filter by contextId / status /

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/dsh-a2a",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "description": "A2A protocol (JSON-RPC + SSE) server plugin for DeepSeek Harness: expose dsh agents as A2A agents.",
   "type": "module",
   "main": "lib/index.js",