@kvman/kvcoder 0.1.0

package/dist/connectors/background.js

@@ -0,0 +1,56 @@
+import { z } from '@kvman/sdk';
+import { cancelJob, jobDetail, jobRows } from "../jobs/job-rows.js";
+import { callInput } from "./connector-command.js";
+// The `background` connector (plan 08 §8.5, ADR 0011, 6): what this chat started with `background: true`, a process or
+// a subagent, listed, read, or stopped by the id the starting call returned. The agent sees no kernel job.
+/** What the prompt's index says the connector is for. */
+export const backgroundDescription = 'Follow up on what you started with background set to true: a server or other long-running shell line, or a background subagent. Use it to see its status or output, or to stop it.';
+const started = z.strictObject({ id: z.string().min(1).describe('The id that the call which started the work returned.') });
+const payloads = { list: z.strictObject({}), output: started, stop: started };
+export const backgroundCommands = {
+    list: { registration: 'kvcoder.background.list', description: "Lists this chat's newest 50 background runs, newest first.", payload: payloads.list, asks: false },
+    output: { registration: 'kvcoder.background.output.get', description: "Gives one background run's status, and its output (a process's last 100 lines, a subagent's answer, or what a program worker's run returned).", payload: payloads.output, asks: false },
+    stop: { registration: 'kvcoder.background.stop', description: "Stops a background process or a program worker's run, or cancels a background subagent.", payload: payloads.stop, asks: false },
+};
+const rowSchema = z.object({
+    id: z.string(),
+    kind: z.enum(['process', 'subagent', 'worker']),
+    call: z.string(),
+    status: z.string(),
+    startedAt: z.string(),
+    endedAt: z.string().exactOptional(),
+    exitCode: z.number().int().exactOptional(),
+});
+const forAgent = (row) => ({ id: row.id, kind: row.kind, call: row.call, status: row.status, startedAt: row.startedAt, ...(row.endedAt === undefined ? {} : { endedAt: row.endedAt }), ...(row.exitCode === undefined ? {} : { exitCode: row.exitCode }) });
+async function startedBy(ctx, sessionId, id) {
+    const found = await jobDetail(ctx, sessionId, id);
+    if (found === undefined)
+        throw ctx.problem('kvcoder/JOB_NOT_FOUND', { sessionId, id });
+    return found;
+}
+const commands = backgroundCommands;
+export function registerBackgroundConnector(ctx) {
+    ctx.registerQuery('kvcoder.background.list', {
+        description: commands.list.description,
+        input: callInput(payloads.list),
+        output: z.array(rowSchema),
+        handle: async ({ sessionId }) => (await jobRows(ctx, sessionId)).map(forAgent),
+    });
+    ctx.registerQuery('kvcoder.background.output.get', {
+        description: commands.output.description,
+        input: callInput(payloads.output),
+        output: rowSchema.extend({ output: z.json().exactOptional(), problem: z.json().exactOptional() }),
+        handle: async ({ sessionId, payload }) => {
+            const found = await startedBy(ctx, sessionId, payload.id);
+            return { ...forAgent(found.row), ...found.detail };
+        },
+    });
+    ctx.registerCommand('kvcoder.background.stop', {
+        description: commands.stop.description,
+        input: callInput(payloads.stop),
+        output: z.object({ stopped: z.boolean() }),
+        retries: 0,
+        handle: async ({ sessionId, payload }) => ({ stopped: await cancelJob(ctx, sessionId, (await startedBy(ctx, sessionId, payload.id)).row, 'agent') }),
+    });
+}
+//# sourceMappingURL=background.js.map

package/dist/connectors/background.js.map

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

package/dist/connectors/binary.d.ts

@@ -0,0 +1,5 @@
+import { type Ctx } from '@kvman/sdk';
+import { type ConnectorCommand } from './connector-command.ts';
+export declare const binaryExec: ConnectorCommand;
+export declare function registerBinaryConnector(ctx: Ctx): void;
+//# sourceMappingURL=binary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../src/connectors/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAIzC,OAAO,EAA6B,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAS1F,eAAO,MAAM,UAAU,EAAE,gBAAqN,CAAC;AAE/O,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAatD"}

package/dist/connectors/binary.js

