@kvman/kvcoder 0.1.0

package/dist/delegate/register-worker-run.js

@@ -0,0 +1,70 @@
+import { z } from '@kvman/sdk';
+import { records } from "../store/collections.js";
+import { endTurn } from "../turns/end-turn.js";
+import { checkCommand, runResult } from "./programs.js";
+import { programFound, runProgram } from "./run-program.js";
+import { finishRun } from "./runs.js";
+import { isProgram, listedWorker, listedWorkers, workerCheckName } from "./workers.js";
+// The job that runs a program worker, and the check of its program (plan 08 §8.5, ADR 0021, 11, 35, and 37). The job
+// is queued by a step or by an answer, never by a handler, so when the program exits it may hold the result and queue
+// the next step, as a subagent's last step does for its parent.
+/** The run's job may last for the longest time limit, with room to report it. */
+const runOptions = { retries: 0, timeoutMs: 7_260_000 };
+// A run whose job failed (ADR 0021, 35): the turn that waits on it ends as a failed step does, and a background run
+// tells the chat. Nothing is queued from here, since a handler's jobs carry the `fromHandler` mark.
+export async function runLost(ctx, jobId, code) {
+    const store = records(ctx.store);
+    const [run] = await store.runs.find({ jobId }, { limit: 1 });
+    if (run === undefined || run.status !== 'running')
+        return;
+    const interrupted = code === 'INTERRUPTED';
+    const status = interrupted ? 'interrupted' : 'failed';
+    const text = interrupted ? `${run.worker} was interrupted because kvman stopped.` : `${run.worker} failed: ${code}`;
+    if (run.toolCallId === null) {
+        await finishRun(ctx, run.id, { status, exitCode: null, text, isError: true }, false);
+        return;
+    }
+    await store.runs.update(run.id, { status, endedAt: new Date().toISOString(), output: text });
+    const session = await store.sessions.get(run.sessionId);
+    if (session === undefined || session.turnId === null)
+        return;
+    await endTurn(ctx, session.id, session.turnId, status, 'handler', { code: interrupted ? 'INTERRUPTED' : 'STEP_FAILED', params: { code } });
+}
+/** The checks of the workspace's program workers, as a session keeps them (ADR 0021, 37). */
+export async function workerChecks(ctx) {
+    const programs = (await listedWorkers(ctx)).filter(isProgram);
+    return Promise.all(programs.map(async (worker) => ({ name: workerCheckName(worker.name), passed: await programFound(checkCommand(worker.kind), ctx.job.workspace.path, ctx.job.signal) })));
+}
+export function registerWorkerRun(ctx) {
+    ctx.registerCommand('kvcoder.delegate.worker.run', {
+        description: "Runs a program worker's program on its task, and gives the chat its answer.",
+        input: z.strictObject({ runId: z.string() }),
+        output: z.object({}),
+        ...runOptions,
+        handle: async ({ runId }) => {
+            const run = await records(ctx.store).runs.get(runId);
+            if (run === undefined || run.status !== 'running')
+                return {};
+            const end = await runProgram({ command: run.command, args: run.args }, ctx.job.workspace.path, run.timeoutMs, ctx.job.signal);
+            // A cancelled or interrupted job leaves the run to whoever stopped it, or to `kernel.job.failed`.
+            ctx.job.signal.throwIfAborted();
+            const result = runResult({ name: run.worker, kind: run.kind, timeoutMs: run.timeoutMs }, end);
+            await finishRun(ctx, runId, { status: result.isError ? 'failed' : 'succeeded', exitCode: end.timedOut ? null : end.exitCode, ...result }, true);
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.delegate.worker.check', {
+        description: "Checks that a worker's program is installed; a subagent is always ready.",
+        input: z.strictObject({ name: z.string() }),
+        output: z.object({ status: z.enum(['ready', 'notFound']) }),
+        public: true,
+        retries: 0,
+        handle: async ({ name }) => {
+            const worker = await listedWorker(ctx, name);
+            const found = !isProgram(worker) || (await programFound(checkCommand(worker.kind), ctx.job.workspace.path, ctx.job.signal));
+            const status = found ? 'ready' : 'notFound';
+            return { status };
+        },
+    });
+}
+//# sourceMappingURL=register-worker-run.js.map

package/dist/delegate/register-worker-run.js.map

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

package/dist/delegate/run-program.d.ts

@@ -0,0 +1,9 @@
+import type { SpawnOptions } from 'node:child_process';
+import type { Platform } from '../calls/shell-command.ts';
+import type { CommandLine, ProgramEnd } from './programs.ts';
+/** How the program is started on each OS: Windows has no process group, and its tree is killed by `taskkill`. */
+export declare function programSpawn(platform: Platform, cwd: string, env: NodeJS.ProcessEnv): SpawnOptions;
+/** Whether a program is installed: started as a run starts it, it exits 0 within 5 s (ADR 0021, 37). */
+export declare function programFound(line: CommandLine, cwd: string, signal: AbortSignal): Promise<boolean>;
+export declare function runProgram(line: CommandLine, cwd: string, timeoutMs: number, signal: AbortSignal): Promise<ProgramEnd>;
+//# sourceMappingURL=run-program.d.ts.map

package/dist/delegate/run-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-program.d.ts","sourceRoot":"","sources":["../../src/delegate/run-program.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAM7D,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,YAAY,CAElG;AAmBD,wGAAwG;AACxG,wBAAsB,YAAY,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA0BtH"}

package/dist/delegate/run-program.js

@@ -0,0 +1,59 @@
+import spawn from 'cross-spawn';
+import { killTree } from "../calls/run-shell.js";
+import { outputLimit } from "../result-text.js";
+// One run of a program worker (plan 08 §8.5, ADR 0021, 11 and 26): in the workspace folder, with kvman's environment
+// and an empty standard input, in its own process group on Linux and macOS so its whole tree can be killed, which
+// happens at its time limit and on cancel. It is a process of the run's own job (plan 02 §2.6).
+/** How the program is started on each OS: Windows has no process group, and its tree is killed by `taskkill`. */
+export function programSpawn(platform, cwd, env) {
+    return { cwd, env, stdio: ['ignore', 'pipe', 'pipe'], detached: platform !== 'win32', windowsHide: true };
+}
+/** The most of each stream that is kept: enough for an answer, which is then cut for the model. */
+const keptBytes = 4 * outputLimit;
+// Keeps the end of a stream: an answer comes last.
+function tail() {
+    let kept = Buffer.alloc(0);
+    return {
+        add: (chunk) => {
+            kept = Buffer.concat([kept, chunk]);
+            if (kept.length > keptBytes)
+                kept = kept.subarray(kept.length - keptBytes);
+        },
+        text: () => kept.toString('utf8'),
+    };
+}
+const checkTimeoutMs = 5_000;
+/** Whether a program is installed: started as a run starts it, it exits 0 within 5 s (ADR 0021, 37). */
+export async function programFound(line, cwd, signal) {
+    const end = await runProgram(line, cwd, checkTimeoutMs, signal);
+    return end.startError === null && !end.timedOut && end.exitCode === 0;
+}
+export function runProgram(line, cwd, timeoutMs, signal) {
+    return new Promise((resolve) => {
+        const child = spawn(line.command, line.args, programSpawn(process.platform, cwd, process.env));
+        const stdout = tail();
+        const stderr = tail();
+        let timedOut = false;
+        child.stdout?.on('data', stdout.add);
+        child.stderr?.on('data', stderr.add);
+        const timer = setTimeout(() => {
+            timedOut = true;
+            killTree(child.pid);
+        }, timeoutMs);
+        const abort = () => killTree(child.pid);
+        signal.addEventListener('abort', abort, { once: true });
+        let settled = false;
+        // A program that can't start reports an error and may then close as well.
+        const settle = (end) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            signal.removeEventListener('abort', abort);
+            resolve({ stdout: stdout.text(), stderr: stderr.text(), timedOut, ...end });
+        };
+        child.once('error', (error) => settle({ exitCode: null, startError: error.message }));
+        child.once('close', (code) => settle({ exitCode: code, startError: null }));
+    });
+}
+//# sourceMappingURL=run-program.js.map

