@kvman/kvcoder 0.1.15 → 0.1.16

package/dist/prompt/kept-rules.d.ts

@@ -0,0 +1,6 @@
+import type { Ctx, Stored } from '@kvman/sdk';
+import type { SessionDoc } from '../schemas/records.ts';
+import type { StepLease } from '../turns/step-claim.ts';
+/** At a step's start: keeps the rule files of a chat that has none kept yet, else tells it once of each that changed. */
+export declare function keepRules(ctx: Ctx, session: Stored<SessionDoc>, lease: StepLease): Promise<void>;
+//# sourceMappingURL=kept-rules.d.ts.map

package/dist/prompt/kept-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kept-rules.d.ts","sourceRoot":"","sources":["../../src/prompt/kept-rules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAexD,yHAAyH;AACzH,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BtG"}

package/dist/prompt/kept-rules.js

@@ -0,0 +1,47 @@
+import { createHash } from 'node:crypto';
+import { ownerName } from "../jobs/process-records.js";
+import { txRecords } from "../store/collections.js";
+import { appendMessage, userContent } from "../turns/history.js";
+import { liveStep } from "../turns/step-intents.js";
+import { readRules, ruleText } from "./project-rules.js";
+// A chat keeps its rule files' text for its life (plan 08 §8.2, ADR 0108, 6), so its system prompt doesn't change and
+// the provider's cache holds. A kept file whose text later differs is told once, as a message, with its current text.
+const hashOf = (text) => createHash('sha256').update(text).digest('hex');
+const gone = 'gone';
+/** What the chat is told of a kept file that changed: its current text, or that it no longer exists. */
+function changedText(rule, now) {
+    const head = `[kvman: ${rule.path} changed since this chat started.`;
+    return now === undefined ? `${head} It no longer exists.]` : `${head} Its current text:]\n${now}`;
+}
+/** At a step's start: keeps the rule files of a chat that has none kept yet, else tells it once of each that changed. */
+export async function keepRules(ctx, session, lease) {
+    const workspace = ctx.job.workspace.path;
+    if (session.rules === undefined) {
+        const rules = await readRules(workspace);
+        await ctx.store.transaction((tx) => {
+            const live = liveStep(txRecords(tx), lease, lease.jobId);
+            if (live !== undefined && live.session.rules === undefined)
+                txRecords(tx).sessions.update(session.id, { rules });
+        });
+        return;
+    }
+    const kept = session.rules;
+    const now = await Promise.all(kept.map((rule) => ruleText(workspace, rule.path)));
+    const changed = kept.flatMap((rule, index) => {
+        const text = now[index];
+        const told = text === undefined ? gone : hashOf(text);
+        return text === rule.content || told === rule.told ? [] : [{ index, told, message: changedText(rule, text) }];
+    });
+    if (changed.length === 0)
+        return;
+    await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const live = liveStep(store, lease, lease.jobId);
+        if (live === undefined)
+            return;
+        const rules = kept.map((rule, index) => ({ ...rule, told: changed.find((entry) => entry.index === index)?.told ?? rule.told }));
+        store.sessions.update(session.id, { rules });
+        appendMessage(store, store.sessions.get(session.id) ?? live.session, { kind: 'user', content: userContent(changed.map((entry) => entry.message).join('\n\n')), turnId: lease.turnId, source: { kind: 'extension', name: ownerName } });
+    });
+}
+//# sourceMappingURL=kept-rules.js.map

package/dist/prompt/kept-rules.js.map

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

package/dist/prompt/project-rules.d.ts

@@ -1,6 +1,11 @@
 import type { Section } from '../registry/register-sections.ts';
+import type { KeptRule } from '../schemas/kept-rule.ts';
 /** The bytes of a rule file that reach the prompt. */
 export declare const ruleLimit: number;
-/** A section for each rule file the workspace folder has, in a fixed order, after every registered section. */
-export declare function projectRules(workspace: string): Promise<Section[]>;
+/** A rule file's text as it reaches the prompt, cut at 32 KB; `undefined` when it isn't a regular file inside the workspace folder. */
+export declare function ruleText(workspace: string, name: string): Promise<string | undefined>;
+/** The rule files the workspace has, the folder's own first, then each folder's by name, with their text. */
+export declare function readRules(workspace: string): Promise<KeptRule[]>;
+/** The rule files as prompt sections, after every registered section, in their order. */
+export declare function ruleSections(rules: readonly KeptRule[]): Section[];
 //# sourceMappingURL=project-rules.d.ts.map

