dsh-loop-engine 1.0.0-rc8 → 1.0.0-rc9

package/README.md

@@ -26,6 +26,26 @@ Restart `dsh web`, then open **Settings → Loop engine**.
 > your project root) and retry. Only the installing project can grant this;
 > the plugin cannot pre-approve its own dependencies.
 
+## Version compatibility
+
+dsh-loop-engine is versioned **independently** of the harness (`1.0.0-rcN`) but
+is bound to a specific harness release via `peerDependencies`. The two must be
+matched — a mismatch fails loudly at boot or session resume:
+
+| dsh-loop-engine | Requires harness |
+|---|---|
+| 1.0.0-rc9 | **0.1.2-rc.1** |
+| 1.0.0-rc8 | **0.1.2-rc.1** |
+| 1.0.0-rc7 | 0.1.1-rc.2 |
+
+- **1.0.0-rc9 (and 1.0.0-rc8) is not compatible with harness 0.1.1-rc.2 or earlier.** It uses
+  the 0.1.2 persistence seam (`SessionPersistence.create` / `open` +
+  `SessionHandle`), the `installSection` settings API, `ToolCallId`, and
+  `Session.snapshotEvents()` — none of which exist in older harnesses.
+- To use the plugin with an older harness, install the loop-engine release that
+  matches it (e.g. `npm i dsh-loop-engine@1.0.0-rc7` for harness 0.1.1-rc.2).
+- The GitHub Release body of each tag states the harness version it targets.
+
 ### Requirements
 
 - For the Claude Code engine: the Claude Code CLI installed and logged in on

package/lib/index.js

@@ -1019,11 +1019,15 @@ var ClaudeCodeAgent = class {
 };
 
 // src/driver-core/ownership.ts
-import { FiberState } from "@deepseek-ai/cordis";
+var INACTIVE_FIBER_VALUES = {
+  FAILED: 3,
+  DISPOSED: 4,
+  UNLOADING: 5
+};
 var INACTIVE_STATES = /* @__PURE__ */ new Set([
-  FiberState.UNLOADING,
-  FiberState.DISPOSED,
-  FiberState.FAILED
+  INACTIVE_FIBER_VALUES.UNLOADING,
+  INACTIVE_FIBER_VALUES.DISPOSED,
+  INACTIVE_FIBER_VALUES.FAILED
 ]);
 var FactoryOwnership = class {
   constructor(fiber) {
@@ -1530,7 +1534,7 @@ var AppServerClient = class _AppServerClient {
       clientInfo: {
         name: "dsh-loop-engine",
         title: null,
-        version: "1.0.0-rc8"
+        version: "1.0.0-rc9"
       },
       capabilities: { experimentalApi: true, requestAttestation: false }
     };
@@ -3281,14 +3285,32 @@ var PiAgent = class {
     });
     this.requestHeaderLogged = true;
   }
