@craftsamo/signal-tools 0.1.1 → 0.2.0

package/.antigravity-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "signal-tools",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Signal tools for coding agents: chats, messages, contacts, received files and sends.",
   "author": {
     "name": "craftsamo",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "signal-tools",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Signal tools for coding agents: chats, messages, contacts, received files and sends.",
   "author": {
     "name": "craftsamo",

package/.codex-plugin/plugin.json

@@ -0,0 +1,31 @@
+{
+  "name": "signal-tools",
+  "version": "0.2.0",
+  "description": "Signal tools for coding agents: chats, messages, contacts, received files and sends.",
+  "author": {
+    "name": "craftsamo",
+    "url": "https://github.com/craft-agent"
+  },
+  "homepage": "https://github.com/craft-agent/signal-tools#readme",
+  "repository": "https://github.com/craft-agent/signal-tools",
+  "license": "MIT",
+  "skills": "./skills",
+  "mcpServers": {
+    "signal-tools": {
+      "command": "node",
+      "args": ["dist/mcp.js"],
+      "cwd": ".",
+      "env_vars": [
+        "SIGNAL_TOOLS_TOOLSETS",
+        "SIGNAL_TOOLS_READ_ONLY",
+        "SIGNAL_TOOLS_TOOLS",
+        "SIGNAL_TOOLS_EXCLUDE_TOOLS",
+        "SIGNAL_TOOLS_CONFIRM",
+        "SIGNAL_TOOLS_STATE_DIR",
+        "SIGNAL_TOOLS_DOWNLOAD_DIR",
+        "SIGNAL_TOOLS_SEND_DIRS",
+        "XDG_STATE_HOME"
+      ]
+    }
+  }
+}

package/README.md

@@ -240,10 +240,12 @@ Hermes.
    the entry points do. A tool that runs a program is tested against a fake of
    that program on `PATH`; no test reaches a real service.
 3. List it in `src/tools.ts`. A new toolset goes into `toolsets` in
-   `src/project.ts` (and `defaultToolsets` when it is on by default).
+   `src/project.ts` (and `defaultToolsets` when it is on by default), and a
+   variable the tool reads besides the settings into `toolVariables`.
 4. Add or update the toolset's skill, `skills/<prefix>-<toolset>/SKILL.md`.
 5. Run `pnpm run build && pnpm run manifests` to list the tool in
-   `plugin.yaml`, then describe it under "Tools and skills".
+   `plugin.yaml` and its variables in Codex's manifest, then describe it under
+   "Tools and skills".
 
 [`docs/conventions.md`](docs/conventions.md) has the rules each step follows.
 
@@ -323,17 +325,22 @@ Lists are comma-separated in a flag or a variable. Where each harness reads them
   flags and pass it the client's environment, so set the variables in the
   environment the harness runs in.
 - **Codex** passes a plugin's MCP server only a few basic variables (such as
-  `PATH` and `HOME`), so the variables have no effect there. To change
-  settings, or to give the server a variable it needs, add the server under
-  `[mcp_servers]` in Codex's `config.toml` instead of using the plugin: flags
-  go in `args`, `env_vars` names the variables to forward from Codex's
-  environment, and `env` sets fixed values.
+  `PATH` and `HOME`) and those the plugin's manifest names, which are the
+  variables above and `XDG_STATE_HOME`, from which the state directory's
+  default comes: set them in the environment Codex runs in. A variable the
+  tools read besides the settings belongs in `toolVariables` in
+  `src/project.ts`; `pnpm run manifests` adds it to the manifest after the
+  settings' variables. To pass flags, or to give the server a variable the
+  package does not name, add the server under `[mcp_servers]` in Codex's
+  `config.toml` instead of using the plugin: flags go in `args`, `env_vars`
+  names the variables to forward from Codex's environment, and `env` sets
+  fixed values.
 
   ```toml
   [mcp_servers.signal-tools]
   command = "npx"
   args = ["-y", "@craftsamo/signal-tools@<version>", "--read-only"]
-  env_vars = ["SIGNAL_TOOLS_STATE_DIR"]
+  env_vars = ["SIGNAL_TOOLS_STATE_DIR", "XDG_STATE_HOME"]
   ```
 
 ### Accounts and the sync service
