@kvman/kvcoder 0.1.0

package/dist/connectors/fs.js

@@ -0,0 +1,132 @@
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from '@kvman/sdk';
+import { applyEdits } from "../files/edit-text.js";
+import { listEntries } from "../files/list-entries.js";
+import { readLines } from "../files/read-file.js";
+import { searchText } from "../files/search-text.js";
+import { resolveInWorkspace } from "../files/workspace-path.js";
+import { invalid, notFound } from "../problems.js";
+import { callInput } from "./connector-command.js";
+import { edits, risky } from "./payload-fields.js";
+// The `fs` connector (plan 08 §8.5, ADR 0009, 157 to 160; ADR 0011, 8): `read`, `list`, and `search` look inside the
+// workspace folder; `write` creates or replaces a file and `edit` replaces text in one, after the approval the shell's
+// calls get. The step runs the changes to one file one after another.
+/** What the prompt's index says the connector is for. */
+export const fsDescription = 'Read, list, search, create, and change files in the workspace folder. Use it instead of cat, ls, grep, or shell redirection: read a file before you edit it, write for a new file or a full rewrite, one file per call, and edit for exact text replacements in an existing file.';
+const filePath = (what) => z.string().min(1).describe(`${what}, relative to the workspace folder, or absolute inside it.`);
+const payloads = {
+    read: z.strictObject({
+        path: filePath('The file to read'),
+        fromLine: z.number().int().min(1).describe('The first line to return, counting from 1. The default is 1.').exactOptional(),
+        lines: z.number().int().min(1).max(2000).describe('How many lines to return: 2000 by default, which is also the most.').exactOptional(),
+    }),
+    list: z.strictObject({ path: z.string().describe('The folder to list, relative to the workspace folder, or absolute inside it; the workspace folder when left out or empty.').exactOptional() }),
+    search: z.strictObject({
+        pattern: z.string().min(1).describe('A JavaScript regular expression, matched against each line, case-sensitive.'),
+        path: z.string().describe('The file or folder to search, relative to the workspace folder, or absolute inside it; the workspace folder when left out or empty.').exactOptional(),
+    }),
+    write: z.strictObject({ path: filePath('The file to create or replace'), content: z.string().describe('The whole content of the file.'), risky }),
+    edit: z.strictObject({ path: filePath('The existing text file to change'), edits, risky }),
+};
+export const fsCommands = {
+    read: { registration: 'kvcoder.fs.file.get', description: 'Reads lines of a text file.', payload: payloads.read, asks: false, bounded: true },
+    list: { registration: 'kvcoder.fs.entry.list', description: 'Lists the files and folders of one folder.', payload: payloads.list, asks: false, bounded: true },
+    search: { registration: 'kvcoder.fs.text.search', description: 'Finds the lines that match a regular expression, in a file or under a folder.', payload: payloads.search, asks: false, bounded: true },
+    write: { registration: 'kvcoder.fs.write', description: 'Creates a file and its parent folders, or replaces the file.', payload: payloads.write, asks: true },
+    edit: { registration: 'kvcoder.fs.edit', description: 'Replaces exact pieces of text in an existing file; if one replacement fails, nothing is written.', payload: payloads.edit, asks: true },
+};
+const strictText = new TextDecoder('utf-8', { fatal: true, ignoreBOM: true });
+const missing = (error) => error instanceof Error && 'code' in error && error.code === 'ENOENT';
+// The file system's own refusals (a folder in the way, no permission) are the model's to read and fix.
+const refusedByFileSystem = (error) => error instanceof Error && 'code' in error && typeof error.code === 'string' && /^E[A-Z]+$/.test(error.code);
+async function asProblems(run) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        if (refusedByFileSystem(error))
+            throw invalid(error.message);
+        throw error;
+    }
+}
+async function statOrUndefined(target) {
+    try {
+        return await stat(target);
+    }
+    catch (error) {
+        if (missing(error))
+            return undefined;
+        throw error;
+    }
+}
+async function readText(target, requested) {
+    let bytes;
+    try {
+        bytes = await readFile(target);
+    }
+    catch (error) {
+        throw missing(error) ? notFound(`${requested} doesn't exist.`, { path: requested }) : error;
+    }
+    try {
+        return strictText.decode(bytes);
+    }
+    catch {
+        throw invalid(`${requested} isn't valid UTF-8 text, so it isn't edited.`, { path: requested });
+    }
+}
+async function writeTo(ctx, input) {
+    const target = await resolveInWorkspace(ctx.job.workspace.path, input.path);
+    const existing = await statOrUndefined(target);
+    if (existing?.isDirectory() === true)
+        throw invalid(`${input.path} is a folder.`, { path: input.path });
+    await mkdir(path.dirname(target), { recursive: true });
+    ctx.job.signal.throwIfAborted();
+    await writeFile(target, input.content, 'utf8');
+    return { path: input.path, created: existing === undefined, bytes: Buffer.byteLength(input.content) };
+}
+async function editIn(ctx, input) {
+    const target = await resolveInWorkspace(ctx.job.workspace.path, input.path);
+    const edited = applyEdits(await readText(target, input.path), input.edits);
+    ctx.job.signal.throwIfAborted();
+    await writeFile(target, edited.text, 'utf8');
+    return { path: input.path, replacements: edited.replacements, firstChangedLine: edited.firstChangedLine };
+}
+const commands = fsCommands;
+export function registerFsConnector(ctx) {
+    ctx.registerQuery('kvcoder.fs.file.get', {
+        description: commands.read.description,
+        input: callInput(payloads.read),
+        output: z.object({ path: z.string(), fromLine: z.number().int(), totalLines: z.number().int(), content: z.string() }),
+        handle: ({ payload }) => asProblems(() => readLines(ctx.job.workspace.path, payload)),
+    });
+    ctx.registerQuery('kvcoder.fs.entry.list', {
+        description: commands.list.description,
+        input: callInput(payloads.list),
+        output: z.object({ path: z.string(), entries: z.array(z.object({ name: z.string(), kind: z.enum(['file', 'folder']), bytes: z.number().int() })), truncated: z.boolean() }),
+        handle: ({ payload }) => asProblems(() => listEntries(ctx.job.workspace.path, payload)),
+    });
+    ctx.registerQuery('kvcoder.fs.text.search', {
+        description: commands.search.description,
+        input: callInput(payloads.search),
+        output: z.object({ matches: z.array(z.object({ path: z.string(), line: z.number().int(), text: z.string() })), truncated: z.boolean() }),
+        handle: ({ payload }) => asProblems(() => searchText(ctx.job.workspace.path, payload, ctx.job.signal)),
+    });
+    ctx.registerCommand('kvcoder.fs.write', {
+        description: commands.write.description,
+        input: callInput(payloads.write),
+        output: z.object({ path: z.string(), created: z.boolean(), bytes: z.number().int() }),
+        retries: 0,
+        maxInputBytes: 33_554_432,
+        handle: ({ payload }) => asProblems(() => writeTo(ctx, payload)),
+    });
+    ctx.registerCommand('kvcoder.fs.edit', {
+        description: commands.edit.description,
+        input: callInput(payloads.edit),
+        output: z.object({ path: z.string(), replacements: z.number().int(), firstChangedLine: z.number().int() }),
+        retries: 0,
+        maxInputBytes: 33_554_432,
+        handle: ({ payload }) => asProblems(() => editIn(ctx, payload)),
+    });
+}
+//# sourceMappingURL=fs.js.map

