@deepseek-harness-tui/dsh-tui 0.14.1 → 0.16.0

package/lib/types/dsh-adapter/channel/transcript.d.ts

@@ -44,10 +44,17 @@ export declare const GOAL_RESULT_BADGE: Record<string, string>;
  */
 export declare function harnessToolResultView(name: string, data: SessionEvent<'tool/result'>['data']): ToolResultView | undefined;
 export declare function toolErrorText(event: SessionEvent<'tool/result'>): string;
+/** One structured tool failure (`tool/result.error`) as display text: its
+ *  `name: code` identity plus the result detail. An auto-review denial reads
+ *  as a localized "denied, not executed" plus the reviewer's `reason`, never
+ *  its English detail (that only restates the denial); other failures' `reason`
+ *  repeats their detail and stays out. Shared by the transcript and the
+ *  subagent cards. */
+export declare function toolFailureText(failure: unknown, detail: string): string;
 /** Restore a folded tool row's result text from its tool/result event. */
 export declare function restoreToolResult(row: ChatRow, event: SessionEvent<'tool/result'>): void;
 /**
- * Prepare durable events for REPLAY (resume / rewind / model-switch fork):
+ * Prepare durable events for REPLAY (resume / rewind / fork):
  * drop settled `assistant/chunk` stream deltas — the sealed
  * `assistant/message` events carry the full text and reasoning blocks, so
  * per-token chunks add nothing to the replayed transcript while costing a

package/lib/types/dsh-adapter/channel/transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE5E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAI7H,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAE1F;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EAAE,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;AACzD;qCACqC;AACrC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GACrC,MAAM,CA4CR;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA8C5G;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CA+B3E;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,MAAM,CAEzE;AAED,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,GACxC,cAAc,GAAG,SAAS,CA4C5B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,MAAM,CAMxE;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI,CAUxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CA2BnF"}
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAE5E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAI7H,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAE1F;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,OAAO,EAAE,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE;AACzD;qCACqC;AACrC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GACrC,MAAM,CA4CR;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,CAAC,EAAE,iBAAiB,GAAG,MAAM,CA8C5G;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CA+B3E;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,MAAM,CAEzE;AAED,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKpD,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,GACxC,cAAc,GAAG,SAAS,CA4C5B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,MAAM,CAIxE;AAED;;;;;sBAKsB;AACtB,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAWxE;AAED,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,IAAI,CAUxF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,YAAY,EAAE,CA2BnF"}

package/lib/types/dsh-adapter/channel/transcript.js

@@ -1,4 +1,5 @@
 import { toolResultPayload } from '../compat/messages.js';
+import { t } from '../../i18n.js';
 import { markChannelReadDirty } from '../../adapter/channel/read-view.js';
 import { ARGS_PREVIEW_LIMIT, LOCAL_OUTPUT_LIMIT, MAX_ROWS, preview, RESULT_PREVIEW_LIMIT } from '../../channel/transcript.js';
 // Limits and the preview helper are backend-neutral (src/channel/transcript.ts);
@@ -240,8 +241,24 @@ export function toolErrorText(event) {
     const failure = event.data.error;
     if (failure === undefined)
         return toolResultPayload(event.data.message).isError ? toolResultText(event) : '';
-    const identity = `${failure.name}: ${failure.code}`;
-    const detail = toolResultText(event);
+    return toolFailureText(failure, toolResultText(event));
+}
+/** One structured tool failure (`tool/result.error`) as display text: its
+ *  `name: code` identity plus the result detail. An auto-review denial reads
+ *  as a localized "denied, not executed" plus the reviewer's `reason`, never
+ *  its English detail (that only restates the denial); other failures' `reason`
+ *  repeats their detail and stays out. Shared by the transcript and the
+ *  subagent cards. */
+export function toolFailureText(failure, detail) {
+    const record = failure !== null && typeof failure === 'object' ? failure : {};
+    if (record.code === 'AUTO_REVIEW_DENIED') {
+        const identity = t('tool-error-auto-review-denied');
+        const reason = typeof record.reason === 'string' ? record.reason.trim() : '';
+        return reason !== '' ? `${identity} — ${reason}` : identity;
+    }
+    const identity = typeof record.name === 'string' && typeof record.code === 'string'
+        ? `${record.name}: ${record.code}`
+        : String(failure);
     return detail === '' || detail === identity ? identity : `${identity} — ${detail}`;
 }
 /** Restore a folded tool row's result text from its tool/result event. */