@@ -0,0 +1,27 @@
+import { z } from '@kvman/sdk';
+import { lineRunOptions, lineRunSchema, runLine } from "../calls/line-run.js";
+import { notFound } from "../problems.js";
+import { activeConnectors } from "../registry/register-connectors.js";
+import { lineCallInput, lineResult } from "./connector-command.js";
+import { background, risky, timeoutMs } from "./payload-fields.js";
+// A binary connector (plan 08 §8.4, ADR 0011, 5): a program on the system, registered by an extension or named in
+// `kvcoder.connectors`. Every one has the same command besides `help`: `exec` runs `<name> <args>` in the real shell,
+// with the approval, timeout, and background rules of `shell exec`.
+const execPayload = z.strictObject({ args: z.string().describe("The program's arguments, as you would type them after its name.").exactOptional(), background, timeoutMs, risky });
+export const binaryExec = { registration: 'kvcoder.binary.run', description: 'Runs the program with the given arguments in the real shell, in the workspace folder.', payload: execPayload, asks: true, result: lineResult };
+export function registerBinaryConnector(ctx) {
+    ctx.registerCommand('kvcoder.binary.run', {
+        description: binaryExec.description,
+        input: lineCallInput(execPayload).extend({ connector: z.string().describe('The binary connector whose program runs.') }),
+        output: lineRunSchema,
+        ...lineRunOptions,
+        handle: async ({ sessionId, description, connector, payload }) => {
+            const binary = (await activeConnectors(ctx)).find((candidate) => candidate.name === connector && candidate.kind === 'binary');
+            if (binary === undefined)
+                throw notFound(`There is no binary connector ${connector}.`, { connector });
+            const args = payload.args?.trim() ?? '';
+            return runLine(ctx, { sessionId, description }, args === '' ? connector : `${connector} ${args}`, payload);
+        },
+    });
+}
+//# sourceMappingURL=binary.js.map

package/dist/connectors/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../src/connectors/binary.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,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAyB,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEnE,kHAAkH;AAClH,sHAAsH;AACtH,oEAAoE;AAEpE,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC,CAAC,aAAa,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAEnL,MAAM,CAAC,MAAM,UAAU,GAAqB,EAAE,YAAY,EAAE,oBAAoB,EAAE,WAAW,EAAE,uFAAuF,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAE/O,MAAM,UAAU,uBAAuB,CAAC,GAAQ;IAC9C,GAAG,CAAC,eAAe,CAAC,oBAAoB,EAAE;QACxC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC,EAAE,CAAC;QACxH,MAAM,EAAE,aAAa;QACrB,GAAG,cAAc;QACjB,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/D,MAAM,MAAM,GAAG,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YAC9H,IAAI,MAAM,KAAK,SAAS;gBAAE,MAAM,QAAQ,CAAC,gCAAgC,SAAS,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACtG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QAC7G,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/connectors/builtin-connectors.d.ts

