@kvman/kvcoder 0.1.0

package/dist/calls/connector-help.js

@@ -0,0 +1,73 @@
+import { z } from '@kvman/sdk';
+import { builtinConnectors, noCommandMessage } from "../connector-call.js";
+import { notFound } from "../problems.js";
+import { callInfos } from "../registry/loaded.js";
+import { activeConnectors } from "../registry/register-connectors.js";
+import { truncate } from "../result-text.js";
+import { binaryExec } from "../connectors/binary.js";
+import { builtinDescriptions, commandsOf } from "../connectors/builtin-connectors.js";
+import { payloadJsonSchema } from "../connectors/connector-command.js";
+import { commandHelp, connectorHelp } from "./help-text.js";
+import { runShell } from "./run-shell.js";
+import { shellFor } from "./shell-program.js";
+// `help` of any connector (plan 08 §8.3 and §8.4, ADR 0011, 4 and 5): the connector's commands, or one command's
+// payload, result, and examples. A binary connector's help also prints the program's own.
+const asksNote = 'The person is asked before this runs.';
+const programHelpTimeoutMs = 5_000;
+const builtinDetail = (name, command) => ({ name, description: command.description, notes: command.notes, payload: payloadJsonSchema(command.payload), result: command.result ?? {}, examples: [] });
+// A built-in command's result is what its table entry says, or the output schema its registration has.
+async function builtinHelp(ctx, connector, command) {
+    const commands = commandsOf(connector);
+    if (command === undefined)
+        return connectorHelp(connector, builtinDescriptions((await shellFor(ctx)).kind)[connector], Object.entries(commands).map(([name, entry]) => ({ name, description: entry.description })));
+    const found = commands[command];
+    if (found === undefined)
+        throw notFound(noCommandMessage(connector, command, Object.keys(commands)), { connector, command });
+    const result = found.result ?? (await callInfos(ctx)).find((info) => info.name === found.registration)?.output ?? {};
+    return commandHelp(connector, { ...builtinDetail(command, found), result });
+}
+async function commandsHelp(ctx, connector, command) {
+    const infos = await callInfos(ctx);
+    const commands = connector.commands ?? [];
+    const info = (name) => infos.find((candidate) => candidate.name === name);
+    if (command === undefined)
+        return connectorHelp(connector.name, connector.description, commands.map((entry) => ({ name: entry.name, description: info(entry.command)?.description ?? '' })));
+    const found = commands.find((entry) => entry.name === command);
+    if (found === undefined)
+        throw notFound(noCommandMessage(connector.name, command, commands.map((entry) => entry.name)), { connector: connector.name, command });
+    const registered = info(found.command);
+    return commandHelp(connector.name, { name: found.name, description: registered?.description ?? '', notes: found.asks ? asksNote : undefined, payload: registered?.input ?? {}, result: registered?.output ?? {}, examples: found.examples });
+}
+// The line that prints a program's help: `<name> [command] --help`, or the registered line with `{command}` filled in.
+function programHelpLine(connector, command) {
+    const template = connector.binary?.help ?? `${connector.name} {command} --help`;
+    return template.replaceAll('{command}', command ?? '').replace(/ {2,}/g, ' ').trim();
+}
+async function binaryHelp(ctx, connector, command) {
+    if (command === 'exec')
+        return commandHelp(connector.name, builtinDetail('exec', binaryExec));
+    const line = programHelpLine(connector, command);
+    const run = await runShell(await shellFor(ctx), line, ctx.job.workspace.path, programHelpTimeoutMs, ctx.job.signal);
+    const program = `${line}:\n${truncate(run.output).replace(/[\r\n]+$/, '')}`;
+    if (command !== undefined)
+        return program;
+    return `${connectorHelp(connector.name, connector.description, [{ name: 'exec', description: binaryExec.description }])}\n\n${program}`;
+}
+async function helpText(ctx, name, command) {
+    const builtin = builtinConnectors.find((candidate) => candidate === name);
+    if (builtin !== undefined)
+        return builtinHelp(ctx, builtin, command);
+    const connector = (await activeConnectors(ctx)).find((candidate) => candidate.name === name);
+    if (connector === undefined)
+        throw notFound(`There is no connector ${name}.`, { connector: name });
+    return connector.kind === 'binary' ? binaryHelp(ctx, connector, command) : commandsHelp(ctx, connector, command);
+}
+export function registerConnectorHelp(ctx) {
+    ctx.registerQuery('kvcoder.connector.help.get', {
+        description: "Gives a connector's help: its commands, or one command's payload, result, and examples.",
+        input: z.strictObject({ connector: z.string().min(1).describe('The connector to describe.'), command: z.string().min(1).describe('The one command to describe; the whole connector when left out.').exactOptional() }),
+        output: z.object({ text: z.string() }),
+        handle: async ({ connector, command }) => ({ text: await helpText(ctx, connector, command) }),
+    });
+}
+//# sourceMappingURL=connector-help.js.map

