@kvman/kvcoder 0.1.6 → 0.1.7

package/dist/connectors/background.js

@@ -1,31 +1,43 @@
 import { z } from '@kvman/sdk';
+import { delay } from "../delay.js";
 import { cancelJob, jobDetail, jobRows } from "../jobs/job-rows.js";
 import { callInput } from "./connector-command.js";
 // The `background` connector (plan 08 §8.5, ADR 0011, 6): what this chat started with `background: true`, a process or
-// a subagent, listed, read, or stopped by the id the starting call returned. The agent sees no kernel job.
+// 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. */
-export const backgroundDescription = 'Follow up on what you started with background set to true: a server or other long-running shell line, or a background subagent. Use it to see its status or output, or to stop it.';
-const started = z.strictObject({ id: z.string().min(1).describe('The id that the call which started the work returned.') });
-const payloads = { list: z.strictObject({}), output: started, stop: started };
+export const backgroundDescription = 'Follow up on what you started with background set to true: a server or other long-running shell line, or a background subagent. Use it to see its status or output, to wait for it to end, or to stop it. When you need a run\'s result before you can go on, call wait once: asking for its output again and again fills the conversation, and a run that ends tells you in a message anyway.';
+const id = z.string().min(1).describe('The id that the call which started the work returned.');
+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 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() }),
+    stop: started,
+};
 export const backgroundCommands = {
-    list: { registration: 'kvcoder.background.list', description: "Lists this chat's newest 50 background runs, newest first.", payload: payloads.list, asks: false },
-    output: { registration: 'kvcoder.background.output.get', description: "Gives one background run's status, and its output (a process's last 100 lines, a subagent's answer, or what a program worker's run returned).", payload: payloads.output, asks: false },
+    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 },
     stop: { registration: 'kvcoder.background.stop', description: "Stops a background process or a program worker's run, or cancels a background subagent.", payload: payloads.stop, asks: false },
 };
-const rowSchema = z.object({
-    id: z.string(),
-    kind: z.enum(['process', 'subagent', 'worker']),
-    call: z.string(),
-    status: z.string(),
-    startedAt: z.string(),
-    endedAt: z.string().exactOptional(),
-    exitCode: z.number().int().exactOptional(),
-});
-const forAgent = (row) => ({ id: row.id, kind: row.kind, call: row.call, status: row.status, startedAt: row.startedAt, ...(row.endedAt === undefined ? {} : { endedAt: row.endedAt }), ...(row.exitCode === undefined ? {} : { exitCode: row.exitCode }) });
-async function startedBy(ctx, sessionId, id) {
-    const found = await jobDetail(ctx, sessionId, id);
+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 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) });
+async function startedBy(ctx, sessionId, runId, lines) {
+    const found = await jobDetail(ctx, sessionId, runId, lines);
     if (found === undefined)
-        throw ctx.problem('kvcoder/JOB_NOT_FOUND', { sessionId, id });
+        throw ctx.problem('kvcoder/JOB_NOT_FOUND', { sessionId, id: runId });
     return found;
 }
 const commands = backgroundCommands;
