@kvman/kvcoder 0.1.0

package/dist/messages/attachments.js

@@ -0,0 +1,48 @@
+import { constants } from 'node:fs';
+import { copyFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { resolveInWorkspace } from "../files/workspace-path.js";
+// A message's files that aren't images (plan 08 §8.1, ADR 0018, 1 to 4): each is copied into the workspace folder under
+// `attachments/`, where the agent opens it with its file commands, and the message's text names them. Nothing is
+// overwritten: a name that exists gets `-2`, `-3`, … before its extension.
+const folderName = 'attachments';
+const isTaken = (error) => error instanceof Error && 'code' in error && error.code === 'EEXIST';
+/** A file's name as it is saved: its base name, with only letters, digits, space, and `._-()` kept. */
+export function safeName(name) {
+    const base = name.split(/[\\/]/).at(-1) ?? '';
+    const safe = base.replace(/[^\p{L}\p{N} ._()-]/gu, '_').trim();
+    return safe === '' || safe === '.' || safe === '..' ? 'file' : safe;
+}
+async function copyUnder(source, folder, name) {
+    const { name: stem, ext } = path.parse(name);
+    for (let count = 1;; count += 1) {
+        const candidate = count === 1 ? name : `${stem}-${count}${ext}`;
+        try {
+            await copyFile(source, path.join(folder, candidate), constants.COPYFILE_EXCL);
+            return candidate;
+        }
+        catch (error) {
+            if (!isTaken(error))
+                throw error;
+        }
+    }
+}
+/** Saves the files into the workspace folder and gives their paths in it; a user upload leaves the kernel's files. */
+export async function saveAttachments(ctx, files) {
+    if (files.length === 0)
+        return [];
+    const folder = await resolveInWorkspace(ctx.job.workspace.path, folderName);
+    await mkdir(folder, { recursive: true });
+    const saved = [];
+    for (const file of files) {
+        saved.push(`${folderName}/${await copyUnder(await ctx.files.path(file.id), folder, safeName(file.name))}`);
+        if (file.owner.kind === 'user')
+            await ctx.files.unlink(file.id);
+    }
+    return saved;
+}
+/** The message's text with its saved files named at its end. */
+export function withAttachments(text, saved) {
+    return saved.length === 0 ? text : `${text}\n\nAttached files:\n${saved.map((file) => `- ${file}`).join('\n')}`;
+}
+//# sourceMappingURL=attachments.js.map

package/dist/messages/attachments.js.map

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

package/dist/messages/receive-message.d.ts

@@ -0,0 +1,15 @@
+import type { Ctx, File, Stored } from '@kvman/sdk';
+import type { SessionDoc, Source } from '../schemas/records.ts';
+/** A message's files: its images, which the session's model must take (ADR 0009, 103), and every other file (ADR 0018, 2). */
+export declare function sortedFiles(ctx: Ctx, session: Stored<SessionDoc>, fileIds: readonly string[]): Promise<{
+    images: File[];
+    others: File[];
+}>;
+export type Incoming = {
+    text: string;
+    fileIds: readonly string[];
+    source: Source;
+    mayStart: boolean;
+};
+export declare function receiveMessage(ctx: Ctx, session: Stored<SessionDoc>, incoming: Incoming): Promise<void>;
+//# sourceMappingURL=receive-message.d.ts.map

package/dist/messages/receive-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"receive-message.d.ts","sourceRoot":"","sources":["../../src/messages/receive-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAehE,8HAA8H;AAC9H,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAAC,MAAM,EAAE,IAAI,EAAE,CAAA;CAAE,CAAC,CAKhJ;AAED,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvG,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA8B7G"}

package/dist/messages/receive-message.js

@@ -0,0 +1,60 @@
+import { dismissedText } from "../connectors/ask.js";
+import { reportInterrupted } from "../jobs/process-report.js";
+import { invalid } from "../problems.js";
+import { now } from "../sessions/session-lookup.js";
+import { txRecords } from "../store/collections.js";
+import { appendMessage, userContent } from "../turns/history.js";
+import { modelInfo } from "../turns/model-info.js";
+import { heldText } from "../turns/resolve.js";
+import { beginTurn, openTurn, queueStep } from "../turns/start-turn.js";
+import { saveAttachments, withAttachments } from "./attachments.js";
+// A message from the person or an extension (plan 08 §8.1): on an idle session it starts a turn; on a running one it
+// waits for the step's results; on a waiting one it dismisses the pending questions and denies the approvals, and the
+// next step runs once no subagent is left to wait for (ADR 0009, 90).
+const imageTypes = new Set(['image/png', 'image/jpeg', 'image/gif', 'image/webp']);
+/** A message's files: its images, which the session's model must take (ADR 0009, 103), and every other file (ADR 0018, 2). */
+export async function sortedFiles(ctx, session, fileIds) {
+    const files = await Promise.all(fileIds.map((fileId) => ctx.files.get(fileId)));
+    const images = files.filter((file) => imageTypes.has(file.type));
+    if (images.length > 0 && (await modelInfo(ctx, session.model))?.images !== true)
+        throw invalid(`The model ${session.model ?? '(none)'} doesn't take images.`, { model: session.model });
+    return { images, others: files.filter((file) => !imageTypes.has(file.type)) };
+}
+export async function receiveMessage(ctx, session, incoming) {
+    await reportInterrupted(ctx, session.id);
+    const { images, others } = await sortedFiles(ctx, session, incoming.fileIds);
+    const text = withAttachments(incoming.text, await saveAttachments(ctx, others));
+    const files = images.length === 0 ? { fileIds: null, fileNames: null } : { fileIds: images.map((file) => file.id), fileNames: images.map((file) => file.name) };
+    const next = await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const fresh = store.sessions.get(session.id) ?? session;
+        if (fresh.status === 'idle') {
+            if (fresh.autoTitle && fresh.title === '')
+                store.sessions.update(fresh.id, { title: incoming.text.slice(0, 60) });
+            appendMessage(store, fresh, { kind: 'user', content: userContent(text), source: incoming.source, ...files });
+            return incoming.mayStart ? { start: openTurn(store, fresh) } : {};
+        }
+        store.queued.insert({ sessionId: fresh.id, source: incoming.source, text, ...files, createdAt: now() });
+        const turn = fresh.turnId === null ? undefined : store.turns.get(fresh.turnId);
+        if (fresh.status === 'running' || !incoming.mayStart || turn === undefined)
+            return {};
+        const dismissed = turn.pending.filter((item) => item.questionId !== null);
+        const results = dismissed.map((item) => {
+            const question = item.questionId === null ? undefined : store.questions.get(item.questionId);
+            if (question !== undefined)
+                store.questions.delete(question.id);
+            return heldText(item.toolCallId, dismissedText(question?.kind ?? 'text'), true);
+        });
+        const pending = turn.pending.filter((item) => item.questionId === null);
+        store.turns.update(turn.id, { pending, results: [...turn.results, ...results] });
+        if (pending.length > 0)
+            return {};
+        store.sessions.update(fresh.id, { status: 'running', updatedAt: now() });
+        return { resume: turn.id };
+    });
+    if (next.start !== undefined)
+        await beginTurn(ctx, session.id, next.start, true);
+    if (next.resume !== undefined)
+        await queueStep(ctx, session.id, next.resume, true);
+}
+//# sourceMappingURL=receive-message.js.map

