@kvman/kvcoder 0.1.10 → 0.1.12

package/dist/connectors/background.js

@@ -1,7 +1,9 @@
 import { z } from '@kvman/sdk';
 import { delay } from "../delay.js";
 import { cancelJob, jobDetail, jobRows } from "../jobs/job-rows.js";
+import { records } from "../store/collections.js";
 import { callInput } from "./connector-command.js";
+import { cutInto } from "./payload-fields.js";
 // The `background` connector (plan 08 §8.5, ADR 0011, 6): what this chat started with `background: true`, a process or
 // a subagent, listed, read, waited for, or stopped by the id the starting call returned. The agent sees no kernel job.
 /** What the prompt's index says the connector is for. */
@@ -11,29 +13,34 @@ const started = z.strictObject({ id });
 /** How long `wait` waits when the call names no time, the most it waits, and how often it looks. */
 export const waitDefaultMs = 120_000;
 export const waitLimitMs = 600_000;
+const waitLeastMs = 1_000;
+const linesDefault = 100;
+const linesLimit = 500;
 const lookEveryMs = 500;
 const titleShown = 80;
 const payloads = {
     list: z.strictObject({}),
-    output: z.strictObject({ id, lines: z.number().int().min(1).max(500).describe("How many of a process's last lines to return: 100 by default, 500 at most.").exactOptional() }),
-    wait: z.strictObject({ id, timeoutMs: z.number().int().min(1000).max(waitLimitMs).describe('The most to wait, in milliseconds: 120000 by default, 600000 at most.').exactOptional() }),
+    output: z.strictObject({ id, lines: z.number().int().describe("How many of a process's last lines to return: 100 by default, 500 at most; a larger number is cut to 500.").exactOptional() }),
+    wait: z.strictObject({ id, timeoutMs: z.number().int().describe('The most to wait, in milliseconds: 120000 by default, from 1000 to 600000; a number outside them is cut into them.').exactOptional() }),
     stop: started,
 };
 export const backgroundCommands = {
     list: { registration: 'kvcoder.background.list', description: "Lists this chat's newest 50 background runs, newest first, each with its id, kind, title, and status.", payload: payloads.list, asks: false },
-    output: { registration: 'kvcoder.background.output.get', description: "Gives one background run's status, and its output (a process's last lines, a subagent's answer, or what a program worker's run returned).", payload: payloads.output, asks: false },
-    wait: { registration: 'kvcoder.background.wait', description: 'Waits until a background run ends or the time passes, then gives its status and output as output does.', payload: payloads.wait, asks: false },
+    output: { registration: 'kvcoder.background.output.get', description: "Gives one background run's status, and its output (a process's last lines, a subagent's answer, or what a program worker's run returned); a subagent's also says how far it got (progress) and, when its status is waiting, the calls it waits on the person for (waitingFor).", payload: payloads.output, asks: false },
+    wait: { registration: 'kvcoder.background.wait', description: 'Waits until a background run ends, a helper starts waiting on the person (status waiting), the person sends a message (note), or the time passes, then gives its status and output as output does.', payload: payloads.wait, asks: false },
     stop: { registration: 'kvcoder.background.stop', description: "Stops a background process or a program worker's run, or cancels a background subagent.", payload: payloads.stop, asks: false },
 };
 const times = { status: z.string(), startedAt: z.string(), endedAt: z.string().exactOptional(), exitCode: z.number().int().exactOptional() };
 const kind = z.enum(['process', 'subagent', 'worker']);
 const rowSchema = z.object({ id: z.string(), kind, call: z.string(), ...times });
 const shortRowSchema = z.object({ id: z.string(), kind, title: z.string(), ...times });