@@ -33,15 +45,33 @@ export function registerBackgroundConnector(ctx) {
     ctx.registerQuery('kvcoder.background.list', {
         description: commands.list.description,
         input: callInput(payloads.list),
-        output: z.array(rowSchema),
-        handle: async ({ sessionId }) => (await jobRows(ctx, sessionId)).map(forAgent),
+        output: z.array(shortRowSchema),
+        handle: async ({ sessionId }) => (await jobRows(ctx, sessionId)).map(shortRow),
     });
     ctx.registerQuery('kvcoder.background.output.get', {
         description: commands.output.description,
         input: callInput(payloads.output),
-        output: rowSchema.extend({ output: z.json().exactOptional(), problem: z.json().exactOptional() }),
+        output: detailSchema,
+        handle: async ({ sessionId, payload }) => {
+            const found = await startedBy(ctx, sessionId, payload.id, payload.lines);
+            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.
+    ctx.registerCommand('kvcoder.background.wait', {
+        description: commands.wait.description,
+        input: callInput(payloads.wait),
+        output: detailSchema,
+        retries: 0,
+        timeoutMs: waitLimitMs + 60_000,
         handle: async ({ sessionId, payload }) => {
-            const found = await startedBy(ctx, sessionId, payload.id);
+            const until = Date.now() + (payload.timeoutMs ?? waitDefaultMs);
+            let found = await startedBy(ctx, sessionId, payload.id);
+            while (found.row.status === 'running' && Date.now() < until) {
+                await delay(Math.min(lookEveryMs, until - Date.now()), ctx.job.signal);
+                ctx.job.signal.throwIfAborted();
+                found = await startedBy(ctx, sessionId, payload.id);
+            }
             return { ...forAgent(found.row), ...found.detail };
         },
     });

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/builtin-connectors.d.ts

@@ -22,6 +22,7 @@ export declare const builtinCommands: {
             payload: import("zod").ZodObject<{
                 path: import("zod").ZodString;
                 fromLine: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                fromColumn: import("zod").ZodExactOptional<import("zod").ZodNumber>;
                 lines: import("zod").ZodExactOptional<import("zod").ZodNumber>;
             }, import("zod/v4/core").$strict>;
             asks: false;
@@ -42,6 +43,8 @@ export declare const builtinCommands: {
             payload: import("zod").ZodObject<{
                 pattern: import("zod").ZodString;
                 path: import("zod").ZodExactOptional<import("zod").ZodString>;
+                literal: import("zod").ZodExactOptional<import("zod").ZodBoolean>;
+                glob: import("zod").ZodExactOptional<import("zod").ZodString>;
             }, import("zod/v4/core").$strict>;
             asks: false;
             bounded: true;
@@ -69,6 +72,34 @@ export declare const builtinCommands: {
             }, import("zod/v4/core").$strict>;
             asks: true;
         };
+        undo: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                risky: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strict>;
+            asks: true;
+        };
+        part: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                part: import("zod").ZodNumber;
+                content: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+        assemble: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                path: import("zod").ZodString;
+                risky: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strict>;
+            asks: true;
+        };
     };
     artifact: {
         write: {
@@ -108,6 +139,60 @@ export declare const builtinCommands: {
             asks: false;
         };
     };
+    'execution-map': {
+        set: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                goal: import("zod").ZodString;
+                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;
+                }, import("zod/v4/core").$strict>>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
+        update: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                steps: import("zod").ZodArray<import("zod").ZodObject<{
+                    id: import("zod").ZodString;
+                    status: import("zod").ZodEnum<{
+                        done: "done";
+                        failed: "failed";
+                        todo: "todo";
+                        doing: "doing";
+                        skipped: "skipped";
+                    }>;
+                    evidence: import("zod").ZodExactOptional<import("zod").ZodString>;
+                    note: import("zod").ZodExactOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strict>>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
+        note: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                text: import("zod").ZodString;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+            result: string;
+        };
+        get: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{}, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+    };
     background: {
         list: {
             registration: string;
@@ -120,6 +205,16 @@ export declare const builtinCommands: {
             description: string;
             payload: import("zod").ZodObject<{
                 id: import("zod").ZodString;
+                lines: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strict>;
+            asks: false;
+        };
+        wait: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                id: import("zod").ZodString;
+                timeoutMs: import("zod").ZodExactOptional<import("zod").ZodNumber>;
             }, import("zod/v4/core").$strict>;
             asks: false;
         };
@@ -207,6 +302,21 @@ export declare const builtinCommands: {
             asks: true;
             result: string;
         };
+        run: {
+            registration: string;
+            description: string;
+            payload: import("zod").ZodObject<{
+                server: import("zod").ZodString;
+                steps: import("zod").ZodArray<import("zod").ZodObject<{
+                    tool: import("zod").ZodString;
+                    arguments: import("zod").ZodExactOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>>;
+                }, import("zod/v4/core").$strict>>;
+                timeoutMs: import("zod").ZodExactOptional<import("zod").ZodNumber>;
+                risky: import("zod").ZodBoolean;
+            }, import("zod/v4/core").$strict>;
+            asks: true;
+            result: string;
+        };
     };
 };
 /** A built-in connector's commands by name, in the order `help` lists them. */

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;AASlF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQ0C,CAAC;AAEvE,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,SAAS,EAAE,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAElG;AAED,8HAA8H;AAC9H,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAElG;AAYD,wGAAwG;AACxG,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAQzE,CAAC"}
+{"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"}

package/dist/connectors/builtin-connectors.js

@@ -4,6 +4,7 @@ import { askCommands, askDescription } from "./ask.js";
 import { backgroundCommands, backgroundDescription } from "./background.js";
 import { payloadJsonSchema } from "./connector-command.js";
 import { delegateCommands, delegateDescription } from "./delegate.js";
+import { executionMapCommands, executionMapDescription } from "./execution-map.js";
 import { fsCommands, fsDescription } from "./fs.js";
 import { mcpCommands, mcpDescription } from "./mcp.js";
 import { shellCommands, shellDescription } from "./shell.js";
@@ -13,6 +14,7 @@ export const builtinCommands = {
     shell: shellCommands,
     fs: fsCommands,
     artifact: artifactCommands,
+    'execution-map': executionMapCommands,
     background: backgroundCommands,
     ask: askCommands,
     delegate: delegateCommands,
@@ -24,7 +26,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, 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 };
 }
 // 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.
