@falkenslab/agent-kit 0.25.0 → 0.27.0

package/dist/tui/extensionCommand.js

@@ -3,7 +3,7 @@ import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { addMarketplace, findPlugin, inspectMarketplace, installFromMarketplace, removeMarketplace, updateMarketplace, } from "../core/marketplaces.js";
 import { addExtension, extensionOptionStates, installTarget, folderSize, isGitSource, isRemoteServer, remoteHosts, listInstalled, removeExtension, setExtensionEnabled, setExtensionOptions, } from "../core/externalExtensions.js";
-import { describe, describeOptions } from "../chat/extensions.js";
+import { applyConfirm, describe, describeConfirm, describeOptions } from "../chat/extensions.js";
 import { extensionCatalog, knownMarketplaces as catalogMarketplaces, restoreExtensions, updateExtension } from "../core/extensionCatalog.js";
 import { trustWorkspace } from "../core/workspaceTrust.js";
 import { describeCapability, describeInLanguage } from "../core/extensions.js";
@@ -21,7 +21,7 @@ export { chatExtensionsCommand, describe } from "../chat/extensions.js";
  * - `extension add <folder> --link [--project]`: registered where it is, to develop it (not copied, its files not checked)
  * - `extension remove <name> [--project | --agent] [--yes | --keep-data]`: asks before deleting its data folder
  * - `extension enable|disable <name> [--project | --agent]`
- * - `extension config <name> [key=value… | key… | --unset key…] [--project | --agent]`: its options; `key` alone asks for it (without echo when it's a secret)
+ * - `extension config <name> [key=value… | key… | --unset key… | confirm=on|off|reset] [--project | --agent]`: its options; `key` alone asks for it (without echo when it's a secret); `confirm=` what guided mode asks about its tools (#74, #76)
  * - `extension update [name] [--yes]`: one installed from a marketplace (or all that have a newer version there) to the version it offers now, its data and options kept
  * - `extension restore [--trust]`: gets the code a workspace's lock lists and this computer lacks (#57); `--trust` trusts it too
  * - `extension trust [name…]`: lets a workspace's extensions run, as their code is now
@@ -200,16 +200,22 @@ export async function runExtensionCommand(argv, options) {
             case "config": {
                 const name = positional[0];
                 if (!name)
-                    return fail(`Usage: ${command} extension config <name> [key=value… | key… | --unset key…] [--project | --agent]`);
+                    return fail(`Usage: ${command} extension config <name> [key=value… | key… | --unset key… | confirm=on|off|reset] [--project | --agent]`);
                 const found = (await listInstalled(options.dirs)).filter((extension) => extension.name === name && !extension.shadowed && (!askedScope || extension.scope === askedScope));
                 if (!found.length)
                     return fail(`${name} isn't installed${askedScope ? ` in the ${askedScope} scope` : ""}. \`${command} extension list\` lists them.`);
                 const installed = found[0];
                 const declared = installed.manifest?.userConfig ?? {};
+                // Guided mode's answers about its tools (#74, #76): confirm=on|off|reset.
+                const confirm = await applyConfirm(installed, positional.slice(1));
+                if ("error" in confirm)
+                    return fail(`${confirm.error}.`);
+                if (confirm.changed)
+                    write(`${name}'s guided-mode answers saved in the ${installed.scope} scope.`);
                 const typed = {};
                 for (const key of values("unset"))
                     typed[key] = undefined;
-                for (const pair of positional.slice(1)) {
+                for (const pair of confirm.rest) {
                     const at = pair.indexOf("=");
                     if (at > 0)
                         typed[pair.slice(0, at)] = pair.slice(at + 1);
@@ -224,10 +230,11 @@ export async function runExtensionCommand(argv, options) {
                     await setExtensionOptions(installed, name, typed);
                     write(`${name}'s options saved in the ${installed.scope} scope. They apply when its server starts again: the next session, or in a chat \`/extensions disable ${name}\` and \`enable\`.`);
                 }
-                const lines = await describeOptions((await listInstalled(options.dirs)).find((extension) => extension.name === name && extension.scopeDir === installed.scopeDir));
+                const now = (await listInstalled(options.dirs)).find((extension) => extension.name === name && extension.scopeDir === installed.scopeDir);
+                const lines = await describeOptions(now);
                 if (!lines.length)
                     write(`${name} has no options.`);
-                for (const line of lines)
+                for (const line of [...lines, ...describeConfirm(now)])
                     write(line);
                 return true;
             }
@@ -297,6 +304,7 @@ export async function runExtensionCommand(argv, options) {
                     "  remove <name> [--project | --agent] [--yes | --keep-data]",
                     "  enable|disable <name> [--project | --agent]",
                     "  config <name> [key=value… | key… | --unset key…]   its options (key alone asks for it)",
+                    "  config <name> confirm=on|off|reset    whether guided mode asks before its tools, or forget the answers kept",
                     "  update [name]                          to the version its marketplace offers now (all that have one, without a name)",
                     "  restore [--trust]                      gets what this workspace's lock lists and this computer lacks",
                     "  trust [name…]                          lets this workspace's extensions run, as they are now",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@falkenslab/agent-kit",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "Library for building an agent on top of the Claude Agent SDK",
   "author": "Francisco Vargas Ruiz",
   "license": "MIT",

package/schemas/agent-kit-metadata.schema.json

@@ -34,6 +34,11 @@
       "type": "array",
       "items": { "type": "string", "minLength": 1 }
     },
+    "confirmTools": {
+      "description": "Its tools that always ask the person in guided mode (short names), even inside a batch they approved, and are never offered \"always\": what creates, edits or publishes in their account. Without it, its servers' destructiveHint says which.",
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
     "labels": {
       "description": "How the chat shows each tool (short name), per language (en, es, fr, de): {field} takes the call's input.",
       "type": "object",