package/dist/messages/receive-message.js.map

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

package/dist/messages/register-messages.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerMessages(ctx: Ctx): void;
+//# sourceMappingURL=register-messages.d.ts.map

package/dist/messages/register-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-messages.d.ts","sourceRoot":"","sources":["../../src/messages/register-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAazC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAmD/C"}

package/dist/messages/register-messages.js

@@ -0,0 +1,63 @@
+import { z } from '@kvman/sdk';
+import { fromSessionHandler } from "../registry/session-points.js";
+import { findSession, ownSession, userOnly } from "../sessions/session-lookup.js";
+import { messageSchema, messageView, queuedView } from "../sessions/session-view.js";
+import { records, txRecords } from "../store/collections.js";
+import { appendMessage } from "../turns/history.js";
+import { newestMessages } from "../turns/message-blocks.js";
+import { receiveMessage } from "./receive-message.js";
+// Messages (plan 08 §8.6): the person's `message.send`, extensions' `message.inject`, display-only notes, and the list.
+const sendSchema = z.object({ sessionId: z.string(), text: z.string().min(1), fileIds: z.array(z.string()).exactOptional() });
+export function registerMessages(ctx) {
+    ctx.registerCommand('kvcoder.message.send', {
+        description: "Sends the person's message: it starts a turn, steers the running one, or answers a waiting one.",
+        input: sendSchema,
+        output: z.object({}),
+        public: true,
+        retries: 0,
+        handle: async ({ sessionId, text, fileIds }) => {
+            userOnly(ctx, 'kvcoder.message.send');
+            await receiveMessage(ctx, await ownSession(ctx, sessionId), { text, fileIds: fileIds ?? [], source: { kind: 'user' }, mayStart: true });
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.message.inject', {
+        description: "Adds an extension's message to a session, as the person's message would be, marked as the extension's.",
+        input: sendSchema,
+        output: z.object({}),
+        public: true,
+        retries: 0,
+        handle: async ({ sessionId, text, fileIds }) => {
+            const caller = ctx.job.caller;
+            const source = caller.kind === 'extension' ? { kind: 'extension', name: caller.name } : { kind: 'user' };
+            const session = await ownSession(ctx, sessionId);
+            await receiveMessage(ctx, session, { text, fileIds: fileIds ?? [], source, mayStart: !(await fromSessionHandler(ctx)) });
+            return {};
+        },
+    });
+    ctx.registerCommand('kvcoder.note.add', {
+        description: 'Adds a display-only note to a session; it never reaches the model and never starts a turn.',
+        input: z.object({ sessionId: z.string(), key: z.string().min(1), params: z.record(z.string(), z.json()).exactOptional() }),
+        output: z.object({}),
+        public: true,
+        handle: async ({ sessionId, key, params }) => {
+            const session = await ownSession(ctx, sessionId);
+            await ctx.store.transaction((tx) => appendMessage(txRecords(tx), session, { kind: 'note', content: { key, ...(params === undefined ? {} : { params }) } }));
+            return {};
+        },
+    });
+    ctx.registerQuery('kvcoder.message.list', {
+        description: "Lists a session's newest messages in order, the count of older ones, and the messages waiting for the step.",
+        input: z.object({ sessionId: z.string(), limit: z.number().int().positive().max(1000) }),
+        output: z.object({ messages: z.array(messageSchema), omitted: z.number().int() }),
+        public: true,
+        handle: async ({ sessionId, limit }) => {
+            const session = await findSession(ctx, sessionId);
+            const store = records(ctx.store);
+            const newest = await newestMessages(ctx, sessionId, limit, session.nextSeq);
+            const queued = await store.queued.find({ sessionId }, { limit: 1000 });
+            return { messages: [...newest.map(messageView), ...queued.map(queuedView)], omitted: (await store.messages.count({ sessionId })) - newest.length };
+        },
+    });
+}
+//# sourceMappingURL=register-messages.js.map

package/dist/messages/register-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-messages.js","sourceRoot":"","sources":["../../src/messages/register-messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,wHAAwH;AAExH,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AAE9H,MAAM,UAAU,gBAAgB,CAAC,GAAQ;IACvC,GAAG,CAAC,eAAe,CAAC,sBAAsB,EAAE;QAC1C,WAAW,EAAE,iGAAiG;QAC9G,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7C,QAAQ,CAAC,GAAG,EAAE,sBAAsB,CAAC,CAAC;YACtC,MAAM,cAAc,CAAC,GAAG,EAAE,MAAM,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YACxI,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;IACH,GAAG,CAAC,eAAe,CAAC,wBAAwB,EAAE;QAC5C,WAAW,EAAE,wGAAwG;QACrH,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;YAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;YAC3H,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACjD,MAAM,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;YACzH,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;IACH,GAAG,CAAC,eAAe,CAAC,kBAAkB,EAAE;QACtC,WAAW,EAAE,4FAA4F;QACzG,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,CAAC;QAC1H,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE;YAC3C,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YACjD,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5J,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;IACH,GAAG,CAAC,aAAa,CAAC,sBAAsB,EAAE;QACxC,WAAW,EAAE,6GAA6G;QAC1H,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACxF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC;QACjF,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvE,OAAO,EAAE,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QACrJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/problems.d.ts

@@ -0,0 +1,8 @@
+import { ProblemError, type Json } from '@kvman/sdk';
+/** A `VALIDATION_FAILED` Problem to throw. */
+export declare function invalid(message: string, params?: Record<string, Json>): ProblemError;
+/** A `TOO_LARGE` Problem to throw. */
+export declare function tooLarge(message: string, limit: number): ProblemError;
+/** A `NOT_FOUND` Problem to throw. */
+export declare function notFound(message: string, params?: Record<string, Json>): ProblemError;
+//# sourceMappingURL=problems.d.ts.map

package/dist/problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.d.ts","sourceRoot":"","sources":["../src/problems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAErD,8CAA8C;AAC9C,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAM,GAAG,YAAY,CAExF;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAErE;AAED,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAM,GAAG,YAAY,CAEzF"}

package/dist/problems.js

@@ -0,0 +1,14 @@
+import { ProblemError } from '@kvman/sdk';
+/** A `VALIDATION_FAILED` Problem to throw. */
+export function invalid(message, params = {}) {
+    return new ProblemError({ code: 'VALIDATION_FAILED', message, params });
+}
+/** A `TOO_LARGE` Problem to throw. */
+export function tooLarge(message, limit) {
+    return new ProblemError({ code: 'TOO_LARGE', message, params: { limit } });
+}
+/** A `NOT_FOUND` Problem to throw. */
+export function notFound(message, params = {}) {
+    return new ProblemError({ code: 'NOT_FOUND', message, params });
+}
+//# sourceMappingURL=problems.js.map

package/dist/problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"problems.js","sourceRoot":"","sources":["../src/problems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAa,MAAM,YAAY,CAAC;AAErD,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,SAA+B,EAAE;IACxE,OAAO,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,KAAa;IACrD,OAAO,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,SAA+B,EAAE;IACzE,OAAO,IAAI,YAAY,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AAClE,CAAC"}

package/dist/prompt/build-prompt.d.ts

@@ -0,0 +1,29 @@
+import type { Section } from '../registry/register-sections.ts';
+import { type Role } from './working-method.ts';
+export type PromptInput = {
+    /** The lead of a chat, or a worker's subagent: each has its own identity and working method (ADR 0022, 3). */
+    role: Role;
+    workspacePath: string;
+    platform: NodeJS.Platform;
+    shell: 'bash' | 'powershell';
+    language: string;
+    sections: readonly Section[];
+    /** The worker a subagent runs for: its instructions follow the sections (ADR 0021, 8). */
+    worker?: {
+        name: string;
+        instructions: string;
+    };
+    connectors: readonly {
+        name: string;
+        description: string;
+        commands: readonly string[];
+        signatures?: readonly string[];
+    }[];
+};
+export type BuiltPrompt = {
+    prompt: string;
+    included: ReadonlySet<Section>;
+    left: readonly Section[];
+};
+export declare function buildPrompt(input: PromptInput): BuiltPrompt;
+//# sourceMappingURL=build-prompt.d.ts.map

package/dist/prompt/build-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-prompt.d.ts","sourceRoot":"","sources":["../../src/prompt/build-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAEhE,OAAO,EAA+B,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAK7E,MAAM,MAAM,WAAW,GAAG;IACxB,8GAA8G;IAC9G,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,0FAA0F;IAC1F,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,UAAU,EAAE,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,EAAE,CAAC;CAC3H,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAC;AAqDvG,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAM3D"}

package/dist/prompt/build-prompt.js

@@ -0,0 +1,60 @@
+import { sectionsLimit } from "../registry/register-sections.js";
+import { identityLine, workingMethod } from "./working-method.js";
+const systems = { linux: 'Linux', darwin: 'macOS', win32: 'Windows' };
+function languageName(code) {
+    const name = new Intl.DisplayNames(['en'], { type: 'language' }).of(code);
+    return name === undefined || name === code ? code : `${name} (${code})`;
+}
+// The base prompt (ADR 0009, 163 and 166; ADR 0011, 1; ADR 0022): who the agent is, its one tool, connectors, and how it works.
+function basePrompt(input) {
+    const shell = input.shell === 'bash' ? 'bash' : 'PowerShell';
+    const identity = [
+        identityLine(input.role, `in the folder ${input.workspacePath} on ${systems[input.platform] ?? input.platform}`),
+        `Reply in ${languageName(input.language)} unless the person writes in another language.`,
+    ].join('\n');
+    const tool = 'Your one tool is run: it runs one command of a connector, as { description, connector, command, payload }. description is one sentence for the person, saying what the call does. Below, `fs write` means the connector fs and its command write.';
+    const connectors = `Connectors are the only way you act. When a connector other than shell covers a task, use it instead of a shell line: it checks its input, returns structured results, and is shown to the person. Use shell only for what no other connector does. Every connector has the command help. A command listed below with its payload needs no help call; for any other command, or for what a field means, call the connector's help with { "command": "<name>" } before the first use. \`shell exec\`, \`fs write\`, \`fs edit\`, and \`mcp call\` take risky, which you always send: true when the call could lose, damage, change, or send something that isn't your own work or reaches outside the workspace folder, and the person is then asked first; false otherwise, such as for a tool that only reads. Each \`shell exec\` starts in the workspace folder, so cd doesn't carry over to the next call; the shell is ${shell}.`;
+    return [identity, tool, connectors, workingMethod(input.role)].join('\n\n');
+}
+// A connector's entry: its owner's description, then its commands, which kvcoder adds (ADR 0009, 164; ADR 0011, 3). A
+// built-in's entry is one line per command with its payload's signature (ADR 0012, 1 and 14); `help`'s payload is `{ command? }`.
+function connectorLine(connector) {
+    const description = /[.!?)]$/.test(connector.description.trimEnd()) ? connector.description.trimEnd() : `${connector.description.trimEnd()}.`;
+    if (connector.signatures === undefined)
+        return `- ${connector.name}: ${description} Commands: ${[...connector.commands, 'help'].join(', ')}.`;
+    const signatures = connector.signatures;
+    const names = [...connector.commands, 'help'];
+    const width = Math.max(...names.map((name) => name.length));
+    const rows = connector.commands.map((name, index) => {
+        const signature = signatures[index];
+        if (signature === undefined)
+            throw new Error(`The connector ${connector.name} has no signature for the command ${name}.`);
+        return `  ${name.padEnd(width)} ${signature}`;
+    });
+    rows.push(`  ${'help'.padEnd(width)} { command? }`);
+    return [`- ${connector.name}: ${description}`, ...rows].join('\n');
+}
+function keptSections(sections) {
+    const kept = [];
+    const left = [];
+    let total = 0;
+    for (const section of sections) {
+        if (total + section.size > sectionsLimit) {
+            left.push(section);
+            continue;
+        }
+        total += section.size;
+        kept.push(section);
+    }
+    return { kept, left };
+}
+export function buildPrompt(input) {
+    const { kept, left } = keptSections(input.sections);
+    const parts = [basePrompt(input), ...kept.map((section) => `## ${section.title}\n${section.content}`)];
+    if (input.worker !== undefined && input.worker.instructions !== '')
+        parts.push(`## Worker: ${input.worker.name}\n${input.worker.instructions}`);
+    if (input.connectors.length > 0)
+        parts.push(['## Connectors', ...input.connectors.map(connectorLine)].join('\n'));
+    return { prompt: parts.join('\n\n'), included: new Set(kept), left };
+}
+//# sourceMappingURL=build-prompt.js.map

