@deepseek-harness-tui/dsh-tui 0.8.8 → 0.9.1

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

@@ -19,6 +19,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { AgentSetup } from '@deepseek-ai/dsh-agent';
 import type { SessionId } from '@deepseek-ai/dsh-session';
 import type { PromptAssembly } from '@deepseek-ai/dsh-system-prompt';
+import { type ModelRoute } from '../modelRoute.js';
 /** One roster entry, as returned by `agentPresets.list()`/`resolve()`. */
 export interface AgentPresetInfo {
     readonly id: string;
@@ -94,6 +95,23 @@ export declare function runningPresetOf(session: {
         data: unknown;
     }[];
 }): string | undefined;
+/**
+ * The route a PERSISTED session actually ran, read from its log: the last
+ * `request/header` snapshot. undefined when the log records none (a session
+ * that never started a turn) or the artifact is unreadable.
+ *
+ * Resume feeds this back into `agents.resume({ agentOptions })` so the
+ * resumed agent's `options.model` is populated again — a cordis.yml that
+ * pins only `provider` (issue #67: a half-pin never merges) leaves
+ * agentOptions.model undefined, which breaks the `{{model}}` persona variable
+ * for the resumed agent's own assembly AND for every subagent it spawns
+ * (dsh-subagent's `resolveChildAgentOptions` inherits `parent.options.model`).
+ *
+ * @param ctx - The plugin context (persistence lookup).
+ * @param sessionId - The persisted session to inspect.
+ * @returns The recorded model route, or undefined when unrecorded/unreadable.
+ */
+export declare function resolvePersistedRoute(ctx: Context, sessionId: SessionId): Promise<ModelRoute | undefined>;
 /**
  * Keep the official Minimal preset's model-facing contract at exactly two
  * tools. The TUI mounts ask_user_question at the host layer so every other

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

@@ -1 +1 @@
-{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AAKpE,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,+DAA+D;AAC/D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,IAAI,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAA;IAC3C,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC9C,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC/D,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAClE,yEAAyE;IACzE,UAAU,CAAC,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,OAAO,CAAA;KAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3D;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAEnE;AAED,kEAAkE;AAClE,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBhG;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqB5G;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,MAAM,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CACnD,GAAG,MAAM,GAAG,SAAS,CAErB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,CAM/G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAKpG"}
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/presets.ts"],"names":[],"mappings":"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"}

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

@@ -16,6 +16,7 @@
  * before presets existed.
  */
 import { resolveSessionPreset } from '@deepseek-ai/dsh-agent-presets';