@@ -41,6 +43,7 @@ export const builtinSignatures = {
     shell: signaturesOf('shell'),
     fs: signaturesOf('fs'),
     artifact: signaturesOf('artifact'),
+    'execution-map': signaturesOf('execution-map'),
     background: signaturesOf('background'),
     ask: signaturesOf('ask'),
     delegate: signaturesOf('delegate'),

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,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7D,mHAAmH;AACnH,oDAAoD;AAEpD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,aAAa;IACpB,EAAE,EAAE,UAAU;IACd,QAAQ,EAAE,gBAAgB;IAC1B,UAAU,EAAE,kBAAkB;IAC9B,GAAG,EAAE,WAAW;IAChB,QAAQ,EAAE,gBAAgB;IAC1B,GAAG,EAAE,WAAW;CACoD,CAAC;AAEvE,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,SAA2B;IACpD,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC;AACpC,CAAC;AAED,8HAA8H;AAC9H,MAAM,UAAU,mBAAmB,CAAC,KAA4B;IAC9D,OAAO,EAAE,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,mBAAmB,EAAE,UAAU,EAAE,qBAAqB,EAAE,GAAG,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,EAAE,cAAc,EAAE,CAAC;AAC1M,CAAC;AAED,oHAAoH;AACpH,yHAAyH;AACzH,SAAS,YAAY,CAAC,SAA2B;IAC/C,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC1D,MAAM,SAAS,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,IAAI,SAAS,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,SAAS,4BAA4B,CAAC,CAAC;QACxG,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,wGAAwG;AACxG,MAAM,CAAC,MAAM,iBAAiB,GAAgD;IAC5E,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC;IAC5B,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC;IACtB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC;IAClC,UAAU,EAAE,YAAY,CAAC,YAAY,CAAC;IACtC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC;IACxB,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC;IAClC,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC;CACzB,CAAC"}
+{"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"}

package/dist/connectors/delegate.d.ts

@@ -1,5 +1,6 @@
 import { z, type Ctx, type Stored } from '@kvman/sdk';
 import { type SubagentWorker, type Worker } from '../delegate/workers.ts';
+import type { CreationGuard } from '../delegate/permission.ts';
 import type { SessionDoc } from '../schemas/records.ts';
 /** What the prompt's index says the connector is for; the session's entry adds its workers. */
 export declare const delegateDescription = "Hand a self-contained task to a worker: a helper agent that works on it alone and returns its answer. Use it for a specialist view or to do a separate part in parallel, or with background set to true while you go on.";
@@ -31,7 +32,7 @@ export declare function registerDelegateConnector(ctx: Ctx): void;
 export declare function createChild(ctx: Ctx, parent: Stored<SessionDoc>, worker: SubagentWorker, run: {
     title: string;
     task: string;
-}): Promise<string>;
+}, guard: CreationGuard): Promise<string>;
 /** Starts the child's turn and tells the parent's stream, so the conversation can stream the child (ADR 0009, 99). */
