@kvman/kvcoder 0.1.0

package/dist/jobs/job-rows.js

@@ -0,0 +1,74 @@
+import { stopRun } from "../delegate/runs.js";
+import { records } from "../store/collections.js";
+import { cancelTurn } from "../turns/cancel-turn.js";
+import { appendBackground, backgroundText } from "../turns/background.js";
+import { childResult } from "../turns/end-turn.js";
+import { processStatus, sessionProcess } from "./process-records.js";
+import { outputTail } from "./process-report.js";
+import { stopProcess } from "./process-run.js";
+import { localLinks } from "./process-text.js";
+const outputLines = 100;
+async function subagentRow(ctx, entry) {
+    const store = records(ctx.store);
+    const child = await store.sessions.get(entry.ref);
+    const [turn] = await store.turns.find({ sessionId: entry.ref }, { limit: 1, order: 'desc' });
+    const outcome = turn?.outcome ?? null;
+    const status = child === undefined || outcome === null ? 'running' : outcome === 'done' ? 'succeeded' : outcome === 'cancelled' ? 'cancelled' : 'failed';
+    const row = { id: entry.ref, kind: 'subagent', title: entry.call, call: entry.call, status, startedAt: entry.startedAt, ...(turn?.endedAt === null || turn === undefined ? {} : { endedAt: turn.endedAt }) };
+    return { row, detail: outcome === null ? {} : { output: (await childResult(ctx, entry.ref, outcome)).text } };
+}
+async function processRow(ctx, id, sessionId) {
+    const doc = await sessionProcess(ctx, sessionId, id);
+    if (doc === undefined)
+        return undefined;
+    const row = { id: doc.id, kind: 'process', title: doc.title, call: doc.call, status: processStatus(doc), startedAt: doc.startedAt, ...(doc.endedAt === undefined ? {} : { endedAt: doc.endedAt }), ...(typeof doc.exitCode === 'number' ? { exitCode: doc.exitCode } : {}) };
+    return { row, detail: { output: await outputTail(ctx, doc.id, outputLines) } };
+}
+// A program worker's run (ADR 0021, 33): its output is what the call returned, once it has ended.
+function runRow(run) {
+    const row = { id: run.id, kind: 'worker', title: run.worker, call: run.call, status: run.status, startedAt: run.startedAt, ...(run.endedAt === null ? {} : { endedAt: run.endedAt }), ...(run.exitCode === null ? {} : { exitCode: run.exitCode }) };
+    return { row, detail: run.output === null ? {} : { output: run.output } };
+}
+/** One job of the session by its id, with its output or problem; `undefined` when the session started no such job. */
+export async function jobDetail(ctx, sessionId, id) {
+    const process = await processRow(ctx, id, sessionId);
+    if (process !== undefined)
+        return process;
+    const run = await records(ctx.store).runs.get(id);
+    if (run !== undefined)
+        return run.sessionId === sessionId ? runRow(run) : undefined;
+    const [entry] = await records(ctx.store).background.find({ sessionId, ref: id }, { limit: 1 });
+    return entry === undefined || entry.kind !== 'subagent' ? undefined : subagentRow(ctx, entry);
+}
+/** The session's newest 50 jobs, newest first. */
+export async function jobRows(ctx, sessionId) {
+    const store = records(ctx.store);
+    const [entries, processes, runs] = await Promise.all([store.background.find({ sessionId }, { limit: 50, order: 'desc' }), store.processes.find({ sessionId }, { limit: 50, order: 'desc' }), store.runs.find({ sessionId }, { limit: 50, order: 'desc' })]);
+    const newest = [...entries.map((entry) => ({ id: entry.ref, startedAt: entry.startedAt })), ...[...processes, ...runs].map((doc) => ({ id: doc.id, startedAt: doc.startedAt }))].sort((a, b) => b.startedAt.localeCompare(a.startedAt)).slice(0, 50);
+    const found = await Promise.all(newest.map((job) => jobDetail(ctx, sessionId, job.id)));
+    return found.flatMap((job) => (job === undefined ? [] : [job.row]));
+}
+/** What the person's list adds to a row: the localhost links in a process's output. */
+export async function linksOf(ctx, sessionId, row) {
+    if (row.kind !== 'process')
+        return [];
+    const doc = await sessionProcess(ctx, sessionId, row.id);
+    return doc === undefined ? [] : localLinks(await outputTail(ctx, doc.id, outputLines));
+}
+/** Stops a process or a run, or cancels a subagent and tells the session; `false` for a process or a run that had ended already. */
+export async function cancelJob(ctx, sessionId, row, by) {
+    if (row.kind === 'worker') {
+        const run = await records(ctx.store).runs.get(row.id);
+        return run !== undefined && stopRun(ctx, run);
+    }
+    if (row.kind === 'process') {
+        const doc = await sessionProcess(ctx, sessionId, row.id);
+        return doc !== undefined && stopProcess(ctx, doc, by);
+    }
+    if (await cancelTurn(ctx, row.id, false)) {
+        const result = await childResult(ctx, row.id, 'cancelled');
+        await appendBackground(ctx, sessionId, { kind: 'subagent', sessionId: row.id }, backgroundText(row.call, row.id, result.text), false);
+    }
+    return true;
+}
+//# sourceMappingURL=job-rows.js.map