package/dist/calls/connector-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-help.js","sourceRoot":"","sources":["../../src/calls/connector-help.ts"],"names":[],"mappings":"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"}

package/dist/calls/help-text.d.ts

@@ -0,0 +1,19 @@
+import type { Json } from '@kvman/sdk';
+export type HelpCommand = {
+    name: string;
+    description: string;
+};
+export type HelpDetail = HelpCommand & {
+    notes?: string | undefined;
+    payload: Json;
+    result: Json | string;
+    examples: readonly {
+        description: string;
+        input: Json;
+    }[];
+};
+/** A connector's own help: what it is for, and each command with its description. */
+export declare function connectorHelp(name: string, description: string, commands: readonly HelpCommand[]): string;
+/** One command's help: its payload and result, and its examples as `run` arguments. */
+export declare function commandHelp(connector: string, command: HelpDetail): string;
+//# sourceMappingURL=help-text.d.ts.map

package/dist/calls/help-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.d.ts","sourceRoot":"","sources":["../../src/calls/help-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhE,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE,EAAE,CAAA;CAAE,CAAC;AAIvK,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAWzG;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAK1E"}

package/dist/calls/help-text.js

@@ -0,0 +1,22 @@
+const helpCommand = { name: 'help', description: 'Describes this connector, or one command with { "command": "<name>" }.' };
+/** A connector's own help: what it is for, and each command with its description. */
+export function connectorHelp(name, description, commands) {
+    const listed = [...commands, helpCommand];
+    const width = Math.max(...listed.map((command) => command.name.length));
+    return [
+        `${name}: ${description}`,
+        '',
+        'Commands:',
+        ...listed.map((command) => `  ${command.name.padEnd(width)}  ${command.description}`),
+        '',
+        'Call help with { "command": "<name>" } for a command\'s payload, result, and examples.',
+    ].join('\n');
+}
+/** One command's help: its payload and result, and its examples as `run` arguments. */
+export function commandHelp(connector, command) {
+    const result = typeof command.result === 'string' ? [`Result: ${command.result}`] : ['Result (JSON Schema):', JSON.stringify(command.result, null, 2)];
+    const examples = command.examples.flatMap((example) => [`  # ${example.description}`, `  { "connector": ${JSON.stringify(connector)}, "command": ${JSON.stringify(command.name)}, "payload": ${JSON.stringify(example.input)} }`]);
+    const notes = command.notes === undefined ? [] : ['', command.notes];
+    return [`${connector} ${command.name}: ${command.description}`, ...notes, '', 'Payload (JSON Schema):', JSON.stringify(command.payload, null, 2), '', ...result, ...(examples.length > 0 ? ['', 'Examples:', ...examples] : [])].join('\n');
+}
+//# sourceMappingURL=help-text.js.map

package/dist/calls/help-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-text.js","sourceRoot":"","sources":["../../src/calls/help-text.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,wEAAwE,EAAE,CAAC;AAEzI,qFAAqF;AACrF,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAmB,EAAE,QAAgC;IAC/F,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACxE,OAAO;QACL,GAAG,IAAI,KAAK,WAAW,EAAE;QACzB,EAAE;QACF,WAAW;QACX,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;QACrF,EAAE;QACF,wFAAwF;KACzF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,OAAmB;IAChE,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACvJ,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,WAAW,EAAE,EAAE,oBAAoB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACnO,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9O,CAAC"}

