subharness 0.0.1

package/dist/adapters/rpc.js

@@ -0,0 +1,101 @@
+import { spawn } from "node:child_process";
+import { AgentError } from "../errors.js";
+/** A bidirectional JSON-lines connection to an external native process. */
+export class NativeRpc {
+    process;
+    pending = new Map();
+    sequence = 0;
+    buffer = "";
+    failure;
+    exited;
+    onMessage = () => { };
+    onFailure = () => { };
+    constructor(command, args, cwd, env) {
+        this.process = spawn(command, args, { cwd, env, stdio: ["pipe", "pipe", "pipe"] });
+        this.process.stdout.setEncoding("utf8");
+        this.process.stdout.on("data", chunk => this.read(chunk));
+        this.process.stderr.resume(); // Native diagnostics can contain credentials; never forward them.
+        this.process.stdin.on("error", () => this.fail(new AgentError("HARNESS_FAILED", "Codex input connection closed.")));
+        this.process.on("error", () => this.fail(new AgentError("HARNESS_UNAVAILABLE", "Cannot start Codex. Install its native CLI and make codex available on PATH.")));
+        this.exited = new Promise(resolve => this.process.once("close", () => {
+            this.fail(new AgentError("HARNESS_FAILED", "Codex exited before the operation completed."));
+            resolve();
+        }));
+    }
+    request(method, params) {
+        if (this.failure)
+            return Promise.reject(this.failure);
+        const id = ++this.sequence;
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject, method });
+            this.send({ id, method, params });
+        });
+    }
+    send(message) {
+        if (this.failure)
+            throw this.failure;
+        this.process.stdin.write(`${JSON.stringify(message)}\n`);
+    }
+    abort(error) {
+        this.fail(error);
+        void this.close();
+    }
+    async close() {
+        if (this.process.exitCode !== null || this.process.signalCode !== null)
+            return this.exited;
+        this.process.kill("SIGTERM");
+        const timer = setTimeout(() => this.process.kill("SIGKILL"), 2_000);
+        timer.unref();
+        await this.exited;
+        clearTimeout(timer);
+    }
+    read(chunk) {
+        this.buffer += chunk;
+        if (this.buffer.length > 16 * 1024 * 1024)
+            return this.invalid();
+        let newline;
+        while ((newline = this.buffer.indexOf("\n")) >= 0) {
+            const line = this.buffer.slice(0, newline);
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line.trim())
+                continue;
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                return this.invalid();
+            }
+            if (!message || typeof message !== "object" || Array.isArray(message))
+                return this.invalid();
+            if (message.method)
+                this.onMessage(message);
+            else if (typeof message.id === "number") {
+                const pending = this.pending.get(message.id);
+                if (!pending)
+                    continue;
+                this.pending.delete(message.id);
+                if (message.error) {
+                    const unsupported = pending.method === "turn/steer" && message.error.code === -32601;
+                    pending.reject(new AgentError(unsupported ? "UNSUPPORTED_DELIVERY" : "NATIVE_ERROR", unsupported ? "This Codex version does not support native steering." : `Codex rejected ${pending.method}. Check the native harness configuration.`));
+                }
+                else
+                    pending.resolve(message.result);
+            }
+        }
+    }
+    invalid() {
+        this.fail(new AgentError("PROTOCOL_ERROR", "Codex returned invalid protocol data."));
+        void this.close();
+    }
+    fail(error) {
+        if (this.failure)
+            return;
+        this.failure = error;
+        for (const pending of this.pending.values())
+            pending.reject(error);
+        this.pending.clear();
+        this.onFailure(error);
+    }
+}
+//# sourceMappingURL=rpc.js.map