package/dist/jobs/job-rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-rows.js","sourceRoot":"","sources":["../../src/jobs/job-rows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQ/C,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,KAAK,UAAU,WAAW,CAAC,GAAQ,EAAE,KAA4B;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAClD,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7F,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzJ,MAAM,GAAG,GAAW,EAAE,EAAE,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACrN,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;AAChH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,EAAU,EAAE,SAAiB;IAC/D,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;IACrD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,GAAG,GAAW,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACrR,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC;AACjF,CAAC;AAED,kGAAkG;AAClG,SAAS,MAAM,CAAC,GAAmB;IACjC,MAAM,GAAG,GAAW,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC7P,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;AAC5E,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAQ,EAAE,SAAiB,EAAE,EAAU;IACrE,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,EAAE,SAAS,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClD,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/F,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;AAChG,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAQ,EAAE,SAAiB;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5P,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrP,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxF,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAQ,EAAE,SAAiB,EAAE,GAAW;IACpE,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IACzD,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,oIAAoI;AACpI,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAQ,EAAE,SAAiB,EAAE,GAAW,EAAE,EAAsB;IAC9F,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtD,OAAO,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACzD,OAAO,GAAG,KAAK,SAAS,IAAI,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IACD,IAAI,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC3D,MAAM,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACxI,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/jobs/process-handlers.d.ts

@@ -0,0 +1,8 @@
+import { type Ctx } from '@kvman/sdk';
+import type { ProcessDoc } from '../schemas/records.ts';
+/** An exit gets a background message only past the startup second; an earlier one reaches the model in the start result (ADR 0012, 8). */
+export declare function exitIsReported(doc: Pick<ProcessDoc, 'starting'>): boolean;
+/** Marks the records of processes that no longer run, such as after kvman died; a hot reload leaves running ones alone. */
+export declare function interruptLeftovers(ctx: Ctx): Promise<void>;
+export declare function registerProcessHandlers(ctx: Ctx): void;
+//# sourceMappingURL=process-handlers.d.ts.map

package/dist/jobs/process-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-handlers.d.ts","sourceRoot":"","sources":["../../src/jobs/process-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAK,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAWxD,0IAA0I;AAC1I,wBAAgB,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,OAAO,CAEzE;AAWD,2HAA2H;AAC3H,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CActD"}

package/dist/jobs/process-handlers.js