package/dist/delegate/run-program.js.map

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

package/dist/delegate/runs.d.ts

@@ -0,0 +1,27 @@
+import type { Ctx, Stored } from '@kvman/sdk';
+import type { HeldResult, RunDoc } from '../schemas/records.ts';
+import type { ProgramWorker } from './workers.ts';
+export type RunEnd = {
+    status: Exclude<RunDoc['status'], 'running'>;
+    exitCode: number | null;
+    text: string;
+    isError: boolean;
+};
+/** Records a run of `worker` on `task`; `toolCallId` is the call that waits on it, or `null` for a background run. */
+export declare function createRun(ctx: Ctx, sessionId: string, worker: ProgramWorker, call: {
+    description: string;
+    task: string;
+}, toolCallId: string | null): Promise<Stored<RunDoc>>;
+/** Queues the job that runs a recorded run. */
+export declare function launchRun(ctx: Ctx, runId: string): Promise<void>;
+/** Ends a run and gives its result to the call that waits on it, or to the chat as a background message, which may start a turn. */
+export declare function finishRun(ctx: Ctx, runId: string, end: RunEnd, startTurn: boolean): Promise<boolean>;
+/** Stops a run for the agent or the person: its result is that it was stopped (ADR 0021, 34). `false` for one that had ended. */
+export declare function stopRun(ctx: Ctx, run: Stored<RunDoc>): Promise<boolean>;
+/** Stops a run whose turn or chat is going away: nothing is told to anyone. */
+export declare function dropRun(ctx: Ctx, run: Stored<RunDoc>): Promise<void>;
+/** Stops every run a session still has going, and forgets all of them (the chat is deleted). */
+export declare function dropRuns(ctx: Ctx, sessionId: string): Promise<void>;
+/** A result that says why a run never started. */
+export declare const refusedRun: (toolCallId: string, text: string) => HeldResult;
+//# sourceMappingURL=runs.d.ts.map

