Turtle
800bafda3b
Replace the dsh CLI's three hand-rolled parsing idioms (raw argv[0]/includes dispatch in bin.ts, per-mode node:util parseArgs in headless.ts/web.ts, and the bespoke parseResumeArg scanner in dsh-app-boot) with a single Commander adapter in apps/cli/src/args.ts. parseDshArgs resolves argv into a discriminated DshInvocation union; bin.ts switches on the mode and dynamic-imports the chosen module, which now consumes already-parsed values. - web is a real subcommand; --host uses choices and --port an argParser range check, moving validation into the parser. - --resume rejects empty and repeated forms; --prompt rejects empty; a config positional after --prompt and a root flag placed before web fail loud. - adds --help/--version; removes parseResumeArg from dsh-app-boot. - new apps/cli/tests/args.spec.ts (apps/*/tests added to vitest include, apps/cli/tests to tsconfig.host.json); the tui-agent keyless PTY smoke covers bin.ts dispatch end to end unchanged.
71 lines
3.5 KiB
TypeScript
71 lines
3.5 KiB
TypeScript
/**
|
|
* `dsh` default surface — the interactive TUI coding agent. Boots the shipped
|
|
* tui-agent config (or an explicit config argument) with the personal overlay
|
|
* from the Harness home (`~/.dsh`): its `.env` fills environment gaps (precedence:
|
|
* ambient environment, then the invoking directory's `.env`, then the personal one)
|
|
* and its `config.yaml` patches the booted tree. The workspace is the invoking
|
|
* directory: sessions, relative paths, and workspace instructions resolve from
|
|
* the cwd, so `dsh` acts on whatever project it is launched in. After boot, the
|
|
* agent's system prompt is told the path to this harness checkout so it can find
|
|
* its own source.
|
|
* @module @deepseek-ai/dsh/tui
|
|
*/
|
|
|
|
import { fileURLToPath } from 'node:url'
|
|
import {
|
|
addHarnessSourceSection,
|
|
boot,
|
|
installFailLoud,
|
|
loadEnv,
|
|
loadPersonalPatches,
|
|
resolveConfigPath,
|
|
} from '@deepseek-ai/dsh-app-boot'
|
|
import { resolveDshHome } from '@deepseek-ai/dsh-paths'
|
|
|
|
const NAME = 'dsh'
|
|
|
|
// The env var the shipped tui-agent config reads (`resumeSessionId: !!js
|
|
// process.env.RESUME_SESSION_ID`) to rehydrate a persisted session. The
|
|
// `--resume <id>` flag is CLI sugar that sets it before boot, so the printed
|
|
// `dsh --resume <id>` exit hint runs back through this same intake.
|
|
const RESUME_SESSION_ID_ENV = 'RESUME_SESSION_ID'
|
|
|
|
// Both the source tree (apps/cli/src) and the bundled bin (apps/cli/lib) sit
|
|
// one directory under apps/cli, so the shipped default config resolves with
|
|
// the same relative hop from either artifact.
|
|
const DEFAULT_CONFIG = fileURLToPath(new URL('../../../examples/tui-agent/cordis.yml', import.meta.url))
|
|
|
|
// The harness checkout root: three hops up from apps/cli/{src,lib}, resolved
|
|
// from this bin's location so it holds however `dsh` is launched (a PATH
|
|
// symlink, an arbitrary cwd). The agent is told where its own source lives.
|
|
const SOURCE_ROOT = fileURLToPath(new URL('../../..', import.meta.url))
|
|
|
|
/* v8 ignore start -- composition over the unit-tested dsh-app-boot helpers;
|
|
the tui-agent PTY smoke drives this path end to end, personal overlay included */
|
|
/**
|
|
* Run the interactive TUI from the invoking directory.
|
|
* @param config - a config path to boot instead of the shipped default, or
|
|
* `undefined` for the default; already parsed from the optional positional.
|
|
* @param resumeSessionId - a persisted session id to resume, or `undefined`;
|
|
* already parsed and non-empty-validated from `--resume`.
|
|
*/
|
|
export async function runTui(config: string | undefined, resumeSessionId: string | undefined): Promise<void> {
|
|
// Refuse pipes BEFORE booting: a compose-time throw inside the Loader tree
|
|
// is logged per-entry rather than rethrown, so a piped launch would
|
|
// otherwise settle into an idle UI-less process instead of exiting nonzero.
|
|
if (!process.stdin.isTTY || !process.stdout.isTTY) {
|
|
process.stderr.write(`${NAME}: the TUI requires stdin and stdout to be interactive TTYs\n`)
|
|
process.exit(1)
|
|
}
|
|
installFailLoud(NAME)
|
|
// The bin already loaded the invoking directory's .env; the personal .env
|
|
// only fills what is still unset (process.loadEnvFile never overrides).
|
|
loadEnv(NAME, resolveDshHome())
|
|
// An explicit `--resume` flag beats any ambient RESUME_SESSION_ID, so set it
|
|
// after loadEnv and before boot reads it through the config's `!!js`.
|
|
if (resumeSessionId !== undefined) process.env[RESUME_SESSION_ID_ENV] = resumeSessionId
|
|
const ctx = await boot(NAME, resolveConfigPath(config ?? DEFAULT_CONFIG, undefined), loadPersonalPatches(NAME))
|
|
addHarnessSourceSection(ctx, SOURCE_ROOT)
|
|
}
|
|
/* v8 ignore stop */
|