allaboard 0.4.0 → 0.6.0

package/dist/host/program.js

@@ -4,11 +4,14 @@
  * names the copy it was started from.
  */
 import { accessSync, constants, realpathSync, statSync } from "node:fs";
-import { delimiter, dirname, join } from "node:path";
-/** The first executable file called `name` in the folders of `pathVariable`, or null. */
+import { delimiter, dirname, isAbsolute, join } from "node:path";
+/**
+ * The first executable file called `name` in the absolute folders of `pathVariable`, or null. A
+ * relative folder (`.`) names the caller's working folder, which a service does not share.
+ */
 export function findOnPath(name, pathVariable) {
     for (const folder of pathVariable.split(delimiter)) {
-        if (folder === "")
+        if (!isAbsolute(folder))
             continue;
         const candidate = join(folder, name);
         try {
@@ -27,20 +30,32 @@ export function findOnPath(name, pathVariable) {
 const GLOBAL_ENTRY = /^(.*)\/lib\/node_modules\/allaboard\/dist\/main\.js$/;
 /**
  * The program of the running command: `entry` is `process.argv[1]` (npm's link in its `bin`
- * folder, resolved here), `pathVariable` the caller's `PATH`, `execPath` the fallback Node.
+ * folder, resolved here), `pathVariable` the caller's `PATH`, `execPath` the fallback Node,
+ * `executables` the agents' own, each kept only when the caller's `PATH` finds it.
  */
-export function programOf(entry, pathVariable, execPath) {
+export function programOf(entry, pathVariable, execPath, executables = []) {
     const main = realpathSync(entry);
     const prefix = GLOBAL_ENTRY.exec(main)?.[1];
     return {
         node: findOnPath("node", pathVariable) ?? execPath,
         main,
         npmBin: prefix === undefined ? null : join(prefix, "bin"),
+        agentExecutables: executables.flatMap((name) => findOnPath(name, pathVariable) ?? []),
     };
 }
-/** The folders of the service's `PATH`: Node's own first, then npm's, then the system's. */
+/**
+ * The folders of the service's `PATH`: Node's own first, then npm's, then the agents' executables'
+ * not among the system's, then the system's in their order.
+ */
 export function servicePath(program, system) {
-    const folders = [dirname(program.node), program.npmBin, ...system];
+    const folders = [
+        dirname(program.node),
+        program.npmBin,
+        ...program.agentExecutables
+            .map((path) => dirname(path))
+            .filter((path) => !system.includes(path)),
+        ...system,
+    ];
     return [...new Set(folders.filter((folder) => folder !== null))].join(":");
 }
 /** The package folder of the copy whose entry file is `main`: the folder above `dist/`. */

package/dist/host/prompter.js

@@ -0,0 +1,61 @@
+/**
+ * Reads one answer from the terminal for `allaboard setup`, with `@inquirer/password` for a secret
+ * (it shows an asterisk for each character), `@inquirer/input` for any other answer and
+ * `@inquirer/select` for every pick from a list (the chat, the agent, the yes or no). Each prompt clears itself once answered: the wizard
+ * prints the answer line, so the terminal holds one line per answer whatever the length of the
+ * token. All of them end without an answer when the owner presses Ctrl-C or Ctrl-D, and so does
+ * the end of the input.
+ */
+/** The prefix of a question waiting for its answer; the answered question is cleared, not drawn. */
+const THEME = { prefix: { idle: "?", done: "" } };
+/**
+ * Runs `prompt` with a signal that aborts on Ctrl-D and on the end of the input, and returns null
+ * when it ends that way or by Ctrl-C. The library settles only on Ctrl-C or process exit, which is
+ * why the other two are listened for here.
+ */
+async function until(prompt) {
+    const ended = new AbortController();
+    const onEnd = () => ended.abort();
+    const onKey = (_text, key) => {
+        if (key?.ctrl === true && key.name === "d")
+            ended.abort();
+    };
+    process.stdin.once("end", onEnd);
+    process.stdin.on("keypress", onKey);
+    try {
+        return await prompt({ signal: ended.signal, clearPromptOnDone: true });
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            (error.name === "ExitPromptError" || error.name === "AbortPromptError")) {
+            return null;
+        }
+        throw error;
+    }
+    finally {
+        process.stdin.off("end", onEnd);
+        process.stdin.off("keypress", onKey);
+    }
+}
+/** The line typed after `message`, or null when the owner ended the wizard. */
+export async function askTerminal(message, secret) {
+    // Loaded here: the daemon starts through this graph and never needs the prompt library.
+    if (secret) {
+        const { default: password } = await import("@inquirer/password");
+        // A token stays hidden, so the show-it key and its tip go. The mask is a single character
+        // per keystroke; the answer line the wizard prints shows a fixed one.
+        return until((context) => password({ message, mask: "*", toggleMask: false, theme: THEME }, context));
+    }
+    const { default: input } = await import("@inquirer/input");
+    return until((context) => input({ message, theme: THEME }, context));
+}
+/** The name the owner picks from `names` (arrow keys, Enter), `preselected` first; null when they ended the wizard. */
+export async function chooseTerminal(message, names, preselected) {
+    const { default: select } = await import("@inquirer/select");
+    return until((context) => select({
+        message,
+        choices: [preselected, ...names.filter((name) => name !== preselected)],
+        default: preselected,
+        theme: THEME,
+    }, context));
+}

package/dist/module-setup.js

@@ -0,0 +1,6 @@
+/**
+ * What a module (an agent back end or a chat provider) tells `allaboard setup` to ask of the owner
+ * to write its variables into `.env`. The types live here, outside both seams, because both seams
+ * use them and a seam imports nothing of the core.
+ */
+export {};

package/dist/version.js

@@ -48,6 +48,10 @@ export function installedVersion() {
 export function changelogOf(version) {
     return `${REPOSITORY}/blob/v${version}/docs/CHANGELOG.md`;
 }
+/** The address of the page of what differs from the terminal, as published with the version that runs. */
+export function limitsPage() {
+    return `${REPOSITORY}/blob/v${installedVersion()}/docs/limits.md`;
+}
 /** The address of `section` of the setup guide, as published with the version that runs. */
 export function setupGuide(section) {
     return `${REPOSITORY}/blob/v${installedVersion()}/docs/setup.md#${section}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "allaboard",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Your Claude Code workspace in Slack: one channel per project, one thread per session, running on your own Mac.",
   "keywords": [
     "slack",
@@ -23,7 +23,10 @@
     "node": ">=22.19.0"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "0.3.301",
+    "@anthropic-ai/claude-agent-sdk": "0.3.304",
+    "@inquirer/input": "5.1.7",
+    "@inquirer/password": "5.2.3",
+    "@inquirer/select": "5.2.6",
     "@slack/bolt": "5.1.0",
     "@slack/web-api": "8.2.0"
   },

package/slack-app-manifest.json

@@ -26,7 +26,8 @@
         "reactions:write"
       ],
       "user": [
-        "chat:write"
+        "chat:write",
+        "pins:write"
       ]
     },
     "pkce_enabled": false