@joe-broadhead/opencode-slack 0.0.3 → 0.0.4

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.4] - 2026-11-04
+
+### Added
+
+- Jelly shows the plugin's one-line summary and icon: `jelly.summary`, and `jelly.icon`, a speech bubble on a muted slate tile, shipped as `assets/icon.svg`.
+- In Jelly, a web tab can sign in to Slack through Jelly's sign-in relay: the `slack` sign-in declares `relay`, and `docs/jelly.md` gives the relay address to add to your Slack app. The app manifest still lists only the loopback address.
+
+### Changed
+
+- The tools RPC, without a Slack app client ID, refuses with `CLIENT_ID_MISSING` (or `CLIENT_ID_INVALID` for a client ID saved in `/connect` that is empty or has spaces) instead of `NOT_REGISTERED`, with `/slack-status`'s next step: run `/connect`, choose Slack app and paste the client ID. `describe` gives the same code as each method's `reason`. `NOT_REGISTERED` now means a client ID is set but OpenCode has not registered the server, and its next step is to run `/slack-status`.
+- The README's sign-out step says what to do when `opencode mcp logout slack` answers "MCP server not found" right after OpenCode starts: wait a few seconds and run it again.
+
 ## [0.0.3] - 2026-11-04
 
 ### Added

package/README.md

@@ -207,7 +207,7 @@ A script's errors from the tools RPC have their own codes, listed in [Scripting]
 
 Sign out while the plugin is still installed: once it is removed, OpenCode no longer knows the `slack` server or the **Slack app** entry, so it cannot remove their credentials, and `opencode auth list` stops showing them.
 
-1. Sign out of Slack: `opencode mcp logout slack`.
+1. Sign out of Slack: `opencode mcp logout slack`. If it answers "MCP server not found" right after OpenCode starts, wait a few seconds and run it again.
 2. If you saved a client ID in `/connect`, remove it: `opencode auth logout slack-app`, and choose the **Slack app** account. Without a terminal, name it: `opencode auth logout slack-app "Slack app"`.
 3. Check: `opencode auth list` lists neither **Slack** nor **Slack app**.
 4. Remove the plugin: `opencode plugin remove @joe-broadhead/opencode-slack`, then `opencode reload`. `opencode mcp list` no longer lists `slack`.

package/assets/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" width="48" height="48"><rect width="48" height="48" rx="12" fill="#475569"/><g fill="none" stroke="#FFFFFF" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"><path d="M15 12h18a5 5 0 0 1 5 5v10a5 5 0 0 1-5 5H23l-7 6v-6h-1a5 5 0 0 1-5-5V17a5 5 0 0 1 5-5z"/><path d="M17 20h14"/><path d="M17 25.5h9"/></g></svg>

package/dist/index.js

@@ -155,8 +155,8 @@ var NEXT_STEPS = {
   CONNECTING: "Wait a few seconds, then call the method again.",
   CONNECTION_FAILED: "Run /slack-status and follow its next step.",
   DISABLED: "Enable the Slack server in /mcps, then call the method again.",
-  // The usual cause: no Slack app client ID, so the plugin registered no server (CLIENT_ID_MISSING in /slack-status).
-  NOT_REGISTERED: "Run /connect and choose Slack app, then paste your Slack app's client ID; if one is set, run /slack-status and follow its next step.",
+  // Without a client ID, setup's notRegistered hook gives CLIENT_ID_MISSING or CLIENT_ID_INVALID and /connect instead.
+  NOT_REGISTERED: "Run /slack-status and follow its next step.",
   TOOL_UNAVAILABLE: "Call describe to see which methods OpenCode lists now, and run /slack-status.",
   UPSTREAM_ERROR: "Check the input against the method's schema from describe, and run /slack-status if it keeps failing.",
   CANCELLED: "Call the method again if you still need the result."
@@ -188,6 +188,7 @@ var DESCRIBED = object(
     description: STRING,
     available: { type: "boolean" },
     reason: STRING,
+    detail: STRING,
     input: ANY_OBJECT,
     output: ANY_OBJECT
   },
@@ -321,12 +322,15 @@ async function registerToolsRpc(ctx, options) {
     const rules = [...agent.data.permissions, ...info.permissions ?? []];
     return { agent: info.agent, rules };
   };
+  const notRegistered = (server) => mcp?.notRegistered?.(server);
   const unavailable = async (server, tool, connected) => {
     const status2 = (await ctx.mcp.list()).data.find((entry) => entry.name === server)?.status.status;
     const code = connection(status2) ?? connected;
     if (code === "TOOL_UNAVAILABLE") return fail(code, `OpenCode does not list ${tool} on the connected "${server}" server`);
     if (status2 === "connected") return fail(code, `the "${server}" server was reconnecting when ${tool} ran`);
-    return fail(code, `the "${server}" server ${STATUS_TEXT[code] ?? "is unavailable"}`);
+    const what = `the "${server}" server ${STATUS_TEXT[code] ?? "is unavailable"}`;
+    const own = code === "NOT_REGISTERED" ? notRegistered(server) : void 0;
+    return own ? new ScriptError({ code: own.code, what, next: own.next }) : fail(code, what);
   };
   const denied = (action, error, asked = action) => {
     const reason = upstreamText(record(error) && typeof error["message"] === "string" ? error["message"] : String(error));
@@ -358,11 +362,15 @@ async function registerToolsRpc(ctx, options) {
       }
     };
   };