package/dist/adapters/rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../../src/adapters/rpc.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { AgentError } from \"../errors.js\";\n\ntype Envelope = { id?: string | number; method?: string; params?: any; result?: any; error?: unknown };\ntype Pending = { resolve(value: any): void; reject(error: Error): void; method: string };\n\n/** A bidirectional JSON-lines connection to an external native process. */\nexport class NativeRpc {\n  private readonly process: ChildProcessWithoutNullStreams;\n  private readonly pending = new Map<number, Pending>();\n  private sequence = 0;\n  private buffer = \"\";\n  private failure?: AgentError;\n  private readonly exited: Promise<void>;\n  onMessage: (message: Envelope) => void = () => {};\n  onFailure: (error: AgentError) => void = () => {};\n\n  constructor(command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv) {\n    this.process = spawn(command, args, { cwd, env, stdio: [\"pipe\", \"pipe\", \"pipe\"] });\n    this.process.stdout.setEncoding(\"utf8\");\n    this.process.stdout.on(\"data\", chunk => this.read(chunk));\n    this.process.stderr.resume(); // Native diagnostics can contain credentials; never forward them.\n    this.process.stdin.on(\"error\", () => this.fail(new AgentError(\"HARNESS_FAILED\", \"Codex input connection closed.\")));\n    this.process.on(\"error\", () => this.fail(new AgentError(\"HARNESS_UNAVAILABLE\", \"Cannot start Codex. Install its native CLI and make codex available on PATH.\")));\n    this.exited = new Promise(resolve => this.process.once(\"close\", () => {\n      this.fail(new AgentError(\"HARNESS_FAILED\", \"Codex exited before the operation completed.\"));\n      resolve();\n    }));\n  }\n\n  request(method: string, params: unknown): Promise<any> {\n    if (this.failure) return Promise.reject(this.failure);\n    const id = ++this.sequence;\n    return new Promise((resolve, reject) => {\n      this.pending.set(id, { resolve, reject, method });\n      this.send({ id, method, params });\n    });\n  }\n\n  send(message: Envelope): void {\n    if (this.failure) throw this.failure;\n    this.process.stdin.write(`${JSON.stringify(message)}\\n`);\n  }\n\n  abort(error: AgentError): void {\n    this.fail(error);\n    void this.close();\n  }\n\n  async close(): Promise<void> {\n    if (this.process.exitCode !== null || this.process.signalCode !== null) return this.exited;\n    this.process.kill(\"SIGTERM\");\n    const timer = setTimeout(() => this.process.kill(\"SIGKILL\"), 2_000);\n    timer.unref();\n    await this.exited;\n    clearTimeout(timer);\n  }\n\n  private read(chunk: string): void {\n    this.buffer += chunk;\n    if (this.buffer.length > 16 * 1024 * 1024) return this.invalid();\n    let newline: number;\n    while ((newline = this.buffer.indexOf(\"\\n\")) >= 0) {\n      const line = this.buffer.slice(0, newline);\n      this.buffer = this.buffer.slice(newline + 1);\n      if (!line.trim()) continue;\n      let message: Envelope;\n      try { message = JSON.parse(line); } catch { return this.invalid(); }\n      if (!message || typeof message !== \"object\" || Array.isArray(message)) return this.invalid();\n      if (message.method) this.onMessage(message);\n      else if (typeof message.id === \"number\") {\n        const pending = this.pending.get(message.id);\n        if (!pending) continue;\n        this.pending.delete(message.id);\n        if (message.error) {\n          const unsupported = pending.method === \"turn/steer\" && (message.error as { code?: number }).code === -32601;\n          pending.reject(new AgentError(unsupported ? \"UNSUPPORTED_DELIVERY\" : \"NATIVE_ERROR\", unsupported ? \"This Codex version does not support native steering.\" : `Codex rejected ${pending.method}. Check the native harness configuration.`));\n        }\n        else pending.resolve(message.result);\n      }\n    }\n  }\n\n  private invalid(): void {\n    this.fail(new AgentError(\"PROTOCOL_ERROR\", \"Codex returned invalid protocol data.\"));\n    void this.close();\n  }\n\n  private fail(error: AgentError): void {\n    if (this.failure) return;\n    this.failure = error;\n    for (const pending of this.pending.values()) pending.reject(error);\n    this.pending.clear();\n    this.onFailure(error);\n  }\n}\n"]}

package/dist/adapters/types.d.ts

@@ -0,0 +1,28 @@
+import type { AgentDefinition, HarnessConfig } from "../sdk/types.js";
+export type HarnessRequest = HarnessConfig extends infer Config ? Config extends HarnessConfig ? Omit<Config, "model"> & {
+    readonly model?: Config["model"];
+} : never : never;
+export type ExecutionDefinition = Omit<AgentDefinition, "harness"> & {
+    readonly harness: HarnessRequest | readonly HarnessRequest[];
+};
+export type AccessType = "subscription" | "api-key" | "vercel-api-key" | "vercel-oidc";
+export interface ResolvedAccess {
+    type: AccessType;
+    token?: string;
+}
+export interface AdapterOptions {
+    agent: ExecutionDefinition;
+    harness: HarnessRequest;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    access: ResolvedAccess;
+}
+/** A native conversation. The external harness owns its reasoning and tool loop. */
+export interface NativeSession {
+    turn(prompt: string): Promise<string>;
+    steer(prompt: string): Promise<void>;
+    /** Resolves only once active execution has stopped. */
+    interrupt(): Promise<void>;
+    resume(): Promise<string>;
+    close(): Promise<void>;
+}

package/dist/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentDefinition, HarnessConfig } from \"../sdk/types.js\";\n\nexport type HarnessRequest = HarnessConfig extends infer Config\n  ? Config extends HarnessConfig\n    ? Omit<Config, \"model\"> & { readonly model?: Config[\"model\"] }\n    : never\n  : never;\n\nexport type ExecutionDefinition = Omit<AgentDefinition, \"harness\"> & {\n  readonly harness: HarnessRequest | readonly HarnessRequest[];\n};\n\nexport type AccessType = \"subscription\" | \"api-key\" | \"vercel-api-key\" | \"vercel-oidc\";\n\nexport interface ResolvedAccess {\n  type: AccessType;\n  token?: string;\n}\n\nexport interface AdapterOptions {\n  agent: ExecutionDefinition;\n  harness: HarnessRequest;\n  cwd: string;\n  env: NodeJS.ProcessEnv;\n  access: ResolvedAccess;\n}\n\n/** A native conversation. The external harness owns its reasoning and tool loop. */\nexport interface NativeSession {\n  turn(prompt: string): Promise<string>;\n  steer(prompt: string): Promise<void>;\n  /** Resolves only once active execution has stopped. */\n  interrupt(): Promise<void>;\n  resume(): Promise<string>;\n  close(): Promise<void>;\n}\n"]}

package/dist/cli/args.d.ts

@@ -0,0 +1,18 @@
+import { type PromptStream } from './input.js';
+export type Command = 'list' | 'run' | 'send' | 'wait' | 'status' | 'queue' | 'cancel' | 'resume' | 'help' | 'version';
+export interface Arguments {
+    command: Command;
+    id?: string;
+    cwd: string;
+    prompt?: string;
+    after?: string;
+    delivery: 'queue' | 'steer' | 'interrupt';
+    format: 'text' | 'jsonl';
+    full: boolean;
+    harness?: 'codex' | 'claudeCode' | 'fx';
+    model?: string;
+    effort?: string;
+}
+export declare function parseArgs(argv: string[], cwd?: string, dependencies?: {
+    stdin?: PromptStream;
+}): Promise<Arguments>;