package/dist/calls/line-run.d.ts

@@ -0,0 +1,33 @@
+import { z, type Ctx } from '@kvman/sdk';
+export declare const lineRunSchema: z.ZodObject<{
+    output: z.ZodString;
+    exitCode: z.ZodNullable<z.ZodNumber>;
+    signal: z.ZodNullable<z.ZodString>;
+    timedOut: z.ZodBoolean;
+    leftoverStopped: z.ZodBoolean;
+    durationMs: z.ZodNumber;
+    timeoutMs: z.ZodNumber;
+    jobId: z.ZodNullable<z.ZodString>;
+    ended: z.ZodBoolean;
+}, z.core.$strip>;
+/** What a line's run gave: its output and exit code, or for a background run its id and how it stands. */
+export type LineRun = z.output<typeof lineRunSchema>;
+type LineOptions = {
+    background?: boolean | undefined;
+    timeoutMs?: number | undefined;
+};
+export declare function runLine(ctx: Ctx, call: {
+    sessionId: string;
+    description: string;
+}, line: string, options: LineOptions): Promise<LineRun>;
+/** What a line's run returns to the model (plan 08 §8.3, ADR 0012, 7). */
+export declare function lineRunText(run: LineRun): string;
+/** A run is an error when it exited non-zero, or was killed (ADR 0012, 7). */
+export declare function lineRunIsError(run: LineRun): boolean;
+/** The options of the jobs that run a line: it may run for the call's longest timeout, with room to report it. */
+export declare const lineRunOptions: {
+    retries: number;
+    timeoutMs: number;
+};
+export {};
+//# sourceMappingURL=line-run.d.ts.map

package/dist/calls/line-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-run.d.ts","sourceRoot":"","sources":["../../src/calls/line-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAUzC,eAAO,MAAM,aAAa;;;;;;;;;;iBAUxB,CAAC;AAEH,0GAA0G;AAC1G,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AAErD,KAAK,WAAW,GAAG;IAAE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAExF,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAO9I;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAahD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGpD;AAED,kHAAkH;AAClH,eAAO,MAAM,cAAc;;;CAAqC,CAAC"}

package/dist/calls/line-run.js

@@ -0,0 +1,56 @@
+import { z } from '@kvman/sdk';
+import { startProcess } from "../jobs/process-run.js";
+import { resultLines } from "../result-text.js";
+import { runShell } from "./run-shell.js";
+import { callTimeout } from "./shell-command.js";
+import { shellFor } from "./shell-program.js";
+// One line in the real shell, in the workspace folder (plan 08 §8.3): what `shell exec` and a binary connector's `exec`
+// both do. It waits for the line, or with `background` starts it in the kernel's process service and returns its id.
+export const lineRunSchema = z.object({
+    output: z.string(),
+    exitCode: z.number().int().nullable(),
+    signal: z.string().nullable(),
+    timedOut: z.boolean(),
+    leftoverStopped: z.boolean(),
+    durationMs: z.number(),
+    timeoutMs: z.number().int(),
+    jobId: z.string().nullable(),
+    ended: z.boolean(),
+});
+export async function runLine(ctx, call, line, options) {
+    const shell = await shellFor(ctx);
+    const timeoutMs = callTimeout(options.timeoutMs);
+    if (options.background !== true)
+        return { ...(await runShell(shell, line, ctx.job.workspace.path, timeoutMs, ctx.job.signal)), signal: null, timeoutMs, jobId: null, ended: true };
+    const started = Date.now();
+    const run = await startProcess(ctx, call.sessionId, shell, { title: call.description, line });
+    return { output: run.output, exitCode: run.exitCode, signal: run.signal, timedOut: false, leftoverStopped: false, durationMs: Date.now() - started, timeoutMs, jobId: run.jobId, ended: run.ended };
+}
+/** What a line's run returns to the model (plan 08 §8.3, ADR 0012, 7). */
+export function lineRunText(run) {
+    if (run.jobId !== null) {
+        const output = run.output.replace(/[\r\n]+$/, '');
+        const lines = output === '' ? [`started ${run.jobId}`] : [`started ${run.jobId}`, output];
+        if (!run.ended)
+            return [...lines, '[running]'].join('\n');
+        if (run.exitCode !== null)
+            return [...lines, '[the process has already ended]', `[exit code ${run.exitCode}]`].join('\n');
+        if (run.signal !== null)
+            return [...lines, '[the process has already ended]', `[killed by ${run.signal}]`].join('\n');
+        return [...lines, '[the process has already ended]'].join('\n');
+    }
+    const timedOut = run.timedOut ? [`[timed out after ${Math.round(run.timeoutMs / 1000)} s; the process tree was killed]`] : [];
+    const leftover = !run.timedOut && run.leftoverStopped ? ['[background processes were stopped when the command ended; set background to true to keep one running]'] : [];
+    if (run.exitCode === null)
+        throw new Error('A foreground run always has an exit code.');
+    return resultLines(run.output, run.exitCode, [...timedOut, ...leftover]);
+}
+/** A run is an error when it exited non-zero, or was killed (ADR 0012, 7). */
+export function lineRunIsError(run) {
+    if (run.signal !== null)
+        return true;
+    return run.exitCode !== null && run.exitCode !== 0;
+}
+/** The options of the jobs that run a line: it may run for the call's longest timeout, with room to report it. */
+export const lineRunOptions = { retries: 0, timeoutMs: 660_000 };
+//# sourceMappingURL=line-run.js.map