@@ -404,8 +411,8 @@ one `default`), and every command takes `--state-dir` like the tools.
 
 ## Layout
 
-- `src/project.ts` — the package's name, tool ID prefix, setting prefix and
-  toolsets.
+- `src/project.ts` — the package's name, tool ID prefix, setting prefix,
+  toolsets and the other variables its tools read.
 - `src/core/` — the tool contract and the tools, free of any harness and of
   the project's names.
 - `src/tools.ts` — the list of every tool, which each entry point registers.
@@ -417,12 +424,14 @@ one `default`), and every command takes `--state-dir` like the tools.
 - `src/hermes/`, `plugin.yaml` and `__init__.py` — the Hermes plugin.
 - `skills/` — one skill per toolset, `skills/<name>/SKILL.md`, which every
   harness that takes skills loads from the package or plugin root.
-- `plugin.json`, `mcp.json`, `.mcp.json`, `.claude-plugin/`, `.agents/plugins/`,
+- `.claude-plugin/`, `.codex-plugin/`, `.agents/plugins/`, `.mcp.json`,
   `.antigravity-plugin/` and `mcp_config.json` — the plugin manifests of the
-  other harnesses. The root `.mcp.json` is the configuration Grok Build reads
-  (with `${CLAUDE_PLUGIN_ROOT}`, the variable both Grok Build and Claude Code
-  expand); when working on this repository in Claude Code, decline the project
-  MCP server it offers from that file.
+  other harnesses. Codex reads `.codex-plugin/plugin.json`; a root
+  `plugin.json` would make it load the plugin as an Agent Plugin, whose tool
+  budget hides tools past a fixed size. The root `.mcp.json` is the
+  configuration Grok Build reads (with `${CLAUDE_PLUGIN_ROOT}`, the variable
+  both Grok Build and Claude Code expand); when working on this repository in
+  Claude Code, decline the project MCP server it offers from that file.
 
 How a release is made is in [`RELEASING.md`](RELEASING.md).
 

package/dist/cli.js

@@ -25,7 +25,9 @@ var PROJECT = {
   /** The toolsets, in the order `all` lists them. */
   toolsets: ["account", "chats", "contacts", "files", "sends", "actions"],
   /** The toolsets on when a setting names none. */
-  defaultToolsets: ["account", "chats", "contacts", "sends"]
+  defaultToolsets: ["account", "chats", "contacts", "sends"],
+  /** The environment variables the tools read besides the settings, which Codex forwards to the server after them. */
+  toolVariables: ["XDG_STATE_HOME"]
 };
 
 // src/core/account/read.ts
@@ -19750,12 +19752,24 @@ function date4(params) {
 }
 
 // src/core/errors.ts