package/dist/cli/args.js

@@ -0,0 +1,118 @@
+import { resolve } from 'node:path';
+import { AgentError } from '../errors.js';
+import { MAX_PROMPT_BYTES, readPromptInput } from './input.js';
+const options = {
+    list: ['cwd'], run: ['cwd', 'prompt', 'prompt-file', 'model', 'effort'], send: ['delivery', 'prompt', 'prompt-file'],
+    wait: ['after'], status: ['full'], queue: [], cancel: [], resume: [],
+};
+const directTargets = { codex: 'codex', claude: 'claudeCode', fx: 'fx' };
+const claudeEfforts = new Set(['low', 'medium', 'high', 'xhigh', 'max']);
+const fail = (message) => { throw new AgentError('INVALID_ARGUMENT', message); };
+export async function parseArgs(argv, cwd = process.cwd(), dependencies = {}) {
+    if (!argv.length)
+        return defaults('help', cwd);
+    if (argv[0] === '--help' || argv[0] === '--version') {
+        if (argv.length !== 1)
+            fail(`${argv[0]} cannot be combined with other options.`);
+        return defaults(argv[0] === '--help' ? 'help' : 'version', cwd);
+    }
+    const command = argv[0];
+    if (!Object.hasOwn(options, command))
+        fail(`Unknown command: ${command}. Use subharness --help.`);
+    const values = {};
+    const positionals = [];
+    let parseOptions = true;
+    for (let i = 1; i < argv.length; i++) {
+        const argument = argv[i];
+        if (parseOptions && argument === '--') {
+            parseOptions = false;
+            continue;
+        }
+        if (!parseOptions || !argument.startsWith('--')) {
+            positionals.push(argument);
+            continue;
+        }
+        const name = argument.slice(2);
+        if (name !== 'format' && name !== 'help' && !options[command].includes(name))
+            fail(`Unknown option: ${argument}`);
+        if (name in values)
+            fail(`Duplicate option: ${argument}`);
+        if (name === 'full' || name === 'help')
+            values[name] = true;
+        else {
+            const value = argv[++i];
+            if (value === undefined || (name !== 'prompt' && value.startsWith('--')))
+                fail(`Missing value for ${argument}`);
+            values[name] = value;
+        }
+    }
+    if (values.help === true) {
+        if (Object.keys(values).some(name => name !== 'help'))
+            fail('--help cannot be combined with other options.');
+        const target = command === 'run' && positionals[0] && Object.hasOwn(directTargets, positionals[0])
+            ? directTargets[positionals[0]] : undefined;
+        return { ...defaults('help', cwd), ...(target ? { id: positionals[0], harness: target } : {}) };
+    }
+    const promptCommand = command === 'run' || command === 'send';
+    const identifierCount = command === 'list' ? 0 : 1;
+    if (positionals.length < identifierCount)
+        fail(`Expected ${identifierCount ? 'one identifier' : 'no identifier'} for ${command}.`);
+    if (!promptCommand && positionals.length !== identifierCount)
+        fail(`Expected ${identifierCount ? 'one identifier' : 'no identifier'} for ${command}.`);
+    if (promptCommand && positionals.length > 2)
+        fail(`Expected one positional prompt for ${command}.`);
+    const format = values.format ?? 'text';
+    if (format !== 'text' && format !== 'jsonl')
+        fail('Format must be text or jsonl.');
+    const delivery = values.delivery ?? 'queue';
+    if (!['queue', 'steer', 'interrupt'].includes(String(delivery)))
+        fail('Delivery must be queue, steer, or interrupt.');
+    const result = { ...defaults(command, cwd), id: positionals[0], format, delivery,
+        cwd: resolve(cwd, String(values.cwd ?? '.')), full: values.full === true };
+    if (command === 'run') {
+        const direct = Object.hasOwn(directTargets, result.id)
+            ? directTargets[result.id] : undefined;
+        if (direct)
+            result.harness = direct;
+        if ('model' in values || 'effort' in values) {
+            if (!direct)
+                fail('--model and --effort are available only for direct harness targets.');
+            if ('model' in values && !String(values.model).trim())
+                fail('Model must contain text.');
+            if ('effort' in values && !String(values.effort).trim())
+                fail('Effort must contain text.');
+            if (direct === 'claudeCode' && 'effort' in values && !claudeEfforts.has(String(values.effort))) {
+                fail('Claude effort must be low, medium, high, xhigh, or max.');
+            }
+            if ('model' in values)
+                result.model = String(values.model);
+            if ('effort' in values)
+                result.effort = String(values.effort);
+        }
+    }
+    if (command === 'run' || command === 'send') {
+        const positionalPrompt = positionals[1];
+        if (Number(positionalPrompt !== undefined) + Number('prompt' in values) + Number('prompt-file' in values) !== 1) {
+            fail('Supply exactly one prompt source: one positional prompt, --prompt, or --prompt-file.');
+        }
+        if ('prompt-file' in values) {
+            result.prompt = await readPromptInput(String(values['prompt-file']), cwd, dependencies.stdin);
+        }
+        else
+            result.prompt = positionalPrompt ?? String(values.prompt);
+        if (!result.prompt?.trim())
+            fail('Prompt must contain text.');
+        if (Buffer.byteLength(result.prompt) > MAX_PROMPT_BYTES)
+            fail('Prompt exceeds 1 MiB.');
+    }
+    if (command === 'wait') {
+        if (!values.after)
+            fail('wait requires --after <response-id>.');
+        result.after = String(values.after);
+    }
+    return result;
+}
+function defaults(command, cwd) {
+    return { command, cwd, delivery: 'queue', format: 'text', full: false };
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from 'node:path';\nimport { AgentError } from '../errors.js';\nimport { MAX_PROMPT_BYTES, readPromptInput, type PromptStream } from './input.js';\n\nexport type Command = 'list' | 'run' | 'send' | 'wait' | 'status' | 'queue' | 'cancel' | 'resume' | 'help' | 'version';\nexport interface Arguments {\n  command: Command; id?: string; cwd: string; prompt?: string; after?: string;\n  delivery: 'queue' | 'steer' | 'interrupt'; format: 'text' | 'jsonl'; full: boolean;\n  harness?: 'codex' | 'claudeCode' | 'fx'; model?: string; effort?: string;\n}\nconst options: Record<string, string[]> = {\n  list: ['cwd'], run: ['cwd','prompt','prompt-file','model','effort'], send: ['delivery','prompt','prompt-file'],\n  wait: ['after'], status: ['full'], queue: [], cancel: [], resume: [],\n};\nconst directTargets = {codex:'codex',claude:'claudeCode',fx:'fx'} as const;\nconst claudeEfforts = new Set(['low','medium','high','xhigh','max']);\nconst fail = (message: string): never => { throw new AgentError('INVALID_ARGUMENT', message); };\n\nexport async function parseArgs(\n  argv: string[], cwd = process.cwd(), dependencies: {stdin?: PromptStream} = {},\n): Promise<Arguments> {\n  if (!argv.length) return defaults('help', cwd);\n  if (argv[0] === '--help' || argv[0] === '--version') {\n    if (argv.length !== 1) fail(`${argv[0]} cannot be combined with other options.`);\n    return defaults(argv[0] === '--help' ? 'help' : 'version', cwd);\n  }\n  const command = argv[0]!;\n  if (!Object.hasOwn(options, command)) fail(`Unknown command: ${command}. Use subharness --help.`);\n  const values: Record<string, string | boolean> = {};\n  const positionals: string[] = [];\n  let parseOptions = true;\n  for (let i = 1; i < argv.length; i++) {\n    const argument = argv[i]!;\n    if (parseOptions && argument === '--') { parseOptions = false; continue; }\n    if (!parseOptions || !argument.startsWith('--')) { positionals.push(argument); continue; }\n    const name = argument.slice(2);\n    if (name !== 'format' && name !== 'help' && !options[command]!.includes(name)) fail(`Unknown option: ${argument}`);\n    if (name in values) fail(`Duplicate option: ${argument}`);\n    if (name === 'full' || name === 'help') values[name] = true;\n    else {\n      const value = argv[++i];\n      if (value === undefined || (name !== 'prompt' && value.startsWith('--'))) fail(`Missing value for ${argument}`);\n      values[name] = value!;\n    }\n  }\n  if (values.help === true) {\n    if (Object.keys(values).some(name => name !== 'help')) fail('--help cannot be combined with other options.');\n    const target = command === 'run' && positionals[0] && Object.hasOwn(directTargets, positionals[0])\n      ? directTargets[positionals[0] as keyof typeof directTargets] : undefined;\n    return {...defaults('help', cwd), ...(target ? {id: positionals[0], harness: target} : {})};\n  }\n  const promptCommand = command === 'run' || command === 'send';\n  const identifierCount = command === 'list' ? 0 : 1;\n  if (positionals.length < identifierCount) fail(`Expected ${identifierCount ? 'one identifier' : 'no identifier'} for ${command}.`);\n  if (!promptCommand && positionals.length !== identifierCount) fail(`Expected ${identifierCount ? 'one identifier' : 'no identifier'} for ${command}.`);\n  if (promptCommand && positionals.length > 2) fail(`Expected one positional prompt for ${command}.`);\n  const format = values.format ?? 'text';\n  if (format !== 'text' && format !== 'jsonl') fail('Format must be text or jsonl.');\n  const delivery = values.delivery ?? 'queue';\n  if (!['queue','steer','interrupt'].includes(String(delivery))) fail('Delivery must be queue, steer, or interrupt.');\n  const result = {...defaults(command as Command, cwd), id: positionals[0], format, delivery,\n    cwd: resolve(cwd, String(values.cwd ?? '.')), full: values.full === true} as Arguments;\n  if (command === 'run') {\n    const direct = Object.hasOwn(directTargets, result.id!)\n      ? directTargets[result.id! as keyof typeof directTargets] : undefined;\n    if (direct) result.harness = direct;\n    if ('model' in values || 'effort' in values) {\n      if (!direct) fail('--model and --effort are available only for direct harness targets.');\n      if ('model' in values && !String(values.model).trim()) fail('Model must contain text.');\n      if ('effort' in values && !String(values.effort).trim()) fail('Effort must contain text.');\n      if (direct === 'claudeCode' && 'effort' in values && !claudeEfforts.has(String(values.effort))) {\n        fail('Claude effort must be low, medium, high, xhigh, or max.');\n      }\n      if ('model' in values) result.model = String(values.model);\n      if ('effort' in values) result.effort = String(values.effort);\n    }\n  }\n  if (command === 'run' || command === 'send') {\n    const positionalPrompt = positionals[1];\n    if (Number(positionalPrompt !== undefined) + Number('prompt' in values) + Number('prompt-file' in values) !== 1) {\n      fail('Supply exactly one prompt source: one positional prompt, --prompt, or --prompt-file.');\n    }\n    if ('prompt-file' in values) {\n      result.prompt = await readPromptInput(String(values['prompt-file']), cwd, dependencies.stdin);\n    } else result.prompt = positionalPrompt ?? String(values.prompt);\n    if (!result.prompt?.trim()) fail('Prompt must contain text.');\n    if (Buffer.byteLength(result.prompt!) > MAX_PROMPT_BYTES) fail('Prompt exceeds 1 MiB.');\n  }\n  if (command === 'wait') {\n    if (!values.after) fail('wait requires --after <response-id>.');\n    result.after = String(values.after);\n  }\n  return result;\n}\nfunction defaults(command: Command, cwd: string): Arguments {\n  return {command,cwd,delivery:'queue',format:'text',full:false};\n}\n"]}

package/dist/cli/catalog-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/catalog-worker.js

@@ -0,0 +1,22 @@
+import { discover, loadDefinition } from "../config/loader.js";
+import { errorInfo } from "../errors.js";
+process.on("disconnect", () => process.exit());
+process.once("message", async ({ cwd, parent, discover: shouldDiscover = true }) => {
+    let reply;
+    try {
+        const entries = shouldDiscover
+            ? (await discover(cwd)).map(({ id, name, description, scope, file }) => ({ id, name, description, scope, file }))
+            : [];
+        const definition = parent && 'file' in parent ? await loadDefinition(parent.file, parent.subagents) : undefined;
+        const children = Object.entries(definition?.subagents ?? {}).map(([name, child]) => ({ name, description: child.description }));
+        reply = { result: { entries, children } };
+    }
+    catch (error) {
+        reply = { error: errorInfo(error) };
+    }
+    // Wait until the caller receives the result, then end any timers created by trusted modules.
+    process.once("message", () => process.exit());
+    process.send?.(reply, (error) => { if (error)
+        process.exit(1); });
+});
+//# sourceMappingURL=catalog-worker.js.map

package/dist/cli/catalog-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-worker.js","sourceRoot":"","sources":["../../src/cli/catalog-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC/C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,EAAoE,EAAE,EAAE;IACnJ,IAAI,KAAmB,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,cAAc;YAC5B,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,UAAU,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChH,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAChI,KAAK,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,KAAK,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IAAC,CAAC;IACxD,6FAA6F;IAC7F,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAmB,EAAE,EAAE,GAAG,IAAI,KAAK;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC,CAAC,CAAC","sourcesContent":["import { discover, loadDefinition } from \"../config/loader.js\";\nimport { errorInfo } from \"../errors.js\";\nimport type { ExecutionReference } from \"../runtime/types.js\";\nimport type { CatalogReply } from \"./catalog.js\";\n\nprocess.on(\"disconnect\", () => process.exit());\nprocess.once(\"message\", async ({ cwd, parent, discover: shouldDiscover = true }: { cwd: string; parent?: ExecutionReference; discover?: boolean }) => {\n  let reply: CatalogReply;\n  try {\n    const entries = shouldDiscover\n      ? (await discover(cwd)).map(({ id, name, description, scope, file }) => ({ id, name, description, scope, file }))\n      : [];\n    const definition = parent && 'file' in parent ? await loadDefinition(parent.file, parent.subagents) : undefined;\n    const children = Object.entries(definition?.subagents ?? {}).map(([name, child]) => ({ name, description: child.description }));\n    reply = { result: { entries, children } };\n  } catch (error) { reply = { error: errorInfo(error) }; }\n  // Wait until the caller receives the result, then end any timers created by trusted modules.\n  process.once(\"message\", () => process.exit());\n  process.send?.(reply, (error: Error | null) => { if (error) process.exit(1); });\n});\n"]}

