@deepseek-harness-tui/dsh-tui 0.6.1 → 0.7.0

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

@@ -0,0 +1,109 @@
+/**
+ * Upstream compatibility contract.
+ *
+ * The TUI is validated against one upstream release line (0.1.0-rc.6).
+ * Every official package this adapter touches is blessed here; anything
+ * else must go through upstream channels or the adapter, never the UI.
+ *
+ * `upstreamDrift()` powers both the boot-time warning (dev visibility) and
+ * the CI gate (scripts/verify-upstream-contract.ts) so a mismatched
+ * install fails in CI before it fails on a user's machine.
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+export const UPSTREAM_VALIDATED_VERSION = '0.1.0-rc.6';
+/**
+ * Framework packages version on their own lines; the contract validates
+ * their MAJOR (breaking surface), not the harness rc number.
+ */
+export const UPSTREAM_FRAMEWORK_MAJORS = {
+    '@deepseek-ai/cordis': 4,
+    '@deepseek-ai/schemastery': 3,
+};
+/** Official packages the adapter consumes at runtime or as types. */
+export const UPSTREAM_BLESSED_PACKAGES = [
+    '@deepseek-ai/cordis',
+    '@deepseek-ai/schemastery',
+    '@deepseek-ai/dsh-invariants',
+    '@deepseek-ai/dsh-agent',
+    '@deepseek-ai/dsh-agent-instructions',
+    '@deepseek-ai/dsh-agent-presets',
+    '@deepseek-ai/dsh-commands',
+    '@deepseek-ai/dsh-cordis-host-runner',
+    '@deepseek-ai/dsh-llm',
+    '@deepseek-ai/dsh-persona',
+    '@deepseek-ai/dsh-session',
+    '@deepseek-ai/dsh-skill',
+    '@deepseek-ai/dsh-storage',
+    '@deepseek-ai/dsh-storage-domain',
+    '@deepseek-ai/dsh-storage-json',
+    '@deepseek-ai/dsh-workspace',
+    '@deepseek-ai/dsh-system-prompt',
+    '@deepseek-ai/dsh-terminal',
+    '@deepseek-ai/dsh-terminal-bash',
+    '@deepseek-ai/dsh-tool-ask-user',
+    '@deepseek-ai/dsh-tool-bash-persistent',
+    '@deepseek-ai/dsh-tool-cordis',
+    '@deepseek-ai/dsh-user-approval',
+    '@deepseek-ai/dsh-user-questions',
+];
+function resolvePackageJson(packageName) {
+    try {
+        const path = import.meta.resolve(`${packageName}/package.json`);
+        return path.startsWith('file:') ? fileURLToPath(path) : path;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function installedUpstreamVersions() {
+    const result = {};
+    for (const packageName of UPSTREAM_BLESSED_PACKAGES) {
+        let version;
+        const path = resolvePackageJson(packageName);
+        if (path !== undefined) {
+            try {
+                const manifest = JSON.parse(readFileSync(path, 'utf8'));
+                version = manifest.version;
+            }
+            catch {
+                version = undefined;
+            }
+        }
+        result[packageName] = version;
+    }
+    return result;
+}
+function rcNumber(version) {
+    const match = /0\.1\.0-rc\.(\d+)/u.exec(version ?? '');
+    return match === null ? undefined : Number(match[1]);
+}
+/**
+ * Report every blessed package whose installed version is NOT the validated
+ * release line. Empty array = the running install matches the contract.
+ */
+export function upstreamDrift() {
+    const drift = [];
+    for (const [packageName, installed] of Object.entries(installedUpstreamVersions())) {
+        const expected = UPSTREAM_BLESSED_PACKAGES.includes(packageName);
+        if (!expected)
+            continue;
+        let matches;
+        const frameworkMajor = UPSTREAM_FRAMEWORK_MAJORS[packageName];
+        if (frameworkMajor !== undefined) {
+            const installedMajor = Number((installed ?? '').split('.')[0]);
+            matches = installedMajor === frameworkMajor;
+        }
+        else {
+            matches = rcNumber(installed) === rcNumber(UPSTREAM_VALIDATED_VERSION);
+        }
+        if (!matches) {
+            drift.push({
+                package: packageName,
+                installed,
+                validated: frameworkMajor !== undefined ? `major ${frameworkMajor}` : UPSTREAM_VALIDATED_VERSION,
+            });
+        }
+    }
+    return drift;
+}

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

@@ -0,0 +1,80 @@
+/**
+ * dsh-tui plugin entry. The TUI implementation lives in `./plugin.tsx` (its
+ * render path is JSX); this module owns the plugin surface (`name`/`inject`/
+ * `Config`/`apply`) at the canonical `src/index.ts` location and delegates
+ * `apply` through a dynamic import so entry-scanning tooling and the Loader
+ * resolve a plain `.ts` module.
+ * @module @deepseek-harness-tui/dsh-tui
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import Schema from '@deepseek-ai/schemastery';
+import type { SessionModeSpec } from '../sessionModes.js';
+export declare const name = "dsh-tui";
+export declare const inject: string[];
+/**
+ * dsh-tui plugin configuration: session attachment, model route, working
+ * directory, and display preferences.
+ */
+export interface Config {
+    /** Existing session to attach; a fresh session is created when absent. */
+    sessionId?: string;
+    /** LLM provider route. The route resolves atomically (issue #67): when
+     *  cordis.yml names BOTH `provider` and `model`, that pair wins; otherwise
+     *  the `/model` choice persisted in `~/.dsh-tui/model.json` wins whole;
+     *  otherwise `agentDefaultModel` supplies the provider-neutral Harness
+     *  default. A bare embedder without that service falls back to DeepSeek.
+     *  A provider-only pin never half-overrides the persisted choice. */
+    provider?: string;
+    /** Model override passed to the agent; resolved together with `provider`
+     *  as one atomic route (see `provider`). */
+    model?: string;
+    /** Session working directory. When absent, the git worktree root
+     *  containing the invoking directory wins (the invoking directory itself
+     *  outside any worktree) — never a bare launch subdirectory (issue #96). */
+    cwd?: string;
+    /** Absolute local path, file URL, or provider URI resolved before the
+     *  initial agent is created. */
+    workspace?: string;
+    /** Reasoning effort applied to every request, validated against the live
+     *  route's adapter levels (an unlisted level is ignored and the adapter
+     *  default applies). Wins over the persisted /effort choice; also seeds
+     *  the startup status line until the first request header reports the
+     *  live value. */
+    effort?: string;
+    /** Show the live working line derived in-process from base session events. */
+    activity?: boolean;
+    /** Working-activity indicator preset: `claude`/`moon`/`comet`/`dots`/…
+     *  or `random` (see activityFrames.ts). When absent, the `/activity`
+     *  choice persisted in `~/.dsh-tui/working-activity.json` wins, then the
+     *  `claude` default. */
+    activityFrames?: string;
+    /** Show the segmented context bar (the band under the input with the
+     *  `ctx used/window` readout) in the status footer; off hides that row
+     *  while the status/mode lines stay (issue #29). */
+    contextBar?: boolean;
+    /** Run in the terminal's alternate screen (Claude Code fullscreen layout). */
+    fullscreen?: boolean;
+    /** UI language: `en` / `zh`. When absent, the `DSH_TUI_LANG` env var wins,
+     *  then the `/lang` choice persisted in `~/.dsh-tui/lang.json`, then `zh`. */
+    lang?: string;
+    /** Agent preset id new sessions compose from (standard/code/minimal/
+     *  cordis/… when the roster is mounted). When absent, the `/preset` choice
+     *  persisted in `~/.dsh-tui/agent-preset.json` wins, then the roster
+     *  default (`standard`). */
+    preset?: string;
+    /** Shift+Tab session-mode cycle (array order IS the cycle order; index 0
+     *  is the unmarked base mode). Each entry bundles any subset of the
+     *  `plan`/`sandbox`/`approval` atoms; absent → the built-in
+     *  default/plan/full cycle (see sessionModes.ts). */
+    modes?: SessionModeSpec[];
+}
+export declare const Config: Schema<Config>;
+/**
+ * Start the interactive TUI front door, delegating to the JSX implementation
+ * in `./plugin.tsx` (see its module doc for the full contract).
+ * @param ctx - the plugin context.
+ * @param config - the validated dsh-tui configuration.
+ * @returns a promise settling when the TUI teardown completes.
+ */
+export declare function apply(ctx: Context, config: Config): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,MAAM,MAAM,0BAA0B,CAAA;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEzD,eAAO,MAAM,IAAI,YAAY,CAAA;AAC7B,eAAO,MAAM,MAAM,UAA8B,CAAA;AAEjD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;yEAKqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;gDAC4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;gFAE4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;oCACgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;sBAIkB;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;4BAGwB;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;wDAEoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;gCAG4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;yDAGqD;IACrD,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,CA0BhC,CAAA;AAEF;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWvE"}

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

@@ -0,0 +1,45 @@
+import Schema from '@deepseek-ai/schemastery';
+export const name = 'dsh-tui';
+export const inject = ['agents', 'tuiWorkspaces'];
+export const Config = Schema.object({
+    sessionId: Schema.string().required(false),
+    // No schema defaults on the route: a `.default()` here would make an
+    // unset key indistinguishable from an explicit cordis.yml choice and the
+    // persisted `/model` preference could never win (issue #30). The defaults
+    // live at the end of the fallback chain in modelRoute.ts instead.
+    provider: Schema.string().required(false),
+    model: Schema.string().required(false),
+    cwd: Schema.string().required(false),
+    workspace: Schema.string().required(false),
+    effort: Schema.string().required(false),
+    activity: Schema.boolean().default(true),
+    activityFrames: Schema.string().required(false),
+    contextBar: Schema.boolean().default(true),
+    fullscreen: Schema.boolean().default(false),
+    lang: Schema.string().required(false),
+    preset: Schema.string().required(false),
+    modes: Schema.array(Schema.object({
+        id: Schema.string(),
+        label: Schema.string().required(false),
+        plan: Schema.boolean().required(false),
+        sandbox: Schema.union(['read-only', 'workspace-write', 'danger-full-access']).required(false),
+        approval: Schema.union(['ask', 'never']).required(false),
+    })).required(false),
+});
+/**
+ * Start the interactive TUI front door, delegating to the JSX implementation
+ * in `./plugin.tsx` (see its module doc for the full contract).
+ * @param ctx - the plugin context.
+ * @param config - the validated dsh-tui configuration.
+ * @returns a promise settling when the TUI teardown completes.
+ */
+export async function apply(ctx, config) {
+    const { upstreamDrift, UPSTREAM_VALIDATED_VERSION } = await import('./contract.js');
+    for (const entry of upstreamDrift()) {
+        console.warn(`[dsh-tui] upstream drift: ${entry.package} installed=${entry.installed ?? 'missing'} ` +
+            `validated=${UPSTREAM_VALIDATED_VERSION} — the TUI was validated against ` +
+            `${UPSTREAM_VALIDATED_VERSION}; upgrade the profile when upstream is bumped.`);
+    }
+    const { apply: ccTuiApply } = await import('./plugin.js');
+    return ccTuiApply(ctx, config);
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/invariant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,sBAAsB,CAAA;AACvC,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AASpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/types/dsh-adapter/packaged-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packaged-skills.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/packaged-skills.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AA+BlD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAqBzD"}

package/lib/types/{plugin.d.ts → dsh-adapter/plugin.d.ts}

@@ -1,3 +1,4 @@
+import type { Agent } from '@deepseek-ai/dsh-agent';
 import type { Context } from '@deepseek-ai/cordis';
 import { Config } from './index.js';
 /**
@@ -30,4 +31,20 @@ export declare function createExitFunnel(deps: {
     handleExit: (error?: unknown) => void;
     markTeardown: () => void;
 };
+/**
+ * Whether a user exit should leave the resume marker (and print the resume
+ * hint). Must be judged against the LIVE session behind the channel, not the
+ * boot-time agent apply() captured: /resume, /new and /model swap the active
+ * agent (channel.agentId follows, the old handle is disposed), so the
+ * captured reference can point at a stale session — wiping a marker the
+ * resume path just wrote (boot empty → /resume into history) or rewriting it
+ * to a fresh empty session (boot with history → /new). `liveAgent` is the
+ * registry lookup of channel.agentId; it falls back to the captured agent
+ * when the lookup misses. Exported for scripts/verify-exit-resume-marker.
+ */
+export declare function isExitResumable(deps: {
+    pendingCount: number;
+    liveAgent: Agent | undefined;
+    startupAgent: Agent;
+}): boolean;
 //# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAe,MAAM,wBAAwB,CAAA;AAGhE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AA2BnC;;;;;;;;GAQG;AACH,wBAAsB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkYvE;AA6GD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;CAAE,GAAG;IACjF,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB,CAcA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,KAAK,GAAG,SAAS,CAAA;IAC5B,YAAY,EAAE,KAAK,CAAA;CACpB,GAAG,OAAO,CAQV"}