synapsexcoder 6.0.0

package/src/plugin/opencode-plugin.ts

@@ -0,0 +1,141 @@
+/**
+ * SynapseXcoder — OpenCode TUI & CLI Plugin Entry Point
+ *
+ * When this package is installed as an OpenCode plugin (e.g. "@synapsexcoder/synapsexcoder"),
+ * this entry registers all 13+ SynapseXcoder V6 agents, their instruction prompts,
+ * native tools, shell environment, and TUI integration hooks.
+ *
+ * Architecture:
+ *   - Acts as OpenCode Plugin (via @opencode-ai/plugin SDK v1.15.12)
+ *   - Provides `hooks.tool` with 5 native tool definitions (synapse-analyze, synapse-search,
+ *     synapse-fetch, synapse-agent, synapse-session) registered via `tool()` from @opencode-ai/plugin/tool
+ *   - Hooks: config, tool, shell.env, chat.message, dispose
+ *   - tool-bridge.ts consumers can call setPluginInput() to use BunShell + client
+ *     instead of spawning opencode as subprocess
+ *
+ * Pattern follows @lyculs/opencode-firecrawl plugin architecture.
+ *
+ * @see https://opencode.ai/docs/plugins
+ */
+
+import type { Plugin, Hooks, PluginInput } from "@opencode-ai/plugin";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { nativeTools } from "./native-tools.js";
+import { OpenCodeToolBridge } from "../synapsexcoder/tool-bridge.js";
+
+const current_dir = dirname(fileURLToPath(import.meta.url));
+const agents_dir = join(current_dir, "..", "..", "opencode-agents");
+
+// Store PluginInput for tool-bridge to use when available
+let _pluginInput: PluginInput | null = null;
+
+/**
+ * Get the current PluginInput if the plugin is loaded inside OpenCode.
+ * Returns null when running standalone (e.g. CLI mode).
+ */
+export function getPluginInput(): PluginInput | null {
+  return _pluginInput;
+}
+
+/**
+ * SynapseXcoder Plugin — registers agents, instructions, native tools,
+ * shell environment, and TUI integration.
+ */
+export const plugin: Plugin = async (input: PluginInput) => {
+  _pluginInput = input;
+
+  // If a tool-bridge instance exists, feed it the PluginInput
+  // so it can use BunShell + client instead of spawn.
+  OpenCodeToolBridge.setPluginInput(input);
+
+  const hooks: Hooks = {
+    /**
+     * Dispose hook: clean up when the plugin is unloaded.
+     */
+    async dispose() {
+      _pluginInput = null;
+      OpenCodeToolBridge.setPluginInput(null);
+    },
+
+    /**
+     * Config hook: registers agent prompt files, instructions, and skills.
+     */
+    async config(config) {
+      // Ensure arrays exist
+      config.instructions ??= [];
+
+      // Register all synapse agent prompt files
+      const agent_files = [
+        "synapse-master.md",
+        "synapse-planner.md",
+        "synapse-analyzer.md",
+        "synapse-reviewer.md",
+        "synapse-rewriter.md",
+        "synapse-ui-designer.md",
+        "synapse-researcher.md",
+        "synapse-strategist.md",
+        "synapse-gatekeeper.md",
+        "synapse-verifier.md",
+        "synapse-debugger.md",
+        "synapse-diff-validator.md",
+        "synapse-test-runner.md",
+      ];
+
+      for (const agent_file of agent_files) {
+        config.instructions.push(join(agents_dir, agent_file));
+      }
+
+      // Register skills directory if exists
+      // skills is an internal OpenCode config field not in public types
+      const cfg = config as Record<string, unknown>;
+      const skills = (cfg.skills ??= { paths: [] as string[] }) as { paths: string[] };
+      skills.paths.push(join(current_dir, "..", "..", ".opencode", "skills"));
+      skills.paths.push(join(current_dir, "..", "..", ".opencode", "skills", "shell-strategy"));
+    },
+
+    /**
+     * Tool hook: register all 5 native SynapseXcoder tools.
+     * These are surfaced to OpenCode agents as callable tools.
+     */
+    tool: nativeTools,
+
+    /**
+     * Shell environment: pass through relevant env vars.
+     * Uses the BunShell instance from PluginInput.$ when available.
+     */
+    "shell.env": async (_input, output) => {
+      // Pass through SynapseXcoder configuration
+      if (process.env.SYNAPSE_CONFIG_PATH) {
+        output.env.SYNAPSE_CONFIG_PATH = process.env.SYNAPSE_CONFIG_PATH;
+      }
+      if (process.env.SYNAPSE_LOG_LEVEL) {
+        output.env.SYNAPSE_LOG_LEVEL = process.env.SYNAPSE_LOG_LEVEL;
+      }
+
+      // Detect standalone vs. plugin mode
+      output.env.SYNAPSE_PLUGIN_MODE = _pluginInput ? "plugin" : "standalone";
+
+      // Add the node_modules .bin to PATH for npm/npx access
+      const localBin = join(
+        _pluginInput?.directory || process.cwd(),
+        "node_modules",
+        ".bin",
+      );
+      output.env.PATH = `${localBin}:${process.env.PATH || ""}`;
+    },
+
+    /**
+     * Chat message hook: monitor messages for SynapseXcoder agent routing.
+     * When a message targets a synapse-* agent, route accordingly.
+     */
+    "chat.message": async (_input, _output) => {
+      // Future: intercept messages targeting synapse-* agents for
+      // custom routing logic or pre/post processing.
+    },
+  };
+
+  return hooks;
+};
+
+export default plugin;