@@ -0,0 +1,217 @@
+import { type BuiltinConnector } from '../connector-call.ts';
+import { type ConnectorCommand } from './connector-command.ts';
+export declare const builtinCommands: {
+    shell: {
+        exec: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                line: import("zod").ZodString;
+                background: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
+                timeoutMs: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                risky: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strict>;
+            asks: true;
+            result: string;
+        };
+    };
+    fs: {
+        read: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                fromLine: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                lines: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            bounded: true;
+        };
+        list: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                path: import("zod").ZodExactOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            bounded: true;
+        };
+        search: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                pattern: import("zod").ZodString;
+                path: import("zod").ZodExactOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            bounded: true;
+        };
+        write: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                content: import("zod").ZodString;
+                risky: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strict>;
+            asks: true;
+        };
+        edit: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                edits: import("zod").ZodArray<import("zod").ZodObject<{
+                    oldText: import("zod").ZodString;
+                    newText: import("zod").ZodString;
+                }, import("zod/v4/core").$strict>>;
+                risky: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strict>;
+            asks: true;
+        };
+    };
+    artifact: {
+        write: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                title: import("zod").ZodString;
+                format: import("zod").ZodExactOptional<import("zod").ZodEnum<{
+                    markdown: "markdown";
+                    html: "html";
+                    url: "url";
+                }>>;
+                content: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            notes: string;
+        };
+        edit: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                edits: import("zod").ZodArray<import("zod").ZodObject<{
+                    oldText: import("zod").ZodString;
+                    newText: import("zod").ZodString;
+                }, import("zod/v4/core").$strict>>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+        get: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+    };
+    background: {
+        list: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{}, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+        output: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+        stop: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+    };
+    ask: {
+        text: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                prompt: import("zod").ZodString;
+                placeholder: import("zod").ZodExactOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
+        choice: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                prompt: import("zod").ZodString;
+                multiple: import("zod").ZodBoolean;
+                options: import("zod").ZodArray<import("zod").ZodObject<{
+                    id: import("zod").ZodString;
+                    label: import("zod").ZodString;
+                    description: import("zod").ZodExactOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strict>>;
+                other: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
+        confirm: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                prompt: import("zod").ZodString;
+                danger: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
+    };
+    delegate: {
+        run: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                worker: import("zod").ZodString;
+                task: import("zod").ZodString;
+                background: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
+    };
+    mcp: {
+        tools: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                server: import("zod").ZodString;
+                tool: import("zod").ZodExactOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+        call: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                server: import("zod").ZodString;
+                tool: import("zod").ZodString;
+                arguments: import("zod").ZodExactOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>>;
+                timeoutMs: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                risky: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strict>;
+            asks: true;
+            result: string;
+        };
+    };
+};
+/** A built-in connector's commands by name, in the order `help` lists them. */
+export declare function commandsOf(connector: BuiltinConnector): Readonly<Record<string, ConnectorCommand>>;
+/** What the prompt's connector index and `help` say each built-in connector is for; `shell` names the shell this run uses. */
+export declare function builtinDescriptions(shell: 'bash' | 'powershell'): Record<BuiltinConnector, string>;
+/** Each built-in connector's command payloads' signatures, one per command, in `commandsOf`'s order. */
+export declare const builtinSignatures: Record<BuiltinConnector, readonly string[]>;
+//# sourceMappingURL=builtin-connectors.d.ts.map

package/dist/connectors/builtin-connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-connectors.d.ts","sourceRoot":"","sources":["../../src/connectors/builtin-connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI/E,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AASlF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ0C,CAAC;AAEvE,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,SAAS,EAAE,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAElG;AAED,8HAA8H;AAC9H,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAElG;AAYD,wGAAwG;AACxG,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAQzE,CAAC"}

package/dist/connectors/builtin-connectors.js

@@ -0,0 +1,49 @@
+import { payloadSignature } from "../connector-call.js";
+import { artifactCommands, artifactDescription } from "./artifact.js";
+import { askCommands, askDescription } from "./ask.js";
+import { backgroundCommands, backgroundDescription } from "./background.js";
+import { payloadJsonSchema } from "./connector-command.js";
+import { delegateCommands, delegateDescription } from "./delegate.js";
+import { fsCommands, fsDescription } from "./fs.js";
+import { mcpCommands, mcpDescription } from "./mcp.js";
+import { shellCommands, shellDescription } from "./shell.js";
+// kvcoder's own connectors together (plan 08 §8.3 and §8.5): each lives in its own file, with its description, its
+// payloads, its commands, and the jobs behind them.
+export const builtinCommands = {
+    shell: shellCommands,
+    fs: fsCommands,
+    artifact: artifactCommands,
+    background: backgroundCommands,
+    ask: askCommands,
+    delegate: delegateCommands,
+    mcp: mcpCommands,
+};
+/** A built-in connector's commands by name, in the order `help` lists them. */
+export function commandsOf(connector) {
+    return builtinCommands[connector];
+}
+/** What the prompt's connector index and `help` say each built-in connector is for; `shell` names the shell this run uses. */
+export function builtinDescriptions(shell) {
+    return { shell: shellDescription(shell), fs: fsDescription, artifact: artifactDescription, background: backgroundDescription, ask: askDescription, delegate: delegateDescription, mcp: mcpDescription };
+}
+// Each built-in payload is an object, so a missing signature is a programming error, not a case the prompt may fall
+// back from; computed once per worker, not at every prompt build. In the order of `commandsOf`, like the prompt's lines.
+function signaturesOf(connector) {
+    return Object.values(commandsOf(connector)).map((command) => {
+        const signature = payloadSignature(payloadJsonSchema(command.payload));
+        if (signature === undefined)
+            throw new Error(`The payload of a ${connector} command has no signature.`);
+        return signature;
+    });
+}
+/** Each built-in connector's command payloads' signatures, one per command, in `commandsOf`'s order. */
+export const builtinSignatures = {
+    shell: signaturesOf('shell'),
+    fs: signaturesOf('fs'),
+    artifact: signaturesOf('artifact'),
+    background: signaturesOf('background'),
+    ask: signaturesOf('ask'),
+    delegate: signaturesOf('delegate'),
+    mcp: signaturesOf('mcp'),
+};
+//# sourceMappingURL=builtin-connectors.js.map