+import { recordedModelRoute } from '../modelRoute.js';
 const ASK_USER_TOOL = 'ask_user_question';
 /**
  * The mounted preset roster, or undefined when the composition has no
@@ -95,6 +96,36 @@ export async function resolvePersistedPreset(ctx, sessionId) {
 export function runningPresetOf(session) {
     return resolveSessionPreset(session);
 }
+/**
+ * The route a PERSISTED session actually ran, read from its log: the last
+ * `request/header` snapshot. undefined when the log records none (a session
+ * that never started a turn) or the artifact is unreadable.
+ *
+ * Resume feeds this back into `agents.resume({ agentOptions })` so the
+ * resumed agent's `options.model` is populated again — a cordis.yml that
+ * pins only `provider` (issue #67: a half-pin never merges) leaves
+ * agentOptions.model undefined, which breaks the `{{model}}` persona variable
+ * for the resumed agent's own assembly AND for every subagent it spawns
+ * (dsh-subagent's `resolveChildAgentOptions` inherits `parent.options.model`).
+ *
+ * @param ctx - The plugin context (persistence lookup).
+ * @param sessionId - The persisted session to inspect.
+ * @returns The recorded model route, or undefined when unrecorded/unreadable.
+ */
+export async function resolvePersistedRoute(ctx, sessionId) {
+    const persistence = ctx.get('sessionPersistence');
+    if (persistence === undefined)
+        return undefined;
+    try {
+        const { events } = await persistence.load(sessionId);
+        return recordedModelRoute(events);
+    }
+    catch {
+        // A missing/corrupt artifact leaves resume itself to report the failure;
+        // the route lookup must not mask it with a second, misleading error.
+        return undefined;
+    }
+}
 /**
  * Keep the official Minimal preset's model-facing contract at exactly two
  * tools. The TUI mounts ask_user_question at the host layer so every other

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

@@ -31,6 +31,32 @@ export interface CatalogProviderCandidate {
     readonly provider: string;
     readonly displayName: string;
 }
+/** One OAuth-capable provider a dsh-auth-style plugin mounts (masked state only). */
+export interface OAuthProviderStatus {
+    readonly provider: string;
+    readonly label: string;
+    readonly oauthLabel: string;
+    readonly loginLabel: string | undefined;
+    readonly signedIn: boolean;
+    readonly expiresAt: number | undefined;
+    readonly expired: boolean;
+}
+/** One successful OAuth login. */
+export interface OAuthLoginResult {
+    readonly provider: string;
+    readonly oauthLabel: string;
+    readonly expiresAt: number;
+}
+/**
+ * The `ctx.dshAuth` api, structural so this tree never imports the plugin:
+ * mounting dsh-auth (or anything exporting this shape) lights up the wizard's
+ * OAuth branch; absent it, the wizard behaves exactly as before.
+ */
+export interface OAuthSetupHost {
+    providers(): Promise<readonly OAuthProviderStatus[]>;
+    login(provider?: string, signal?: AbortSignal): Promise<OAuthLoginResult>;
+    logout(provider: string): Promise<boolean>;
+}
 /**
  * Runtime capabilities the wizard needs, implemented by the channel over
  * `ctx.settings` / `ctx.credentials` / `ctx.llm`. `undefined` from
@@ -66,6 +92,8 @@ export interface ProviderSetupHost {
      * rejects when the adapter's validation deems it unserviceable.
      */
     writeProfile(route: string, profile: Record<string, unknown>): Promise<void>;
