@agi-fans/oh-my-dsh 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 D.Yang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# @agi-fans/oh-my-dsh
+
+The `omdsh` command: a TUI coding agent over the DeepSeek Harness core runtime. Boots the shipped `config/cordis.yml` composition through the harness boot machinery (`dsh-app-boot`), provides the command line and exit request, and leaves process lifetime to the mounted runner.
+
+## Install
+
+```sh
+npm install --global @agi-fans/oh-my-dsh
+omdsh
+```
+
+Or run it without a global installation:
+
+```sh
+npx @agi-fans/oh-my-dsh
+```
+
+## Develop
+
+```sh
+pnpm install
+pnpm omdsh "list files"
+
+node lib/bin.js "list files"
+```
+
+Model/provider routes come from `OMDSH_MODEL`/`OMDSH_PROVIDER` or the user's `$DSH_HOME/settings.yaml` (mounted via `dsh-settings-file`); credentials resolve through `dsh-credentials-local` (inherited env, managed `.credentials.yaml`, project/user `.env`). The default permission mode is trusted-local (`danger-full-access`); `OMDSH_PERMISSION_MODE` narrows it.
+
+Run `/settings` to customize the TUI. The overlay controls themes, colors, tool expansion, and the composer status bar, including telemetry visibility, compact/full labels, and the order of Context, Cache, Tokens, Latency, Time, and Activity groups. Use up/down to navigate and left/right to change a value; preferences are stored in the user settings document.
+
+Skills are discovered from project/user `.dsh/skills` and `.agents/skills` roots. MCP servers are loaded from user and project `.dsh/mcp.json` files; see [Skills and MCP](https://github.com/agi-fans/oh-my-dsh/blob/main/docs/skills-and-mcp.md) for the configuration shape and TUI commands.
+
+## Verify
+
+```sh
+pnpm --filter @agi-fans/oh-my-dsh test   # keyless pipe-mode e2e
+pnpm smoke                     # keyless interactive PTY e2e
+```

package/config/cordis.yml

@@ -0,0 +1,243 @@
+# omdsh composition — the TUI coding agent over the DeepSeek Harness core
+# runtime. No Host, no HTTP, no browser layer: local executors, the
+# executor-less agent spine, the DeepSeek adapter, and the omdsh TUI seam
+# (provider + interactive runner).
+#
+# Model/provider rows read the CLI/environment overrides through the
+# harness's sanctioned dynamic-config mechanism (!!js under plugin config).
+
+- id: timer
+  name: '@deepseek-ai/cordis-plugin-timer'
+
+- id: llm
+  name: '@deepseek-ai/dsh-llm'
+
+- id: llm-deepseek
+  name: '@deepseek-ai/dsh-llm-deepseek'
+
+- id: session
+  name: '@deepseek-ai/dsh-session'
+
+- id: session-persistence
+  name: '@deepseek-ai/dsh-session-persistence-jsonl'
+  config:
+    root: !!js "(process.env.OMDSH_HOME || process.env.DSH_HOME || process.env.HOME + '/.dsh') + '/sessions'"
+
+- id: session-checkpoint
+  name: '@deepseek-ai/dsh-session-checkpoint-policy'
+
+- id: session-projection
+  name: '@deepseek-ai/dsh-session-projection'
+
+- id: session-title
+  name: '@deepseek-ai/dsh-session-title'
+  config:
+    fallbackMaxWords: 8
+    fallbackMaxBytes: 80
+    maxTitleBytes: 120
+
+- id: session-stats
+  name: '@deepseek-ai/dsh-session-stats'
+
+- id: session-query
+  name: '@deepseek-ai/dsh-session-query-sqlite'
+  config:
+    path: !!js "(process.env.OMDSH_HOME || process.env.DSH_HOME || process.env.HOME + '/.dsh') + '/sessions-query.sqlite'"
+    openAt: first-search
+
+- id: attachments
+  name: '@deepseek-ai/dsh-attachment-local'
+  config:
+    dshHome: !!js process.env.OMDSH_HOME || process.env.DSH_HOME || undefined
+
+# User settings document ($DSH_HOME/settings.yaml) and credential sources
+# (inherited env, managed .credentials.yaml, project/user .env) — the same
+# rows the harness base mounts, so omdsh honors the user's existing model
+# route and API key setup out of the box.
+- id: settings
+  name: '@deepseek-ai/dsh-settings-file'
+
+- id: credentials
+  name: '@deepseek-ai/dsh-credentials-local'
+
+- id: agent
+  name: '@deepseek-ai/dsh-agent'
+
+- id: agent-default-model
+  name: '@deepseek-ai/dsh-agent-default-model'
+  config:
+    provider: !!js process.env.OMDSH_PROVIDER || 'deepseek-official'
+    model: !!js process.env.OMDSH_MODEL || 'deepseek-v4-flash'
+
+- id: commands
+  name: '@deepseek-ai/dsh-commands'
+
+- id: user-questions
+  name: '@deepseek-ai/dsh-user-questions'
+
+- id: approval
+  name: '@deepseek-ai/dsh-user-approval'
+  config:
+    policy: !!js "(process.env.OMDSH_PERMISSION_MODE || 'workspace-write') === 'danger-full-access' ? 'never' : 'ask'"
+
+# Every session starts with one explicit access preset. The environment is a
+# deployment override; the TUI switches it later through the /mode picker.
+- id: sandbox
+  name: '@deepseek-ai/dsh-sandbox-local'
+
+- id: sandbox-policy
+  name: '@deepseek-ai/dsh-sandbox-policy'
+  config:
+    mode: !!js process.env.OMDSH_PERMISSION_MODE || 'workspace-write'
+    workspaceRoot: !!js process.cwd()
+
+- id: fs
+  name: '@deepseek-ai/dsh-fs-local'
+
+- id: fs-observation-policy
+  name: '@deepseek-ai/dsh-fs-observation-policy'
+
+- id: subprocess
+  name: '@deepseek-ai/dsh-subprocess-local'
+
+- id: bash
+  name: '@deepseek-ai/dsh-bash-sandbox'
+
+- id: permission
+  name: '@deepseek-ai/dsh-permission-presets'
+  config:
+    presets:
+      read-only:
+        sandbox: read-only
+        approval: ask
+        name: Read only
+        description: Inspect the workspace without writing; escalation requires approval.
+      workspace-write:
+        sandbox: workspace-write
+        approval: ask
+        name: Workspace write
+        description: Write inside the workspace; wider access requires approval.
+      danger-full-access:
+        sandbox: danger-full-access
+        approval: never
+        name: Full access
+        description: Full filesystem access without approval prompts.
+
+- id: spine
+  name: '@deepseek-ai/dsh-agent-spine-demo'
+  config:
+    workspaceContext:
+      maxBytes: 65536
+    dshHome: !!js process.env.OMDSH_HOME || undefined
+    skills:
+      enabled: true
+    goals:
+      domain: {}
+      tool: {}
+
+# Human and model workflow contributions. The TUI discovers human commands
+# from dsh-commands and renders unknown tools through its safe fallback.
+- id: command-goal
+  name: '@deepseek-ai/dsh-command-goal'
+
+- id: tool-ask-user
+  name: '@deepseek-ai/dsh-tool-ask-user'
+
+- id: plan-mode
+  name: '@deepseek-ai/dsh-plan-mode'
+  config:
+    section: |
+      You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+
+      Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
+
+      The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
+
+      Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
+
+      Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public interface, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
+
+      When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
+
+- id: tool-fs
+  name: '@deepseek-ai/dsh-tool-fs'
+
+- id: tool-fs-search
+  name: '@deepseek-ai/dsh-tool-fs-search'
+  config:
+    sampleOverCapGlobResults: false
+
+- id: tool-todo
+  name: '@deepseek-ai/dsh-tool-todo'
+  config:
+    allowParallelInProgress: true
+
+- id: tool-str-replace-editor
+  name: '@deepseek-ai/dsh-tool-str-replace-editor'
+  config:
+    maxOutputChars: 16000
+
+- id: token-meter
+  name: '@deepseek-ai/dsh-token-meter'
+
+- id: compaction
+  name: '@deepseek-ai/dsh-compaction-basic'
+
+- id: command-compact
+  name: '@deepseek-ai/dsh-command-compact'
+
+- id: subagent
+  name: '@deepseek-ai/dsh-subagent'
+
+- id: subagent-spawn
+  name: '@deepseek-ai/dsh-subagent-spawn-in-process'
+  config:
+    providerName: spawn
+
+- id: subagent-control
+  name: '@deepseek-ai/dsh-tool-subagent-control'
+
+- id: subagent-list
+  name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+
+- id: tool-subagent
+  name: '@deepseek-ai/dsh-tool-subagent'
+  config:
+    provider: spawn
+    toolName: subagent
+    backgroundMode: continuable
+
+- id: tui
+  name: '@agi-fans/dsh-tui'
+  config:
+    model: !!js process.env.OMDSH_MODEL || 'deepseek-v4-flash'
+
+- id: tui-tool-presentation
+  name: '@agi-fans/dsh-tui/tool-presentation'
+
+- id: tui-session-runtime
+  name: '@agi-fans/dsh-tui/session-runtime'
+
+- id: tui-human-interaction
+  name: '@agi-fans/dsh-tui/human-interaction'
+
+- id: tui-command-session
+  name: '@agi-fans/dsh-tui/command-session'
+
+- id: tui-command-queue
+  name: '@agi-fans/dsh-tui/command-queue'
+
+- id: tui-command-model
+  name: '@agi-fans/dsh-tui/command-model'
+
+- id: tui-command-mode
+  name: '@agi-fans/dsh-tui/command-mode'
+
+- id: tui-command-transcript
+  name: '@agi-fans/dsh-tui/command-transcript'
+
+- id: tui-command-integrations
+  name: '@agi-fans/dsh-tui/command-integrations'
+
+- id: runner
+  name: '@agi-fans/dsh-tui/runner'

package/lib/args.d.ts

@@ -0,0 +1,24 @@
+/**
+ * omdsh argument parsing: one optional prompt (positional words joined)
+ * plus --model/--provider overrides, durable --resume, and help/version.
+ * @module @agi-fans/oh-my-dsh
+ */
+export interface OmdshInvocation {
+    /** Positional prompt words, joined by spaces (empty when interactive only). */
+    prompt: string[];
+    /** --model override (process.env.OMDSH_MODEL). */
+    model: string | undefined;
+    /** --provider override (process.env.OMDSH_PROVIDER). */
+    provider: string | undefined;
+    /** Durable session selected by --resume/-r. */
+    resume: string | undefined;
+    /** --help requested. */
+    help: boolean;
+}
+/**
+ * Parse the omdsh command line.
+ * @param argv - arguments after the bin name.
+ * @param version - version string for --version output.
+ * @returns the invocation, or prints help/version and exits.
+ */
+export declare function parseOmdshArgs(argv: readonly string[], version: string): OmdshInvocation;

package/lib/args.js

@@ -0,0 +1,81 @@
+/**
+ * omdsh argument parsing: one optional prompt (positional words joined)
+ * plus --model/--provider overrides, durable --resume, and help/version.
+ * @module @agi-fans/oh-my-dsh
+ */
+const HELP = `
+omdsh — a TUI coding agent on the DeepSeek Harness runtime
+
+Usage:
+  omdsh [options] [prompt...]
+
+Options:
+  --model <name>      model route (default deepseek-v4-flash)
+  --provider <name>   provider route (default deepseek-official)
+  -r, --resume <id>   resume a durable session
+  -h, --help          show this help
+  --version           show the version
+
+Environment:
+  DEEPSEEK_API_KEY    DeepSeek API key (required for live turns)
+`;
+/**
+ * Parse the omdsh command line.
+ * @param argv - arguments after the bin name.
+ * @param version - version string for --version output.
+ * @returns the invocation, or prints help/version and exits.
+ */
+export function parseOmdshArgs(argv, version) {
+    const prompt = [];
+    let model;
+    let provider;
+    let resume;
+    let help = false;
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i] ?? '';
+        if (arg === '-h' || arg === '--help') {
+            help = true;
+        }
+        else if (arg === '--version') {
+            console.log(version);
+            process.exit(0);
+        }
+        else if (arg === '--model') {
+            model = argv[i + 1];
+            i += 1;
+            if (model === undefined)
+                usageError('--model requires a value');
+        }
+        else if (arg === '--provider') {
+            provider = argv[i + 1];
+            i += 1;
+            if (provider === undefined)
+                usageError('--provider requires a value');
+        }
+        else if (arg === '--resume' || arg === '-r') {
+            resume = argv[i + 1];
+            i += 1;
+            if (resume === undefined || resume.startsWith('-'))
+                usageError(`${arg} requires a session id`);
+        }
+        else if (arg.startsWith('-')) {
+            usageError('unknown option ' + arg);
+        }
+        else {
+            prompt.push(arg);
+        }
+    }
+    if (help) {
+        console.log(HELP.trim());
+        process.exit(0);
+    }
+    if (resume !== undefined && prompt.length > 0)
+        usageError('--resume cannot be combined with a prompt');
+    return { prompt, model, provider, resume, help };
+}
+function usageError(message) {
+    console.error('omdsh: ' + message);
+    console.error('run: omdsh --help');
+    process.exit(2);
+}
+//# sourceMappingURL=args.js.map

