@kvman/kvcoder 0.1.1 → 0.1.3

package/docs/connectors.md

@@ -68,6 +68,26 @@ The agent calls a binary connector with two commands. `exec { args?, background?
 
 `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.
 
+## A connector that is off until enabled
+
+Register a connector with `optIn: true`, the only value the field takes, when it belongs only in chats that asked for it.
+
+- It is in no chat's connector index and no `run` enum, and a call to it gets the answer for a connector that doesn't exist.
+- Its owner switches it on for one chat: `kvcoder.connector.enable { sessionId, names }`. Each name must be an `optIn` connector of the caller (`VALIDATION_FAILED`); an unknown session fails `kvcoder/SESSION_NOT_FOUND`, and a subagent's `VALIDATION_FAILED`.
+- The chat keeps it across restarts. A subagent has it only when its chat enabled it and its worker lists it. A fork starts with none. Nothing switches one off again, and `kvcoder.connectors.disabled` still turns it off.
+- `kvcoder.connector.list` rows have `optIn`.
+
+## Slash commands
+
+`kvcoder.slash.register { commands: [{ name, description, command, message? }] }` adds commands to the send box, after kvcoder's own six.
+
+- `name`: lowercase kebab case; kvcoder's own names and another extension's fail `kvcoder/NAME_TAKEN`, and a name given twice `VALIDATION_FAILED`. All of a call's commands are stored, or none.
+- `description` and `message`: translation keys of the caller's catalog.
+- `command`: a public command of the caller (`VALIDATION_FAILED` otherwise). The send box calls it with `{ sessionId, argument }`, where `argument` is the text after the name, `''` when there is none.
+- With `message`, a command that succeeded is followed by the person's message: the argument, or with none the text of `message`. A command that failed shows its Problem and sends nothing.
+- `kvcoder.slash.unregister { name }` removes the caller's own; `kvcoder.slash.list` answers `[{ name, description, command, message?, owner }]`, by name.
+- On the Chat page, with no chat yet, a registered command runs in a new chat that the send box creates and opens; kvcoder's own six are greyed there.
+
 ## Built-in connectors
 
 kvcoder's own connectors are `shell` (one line in the real shell), `fs` (read, list, search, write, and edit files in the workspace folder), `artifact` (a document shown beside the chat), `background` (follow up on what was started with `background: true`), `ask` (a question that suspends the turn), `delegate` (`delegate run { worker, task, background? }` hands a task to a worker, which runs it in a helper session; the workers are the setting `kvcoder.delegate.workers`, and it is a connector of a session only while a worker is turned on), and `mcp` (the tools of the MCP servers the person added; it is a connector of a session only while the workspace has a server). Their names are taken: registering one fails `kvcoder/NAME_TAKEN`.
@@ -81,6 +101,6 @@ kvcoder's own connectors are `shell` (one line in the real shell), `fs` (read, l
 
 ## Lifetime
 
-- Connectors last one run. kvcoder clears them in its own `kernel.started` handler, which runs first because registering extensions declare kvcoder as a dependency. Each extension registers its connectors again from its own `kernel.started` handler. A hot reload of kvcoder reruns its dependents' handlers too.
+- Connectors and slash commands last one run. kvcoder clears them in its own `kernel.started` handler, which runs first because registering extensions declare kvcoder as a dependency. Each extension registers its connectors and slash commands again from its own `kernel.started` handler. A hot reload of kvcoder reruns its dependents' handlers too.
 - Sections are stored until removed; see [Sections](sections.md).
 - When kvcoder reads, it ignores any connector whose owner isn't loaded.

package/locales/ar.json

@@ -164,6 +164,10 @@
   "kvcoder.connector.register.description": "يسجّل موصّلًا يستدعيه الوكيل بأداته run: أوامر المستدعي العامة، أو برنامجًا يعمل في الطرفية.",
   "kvcoder.connector.unregister.description": "يزيل أحد موصّلات المستدعي.",
   "kvcoder.connector.list.description": "يسرد الموصّلات التي يمكن للوكيل استخدامها.",