package/dist/cli/catalog.d.ts

@@ -0,0 +1,26 @@
+import { type ErrorInfo } from "../errors.js";
+import type { AgentReference, ExecutionReference } from "../runtime/types.js";
+export interface CatalogSnapshot {
+    entries: {
+        id: string;
+        name: string;
+        description: string;
+        scope: "repo" | "global";
+        file: string;
+    }[];
+    children: {
+        name: string;
+        description: string;
+    }[];
+}
+export type CatalogReply = {
+    result: CatalogSnapshot;
+    error?: never;
+} | {
+    result?: never;
+    error: ErrorInfo;
+};
+/** Definition modules run in their selected directory without sharing the CLI's output streams. */
+export declare function loadCatalog(cwd: string, parent?: ExecutionReference): Promise<CatalogSnapshot>;
+/** Declared-child lookup evaluates only the active parent's definition source. */
+export declare function loadDeclaredChildren(cwd: string, parent: AgentReference): Promise<CatalogSnapshot['children']>;

package/dist/cli/catalog.js

@@ -0,0 +1,41 @@
+import { fork } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { AgentError } from "../errors.js";
+/** Definition modules run in their selected directory without sharing the CLI's output streams. */
+export function loadCatalog(cwd, parent) {
+    return loadCatalogSnapshot(cwd, parent, true);
+}
+/** Declared-child lookup evaluates only the active parent's definition source. */
+export async function loadDeclaredChildren(cwd, parent) {
+    return (await loadCatalogSnapshot(cwd, parent, false)).children;
+}
+function loadCatalogSnapshot(cwd, parent, discover) {
+    return new Promise((resolve, reject) => {
+        const extension = import.meta.url.endsWith(".ts") ? "ts" : "js";
+        const child = fork(fileURLToPath(new URL(`./catalog-worker.${extension}`, import.meta.url)), [], {
+            cwd, env: process.env, stdio: ["ignore", "ignore", "ignore", "ipc"],
+            execArgv: extension === "ts" ? ["--import", import.meta.resolve("tsx")] : [],
+        });
+        let reply;
+        const failed = () => reject(new AgentError("INVALID_DEFINITION", "The agent catalog worker exited before returning its catalog."));
+        child.once("error", failed);
+        child.once("exit", () => {
+            if (!reply)
+                failed();
+            else if (reply.error)
+                reject(new AgentError(reply.error.code, reply.error.message));
+            else
+                resolve(reply.result);
+        });
+        child.once("message", (message) => {
+            reply = message;
+            child.send({ received: true }, (error) => { if (error)
+                child.kill(); });
+        });
+        child.send({ cwd, parent, discover }, (error) => { if (error) {
+            child.kill();
+            failed();
+        } });
+    });
+}
+//# sourceMappingURL=catalog.js.map

