mirror of
https://github.com/deepseek-ai/deepseek-harness
synced 2026-08-15 21:04:50 +00:00
ec601ca13d
Machine-produced by `pnpm run rescope-vendor --apply` plus the regeneration it prints: `pnpm install` for the lockfile, `pnpm run gen-third-party-notices`, `verify-translation-pairing --write` for the touched bilingual pairs, `gen-doc-graphs`, and one typert snapshot whose ids embed character offsets. `pnpm run rescope-vendor --check` verifies the result. Renames nine vendored packages (cordis, cosmokit, schemastery and the six @cordisjs plugins) and every reference that resolves them: manifest names and dependency keys, module specifiers including declare-module merges, cordis.yml plugin names, tsconfig paths, every Markdown fence, and `docs/` prose. Directory names, upstream versions, and dependency ranges are unchanged, so vendor/README.md still reads as an upstream snapshot; its manifest table gains an upstream-name column so THIRD_PARTY_NOTICES keeps MIT attribution pointed at each fork's origin. The tutorial tier follows the rename end to end: its yaml fences named plugins the Loader can no longer resolve, its `ts ignore-check` fences disagreed with the compiled fences beside them, and its prose quoted both. The contracts that told readers to keep upstream names — the root convention and the vendoring cookbook's tree comment and manifest invariant — now say to rescope instead. Two rules read `@deepseek-ai/` as "another workspace plugin": the client bundle purity gate now names the vendored libraries a browser bundle inlines, and the files where a bare `cordis` is an agent-preset id keep that product data.
82 lines
3.2 KiB
TypeScript
82 lines
3.2 KiB
TypeScript
/** Validated configuration for the local PTY backend. */
|
|
|
|
import z from '@deepseek-ai/schemastery'
|
|
|
|
/** Public plugin configuration. */
|
|
export interface Config {
|
|
/** Backend registry type (default: `shell`). */
|
|
backendType?: string
|
|
/** Interactive shell executable (default: `/bin/bash`). */
|
|
shellPath?: string
|
|
/** Shell arguments (default: `--noprofile --norc -i`). */
|
|
shellArgs?: string[]
|
|
/** Terminal rows. */
|
|
rows?: number
|
|
/** Terminal columns. */
|
|
cols?: number
|
|
/** Maximum retained logical lines. */
|
|
scrollbackLines?: number
|
|
/** Maximum retained UTF-8 bytes. */
|
|
scrollbackMaxBytes?: number
|
|
/** Maximum bytes returned by one read or settled viewport. */
|
|
maxReadBytes?: number
|
|
/** Readiness polling interval. */
|
|
pollIntervalMs?: number
|
|
/** Delay before Linux exact syscall probes. */
|
|
exactProbeAfterMs?: number
|
|
/** Silence duration that yields `inferred_idle`. */
|
|
idleSilenceMs?: number
|
|
/**
|
|
* Extra wait beyond `idleSilenceMs`, once a prompt marker was seen, for the shell to
|
|
* regain the foreground before `inferred_idle` settles; at least one `pollIntervalMs`.
|
|
*/
|
|
handoffGraceMs?: number
|
|
/** Absolute send wait bound. */
|
|
timeoutMs?: number
|
|
/** Grace before teardown escalates to `SIGKILL`. */
|
|
disposeGraceMs?: number
|
|
}
|
|
|
|
/** Configuration after Schemastery defaults. */
|
|
export type ResolvedConfig = Required<Config>
|
|
|
|
/** Schemastery config exposed by the plugin. */
|
|
export const Config: z<Config> = z.object({
|
|
backendType: z.string().default('shell'),
|
|
shellPath: z.string().default('/bin/bash'),
|
|
shellArgs: z.array(z.string()).default(['--noprofile', '--norc', '-i']),
|
|
rows: z.number().default(40),
|
|
cols: z.number().default(160),
|
|
scrollbackLines: z.number().default(10_000),
|
|
scrollbackMaxBytes: z.number().default(4 * 1024 * 1024),
|
|
maxReadBytes: z.number().default(256 * 1024),
|
|
pollIntervalMs: z.number().default(50),
|
|
exactProbeAfterMs: z.number().default(150),
|
|
idleSilenceMs: z.number().default(3_000),
|
|
handoffGraceMs: z.number().default(500),
|
|
timeoutMs: z.number().default(30_000),
|
|
disposeGraceMs: z.number().default(3_000),
|
|
})
|
|
|
|
/**
|
|
* Assert every numeric config field is a positive safe integer and bounds compose.
|
|
* @param config - Schemastery-resolved plugin configuration.
|
|
* @returns Narrows the input to the fully resolved configuration.
|
|
*/
|
|
export function validateConfig(config: Config): asserts config is ResolvedConfig {
|
|
const resolved = config as ResolvedConfig
|
|
if (resolved.backendType.length === 0) throw new Error('pty-local: backendType must be non-empty')
|
|
if (resolved.shellPath.length === 0) throw new Error('pty-local: shellPath must be non-empty')
|
|
for (const [name, value] of Object.entries(resolved)) {
|
|
if (typeof value === 'number' && (!Number.isSafeInteger(value) || value <= 0)) {
|
|
throw new Error(`pty-local: ${name} must be a positive safe integer`)
|
|
}
|
|
}
|
|
if (resolved.maxReadBytes > resolved.scrollbackMaxBytes) {
|
|
throw new Error('pty-local: maxReadBytes must not exceed scrollbackMaxBytes')
|
|
}
|
|
if (resolved.handoffGraceMs < resolved.pollIntervalMs) {
|
|
throw new Error('pty-local: handoffGraceMs must be at least pollIntervalMs so one readiness poll runs inside the grace window')
|
|
}
|
|
}
|