opencode-gitlab-dap 1.5.1 → 1.6.1

package/README.md

@@ -91,7 +91,26 @@ The plugin guides you through an interactive workflow:
 
 The `confirmed` parameter on `gitlab_create_agent` enforces the interactive workflow — the tool returns instructions instead of creating the agent when called without explicit confirmation.
 
-### 17 DAP Tools
+### Custom Flow Creation
+
+Design and create custom flows interactively:
+
+```
+Create a flow that fetches MR data, analyzes the changes, and posts a summary comment
+```
+
+The plugin provides a multi-round design workflow:
+
+1. `gitlab_design_flow` with `action="get_schema"` returns the flow YAML schema reference, two annotated examples, and step-by-step instructions
+2. The LLM asks the user about the flow's purpose, resource type, and steps
+3. The LLM proposes a component architecture for user approval
+4. The LLM generates the full YAML, validates it client-side against the `flow_v2` JSON schema via `gitlab_design_flow` with `action="validate"`
+5. After user confirmation, `gitlab_create_flow` with `confirmed=true` submits it to GitLab
+6. After creation, offers to enable the flow on the current project via `gitlab_enable_project_flow`
+
+The vendored `flow_v2.json` schema from GitLab Rails powers client-side validation using `ajv`, catching errors before hitting the API.
+
+### 20 DAP Tools
 
 | Tool                              | Description                                             |
 | --------------------------------- | ------------------------------------------------------- |
@@ -102,7 +121,10 @@ The `confirmed` parameter on `gitlab_create_agent` enforces the interactive work
 | `gitlab_disable_project_agent`    | Disable an agent in a project                           |
 | `gitlab_create_agent`             | Create a custom agent (interactive, confirmation-gated) |
 | `gitlab_update_agent`             | Update an existing custom agent                         |
-| `gitlab_list_builtin_tools`       | List available built-in tools for agent configuration   |
+| `gitlab_list_builtin_tools`       | List available built-in tools for agent/flow config     |
+| `gitlab_design_flow`              | Interactive flow design + YAML validation               |
+| `gitlab_create_flow`              | Create a custom flow (confirmation-gated)               |
+| `gitlab_update_flow`              | Update an existing custom flow                          |
 | `gitlab_list_flows`               | Search flows in the global AI Catalog                   |
 | `gitlab_get_flow`                 | Get flow details by ID                                  |
 | `gitlab_list_project_flows`       | List flows enabled for a project                        |