-export declare function startChild(ctx: Ctx, childId: string): Promise<void>;
+export declare function startChild(ctx: Ctx, childId: string, guard: CreationGuard): Promise<void>;
 //# sourceMappingURL=delegate.d.ts.map

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;AAE3F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAYxD,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,6NAC4L,CAAC;AAE7N,4GAA4G;AAC5G,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE3E;AAED,eAAO,MAAM,iBAAiB;;;;;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,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BrJ;AAED,sHAAsH;AACtH,wBAAsB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzE"}
+{"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"}

package/dist/connectors/delegate.js

@@ -1,6 +1,8 @@
 import { z } from '@kvman/sdk';
 import { availableWorker } 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";
@@ -16,9 +18,12 @@ export const delegateDescription = 'Hand a self-contained task to a worker: a he
 export function delegateIndexDescription(workers) {
     return `${delegateDescription} Workers: ${workers.map((worker) => `${worker.name} (${worker.description.replace(/[.\s]+$/, '')})`).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).
+const shownTitle = (title) => (title.length > titleShown ? `${title.slice(0, titleShown - 1)}…` : title);
 export const delegateRunSchema = z.strictObject({
     worker: z.string().min(1).describe('The worker to hand the task to, by a name the system prompt lists.'),
-    title: z.string().min(1).max(60).describe("The role this run plays, in a few words, such as UI expert or Node.js expert: the person sees it as the helper's name. Up to 60 characters."),
+    title: z.string().min(1).max(200).describe("The role this run plays, in a few words, such as UI expert or Node.js expert: the person sees it as the helper's name. Keep it under 60 characters; a longer one is shortened."),
     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(),
 });
@@ -39,23 +44,32 @@ export function registerDelegateConnector(ctx) {
     });
 }
 /** Creates the worker's child session, named by the run's title (ADR 0037, 2), with the task as its first message. */
-export async function createChild(ctx, parent, worker, run) {
+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'));
     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 child = store.sessions.insert({
-            title: run.title,
+            title: shownTitle(run.title),
             autoTitle: false,
+            deleting: false,
             status: 'idle',
             parentId: parent.id,
-            worker: { name: worker.name, instructions: worker.instructions },
-            model: worker.model ?? parent.model,
-            thinking: worker.thinking ?? parent.thinking,
+            worker: { name: worker.name, instructions: worker.instructions, readOnly: worker.readOnly },
+            model: worker.model ?? helperModel ?? canonical.model,
+            thinking: worker.thinking ?? canonical.thinking,
             stepJobId: null,
+            stepGeneration: 0,
+            stepIntentId: null,
             turnId: null,
             endedTurns: 0,
             nextSeq: 0,
             usage: noUsage(),
+            usageBy: { summary: noUsage(), title: noUsage(), helpers: noUsage() },
             durationMs: 0,
             checks: null,
             connectors: worker.connectors,
@@ -70,15 +84,19 @@ export async function createChild(ctx, parent, worker, run) {
     return childId;
 }
 /** Starts the child's turn and tells the parent's stream, so the conversation can stream the child (ADR 0009, 99). */
-export async function startChild(ctx, childId) {
+export async function startChild(ctx, childId, guard) {
     const turnId = await ctx.store.transaction((tx) => {
         const store = txRecords(tx);
+        const parent = guard(store);
         const child = store.sessions.get(childId);
-        return child === undefined || child.status !== 'idle' ? undefined : openTurn(store, child);
+        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);
     });
     if (turnId === undefined)
         return;
     const jobId = await beginTurn(ctx, childId, turnId, false);
-    ctx.job.progress({ type: 'subagent', sessionId: childId, jobId });
+    if (jobId !== null)
+        ctx.job.progress({ type: 'subagent', sessionId: childId, jobId });
 }
 //# sourceMappingURL=delegate.js.map

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":"AAAA,OAAO,EAAE,CAAC,EAAyB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,eAAe,EAAoC,MAAM,wBAAwB,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,EAAE,GAAG,EAAE,MAAM,+BAA+B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAyB,MAAM,wBAAwB,CAAC;AAE1E,sHAAsH;AACtH,oHAAoH;AACpH,yKAAyK;AACzK,4CAA4C;AAE5C,+FAA+F;AAC/F,MAAM,CAAC,MAAM,mBAAmB,GAC9B,0NAA0N,CAAC;AAE7N,4GAA4G;AAC5G,MAAM,UAAU,wBAAwB,CAAC,OAA0B;IACjE,OAAO,GAAG,mBAAmB,aAAa,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACnJ,CAAC;AAED,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,sHAAsH;AACtH,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAEzH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IACxG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,gLAAgL,CAAC;IAC5N,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yFAAyF,CAAC;IAC3H,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,qEAAqE,CAAC,CAAC,aAAa,EAAE;CACxH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,GAAG,EAAE,EAAE,YAAY,EAAE,wBAAwB,EAAE,WAAW,EAAE,qEAAqE,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,6DAA6D,EAAE;CACzM,CAAC;AAI7C,MAAM,UAAU,yBAAyB,CAAC,GAAQ;IAChD,GAAG,CAAC,eAAe,CAAC,wBAAwB,EAAE;QAC5C,WAAW,EAAE,gBAAgB,CAAC,GAAG,CAAC,WAAW;QAC7C,KAAK,EAAE,SAAS,CAAC,iBAAiB,CAAC;QACnC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACjE,MAAM,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YACpE,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAQ,EAAE,MAA0B,EAAE,MAAsB,EAAE,GAAoC,EAAE,KAAoB;IACxJ,4GAA4G;IAC5G,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC;IACjG,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,SAAS,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE;YAAE,MAAM,OAAO,CAAC,8CAA8C,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAClC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;YAC5B,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;YAC3F,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,WAAW,IAAI,SAAS,CAAC,KAAK;YACrD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ;YAC/C,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,OAAO,EAAE;YAClB,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;YACnE,UAAU,EAAE,CAAC;YACb,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,EAAE;YACX,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAClI,OAAO,KAAK,CAAC,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,CAAC,GAAG,EAAE,yBAAyB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7F,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,sHAAsH;AACtH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAQ,EAAE,OAAe,EAAE,KAAoB;IAC9E,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE;QAChD,MAAM,KAAK,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE;YAAE,MAAM,OAAO,CAAC,yDAAyD,CAAC,CAAC;QAClI,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAChJ,CAAC,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO;IACjC,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3D,IAAI,KAAK,KAAK,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACxF,CAAC"}

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

@@ -0,0 +1,62 @@
+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.";
+/** The steps one map holds at most, and its notes. */
+export declare const stepsLimit = 40;
+export declare const notesLimit = 50;
+export declare const executionMapCommands: {
+    set: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            goal: z.ZodString;
+            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;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
+    update: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            steps: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                status: z.ZodEnum<{
+                    done: "done";
+                    failed: "failed";
+                    todo: "todo";
+                    doing: "doing";
+                    skipped: "skipped";
+                }>;
+                evidence: z.ZodExactOptional<z.ZodString>;
+                note: z.ZodExactOptional<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
+    note: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{
+            text: z.ZodString;
+        }, z.core.$strict>;
+        asks: false;
+        result: string;
+    };
+    get: {
+        registration: string;
+        description: string;
+        payload: z.ZodObject<{}, z.core.$strict>;
+        asks: false;
+    };
+};
+export declare function registerExecutionMapConnector(ctx: Ctx): void;
+//# sourceMappingURL=execution-map.d.ts.map

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

@@ -0,0 +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,uxBACkvB,CAAC;AAEvxB,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"}