package/dist/connectors/fs.js.map

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

package/dist/connectors/mcp.d.ts

@@ -0,0 +1,37 @@
+import { z, type Ctx } from '@kvman/sdk';
+import { type McpServer } from '../mcp/servers.ts';
+/** What the prompt's index says the connector is for; the session's entry adds its servers. */
+export declare const mcpDescription = "Tools from the MCP servers the person added. Call tools with { \"server\" } to see what a server offers, and with { \"server\", \"tool\" } to see a tool's arguments, before the first time you call it.";
+/** The connector's description with the workspace's servers, as the prompt's index shows it. */
+export declare function mcpIndexDescription(servers: readonly McpServer[]): string;
+export declare const mcpCommands: {
+    tools: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            server: z.ZodString;
+            tool: z.ZodExactOptional<z.ZodString>;
+        }, z.core.$strict>;
+        asks: false;
+    };
+    call: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            server: z.ZodString;
+            tool: z.ZodString;
+            arguments: z.ZodExactOptional<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+            timeoutMs: z.ZodExactOptional<z.ZodNumber>;
+            risky: z.ZodBoolean;
+        }, z.core.$strict>;
+        asks: true;
+        result: string;
+    };
+};
+/** What `kvcoder.mcp.tool.call` gives: the tool's text, and whether the tool says it failed. */
+export declare const mcpCallSchema: z.ZodObject<{
+    text: z.ZodString;
+    isError: z.ZodBoolean;
+}, z.core.$strip>;
+export declare function registerMcpConnector(ctx: Ctx): void;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/connectors/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/connectors/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAS9D,+FAA+F;AAC/F,eAAO,MAAM,cAAc,6MAC4K,CAAC;AAExM,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAEzE;AAgBD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;CAGoB,CAAC;AAE7C,gGAAgG;AAChG,eAAO,MAAM,aAAa;;;iBAAuD,CAAC;AAQlF,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA6BnD"}