@@ -0,0 +1,43 @@
+import { z } from '@kvman/sdk';
+import { records } from "../store/collections.js";
+import { markEnd, ownerName, processId, processName } from "./process-records.js";
+import { reportEnd } from "./process-report.js";
+// How kvcoder learns that a background process ended without its own doing (ADR 0009, 150): `kernel.process.exited` for
+// an exit by itself, `kernel.stopping` as kvman stops, and `kernel.started` for a kvman that died. The last two run in
+// Home, so they only record the end; the chat is told at its next message (`reportInterrupted`).
+const runningProcessesSchema = z.array(z.object({ extension: z.string(), name: z.string() }));
+/** An exit gets a background message only past the startup second; an earlier one reaches the model in the start result (ADR 0012, 8). */
+export function exitIsReported(doc) {
+    return doc.starting !== true;
+}
+async function interrupt(ctx, ids) {
+    for (const id of ids)
+        await markEnd(ctx, id, { end: 'interrupted', reported: false });
+}
+async function runningIds(ctx) {
+    const docs = await records(ctx.store).processes.find({}, { limit: 1000 });
+    return docs.filter((doc) => doc.end === undefined).map((doc) => doc.id);
+}
+/** Marks the records of processes that no longer run, such as after kvman died; a hot reload leaves running ones alone. */
+export async function interruptLeftovers(ctx) {
+    const alive = new Set(runningProcessesSchema.parse(await ctx.exec('kernel.processes.list', {})).filter((process) => process.extension === ownerName).map((process) => process.name));
+    await interrupt(ctx, (await runningIds(ctx)).filter((id) => !alive.has(processName(id))));
+}
+export function registerProcessHandlers(ctx) {
+    ctx.registerHandler('kernel.process.exited', {
+        description: 'Records how a background process of a chat exited by itself, and tells the chat.',
+        handle: async ({ extension, name, exitCode, signal }) => {
+            const id = processId(name);
+            if (extension !== ownerName || id === undefined)
+                return;
+            const ended = await markEnd(ctx, id, { end: 'exited', exitCode, signal, reported: true });
+            if (ended !== undefined && exitIsReported(ended))
+                await reportEnd(ctx, ended);
+        },
+    });
+    ctx.registerHandler('kernel.stopping', {
+        description: 'Marks the background processes of chats interrupted, as kvman stops them.',
+        handle: async () => interrupt(ctx, await runningIds(ctx)),
+    });
+}
+//# sourceMappingURL=process-handlers.js.map

package/dist/jobs/process-handlers.js.map

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

package/dist/jobs/process-records.d.ts

@@ -0,0 +1,15 @@
+import type { Ctx, Stored } from '@kvman/sdk';
+import type { ProcessDoc } from '../schemas/records.ts';
+/** The extension name the kernel's process service records for kvcoder's processes. */
+export declare const ownerName = "@kvman/kvcoder";
+export declare const processName: (id: string) => string;
+/** The record id a process name `job-<id>` stands for, or `undefined` for another name. */
+export declare const processId: (name: string) => string | undefined;
+export type ProcessStatus = 'running' | 'succeeded' | 'failed' | 'cancelled' | 'interrupted';
+export declare function processStatus(doc: ProcessDoc): ProcessStatus;
+export type EndPatch = Pick<ProcessDoc, 'end' | 'reported'> & Partial<Pick<ProcessDoc, 'exitCode' | 'signal'>>;
+/** Records how a process ended, once: the record when this call set the end, `undefined` when it had ended already. */
+export declare function markEnd(ctx: Ctx, id: string, patch: EndPatch): Promise<Stored<ProcessDoc> | undefined>;
+/** A session's process, or `undefined` when the session has none with that id. */
+export declare function sessionProcess(ctx: Ctx, sessionId: string, id: string): Promise<Stored<ProcessDoc> | undefined>;
+//# sourceMappingURL=process-records.d.ts.map

package/dist/jobs/process-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-records.d.ts","sourceRoot":"","sources":["../../src/jobs/process-records.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMxD,uFAAuF;AACvF,eAAO,MAAM,SAAS,mBAAmB,CAAC;AAE1C,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,MAAqB,CAAC;AAE/D,2FAA2F;AAC3F,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,MAAM,GAAG,SAA8E,CAAC;AAEjI,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,CAAC;AAE7F,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,CAI5D;AAED,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC;AAE/G,uHAAuH;AACvH,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAM5G;AAED,kFAAkF;AAClF,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAGrH"}

package/dist/jobs/process-records.js