package/dist/connectors/builtin-connectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-connectors.js","sourceRoot":"","sources":["../../src/connectors/builtin-connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAyB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAyB,MAAM,wBAAwB,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,mHAAmH;AACnH,oDAAoD;AAEpD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,aAAa;IACpB,EAAE,EAAE,UAAU;IACd,QAAQ,EAAE,gBAAgB;IAC1B,UAAU,EAAE,kBAAkB;IAC9B,GAAG,EAAE,WAAW;IAChB,QAAQ,EAAE,gBAAgB;IAC1B,GAAG,EAAE,WAAW;CACoD,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,SAA2B;IACpD,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,8HAA8H;AAC9H,MAAM,UAAU,mBAAmB,CAAC,KAA4B;IAC9D,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,mBAAmB,EAAE,UAAU,EAAE,qBAAqB,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;AAC1M,CAAC;AAED,oHAAoH;AACpH,yHAAyH;AACzH,SAAS,YAAY,CAAC,SAA2B;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC1D,MAAM,SAAS,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,IAAI,SAAS,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,SAAS,4BAA4B,CAAC,CAAC;QACxG,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wGAAwG;AACxG,MAAM,CAAC,MAAM,iBAAiB,GAAgD;IAC5E,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC;IAC5B,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC;IAClC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;IACtC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC;IAClC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC;CACzB,CAAC"}

package/dist/connectors/connector-command.d.ts

@@ -0,0 +1,26 @@
+import { z, type Json } from '@kvman/sdk';
+export type ConnectorCommand = {
+    registration: string;
+    description: string;
+    payload: z.ZodType;
+    asks: boolean;
+    result?: string;
+    notes?: string;
+    bounded?: true;
+};
+/** What `shell exec` and a binary's `exec` return. */
+export declare const lineResult = "the combined output, then [exit code N].";
+/** A payload schema as JSON Schema, the way the kernel shows an input (plan 02 §2.12). */
+export declare function payloadJsonSchema(payload: z.ZodType): Json;
+/** A built-in command's job input: the chat it runs for, and the payload. */
+export declare function callInput<Payload extends z.ZodType>(payload: Payload): z.ZodObject<{
+    sessionId: z.ZodString;
+    payload: Payload;
+}, z.core.$strict>;
+/** The same for a command that runs in the real shell: with the call's description, which names a background run. */
+export declare function lineCallInput<Payload extends z.ZodType>(payload: Payload): z.ZodObject<{
+    sessionId: z.ZodString;
+    description: z.ZodString;
+    payload: Payload;
+}, z.core.$strict>;
+//# sourceMappingURL=connector-command.d.ts.map

package/dist/connectors/connector-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-command.d.ts","sourceRoot":"","sources":["../../src/connectors/connector-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAO1C,MAAM,MAAM,gBAAgB,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjK,sDAAsD;AACtD,eAAO,MAAM,UAAU,6CAA6C,CAAC;AAErE,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,GAAG,IAAI,CAE1D;AAID,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO;;;mBAEpE;AAED,qHAAqH;AACrH,wBAAgB,aAAa,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO;;;;mBAExE"}

package/dist/connectors/connector-command.js

@@ -0,0 +1,17 @@
+import { z } from '@kvman/sdk';
+/** What `shell exec` and a binary's `exec` return. */
+export const lineResult = 'the combined output, then [exit code N].';
+/** A payload schema as JSON Schema, the way the kernel shows an input (plan 02 §2.12). */
+export function payloadJsonSchema(payload) {
+    return z.json().parse(z.toJSONSchema(payload, { io: 'input', unrepresentable: 'any' }));
+}
+const sessionId = z.string().describe('The chat the call belongs to.');
+/** A built-in command's job input: the chat it runs for, and the payload. */
+export function callInput(payload) {
+    return z.strictObject({ sessionId, payload: payload.describe("The command's payload.") });
+}
+/** The same for a command that runs in the real shell: with the call's description, which names a background run. */
+export function lineCallInput(payload) {
+    return z.strictObject({ sessionId, description: z.string().describe("The call's description, for the person."), payload: payload.describe("The command's payload.") });
+}
+//# sourceMappingURL=connector-command.js.map