package/dist/delegate/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/delegate/runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAMhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAMlD,MAAM,MAAM,MAAM,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC;AAE/H,sHAAsH;AACtH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAGnL;AAED,+CAA+C;AAC/C,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE;AAiBD,oIAAoI;AACpI,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAM1G;AAOD,iIAAiI;AACjI,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAI7E;AAED,+EAA+E;AAC/E,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1E;AAED,gGAAgG;AAChG,wBAAsB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED,kDAAkD;AAClD,eAAO,MAAM,UAAU,GAAI,YAAY,MAAM,EAAE,MAAM,MAAM,KAAG,UAA8C,CAAC"}

package/dist/delegate/runs.js

@@ -0,0 +1,68 @@
+import { now } from "../sessions/session-lookup.js";
+import { records, txRecords } from "../store/collections.js";
+import { appendBackground, backgroundText } from "../turns/background.js";
+import { heldText, resolvePending } from "../turns/resolve.js";
+import { commandLine } from "./programs.js";
+/** Records a run of `worker` on `task`; `toolCallId` is the call that waits on it, or `null` for a background run. */
+export async function createRun(ctx, sessionId, worker, call, toolCallId) {
+    const line = commandLine(worker, call.task);
+    return records(ctx.store).runs.insert({ sessionId, toolCallId, worker: worker.name, kind: worker.kind, call: call.description, command: line.command, args: line.args, timeoutMs: worker.timeoutMs, jobId: null, status: 'running', startedAt: now(), endedAt: null, exitCode: null, output: null });
+}
+/** Queues the job that runs a recorded run. */
+export async function launchRun(ctx, runId) {
+    const jobId = await ctx.execAsync('kvcoder.delegate.worker.run', { runId });
+    await records(ctx.store).runs.update(runId, { jobId });
+}
+// Records how a run ended, once: `undefined` when something else ended it first.
+async function markEnded(ctx, runId, end) {
+    return ctx.store.transaction((tx) => {
+        const { runs } = txRecords(tx);
+        const run = runs.get(runId);
+        if (run === undefined || run.status !== 'running')
+            return undefined;
+        return runs.update(runId, { status: end.status, endedAt: now(), exitCode: end.exitCode, output: end.text });
+    });
+}
+function heldRun(run, toolCallId, end) {
+    const durationMs = Math.max(Date.now() - Date.parse(run.startedAt), 0);
+    return { toolCallId, text: end.text, isError: end.isError, run: null, details: { description: run.call, connector: 'delegate', command: 'run', output: end.text, durationMs } };
+}
+/** Ends a run and gives its result to the call that waits on it, or to the chat as a background message, which may start a turn. */
+export async function finishRun(ctx, runId, end, startTurn) {
+    const run = await markEnded(ctx, runId, end);
+    if (run === undefined)
+        return false;
+    if (run.toolCallId !== null)
+        await resolvePending(ctx, run.sessionId, run.toolCallId, heldRun(run, run.toolCallId, end), false);
+    else
+        await appendBackground(ctx, run.sessionId, { kind: 'job', jobId: run.id }, backgroundText(run.call, run.id, end.text), startTurn);
+    return true;
+}
+async function cancelJobOf(ctx, run) {
+    const jobId = run.jobId ?? (await records(ctx.store).runs.get(run.id))?.jobId ?? null;
+    if (jobId !== null)
+        await ctx.cancel(jobId);
+}
+/** Stops a run for the agent or the person: its result is that it was stopped (ADR 0021, 34). `false` for one that had ended. */
+export async function stopRun(ctx, run) {
+    const stopped = await finishRun(ctx, run.id, { status: 'cancelled', exitCode: null, text: `${run.worker} was stopped`, isError: true }, false);
+    if (stopped)
+        await cancelJobOf(ctx, run);
+    return stopped;
+}
+/** Stops a run whose turn or chat is going away: nothing is told to anyone. */
+export async function dropRun(ctx, run) {
+    if ((await markEnded(ctx, run.id, { status: 'cancelled', exitCode: null, text: `${run.worker} was stopped`, isError: true })) !== undefined)
+        await cancelJobOf(ctx, run);
+}
+/** Stops every run a session still has going, and forgets all of them (the chat is deleted). */
+export async function dropRuns(ctx, sessionId) {
+    const store = records(ctx.store);
+    for (const run of await store.runs.find({ sessionId }, { limit: 1000 })) {
+        await dropRun(ctx, run);
+        await store.runs.delete(run.id);
+    }
+}
+/** A result that says why a run never started. */
+export const refusedRun = (toolCallId, text) => heldText(toolCallId, text, true);
+//# sourceMappingURL=runs.js.map