@@ -258,7 +275,7 @@ export function restoreToolResult(row, event) {
     row.tool.resultFull = result || undefined;
 }
 /**
- * Prepare durable events for REPLAY (resume / rewind / model-switch fork):
+ * Prepare durable events for REPLAY (resume / rewind / fork):
  * drop settled `assistant/chunk` stream deltas — the sealed
  * `assistant/message` events carry the full text and reasoning blocks, so
  * per-token chunks add nothing to the replayed transcript while costing a

package/lib/types/dsh-adapter/channel/upstream-retry.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Upstream auto-retry for DSH sessions: the llm-retry plugin (dsh-base)
+ * already retries transient model-request failures per each provider
+ * route's resolved retry policy, but the stock retryable-code set
+ * (EMPTY_RESPONSE / RATE_LIMIT / SERVER / TIMEOUT / TRANSPORT) does not
+ * include STREAM_CLOSED — the code dsh-llm-pi-ai throws when an upstream
+ * SSE stream simply ends with no terminal event, i.e. the bare upstream
+ * link drop. Those drops are exactly as transient as the classified
+ * transport errors, so this module widens the policy to cover them.
+ *
+ * The widening is delivered where the retry policy actually lives: the
+ * 'llm-pi-ai' settings section's 'providers.<route>.retryPolicy' field
+ * (dsh-llm-retry executes it; the TUI never retries anything itself).
+ * ensureUpstreamRetry seeds that field ONLY on the route(s) the bound
+ * session actually uses (the channel feeds it the live provider at every
+ * bind — boot, resume — and on each /model switch), and only when that route declares
+ * no retryPolicy: an explicit value (from cordis.yml or a hand-edited
+ * settings document) is a deliberate choice and is never overwritten, and
+ * dormant channels are never touched. The settings user layer merges
+ * recursively over the composition base, so a route configured through
+ * the profile patch is reached with all its other fields intact.
+ *
+ * @module @deepseek-harness-tui/dsh-tui/channel/upstream-retry
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Retry attempts after the first request, matching both the upstream
+ *  default and the product ask (retry 5 times). */
+export declare const UPSTREAM_RETRY_MAX_RETRIES = 5;
+/**
+ * Failure codes the widened policy retries: the stock set dsh-llm's
+ * resolveRetryPolicy defaults to, plus STREAM_CLOSED (dsh-llm-pi-ai's
+ * signature for an upstream event stream that ended without a terminal
+ * event). Codes outside the set (AUTH, INVALID_REQUEST, QUOTA, …) stay
+ * non-retryable exactly as before.
+ */
+export declare const UPSTREAM_RETRYABLE_CODES: readonly string[];
+/**
+ * The retry policy value written under 'providers.<route>.retryPolicy'
+ * (RetryPolicySchema's normal mode). A fresh object per call: settings
+ * documents are plain JSON, never shared module state.
+ */
+export declare function upstreamRetryPolicy(): {
+    mode: 'normal';
+    maxRetries: number;
+    retryableCodes: readonly string[];
+};
+/**
+ * Provider routes whose resolved profile declares no retryPolicy — the ones
+ * ensureUpstreamRetry may seed. A present value (any shape) marks a
+ * deliberate choice and keeps the route out. With `wanted`, only those
+ * routes are considered — the caller names the route(s) its session
+ * actually uses, so dormant channels are never touched.
+ */
+export declare function routesWithoutRetryPolicy(section: unknown, wanted?: readonly string[]): readonly string[];
+/** One settings mutation op per route (see ensureUpstreamRetry). */
+export declare function upstreamRetryOps(routes: readonly string[]): readonly {
+    op: 'set';
+    path: readonly string[];
+    value: unknown;
+}[];
+/**
+ * Seed 'retryPolicy' (normal mode, 5 retries, transport-drop-aware codes)
+ * on the given llm-pi-ai routes — and only those — when their resolved
+ * profiles lack one, through the official settings mutation path (one
+ * stale-revision retry, same contract as the provider wizard). Callers
+ * name the route(s) the bound session actually uses, so channels nobody
+ * switched to are never written. Per-route once-per-process is the
+ * caller's guard; after a successful write the route carries the policy
+ * and drops out on its own.
+ * Best effort: no settings service, no llm-pi-ai namespace, a route the
+ * section does not know (a non-pi-ai adapter route), or a refused write
+ * all stay quiet (warn to the log on real errors).
+ * @param ctx - Context with the settings service (optional at runtime).
+ * @param notify - Channel notification for the one success line.
+ * @param routes - Provider routes the current session uses.
+ */
+export declare function ensureUpstreamRetry(ctx: Context, notify: (text: string, options?: {
+    color?: 'success' | 'warning' | 'error';
+    timeoutMs?: number;
+}) => void, routes: readonly string[]): Promise<void>;
+//# sourceMappingURL=upstream-retry.d.ts.map