@@ -0,0 +1,30 @@
+import { now } from "../sessions/session-lookup.js";
+import { records, txRecords } from "../store/collections.js";
+// A background process's record (ADR 0009, 150): its name in the kernel's process service, how it ends, and its status.
+/** The extension name the kernel's process service records for kvcoder's processes. */
+export const ownerName = '@kvman/kvcoder';
+export const processName = (id) => `job-${id}`;
+/** The record id a process name `job-<id>` stands for, or `undefined` for another name. */
+export const processId = (name) => (name.startsWith('job-') ? name.slice('job-'.length) : undefined);
+export function processStatus(doc) {
+    if (doc.end === undefined)
+        return 'running';
+    if (doc.end === 'exited')
+        return doc.exitCode === 0 ? 'succeeded' : 'failed';
+    return doc.end === 'interrupted' ? 'interrupted' : 'cancelled';
+}
+/** Records how a process ended, once: the record when this call set the end, `undefined` when it had ended already. */
+export async function markEnd(ctx, id, patch) {
+    return ctx.store.transaction((tx) => {
+        const doc = txRecords(tx).processes.get(id);
+        if (doc === undefined || doc.end !== undefined)
+            return undefined;
+        return txRecords(tx).processes.update(id, { ...patch, endedAt: now() });
+    });
+}
+/** A session's process, or `undefined` when the session has none with that id. */
+export async function sessionProcess(ctx, sessionId, id) {
+    const doc = await records(ctx.store).processes.get(id);
+    return doc?.sessionId === sessionId ? doc : undefined;
+}
+//# sourceMappingURL=process-records.js.map

package/dist/jobs/process-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-records.js","sourceRoot":"","sources":["../../src/jobs/process-records.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAE7D,wHAAwH;AAExH,uFAAuF;AACvF,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;AAE/D,2FAA2F;AAC3F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAsB,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAIjI,MAAM,UAAU,aAAa,CAAC,GAAe;IAC3C,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,IAAI,GAAG,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7E,OAAO,GAAG,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;AACjE,CAAC;AAID,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAQ,EAAE,EAAU,EAAE,KAAe;IACjE,OAAO,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;QAClC,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACjE,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kFAAkF;AAClF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAQ,EAAE,SAAiB,EAAE,EAAU;IAC1E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvD,OAAO,GAAG,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/dist/jobs/process-report.d.ts

@@ -0,0 +1,8 @@
+import { type Ctx, type Stored } from '@kvman/sdk';
+import type { ProcessDoc } from '../schemas/records.ts';
+/** A process's last lines of output; none when it left no log. */
+export declare function outputTail(ctx: Ctx, id: string, lines: number): Promise<string>;
+export declare function reportEnd(ctx: Ctx, doc: Stored<ProcessDoc>): Promise<void>;
+/** Reports the endings no handler could write into this session (kvman stopped or died), once each. */
+export declare function reportInterrupted(ctx: Ctx, sessionId: string): Promise<void>;
+//# sourceMappingURL=process-report.d.ts.map

package/dist/jobs/process-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-report.d.ts","sourceRoot":"","sources":["../../src/jobs/process-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAWxD,kEAAkE;AAClE,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOrF;AASD,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAED,uGAAuG;AACvG,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOlF"}

package/dist/jobs/process-report.js

@@ -0,0 +1,44 @@
+import { ProblemError } from '@kvman/sdk';
+import { appendBackground, backgroundText } from "../turns/background.js";
+import { records } from "../store/collections.js";
+import { processName } from "./process-records.js";
+import { lastLines } from "./process-text.js";
+// Telling a session how a background process ended (ADR 0009, 150): one background message with the outcome and the
+// last 20 lines of output. It never starts a turn, since a handler's jobs carry the `fromHandler` mark.
+const reportLines = 20;
+/** A process's last lines of output; none when it left no log. */
+export async function outputTail(ctx, id, lines) {
+    try {
+        return lastLines(await ctx.processes.log(processName(id), { tail: lines }), lines);
+    }
+    catch (error) {
+        if (error instanceof ProblemError && error.problem.code === 'NOT_FOUND')
+            return '';
+        throw error;
+    }
+}
+function outcome(doc) {
+    if (doc.end === 'person')
+        return 'was stopped by the person.';
+    if (doc.end === 'interrupted')
+        return 'was interrupted because kvman stopped.';
+    if (doc.end === 'exited' && doc.exitCode !== null && doc.exitCode !== undefined)
+        return `exited with code ${String(doc.exitCode)}.`;
+    return `was killed by ${doc.signal ?? 'a signal'}.`;
+}
+export async function reportEnd(ctx, doc) {
+    const tail = await outputTail(ctx, doc.id, reportLines);
+    const text = `The process ${outcome(doc)}${tail === '' ? '' : `\nIts last output:\n${tail}`}`;
+    await appendBackground(ctx, doc.sessionId, { kind: 'job', jobId: doc.id }, backgroundText(doc.call, doc.id, text), false);
+}
+/** Reports the endings no handler could write into this session (kvman stopped or died), once each. */
+export async function reportInterrupted(ctx, sessionId) {
+    const store = records(ctx.store);
+    for (const doc of await store.processes.find({ sessionId, reported: false }, { limit: 1000 })) {
+        if (doc.end === undefined)
+            continue;
+        await store.processes.update(doc.id, { reported: true });
+        await reportEnd(ctx, doc);
+    }
+}
+//# sourceMappingURL=process-report.js.map