package/dist/calls/line-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-run.js","sourceRoot":"","sources":["../../src/calls/line-run.ts"],"names":[],"mappings":"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"}

package/dist/calls/run-shell.d.ts

@@ -0,0 +1,12 @@
+import { type ShellCommand } from './shell-command.ts';
+export type ShellRun = {
+    output: string;
+    exitCode: number;
+    timedOut: boolean;
+    leftoverStopped: boolean;
+    durationMs: number;
+};
+/** Kills a process and everything it started: its group on Linux and macOS, `taskkill /T /F` on Windows. */
+export declare function killTree(pid: number | undefined): void;
+export declare function runShell(shell: ShellCommand, line: string, cwd: string, timeoutMs: number, signal: AbortSignal): Promise<ShellRun>;
+//# sourceMappingURL=run-shell.d.ts.map

package/dist/calls/run-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-shell.d.ts","sourceRoot":"","sources":["../../src/calls/run-shell.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOjE,MAAM,MAAM,QAAQ,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,eAAe,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAgB7H,4GAA4G;AAC5G,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQtD;AAuBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqClI"}

package/dist/calls/run-shell.js

@@ -0,0 +1,88 @@
+import { spawn } from 'node:child_process';
+import { cutOutput, outputKept, outputLimit } from "../result-text.js";
+import { treeKill } from "./shell-command.js";
+/** How long output gets to drain once the shell has exited, for a process outside its group that still holds the pipe. */
+const drainMs = 1_000;
+// Whether the group had any process left to signal.
+function signalGroup(pid, signal) {
+    try {
+        process.kill(-pid, signal);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ESRCH')
+            return false;
+        throw error;
+    }
+}
+/** Kills a process and everything it started: its group on Linux and macOS, `taskkill /T /F` on Windows. */
+export function killTree(pid) {
+    if (pid === undefined)
+        return;
+    const kill = treeKill(process.platform, pid);
+    if (kill.kind === 'taskkill') {
+        spawn(kill.program, kill.args, { stdio: 'ignore', windowsHide: true });
+        return;
+    }
+    signalGroup(kill.pid, 'SIGKILL');
+}
+// Once the shell has exited the group holds only what it left behind. Windows has no such group to find.
+function stopLeftover(pid) {
+    return pid !== undefined && process.platform !== 'win32' && signalGroup(pid, 'SIGKILL');
+}
+// Collects output, keeping everything up to the limit, then only the head and a rolling tail.
+function outputCollector() {
+    let all = Buffer.alloc(0);
+    let tail = Buffer.alloc(0);
+    let total = 0;
+    return {
+        add: (chunk) => {
+            total += chunk.length;
+            if (all.length <= outputLimit)
+                all = Buffer.concat([all, chunk]);
+            tail = Buffer.concat([tail, chunk]);
+            if (tail.length > outputKept)
+                tail = tail.subarray(tail.length - outputKept);
+        },
+        text: () => (total <= outputLimit ? all.toString('utf8') : cutOutput(all.subarray(0, outputKept), total - 2 * outputKept, tail)),
+    };
+}
+export function runShell(shell, line, cwd, timeoutMs, signal) {
+    const started = Date.now();
+    return new Promise((resolve, reject) => {
+        const child = spawn(shell.program, shell.args(line), { cwd, stdio: ['ignore', 'pipe', 'pipe'], detached: process.platform !== 'win32', windowsHide: true });
+        const output = outputCollector();
+        let timedOut = false;
+        let leftoverStopped = false;
+        let drain;
+        child.stdout.on('data', output.add);
+        child.stderr.on('data', output.add);
+        const timer = setTimeout(() => {
+            timedOut = true;
+            killTree(child.pid);
+        }, timeoutMs);
+        const abort = () => killTree(child.pid);
+        signal.addEventListener('abort', abort, { once: true });
+        const settle = () => {
+            clearTimeout(timer);
+            clearTimeout(drain);
+            signal.removeEventListener('abort', abort);
+        };
+        child.once('error', (error) => {
+            settle();
+            reject(error);
+        });
+        child.once('exit', () => {
+            leftoverStopped = !timedOut && !signal.aborted && stopLeftover(child.pid);
+            drain = setTimeout(() => {
+                child.stdout.destroy();
+                child.stderr.destroy();
+            }, drainMs);
+        });
+        child.once('close', (code, killedBy) => {
+            settle();
+            resolve({ output: output.text(), exitCode: timedOut ? 124 : (code ?? (killedBy === null ? 1 : 137)), timedOut, leftoverStopped, durationMs: Date.now() - started });
+        });
+    });
+}
+//# sourceMappingURL=run-shell.js.map

