@webpresso/opencode-plugin 3.1.3

package/LICENSE

@@ -0,0 +1,104 @@
+Elastic License 2.0
+===================
+
+Copyright (c) 2026 Webpresso, Inc.
+
+Acceptance
+----------
+
+By using the software, you agree to all of the terms and conditions below.
+
+Copyright License
+-----------------
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject
+to the limitations and conditions below.
+
+Limitations
+-----------
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key
+functionality in the software, and you may not remove or obscure any
+functionality in the software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other
+notices of the licensor in the software. Any use of the licensor's trademarks
+is subject to applicable law.
+
+Patents
+-------
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software.
+
+If you or your company make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license for the software
+granted under these terms ends immediately. If your company makes such a claim,
+your patent license ends immediately for work on behalf of your company.
+
+Notices
+-------
+
+You must ensure that anyone who gets a copy of any part of the software from
+you also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+No Other Rights
+---------------
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+Termination
+-----------
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+No Liability
+------------
+
+As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.
+
+Definitions
+-----------
+
+The licensor is the entity offering these terms, and the software is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+you refers to the individual or entity agreeing to these terms.
+
+your company is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that organization.
+control means ownership of substantially all the assets of an entity, or the
+power to direct its management and policies by vote, contract, or otherwise.
+Control can be direct or indirect.
+
+your licenses are all the licenses granted to you for the software under these
+terms.
+
+use means anything you do with the software requiring one of your licenses.
+
+trademark means trademarks, service marks, and similar rights.

package/README.md

@@ -0,0 +1,11 @@
+# @webpresso/opencode-plugin
+
+`@webpresso/opencode-plugin` is the OpenCode host adapter package for Agent
+Kit. It provides the native OpenCode npm plugin surface, registered through
+`opencode.json`, with the package module exports and metadata OpenCode expects.
+
+The root `@webpresso/agent-kit` package is CLI/core only: it ships `wp`, MCP
+tools, audits, blueprints, session memory, docs, and catalog sources, but it
+does not ship this OpenCode payload from the root package. OpenCode delivery is
+native npm plugin registration only; there is no generated bridge, MCP bridge,
+or MCP injection payload in this package.

package/index.js