package/dist/jobs/process-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-report.js","sourceRoot":"","sources":["../../src/jobs/process-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyB,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,oHAAoH;AACpH,wGAAwG;AAExG,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,EAAU,EAAE,KAAa;IAClE,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW;YAAE,OAAO,EAAE,CAAC;QACnF,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAe;IAC9B,IAAI,GAAG,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,4BAA4B,CAAC;IAC9D,IAAI,GAAG,CAAC,GAAG,KAAK,aAAa;QAAE,OAAO,wCAAwC,CAAC;IAC/E,IAAI,GAAG,CAAC,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,oBAAoB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;IACpI,OAAO,iBAAiB,GAAG,CAAC,MAAM,IAAI,UAAU,GAAG,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAQ,EAAE,GAAuB;IAC/D,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,eAAe,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,uBAAuB,IAAI,EAAE,EAAE,CAAC;IAC9F,MAAM,gBAAgB,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5H,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAQ,EAAE,SAAiB;IACjE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,MAAM,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAC9F,IAAI,GAAG,CAAC,GAAG,KAAK,SAAS;YAAE,SAAS;QACpC,MAAM,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/jobs/process-run.d.ts

@@ -0,0 +1,26 @@
+import { type Ctx, type Stored } from '@kvman/sdk';
+import type { ShellCommand } from '../calls/shell-command.ts';
+import type { ProcessDoc } from '../schemas/records.ts';
+export type StartedProcess = {
+    output: string;
+    jobId: string;
+    ended: boolean;
+    exitCode: number | null;
+    signal: string | null;
+};
+/** How a start reads from its process record: running, or how it ended (ADR 0012, 7 and 9). */
+export declare function startedOutcome(doc: Pick<ProcessDoc, 'end' | 'exitCode' | 'signal'>): {
+    ended: boolean;
+    exitCode: number | null;
+    signal: string | null;
+};
+/** Starts `line` in the real shell for a session; a line that can't start fails `VALIDATION_FAILED` and leaves no record. */
+export declare function startProcess(ctx: Ctx, sessionId: string, shell: ShellCommand, labelled: {
+    title: string;
+    line: string;
+}): Promise<StartedProcess>;
+/** Stops a running process for `by`; `false` when it had ended already. The person's stop is reported to the session. */
+export declare function stopProcess(ctx: Ctx, doc: Stored<ProcessDoc>, by: 'agent' | 'person'): Promise<boolean>;
+/** Stops every process a session still runs, and forgets all of them (the chat is deleted). */
+export declare function dropProcesses(ctx: Ctx, sessionId: string): Promise<void>;
+//# sourceMappingURL=process-run.d.ts.map

package/dist/jobs/process-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-run.d.ts","sourceRoot":"","sources":["../../src/jobs/process-run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAK9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AASxD,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC;AAE/H,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAOvJ;AAED,6HAA6H;AAC7H,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAkBvJ;AAED,yHAAyH;AACzH,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAU7G;AAED,+FAA+F;AAC/F,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9E"}

package/dist/jobs/process-run.js