package/dist/connectors/connector-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-command.js","sourceRoot":"","sources":["../../src/connectors/connector-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAa,MAAM,YAAY,CAAC;AAS1C,sDAAsD;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,0CAA0C,CAAC;AAErE,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,OAAkB;IAClD,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC,CAAC;AAEvE,6EAA6E;AAC7E,MAAM,UAAU,SAAS,CAA4B,OAAgB;IACnE,OAAO,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC;AAED,qHAAqH;AACrH,MAAM,UAAU,aAAa,CAA4B,OAAgB;IACvE,OAAO,CAAC,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;AACzK,CAAC"}

package/dist/connectors/delegate.d.ts

@@ -0,0 +1,32 @@
+import { z, type Ctx, type Stored } from '@kvman/sdk';
+import { type SubagentWorker, type Worker } from '../delegate/workers.ts';
+import type { SessionDoc } from '../schemas/records.ts';
+/** What the prompt's index says the connector is for; the session's entry adds its workers. */
+export declare const delegateDescription = "Hand a self-contained task to a worker: a helper agent that works on it alone and returns its answer. Use it for a specialist view or to do a separate part in parallel, or with background set to true while you go on.";
+/** The connector's description with the available workers, as the prompt's index shows it (ADR 0021, 1). */
+export declare function delegateIndexDescription(workers: readonly Worker[]): string;
+export declare const delegateRunSchema: z.ZodObject<{
+    worker: z.ZodString;
+    task: z.ZodString;
+    background: z.ZodExactOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export declare const delegateCommands: {
+    run: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            worker: z.ZodString;
+            task: z.ZodString;
+            background: z.ZodExactOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
+};
+export type DelegateRun = z.output<typeof delegateRunSchema>;
+export declare function registerDelegateConnector(ctx: Ctx): void;
+/** Creates the worker's child session, with the task as its first message. */
+export declare function createChild(ctx: Ctx, parent: Stored<SessionDoc>, worker: SubagentWorker, task: string): Promise<string>;
+/** Starts the child's turn and tells the parent's stream, so the conversation can stream the child (ADR 0009, 99). */
+export declare function startChild(ctx: Ctx, childId: string): Promise<void>;
+//# sourceMappingURL=delegate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/connectors/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAE3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAYxD,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,6NAC4L,CAAC;AAE7N,4GAA4G;AAC5G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE3E;AAED,eAAO,MAAM,iBAAiB;;;;kBAI5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAEe,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAYxD;AAED,8EAA8E;AAC9E,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4B7H;AAED,sHAAsH;AACtH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE"}

package/dist/connectors/delegate.js

@@ -0,0 +1,82 @@
+import { z } from '@kvman/sdk';
+import { availableWorker } from "../delegate/workers.js";
+import { firePoint } from "../registry/session-points.js";
+import { now } from "../sessions/session-lookup.js";
+import { records, txRecords } from "../store/collections.js";
+import { appendMessage, noUsage, userContent } from "../turns/history.js";
+import { beginTurn, openTurn } from "../turns/start-turn.js";
+import { callInput } from "./connector-command.js";
+// The `delegate` connector (plan 08 §8.5, ADR 0021): a task handed to a worker. A subagent worker runs it in a hidden
+// child session that starts from the task alone, with the worker's instructions, connectors, model, and thinking; a
+// child never has `delegate` and always has `ask`. A program worker's run is in `src/delegate/`. The check validates the payload and the worker as a kernel job, and the
+// step then starts the child (ADR 0011, 9).
+/** What the prompt's index says the connector is for; the session's entry adds its workers. */
+export const delegateDescription = 'Hand a self-contained task to a worker: a helper agent that works on it alone and returns its answer. Use it for a specialist view or to do a separate part in parallel, or with background set to true while you go on.';
+/** The connector's description with the available workers, as the prompt's index shows it (ADR 0021, 1). */
+export function delegateIndexDescription(workers) {
+    return `${delegateDescription} Workers: ${workers.map((worker) => `${worker.name} (${worker.description.replace(/[.\s]+$/, '')})`).join(', ')}.`;
+}
+export const delegateRunSchema = z.strictObject({
+    worker: z.string().min(1).describe('The worker to hand the task to, by a name the system prompt lists.'),
+    task: z.string().min(1).describe("The worker's whole brief: the goal, the facts it needs, its limits, and what to return."),
+    background: z.boolean().describe('true lets you go on at once; the answer arrives later as a message.').exactOptional(),
+});
+export const delegateCommands = {
+    run: { registration: 'kvcoder.delegate.check', description: 'Runs a worker on a task; several runs in one reply run in parallel.', payload: delegateRunSchema, asks: false, result: "the worker's final answer, or started <id> with background." },
+};
+export function registerDelegateConnector(ctx) {
+    ctx.registerCommand('kvcoder.delegate.check', {
+        description: delegateCommands.run.description,
+        input: callInput(delegateRunSchema),
+        output: z.object({}),
+        retries: 0,
+        handle: async ({ sessionId, payload }) => {
+            const session = await records(ctx.store).sessions.get(sessionId);
+            await availableWorker(ctx, session?.checks ?? null, payload.worker);
+            return {};
+        },
+    });
+}
+/** Creates the worker's child session, with the task as its first message. */
+export async function createChild(ctx, parent, worker, task) {
+    const childId = await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const stamp = now();
+        const child = store.sessions.insert({
+            title: task.slice(0, 60),
+            autoTitle: false,
+            status: 'idle',
+            parentId: parent.id,
+            worker: { name: worker.name, instructions: worker.instructions },
+            model: worker.model ?? parent.model,
+            thinking: worker.thinking ?? parent.thinking,
+            stepJobId: null,
+            turnId: null,
+            endedTurns: 0,
+            nextSeq: 0,
+            usage: noUsage(),
+            durationMs: 0,
+            checks: null,
+            connectors: worker.connectors,
+            createdAt: stamp,
+            updatedAt: stamp,
+        });
+        appendMessage(store, child, { kind: 'user', content: userContent(task), source: { kind: 'subagent', sessionId: parent.id } });
+        return child.id;
+    });
+    await firePoint(ctx, 'kvcoder.session.created', { sessionId: childId, parentId: parent.id });
+    return childId;
+}
+/** Starts the child's turn and tells the parent's stream, so the conversation can stream the child (ADR 0009, 99). */
+export async function startChild(ctx, childId) {
+    const turnId = await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const child = store.sessions.get(childId);
+        return child === undefined || child.status !== 'idle' ? undefined : openTurn(store, child);
+    });
+    if (turnId === undefined)
+        return;
+    const jobId = await beginTurn(ctx, childId, turnId, false);
+    ctx.job.progress({ type: 'subagent', sessionId: childId, jobId });
+}
+//# sourceMappingURL=delegate.js.map