package/dist/connectors/mcp.js

@@ -0,0 +1,69 @@
+import { z } from '@kvman/sdk';
+import { callTimeout } from "../calls/shell-command.js";
+import { mcpServer } from "../mcp/servers.js";
+import { listTools, resultText, toolNamed } from "../mcp/tools.js";
+import { callInput } from "./connector-command.js";
+import { timeoutMs } from "./payload-fields.js";
+// The `mcp` connector (plan 08 §8.5, ADR 0020, 3, 7, and 10): the tools of the MCP servers the person added. `tools`
+// lists a server's tools or gives one tool's arguments; `call` runs a tool, after the person's approval when it is risky.
+// The MCP client is loaded by the first call that connects, so a kvman with no server doesn't keep it in memory.
+/** What the prompt's index says the connector is for; the session's entry adds its servers. */
+export const mcpDescription = 'Tools from the MCP servers the person added. Call tools with { "server" } to see what a server offers, and with { "server", "tool" } to see a tool\'s arguments, before the first time you call it.';
+/** The connector's description with the workspace's servers, as the prompt's index shows it. */
+export function mcpIndexDescription(servers) {
+    return `${mcpDescription} Servers: ${servers.map((server) => `${server.name} (${server.description.replace(/[.\s]+$/, '')})`).join(', ')}.`;
+}
+const server = z.string().min(1).describe('The MCP server, by the name the system prompt lists.');
+const risky = z.boolean().describe('true when the tool could change, delete, or send something that isn\'t your own work: creating or closing an issue, sending a message, writing to a database. The person is asked first. false for a tool that only reads.');
+const payloads = {
+    tools: z.strictObject({ server, tool: z.string().min(1).describe("One tool to describe with its arguments' JSON Schema; every tool's name and description when left out.").exactOptional() }),
+    call: z.strictObject({
+        server,
+        tool: z.string().min(1).describe('The tool to call, by its name from tools.'),
+        arguments: z.record(z.string(), z.json()).describe("The tool's arguments, as its JSON Schema from tools asks; leave it out for a tool that takes none.").exactOptional(),
+        timeoutMs,
+        risky,
+    }),
+};
+export const mcpCommands = {
+    tools: { registration: 'kvcoder.mcp.tool.describe', description: "Lists an MCP server's tools, or gives one tool's description and arguments.", payload: payloads.tools, asks: false },
+    call: { registration: 'kvcoder.mcp.tool.call', description: "Calls one tool of an MCP server and returns the tool's text.", payload: payloads.call, asks: true, result: "the tool's text." },
+};
+/** What `kvcoder.mcp.tool.call` gives: the tool's text, and whether the tool says it failed. */
+export const mcpCallSchema = z.object({ text: z.string(), isError: z.boolean() });
+const toolRowSchema = z.object({ name: z.string(), description: z.string() });
+const describeOutput = z.union([z.object({ server: z.string(), tools: z.array(toolRowSchema) }), toolRowSchema.extend({ server: z.string(), arguments: z.json() })]);
+// The jobs may run for the call's longest timeout, with room to report it.
+const jobOptions = { retries: 0, timeoutMs: 660_000 };
+export function registerMcpConnector(ctx) {
+    ctx.registerCommand('kvcoder.mcp.tool.describe', {
+        description: mcpCommands.tools.description,
+        input: callInput(payloads.tools),
+        output: describeOutput,
+        ...jobOptions,
+        handle: async ({ payload }) => {
+            const found = await mcpServer(ctx, payload.server);
+            const { withServer } = await import("../mcp/connect.js");
+            const tools = await withServer(ctx, found, callTimeout(undefined), listTools);
+            if (payload.tool === undefined)
+                return { server: found.name, tools: tools.map((tool) => ({ name: tool.name, description: tool.description ?? '' })) };
+            const tool = toolNamed(found.name, tools, payload.tool);
+            return { server: found.name, name: tool.name, description: tool.description ?? '', arguments: tool.inputSchema };
+        },
+    });
+    ctx.registerCommand('kvcoder.mcp.tool.call', {
+        description: mcpCommands.call.description,
+        input: callInput(payloads.call),
+        output: mcpCallSchema,
+        ...jobOptions,
+        handle: async ({ payload }) => {
+            const found = await mcpServer(ctx, payload.server);
+            const { withServer } = await import("../mcp/connect.js");
+            return withServer(ctx, found, callTimeout(payload.timeoutMs), async (connection) => {
+                toolNamed(found.name, await listTools(connection), payload.tool);
+                return resultText(await connection.client.callTool({ name: payload.tool, arguments: payload.arguments ?? {} }, undefined, connection.request));
+            });
+        },
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/connectors/mcp.js.map

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

package/dist/connectors/payload-fields.d.ts

@@ -0,0 +1,9 @@
+import { z } from '@kvman/sdk';
+export declare const risky: z.ZodBoolean;
+export declare const background: z.ZodExactOptional<z.ZodBoolean>;
+export declare const timeoutMs: z.ZodExactOptional<z.ZodNumber>;
+export declare const edits: z.ZodArray<z.ZodObject<{
+    oldText: z.ZodString;
+    newText: z.ZodString;
+}, z.core.$strict>>;
+//# sourceMappingURL=payload-fields.d.ts.map

package/dist/connectors/payload-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-fields.d.ts","sourceRoot":"","sources":["../../src/connectors/payload-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAK/B,eAAO,MAAM,KAAK,cAEoQ,CAAC;AAEvR,eAAO,MAAM,UAAU,kCAAsK,CAAC;AAE9L,eAAO,MAAM,SAAS,iCAAqK,CAAC;AAE5L,eAAO,MAAM,KAAK;;;mBAGsG,CAAC"}

package/dist/connectors/payload-fields.js

@@ -0,0 +1,13 @@
+import { z } from '@kvman/sdk';
+// The payload fields several connectors share (plan 08 §8.3 and §8.5). Every field has a description, since `help`
+// shows these schemas to the model (ADR 0011, 10).
+export const risky = z
+    .boolean()
+    .describe("true when this could lose or damage something that isn't your own work, or reaches outside the workspace folder: deleting or overwriting files you didn't create, sudo, a global install, git push --force or reset --hard. The person is asked first. Otherwise false.");
+export const background = z.boolean().describe('true keeps a server or any long-running command running after the call returns; follow it up with the background connector.').exactOptional();
+export const timeoutMs = z.number().int().positive().describe('How long the command may run, in milliseconds: 120000 by default, at most 600000. Ignored with background.').exactOptional();
+export const edits = z
+    .array(z.strictObject({ oldText: z.string().describe('The exact text to replace, as it is now, whitespace and line breaks included. It must occur once.'), newText: z.string().describe('The text that replaces it.') }))
+    .min(1)
+    .describe('The replacements, applied together. They must not overlap; put several changes to one target in one call.');
+//# sourceMappingURL=payload-fields.js.map

package/dist/connectors/payload-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload-fields.js","sourceRoot":"","sources":["../../src/connectors/payload-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,YAAY,CAAC;AAE/B,mHAAmH;AACnH,mDAAmD;AAEnD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACnB,OAAO,EAAE;KACT,QAAQ,CAAC,yQAAyQ,CAAC,CAAC;AAEvR,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,6HAA6H,CAAC,CAAC,aAAa,EAAE,CAAC;AAE9L,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4GAA4G,CAAC,CAAC,aAAa,EAAE,CAAC;AAE5L,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC;KACnB,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,CAAC,CAAC;KACxN,GAAG,CAAC,CAAC,CAAC;KACN,QAAQ,CAAC,2GAA2G,CAAC,CAAC"}

package/dist/connectors/shell.d.ts

@@ -0,0 +1,19 @@
+import { z, type Ctx } from '@kvman/sdk';
+/** What the prompt's index says the connector is for; it names the shell this run uses. */
+export declare const shellDescription: (shell: "bash" | "powershell") => string;
+export declare const shellCommands: {
+    exec: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            line: z.ZodString;
+            background: z.ZodExactOptional<z.ZodBoolean>;
+            timeoutMs: z.ZodExactOptional<z.ZodNumber>;
+            risky: z.ZodBoolean;
+        }, z.core.$strict>;
+        asks: true;
+        result: string;
+    };
+};
+export declare function registerShellConnector(ctx: Ctx): void;
+//# sourceMappingURL=shell.d.ts.map

package/dist/connectors/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/connectors/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAQzC,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,GAAG,YAAY,KAAG,MAC0Q,CAAC;AAI3U,eAAO,MAAM,aAAa;;;;;;;;;;;;;CAEkB,CAAC;AAE7C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAQrD"}

package/dist/connectors/shell.js

@@ -0,0 +1,22 @@
+import { z } from '@kvman/sdk';
+import { lineRunOptions, lineRunSchema, runLine } from "../calls/line-run.js";
+import { lineCallInput, lineResult } from "./connector-command.js";
+import { background, risky, timeoutMs } from "./payload-fields.js";
+// The `shell` connector (plan 08 §8.3, ADR 0011, 2): `exec` runs one whole line in the real shell, in the workspace
+// folder, after the person's approval when the call is risky.
+/** What the prompt's index says the connector is for; it names the shell this run uses. */
+export const shellDescription = (shell) => `Run a line in the real shell (${shell === 'bash' ? 'bash' : 'PowerShell'}) in the workspace folder: build, test, install, or anything no other connector covers. Set background to true for a server or any command that keeps running; to show the person an app you started, give its address to artifact write with the format url.`;
+const execPayload = z.strictObject({ line: z.string().min(1).describe('The whole shell line to run, with any pipes, &&, or redirection.'), background, timeoutMs, risky });
+export const shellCommands = {
+    exec: { registration: 'kvcoder.shell.run', description: 'Runs one line in the real shell, in the workspace folder.', payload: execPayload, asks: true, result: lineResult },
+};
+export function registerShellConnector(ctx) {
+    ctx.registerCommand('kvcoder.shell.run', {
+        description: shellCommands.exec.description,
+        input: lineCallInput(execPayload),
+        output: lineRunSchema,
+        ...lineRunOptions,
+        handle: ({ sessionId, description, payload }) => runLine(ctx, { sessionId, description }, payload.line, payload),
+    });
+}
+//# sourceMappingURL=shell.js.map

package/dist/connectors/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/connectors/shell.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,UAAU,EAAyB,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEnE,oHAAoH;AACpH,8DAA8D;AAE9D,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAA4B,EAAU,EAAE,CACvE,iCAAiC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,+PAA+P,CAAC;AAE3U,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kEAAkE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAE3K,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,2DAA2D,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE;CACjI,CAAC;AAE7C,MAAM,UAAU,sBAAsB,CAAC,GAAQ;IAC7C,GAAG,CAAC,eAAe,CAAC,mBAAmB,EAAE;QACvC,WAAW,EAAE,aAAa,CAAC,IAAI,CAAC,WAAW;QAC3C,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC;QACjC,MAAM,EAAE,aAAa;QACrB,GAAG,cAAc;QACjB,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;KACjH,CAAC,CAAC;AACL,CAAC"}

package/dist/delay.d.ts

@@ -0,0 +1,3 @@
+/** Waits `milliseconds`, or less when `signal` aborts; the caller checks the signal afterwards. */
+export declare function delay(milliseconds: number, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=delay.d.ts.map

package/dist/delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../src/delay.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,wBAAgB,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ9E"}

package/dist/delay.js

@@ -0,0 +1,11 @@
+/** Waits `milliseconds`, or less when `signal` aborts; the caller checks the signal afterwards. */
+export function delay(milliseconds, signal) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(resolve, milliseconds);
+        signal.addEventListener('abort', () => {
+            clearTimeout(timer);
+            resolve();
+        }, { once: true });
+    });
+}
+//# sourceMappingURL=delay.js.map

