@kvman/kvcoder 0.1.0

package/dist/connector-call.d.ts

@@ -0,0 +1,66 @@
+import { z, type Json, type Problem } from '@kvman/sdk';
+/** A JSON value as zod parses it. */
+export type JsonValue = z.output<ReturnType<typeof z.json>>;
+/** What a connector call returned, and whether it failed (exit code 1). */
+export type CallResult = {
+    output: string;
+    exitCode: number;
+};
+/** The connectors kvcoder runs itself, in the order the prompt lists them. */
+export declare const builtinConnectors: readonly ["shell", "fs", "artifact", "background", "ask", "delegate", "mcp"];
+export type BuiltinConnector = (typeof builtinConnectors)[number];
+/** A Problem as a connector call returns it. */
+export declare function errorOutput(problem: Pick<Problem, 'code' | 'message'>): CallResult;
+/** A connector command's JSON output, indented by 2 spaces. */
+export declare function jsonOutput(value: unknown): CallResult;
+export declare const noConnectorMessage: (connector: string, names: readonly string[]) => string;
+/** A connector has no such command: the message names the ones it has, and cuts a long wrong name, which is usually a shell line (ADR 0012, 19). */
+export declare function noCommandMessage(connector: string, command: string, commands: readonly string[]): string;
+export type PayloadIssue = {
+    path: string;
+    message: string;
+};
+/** A payload's signature written from its JSON Schema, such as `{ a, b?, c: [{ x }] }`; `undefined` when the schema isn't an object with properties. */
+export declare function payloadSignature(schema: Json | undefined): string | undefined;
+/** An invalid payload as the model reads it: each problem, then the command's signature so one correction is enough (ADR 0012, 2 to 4). */
+export declare function invalidPayloadOutput(call: {
+    connector: string;
+    command: string;
+}, issues: readonly PayloadIssue[], schema: Json | undefined): CallResult;
+/** One run of a connector's command: how to run it, and how to find its payload schema when the payload doesn't fit. */
+export type CommandRun = {
+    connector: string;
+    command: string;
+    /** Where the payload sits in the job's input: `payload` for a built-in command, nothing for a registered one. */
+    payloadPath: string;
+    exec(): Promise<unknown>;
+    payloadSchema(): Promise<Json | undefined>;
+    /** Whether the calling job was cancelled, so its Problem is rethrown instead of returned. */
+    cancelled(): boolean;
+};
+/** Runs a connector's command: its output, or the failure the model reads. */
+export declare function runCommand(run: CommandRun): Promise<{
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    result: CallResult;
+}>;
+/** The test kernel `runConnector` needs: `@kvman/testkit`'s, with kvcoder loaded. */
+export type ConnectorKernel = {
+    exec(name: string, input: Record<string, Json>, options?: {
+        as?: string;
+        workspaceId?: string;
+    }): Promise<unknown>;
+};
+/** A call as the `run` tool makes it, without its description. */
+export type ConnectorCall = {
+    connector: string;
+    command: string;
+    payload?: Record<string, Json>;
+};
+/** Runs a call exactly as kvcoder does, for commands connectors and every connector's `help` (ADR 0009, 96; ADR 0011, 18). */
+export declare function runConnector(kernel: ConnectorKernel, call: ConnectorCall, options?: {
+    workspaceId?: string;
+}): Promise<CallResult>;
+//# sourceMappingURL=connector-call.d.ts.map

package/dist/connector-call.d.ts.map

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

package/dist/connector-call.js

