@amsterdamdatalabs/enact-extensions 0.1.42 → 0.1.48

package/dist/create/opencode.d.ts

@@ -0,0 +1,129 @@
+import type { PluginManifest } from "../internal/types.js";
+/**
+ * Derive the OpenCode descriptor (`.opencode-plugin/plugin.json`) from the
+ * canonical Enact manifest. OpenCode has no documented plugin manifest file of
+ * its own — this descriptor is Enact-internal bookkeeping (validated by
+ * spec/opencode.json) that records project metadata plus the canonical
+ * `hooks`/`mcpServers` SOURCE PATHS (not their resolved content). A future
+ * installer reads those paths, loads the referenced JSON, and calls
+ * {@link deriveOpenCodeMcp} / {@link deriveOpenCodePlugin} to generate the
+ * real OpenCode artifacts: a root `opencode.json` MCP fragment and a
+ * `.opencode/plugins/<name>.ts` file.
+ */
+export declare function deriveOpenCodeManifest(enact: PluginManifest): PluginManifest;
+export interface OpenCodeLocalMcpServer {
+    type: "local";
+    command: string[];
+    environment?: Record<string, string>;
+    cwd?: string;
+    enabled: true;
+}
+/**
+ * Project a canonical `.mcp.json` document
+ * (`{mcpServers:{name:{command,args,env,cwd?}}}`) into OpenCode's root
+ * `opencode.json` MCP fragment.
+ *
+ * Source (verified 2026-09-14, this session): https://opencode.ai/docs —
+ * OpenCode MCP servers are declared directly under `"mcp"` in `opencode.json`
+ * as `{"<name>": {"type":"local", "command":["cmd", ...args],
+ * "environment": {...}, "cwd": "...", "enabled": true}}`. There is no
+ * `servers` wrapper (unlike the canonical `mcpServers` key) and no `disabled`
+ * key — OpenCode uses `enabled` and we always emit `enabled: true` for a
+ * server the canonical manifest declares (a disabled server simply would not
+ * be declared).
+ *
+ * Servers without a `command` (e.g. a remote/HTTP-only definition) have no
+ * documented OpenCode "local" equivalent here and are skipped rather than
+ * guessed at.
+ */
+export declare function deriveOpenCodeMcp(canonicalMcp: unknown): {
+    mcp: Record<string, OpenCodeLocalMcpServer>;
+};
+/**
+ * Project a canonical matcher (e.g. `"Bash"`, or
+ * `"Write|Edit|MultiEdit|StrReplace|str_replace_editor|..."`) into an
+ * OpenCode-tool-id alternation (e.g. `"bash"`, `"write|edit"`), deduping
+ * repeated targets. A token with no known canonical mapping is kept
+ * (lowercased) as a passthrough rather than dropped -- combined with the
+ * case-insensitive ANCHORED matching {@link emitToolMethod} generates, this
+ * is a safety net that still matches an already-OpenCode-shaped or unknown
+ * matcher instead of silently never firing.
+ */
+export declare function projectMatcherToOpenCode(matcher: string): string;
+/**
+ * Return canonical hook events that declare active commands but have no
+ * documented OpenCode equivalent in {@link OPENCODE_HOOK_EVENT_MAP} AND no
+ * entry in {@link OPENCODE_HOOK_EVENT_FALLBACK} (a fallback-projected event
+ * is not "unmapped" — see {@link fallbackOpenCodeHookEvents}).
+ */
+export declare function unmappedOpenCodeHookEvents(canonicalHooks: unknown): string[];
+/** One canonical event projected via {@link OPENCODE_HOOK_EVENT_FALLBACK}. */
+export interface OpenCodeHookFallback {
+    /** The canonical event with no direct OpenCode equivalent (e.g. "SessionEnd"). */
+    from: string;
+    /** The canonical event whose OpenCode handler it was folded into (e.g. "SessionIdle"). */
+    to: string;
+}
+/**
+ * Return the canonical hook events projected via
+ * {@link OPENCODE_HOOK_EVENT_FALLBACK} that declare active commands — e.g.
+ * `[{from:"SessionEnd", to:"SessionIdle"}]`. These are NOT reported by
+ * {@link unmappedOpenCodeHookEvents}: they run, just on a substitute event.
+ */
+export declare function fallbackOpenCodeHookEvents(canonicalHooks: unknown): OpenCodeHookFallback[];
+/** Input to {@link deriveOpenCodePlugin}: the three canonical bundle sources a generated OpenCode plugin carries. */
+export interface OpenCodePluginSource {
+    /** Canonical hooks.json document, i.e. `{hooks:{EventName:[...]}}`. */
+    hooks?: unknown;
+    /** Canonical .mcp.json document, i.e. `{mcpServers:{name:{command,args,env,cwd?}}}`. */
+    mcpServers?: unknown;
+    /**
+     * Plugin-relative path to the bundle's skills directory (e.g. `"./skills"`),
+     * if the bundle has one. Resolved at runtime as `join(directory, skillsDir)`
+     * — `directory` is the OpenCode-supplied project root, never
+     * `${CLAUDE_PLUGIN_ROOT}` (OpenCode does not set that env var).
+     */
+    skillsDir?: string;
+}
+/**
+ * Generate the TypeScript source for a SINGLE OpenCode project plugin
+ * (`.opencode/plugins/<pluginName>.ts`) that carries a bundle's hooks, MCP
+ * servers AND skills together — see the module-level owner-decision comment
+ * above for the live-evidence basis of every mapping choice below.
+ *
+ * Runtime choice: OpenCode plugins run on Bun. This generated file uses
+ * `Bun.spawn` rather than the Bun Shell `$` helper because `Bun.spawn` has a
+ * documented `timeout` + `killSignal` option
+ * (https://bun.com/docs/api/spawn, verified 2026-09-14) needed to honor each
+ * canonical hook command's `timeout` (seconds), and gives direct access to
+ * `stdin`, `exitCode`, `stdout`/`stderr` text.
+ *
+ * Truthful failures: a hook command that crashes (e.g. `Bun.spawn` itself
+ * throws) or exits non-zero for a reason other than a PreToolUse deny is
+ * logged to stderr with the plugin's name — never silently swallowed, and
+ * never treated as a block (fail open). The PreToolUse deny throw itself
+ * happens OUTSIDE any try/catch in the generated code, so it can never be
+ * caught and swallowed by error handling elsewhere in the same method.
+ *
+ * PreToolUse (`tool.execute.before`) deny contract: the configured command
+ * receives `{hook_event_name, tool_name, tool_input, cwd, session_id}` as
+ * JSON on stdin. The call is blocked (the generated hook throws) when the
+ * command exits with code 2, or its stdout parses as JSON with
+ * `hookSpecificOutput.permissionDecision === "deny"`.
+ *
+ * UserPromptSubmit (`chat.message` + `experimental.chat.system.transform`):
+ * the configured command receives `{hook_event_name:"UserPromptSubmit",
+ * prompt, cwd, session_id}` as JSON on stdin. Its `hookSpecificOutput.additionalContext`
+ * (or, failing that, its raw stdout) is stored keyed by session id and
+ * injected into `output.system` the next time `experimental.chat.system.transform`
+ * fires for that same session — see the module comment for why this replaced
+ * a direct `output.parts` push.
+ *
+ * Canonical events with no documented OpenCode equivalent and no fallback are
+ * NOT wired into any hook; call {@link unmappedOpenCodeHookEvents} to get
+ * that list. Events projected via {@link OPENCODE_HOOK_EVENT_FALLBACK} (e.g.
+ * SessionEnd -> SessionIdle) ARE wired in, under their fallback target's
+ * bucket; call {@link fallbackOpenCodeHookEvents} to get that list.
+ */
+export declare function deriveOpenCodePlugin(source: OpenCodePluginSource, pluginName: string): string;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/create/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/create/opencode.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAM3D;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAW5E;AAMD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;CACf;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,OAAO,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAA;CAAE,CAiCxG;AAgJD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYhE;AA2DD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAS5E;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,cAAc,EAAE,OAAO,GAAG,oBAAoB,EAAE,CAO1F;AA2JD,qHAAqH;AACrH,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wFAAwF;IACxF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyO7F"}