package/dist/delay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.js","sourceRoot":"","sources":["../src/delay.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,UAAU,KAAK,CAAC,YAAoB,EAAE,MAAmB;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAChD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;YACpC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type Ctx } from '@kvman/sdk';
+import type { RunCallDoc } from '../schemas/records.ts';
+type Approved = {
+    sessionId: string;
+    toolCallId: string;
+    call: RunCallDoc;
+};
+/** Whether an approved call is a worker's run, which never runs as a held call does. */
+export declare const isDelegateRun: (call: RunCallDoc) => boolean;
+/** Starts the run of an approved call; resolves to the next step's job id when the call got its result at once and nothing else is pending. */
+export declare function startApprovedRun(ctx: Ctx, approved: Approved): Promise<string | null>;
+export {};
+//# sourceMappingURL=approved-run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approved-run.d.ts","sourceRoot":"","sources":["../../src/delegate/approved-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAIpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAUxD,KAAK,QAAQ,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE5E,wFAAwF;AACxF,eAAO,MAAM,aAAa,GAAI,MAAM,UAAU,KAAG,OAAkE,CAAC;AAOpH,+IAA+I;AAC/I,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiC3F"}

package/dist/delegate/approved-run.js

@@ -0,0 +1,54 @@
+import { ProblemError } from '@kvman/sdk';
+import { delegateRunSchema } from "../connectors/delegate.js";
+import { errorOutput } from "../connector-call.js";
+import { firePoint } from "../registry/session-points.js";
+import { records, txRecords } from "../store/collections.js";
+import { heldText, resolvePending } from "../turns/resolve.js";
+import { createRun, dropRun, launchRun } from "./runs.js";
+import { availableWorker, isProgram } from "./workers.js";
+/** Whether an approved call is a worker's run, which never runs as a held call does. */
+export const isDelegateRun = (call) => call.connector === 'delegate' && call.command === 'run';
+async function refuse(ctx, approved, error) {
+    if (!(error instanceof ProblemError))
+        throw error;
+    return resolvePending(ctx, approved.sessionId, approved.toolCallId, heldText(approved.toolCallId, errorOutput(error.problem).output, true), false);
+}
+/** Starts the run of an approved call; resolves to the next step's job id when the call got its result at once and nothing else is pending. */
+export async function startApprovedRun(ctx, approved) {
+    const { sessionId, toolCallId, call } = approved;
+    const payload = delegateRunSchema.parse(call.payload);
+    const session = await records(ctx.store).sessions.get(sessionId);
+    let worker;
+    try {
+        worker = await availableWorker(ctx, session?.checks ?? null, payload.worker);
+        if (!isProgram(worker))
+            throw new ProblemError({ code: 'VALIDATION_FAILED', message: `The worker ${worker.name} changed while the call waited. Make the call again.`, params: { worker: worker.name } });
+    }
+    catch (error) {
+        return refuse(ctx, approved, error);
+    }
+    const background = payload.background === true;
+    const run = await createRun(ctx, sessionId, worker, { description: call.description, task: payload.task }, background ? null : toolCallId);
+    if (background) {
+        await launchRun(ctx, run.id);
+        const text = `started ${run.id}`;
+        return resolvePending(ctx, sessionId, toolCallId, { toolCallId, text, isError: false, run: null, details: { description: call.description, connector: call.connector, command: call.command, output: text, durationMs: 0 } }, false);
+    }
+    const waiting = await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const current = store.sessions.get(sessionId);
+        const turn = current === undefined || current.turnId === null ? undefined : store.turns.get(current.turnId);
+        if (turn === undefined || !turn.pending.some((item) => item.toolCallId === toolCallId))
+            return false;
+        store.turns.update(turn.id, { pending: turn.pending.map((item) => (item.toolCallId === toolCallId ? { toolCallId, kind: 'worker', questionId: null, question: null, childSessionId: null, runId: run.id } : item)) });
+        return true;
+    });
+    if (!waiting) {
+        await dropRun(ctx, run);
+        return null;
+    }
+    await launchRun(ctx, run.id);
+    await firePoint(ctx, 'kvcoder.session.waiting', { sessionId, kind: 'worker' });
+    return null;
+}
+//# sourceMappingURL=approved-run.js.map

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

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

