dsh-a2a-server 0.2.0 → 0.4.0

package/lib/projection.d.ts

@@ -40,6 +40,17 @@ export interface A2ATaskView {
      * `exactOptionalPropertyTypes`.
      */
     stopReason?: string | undefined;
+    /**
+     * The visitor's submitted text, when a non-terminal edge recorded it.
+     *
+     * Monitoring reads this to show what a visitor said; the A2A wire task does
+     * not carry it (a peer already knows what it sent).
+     *
+     * Explicitly `| undefined` because the value round-trips through a zod schema
+     * whose inferred optional includes it, and this project compiles with
+     * `exactOptionalPropertyTypes`.
+     */
+    input?: string | undefined;
     /** Wall-clock of the last recorded edge, for `Task.status.timestamp`. */
     updatedAt: string;
 }
@@ -48,12 +59,16 @@ export interface A2ATaskProjection {
     tasks: Record<string, A2ATaskView>;
 }
 declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionStateMap {
+        /** Per-session A2A task fold state (plain JSON, per the cache precondition). */
+        a2aTask: A2ATaskState_;
+    }
     interface SessionProjectionMap {
         /** Per-session A2A task states, folded from `a2a/task` edges. */
         a2aTask: A2ATaskProjection;
     }
 }
-/** Validates the wire payload before it leaves the host. */
+/** Validates the unit's state and wire payload — both are the same shape here. */
 export declare const A2A_TASK_VIEW_SCHEMA: z.ZodObject<{
     tasks: z.ZodRecord<z.ZodString, z.ZodObject<{
         taskId: z.ZodString;
@@ -69,6 +84,7 @@ export declare const A2A_TASK_VIEW_SCHEMA: z.ZodObject<{
             TASK_STATE_FAILED: "TASK_STATE_FAILED";
             TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
         }>;
+        input: z.ZodOptional<z.ZodString>;
         output: z.ZodOptional<z.ZodString>;
         stopReason: z.ZodOptional<z.ZodString>;
         updatedAt: z.ZodString;
@@ -83,10 +99,13 @@ export interface A2ATaskState_ {
  *
  * Declared as a plain object rather than built inside `apply()` so the fold can
  * be unit-tested without a Cordis context or a session.
+ *
+ * This unit's state and view are the same shape, so one schema serves both the
+ * persisted-state check (`stateSchema`) and the wire check (`wire.viewSchema`).
  */
 export declare const a2aTaskProjection: {
     key: "a2aTask";
-    schema: z.ZodObject<{
+    stateSchema: z.ZodObject<{
         tasks: z.ZodRecord<z.ZodString, z.ZodObject<{
             taskId: z.ZodString;
             peer: z.ZodString;
@@ -101,6 +120,7 @@ export declare const a2aTaskProjection: {
                 TASK_STATE_FAILED: "TASK_STATE_FAILED";
                 TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
             }>;
+            input: z.ZodOptional<z.ZodString>;
             output: z.ZodOptional<z.ZodString>;
             stopReason: z.ZodOptional<z.ZodString>;
             updatedAt: z.ZodString;
@@ -128,6 +148,29 @@ export declare const a2aTaskProjection: {
      * @param state - the current state.
      * @returns the whole current value.
      */
-    view(state: A2ATaskState_): A2ATaskProjection;
+    wire: {
+        viewSchema: z.ZodObject<{
+            tasks: z.ZodRecord<z.ZodString, z.ZodObject<{
+                taskId: z.ZodString;
+                peer: z.ZodString;
+                state: z.ZodEnum<{
+                    TASK_STATE_UNSPECIFIED: "TASK_STATE_UNSPECIFIED";
+                    TASK_STATE_SUBMITTED: "TASK_STATE_SUBMITTED";
+                    TASK_STATE_WORKING: "TASK_STATE_WORKING";
+                    TASK_STATE_INPUT_REQUIRED: "TASK_STATE_INPUT_REQUIRED";
+                    TASK_STATE_AUTH_REQUIRED: "TASK_STATE_AUTH_REQUIRED";
+                    TASK_STATE_COMPLETED: "TASK_STATE_COMPLETED";
+                    TASK_STATE_CANCELED: "TASK_STATE_CANCELED";
+                    TASK_STATE_FAILED: "TASK_STATE_FAILED";
+                    TASK_STATE_REJECTED: "TASK_STATE_REJECTED";
+                }>;
+                input: z.ZodOptional<z.ZodString>;
+                output: z.ZodOptional<z.ZodString>;
+                stopReason: z.ZodOptional<z.ZodString>;
+                updatedAt: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        view(state: A2ATaskState_): A2ATaskProjection;
+    };
 };
 //# sourceMappingURL=projection.d.ts.map

package/lib/projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElE,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,CAAA;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACnC;AAED,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,oBAAoB;QAC5B,iEAAiE;QACjE,OAAO,EAAE,iBAAiB,CAAA;KAC3B;CACF;AAUD,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAS/B,CAAA;AAEF,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACnC;AAYD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;IAQ5B;;;OAGG;YACK,aAAa;IAIrB;;;;;;;;;OASG;iBACU,aAAa,SAAS,YAAY,GAAG,aAAa;IA2B/D;;;;OAIG;gBACS,aAAa,GAAG,iBAAiB;CAG9C,CAAA"}
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElE,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,YAAY,CAAA;IACnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACnC;AAED,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,yBAAyB;QACjC,gFAAgF;QAChF,OAAO,EAAE,aAAa,CAAA;KACvB;IACD,UAAU,oBAAoB;QAC5B,iEAAiE;QACjE,OAAO,EAAE,iBAAiB,CAAA;KAC3B;CACF;AAUD,kFAAkF;AAClF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;iBAU/B,CAAA;AAEF,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACnC;AAaD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;IAQ5B;;;OAGG;YACK,aAAa;IAIrB;;;;;;;;;OASG;iBACU,aAAa,SAAS,YAAY,GAAG,aAAa;IAgC/D;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;oBAGW,aAAa,GAAG,iBAAiB;;CAIhD,CAAA"}

package/lib/projection.js

@@ -23,12 +23,13 @@ const STATES = [
     'TASK_STATE_COMPLETED', 'TASK_STATE_CANCELED',
     'TASK_STATE_FAILED', 'TASK_STATE_REJECTED',
 ];
-/** Validates the wire payload before it leaves the host. */
+/** Validates the unit's state and wire payload — both are the same shape here. */
 export const A2A_TASK_VIEW_SCHEMA = z.object({
     tasks: z.record(z.string(), z.object({
         taskId: z.string(),
         peer: z.string(),
         state: z.enum(STATES),
+        input: z.string().optional(),
         output: z.string().optional(),
         stopReason: z.string().optional(),
         updatedAt: z.string(),
@@ -39,14 +40,17 @@ export const A2A_TASK_VIEW_SCHEMA = z.object({
  *
  * Declared as a plain object rather than built inside `apply()` so the fold can
  * be unit-tested without a Cordis context or a session.
+ *
+ * This unit's state and view are the same shape, so one schema serves both the
+ * persisted-state check (`stateSchema`) and the wire check (`wire.viewSchema`).
  */
 export const a2aTaskProjection = {
     key: 'a2aTask',
-    schema: A2A_TASK_VIEW_SCHEMA,
-    // Bumped for A2A v1.0: task states are persisted in their new ProtoJSON
-    // spelling, so a cache written under the v0.3 spelling must be discarded
-    // rather than folded onto.
-    stateVersion: 2,
+    stateSchema: A2A_TASK_VIEW_SCHEMA,
+    // v2 folded A2A v1.0 state spellings; v3 adds the visitor's submitted text
+    // (`input`) to the state shape, so a v2 cache must be discarded rather than
+    // folded onto.
+    stateVersion: 3,
     /**
      * State for the empty log.
      * @returns the initial state.
@@ -74,6 +78,9 @@ export const a2aTaskProjection = {
         // Terminal states are final: a late edge must not reopen a settled task.
         if (previous !== undefined && TERMINAL.has(previous.state))
             return state;
+        // A terminal edge carries the answer, not the question: the input recorded
+        // by the submitted edge carries forward so a settled row stays complete.
+        const input = data.input ?? previous?.input;
         return {
             tasks: {
                 ...state.tasks,
@@ -81,6 +88,7 @@ export const a2aTaskProjection = {
                     taskId: data.taskId,
                     peer: data.peer,
                     state: data.state,
+                    ...input === undefined ? {} : { input },
                     ...data.output === undefined ? {} : { output: data.output },
                     ...data.stopReason === undefined ? {} : { stopReason: data.stopReason },
                     // The log has no wall-clock of its own, so the fold stamps when it
@@ -96,8 +104,11 @@ export const a2aTaskProjection = {
      * @param state - the current state.
      * @returns the whole current value.
      */
-    view(state) {
-        return { tasks: state.tasks };
+    wire: {
+        viewSchema: A2A_TASK_VIEW_SCHEMA,
+        view(state) {
+            return { tasks: state.tasks };
+        },
     },
 };
 const TERMINAL = new Set([

package/lib/projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"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"}

package/lib/router.d.ts

@@ -26,11 +26,21 @@ export interface RouterDeps {
     };
     assertOpen: () => void;
     resolvePeerSecrets: () => Promise<Map<PeerIdentity, string>>;
+    /**
+     * Resolve the deployment owner's token, per request. The owner is the
+     * console on this machine: accepted only on IPC, never in the peers table.
+     * It retains the caretaker preset and bypasses only the visitor turn cap.
+     */
+    resolveOwnerSecret?: (() => Promise<string | undefined>) | undefined;
     identify: (token: string | undefined, secrets: ReadonlyMap<PeerIdentity, string>) => PeerIdentity | undefined;
     cardFor: (hostHeader: string | undefined) => A2AAgentCard;
     /** The authenticated extended card, or undefined when none is configured. */
     extendedCardFor: (hostHeader: string | undefined) => A2AAgentCard | undefined;
     createActivation: (peer: PeerIdentity) => Promise<Activation>;
+    releaseActivation: (activation: Activation) => void;
+    restoreActivation: (id: string, peer: PeerIdentity) => Promise<Activation | undefined>;
+    retainedTasks: (peer: PeerIdentity) => A2ATask[];
+    reserveTask: (peer: PeerIdentity) => () => void;
     submit: (activation: Activation, text: string, peer: PeerIdentity) => Promise<TaskSlot>;
     cancel: (activation: Activation, slot: TaskSlot) => void;
     taskSnapshot: (activation: Activation, slot: TaskSlot, state: A2ATaskState, artifacts: A2AArtifact[], stopReason?: string) => A2ATask;
@@ -48,11 +58,48 @@ export interface RouterDeps {
      * {@link readProjectedTask}.
      */
     readProjectedTasks?: (activation: Activation) => A2ATask[];
+    /**
+     * Resolve the admin token, per request. Present exactly when the deployment
+     * configured `admin.tokenEnv`; absent means the admin surface is not mounted.
+     */
+    /** The whole monitoring view over resident contexts. */
+    adminSnapshot?: () => AdminSnapshot;
+    /** Drain tasks and persist guest disks before the local owner stops the host. */
+    prepareStop?: () => Promise<void>;
+}
+/** One task as the monitoring surface shows it. */
+export interface AdminTaskView {
+    taskId: string;
+    state: A2ATaskState;
+    /** What the visitor said, as recorded on the task's non-terminal edges. */
+    input?: string;
+    /** What the agent answered, when the task has settled with output. */
+    output?: string;
+    updatedAt: string;
+}
+/** One resident context as the monitoring surface shows it. */
+export interface AdminContextView {
+    contextId: string;
+    peer: string;
+    cwd: string;
+    lastTouchedAt: number;
+    /** Tasks still in flight. */
+    active: number;
+    /** Every task this context has seen, in fold order. */
+    tasks: AdminTaskView[];
+}
+/** What `{basePath}/admin/contexts` serves. */
+export interface AdminSnapshot {
+    generatedAt: string;
+    contexts: AdminContextView[];
 }
 /** The router surface the plugin body wires into routes and teardown. */
 export interface Router {
     serveCard: (req: IncomingMessage, res: ServerResponse) => void;
     serveRpc: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    serveOwnerRpc: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    /** The local-IPC monitoring surface under `{basePath}/admin/`. */
+    serveAdmin: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
     /** Send every open stream its terminal frame, then end it. */
     closeStreams: () => void;
 }

package/lib/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,EA2BL,KAAK,YAAY,EACjB,KAAK,WAAW,EAGhB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAChE,OAAO,EAAiC,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AACpH,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,YAAY,CAAA;AAQ1D,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,eAAe,CAAA;IACzB,KAAK,EAAE,WAAW,CAAA;IAClB,WAAW,EAAE,WAAW,CAAA;IACxB,MAAM,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;IAC7E,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,kBAAkB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5D,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,KAAK,YAAY,GAAG,SAAS,CAAA;IAC7G,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,YAAY,CAAA;IACzD,6EAA6E;IAC7E,eAAe,EAAE,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,KAAK,YAAY,GAAG,SAAS,CAAA;IAC7E,gBAAgB,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC7D,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;IACvF,MAAM,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IACxD,YAAY,EAAE,CACZ,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,WAAW,EAAE,EACxB,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAA;IACZ;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,GAAG,SAAS,CAAA;IACtF;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,EAAE,CAAA;CAC3D;AAUD,yEAAyE;AACzE,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAA;IAC9D,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtE,8DAA8D;IAC9D,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAmkBrD"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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"}