package/dist/calls/run-shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-shell.js","sourceRoot":"","sources":["../../src/calls/run-shell.ts"],"names":[],"mappings":"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"}

package/dist/calls/run-tool.d.ts

@@ -0,0 +1,49 @@
+import { z } from '@kvman/sdk';
+import type { JsonValue } from '../connector-call.ts';
+export declare function runTool(connectors: readonly string[]): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            description: {
+                type: string;
+                description: string;
+            };
+            connector: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            command: {
+                type: string;
+                description: string;
+            };
+            payload: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+declare const argsSchema: z.ZodObject<{
+    description: z.ZodString;
+    connector: z.ZodString;
+    command: z.ZodString;
+    payload: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+}, z.core.$strict>;
+/** A call as the model made it: what it says to the person, and the connector command with its payload. */
+export type RunCall = z.output<typeof argsSchema>;
+export type ParsedRunArgs = {
+    success: true;
+    data: RunCall;
+} | {
+    success: false;
+    problems: string;
+};
+/** A call's arguments, or what is wrong with them and what each field must be. */
+export declare function parseRunArgs(raw: Record<string, JsonValue>): ParsedRunArgs;
+export {};
+//# sourceMappingURL=run-tool.d.ts.map

package/dist/calls/run-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.d.ts","sourceRoot":"","sources":["../../src/calls/run-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAOtD,wBAAgB,OAAO,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBpD;AAID,QAAA,MAAM,UAAU;;;;;kBAKd,CAAC;AAEH,2GAA2G;AAC3G,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC;AAqBlD,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpG,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,aAAa,CAU1E"}

package/dist/calls/run-tool.js