package/dist/prompt/build-prompt.js.map

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

package/dist/prompt/register-prompt.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx } from '@kvman/sdk';
+export declare function registerPrompt(ctx: Ctx): void;
+//# sourceMappingURL=register-prompt.d.ts.map

package/dist/prompt/register-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-prompt.d.ts","sourceRoot":"","sources":["../../src/prompt/register-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAMzC,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAsB7C"}

package/dist/prompt/register-prompt.js

@@ -0,0 +1,29 @@
+import { z } from '@kvman/sdk';
+import { findSession } from "../sessions/session-lookup.js";
+import { sessionTools } from "./session-prompt.js";
+// `kvcoder.prompt.get` (plan 08 §8.6): the exact system prompt a session's next step sends, with each section's owner,
+// reach, and size for the conversation's Prompt tab (ADR 0009, 104).
+export function registerPrompt(ctx) {
+    ctx.registerQuery('kvcoder.prompt.get', {
+        description: "Gives the exact system prompt of a session's next step, and its sections.",
+        input: z.object({ sessionId: z.string() }),
+        output: z.object({
+            prompt: z.string(),
+            sections: z.array(z.object({ id: z.string(), title: z.string(), owner: z.string(), reach: z.enum(['global', 'workspace', 'session']), size: z.number(), included: z.boolean() })),
+        }),
+        public: true,
+        handle: async ({ sessionId }) => {
+            const tools = await sessionTools(ctx, await findSession(ctx, sessionId));
+            const sections = [...tools.built.included, ...tools.built.left].map((section) => ({
+                id: section.id,
+                title: section.title,
+                owner: section.owner,
+                reach: section.global ? 'global' : section.sessionId === null ? 'workspace' : 'session',
+                size: section.size,
+                included: tools.built.included.has(section),
+            }));
+            return { prompt: tools.built.prompt, sections };
+        },
+    });
+}
+//# sourceMappingURL=register-prompt.js.map