package/lib/types/dsh-adapter/channel/upstream-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upstream-retry.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/upstream-retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD;mDACmD;AACnD,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAOrD,CAAA;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI;IACrC,IAAI,EAAE,QAAQ,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC,CAMA;AAUD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAMxG;AAED,oEAAoE;AACpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS;IACpE,EAAE,EAAE,KAAK,CAAA;IACT,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;CACf,EAAE,CAMF;AAaD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,EACzG,MAAM,EAAE,SAAS,MAAM,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/lib/types/dsh-adapter/channel/upstream-retry.js

@@ -0,0 +1,138 @@
+/**
+ * Upstream auto-retry for DSH sessions: the llm-retry plugin (dsh-base)
+ * already retries transient model-request failures per each provider
+ * route's resolved retry policy, but the stock retryable-code set
+ * (EMPTY_RESPONSE / RATE_LIMIT / SERVER / TIMEOUT / TRANSPORT) does not
+ * include STREAM_CLOSED — the code dsh-llm-pi-ai throws when an upstream
+ * SSE stream simply ends with no terminal event, i.e. the bare upstream
+ * link drop. Those drops are exactly as transient as the classified
+ * transport errors, so this module widens the policy to cover them.
+ *
+ * The widening is delivered where the retry policy actually lives: the
+ * 'llm-pi-ai' settings section's 'providers.<route>.retryPolicy' field
+ * (dsh-llm-retry executes it; the TUI never retries anything itself).
+ * ensureUpstreamRetry seeds that field ONLY on the route(s) the bound
+ * session actually uses (the channel feeds it the live provider at every
+ * bind — boot, resume — and on each /model switch), and only when that route declares
+ * no retryPolicy: an explicit value (from cordis.yml or a hand-edited
+ * settings document) is a deliberate choice and is never overwritten, and
+ * dormant channels are never touched. The settings user layer merges
+ * recursively over the composition base, so a route configured through
+ * the profile patch is reached with all its other fields intact.
+ *
+ * @module @deepseek-harness-tui/dsh-tui/channel/upstream-retry
+ */
+import { t } from '../../i18n.js';
+import { settingsValue } from '../compat/settings.js';
+/** Retry attempts after the first request, matching both the upstream
+ *  default and the product ask (retry 5 times). */
+export const UPSTREAM_RETRY_MAX_RETRIES = 5;
+/**
+ * Failure codes the widened policy retries: the stock set dsh-llm's
+ * resolveRetryPolicy defaults to, plus STREAM_CLOSED (dsh-llm-pi-ai's
+ * signature for an upstream event stream that ended without a terminal
+ * event). Codes outside the set (AUTH, INVALID_REQUEST, QUOTA, …) stay
+ * non-retryable exactly as before.
+ */
+export const UPSTREAM_RETRYABLE_CODES = [
+    'EMPTY_RESPONSE',
+    'RATE_LIMIT',
+    'SERVER',
+    'TIMEOUT',
+    'TRANSPORT',
+    'STREAM_CLOSED',
+];
+/**
+ * The retry policy value written under 'providers.<route>.retryPolicy'
+ * (RetryPolicySchema's normal mode). A fresh object per call: settings
+ * documents are plain JSON, never shared module state.
+ */
+export function upstreamRetryPolicy() {
+    return {
+        mode: 'normal',
+        maxRetries: UPSTREAM_RETRY_MAX_RETRIES,
+        retryableCodes: [...UPSTREAM_RETRYABLE_CODES],
+    };
+}
+/** The resolved 'llm-pi-ai' section narrowed to its provider dict. */
+function providersOf(section) {
+    if (section === null || typeof section !== 'object' || Array.isArray(section))
+        return {};
+    const providers = section.providers;
+    if (providers === null || typeof providers !== 'object' || Array.isArray(providers))
+        return {};
+    return providers;
+}
+/**
+ * Provider routes whose resolved profile declares no retryPolicy — the ones
+ * ensureUpstreamRetry may seed. A present value (any shape) marks a
+ * deliberate choice and keeps the route out. With `wanted`, only those
+ * routes are considered — the caller names the route(s) its session
+ * actually uses, so dormant channels are never touched.
+ */
+export function routesWithoutRetryPolicy(section, wanted) {
+    const filter = wanted === undefined ? undefined : new Set(wanted);
+    return Object.entries(providersOf(section))
+        .filter(([route, profile]) => filter === undefined || filter.has(route))
+        .filter(([, profile]) => !(profile !== null && typeof profile === 'object' && 'retryPolicy' in profile))
+        .map(([route]) => route);
+}
+/** One settings mutation op per route (see ensureUpstreamRetry). */
+export function upstreamRetryOps(routes) {
+    return routes.map(route => ({
+        op: 'set',
+        path: ['providers', route, 'retryPolicy'],
+        value: upstreamRetryPolicy(),
+    }));
+}
+/**
+ * Seed 'retryPolicy' (normal mode, 5 retries, transport-drop-aware codes)
+ * on the given llm-pi-ai routes — and only those — when their resolved
+ * profiles lack one, through the official settings mutation path (one
+ * stale-revision retry, same contract as the provider wizard). Callers
+ * name the route(s) the bound session actually uses, so channels nobody
+ * switched to are never written. Per-route once-per-process is the
+ * caller's guard; after a successful write the route carries the policy
+ * and drops out on its own.
+ * Best effort: no settings service, no llm-pi-ai namespace, a route the
+ * section does not know (a non-pi-ai adapter route), or a refused write
+ * all stay quiet (warn to the log on real errors).
+ * @param ctx - Context with the settings service (optional at runtime).
+ * @param notify - Channel notification for the one success line.
+ * @param routes - Provider routes the current session uses.
+ */
+export async function ensureUpstreamRetry(ctx, notify, routes) {
+    if (routes.length === 0)
+        return;
+    let settings;
+    try {
+        settings = ctx.get('settings');
+    }
+    catch {
+        settings = undefined;
+    }
+    if (settings === undefined || typeof settings.describe !== 'function')
+        return;
+    const revision = () => settings.describe().find(row => row.ns === 'llm-pi-ai')?.revision;
+    if (revision() === undefined)
+        return;
+    const missing = routesWithoutRetryPolicy(settingsValue(settings, 'llm-pi-ai'), routes);
+    if (missing.length === 0)
+        return;
+    try {
+        try {
+            await settings.mutate('llm-pi-ai', upstreamRetryOps(missing), revision());
+        }
+        catch (error) {
+            // One retry on a stale-revision conflict (a concurrent write landed
+            // between describe and mutate); anything else propagates.
+            if (error?.code !== 'SETTINGS_CONFLICT')
+                throw error;
+            await settings.mutate('llm-pi-ai', upstreamRetryOps(missing), revision());
+        }
+        notify(t('upstream-retry-enabled', { routes: missing.join(', ') }), { color: 'success' });
+    }
+    catch (error) {
+        ctx.logger.warn(`dsh-tui: upstream retry policy could not be seeded for ${missing.join()} (${error instanceof Error ? error.message : String(error)})`);
+    }
+}