@@ -0,0 +1,66 @@
+import { z } from '@kvman/sdk';
+// The agent's one tool (plan 08 §8.2, ADR 0011, 1): `run { description, connector, command, payload }` runs one command
+// of a connector. The payload has no schema here: the model learns it from the prompt's connector index or the connector's `help`.
+const exampleCall = '{ "description": "Listing the project\'s source files", "connector": "fs", "command": "list", "payload": { "path": "src" } }';
+export function runTool(connectors) {
+    return {
+        name: 'run',
+        description: [
+            'Runs one command of a connector and returns its result. Connectors are the only way you act: the system prompt lists each one with its commands.',
+            '',
+            `For example, ${exampleCall}. Every connector has the command help: call it with an empty payload to see the connector's commands, or with { "command": "<name>" } to see one command's payload, before the first time you use a command whose payload the system prompt doesn't list.`,
+        ].join('\n'),
+        parameters: {
+            type: 'object',
+            properties: {
+                description: { type: 'string', description: 'One sentence saying what this call does, for a person who knows nothing about how you work ("Editing app.ts to add the save button"). Write it first.' },
+                connector: { type: 'string', enum: [...connectors], description: 'The connector to use.' },
+                command: { type: 'string', description: "One of the connector's commands, or help." },
+                payload: { type: 'object', description: "The command's input, as the system prompt or the connector's help gives it. Leave it out for a command that takes none." },
+            },
+            required: ['description', 'connector', 'command'],
+            additionalProperties: false,
+        },
+    };
+}
+const payloadSchema = z.record(z.string(), z.json());
+const argsSchema = z.strictObject({
+    description: z.string().trim().min(1),
+    connector: z.string().min(1),
+    command: z.string().min(1),
+    payload: payloadSchema.default({}),
+});
+// What each argument must be, as a failed call says it.
+const requirements = {
+    description: 'one sentence saying what this call does, for the person',
+    connector: "one of the session's connectors",
+    command: "one of the connector's commands, or help",
+    payload: "a JSON object: the command's input",
+};
+// A payload some models send as a JSON string is read as the object it holds.
+function withParsedPayload(raw) {
+    if (typeof raw['payload'] !== 'string')
+        return raw;
+    try {
+        return { ...raw, payload: z.json().parse(JSON.parse(raw['payload'])) };
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return raw;
+        throw error;
+    }
+}
+/** A call's arguments, or what is wrong with them and what each field must be. */
+export function parseRunArgs(raw) {
+    const parsed = argsSchema.safeParse(withParsedPayload(raw));
+    if (parsed.success)
+        return { success: true, data: parsed.data };
+    const problems = parsed.error.issues.map((issue) => {
+        const field = String(issue.path[0] ?? 'arguments');
+        const needed = requirements[field];
+        const message = field === 'payload' ? 'The payload must be a JSON object' : issue.message;
+        return `${issue.path.join('.') || 'arguments'}: ${message}${needed === undefined ? '' : ` (it must be ${needed})`}`;
+    });
+    return { success: false, problems: problems.join('; ') };
+}
+//# sourceMappingURL=run-tool.js.map

package/dist/calls/run-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.js","sourceRoot":"","sources":["../../src/calls/run-tool.ts"],"names":[],"mappings":"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"}

package/dist/calls/shell-command.d.ts

@@ -0,0 +1,25 @@
+export type Platform = NodeJS.Platform;
+/** How to start one shell call. */
+export type ShellCommand = {
+    program: string;
+    args: (command: string) => string[];
+    kind: 'bash' | 'powershell';
+};
+/** Whether a program is on the PATH (Windows looks for `<name>.exe`). */
+export declare function onPath(name: string, environment: NodeJS.ProcessEnv, platform: Platform): boolean;
+export declare function shellCommand(platform: Platform, configured: string | null, hasPwsh: () => boolean): ShellCommand;
+/** How to end a process tree: its group on Linux and macOS, `taskkill /T /F` on Windows. */
+export type TreeKill = {
+    kind: 'group';
+    pid: number;
+} | {
+    kind: 'taskkill';
+    program: 'taskkill';
+    args: string[];
+};
+export declare function treeKill(platform: Platform, pid: number): TreeKill;
+export declare const defaultTimeoutMs = 120000;
+export declare const maxTimeoutMs = 600000;
+/** A call's timeout: the default, or the model's, cut to 600 s (ADR 0009, 101). */
+export declare function callTimeout(requested: number | undefined): number;
+//# sourceMappingURL=shell-command.d.ts.map

package/dist/calls/shell-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-command.d.ts","sourceRoot":"","sources":["../../src/calls/shell-command.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AAEvC,mCAAmC;AACnC,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AASjH,yEAAyE;AACzE,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAIhG;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,YAAY,CAKhH;AAED,4FAA4F;AAC5F,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAElH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAElE;AAED,eAAO,MAAM,gBAAgB,SAAU,CAAC;AACxC,eAAO,MAAM,YAAY,SAAU,CAAC;AAEpC,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEjE"}