@@ -0,0 +1,70 @@
+import { ProblemError } from '@kvman/sdk';
+import { delay } from "../delay.js";
+import { now } from "../sessions/session-lookup.js";
+import { records, txRecords } from "../store/collections.js";
+import { markEnd, processName } from "./process-records.js";
+import { outputTail, reportEnd } from "./process-report.js";
+// A background shell line (ADR 0009, 149): it runs in the kernel's process service, and the call returns its id and the
+// first second of its output. Stopping one is kvcoder's own call, since the kernel reports no event for a stop.
+/** How long a background call waits for the first output. */
+const startupWindowMs = 1_000;
+const firstOutputLines = 100;
+/** How a start reads from its process record: running, or how it ended (ADR 0012, 7 and 9). */
+export function startedOutcome(doc) {
+    if (doc.end === undefined)
+        return { ended: false, exitCode: null, signal: null };
+    if (doc.end === 'exited') {
+        if (typeof doc.exitCode === 'number')
+            return { ended: true, exitCode: doc.exitCode, signal: null };
+        return { ended: true, exitCode: null, signal: doc.signal ?? 'a signal' };
+    }
+    return { ended: true, exitCode: null, signal: null };
+}
+/** Starts `line` in the real shell for a session; a line that can't start fails `VALIDATION_FAILED` and leaves no record. */
+export async function startProcess(ctx, sessionId, shell, labelled) {
+    const store = records(ctx.store);
+    const doc = await store.processes.insert({ workspaceId: ctx.job.workspace.id, sessionId, title: labelled.title, call: labelled.line, startedAt: now(), reported: false, starting: true });
+    try {
+        await ctx.processes.start(processName(doc.id), { command: shell.program, args: shell.args(labelled.line) });
+    }
+    catch (error) {
+        await store.processes.delete(doc.id);
+        throw error;
+    }
+    await delay(startupWindowMs, ctx.job.signal);
+    const output = await outputTail(ctx, doc.id, firstOutputLines);
+    // The record alone decides: a process that died without its end recorded still counts as running (ADR 0012, 9).
+    const settled = await ctx.store.transaction((tx) => {
+        const current = txRecords(tx).processes.get(doc.id);
+        if (current === undefined)
+            return undefined;
+        return current.end === undefined ? txRecords(tx).processes.update(doc.id, { starting: false }) : current;
+    });
+    return { output, jobId: doc.id, ...startedOutcome(settled ?? doc) };
+}
+/** Stops a running process for `by`; `false` when it had ended already. The person's stop is reported to the session. */
+export async function stopProcess(ctx, doc, by) {
+    const ended = await markEnd(ctx, doc.id, { end: by, reported: by === 'person' });
+    if (ended === undefined)
+        return false;
+    try {
+        await ctx.processes.stop(processName(doc.id));
+    }
+    catch (error) {
+        if (!(error instanceof ProblemError) || error.problem.code !== 'NOT_FOUND')
+            throw error;
+    }
+    if (by === 'person')
+        await reportEnd(ctx, ended);
+    return true;
+}
+/** Stops every process a session still runs, and forgets all of them (the chat is deleted). */
+export async function dropProcesses(ctx, sessionId) {
+    const store = records(ctx.store);
+    for (const doc of await store.processes.find({ sessionId }, { limit: 1000 })) {
+        if (doc.end === undefined)
+            await stopProcess(ctx, doc, 'agent');
+        await store.processes.delete(doc.id);
+    }
+}
+//# sourceMappingURL=process-run.js.map

package/dist/jobs/process-run.js.map

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

package/dist/jobs/process-text.d.ts

@@ -0,0 +1,5 @@
+/** The last `count` lines of a log. */
+export declare function lastLines(text: string, count: number): string;
+/** The `http://127.0.0.1:<port>` and `http://localhost:<port>` URLs in a text, each once, without trailing punctuation. */
+export declare function localLinks(text: string): string[];
+//# sourceMappingURL=process-text.d.ts.map

package/dist/jobs/process-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-text.d.ts","sourceRoot":"","sources":["../../src/jobs/process-text.ts"],"names":[],"mappings":"AAEA,uCAAuC;AACvC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAID,2HAA2H;AAC3H,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEjD"}

package/dist/jobs/process-text.js