+  "kvcoder.connector.enable.description": "يشغّل موصّلات المستدعي الاختيارية (optIn) في محادثة واحدة.",
+  "kvcoder.slash.register.description": "يسجّل أوامر الشرطة المائلة في مربع الإرسال، وكلٌّ منها يشغّل أحد أوامر المستدعي العامة.",
+  "kvcoder.slash.unregister.description": "يزيل أحد أوامر الشرطة المائلة للمستدعي.",
+  "kvcoder.slash.list.description": "يسرد أوامر الشرطة المائلة التي أضافتها الإضافات إلى مربع الإرسال.",
   "kvcoder.section.set.description": "يضبط أحد أقسام المستدعي في تعليمات النظام.",
   "kvcoder.section.remove.description": "يزيل أحد أقسام المستدعي؛ ولا يفعل شيئًا إن لم يكن القسم موجودًا.",
   "kvcoder.section.list.description": "يسرد الأقسام التي تدخل في تعليمات محادثة، أو أقسام مساحة العمل عند عدم تحديد محادثة.",
@@ -180,7 +184,7 @@
   "kvcoder.thinking.title": "التفكير",
   "kvcoder.thinking.description": "مقدار تفكير النموذج في المحادثة الجديدة.",
   "kvcoder.maxSteps.title": "الخطوات في كل جولة",
-  "kvcoder.maxSteps.description": "أقصى عدد من الخطوات تنفّذه الجولة قبل أن تتوقف.",
+  "kvcoder.maxSteps.description": "أقصى عدد من الخطوات تنفّذه الجولة قبل أن تتوقف. اتركه فارغًا لتبقى الجولة بلا حدّ.",
   "kvcoder.shell.approval.title": "الموافقة على الأوامر",
   "kvcoder.shell.approval.description": "متى يطلب الوكيل موافقتك قبل تنفيذ أمر أو تعديل ملف.",
   "kvcoder.shell.path.title": "برنامج الطرفية",

package/locales/en.json

@@ -164,6 +164,10 @@
   "kvcoder.connector.register.description": "Registers a connector the agent calls with its run tool: the caller's public commands, or a program run in the shell.",
   "kvcoder.connector.unregister.description": "Removes one of the caller's connectors.",
   "kvcoder.connector.list.description": "Lists the connectors the agent may use.",
+  "kvcoder.connector.enable.description": "Switches the caller's own optIn connectors on for one chat.",
+  "kvcoder.slash.register.description": "Registers slash commands of the send box, each running one of the caller's public commands.",
+  "kvcoder.slash.unregister.description": "Removes one of the caller's slash commands.",
+  "kvcoder.slash.list.description": "Lists the slash commands that extensions added to the send box.",
   "kvcoder.section.set.description": "Sets one of the caller's sections of the system prompt.",
   "kvcoder.section.remove.description": "Removes one of the caller's sections; a missing one does nothing.",
   "kvcoder.section.list.description": "Lists the sections a session's prompt reaches, or the workspace's without a session.",
@@ -180,7 +184,7 @@
   "kvcoder.thinking.title": "Thinking",
   "kvcoder.thinking.description": "How hard the model thinks in a new chat.",
   "kvcoder.maxSteps.title": "Steps per turn",
-  "kvcoder.maxSteps.description": "The most steps a turn takes before it stops.",
+  "kvcoder.maxSteps.description": "The most steps a turn takes before it stops. Leave it empty for no limit.",
   "kvcoder.shell.approval.title": "Shell approval",
   "kvcoder.shell.approval.description": "When the agent asks you before it runs a command or changes a file.",
   "kvcoder.shell.path.title": "Shell program",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kvman/kvcoder",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "kvcoder: the app-building harness, with one run tool over connectors, sections, and its conversation UI.",
   "license": "MIT",
   "repository": {
@@ -43,9 +43,9 @@
     "vue": "3.5.43"
   },
   "devDependencies": {
-    "@kvman/kvwebui": "0.1.0",
-    "@kvman/sdk": "0.1.0",
-    "@kvman/testkit": "0.1.1",
+    "@kvman/kvwebui": "0.1.1",
+    "@kvman/sdk": "0.1.1",
+    "@kvman/testkit": "0.1.3",
     "@types/cross-spawn": "6.0.6",
     "@vitejs/plugin-vue": "6.0.9",
     "@vue/test-utils": "2.5.1",