-const detailSchema = rowSchema.extend({ output: z.json().exactOptional(), problem: z.json().exactOptional() });
+const detailSchema = rowSchema.extend({ output: z.json().exactOptional(), problem: z.json().exactOptional(), progress: z.object({ steps: z.number().int(), lastActivityAt: z.string(), recentCalls: z.array(z.string()) }).exactOptional(), waitingFor: z.array(z.string()).exactOptional(), note: z.string().exactOptional() });
 const ended = (row) => ({ ...(row.endedAt === undefined ? {} : { endedAt: row.endedAt }), ...(row.exitCode === undefined ? {} : { exitCode: row.exitCode }) });
 const forAgent = (row) => ({ id: row.id, kind: row.kind, call: row.call, status: row.status, startedAt: row.startedAt, ...ended(row) });
 // A list names each run in a few words (ADR 0068, 2): the whole line or task is in `output`.
 const shortRow = (row) => ({ id: row.id, kind: row.kind, title: row.title.length > titleShown ? `${row.title.slice(0, titleShown - 1)}…` : row.title, status: row.status, startedAt: row.startedAt, ...ended(row) });
+// A message from the person queued for the chat ends a wait, so the step ends and the message is read (ADR 0085, 3).
+const personWrote = async (ctx, sessionId) => (await records(ctx.store).queued.find({ sessionId }, { limit: 100 })).some((item) => item.source.kind === 'user');
 async function startedBy(ctx, sessionId, runId, lines) {
     const found = await jobDetail(ctx, sessionId, runId, lines);
     if (found === undefined)
@@ -53,11 +60,12 @@ export function registerBackgroundConnector(ctx) {
         input: callInput(payloads.output),
         output: detailSchema,
         handle: async ({ sessionId, payload }) => {
-            const found = await startedBy(ctx, sessionId, payload.id, payload.lines);
+            const found = await startedBy(ctx, sessionId, payload.id, cutInto(payload.lines ?? linesDefault, 1, linesLimit));
             return { ...forAgent(found.row), ...found.detail };
         },
     });
     // A run is looked at until it has ended (ADR 0068, 1), as a line in the shell waits on its process: the wait is this job's own.
