@huanlin/dsh-plugin-yet-another-subagent 0.1.6 → 0.3.0

package/lib/types/projection.d.ts

@@ -15,9 +15,17 @@
  * Both units are pure synchronous folds; the framework drives them and the
  * host wire layer ships the validated views.
  *
+ * Alpha.3 change-feed contract (`@deepseek-ai/dsh-session-projection`): the
+ * drive publishes a client view only when its raw output changes by
+ * `Object.is`, so an object-valued view MUST reuse its reference while the
+ * wire content is unchanged — a fresh object per call republishes on every
+ * internal-only state change (e.g. the excluded `streamingText`
+ * accumulator). Both `view`s below go through {@link memoizeView} for that
+ * reference-stability guarantee.
+ *
  * @module @huanlin/dsh-plugin-yet-another-subagent/projection
  */
-import type { ProjectionDefinition } from '@deepseek-ai/dsh-session-projection';
+import { z } from 'zod';
 import type { SessionEvent } from '@deepseek-ai/dsh-session';
 /** `subagentProfile` wire shape: childId → profileId, plus callId → childId. */
 export interface SubagentProfileProjection {
@@ -26,10 +34,14 @@ export interface SubagentProfileProjection {
     /** callId → childId (for foreground calls where the result text has no embedded id). */
     readonly calls: Record<string, string>;
 }
-/** Internal fold state for `subagentProfile`. */
+/**
+ * Internal fold state for `subagentProfile`. Plain JSON only (the persisted
+ * projection-cache precondition), so the pending callId map is a Record,
+ * not a Map.
+ */
 interface ProfileState {
     /** callId → profileId, awaiting the matching `tool/result`. */
-    readonly pending: Map<string, string>;
+    readonly pending: Record<string, string>;
     /** childId → profileId (the durable mapping). */
     readonly mapping: Record<string, string>;
     /** callId → childId (survives after the pending entry is consumed). */
@@ -42,7 +54,31 @@ interface ProfileState {
  * or `runId` (foreground branch); the continuable branch is the durable
  * child identity that survives across activations.
  */
-export declare const subagentProfileProjection: ProjectionDefinition<'subagentProfile', ProfileState>;
+export declare const subagentProfileProjection: {
+    key: "subagentProfile";
+    stateSchema: z.ZodObject<{
+        pending: z.ZodRecord<z.ZodString, z.ZodString>;
+        mapping: z.ZodRecord<z.ZodString, z.ZodString>;
+        callToChild: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>;
+    stateVersion: number;
+    init: () => {
+        pending: {};
+        mapping: {};
+        callToChild: {};
+    };
+    apply: (state: NoInfer<ProfileState>, event: SessionEvent) => ProfileState;
+    wire: {
+        viewSchema: z.ZodObject<{
+            children: z.ZodRecord<z.ZodString, z.ZodString>;
+            calls: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>;
+        view: (state: NoInfer<ProfileState>) => {
+            children: Record<string, string>;
+            calls: Record<string, string>;
+        };
+    };
+};
 /** `yaSubagentProgress` wire shape: live child progress for the parent's card. */
 export interface YaSubagentProgressProjection {
     /** Number of `tool/call` events folded so far. */
@@ -88,16 +124,91 @@ interface ProgressState {
  * usage accumulates from `assistant/message.usage` (cache fields are
  * optional); tool calls are counted; lifecycle follows turn boundaries.
  */
-export declare const yaSubagentProgressProjection: ProjectionDefinition<'yaSubagentProgress', ProgressState>;
+export declare const yaSubagentProgressProjection: {
+    key: "yaSubagentProgress";
+    stateSchema: z.ZodObject<{
+        toolCallCount: z.ZodNumber;
+        tokens: z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+            cacheRead: z.ZodNumber;
+            cacheWrite: z.ZodNumber;
+            reasoning: z.ZodNumber;
+        }, z.core.$strict>;
+        state: z.ZodUnion<readonly [z.ZodLiteral<"running">, z.ZodLiteral<"idle">, z.ZodLiteral<"settled">]>;
+        activity: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            kind: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"tool">;
+            name: z.ZodString;
+            args: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>]>>;
+        streamingText: z.ZodString;
+    }, z.core.$strict>;
+    stateVersion: number;
+    init: () => {
+        toolCallCount: number;
+        tokens: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            reasoning: number;
+        };
+        state: "idle";
+        streamingText: string;
+    };
+    apply: (state: NoInfer<ProgressState>, event: SessionEvent) => ProgressState;
+    wire: {
+        viewSchema: z.ZodObject<{
+            toolCallCount: z.ZodNumber;
+            tokens: z.ZodObject<{
+                input: z.ZodNumber;
+                output: z.ZodNumber;
+                cacheRead: z.ZodNumber;
+                cacheWrite: z.ZodNumber;
+                reasoning: z.ZodNumber;
+            }, z.core.$strict>;
+            state: z.ZodUnion<readonly [z.ZodLiteral<"running">, z.ZodLiteral<"idle">, z.ZodLiteral<"settled">]>;
+            activity: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                kind: z.ZodLiteral<"text">;
+                text: z.ZodString;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"tool">;
+                name: z.ZodString;
+                args: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>]>>;
+        }, z.core.$strict>;
+        view: (state: NoInfer<ProgressState>) => {
+            toolCallCount: number;
+            tokens: {
+                readonly input: number;
+                readonly output: number;
+                readonly cacheRead: number;
+                readonly cacheWrite: number;
+                readonly reasoning: number;
+            };
+            state: "running" | "idle" | "settled";
+            activity?: Activity;
+        };
+    };
+};
 /** Convenience: the projection keys registered by this plugin. */
 export declare const PROJECTION_KEYS: readonly ["subagentProfile", "yaSubagentProgress"];
-/** Type-side declaration merge so consumers can read these keys via the projection registry. */
+/** Type-side declaration merges so consumers can read these keys via the projection registry. */
 declare module '@deepseek-ai/dsh-session-projection/types' {
     interface SessionProjectionMap {
-        /** Parent-session map of childId → profileId. Empty object when no children yet. */
+        /** Parent-session map of childId → profileId. */
         subagentProfile: SubagentProfileProjection;
         /** Child-session live progress (toolcall count + token usage + state). */
         yaSubagentProgress: YaSubagentProgressProjection;
     }
+    interface SessionProjectionStateMap {
+        /** Host fold state behind {@link SubagentProfileProjection}. */
+        subagentProfile: ProfileState;
+        /** Host fold state behind {@link YaSubagentProgressProjection}. */
+        yaSubagentProgress: ProgressState;
+    }
 }
 export type { SessionEvent };

package/lib/types/repair.d.ts

@@ -1,15 +1,27 @@
 /**
- * One-shot session-log repair: stamp `"ignorable": true` onto legacy
- * `ya-subagent/started` events so the harness persistence read path
- * (`assertEventsSupported`) will skip them instead of refusing the whole log.
- *
- * Background: older plugin versions wrote `ya-subagent/started` via
- * `session.append(...)`, but `session.append` cannot set the `ignorable`
- * envelope flag, and `KNOWN_SESSION_EVENT_TYPES` is code-generated with no
- * plugin registration surface. The read path therefore refuses any log
- * containing the type unless each occurrence carries `ignorable: true`.
- * This module rewrites on-disk artifacts in place (after a `.bak` backup) to
- * add that flag to every `ya-subagent/started` row missing it.
+ * One-shot session-log repair: physically REMOVE legacy `ya-subagent/started`
+ * event rows so the harness persistence read path (`assertEventsSupported`)
+ * loads the log again.
+ *
+ * Background: plugin versions ≤0.1.2 appended `ya-subagent/started` via
+ * `session.append(...)`. `KNOWN_SESSION_EVENT_TYPES` is code-generated with no
+ * plugin registration surface, and v0.1.2-alpha.1 refuses EVERY log row whose
+ * type is outside that set — the old `ignorable` envelope flag no longer
+ * exists, so stamping it (the ≤0.1.5 repair) cannot help. The only repair is
+ * removal.
+ *
+ * Rows cannot simply be deleted: the read path enforces contiguous `seq`
+ * numbers. This module therefore rewrites the log in place (after a `.bak`
+ * backup):
+ *
+ *   - drops every `ya-subagent/started` row;
+ *   - decrements the `seq` of every later ordinary event row (packed
+ *     `text-chunks` / `reasoning-chunks` / `tool-call-chunks` storage rows
+ *     shift their `seq0` instead);
+ *   - shifts every `sourceEventSeqs` citation by the number of dropped rows
+ *     ahead of it (dropped rows are never cited: only surface events carry
+ *     provenance and they cite assistant chunks / surface nodes, which a
+ *     plugin row never is).
  *
  * Two physical encodings (mirrors `session-persistence-jsonl`):
  *   - `.jsonl`        — plaintext, one JSON record per line.
@@ -17,12 +29,17 @@
  *                       frame holds the session header line, subsequent
  *                       frames each hold one append batch of event lines.
  *                       Each frame is independently decodable + checksummed.
- *                       Only frames whose decoded plaintext contains a target
- *                       row are recompressed; untouched frames are copied
- *                       verbatim so byte-identity is preserved where possible.
+ *                       The first frame containing a dropped row and every
+ *                       frame after it are recompressed (their rows renumber);
+ *                       untouched earlier frames are copied verbatim.
+ *
+ * Modified rows are re-encoded with `JSON.stringify`, which reproduces the
+ * write path's canonical single-line form and preserves the parsed key order;
+ * untouched lines stay byte-identical.
  *
- * Idempotent: rows already carrying `ignorable: true` are skipped; files with
- * no target rows are left untouched (no backup, no rewrite).
+ * Idempotent: a log with no target rows is left untouched (no backup, no
+ * rewrite). A corrupt (unparsable) line is left untouched — that is the
+ * harness's refusal job, not ours.
  *
  * @module @huanlin/dsh-plugin-yet-another-subagent/repair
  */
@@ -30,9 +47,9 @@
 export interface RepairStats {
     /** Session log files examined (`.jsonl` + `.jsonl.zstd`). */
     readonly scanned: number;
-    /** Files rewritten because at least one target row was patched. */
+    /** Files rewritten because at least one target row was removed. */
     readonly repaired: number;
-    /** Files with no patchable rows (already clean or no target events). */
+    /** Files with no target rows (already clean). */
     readonly skipped: number;
     /** Per-file errors (path + message); empty on a clean run. */
     readonly errors: readonly {

package/lib/types/rpc.d.ts

@@ -52,7 +52,9 @@ export type YaSubagentValue = ProfileListResponse | ToolListResponse | RepairSta
  * Register the ya-subagent RPC channel on the host's connection service.
  * `connection` is in the plugin's inject list, so `ctx.connection` is
  * directly available; the channel route rolls back on fiber disposal
- * (the inner `owner.effect` owns cleanup).
+ * (the inner `owner.effect` owns cleanup). Trust and browser authentication
+ * moved to the physical `/api` carrier in v0.1.2-alpha.1, so channels no
+ * longer carry an `authority` option.
  * @param ctx - host context.
  * @param store - profile store.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huanlin/dsh-plugin-yet-another-subagent",
-  "version": "0.1.6",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },
@@ -17,10 +17,6 @@
       "types": "./lib/types/index.d.ts",
       "import": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "import": "./lib/invariant.js"
-    },
     "./client": {
       "types": "./lib/types/client/index.d.ts",
       "default": "./lib/client.js"
@@ -30,7 +26,6 @@
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/client.js",
     "lib/types/**/*.d.ts",
     "cordis.patch.yml"
@@ -41,7 +36,7 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-api-session-controller",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-tool",
@@ -54,23 +49,22 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-tool": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-host-apiproxy": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-session-projection": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-subagent": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-jobs": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-tool": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-subagent": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-jobs": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-tools": "^0.1.2-rc.1",
+    "@deepseek-ai/dsh-util-values": "^0.1.2-rc.1",
     "cordis": "^4.0.0-rc.7",
     "react": "^18.2.0",
     "schemastery": "^3.18.0"
@@ -79,13 +73,13 @@
     "@deepseek-ai/dsh-agent": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-connection": {
+    "@deepseek-ai/dsh-api-session-controller": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-locale": {
+    "@deepseek-ai/dsh-client-connection": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
+    "@deepseek-ai/dsh-client-locale": {
       "optional": true
     },
     "@deepseek-ai/dsh-client-ui-conversation": {
@@ -103,12 +97,6 @@
     "@deepseek-ai/dsh-client-ui-tool": {
       "optional": true
     },
-    "@deepseek-ai/dsh-host-apiproxy": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-invariants": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-llm": {
       "optional": true
     },
@@ -127,6 +115,9 @@
     "@deepseek-ai/dsh-tools": {
       "optional": true
     },
+    "@deepseek-ai/dsh-util-values": {
+      "optional": true
+    },
     "cordis": {
       "optional": true
     },

package/lib/invariant.js

@@ -1,21 +0,0 @@
-//#region src/invariant.ts
-const PACKAGE_NAME = "@huanlin/dsh-plugin-yet-another-subagent";
-/** Cordis companion plugin name. */
-const name = "yet-another-subagent-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: profile tools, the RPC interceptor, and the two
-* projections are registry-owned registrations whose disposal is proven by
-* the HMR-safety spec. They emit no cordis events and own no cross-plugin
-* mutable state (the in-memory ProfileStore's lifetime is the plugin fiber).
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@huanlin/dsh-plugin-yet-another-subagent`.
- *
- * @module @huanlin/dsh-plugin-yet-another-subagent/invariant
- */
-import type { Context } from 'cordis';
-/** Cordis companion plugin name. */
-export declare const name = "yet-another-subagent-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;