package/dist/delegate/programs.d.ts

@@ -0,0 +1,32 @@
+import type { ProgramWorker } from './workers.ts';
+export type CommandLine = {
+    command: string;
+    args: string[];
+};
+/** The command line that runs `task` with a worker. */
+export declare function commandLine(worker: ProgramWorker, task: string): CommandLine;
+/** The command line that checks a kind's program is installed (ADR 0021, 37). */
+export declare const checkCommand: (kind: ProgramWorker["kind"]) => CommandLine;
+/** A program's answer from its standard output, and the reasons it gave for a failure. */
+export declare function answerOf(kind: ProgramWorker['kind'], stdout: string): {
+    answer: string;
+    reasons: string[];
+};
+/** How a program's run ended. */
+export type ProgramEnd = {
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+    timedOut: boolean;
+    startError: string | null;
+};
+/** What a run returns to the model, and whether it is an error (ADR 0021, 32). */
+export declare function runResult(worker: {
+    name: string;
+    kind: ProgramWorker['kind'];
+    timeoutMs: number;
+}, end: ProgramEnd): {
+    text: string;
+    isError: boolean;
+};
+//# sourceMappingURL=programs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../../src/delegate/programs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAKlD,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAI9D,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAW5E;AAED,iFAAiF;AACjF,eAAO,MAAM,YAAY,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,WAAuD,CAAC;AAgCnH,0FAA0F;AAC1F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAE3G;AAED,iCAAiC;AACjC,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAEnI,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAMvJ"}

