@arbium/enterprise-agent-connect 0.1.2-dev.d2aa5ca → 0.2.1-dev.7b4e802

package/dist/connectors/gitlab/connector.json

@@ -0,0 +1,263 @@
+{
+  "id": "gitlab",
+  "name": "GitLab",
+  "description": "Let agents read merge requests, pipelines, job logs and commits in the GitLab projects you choose, and comment on merge requests. For review prep, failed pipeline triage, release checks and status reports.",
+  "logo": "/brand/registry/gitlab.svg",
+  "identity": "A GitLab project or group access token. It acts as a bot member of that project or group, with the role you give it, and reaches nothing outside it.",
+  "accountKey": "host",
+  "connectionKind": "guided",
+  "setup": [
+    {
+      "title": "Create an access token",
+      "body": "Create the token on the group that holds the projects agents should see, or on one project. Give it the Reporter role and the read_api scope. If agents may comment on merge requests, keep the Reporter role and choose the api scope instead: Reporter can comment but cannot push code, merge or run pipelines. GitLab shows the token only once.",
+      "link": {
+        "label": "GitLab: project access tokens",
+        "href": "https://docs.gitlab.com/user/project/settings/project_access_tokens/"
+      },
+      "click": [
+        "In GitLab, open the group (or the project), then select Settings > Access tokens > Add new token.",
+        "Token name: AI agents. Set an expiration date.",
+        "Role: Reporter. Scopes: read_api (api if agents may comment).",
+        "Select Create group access token (or Create project access token) and copy the token."
+      ]
+    },
+    {
+      "title": "Find your GitLab address",
+      "body": "Enter the host name of your GitLab, such as gitlab.com or gitlab.example.com, without https://. You can test the token with the command below: it shows the token's bot user and changes nothing.",
+      "click": ["Copy the host name from your browser's address bar while you are in GitLab."],
+      "copy": [
+        "GITLAB_HOST=gitlab.example.com",
+        "curl -s --header \"PRIVATE-TOKEN: $GITLAB_TOKEN\" \"https://$GITLAB_HOST/api/v4/user\""
+      ],
+      "shell": "bash"
+    }
+  ],
+  "afterConnect": [],
+  "fields": [
+    {
+      "id": "host",
+      "label": "GitLab address",
+      "help": "The host name only, such as gitlab.com or gitlab.example.com.",
+      "placeholder": "gitlab.example.com",
+      "secret": false
+    },
+    { "id": "token", "label": "Access token", "secret": true }
+  ],
+  "capabilities": [
+    {
+      "id": "read",
+      "label": "Read merge requests and pipelines",
+      "description": "List and read merge requests with their changes and comments, list and read pipelines and their jobs, read a job's log, and list commits.",
+      "required": true,
+      "note": "Reaches every project the token can see unless you keep a key to chosen projects. Read-only.",
+      "scopes": ["read_api"],
+      "permissions": [],
+      "tools": [
+        "gitlab_list_merge_requests",
+        "gitlab_get_merge_request",
+        "gitlab_list_merge_request_changes",
+        "gitlab_list_merge_request_comments",
+        "gitlab_list_pipelines",
+        "gitlab_get_pipeline",
+        "gitlab_list_pipeline_jobs",
+        "gitlab_get_job_log",
+        "gitlab_list_commits"
+      ]
+    },
+    {
+      "id": "comment",
+      "label": "Comment on merge requests",
+      "description": "Add a comment to a merge request, such as a review brief. It can be marked internal, so only project members see it.",
+      "note": "Needs a token with the api scope. Keep its role at Reporter.",
+      "scopes": ["api"],
+      "permissions": [],
+      "tools": ["gitlab_add_merge_request_comment"]
+    }
+  ],
+  "limits": [
+    {
+      "id": "projects",
+      "label": "Projects",
+      "help": "Optional: only these projects, by their full path as in the project's address, such as platform/payments-api. Agents must then name projects by that path. Leave empty for every project the token can see.",
+      "kind": "list",
+      "required": false,
+      "pattern": "^[A-Za-z0-9_.-]+(/[A-Za-z0-9_.-]+)+$"
+    }
+  ],
+  "verify": { "method": "GET", "path": "/user", "label": "GitLab token user", "show": "username" },
+  "revoke": "In GitLab, open the group or project, go to Settings > Access tokens and revoke the token. Agents lose access to GitLab at once.",
+  "http": {
+    "baseUrl": "https://{host}/api/v4",
+    "auth": { "type": "header", "header": "PRIVATE-TOKEN", "value": "token" },
+    "tools": [
+      {
+        "name": "gitlab_list_merge_requests",
+        "description": "List a project's merge requests, newest first. Pass next from the answer as page for the next page.",
+        "method": "GET",
+        "path": "/projects/{project}/merge_requests",
+        "params": {
+          "project": {
+            "type": "string",
+            "description": "The project's full path, such as platform/payments-api, or its numeric id",
+            "in": "path",
+            "limit": "projects"
+          },
+          "state": {
+            "type": "string",
+            "enum": ["opened", "closed", "locked", "merged", "all"],
+            "description": "Only merge requests in this state",
+            "in": "query",
+            "default": "opened"
+          },
+          "target_branch": { "type": "string", "description": "Only those merging into this branch", "in": "query", "required": false },
+          "source_branch": { "type": "string", "description": "Only those from this branch", "in": "query", "required": false },
+          "labels": { "type": "string", "description": "Comma-separated labels, all of which must be on the merge request", "in": "query", "required": false },
+          "author_username": { "type": "string", "description": "Only those opened by this username", "in": "query", "required": false },
+          "reviewer_username": { "type": "string", "description": "Only those with this reviewer", "in": "query", "required": false },
+          "search": { "type": "string", "description": "Words in the title or description", "in": "query", "required": false },
+          "updated_after": { "type": "string", "description": "Only those updated after this time, ISO 8601, such as 2026-10-01T00:00:00Z", "in": "query", "required": false },
+          "per_page": { "type": "integer", "description": "How many per page, at most 100", "in": "query", "default": 20 },
+          "page": { "type": "integer", "description": "The next value of the previous answer", "in": "query", "required": false }
+        },
+        "paging": { "param": "page", "header": "X-Next-Page" },
+        "result": {
+          "fields": ["iid", "title", "state", "draft", "author.username", "reviewers.username", "source_branch", "target_branch", "labels", "detailed_merge_status", "has_conflicts", "updated_at", "web_url"]
+        }
+      },
+      {
+        "name": "gitlab_get_merge_request",
+        "description": "Read one merge request: description, branches, approvals state, merge status and its latest pipeline.",
+        "method": "GET",
+        "path": "/projects/{project}/merge_requests/{iid}",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "iid": { "type": "integer", "description": "The merge request number within the project (its iid)", "in": "path" }
+        }
+      },
+      {
+        "name": "gitlab_list_merge_request_changes",
+        "description": "List the files a merge request changes, with each file's diff. Pass next from the answer as page for the next page.",
+        "method": "GET",
+        "path": "/projects/{project}/merge_requests/{iid}/diffs",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "iid": { "type": "integer", "description": "The merge request number within the project (its iid)", "in": "path" },
+          "per_page": { "type": "integer", "description": "How many files per page, at most 100", "in": "query", "default": 20 },
+          "page": { "type": "integer", "description": "The next value of the previous answer", "in": "query", "required": false }
+        },
+        "paging": { "param": "page", "header": "X-Next-Page" }
+      },
+      {
+        "name": "gitlab_list_merge_request_comments",
+        "description": "List the comments on a merge request, newest first, including system notes such as approvals. Pass next from the answer as page for the next page.",
+        "method": "GET",
+        "path": "/projects/{project}/merge_requests/{iid}/notes",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "iid": { "type": "integer", "description": "The merge request number within the project (its iid)", "in": "path" },
+          "per_page": { "type": "integer", "description": "How many per page, at most 100", "in": "query", "default": 20 },
+          "page": { "type": "integer", "description": "The next value of the previous answer", "in": "query", "required": false }
+        },
+        "paging": { "param": "page", "header": "X-Next-Page" },
+        "result": { "fields": ["id", "author.username", "body", "system", "internal", "created_at"] }
+      },
+      {
+        "name": "gitlab_list_pipelines",
+        "description": "List a project's pipelines, newest first. Pass next from the answer as page for the next page.",
+        "method": "GET",
+        "path": "/projects/{project}/pipelines",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "status": {
+            "type": "string",
+            "enum": ["created", "waiting_for_resource", "preparing", "pending", "running", "success", "failed", "canceled", "skipped", "manual", "scheduled"],
+            "description": "Only pipelines in this status",
+            "in": "query",
+            "required": false
+          },
+          "ref": { "type": "string", "description": "Only pipelines for this branch or tag", "in": "query", "required": false },
+          "sha": { "type": "string", "description": "Only pipelines for this commit", "in": "query", "required": false },
+          "updated_after": { "type": "string", "description": "Only those updated after this time, ISO 8601", "in": "query", "required": false },
+          "per_page": { "type": "integer", "description": "How many per page, at most 100", "in": "query", "default": 20 },
+          "page": { "type": "integer", "description": "The next value of the previous answer", "in": "query", "required": false }
+        },
+        "paging": { "param": "page", "header": "X-Next-Page" },
+        "result": { "fields": ["id", "status", "ref", "sha", "source", "created_at", "updated_at", "web_url"] }
+      },
+      {
+        "name": "gitlab_get_pipeline",
+        "description": "Read one pipeline: status, branch, commit, who started it, timing and the reason it failed, if GitLab gives one.",
+        "method": "GET",
+        "path": "/projects/{project}/pipelines/{pipeline_id}",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "pipeline_id": { "type": "integer", "description": "The pipeline id", "in": "path" }
+        }
+      },
+      {
+        "name": "gitlab_list_pipeline_jobs",
+        "description": "List a pipeline's jobs with their stage, status and failure reason. Pass next from the answer as page for the next page.",
+        "method": "GET",
+        "path": "/projects/{project}/pipelines/{pipeline_id}/jobs",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "pipeline_id": { "type": "integer", "description": "The pipeline id", "in": "path" },
+          "scope": {
+            "type": "array",
+            "items": "string",
+            "enum": ["created", "pending", "running", "failed", "success", "canceled", "skipped", "waiting_for_resource", "manual"],
+            "description": "Only jobs in these statuses",
+            "in": "query",
+            "name": "scope[]",
+            "required": false
+          },
+          "include_retried": { "type": "boolean", "description": "Include jobs that were retried", "in": "query", "required": false },
+          "per_page": { "type": "integer", "description": "How many per page, at most 100", "in": "query", "default": 50 },
+          "page": { "type": "integer", "description": "The next value of the previous answer", "in": "query", "required": false }
+        },
+        "paging": { "param": "page", "header": "X-Next-Page" },
+        "result": { "fields": ["id", "name", "stage", "status", "failure_reason", "allow_failure", "duration", "started_at", "finished_at", "web_url"] }
+      },
+      {
+        "name": "gitlab_get_job_log",
+        "description": "Read a job's log as text, to see why it failed. Logs larger than 1 MB cannot be read.",
+        "method": "GET",
+        "path": "/projects/{project}/jobs/{job_id}/trace",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "job_id": { "type": "integer", "description": "The job id", "in": "path" }
+        }
+      },
+      {
+        "name": "gitlab_list_commits",
+        "description": "List commits on a branch, newest first, optionally only within dates or by one author. Pass next from the answer as page for the next page.",
+        "method": "GET",
+        "path": "/projects/{project}/repository/commits",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "ref_name": { "type": "string", "description": "The branch or tag; the default branch when left out", "in": "query", "required": false },
+          "since": { "type": "string", "description": "Only commits after this time, ISO 8601", "in": "query", "required": false },
+          "until": { "type": "string", "description": "Only commits before this time, ISO 8601", "in": "query", "required": false },
+          "author": { "type": "string", "description": "Only commits by this author name or email", "in": "query", "required": false },
+          "per_page": { "type": "integer", "description": "How many per page, at most 100", "in": "query", "default": 20 },
+          "page": { "type": "integer", "description": "The next value of the previous answer", "in": "query", "required": false }
+        },
+        "paging": { "param": "page", "header": "X-Next-Page" },
+        "result": { "fields": ["short_id", "title", "author_name", "author_email", "committed_date", "web_url"] }
+      },
+      {
+        "name": "gitlab_add_merge_request_comment",
+        "description": "Add a comment to a merge request. Markdown is allowed.",
+        "method": "POST",
+        "path": "/projects/{project}/merge_requests/{iid}/notes",
+        "params": {
+          "project": { "type": "string", "description": "The project's full path or numeric id", "in": "path", "limit": "projects" },
+          "iid": { "type": "integer", "description": "The merge request number within the project (its iid)", "in": "path" },
+          "body": { "type": "string", "description": "The comment, in Markdown", "in": "body" },
+          "internal": { "type": "boolean", "description": "Only project members can see it", "in": "body", "required": false }
+        },
+        "result": { "fields": ["id", "body", "internal", "created_at"] }
+      }
+    ]
+  }
+}