package/lib/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * omdsh — command-line entry. Parses flags, applies model/provider
+ * overrides to the environment the cordis.yml composition reads, and
+ * boots the tree; the mounted runner owns process lifetime after that.
+ * @module @agi-fans/oh-my-dsh
+ */
+export {};

package/lib/bin.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * omdsh — command-line entry. Parses flags, applies model/provider
+ * overrides to the environment the cordis.yml composition reads, and
+ * boots the tree; the mounted runner owns process lifetime after that.
+ * @module @agi-fans/oh-my-dsh
+ */
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { parseOmdshArgs } from "./args.js";
+/** This app's version, read from its checked-in package.json. */
+function readVersion() {
+    const manifest = JSON.parse(readFileSync(fileURLToPath(new URL('../package.json', import.meta.url)), 'utf8'));
+    return typeof manifest.version === 'string' ? manifest.version : '0.0.0';
+}
+const invocation = parseOmdshArgs(process.argv.slice(2), readVersion());
+// CLI flags outrank every layered environment source; the cordis.yml
+// rows read these overrides at entry-mount time.
+if (invocation.model !== undefined)
+    process.env.OMDSH_MODEL = invocation.model;
+if (invocation.provider !== undefined)
+    process.env.OMDSH_PROVIDER = invocation.provider;
+const { runOmdsh } = await import("./boot.js");
+await runOmdsh(invocation.prompt, invocation.resume);
+//# sourceMappingURL=bin.js.map