@@ -0,0 +1,133 @@
+import { ProblemError, z } from '@kvman/sdk';
+/** The connectors kvcoder runs itself, in the order the prompt lists them. */
+export const builtinConnectors = ['shell', 'fs', 'artifact', 'background', 'ask', 'delegate', 'mcp'];
+/** A Problem as a connector call returns it. */
+export function errorOutput(problem) {
+    return { output: `error ${problem.code}: ${problem.message}`, exitCode: 1 };
+}
+/** A connector command's JSON output, indented by 2 spaces. */
+export function jsonOutput(value) {
+    return { output: JSON.stringify(value ?? null, null, 2), exitCode: 0 };
+}
+export const noConnectorMessage = (connector, names) => `There is no connector ${connector}. The connectors are: ${names.join(', ')}.`;
+const shownCommandLength = 40;
+/** A connector has no such command: the message names the ones it has, and cuts a long wrong name, which is usually a shell line (ADR 0012, 19). */
+export function noCommandMessage(connector, command, commands) {
+    const shown = command.length > shownCommandLength ? `${command.slice(0, shownCommandLength)}…` : command;
+    return `${connector} has no command ${shown}. Its commands are: ${[...commands, 'help'].join(', ')}.`;
+}
+const field = z.lazy(() => z.looseObject({
+    type: z.string().optional(),
+    enum: z.array(z.json()).optional(),
+    properties: z.record(z.string(), field).optional(),
+    required: z.array(z.string()).optional(),
+    items: field.optional(),
+}));
+// The top of a payload's schema: an object with properties, as the kernel's `z.toJSONSchema` writes it.
+const payloadObject = z.looseObject({ type: z.literal('object'), properties: z.record(z.string(), field), required: z.array(z.string()).optional() });
+function objectSignature(schema) {
+    const entries = Object.entries(schema.properties ?? {});
+    if (entries.length === 0)
+        return '{}';
+    const required = new Set(schema.required ?? []);
+    return `{ ${entries.map(([name, child]) => fieldSignature(name, child, required.has(name))).join(', ')} }`;
+}
+function fieldSignature(name, schema, required) {
+    const mark = required ? '' : '?';
+    if (schema.properties !== undefined)
+        return `${name}${mark}: ${objectSignature(schema)}`;
+    if (schema.type === 'array' && schema.items?.properties !== undefined)
+        return `${name}${mark}: [${objectSignature(schema.items)}]`;
+    if (schema.enum !== undefined && schema.enum.length > 0 && schema.enum.every((value) => typeof value === 'string')) {
+        return `${name}${mark}: ${schema.enum.map((value) => JSON.stringify(value)).join(' | ')}`;
+    }
+    return `${name}${mark}`;
+}
+/** A payload's signature written from its JSON Schema, such as `{ a, b?, c: [{ x }] }`; `undefined` when the schema isn't an object with properties. */
+export function payloadSignature(schema) {
+    if (schema === undefined)
+        return undefined;
+    const parsed = payloadObject.safeParse(schema);
+    return parsed.success ? objectSignature(parsed.data) : undefined;
+}
+function withoutSchemaKey(schema) {
+    if (typeof schema !== 'object' || schema === null || Array.isArray(schema))
+        return schema;
+    return Object.fromEntries(Object.entries(schema).filter(([key]) => key !== '$schema'));
+}
+/** An invalid payload as the model reads it: each problem, then the command's signature so one correction is enough (ADR 0012, 2 to 4). */
+export function invalidPayloadOutput(call, issues, schema) {
+    const problems = issues.map((issue) => `${issue.path === '' ? 'payload' : issue.path}: ${issue.message}`).join('; ');
+    let shape = '';
+    if (schema !== undefined) {
+        const signature = payloadSignature(schema);
+        shape = signature === undefined ? ` The payload of ${call.connector} ${call.command} is (JSON Schema):\n${JSON.stringify(withoutSchemaKey(schema))}` : ` The payload of ${call.connector} ${call.command} is\n${signature}`;
+    }
+    return errorOutput({ code: 'VALIDATION_FAILED', message: `${problems}.${shape}` });
+}
+const kernelIssuesSchema = z.object({ issues: z.array(z.object({ path: z.string(), message: z.string() })).min(1) });
+// The kernel's issue paths start at the job's input; a built-in command's payload is the input's `payload` field.
+function withoutPrefix(path, prefix) {
+    if (prefix === '')
+        return path;
+    if (path === prefix)
+        return '';
+    return path.startsWith(`${prefix}.`) ? path.slice(prefix.length + 1) : path;
+}
+/** Runs a connector's command: its output, or the failure the model reads. */
+export async function runCommand(run) {
+    try {
+        return { ok: true, value: await run.exec() };
+    }
+    catch (error) {
+        if (!(error instanceof ProblemError) || run.cancelled())
+            throw error;
+        const invalid = error.problem.code === 'VALIDATION_FAILED' ? kernelIssuesSchema.safeParse(error.problem.params) : undefined;
+        if (invalid?.success !== true)
+            return { ok: false, result: errorOutput(error.problem) };
+        const issues = invalid.data.issues.map((issue) => ({ path: withoutPrefix(issue.path, run.payloadPath), message: issue.message }));
+        return { ok: false, result: invalidPayloadOutput(run, issues, await run.payloadSchema()) };
+    }
+}
+const connectorListSchema = z.array(z.object({ name: z.string(), kind: z.enum(['commands', 'binary']), commands: z.array(z.object({ name: z.string(), command: z.string() })).exactOptional() }));
+const registrationSchema = z.object({ name: z.string(), input: z.json() });
+const extensionsSchema = z.array(z.object({ commands: z.array(registrationSchema), queries: z.array(registrationSchema) }));
+const helpSchema = z.object({ text: z.string() });
+const insideTurn = (connector) => ({ output: `${connector} runs only inside a turn`, exitCode: 1 });
+/** Runs a call exactly as kvcoder does, for commands connectors and every connector's `help` (ADR 0009, 96; ADR 0011, 18). */
+export async function runConnector(kernel, call, options = {}) {
+    const as = { as: '@kvman/kvcoder', ...options };
+    const payload = call.payload ?? {};
+    if (call.command === 'help') {
+        const asked = typeof payload['command'] === 'string' ? { command: payload['command'] } : {};
+        try {
+            return { output: helpSchema.parse(await kernel.exec('kvcoder.connector.help.get', { connector: call.connector, ...asked }, as)).text, exitCode: 0 };
+        }
+        catch (error) {
+            if (error instanceof ProblemError)
+                return errorOutput(error.problem);
+            throw error;
+        }
+    }
+    if (builtinConnectors.some((name) => name === call.connector))
+        return insideTurn(call.connector);
+    const connectors = connectorListSchema.parse(await kernel.exec('kvcoder.connector.list', {}, as));
+    const connector = connectors.find((candidate) => candidate.name === call.connector);
+    if (connector === undefined)
+        return errorOutput({ code: 'VALIDATION_FAILED', message: noConnectorMessage(call.connector, [...builtinConnectors, ...connectors.map((candidate) => candidate.name)]) });
+    if (connector.kind === 'binary')
+        return insideTurn(call.connector);
+    const target = connector.commands?.find((candidate) => candidate.name === call.command);
+    if (target === undefined)
+        return errorOutput({ code: 'NOT_FOUND', message: noCommandMessage(call.connector, call.command, (connector.commands ?? []).map((candidate) => candidate.name)) });
+    const done = await runCommand({
+        connector: call.connector,
+        command: call.command,
+        payloadPath: '',
+        exec: () => kernel.exec(target.command, payload, as),
+        payloadSchema: async () => extensionsSchema.parse(await kernel.exec('kernel.extensions.list', {}, as)).flatMap((extension) => [...extension.commands, ...extension.queries]).find((registered) => registered.name === target.command)?.input,
+        cancelled: () => false,
+    });
+    return done.ok ? jsonOutput(done.value) : done.result;
+}
+//# sourceMappingURL=connector-call.js.map

