@aiwayds/dsh-tui-pi 1.3.1 → 2.0.1

package/lib/model-sync.d.ts

@@ -0,0 +1,122 @@
+/**
+ * /model-sync (singular) — discover models for CUSTOM provider routes and
+ * merge them back into the llm-pi-ai settings section.
+ *
+ * A custom route is a hand-declared `llm-pi-ai.providers.<id>` profile that
+ * carries a `baseURL` and is NOT one of the built-in catalog routes
+ * (provider-catalog.ts): discovery against a catalog route would short-circuit
+ * back to the installed pi-ai catalog. This command interrogates
+ * each route's `GET ${baseURL}/models` through the official seam
+ * (`LlmRuntime.discoverModels`, registered for the `llm-pi-ai` namespace by
+ * dsh-llm-pi-ai with catalog short-circuit + stored-credential resolution),
+ * then merges the answer into the profile's `models` array.
+ *
+ * The merge is additive-only: existing entries are preserved verbatim (local
+ * overrides such as reasoningEfforts survive), discovered ids already present
+ * are skipped, new ids are appended with sanitized metadata. The write goes
+ * through `settings.mutate` at the revision read at execution time, with one
+ * retry after SettingsConflictError (the persistDefaultModel pattern in
+ * session.ts). Pure logic lives here as exported functions; src/index.ts only
+ * wires the command.
+ *
+ * @module dsh-tui-pi/model-sync
+ */
+import type { SettingsProvider } from '@deepseek-ai/dsh-settings';
+import type { LlmRuntime } from '@deepseek-ai/dsh-llm';
+/**
+ * The services /model-sync needs, narrowed to the exact surface it touches so
+ * tests can supply fakes without a live tree.
+ */
+export interface ModelSyncDeps {
+    /** The settings provider (describe for revisions, mutate for the write). */
+    settings: Pick<SettingsProvider, 'describe' | 'mutate'>;
+    /** The LLM runtime whose discoverModels serves the `llm-pi-ai` namespace. */
+    llm: Pick<LlmRuntime, 'discoverModels'>;
+}
+/** One models entry as stored in a profile — passed through untouched. */
+type StoredModel = Record<string, unknown>;
+/**
+ * A custom route selected for sync: the dict key plus the endpoint facts
+ * discovery needs. `api` is optional — discovery defaults the protocol.
+ */
+export interface CustomProviderRoute {
+    id: string;
+    baseURL: string;
+    api?: string;
+}
+/**
+ * A sanitized discovered model — the writable shape of one endpoint row:
+ * always an id; name/capacities carried only when present and valid.
+ */
+export interface SanitizedModel {
+    id: string;
+    name?: string;
+    contextWindow?: number;
+    maxTokens?: number;
+}
+/** Outcome of merging one route's discovery into its stored models. */
+export interface ModelSyncMergeResult {
+    /**
+     * The merged models array to store: existing entries first in their stored
+     * order, newly discovered ids appended at the end in discovery order.
+     */
+    models: StoredModel[];
+    /** Discovered rows appended as new entries. */
+    added: number;
+    /** Existing entries preserved verbatim. */
+    kept: number;
+    /**
+     * Discovered rows dropped entirely: unusable id, or an id already covered
+     * by an existing entry (local state wins) or by an earlier row of this batch.
+     */
+    skipped: number;
+}
+/**
+ * Select the custom (hand-declared) routes worth syncing from a providers
+ * dict: profiles carrying a non-empty `baseURL` whose key is not a built-in
+ * catalog route — a catalog key would short-circuit discovery back to the
+ * installed catalog. Sorted by route key so the
+ * report order is stable regardless of document order.
+ */
+export declare function selectCustomProviders(providers: Record<string, unknown> | undefined): CustomProviderRoute[];
+/**
+ * Clean one discovered row into a writable models entry. The id is mandatory
+ * (blank/absent → undefined); name must be a non-blank string; capacities
+ * must be integers ≥ 1 — the llm-pi-ai schema rejects anything else at write
+ * time (`contextWindow >= 1`, integer step), and a field that fails stays
+ * behind rather than sinking the whole row (verified against the shipped
+ * schema: absent name/contextWindow/maxTokens validate fine).
+ */
+export declare function sanitizeDiscoveredModel(raw: unknown): SanitizedModel | undefined;
+/**
+ * Merge one route's discovery into its stored models — additive-only:
+ *
+ * - existing entries are the base and are preserved VERBATIM (local overrides
+ *   like reasoningEfforts/input/compat survive; nothing is overwritten or
+ *   deleted);
+ * - discovered rows join by id: an id already present (or repeated within the
+ *   batch) counts as skipped, local state wins;
+ * - new ids are appended with `sanitizeDiscoveredModel`'s cleaned fields;
+ * - the stored order is never touched: existing entries keep their positions
+ *   (id-less rows included) and new ids join at the end in discovery order.
+ */
+export declare function mergeModels(existing: ReadonlyArray<object>, discovered: ReadonlyArray<unknown>): ModelSyncMergeResult;
+/**
+ * Run one /model-sync round: select the target routes (the rawInput-named one,
+ * or every custom route), discover each endpoint's models, merge, and write
+ * back. One route's failure never aborts the rest — its line reports the
+ * reason instead. Agentless by design: nothing here touches a session.
+ *
+ * @returns the command result — per-provider `<id>: added N · kept M ·
+ *   skipped K` lines on success, `<id>: <reason>` for failed routes; `kind:
+ *   'error'` only for preconditions (missing namespace, unknown/non-custom
+ *   named route) or when EVERY route failed.
+ */
+export declare function runModelSync(deps: ModelSyncDeps, options?: {
+    rawInput?: string;
+    signal?: AbortSignal;
+}): Promise<{
+    kind: 'success' | 'error';
+    text: string;
+}>;
+export {};

