@moreih29/nexus-core 0.12.0 → 0.14.0

package/dist/src/hooks/opencode-mount.js

@@ -0,0 +1,352 @@
+/**
+ * OpenCode plugin adapter — mounts nexus hooks into OpenCode's plugin API.
+ *
+ * 결정 참조: plan.json Issue #1 (3-레이어 책임 분담),
+ *            Issue #3 (OpenCode 2단 처리 — SubagentStart/Stop, agent-tracker),
+ *            Issue #6 (additional_context 주입 우회 — SubagentStop output.output append)
+ */
+import { spawn } from "node:child_process";
+import { mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { updateJsonFileLocked } from "../shared/json-store.js";
+// ---------------------------------------------------------------------------
+// resolveManifestPath — handlerPath absolutizer
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a manifest-relative handlerPath to an absolute filesystem path.
+ *
+ * The manifest JSON lives at dist/manifests/opencode-manifest.json.
+ * This module lives at dist/src/hooks/opencode-mount.js.
+ * We construct the manifest's URL relative to this module, then resolve
+ * the handlerPath relative to that manifest URL.
+ */
+function resolveManifestPath(relPath) {
+    const manifestUrl = new URL("../../manifests/opencode-manifest.json", import.meta.url);
+    return fileURLToPath(new URL(relPath, manifestUrl));
+}
+// ---------------------------------------------------------------------------
+// mountHooks — primary export
+// ---------------------------------------------------------------------------
+/**
+ * Mount nexus hooks into OpenCode's plugin API.
+ *
+ * Returns an object whose keys are OpenCode plugin hook names. Each value is
+ * the async handler function OpenCode calls when the corresponding event fires.
+ *
+ * @param pluginCtx  OpenCode plugin context (must expose `.directory: string`)
+ * @param manifest   Hook manifest produced by build-hooks.ts
+ */
+export function mountHooks(pluginCtx, manifest) {
+    // Resolve all handlerPaths to absolute paths so spawn() works regardless of CWD.
+    const resolvedManifest = {
+        hooks: manifest.hooks.map((h) => ({ ...h, handlerPath: resolveManifestPath(h.handlerPath) })),
+    };
+    // Buffer for additional_context produced by SessionStart / UserPromptSubmit hooks.
+    // Flushed into the system prompt on each LLM call via chat.system.transform.
+    const systemTransformBuffer = [];
+    return {
+        // ------------------------------------------------------------------
+        // session.created → SessionStart
+        // ------------------------------------------------------------------
+        "event": async (input) => {
+            const ev = input;
+            if (ev["event"]?.["type"] !== "session.created") {
+                return;
+            }
+            const sessionEvent = ev["event"];
+            const sessionId = sessionEvent["sessionID"] ?? "";
+            await dispatchEvent("SessionStart", resolvedManifest, {
+                hook_event_name: "SessionStart",
+                session_id: sessionId,
+                cwd: pluginCtx.directory,
+                source: "startup",
+            }, { systemTransformBuffer });
+        },
+        // ------------------------------------------------------------------
+        // chat.message → UserPromptSubmit
+        // ------------------------------------------------------------------
+        "chat.message": async (input) => {
+            const msg = input;
+            const sessionId = msg["sessionID"] ?? "";
+            const prompt = msg["message"] ?? "";
+            await dispatchEvent("UserPromptSubmit", resolvedManifest, {
+                hook_event_name: "UserPromptSubmit",
+                session_id: sessionId,
+                cwd: pluginCtx.directory,
+                prompt,
+            }, { systemTransformBuffer });
+        },
+        // ------------------------------------------------------------------
+        // tool.execute.before → PreToolUse  (or SubagentStart when tool=task)
+        // ------------------------------------------------------------------
+        "tool.execute.before": async (input, output) => {
+            const inp = input;
+            const out = output;
+            const sessionId = inp["sessionID"] ?? "";
+            const toolName = inp["tool"] ?? "";
+            const isTask = toolName === "task";
+            const args = out["args"] ?? {};
+            if (isTask) {
+                await dispatchEvent("SubagentStart", resolvedManifest, {
+                    hook_event_name: "SubagentStart",
+                    session_id: sessionId,
+                    cwd: pluginCtx.directory,
+                    // agent_id is unknown until tool.execute.after resolves the subagent session
+                    agent_id: "",
+                    agent_type: args["subagent_type"] ?? "",
+                }, { outputArgsRef: args });
+            }
+            else {
+                await dispatchEvent("PreToolUse", resolvedManifest, {
+                    hook_event_name: "PreToolUse",
+                    session_id: sessionId,
+                    cwd: pluginCtx.directory,
+                    tool_name: normalizeOpenCodeToolName(toolName),
+                    tool_input: args,
+                }, { outputArgsRef: args });
+            }
+        },
+        // ------------------------------------------------------------------
+        // tool.execute.after → PostToolUse  (or SubagentStop when tool=task)
+        // ------------------------------------------------------------------
+        "tool.execute.after": async (input, output) => {
+            const inp = input;
+            const out = output;
+            const sessionId = inp["sessionID"] ?? "";
+            const toolName = inp["tool"] ?? "";
+            const isTask = toolName === "task";
+            const args = out["args"] ?? {};
+            const metadata = out["metadata"] ?? {};
+            const agentId = metadata["sessionId"] ?? "";
+            if (isTask) {
+                // Register / update agent-tracker before dispatching SubagentStop
+                await upsertAgentTracker(pluginCtx.directory, sessionId, agentId, args["subagent_type"] ?? "");
+                await dispatchEvent("SubagentStop", resolvedManifest, {
+                    hook_event_name: "SubagentStop",
+                    session_id: sessionId,
+                    cwd: pluginCtx.directory,
+                    agent_id: agentId,
+                    agent_type: args["subagent_type"] ?? "",
+                    last_assistant_message: out["output"] ?? "",
+                }, 
+                // additional_context appended to output.output (bypass #6)
+                { outputOutputRef: out });
+            }
+            else {
+                await dispatchEvent("PostToolUse", resolvedManifest, {
+                    hook_event_name: "PostToolUse",
+                    session_id: sessionId,
+                    cwd: pluginCtx.directory,
+                    tool_name: normalizeOpenCodeToolName(toolName),
+                    tool_input: args,
+                    tool_response: out["output"] ?? "",
+                }, {});
+            }
+        },
+        // ------------------------------------------------------------------
+        // experimental.chat.system.transform — flush buffer into system prompt
+        // ------------------------------------------------------------------
+        "experimental.chat.system.transform": async (_input, output) => {
+            const out = output;
+            if (!Array.isArray(out.system))
+                return;
+            while (systemTransformBuffer.length > 0) {
+                out.system.push(systemTransformBuffer.shift());
+            }
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// dispatchEvent
+// ---------------------------------------------------------------------------
+async function dispatchEvent(nexusEventName, manifest, nexusInput, sideEffects) {
+    // Sort hooks by priority (ascending) so lower numbers run first
+    const candidates = manifest.hooks
+        .filter((h) => h.events.includes(nexusEventName))
+        .sort((a, b) => a.priority - b.priority);
+    for (const hook of candidates) {
+        const toolOrSource = nexusInput["tool_name"] ??
+            nexusInput["source"] ??
+            "";
+        if (!matchesPattern(hook.matcher, toolOrSource))
+            continue;
+        const timeoutMs = (hook.timeout ?? 30) * 1000;
+        const result = await spawnHandler(hook.handlerPath, nexusInput, timeoutMs);
+        if (result == null)
+            continue;
+        applyResult(result, nexusEventName, sideEffects);
+    }
+}
+// ---------------------------------------------------------------------------
+// spawnHandler
+// ---------------------------------------------------------------------------
+async function spawnHandler(handlerPath, nexusInput, timeoutMs) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn("node", [handlerPath], {
+                env: { ...process.env, NEXUS_HARNESS: "opencode" },
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+        }
+        catch {
+            // spawn itself threw (e.g. node not found) — silent
+            resolve(null);
+            return;
+        }
+        let stdout = "";
+        let timedOut = false;
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill();
+            }
+            catch {
+                // ignore
+            }
+            resolve(null);
+        }, timeoutMs);
+        if (!child.stdout || !child.stdin) {
+            clearTimeout(timer);
+            resolve(null);
+            return;
+        }
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stdin.write(JSON.stringify(nexusInput));
+        child.stdin.end();
+        child.on("exit", () => {
+            clearTimeout(timer);
+            if (timedOut)
+                return;
+            try {
+                resolve(stdout ? JSON.parse(stdout) : null);
+            }
+            catch {
+                resolve(null);
+            }
+        });
+        child.on("error", () => {
+            clearTimeout(timer);
+            resolve(null); // spawn failure — silent, keep OpenCode turn alive
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// applyResult — convert nexus output to OpenCode API side effects
+// ---------------------------------------------------------------------------
+function applyResult(result, nexusEventName, sideEffects) {
+    // decision:block → throw (OpenCode sees an error and halts the turn)
+    if (result["decision"] === "block") {
+        const reason = result["block_reason"] ?? "Blocked by nexus hook";
+        throw new Error(reason);
+    }
+    // continue:false → throw
+    if (result["continue"] === false) {
+        const msg = result["system_message"] ?? "Hook requested stop";
+        throw new Error(msg);
+    }
+    // additional_context
+    const additionalContext = result["additional_context"];
+    if (additionalContext) {
+        if (nexusEventName === "SessionStart" || nexusEventName === "UserPromptSubmit") {
+            // Push to system.transform buffer
+            sideEffects.systemTransformBuffer?.push(additionalContext);
+        }
+        else if (nexusEventName === "SubagentStart") {
+            // Prepend to args.prompt so the subagent receives the context
+            if (sideEffects.outputArgsRef) {
+                const existing = sideEffects.outputArgsRef["prompt"] ?? "";
+                sideEffects.outputArgsRef["prompt"] = additionalContext + "\n\n" + existing;
+            }
+        }
+        else if (nexusEventName === "SubagentStop") {
+            // Append to output.output (bypass #6)
+            if (sideEffects.outputOutputRef) {
+                const existing = sideEffects.outputOutputRef["output"] ?? "";
+                sideEffects.outputOutputRef["output"] = existing + "\n\n" + additionalContext;
+            }
+        }
+    }
+    // updated_input → mutate output.args (PreToolUse only)
+    const updatedInput = result["updated_input"];
+    if (updatedInput && nexusEventName === "PreToolUse" && sideEffects.outputArgsRef) {
+        Object.assign(sideEffects.outputArgsRef, updatedInput);
+    }
+}
+// ---------------------------------------------------------------------------
+// upsertAgentTracker
+// ---------------------------------------------------------------------------
+async function upsertAgentTracker(cwd, sessionId, agentId, agentType) {
+    if (!agentId)
+        return; // agent_id not yet resolved — skip silently
+    const trackerPath = join(cwd, ".nexus", "state", sessionId, "agent-tracker.json");
+    try {
+        mkdirSync(dirname(trackerPath), { recursive: true });
+        await updateJsonFileLocked(trackerPath, [], (tracker) => {
+            const existing = tracker.find((e) => e.agent_id === agentId);
+            if (!existing) {
+                tracker.push({
+                    agent_id: agentId,
+                    agent_type: agentType,
+                    started_at: new Date().toISOString(),
+                    resume_count: 0,
+                    status: "running",
+                });
+            }
+            else {
+                existing.resume_count = (existing.resume_count ?? 0) + 1;
+                existing.last_resumed_at = new Date().toISOString();
+            }
+            return tracker;
+        });
+    }
+    catch {
+        // tracker update failure must never disrupt the OpenCode turn
+    }
+}
+/**
+ * Test whether a nexus matcher pattern matches the given value.
+ * Pattern "*" matches everything.
+ * Otherwise the pattern is treated as a pipe-separated list of literals
+ * (e.g. "Read|Write|Edit") or a simple regex.
+ */
+function matchesPattern(pattern, value) {
+    if (pattern === "*")
+        return true;
+    // Try literal pipe-separated list first (most common case)
+    const literals = pattern.split("|");
+    if (literals.every((l) => /^[A-Za-z0-9_-]+$/.test(l))) {
+        return literals.includes(value);
+    }
+    // Fall back to regex
+    try {
+        return new RegExp(pattern).test(value);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Normalize OpenCode lowercase tool names to nexus PascalCase equivalents.
+ * OpenCode uses snake_case/lowercase internally; nexus standard is PascalCase.
+ */
+function normalizeOpenCodeToolName(name) {
+    const aliasMap = {
+        read: "Read",
+        edit: "Edit",
+        write: "Write",
+        bash: "Bash",
+        glob: "Glob",
+        grep: "Grep",
+        ls: "LS",
+        task: "Task",
+        web_fetch: "WebFetch",
+        web_search: "WebSearch",
+        patch: "Edit",
+    };
+    return aliasMap[name] ?? name;
+}
+//# sourceMappingURL=opencode-mount.js.map

package/dist/src/hooks/opencode-mount.js.map

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

package/dist/src/hooks/runtime.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Nexus Hook shell wrapper entry — reads stdin, normalizes for harness,
+ * dispatches to handler, and serializes stdout per NEXUS_HARNESS.
+ *
+ * 결정 참조: plan.json Issue #1 (3-레이어 책임 분담),
+ *            Issue #3 (Bash parse patterns), Issue #4 (Codex tool aliases)
+ */
+import type { NexusHookInput, NexusHookOutput } from "./types.js";
+export interface RunWrapperOptions {
+    /** Absolute path to the compiled handler .js file. */
+    handlerPath: string;
+    /** Optional absolute path to meta.yml; enables condition.state_file_exists check. */
+    metaPath?: string;
+}
+export declare function runWrapper(options: RunWrapperOptions): Promise<void>;
+export interface ParsedBashCommand {
+    tool: string;
+    target?: string;
+}
+/** Parse a Bash command string into a nexus standard tool name.
+ *  Returns null when the command is a compound/piped command or unrecognised. */
+export declare function parseBashCommand(command: string): ParsedBashCommand | null;
+/** Map Codex native tool aliases to nexus PascalCase equivalents. */
+declare function normalizeCodexToolName(name: string): string;
+/** When tool_name is "Bash" and tool_input.command is present, attempt to
+ *  resolve a more specific nexus standard tool_name via bash_parse_patterns. */
+declare function normalizeBashToolName(input: NexusHookInput, _harness: string): NexusHookInput;
+declare function serializeForClaude(out: NexusHookOutput, eventName: string): Record<string, unknown>;
+declare function serializeForCodex(out: NexusHookOutput, eventName: string): Record<string, unknown>;
+export declare const __test: {
+    serializeForClaude: typeof serializeForClaude;
+    serializeForCodex: typeof serializeForCodex;
+    normalizeBashToolName: typeof normalizeBashToolName;
+    normalizeCodexToolName: typeof normalizeCodexToolName;
+};
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/src/hooks/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/hooks/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAU/E,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC1E;AAMD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;iFACiF;AACjF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAiB1E;AAqFD,qEAAqE;AACrE,iBAAS,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBpD;AAED;gFACgF;AAChF,iBAAS,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAatF;AA2CD,iBAAS,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2B5F;AAED,iBAAS,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyB3F;AAmBD,eAAO,MAAM,MAAM;;;;;CAKlB,CAAC"}