package/dist/connector-call.js.map

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

package/dist/connectors/artifact.d.ts

@@ -0,0 +1,51 @@
+import { z, type Ctx } from '@kvman/sdk';
+import { artifactFormats } from '../artifacts/artifact-format.ts';
+/** What the prompt's index says the connector is for. */
+export declare const artifactDescription = "Show the person something to read or see: a plan, a report, a design, an HTML page, or the localhost address of an app you are running (format url). Use it for anything longer than a few lines instead of pasting it into a reply, and when you write a plan, keep it in the artifact `plan`. The panel runs the page of an HTML artifact in a sandbox where localStorage, sessionStorage, cookies, and indexedDB throw, so a page you show that way must work without them, keeping its state in memory or wrapping each use in try/catch; a url artifact is a normal page on its own address and can use them.";
+export declare const artifactCommands: {
+    write: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodString;
+            format: z.ZodExactOptional<z.ZodEnum<{
+                markdown: "markdown";
+                html: "html";
+                url: "url";
+            }>>;
+            content: z.ZodString;
+        }, z.core.$strict>;
+        asks: false;
+        notes: string;
+    };
+    edit: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            edits: z.ZodArray<z.ZodObject<{
+                oldText: z.ZodString;
+                newText: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        asks: false;
+    };
+    get: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strict>;
+        asks: false;
+    };
+};
+/** What the artifact card shows of a chat's artifact (ADR 0009, 177), or nothing when the chat has none by that id. */
+export declare function artifactCard(ctx: Ctx, sessionId: string, id: string): Promise<{
+    id: string;
+    title: string;
+    format: (typeof artifactFormats)[number];
+    version: number;
+} | undefined>;
+export declare function registerArtifactConnector(ctx: Ctx): void;
+//# sourceMappingURL=artifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/connectors/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAA4B,MAAM,iCAAiC,CAAC;AAc5F,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,ulBACsjB,CAAC;AAoBvlB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIe,CAAC;AAyC7C,uHAAuH;AACvH,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAGzL;AAID,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAyBxD"}