package/dist/cli/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/cli/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,UAAU,EAAkB,MAAM,cAAc,CAAC;AAS1D,mGAAmG;AACnG,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAA2B;IAClE,OAAO,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,MAAsB;IAC5E,OAAO,CAAC,MAAM,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAClE,CAAC;AAED,SAAS,mBAAmB,CAAC,GAAW,EAAE,MAAsC,EAAE,QAAiB;IACjG,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,oBAAoB,SAAS,EAAE,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YAC/F,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC;YACnE,QAAQ,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;SAC7E,CAAC,CAAC;QACH,IAAI,KAA+B,CAAC;QACpC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,oBAAoB,EAAE,+DAA+D,CAAC,CAAC,CAAC;QACnI,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,KAAK;gBAAE,MAAM,EAAE,CAAC;iBAChB,IAAI,KAAK,CAAC,KAAK;gBAAE,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;;gBAC/E,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,OAAqB,EAAE,EAAE;YAC9C,KAAK,GAAG,OAAO,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,KAAK,EAAE,CAAC;YAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAAC,MAAM,EAAE,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { fork } from \"node:child_process\";\nimport { fileURLToPath } from \"node:url\";\nimport { AgentError, type ErrorInfo } from \"../errors.js\";\nimport type { AgentReference, ExecutionReference } from \"../runtime/types.js\";\n\nexport interface CatalogSnapshot {\n  entries: { id: string; name: string; description: string; scope: \"repo\" | \"global\"; file: string }[];\n  children: { name: string; description: string }[];\n}\nexport type CatalogReply = { result: CatalogSnapshot; error?: never } | { result?: never; error: ErrorInfo };\n\n/** Definition modules run in their selected directory without sharing the CLI's output streams. */\nexport function loadCatalog(cwd: string, parent?: ExecutionReference): Promise<CatalogSnapshot> {\n  return loadCatalogSnapshot(cwd, parent, true);\n}\n\n/** Declared-child lookup evaluates only the active parent's definition source. */\nexport async function loadDeclaredChildren(cwd: string, parent: AgentReference): Promise<CatalogSnapshot['children']> {\n  return (await loadCatalogSnapshot(cwd, parent, false)).children;\n}\n\nfunction loadCatalogSnapshot(cwd: string, parent: ExecutionReference | undefined, discover: boolean): Promise<CatalogSnapshot> {\n  return new Promise((resolve, reject) => {\n    const extension = import.meta.url.endsWith(\".ts\") ? \"ts\" : \"js\";\n    const child = fork(fileURLToPath(new URL(`./catalog-worker.${extension}`, import.meta.url)), [], {\n      cwd, env: process.env, stdio: [\"ignore\", \"ignore\", \"ignore\", \"ipc\"],\n      execArgv: extension === \"ts\" ? [\"--import\", import.meta.resolve(\"tsx\")] : [],\n    });\n    let reply: CatalogReply | undefined;\n    const failed = () => reject(new AgentError(\"INVALID_DEFINITION\", \"The agent catalog worker exited before returning its catalog.\"));\n    child.once(\"error\", failed);\n    child.once(\"exit\", () => {\n      if (!reply) failed();\n      else if (reply.error) reject(new AgentError(reply.error.code, reply.error.message));\n      else resolve(reply.result);\n    });\n    child.once(\"message\", (message: CatalogReply) => {\n      reply = message;\n      child.send({ received: true }, (error) => { if (error) child.kill(); });\n    });\n    child.send({ cwd, parent, discover }, (error) => { if (error) { child.kill(); failed(); } });\n  });\n}\n"]}