+    /** The OAuth sign-in surface; absent when no dsh-auth-style plugin is mounted. */
+    readonly oauth?: OAuthSetupHost;
 }
 export interface ProviderWizardDeps {
     readonly host: ProviderSetupHost;
@@ -81,7 +109,7 @@ export interface ProviderWizardDeps {
     readonly working: () => boolean;
     readonly switchModel: (provider: string, model: string) => Promise<boolean>;
 }
-export type ProviderWizardOutcome = 'added' | 'cancelled' | 'failed';
+export type ProviderWizardOutcome = 'added' | 'signed-out' | 'cancelled' | 'failed';
 /**
  * Run the add-provider wizard. Resolves 'cancelled' when the user dismisses
  * any question (Esc) — nothing has been written at that point by design:

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

@@ -1 +1 @@
-{"version":3,"file":"providerWizard.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/providerWizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,QAAoC,CAAA;AAElE,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,2EAIrB,CAAA;AAEV;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,mEAAmE;AACnE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,oBAAoB,IAAI,SAAS,wBAAwB,EAAE,CAAA;IAC3D,kEAAkE;IAClE,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,sEAAsE;IACtE,cAAc,CAAC,OAAO,EAAE;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAA;IAC1C,0EAA0E;IAC1E,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACxD,2EAA2E;IAC3E,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjE,yDAAyD;IACzD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,CACZ,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAC3B,OAAO,CAAC,qBAAqB,CAAC,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,CACf,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KACtE,IAAI,CAAA;IACT,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAA;IACrE,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5E;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,CAAA;AAgDpE;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,qBAAqB,CAAC,CA8MhC"}
+{"version":3,"file":"providerWizard.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/providerWizard.ts"],"names":[],"mappings":"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"}

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

@@ -69,13 +69,23 @@ export async function runProviderWizard(deps) {
     const { host, ask, notify, pushLocal } = deps;
     try {
         // ── 1. mode ────────────────────────────────────────────────────────
+        const modeOptions = [
+            { label: t('provider-opt-catalog'), description: t('provider-opt-catalog-desc') },
+            { label: t('provider-opt-custom'), description: t('provider-opt-custom-desc') },
+        ];
+        // The OAuth branch exists only while a dsh-auth-style plugin is mounted;
+        // without the service the mode question stays exactly two options.
+        if (host.oauth !== undefined) {
+            modeOptions.push({ label: t('provider-opt-oauth'), description: t('provider-opt-oauth-desc') });
+        }
         const modeAnswer = await ask({
-            questions: [optionQuestion('mode', t('provider-q-mode'), [
-                    { label: t('provider-opt-catalog'), description: t('provider-opt-catalog-desc') },
-                    { label: t('provider-opt-custom'), description: t('provider-opt-custom-desc') },
-                ], { hideCustomInput: true })],
+            questions: [optionQuestion('mode', t('provider-q-mode'), modeOptions, { hideCustomInput: true })],
         });
-        const isCatalog = answerSelected(modeAnswer, 'mode')[0] === t('provider-opt-catalog');
+        const pickedMode = answerSelected(modeAnswer, 'mode')[0];
+        if (host.oauth !== undefined && pickedMode === t('provider-opt-oauth')) {
+            return runOAuthWizard(deps, host.oauth);
+        }
+        const isCatalog = pickedMode === t('provider-opt-catalog');
         // ── 2. route ───────────────────────────────────────────────────────
         let route = '';
         if (isCatalog) {
@@ -267,6 +277,80 @@ export async function runProviderWizard(deps) {
         return 'failed';
     }
 }
+/** Masked state line for one provider row in the OAuth pick question. */
+function oauthStateDescription(status) {
+    if (status.signedIn) {
+        return t('provider-oauth-state-in', { time: new Date(status.expiresAt ?? 0).toISOString() });
+    }
+    return status.expired
+        ? t('provider-oauth-state-expired')
+        : (status.loginLabel ?? status.oauthLabel);
+}
+/**
+ * The OAuth branch of `/provider`: pick a subscription provider, then sign
+ * in (the plugin's own question panels carry the flow — device codes,
+ * authorization URLs), or re-login / sign out when one is already signed in.
+ * No settings or credential writes happen here; the plugin owns its store.
+ */
+async function runOAuthWizard(deps, oauth) {
+    const { ask, notify, pushLocal } = deps;
+    try {
+        const statuses = await oauth.providers();
+        if (statuses.length === 0) {
+            notify(t('provider-oauth-none'), { color: 'warning' });
+            return 'failed';
+        }
+        const pickAnswer = await ask({
+            questions: [optionQuestion('oauth-provider', t('provider-q-oauth'), statuses.map(status => ({
+                    label: status.provider,
+                    description: oauthStateDescription(status),
+                })), { hideCustomInput: true })],
+        });
+        const providerId = answerSelected(pickAnswer, 'oauth-provider')[0];
+        const status = statuses.find(row => row.provider === providerId);
+        if (status === undefined)
+            return 'cancelled';
+        if (status.signedIn) {
+            const actionAnswer = await ask({
+                questions: [optionQuestion('oauth-signed-action', t('provider-q-oauth-signed', { provider: status.provider }), [
+                        { label: t('provider-opt-oauth-relogin'), description: t('provider-opt-oauth-relogin-desc') },
+                        { label: t('provider-opt-oauth-logout'), description: t('provider-opt-oauth-logout-desc') },
+                        { label: t('provider-opt-confirm-cancel') },
+                    ], { hideCustomInput: true })],
+            });
+            const action = answerSelected(actionAnswer, 'oauth-signed-action')[0];
+            if (action === t('provider-opt-oauth-logout')) {
+                await oauth.logout(status.provider);
+                pushLocal('/provider', [
+                    t('provider-line-oauth-provider', { provider: status.provider }),
+                    t('provider-line-oauth-out'),
+                ]);
+                notify(t('provider-oauth-logout-ok', { provider: status.provider }), { color: 'success' });
+                return 'signed-out';
+            }
+            if (action !== t('provider-opt-oauth-relogin'))
+                return 'cancelled';
+        }
+        const result = await oauth.login(status.provider);
+        pushLocal('/provider', [
+            t('provider-line-oauth-provider', { provider: result.provider }),
+            t('provider-line-oauth-flow', { flow: result.oauthLabel }),
+            t('provider-line-oauth-expires', { time: new Date(result.expiresAt).toISOString() }),
+            t('provider-switch-hint'),
+        ]);
+        notify(t('provider-oauth-login-ok', { provider: result.provider }), { color: 'success' });
+        return 'added';
+    }
+    catch (error) {
+        if (error instanceof UserQuestionError) {
+            notify(t('provider-cancelled'));
+            return 'cancelled';
+        }
+        const err = error instanceof Error ? error.message : String(error);
+        notify(t('provider-oauth-login-failed', { err }), { color: 'error', timeoutMs: 8000 });
+        return 'failed';
+    }
+}
 /** Prompt for a route id until it validates or the retry budget runs out. */
 async function promptRouteId(ask, notify) {
     for (let attempt = 0; attempt < MAX_RETRY; attempt += 1) {

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

@@ -18,6 +18,12 @@ export interface QuestionSelection {
     readonly selected: string[];
     readonly custom?: string;
 }
+/**
+ * In-progress answer state kept while navigating between questions. Drafts
+ * are deliberately separate from committed answers: leaving a question
+ * should preserve what the user typed without making it count as answered.
+ */
+export type QuestionDraft = QuestionSelection;
 /** What the TUI renders while a question is pending. */
 export interface QuestionSnapshot {
     /** Stable key so the panel remounts (fresh selection state) per question. */
@@ -29,6 +35,10 @@ export interface QuestionSnapshot {
     readonly total: number;
     /** Questions answered before the current one. */
     readonly answered: number;
+    /** Previously saved answer or draft for the current question. */
+    readonly draft?: QuestionDraft;
+    /** Whether Esc should navigate to the previous question. */
+    readonly canGoBack: boolean;
 }
 /** Completed batch summary, pushed into the transcript by the caller. */
 export interface QuestionSummary {
@@ -88,11 +98,18 @@ export declare class QuestionStore {
     /** Advance to the next queued ask, if any. */
     private startNext;
     /**
-     * The user submitted an answer for the current question; advances the
-     * batch and settles it once every question is answered.
+     * The user submitted an answer for the current question; replaces any
+     * previous answer at that position, advances the batch, and settles it once
+     * every question is answered.
      * @param selection - Selected option labels plus optional custom text.
      */
     answerCurrent(selection: QuestionSelection): void;
+    /**
+     * Navigate to the previous question without cancelling the batch. The
+     * caller supplies the panel's current draft so partially typed text can be
+     * restored when the user returns.
+     */
+    backCurrent(draft?: QuestionDraft): void;
     /** The user interrupted the questionnaire (Esc / Ctrl+C). */
     cancelCurrent(): void;
     /** Reject the active and all queued asks (plugin teardown). */

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

@@ -1 +1 @@
-{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/questions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAA;AAExC;mEACmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAsBD,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAqCD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAI;IACpB,yEAAyE;IACzE,OAAO,CAAC,SAAS,CAAwB;IACzC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAgC;IAErD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C;;;OAGG;IACH,WAAW,IAAI,gBAAgB,GAAG,IAAI;IAItC;;;OAGG;IACH,aAAa,IAAI,eAAe,EAAE;IAMlC,OAAO,CAAC,IAAI;IAIZ,sEAAsE;IACtE,OAAO,CAAC,eAAe;IAgBvB;;;;;;;;;OASG;IACH,GAAG,CAAC,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA8BnE,8CAA8C;IAC9C,OAAO,CAAC,SAAS;IAOjB;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAwBjD,6DAA6D;IAC7D,aAAa,IAAI,IAAI;IAUrB,+DAA+D;IAC/D,SAAS,IAAI,IAAI;IASjB,wEAAwE;IACxE,OAAO,CAAC,MAAM;IAOd,yEAAyE;IACzE,OAAO,CAAC,IAAI;CAMb"}
+{"version":3,"file":"questions.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/questions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAEL,KAAK,qBAAqB,EAE1B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAA;AAExC;mEACmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAA;AAwB7C,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAA;IACtC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAA;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAqDD;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,QAAQ,CAAI;IACpB,yEAAyE;IACzE,OAAO,CAAC,SAAS,CAAwB;IACzC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAgC;IAErD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C;;;OAGG;IACH,WAAW,IAAI,gBAAgB,GAAG,IAAI;IAItC;;;OAGG;IACH,aAAa,IAAI,eAAe,EAAE;IAMlC,OAAO,CAAC,IAAI;IAIZ,sEAAsE;IACtE,OAAO,CAAC,eAAe;IAwBvB;;;;;;;;;OASG;IACH,GAAG,CAAC,OAAO,EAAE,sBAAsB,EAC/B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA+BnE,8CAA8C;IAC9C,OAAO,CAAC,SAAS;IAOjB;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI;IA2BjD;;;;OAIG;IACH,WAAW,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI;IAWxC,6DAA6D;IAC7D,aAAa,IAAI,IAAI;IAUrB,+DAA+D;IAC/D,SAAS,IAAI,IAAI;IASjB,wEAAwE;IACxE,OAAO,CAAC,MAAM;IAOd,yEAAyE;IACzE,OAAO,CAAC,IAAI;CAMb"}

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

@@ -27,9 +27,23 @@ function clip(text, max = 140) {
         return text;
     return `${text.slice(0, max)}…`;
 }
+function isDefined(value) {
+    return value !== undefined;
+}
+function copyDraft(draft) {
+    return {
+        selected: [...draft.selected],
+        ...(draft.custom !== undefined ? { custom: draft.custom } : {}),
+    };
+}
+function selectionFromAnswer(answer) {
+    return copyDraft(answer);
+}
 function buildSummary(pending) {
-    const lines = pending.answers.map(answer => {
-        const question = pending.request.questions.find(q => q.id === answer.id);
+    const lines = pending.request.questions.flatMap((question, index) => {
+        const answer = pending.answers[index];
+        if (answer === undefined)
+            return [];
         const text = pending.redact
             ? '••••••'
             : (() => {
@@ -38,7 +52,7 @@ function buildSummary(pending) {
                     ? labels === '' ? answer.custom : `${labels}：${answer.custom}`
                     : labels;
             })();
-        return `· ${question?.question ?? answer.id} → ${clip(text)}`;
+        return `· ${question.question} → ${clip(text)}`;
     });
     const total = pending.request.questions.length;
     return {
@@ -103,12 +117,20 @@ export class QuestionStore {
             return;
         }
         const question = pending.request.questions[pending.index];
+        const savedDraft = pending.drafts[pending.index];
+        const savedAnswer = pending.answers[pending.index];
         this.snapshotCache = question === undefined ? null : {
             key: `${pending.batchId}-${pending.index}`,
             question,
             position: pending.index + 1,
             total: pending.request.questions.length,
-            answered: pending.answers.length,
+            answered: pending.index,
+            ...(savedDraft !== undefined
+                ? { draft: savedDraft }
+                : savedAnswer !== undefined
+                    ? { draft: selectionFromAnswer(savedAnswer) }
+                    : {}),
+            canGoBack: pending.index > 0,
         };
     }
     /**
@@ -127,7 +149,8 @@ export class QuestionStore {
                 request,
                 batchId: ++this.batchSeq,
                 index: 0,
-                answers: [],
+                answers: new Array(request.questions.length),
+                drafts: new Array(request.questions.length),
                 ...(options?.redact ? { redact: true } : {}),
                 resolve,
                 reject,
@@ -160,8 +183,9 @@ export class QuestionStore {
         this.emit();
     }
     /**
-     * The user submitted an answer for the current question; advances the
-     * batch and settles it once every question is answered.
+     * The user submitted an answer for the current question; replaces any
+     * previous answer at that position, advances the batch, and settles it once
+     * every question is answered.
      * @param selection - Selected option labels plus optional custom text.
      */
     answerCurrent(selection) {
@@ -169,25 +193,44 @@ export class QuestionStore {
         const question = pending?.request.questions[pending.index];
         if (pending === undefined || question === undefined)
             return;
-        pending.answers.push({
+        const answer = {
             id: question.id,
             selected: [...selection.selected],
             ...(selection.custom !== undefined && selection.custom !== ''
                 ? { custom: selection.custom }
                 : {}),
-        });
+        };
+        pending.answers[pending.index] = answer;
+        pending.drafts[pending.index] = copyDraft(selection);
         pending.index += 1;
         if (pending.index >= pending.request.questions.length) {
             // Batch complete: settle the harness promise, remember a transcript
             // summary, and drain the next queued ask if any.
+            const answers = pending.answers.filter(isDefined);
             this.active = undefined;
-            pending.resolve({ answers: [...pending.answers] });
+            pending.resolve({ answers });
             this.summaries.push(buildSummary(pending));
             this.startNext();
         }
         this.rebuildSnapshot();
         this.emit();
     }
+    /**
+     * Navigate to the previous question without cancelling the batch. The
+     * caller supplies the panel's current draft so partially typed text can be
+     * restored when the user returns.
+     */
+    backCurrent(draft) {
+        const pending = this.active;
+        if (pending === undefined || pending.index <= 0)
+            return;
+        if (draft !== undefined) {
+            pending.drafts[pending.index] = copyDraft(draft);
+        }
+        pending.index -= 1;
+        this.rebuildSnapshot();
+        this.emit();
+    }
     /** The user interrupted the questionnaire (Esc / Ctrl+C). */
     cancelCurrent() {
         const pending = this.active;

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

@@ -0,0 +1,49 @@
+/**
+ * Session recap (`/recap`, pi-recap semantics): a single TOOL-LESS LLM
+ * call that summarizes the session's RECENT activity into one line and
+ * proposes a short title. Unlike `/btw` it does not replay the full
+ * derived history — the recent-activity excerpt below IS the payload, so
+ * the call stays cheap and the recap is about the tail of the session,
+ * which is exactly what a glance at a resumed/unknown session needs.
+ *
+ * The answer never enters the session log — it is pure UI state (the
+ * RecapPanel in the Chat screen); applying the proposed title goes
+ * through the normal `/rename` path (channel.renameSession).
+ *
+ * @module
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+/** Max chars of recent activity fed to the recap call. */
+export declare const RECAP_RECENT_CHARS = 6000;
+/**
+ * Collect the most recent user/assistant exchanges from a session event
+ * log as plain `role: text` lines, capped to the tail turns and a char
+ * budget. Rows derived from the log (tool cards, notices) are skipped —
+ * the recap wants the conversation, not the chrome.
+ */
+export declare function collectRecentActivity(events: readonly SessionEvent[], limitChars: number): string;
+/**
+ * Wrap the recent-activity excerpt with the single-response, JSON-only
+ * recap contract. The model answers with a title + one-line summary in
+ * the language of the activity (matching the user's own words).
+ */
+export declare function wrapRecapPrompt(activity: string): string;
+/**
+ * Parse the model's recap response: extract the JSON object (tolerating
+ * stray prose around it); on failure the whole text becomes the summary
+ * and no title is proposed.
+ */
+export declare function parseRecapResponse(raw: string): {
+    summary: string;
+    title?: string;
+};
+/** Outcome of one recap call, as surfaced on the Channel. */
+export interface RecapOutcome {
+    /** The one-line summary, or null when the call failed. */
+    summary: string | null;
+    /** Proposed session title, when the model offered one. */
+    title?: string;
+    /** Human-readable failure reason (llm missing, stream error, …). */
+    error?: string;
+}
+//# sourceMappingURL=recap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recap.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/recap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAkBtC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA4BjG;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYxD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAyBnF;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

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

@@ -0,0 +1,121 @@
+/**
+ * Session recap (`/recap`, pi-recap semantics): a single TOOL-LESS LLM
+ * call that summarizes the session's RECENT activity into one line and
+ * proposes a short title. Unlike `/btw` it does not replay the full
+ * derived history — the recent-activity excerpt below IS the payload, so
+ * the call stays cheap and the recap is about the tail of the session,
+ * which is exactly what a glance at a resumed/unknown session needs.
+ *
+ * The answer never enters the session log — it is pure UI state (the
+ * RecapPanel in the Chat screen); applying the proposed title goes
+ * through the normal `/rename` path (channel.renameSession).
+ *
+ * @module
+ */
+/** Max chars of recent activity fed to the recap call. */
+export const RECAP_RECENT_CHARS = 6000;
+/** How many exchanges (user + assistant) the recap looks back. */
+const RECAP_RECENT_TURNS = 6;
+/** The first text block of a message `content` payload. */
+function textOfContent(content) {
+    if (typeof content === 'string')
+        return content.trim() || undefined;
+    if (!Array.isArray(content))
+        return undefined;
+    for (const block of content) {
+        if (block === null || typeof block !== 'object')
+            continue;
+        const record = block;
+        if (record['type'] !== 'text')
+            continue;
+        const value = record['text'];
+        if (typeof value === 'string' && value.trim().length > 0)
+            return value.trim();
+    }
+    return undefined;
+}
+/**
+ * Collect the most recent user/assistant exchanges from a session event
+ * log as plain `role: text` lines, capped to the tail turns and a char
+ * budget. Rows derived from the log (tool cards, notices) are skipped —
+ * the recap wants the conversation, not the chrome.
+ */
+export function collectRecentActivity(events, limitChars) {
+    const entries = [];
+    for (const event of events) {
+        const record = event;
+        if (record['type'] === 'user/message') {
+            const data = record['data'];
+            const text = textOfContent(data?.['content']);
+            if (text !== undefined)
+                entries.push({ role: 'user', text });
+            continue;
+        }
+        if (record['type'] === 'assistant/message') {
+            const data = record['data'];
+            const message = data?.['message'];
+            const text = textOfContent(message?.['content']);
+            if (text !== undefined)
+                entries.push({ role: 'assistant', text });
+        }
+    }
+    const tail = entries.slice(-RECAP_RECENT_TURNS * 2);
+    let budget = limitChars;
+    const lines = [];
+    for (const entry of tail) {
+        const text = entry.text.length > budget ? entry.text.slice(0, budget) : entry.text;
+        lines.push(`${entry.role}: ${text}`);
+        budget -= text.length + entry.role.length + 2;
+        if (budget <= 0)
+            break;
+    }
+    return lines.join('\n');
+}
+/**
+ * Wrap the recent-activity excerpt with the single-response, JSON-only
+ * recap contract. The model answers with a title + one-line summary in
+ * the language of the activity (matching the user's own words).
+ */
+export function wrapRecapPrompt(activity) {
+    return `<system-reminder>You are a thoughtful assistant helping the user wrap up this session. Look at the recent activity below and give it a quick human review — like a colleague summarizing what the two of you just worked on.
+
+TASK — do BOTH:
+1. Write ONE short line (about 10-20 words) recapping the RECENT ACTIVITY: what was being worked on and where things stand. Write it in the same language the user writes in. Sound natural and professional — a warm recap, not a dry log.
+2. Propose a short session title (about 2-6 words, same language) that captures what this session is about.
+
+Respond with ONLY a JSON object, no markdown fences, no extra text:
+{"title": "<short title>", "summary": "<one-line summary>"}
+
+RECENT ACTIVITY:
+${activity}</system-reminder>`;
+}
+/**
+ * Parse the model's recap response: extract the JSON object (tolerating
+ * stray prose around it); on failure the whole text becomes the summary
+ * and no title is proposed.
+ */
+export function parseRecapResponse(raw) {
+    const start = raw.indexOf('{');
+    const end = raw.lastIndexOf('}');
+    if (start !== -1 && end > start) {
+        try {
+            const parsed = JSON.parse(raw.slice(start, end + 1));
+            if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
+                const record = parsed;
+                const summary = typeof record['summary'] === 'string' && record['summary'].trim() !== ''
+                    ? record['summary'].trim()
+                    : undefined;
+                const title = typeof record['title'] === 'string' && record['title'].trim() !== ''
+                    ? record['title'].trim()
+                    : undefined;
+                if (summary !== undefined) {
+                    return title === undefined ? { summary } : { summary, title };
+                }
+            }
+        }
+        catch {
+            // Fall through to the raw-text fallback below.
+        }
+    }
+    return { summary: raw.trim() };
+}