package/dist/prompt/register-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-prompt.js","sourceRoot":"","sources":["../../src/prompt/register-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAY,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,uHAAuH;AACvH,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,GAAQ;IACrC,GAAG,CAAC,aAAa,CAAC,oBAAoB,EAAE;QACtC,WAAW,EAAE,2EAA2E;QACxF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;QAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;SAClL,CAAC;QACF,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;YAC9B,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;YACzE,MAAM,QAAQ,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAChF,EAAE,EAAE,OAAO,CAAC,EAAE;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAE,QAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAE,WAAqB,CAAC,CAAC,CAAE,SAAmB;gBACxH,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;aAC5C,CAAC,CAAC,CAAC;YACJ,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;QAClD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/prompt/session-prompt.d.ts

@@ -0,0 +1,24 @@
+import { type Ctx, type Stored } from '@kvman/sdk';
+import type { ShellCommand } from '../calls/shell-command.ts';
+import { type ConnectorRow } from '../registry/register-connectors.ts';
+import type { SessionDoc } from '../schemas/records.ts';
+import { type BuiltPrompt } from './build-prompt.ts';
+/** A connector the session's agent can call: its entry in the prompt's index and in the `run` tool's enum. */
+export type ListedConnector = {
+    name: string;
+    description: string;
+    commands: string[];
+    signatures?: readonly string[];
+};
+export type SessionTools = {
+    built: BuiltPrompt;
+    shell: ShellCommand;
+    /** Every registered connector of the run, callable or not. */
+    connectors: ConnectorRow[];
+    /** The connectors the session may call, in the prompt's order. */
+    listed: ListedConnector[];
+    /** The names that are turned off (ADR 0014, 7). */
+    disabled: ReadonlySet<string>;
+};
+export declare function sessionTools(ctx: Ctx, session: Stored<SessionDoc>): Promise<SessionTools>;
+//# sourceMappingURL=session-prompt.d.ts.map

