opencode-gitlab-plugin 2.8.2 → 3.0.0

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 All notable changes to this project will be documented in this file. See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.0.0](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v2.8.2...v3.0.0) (2026-09-21)
+
+
+### ⚠ BREAKING CHANGES
+
+* the default export is a plugin definition object rather than a
+plugin function. Anything importing the default export and calling it must use
+the named `gitlabPlugin` export instead. OpenCode v1 hosts older than 1.18.29
+do not understand object entrypoints and must stay on 2.x. On OpenCode v2 the
+configuration key is `plugins`, and options move from a tuple to
+`{ "package": "...", "options": { ... } }`; v1's `plugin` key is normalised
+automatically.
+
+### ✨ Features
+
+* support the v2 plugin SDK ([0b0fe45](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/0b0fe4521210820fe4a424499fecaee4d9f55ae6))
+
+
+### 🐛 Bug Fixes
+
+* **ci:** sync lockfile with npm 11.6.2 ([ceb68d7](https://gitlab.com/vglafirov/opencode-gitlab-plugin/commit/ceb68d7229d847070233566661472e43f4cdcc3a))
+
 ## [2.8.2](https://gitlab.com/vglafirov/opencode-gitlab-plugin/compare/v2.8.1...v2.8.2) (2026-09-18)
 
 

package/README.md

@@ -266,6 +266,14 @@ Full example with lazy-mcp configured in opencode (`~/.config/opencode/opencode.
       "command": ["npx", "-y", "lazy-mcp@latest", "--config", "~/.config/lazy-mcp/servers.json"]
     }
   },
+  "plugins": [{ "package": "opencode-gitlab-plugin", "options": { "tools": false } }]
+}
+```
+
+On OpenCode v1, use the legacy tuple form instead:
+
+```json
+{
   "plugin": [["opencode-gitlab-plugin", { "tools": false }]]
 }
 ```
@@ -298,6 +306,16 @@ export GITLAB_INSTANCE_URL=https://gitlab.example.com
 
 Add the following plugin to your opencode configuration `~/.config/opencode/opencode.json`:
 
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugins": ["opencode-gitlab-plugin"]
+}
+```
+
+The package ships both plugin SDK entrypoints, so it also works on OpenCode v1 with the
+legacy `plugin` key:
+
 ```json
 {
   "$schema": "https://opencode.ai/config.json",
@@ -490,9 +508,9 @@ The plugin provides **64 tools** organized into the following categories:
 ### Example 1: Create and Manage Issues
 
 ```javascript
-import gitlabPlugin from 'opencode-gitlab-plugin';
+import { allTools } from 'opencode-gitlab-plugin';
 
-const plugin = await gitlabPlugin({});
+const plugin = { tool: allTools };
 
 // Create a new issue
 const issue = await plugin.tool.gitlab_create_issue.execute({
@@ -782,6 +800,7 @@ await plugin.tool.gitlab_link_vulnerability_to_issue.execute({
 
 ```
 opencode-gitlab-plugin/
+├── index.ts                # Package-root entrypoint for local v2 plugin loading
 ├── src/
 │   ├── client/              # API client modules
 │   │   ├── base.ts         # Base client with HTTP & GraphQL methods
@@ -806,8 +825,12 @@ opencode-gitlab-plugin/
 │   │   ├── repository.ts   # Repository tool definitions
 │   │   ├── discussions-unified.ts # Unified discussion tools (4 tools)
 │   │   ├── notes-unified.ts # Unified notes tools (3 tools)
+│   │   ├── index.ts        # Aggregated tool registries
 │   │   └── ...             # Other tool definitions
-│   ├── index.ts            # Main plugin entry point
+│   ├── v2/                 # Plugin SDK v2 entry point
+│   │   ├── plugin.ts       # Plugin.define({ id, setup })
+│   │   └── tool-adapter.ts # v1 tool definitions -> v2 tool registrations
+│   ├── index.ts            # Main plugin entry point (v2 setup + v1 server)
 │   ├── utils.ts            # Utility functions
 │   └── validation.ts       # GID validation utilities
 ├── tests/                  # Test suite (225 tests)
@@ -863,6 +886,25 @@ npm run format
 npm run format:check
 ```
 
+### Loading a Local Checkout
+
+OpenCode v2 resolves a plugin configured by absolute path by probing
+`<directory>/server` and `<directory>/index` — it does **not** read the package's
+`main`/`exports`. The repository root ships an `index.ts` for exactly this, so point
+the config at the checkout root:
+
+```json
+{
+  "plugins": [{ "package": "/abs/path/to/opencode-gitlab-plugin" }]
+}
+```
+
+This loads `src/` directly, so OpenCode's watcher picks up edits without a rebuild.
+Confirm it loaded with `opencode plugin list` — the `gitlab` plugin should be listed.
+
+A path to a _file_ (for example `.../dist/index.js`) is rejected with
+`configured plugin path must be a directory`.
+
 ### Git Hooks
 
 The project uses Husky for Git hooks:

package/dist/index.d.ts

@@ -1,7 +1,19 @@
-import { Plugin } from '@opencode-ai/plugin';
+import * as _opencode_plugin_promise_plugin from '@opencode/plugin/promise/plugin';
+import { ToolDefinition, Plugin as Plugin$1 } from '@opencode-ai/plugin';
+import { Plugin } from '@opencode/plugin';
 
 /**
- * GitLab Tools Plugin for OpenCode
+ * Tools exposed over the standalone MCP server (`opencode-gitlab-plugin` binary).
+ */
+declare const mcpTools: Record<string, ToolDefinition>;
+/**
+ * Every tool registered by the OpenCode plugin.
+ */
+declare const allTools: Record<string, ToolDefinition>;
+
+declare const PLUGIN_ID = "gitlab";
+/**
+ * GitLab Tools Plugin for OpenCode (plugin SDK v2)
  *
  * Provides tools for interacting with GitLab:
  * - Merge requests: get, list, changes, create, update, commits, pipelines, diffs (paginated), auto-merge
@@ -22,6 +34,26 @@ import { Plugin } from '@opencode-ai/plugin';
  * - Git: execute safe, read-only git commands in repository
  * - Orbit: Knowledge Graph API (status, schema, query, neighbors)
  */
-declare const gitlabPlugin: Plugin;
+declare const gitlabPluginV2: Plugin.Plugin;
+
+/**
+ * GitLab Tools Plugin for OpenCode — legacy (v1) plugin SDK entrypoint.
+ *
+ * Kept so the package keeps working on OpenCode v1. New installs use the v2
+ * `setup()` implementation in `./v2/plugin.ts`.
+ *
+ * @deprecated Use the default export with the v2 plugin SDK.
+ */
+declare const gitlabPlugin: Plugin$1;
+/**
+ * Dual entrypoint: OpenCode v2 calls `setup()`, OpenCode v1 calls `server()`.
+ *
+ * See https://opencode.ai/v2/docs/build/plugins/migrate-v1
+ */
+declare const _default: {
+    server: Plugin$1;
+    id: string;
+    setup: (context: _opencode_plugin_promise_plugin.Context) => Promise<_opencode_plugin_promise_plugin.Cleanup | void> | _opencode_plugin_promise_plugin.Cleanup | void;
+};
 
-export { gitlabPlugin as default, gitlabPlugin };
+export { PLUGIN_ID, allTools, _default as default, gitlabPlugin, gitlabPluginV2, mcpTools };

package/dist/index.js

@@ -5789,45 +5789,139 @@ then use that ID (e.g., 377844873).`,
   })
 };
 
