@falkenslab/agent-kit 0.27.0 → 0.27.1

package/dist/core/npxPackages.js

@@ -47,8 +47,12 @@ async function packageBin(dir, name) {
     const bundled = json.bundleDependencies ?? json.bundledDependencies;
     const declared = Object.keys({ ...json.dependencies, ...json.optionalDependencies });
     const missing = bundled === true ? [] : declared.filter((dependency) => !(Array.isArray(bundled) && bundled.includes(dependency)));
+    // Only package.json is read (#71): one bundled into the program but still in `dependencies`
+    // looks missing too, so the message says both ways out.
     if (missing.length)
-        return { problem: `has dependencies it doesn't bring (${missing.join(", ")}): the kit installs none, so a package must bundle them, or list them in bundleDependencies` };
+        return {
+            problem: `declares dependencies it doesn't bring (${missing.join(", ")}): the kit installs none. If they're bundled into its program, move them to devDependencies; otherwise list them in bundleDependencies`,
+        };
     const scripts = ["preinstall", "install", "postinstall"].filter((script) => json.scripts?.[script]);
     if (scripts.length)
         return { problem: `has install scripts (${scripts.join(", ")}), which the kit never runs` };

package/dist/core/openBrowser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Whether a browser can be opened on this computer (#72): not over SSH, nor on Linux without a
+ * display (a server, a container). Elsewhere the desktop is there.
+ */
+export declare function canOpenBrowser(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
+/**
+ * Opens an `http(s)` address in this computer's browser, with the system's own opener and no
+ * shell (an OAuth link is full of `&`, which `cmd /c start` would cut): `rundll32` on Windows,
+ * `open` on macOS, `xdg-open` elsewhere. False when it can't (`canOpenBrowser()`, another kind
+ * of address, no opener): then the person is given the link only.
+ */
+export declare function openBrowser(url: string): Promise<boolean>;

package/dist/core/openBrowser.js

@@ -0,0 +1,36 @@
+import { spawn } from "node:child_process";
+/**
+ * Whether a browser can be opened on this computer (#72): not over SSH, nor on Linux without a
+ * display (a server, a container). Elsewhere the desktop is there.
+ */
+export function canOpenBrowser(env = process.env, platform = process.platform) {
+    if (env.SSH_CONNECTION || env.SSH_TTY || env.SSH_CLIENT)
+        return false;
+    if (platform === "win32" || platform === "darwin")
+        return true;
+    return Boolean(env.DISPLAY || env.WAYLAND_DISPLAY);
+}
+/**
+ * Opens an `http(s)` address in this computer's browser, with the system's own opener and no
+ * shell (an OAuth link is full of `&`, which `cmd /c start` would cut): `rundll32` on Windows,
+ * `open` on macOS, `xdg-open` elsewhere. False when it can't (`canOpenBrowser()`, another kind
+ * of address, no opener): then the person is given the link only.
+ */
+export async function openBrowser(url) {
+    if (!/^https?:\/\//i.test(url) || !canOpenBrowser())
+        return false;
+    const [command, args] = process.platform === "win32" ? ["rundll32", ["url.dll,FileProtocolHandler", url]] : process.platform === "darwin" ? ["open", [url]] : ["xdg-open", [url]];
+    return await new Promise((resolve) => {
+        try {
+            const child = spawn(command, args, { detached: true, stdio: "ignore", windowsHide: true });
+            child.once("error", () => resolve(false));
+            child.once("spawn", () => {
+                child.unref();
+                resolve(true);
+            });
+        }
+        catch {
+            resolve(false);
+        }
+    });
+}

package/dist/tui/extensionCommand.js

@@ -59,8 +59,10 @@ export async function runExtensionCommand(argv, options) {
     const ask = options.ask ?? askOnTerminal;
     const askSecret = options.askSecret ?? (options.ask ? options.ask : askSecretOnTerminal);
     /**
-     * After installing `name` into `dir`: its options from `--set`, then asked for each still
-     * without a value (on a terminal; none without one), saying which required ones are left.
+     * After installing `name` into `dir`: its options from `--set`, saved first so a prompt cut
+     * short loses none (#73), then asked for each still without a value, saying which required ones
+     * are left. Never asked with `--yes`, nor without a terminal unless the host asks itself (`ask`):
+     * a default stays, an optional one stays unset.
      */
     const configure = async (name, dir) => {
         const installed = (await listInstalled(options.dirs)).find((extension) => extension.name === name && extension.scopeDir === dir);
@@ -74,17 +76,24 @@ export async function runExtensionCommand(argv, options) {
                 throw new Error(`--set takes key=value: "${pair}"`);
             typed[pair.slice(0, at)] = pair.slice(at + 1);
         }
+        if (Object.keys(typed).length)
+            await setExtensionOptions(installed, name, typed);
         const states = await describeOptionStates(installed);
+        const canAsk = !flag("yes") && (options.ask !== undefined || process.stdin.isTTY === true);
+        const asked = {};
         for (const [key, option] of Object.entries(declared)) {
+            if (!canAsk)
+                break;
             if (key in typed || states.get(key))
                 continue;
             const question = `${option.title}${option.required ? "" : " (optional)"}${option.default !== undefined ? ` [${String(option.default)}]` : ""}: ${option.description}\n  ${key} = `;
             const answer = (await (option.sensitive ? askSecret : ask)(question)).trim();
             if (answer)
-                typed[key] = answer;
+                asked[key] = answer;
         }
-        if (Object.keys(typed).length)
-            await setExtensionOptions(installed, name, typed);
+        if (Object.keys(asked).length)
+            await setExtensionOptions(installed, name, asked);
+        Object.assign(typed, asked);
         const missing = Object.entries(declared).filter(([key, option]) => option.required && !(key in typed) && !states.get(key) && option.default === undefined).map(([key]) => key);
         if (missing.length)
             write(`It stays off until ${missing.join(", ")} ${missing.length === 1 ? "is" : "are"} set: \`${command} extension config ${name} ${missing[0]}\`.`);

package/package.json

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