package/dist/delegate/runs.js.map

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

package/dist/delegate/workers.d.ts

@@ -0,0 +1,266 @@
+import { z, type Ctx } from '@kvman/sdk';
+/** A worker that runs a subagent: a child session with its own connectors, model, and thinking. */
+export declare const subagentWorkerSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"subagent">;
+    connectors: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodNullable<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>;
+/** The permission modes in which Claude Code acts without asking anyone. */
+export declare const unaskedModes: readonly string[];
+export declare const opencodeWorkerSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"opencode">;
+    model: z.ZodNullable<z.ZodString>;
+    agent: z.ZodNullable<z.ZodString>;
+    autoApprove: z.ZodBoolean;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>;
+export declare const piWorkerSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"pi">;
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodNullable<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    tools: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>;
+export declare const claudeWorkerSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"claude">;
+    model: z.ZodNullable<z.ZodString>;
+    effort: z.ZodNullable<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    permissionMode: z.ZodEnum<{
+        auto: "auto";
+        bypassPermissions: "bypassPermissions";
+        dontAsk: "dontAsk";
+        acceptEdits: "acceptEdits";
+        plan: "plan";
+    }>;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>;
+/** One worker: a subagent, or a program of one of the kinds kvcoder knows (ADR 0021, 3). */
+export declare const workerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"subagent">;
+    connectors: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodNullable<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"opencode">;
+    model: z.ZodNullable<z.ZodString>;
+    agent: z.ZodNullable<z.ZodString>;
+    autoApprove: z.ZodBoolean;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"pi">;
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodNullable<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    tools: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"claude">;
+    model: z.ZodNullable<z.ZodString>;
+    effort: z.ZodNullable<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    permissionMode: z.ZodEnum<{
+        auto: "auto";
+        bypassPermissions: "bypassPermissions";
+        dontAsk: "dontAsk";
+        acceptEdits: "acceptEdits";
+        plan: "plan";
+    }>;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>], "kind">;
+/** The `kvcoder.delegate.workers` setting: each worker has its own name. */
+export declare const workersSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"subagent">;
+    connectors: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodNullable<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+    }>>;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"opencode">;
+    model: z.ZodNullable<z.ZodString>;
+    agent: z.ZodNullable<z.ZodString>;
+    autoApprove: z.ZodBoolean;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"pi">;
+    model: z.ZodNullable<z.ZodString>;
+    thinking: z.ZodNullable<z.ZodEnum<{
+        off: "off";
+        minimal: "minimal";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    tools: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"claude">;
+    model: z.ZodNullable<z.ZodString>;
+    effort: z.ZodNullable<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        xhigh: "xhigh";
+        max: "max";
+    }>>;
+    permissionMode: z.ZodEnum<{
+        auto: "auto";
+        bypassPermissions: "bypassPermissions";
+        dontAsk: "dontAsk";
+        acceptEdits: "acceptEdits";
+        plan: "plan";
+    }>;
+    approval: z.ZodEnum<{
+        ask: "ask";
+        auto: "auto";
+    }>;
+    timeoutMs: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodString;
+    enabled: z.ZodBoolean;
+    instructions: z.ZodString;
+}, z.core.$strict>], "kind">>;
+export type Worker = z.output<typeof workerSchema>;
+export type SubagentWorker = z.output<typeof subagentWorkerSchema>;
+export type ProgramWorker = Exclude<Worker, SubagentWorker>;
+/** Whether a worker runs a program, not a subagent. */
+export declare const isProgram: (worker: Worker) => worker is ProgramWorker;
+/** The name a program worker's check has among a session's checks (ADR 0021, 37). */
+export declare const workerCheckName: (name: string) => string;
+/** The workers kvcoder ships with: they differ by their instructions only (ADR 0021, 5). */
+export declare const shippedWorkers: SubagentWorker[];
+/** The workers of the job's workspace, in the setting's order. */
+export declare function listedWorkers(ctx: Ctx): Promise<Worker[]>;
+type Checks = readonly {
+    name: string;
+    passed: boolean;
+}[] | null;
+/** The workers a session can use: turned on, and for a program, one whose check passed (ADR 0021, 17). */
+export declare function availableWorkers(ctx: Ctx, checks: Checks): Promise<Worker[]>;
+/** One available worker by name, or `kvcoder/WORKER_NOT_FOUND` naming the ones there are. */
+export declare function availableWorker(ctx: Ctx, checks: Checks, name: string): Promise<Worker>;
+/** One worker of the list by name, turned on or not. */
+export declare function listedWorker(ctx: Ctx, name: string): Promise<Worker>;
+export {};
+//# sourceMappingURL=workers.d.ts.map