package/lib/boot.d.ts

@@ -0,0 +1,21 @@
+/**
+ * omdsh tree boot: mounts the shipped cordis.yml composition through the
+ * harness boot machinery, providing the command line, the exit request,
+ * and the launch-environment snapshot before any entry mounts.
+ * @module @agi-fans/oh-my-dsh
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type ProcessShutdown } from './process-shutdown.ts';
+export declare const NAME = "omdsh";
+/** Absolute path of the shipped composition (source and built layouts both sit one directory under apps/omdsh). */
+export declare const CONFIG_PATH: string;
+/**
+ * Boot the omdsh tree and leave process lifetime to the mounted runner.
+ * @param prompt - positional prompt words (empty for interactive only).
+ * @param resume - durable session id selected by the launcher.
+ * @returns the settled root context and the shutdown controller.
+ */
+export declare function runOmdsh(prompt: readonly string[], resume?: string): Promise<{
+    ctx: Context;
+    shutdown: ProcessShutdown;
+}>;

package/lib/boot.js

@@ -0,0 +1,47 @@
+/**
+ * omdsh tree boot: mounts the shipped cordis.yml composition through the
+ * harness boot machinery, providing the command line, the exit request,
+ * and the launch-environment snapshot before any entry mounts.
+ * @module @agi-fans/oh-my-dsh
+ */
+import { fileURLToPath } from 'node:url';
+import { boot, installFailLoud, loadLayeredEnv } from '@deepseek-ai/dsh-app-boot';
+import { provideCmdline } from '@deepseek-ai/dsh-cmdline';
+import { DSH_LAUNCH_ENVIRONMENT_KEY } from '@deepseek-ai/dsh-launch-environment';
+import { createProcessShutdown } from "./process-shutdown.js";
+import { loadMcpPatches } from "./mcp-config.js";
+export const NAME = 'omdsh';
+/** Absolute path of the shipped composition (source and built layouts both sit one directory under apps/omdsh). */
+export const CONFIG_PATH = fileURLToPath(new URL('../config/cordis.yml', import.meta.url));
+/**
+ * Boot the omdsh tree and leave process lifetime to the mounted runner.
+ * @param prompt - positional prompt words (empty for interactive only).
+ * @param resume - durable session id selected by the launcher.
+ * @returns the settled root context and the shutdown controller.
+ */
+export async function runOmdsh(prompt, resume) {
+    const app = {};
+    const shutdown = createProcessShutdown(async () => { await app.current?.fiber.dispose(); });
+    const signalShutdown = new AbortController();
+    const interrupt = (code) => {
+        signalShutdown.abort();
+        shutdown.interrupt(code);
+    };
+    // SIGINT only fires outside raw mode (a raw tty delivers Ctrl-C as a
+    // keypress the tui provider handles); SIGTERM is the supervisor's stop.
+    process.on('SIGTERM', () => { interrupt(0); });
+    process.on('SIGINT', () => { interrupt(130); });
+    installFailLoud(NAME, process, async () => { await app.current?.fiber.dispose(); });
+    const environment = loadLayeredEnv(NAME);
+    const ctx = await boot(NAME, CONFIG_PATH, loadMcpPatches(), (hostCtx) => {
+        app.current = hostCtx;
+        hostCtx.provide(DSH_LAUNCH_ENVIRONMENT_KEY, environment);
+        provideCmdline(hostCtx, {
+            args: resume === undefined ? prompt : ['--resume', resume],
+            exit: (code) => { void shutdown.shutdown(code); },
+        });
+    });
+    app.current = ctx;
+    return { ctx, shutdown };
+}
+//# sourceMappingURL=boot.js.map