package/dist/connectors/delegate.js.map

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

package/dist/connectors/fs.d.ts

@@ -0,0 +1,60 @@
+import { z, type Ctx } from '@kvman/sdk';
+/** What the prompt's index says the connector is for. */
+export declare 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.";
+export declare const fsCommands: {
+    read: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            path: z.ZodString;
+            fromLine: z.ZodExactOptional<z.ZodNumber>;
+            lines: z.ZodExactOptional<z.ZodNumber>;
+        }, z.core.$strict>;
+        asks: false;
+        bounded: true;
+    };
+    list: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            path: z.ZodExactOptional<z.ZodString>;
+        }, z.core.$strict>;
+        asks: false;
+        bounded: true;
+    };
+    search: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            pattern: z.ZodString;
+            path: z.ZodExactOptional<z.ZodString>;
+        }, z.core.$strict>;
+        asks: false;
+        bounded: true;
+    };
+    write: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            path: z.ZodString;
+            content: z.ZodString;
+            risky: z.ZodBoolean;
+        }, z.core.$strict>;
+        asks: true;
+    };
+    edit: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            path: z.ZodString;
+            edits: z.ZodArray<z.ZodObject<{
+                oldText: z.ZodString;
+                newText: z.ZodString;
+            }, z.core.$strict>>;
+            risky: z.ZodBoolean;
+        }, z.core.$strict>;
+        asks: true;
+    };
+};
+export declare function registerFsConnector(ctx: Ctx): void;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/connectors/fs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAczC,yDAAyD;AACzD,eAAO,MAAM,aAAa,sRAC2P,CAAC;AAmBtR,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMqB,CAAC;AA6D7C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAmClD"}