package/dist/delegate/programs.js

@@ -0,0 +1,67 @@
+import { z } from '@kvman/sdk';
+import { truncate } from "../result-text.js";
+const option = (name, value) => (value === null ? [] : [name, value]);
+/** The command line that runs `task` with a worker. */
+export function commandLine(worker, task) {
+    if (worker.kind === 'opencode') {
+        const text = worker.instructions === '' ? task : `${worker.instructions}\n\n${task}`;
+        return { command: 'opencode', args: ['run', '--format', 'json', ...option('--model', worker.model), ...option('--agent', worker.agent), ...(worker.autoApprove ? ['--auto'] : []), '--', text] };
+    }
+    const instructions = option('--append-system-prompt', worker.instructions === '' ? null : worker.instructions);
+    if (worker.kind === 'pi') {
+        const tools = option('--tools', worker.tools === null ? null : worker.tools.join(','));
+        return { command: 'pi', args: ['-p', ...option('--model', worker.model), ...option('--thinking', worker.thinking), ...tools, ...instructions, '--', task] };
+    }
+    return { command: 'claude', args: ['-p', '--permission-mode', worker.permissionMode, ...option('--model', worker.model), ...option('--effort', worker.effort), ...instructions, '--', task] };
+}
+/** The command line that checks a kind's program is installed (ADR 0021, 37). */
+export const checkCommand = (kind) => ({ command: kind, args: ['--version'] });
+const eventSchema = z.object({ type: z.string(), part: z.object({ text: z.string().exactOptional() }).exactOptional(), error: z.object({ message: z.string().exactOptional() }).exactOptional() });
+function eventOf(line) {
+    if (!line.trimStart().startsWith('{'))
+        return undefined;
+    let value;
+    try {
+        value = JSON.parse(line);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+    const parsed = eventSchema.safeParse(value);
+    return parsed.success ? parsed.data : undefined;
+}
+// opencode prints one JSON event per line: the answer is the text after the last tool call, and an error event's
+// message is a reason. A line that isn't an event is ignored.
+function opencodeAnswer(stdout) {
+    let texts = [];
+    const reasons = [];
+    for (const line of stdout.split('\n')) {
+        const event = eventOf(line);
+        if (event === undefined)
+            continue;
+        if (event.type === 'tool_use')
+            texts = [];
+        else if (event.type === 'text' && event.part?.text !== undefined)
+            texts.push(event.part.text);
+        else if (event.type === 'error' && event.error?.message !== undefined)
+            reasons.push(event.error.message);
+    }
+    return { answer: texts.join('\n\n').trim(), reasons };
+}
+/** A program's answer from its standard output, and the reasons it gave for a failure. */
+export function answerOf(kind, stdout) {
+    return kind === 'opencode' ? opencodeAnswer(stdout) : { answer: stdout.trim(), reasons: [] };
+}
+/** What a run returns to the model, and whether it is an error (ADR 0021, 32). */
+export function runResult(worker, end) {
+    if (end.startError !== null)
+        return { text: `${worker.name} could not start: ${end.startError}`, isError: true };
+    const { answer, reasons } = answerOf(worker.kind, end.stdout);
+    if (!end.timedOut && end.exitCode === 0)
+        return answer === '' ? { text: `${worker.name} returned no answer`, isError: true } : { text: truncate(answer), isError: false };
+    const first = end.timedOut ? `${worker.name} timed out after ${Math.round(worker.timeoutMs / 1000)} s` : `${worker.name} exited with code ${String(end.exitCode)}`;
+    return { text: truncate([first, ...reasons, end.stderr.trim(), answer].filter((part) => part !== '').join('\n')), isError: true };
+}
+//# sourceMappingURL=programs.js.map

package/dist/delegate/programs.js.map

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

package/dist/delegate/register-worker-run.d.ts

@@ -0,0 +1,9 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function runLost(ctx: Ctx, jobId: string, code: string): Promise<void>;
+/** The checks of the workspace's program workers, as a session keeps them (ADR 0021, 37). */
+export declare function workerChecks(ctx: Ctx): Promise<{
+    name: string;
+    passed: boolean;
+}[]>;
+export declare function registerWorkerRun(ctx: Ctx): void;
+//# sourceMappingURL=register-worker-run.d.ts.map

package/dist/delegate/register-worker-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-worker-run.d.ts","sourceRoot":"","sources":["../../src/delegate/register-worker-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAiBzC,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAelF;AAED,6FAA6F;AAC7F,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,EAAE,CAAC,CAGzF;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA8BhD"}