package/dist/prompt/session-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-prompt.d.ts","sourceRoot":"","sources":["../../src/prompt/session-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAO9D,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAOlE,8GAA8G;AAC9G,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAExH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,8DAA8D;IAC9D,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,kEAAkE;IAClE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B,CAAC;AASF,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CA4B/F"}

package/dist/prompt/session-prompt.js

@@ -0,0 +1,50 @@
+import { z } from '@kvman/sdk';
+import { builtinDescriptions, builtinSignatures, commandsOf } from "../connectors/builtin-connectors.js";
+import { shellFor } from "../calls/shell-program.js";
+import { builtinConnectors } from "../connector-call.js";
+import { delegateIndexDescription } from "../connectors/delegate.js";
+import { mcpIndexDescription } from "../connectors/mcp.js";
+import { availableWorkers } from "../delegate/workers.js";
+import { mcpServers } from "../mcp/servers.js";
+import { activeConnectors } from "../registry/register-connectors.js";
+import { disabledConnectors } from "../register-settings.js";
+import { sectionsFor } from "../registry/register-sections.js";
+import { buildPrompt } from "./build-prompt.js";
+// The connector names a session may use: none that is turned off (ADR 0014, 7), and for a subagent only its worker's (ADR 0021, 24).
+function allowedNames(session, connectors, disabled) {
+    const names = [...builtinConnectors, ...connectors.map((connector) => connector.name)].filter((name) => !disabled.has(name));
+    if (session.parentId === null)
+        return new Set(names);
+    return new Set(names.filter((name) => name === 'ask' || (name !== 'delegate' && (session.connectors === null || session.connectors.includes(name)))));
+}
+export async function sessionTools(ctx, session) {
+    const shell = await shellFor(ctx);
+    const connectors = await activeConnectors(ctx);
+    const disabled = await disabledConnectors(ctx);
+    const allowed = allowedNames(session, connectors, disabled);
+    const passed = new Set((session.checks ?? []).filter((check) => check.passed).map((check) => check.name));
+    const servers = await mcpServers(ctx);
+    const workers = await availableWorkers(ctx, session.checks);
+    const descriptions = { ...builtinDescriptions(shell.kind), delegate: delegateIndexDescription(workers), mcp: mcpIndexDescription(servers) };
+    const present = { mcp: servers.length > 0, delegate: workers.length > 0 };
+    const listed = [
+        ...builtinConnectors.filter((name) => allowed.has(name) && present[name] !== false).map((name) => ({ name, description: descriptions[name], commands: Object.keys(commandsOf(name)), signatures: builtinSignatures[name] })),
+        ...connectors
+            .filter((connector) => allowed.has(connector.name) && (connector.kind === 'commands' || passed.has(connector.name)))
+            .map((connector) => ({ name: connector.name, description: connector.description, commands: connector.commands?.map((command) => command.name) ?? ['exec'] })),
+    ];
+    const built = buildPrompt({
+        role: session.parentId === null ? 'lead' : 'worker',
+        workspacePath: ctx.job.workspace.path,
+        platform: process.platform,
+        shell: shell.kind,
+        language: z.string().parse(await ctx.settings.get('kernel.language')),
+        sections: await sectionsFor(ctx, session.id),
+        ...(session.worker === null ? {} : { worker: session.worker }),
+        connectors: listed,
+    });
+    for (const section of built.left)
+        ctx.log.warn('A section was left out of a prompt past 64 KB of sections.', { owner: section.owner, id: section.id });
+    return { built, shell, connectors, listed, disabled };
+}
+//# sourceMappingURL=session-prompt.js.map