package/dist/connectors/gong/vendor.d.ts

@@ -1,4 +1,4 @@
 import { type Fetch, type Vendor, type VendorResponse } from "../../packages/connector-kit/src/types.js";
 export declare function normalizeBaseUrl(input: string): string;
 export declare function gongError(res: VendorResponse): string;
-export declare function gongVendor(fetchImpl?: Fetch, wait?: (seconds: number) => Promise<unknown>): Vendor;
+export declare function gongVendor(unguarded?: Fetch, wait?: (seconds: number) => Promise<void>): Vendor;

package/dist/connectors/gong/vendor.js

@@ -1,13 +1,13 @@
+import { retryAfter, vendorFetch } from "../../packages/connector-kit/src/fetch.js";
 import { ConnectError, } from "../../packages/connector-kit/src/types.js";
 // A Gong API access key and secret, sent as Basic auth to the company's own API address
 // (https://<id>.api.gong.io, or the shared https://api.gong.io). Gong allows 3 calls a second
-// and 10,000 a day per company and answers 429 with Retry-After past either; short waits are
-// retried here, longer ones go back to the agent. Errors come as {requestId, errors: [...]}.
+// and 10,000 a day per company and answers 429 with Retry-After past either; the kit's
+// vendorFetch retries short waits, longer ones go back to the agent. Errors come as
+// {requestId, errors: [...]}.
 // Sources: help.gong.io "Receive access to the API" and gong.app.gong.io/settings/api/
 // documentation (read October 27, 2026).
 const HOST = /^([a-z0-9][a-z0-9-]*\.)?api\.gong\.io$/;
