@tool-bridge/server 0.1.1 → 0.3.0

package/dist/grafana-4PKSSDXY.js

@@ -0,0 +1,817 @@
+import {
+  assertPublicHttpUrl,
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/grafana/api.ts
+var SERVICE = "grafana";
+var DEFAULT_NAMESPACE = "default";
+var FOLDER_PARENT_ANNOTATION = "grafana.app/folder";
+var DEFAULT_API_VERSION = "v1";
+var API_VERSION_PREFERENCE = [DEFAULT_API_VERSION, "v1beta1", "v0alpha1"];
+var API_GROUPS = {
+  dashboards: "dashboard.grafana.app",
+  folders: "folder.grafana.app"
+};
+var API_VERSION_CACHE_MAX = 256;
+var apiVersionCache = /* @__PURE__ */ new Map();
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function integer(value) {
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+}
+function boolean(value) {
+  return typeof value === "boolean" ? value : void 0;
+}
+function compact(input) {
+  return Object.fromEntries(
+    Object.entries(input).filter(([, value]) => value !== void 0)
+  );
+}
+function requireText(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} is required`);
+  return result;
+}
+function requireObject(value, field) {
+  const object = record(value);
+  if (object === void 0) throw new TBError("invalid_argument", `${field} object is required`);
+  return object;
+}
+function objectArray(value) {
+  if (!Array.isArray(value)) return [];
+  return value.flatMap((item) => {
+    const fields = record(item);
+    return fields === void 0 ? [] : [fields];
+  });
+}
+function stringArray(value) {
+  if (value === void 0) return void 0;
+  return value.flatMap((item) => {
+    const trimmed = text(item);
+    return trimmed === void 0 ? [] : [trimmed];
+  });
+}
+function configError(message) {
+  return new TBError("invalid_argument", `${SERVICE} \u7684 baseUrl ${message}`);
+}
+function resolveBaseUrl(ctx) {
+  const configured = ctx.config?.baseUrl;
+  if (configured !== void 0 && typeof configured !== "string") throw configError("\u5FC5\u987B\u662F\u5B57\u7B26\u4E32");
+  const candidate = text(configured);
+  if (candidate === void 0) {
+    throw configError(
+      "\u662F\u5FC5\u914D\u9879:\u7ED9\u6302\u8F7D\u8282\u70B9\u914D providerConfig.baseUrl \u6307\u5411\u4F60\u7684 Grafana \u5B9E\u4F8B(\u5982 https://your-stack.grafana.net)\u3002Grafana \u6CA1\u6709\u516C\u5171\u7F3A\u7701\u5730\u5740,\u62FF\u4E0D\u5230\u5B83\u65E0\u6CD5\u51FA\u7AD9"
+    );
+  }
+  let url;
+  try {
+    url = assertPublicHttpUrl(candidate);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : "\u4E0D\u53EF\u7528";
+    throw configError(
+      `\u4E0D\u53EF\u7528(${detail})\u3002\u81EA\u5EFA Grafana \u5FC5\u987B\u662F**\u516C\u7F51\u53EF\u8FBE**\u7684 https \u5730\u5740:\u63D2\u4EF6\u4E0E\u7F51\u5173\u540C\u8FDB\u7A0B,\u6307\u5411\u5185\u7F51\u6216\u4FDD\u7559\u5730\u5740\u4F1A\u88AB\u51FA\u7AD9\u6821\u9A8C\u62D2\u7EDD`
+    );
+  }
+  if (url.protocol !== "https:") throw configError("\u5FC5\u987B\u7528 https");
+  url.search = "";
+  url.hash = "";
+  return `${url.origin}${url.pathname.replace(/\/+$/, "")}`;
+}
+function resolveTarget(ctx) {
+  return { apiKey: requireApiKey(ctx, SERVICE), baseUrl: resolveBaseUrl(ctx) };
+}
+function errorMessage(payload, status, statusText) {
+  const direct = text(payload);
+  if (direct !== void 0) return direct;
+  const fields = record(payload);
+  const message = text(fields?.message) ?? text(fields?.error) ?? text(fields?.detail) ?? text(fields?.title);
+  return message ?? text(statusText) ?? `Grafana request failed with ${status}`;
+}
+function buildUrl(baseUrl, input) {
+  const url = new URL(input.path.replace(/^\/+/, ""), `${baseUrl}/`);
+  for (const [key, value] of Object.entries(input.query ?? {})) {
+    if (value !== void 0) url.searchParams.set(key, String(value));
+  }
+  for (const [key, values] of Object.entries(input.multiValueQuery ?? {})) {
+    for (const value of values ?? []) url.searchParams.append(key, value);
+  }
+  return url.toString();
+}
+function readPayload(body) {
+  if (body.trim() === "") return null;
+  try {
+    return JSON.parse(body);
+  } catch {
+    return body;
+  }
+}
+async function request(target, input) {
+  let response;
+  let payload;
+  try {
+    response = await guardedFetch(buildUrl(target.baseUrl, input), {
+      method: input.method,
+      headers: {
+        accept: "application/json",
+        authorization: `Bearer ${target.apiKey}`,
+        ...input.body === void 0 ? {} : { "content-type": "application/json" }
+      },
+      body: input.body === void 0 ? void 0 : JSON.stringify(input.body)
+    });
+    payload = readPayload(await response.text());
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    const detail = error instanceof Error ? error.message : "unknown network error";
+    throw upstreamError(502, `Grafana request failed: ${detail}`);
+  }
+  if (!response.ok) {
+    throw upstreamError(response.status, errorMessage(payload, response.status, response.statusText));
+  }
+  return payload;
+}
+function cacheApiVersion(key, version) {
+  apiVersionCache.delete(key);
+  if (apiVersionCache.size >= API_VERSION_CACHE_MAX) {
+    const oldest = apiVersionCache.keys().next().value;
+    if (oldest !== void 0) apiVersionCache.delete(oldest);
+  }
+  apiVersionCache.set(key, version);
+}
+async function resolveApiVersion(target, group) {
+  const key = `${target.baseUrl}|${group}`;
+  const cached = apiVersionCache.get(key);
+  if (cached !== void 0) return cached;
+  try {
+    const payload = await request(target, { method: "GET", path: `/apis/${group}` });
+    const served = new Set(objectArray(record(payload)?.versions).map((entry) => text(entry.version)).filter((version) => version !== void 0));
+    const match = API_VERSION_PREFERENCE.find((version) => served.has(version));
+    if (match !== void 0) {
+      cacheApiVersion(key, match);
+      return match;
+    }
+  } catch {
+  }
+  return DEFAULT_API_VERSION;
+}
+async function appPath(target, resource, namespace) {
+  const group = API_GROUPS[resource];
+  const version = await resolveApiVersion(target, group);
+  const ns = encodeURIComponent(text(namespace) ?? DEFAULT_NAMESPACE);
+  return `/apis/${group}/${version}/namespaces/${ns}/${resource}`;
+}
+async function appResourcePath(target, resource, namespace, uid) {
+  const collection = await appPath(target, resource, namespace);
+  return `${collection}/${encodeURIComponent(requireText(uid, "uid"))}`;
+}
+function resourceBody(input) {
+  return {
+    metadata: compact({
+      name: text(input.uid),
+      generateName: text(input.generateName),
+      resourceVersion: text(input.resourceVersion),
+      annotations: input.parent === void 0 ? void 0 : { [FOLDER_PARENT_ANNOTATION]: input.parent }
+    }),
+    spec: input.spec
+  };
+}
+function normalizeAppResource(value, parentKey) {
+  const fields = record(value) ?? {};
+  const metadata = record(fields.metadata) ?? {};
+  const spec = record(fields.spec) ?? {};
+  const annotations = record(metadata.annotations) ?? {};
+  return {
+    uid: text(metadata.name) ?? text(metadata.uid) ?? null,
+    title: text(spec.title) ?? null,
+    namespace: text(metadata.namespace) ?? null,
+    resourceVersion: text(metadata.resourceVersion) ?? null,
+    [parentKey]: text(annotations[FOLDER_PARENT_ANNOTATION]) ?? null,
+    raw: fields
+  };
+}
+function normalizeSearchItem(value) {
+  return {
+    ...value,
+    id: integer(value.id) ?? null,
+    uid: text(value.uid) ?? null,
+    title: text(value.title) ?? null,
+    type: text(value.type) ?? null,
+    url: text(value.url) ?? null,
+    isStarred: boolean(value.isStarred) ?? null
+  };
+}
+function normalizeDataSource(value) {
+  const fields = record(value) ?? {};
+  return {
+    ...fields,
+    id: integer(fields.id) ?? null,
+    uid: text(fields.uid) ?? null,
+    name: text(fields.name) ?? null,
+    type: text(fields.type) ?? null,
+    access: text(fields.access) ?? null,
+    url: text(fields.url) ?? null,
+    isDefault: boolean(fields.isDefault) ?? null,
+    readOnly: boolean(fields.readOnly) ?? null
+  };
+}
+function deleted(payload) {
+  return { deleted: true, raw: record(payload) ?? null };
+}
+function dataSourcePath(uid) {
+  return `/api/datasources/uid/${encodeURIComponent(requireText(uid, "uid"))}`;
+}
+async function listFolders(input, ctx) {
+  const target = resolveTarget(ctx);
+  const payload = await request(target, {
+    method: "GET",
+    path: await appPath(target, "folders", input.namespace),
+    // Kubernetes 风格的分页:游标叫 `continue`,入参里叫 `continueToken`。
+    query: compact({ limit: input.limit, continue: text(input.continueToken) })
+  });
+  const fields = record(payload) ?? {};
+  return {
+    folders: objectArray(fields.items).map((item) => normalizeAppResource(item, "parentUid")),
+    continueToken: text(record(fields.metadata)?.continue) ?? null,
+    raw: fields
+  };
+}
+async function getFolder(input, ctx) {
+  const target = resolveTarget(ctx);
+  const payload = await request(target, {
+    method: "GET",
+    path: await appResourcePath(target, "folders", input.namespace, input.uid)
+  });
+  return { folder: normalizeAppResource(payload, "parentUid") };
+}
+async function createFolder(input, ctx) {
+  const target = resolveTarget(ctx);
+  const payload = await request(target, {
+    method: "POST",
+    path: await appPath(target, "folders", input.namespace),
+    body: resourceBody({
+      uid: input.uid,
+      generateName: input.generateName,
+      parent: text(input.parentUid),
+      spec: { title: requireText(input.title, "title") }
+    })
+  });
+  return { folder: normalizeAppResource(payload, "parentUid") };
+}
+async function updateFolder(input, ctx) {
+  const target = resolveTarget(ctx);
+  const uid = requireText(input.uid, "uid");
+  const payload = await request(target, {
+    method: "PUT",
+    path: await appResourcePath(target, "folders", input.namespace, uid),
+    // 更新时 `metadata.name` 必须等于路径上的 uid,故拿它当兜底值。
+    body: resourceBody({
+      uid,
+      resourceVersion: input.resourceVersion,
+      parent: text(input.parentUid),
+      spec: { title: requireText(input.title, "title") }
+    })
+  });
+  return { folder: normalizeAppResource(payload, "parentUid") };
+}
+async function deleteFolder(input, ctx) {
+  const target = resolveTarget(ctx);
+  const payload = await request(target, {
+    method: "DELETE",
+    path: await appResourcePath(target, "folders", input.namespace, input.uid)
+  });
+  return deleted(payload);
+}
+async function searchDashboards(input, ctx) {
+  const payload = await request(resolveTarget(ctx), {
+    method: "GET",
+    path: "/api/search",
+    query: compact({
+      query: text(input.query),
+      type: text(input.type),
+      starred: input.starred,
+      limit: input.limit,
+      page: input.page
+    }),
+    multiValueQuery: {
+      tag: stringArray(input.tags),
+      dashboardUIDs: stringArray(input.dashboardUids),
+      folderUIDs: stringArray(input.folderUids)
+    }
+  });
+  const results = objectArray(payload);
+  return { results: results.map(normalizeSearchItem), raw: results };
+}
+async function getDashboard(input, ctx) {
+  const target = resolveTarget(ctx);
+  const payload = await request(target, {
+    method: "GET",
+    path: await appResourcePath(target, "dashboards", input.namespace, input.uid)
+  });
+  return { dashboard: normalizeAppResource(payload, "folderUid") };
+}
+async function createDashboard(input, ctx) {
+  const target = resolveTarget(ctx);
+  const payload = await request(target, {
+    method: "POST",
+    path: await appPath(target, "dashboards", input.namespace),
+    body: resourceBody({
+      uid: input.uid,
+      generateName: input.generateName,
+      parent: text(input.folderUid),
+      spec: requireObject(input.spec, "spec")
+    })
+  });
+  return { dashboard: normalizeAppResource(payload, "folderUid") };
+}
+async function updateDashboard(input, ctx) {
+  const target = resolveTarget(ctx);
+  const uid = requireText(input.uid, "uid");
+  const payload = await request(target, {
+    method: "PUT",
+    path: await appResourcePath(target, "dashboards", input.namespace, uid),
+    body: resourceBody({
+      uid,
+      resourceVersion: input.resourceVersion,
+      parent: text(input.folderUid),
+      spec: requireObject(input.spec, "spec")
+    })
+  });
+  return { dashboard: normalizeAppResource(payload, "folderUid") };
+}
+async function deleteDashboard(input, ctx) {
+  const target = resolveTarget(ctx);
+  const payload = await request(target, {
+    method: "DELETE",
+    path: await appResourcePath(target, "dashboards", input.namespace, input.uid)
+  });
+  return deleted(payload);
+}
+async function listDataSources(_input, ctx) {
+  const payload = await request(resolveTarget(ctx), { method: "GET", path: "/api/datasources" });
+  const records = objectArray(payload);
+  return { dataSources: records.map(normalizeDataSource), raw: records };
+}
+async function getDataSource(input, ctx) {
+  const payload = await request(resolveTarget(ctx), { method: "GET", path: dataSourcePath(input.uid) });
+  return { dataSource: normalizeDataSource(payload) };
+}
+async function createDataSource(input, ctx) {
+  const payload = await request(resolveTarget(ctx), {
+    method: "POST",
+    path: "/api/datasources",
+    body: requireObject(input.dataSource, "dataSource")
+  });
+  return {
+    dataSource: normalizeDataSource(record(payload)?.datasource ?? payload),
+    raw: record(payload) ?? {}
+  };
+}
+async function updateDataSource(input, ctx) {
+  const payload = await request(resolveTarget(ctx), {
+    method: "PUT",
+    path: dataSourcePath(input.uid),
+    body: requireObject(input.dataSource, "dataSource")
+  });
+  return {
+    dataSource: normalizeDataSource(record(payload)?.datasource ?? payload),
+    raw: record(payload) ?? {}
+  };
+}
+async function deleteDataSource(input, ctx) {
+  const payload = await request(resolveTarget(ctx), { method: "DELETE", path: dataSourcePath(input.uid) });
+  return deleted(payload);
+}
+async function listAlertRules(_input, ctx) {
+  const payload = await request(resolveTarget(ctx), { method: "GET", path: "/api/v1/provisioning/alert-rules" });
+  return { alertRules: objectArray(payload) };
+}
+async function getAlertRule(input, ctx) {
+  const uid = encodeURIComponent(requireText(input.uid, "uid"));
+  const payload = await request(resolveTarget(ctx), {
+    method: "GET",
+    path: `/api/v1/provisioning/alert-rules/${uid}`
+  });
+  return { alertRule: record(payload) ?? {} };
+}
+async function listAlertInstances(input, ctx) {
+  const payload = await request(resolveTarget(ctx), {
+    method: "GET",
+    // 内置 Alertmanager 的 v2 端点,与 App Platform 的版本协商无关。
+    path: "/api/alertmanager/grafana/api/v2/alerts",
+    query: compact({ active: input.active, silenced: input.silenced, inhibited: input.inhibited })
+  });
+  return { alertInstances: objectArray(payload) };
+}
+async function listContactPoints(_input, ctx) {
+  const payload = await request(resolveTarget(ctx), { method: "GET", path: "/api/v1/provisioning/contact-points" });
+  return { contactPoints: objectArray(payload) };
+}
+
+// ../plugins/src/grafana/schema.ts
+var listFoldersInput = external_exports.strictObject({
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional(),
+  limit: external_exports.int().min(1).describe("Maximum number of folders to request.").optional(),
+  continueToken: external_exports.string().min(1).describe("The Grafana continue token from a previous folder list response.").optional()
+}).describe("Input for listing Grafana folders.");
+var listFoldersOutput = external_exports.strictObject({
+  folders: external_exports.array(external_exports.strictObject({
+    uid: external_exports.string().describe("The Grafana folder UID.").nullable().optional(),
+    title: external_exports.string().describe("The folder title.").nullable().optional(),
+    namespace: external_exports.string().describe("The namespace that owns the folder.").nullable().optional(),
+    resourceVersion: external_exports.string().describe("The folder resource version.").nullable().optional(),
+    parentUid: external_exports.string().describe("The parent folder UID when the folder is nested.").nullable().optional(),
+    raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+  }).describe("A normalized Grafana folder.")).describe("Folders returned by Grafana.").optional(),
+  continueToken: external_exports.string().describe("The next Grafana continue token, or null on the last page.").nullable().optional(),
+  raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+}).describe("A page of Grafana folders.");
+var getFolderInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana folder UID."),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional()
+}).describe("Input for retrieving a Grafana folder.");
+var getFolderOutput = external_exports.strictObject({
+  folder: external_exports.strictObject({
+    uid: external_exports.string().describe("The Grafana folder UID.").nullable().optional(),
+    title: external_exports.string().describe("The folder title.").nullable().optional(),
+    namespace: external_exports.string().describe("The namespace that owns the folder.").nullable().optional(),
+    resourceVersion: external_exports.string().describe("The folder resource version.").nullable().optional(),
+    parentUid: external_exports.string().describe("The parent folder UID when the folder is nested.").nullable().optional(),
+    raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+  }).describe("A normalized Grafana folder.").optional()
+}).describe("A Grafana folder response.");
+var createFolderInput = external_exports.strictObject({
+  title: external_exports.string().min(1).describe("The new folder title."),
+  uid: external_exports.string().min(1).describe("Optional explicit Grafana folder UID.").optional(),
+  generateName: external_exports.string().min(1).describe("Optional UID prefix Grafana can use to generate a folder UID.").optional(),
+  parentUid: external_exports.string().min(1).describe("Optional parent folder UID for a nested folder.").optional(),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional()
+}).describe("Input for creating a Grafana folder.");
+var createFolderOutput = external_exports.strictObject({
+  folder: external_exports.strictObject({
+    uid: external_exports.string().describe("The Grafana folder UID.").nullable().optional(),
+    title: external_exports.string().describe("The folder title.").nullable().optional(),
+    namespace: external_exports.string().describe("The namespace that owns the folder.").nullable().optional(),
+    resourceVersion: external_exports.string().describe("The folder resource version.").nullable().optional(),
+    parentUid: external_exports.string().describe("The parent folder UID when the folder is nested.").nullable().optional(),
+    raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+  }).describe("A normalized Grafana folder.").optional()
+}).describe("The created Grafana folder.");
+var updateFolderInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana folder UID."),
+  title: external_exports.string().min(1).describe("The updated folder title."),
+  parentUid: external_exports.string().min(1).describe("Optional parent folder UID for a nested folder.").optional(),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional(),
+  resourceVersion: external_exports.string().min(1).describe("The current Grafana resource version when required by the instance.").optional()
+}).describe("Input for updating a Grafana folder.");
+var updateFolderOutput = external_exports.strictObject({
+  folder: external_exports.strictObject({
+    uid: external_exports.string().describe("The Grafana folder UID.").nullable().optional(),
+    title: external_exports.string().describe("The folder title.").nullable().optional(),
+    namespace: external_exports.string().describe("The namespace that owns the folder.").nullable().optional(),
+    resourceVersion: external_exports.string().describe("The folder resource version.").nullable().optional(),
+    parentUid: external_exports.string().describe("The parent folder UID when the folder is nested.").nullable().optional(),
+    raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+  }).describe("A normalized Grafana folder.").optional()
+}).describe("The updated Grafana folder.");
+var deleteFolderInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana folder UID."),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional()
+}).describe("Input for deleting a Grafana folder.");
+var deleteFolderOutput = external_exports.strictObject({
+  deleted: external_exports.boolean().describe("Whether the connector completed the delete request.").optional(),
+  raw: external_exports.looseObject({}).describe("The raw Grafana API object.").nullable().optional()
+}).describe("Grafana folder deletion result.");
+var searchDashboardsInput = external_exports.strictObject({
+  query: external_exports.string().min(1).describe("Free-text search query.").optional(),
+  tags: external_exports.array(external_exports.string().min(1).describe("A dashboard tag.")).describe("Dashboard tags to search for.").optional(),
+  type: external_exports.enum(["dash-db", "dash-folder"]).describe("Restrict results to dashboards or folders.").optional(),
+  dashboardUids: external_exports.array(external_exports.string().min(1).describe("A dashboard UID.")).describe("Dashboard UIDs to search for.").optional(),
+  folderUids: external_exports.array(external_exports.string().min(1).describe("A folder UID.")).describe("Folder UIDs to search in.").optional(),
+  starred: external_exports.boolean().describe("Whether to return only starred dashboards.").optional(),
+  limit: external_exports.int().min(1).max(5e3).describe("Maximum number of search results to return.").optional(),
+  page: external_exports.int().min(1).describe("Search results page number. Numbering starts at 1.").optional()
+}).describe("Input for searching Grafana folders and dashboards.");
+var searchDashboardsOutput = external_exports.strictObject({
+  results: external_exports.array(external_exports.looseObject({
+    id: external_exports.int().describe("The numeric Grafana search result ID.").nullable(),
+    uid: external_exports.string().describe("The Grafana dashboard or folder UID.").nullable(),
+    title: external_exports.string().describe("The search result title.").nullable(),
+    type: external_exports.string().describe("The Grafana result type, such as dash-db or dash-folder.").nullable(),
+    url: external_exports.string().describe("The Grafana UI path for the result.").nullable(),
+    isStarred: external_exports.boolean().describe("Whether the dashboard is starred.").nullable()
+  }).describe("A Grafana folder or dashboard search result.")).describe("Search results returned by Grafana.").optional(),
+  raw: external_exports.array(external_exports.looseObject({}).describe("The raw Grafana API object.")).describe("Raw Grafana search result objects.").optional()
+}).describe("Grafana folder and dashboard search results.");
+var getDashboardInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana dashboard UID."),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional()
+}).describe("Input for retrieving a Grafana dashboard.");
+var getDashboardOutput = external_exports.strictObject({
+  dashboard: external_exports.strictObject({
+    uid: external_exports.string().describe("The dashboard UID.").nullable().optional(),
+    title: external_exports.string().describe("The dashboard title.").nullable().optional(),
+    namespace: external_exports.string().describe("The namespace that owns the dashboard.").nullable().optional(),
+    resourceVersion: external_exports.string().describe("The dashboard resource version.").nullable().optional(),
+    folderUid: external_exports.string().describe("The folder UID that contains the dashboard.").nullable().optional(),
+    raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+  }).describe("A normalized Grafana dashboard resource.").optional()
+}).describe("A Grafana dashboard response.");
+var createDashboardInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("Optional explicit Grafana dashboard UID.").optional(),
+  generateName: external_exports.string().min(1).describe("Optional UID prefix Grafana can use to generate a dashboard UID.").optional(),
+  folderUid: external_exports.string().min(1).describe("Optional folder UID for the new dashboard.").optional(),
+  spec: external_exports.looseObject({}).describe("The Grafana dashboard spec JSON. This is forwarded to Grafana as the dashboard body."),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional()
+}).describe("Input for creating a Grafana dashboard.");
+var createDashboardOutput = external_exports.strictObject({
+  dashboard: external_exports.strictObject({
+    uid: external_exports.string().describe("The dashboard UID.").nullable().optional(),
+    title: external_exports.string().describe("The dashboard title.").nullable().optional(),
+    namespace: external_exports.string().describe("The namespace that owns the dashboard.").nullable().optional(),
+    resourceVersion: external_exports.string().describe("The dashboard resource version.").nullable().optional(),
+    folderUid: external_exports.string().describe("The folder UID that contains the dashboard.").nullable().optional(),
+    raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+  }).describe("A normalized Grafana dashboard resource.").optional()
+}).describe("The created Grafana dashboard.");
+var updateDashboardInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana dashboard UID."),
+  folderUid: external_exports.string().min(1).describe("Optional folder UID for the dashboard.").optional(),
+  spec: external_exports.looseObject({}).describe("The Grafana dashboard spec JSON. This is forwarded to Grafana as the dashboard body."),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional(),
+  resourceVersion: external_exports.string().min(1).describe("The current Grafana resource version when required by the instance.").optional()
+}).describe("Input for updating a Grafana dashboard.");
+var updateDashboardOutput = external_exports.strictObject({
+  dashboard: external_exports.strictObject({
+    uid: external_exports.string().describe("The dashboard UID.").nullable().optional(),
+    title: external_exports.string().describe("The dashboard title.").nullable().optional(),
+    namespace: external_exports.string().describe("The namespace that owns the dashboard.").nullable().optional(),
+    resourceVersion: external_exports.string().describe("The dashboard resource version.").nullable().optional(),
+    folderUid: external_exports.string().describe("The folder UID that contains the dashboard.").nullable().optional(),
+    raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+  }).describe("A normalized Grafana dashboard resource.").optional()
+}).describe("The updated Grafana dashboard.");
+var deleteDashboardInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana dashboard UID."),
+  namespace: external_exports.string().min(1).describe("The Grafana API namespace. Use default for the main organization.").optional()
+}).describe("Input for deleting a Grafana dashboard.");
+var deleteDashboardOutput = external_exports.strictObject({
+  deleted: external_exports.boolean().describe("Whether the connector completed the delete request.").optional(),
+  raw: external_exports.looseObject({}).describe("The raw Grafana API object.").nullable().optional()
+}).describe("Grafana dashboard deletion result.");
+var listDataSourcesInput = external_exports.strictObject({}).describe("No input is required to list Grafana data sources.");
+var listDataSourcesOutput = external_exports.strictObject({
+  dataSources: external_exports.array(external_exports.looseObject({
+    id: external_exports.int().describe("The numeric Grafana data source ID.").nullable(),
+    uid: external_exports.string().describe("The Grafana data source UID.").nullable(),
+    name: external_exports.string().describe("The data source name.").nullable(),
+    type: external_exports.string().describe("The data source plugin type.").nullable(),
+    access: external_exports.string().describe("The data source access mode.").nullable(),
+    url: external_exports.string().describe("The data source URL when returned by Grafana.").nullable(),
+    isDefault: external_exports.boolean().describe("Whether this data source is the default.").nullable(),
+    readOnly: external_exports.boolean().describe("Whether this data source is read-only.").nullable()
+  }).describe("A Grafana data source record.")).describe("Data sources returned by Grafana.").optional(),
+  raw: external_exports.array(external_exports.looseObject({}).describe("The raw Grafana API object.")).describe("Raw Grafana data source objects.").optional()
+}).describe("Grafana data sources.");
+var getDataSourceInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana data source UID.").optional()
+}).describe("Input for retrieving a Grafana data source.");
+var getDataSourceOutput = external_exports.strictObject({
+  dataSource: external_exports.looseObject({
+    id: external_exports.int().describe("The numeric Grafana data source ID.").nullable(),
+    uid: external_exports.string().describe("The Grafana data source UID.").nullable(),
+    name: external_exports.string().describe("The data source name.").nullable(),
+    type: external_exports.string().describe("The data source plugin type.").nullable(),
+    access: external_exports.string().describe("The data source access mode.").nullable(),
+    url: external_exports.string().describe("The data source URL when returned by Grafana.").nullable(),
+    isDefault: external_exports.boolean().describe("Whether this data source is the default.").nullable(),
+    readOnly: external_exports.boolean().describe("Whether this data source is read-only.").nullable()
+  }).describe("A Grafana data source record.").optional()
+}).describe("A Grafana data source response.");
+var createDataSourceInput = external_exports.strictObject({
+  dataSource: external_exports.looseObject({}).describe("The Grafana data source payload. Use official Grafana data source fields such as name, type, access, url, jsonData, and secureJsonData.").optional()
+}).describe("Input for creating a Grafana data source.");
+var createDataSourceOutput = external_exports.strictObject({
+  dataSource: external_exports.looseObject({
+    id: external_exports.int().describe("The numeric Grafana data source ID.").nullable(),
+    uid: external_exports.string().describe("The Grafana data source UID.").nullable(),
+    name: external_exports.string().describe("The data source name.").nullable(),
+    type: external_exports.string().describe("The data source plugin type.").nullable(),
+    access: external_exports.string().describe("The data source access mode.").nullable(),
+    url: external_exports.string().describe("The data source URL when returned by Grafana.").nullable(),
+    isDefault: external_exports.boolean().describe("Whether this data source is the default.").nullable(),
+    readOnly: external_exports.boolean().describe("Whether this data source is read-only.").nullable()
+  }).describe("A Grafana data source record.").optional(),
+  raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+}).describe("The created Grafana data source result.");
+var updateDataSourceInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana data source UID.").optional(),
+  dataSource: external_exports.looseObject({}).describe("The Grafana data source payload. Use official Grafana data source fields such as name, type, access, url, jsonData, and secureJsonData.").optional()
+}).describe("Input for updating a Grafana data source.");
+var updateDataSourceOutput = external_exports.strictObject({
+  dataSource: external_exports.looseObject({
+    id: external_exports.int().describe("The numeric Grafana data source ID.").nullable(),
+    uid: external_exports.string().describe("The Grafana data source UID.").nullable(),
+    name: external_exports.string().describe("The data source name.").nullable(),
+    type: external_exports.string().describe("The data source plugin type.").nullable(),
+    access: external_exports.string().describe("The data source access mode.").nullable(),
+    url: external_exports.string().describe("The data source URL when returned by Grafana.").nullable(),
+    isDefault: external_exports.boolean().describe("Whether this data source is the default.").nullable(),
+    readOnly: external_exports.boolean().describe("Whether this data source is read-only.").nullable()
+  }).describe("A Grafana data source record.").optional(),
+  raw: external_exports.looseObject({}).describe("The raw Grafana API object.").optional()
+}).describe("The updated Grafana data source result.");
+var deleteDataSourceInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana data source UID.").optional()
+}).describe("Input for deleting a Grafana data source.");
+var deleteDataSourceOutput = external_exports.strictObject({
+  deleted: external_exports.boolean().describe("Whether the connector completed the delete request.").optional(),
+  raw: external_exports.looseObject({}).describe("The raw Grafana API object.").nullable().optional()
+}).describe("Grafana data source deletion result.");
+var listAlertRulesInput = external_exports.strictObject({}).describe("No input is required to list Grafana alert rules.");
+var listAlertRulesOutput = external_exports.strictObject({
+  alertRules: external_exports.array(external_exports.looseObject({}).describe("A Grafana-managed alert rule.")).describe("Alert rules returned by Grafana.").optional()
+}).describe("Grafana-managed alert rules.");
+var getAlertRuleInput = external_exports.strictObject({
+  uid: external_exports.string().min(1).describe("The Grafana alert rule UID.")
+}).describe("Input for retrieving a Grafana alert rule.");
+var getAlertRuleOutput = external_exports.strictObject({
+  alertRule: external_exports.looseObject({}).describe("A Grafana-managed alert rule.").optional()
+}).describe("A Grafana-managed alert rule.");
+var listAlertInstancesInput = external_exports.strictObject({
+  active: external_exports.boolean().describe("Include active (firing) alert instances.").optional(),
+  silenced: external_exports.boolean().describe("Include silenced alert instances.").optional(),
+  inhibited: external_exports.boolean().describe("Include inhibited alert instances.").optional()
+}).describe("Input for listing Grafana alert instances.");
+var listAlertInstancesOutput = external_exports.strictObject({
+  alertInstances: external_exports.array(external_exports.looseObject({}).describe("A firing or pending Grafana alert instance.")).describe("Alert instances returned by Grafana.").optional()
+}).describe("Grafana alert instances.");
+var listContactPointsInput = external_exports.strictObject({}).describe("No input is required to list Grafana contact points.");
+var listContactPointsOutput = external_exports.strictObject({
+  contactPoints: external_exports.array(external_exports.looseObject({}).describe("A Grafana notification contact point.")).describe("Contact points returned by Grafana.").optional()
+}).describe("Grafana notification contact points.");
+var grafanaActions = {
+  list_folders: {
+    description: "List Grafana folders in a namespace with optional pagination.",
+    effect: "read",
+    inputSchema: listFoldersInput,
+    outputSchema: external_exports.toJSONSchema(listFoldersOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_folder: {
+    description: "Retrieve one Grafana folder by UID.",
+    effect: "read",
+    inputSchema: getFolderInput,
+    outputSchema: external_exports.toJSONSchema(getFolderOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_folder: {
+    description: "Create a Grafana folder in a namespace.",
+    effect: "write",
+    inputSchema: createFolderInput,
+    outputSchema: external_exports.toJSONSchema(createFolderOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_folder: {
+    description: "Update the title or parent folder for a Grafana folder.",
+    effect: "write",
+    inputSchema: updateFolderInput,
+    outputSchema: external_exports.toJSONSchema(updateFolderOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_folder: {
+    description: "Delete a Grafana folder by UID.",
+    effect: "destructive",
+    inputSchema: deleteFolderInput,
+    outputSchema: external_exports.toJSONSchema(deleteFolderOutput, { io: "output", unrepresentable: "any" })
+  },
+  search_dashboards: {
+    description: "Search Grafana folders and dashboards by query, tags, type, folder, and pagination.",
+    effect: "read",
+    inputSchema: searchDashboardsInput,
+    outputSchema: external_exports.toJSONSchema(searchDashboardsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_dashboard: {
+    description: "Retrieve one Grafana dashboard resource by UID.",
+    effect: "read",
+    inputSchema: getDashboardInput,
+    outputSchema: external_exports.toJSONSchema(getDashboardOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_dashboard: {
+    description: "Create a Grafana dashboard resource in a namespace.",
+    effect: "write",
+    inputSchema: createDashboardInput,
+    outputSchema: external_exports.toJSONSchema(createDashboardOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_dashboard: {
+    description: "Replace a Grafana dashboard resource by UID.",
+    effect: "write",
+    inputSchema: updateDashboardInput,
+    outputSchema: external_exports.toJSONSchema(updateDashboardOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_dashboard: {
+    description: "Delete a Grafana dashboard resource by UID.",
+    effect: "destructive",
+    inputSchema: deleteDashboardInput,
+    outputSchema: external_exports.toJSONSchema(deleteDashboardOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_data_sources: {
+    description: "List Grafana data sources available to the service account token.",
+    effect: "read",
+    inputSchema: listDataSourcesInput,
+    outputSchema: external_exports.toJSONSchema(listDataSourcesOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_data_source: {
+    description: "Retrieve one Grafana data source by UID.",
+    effect: "read",
+    inputSchema: getDataSourceInput,
+    outputSchema: external_exports.toJSONSchema(getDataSourceOutput, { io: "output", unrepresentable: "any" })
+  },
+  create_data_source: {
+    description: "Create a Grafana data source using a JSON payload accepted by Grafana.",
+    effect: "write",
+    inputSchema: createDataSourceInput,
+    outputSchema: external_exports.toJSONSchema(createDataSourceOutput, { io: "output", unrepresentable: "any" })
+  },
+  update_data_source: {
+    description: "Update a Grafana data source by UID using fields accepted by Grafana.",
+    effect: "write",
+    inputSchema: updateDataSourceInput,
+    outputSchema: external_exports.toJSONSchema(updateDataSourceOutput, { io: "output", unrepresentable: "any" })
+  },
+  delete_data_source: {
+    description: "Delete a Grafana data source by UID.",
+    effect: "destructive",
+    inputSchema: deleteDataSourceInput,
+    outputSchema: external_exports.toJSONSchema(deleteDataSourceOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_alert_rules: {
+    description: "List all Grafana-managed alert rules via the provisioning API.",
+    effect: "read",
+    inputSchema: listAlertRulesInput,
+    outputSchema: external_exports.toJSONSchema(listAlertRulesOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_alert_rule: {
+    description: "Retrieve one Grafana-managed alert rule by UID via the provisioning API.",
+    effect: "read",
+    inputSchema: getAlertRuleInput,
+    outputSchema: external_exports.toJSONSchema(getAlertRuleOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_alert_instances: {
+    description: "List currently firing or pending Grafana alert instances from the built-in Alertmanager.",
+    effect: "read",
+    inputSchema: listAlertInstancesInput,
+    outputSchema: external_exports.toJSONSchema(listAlertInstancesOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_contact_points: {
+    description: "List Grafana notification contact points via the provisioning API.",
+    effect: "read",
+    inputSchema: listContactPointsInput,
+    outputSchema: external_exports.toJSONSchema(listContactPointsOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/grafana/index.ts
+function createGrafanaPlugin() {
+  return createProviderPlugin({
+    description: "Grafana",
+    actions: grafanaActions,
+    credentialProbe: "search_dashboards",
+    handlers: {
+      list_folders: listFolders,
+      get_folder: getFolder,
+      create_folder: createFolder,
+      update_folder: updateFolder,
+      delete_folder: deleteFolder,
+      search_dashboards: searchDashboards,
+      get_dashboard: getDashboard,
+      create_dashboard: createDashboard,
+      update_dashboard: updateDashboard,
+      delete_dashboard: deleteDashboard,
+      list_data_sources: listDataSources,
+      get_data_source: getDataSource,
+      create_data_source: createDataSource,
+      update_data_source: updateDataSource,
+      delete_data_source: deleteDataSource,
+      list_alert_rules: listAlertRules,
+      get_alert_rule: getAlertRule,
+      list_alert_instances: listAlertInstances,
+      list_contact_points: listContactPoints
+    }
+  });
+}
+var grafana_default = createGrafanaPlugin();
+export {
+  createGrafanaPlugin,
+  grafana_default as default
+};