+function deepFreeze(value) {
+  if (value !== null && typeof value === "object") {
+    Object.freeze(value);
+    for (const child of Object.values(value)) {
+      deepFreeze(child);
+    }
+  }
+  return value;
+}
 var ToolError = class extends Error {
   code;
   constructor(code, message, options) {
-    super(message, options);
+    super(message, options && "cause" in options ? { cause: options.cause } : void 0);
     this.name = "ToolError";
     this.code = code;
+    if (options?.details !== void 0) {
+      this.details = deepFreeze(JSON.parse(JSON.stringify(options.details)));
+    }
   }
 };
 function isToolError(error62) {
@@ -25930,6 +25944,11 @@ var ALL_TOOLS = [
   signalMessageSend
 ];
 
+// src/entry/errors.ts
+function errorBody(code, message, details) {
+  return { code, message, ...details !== void 0 && { details } };
+}
+
 // src/entry/permission.ts
 function permissionResources(spec, args, ctx) {
   return writeTargets(spec, args, ctx);
@@ -28519,8 +28538,8 @@ function writeJson(io, document) {
   io.stdout(`${JSON.stringify(document)}
 `);
 }
-function writeError(io, code, message) {
-  writeJson(io, { error: { code, message } });
+function writeError(io, code, message, details) {
+  writeJson(io, { error: errorBody(code, message, details) });
   return EXIT_FAILED;
 }
 async function readArguments(io) {
@@ -28548,7 +28567,7 @@ async function runTool(command, io) {
     writeJson(io, { result });
     return EXIT_OK;
   } catch (error62) {
-    if (isToolError(error62)) return writeError(io, error62.code, error62.message);
+    if (isToolError(error62)) return writeError(io, error62.code, error62.message, error62.details);
     if (isAbortError(error62)) return writeError(io, "internal_error", `${spec.id} was cancelled.`);
     io.stderr(`${PROGRAM2}: unexpected error while running ${spec.id}: ${errorDetail(error62)}
 `);
@@ -28571,7 +28590,7 @@ async function targetOf(command, io) {
     writeJson(io, { resources });
     return EXIT_OK;
   } catch (error62) {
-    if (isToolError(error62)) return writeError(io, error62.code, error62.message);
+    if (isToolError(error62)) return writeError(io, error62.code, error62.message, error62.details);
     if (isAbortError(error62)) return writeError(io, "internal_error", "The call was cancelled.");
     io.stderr(`${PROGRAM2}: unexpected error while resolving the target: ${errorDetail(error62)}
 `);

package/dist/mcp.js

@@ -28599,12 +28599,24 @@ var StdioServerTransport = class {
 };
 
 // src/core/errors.ts
+function deepFreeze(value) {
+  if (value !== null && typeof value === "object") {
+    Object.freeze(value);
+    for (const child of Object.values(value)) {
+      deepFreeze(child);
+    }
+  }
+  return value;
+}
 var ToolError = class extends Error {
   code;
   constructor(code, message, options) {
-    super(message, options);
+    super(message, options && "cause" in options ? { cause: options.cause } : void 0);
     this.name = "ToolError";
     this.code = code;
+    if (options?.details !== void 0) {
+      this.details = deepFreeze(JSON.parse(JSON.stringify(options.details)));
+    }
   }
 };
 function isToolError(error62) {
@@ -28853,6 +28865,24 @@ function packageRoot(bundleUrl) {
   return dirname(dirname(fileURLToPath(bundleUrl)));
 }
 
+// src/project.ts
+var PROJECT = {
+  /** The plugin, MCP server and program name. */
+  name: "signal-tools",
+  /** The command line the Hermes plugin calls. */
+  cli: "signal-tools-cli",
+  /** Every tool ID starts with `<toolPrefix>_`. */
+  toolPrefix: "signal",
+  /** Every setting's environment variable is `<envPrefix>_<SETTING>`. */
+  envPrefix: "SIGNAL_TOOLS",
+  /** The toolsets, in the order `all` lists them. */
+  toolsets: ["account", "chats", "contacts", "files", "sends", "actions"],
+  /** The toolsets on when a setting names none. */
+  defaultToolsets: ["account", "chats", "contacts", "sends"],
+  /** The environment variables the tools read besides the settings, which Codex forwards to the server after them. */
+  toolVariables: ["XDG_STATE_HOME"]
+};
+
 // src/entry/directory.ts
 import { homedir } from "node:os";
 import { isAbsolute as isAbsolute2, join, resolve, sep as sep2 } from "node:path";
@@ -28888,22 +28918,6 @@ function resolveDownloadDir(given, env, profile) {
   return given !== void 0 ? resolveGivenDirectory(given, home) : resolve2(home, DOWNLOADS_DIR, profile.name);
 }
 
-// src/project.ts
-var PROJECT = {
-  /** The plugin, MCP server and program name. */
-  name: "signal-tools",
-  /** The command line the Hermes plugin calls. */
-  cli: "signal-tools-cli",
-  /** Every tool ID starts with `<toolPrefix>_`. */
-  toolPrefix: "signal",
-  /** Every setting's environment variable is `<envPrefix>_<SETTING>`. */
-  envPrefix: "SIGNAL_TOOLS",
-  /** The toolsets, in the order `all` lists them. */
-  toolsets: ["account", "chats", "contacts", "files", "sends", "actions"],
-  /** The toolsets on when a setting names none. */
-  defaultToolsets: ["account", "chats", "contacts", "sends"]
-};
-
 // src/entry/profile.ts
 var PROJECT_PROFILE = {
   name: PROJECT.name,
@@ -36470,6 +36484,11 @@ var Server = class extends Protocol {
   }
 };
 
+// src/entry/errors.ts
+function errorBody(code, message, details) {
+  return { code, message, ...details !== void 0 && { details } };
+}
+
 // src/mcp/confirm.ts
 function supportsFormElicitation(server) {
   const elicitation = server.getClientCapabilities()?.elicitation;
@@ -36546,8 +36565,11 @@ function createWorkingDirResolver(server, fallback, ownDir) {
 
 // src/mcp/server.ts
 var DEFAULT_VERSION = "0.0.0";
-function errorResult(code, message) {
-  return { isError: true, content: [{ type: "text", text: JSON.stringify({ error: { code, message } }) }] };
+function errorResult(code, message, details) {
+  return {
+    isError: true,
+    content: [{ type: "text", text: JSON.stringify({ error: errorBody(code, message, details) }) }]
+  };
 }
 function describeTool(spec) {
   const meta3 = toolMeta(spec);
@@ -36590,7 +36612,7 @@ function createServer(specs, settings, options = {}) {
       return { content: [{ type: "text", text: JSON.stringify(result) }], structuredContent: result };
     } catch (error62) {
       if (isAbortError(error62)) throw error62;
-      if (isToolError(error62)) return errorResult(error62.code, error62.message);
+      if (isToolError(error62)) return errorResult(error62.code, error62.message, error62.details);
       log(
         `Unexpected error while running ${spec.id}: ${error62 instanceof Error ? error62.stack ?? error62.message : String(error62)}`
       );
@@ -36608,7 +36630,7 @@ async function main() {
     const settings = parseSettings(process.argv.slice(2), process.env);
     server = createServer(ALL_TOOLS, settings, {
       ownDir: packageRoot(import.meta.url),
-      version: true ? "0.1.1" : void 0
+      version: true ? "0.2.0" : void 0
     });
   } catch (error62) {
     if (!isToolError(error62)) throw error62;

package/dist/opencode.js

@@ -24,7 +24,9 @@ var PROJECT = {
   /** The toolsets, in the order `all` lists them. */
   toolsets: ["account", "chats", "contacts", "files", "sends", "actions"],
   /** The toolsets on when a setting names none. */
-  defaultToolsets: ["account", "chats", "contacts", "sends"]
+  defaultToolsets: ["account", "chats", "contacts", "sends"],
+  /** The environment variables the tools read besides the settings, which Codex forwards to the server after them. */
+  toolVariables: ["XDG_STATE_HOME"]
 };
 
 // src/core/account/read.ts
@@ -19749,12 +19751,24 @@ function date4(params) {
 }
 
 // src/core/errors.ts
+function deepFreeze(value) {
+  if (value !== null && typeof value === "object") {
+    Object.freeze(value);
+    for (const child of Object.values(value)) {
+      deepFreeze(child);
+    }
+  }
+  return value;
+}
 var ToolError = class extends Error {
   code;
   constructor(code, message, options) {
-    super(message, options);
+    super(message, options && "cause" in options ? { cause: options.cause } : void 0);
     this.name = "ToolError";
     this.code = code;
+    if (options?.details !== void 0) {
+      this.details = deepFreeze(JSON.parse(JSON.stringify(options.details)));
+    }
   }
 };
 function isToolError(error62) {
@@ -25681,6 +25695,12 @@ function permissionResources(spec, args, ctx) {
   return writeTargets(spec, args, ctx);
 }
 
+// src/entry/errors.ts
+function errorText(error62) {
+  return `${error62.code}: ${error62.message}${error62.details !== void 0 ? `
+${JSON.stringify(error62.details)}` : ""}`;
+}
+
 // src/entry/profile.ts
 var PROJECT_PROFILE = {
   name: PROJECT.name,
@@ -25899,7 +25919,7 @@ async function runTool(spec, args, ctx) {
     return await invoke(spec, args, ctx);
   } catch (error62) {
     if (!isToolError(error62)) throw error62;
-    throw new Error(`${error62.code}: ${error62.message}`, { cause: error62 });
+    throw new Error(errorText(error62), { cause: error62 });
   }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craftsamo/signal-tools",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Signal tools for coding agents: chats, messages, contacts, received files and sends.",
   "author": "craftsamo",
   "license": "MIT",
@@ -24,10 +24,9 @@
   "files": [
     "dist",
     "skills",
-    "plugin.json",
-    "mcp.json",
     ".mcp.json",
     ".claude-plugin",
+    ".codex-plugin",
     ".agents/plugins",
     ".antigravity-plugin",
     "mcp_config.json",
@@ -54,7 +53,7 @@
     "prepare": "node -e \"const fs=require('fs');if(fs.existsSync('.git')&&fs.existsSync('node_modules/husky'))require('child_process').execFileSync('husky',{stdio:'inherit'})\""
   },
   "devDependencies": {
-    "@craftsamo/repo-kit": "^1.3.0",
+    "@craftsamo/repo-kit": "^1.4.0",
     "@modelcontextprotocol/sdk": "^1.32.2",
     "@opencode-ai/plugin": "^1.19.5",
     "@types/bun": "^1.4.4",

package/plugin.yaml

@@ -1,5 +1,5 @@
 name: signal-tools
-version: 0.1.1
+version: 0.2.0
 description: "Signal tools for coding agents: chats, messages, contacts, received files and sends."
 manifest_version: 1
 requires_hermes: ">=0.22"

package/src/hermes/signal_tools_hermes/tools.py

@@ -36,10 +36,14 @@ def _read_document(stdout: str) -> dict[str, Any] | None:
 
 
 def _failure(code: int, stdout: str, stderr: str) -> str:
-    """The error result of a command line that did not succeed: its ``<code>: <message>``, or its stderr."""
+    """The error result of a command line that did not succeed: its ``<code>: <message>`` and details line, or its stderr."""
     error = (_read_document(stdout) or {}).get("error")
     if isinstance(error, dict) and isinstance(error.get("code"), str) and isinstance(error.get("message"), str):
-        return error_result(f"{error['code']}: {error['message']}")
+        message = f"{error['code']}: {error['message']}"
+        details = error.get("details")
+        if isinstance(details, dict):
+            message = f"{message}\n" + json.dumps(details, ensure_ascii=False, separators=(",", ":"))
+        return error_result(message)
     detail = stderr.strip() or f"exit status {code}"
     return error_result(f"{project.CLI_NAME} failed: {detail}")
 

package/mcp.json

@@ -1,10 +0,0 @@
-{
-  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
-  "mcpServers": {
-    "signal-tools": {
-      "type": "stdio",
-      "command": "node",
-      "args": ["${PLUGIN_ROOT}/dist/mcp.js"]
-    }
-  }
-}

package/plugin.json

@@ -1,13 +0,0 @@
-{
-  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
-  "name": "signal-tools",
-  "version": "0.1.1",
-  "description": "Signal tools for coding agents: chats, messages, contacts, received files and sends.",
-  "author": {
-    "name": "craftsamo",
-    "url": "https://github.com/craft-agent"
-  },
-  "homepage": "https://github.com/craft-agent/signal-tools#readme",
-  "repository": "https://github.com/craft-agent/signal-tools",
-  "license": "MIT"
-}