-const MAX_WAIT_SECONDS = 10;
-const RETRIES = 2;
 export function normalizeBaseUrl(input) {
     const raw = input.trim().toLowerCase();
     const url = URL.parse(/^[a-z]+:\/\//.test(raw) ? raw : `https://${raw}`);
@@ -31,38 +31,30 @@ export function gongError(res) {
         : "";
     return `Gong answered ${res.status}${detail ? `: ${detail.slice(0, 300)}` : ""}`;
 }
-const sleep = (seconds) => new Promise((r) => setTimeout(r, seconds * 1000));
-export function gongVendor(fetchImpl = fetch, wait = sleep) {
+export function gongVendor(unguarded = fetch, wait) {
+    const fetchImpl = vendorFetch("Gong", unguarded, wait);
     async function send(host, secret, request) {
         if (!HOST.test(host))
             throw new Error("Gong connection has no API address");
         const auth = Buffer.from(`${secret.access_key}:${secret.access_key_secret}`).toString("base64");
-        // A 429 means Gong did not run the call, so it is safe to send again.
-        for (let attempt = 0;; attempt++) {
-            const res = await fetchImpl(`https://${host}${request.path}`, {
-                method: request.method,
-                redirect: "error",
-                headers: {
-                    authorization: `Basic ${auth}`,
-                    accept: "application/json",
-                    ...(request.body === undefined ? {} : { "content-type": "application/json" }),
-                },
-                body: request.body === undefined ? undefined : JSON.stringify(request.body),
-            });
-            const raw = await res.text();
-            if (res.status === 429) {
-                const after = Number(res.headers.get("retry-after") ?? "1");
-                if (attempt < RETRIES && Number.isFinite(after) && after <= MAX_WAIT_SECONDS) {
-                    await wait(Math.max(after, 1));
-                    continue;
-                }
-                return {
-                    status: 429,
-                    data: { retryAfter: Number.isFinite(after) ? after : null },
-                };
-            }
-            return { status: res.status, data: raw ? parse(raw) : null };
-        }
+        const res = await fetchImpl(`https://${host}${request.path}`, {
+            method: request.method,
+            headers: {
+                authorization: `Basic ${auth}`,
+                accept: "application/json",
+                ...(request.body === undefined ? {} : { "content-type": "application/json" }),
+            },
+            body: request.body === undefined ? undefined : JSON.stringify(request.body),
+        });
+        const raw = await res.text();
+        const headers = Object.fromEntries(res.headers);
+        if (res.status === 429)
+            return {
+                status: 429,
+                data: { retryAfter: retryAfter(res.headers.get("retry-after")) },
+                headers,
+            };
+        return { status: res.status, data: raw ? parse(raw) : null, headers };
     }
     return {
         async connect(fields) {

package/dist/connectors/gong/vendor.js.map

@@ -1 +1 @@
-{"version":3,"file":"vendor.js","sourceRoot":"","sources":["../../../connectors/gong/vendor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vendor.js","sourceRoot":"","sources":["../../../connectors/gong/vendor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AACpF,OAAO,EACL,YAAY,GAMb,MAAM,2CAA2C,CAAC;AAEnD,wFAAwF;AACxF,8FAA8F;AAC9F,uFAAuF;AACvF,oFAAoF;AACpF,8BAA8B;AAC9B,uFAAuF;AACvF,yCAAyC;AAEzC,MAAM,IAAI,GAAG,wCAAwC,CAAC;AAEtD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,GAAG,EAAE,CAAC,CAAC;IACzE,IACE,CAAC,GAAG;QACJ,GAAG,CAAC,QAAQ,KAAK,QAAQ;QACzB,GAAG,CAAC,IAAI;QACR,GAAG,CAAC,QAAQ;QACZ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;QACxB,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAEnD,MAAM,IAAI,YAAY,CACpB,uGAAuG,CACxG,CAAC;IACJ,OAAO,GAAG,CAAC,QAAQ,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAmB;IAC3C,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAI,GAAG,CAAC,IAAiC,EAAE,UAAU,CAAC;QACjE,OAAO,kDAAkD,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChI,CAAC;IACD,MAAM,MAAM,GAAI,GAAG,CAAC,IAA6B,EAAE,MAAM,CAAC;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACxD,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,iBAAiB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,YAAmB,KAAK,EACxB,IAAyC;IAEzC,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAEvD,KAAK,UAAU,IAAI,CAAC,IAAY,EAAE,MAA8B,EAAE,OAAsB;QACtF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAChG,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,WAAW,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE;YAC5D,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS,IAAI,EAAE;gBAC9B,MAAM,EAAE,kBAAkB;gBAC1B,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC;aAC9E;YACD,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;SAC5E,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YACpB,OAAO;gBACL,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,EAAE;gBAChE,OAAO;aACR,CAAC;QACJ,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IACxE,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,MAAM;YAClB,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG;gBACb,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE;gBAC3C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,IAAI,EAAE,IAAI,EAAE;aAC1D,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,iBAAiB;gBACjD,MAAM,IAAI,YAAY,CAAC,0DAA0D,CAAC,CAAC;YACrF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE;gBACnC,MAAM,EAAE,KAAK;gBACb,IAAI,EAAE,gBAAgB;aACvB,CAAC,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBACpB,MAAM,IAAI,YAAY,CAAC,+CAA+C,CAAC,CAAC;YAC1E,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,MAAM,IAAI,YAAY,CAAC,wBAAwB,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzF,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC1D,CAAC;QAED,IAAI,EAAE,CAAC,UAA4B,EAAE,OAAO,EAAE,EAAE,CAC9C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;KACjE,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,GAAW;IACxB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/connectors/grafana/connector.json

@@ -0,0 +1,162 @@
+{
+  "id": "grafana",
+  "name": "Grafana",
+  "description": "Let agents find and read Grafana dashboards and alert rules, and read alert state changes and annotations around an incident. For first response to production alerts.",
+  "logo": "/brand/registry/grafana.svg",
+  "identity": "A Grafana service account token. The service account has the Viewer role, so it reads what a viewer in your organization may read.",
+  "accountKey": "host",
+  "connectionKind": "guided",
+  "setup": [
+    {
+      "title": "Create a service account with the Viewer role",
+      "body": "You need a Grafana organization administrator for this. Viewer lets agents read dashboards, alert rules and annotations and change nothing.",
+      "link": {
+        "label": "Grafana: service accounts",
+        "href": "https://grafana.com/docs/grafana/latest/administration/service-accounts/"
+      },
+      "click": [
+        "In Grafana, select Administration > Users and access > Service accounts > Add service account.",
+        "Display name: AI agents. Select Create.",
+        "On the AI agents service account, set its role to Viewer with the role picker."
+      ]
+    },
+    {
+      "title": "Add a token",
+      "body": "Grafana shows the token only once. You can test it with the command below: it shows your organization's name and changes nothing.",
+      "click": [
+        "On the AI agents service account, select Add service account token.",
+        "Name: AI agents. Set an expiration date, then select Generate token and copy it."
+      ],
+      "copy": [
+        "GRAFANA_HOST=grafana.example.com",
+        "curl -s -H \"Authorization: Bearer $GRAFANA_TOKEN\" \"https://$GRAFANA_HOST/api/org/\""
+      ],
+      "shell": "bash"
+    }
+  ],
+  "afterConnect": [],
+  "fields": [
+    {
+      "id": "host",
+      "label": "Grafana address",
+      "help": "The host name of your Grafana, such as grafana.example.com or yourstack.grafana.net, without https://.",
+      "placeholder": "grafana.example.com",
+      "secret": false
+    },
+    { "id": "token", "label": "Service account token", "secret": true }
+  ],
+  "capabilities": [
+    {
+      "id": "read",
+      "label": "Read dashboards and alert rules",
+      "description": "Search dashboards and folders, read a dashboard's panels and queries, and list and read alert rules.",
+      "required": true,
+      "note": "Read-only. Reaches every dashboard and alert rule a viewer can see unless you keep a key to chosen folders. Reading alert rules with the Viewer role needs Grafana 11 or later.",
+      "scopes": [],
+      "permissions": ["Viewer"],
+      "tools": ["grafana_search", "grafana_get_dashboard", "grafana_list_alert_rules", "grafana_get_alert_rule"]
+    },
+    {
+      "id": "read_annotations",
+      "label": "Read annotations",
+      "description": "Read annotations in a time window, such as alert state changes, deployments and notes people added to graphs.",
+      "note": "Annotations are read across the organization, whatever folders a key is kept to.",
+      "scopes": [],
+      "permissions": ["Viewer"],
+      "tools": ["grafana_list_annotations"]
+    }
+  ],
+  "limits": [
+    {
+      "id": "folders",
+      "label": "Folders",
+      "help": "Optional: only dashboards and alert rules in these folders, by folder UID (in the folder's address after /dashboards/f/). Leave empty for every folder.",
+      "kind": "list",
+      "required": false,
+      "pattern": "^[A-Za-z0-9_-]{1,40}$"
+    }
+  ],
+  "verify": { "method": "GET", "path": "/api/org/", "label": "Grafana organization", "show": "name" },
+  "revoke": "In Grafana, go to Administration > Users and access > Service accounts, select AI agents and delete its token, or the service account. Agents lose access to Grafana at once.",
+  "http": {
+    "baseUrl": "https://{host}",
+    "auth": { "type": "bearer", "token": "token" },
+    "tools": [
+      {
+        "name": "grafana_search",
+        "description": "Search dashboards or folders by title, tag or folder. Pass page to read further pages, from 1.",
+        "method": "GET",
+        "path": "/api/search",
+        "params": {
+          "query": { "type": "string", "description": "Words in the title", "in": "query", "required": false },
+          "tag": { "type": "array", "items": "string", "description": "Only those with all these tags", "in": "query", "required": false },
+          "type": { "type": "string", "enum": ["dash-db", "dash-folder"], "description": "Dashboards or folders", "in": "query", "default": "dash-db" },
+          "folder_uids": {
+            "type": "array",
+            "items": "string",
+            "description": "Only in these folders, by UID",
+            "in": "query",
+            "name": "folderUIDs",
+            "required": false,
+            "limit": "folders"
+          },
+          "limit": { "type": "integer", "description": "Results per page", "in": "query", "default": 50 },
+          "page": { "type": "integer", "description": "The page, from 1", "in": "query", "default": 1 }
+        },
+        "result": { "fields": ["uid", "title", "type", "tags", "folderUid", "folderTitle", "url"] }
+      },
+      {
+        "name": "grafana_get_dashboard",
+        "description": "Read a dashboard by UID: its panels with their titles, queries and data sources, its variables and its folder.",
+        "method": "GET",
+        "path": "/api/dashboards/uid/{uid}",
+        "params": { "uid": { "type": "string", "description": "The dashboard UID", "in": "path" } },
+        "answerLimits": [{ "field": "meta.folderUid", "limit": "folders" }],
+        "result": {
+          "fields": [
+            "dashboard.uid",
+            "dashboard.title",
+            "dashboard.tags",
+            "dashboard.panels",
+            "dashboard.templating",
+            "meta.folderUid",
+            "meta.folderTitle",
+            "meta.url",
+            "meta.updated"
+          ]
+        }
+      },
+      {
+        "name": "grafana_list_alert_rules",
+        "description": "List every alert rule with its folder, group, condition and labels. Under a key kept to some folders, this answers only when every rule is in them; read one rule instead.",
+        "method": "GET",
+        "path": "/api/v1/provisioning/alert-rules",
+        "answerLimits": [{ "field": "folderUID", "limit": "folders" }],
+        "result": { "fields": ["uid", "title", "folderUID", "ruleGroup", "condition", "for", "labels", "annotations", "isPaused"] }
+      },
+      {
+        "name": "grafana_get_alert_rule",
+        "description": "Read one alert rule by UID: its queries, condition, labels, annotations such as the runbook, and how long it must hold before firing.",
+        "method": "GET",
+        "path": "/api/v1/provisioning/alert-rules/{uid}",
+        "params": { "uid": { "type": "string", "description": "The alert rule UID", "in": "path" } },
+        "answerLimits": [{ "field": "folderUID", "limit": "folders" }]
+      },
+      {
+        "name": "grafana_list_annotations",
+        "description": "List annotations in a time window, newest first: alert state changes (type alert) or notes people added (type annotation), optionally on one dashboard or with tags.",
+        "method": "GET",
+        "path": "/api/annotations",
+        "params": {
+          "from": { "type": "integer", "description": "Start of the window, milliseconds since 1970", "in": "query", "required": false },
+          "to": { "type": "integer", "description": "End of the window, milliseconds since 1970", "in": "query", "required": false },
+          "type": { "type": "string", "enum": ["alert", "annotation"], "description": "Alert state changes or notes", "in": "query", "required": false },
+          "dashboard_uid": { "type": "string", "description": "Only on this dashboard", "in": "query", "name": "dashboardUID", "required": false },
+          "tags": { "type": "array", "items": "string", "description": "Only those with all these tags", "in": "query", "required": false },
+          "limit": { "type": "integer", "description": "At most this many", "in": "query", "default": 100 }
+        },
+        "result": { "fields": ["id", "time", "timeEnd", "text", "tags", "dashboardUID", "panelId", "alertName", "newState", "prevState"] }
+      }
+    ]
+  }
+}

package/dist/connectors/http/index.d.ts

@@ -1,8 +1,7 @@
 import { z } from "zod";
 import { type Toolset } from "../../packages/connector-kit/src/common.js";
-import type { Connector, HttpApp, HttpAuth } from "../../packages/connector-kit/src/connector.js";
-import { type Fetch, type Vendor, type VendorConnection } from "../../packages/connector-kit/src/types.js";
-import type { Limits } from "../../packages/server/src/store.js";
+import { type Connector, type HttpApp, type HttpAuth } from "../../packages/connector-kit/src/connector.js";
+import { type Fetch, type Limits, type Vendor, type VendorConnection } from "../../packages/connector-kit/src/types.js";
 export declare const MAX_RESPONSE_BYTES: number;
 export declare const MAX_BODY_BYTES: number;
 export declare const MAX_TARGET_BYTES: number;
@@ -12,6 +11,10 @@ export declare function formValues(connector: Connector, fields: Record<string,
     config: Record<string, string>;
     secret: Record<string, string>;
 };
+export declare function connectionAddress(connector: Connector, address: string, allowedHosts: string[] | undefined, tokenUrl: string | null, fetchImpl: Fetch, types?: RegExp, passed?: string): (c: Pick<VendorConnection, "config">) => {
+    url: import("node:url").URL;
+    safe: typeof fetch;
+};
 export declare function httpVendor(connector: Connector, fetchImpl?: Fetch): Vendor;
 export declare function answerWithin(data: unknown, path: string, values: string[]): boolean;
 export declare function paramLimits(limits: Limits, params: Record<string, {
@@ -27,10 +30,7 @@ export declare function httpTools(http: HttpApp): Toolset;
 /** Binds to any connector with an `http` block; createAgentConnect uses it for those. */
 declare const _default: {
     id: string;
-    create: ({ connector }: {
-        microsoft: import("../microsoft/client.js").MicrosoftClient;
-        connector: Connector;
-    }) => {
+    create: ({ connector }: import("../../packages/connector-kit/src/connector.js").ConnectorContext) => {
         vendor: Vendor;
         toolset: Toolset;
     };