package/dist/delegate/workers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../src/delegate/workers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAkBvD,mGAAmG;AACnG,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;kBAAmL,CAAC;AAWrN,4EAA4E;AAC5E,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAA6C,CAAC;AAExF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;kBAAmM,CAAC;AACrO,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;kBAA6M,CAAC;AACzO,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;kBAM8E,CAAC;AAE9G,4FAA4F;AAC5F,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAAiH,CAAC;AAE3I,4EAA4E;AAC5E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BAAsJ,CAAC;AAEjL,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAE5D,uDAAuD;AACvD,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,MAAM,IAAI,aAA2C,CAAC;AAEjG,qFAAqF;AACrF,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAA0B,CAAC;AAI1E,4FAA4F;AAC5F,eAAO,MAAM,cAAc,EAAE,cAAc,EAsB1C,CAAC;AAEF,kEAAkE;AAClE,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE/D;AAED,KAAK,MAAM,GAAG,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,IAAI,CAAC;AAElE,0GAA0G;AAC1G,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGlF;AAMD,6FAA6F;AAC7F,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7F;AAED,wDAAwD;AACxD,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK1E"}

package/dist/delegate/workers.js

@@ -0,0 +1,80 @@
+import { ProblemError, z } from '@kvman/sdk';
+import { thinkingSchema } from "../schemas/records.js";
+import { wordSchema } from "../schemas/registry.js";
+// The workers the `delegate` connector hands tasks to (plan 08 §8.5, ADR 0021, 4, 5, 7, and 20): the setting
+// `kvcoder.delegate.workers`. A worker runs a subagent with its own instructions, connectors, model, and thinking, or
+// a program on this computer, and is available while it is turned on.
+/** The most a worker's instructions hold, a section's cap. */
+const instructionsLimit = 16 * 1024;
+const common = {
+    name: wordSchema,
+    description: z.string().min(1),
+    enabled: z.boolean(),
+    instructions: z.string().refine((text) => Buffer.byteLength(text, 'utf8') <= instructionsLimit, 'Instructions hold at most 16 KB.'),
+};
+/** A worker that runs a subagent: a child session with its own connectors, model, and thinking. */
+export const subagentWorkerSchema = z.strictObject({ ...common, kind: z.literal('subagent'), connectors: z.array(z.string()).nullable(), model: z.string().min(1).nullable(), thinking: thinkingSchema.nullable() });
+// A worker that runs a program on this computer (ADR 0021, 12, 13, and 31): whether a run asks first, how long it may
+// take, and the flags that matter, each `null` to leave its flag out.
+const program = { ...common, approval: z.enum(['ask', 'auto']), timeoutMs: z.number().int().min(60_000).max(7_200_000) };
+const flag = z.string().min(1).nullable();
+// A run nobody is asked about must not also approve its own actions (ADR 0021, 39): the task comes from the model,
+// which may have been steered by what it read.
+const unattended = 'A worker that starts at once must not approve its own actions: set it to ask before a run, or choose a stricter mode.';
+/** The permission modes in which Claude Code acts without asking anyone. */
+export const unaskedModes = ['bypassPermissions', 'auto', 'dontAsk'];
+export const opencodeWorkerSchema = z.strictObject({ ...program, kind: z.literal('opencode'), model: flag, agent: flag, autoApprove: z.boolean() }).refine((worker) => worker.approval === 'ask' || !worker.autoApprove, unattended);
+export const piWorkerSchema = z.strictObject({ ...program, kind: z.literal('pi'), model: flag, thinking: z.enum(['off', 'minimal', 'low', 'medium', 'high', 'xhigh', 'max']).nullable(), tools: z.array(z.string().min(1)).nullable() });
+export const claudeWorkerSchema = z.strictObject({
+    ...program,
+    kind: z.literal('claude'),
+    model: flag,
+    effort: z.enum(['low', 'medium', 'high', 'xhigh', 'max']).nullable(),
+    permissionMode: z.enum(['acceptEdits', 'auto', 'bypassPermissions', 'dontAsk', 'plan']),
+}).refine((worker) => worker.approval === 'ask' || !unaskedModes.includes(worker.permissionMode), unattended);
+/** One worker: a subagent, or a program of one of the kinds kvcoder knows (ADR 0021, 3). */
+export const workerSchema = z.discriminatedUnion('kind', [subagentWorkerSchema, opencodeWorkerSchema, piWorkerSchema, claudeWorkerSchema]);
+/** The `kvcoder.delegate.workers` setting: each worker has its own name. */
+export const workersSchema = z.array(workerSchema).refine((workers) => new Set(workers.map((worker) => worker.name)).size === workers.length, 'Each worker needs its own name.');
+/** Whether a worker runs a program, not a subagent. */
+export const isProgram = (worker) => worker.kind !== 'subagent';
+/** The name a program worker's check has among a session's checks (ADR 0021, 37). */
+export const workerCheckName = (name) => `worker:${name}`;
+const shipped = (name, description, instructions) => ({ name, description, enabled: true, kind: 'subagent', instructions, connectors: null, model: null, thinking: null });
+/** The workers kvcoder ships with: they differ by their instructions only (ADR 0021, 5). */
+export const shippedWorkers = [
+    shipped('general', 'Any separate, self-contained task', ''),
+    shipped('ui-ux', 'Designs screens and flows', "You are a UI/UX designer. Design the screens and flows the task asks for, from the person's experience: what they see, what they do next, and every empty, loading, and error state. Follow the project's existing components, styles, and wording. Show the design in an artifact, as a page when layout matters. Don't change the project's files unless the task asks you to build the design."),
+    shipped('architect', 'Studies the code and proposes a design', "You are a software architect. Read the code the task touches before you propose anything. Return a design: the parts, their responsibilities, the shapes that pass between them, the trade-offs you weighed, and the risks. Prefer the simplest design that fits the project's conventions. Don't edit the project's files."),
+    shipped('tester', 'Writes and runs tests', "You are a test engineer. Write the tests the task asks for in the project's own test setup, each checking one behavior with real values, and run them. Report each failure with its cause. Don't change production code to make a test pass; report the defect."),
+    shipped('reviewer', 'Reviews changes with a fresh look', "You are a code reviewer. Read the changes the task names, and the code around them. Report defects by severity, each with its file and line, what is wrong, and what you expect instead: correctness first, then security, then the project's conventions. Say so when you find nothing. Don't edit the project's files."),
+];
+/** The workers of the job's workspace, in the setting's order. */
+export async function listedWorkers(ctx) {
+    return workersSchema.parse(await ctx.settings.get('kvcoder.delegate.workers'));
+}
+/** The workers a session can use: turned on, and for a program, one whose check passed (ADR 0021, 17). */
+export async function availableWorkers(ctx, checks) {
+    const passed = new Set((checks ?? []).filter((check) => check.passed).map((check) => check.name));
+    return (await listedWorkers(ctx)).filter((worker) => worker.enabled && (!isProgram(worker) || passed.has(workerCheckName(worker.name))));
+}
+function notFound(name, names) {
+    return new ProblemError({ code: 'kvcoder/WORKER_NOT_FOUND', message: `There is no worker ${name}. ${names.length === 0 ? 'No worker is available.' : `The workers are: ${names.join(', ')}.`}`, params: { worker: name } });
+}
+/** One available worker by name, or `kvcoder/WORKER_NOT_FOUND` naming the ones there are. */
+export async function availableWorker(ctx, checks, name) {
+    const workers = await availableWorkers(ctx, checks);
+    const found = workers.find((worker) => worker.name === name);
+    if (found === undefined)
+        throw notFound(name, workers.map((worker) => worker.name));
+    return found;
+}
+/** One worker of the list by name, turned on or not. */
+export async function listedWorker(ctx, name) {
+    const workers = await listedWorkers(ctx);
+    const found = workers.find((worker) => worker.name === name);
+    if (found === undefined)
+        throw notFound(name, workers.map((worker) => worker.name));
+    return found;
+}
+//# sourceMappingURL=workers.js.map

package/dist/delegate/workers.js.map

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