package/dist/prompt/session-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-prompt.js","sourceRoot":"","sources":["../../src/prompt/session-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAyB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEzG,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAqB,MAAM,oCAAoC,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AAqBlE,qIAAqI;AACrI,SAAS,YAAY,CAAC,OAAmB,EAAE,UAAmC,EAAE,QAA6B;IAC3G,MAAM,KAAK,GAAG,CAAC,GAAG,iBAAiB,EAAE,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7H,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACrD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACxJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,OAA2B;IACtE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1G,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,wBAAwB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5I,MAAM,OAAO,GAAqC,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAC5G,MAAM,MAAM,GAAG;QACb,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5N,GAAG,UAAU;aACV,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;aACnH,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;KAChK,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QACnD,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI;QACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACrE,QAAQ,EAAE,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;QAC5C,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9D,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,4DAA4D,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACvJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACxD,CAAC"}

package/dist/prompt/working-method.d.ts

@@ -0,0 +1,7 @@
+/** Who reads the prompt: the agent of a chat, or the subagent of one of its workers. */
+export type Role = 'lead' | 'worker';
+/** The first line of the prompt: who the agent is, and where it works. */
+export declare function identityLine(role: Role, place: string): string;
+/** The "How you work" block of a role. */
+export declare function workingMethod(role: Role): string;
+//# sourceMappingURL=working-method.d.ts.map