package/lib/types/dsh-adapter/channel/workspace-actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/workspace-actions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,4GAA4G;AAC5G,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC,EACpE,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;IACzC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,gBAAgB,IAAI,IAAI,CAAA;IACxB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAC/B;;iCAciC,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;4BAElC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;8BAgBvB,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;4BA5BhD,MAAM;8BAuCE,kBAAkB,KAAG,OAAO,CAAC,OAAO,CAAC;6BAsBtC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;;gCAakJ,MAAM,SAAS,MAAM;EACvO"}
+{"version":3,"file":"workspace-actions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/workspace-actions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,4GAA4G;AAC5G,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC,EACpE,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CAAA;IACzC,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,gBAAgB,IAAI,IAAI,CAAA;IACxB,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CAC/B;;iCAeiC,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;4BAElC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;8BAgBvB,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;4BA5BhD,MAAM;8BAuCE,kBAAkB,KAAG,OAAO,CAAC,OAAO,CAAC;6BAsBtC,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;;gCAauJ,MAAM,SAAS,MAAM;EAC5O"}

package/lib/types/dsh-adapter/channel/workspace-actions.js

@@ -3,9 +3,10 @@ import { t } from '../../i18n.js';
 import { WORKING_GATE_NOTICES } from '../../commands.js';
 /** Workspace command/query surface. The selected cwd is published only by a successful session adoption. */
 export function createWorkspaceActions(state, deps) {
-    const { service, notify } = deps;
-    const listWorkspaces = () => service.list(state.cwd);
-    const resolveWorkspace = (uri) => service.resolve(uri, state.cwd);
+    // `deps.service` is read per call (late row).
+    const { notify } = deps;
+    const listWorkspaces = () => deps.service.list(state.cwd);
+    const resolveWorkspace = (uri) => deps.service.resolve(uri, state.cwd);
     /**
      * The workspace home screen's sidebar: the durable ledger's own listing.
      *
@@ -15,12 +16,12 @@ export function createWorkspaceActions(state, deps) {
      * directly and only adds what the ledger does not know: whether the
      * directory still exists.
      */
-    const listWorkspaceRegistry = () => service.listRegistry();
+    const listWorkspaceRegistry = () => deps.service.listRegistry();
     /** Forget a registration. Sessions are untouched; removing the live workspace is refused. */
     const removeWorkspace = async (path) => {
         deps.owner.assertActive();
         try {
-            const removed = await service.remove(path);
+            const removed = await deps.service.remove(path);
             if (!removed) {
                 notify(t('workspace-remove-unknown', { target: path }), { color: 'warning', timeoutMs: 8000 });
                 return false;
@@ -37,7 +38,7 @@ export function createWorkspaceActions(state, deps) {
     const renameWorkspaceAt = async (path, title) => {
         deps.owner.assertActive();
         try {
-            const renamed = await service.rename(path, title);
+            const renamed = await deps.service.rename(path, title);
             notify(t('workspace-renamed', { title: renamed.label }));
             return true;
         }
@@ -82,7 +83,7 @@ export function createWorkspaceActions(state, deps) {
     const renameWorkspace = async (title) => {
         deps.owner.assertActive();
         try {
-            const renamed = await service.rename(state.cwd, title);
+            const renamed = await deps.service.rename(state.cwd, title);
             state.displayCwd = renamed.description ?? renamed.uri;
             notify(t('workspace-renamed', { title: renamed.label }));
             state.emit();
@@ -93,5 +94,5 @@ export function createWorkspaceActions(state, deps) {
             return false;
         }
     };
-    return { listWorkspaces, listWorkspaceRegistry, removeWorkspace, renameWorkspaceAt, resolveWorkspace, switchWorkspace, renameWorkspace, workspaceCommands: () => service.commands(), runWorkspaceCommand: (name, input) => service.runCommand(name, input, state.cwd) };
+    return { listWorkspaces, listWorkspaceRegistry, removeWorkspace, renameWorkspaceAt, resolveWorkspace, switchWorkspace, renameWorkspace, workspaceCommands: () => deps.service.commands(), runWorkspaceCommand: (name, input) => deps.service.runCommand(name, input, state.cwd) };
 }

package/lib/types/dsh-adapter/channel-ui.d.ts

@@ -2,7 +2,9 @@
 import type { ChannelState } from './channel.js';
 import type { ChannelUi } from '../adapter/channel/ui-policy.js';
 import type { AdapterMode } from '../adapter/kernel/runtime.js';
-export declare function mountChannelUi(ctx: unknown, channel: ChannelState, pluginHost: unknown, mode: AdapterMode): {
+export declare function mountChannelUi(ctx: unknown, channel: ChannelState, pluginHost: unknown, mode: AdapterMode, 
+/** Look the plugin host up per probe (late row); absent = `pluginHost`. */
+resolvePluginHost?: () => unknown): {
     channel: ChannelUi;
     dispose(): void;
 };

package/lib/types/dsh-adapter/channel-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-ui.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel-ui.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAY/D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,WAAW,GAChB;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAkGzC"}
+{"version":3,"file":"channel-ui.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel-ui.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAY/D,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,WAAW;AACjB,2EAA2E;AAC3E,iBAAiB,CAAC,EAAE,MAAM,OAAO,GAChC;IAAE,OAAO,EAAE,SAAS,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAkGzC"}

package/lib/types/dsh-adapter/channel-ui.js

@@ -10,7 +10,9 @@ function throwCleanupFailures(failures, message) {
 }
 /** Re-probe interval while the kernel's channel slice is still absent. */
 const FACADE_PROBE_MS = 250;
-export function mountChannelUi(ctx, channel, pluginHost, mode) {
+export function mountChannelUi(ctx, channel, pluginHost, mode, 
+/** Look the plugin host up per probe (late row); absent = `pluginHost`. */
+resolvePluginHost) {
     // A registration, rather than Channel object equality, is the authority for
     // this mount. Re-registering the same Channel revokes retained UI handles.
     const registration = getTuiChannelRegistration(ctx);
@@ -64,7 +66,7 @@ export function mountChannelUi(ctx, channel, pluginHost, mode) {
         if (facadeProbe !== undefined && now - facadeProbeAt < FACADE_PROBE_MS)
             return facadeProbe;
         facadeProbeAt = now;
-        facadeProbe = getHostFacade(pluginHost);
+        facadeProbe = getHostFacade((resolvePluginHost === undefined ? pluginHost : resolvePluginHost()));
         if (facadeProbe?.channel !== undefined)
             facadeProbeLocked = true;
         return facadeProbe;

package/lib/types/dsh-adapter/channel.d.ts

@@ -16,8 +16,8 @@ export type { SubagentState } from './subagents.js';
  * transcript, subscribe to the session's events, and expose every TUI action.
  * @internal
  * @param ctx - The plugin context; optional services are resolved via ctx.get.
- * @param initial - The session the channel renders; rewinds, resumes, and
- *   model switches replace it. A raw DSH agent (direct embedders, fixtures) is
+ * @param initial - The session the channel renders; rewinds and resumes
+ *   replace it, while model switches keep it. A raw DSH agent (direct embedders, fixtures) is
  *   wrapped as a DSH session together with `options.handle`.
  * @param options - Boot options: model route, cwd, provider, and the
  *   reasoning-effort / working-activity preferences.

package/lib/types/dsh-adapter/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAMvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,GAAG,KAAK,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,YAAY,CAoBd;AAED,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC30B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/channel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAOvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,YAAY,GAAG,KAAK,EAC7B,OAAO,EAAE,oBAAoB,GAC5B,YAAY,CAgCd;AAED,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,YAAY,EAAE,uBAAuB,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,YAAY,EAAE,sBAAsB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,SAAS,EAAE,gBAAgB,EAAE,cAAc,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC30B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

package/lib/types/dsh-adapter/channel.js

@@ -1,4 +1,5 @@
 import { createDshSession, isAgentSession } from './backend/session.js';
+import { cordisChannelHost } from './channel/cordis-host.js';
 import { createCoreChannel } from './channel/core/compose.js';
 import { attachDshExtensions } from './channel/extensions.js';
 import { attachSessionWorkingActivity } from './channel/session-activity.js';
@@ -8,8 +9,8 @@ import { createChannelOwner } from './channel/owner.js';
  * transcript, subscribe to the session's events, and expose every TUI action.
  * @internal
  * @param ctx - The plugin context; optional services are resolved via ctx.get.
- * @param initial - The session the channel renders; rewinds, resumes, and
- *   model switches replace it. A raw DSH agent (direct embedders, fixtures) is
+ * @param initial - The session the channel renders; rewinds and resumes
+ *   replace it, while model switches keep it. A raw DSH agent (direct embedders, fixtures) is
  *   wrapped as a DSH session together with `options.handle`.
  * @param options - Boot options: model route, cwd, provider, and the
  *   reasoning-effort / working-activity preferences.
@@ -19,16 +20,29 @@ export function createChannel(ctx, initial, options) {
     const owner = createChannelOwner();
     try {
         const session = isAgentSession(initial) ? initial : createDshSession(ctx, { agent: initial, handle: options.handle });
-        const core = createCoreChannel(ctx, session, options, owner);
+        const core = createCoreChannel(cordisChannelHost(ctx, options.settingsService === undefined ? {} : { settings: options.settingsService }), session, options, owner);
         // DSH extensions attach only to a DSH session; other backends get the
         // core and whatever their session capabilities offer.
         const native = session.capabilities.native.dsh;
-        if (native !== undefined)
+        if (native !== undefined) {
             attachDshExtensions(core, ctx, native, options);
+        }
+        else if (options.startup !== undefined) {
+            // A placeholder learns its backend at the first adoption; a DSH
+            // session adopted then gets the same extensions.
+            core.extendOnAdopt(adopted => {
+                const dsh = adopted.capabilities.native.dsh;
+                if (dsh !== undefined)
+                    attachDshExtensions(core, ctx, dsh, options);
+            });
+        }
         // A backend that builds its own working line (the Claude backend) exposes
         // it as a capability. DSH keeps using its projection above. Without the
         // capability or the publish option nothing is attached.
-        if (session.capabilities.workingActivity !== undefined)
+        // A placeholder serves nothing yet, so its real session's capability
+        // decides per bind (a DSH session adopted later replaces these hooks:
+        // `extend` merges `bind` whole).
+        if (session.capabilities.workingActivity !== undefined || options.startup !== undefined)
             attachSessionWorkingActivity(core, options);
         return core.start();
     }

package/lib/types/dsh-adapter/compat/agent-team-0.2.0.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Agent Teams 0.2.0 durable shapes, read as their 0.2.1 equivalents.
+ *
+ * The readers that meet these shapes call in here first, so the rest of the
+ * adapter knows only the 0.2.1 forms (docs/agent-teams-design.md「兼容（0.2.0）」):
+ * the translator and the subagent projection for mailbox deliveries, the
+ * translator and agent-view for a teammate's first prompt. Session previews
+ * (sessions/digest.ts) and the recap read no teammate session today: the
+ * listings previews serve skip `origin: subagent`, and the recap reads only
+ * the bound session. Route them here when a teammate session opens there.
+ * The shapes are log compatibility, not host compatibility: a 0.2.1 host
+ * still resumes sessions recorded under 0.2.0, so dropping the 0.2.0 host
+ * line alone does not retire this module. It retires when reading
+ * 0.2.0-era team logs is given up; then delete this file and its callers
+ * (`grep -rn "compat(dsh 0.2.0"`).
+ *
+ * @module
+ */
+/**
+ * A team message delivered by the 0.2.0 mailbox, as the relay it became:
+ * source `{ kind: 'agent-message', form: 'relay', senderSessionId }`, first
+ * block `Team message from <name>:`. The 0.2.0 framing block
+ * (`Team message <id> from <name>:`) is replaced only when it matches this
+ * message's identity exactly; otherwise it stays as content, as it did.
+ * @param data - the message's source and content (other fields are kept).
+ * @returns `data`, or a copy in the 0.2.1 form.
+ */
+export declare function teamMailboxAsRelay<T extends {
+    readonly source?: unknown;
+    readonly content?: unknown;
+}>(data: T): T;
+/**
+ * A teammate's first prompt without the leading `<system-reminder>` identity
+ * block (0.2.1 carries it as a system-prompt context). Matched against the
+ * whole 0.2.0 template, on a human-sourced message with more blocks after it;
+ * callers apply it to the first prompt they read (a translator: the first
+ * since its replay or reset). A reader that starts mid-log — a subagent
+ * transcript page, the live translator after `history()` replayed on its own
+ * instance — counts its first prompt as one, so only that prompt, pasted as
+ * the exact template plus more blocks, could lose the block.
+ * @param data - the message's source and content (other fields are kept).
+ * @returns `data`, or a copy without the block.
+ */
+export declare function withoutTeammateReminder<T extends {
+    readonly source?: unknown;
+    readonly content?: unknown;
+}>(data: T): T;
+/**
+ * The 0.2.0 `send_message` result: the mailbox status of the queued message
+ * (0.2.1 answers `{ sent: true }`).
+ * @param value - the parsed tool result.
+ * @returns `accepted` / `queued`, or `undefined` for anything else.
+ */
+export declare function legacySendMessageStatus(value: Readonly<Record<string, unknown>>): string | undefined;
+//# sourceMappingURL=agent-team-0.2.0.d.ts.map

package/lib/types/dsh-adapter/compat/agent-team-0.2.0.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-team-0.2.0.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/compat/agent-team-0.2.0.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiBH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAYlH;AAqBD;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAKvH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,GAAG,SAAS,CAEpG"}

package/lib/types/dsh-adapter/compat/agent-team-0.2.0.js

@@ -0,0 +1,96 @@
+/**
+ * Agent Teams 0.2.0 durable shapes, read as their 0.2.1 equivalents.
+ *
+ * The readers that meet these shapes call in here first, so the rest of the
+ * adapter knows only the 0.2.1 forms (docs/agent-teams-design.md「兼容（0.2.0）」):
+ * the translator and the subagent projection for mailbox deliveries, the
+ * translator and agent-view for a teammate's first prompt. Session previews
+ * (sessions/digest.ts) and the recap read no teammate session today: the
+ * listings previews serve skip `origin: subagent`, and the recap reads only
+ * the bound session. Route them here when a teammate session opens there.
+ * The shapes are log compatibility, not host compatibility: a 0.2.1 host
+ * still resumes sessions recorded under 0.2.0, so dropping the 0.2.0 host
+ * line alone does not retire this module. It retires when reading
+ * 0.2.0-era team logs is given up; then delete this file and its callers
+ * (`grep -rn "compat(dsh 0.2.0"`).
+ *
+ * @module
+ */
+function mailboxSourceOf(source) {
+    const shape = source;
+    return shape?.kind === 'team-message' && typeof shape.senderId === 'string' && typeof shape.senderName === 'string'
+        ? shape
+        : undefined;
+}
+/**
+ * A team message delivered by the 0.2.0 mailbox, as the relay it became:
+ * source `{ kind: 'agent-message', form: 'relay', senderSessionId }`, first
+ * block `Team message from <name>:`. The 0.2.0 framing block
+ * (`Team message <id> from <name>:`) is replaced only when it matches this
+ * message's identity exactly; otherwise it stays as content, as it did.
+ * @param data - the message's source and content (other fields are kept).
+ * @returns `data`, or a copy in the 0.2.1 form.
+ */
+export function teamMailboxAsRelay(data) {
+    const { source, content } = data;
+    const mailbox = mailboxSourceOf(source);
+    if (mailbox === undefined || !Array.isArray(content))
+        return data;
+    const first = content[0];
+    const legacyFraming = `Team message ${String(mailbox.messageId)} from ${mailbox.senderName}:`;
+    const body = first?.type === 'text' && first.text === legacyFraming ? content.slice(1) : content;
+    return {
+        ...data,
+        source: { kind: 'agent-message', form: 'relay', senderSessionId: mailbox.senderId },
+        content: [{ type: 'text', text: `Team message from ${mailbox.senderName}:` }, ...body],
+    };
+}
+/** The identity block 0.2.0 `spawn_teammate` put before a teammate's first prompt, around the name. */
+const REMINDER_HEAD = '<system-reminder>\nYou are teammate "';
+const REMINDER_TAIL = `".
+Your Team Lead is named "lead".
+Use list_agents({}) to find your teammates and their names.
+To message your Team Lead, use send_message({ target: "lead", message: "..." }).
+To message another teammate, use send_message({ target: "<teammate name>", message: "..." }).
+</system-reminder>
+
+`;
+function isTeammateReminder(block) {
+    const { type, text } = (block ?? {});
+    if (type !== 'text' || typeof text !== 'string')
+        return false;
+    if (text.length < REMINDER_HEAD.length + REMINDER_TAIL.length)
+        return false;
+    if (!text.startsWith(REMINDER_HEAD) || !text.endsWith(REMINDER_TAIL))
+        return false;
+    return !text.slice(REMINDER_HEAD.length, text.length - REMINDER_TAIL.length).includes('\n');
+}
+/**
+ * A teammate's first prompt without the leading `<system-reminder>` identity
+ * block (0.2.1 carries it as a system-prompt context). Matched against the
+ * whole 0.2.0 template, on a human-sourced message with more blocks after it;
+ * callers apply it to the first prompt they read (a translator: the first
+ * since its replay or reset). A reader that starts mid-log — a subagent
+ * transcript page, the live translator after `history()` replayed on its own
+ * instance — counts its first prompt as one, so only that prompt, pasted as
+ * the exact template plus more blocks, could lose the block.
+ * @param data - the message's source and content (other fields are kept).
+ * @returns `data`, or a copy without the block.
+ */
+export function withoutTeammateReminder(data) {
+    const { source, content } = data;
+    if (source?.kind !== 'user')
+        return data;
+    if (!Array.isArray(content) || content.length < 2 || !isTeammateReminder(content[0]))
+        return data;
+    return { ...data, content: content.slice(1) };
+}
+/**
+ * The 0.2.0 `send_message` result: the mailbox status of the queued message
+ * (0.2.1 answers `{ sent: true }`).
+ * @param value - the parsed tool result.
+ * @returns `accepted` / `queued`, or `undefined` for anything else.
+ */
+export function legacySendMessageStatus(value) {
+    return value.status === 'accepted' || value.status === 'queued' ? value.status : undefined;
+}