@@ -0,0 +1,209 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+
+const SESSION_START_HOOKS = ["sessionstart-routing"];
+const PRE_TOOL_HOOKS = ["pretool-guard"];
+const POST_TOOL_HOOKS = ["post-tool"];
+
+function extractAdditionalContext(envelope) {
+  return envelope?.hookSpecificOutput?.additionalContext ?? null;
+}
+
+function extractDenyReason(envelope) {
+  const output = envelope?.hookSpecificOutput;
+  if (output?.permissionDecision === "deny") {
+    return output.permissionDecisionReason ?? "webpresso denied this tool call";
+  }
+
+  return null;
+}
+
+function hookInputForTool(tool, args, directory) {
+  const base = {
+    cwd: directory,
+    hook_event_name: "PreToolUse",
+  };
+
+  switch (tool) {
+    case "bash":
+      return {
+        ...base,
+        tool_name: "Bash",
+        tool_input: {
+          command: args?.command ?? "",
+        },
+      };
+    case "write":
+      return {
+        ...base,
+        tool_name: "Write",
+        tool_input: {
+          file_path: args?.filePath ?? "",
+          content: args?.content ?? "",
+        },
+      };
+    case "edit":
+      return {
+        ...base,
+        tool_name: "Edit",
+        tool_input: {
+          file_path: args?.filePath ?? "",
+          old_string: args?.oldString ?? "",
+          new_string: args?.newString ?? "",
+        },
+      };
+    case "read":
+      return {
+        ...base,
+        tool_name: "Read",
+        tool_input: {
+          file_path: args?.filePath ?? "",
+        },
+      };
+    case "apply_patch":
+      return {
+        ...base,
+        tool_name: "Write",
+        tool_input: {
+          patch_text: args?.patchText ?? "",
+        },
+      };
+    default:
+      return null;
+  }
+}
+
+function shellQuote(value) {
+  return `'${String(value).replaceAll("'", "'\\''")}'`;
+}
+
+async function resolveWpHookCommand($, directory, hookName) {
+  const repoLauncher = join(directory, "bin", process.platform === "win32" ? "wp.cmd" : "wp");
+  const candidates = [process.env.WEBPRESSO_WP_BIN, repoLauncher].filter(Boolean);
+
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return `${shellQuote(candidate)} hook ${hookName}`;
+    }
+  }
+
+  const found = await $`command -v wp`.cwd(directory).quiet().nothrow();
+  const resolved = found.stdout?.toString().trim().split(/\r?\n/u)[0] ?? "";
+  if ((found.exitCode === undefined || found.exitCode === 0) && resolved.length > 0) {
+    return `${shellQuote(resolved)} hook ${hookName}`;
+  }
+
+  throw new Error(
+    "webpresso wp launcher not found; run wp setup after installing @webpresso/agent-kit",
+  );
+}
+
+async function runHook($, directory, hookName, payload, options = {}) {
+  const stdinPayload = payload === null ? "" : JSON.stringify(payload);
+  const command = await resolveWpHookCommand($, directory, hookName);
+  const result =
+    await $`printf '%s' ${stdinPayload} | env CLAUDE_PROJECT_DIR=${directory} WP_HOOK_HOST=opencode sh -lc ${command}`
+      .cwd(directory)
+      .quiet()
+      .nothrow();
+
+  const stdout = result.stdout.toString().trim();
+  const stderr = result.stderr?.toString().trim() ?? "";
+  const exitCode = result.exitCode ?? 0;
+  const required = options.required === true;
+
+  if (exitCode !== 0) {
+    if (required) {
+      throw new Error(
+        `webpresso hook ${hookName} failed with exit ${exitCode}${stderr ? `: ${stderr}` : ""}`,
+      );
+    }
+    return null;
+  }
+
+  if (stdout === "") {
+    if (required) {
+      throw new Error(`webpresso hook ${hookName} produced no JSON response`);
+    }
+    return null;
+  }
+
+  try {
+    return JSON.parse(stdout);
+  } catch (error) {
+    if (required) {
+      throw new Error(
+        `webpresso hook ${hookName} produced invalid JSON${stderr ? `: ${stderr}` : ""}`,
+        { cause: error },
+      );
+    }
+    return null;
+  }
+}
+
+async function collectSessionStartContext($, directory) {
+  const contexts = [];
+
+  for (const hookName of SESSION_START_HOOKS) {
+    const envelope = await runHook($, directory, hookName, null);
+    const message = extractAdditionalContext(envelope);
+    if (message === null) {
+      continue;
+    }
+
+    contexts.push(message);
+  }
+
+  return contexts;
+}
+
+export const WebpressoHooksPlugin = async ({ $, directory }) => {
+  let cachedSessionContexts = [];
+
+  return {
+    event: async ({ event }) => {
+      if (event?.type === "session.created") {
+        cachedSessionContexts = await collectSessionStartContext($, directory);
+      }
+    },
+    "shell.env": async (input, output) => {
+      output.env.CLAUDE_PROJECT_DIR = input.cwd;
+    },
+    "tool.execute.before": async (input, output) => {
+      const payload = hookInputForTool(input?.tool, output?.args ?? input?.args ?? {}, directory);
+      if (payload === null) {
+        return;
+      }
+
+      for (const hookName of PRE_TOOL_HOOKS) {
+        const envelope = await runHook($, directory, hookName, payload, { required: true });
+        const denyReason = extractDenyReason(envelope);
+        if (denyReason !== null) {
+          throw new Error(denyReason);
+        }
+      }
+    },
+    "tool.execute.after": async (input, output) => {
+      const payload = hookInputForTool(input?.tool, output?.args ?? input?.args ?? {}, directory);
+      if (payload === null) {
+        return;
+      }
+
+      for (const hookName of POST_TOOL_HOOKS) {
+        await runHook($, directory, hookName, payload);
+      }
+    },
+    "experimental.session.compacting": async (_input, output) => {
+      cachedSessionContexts = await collectSessionStartContext($, directory);
+      if (output && Array.isArray(output.context)) {
+        for (const message of cachedSessionContexts) {
+          output.context.push(message);
+        }
+      }
+    },
+  };
+};
+
+const webpressoOpenCodePlugins = [WebpressoHooksPlugin];
+
+export default webpressoOpenCodePlugins;

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@webpresso/opencode-plugin",
+  "version": "3.1.3",
+  "private": false,
+  "description": "OpenCode plugin adapter package for Webpresso agent-kit.",
+  "homepage": "https://github.com/webpresso/agent-kit#readme",
+  "bugs": {
+    "url": "https://github.com/webpresso/agent-kit/issues"
+  },
+  "license": "Elastic-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webpresso/agent-kit.git",
+    "directory": "packages/opencode-plugin"
+  },
+  "files": [
+    "index.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}