package/dist/calls/shell-command.js

@@ -0,0 +1,31 @@
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+const powershellArgs = (command) => ['-NoProfile', '-Command', command];
+const bashArgs = (command) => ['-lc', command];
+function isPowerShell(program) {
+    return /^(pwsh|powershell)(\.exe)?$/i.test(path.basename(program));
+}
+/** Whether a program is on the PATH (Windows looks for `<name>.exe`). */
+export function onPath(name, environment, platform) {
+    const folders = (environment['PATH'] ?? environment['Path'] ?? '').split(platform === 'win32' ? ';' : ':').filter((folder) => folder !== '');
+    const file = platform === 'win32' ? `${name}.exe` : name;
+    return folders.some((folder) => existsSync(path.join(folder, file)));
+}
+export function shellCommand(platform, configured, hasPwsh) {
+    const kind = platform === 'win32' ? 'powershell' : 'bash';
+    if (configured !== null)
+        return { program: configured, args: isPowerShell(configured) ? powershellArgs : bashArgs, kind };
+    if (platform !== 'win32')
+        return { program: 'bash', args: bashArgs, kind };
+    return { program: hasPwsh() ? 'pwsh' : 'powershell.exe', args: powershellArgs, kind };
+}
+export function treeKill(platform, pid) {
+    return platform === 'win32' ? { kind: 'taskkill', program: 'taskkill', args: ['/PID', String(pid), '/T', '/F'] } : { kind: 'group', pid };
+}
+export const defaultTimeoutMs = 120_000;
+export const maxTimeoutMs = 600_000;
+/** A call's timeout: the default, or the model's, cut to 600 s (ADR 0009, 101). */
+export function callTimeout(requested) {
+    return Math.min(requested ?? defaultTimeoutMs, maxTimeoutMs);
+}
+//# sourceMappingURL=shell-command.js.map

package/dist/calls/shell-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-command.js","sourceRoot":"","sources":["../../src/calls/shell-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAW7B,MAAM,cAAc,GAAG,CAAC,OAAe,EAAY,EAAE,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAC1F,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAY,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAEjE,SAAS,YAAY,CAAC,OAAe;IACnC,OAAO,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,WAA8B,EAAE,QAAkB;IACrF,MAAM,OAAO,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IAC7I,MAAM,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAkB,EAAE,UAAyB,EAAE,OAAsB;IAChG,MAAM,IAAI,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1D,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1H,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3E,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;AACxF,CAAC;AAKD,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,GAAW;IACtD,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AAC5I,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC;AAEpC,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,SAA6B;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,gBAAgB,EAAE,YAAY,CAAC,CAAC;AAC/D,CAAC"}

package/dist/calls/shell-program.d.ts

@@ -0,0 +1,5 @@
+import type { Ctx } from '@kvman/sdk';
+import { type ShellCommand } from './shell-command.ts';
+/** The shell this run uses: `kvcoder.shell.path`, or the one found for the OS (plan 08 §8.3). */
+export declare function shellFor(ctx: Ctx): Promise<ShellCommand>;
+//# sourceMappingURL=shell-program.d.ts.map

package/dist/calls/shell-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-program.d.ts","sourceRoot":"","sources":["../../src/calls/shell-program.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG7E,iGAAiG;AACjG,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAG9D"}

package/dist/calls/shell-program.js

@@ -0,0 +1,8 @@
+import { onPath, shellCommand } from "./shell-command.js";
+import { settingSchemas } from "../register-settings.js";
+/** The shell this run uses: `kvcoder.shell.path`, or the one found for the OS (plan 08 §8.3). */
+export async function shellFor(ctx) {
+    const configured = settingSchemas.shellPath.parse(await ctx.settings.get('kvcoder.shell.path'));
+    return shellCommand(process.platform, configured, () => onPath('pwsh', process.env, process.platform));
+}
+//# sourceMappingURL=shell-program.js.map

package/dist/calls/shell-program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-program.js","sourceRoot":"","sources":["../../src/calls/shell-program.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAQ;IACrC,MAAM,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAChG,OAAO,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzG,CAAC"}