@akonwi/opencode-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akonwi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @akonwi/opencode-kit
+
+OpenCode plugin package for local workflow notifications and runtime toggles.
+
+## Features
+
+- Idle notification with terminal bell and optional speech.
+- Error notification with macOS Funk sound and optional speech.
+- Runtime config reads from `~/.config/opencode/kit.json`.
+- Structured JSON-line logs at `~/.config/opencode/logs/opencode-kit.log`.
+- Local control CLI (no AI turn): `oc-kit`.
+
+## Install
+
+```bash
+bun add @akonwi/opencode-kit
+```
+
+Register the plugin in your OpenCode plugin config by loading `@akonwi/opencode-kit` and the `OpencodeKit` export.
+
+## Config
+
+File: `~/.config/opencode/kit.json`
+
+```json
+{
+  "bells": {
+    "enabled": true,
+    "errorSound": "Funk"
+  },
+  "speech": {
+    "enabled": true,
+    "maxChars": 220,
+    "voice": null
+  },
+  "debug": {
+    "logLevel": "info"
+  }
+}
+```
+
+If the file is missing or invalid, safe defaults are used.
+
+## CLI
+
+```bash
+oc-kit bells on
+oc-kit bells off
+oc-kit bells toggle
+oc-kit bells status
+
+oc-kit speech on
+oc-kit speech off
+oc-kit speech toggle
+oc-kit speech status
+```
+
+The plugin re-reads `kit.json` at runtime so changes apply without restart.
+
+## Development
+
+```bash
+bun install
+bun run format
+bun run lint
+bun run build
+```

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+
+// src/config.ts
+import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { homedir } from "os";
+import path from "path";
+var CONFIG_PATH = path.join(homedir(), ".config", "opencode", "kit.json");
+var VALID_LOG_LEVELS = /* @__PURE__ */ new Set(["debug", "info", "warn", "error"]);
+var DEFAULT_CONFIG = {
+  bells: {
+    enabled: true,
+    errorSound: "Funk"
+  },
+  speech: {
+    enabled: true,
+    maxChars: 220,
+    voice: null
+  },
+  debug: {
+    logLevel: "info"
+  }
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function asBoolean(value, fallback) {
+  return typeof value === "boolean" ? value : fallback;
+}
+function asErrorSound(value, fallback) {
+  return value === "Funk" ? "Funk" : fallback;
+}
+function asOptionalString(value, fallback) {
+  if (value === null) {
+    return null;
+  }
+  return typeof value === "string" && value.trim() !== "" ? value : fallback;
+}
+function asIntInRange(value, fallback, min, max) {
+  if (typeof value !== "number" || !Number.isInteger(value)) {
+    return fallback;
+  }
+  if (value < min || value > max) {
+    return fallback;
+  }
+  return value;
+}
+function asLogLevel(value, fallback) {
+  if (typeof value !== "string") {
+    return fallback;
+  }
+  return VALID_LOG_LEVELS.has(value) ? value : fallback;
+}
+function sanitizeConfig(input) {
+  const raw = isRecord(input) ? input : {};
+  const rawBells = isRecord(raw.bells) ? raw.bells : {};
+  const rawSpeech = isRecord(raw.speech) ? raw.speech : {};
+  const rawDebug = isRecord(raw.debug) ? raw.debug : {};
+  return {
+    bells: {
+      enabled: asBoolean(rawBells.enabled, DEFAULT_CONFIG.bells.enabled),
+      errorSound: asErrorSound(rawBells.errorSound, DEFAULT_CONFIG.bells.errorSound)
+    },
+    speech: {
+      enabled: asBoolean(rawSpeech.enabled, DEFAULT_CONFIG.speech.enabled),
+      maxChars: asIntInRange(rawSpeech.maxChars, DEFAULT_CONFIG.speech.maxChars, 20, 2e3),
+      voice: asOptionalString(rawSpeech.voice, DEFAULT_CONFIG.speech.voice)
+    },
+    debug: {
+      logLevel: asLogLevel(rawDebug.logLevel, DEFAULT_CONFIG.debug.logLevel)
+    }
+  };
+}
+async function readConfig() {
+  try {
+    const content = await readFile(CONFIG_PATH, "utf8");
+    const parsed = JSON.parse(content);
+    return sanitizeConfig(parsed);
+  } catch {
+    return sanitizeConfig(DEFAULT_CONFIG);
+  }
+}
+async function ensureConfigDirectory() {
+  await mkdir(path.dirname(CONFIG_PATH), { recursive: true });
+}
+async function writeConfig(config) {
+  const safeConfig = sanitizeConfig(config);
+  const serialized = `${JSON.stringify(safeConfig, null, 2)}
+`;
+  const tempPath = `${CONFIG_PATH}.tmp`;
+  await ensureConfigDirectory();
+  await writeFile(tempPath, serialized, "utf8");
+  await rename(tempPath, CONFIG_PATH);
+}
+async function updateConfig(mutator) {
+  const current = await readConfig();
+  const next = sanitizeConfig(mutator(current));
+  await writeConfig(next);
+  return next;
+}
+
+// src/cli.ts
+function printUsage() {
+  const lines = [
+    "Usage:",
+    "  oc-kit bells on|off|toggle|status",
+    "  oc-kit speech on|off|toggle|status"
+  ];
+  process.stdout.write(`${lines.join("\n")}
+`);
+}
+function asTopic(input) {
+  if (input === "bells" || input === "speech") {
+    return input;
+  }
+  return null;
+}
+function asAction(input) {
+  if (input === "on" || input === "off" || input === "toggle" || input === "status") {
+    return input;
+  }
+  return null;
+}
+async function getStatusLine() {
+  const config = await readConfig();
+  return `bells=${config.bells.enabled ? "on" : "off"} speech=${config.speech.enabled ? "on" : "off"}`;
+}
+async function run() {
+  const args = process.argv.slice(2);
+  const topic = asTopic(args[0]);
+  const action = asAction(args[1]);
+  if (!topic || !action) {
+    printUsage();
+    process.exitCode = 1;
+    return;
+  }
+  if (action === "status") {
+    const line = await getStatusLine();
+    process.stdout.write(`${line}
+config=${CONFIG_PATH}
+`);
+    return;
+  }
+  const updated = await updateConfig((current) => {
+    const enabled = topic === "bells" ? current.bells.enabled : current.speech.enabled;
+    const nextEnabled = action === "toggle" ? !enabled : action === "on";
+    if (topic === "bells") {
+      return {
+        ...current,
+        bells: {
+          ...current.bells,
+          enabled: nextEnabled
+        }
+      };
+    }
+    return {
+      ...current,
+      speech: {
+        ...current.speech,
+        enabled: nextEnabled
+      }
+    };
+  });
+  process.stdout.write(
+    `updated ${topic}.enabled=${topic === "bells" ? updated.bells.enabled : updated.speech.enabled}
+`
+  );
+  process.stdout.write(
+    `status bells=${updated.bells.enabled ? "on" : "off"} speech=${updated.speech.enabled ? "on" : "off"}
+`
+  );
+  process.stdout.write(`config=${CONFIG_PATH}
+`);
+}
+void run();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/cli.ts"],"sourcesContent":["import { mkdir, readFile, rename, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport interface KitConfig {\n  bells: {\n    enabled: boolean;\n    errorSound: \"Funk\";\n  };\n  speech: {\n    enabled: boolean;\n    maxChars: number;\n    voice: string | null;\n  };\n  debug: {\n    logLevel: LogLevel;\n  };\n}\n\nexport const CONFIG_PATH = path.join(homedir(), \".config\", \"opencode\", \"kit.json\");\n\nconst VALID_LOG_LEVELS: ReadonlySet<string> = new Set([\"debug\", \"info\", \"warn\", \"error\"]);\n\nconst DEFAULT_CONFIG: KitConfig = {\n  bells: {\n    enabled: true,\n    errorSound: \"Funk\",\n  },\n  speech: {\n    enabled: true,\n    maxChars: 220,\n    voice: null,\n  },\n  debug: {\n    logLevel: \"info\",\n  },\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction asBoolean(value: unknown, fallback: boolean): boolean {\n  return typeof value === \"boolean\" ? value : fallback;\n}\n\nfunction asErrorSound(value: unknown, fallback: \"Funk\"): \"Funk\" {\n  return value === \"Funk\" ? \"Funk\" : fallback;\n}\n\nfunction asOptionalString(value: unknown, fallback: string | null): string | null {\n  if (value === null) {\n    return null;\n  }\n\n  return typeof value === \"string\" && value.trim() !== \"\" ? value : fallback;\n}\n\nfunction asIntInRange(value: unknown, fallback: number, min: number, max: number): number {\n  if (typeof value !== \"number\" || !Number.isInteger(value)) {\n    return fallback;\n  }\n\n  if (value < min || value > max) {\n    return fallback;\n  }\n\n  return value;\n}\n\nfunction asLogLevel(value: unknown, fallback: LogLevel): LogLevel {\n  if (typeof value !== \"string\") {\n    return fallback;\n  }\n\n  return VALID_LOG_LEVELS.has(value) ? (value as LogLevel) : fallback;\n}\n\nexport function sanitizeConfig(input: unknown): KitConfig {\n  const raw = isRecord(input) ? input : {};\n  const rawBells = isRecord(raw.bells) ? raw.bells : {};\n  const rawSpeech = isRecord(raw.speech) ? raw.speech : {};\n  const rawDebug = isRecord(raw.debug) ? raw.debug : {};\n\n  return {\n    bells: {\n      enabled: asBoolean(rawBells.enabled, DEFAULT_CONFIG.bells.enabled),\n      errorSound: asErrorSound(rawBells.errorSound, DEFAULT_CONFIG.bells.errorSound),\n    },\n    speech: {\n      enabled: asBoolean(rawSpeech.enabled, DEFAULT_CONFIG.speech.enabled),\n      maxChars: asIntInRange(rawSpeech.maxChars, DEFAULT_CONFIG.speech.maxChars, 20, 2000),\n      voice: asOptionalString(rawSpeech.voice, DEFAULT_CONFIG.speech.voice),\n    },\n    debug: {\n      logLevel: asLogLevel(rawDebug.logLevel, DEFAULT_CONFIG.debug.logLevel),\n    },\n  };\n}\n\nexport async function readConfig(): Promise<KitConfig> {\n  try {\n    const content = await readFile(CONFIG_PATH, \"utf8\");\n    const parsed = JSON.parse(content) as unknown;\n    return sanitizeConfig(parsed);\n  } catch {\n    return sanitizeConfig(DEFAULT_CONFIG);\n  }\n}\n\nasync function ensureConfigDirectory(): Promise<void> {\n  await mkdir(path.dirname(CONFIG_PATH), { recursive: true });\n}\n\nexport async function writeConfig(config: KitConfig): Promise<void> {\n  const safeConfig = sanitizeConfig(config);\n  const serialized = `${JSON.stringify(safeConfig, null, 2)}\\n`;\n  const tempPath = `${CONFIG_PATH}.tmp`;\n\n  await ensureConfigDirectory();\n  await writeFile(tempPath, serialized, \"utf8\");\n  await rename(tempPath, CONFIG_PATH);\n}\n\nexport async function updateConfig(mutator: (current: KitConfig) => KitConfig): Promise<KitConfig> {\n  const current = await readConfig();\n  const next = sanitizeConfig(mutator(current));\n  await writeConfig(next);\n  return next;\n}\n\nexport function defaultConfig(): KitConfig {\n  return sanitizeConfig(DEFAULT_CONFIG);\n}\n","#!/usr/bin/env node\n\nimport { CONFIG_PATH, readConfig, updateConfig } from \"./config\";\n\ntype Topic = \"bells\" | \"speech\";\ntype Action = \"on\" | \"off\" | \"toggle\" | \"status\";\n\nfunction printUsage(): void {\n  const lines = [\n    \"Usage:\",\n    \"  oc-kit bells on|off|toggle|status\",\n    \"  oc-kit speech on|off|toggle|status\",\n  ];\n  process.stdout.write(`${lines.join(\"\\n\")}\\n`);\n}\n\nfunction asTopic(input: string | undefined): Topic | null {\n  if (input === \"bells\" || input === \"speech\") {\n    return input;\n  }\n\n  return null;\n}\n\nfunction asAction(input: string | undefined): Action | null {\n  if (input === \"on\" || input === \"off\" || input === \"toggle\" || input === \"status\") {\n    return input;\n  }\n\n  return null;\n}\n\nasync function getStatusLine(): Promise<string> {\n  const config = await readConfig();\n  return `bells=${config.bells.enabled ? \"on\" : \"off\"} speech=${config.speech.enabled ? \"on\" : \"off\"}`;\n}\n\nasync function run(): Promise<void> {\n  const args = process.argv.slice(2);\n  const topic = asTopic(args[0]);\n  const action = asAction(args[1]);\n\n  if (!topic || !action) {\n    printUsage();\n    process.exitCode = 1;\n    return;\n  }\n\n  if (action === \"status\") {\n    const line = await getStatusLine();\n    process.stdout.write(`${line}\\nconfig=${CONFIG_PATH}\\n`);\n    return;\n  }\n\n  const updated = await updateConfig((current) => {\n    const enabled = topic === \"bells\" ? current.bells.enabled : current.speech.enabled;\n    const nextEnabled = action === \"toggle\" ? !enabled : action === \"on\";\n\n    if (topic === \"bells\") {\n      return {\n        ...current,\n        bells: {\n          ...current.bells,\n          enabled: nextEnabled,\n        },\n      };\n    }\n\n    return {\n      ...current,\n      speech: {\n        ...current.speech,\n        enabled: nextEnabled,\n      },\n    };\n  });\n\n  process.stdout.write(\n    `updated ${topic}.enabled=${topic === \"bells\" ? updated.bells.enabled : updated.speech.enabled}\\n`,\n  );\n  process.stdout.write(\n    `status bells=${updated.bells.enabled ? \"on\" : \"off\"} speech=${updated.speech.enabled ? \"on\" : \"off\"}\\n`,\n  );\n  process.stdout.write(`config=${CONFIG_PATH}\\n`);\n}\n\nvoid run();\n"],"mappings":"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","names":[]}

package/dist/plugin.d.ts

@@ -0,0 +1,5 @@
+import { Plugin } from '@opencode-ai/plugin';
+
+declare const OpencodeKit: Plugin;
+
+export { OpencodeKit, OpencodeKit as default };

package/dist/plugin.js

@@ -0,0 +1,335 @@
+// src/config.ts
+import { mkdir, readFile, rename, writeFile } from "fs/promises";
+import { homedir } from "os";
+import path from "path";
+var CONFIG_PATH = path.join(homedir(), ".config", "opencode", "kit.json");
+var VALID_LOG_LEVELS = /* @__PURE__ */ new Set(["debug", "info", "warn", "error"]);
+var DEFAULT_CONFIG = {
+  bells: {
+    enabled: true,
+    errorSound: "Funk"
+  },
+  speech: {
+    enabled: true,
+    maxChars: 220,
+    voice: null
+  },
+  debug: {
+    logLevel: "info"
+  }
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function asBoolean(value, fallback) {
+  return typeof value === "boolean" ? value : fallback;
+}
+function asErrorSound(value, fallback) {
+  return value === "Funk" ? "Funk" : fallback;
+}
+function asOptionalString(value, fallback) {
+  if (value === null) {
+    return null;
+  }
+  return typeof value === "string" && value.trim() !== "" ? value : fallback;
+}
+function asIntInRange(value, fallback, min, max) {
+  if (typeof value !== "number" || !Number.isInteger(value)) {
+    return fallback;
+  }
+  if (value < min || value > max) {
+    return fallback;
+  }
+  return value;
+}
+function asLogLevel(value, fallback) {
+  if (typeof value !== "string") {
+    return fallback;
+  }
+  return VALID_LOG_LEVELS.has(value) ? value : fallback;
+}
+function sanitizeConfig(input) {
+  const raw = isRecord(input) ? input : {};
+  const rawBells = isRecord(raw.bells) ? raw.bells : {};
+  const rawSpeech = isRecord(raw.speech) ? raw.speech : {};
+  const rawDebug = isRecord(raw.debug) ? raw.debug : {};
+  return {
+    bells: {
+      enabled: asBoolean(rawBells.enabled, DEFAULT_CONFIG.bells.enabled),
+      errorSound: asErrorSound(rawBells.errorSound, DEFAULT_CONFIG.bells.errorSound)
+    },
+    speech: {
+      enabled: asBoolean(rawSpeech.enabled, DEFAULT_CONFIG.speech.enabled),
+      maxChars: asIntInRange(rawSpeech.maxChars, DEFAULT_CONFIG.speech.maxChars, 20, 2e3),
+      voice: asOptionalString(rawSpeech.voice, DEFAULT_CONFIG.speech.voice)
+    },
+    debug: {
+      logLevel: asLogLevel(rawDebug.logLevel, DEFAULT_CONFIG.debug.logLevel)
+    }
+  };
+}
+async function readConfig() {
+  try {
+    const content = await readFile(CONFIG_PATH, "utf8");
+    const parsed = JSON.parse(content);
+    return sanitizeConfig(parsed);
+  } catch {
+    return sanitizeConfig(DEFAULT_CONFIG);
+  }
+}
+
+// src/features/logging.ts
+import { appendFile, mkdir as mkdir2 } from "fs/promises";
+import { homedir as homedir2 } from "os";
+import path2 from "path";
+var LOG_DIR = path2.join(homedir2(), ".config", "opencode", "logs");
+var LOG_PATH = path2.join(LOG_DIR, "opencode-kit.log");
+var LOG_WEIGHT = {
+  debug: 10,
+  info: 20,
+  warn: 30,
+  error: 40
+};
+function shouldLog(minLevel, level) {
+  return LOG_WEIGHT[level] >= LOG_WEIGHT[minLevel];
+}
+async function appendLogLine(line) {
+  try {
+    await mkdir2(LOG_DIR, { recursive: true });
+    await appendFile(LOG_PATH, `${JSON.stringify(line)}
+`, "utf8");
+  } catch {
+  }
+}
+function createLogger(initialLevel = "info") {
+  let minLevel = initialLevel;
+  const write = (level, event, message, context) => {
+    if (!shouldLog(minLevel, level)) {
+      return;
+    }
+    void appendLogLine({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level,
+      event,
+      message,
+      context
+    });
+  };
+  return {
+    setLevel: (level) => {
+      minLevel = level;
+    },
+    debug: (event, message, context) => {
+      write("debug", event, message, context);
+    },
+    info: (event, message, context) => {
+      write("info", event, message, context);
+    },
+    warn: (event, message, context) => {
+      write("warn", event, message, context);
+    },
+    error: (event, message, context) => {
+      write("error", event, message, context);
+    }
+  };
+}
+
+// src/features/sounds.ts
+import { spawn } from "child_process";
+var FUNK_SOUND_PATH = "/System/Library/Sounds/Funk.aiff";
+function runCommand(command, args, logger) {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, {
+      stdio: "ignore"
+    });
+    child.on("error", (error) => {
+      logger.warn("command.error", "Command failed to launch", {
+        command,
+        args,
+        error: error.message
+      });
+      resolve();
+    });
+    child.on("exit", (code) => {
+      if (code !== 0) {
+        logger.warn("command.nonzero", "Command exited non-zero", {
+          command,
+          args,
+          code
+        });
+      }
+      resolve();
+    });
+  });
+}
+function truncateSummary(text, maxChars) {
+  const trimmed = text.trim();
+  if (trimmed.length <= maxChars) {
+    return trimmed;
+  }
+  return `${trimmed.slice(0, maxChars - 3)}...`;
+}
+function cleanTextForSpeech(text) {
+  return text.replace(/```[\s\S]*?```/g, " code block omitted ").replace(/`([^`]+)`/g, "$1").replace(/\[(.*?)\]\((.*?)\)/g, "$1").replace(/[*_~#>]/g, "").replace(/\s+/g, " ").trim();
+}
+function shortSpeech(text, maxChars) {
+  const cleaned = cleanTextForSpeech(text);
+  if (!cleaned) {
+    return "";
+  }
+  if (cleaned.length <= maxChars) {
+    return cleaned;
+  }
+  const sentence = cleaned.match(/(.+?[.!?])(\s|$)/)?.[1]?.trim();
+  if (sentence && sentence.length <= maxChars) {
+    return sentence;
+  }
+  return truncateSummary(cleaned, maxChars);
+}
+function writeTerminalBell(logger) {
+  try {
+    process.stdout.write("\x07");
+  } catch (error) {
+    logger.warn("bell.error", "Failed to write terminal bell", {
+      error: error instanceof Error ? error.message : String(error)
+    });
+  }
+}
+async function speak(text, config, logger) {
+  if (!config.speech.enabled) {
+    return;
+  }
+  if (process.platform !== "darwin") {
+    logger.info("speech.unsupported", "Speech skipped: platform unsupported", {
+      platform: process.platform
+    });
+    return;
+  }
+  const clipped = shortSpeech(text, config.speech.maxChars);
+  if (!clipped) {
+    return;
+  }
+  const args = [];
+  if (config.speech.voice) {
+    args.push("-v", config.speech.voice);
+  }
+  args.push(clipped);
+  await runCommand("say", args, logger);
+}
+async function playErrorSound(config, logger) {
+  if (!config.bells.enabled) {
+    return;
+  }
+  if (process.platform !== "darwin") {
+    writeTerminalBell(logger);
+    return;
+  }
+  if (config.bells.errorSound === "Funk") {
+    await runCommand("afplay", [FUNK_SOUND_PATH], logger);
+  }
+}
+async function notifyIdle(lastAssistantText, config, logger) {
+  if (config.bells.enabled) {
+    writeTerminalBell(logger);
+  }
+  if (config.speech.enabled && lastAssistantText.trim()) {
+    await speak(lastAssistantText, config, logger);
+  }
+  logger.debug("idle.notify", "Idle notification processed", {
+    bell: config.bells.enabled,
+    speech: config.speech.enabled
+  });
+}
+async function notifyError(message, config, logger) {
+  await playErrorSound(config, logger);
+  if (config.speech.enabled) {
+    const safeMessage = message?.trim() || "Unknown error";
+    await speak(`OpenCode error: ${safeMessage}`, config, logger);
+  }
+  logger.warn("error.notify", "Error notification processed", {
+    bell: config.bells.enabled,
+    speech: config.speech.enabled
+  });
+}
+
+// src/plugin.ts
+function getErrorMessage(event) {
+  if (event.type !== "session.error") {
+    return "Unknown error";
+  }
+  const rawError = event.properties.error;
+  if (!rawError) {
+    return "Agent encountered an error.";
+  }
+  const errorData = rawError.data;
+  if (errorData && typeof errorData === "object") {
+    if ("message" in errorData && typeof errorData.message === "string" && errorData.message.trim()) {
+      return `Agent encountered an error: ${errorData.message.trim()}`;
+    }
+  }
+  if (typeof rawError.name === "string" && rawError.name.trim()) {
+    return `Agent encountered an error: ${rawError.name.trim()}`;
+  }
+  return "Agent encountered an error.";
+}
+var OpencodeKit = async (input) => {
+  const logger = createLogger();
+  const latestAssistantMessageBySession = /* @__PURE__ */ new Map();
+  const latestAssistantTextByMessage = /* @__PURE__ */ new Map();
+  const lastSpokenMessageBySession = /* @__PURE__ */ new Map();
+  return {
+    event: async ({ event }) => {
+      if (event.type === "message.updated") {
+        const info = event.properties.info;
+        if (info.role === "assistant") {
+          latestAssistantMessageBySession.set(info.sessionID, info.id);
+        }
+        return;
+      }
+      if (event.type === "message.part.updated") {
+        const part = event.properties.part;
+        if (part.type === "text" && typeof part.messageID === "string" && typeof part.text === "string") {
+          latestAssistantTextByMessage.set(part.messageID, part.text);
+        }
+        return;
+      }
+      if (event.type !== "session.idle" && event.type !== "session.error") {
+        return;
+      }
+      const config = await readConfig();
+      logger.setLevel(config.debug.logLevel);
+      if (event.type === "session.idle") {
+        const sessionID = event.properties.sessionID;
+        const latestMessageID = latestAssistantMessageBySession.get(sessionID);
+        const lastText = latestMessageID ? latestAssistantTextByMessage.get(latestMessageID) ?? "" : "";
+        const previouslySpoken = lastSpokenMessageBySession.get(sessionID);
+        if (latestMessageID && previouslySpoken === latestMessageID) {
+          logger.debug("idle.skip_duplicate", "Skipping duplicate idle speech", {
+            sessionID,
+            messageID: latestMessageID
+          });
+          return;
+        }
+        if (!latestMessageID || !lastText) {
+          logger.warn("idle.no_summary", "No cached assistant summary for idle event", {
+            sessionID,
+            hasMessageID: Boolean(latestMessageID),
+            hasText: Boolean(lastText)
+          });
+          await notifyIdle("", config, logger);
+          return;
+        }
+        lastSpokenMessageBySession.set(sessionID, latestMessageID);
+        await notifyIdle(lastText, config, logger);
+        return;
+      }
+      await notifyError(getErrorMessage(event), config, logger);
+    }
+  };
+};
+var plugin_default = OpencodeKit;
+export {
+  OpencodeKit,
+  plugin_default as default
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/features/logging.ts","../src/features/sounds.ts","../src/plugin.ts"],"sourcesContent":["import { mkdir, readFile, rename, writeFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\nexport interface KitConfig {\n  bells: {\n    enabled: boolean;\n    errorSound: \"Funk\";\n  };\n  speech: {\n    enabled: boolean;\n    maxChars: number;\n    voice: string | null;\n  };\n  debug: {\n    logLevel: LogLevel;\n  };\n}\n\nexport const CONFIG_PATH = path.join(homedir(), \".config\", \"opencode\", \"kit.json\");\n\nconst VALID_LOG_LEVELS: ReadonlySet<string> = new Set([\"debug\", \"info\", \"warn\", \"error\"]);\n\nconst DEFAULT_CONFIG: KitConfig = {\n  bells: {\n    enabled: true,\n    errorSound: \"Funk\",\n  },\n  speech: {\n    enabled: true,\n    maxChars: 220,\n    voice: null,\n  },\n  debug: {\n    logLevel: \"info\",\n  },\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null;\n}\n\nfunction asBoolean(value: unknown, fallback: boolean): boolean {\n  return typeof value === \"boolean\" ? value : fallback;\n}\n\nfunction asErrorSound(value: unknown, fallback: \"Funk\"): \"Funk\" {\n  return value === \"Funk\" ? \"Funk\" : fallback;\n}\n\nfunction asOptionalString(value: unknown, fallback: string | null): string | null {\n  if (value === null) {\n    return null;\n  }\n\n  return typeof value === \"string\" && value.trim() !== \"\" ? value : fallback;\n}\n\nfunction asIntInRange(value: unknown, fallback: number, min: number, max: number): number {\n  if (typeof value !== \"number\" || !Number.isInteger(value)) {\n    return fallback;\n  }\n\n  if (value < min || value > max) {\n    return fallback;\n  }\n\n  return value;\n}\n\nfunction asLogLevel(value: unknown, fallback: LogLevel): LogLevel {\n  if (typeof value !== \"string\") {\n    return fallback;\n  }\n\n  return VALID_LOG_LEVELS.has(value) ? (value as LogLevel) : fallback;\n}\n\nexport function sanitizeConfig(input: unknown): KitConfig {\n  const raw = isRecord(input) ? input : {};\n  const rawBells = isRecord(raw.bells) ? raw.bells : {};\n  const rawSpeech = isRecord(raw.speech) ? raw.speech : {};\n  const rawDebug = isRecord(raw.debug) ? raw.debug : {};\n\n  return {\n    bells: {\n      enabled: asBoolean(rawBells.enabled, DEFAULT_CONFIG.bells.enabled),\n      errorSound: asErrorSound(rawBells.errorSound, DEFAULT_CONFIG.bells.errorSound),\n    },\n    speech: {\n      enabled: asBoolean(rawSpeech.enabled, DEFAULT_CONFIG.speech.enabled),\n      maxChars: asIntInRange(rawSpeech.maxChars, DEFAULT_CONFIG.speech.maxChars, 20, 2000),\n      voice: asOptionalString(rawSpeech.voice, DEFAULT_CONFIG.speech.voice),\n    },\n    debug: {\n      logLevel: asLogLevel(rawDebug.logLevel, DEFAULT_CONFIG.debug.logLevel),\n    },\n  };\n}\n\nexport async function readConfig(): Promise<KitConfig> {\n  try {\n    const content = await readFile(CONFIG_PATH, \"utf8\");\n    const parsed = JSON.parse(content) as unknown;\n    return sanitizeConfig(parsed);\n  } catch {\n    return sanitizeConfig(DEFAULT_CONFIG);\n  }\n}\n\nasync function ensureConfigDirectory(): Promise<void> {\n  await mkdir(path.dirname(CONFIG_PATH), { recursive: true });\n}\n\nexport async function writeConfig(config: KitConfig): Promise<void> {\n  const safeConfig = sanitizeConfig(config);\n  const serialized = `${JSON.stringify(safeConfig, null, 2)}\\n`;\n  const tempPath = `${CONFIG_PATH}.tmp`;\n\n  await ensureConfigDirectory();\n  await writeFile(tempPath, serialized, \"utf8\");\n  await rename(tempPath, CONFIG_PATH);\n}\n\nexport async function updateConfig(mutator: (current: KitConfig) => KitConfig): Promise<KitConfig> {\n  const current = await readConfig();\n  const next = sanitizeConfig(mutator(current));\n  await writeConfig(next);\n  return next;\n}\n\nexport function defaultConfig(): KitConfig {\n  return sanitizeConfig(DEFAULT_CONFIG);\n}\n","import { appendFile, mkdir } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport path from \"node:path\";\n\nimport type { LogLevel } from \"../config\";\n\nconst LOG_DIR = path.join(homedir(), \".config\", \"opencode\", \"logs\");\nexport const LOG_PATH = path.join(LOG_DIR, \"opencode-kit.log\");\n\nconst LOG_WEIGHT: Record<LogLevel, number> = {\n  debug: 10,\n  info: 20,\n  warn: 30,\n  error: 40,\n};\n\nexport interface LogContext {\n  [key: string]: unknown;\n}\n\nexport interface Logger {\n  setLevel: (level: LogLevel) => void;\n  debug: (event: string, message: string, context?: LogContext) => void;\n  info: (event: string, message: string, context?: LogContext) => void;\n  warn: (event: string, message: string, context?: LogContext) => void;\n  error: (event: string, message: string, context?: LogContext) => void;\n}\n\ninterface LogLine {\n  timestamp: string;\n  level: LogLevel;\n  event: string;\n  message: string;\n  context?: LogContext;\n}\n\nfunction shouldLog(minLevel: LogLevel, level: LogLevel): boolean {\n  return LOG_WEIGHT[level] >= LOG_WEIGHT[minLevel];\n}\n\nasync function appendLogLine(line: LogLine): Promise<void> {\n  try {\n    await mkdir(LOG_DIR, { recursive: true });\n    await appendFile(LOG_PATH, `${JSON.stringify(line)}\\n`, \"utf8\");\n  } catch {\n    // Best effort logging only.\n  }\n}\n\nexport function createLogger(initialLevel: LogLevel = \"info\"): Logger {\n  let minLevel = initialLevel;\n\n  const write = (level: LogLevel, event: string, message: string, context?: LogContext): void => {\n    if (!shouldLog(minLevel, level)) {\n      return;\n    }\n\n    void appendLogLine({\n      timestamp: new Date().toISOString(),\n      level,\n      event,\n      message,\n      context,\n    });\n  };\n\n  return {\n    setLevel: (level: LogLevel) => {\n      minLevel = level;\n    },\n    debug: (event, message, context) => {\n      write(\"debug\", event, message, context);\n    },\n    info: (event, message, context) => {\n      write(\"info\", event, message, context);\n    },\n    warn: (event, message, context) => {\n      write(\"warn\", event, message, context);\n    },\n    error: (event, message, context) => {\n      write(\"error\", event, message, context);\n    },\n  };\n}\n","import { spawn } from \"node:child_process\";\n\nimport type { KitConfig } from \"../config\";\nimport type { Logger } from \"./logging\";\n\nconst FUNK_SOUND_PATH = \"/System/Library/Sounds/Funk.aiff\";\n\nfunction runCommand(command: string, args: string[], logger: Logger): Promise<void> {\n  return new Promise((resolve) => {\n    const child = spawn(command, args, {\n      stdio: \"ignore\",\n    });\n\n    child.on(\"error\", (error) => {\n      logger.warn(\"command.error\", \"Command failed to launch\", {\n        command,\n        args,\n        error: error.message,\n      });\n      resolve();\n    });\n\n    child.on(\"exit\", (code) => {\n      if (code !== 0) {\n        logger.warn(\"command.nonzero\", \"Command exited non-zero\", {\n          command,\n          args,\n          code,\n        });\n      }\n\n      resolve();\n    });\n  });\n}\n\nfunction truncateSummary(text: string, maxChars: number): string {\n  const trimmed = text.trim();\n  if (trimmed.length <= maxChars) {\n    return trimmed;\n  }\n\n  return `${trimmed.slice(0, maxChars - 3)}...`;\n}\n\nfunction cleanTextForSpeech(text: string): string {\n  return text\n    .replace(/```[\\s\\S]*?```/g, \" code block omitted \")\n    .replace(/`([^`]+)`/g, \"$1\")\n    .replace(/\\[(.*?)\\]\\((.*?)\\)/g, \"$1\")\n    .replace(/[*_~#>]/g, \"\")\n    .replace(/\\s+/g, \" \")\n    .trim();\n}\n\nfunction shortSpeech(text: string, maxChars: number): string {\n  const cleaned = cleanTextForSpeech(text);\n  if (!cleaned) {\n    return \"\";\n  }\n\n  if (cleaned.length <= maxChars) {\n    return cleaned;\n  }\n\n  const sentence = cleaned.match(/(.+?[.!?])(\\s|$)/)?.[1]?.trim();\n  if (sentence && sentence.length <= maxChars) {\n    return sentence;\n  }\n\n  return truncateSummary(cleaned, maxChars);\n}\n\nfunction writeTerminalBell(logger: Logger): void {\n  try {\n    process.stdout.write(\"\\u0007\");\n  } catch (error) {\n    logger.warn(\"bell.error\", \"Failed to write terminal bell\", {\n      error: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\n\nasync function speak(text: string, config: KitConfig, logger: Logger): Promise<void> {\n  if (!config.speech.enabled) {\n    return;\n  }\n\n  if (process.platform !== \"darwin\") {\n    logger.info(\"speech.unsupported\", \"Speech skipped: platform unsupported\", {\n      platform: process.platform,\n    });\n    return;\n  }\n\n  const clipped = shortSpeech(text, config.speech.maxChars);\n  if (!clipped) {\n    return;\n  }\n\n  const args: string[] = [];\n  if (config.speech.voice) {\n    args.push(\"-v\", config.speech.voice);\n  }\n  args.push(clipped);\n\n  await runCommand(\"say\", args, logger);\n}\n\nasync function playErrorSound(config: KitConfig, logger: Logger): Promise<void> {\n  if (!config.bells.enabled) {\n    return;\n  }\n\n  if (process.platform !== \"darwin\") {\n    writeTerminalBell(logger);\n    return;\n  }\n\n  if (config.bells.errorSound === \"Funk\") {\n    await runCommand(\"afplay\", [FUNK_SOUND_PATH], logger);\n  }\n}\n\nexport async function notifyIdle(\n  lastAssistantText: string,\n  config: KitConfig,\n  logger: Logger,\n): Promise<void> {\n  if (config.bells.enabled) {\n    writeTerminalBell(logger);\n  }\n\n  if (config.speech.enabled && lastAssistantText.trim()) {\n    await speak(lastAssistantText, config, logger);\n  }\n\n  logger.debug(\"idle.notify\", \"Idle notification processed\", {\n    bell: config.bells.enabled,\n    speech: config.speech.enabled,\n  });\n}\n\nexport async function notifyError(\n  message: string,\n  config: KitConfig,\n  logger: Logger,\n): Promise<void> {\n  await playErrorSound(config, logger);\n\n  if (config.speech.enabled) {\n    const safeMessage = message?.trim() || \"Unknown error\";\n    await speak(`OpenCode error: ${safeMessage}`, config, logger);\n  }\n\n  logger.warn(\"error.notify\", \"Error notification processed\", {\n    bell: config.bells.enabled,\n    speech: config.speech.enabled,\n  });\n}\n","import type { Plugin } from \"@opencode-ai/plugin\";\nimport type { Event } from \"@opencode-ai/sdk\";\n\nimport { readConfig } from \"./config\";\nimport { createLogger } from \"./features/logging\";\nimport { notifyError, notifyIdle } from \"./features/sounds\";\n\nfunction getErrorMessage(event: Event): string {\n  if (event.type !== \"session.error\") {\n    return \"Unknown error\";\n  }\n\n  const rawError = event.properties.error;\n  if (!rawError) {\n    return \"Agent encountered an error.\";\n  }\n\n  const errorData = rawError.data;\n  if (errorData && typeof errorData === \"object\") {\n    if (\n      \"message\" in errorData &&\n      typeof errorData.message === \"string\" &&\n      errorData.message.trim()\n    ) {\n      return `Agent encountered an error: ${errorData.message.trim()}`;\n    }\n  }\n\n  if (typeof rawError.name === \"string\" && rawError.name.trim()) {\n    return `Agent encountered an error: ${rawError.name.trim()}`;\n  }\n\n  return \"Agent encountered an error.\";\n}\n\nexport const OpencodeKit: Plugin = async (input) => {\n  const logger = createLogger();\n  const latestAssistantMessageBySession = new Map<string, string>();\n  const latestAssistantTextByMessage = new Map<string, string>();\n  const lastSpokenMessageBySession = new Map<string, string>();\n\n  return {\n    event: async ({ event }): Promise<void> => {\n      if (event.type === \"message.updated\") {\n        const info = event.properties.info;\n        if (info.role === \"assistant\") {\n          latestAssistantMessageBySession.set(info.sessionID, info.id);\n        }\n        return;\n      }\n\n      if (event.type === \"message.part.updated\") {\n        const part = event.properties.part;\n        if (\n          part.type === \"text\" &&\n          typeof part.messageID === \"string\" &&\n          typeof part.text === \"string\"\n        ) {\n          latestAssistantTextByMessage.set(part.messageID, part.text);\n        }\n        return;\n      }\n\n      if (event.type !== \"session.idle\" && event.type !== \"session.error\") {\n        return;\n      }\n\n      const config = await readConfig();\n      logger.setLevel(config.debug.logLevel);\n\n      if (event.type === \"session.idle\") {\n        const sessionID = event.properties.sessionID;\n        const latestMessageID = latestAssistantMessageBySession.get(sessionID);\n        const lastText = latestMessageID\n          ? (latestAssistantTextByMessage.get(latestMessageID) ?? \"\")\n          : \"\";\n        const previouslySpoken = lastSpokenMessageBySession.get(sessionID);\n\n        if (latestMessageID && previouslySpoken === latestMessageID) {\n          logger.debug(\"idle.skip_duplicate\", \"Skipping duplicate idle speech\", {\n            sessionID,\n            messageID: latestMessageID,\n          });\n          return;\n        }\n\n        if (!latestMessageID || !lastText) {\n          logger.warn(\"idle.no_summary\", \"No cached assistant summary for idle event\", {\n            sessionID,\n            hasMessageID: Boolean(latestMessageID),\n            hasText: Boolean(lastText),\n          });\n          await notifyIdle(\"\", config, logger);\n          return;\n        }\n\n        lastSpokenMessageBySession.set(sessionID, latestMessageID);\n        await notifyIdle(lastText, config, logger);\n        return;\n      }\n\n      await notifyError(getErrorMessage(event), config, logger);\n    },\n  };\n};\n\nexport default OpencodeKit;\n"],"mappings":"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","names":["mkdir","homedir","path"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@akonwi/opencode-kit",
+  "version": "0.1.0",
+  "description": "Personal OpenCode workflow plugin with bells, speech, and runtime toggles",
+  "type": "module",
+  "main": "./dist/plugin.js",
+  "types": "./dist/plugin.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/plugin.js",
+      "types": "./dist/plugin.d.ts"
+    }
+  },
+  "bin": {
+    "oc-kit": "./dist/cli.js"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "check": "bun run lint && bun run build"
+  },
+  "keywords": ["opencode", "plugin", "notifications", "speech"],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.1.64"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "@types/node": "^22.13.4",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "packageManager": "bun@1.2.16"
+}