package/dist/prompt/working-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-method.d.ts","sourceRoot":"","sources":["../../src/prompt/working-method.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,QAAQ,CAAC;AA4CrC,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEhD"}

package/dist/prompt/working-method.js

@@ -0,0 +1,51 @@
+// How the agent works (plan 08 §8.2; ADR 0022, 2 to 4): the lead of a chat decides, plans, executes, and delegates; a
+// worker does the one task it was given. Both end with the same rules, the call-or-final-answer rule last.
+const evidence = 'Decide from evidence: every decision and every claim rests on something you read, ran, or were told. When you report a result, say what you checked and what you didn\'t.';
+const simplest = "Use the simplest practical way that follows the project's conventions and sound engineering practice, and don't add what wasn't asked.";
+const together = 'The calls of one reply run at the same time, so put independent calls (reads, searches, separate files, separate workers) in one reply, and calls that depend on each other in separate replies.';
+const artifacts = 'Show the person anything long to read or see (a plan, a report, a design, an HTML page) in an artifact, not in a reply.';
+const asking = 'To put a question to the person (a choice, a yes or no, a free answer), call `ask`.';
+const checked = "Before you say that something runs or works, check it the way the person would: run it, request its address, or run its test; if you couldn't, say what is unchecked. After you start a server, request its address once before you give it to the person.";
+const short = 'Keep replies short: say what you did and what is left.';
+const callOrFinalAnswer = 'Say what you are about to do in the same reply as the call that does it, and never make a call that does nothing, such as `true`, just to keep going. A reply with no tool call is your final answer and ends the turn: when work remains, your reply must contain the call that does the next piece. A reply that only says what you will do ("now I will write the file") ends the turn with nothing done.';
+const leadMethod = [
+    'How you work. You are the one who decides: connectors and workers are how you act, and the result is yours. Scale the process to the task: a task of one file or a few steps needs no plan and no `plan` artifact, so skip steps 3 and 5 and just do it; a larger one follows these steps.',
+    "1. Understand. Look for facts before you decide anything: read the request, then the files, config, and tests, and `docs get` where there is a guide. Work out what the person needs, not only what they typed. Never assume or invent names, paths, APIs, or behavior; when you can't find a fact, say so or ask.",
+    "2. Clarify. If the request is unclear, contradicts itself or the code, or leaves out something that changes the result, ask: put each question in its own `ask` call, with all the calls in one reply, and use `ask choice` whenever you offer options, your recommended one first. Don't ask what looking would answer.",
+    '3. Plan. Write the plan as the artifact `plan`: the goal, the steps in order as a checklist (☐ to do, ☑ done), what each step uses (a connector from the list below, a worker), which steps can run at the same time, and how you will check each one. Plan only with the connectors and workers you have. Write it in the same reply as your first call. For a large, ambiguous, or risky task, call `ask confirm` on the plan before you start.',
+    "4. Execute. Work through the steps, running the independent ones together. Make the smallest change for each step, check it with the project's own check or tests, fix a failure at its cause, and tick the step off with `artifact edit`. Write each file in its own call, with `fs write`. If the facts change, change the plan.",
+    '5. Delegate. Hand a separate, self-contained part to a worker of the `delegate` connector when a specialist view or parallel work is worth it; its entry lists the workers and what each is for. Several `delegate run` calls in one reply run in parallel. Brief the worker with the goal, the facts it needs, its limits, and what to return. Read what a worker returns and check it before you rely on it: its work is your responsibility.',
+    "6. Finish. The work is done when it is ready for production: it does what was asked, it handles the errors and edge cases that will happen, it follows the project's conventions, its checks and tests pass, and nothing unfinished or temporary is left behind.",
+    evidence,
+    simplest,
+    together,
+    artifacts,
+    asking,
+    checked,
+    short,
+    callOrFinalAnswer,
+].join('\n');
+const workerMethod = [
+    "How you work. Do the task you were given and return the result; don't re-plan it or widen it, and ask the person only if you are blocked.",
+    "1. Understand. Read the task, then the files, config, and tests it touches. Never assume or invent names, paths, APIs, or behavior; when you can't find a fact, say so in your answer.",
+    "2. Do it. Make the smallest change that does the task, check it with the project's own check or tests, and fix a failure at its cause. Write each file in its own call, with `fs write`.",
+    '3. Return. Your last reply is the result the lead agent reads: what you did or found, the evidence for it, and what is unchecked or left.',
+    evidence,
+    simplest,
+    together,
+    artifacts,
+    asking,
+    checked,
+    callOrFinalAnswer,
+].join('\n');
+/** The first line of the prompt: who the agent is, and where it works. */
+export function identityLine(role, place) {
+    if (role === 'lead')
+        return `You are kvman Coder, the lead engineer on this work: a software engineer with long, deep experience who owns the outcome. You understand the request, decide, plan, and execute it, ${place}.`;
+    return `You are kvman Coder, working on one task that the lead agent gave you, ${place}: a software engineer with long, deep experience.`;
+}
+/** The "How you work" block of a role. */
+export function workingMethod(role) {
+    return role === 'lead' ? leadMethod : workerMethod;
+}
+//# sourceMappingURL=working-method.js.map