package/lib/mcp-config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Native omdsh MCP configuration adapter.
+ *
+ * This module owns only deployment discovery: it translates the familiar
+ * `mcpServers` JSON shape into one Harness `dsh-mcp-client` plugin row per
+ * server. Protocol, connection lifecycle, tool registration, and reconnects
+ * remain owned by the Harness MCP client.
+ * @module @agi-fans/oh-my-dsh
+ */
+export interface McpPluginRow {
+    id: string;
+    name: '@deepseek-ai/dsh-mcp-client';
+    config: Record<string, unknown>;
+}
+export interface McpInsertPatch {
+    insert: McpPluginRow[];
+}
+/** Resolve the native user-level MCP document. */
+export declare function omdshHome(environment?: NodeJS.ProcessEnv): string;
+/**
+ * Load user and project MCP definitions and turn them into Loader insert
+ * patches. Project definitions override same-named user definitions.
+ */
+export declare function loadMcpPatches(cwd?: string, environment?: NodeJS.ProcessEnv): McpInsertPatch[];

package/lib/mcp-config.js

@@ -0,0 +1,177 @@
+/**
+ * Native omdsh MCP configuration adapter.
+ *
+ * This module owns only deployment discovery: it translates the familiar
+ * `mcpServers` JSON shape into one Harness `dsh-mcp-client` plugin row per
+ * server. Protocol, connection lifecycle, tool registration, and reconnects
+ * remain owned by the Harness MCP client.
+ * @module @agi-fans/oh-my-dsh
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+function configError(path, detail) {
+    return new Error(`omdsh: invalid MCP config ${path}: ${detail}`);
+}
+function object(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readDocument(path) {
+    if (!existsSync(path))
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        throw configError(path, error instanceof Error ? error.message : String(error));
+    }
+    if (!object(parsed) || !object(parsed.mcpServers)) {
+        throw configError(path, 'expected an object with an "mcpServers" object');
+    }
+    return { mcpServers: parsed.mcpServers };
+}
+function stringArray(value, path, field) {
+    if (value === undefined)
+        return undefined;
+    if (!Array.isArray(value) || value.some(item => typeof item !== 'string')) {
+        throw configError(path, `"${field}" must be an array of strings`);
+    }
+    return value;
+}
+function stringRecord(value, path, field) {
+    if (value === undefined)
+        return undefined;
+    if (!object(value) || Object.values(value).some(item => typeof item !== 'string')) {
+        throw configError(path, `"${field}" must be an object of string values`);
+    }
+    return value;
+}
+function optionalBoolean(value, path, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'boolean')
+        throw configError(path, `"${field}" must be a boolean`);
+    return value;
+}
+function optionalNumber(value, path, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+        throw configError(path, `"${field}" must be a positive number`);
+    }
+    return value;
+}
+function commonConfig(server, path) {
+    const timeout = optionalNumber(server.toolCallTimeoutMs ?? server.timeout, path, 'toolCallTimeoutMs');
+    const fail = optionalBoolean(server.failOnStartupError, path, 'failOnStartupError');
+    if (server.reconnect !== undefined && !object(server.reconnect)) {
+        throw configError(path, '"reconnect" must be an object');
+    }
+    return {
+        ...(timeout === undefined ? {} : { toolCallTimeoutMs: timeout }),
+        ...(fail === undefined ? {} : { failOnStartupError: fail }),
+        ...(server.reconnect === undefined ? {} : { reconnect: server.reconnect }),
+    };
+}
+function expandEnvironment(value, environment) {
+    if (typeof value === 'string') {
+        return value.replace(/\$\{([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\}/gu, (token, name, fallback) => environment[name] ?? fallback ?? token);
+    }
+    if (Array.isArray(value))
+        return value.map(item => expandEnvironment(item, environment));
+    if (!object(value))
+        return value;
+    return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, expandEnvironment(item, environment)]));
+}
+function serverConfig(name, raw, path, environment) {
+    if (!/^[A-Za-z0-9_-]{1,32}$/u.test(name)) {
+        throw configError(path, `server name "${name}" must match [A-Za-z0-9_-]{1,32}`);
+    }
+    const value = expandEnvironment(raw, environment);
+    if (!object(value))
+        throw configError(path, `server "${name}" must be an object`);
+    const enabled = optionalBoolean(value.enabled, path, `${name}.enabled`);
+    if (enabled === false)
+        return undefined;
+    const command = value.command;
+    const url = value.url;
+    if (typeof command === 'string' && command !== '') {
+        if (url !== undefined)
+            throw configError(path, `server "${name}" cannot set both "command" and "url"`);
+        const args = stringArray(value.args, path, `${name}.args`);
+        const env = stringRecord(value.env, path, `${name}.env`);
+        if (value.cwd !== undefined && typeof value.cwd !== 'string') {
+            throw configError(path, `"${name}.cwd" must be a string`);
+        }
+        return {
+            serverName: name,
+            transport: 'stdio',
+            command,
+            ...(args === undefined ? {} : { args }),
+            ...(env === undefined ? {} : { env }),
+            ...(value.cwd === undefined ? {} : { cwd: value.cwd }),
+            ...commonConfig(value, path),
+        };
+    }
+    if (typeof url === 'string' && url !== '') {
+        const headers = stringRecord(value.headers, path, `${name}.headers`);
+        return {
+            serverName: name,
+            transport: 'streamable-http',
+            url,
+            ...(headers === undefined ? {} : { headers }),
+            ...commonConfig(value, path),
+        };
+    }
+    throw configError(path, `server "${name}" requires either a non-empty "command" or "url"`);
+}
+function safeId(name) {
+    return 'mcp-' + name;
+}
+/** Resolve the native user-level MCP document. */
+export function omdshHome(environment = process.env) {
+    const configured = environment.OMDSH_HOME?.trim() || environment.DSH_HOME?.trim();
+    return configured === undefined
+        ? join(homedir(), '.dsh')
+        : (isAbsolute(configured) ? configured : resolve(configured));
+}
+function projectRoot(cwd) {
+    const fallback = resolve(cwd);
+    let current = fallback;
+    for (;;) {
+        if (existsSync(join(current, '.git')))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return fallback;
+        current = parent;
+    }
+}
+/**
+ * Load user and project MCP definitions and turn them into Loader insert
+ * patches. Project definitions override same-named user definitions.
+ */
+export function loadMcpPatches(cwd = process.cwd(), environment = process.env) {
+    const files = [
+        join(omdshHome(environment), 'mcp.json'),
+        join(projectRoot(cwd), '.dsh', 'mcp.json'),
+    ];
+    const merged = new Map();
+    for (const path of files) {
+        const document = readDocument(path);
+        if (document === undefined)
+            continue;
+        for (const [name, value] of Object.entries(document.mcpServers))
+            merged.set(name, { value, path });
+    }
+    const rows = [];
+    for (const [name, source] of merged) {
+        const config = serverConfig(name, source.value, source.path, environment);
+        if (config === undefined)
+            continue;
+        rows.push({ id: safeId(name), name: '@deepseek-ai/dsh-mcp-client', config });
+    }
+    return rows.length === 0 ? [] : [{ insert: rows }];
+}
+//# sourceMappingURL=mcp-config.js.map