package/dist/cli/help.d.ts

@@ -0,0 +1,3 @@
+type DirectHarness = 'codex' | 'claudeCode' | 'fx';
+export declare function renderHelp(harness?: DirectHarness): string;
+export {};

package/dist/cli/help.js

@@ -0,0 +1,68 @@
+const GLOBAL_HELP = `subharness — coordinate external coding agents
+
+Usage:
+  subharness list [--cwd <directory>]
+  subharness run <target> [options] <prompt>
+  subharness run <target> [options] --prompt <text>
+  subharness run <target> [options] --prompt-file <path|->
+  subharness send <session-id> [--delivery queue|steer|interrupt] <prompt>
+  subharness send <session-id> [--delivery queue|steer|interrupt] --prompt <text>
+  subharness send <session-id> [--delivery queue|steer|interrupt] --prompt-file <path|->
+  subharness wait <task-id> --after <response-id>
+  subharness status <task-id> [--full]
+  subharness queue <session-id>
+  subharness cancel <task-id>
+  subharness resume <session-id>
+
+Direct harness targets: codex, claude, fx. These bare names are reserved; same-named specialists require repo: or global:.
+Specialist targets: repo:<name>, global:<name>, or an unambiguous bare name.
+Declared child targets: subagent:<name>, resolved only from the active managed parent's declarations.
+Run "subharness run <harness> --help" for harness-specific options.
+Execution commands accept --format text|jsonl; text is the default.
+--help and --version do not start a coordinator or native harness.
+Use -- to pass a positional prompt beginning with a dash.
+agent is an identical compatibility alias for subharness.
+`;
+const details = {
+    codex: {
+        name: 'codex',
+        access: 'Requires an installed Codex executable and eligible configured access.',
+        effort: 'Codex accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',
+    },
+    claudeCode: {
+        name: 'claude',
+        access: 'Requires an installed Claude Code executable and eligible configured access.',
+        effort: 'Claude effort must be low, medium, high, xhigh, or max.',
+    },
+    fx: {
+        name: 'fx',
+        access: 'Requires an installed fx executable and configured Gateway access.',
+        effort: 'fx accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',
+    },
+};
+export function renderHelp(harness) {
+    if (!harness)
+        return GLOBAL_HELP;
+    const target = details[harness];
+    return `subharness run ${target.name} — start a direct ${target.name} session
+
+Usage:
+  subharness run ${target.name} [--cwd <directory>] [--model <model>] [--effort <effort>] <prompt>
+  subharness run ${target.name} [options] --prompt <text>
+  subharness run ${target.name} [options] --prompt-file <path|->
+
+Options:
+  --cwd <directory>       Execution directory for the new session
+  --model <model>         Native model identifier
+  --effort <effort>       Native effort identifier
+  --prompt <text>         Prompt text
+  --prompt-file <path|->  Read the prompt from a UTF-8 file or stdin
+  --format text|jsonl     Output format (text by default)
+
+Omitting --model or --effort uses the verifiable native default for the selected access route.
+${target.effort}
+${target.access}
+Native harness flags are not forwarded; unsupported options are errors.
+`;
+}
+//# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBnB,CAAC;AAEF,MAAM,OAAO,GAA0E;IACrF,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,MAAM,EAAE,wEAAwE;QAChF,MAAM,EAAE,mGAAmG;KAC5G;IACD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,8EAA8E;QACtF,MAAM,EAAE,yDAAyD;KAClE;IACD,EAAE,EAAE;QACF,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,oEAAoE;QAC5E,MAAM,EAAE,gGAAgG;KACzG;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,OAAuB;IAChD,IAAI,CAAC,OAAO;QAAE,OAAO,WAAW,CAAC;IACjC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,OAAO,kBAAkB,MAAM,CAAC,IAAI,qBAAqB,MAAM,CAAC,IAAI;;;mBAGnD,MAAM,CAAC,IAAI;mBACX,MAAM,CAAC,IAAI;mBACX,MAAM,CAAC,IAAI;;;;;;;;;;;EAW5B,MAAM,CAAC,MAAM;EACb,MAAM,CAAC,MAAM;;CAEd,CAAC;AACF,CAAC","sourcesContent":["type DirectHarness = 'codex' | 'claudeCode' | 'fx';\n\nconst GLOBAL_HELP = `subharness — coordinate external coding agents\n\nUsage:\n  subharness list [--cwd <directory>]\n  subharness run <target> [options] <prompt>\n  subharness run <target> [options] --prompt <text>\n  subharness run <target> [options] --prompt-file <path|->\n  subharness send <session-id> [--delivery queue|steer|interrupt] <prompt>\n  subharness send <session-id> [--delivery queue|steer|interrupt] --prompt <text>\n  subharness send <session-id> [--delivery queue|steer|interrupt] --prompt-file <path|->\n  subharness wait <task-id> --after <response-id>\n  subharness status <task-id> [--full]\n  subharness queue <session-id>\n  subharness cancel <task-id>\n  subharness resume <session-id>\n\nDirect harness targets: codex, claude, fx. These bare names are reserved; same-named specialists require repo: or global:.\nSpecialist targets: repo:<name>, global:<name>, or an unambiguous bare name.\nDeclared child targets: subagent:<name>, resolved only from the active managed parent's declarations.\nRun \"subharness run <harness> --help\" for harness-specific options.\nExecution commands accept --format text|jsonl; text is the default.\n--help and --version do not start a coordinator or native harness.\nUse -- to pass a positional prompt beginning with a dash.\nagent is an identical compatibility alias for subharness.\n`;\n\nconst details: Record<DirectHarness, {name: string; access: string; effort: string}> = {\n  codex: {\n    name: 'codex',\n    access: 'Requires an installed Codex executable and eligible configured access.',\n    effort: 'Codex accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',\n  },\n  claudeCode: {\n    name: 'claude',\n    access: 'Requires an installed Claude Code executable and eligible configured access.',\n    effort: 'Claude effort must be low, medium, high, xhigh, or max.',\n  },\n  fx: {\n    name: 'fx',\n    access: 'Requires an installed fx executable and configured Gateway access.',\n    effort: 'fx accepts a nonempty native effort identifier; model compatibility is checked by the adapter.',\n  },\n};\n\nexport function renderHelp(harness?: DirectHarness): string {\n  if (!harness) return GLOBAL_HELP;\n  const target = details[harness];\n  return `subharness run ${target.name} — start a direct ${target.name} session\n\nUsage:\n  subharness run ${target.name} [--cwd <directory>] [--model <model>] [--effort <effort>] <prompt>\n  subharness run ${target.name} [options] --prompt <text>\n  subharness run ${target.name} [options] --prompt-file <path|->\n\nOptions:\n  --cwd <directory>       Execution directory for the new session\n  --model <model>         Native model identifier\n  --effort <effort>       Native effort identifier\n  --prompt <text>         Prompt text\n  --prompt-file <path|->  Read the prompt from a UTF-8 file or stdin\n  --format text|jsonl     Output format (text by default)\n\nOmitting --model or --effort uses the verifiable native default for the selected access route.\n${target.effort}\n${target.access}\nNative harness flags are not forwarded; unsupported options are errors.\n`;\n}\n"]}