package/dist/connectors/artifact.js

@@ -0,0 +1,101 @@
+import { z } from '@kvman/sdk';
+import { artifactFormats, contentFor, detectFormat } from "../artifacts/artifact-format.js";
+import { artifactCountLimit, assertWithinLimit, chatIdOf } from "../artifacts/artifact-records.js";
+import { applyEdits } from "../files/edit-text.js";
+import { notFound, tooLarge } from "../problems.js";
+import { kebab } from "../schemas/registry.js";
+import { findSession, now } from "../sessions/session-lookup.js";
+import { records, txRecords } from "../store/collections.js";
+import { callInput } from "./connector-command.js";
+import { edits } from "./payload-fields.js";
+// The `artifact` connector (plan 08 §8.5, ADR 0009, 173 to 176): `write` creates or replaces the chat's document,
+// `edit` replaces text in one, `get` reads one. No approval is asked, and the step runs the calls on one artifact one
+// after another.
+/** What the prompt's index says the connector is for. */
+export const artifactDescription = 'Show the person something to read or see: a plan, a report, a design, an HTML page, or the localhost address of an app you are running (format url). Use it for anything longer than a few lines instead of pasting it into a reply, and when you write a plan, keep it in the artifact `plan`. The panel runs the page of an HTML artifact in a sandbox where localStorage, sessionStorage, cookies, and indexedDB throw, so a page you show that way must work without them, keeping its state in memory or wrapping each use in try/catch; a url artifact is a normal page on its own address and can use them.';
+const idMessage = 'An artifact id is lowercase kebab case, such as plan or login-design, up to 50 characters.';
+const artifactId = z.string().max(50, idMessage).regex(kebab, idMessage).describe('The name of the artifact within this chat, in lowercase kebab case, up to 50 characters, such as plan.');
+const payloads = {
+    write: z.strictObject({
+        id: artifactId,
+        title: z.string().min(1).max(100).describe('The title the person sees, up to 100 characters.'),
+        format: z.enum(artifactFormats).describe('markdown, html, or url. Left out, a page that starts with <!doctype html or <html is html, a lone localhost address is url, and anything else markdown.').exactOptional(),
+        content: z.string().min(1).describe('The whole content, up to 64 KB.'),
+    }),
+    edit: z.strictObject({ id: artifactId, edits }),
+    get: z.strictObject({ id: artifactId }),
+};
+const writeNotes = 'The content is up to 64 KB, and a chat holds up to 20 artifacts. An "html" artifact is one self-contained page: its scripts run, but it can load nothing from the network (no external scripts, styles, images, or fonts: use inline CSS and JS, data: images, or inline SVG) and can\'t reach the rest of the app. A "url" artifact shows an app running on this machine, such as a dev server you started: its content is one http or https address on localhost or 127.0.0.1, shown in a scripts-only frame.';
+export const artifactCommands = {
+    write: { registration: 'kvcoder.artifact.write', description: 'Creates an artifact, or replaces its title, format, and content.', payload: payloads.write, asks: false, notes: writeNotes },
+    edit: { registration: 'kvcoder.artifact.edit', description: 'Replaces exact pieces of text in an existing artifact; if one replacement fails, nothing changes.', payload: payloads.edit, asks: false },
+    get: { registration: 'kvcoder.artifact.content.get', description: 'Reads an artifact with its content.', payload: payloads.get, asks: false },
+};
+const missing = (id) => notFound(`The artifact ${id} doesn't exist.`, { id });
+// An artifact belongs to its chat, so a subagent's belongs to the chat at its root.
+const chatOf = async (ctx, sessionId) => chatIdOf(await findSession(ctx, sessionId));
+function writeArtifact(ctx, chatId, input) {
+    const format = input.format ?? detectFormat(input.content);
+    return ctx.store.transaction((tx) => {
+        const content = contentFor(format, input.content);
+        assertWithinLimit(input.id, content);
+        const artifacts = txRecords(tx).artifacts;
+        const existing = artifacts.find({ sessionId: chatId, artifactId: input.id }, { limit: 1 })[0];
+        const stamp = now();
+        if (existing === undefined) {
+            if (artifacts.count({ sessionId: chatId }) >= artifactCountLimit)
+                throw tooLarge(`The chat holds at most ${artifactCountLimit} artifacts.`, artifactCountLimit);
+            artifacts.insert({ sessionId: chatId, artifactId: input.id, title: input.title, format, content, version: 1, createdAt: stamp, updatedAt: stamp });
+            return { id: input.id, version: 1, created: true, bytes: Buffer.byteLength(content) };
+        }
+        artifacts.update(existing.id, { title: input.title, format, content, version: existing.version + 1, updatedAt: stamp });
+        return { id: input.id, version: existing.version + 1, created: false, bytes: Buffer.byteLength(content) };
+    });
+}
+function editArtifact(ctx, chatId, input) {
+    return ctx.store.transaction((tx) => {
+        const artifacts = txRecords(tx).artifacts;
+        const existing = artifacts.find({ sessionId: chatId, artifactId: input.id }, { limit: 1 })[0];
+        if (existing === undefined)
+            throw missing(input.id);
+        const edited = applyEdits(existing.content, input.edits);
+        const text = contentFor(existing.format, edited.text);
+        assertWithinLimit(input.id, text);
+        artifacts.update(existing.id, { content: text, version: existing.version + 1, updatedAt: now() });
+        return { id: input.id, version: existing.version + 1, replacements: edited.replacements, firstChangedLine: edited.firstChangedLine };
+    });
+}
+/** What the artifact card shows of a chat's artifact (ADR 0009, 177), or nothing when the chat has none by that id. */
+export async function artifactCard(ctx, sessionId, id) {
+    const found = (await records(ctx.store).artifacts.find({ sessionId: await chatOf(ctx, sessionId), artifactId: id }, { limit: 1 }))[0];
+    return found === undefined ? undefined : { id, title: found.title, format: found.format, version: found.version };
+}
+const commands = artifactCommands;
+export function registerArtifactConnector(ctx) {
+    ctx.registerCommand('kvcoder.artifact.write', {
+        description: commands.write.description,
+        input: callInput(payloads.write),
+        output: z.object({ id: z.string(), version: z.number().int(), created: z.boolean(), bytes: z.number().int() }),
+        retries: 0,
+        handle: async ({ sessionId, payload }) => writeArtifact(ctx, await chatOf(ctx, sessionId), payload),
+    });
+    ctx.registerCommand('kvcoder.artifact.edit', {
+        description: commands.edit.description,
+        input: callInput(payloads.edit),
+        output: z.object({ id: z.string(), version: z.number().int(), replacements: z.number().int(), firstChangedLine: z.number().int() }),
+        retries: 0,
+        handle: async ({ sessionId, payload }) => editArtifact(ctx, await chatOf(ctx, sessionId), payload),
+    });
+    ctx.registerQuery('kvcoder.artifact.content.get', {
+        description: commands.get.description,
+        input: callInput(payloads.get),
+        output: z.object({ id: z.string(), title: z.string(), format: z.enum(artifactFormats), version: z.number().int(), content: z.string() }),
+        handle: async ({ sessionId, payload }) => {
+            const found = (await records(ctx.store).artifacts.find({ sessionId: await chatOf(ctx, sessionId), artifactId: payload.id }, { limit: 1 }))[0];
+            if (found === undefined)
+                throw missing(payload.id);
+            return { id: payload.id, title: found.title, format: found.format, version: found.version, content: found.content };
+        },
+    });
+}
+//# sourceMappingURL=artifact.js.map