package/lib/model-sync.js

@@ -0,0 +1,256 @@
+/**
+ * /model-sync (singular) — discover models for CUSTOM provider routes and
+ * merge them back into the llm-pi-ai settings section.
+ *
+ * A custom route is a hand-declared `llm-pi-ai.providers.<id>` profile that
+ * carries a `baseURL` and is NOT one of the built-in catalog routes
+ * (provider-catalog.ts): discovery against a catalog route would short-circuit
+ * back to the installed pi-ai catalog. This command interrogates
+ * each route's `GET ${baseURL}/models` through the official seam
+ * (`LlmRuntime.discoverModels`, registered for the `llm-pi-ai` namespace by
+ * dsh-llm-pi-ai with catalog short-circuit + stored-credential resolution),
+ * then merges the answer into the profile's `models` array.
+ *
+ * The merge is additive-only: existing entries are preserved verbatim (local
+ * overrides such as reasoningEfforts survive), discovered ids already present
+ * are skipped, new ids are appended with sanitized metadata. The write goes
+ * through `settings.mutate` at the revision read at execution time, with one
+ * retry after SettingsConflictError (the persistDefaultModel pattern in
+ * session.ts). Pure logic lives here as exported functions; src/index.ts only
+ * wires the command.
+ *
+ * @module dsh-tui-pi/model-sync
+ */
+import { settingsNamespace, SettingsConflictError } from '@deepseek-ai/dsh-settings';
+import { catalogEntry } from "./provider-catalog.js";
+/** The settings namespace dsh-llm-pi-ai owns its provider routes under. */
+const NS_LLM_PI_AI = settingsNamespace('llm-pi-ai');
+/**
+ * Read the providers dict out of an llm-pi-ai descriptor value. Tolerant of
+ * every malformed shape — a section that is not an object yields no routes.
+ */
+function readProviders(value) {
+    if (typeof value !== 'object' || value === null)
+        return {};
+    const providers = value.providers;
+    if (typeof providers !== 'object' || providers === null)
+        return {};
+    return providers;
+}
+function readProfile(raw) {
+    const source = typeof raw === 'object' && raw !== null ? raw : {};
+    const baseURL = typeof source.baseURL === 'string' && source.baseURL !== '' ? source.baseURL : undefined;
+    const api = typeof source.api === 'string' && source.api !== '' ? source.api : undefined;
+    const rawModels = Array.isArray(source.models) ? source.models : [];
+    // Only well-formed entries are merged against; a malformed stored row is
+    // left alone rather than deleted (additive-only merge).
+    const models = rawModels.filter((entry) => typeof entry === 'object' && entry !== null);
+    return { ...(baseURL !== undefined ? { baseURL } : {}), ...(api !== undefined ? { api } : {}), models };
+}
+/** The stored entry's id, when it is a non-empty string. */
+function storedModelId(entry) {
+    const id = entry.id;
+    return typeof id === 'string' && id !== '' ? id : undefined;
+}
+/**
+ * Select the custom (hand-declared) routes worth syncing from a providers
+ * dict: profiles carrying a non-empty `baseURL` whose key is not a built-in
+ * catalog route — a catalog key would short-circuit discovery back to the
+ * installed catalog. Sorted by route key so the
+ * report order is stable regardless of document order.
+ */
+export function selectCustomProviders(providers) {
+    const selected = [];
+    for (const [id, raw] of Object.entries(providers ?? {})) {
+        if (catalogEntry(id) !== undefined)
+            continue;
+        const profile = readProfile(raw);
+        if (profile.baseURL === undefined)
+            continue;
+        selected.push({
+            id,
+            baseURL: profile.baseURL,
+            ...(profile.api !== undefined ? { api: profile.api } : {}),
+        });
+    }
+    selected.sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    return selected;
+}
+/**
+ * Clean one discovered row into a writable models entry. The id is mandatory
+ * (blank/absent → undefined); name must be a non-blank string; capacities
+ * must be integers ≥ 1 — the llm-pi-ai schema rejects anything else at write
+ * time (`contextWindow >= 1`, integer step), and a field that fails stays
+ * behind rather than sinking the whole row (verified against the shipped
+ * schema: absent name/contextWindow/maxTokens validate fine).
+ */
+export function sanitizeDiscoveredModel(raw) {
+    if (typeof raw !== 'object' || raw === null)
+        return undefined;
+    const row = raw;
+    if (typeof row.id !== 'string')
+        return undefined;
+    const id = row.id.trim();
+    if (id === '')
+        return undefined;
+    const name = typeof row.name === 'string' && row.name.trim() !== '' ? row.name.trim() : undefined;
+    const capacity = (value) => typeof value === 'number' && Number.isInteger(value) && value >= 1 ? value : undefined;
+    const contextWindow = capacity(row.contextWindow);
+    const maxTokens = capacity(row.maxTokens);
+    return {
+        id,
+        ...(name !== undefined ? { name } : {}),
+        ...(contextWindow !== undefined ? { contextWindow } : {}),
+        ...(maxTokens !== undefined ? { maxTokens } : {}),
+    };
+}
+/**
+ * Merge one route's discovery into its stored models — additive-only:
+ *
+ * - existing entries are the base and are preserved VERBATIM (local overrides
+ *   like reasoningEfforts/input/compat survive; nothing is overwritten or
+ *   deleted);
+ * - discovered rows join by id: an id already present (or repeated within the
+ *   batch) counts as skipped, local state wins;
+ * - new ids are appended with `sanitizeDiscoveredModel`'s cleaned fields;
+ * - the stored order is never touched: existing entries keep their positions
+ *   (id-less rows included) and new ids join at the end in discovery order.
+ */
+export function mergeModels(existing, discovered) {
+    const models = existing.map(entry => entry);
+    const ids = new Set();
+    for (const entry of models) {
+        const id = storedModelId(entry);
+        if (id !== undefined)
+            ids.add(id);
+    }
+    let added = 0;
+    let skipped = 0;
+    for (const raw of discovered) {
+        const clean = sanitizeDiscoveredModel(raw);
+        if (clean === undefined || ids.has(clean.id)) {
+            skipped += 1;
+            continue;
+        }
+        ids.add(clean.id);
+        // A fresh literal (not a cast): interfaces carry no implicit index
+        // signature, so the entry must be rebuilt as a plain record.
+        models.push({ ...clean });
+        added += 1;
+    }
+    // No reordering: existing entries stay exactly where the user stored them
+    // and new ids are appended at the end in discovery order — a no-op sync
+    // therefore leaves the stored array byte-identical.
+    return { models, added, kept: existing.length, skipped };
+}
+/**
+ * Write one route's merged models with optimistic concurrency: mutate at the
+ * revision read NOW (not at command start), one retry after
+ * SettingsConflictError with a freshly read revision — the same bottom pattern
+ * as persistDefaultModel in session.ts. A second conflict surfaces.
+ */
+async function writeModels(settings, providerId, models) {
+    const ops = [
+        { op: 'set', path: ['providers', providerId, 'models'], value: models },
+    ];
+    const ns = NS_LLM_PI_AI;
+    for (let attempt = 0;; attempt++) {
+        const descriptor = currentDescriptor(settings);
+        try {
+            await settings.mutate(ns, ops, descriptor?.revision);
+            return;
+        }
+        catch (error) {
+            if (attempt === 0 && error instanceof SettingsConflictError)
+                continue;
+            throw error;
+        }
+    }
+}
+/** The live llm-pi-ai descriptor, re-read on demand (revision freshness). */
+function currentDescriptor(settings) {
+    return settings.describe().find(d => d.ns === NS_LLM_PI_AI);
+}
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Run one /model-sync round: select the target routes (the rawInput-named one,
+ * or every custom route), discover each endpoint's models, merge, and write
+ * back. One route's failure never aborts the rest — its line reports the
+ * reason instead. Agentless by design: nothing here touches a session.
+ *
+ * @returns the command result — per-provider `<id>: added N · kept M ·
+ *   skipped K` lines on success, `<id>: <reason>` for failed routes; `kind:
+ *   'error'` only for preconditions (missing namespace, unknown/non-custom
+ *   named route) or when EVERY route failed.
+ */
+export async function runModelSync(deps, options = {}) {
+    const descriptor = currentDescriptor(deps.settings);
+    if (descriptor === undefined) {
+        return { kind: 'error', text: 'The llm-pi-ai settings namespace is not registered — nothing to sync.' };
+    }
+    const wanted = options.rawInput?.trim() ?? '';
+    let targets;
+    if (wanted !== '') {
+        const providers = readProviders(descriptor.value);
+        if (!(wanted in providers)) {
+            return { kind: 'error', text: `Provider "${wanted}" is not configured under llm-pi-ai providers.` };
+        }
+        targets = selectCustomProviders({ [wanted]: providers[wanted] });
+        if (targets.length === 0) {
+            // Two distinct shapes land here: a built-in catalog key (excluded by
+            // selection even when the profile carries a baseURL) and a genuinely
+            // non-custom route without a baseURL. Name each accurately.
+            if (catalogEntry(wanted) !== undefined) {
+                return {
+                    kind: 'error',
+                    text: `Provider "${wanted}" is a built-in catalog route — /model-sync syncs hand-declared (baseURL) routes only.`,
+                };
+            }
+            return {
+                kind: 'error',
+                text: `Provider "${wanted}" has no baseURL — /model-sync syncs hand-declared routes only.`,
+            };
+        }
+    }
+    else {
+        targets = selectCustomProviders(readProviders(descriptor.value));
+        if (targets.length === 0) {
+            return { kind: 'success', text: 'No hand-declared (baseURL) providers configured — nothing to sync.' };
+        }
+    }
+    const lines = [];
+    let failures = 0;
+    for (const target of targets) {
+        try {
+            // Re-read the live section per route: an api added/removed between the
+            // selection and this write still reaches discovery (and a vanished
+            // namespace degrades into that route's failure line, not a crash).
+            const liveValue = currentDescriptor(deps.settings)?.value;
+            const profile = readProfile(readProviders(liveValue)[target.id]);
+            const discovered = await deps.llm.discoverModels(NS_LLM_PI_AI, {
+                provider: target.id,
+                baseURL: target.baseURL,
+                ...(profile.api !== undefined ? { api: profile.api } : {}),
+                ...(options.signal !== undefined ? { signal: options.signal } : {}),
+            });
+            const merged = mergeModels(profile.models, discovered);
+            // A no-op sync must produce zero settings mutations: write only when
+            // discovery actually contributed new ids.
+            if (merged.added > 0) {
+                await writeModels(deps.settings, target.id, merged.models);
+            }
+            lines.push(`${target.id}: added ${merged.added} · kept ${merged.kept} · skipped ${merged.skipped}`);
+        }
+        catch (error) {
+            failures += 1;
+            lines.push(`${target.id}: ${errorText(error)}`);
+        }
+    }
+    if (failures === targets.length && failures > 0) {
+        return { kind: 'error', text: lines.join('\n') };
+    }
+    return { kind: 'success', text: lines.join('\n') };
+}
+//# sourceMappingURL=model-sync.js.map