package/dist/cli/input.d.ts

@@ -0,0 +1,5 @@
+export declare const MAX_PROMPT_BYTES: number;
+export type PromptStream = AsyncIterable<Uint8Array | string> & {
+    isTTY?: boolean;
+};
+export declare function readPromptInput(source: string, cwd: string, stdin?: PromptStream): Promise<string>;

package/dist/cli/input.js

@@ -0,0 +1,69 @@
+import { open } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { AgentError } from '../errors.js';
+export const MAX_PROMPT_BYTES = 1024 * 1024;
+const invalid = (message) => { throw new AgentError('INVALID_ARGUMENT', message); };
+function decode(chunks, bytes, source) {
+    if (bytes > MAX_PROMPT_BYTES)
+        invalid('Prompt exceeds 1 MiB.');
+    try {
+        return new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks, bytes));
+    }
+    catch {
+        return invalid(`Cannot read UTF-8 prompt ${source}.`);
+    }
+}
+async function readStdin(stdin) {
+    if (stdin.isTTY)
+        invalid('Cannot read a prompt from interactive terminal stdin.');
+    const chunks = [];
+    let bytes = 0;
+    try {
+        for await (const value of stdin) {
+            const chunk = Buffer.from(value);
+            bytes += chunk.byteLength;
+            if (bytes > MAX_PROMPT_BYTES)
+                invalid('Prompt exceeds 1 MiB.');
+            chunks.push(chunk);
+        }
+    }
+    catch (error) {
+        if (error instanceof AgentError)
+            throw error;
+        invalid('Cannot read prompt from stdin.');
+    }
+    return decode(chunks, bytes, 'from stdin');
+}
+async function readFileBounded(path) {
+    let file;
+    try {
+        file = await open(path, 'r');
+        const chunks = [];
+        let bytes = 0;
+        while (true) {
+            const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, MAX_PROMPT_BYTES + 1 - bytes));
+            const { bytesRead } = await file.read(buffer, 0, buffer.byteLength, null);
+            if (!bytesRead)
+                return decode(chunks, bytes, `file: ${path}`);
+            bytes += bytesRead;
+            if (bytes > MAX_PROMPT_BYTES)
+                invalid('Prompt exceeds 1 MiB.');
+            chunks.push(buffer.subarray(0, bytesRead));
+        }
+    }
+    catch (error) {
+        if (error instanceof AgentError)
+            throw error;
+        return invalid(`Cannot read prompt file: ${path}`);
+    }
+    finally {
+        try {
+            await file?.close();
+        }
+        catch { }
+    }
+}
+export function readPromptInput(source, cwd, stdin = process.stdin) {
+    return source === '-' ? readStdin(stdin) : readFileBounded(resolve(cwd, source));
+}
+//# sourceMappingURL=input.js.map