package/dist/connectors/artifact.js.map

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

package/dist/connectors/ask.d.ts

@@ -0,0 +1,58 @@
+import { z, type Ctx } from '@kvman/sdk';
+import type { QuestionDoc } from '../schemas/records.ts';
+/** What the prompt's index says the connector is for. */
+export declare const askDescription = "Put a question to the person and wait for the answer. Use it when you need a decision, a missing detail, or a go-ahead before a risky step, instead of guessing.";
+export declare const askCommands: {
+    text: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            prompt: z.ZodString;
+            placeholder: z.ZodExactOptional<z.ZodString>;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
+    choice: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            prompt: z.ZodString;
+            multiple: z.ZodBoolean;
+            options: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                label: z.ZodString;
+                description: z.ZodExactOptional<z.ZodString>;
+            }, z.core.$strict>>;
+            other: z.ZodExactOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
+    confirm: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            prompt: z.ZodString;
+            danger: z.ZodExactOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
+};
+export type QuestionKind = QuestionDoc['kind'];
+/** The kinds of question the agent asks: the `ask` connector's commands. */
+export declare const askKinds: readonly ["text", "choice", "confirm"];
+export declare const isAskKind: (command: string) => command is (typeof askKinds)[number];
+export declare function registerAskConnector(ctx: Ctx): void;
+/** An answer checked against its question: the call's result, or an approval's decision. */
+export declare function checkedAnswer(question: QuestionDoc, answer: unknown): {
+    kind: 'result';
+    text: string;
+} | {
+    kind: 'approval';
+    approved: boolean;
+};
+/** What a question, or an approval, dismissed by a message returns to the model (plan 08 §8.1). */
+export declare function dismissedText(kind: QuestionKind): string;
+//# sourceMappingURL=ask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/connectors/ask.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAGzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOzD,yDAAyD;AACzD,eAAO,MAAM,cAAc,qKAAqK,CAAC;AAsBjM,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIoB,CAAC;AAE7C,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAE/C,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,wCAAyC,CAAC;AAE/D,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,OAAO,IAAI,CAAC,OAAO,QAAQ,EAAE,MAAM,CAA8C,CAAC;AAI9H,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAKnD;AAqBD,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAahJ;AAED,mGAAmG;AACnG,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAExD"}