+// src/tools/index.ts
+var mcpTools = {
+  ...mergeRequestTools,
+  ...issueTools,
+  ...epicTools,
+  ...pipelineTools,
+  ...repositoryTools,
+  ...searchTools,
+  ...projectTools,
+  ...userTools,
+  ...securityTools,
+  ...todoTools,
+  ...wikiTools,
+  ...workItemTools,
+  ...discussionsUnifiedTools,
+  ...notesUnifiedTools,
+  ...gitTools,
+  ...auditTools,
+  ...awardEmojiTools
+};
+var allTools = {
+  ...mcpTools,
+  ...orbitTools
+};
+
+// src/v2/plugin.ts
+import { Plugin } from "@opencode/plugin";
+
+// src/v2/tool-adapter.ts
+import { tool as tool19 } from "@opencode-ai/plugin";
+var z19 = tool19.schema;
+function toInputSchema(args) {
+  const schema = z19.toJSONSchema(z19.object(args ?? {}), { io: "input" });
+  delete schema["$schema"];
+  return {
+    type: "object",
+    properties: {},
+    additionalProperties: false,
+    ...schema
+  };
+}
+function toToolResult(result) {
+  if (typeof result === "string") {
+    return { content: result };
+  }
+  const metadata = { ...result.metadata ?? {} };
+  if (result.title !== void 0) metadata["title"] = result.title;
+  if (result.attachments !== void 0) metadata["attachments"] = result.attachments;
+  return {
+    content: result.output,
+    ...Object.keys(metadata).length > 0 ? { metadata } : {}
+  };
+}
+function toLegacyContext(context, directory, worktree) {
+  return {
+    sessionID: context.sessionID,
+    messageID: context.messageID,
+    agent: context.agent,
+    directory,
+    worktree,
+    abort: context.signal,
+    metadata: (update) => void context.progress(update),
+    ask: async () => {
+    }
+  };
+}
+function adaptTool(name, definition, options) {
+  const validator = z19.object(definition.args ?? {});
+  return {
+    name,
+    description: definition.description,
+    input: toInputSchema(definition.args),
+    async execute(input, context) {
+      const parsed = validator.parse(input ?? {});
+      const legacyContext = toLegacyContext(context, options.directory, options.worktree);
+      const result = await definition.execute(
+        parsed,
+        legacyContext
+      );
+      return toToolResult(result);
+    }
+  };
+}
+function adaptTools(tools, options) {
+  return Object.entries(tools).map(([name, definition]) => adaptTool(name, definition, options));
+}
+
+// src/v2/plugin.ts
+var PLUGIN_ID = "gitlab";
+var LAZY_MCP_HINT = `## GitLab Tools via lazy-mcp
+GitLab API tools (MRs, issues, pipelines, security, search, repos, users, todos, work items, discussions, notes, audit, git, award emoji) are served via the "gitlab" MCP server through lazy-mcp. Use lazy-mcp_list_commands with server "gitlab" to discover and call them.
+DAP tools (agents, flows, memory, skills) are on the "gitlab-dap" server instead.`;
+var gitlabPluginV2 = Plugin.define({
+  id: PLUGIN_ID,
+  async setup(ctx) {
+    if (ctx.options["tools"] === false) {
+      await ctx.session.hook("context", (event) => {
+        event.system.push({ type: "text", text: LAZY_MCP_HINT });
+      });
+      return;
+    }
+    const directory = ctx.location.directory;
+    const worktree = ctx.location.project.directory ?? directory;
+    const tools = adaptTools(allTools, { directory, worktree });
+    await ctx.tool.transform((editor) => {
+      for (const definition of tools) {
+        editor.add(definition);
+      }
+    });
+  }
+});
+
 // src/index.ts
 var gitlabPlugin = async (_input, options) => {
-  if (options?.tools === false) {
+  if (options?.["tools"] === false) {
     return {
-      "experimental.chat.system.transform": async (_input2, output) => {
-        output.system.push(
-          `## GitLab Tools via lazy-mcp
-GitLab API tools (MRs, issues, pipelines, security, search, repos, users, todos, work items, discussions, notes, audit, git, award emoji) are served via the "gitlab" MCP server through lazy-mcp. Use lazy-mcp_list_commands with server "gitlab" to discover and call them.
-DAP tools (agents, flows, memory, skills) are on the "gitlab-dap" server instead.`
-        );
+      "experimental.chat.system.transform": async (_hookInput, output) => {
+        output.system.push(LAZY_MCP_HINT);
       }
     };
   }
-  return {
-    tool: {
-      ...mergeRequestTools,
-      ...issueTools,
-      ...epicTools,
-      ...pipelineTools,
-      ...repositoryTools,
-      ...searchTools,
-      ...projectTools,
-      ...userTools,
-      ...securityTools,
-      ...todoTools,
-      ...wikiTools,
-      ...workItemTools,
-      ...discussionsUnifiedTools,
-      ...notesUnifiedTools,
-      ...gitTools,
-      ...auditTools,
-      ...awardEmojiTools,
-      ...orbitTools
-    }
-  };
+  return { tool: allTools };
+};
+var index_default = {
+  ...gitlabPluginV2,
+  server: gitlabPlugin
 };
-var index_default = gitlabPlugin;
 export {
+  PLUGIN_ID,
+  allTools,
   index_default as default,
-  gitlabPlugin
+  gitlabPlugin,
+  gitlabPluginV2,
+  mcpTools
 };
 //# sourceMappingURL=index.js.map