package/lib/process-shutdown.d.ts

@@ -0,0 +1,16 @@
+/** Bounded, escalating process shutdown (mirrors the dsh CLI's own controller). */
+/** Maximum grace allowed for the application tree to dispose before process exit. */
+export declare const PROCESS_SHUTDOWN_TIMEOUT_MS = 5000;
+/** Process-exit controller shared by normal completion and Unix signal handlers. */
+export interface ProcessShutdown {
+    /** Start or join graceful disposal before allowing natural completion with `code`. */
+    shutdown(code: number): Promise<void>;
+    /** Start graceful disposal followed by exit, or force exit when shutdown is already running. */
+    interrupt(code: number): void;
+}
+/**
+ * Create one process-exit controller around an application disposer.
+ * @param dispose - whole-application teardown that resolves at quiescence.
+ * @returns a controller whose normal calls coalesce and whose repeated signal call escalates.
+ */
+export declare function createProcessShutdown(dispose: () => Promise<void>): ProcessShutdown;

package/lib/process-shutdown.js

@@ -0,0 +1,57 @@
+/** Bounded, escalating process shutdown (mirrors the dsh CLI's own controller). */
+/** Maximum grace allowed for the application tree to dispose before process exit. */
+export const PROCESS_SHUTDOWN_TIMEOUT_MS = 5_000;
+/**
+ * Create one process-exit controller around an application disposer.
+ * @param dispose - whole-application teardown that resolves at quiescence.
+ * @returns a controller whose normal calls coalesce and whose repeated signal call escalates.
+ */
+export function createProcessShutdown(dispose) {
+    let pending;
+    let timeout;
+    let completed = false;
+    let forceExited = false;
+    const forceExitOnce = (code) => {
+        if (forceExited)
+            return;
+        forceExited = true;
+        if (timeout !== undefined)
+            clearTimeout(timeout);
+        process.exit(code);
+    };
+    const completeOnce = (code) => {
+        if (completed || forceExited)
+            return;
+        completed = true;
+        if (timeout !== undefined)
+            clearTimeout(timeout);
+        process.exitCode = code;
+    };
+    const start = (code, forceAfterDispose) => {
+        if (pending !== undefined)
+            return pending;
+        timeout = setTimeout(() => {
+            forceExitOnce(code);
+        }, PROCESS_SHUTDOWN_TIMEOUT_MS);
+        pending = Promise.resolve().then(dispose).then(() => {
+            if (forceAfterDispose)
+                forceExitOnce(code);
+            else
+                completeOnce(code);
+        }, () => { forceExitOnce(code); });
+        return pending;
+    };
+    return {
+        shutdown(code) {
+            return start(code, false);
+        },
+        interrupt(code) {
+            if (pending !== undefined) {
+                forceExitOnce(code);
+                return;
+            }
+            void start(code, true);
+        },
+    };
+}
+//# sourceMappingURL=process-shutdown.js.map

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@agi-fans/oh-my-dsh",
+  "description": "omdsh: TUI coding agent command over the DeepSeek Harness runtime",
+  "version": "0.1.0",
+  "homepage": "https://github.com/agi-fans/oh-my-dsh#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agi-fans/oh-my-dsh.git",
+    "directory": "apps/omdsh"
+  },
+  "bugs": {
+    "url": "https://github.com/agi-fans/oh-my-dsh/issues"
+  },
+  "type": "module",
+  "bin": {
+    "omdsh": "lib/bin.js"
+  },
+  "files": [
+    "lib/*.js",
+    "lib/*.d.ts",
+    "config"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@deepseek-ai/cordis-plugin-loader": "1.0.2",
+    "@deepseek-ai/cordis-plugin-timer": "1.1.3",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent-default-model": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent-spine-demo": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-attachment-local": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-command-compact": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-command-goal": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-commands": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-compaction-basic": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-app-boot": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-bash-sandbox": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-cmdline": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-fs-local": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-fs-observation-policy": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-launch-environment": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm-deepseek": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-mcp-client": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-permission-presets": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-plan-mode": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-sandbox-local": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-sandbox-policy": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-checkpoint-policy": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-projection": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-query-sqlite": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-stats": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-title": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-subagent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-token-meter": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-ask-user": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-fs": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-fs-search": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-str-replace-editor": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-subagent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-subagent-control": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tool-todo": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-user-approval": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-user-questions": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-subprocess-local": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings-file": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-credentials-local": "0.1.0-rc.6",
+    "@agi-fans/dsh-tui": "^0.1.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "typescript": "^5.6.0",
+    "tsx": "^4.19.0",
+    "vitest": "^2.1.0",
+    "@types/node": "^22.10.0"
+  },
+  "scripts": {
+    "clean": "node -e \"const fs=require('node:fs');fs.rmSync('lib',{recursive:true,force:true});fs.rmSync('tsconfig.tsbuildinfo',{force:true})\"",
+    "build": "tsc -b tsconfig.json",
+    "test": "vitest run src",
+    "typecheck": "tsc -b tsconfig.json",
+    "dev": "tsx src/bin.ts",
+    "omdsh": "tsx src/bin.ts"
+  }
+}