@@ -0,0 +1,11 @@
+// What the model and the person read of a background process's output (ADR 0009, 150 and 152).
+/** The last `count` lines of a log. */
+export function lastLines(text, count) {
+    return text.replace(/[\r\n]+$/, '').split(/\r?\n/).slice(-count).join('\n');
+}
+const localUrl = /http:\/\/(?:127\.0\.0\.1|localhost):\d+[^\s"'`<>()[\]{}]*/g;
+/** The `http://127.0.0.1:<port>` and `http://localhost:<port>` URLs in a text, each once, without trailing punctuation. */
+export function localLinks(text) {
+    return [...new Set((text.match(localUrl) ?? []).map((url) => url.replace(/[.,;:!?]+$/, '')))];
+}
+//# sourceMappingURL=process-text.js.map

package/dist/jobs/process-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-text.js","sourceRoot":"","sources":["../../src/jobs/process-text.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,uCAAuC;AACvC,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAa;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,QAAQ,GAAG,4DAA4D,CAAC;AAE9E,2HAA2H;AAC3H,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAChG,CAAC"}

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

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

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

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

package/dist/jobs/register-jobs.js

@@ -0,0 +1,61 @@
+import { z } from '@kvman/sdk';
+import { findSession, userOnly } from "../sessions/session-lookup.js";
+import { cancelJob, jobDetail, jobRows, linksOf } from "./job-rows.js";
+// The person's view of a session's background jobs (ADR 0009, 152): list, read, and cancel, for the Running chip.
+const sessionJobSchema = z.object({ sessionId: z.string(), id: z.string() });
+const rowSchema = z.object({
+    id: z.string(),
+    kind: z.enum(['process', 'subagent', 'worker']),
+    title: z.string(),
+    call: z.string(),
+    status: z.string(),
+    startedAt: z.string(),
+    endedAt: z.string().exactOptional(),
+    exitCode: z.number().int().exactOptional(),
+    links: z.array(z.string()),
+});
+const withLinks = async (ctx, sessionId, row) => ({ ...row, links: await linksOf(ctx, sessionId, row) });
+export function registerJobs(ctx) {
+    ctx.registerQuery('kvcoder.job.list', {
+        description: "A chat's newest 50 background jobs (processes, subagents, and program workers' runs), running ones first.",
+        input: z.object({ sessionId: z.string() }),
+        output: z.array(rowSchema),
+        public: true,
+        handle: async ({ sessionId }) => {
+            userOnly(ctx, 'kvcoder.job.list');
+            await findSession(ctx, sessionId);
+            const rows = await Promise.all((await jobRows(ctx, sessionId)).map((row) => withLinks(ctx, sessionId, row)));
+            return [...rows.filter((row) => row.status === 'running'), ...rows.filter((row) => row.status !== 'running')];
+        },
+    });
+    ctx.registerQuery('kvcoder.job.get', {
+        description: "One background job of a chat with its output: a process's last 100 lines, a subagent's result, or what a program worker's run returned.",
+        input: sessionJobSchema,
+        output: rowSchema.extend({ output: z.json().exactOptional(), problem: z.json().exactOptional() }),
+        public: true,
+        handle: async ({ sessionId, id }) => {
+            userOnly(ctx, 'kvcoder.job.get');
+            await findSession(ctx, sessionId);
+            const found = await jobDetail(ctx, sessionId, id);
+            if (found === undefined)
+                throw ctx.problem('kvcoder/JOB_NOT_FOUND', { sessionId, id });
+            return { ...(await withLinks(ctx, sessionId, found.row)), ...found.detail };
+        },
+    });
+    ctx.registerCommand('kvcoder.job.cancel', {
+        description: "Stops a running background process or program worker's run of a chat, or cancels its background subagent.",
+        input: sessionJobSchema,
+        output: z.object({}),
+        public: true,
+        handle: async ({ sessionId, id }) => {
+            userOnly(ctx, 'kvcoder.job.cancel');
+            await findSession(ctx, sessionId);
+            const found = await jobDetail(ctx, sessionId, id);
+            if (found === undefined)
+                throw ctx.problem('kvcoder/JOB_NOT_FOUND', { sessionId, id });
+            await cancelJob(ctx, sessionId, found.row, 'person');
+            return {};
+        },
+    });
+}
+//# sourceMappingURL=register-jobs.js.map

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

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

package/dist/mcp/command-transport.d.ts

@@ -0,0 +1,17 @@
+import type { SpawnOptions } from 'node:child_process';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import type { Platform } from '../calls/shell-command.ts';
+export type CommandStart = {
+    command: string;
+    args: readonly string[];
+    cwd: string;
+    env: Readonly<Record<string, string>>;
+};
+/** A command's transport, and the last of what the command wrote to its error output. */
+export type CommandTransport = Transport & {
+    errorOutput(): string;
+};
+/** How the command is started on each OS: in its own group where the group is what gets killed. */
+export declare function commandSpawn(platform: Platform, start: CommandStart, environment: NodeJS.ProcessEnv): SpawnOptions;
+export declare function commandTransport(start: CommandStart): CommandTransport;
+//# sourceMappingURL=command-transport.d.ts.map

package/dist/mcp/command-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-transport.d.ts","sourceRoot":"","sources":["../../src/mcp/command-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAE/E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAM1D,MAAM,MAAM,YAAY,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC;AAE5H,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG;IAAE,WAAW,IAAI,MAAM,CAAA;CAAE,CAAC;AAErE,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,GAAG,YAAY,CAElH;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,gBAAgB,CAiDtE"}

package/dist/mcp/command-transport.js

@@ -0,0 +1,60 @@
+import spawn from 'cross-spawn';
+import { ReadBuffer, serializeMessage } from '@modelcontextprotocol/sdk/shared/stdio.js';
+import { killTree } from "../calls/run-shell.js";
+/** How the command is started on each OS: in its own group where the group is what gets killed. */
+export function commandSpawn(platform, start, environment) {
+    return { cwd: start.cwd, env: { ...environment, ...start.env }, stdio: ['pipe', 'pipe', 'pipe'], detached: platform !== 'win32', windowsHide: true };
+}
+const errorOutputKept = 2_000;
+export function commandTransport(start) {
+    const buffer = new ReadBuffer();
+    let child;
+    let closed = Promise.resolve();
+    let errors = Buffer.alloc(0);
+    const transport = {
+        errorOutput: () => errors.toString('utf8').trim(),
+        start: () => new Promise((resolve, reject) => {
+            const started = spawn(start.command, [...start.args], commandSpawn(process.platform, start, process.env));
+            child = started;
+            closed = new Promise((done) => started.once('exit', () => done()));
+            started.once('error', (error) => {
+                reject(error);
+                transport.onerror?.(error);
+            });
+            started.once('spawn', () => resolve());
+            started.once('exit', () => transport.onclose?.());
+            started.stdin?.on('error', (error) => transport.onerror?.(error));
+            started.stderr?.on('data', (chunk) => (errors = Buffer.concat([errors, chunk]).subarray(-errorOutputKept)));
+            started.stdout?.on('data', (chunk) => {
+                buffer.append(chunk);
+                try {
+                    for (let message = buffer.readMessage(); message !== null; message = buffer.readMessage())
+                        transport.onmessage?.(message);
+                }
+                catch (error) {
+                    transport.onerror?.(error instanceof Error ? error : new Error(String(error)));
+                }
+            });
+        }),
+        send: (message) => new Promise((resolve, reject) => {
+            const input = child?.stdin;
+            if (input === undefined || input === null || !input.writable)
+                return reject(new Error('The server has exited.'));
+            input.write(serializeMessage(message), (error) => (error === null || error === undefined ? resolve() : reject(error)));
+        }),
+        // A command that never started has no pid and nothing to wait for. A process that left the group may still hold
+        // the pipes, so the wait is for the command's exit, and the pipes are then dropped.
+        close: async () => {
+            const pid = child?.pid;
+            if (pid === undefined)
+                return;
+            killTree(pid);
+            await closed;
+            child?.stdout?.destroy();
+            child?.stderr?.destroy();
+            buffer.clear();
+        },
+    };
+    return transport;
+}
+//# sourceMappingURL=command-transport.js.map

package/dist/mcp/command-transport.js.map

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

package/dist/mcp/connect.d.ts

@@ -0,0 +1,12 @@
+import { type Ctx } from '@kvman/sdk';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import type { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import type { McpServer } from './servers.ts';
+/** What the work gets: the connected client, and the options every request of this connection takes. */
+export type Connection = {
+    client: Client;
+    request: RequestOptions;
+};
+/** Connects to a server, runs `work`, and closes the connection; a failure is a Problem with the reason. */
+export declare function withServer<Result>(ctx: Ctx, server: McpServer, timeoutMs: number, work: (connection: Connection) => Promise<Result>): Promise<Result>;
+//# sourceMappingURL=connect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/mcp/connect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAKnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,wGAAwG;AACxG,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC;AA8BrE,4GAA4G;AAC5G,wBAAsB,UAAU,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB3J"}