@@ -124,6 +146,9 @@ Foundational flow definitions (from `gitlab-org/modelops/applied-ml/code-suggest
 are vendored and embedded at build time. This provides flow input schemas for
 foundational flows whose configs are not available via the GitLab API.
 
+The `flow_v2.json` JSON schema is also vendored from GitLab Rails and bundled
+inline for client-side YAML validation via `ajv`.
+
 ## Agent Types
 
 ### Foundational Agents
@@ -167,7 +192,7 @@ export GITLAB_INSTANCE_URL=https://your-instance.com
 
 ```bash
 npm install
-npm test          # Run tests (62 tests)
+npm test          # Run tests (69 tests)
 npm run build     # Build (auto-runs vendor:generate)
 npm run type-check
 ```
@@ -202,7 +227,7 @@ Plugin init
   ├─ config hook                         injects agents (primary) + flows (subagent with prompt)
   ├─ chat.message hook                   intercepts @flow → general subagent dispatch
   ├─ experimental.chat.system.transform  injects flow dispatch + agent creation guidelines
-  └─ tool hook                           17 DAP tools
+  └─ tool hook                           20 DAP tools
 
 Single flow execution (@FlowName goal):
   ├─ chat.message hook          rewrites @mention → Task tool with general subagent
@@ -230,6 +255,17 @@ Agent creation (interactive):
   ├─ gitlab_create_agent        called with confirmed=true → creates agent
   └─ gitlab_enable_project_agent  optionally enable on project
 
+Flow creation (interactive, multi-round):
+  ├─ gitlab_design_flow (get_schema)  returns schema reference + examples + instructions
+  ├─ gitlab_list_builtin_tools        discover available tool names for flow components
+  ├─ question tool                    ask user for name, visibility, purpose, steps
+  ├─ LLM proposes                    component architecture → user confirms
+  ├─ LLM generates                   flow YAML definition
+  ├─ gitlab_design_flow (validate)   client-side validation against flow_v2.json via ajv
+  ├─ User confirms                   the generated YAML
+  ├─ gitlab_create_flow              called with confirmed=true → creates flow
+  └─ gitlab_enable_project_flow      optionally enable on project
+
 Enable/disable:
   └─ refreshAgents()            clears cache, re-fetches, updates cfg.agent
 ```

package/dist/chunk-DPR6OUYG.js

@@ -0,0 +1,119 @@
+// src/graphql.ts
+async function gql(instanceUrl, token, query, variables) {
+  const res = await fetch(`${instanceUrl.replace(/\/$/, "")}/api/graphql`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+    body: JSON.stringify({ query, variables })
+  });
+  const json = await res.json();
+  if (json.errors?.length) throw new Error(json.errors[0].message);
+  return json.data;
+}
+
+// src/mcp-servers.ts
+var MCP_SERVERS_QUERY = `
+query AiCatalogMcpServers($projectId: ProjectID!, $after: String) {
+  aiCatalogConfiguredItems(first: 50, projectId: $projectId, itemTypes: [AGENT], after: $after) {
+    pageInfo { hasNextPage endCursor }
+    nodes {
+      item {
+        id
+        name
+        latestVersion {
+          ... on AiCatalogAgentVersion {
+            mcpServers {
+              nodes { id name description url transport authType currentUserConnected }
+            }
+          }
+        }
+      }
+    }
+  }
+}`;
+async function fetchMcpServers(instanceUrl, token, projectId, agents) {
+  try {
+    let after = null;
+    const serversByAgent = /* @__PURE__ */ new Map();
+    for (; ; ) {
+      const data = await gql(instanceUrl, token, MCP_SERVERS_QUERY, {
+        projectId,
+        ...after ? { after } : {}
+      });
+      const page = data?.aiCatalogConfiguredItems;
+      if (!page) break;
+      for (const node of page.nodes ?? []) {
+        const item = node.item;
+        const version = item?.latestVersion;
+        if (!version?.mcpServers?.nodes?.length) continue;
+        const servers = version.mcpServers.nodes.map((s) => ({
+          id: s.id,
+          name: s.name,
+          description: s.description ?? "",
+          url: s.url,
+          transport: s.transport,
+          authType: s.authType,
+          currentUserConnected: !!s.currentUserConnected
+        }));
+        serversByAgent.set(item.id, servers);
+      }
+      if (!page.pageInfo?.hasNextPage) break;
+      after = page.pageInfo.endCursor;
+    }
+    for (const agent of agents) {
+      const servers = serversByAgent.get(agent.identifier);
+      if (servers?.length) agent.mcpServers = servers;
+    }
+  } catch {
+  }
+}
+async function listMcpServerTools(server) {
+  try {
+    const res = await fetch(server.url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json, text/event-stream"
+      },
+      body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/list", params: {} })
+    });
+    if (!res.ok) return [];
+    const data = await res.json();
+    const tools = data?.result?.tools;
+    if (!Array.isArray(tools)) return [];
+    return tools.map((t) => ({ name: t.name, description: t.description ?? "" }));
+  } catch {
+    return [];
+  }
+}
+async function discoverMcpToolNames(agents) {
+  const result = /* @__PURE__ */ new Map();
+  const seen = /* @__PURE__ */ new Set();
+  for (const agent of agents) {
+    if (!agent.mcpServers?.length) continue;
+    const agentToolNames = [];
+    for (const server of agent.mcpServers) {
+      if (seen.has(server.id)) {
+        const key2 = server.name.toLowerCase().replace(/[^a-z0-9]+/g, "_");
+        const cached = result.get(server.id);
+        if (cached) agentToolNames.push(...cached.map((t) => `${key2}_${t}`));
+        continue;
+      }
+      seen.add(server.id);
+      const tools = await listMcpServerTools(server);
+      const toolNames = tools.map((t) => t.name);
+      result.set(server.id, toolNames);
+      const key = server.name.toLowerCase().replace(/[^a-z0-9]+/g, "_");
+      agentToolNames.push(...toolNames.map((t) => `${key}_${t}`));
+    }
+    result.set(agent.identifier, agentToolNames);
+  }
+  return result;
+}
+
+export {
+  gql,
+  fetchMcpServers,
+  listMcpServerTools,
+  discoverMcpToolNames
+};
+//# sourceMappingURL=chunk-DPR6OUYG.js.map