package/dist/cli/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../src/cli/input.ts"],"names":[],"mappings":"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","sourcesContent":["import { open } from 'node:fs/promises';\nimport { resolve } from 'node:path';\nimport { AgentError } from '../errors.js';\n\nexport const MAX_PROMPT_BYTES = 1024 * 1024;\n\nexport type PromptStream = AsyncIterable<Uint8Array | string> & {isTTY?: boolean};\n\nconst invalid = (message: string): never => { throw new AgentError('INVALID_ARGUMENT', message); };\n\nfunction decode(chunks: Uint8Array[], bytes: number, source: string): string {\n  if (bytes > MAX_PROMPT_BYTES) invalid('Prompt exceeds 1 MiB.');\n  try {\n    return new TextDecoder('utf-8', {fatal: true}).decode(Buffer.concat(chunks, bytes));\n  } catch {\n    return invalid(`Cannot read UTF-8 prompt ${source}.`);\n  }\n}\n\nasync function readStdin(stdin: PromptStream): Promise<string> {\n  if (stdin.isTTY) invalid('Cannot read a prompt from interactive terminal stdin.');\n  const chunks: Uint8Array[] = [];\n  let bytes = 0;\n  try {\n    for await (const value of stdin) {\n      const chunk = Buffer.from(value);\n      bytes += chunk.byteLength;\n      if (bytes > MAX_PROMPT_BYTES) invalid('Prompt exceeds 1 MiB.');\n      chunks.push(chunk);\n    }\n  } catch (error) {\n    if (error instanceof AgentError) throw error;\n    invalid('Cannot read prompt from stdin.');\n  }\n  return decode(chunks, bytes, 'from stdin');\n}\n\nasync function readFileBounded(path: string): Promise<string> {\n  let file;\n  try {\n    file = await open(path, 'r');\n    const chunks: Uint8Array[] = [];\n    let bytes = 0;\n    while (true) {\n      const buffer = Buffer.allocUnsafe(Math.min(64 * 1024, MAX_PROMPT_BYTES + 1 - bytes));\n      const {bytesRead} = await file.read(buffer, 0, buffer.byteLength, null);\n      if (!bytesRead) return decode(chunks, bytes, `file: ${path}`);\n      bytes += bytesRead;\n      if (bytes > MAX_PROMPT_BYTES) invalid('Prompt exceeds 1 MiB.');\n      chunks.push(buffer.subarray(0, bytesRead));\n    }\n  } catch (error) {\n    if (error instanceof AgentError) throw error;\n    return invalid(`Cannot read prompt file: ${path}`);\n  } finally {\n    try { await file?.close(); } catch {}\n  }\n}\n\nexport function readPromptInput(source: string, cwd: string, stdin: PromptStream = process.stdin): Promise<string> {\n  return source === '-' ? readStdin(stdin) : readFileBounded(resolve(cwd, source));\n}\n"]}

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};