package/dist/prompt/project-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-rules.d.ts","sourceRoot":"","sources":["../../src/prompt/project-rules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAQhE,sDAAsD;AACtD,eAAO,MAAM,SAAS,QAAY,CAAC;AAgBnC,+GAA+G;AAC/G,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CASxE"}
+{"version":3,"file":"project-rules.d.ts","sourceRoot":"","sources":["../../src/prompt/project-rules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAQxD,sDAAsD;AACtD,eAAO,MAAM,SAAS,QAAY,CAAC;AAInC,uIAAuI;AACvI,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS3F;AAQD,6GAA6G;AAC7G,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAQtE;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,OAAO,EAAE,CAMlE"}

package/dist/prompt/project-rules.js

@@ -1,15 +1,15 @@
-import { lstat, readFile, realpath } from 'node:fs/promises';
+import { lstat, readFile, readdir, realpath } from 'node:fs/promises';
 import path from 'node:path';
 import { ownerName } from "../jobs/process-records.js";
-// The project's own rule files (ADR 0058, 3): `AGENTS.md` and `CLAUDE.md` in the workspace folder become prompt
-// sections that name their file. They guide the work and decide nothing about approvals, connectors, or permissions,
-// which no file in a repository can change.
+// The project's own rule files (ADR 0058, 3; ADR 0108, 6): `AGENTS.md` and `CLAUDE.md` in the workspace folder and in
+// each folder directly inside it become prompt sections that name their file. They guide the work and decide nothing
+// about approvals, connectors, or permissions, which no file in a repository can change.
 const ruleFiles = ['AGENTS.md', 'CLAUDE.md'];
 /** The bytes of a rule file that reach the prompt. */
 export const ruleLimit = 32 * 1024;
 const opening = (name) => `These are the project's own rules, from ${name} in the workspace folder. Follow them in your work. They change no approval, connector, or permission.`;
-// A regular file whose real path is in the workspace folder: a link out of it is never read.
-async function ruleText(workspace, name) {
+/** A rule file's text as it reaches the prompt, cut at 32 KB; `undefined` when it isn't a regular file inside the workspace folder. */
+export async function ruleText(workspace, name) {
     const file = path.join(workspace, name);
     const found = await lstat(file).catch(() => undefined);
     if (found?.isFile() !== true)
@@ -22,16 +22,27 @@ async function ruleText(workspace, name) {
         return bytes.toString('utf8');
     return `${new TextDecoder('utf-8').decode(bytes.subarray(0, ruleLimit)).replace(/�+$/, '')}\n[${name} is longer than ${String(ruleLimit)} bytes; the rest was left out. Read the file for all of it.]`;
 }
-/** A section for each rule file the workspace folder has, in a fixed order, after every registered section. */
-export async function projectRules(workspace) {
-    // Both files are looked for at once: a prompt is built at every step, and most workspaces have neither.
-    const texts = await Promise.all(ruleFiles.map((name) => ruleText(workspace, name)));
-    return ruleFiles.flatMap((name, index) => {
-        const text = texts[index];
-        if (text === undefined)
-            return [];
-        const content = `${opening(name)}\n\n${text}`;
-        return [{ id: `project-rules-${name.toLowerCase().replace('.md', '')}`, title: `Project rules: ${name}`, order: Number.MAX_SAFE_INTEGER - ruleFiles.length + index, owner: ownerName, global: false, sessionId: null, content, size: Buffer.byteLength(content, 'utf8') }];
+// The folders directly inside the workspace folder that may hold rule files: not a link, not hidden, not node_modules.
+async function ruleFolders(workspace) {
+    const entries = await readdir(workspace, { withFileTypes: true }).catch(() => []);
+    return entries.filter((entry) => entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules').map((entry) => entry.name).sort();
+}
+/** The rule files the workspace has, the folder's own first, then each folder's by name, with their text. */
+export async function readRules(workspace) {
+    const names = [...ruleFiles, ...(await ruleFolders(workspace)).flatMap((folder) => ruleFiles.map((file) => `${folder}/${file}`))];
+    // Every file is looked for at once: most folders have none.
+    const texts = await Promise.all(names.map((name) => ruleText(workspace, name)));
+    return names.flatMap((name, index) => {
+        const content = texts[index];
+        return content === undefined ? [] : [{ path: name, content, told: null }];
+    });
+}
+/** The rule files as prompt sections, after every registered section, in their order. */
+export function ruleSections(rules) {
+    return rules.map((rule, index) => {
+        const content = `${opening(rule.path)}\n\n${rule.content}`;
+        const id = `project-rules-${rule.path.toLowerCase().replace(/\.md$/, '').replace(/[^a-z0-9]+/g, '-')}`;
+        return { id, title: `Project rules: ${rule.path}`, order: Number.MAX_SAFE_INTEGER - rules.length + index, owner: ownerName, global: false, sessionId: null, content, size: Buffer.byteLength(content, 'utf8') };
     });
 }
 //# sourceMappingURL=project-rules.js.map

package/dist/prompt/project-rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-rules.js","sourceRoot":"","sources":["../../src/prompt/project-rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAGvD,gHAAgH;AAChH,qHAAqH;AACrH,4CAA4C;AAE5C,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,WAAW,CAAU,CAAC;AAEtD,sDAAsD;AACtD,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,GAAG,IAAI,CAAC;AAEnC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,2CAA2C,IAAI,wGAAwG,CAAC;AAElM,6FAA6F;AAC7F,KAAK,UAAU,QAAQ,CAAC,SAAiB,EAAE,IAAY;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,IAAI,MAAM,KAAK,EAAE,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,KAAK,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7D,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,IAAI,mBAAmB,MAAM,CAAC,SAAS,CAAC,8DAA8D,CAAC;AACzM,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAiB;IAClD,wGAAwG;IACxG,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAC9C,OAAO,CAAC,EAAE,EAAE,EAAE,iBAAiB,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,kBAAkB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,gBAAgB,GAAG,SAAS,CAAC,MAAM,GAAG,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7Q,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"project-rules.js","sourceRoot":"","sources":["../../src/prompt/project-rules.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,5 @@
 import type { Ctx, Stored } from '@kvman/sdk';
+import { type ConnectorRow } from '../registry/register-connectors.ts';
 import type { SessionDoc } from '../schemas/records.ts';
 import { type TxRecords } from '../store/collections.ts';
 /** Await external data before the caller's final canonical store validation, not afterwards. */
@@ -10,6 +11,7 @@ export declare function prepareGrants(ctx: Ctx): Promise<{
         command: string;
         args: string[];
         env: string[];
+        port?: number;
     } | {
         name: string;
         description: string;
@@ -80,6 +82,7 @@ export declare function grantsInTx(store: TxRecords, session: Stored<SessionDoc>
         thinking: "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
         decides: boolean;
         clearedThroughSeq: number | null;
+        collapsedThroughSeq: number | null;
         webHosts: string[];
         usageBy: {
             summary: {
@@ -124,32 +127,21 @@ export declare function grantsInTx(store: TxRecords, session: Stored<SessionDoc>
         }[] | null;
         connectors: string[] | null;
         optedIn: string[];
+        run: {
+            kind: "check" | "find" | "change" | "review";
+            goal: string;
+            files: string[] | null;
+            budget: number;
+        } | null;
         createdAt: string;
         updatedAt: string;
-    }>;
-    connectors: {
-        name: string;
-        description: string;
-        owner: string;
-        kind: "commands" | "binary";
-        optIn: boolean;
-        commands?: {
-            name: string;
-            command: string;
-            examples: {
-                description: string;
-                input: import("zod").JSONType;
-            }[];
-            asks: boolean;
-            query: boolean;
-            card?: string;
+        rules?: {
+            path: string;
+            content: string;
+            told: string | null;
         }[];
-        binary?: {
-            check: string;
-            install?: string;
-            help?: string;
-        };
-    }[];
+    }>;
+    connectors: ConnectorRow[];
     disabled: Set<string>;
     names: string[];
     workers: ({
@@ -202,6 +194,7 @@ export declare function grantsInTx(store: TxRecords, session: Stored<SessionDoc>
         command: string;
         args: string[];
         env: string[];
+        port?: number;
     } | {
         name: string;
         description: string;

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

@@ -1 +1 @@
-{"version":3,"file":"session-grants.d.ts","sourceRoot":"","sources":["../../src/prompt/session-grants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAM9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAapE,gGAAgG;AAChG,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAM3C;AACD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC;AAEzE,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAenG;AACD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AAEvE,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAMnG"}
+{"version":3,"file":"session-grants.d.ts","sourceRoot":"","sources":["../../src/prompt/session-grants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAI9C,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAE1G,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAapE,gGAAgG;AAChG,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAM3C;AACD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC;AAEzE,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAenG;AACD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AAEvE,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAMnG"}

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

@@ -8,7 +8,7 @@ export type ListedConnector = {
     name: string;
     description: string;
     commands: string[];
-    signatures?: readonly string[];
+    signatures?: readonly (string | undefined)[];
 };
 export type SessionTools = {
     built: BuiltPrompt;

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

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

package/dist/prompt/session-prompt.js

@@ -5,8 +5,9 @@ import { builtinConnectors } from "../connector-call.js";
 import { delegateIndexDescription } from "../connectors/delegate.js";
 import { mcpIndexDescription } from "../connectors/mcp.js";
 import { preferencesSection } from "./person-preferences.js";
-import { projectRules } from "./project-rules.js";
+import { readRules, ruleSections } from "./project-rules.js";
 import { helperAllows } from "../turns/helper-calls.js";
+import { changesFiles } from "../turns/run-scope.js";
 import { readOnlyAllows } from "../turns/read-only.js";
 import { sectionsFor } from "../registry/register-sections.js";
 import { invalid } from "../problems.js";
@@ -18,7 +19,8 @@ export async function sessionTools(ctx, session) {
     // The settings and files the prompt needs are read together: each read waits on the kernel, so one after another
     // they add up (the person's preferences among them, ADR 0092, 3).
     const [rules, preferences, shell, profile, language, grants] = await Promise.all([
-        projectRules(ctx.job.workspace.path),
+        // A chat's kept rule files; before its first step keeps them, the files as they are (ADR 0108, 6).
+        session.rules ?? readRules(ctx.job.workspace.path),
         preferencesSection(ctx),
         shellFor(ctx),
         agentProfile(ctx),
@@ -33,16 +35,21 @@ export async function sessionTools(ctx, session) {
     // A helper is shown only what it may run (ADR 0063, 1), and a read-only worker's helper less (ADR 0056, 4).
     const readOnly = current.worker?.readOnly === true;
     const helper = current.parentId !== null;
+    // A check run runs lines but changes no file through fs, so it isn't shown fs's changes (ADR 0108, 2).
+    const checking = current.run?.kind === 'check';
     const builtins = builtinConnectors.filter(name => names.includes(name)).map(name => {
-        const shown = Object.entries(commandsOf(name)).map(([command, entry], index) => ({ command, signature: builtinSignatures[name][index] ?? '', allowed: (!helper || helperAllows(entry)) && (!readOnly || readOnlyAllows(command, entry)) })).filter(row => row.allowed);
+        const shown = Object.entries(commandsOf(name)).map(([command, entry], index) => ({ command, signature: builtinSignatures[name][index] ?? '', allowed: (!helper || helperAllows(entry)) && (!readOnly || readOnlyAllows(command, entry)) && !(checking && name === 'fs' && changesFiles(command)) })).filter(row => row.allowed);
         return { name, description: descriptions[name], commands: shown.map(row => row.command), signatures: shown.map(row => row.signature) };
     });
     // A read-only helper sees a registered connector only with its commands that run a query (ADR 0082, 3).
-    const registered = connectors.filter(connector => names.includes(connector.name)).map(connector => ({
-        name: connector.name,
-        description: connector.description,
-        commands: connector.commands?.filter(command => !readOnly || readOnlyAllows(command.name, undefined, command)).map(command => command.name) ?? (readOnly ? [] : ['exec']),
-    }));
+    // A registered command's payload signature, from its registration's input, so its payload needs no help call (ADR 0108, 14).
+    const shownRegistered = connectors.filter(connector => names.includes(connector.name));
+    const registered = shownRegistered.map(connector => {
+        if (connector.commands === null || connector.commands === undefined)
+            return { name: connector.name, description: connector.description, commands: readOnly ? [] : ['exec'] };
+        const shown = connector.commands.filter(command => !readOnly || readOnlyAllows(command.name, undefined, command));
+        return { name: connector.name, description: connector.description, commands: shown.map(command => command.name), signatures: shown.map(command => command.signature) };
+    });
     const listed = [...builtins.filter(connector => connector.commands.length > 0), ...registered.filter(connector => connector.commands.length > 0)];
     const built = buildPrompt({
         role: current.parentId === null ? 'lead' : 'worker',
@@ -51,7 +58,7 @@ export async function sessionTools(ctx, session) {
         platform: process.platform,
         shell: shell.kind,
         language: z.string().parse(language),
-        sections: [...preferences, ...(await sectionsFor(ctx, current.id)), ...rules],
+        sections: [...preferences, ...(await sectionsFor(ctx, current.id)), ...ruleSections(rules)],
         ...(current.worker === null ? {} : { worker: current.worker }),
         decides: current.decides,
         connectors: listed,

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

@@ -1 +1 @@
-{"version":3,"file":"session-prompt.js","sourceRoot":"","sources":["../../src/prompt/session-prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-prompt.js","sourceRoot":"","sources":["../../src/prompt/session-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAyB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAEzG,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgBpD,kHAAkH;AAClH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,OAA2B;IACtE,iHAAiH;IACjH,kEAAkE;IAClE,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/E,mGAAmG;QACnG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;QAClD,kBAAkB,CAAC,GAAG,CAAC;QACvB,QAAQ,CAAC,GAAG,CAAC;QACb,YAAY,CAAC,GAAG,CAAC;QACjB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC;QACnC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;KAC/B,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,8CAA8C,CAAC,CAAC;IACxF,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IACjE,MAAM,YAAY,GAAG,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,wBAAwB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;IAC5I,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAC/B,4GAA4G;IAC5G,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,CAAC;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC;IACzC,uGAAuG;IACvG,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,KAAK,OAAO,CAAC;IAC/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACjF,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChU,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;IACzI,CAAC,CAAC,CAAC;IACH,wGAAwG;IACxG,6HAA6H;IAC7H,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;QACjD,IAAI,SAAS,CAAC,QAAQ,KAAK,IAAI,IAAI,SAAS,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7K,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QAClH,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;IACzK,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAClJ,MAAM,KAAK,GAAG,WAAW,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QACnD,OAAO;QACP,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI;QACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,KAAK,CAAC,IAAI;QACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC;QACpC,QAAQ,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,CAAC,MAAM,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9D,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;IACH,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,IAAI;QAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,4DAA4D,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;IACvJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACxD,CAAC"}

package/dist/prompt/working-method.js

@@ -3,8 +3,8 @@
 // talking as it works (ADR 0097, 1); both end with keeping going to the end (ADR 0092, 1) and the call-or-final-answer rule. "Decide for me" asks nothing (ADR 0097, 7).
 const evidence = 'Decide from evidence: every decision and every claim rests on something you read, ran, or were told. When you report a result, say what you checked and what you didn\'t.';
 const simplest = "Use the simplest practical way that follows the project's conventions and sound engineering practice, and don't add what wasn't asked: no extra feature, file, option, or document.";
-const together = "Work in few steps. Each reply is a step, and every step sends the whole conversation again, so make in one reply every call you can make now: reads and searches run at the same time, and calls that change something (shell lines, writes, edits) run one after another in the order you give them. Read a few files with one `fs read-files`, put independent calls (searches, separate files, separate workers) in the same reply, and leave for a later reply only a call that needs another call's result. Several new files are several `fs write` calls in one reply, not one reply each.";
-const context = "Spend context with care: every result stays in the conversation and is read again at every step. Search before you read, read only the part of a long file you need, and don't read again a file you already hold: after `fs edit` the result shows the new lines. When you need a background run's result before you can go on, call `background wait` once; don't ask for its output again and again, and a run that ends tells you in a message.";
+const together = "Work in few steps. Each reply is a step, and every step sends the whole conversation again, so make in one reply every call you can make now: reads and searches run at the same time, and calls that change something (shell lines, writes, edits) run one after another in the order you give them. Read a few files with one `fs read-files`, put independent calls (searches, separate files, separate workers) in the same reply, as several run calls or one run with a calls list, and leave for a later reply only a call that needs another call's result. Several new files are several `fs write` calls in one reply, not one reply each.";
+const context = "Spend context with care: every result stays in the conversation and is read again at every step. Search before you read, read only the part of a long file you need, and don't read again a file you already hold: after `fs edit` the result shows the new lines. When you need a background process's result before you can go on, call `background wait` once; don't ask for its output again and again, and a run that ends tells you in a message. Never wait for a helper: its answer wakes you.";
 const artifacts = 'Show the person anything long to read or see (a report, a design, an HTML page) in an artifact, not in a reply.';
 const asking = 'To put a question to the person (a choice, a yes or no, a free answer), call `ask`.';
 const checked = "Before you say that something runs or works, check it the way the person would: run it, request its address, or run its test; if you couldn't, say what is unchecked. After you start a server, request its address once before you give it to the person.";
@@ -18,11 +18,11 @@ const testingAsking = "Tests the person chose. Before you write or change a test
 const testingDeciding = "Tests. When the project's AGENTS.md has a line starting `Testing:`, follow it. When it has none, don't ask and don't write new tests: run the existing tests that cover your change, leave the app running with its address, and record nothing.";
 const clarifyDeciding = "Clarify. Sort what looking left open. A fact that looking would answer: look, don't guess. Anything else, decide yourself, since the person asked you to decide: choose what you would recommend, and say in a line what you chose and why. When the means they asked for works against their goal, or a clearly better way exists, say so in a line and take the way you would recommend.";
 // Deliberating is chosen apart from the map, and names no worker, since the person may turn the council off (ADR 0103, 6).
-const deliberate = "Deliberate. Only for a complex request whose approach is open: there are several real ways to do it, the choice is costly or hard to take back, or its risks are not yet clear to you. Once you understood it and have the person's answers, and before any map or change, hand it in one `delegate run` to the worker of the `delegate` connector that debates approaches, when its entry lists one: brief it with the goal, what done looks like, the facts and paths you found, the constraints, and the person's answers. Check its final answer against what you read, then build on it: the map's steps and details when your path has a map, or the work itself when it doesn't. Deliberating and mapping are separate choices: a hard decision with a small change gets the debate and no map; a large change whose approach is clear gets a map and no debate; complex work whose approach is open gets both, the debate first; and most work gets neither. Never deliberate a question, a bug fix, or a clear or small change, and deliberate once per request, not per step.";
+const deliberate = "Deliberate. Only when the person asks for the approaches to be debated. Once you understood the request and have the person's answers, and before any map or change, hand it in one `delegate run` to the worker of the `delegate` connector that debates approaches, when its entry lists one: brief it with the goal, what done looks like, the facts and paths you found, the constraints, and the person's answers. Check its final answer against what you read, then build on it: the map's steps and details when your path has a map, or the work itself when it doesn't. Deliberating and mapping are separate choices, and deliberate once per request, not per step.";
 const plan = "Plan. Only when your path needs a map, and only after you understood the request, looked at what exists, and have your answers, and before you change anything: never in your first reply, because a map made before you looked is a guess. The map is the implementation plan the person reads and agrees to, so make it detailed, not an outline; the `execution-map` entry below says how to set it with its steps' details in one call, and keep it true. Choose for each step whoever does it best and fastest: yourself, with a connector, for an ordinary or small change, or a worker of the `delegate` connector whose description fits when the step needs that skill.";
 const confirmAsking = 'Confirm the plan. The person agrees to the map before you work on it. Once the first map of the request, or a map you set again with a change to what the person gets (the goal, what done looks like, what stays as it is, stored data, or what could go wrong), has details on every step (its undetailed list is empty), and before you start any step, call `ask choice` with other set to true. Its question first says in a few lines what you understood: the goal, what done looks like, what stays as it is, and the choices you made for the person; then it asks whether to start, with the option that starts first and an option that changes the plan, so the person can write what to change. When they ask for changes, set the map again with them, detail what changed, and ask again; start only after they chose to start. A change inside the plan, such as who does a step, the order, a step split or retried, or a worker reassigned, needs no confirmation: set the map and say what changed in one line. Never ask the person to confirm a choice they have just made. A change of status with `execution-map update` needs no confirmation.';
 const confirmDeciding = 'Confirm the plan. Once every step of the map has details, say in a few lines what you understood (the goal, what done looks like, what stays as it is, and the choices you made for the person) and start: the person asked you to decide, so don\'t wait for an answer.';
-const execute = "Execute. With a map, work through it as its entry says, so it always shows where you are: take the steps it returns as ready, mark each doing in the reply that makes its first call, hand a step whose uses names a worker to that worker with `delegate run` and check its answer, and mark the step done with your evidence as soon as its check passed. For each step, or with no map for all of what was asked, make the smallest change that does it, check it, and fix a failure at its cause. Check in proportion: after each change, run the tests that cover it; run the whole suite once, at the end; and run no stress, load, performance, or benchmark test unless the person asked for one. A step is not done because you wrote it.";
+const execute = "Execute. With a map, work through it as its entry says, so it always shows where you are: take the steps it returns as ready, mark each doing in the reply that makes its first call, never spend a reply only on `execution-map update` but send it in the reply that makes the next piece of work's calls, hand a step whose uses names a worker to that worker with `delegate run` and check its answer, and mark the step done with your evidence as soon as its check passed. For each step, or with no map for all of what was asked, make the smallest change that does it, check it, and fix a failure at its cause. Check in proportion: after each change, run the tests that cover it; run the whole suite once, at the end; and run no stress, load, performance, or benchmark test unless the person asked for one. A step is not done because you wrote it.";
 const leadMethodOf = (decides) => {
     const clarify = decides ? clarifyDeciding : clarifyAsking;
     const confirm = decides ? confirmDeciding : confirmAsking;
@@ -30,7 +30,7 @@ const leadMethodOf = (decides) => {
         'How you work. You are the one who decides: connectors and workers are how you act, and the result is yours. No path is fixed: you choose it for each task from what the task is, and you change it when what you find changes it.',
         together,
         narrate,
-        'Size up the task first. Read the request and look at what it touches, then judge four things: how clear it is (can you say what done looks like?), how much it changes (one place, or several parts that depend on each other), what could go wrong and how hard that is to take back, and whether the person will look at the result (a screen, a page, a report). From that, choose the lightest path that delivers the task well. A question needs an answer from what you read, and no change. A small, clear change needs doing and checking, and nothing more. An unclear request needs its questions answered before any work. Work that changes several parts that depend on each other, or that is hard to take back, needs an execution map the person agreed to; other work, even of a few steps, needs no map: do it, and say where you are as you go. A bug fix, or a change to one or two files, never gets a map. A complex request whose approach is open needs deliberating first, with a map or without one, as Deliberate says. Separate parts may need workers, and a result the person looks at needs showing. A task that turns out larger than it looked gets its map then, and one that turns out simple drops what it does not need.',
+        'Size up the task first. Read the request and look at what it touches, then judge four things: how clear it is (can you say what done looks like?), how much it changes (one place, or several parts that depend on each other), what could go wrong and how hard that is to take back, and whether the person will look at the result (a screen, a page, a report). From that, choose the lightest path that delivers the task well. A question needs an answer from what you read, and no change. A small, clear change needs doing and checking, and nothing more. An unclear request needs its questions answered before any work. Work that changes several parts that depend on each other, or that is hard to take back, needs an execution map the person agreed to; other work, even of a few steps, needs no map: do it, and say where you are as you go. A bug fix, a change to one or two files, or a fix the person described never gets a map. A request the person asks to have debated is deliberated first, with a map or without one, as Deliberate says. Separate parts may need workers, and a result the person looks at needs showing. A task that turns out larger than it looked gets its map then, and one that turns out simple drops what it does not need.',
         'These are the parts of a path. Use only the ones your path has.',
         "Understand. Before you decide anything, find out what the person is trying to achieve, as far as the task needs. Read everything they sent, attached images and files too, then look at what exists: the files, config, tests, and data the request touches, the project's rules, and what already does part of it, so you build on it and not beside it. Work out what the person needs, not only what they typed: answer for yourself what outcome they want and what they will do with it; what done looks like to them, as examples they would check (an exact name, a screen, an output); what the work changes or must keep working (other callers, stored data, settings, users); whether they asked for a goal or for a particular means (a format, a library, a design), and whether that means serves the goal; what they didn't say that changes the result (who uses it, how much data or load, which platforms and languages, privacy and security, and how good is good enough); and which of your connectors and workers help, and what is missing. Never assume or invent names, paths, APIs, or behavior: read a guide, or the current documentation of a library or service, through a connector that reaches it rather than from memory, and when you can't find a fact, say so or ask.",
         clarify,
@@ -40,8 +40,8 @@ const leadMethodOf = (decides) => {
         confirm,
         execute,
         'Stay on the task. Do what was asked and nothing else. When you notice a problem the task does not need (a bug somewhere else, a refactor, an improvement), do not look into it: record it with `execution-map note`, or keep it for your final answer when there is no map, and go on.',
-        "Delegate. A step goes to a worker of the `delegate` connector when the worker does it better or faster than you would: a specialist whose skill the step needs, separate work that runs beside yours, or a fresh review of a change you finished; its entry lists the workers and what each is for. Don't delegate what a few calls of your own would do, and ask for one review of a piece of work, not several. Several `delegate run` calls in one reply run in parallel. Brief the worker with the goal, the facts it needs, its limits, and what to return. A worker sees none of this conversation and reads again every file it needs, so put in the brief the paths, the exact lines it needs quoted when they are short, and what you already found, so it doesn't read again what you hold. Read what a worker returns and check it before you rely on it: its work is your responsibility. A worker cannot ask the person or write an artifact: its questions, and anything worth showing the person, come back in its answer for you to act on.",
-        'Show what the person will look at. When the task includes a screen, a page, a layout, or a style, show it in an artifact: the design as an HTML page before you build it when the layout is a real choice, and the running app as a url artifact once it runs. Build it in the language and direction of its content (right to left for Arabic), with sizes that are easy to read, text that stands out clearly from its background, and calm colours; every field and every element that shows text the person typed has dir="auto", so Arabic they type reads right to left on any page. Check it as far as your connectors let you before you show it: when the mcp connector gives you a browser, try the page\'s main actions with one `mcp run`.',
+        "Delegate. A run is one deliverable of one kind: find (locate or explain), change (one change in the files it names), check (run commands or tests and diagnose), or review (review a finished change). Delegate find, check, and review runs, and change runs only when two or more run at once on files that don't overlap; never a question, a small change, work you already hold the context for, or work the person asked you to do. Ask for one review of a piece of work, not several. A task with several parts is several runs, and several `delegate run` calls in one reply run in parallel. Write the brief in plain full sentences: goal is one sentence of what the run delivers, done one condition anyone can check, and context the line ranges the worker needs, whose text kvcoder attaches, so it reads nothing again that you hold. Every run goes on in the background: after starting workers, go on with what doesn't need them or end your turn; their answers come as messages that wake you, and you never wait for a helper with `background wait`. Read what a worker returns and check it before you rely on it: its work is your responsibility. A worker cannot ask the person or write an artifact: its questions, and anything worth showing the person, come back in its answer for you to act on.",
+        'Show what the person will look at. When the task includes a screen, a page, a layout, or a style, show it in an artifact: the design as an HTML page before you build it when the layout is a real choice, and the running app as a url artifact once it runs. Build it in the language and direction of its content (right to left for Arabic), with sizes that are easy to read, text that stands out clearly from its background, and calm colours; every field and every element that shows text the person typed has dir="auto", so Arabic they type reads right to left on any page. Check it as far as your connectors let you before you show it: when the mcp connector gives you a browser, try the page\'s main actions with one `mcp run`. When the person says they will test it themselves, start it, request its address once, give it to them, and stop, with no browser checks.',
         "Finish. The work is done when it is ready for production: it does what was asked, it handles the errors and edge cases that will happen, it follows the project's conventions, its checks and tests pass, and nothing unfinished or temporary is left behind. Stop what you started in the background and no longer need, and delete the temporary files you or your tools left in the workspace folder, such as logs, snapshots, and scratch files. Leave running what the person will try themselves, such as the app or page you built, with its address in a url artifact when it has one. When you found how this project is built, tested, or run and its AGENTS.md does not say it, add a short Commands section to AGENTS.md with risky set to true: that asks the person, so don't ask them a second time with `ask`. It holds only command lines, each with a few words of what it does, at most 15 lines: never notes, designs, or history. Your final answer, in plain words and as short as the facts allow, says what was done, what you checked and what it showed, what is unchecked, what still runs in the background, and what you noted for later.",
         evidence,
         simplest,

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

@@ -1 +1 @@
-{"version":3,"file":"working-method.js","sourceRoot":"","sources":["../../src/prompt/working-method.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"working-method.js","sourceRoot":"","sources":["../../src/prompt/working-method.ts"],"names":[],"mappings":"AAAA,4MAA4M;AAC5M,sJAAsJ;AACtJ,yKAAyK;AAQzK,MAAM,QAAQ,GAAG,2KAA2K,CAAC;AAC7L,MAAM,QAAQ,GAAG,qLAAqL,CAAC;AACvM,MAAM,QAAQ,GACZ,snBAAsnB,CAAC;AACznB,MAAM,OAAO,GAAG,weAAwe,CAAC;AACzf,MAAM,SAAS,GAAG,iHAAiH,CAAC;AACpI,MAAM,MAAM,GAAG,qFAAqF,CAAC;AACrG,MAAM,OAAO,GAAG,4PAA4P,CAAC;AAC7Q,MAAM,OAAO,GACX,y/BAAy/B,CAAC;AAC5/B,mGAAmG;AACnG,MAAM,SAAS,GACb,qSAAqS,CAAC;AACxS,MAAM,iBAAiB,GACrB,iUAAiU,CAAC;AAEpU,MAAM,aAAa,GACjB,kyBAAkyB,CAAC;AACryB,qGAAqG;AACrG,MAAM,aAAa,GACjB,wtBAAwtB,CAAC;AAC3tB,MAAM,eAAe,GACnB,kPAAkP,CAAC;AACrP,MAAM,eAAe,GACnB,4XAA4X,CAAC;AAC/X,2HAA2H;AAC3H,MAAM,UAAU,GACd,ipBAAipB,CAAC;AACppB,MAAM,IAAI,GACR,kpBAAkpB,CAAC;AACrpB,MAAM,aAAa,GACjB,wmCAAwmC,CAAC;AAC3mC,MAAM,eAAe,GACnB,0QAA0Q,CAAC;AAC7Q,MAAM,OAAO,GACX,20BAA20B,CAAC;AAE90B,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAU,EAAE;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAC;IAC1D,OAAO;QACP,mOAAmO;QACnO,QAAQ;QACR,OAAO;QACP,utCAAutC;QACvtC,iEAAiE;QACjE,4uCAA4uC;QAC5uC,OAAO;QACP,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa;QACzC,UAAU;QACV,IAAI;QACJ,OAAO;QACP,OAAO;QACP,wRAAwR;QACxR,uwCAAuwC;QACvwC,k2BAAk2B;QACl2B,wmCAAwmC;QACxmC,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,SAAS;QACT,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO;QACP,SAAS;QACT,iBAAiB;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AAEF,MAAM,eAAe,GAAG,iFAAiF,CAAC;AAE1G,MAAM,iBAAiB,GAAG,8IAA8I,CAAC;AACzK,MAAM,aAAa,GAAG,4UAA4U,CAAC;AACnW,MAAM,eAAe,GAAG,kOAAkO,CAAC;AAE3P,MAAM,mBAAmB,GAAG,CAAC,OAAgB,EAAU,EAAE,CACvD,CAAC,GAAG,iBAAiB,IAAI,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE1N,MAAM,WAAW,GAA8B;IAC7C,gPAAgP;IAChP,wLAAwL;CACzL,CAAC;AACF,MAAM,eAAe,GAAG,4aAA4a,CAAC;AACrc,MAAM,WAAW,GAAG,kGAAkG,CAAC;AACvH,MAAM,YAAY,GAChB,8aAA8a,CAAC;AAEjb,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,YAAoB,EAAU,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzN,MAAM,YAAY,GAAG,cAAc,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;AAC/D,MAAM,mBAAmB,GAAG,cAAc,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;AAEzE,6IAA6I;AAC7I,MAAM,UAAU,YAAY,CAAC,IAAU,EAAE,KAAa,EAAE,QAAiB;IACvE,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,aAAa,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,yDAAyD,KAAK,GAAG,CAAC;IACrK,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,uLAAuL,KAAK,GAAG,CAAC;IAC5N,OAAO,0EAA0E,KAAK,mDAAmD,CAAC;AAC5I,CAAC;AAED,8HAA8H;AAC9H,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,SAAiB,aAAa,EAAE,OAAO,GAAG,KAAK;IACvF,IAAI,MAAM,KAAK,aAAa;QAAE,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAC5F,OAAO,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAC9E,CAAC"}

package/dist/register-settings.d.ts

@@ -47,6 +47,7 @@ export declare const settingSchemas: {
         command: z.ZodString;
         args: z.ZodArray<z.ZodString>;
         env: z.ZodArray<z.ZodString>;
+        port: z.ZodExactOptional<z.ZodNumber>;
     }, z.core.$strict>, z.ZodObject<{
         name: z.ZodString;
         description: z.ZodString;

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

@@ -1 +1 @@
-{"version":3,"file":"register-settings.d.ts","sourceRoot":"","sources":["../src/register-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAiBzC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB1B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAqB/C;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CAG9G;AAED,oJAAoJ;AACpJ,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAIvE;AAED,yCAAyC;AACzC,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;GAa1C;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC"}
+{"version":3,"file":"register-settings.d.ts","sourceRoot":"","sources":["../src/register-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAiBzC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB1B,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAsB/C;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAA;CAAE,CAAC,CAG9G;AAED,oJAAoJ;AACpJ,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAIvE;AAED,yCAAyC;AACzC,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;GAa1C;AAED,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC"}

package/dist/register-settings.js

@@ -37,6 +37,7 @@ export function registerSettings(ctx) {
     ctx.registerSetting('kvcoder.delegate.model', { description: "The model a helper uses when its worker names none; null uses the chat's own.", schema: settingSchemas.model, default: null });
     ctx.registerSetting('kvcoder.thinking', { description: 'How hard the model thinks in a new session.', schema: settingSchemas.thinking, default: 'medium' });
     ctx.registerSetting('kvcoder.delegate.thinking', { description: "How hard a helper thinks when its worker names no level (ADR 0102, 3).", schema: settingSchemas.thinking, default: 'medium' });
+    ctx.registerSetting('kvcoder.delegate.thinkingLimit', { description: 'The highest level any helper thinks at, whatever its worker or the chat names (ADR 0108, 3).', schema: settingSchemas.thinking, default: 'high' });
     ctx.registerSetting('kvcoder.maxSteps', { description: 'The most steps a turn takes before it stops; null sets no limit.', schema: settingSchemas.maxSteps, default: null });
     ctx.registerSetting('kvcoder.approval', { description: 'When a call asks the person first: only the ones the model marks risky (auto), every one that can ask (ask), or none at all (never).', schema: settingSchemas.approval, default: 'auto' });
     ctx.registerSetting('kvcoder.approval.allowed', { description: 'The approval rules: a line whose every command starts with one of these prefixes, or a file change, runs without asking.', schema: settingSchemas.allowed, default: [] });

package/dist/register-settings.js.map

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

package/dist/registry/register-connectors.d.ts

@@ -1,5 +1,16 @@
 import { z, type Ctx } from '@kvman/sdk';
 import { type TxRecords } from '../store/collections.ts';
+declare const commandRowSchema: z.ZodObject<{
+    name: z.ZodString;
+    command: z.ZodString;
+    examples: z.ZodArray<z.ZodObject<{
+        description: z.ZodString;
+        input: z.ZodJSONSchema;
+    }, z.core.$strip>>;
+    asks: z.ZodBoolean;
+    query: z.ZodBoolean;
+    card: z.ZodExactOptional<z.ZodString>;
+}, z.core.$strip>;
 declare const connectorRowSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodString;
@@ -26,7 +37,12 @@ declare const connectorRowSchema: z.ZodObject<{
     }, z.core.$strip>>;
     optIn: z.ZodBoolean;
 }, z.core.$strip>;
-export type ConnectorRow = z.output<typeof connectorRowSchema>;
+/** A connector as kvcoder uses it; a command also carries its payload's signature for the prompt (ADR 0108, 14), which `kvcoder.connector.list` doesn't answer. */
+export type ConnectorRow = Omit<z.output<typeof connectorRowSchema>, 'commands'> & {
+    commands?: (z.output<typeof commandRowSchema> & {
+        signature?: string;
+    })[];
+};
 export type ConnectorPreparation = {
     loaded: ReadonlySet<string>;
     binaries: ConnectorRow[];

package/dist/registry/register-connectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register-connectors.d.ts","sourceRoot":"","sources":["../../src/registry/register-connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAKzC,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAQ7E,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;iBAQtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAc/D,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAE7F,mGAAmG;AACnG,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAM/E;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,GAAG,YAAY,EAAE,CAI/F;AAED,sHAAsH;AACtH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAOxE;AAuCD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAyDjD;AAED,wGAAwG;AACxG,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7D"}
+{"version":3,"file":"register-connectors.d.ts","sourceRoot":"","sources":["../../src/registry/register-connectors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAKzC,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAQ7E,QAAA,MAAM,gBAAgB;;;;;;;;;;iBAAiK,CAAC;AAExL,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;iBAQtB,CAAC;AAEH,mKAAmK;AACnK,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,EAAE,UAAU,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;CAAE,CAAC;AAcjK,MAAM,MAAM,oBAAoB,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAE7F,mGAAmG;AACnG,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAM/E;AAED,8FAA8F;AAC9F,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,oBAAoB,GAAG,YAAY,EAAE,CAI/F;AAED,sHAAsH;AACtH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAOxE;AA2CD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAyDjD;AAED,wGAAwG;AACxG,wBAAsB,eAAe,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7D"}