mirror of
https://github.com/deepseek-ai/deepseek-harness.git
synced 2026-08-29 04:26:38 +00:00
Tianyi Cui
8dc3b0380e
Add a startup-only sdk-minimal template whose sole bundle inserts the complete JSON-RPC agent tree over the empty profile root. The roster is an explicit composition allowlist: it contains one DeepSeek adapter, the minimal agent spine, persistent Bash, the string-replace editor, local execution, and JSONL persistence, while dsh-base and Web remain absent. Reuse the SDK app startup provider so the new profile retains help, stdin EOF, and bounded launcher shutdown semantics. Make that provider render its configured profile name, which keeps both sdk and sdk-minimal help truthful without duplicating process lifecycle code. Register the package in the CLI closure, TypeScript graph, lockfile, Knip policy, and bilingual bundle references. Exact manifest, row-roster, profile-template, config-dump, and HMR tests make later additions visible instead of relying on a blacklist.
63 lines
2.1 KiB
TypeScript
63 lines
2.1 KiB
TypeScript
/**
|
|
* The SDK profile's command-line and stdin-lifetime provider. A successful
|
|
* parse publishes {@link SDK_APP_STARTUP_SERVICE}; the JSON-RPC server waits
|
|
* for that service, so help starts no transport.
|
|
* @module @deepseek-ai/dsh-sdk-app
|
|
*/
|
|
|
|
import { Command } from 'commander'
|
|
import type { Context } from '@deepseek-ai/cordis'
|
|
import z from '@deepseek-ai/schemastery'
|
|
import { exitOnStdinEnd, parseCmdline } from '@deepseek-ai/dsh-cmdline'
|
|
|
|
/** Stable Cordis plugin name. */
|
|
export const name = 'sdk-app-startup'
|
|
|
|
/** Launcher service required before this app can parse its invocation. */
|
|
export const inject = ['cmdlineArgs']
|
|
|
|
/** Service the JSON-RPC server row waits for before claiming stdio. */
|
|
export const SDK_APP_STARTUP_SERVICE = 'sdkAppStartup'
|
|
|
|
/** SDK stdio startup configuration. */
|
|
export interface Config {
|
|
/** Profile name rendered in help and diagnostics (default `sdk`). */
|
|
profile?: string
|
|
}
|
|
|
|
/** Validate and default SDK stdio startup configuration. */
|
|
export const Config: z<Config> = z.object({
|
|
profile: z.string().default('sdk'),
|
|
})
|
|
|
|
/**
|
|
* Build this app's zero-option command and help.
|
|
* @param profile - selected profile name rendered in the command grammar.
|
|
* @returns a fresh program for one invocation.
|
|
*/
|
|
function sdkCommand(profile: string): Command {
|
|
return new Command()
|
|
.name(`dsh --profile ${profile}`)
|
|
.description('Serve DeepSeek Harness SDK clients over stdio JSON-RPC.')
|
|
.helpOption('-h, --help', 'show this help')
|
|
.addHelpText('after', `
|
|
Example:
|
|
dsh --profile ${profile} serve one SDK runtime until its client disconnects
|
|
`)
|
|
}
|
|
|
|
/**
|
|
* Accept an SDK profile invocation, publish readiness, and bind EOF to the
|
|
* launcher's bounded shutdown.
|
|
* @param ctx - plugin context carrying command-line and exit launcher values.
|
|
* @param config - selected profile identity for command help.
|
|
*/
|
|
export function apply(ctx: Context, config: Config = {}): void {
|
|
const program = sdkCommand(config.profile ?? 'sdk')
|
|
program.action(() => {
|
|
exitOnStdinEnd(ctx, 'sdk-app.stdin')
|
|
ctx.provide(SDK_APP_STARTUP_SERVICE, { accepted: true })
|
|
})
|
|
parseCmdline(ctx, program)
|
|
}
|