package/dist/chunk-DPR6OUYG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/graphql.ts","../src/mcp-servers.ts"],"sourcesContent":["export async function gql(\n  instanceUrl: string,\n  token: string,\n  query: string,\n  variables: Record<string, unknown>\n): Promise<any> {\n  const res = await fetch(`${instanceUrl.replace(/\\/$/, \"\")}/api/graphql`, {\n    method: \"POST\",\n    headers: { \"Content-Type\": \"application/json\", Authorization: `Bearer ${token}` },\n    body: JSON.stringify({ query, variables }),\n  });\n  const json = (await res.json()) as any;\n  if (json.errors?.length) throw new Error(json.errors[0].message);\n  return json.data;\n}\n","import { gql } from \"./graphql\";\nimport type { CatalogAgent, McpServerInfo } from \"./types\";\n\nconst MCP_SERVERS_QUERY = `\nquery AiCatalogMcpServers($projectId: ProjectID!, $after: String) {\n  aiCatalogConfiguredItems(first: 50, projectId: $projectId, itemTypes: [AGENT], after: $after) {\n    pageInfo { hasNextPage endCursor }\n    nodes {\n      item {\n        id\n        name\n        latestVersion {\n          ... on AiCatalogAgentVersion {\n            mcpServers {\n              nodes { id name description url transport authType currentUserConnected }\n            }\n          }\n        }\n      }\n    }\n  }\n}`;\n\nexport async function fetchMcpServers(\n  instanceUrl: string,\n  token: string,\n  projectId: string,\n  agents: CatalogAgent[]\n): Promise<void> {\n  try {\n    let after: string | null = null;\n    const serversByAgent = new Map<string, McpServerInfo[]>();\n\n    for (;;) {\n      const data = await gql(instanceUrl, token, MCP_SERVERS_QUERY, {\n        projectId,\n        ...(after ? { after } : {}),\n      });\n      const page = data?.aiCatalogConfiguredItems;\n      if (!page) break;\n\n      for (const node of page.nodes ?? []) {\n        const item = node.item;\n        const version = item?.latestVersion;\n        if (!version?.mcpServers?.nodes?.length) continue;\n        const servers: McpServerInfo[] = version.mcpServers.nodes.map((s: any) => ({\n          id: s.id,\n          name: s.name,\n          description: s.description ?? \"\",\n          url: s.url,\n          transport: s.transport,\n          authType: s.authType,\n          currentUserConnected: !!s.currentUserConnected,\n        }));\n        serversByAgent.set(item.id, servers);\n      }\n\n      if (!page.pageInfo?.hasNextPage) break;\n      after = page.pageInfo.endCursor;\n    }\n\n    for (const agent of agents) {\n      const servers = serversByAgent.get(agent.identifier);\n      if (servers?.length) agent.mcpServers = servers;\n    }\n  } catch {\n    // MCP servers query not available — silently skip\n  }\n}\n\nexport async function listMcpServerTools(\n  server: McpServerInfo\n): Promise<Array<{ name: string; description: string }>> {\n  try {\n    const res = await fetch(server.url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Accept: \"application/json, text/event-stream\",\n      },\n      body: JSON.stringify({ jsonrpc: \"2.0\", id: 1, method: \"tools/list\", params: {} }),\n    });\n    if (!res.ok) return [];\n    const data = await res.json();\n    const tools = data?.result?.tools;\n    if (!Array.isArray(tools)) return [];\n    return tools.map((t: any) => ({ name: t.name, description: t.description ?? \"\" }));\n  } catch {\n    return [];\n  }\n}\n\nexport async function discoverMcpToolNames(agents: CatalogAgent[]): Promise<Map<string, string[]>> {\n  const result = new Map<string, string[]>();\n  const seen = new Set<string>();\n\n  for (const agent of agents) {\n    if (!agent.mcpServers?.length) continue;\n    const agentToolNames: string[] = [];\n    for (const server of agent.mcpServers) {\n      if (seen.has(server.id)) {\n        const key = server.name.toLowerCase().replace(/[^a-z0-9]+/g, \"_\");\n        const cached = result.get(server.id);\n        if (cached) agentToolNames.push(...cached.map((t) => `${key}_${t}`));\n        continue;\n      }\n      seen.add(server.id);\n      const tools = await listMcpServerTools(server);\n      const toolNames = tools.map((t) => t.name);\n      result.set(server.id, toolNames);\n      const key = server.name.toLowerCase().replace(/[^a-z0-9]+/g, \"_\");\n      agentToolNames.push(...toolNames.map((t) => `${key}_${t}`));\n    }\n    result.set(agent.identifier, agentToolNames);\n  }\n  return result;\n}\n"],"mappings":";AAAA,eAAsB,IACpB,aACA,OACA,OACA,WACc;AACd,QAAM,MAAM,MAAM,MAAM,GAAG,YAAY,QAAQ,OAAO,EAAE,CAAC,gBAAgB;AAAA,IACvE,QAAQ;AAAA,IACR,SAAS,EAAE,gBAAgB,oBAAoB,eAAe,UAAU,KAAK,GAAG;AAAA,IAChF,MAAM,KAAK,UAAU,EAAE,OAAO,UAAU,CAAC;AAAA,EAC3C,CAAC;AACD,QAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,MAAI,KAAK,QAAQ,OAAQ,OAAM,IAAI,MAAM,KAAK,OAAO,CAAC,EAAE,OAAO;AAC/D,SAAO,KAAK;AACd;;;ACXA,IAAM,oBAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoB1B,eAAsB,gBACpB,aACA,OACA,WACA,QACe;AACf,MAAI;AACF,QAAI,QAAuB;AAC3B,UAAM,iBAAiB,oBAAI,IAA6B;AAExD,eAAS;AACP,YAAM,OAAO,MAAM,IAAI,aAAa,OAAO,mBAAmB;AAAA,QAC5D;AAAA,QACA,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC;AAAA,MAC3B,CAAC;AACD,YAAM,OAAO,MAAM;AACnB,UAAI,CAAC,KAAM;AAEX,iBAAW,QAAQ,KAAK,SAAS,CAAC,GAAG;AACnC,cAAM,OAAO,KAAK;AAClB,cAAM,UAAU,MAAM;AACtB,YAAI,CAAC,SAAS,YAAY,OAAO,OAAQ;AACzC,cAAM,UAA2B,QAAQ,WAAW,MAAM,IAAI,CAAC,OAAY;AAAA,UACzE,IAAI,EAAE;AAAA,UACN,MAAM,EAAE;AAAA,UACR,aAAa,EAAE,eAAe;AAAA,UAC9B,KAAK,EAAE;AAAA,UACP,WAAW,EAAE;AAAA,UACb,UAAU,EAAE;AAAA,UACZ,sBAAsB,CAAC,CAAC,EAAE;AAAA,QAC5B,EAAE;AACF,uBAAe,IAAI,KAAK,IAAI,OAAO;AAAA,MACrC;AAEA,UAAI,CAAC,KAAK,UAAU,YAAa;AACjC,cAAQ,KAAK,SAAS;AAAA,IACxB;AAEA,eAAW,SAAS,QAAQ;AAC1B,YAAM,UAAU,eAAe,IAAI,MAAM,UAAU;AACnD,UAAI,SAAS,OAAQ,OAAM,aAAa;AAAA,IAC1C;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AAEA,eAAsB,mBACpB,QACuD;AACvD,MAAI;AACF,UAAM,MAAM,MAAM,MAAM,OAAO,KAAK;AAAA,MAClC,QAAQ;AAAA,MACR,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,QAAQ;AAAA,MACV;AAAA,MACA,MAAM,KAAK,UAAU,EAAE,SAAS,OAAO,IAAI,GAAG,QAAQ,cAAc,QAAQ,CAAC,EAAE,CAAC;AAAA,IAClF,CAAC;AACD,QAAI,CAAC,IAAI,GAAI,QAAO,CAAC;AACrB,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,UAAM,QAAQ,MAAM,QAAQ;AAC5B,QAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACnC,WAAO,MAAM,IAAI,CAAC,OAAY,EAAE,MAAM,EAAE,MAAM,aAAa,EAAE,eAAe,GAAG,EAAE;AAAA,EACnF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,eAAsB,qBAAqB,QAAwD;AACjG,QAAM,SAAS,oBAAI,IAAsB;AACzC,QAAM,OAAO,oBAAI,IAAY;AAE7B,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,MAAM,YAAY,OAAQ;AAC/B,UAAM,iBAA2B,CAAC;AAClC,eAAW,UAAU,MAAM,YAAY;AACrC,UAAI,KAAK,IAAI,OAAO,EAAE,GAAG;AACvB,cAAMA,OAAM,OAAO,KAAK,YAAY,EAAE,QAAQ,eAAe,GAAG;AAChE,cAAM,SAAS,OAAO,IAAI,OAAO,EAAE;AACnC,YAAI,OAAQ,gBAAe,KAAK,GAAG,OAAO,IAAI,CAAC,MAAM,GAAGA,IAAG,IAAI,CAAC,EAAE,CAAC;AACnE;AAAA,MACF;AACA,WAAK,IAAI,OAAO,EAAE;AAClB,YAAM,QAAQ,MAAM,mBAAmB,MAAM;AAC7C,YAAM,YAAY,MAAM,IAAI,CAAC,MAAM,EAAE,IAAI;AACzC,aAAO,IAAI,OAAO,IAAI,SAAS;AAC/B,YAAM,MAAM,OAAO,KAAK,YAAY,EAAE,QAAQ,eAAe,GAAG;AAChE,qBAAe,KAAK,GAAG,UAAU,IAAI,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;AAAA,IAC5D;AACA,WAAO,IAAI,MAAM,YAAY,cAAc;AAAA,EAC7C;AACA,SAAO;AACT;","names":["key"]}