synapsexcoder 6.0.0

package/dist/plugin/opencode-plugin.js

@@ -0,0 +1,119 @@
+/**
+ * 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 { 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 = null;
+/**
+ * Get the current PluginInput if the plugin is loaded inside OpenCode.
+ * Returns null when running standalone (e.g. CLI mode).
+ */
+export function getPluginInput() {
+    return _pluginInput;
+}
+/**
+ * SynapseXcoder Plugin — registers agents, instructions, native tools,
+ * shell environment, and TUI integration.
+ */
+export const plugin = async (input) => {
+    _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 = {
+        /**
+         * 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;
+            const skills = (cfg.skills ??= { paths: [] });
+            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;
+//# sourceMappingURL=opencode-plugin.js.map

package/dist/plugin/opencode-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-plugin.js","sourceRoot":"","sources":["../../src/plugin/opencode-plugin.ts"],"names":[],"mappings":"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"}

package/dist/plugins/plugin-system.d.ts

@@ -0,0 +1,108 @@
+/** Plugin System */
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    description: string;
+    author: string;
+    type: "agent" | "command" | "tool" | "context" | "knowledge" | "mixed";
+    entryPoint: string;
+    dependencies?: string[];
+    permissions?: string[];
+    config?: Record<string, unknown>;
+}
+/**
+ * The required contract every loaded plugin module must satisfy.
+ * Both `activate` and `deactivate` are mandatory; type-specific hooks
+ * are optional so the same interface covers all plugin types.
+ */
+export interface PluginModule {
+    /** Called once when the plugin is loaded and enabled. */
+    activate(context: PluginContext): void | Promise<void>;
+    /** Called once when the plugin is disabled or the host shuts down. */
+    deactivate(): void | Promise<void>;
+    /** agent plugins: handle a raw prompt and return a response. */
+    handlePrompt?: (prompt: string) => string | Promise<string>;
+    /** command plugins: map of command names → handler functions. */
+    commands?: Record<string, (...args: unknown[]) => unknown>;
+    /** tool plugins: map of tool names → tool implementations. */
+    tools?: Record<string, unknown>;
+    /** context plugins: supply additional context to the pipeline. */
+    getContext?: () => Record<string, unknown> | Promise<Record<string, unknown>>;
+    /** knowledge plugins: answer knowledge queries. */
+    queryKnowledge?: (query: string) => string | string[] | Promise<string | string[]>;
+}
+export interface Plugin {
+    manifest: PluginManifest;
+    /** The loaded PluginModule, or null when loading failed. */
+    instance: PluginModule | null;
+    enabled: boolean;
+    loadedAt: number;
+    /** Set to "error" when the entry point could not be loaded. */
+    state: "loaded" | "error";
+    /** Populated with the error message when state === "error". */
+    loadError?: string;
+}
+export interface PluginContext {
+    masterAgent: unknown;
+    config: Record<string, unknown>;
+    logger: (message: string) => void;
+    registerCommand?: (name: string, handler: unknown) => void;
+    registerAgent?: (type: string, factory: unknown) => void;
+    registerTool?: (name: string, tool: unknown) => void;
+}
+export declare abstract class BasePlugin {
+    protected context: PluginContext;
+    constructor(context: PluginContext);
+    abstract initialize(): Promise<void>;
+    abstract shutdown(): Promise<void>;
+    abstract getCapabilities(): string[];
+}
+export declare class PluginManager {
+    private pluginsDir;
+    private plugins;
+    constructor(projectRoot: string, _masterAgent: unknown);
+    private loadPluginFiles;
+    listPlugins(): Plugin[];
+    getPlugin(pluginId: string): Plugin | undefined;
+    enablePlugin(pluginId: string): boolean;
+    disablePlugin(pluginId: string): boolean;
+    getStats(): {
+        total: number;
+        enabled: number;
+        disabled: number;
+        errored: number;
+        byType: Record<string, number>;
+    };
+    /**
+     * Return a complete, valid TypeScript plugin template for the given type.
+     *
+     * Every template:
+     *  - Implements the `PluginModule` interface contract
+     *  - Includes JSDoc on every method
+     *  - Has realistic example logic for the type's primary hook
+     *  - Ends with an `export default` statement
+     */
+    createPluginTemplate(type: PluginManifest["type"]): string;
+    /**
+     * Generate a complete plugin scaffold for a new plugin.
+     *
+     * Returns every file needed to publish and use the plugin:
+     * - `code`        — the plugin's main TypeScript entry point
+     * - `packageJson` — a ready-to-publish `package.json` object
+     * - `readme`      — a Markdown README
+     * - `testFile`    — a Vitest test stub covering activate/deactivate
+     * - `tsConfig`    — a minimal `tsconfig.json` for building the plugin
+     * - `manifest`    — the `PluginManifest` object (also written to disk)
+     */
+    createPluginScaffold(type: PluginManifest["type"], name: string): {
+        manifest: PluginManifest;
+        code: string;
+        packageJson: Record<string, unknown>;
+        readme: string;
+        testFile: string;
+        tsConfig: Record<string, unknown>;
+    };
+}
+export declare function createPluginManager(projectRoot: string, masterAgent: unknown): PluginManager;
+//# sourceMappingURL=plugin-system.d.ts.map

package/dist/plugins/plugin-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-system.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-system.ts"],"names":[],"mappings":"AAAA,oBAAoB;AAMpB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,sEAAsE;IACtE,UAAU,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IAC3D,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9E,mDAAmD;IACnD,cAAc,CAAC,EAAE,CACf,KAAK,EAAE,MAAM,KACV,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,cAAc,CAAC;IACzB,4DAA4D;IAC5D,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACzD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACtD;AAED,8BAAsB,UAAU;IAClB,SAAS,CAAC,OAAO,EAAE,aAAa;gBAAtB,OAAO,EAAE,aAAa;IAC5C,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAClC,QAAQ,CAAC,eAAe,IAAI,MAAM,EAAE;CACrC;AAyDD,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAA6B;gBAEhC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO;IAOtD,OAAO,CAAC,eAAe;IA8DvB,WAAW,IAAI,MAAM,EAAE;IAIvB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOvC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOxC,QAAQ,IAAI;QACV,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAChC;IAkBD;;;;;;;;OAQG;IACH,oBAAoB,CAAC,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,MAAM;IAkS1D;;;;;;;;;;OAUG;IACH,oBAAoB,CAClB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,EAC5B,IAAI,EAAE,MAAM,GACX;QACD,QAAQ,EAAE,cAAc,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC;CAySF;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,OAAO,GACnB,aAAa,CAEf"}