@kvman/kvcoder 0.1.15 → 0.1.16

package/docs/connectors.md

@@ -32,11 +32,11 @@ ctx.registerHandler('kernel.started', {
 - `kvcoder.connector.register` takes exactly one of `commands` or `binary`, plus `name` and `description`.
 - To register several connectors in one call, pass `{ connectors: [ … ] }`, each entry shaped as one connector. All are checked first and stored together: the call registers all of them or none, and a name given twice fails `VALIDATION_FAILED`.
 - `name`: the `connector` the agent names. Names, and each command's `name`, are lowercase kebab-case single words: `model-list`, not `model list`. A command can't be named `help`.
-- `description`: what the agent sees in the prompt's connector index. Say what the connector is for and when to use it. kvcoder adds the command names after it (`Commands: add, list, help.`), so the index is never out of date. The prompt lists the payloads of kvcoder's own connectors (`shell`, `fs`, `artifact`, `background`, `ask`, `delegate`); the agent learns a registered connector's payloads from `help`, so clear field names and descriptions matter.
+- `description`: what the agent sees in the prompt's connector index. Say what the connector is for and when to use it. kvcoder adds each command after it, one line each with its payload's signature, such as `add { text (≤200), done? }`, then `help`, so the index is never out of date and the agent needs no `help` call to use a command; `help` still gives each field's description, so clear field names and descriptions matter.
 - `commands`: each command's `name`, the public `command` it runs, and optional `examples` (`{ description, input }`). `help` shows the registered descriptions, JSON Schemas, and examples, so give every input field a `.describe()`.
 - `asks: true` on a command makes the person approve every call of it first (see **A command that asks** below). The field takes only `true`; leave it out for a command that runs at once.
 - Each `command` must be a public command or query of the registering extension, or registration fails `VALIDATION_FAILED`. The command runs through `ctx.exec` with the payload as its input, so validation, cancel, and timeouts are the kernel's, and it runs to its end inside the agent's step.
-- The result the agent reads is the output as JSON on one line, or `error <code>: <message>`. A payload that doesn't fit returns each problem and then the payload's signature, such as `{ text (≤200), done? }`, where `(≤N)` is a string's `max` length from your zod schema, so the agent can correct it in one try; a payload that isn't a plain object returns its JSON Schema on one line instead.
+- The result the agent reads is the output as JSON on one line, or `error <code>: <message>`. A payload that doesn't fit returns each problem and then the payload's signature, such as `{ text (≤200), done? }`, where `(≤N)` is a string's `max` length from your zod schema, so the agent can correct it in one try; a payload that isn't a plain object returns its JSON Schema on one line instead. The command's `help` text follows, after a blank line.
 - `binary`: a program on the system, with `{ check, install?, help? }`. `check` is a line whose exit code 0 means the program is usable; the connector is listed, and can be called, only while its check passes.
 
 ## A command that asks
@@ -63,7 +63,7 @@ await ctx.exec('kvcoder.connector.register', {
 });
 ```
 
-The agent calls a binary connector with two commands. `exec { args?, background?, timeoutMs?, risky }` runs the program with those arguments in the real shell, in the workspace folder. `help {}` describes `exec` and prints the program's own help (`gh --help`), and `help { "command": "pr" }` prints `gh pr --help`. For a program whose help is asked another way, register the line with `{command}` standing for the command: `help: 'go help {command}'`.
+The agent calls a binary connector with two commands. `exec { args?, background?, notify?, timeoutMs?, risky }` runs the program with those arguments in the real shell, in the workspace folder. `help {}` describes `exec` and prints the program's own help (`gh --help`), and `help { "command": "pr" }` prints `gh pr --help`. For a program whose help is asked another way, register the line with `{command}` standing for the command: `help: 'go help {command}'`.
 
 `kvcoder.connector.unregister { name }` removes one of the caller's own connectors; a missing name does nothing. `kvcoder.connector.list` answers every registered connector and program, each with `enabled`. The setting `kvcoder.connectors.disabled` lists the names that are turned off, kvcoder's own seven included: such a connector is left out of the prompt and can't be called, from the next step.
 

package/locales/ar.json

@@ -656,5 +656,21 @@
   "kvcoder.artifacts.keepDays.title": "أيام الاحتفاظ بالمخرجات",
   "kvcoder.artifacts.keepDays.description": "عدد الأيام التي يُحتفظ فيها بمُخرَج محادثة خاملة بعد آخر تغيير له. 0 يحتفظ بها كلها.",
   "kvcoder.ui.artifacts.delete": "حذف",
-  "kvcoder.ui.artifacts.deleteConfirm": "هل تريد حذف هذا المُخرَج؟"
+  "kvcoder.ui.artifacts.deleteConfirm": "هل تريد حذف هذا المُخرَج؟",
+  "kvcoder.delegate.thinkingLimit.title": "أعلى تفكير للمساعدين",
+  "kvcoder.delegate.thinkingLimit.description": "أقصى مقدار يفكّر به أي مساعد، مهما حدّد عامله أو المحادثة. المرتفع يُبعد المساعدين عن أبطأ المستويات.",
+  "kvcoder.delegate.thinkingLimit.options.off": "بدون",
+  "kvcoder.delegate.thinkingLimit.options.minimal": "أدنى",
+  "kvcoder.delegate.thinkingLimit.options.low": "منخفض",
+  "kvcoder.delegate.thinkingLimit.options.medium": "متوسط",
+  "kvcoder.delegate.thinkingLimit.options.high": "مرتفع",
+  "kvcoder.delegate.thinkingLimit.options.xhigh": "مرتفع جدًا",
+  "kvcoder.delegate.thinkingLimit.options.max": "أقصى",
+  "kvcoder.background.notify.watch.description": "ينتظر انتهاء أمر في الخلفية بُدئ مع notify، ثم يُعلم محادثته، ويبدأ دورًا إن كانت المحادثة خاملة.",
+  "kvcoder.notices.CONNECTION_WAITING": "فشل الاتصال بـ{model}؛ يعيد kvman المحاولة كل دقيقتين. أرسل رسالة لتحاول الآن.",
+  "kvcoder.turn.resume.description": "يعيد تشغيل خطوة دور ينتظر عودة الاتصال.",
+  "kvcoder.config.mcp.form.port": "المنفذ (اختياري)",
+  "kvcoder.config.mcp.form.portHint": "إن كان الأمر يقدّم MCP عبر HTTP على هذا المنفذ، يبقيه kvman عاملًا طوال الدور، فيحتفظ المتصفح بصفحته بين الاستدعاءات.",
+  "kvcoder.config.mcp.invalid.port": "اكتب عددًا صحيحًا من 1024 إلى 65535، أو اتركه فارغًا.",
+  "kvcoder.ui.helper.step": "الخطوة {step} من {budget}"
 }

package/locales/en.json

@@ -656,5 +656,21 @@
   "kvcoder.artifacts.keepDays.title": "Days to keep artifacts",
   "kvcoder.artifacts.keepDays.description": "How many days an idle chat's artifact is kept after its last change. 0 keeps them all.",
   "kvcoder.ui.artifacts.delete": "Delete",
-  "kvcoder.ui.artifacts.deleteConfirm": "Delete this artifact?"
+  "kvcoder.ui.artifacts.deleteConfirm": "Delete this artifact?",
+  "kvcoder.delegate.thinkingLimit.title": "Helpers' highest thinking",
+  "kvcoder.delegate.thinkingLimit.description": "The most any helper thinks, whatever its worker or the chat sets. High keeps helpers from the slowest levels.",
+  "kvcoder.delegate.thinkingLimit.options.off": "Off",
+  "kvcoder.delegate.thinkingLimit.options.minimal": "Minimal",
+  "kvcoder.delegate.thinkingLimit.options.low": "Low",
+  "kvcoder.delegate.thinkingLimit.options.medium": "Medium",
+  "kvcoder.delegate.thinkingLimit.options.high": "High",
+  "kvcoder.delegate.thinkingLimit.options.xhigh": "Extra high",
+  "kvcoder.delegate.thinkingLimit.options.max": "Max",
+  "kvcoder.background.notify.watch.description": "Waits for a background line started with notify to end, then tells its chat, starting a turn when the chat is idle.",
+  "kvcoder.notices.CONNECTION_WAITING": "The connection to {model} failed; kvman tries again every 2 minutes. Send a message to try now.",
+  "kvcoder.turn.resume.description": "Runs again the step of a turn that waits for the connection.",
+  "kvcoder.config.mcp.form.port": "Port (optional)",
+  "kvcoder.config.mcp.form.portHint": "When the command serves MCP over HTTP on this port, kvman keeps it running for a whole turn, so a browser keeps its page between calls.",
+  "kvcoder.config.mcp.invalid.port": "Give a whole number from 1024 to 65535, or leave it empty.",
+  "kvcoder.ui.helper.step": "step {step} of {budget}"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvman/kvcoder",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "kvcoder: the app-building harness, with one run tool over connectors, sections, and its conversation UI.",
   "license": "MIT",
   "repository": {
@@ -36,7 +36,7 @@
     "@kvman/sdk": "^0.1.5"
   },
   "dependencies": {
-    "@kvman/kvai": "0.1.7",
+    "@kvman/kvai": "0.1.8",
     "@lucide/vue": "1.49.0",
     "@modelcontextprotocol/sdk": "1.32.1",
     "cross-spawn": "7.0.6",
@@ -46,7 +46,7 @@
   "devDependencies": {
     "@kvman/kvwebui": "0.1.8",
     "@kvman/sdk": "0.1.5",
-    "@kvman/testkit": "0.1.9",
+    "@kvman/testkit": "0.1.10",
     "@types/cross-spawn": "6.0.6",
     "@types/turndown": "5.0.6",
     "@vitejs/plugin-vue": "6.0.9",
@@ -187,6 +187,21 @@
           "ref"
         ]
       ],
+      "read-endings": [
+        [
+          "sessionId",
+          "ref"
+        ]
+      ],
+      "mcp-sessions": [
+        [
+          "turnId"
+        ],
+        [
+          "turnId",
+          "server"
+        ]
+      ],
       "runs": [
         [
           "sessionId"

package/dist/delegate/start-pending.d.ts

@@ -1,5 +0,0 @@
-import { type Ctx } from '@kvman/sdk';
-import { type PendingAuthority } from './permission.ts';
-/** Parent grants, not child tool scope, authorize a newly published foreground resource. */
-export declare function startPending(ctx: Ctx, authority: PendingAuthority): Promise<void>;
-//# sourceMappingURL=start-pending.d.ts.map

package/dist/delegate/start-pending.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"start-pending.d.ts","sourceRoot":"","sources":["../../src/delegate/start-pending.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,MAAM,YAAY,CAAC;AAIpD,OAAO,EAAkE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxH,4FAA4F;AAC5F,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BvF"}

package/dist/delegate/start-pending.js

@@ -1,42 +0,0 @@
-import { ProblemError } from '@kvman/sdk';
-import { startChild } from "../connectors/delegate.js";
-import { invalid } from "../problems.js";
-import { prepareGrants } from "../prompt/session-grants.js";
-import { delegationInTx, refusePending, waitingInTx } from "./permission.js";
-import { launchRun } from "./runs.js";
-/** Parent grants, not child tool scope, authorize a newly published foreground resource. */
-export async function startPending(ctx, authority) {
-    const { sessionId, pending } = authority;
-    try {
-        const prepared = await prepareGrants(ctx);
-        const guard = store => {
-            ctx.job.signal.throwIfAborted();
-            if (waitingInTx(store, authority) === undefined)
-                throw invalid('The originating delegation is no longer current.');
-            if (pending.kind === 'worker' && pending.runId !== null && pending.childSessionId === null && pending.questionId === null && pending.question === null) {
-                const run = store.runs.get(pending.runId);
-                if (run?.status !== 'running' || run.sessionId !== sessionId || run.toolCallId !== pending.toolCallId)
-                    throw invalid('The worker run is no longer current.');
-                return delegationInTx(store, sessionId, prepared, run.worker, run.kind).session;
-            }
-            if (pending.kind === 'subagent' && pending.childSessionId !== null && pending.runId === null && pending.questionId === null && pending.question === null) {
-                const child = store.sessions.get(pending.childSessionId);
-                if (child?.parentId !== sessionId || child.worker === null || child === undefined)
-                    throw invalid('The child no longer belongs to its originating session.');
-                return delegationInTx(store, sessionId, prepared, child.worker.name, 'subagent').session;
-            }
-            throw invalid('The delegation binding is invalid.');
-        };
-        if (pending.childSessionId !== null)
-            await startChild(ctx, pending.childSessionId, guard);
-        else if (pending.runId !== null)
-            await launchRun(ctx, pending.runId, guard);
-    }
-    catch (error) {
-        if (!(error instanceof ProblemError) || ctx.job.signal.aborted)
-            throw error;
-        await refusePending(ctx, authority, error);
-        // Stale resources are retained for separately approved owned cleanup, not used to mutate a newer turn.
-    }
-}
-//# sourceMappingURL=start-pending.js.map

package/dist/delegate/start-pending.js.map

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