-  const ownedTarget = (spec, envelope2) => ({
-    action: spec.action,
-    mcp: false,
-    run: async (call) => await spec.run(envelope2.input, call) ?? null
-  });
+  const ownedTarget = (spec, envelope2) => {
+    if (accounts) serverOf(envelope2.account);
+    const account = accounts && envelope2.account !== void 0 ? { account: envelope2.account } : {};
+    return {
+      action: spec.action,
+      mcp: false,
+      run: async (call) => await spec.run(envelope2.input, { ...call, ...account }) ?? null
+    };
+  };
   const invoke = async (target, raw, context) => {
     const envelope2 = raw;
     let method;
@@ -415,7 +423,9 @@ async function registerToolsRpc(ctx, options) {
       for (const name of KNOWN_READS) {
         const id = `${server}_${name}`;
         const tool = managed ? tools.find((entry) => entry.id === id) : void 0;
-        const reason = !managed ? "SERVER_CONFLICT" : tool ? void 0 : connection(status2) ?? "TOOL_UNAVAILABLE";
+        const code = !managed ? "SERVER_CONFLICT" : tool ? void 0 : connection(status2) ?? "TOOL_UNAVAILABLE";
+        const reason = code === "NOT_REGISTERED" ? notRegistered(server)?.code ?? code : code;
+        const detail = code === void 0 ? void 0 : mcp.unavailableDetail?.(name, code);
         const input = jsonSchema(tool?.input) ?? ANY_OBJECT;
         const output = jsonSchema(tool?.output);
         methods.push({
@@ -426,6 +436,7 @@ async function registerToolsRpc(ctx, options) {
           description: tool?.description ?? "",
           available: reason === void 0,
           ...reason ? { reason } : {},
+          ...detail === void 0 ? {} : { detail },
           input,
           output: mcpOutput(output)
         });
@@ -830,12 +841,15 @@ function buildStatus(input) {
       ...base,
       state: "not_configured",
       ...input.client.invalid ? { code: "CLIENT_ID_INVALID", message: `The client ID saved in the /connect ${app} entry is empty or has spaces, so Slack is not added.` } : { code: "CLIENT_ID_MISSING", message: `No Slack app client ID is set, so Slack is not added. To create the app, use the manifest at ${APP_MANIFEST_URL}.` },
-      nextStep: `Run /connect and choose ${app}, then paste your Slack app's client ID.`
+      nextStep: clientNextStep(server)
     };
   }
   const status2 = input.servers.find((item) => item.name === server)?.status;
   return { ...base, ...connection2(server, status2, unguardedAgents, names.length) };
 }
+function clientNextStep(server) {
+  return `Run /connect and choose ${appDisplayName(server)}, then paste your Slack app's client ID.`;
+}
 function callbackRow(callback, port) {
   const register = "register exactly this URL in the app's Redirect URLs";
   if (port === void 0) return `${callback} (${register})`;
@@ -899,7 +913,7 @@ function formatStatus(status2) {
 }
 
 // src/version.ts
-var VERSION = "0.0.3";
+var VERSION = "0.0.4";
 
 // src/index.ts
 var STARTUP_POLL_MS = 250;
@@ -1007,7 +1021,13 @@ var src_default = Plugin.define({
       }
     });
     const stopTools = options === void 0 ? async () => {
-    } : await registerToolsRpc(ctx, { mcp: { server: options.server, managed: () => !nameInUse } });
+    } : await registerToolsRpc(ctx, {
+      mcp: {
+        server: options.server,
+        managed: () => !nameInUse,
+        notRegistered: () => client.client !== void 0 ? void 0 : { code: client.invalid ? "CLIENT_ID_INVALID" : "CLIENT_ID_MISSING", next: clientNextStep(options.server) }
+      }
+    });
     await ctx.command.transform((editor) => {
       editor.add({
         name: "slack-status",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joe-broadhead/opencode-slack",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Unofficial OpenCode plugin for Slack",
   "keywords": [
     "opencode",
@@ -23,6 +23,7 @@
   },
   "files": [
     "dist",
+    "assets/icon.svg",
     "skills",
     "README.md",
     "LICENSE",
@@ -58,6 +59,8 @@
   },
   "jelly": {
     "title": "Slack",
+    "summary": "Search and read Slack; anything that sends asks first.",
+    "icon": "assets/icon.svg",
     "tools": [
       {
         "name": "slack.slack_search_public",
@@ -242,7 +245,8 @@
         "id": "slack",
         "label": "Slack",
         "server": "slack",
-        "after": "app"
+        "after": "app",
+        "relay": {}
       }
     ],
     "contributes": {