package/dist/connectors/ask.js

@@ -0,0 +1,85 @@
+import { z } from '@kvman/sdk';
+import { jsonOutput } from "../connector-call.js";
+import { invalid } from "../problems.js";
+import { callInput } from "./connector-command.js";
+// The `ask` connector (plan 08 §8.5): a question suspends the turn until the person answers; the answer becomes the
+// call's result, and a dismissal gives `{ "dismissed": true }`. Each command's check validates its payload as a kernel
+// job, and the step then records the question (ADR 0011, 9). Answers are checked (ADR 0009, 102).
+/** What the prompt's index says the connector is for. */
+export const askDescription = 'Put a question to the person and wait for the answer. Use it when you need a decision, a missing detail, or a go-ahead before a risky step, instead of guessing.';
+const prompt = z.string().min(1).describe('The question, as the person reads it.');
+const payloads = {
+    text: z.strictObject({ prompt, placeholder: z.string().describe('A hint shown in the empty answer box.').exactOptional() }),
+    choice: z.strictObject({
+        prompt,
+        multiple: z.boolean().describe('true when the person may choose several options.'),
+        options: z
+            .array(z.strictObject({ id: z.string().min(1).describe('What the answer names the option by.'), label: z.string().min(1).describe('The option, as the person reads it.'), description: z.string().describe('A line that explains the option.').exactOptional() }))
+            .min(2)
+            .max(10)
+            .refine((options) => new Set(options.map((option) => option.id)).size === options.length, 'Option ids must differ.')
+            .describe('Two to ten options, the recommended one first.'),
+        other: z.boolean().describe('true lets the person write an answer of their own.').exactOptional(),
+    }),
+    confirm: z.strictObject({ prompt, danger: z.boolean().describe('true marks the confirmation as destructive.').exactOptional() }),
+};
+const dismissed = ', or { "dismissed": true }.';
+export const askCommands = {
+    text: { registration: 'kvcoder.ask.text.check', description: 'Asks the person for a free answer and waits for it.', payload: payloads.text, asks: false, result: `the person's answer: { "text" }${dismissed}` },
+    choice: { registration: 'kvcoder.ask.choice.check', description: 'Asks the person to choose among options and waits for the answer.', payload: payloads.choice, asks: false, result: `the person's answer: { "selected": [ids], "other"? }${dismissed}` },
+    confirm: { registration: 'kvcoder.ask.confirm.check', description: 'Asks the person yes or no and waits for the answer.', payload: payloads.confirm, asks: false, result: `the person's answer: { "confirmed" }${dismissed}` },
+};
+/** The kinds of question the agent asks: the `ask` connector's commands. */
+export const askKinds = ['text', 'choice', 'confirm'];
+export const isAskKind = (command) => askKinds.some((kind) => kind === command);
+const noOutput = z.object({});
+export function registerAskConnector(ctx) {
+    for (const kind of askKinds) {
+        const command = askCommands[kind];
+        ctx.registerCommand(command.registration, { description: command.description, input: callInput(command.payload), output: noOutput, retries: 0, handle: () => ({}) });
+    }
+}
+const dismissedSchema = z.strictObject({ dismissed: z.literal(true) });
+const answerSchemas = {
+    text: z.strictObject({ text: z.string() }),
+    choice: z.strictObject({ selected: z.array(z.string()), other: z.string().exactOptional() }),
+    confirm: z.strictObject({ confirmed: z.boolean() }),
+    approval: z.strictObject({ confirmed: z.boolean() }),
+};
+function checkChoice(question, answer) {
+    const parsed = payloads.choice.parse(question);
+    const ids = new Set(parsed.options.map((option) => option.id));
+    const unknown = answer.selected.find((id) => !ids.has(id));
+    if (unknown !== undefined)
+        throw invalid(`${unknown} isn't one of the options.`, { selected: unknown });
+    if (answer.other !== undefined && parsed.other !== true)
+        throw invalid('This question offers no other answer.');
+    const count = answer.selected.length + (answer.other === undefined ? 0 : 1);
+    if (!parsed.multiple && count !== 1)
+        throw invalid('Choose exactly one option.');
+}
+/** An answer checked against its question: the call's result, or an approval's decision. */
+export function checkedAnswer(question, answer) {
+    const dismissed = dismissedSchema.safeParse(answer);
+    if (question.kind === 'approval') {
+        if (dismissed.success)
+            return { kind: 'approval', approved: false };
+        const parsed = answerSchemas.approval.safeParse(answer);
+        if (!parsed.success)
+            throw invalid('An approval is answered { confirmed } or { dismissed: true }.');
+        return { kind: 'approval', approved: parsed.data.confirmed };
+    }
+    if (dismissed.success)
+        return { kind: 'result', text: jsonOutput({ dismissed: true }).output };
+    const parsed = answerSchemas[question.kind].safeParse(answer);
+    if (!parsed.success)
+        throw invalid(`The answer doesn't fit a ${question.kind} question.`);
+    if ('selected' in parsed.data)
+        checkChoice(question.question, parsed.data);
+    return { kind: 'result', text: jsonOutput(parsed.data).output };
+}
+/** What a question, or an approval, dismissed by a message returns to the model (plan 08 §8.1). */
+export function dismissedText(kind) {
+    return kind === 'approval' ? 'denied by the user' : 'dismissed by the user';
+}
+//# sourceMappingURL=ask.js.map

package/dist/connectors/ask.js.map

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

package/dist/connectors/background.d.ts

@@ -0,0 +1,29 @@
+import { z, type Ctx } from '@kvman/sdk';
+/** What the prompt's index says the connector is for. */
+export declare 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.";
+export declare const backgroundCommands: {
+    list: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{}, z.core.$strict>;
+        asks: false;
+    };
+    output: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strict>;
+        asks: false;
+    };
+    stop: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strict>;
+        asks: false;
+    };
+};
+export declare function registerBackgroundConnector(ctx: Ctx): void;
+//# sourceMappingURL=background.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/connectors/background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAOzC,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,uLAAuL,CAAC;AAM1N,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CAIa,CAAC;AAsB7C,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAuB1D"}