package/dist/prompt/working-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-method.js","sourceRoot":"","sources":["../../src/prompt/working-method.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,2GAA2G;AAK3G,MAAM,QAAQ,GAAG,2KAA2K,CAAC;AAC7L,MAAM,QAAQ,GAAG,wIAAwI,CAAC;AAC1J,MAAM,QAAQ,GAAG,kMAAkM,CAAC;AACpN,MAAM,SAAS,GAAG,yHAAyH,CAAC;AAC5I,MAAM,MAAM,GAAG,qFAAqF,CAAC;AACrG,MAAM,OAAO,GAAG,4PAA4P,CAAC;AAC7Q,MAAM,KAAK,GAAG,wDAAwD,CAAC;AACvE,MAAM,iBAAiB,GACrB,8YAA8Y,CAAC;AAEjZ,MAAM,UAAU,GAAG;IACjB,4RAA4R;IAC5R,oTAAoT;IACpT,0TAA0T;IAC1T,mbAAmb;IACnb,oUAAoU;IACpU,ibAAib;IACjb,kQAAkQ;IAClQ,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,KAAK;IACL,iBAAiB;CAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,YAAY,GAAG;IACnB,2IAA2I;IAC3I,wLAAwL;IACxL,0LAA0L;IAC1L,2IAA2I;IAC3I,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,iBAAiB;CAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,KAAa;IACpD,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,uLAAuL,KAAK,GAAG,CAAC;IAC5N,OAAO,0EAA0E,KAAK,mDAAmD,CAAC;AAC5I,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC;AACrD,CAAC"}