+  /**
+   * The harness Session's web-side model selection, if any was stored. The
+   * durable `model/selection` event carries `{ provider, model, ... }`; when a
+   * user picked a model via `/model`, this is the newest pick, and it overrides
+   * the deployment config (which stays the fallback). Returns `undefined` when
+   * no selection was stored, so the deployment config governs.
+   */
+  dynamicModel() {
+    for (const event of [...this.session.snapshotEvents()].reverse()) {
+      const type = event.type;
+      if (type !== "model/selection") continue;
+      const data = event.data;
+      const model = data?.model;
+      if (typeof model === "string" && model.length > 0) return model;
+    }
+    return void 0;
+  }
   /** Build the `pi --mode rpc` argv/cwd/env for one step's child process. */
   spawnSpec(cwd) {
     const argv = [];
+    const model = this.dynamicModel() ?? this.config.model;
     if (this.config.provider !== void 0) argv.push("--provider", this.config.provider);
-    if (this.config.model !== void 0 && this.config.thinkingLevel !== void 0) {
-      argv.push("--model", `${this.config.model}:${this.config.thinkingLevel}`);
-    } else if (this.config.model !== void 0) {
-      argv.push("--model", this.config.model);
+    if (model !== void 0 && this.config.thinkingLevel !== void 0) {
+      argv.push("--model", `${model}:${this.config.thinkingLevel}`);
+    } else if (model !== void 0) {
+      argv.push("--model", model);
     } else if (this.config.thinkingLevel !== void 0) {
       argv.push("--model", `:${this.config.thinkingLevel}`);
     }
@@ -3543,6 +3565,67 @@ var PiAgent = class {
   }
 };
 
+// src/engine-pi/probe.ts
+function waitForExit(child) {
+  return new Promise((resolve5) => {
+    ;
+    child.onExit(
+      (code) => resolve5(code ?? 0)
+    );
+  });
+}
+function collectStdout(child) {
+  return new Promise((resolve5) => {
+    let text = "";
+    if (child.stdout.on === void 0) {
+      resolve5("");
+      return;
+    }
+    const out = child.stdout;
+    out.setEncoding("utf8");
+    out.on("data", (data) => {
+      text += String(data);
+    });
+    out.on("end", () => {
+      resolve5(text);
+    });
+    out.on("close", () => {
+      resolve5(text);
+    });
+  });
+}
+function parsePiModelList(output) {
+  const entries = [];
+  for (const line of output.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0) continue;
+    const match = /^(\S+)\s{2,}(\S+)/.exec(trimmed);
+    if (match === null) continue;
+    const provider = match[1];
+    if (provider === "provider") continue;
+    entries.push({ provider, model: match[2] });
+  }
+  return entries;
+}
+async function probePiModels(bin, spawn4) {
+  const spec = {
+    argv: [bin, "--mode", "rpc", "--list-models"],
+    cwd: process.cwd(),
+    env: {}
+  };
+  let child;
+  try {
+    child = spawn4(spec);
+  } catch {
+    return [];
+  }
+  const stdoutPromise = collectStdout(child);
+  const exitCode = await waitForExit(child);
+  if (exitCode !== 0) return [];
+  const stdout = await stdoutPromise;
+  return parsePiModelList(stdout);
+}
+
 // src/engine-pi/loop.ts
 var PI_SANDBOX_MODES = [
   "read-only",
@@ -3555,7 +3638,8 @@ var Config3 = z3.object({
   provider: z3.string(),
   model: z3.string(),
   thinkingLevel: z3.string(),
-  env: z3.dict(z3.string()).default({})
+  env: z3.dict(z3.string()).default({}),
+  piCatalogHolder: z3.any()
 });
 function resolveConfig3(config) {
   return {
@@ -3594,7 +3678,8 @@ function fromSubprocess(handle) {
     stdout,
     stderr,
     onExit: (handler) => {
-      void handle.done.then(handler, handler);
+      const onExit = handler;
+      void handle.done.then((outcome) => onExit(outcome.exitCode), handler);
     },
     terminate: () => handle.terminate()
   };
@@ -3618,6 +3703,14 @@ var PiLoop = class extends Service3 {
     this.runtime = { ctx };
     this.bin = piCliEntrypoint();
     this.spawn = (spec) => fromSubprocess(this.runtime.ctx.subprocess.spawn(piSubprocessSpec(spec, PI_DISPOSE_GRACE_MS)));
+    const holder = config.piCatalogHolder;
+    if (holder !== void 0) {
+      void probePiModels(this.bin, (spec) => this.spawn(spec)).then((models) => {
+        holder.entries = [...models];
+      }).catch(() => {
+        holder.entries = [];
+      });
+    }
     ctx.effect(() => () => this.ownership.dispose(), "agentLoopPi.transactions()");
     ctx.effect(() => ctx.agents.setFactory(this), "agentLoopPi.setFactory()");
     ctx.systemPrompt.variable("provider", (context) => context.agent?.options.provider);
@@ -5646,12 +5739,24 @@ var HOSTED_PROVIDER_ROUTES = {
 var HostedEngineRouteAdapter = class extends LlmAdapter {
   /**
    * @param label - the provider route label this placeholder serves.
+   * @param options - optional catalog source; omit for an empty catalog.
    */
-  constructor(label) {
+  constructor(label, options = {}) {
     super();
     this.label = label;
+    this.options = options;
   }
   label;
+  options;
+  /** Advertise the injected Pi models (if any) under this route's provider label. */
+  async listModels(_provider) {
+    const catalog = this.options.listModels?.() ?? [];
+    return catalog.map((entry) => ({
+      provider: this.label,
+      id: `${entry.provider}/${entry.model}`,
+      name: `${entry.provider}/${entry.model}`
+    }));
+  }
   stream(_options) {
     throw new LlmError5(
       `provider "${this.label}" is a hosted loop engine route, not a model endpoint`,
@@ -6047,6 +6152,7 @@ function apply(ctx, config) {
   let mountedEngine;
   let commandDisposers;
   let skillDisposer;
+  const piCatalogHolder = { entries: [] };
   let mountAttempts = 0;
   let mountRetry;
   const CLEAR_RETRY = () => {
@@ -6096,7 +6202,8 @@ function apply(ctx, config) {
       return;
     }
     try {
-      routeHandle = llm.registerAdapter([label], new HostedEngineRouteAdapter(label));
+      const options = engine === "pi" ? { listModels: () => piCatalogHolder.entries } : void 0;
+      routeHandle = llm.registerAdapter([label], new HostedEngineRouteAdapter(label, options));
       routeEngine = engine;
     } catch (error) {
       if (error instanceof Error && error.message.includes("already registered")) {
@@ -6215,7 +6322,10 @@ function apply(ctx, config) {
     if (skills !== void 0) {
       skillDisposer = skills.registerProvider((control) => new PiSkillProvider(control));
     }
-    hostFactory("pi", () => ctx.plugin(PiLoop, piConfig(config)));
+    hostFactory("pi", () => ctx.plugin(PiLoop, {
+      ...piConfig(config),
+      piCatalogHolder
+    }));
   };
   const mountKimi = () => {
     const commands = ctx.get("commands");

package/lib/types/driver-core/ownership.d.ts

@@ -9,11 +9,10 @@
  *
  * @module dsh-loop-engine/driver-core/ownership
  */
-import { FiberState } from '@deepseek-ai/cordis';
 import type { Context } from '@deepseek-ai/cordis';
 import type { SessionId } from '@deepseek-ai/dsh-session';
 /** Fiber states that cannot own or serve a new lifecycle. */
-export declare const INACTIVE_STATES: ReadonlySet<FiberState>;
+export declare const INACTIVE_STATES: ReadonlySet<number>;
 /** Factory-level ownership: live agent teardowns plus load-time tracking. */
 export declare class FactoryOwnership {
     private readonly fiber;

package/lib/types/engine-pi/agent.d.ts

@@ -109,6 +109,14 @@ export declare class PiAgent implements Agent {
     private modelLabel;
     /** Append the request header snapshot once per loop instance. */
     private assertRequestHeader;
+    /**
+     * The harness Session's web-side model selection, if any was stored. The
+     * durable `model/selection` event carries `{ provider, model, ... }`; when a
+     * user picked a model via `/model`, this is the newest pick, and it overrides
+     * the deployment config (which stays the fallback). Returns `undefined` when
+     * no selection was stored, so the deployment config governs.
+     */
+    private dynamicModel;
     /** Build the `pi --mode rpc` argv/cwd/env for one step's child process. */
     private spawnSpec;
     /**

package/lib/types/engine-pi/loop.d.ts

@@ -14,6 +14,7 @@ import { Service } from '@deepseek-ai/cordis';
 import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { AgentFactory, AgentHandle, CreateAgentOptions, ResumeAgentOptions } from '@deepseek-ai/dsh-agent';
+import type { PiModelEntry } from './probe.ts';
 import type { PiProcess, PiSpawnSpec } from './rpc/client.ts';
 import type { PiSandboxMode, ResolvedConfig } from './types.ts';
 /** Pi CLI sandbox modes a deployment may pin. */
@@ -38,6 +39,10 @@ export interface Config {
     thinkingLevel?: string;
     /** Explicit environment entries passed to the `pi` child. */
     env?: Record<string, string>;
+    /** Shared Pi model catalog holder; the loop writes its `pi --list-models` probe result here. */
+    piCatalogHolder?: {
+        entries: readonly PiModelEntry[];
+    };
 }
 /** Schema of the Pi loop plugin configuration. */
 export declare const Config: z<Config>;

package/lib/types/engine-pi/probe.d.ts

@@ -0,0 +1,23 @@
+import type { PiProcess, PiSpawnSpec } from './rpc/client.ts';
+/** One discoverable Pi model: the raw two-part identity `pi` exposes. */
+export interface PiModelEntry {
+    readonly provider: string;
+    readonly model: string;
+}
+/**
+ * Parse the output of `pi --list-models`: a column-aligned table whose first
+ * two columns are `provider` and `model`. The header row and blank lines are
+ * skipped; long model ids simply occupy more columns. Splitting on 2+ spaces
+ * yields provider and model in the first two fields regardless of alignment.
+ */
+export declare function parsePiModelList(output: string): PiModelEntry[];
+/**
+ * Spawn `pi --list-models` and return the parsed model entries. Failures
+ * (non-zero exit, no stdout, spawn throw) resolve to an empty array so the
+ * catalog stays advisory and a probe glitch never breaks the engine mount.
+ * @param bin - the Pi CLI entrypoint (from `piCliEntrypoint()`); becomes spec.argv[0].
+ * @param spawn - the process-spawn adapter; `piSubprocessSpec` prepends the node
+ *   prefix, so spec.argv must NOT carry it.
+ */
+export declare function probePiModels(bin: string, spawn: (spec: PiSpawnSpec) => PiProcess): Promise<readonly PiModelEntry[]>;
+//# sourceMappingURL=probe.d.ts.map

package/lib/types/provider-route.d.ts

@@ -12,11 +12,21 @@
  *
  * @module dsh-loop-engine/provider-route
  */
-import type { GenerateOptions, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { GenerateOptions, LlmModelInfo, StreamChunk } from '@deepseek-ai/dsh-llm';
 import { LlmAdapter } from '@deepseek-ai/dsh-llm';
 import type { LoopEngineId } from './settings.ts';
+import type { PiModelEntry } from './engine-pi/probe.ts';
 /** Provider route label each hosted engine logs into its sessions' request/header. */
 export declare const HOSTED_PROVIDER_ROUTES: Readonly<Record<Exclude<LoopEngineId, 'in-process'>, string>>;
+/** Injectable catalog source a hosted engine route can advertise over the placeholder. */
+export interface HostedEngineRouteAdapterOptions {
+    /**
+     * Optional model catalog generator. When present, `listModels` advertises
+     * these entries under this route's provider label; when absent, the catalog
+     * stays empty (the default, "engine owns its models" behavior).
+     */
+    readonly listModels?: () => readonly PiModelEntry[];
+}
 /**
  * Placeholder adapter serving one hosted engine's provider route label. It
  * inherits the empty catalog and default metadata (the engine's model is not a
@@ -26,10 +36,14 @@ export declare const HOSTED_PROVIDER_ROUTES: Readonly<Record<Exclude<LoopEngineI
  */
 export declare class HostedEngineRouteAdapter extends LlmAdapter {
     private readonly label;
+    private readonly options;
     /**
      * @param label - the provider route label this placeholder serves.
+     * @param options - optional catalog source; omit for an empty catalog.
      */
-    constructor(label: string);
+    constructor(label: string, options?: HostedEngineRouteAdapterOptions);
+    /** Advertise the injected Pi models (if any) under this route's provider label. */
+    listModels(_provider: string): Promise<readonly LlmModelInfo[]>;
     stream(_options: GenerateOptions): AsyncIterable<StreamChunk>;
 }
 //# sourceMappingURL=provider-route.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-loop-engine",
   "description": "Web-switchable agent loop engine selection for the DeepSeek Harness - out-of-tree plugin (Claude Code / Codex / Pi / Kimi Code drivers) maintained by @kuun993, zero main-repo changes",
-  "version": "1.0.0-rc8",
+  "version": "1.0.0-rc9",
   "publishConfig": {
     "access": "public"
   },