package/lib/model-sync.js.map

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

package/lib/preset.d.ts

@@ -35,17 +35,18 @@ export interface PresetRoot {
 }
 export declare function __setPresetRootOverride(roots: PresetRoot[] | undefined): void;
 /**
- * Resolve the preset roots — same discovery families as dsh-agent-presets:
- *   1. shipped root: `<dsh install>/config/agent-presets/` (rc-era hosts) or
- *      the `presets/` dir inside the `@deepseek-ai/dsh-agent-presets` package
- *      (alpha-era hosts)
+ * Resolve the preset roots — same discovery families as dsh-agent-presets
+ * (alpha.3: shipped presets are bundled inside the `@deepseek-ai/dsh-agent-presets`
+ * package; locally authored presets live under the Harness home):
+ *   1. shipped root: the `presets/` dir inside the `@deepseek-ai/dsh-agent-presets`
+ *      package
  *   2. user root: `~/.dsh/.agent-presets/`
  * The shipped root is located by probing the known install layouts; the user
  * root is the conventional `~/.dsh/.agent-presets/`.
  *
  * Nonexistent roots scan to an empty roster, so every candidate is probed
- * in order — rc-era layouts first, then the dsh-agent-presets package nested
- * under the dsh install, then the flat global-root variant (npm hoisting).
+ * in order — the dsh-agent-presets package nested under the dsh install
+ * first, then the flat global-root variant (npm hoisting).
  */
 export declare function resolvePresetRoots(): PresetRoot[];
 /**

package/lib/preset.js

@@ -21,28 +21,26 @@ export function __setPresetRootOverride(roots) {
     presetRootOverride = roots;
 }
 /**
- * Resolve the preset roots — same discovery families as dsh-agent-presets:
- *   1. shipped root: `<dsh install>/config/agent-presets/` (rc-era hosts) or
- *      the `presets/` dir inside the `@deepseek-ai/dsh-agent-presets` package
- *      (alpha-era hosts)
+ * Resolve the preset roots — same discovery families as dsh-agent-presets
+ * (alpha.3: shipped presets are bundled inside the `@deepseek-ai/dsh-agent-presets`
+ * package; locally authored presets live under the Harness home):
+ *   1. shipped root: the `presets/` dir inside the `@deepseek-ai/dsh-agent-presets`
+ *      package
  *   2. user root: `~/.dsh/.agent-presets/`
  * The shipped root is located by probing the known install layouts; the user
  * root is the conventional `~/.dsh/.agent-presets/`.
  *
  * Nonexistent roots scan to an empty roster, so every candidate is probed
- * in order — rc-era layouts first, then the dsh-agent-presets package nested
- * under the dsh install, then the flat global-root variant (npm hoisting).
+ * in order — the dsh-agent-presets package nested under the dsh install
+ * first, then the flat global-root variant (npm hoisting).
  */
 export function resolvePresetRoots() {
     const roots = [];
     // Shipped root probes. The dsh binary is at `/usr/local/bin/dsh` or
-    // `/opt/homebrew/bin/dsh`; rc-era hosts keep the config dir at
-    // `<global>/lib/node_modules/@deepseek-ai/dsh/config/agent-presets/`, while
-    // alpha-era hosts bundle the shipped presets inside `@deepseek-ai/dsh-agent-presets`
-    // (observed nested under the dsh package; flat at the global root when npm hoists).
+    // `/opt/homebrew/bin/dsh`; the shipped presets are bundled inside
+    // `@deepseek-ai/dsh-agent-presets` (observed nested under the dsh package;
+    // flat at the global root when npm hoists).
     const shippedPaths = [
-        '/opt/homebrew/lib/node_modules/@deepseek-ai/dsh/config/agent-presets',
-        '/usr/local/lib/node_modules/@deepseek-ai/dsh/config/agent-presets',
         '/opt/homebrew/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-agent-presets/presets',
         '/usr/local/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-agent-presets/presets',
         '/opt/homebrew/lib/node_modules/@deepseek-ai/dsh-agent-presets/presets',
@@ -61,14 +59,14 @@ export function resolvePresetRoots() {
  * publishes display metadata in Chinese only (e.g. `标准模式`) with no i18n
  * mechanism, which would put Chinese in front of every user — so the roster
  * overrides the ids we know. Anything unmapped (a renamed or newly shipped
- * preset) keeps its official string until mapped here. `code` (rc) and `ptc`
- * (alpha) are the same preset across the upstream rename.
+ * preset) keeps its official string until mapped here. The shipped alpha.3
+ * roster is standard / minimal / cordis / ptc (the pre-alpha `code` id was
+ * renamed upstream and no longer exists).
  */
 const PRESET_ENGLISH_NAMES = {
     standard: 'Standard',
     minimal: 'Minimal',
     cordis: 'Cordis',
-    code: 'PTC',
     ptc: 'PTC',
 };
 /**
@@ -100,28 +98,25 @@ async function scanRoot(root) {
         catch {
             continue; // no composition file → skip
         }
-        // Read optional display metadata: `preset.yml` is the canonical file on
-        // current rc and alpha hosts alike (`METADATA_FILE` in
-        // @deepseek-ai/dsh-agent-presets); `metadata.yml` stays as a legacy
-        // fallback. First file that reads wins; absent metadata keeps the
-        // directory id as the name.
+        // Read the display metadata: `preset.yml` is the canonical file
+        // (`METADATA_FILE` in @deepseek-ai/dsh-agent-presets); absent metadata
+        // keeps the directory id as the name.
         let name = entry.name;
         let description;
-        for (const metaName of ['preset.yml', 'metadata.yml']) {
-            let meta;
-            try {
-                meta = await readFile(join(dir, metaName), 'utf8');
-            }
-            catch {
-                continue;
-            }
+        let meta;
+        try {
+            meta = await readFile(join(dir, 'preset.yml'), 'utf8');
+        }
+        catch {
+            meta = '';
+        }
+        if (meta !== '') {
             const nameMatch = meta.match(/^name:\s*(.+)$/m);
             if (nameMatch)
                 name = nameMatch[1].trim();
             const descMatch = meta.match(/^description:\s*(.+)$/m);
             if (descMatch)
                 description = descMatch[1].trim();
-            break;
         }
         // English override for the known shipped ids; unmapped presets keep the
         // official string (metadata name ?? id).

package/lib/preset.js.map

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

package/lib/session.d.ts

@@ -337,7 +337,7 @@ export declare class DshSessionBridge {
     /**
      * Resume a persisted session: tear down the live agent (disposers are kept —
      * the session-id filter re-binds to the resumed id) and load the persisted
-     * session in its place. The caller replays `handle.agent.session.events`
+     * session in its place. The caller replays `handle.agent.session.snapshotEvents()`
      * through `replay()` to rebuild stats/transcript — clear the transcript
      * BEFORE replaying (the renderer's echo dedupe must not see replayed user
      * messages next to a stale local echo). Serialized: concurrent calls share

package/lib/session.js

@@ -11,7 +11,7 @@
  */
 import { installModelSelection } from '@deepseek-ai/dsh-agent';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
-import { settingsNamespace, SettingsConflictError } from '@deepseek-ai/dsh-settings';
+import { SettingsConflictError } from '@deepseek-ai/dsh-settings';
 import { SessionId } from '@deepseek-ai/dsh-session';
 import { readAppendSystem } from "./append-system.js";
 import { join } from 'node:path';
@@ -418,7 +418,7 @@ export class DshSessionBridge {
             const session = sessions.get(SessionId(childId));
             if (session === undefined)
                 continue;
-            const events = session.events;
+            const events = session.snapshotEvents();
             const len = events.length;
             let from = this.reconciledLen.get(childId) ?? 0;
             // A torn-down / re-seeded child session restarts its log — recount it.
@@ -883,7 +883,7 @@ export class DshSessionBridge {
     /**
      * Resume a persisted session: tear down the live agent (disposers are kept —
      * the session-id filter re-binds to the resumed id) and load the persisted
-     * session in its place. The caller replays `handle.agent.session.events`
+     * session in its place. The caller replays `handle.agent.session.snapshotEvents()`
      * through `replay()` to rebuild stats/transcript — clear the transcript
      * BEFORE replaying (the renderer's echo dedupe must not see replayed user
      * messages next to a stale local echo). Serialized: concurrent calls share
@@ -1532,7 +1532,7 @@ export class DshSessionBridge {
         if (this.sessionId === undefined)
             return true;
         const agent = this.getAgent();
-        return agent === undefined || agent.session.events.length === 0;
+        return agent === undefined || agent.session.seq === 0;
     }
 }
 /**
@@ -1564,7 +1564,10 @@ export async function persistDefaultModel(ctx, selection) {
     const settings = ctx.get('settings');
     if (settings === undefined)
         return undefined;
-    const ns = settingsNamespace('agent-default-model');
+    // dsh-settings 0.1.2-alpha.3 removed the runtime settingsNamespace() helper:
+    // a plain literal is the supported spelling (type-level brand check plus the
+    // host's runtime parseSettingsNamespace validation).
+    const ns = 'agent-default-model';
     // The descriptor carries the namespace's revision (optimistic-concurrency
     // token for mutate) and proves the schema registration that validates the
     // field names below; the write itself rejects when the namespace is