+    // It ends early when a helper starts waiting on the person (ADR 0085, 2) or the person sends a message (ADR 0085, 3).
     ctx.registerCommand('kvcoder.background.wait', {
         description: commands.wait.description,
         input: callInput(payloads.wait),
@@ -65,9 +73,11 @@ export function registerBackgroundConnector(ctx) {
         retries: 0,
         timeoutMs: waitLimitMs + 60_000,
         handle: async ({ sessionId, payload }) => {
-            const until = Date.now() + (payload.timeoutMs ?? waitDefaultMs);
+            const until = Date.now() + cutInto(payload.timeoutMs ?? waitDefaultMs, waitLeastMs, waitLimitMs);
             let found = await startedBy(ctx, sessionId, payload.id);
             while (found.row.status === 'running' && Date.now() < until) {
+                if (await personWrote(ctx, sessionId))
+                    return { ...forAgent(found.row), ...found.detail, note: 'The person sent a message.' };
                 await delay(Math.min(lookEveryMs, until - Date.now()), ctx.job.signal);
                 ctx.job.signal.throwIfAborted();
                 found = await startedBy(ctx, sessionId, payload.id);

package/dist/connectors/background.js.map

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

package/dist/connectors/binary.js

@@ -15,12 +15,12 @@ export function registerBinaryConnector(ctx) {
         input: lineCallInput(execPayload).extend({ connector: z.string().describe('The binary connector whose program runs.') }),
         output: lineRunSchema,
         ...lineRunOptions,
-        handle: async ({ sessionId, description, connector, payload }) => {
+        handle: async ({ sessionId, connector, payload }) => {
             const binary = (await activeConnectors(ctx)).find((candidate) => candidate.name === connector && candidate.kind === 'binary');
             if (binary === undefined)
                 throw notFound(`There is no binary connector ${connector}.`, { connector });
             const args = payload.args?.trim() ?? '';
-            return runLine(ctx, { sessionId, description }, args === '' ? connector : `${connector} ${args}`, payload);
+            return runLine(ctx, sessionId, args === '' ? connector : `${connector} ${args}`, payload);
         },
     });
 }

package/dist/connectors/binary.js.map

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

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

@@ -28,6 +28,19 @@ export declare const builtinCommands: {
             asks: false;
             bounded: true;
         };
+        'read-files': {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                files: import("zod").ZodArray<import("zod").ZodObject<{
+                    path: import("zod").ZodString;
+                    fromLine: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                    lines: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strict>>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            bounded: true;
+        };
         list: {
             registration: string;
             description: string;
@@ -37,6 +50,16 @@ export declare const builtinCommands: {
             asks: false;
             bounded: true;
         };
+        find: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                pattern: import("zod").ZodString;
+                path: import("zod").ZodExactOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            bounded: true;
+        };
         search: {
             registration: string;
             description: string;
@@ -45,6 +68,8 @@ export declare const builtinCommands: {
                 path: import("zod").ZodExactOptional<import("zod").ZodString>;
                 literal: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
                 glob: import("zod").ZodExactOptional<import("zod").ZodString>;
+                context: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                filesOnly: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
             }, import("zod/v4/core").$strict>;
             asks: false;
             bounded: true;
@@ -67,6 +92,7 @@ export declare const builtinCommands: {
                 edits: import("zod").ZodArray<import("zod").ZodObject<{
                     oldText: import("zod").ZodString;
                     newText: import("zod").ZodString;
+                    replaceAll: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
                 }, import("zod/v4/core").$strict>>;
                 risky: import("zod").ZodBoolean;
             }, import("zod/v4/core").$strict>;
@@ -126,6 +152,7 @@ export declare const builtinCommands: {
                 edits: import("zod").ZodArray<import("zod").ZodObject<{
                     oldText: import("zod").ZodString;
                     newText: import("zod").ZodString;
+                    replaceAll: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
                 }, import("zod/v4/core").$strict>>;
             }, import("zod/v4/core").$strict>;
             asks: false;
@@ -148,7 +175,6 @@ export declare const builtinCommands: {
                 steps: import("zod").ZodArray<import("zod").ZodObject<{
                     id: import("zod").ZodString;
                     title: import("zod").ZodString;
-                    description: import("zod").ZodString;
                     after: import("zod").ZodExactOptional<import("zod").ZodArray<import("zod").ZodString>>;
                     uses: import("zod").ZodExactOptional<import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>]>>;
                     check: import("zod").ZodString;
@@ -157,6 +183,16 @@ export declare const builtinCommands: {
             asks: false;
             result: string;
         };
+        detail: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                details: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
         update: {
             registration: string;
             description: string;
@@ -189,7 +225,9 @@ export declare const builtinCommands: {
         get: {
             registration: string;
             description: string;
-            payload: import("zod").ZodObject<{}, import("zod/v4/core").$strict>;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodExactOptional<import("zod").ZodString>;
+            }, import("zod/v4/core").$strict>;
             asks: false;
         };
     };
@@ -278,6 +316,17 @@ export declare const builtinCommands: {
             asks: false;
             result: string;
         };
+        continue: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                message: import("zod").ZodString;
+                background: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
     };
     mcp: {
         tools: {
@@ -318,6 +367,17 @@ export declare const builtinCommands: {
             result: string;
         };
     };
+    web: {
+        fetch: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                url: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            bounded: true;
+        };
+    };
 };
 /** A built-in connector's commands by name, in the order `help` lists them. */
 export declare function commandsOf(connector: BuiltinConnector): Readonly<Record<string, ConnectorCommand>>;

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

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

package/dist/connectors/builtin-connectors.js

@@ -8,6 +8,7 @@ import { executionMapCommands, executionMapDescription } from "./execution-map.j
 import { fsCommands, fsDescription } from "./fs.js";
 import { mcpCommands, mcpDescription } from "./mcp.js";
 import { shellCommands, shellDescription } from "./shell.js";
+import { webCommands, webDescription } from "./web.js";
 // kvcoder's own connectors together (plan 08 §8.3 and §8.5): each lives in its own file, with its description, its
 // payloads, its commands, and the jobs behind them.
 export const builtinCommands = {
@@ -19,6 +20,7 @@ export const builtinCommands = {
     ask: askCommands,
     delegate: delegateCommands,
     mcp: mcpCommands,
+    web: webCommands,
 };
 /** A built-in connector's commands by name, in the order `help` lists them. */
 export function commandsOf(connector) {
@@ -26,7 +28,7 @@ export function commandsOf(connector) {
 }
 /** What the prompt's connector index and `help` say each built-in connector is for; `shell` names the shell this run uses. */
 export function builtinDescriptions(shell) {
-    return { shell: shellDescription(shell), fs: fsDescription, artifact: artifactDescription, 'execution-map': executionMapDescription, background: backgroundDescription, ask: askDescription, delegate: delegateDescription, mcp: mcpDescription };
+    return { shell: shellDescription(shell), fs: fsDescription, artifact: artifactDescription, 'execution-map': executionMapDescription, background: backgroundDescription, ask: askDescription, delegate: delegateDescription, mcp: mcpDescription, web: webDescription };
 }
 // Each built-in payload is an object, so a missing signature is a programming error, not a case the prompt may fall
 // back from; computed once per worker, not at every prompt build. In the order of `commandsOf`, like the prompt's lines.
@@ -48,5 +50,6 @@ export const builtinSignatures = {
     ask: signaturesOf('ask'),
     delegate: signaturesOf('delegate'),
     mcp: signaturesOf('mcp'),
+    web: signaturesOf('web'),
 };
 //# sourceMappingURL=builtin-connectors.js.map

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

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

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

@@ -20,7 +20,6 @@ export declare function callInput<Payload extends z.ZodType>(payload: Payload):
 /** The same for a command that runs in the real shell: with the call's description, which names a background run. */
 export declare function lineCallInput<Payload extends z.ZodType>(payload: Payload): z.ZodObject<{
     sessionId: z.ZodString;
-    description: z.ZodString;
     payload: Payload;
 }, z.core.$strict>;
 //# sourceMappingURL=connector-command.d.ts.map

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

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

package/dist/connectors/connector-command.js

@@ -12,6 +12,6 @@ export function callInput(payload) {
 }
 /** The same for a command that runs in the real shell: with the call's description, which names a background run. */
 export function lineCallInput(payload) {
-    return z.strictObject({ sessionId, description: z.string().describe("The call's description, for the person."), payload: payload.describe("The command's payload.") });
+    return z.strictObject({ sessionId, payload: payload.describe("The command's payload.") });
 }
 //# sourceMappingURL=connector-command.js.map

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

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

package/dist/connectors/delegate.d.ts

@@ -12,6 +12,11 @@ export declare const delegateRunSchema: z.ZodObject<{
     task: z.ZodString;
     background: z.ZodExactOptional<z.ZodBoolean>;
 }, z.core.$strict>;
+export declare const delegateContinueSchema: z.ZodObject<{
+    id: z.ZodString;
+    message: z.ZodString;
+    background: z.ZodExactOptional<z.ZodBoolean>;
+}, z.core.$strict>;
 export declare const delegateCommands: {
     run: {
         registration: string;
@@ -25,7 +30,19 @@ export declare const delegateCommands: {
         asks: false;
         result: string;
     };
+    continue: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            message: z.ZodString;
+            background: z.ZodExactOptional<z.ZodBoolean>;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
 };
+export type DelegateContinue = z.output<typeof delegateContinueSchema>;
 export type DelegateRun = z.output<typeof delegateRunSchema>;
 export declare function registerDelegateConnector(ctx: Ctx): void;
 /** Creates the worker's child session, named by the run's title (ADR 0037, 2), with the task as its first message. */

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

@@ -1 +1 @@
-{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/connectors/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAmB,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAI3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAYxD,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,6NAC4L,CAAC;AAE7N,4GAA4G;AAC5G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE3E;AAOD,eAAO,MAAM,iBAAiB;;;;;kBAK5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;CAEe,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAYxD;AAED,sHAAsH;AACtH,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAqC3K;AAED,sHAAsH;AACtH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F"}
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../../src/connectors/delegate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAoC,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAI5G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAcxD,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,6NAC4L,CAAC;AAK7N,4GAA4G;AAC5G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE3E;AAOD,eAAO,MAAM,iBAAiB;;;;;kBAK5B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;kBAIjC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;CAGe,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAYxD;AAED,sHAAsH;AACtH,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CA+C3K;AAQD,sHAAsH;AACtH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F"}

package/dist/connectors/delegate.js

@@ -1,11 +1,13 @@
 import { z } from '@kvman/sdk';
-import { availableWorker } from "../delegate/workers.js";
+import { availableWorker, workerCheckName } from "../delegate/workers.js";
 import { firePoint } from "../registry/session-points.js";
 import { invalid } from "../problems.js";
 import { settingSchemas } from "../register-settings.js";
 import { now } from "../sessions/session-lookup.js";
 import { records, txRecords } from "../store/collections.js";
 import { appendMessage, noUsage, userContent } from "../turns/history.js";
+import { modelInfo } from "../turns/model-info.js";
+import { nearestLevel } from "../thinking-levels.js";
 import { beginTurn, openTurn } from "../turns/start-turn.js";
 import { callInput } from "./connector-command.js";
 // The `delegate` connector (plan 08 §8.5, ADR 0021): a task handed to a worker. A subagent worker runs it in a hidden
@@ -14,9 +16,11 @@ import { callInput } from "./connector-command.js";
 // step then starts the child (ADR 0011, 9).
 /** What the prompt's index says the connector is for; the session's entry adds its workers. */
 export const delegateDescription = 'Hand a self-contained task to a worker: a helper agent that works on it alone and returns its answer. Use it for a specialist view or to do a separate part in parallel, or with background set to true while you go on.';
+// A read-only worker says so, so the lead hands it no change to make (ADR 0085, 9).
+const readOnlyNote = (worker) => (worker.kind === 'subagent' && worker.readOnly ? '; read-only' : '');
 /** The connector's description with the available workers, as the prompt's index shows it (ADR 0021, 1). */
 export function delegateIndexDescription(workers) {
-    return `${delegateDescription} Workers: ${workers.map((worker) => `${worker.name} (${worker.description.replace(/[.\s]+$/, '')})`).join(', ')}.`;
+    return `${delegateDescription} Workers: ${workers.map((worker) => `${worker.name} (${worker.description.replace(/[.\s]+$/, '')}${readOnlyNote(worker)})`).join(', ')}.`;
 }
 const titleShown = 60;
 // A helper's name as the person sees it: a title over 60 characters keeps its first 59 and an ellipsis (ADR 0051, 4).
@@ -27,8 +31,14 @@ export const delegateRunSchema = z.strictObject({
     task: z.string().min(1).describe("The worker's whole brief: the goal, the facts it needs, its limits, and what to return."),
     background: z.boolean().describe('true lets you go on at once; the answer arrives later as a message.').exactOptional(),
 });
+export const delegateContinueSchema = z.strictObject({
+    id: z.string().min(1).describe('The helper to continue: the id in the line (helper <id>) under its result.'),
+    message: z.string().min(1).describe('What the helper is to do next; it still has its task and everything it did.'),
+    background: z.boolean().describe('true lets you go on at once; the answer arrives later as a message.').exactOptional(),
+});
 export const delegateCommands = {
     run: { registration: 'kvcoder.delegate.check', description: 'Runs a worker on a task; several runs in one reply run in parallel.', payload: delegateRunSchema, asks: false, result: "the worker's final answer, or started <id> with background." },
+    continue: { registration: 'kvcoder.delegate.continue.check', description: 'Sends a follow-up to a helper of this chat that has ended, such as one that came back blocked or with questions: it continues with its own history.', payload: delegateContinueSchema, asks: false, result: "the helper's new answer, or started <id> with background." },
 };
 export function registerDelegateConnector(ctx) {
     ctx.registerCommand('kvcoder.delegate.check', {
@@ -47,12 +57,18 @@ export function registerDelegateConnector(ctx) {
 export async function createChild(ctx, parent, worker, run, guard) {
     // A worker that names no model uses the one set for helpers, and the chat's own when none is (ADR 0069, 3).
     const helperModel = settingSchemas.model.parse(await ctx.settings.get('kvcoder.delegate.model'));
+    // The helper's level is one its model has (ADR 0087, 11); the levels are looked up before the transaction, for the
+    // model the parent has now, and used only when the canonical parent still has it.
+    const expected = worker.model ?? helperModel ?? parent.model;
+    const levels = (await modelInfo(ctx, expected))?.thinkingLevels;
     const childId = await ctx.store.transaction((tx) => {
         const store = txRecords(tx);
         const canonical = guard(store);
         if (canonical.id !== parent.id)
             throw invalid('Delegation requires its originating session.');
         const stamp = now();
+        const model = worker.model ?? helperModel ?? canonical.model;
+        const wanted = worker.thinking ?? canonical.thinking;
         const child = store.sessions.insert({
             title: shownTitle(run.title),
             autoTitle: false,
@@ -60,8 +76,11 @@ export async function createChild(ctx, parent, worker, run, guard) {
             status: 'idle',
             parentId: parent.id,
             worker: { name: worker.name, instructions: worker.instructions, readOnly: worker.readOnly },
-            model: worker.model ?? helperModel ?? canonical.model,
-            thinking: worker.thinking ?? canonical.thinking,
+            model,
+            thinking: levels !== undefined && model === expected ? nearestLevel(levels, wanted) : wanted,
+            decides: false,
+            clearedThroughSeq: null,
+            webHosts: [],
             stepJobId: null,
             stepGeneration: 0,
             stepIntentId: null,
@@ -71,7 +90,8 @@ export async function createChild(ctx, parent, worker, run, guard) {
             usage: noUsage(),
             usageBy: { summary: noUsage(), title: noUsage(), helpers: noUsage() },
             durationMs: 0,
-            checks: null,
+            // A helper starts with its parent's check results: it can't delegate, so the program workers' are left out (ADR 0087, 10).
+            checks: canonical.checks === null ? null : canonical.checks.filter((check) => !check.name.startsWith(workerCheckName(''))),
             connectors: worker.connectors,
             optedIn: [],
             createdAt: stamp,
@@ -83,6 +103,11 @@ export async function createChild(ctx, parent, worker, run, guard) {
     await firePoint(ctx, 'kvcoder.session.created', { sessionId: childId, parentId: parent.id });
     return childId;
 }
+// A child's turn starts on its parent's newest message: its task, or the message of a `continue` (ADR 0085, 4).
+function awaitsParent(store, child) {
+    const [last] = store.messages.find({ sessionId: child.id }, { limit: 1, order: 'desc' });
+    return last?.kind === 'user' && last.source?.kind === 'subagent' && last.source.sessionId === child.parentId;
+}
 /** Starts the child's turn and tells the parent's stream, so the conversation can stream the child (ADR 0009, 99). */
 export async function startChild(ctx, childId, guard) {
     const turnId = await ctx.store.transaction((tx) => {
@@ -91,7 +116,7 @@ export async function startChild(ctx, childId, guard) {
         const child = store.sessions.get(childId);
         if (child !== undefined && child.parentId !== parent.id)
             throw invalid('The child no longer belongs to its originating session.');
-        return child === undefined || child.status !== 'idle' || child.turnId !== null || child.endedTurns !== 0 ? undefined : openTurn(store, child);
+        return child === undefined || child.status !== 'idle' || child.turnId !== null || !awaitsParent(store, child) ? undefined : openTurn(store, child);
     });
     if (turnId === undefined)
         return;

package/dist/connectors/delegate.js.map

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

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

@@ -1,6 +1,6 @@
 import { z, type Ctx } from '@kvman/sdk';
 /** What the prompt's index says the connector is for. */
-export declare const executionMapDescription = "Plan work of several steps as the execution map: your execution path, the steps you found to be the best and fastest way to deliver the request with the connectors and workers you have, and the implementation plan the person reads, agrees to, and watches as a diagram. Keep it true as you work: the person follows the work on it. A step says what it changes and how in its description, which the person opens with a press, names who does it in uses, and comes after the steps it follows. Steps side by side are branches: each is handed to a worker, so they run at the same time, and your own steps are one line. Mark a step doing when you start it and done with your evidence as soon as its check passed, and record a problem the work does not need with note instead of looking into it. Limits: goal up to 300 characters; a step's title up to 100, description up to 500, check up to 300; evidence and a note up to 500; 1 to 40 steps.";
+export declare const executionMapDescription = "Plan work as the execution map: your execution path, and the implementation plan the person reads, agrees to, and watches as a diagram. Keep it true as you work: the person follows the work on it. Give the goal, the outcome the person wants in their own terms, then the steps. A step is one concrete stage of the path, something you can name before you start it, never a phase such as implement or a whole feature: what gets done, who does it, and how it is checked; it may cover the few files that change together. Its uses names who does it: you, with a connector such as fs, or a worker such as delegate designer for a screen or flow whose design is a real choice, delegate architect for a structure decision across several parts, delegate tester for tests that are a piece of work of their own, and delegate reviewer for a finished change that is risky or wide. Its check is the exact command you will run or the thing you will look at. Your own steps are one line, each after the one before. Steps side by side are branches, and a branch means delegation: draw one only for work a worker does that needs nothing from the other branches, touches files no other branch touches, and is worth a worker that starts with none of this conversation; give the branches that start together the same after, or none, and add the step that joins them after every branch it needs. Don't split small independent changes into branches, leave out any step that nothing needs, and end with the project's own checks after everything they cover. Set the skeleton first, then write each step's details with detail, one call per step, all in the reply after the set: what it changes and how, naming the files or parts and the approach in words the person understands without the code, in Markdown, with lists, tables, and Mermaid diagrams or charts in fenced mermaid blocks, never SVG. The person opens them with a press, and a step can't be doing until it has them. Setting the map again keeps the details and the status of each step whose id stays: detail again only a step whose approach changed, and each new step. Every map call returns the steps that are ready: take those, and never work on a step the map does not have. Mark a step doing in the same reply as your first call on it, and when several are ready, mark each and start them all in one reply, one delegate run per branch. Mark a step done with your evidence, what you ran and what it showed, as soon as its check passed and before you start the next; failed with a note when you can't finish it, and skipped with a note when it turned out unneeded. When the plan itself changes, set the map again before you go on, and record a problem the work does not need with note instead of looking into it. Limits: goal up to 300 characters; 1 to 40 steps; a step's id lowercase kebab case up to 50, title up to 100, uses one name up to 60 or a list of up to 5, check up to 300, and details up to 4,000; a step's evidence 10 to 500 and its note up to 300; a note of note up to 500.";
 /** The steps one map holds at most, and its notes. */
 export declare const stepsLimit = 40;
 export declare const notesLimit = 50;
@@ -13,7 +13,6 @@ export declare const executionMapCommands: {
             steps: z.ZodArray<z.ZodObject<{
                 id: z.ZodString;
                 title: z.ZodString;
-                description: z.ZodString;
                 after: z.ZodExactOptional<z.ZodArray<z.ZodString>>;
                 uses: z.ZodExactOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
                 check: z.ZodString;
@@ -22,6 +21,16 @@ export declare const executionMapCommands: {
         asks: false;
         result: string;
     };
+    detail: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            details: z.ZodString;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
     update: {
         registration: string;
         description: string;
@@ -54,7 +63,9 @@ export declare const executionMapCommands: {
     get: {
         registration: string;
         description: string;
-        payload: z.ZodObject<{}, z.core.$strict>;
+        payload: z.ZodObject<{
+            id: z.ZodExactOptional<z.ZodString>;
+        }, z.core.$strict>;
         asks: false;
     };
 };

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

@@ -1 +1 @@
-{"version":3,"file":"execution-map.d.ts","sourceRoot":"","sources":["../../src/connectors/execution-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAczC,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,06BACs4B,CAAC;AAE36B,sDAAsD;AACtD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AA+C7B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKW,CAAC;AAqB7C,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA8D5D"}
+{"version":3,"file":"execution-map.d.ts","sourceRoot":"","sources":["../../src/connectors/execution-map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAczC,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,m9FAC86F,CAAC;AAEn9F,sDAAsD;AACtD,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAkD7B,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMW,CAAC;AAyB7C,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAmF5D"}