@nimbus-dev/connectors 0.2.0 → 0.2.2

package/connectors/pipedrive/src/tools.ts

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { requiredEnv } from "../../../shared/env-json-api.ts";
+import { matchesResult, searchToolInputSchema } from "../../../shared/mcp-search-tool.ts";
+import { mcpJsonResult as jsonResult } from "../../../shared/mcp-tool-kit.ts";
+import type { ZodToolRegistrar } from "../../../shared/run-read-only-mcp-connector.ts";
+import { filterPipedriveDeals } from "./search-filter.ts";
+
+const BASE = "https://api.pipedrive.com";
+
+/** Pipedrive takes its token in the query string, not a header. */
+function withToken(path: string): string {
+  const sep = path.includes("?") ? "&" : "?";
+  return `${BASE}${path}${sep}api_token=${encodeURIComponent(requiredEnv("PIPEDRIVE_TOKEN"))}`;
+}
+
+async function pipedriveGet(path: string, resourceLabel: string): Promise<unknown> {
+  const res = await fetch(withToken(path), { headers: { Accept: "application/json" } });
+  const text = await res.text();
+  if (!res.ok) {
+    throw new Error(`Pipedrive ${resourceLabel} ${String(res.status)}: ${text.slice(0, 400)}`);
+  }
+  return JSON.parse(text) as unknown;
+}
+
+/** Tool names exposed by this connector — for contract/introspection tests. */
+export const PIPEDRIVE_TOOL_NAMES = [
+  "pipedrive_list",
+  "pipedrive_get",
+  "pipedrive_search",
+] as const;
+
+export function registerPipedriveTools(reg: ZodToolRegistrar): void {
+  reg(
+    "pipedrive_list",
+    "List the user's Pipedrive deals (`GET /v1/deals?limit=100`). Returns the `{ success, data: [...], additional_data: { pagination } }` envelope — `data` holds the deal objects (and may be null when there are no deals).",
+    z.object({}),
+    async () => {
+      return jsonResult(await pipedriveGet(`/v1/deals?limit=100`, "deals"));
+    },
+  );
+
+  reg(
+    "pipedrive_get",
+    "Fetch one Pipedrive deal by its id (`GET /v1/deals/{id}`). Returns the `{ success, data: {...} }` envelope. Throws when no match is found.",
+    z.object({
+      id: z.string().min(1),
+    }),
+    async (p) => {
+      return jsonResult(await pipedriveGet(`/v1/deals/${encodeURIComponent(p.id)}`, "deal"));
+    },
+  );
+
+  reg(
+    "pipedrive_search",
+    "Substring search across the user's Pipedrive deals (first page only). Matches the query against the deal title, status, organization name, person name, owner name, and label (case-insensitive). Returns a `{ matches: [...] }` envelope.",
+    searchToolInputSchema(100),
+    async (p) => {
+      const root = await pipedriveGet(`/v1/deals?limit=100`, "deals");
+      const data = (root as { data?: unknown } | null)?.data;
+      return matchesResult(data, filterPipedriveDeals, p);
+    },
+  );
+}

package/connectors/powerbi/src/search-filter.ts

@@ -1,22 +1,9 @@
 import {
-  asRecord,
   makeQueryFilter,
+  recordFieldsFromKeys,
   type SearchMatchOptions,
 } from "../../../shared/search-filter.ts";
 
 export type PowerBiSearchMatchOptions = SearchMatchOptions;
 
-function stringAt(row: Record<string, unknown>, key: string): string {
-  const v = row[key];
-  return typeof v === "string" ? v : "";
-}
-
-function fieldsOf(item: unknown): readonly string[] | null {
-  const row = asRecord(item);
-  if (row === undefined) {
-    return null;
-  }
-  return [stringAt(row, "name"), stringAt(row, "description")];
-}
-
-export const filterPowerBiReports = makeQueryFilter(fieldsOf);
+export const filterPowerBiReports = makeQueryFilter(recordFieldsFromKeys(["name", "description"]));

package/connectors/powerbi/src/server.ts

@@ -1,21 +1,16 @@
 import { z } from "zod";
 import { type ConsentServer, createWriteToolRegistrar } from "../../../shared/consent-kit.ts";
+import { cursorListInputSchema } from "../../../shared/cursor-list-tool.ts";
+import { requiredEnv } from "../../../shared/env-json-api.ts";
 import { searchToolInputSchema } from "../../../shared/mcp-search-tool.ts";
 import { fetchWithTimeout, mcpJsonResult as jsonResult } from "../../../shared/mcp-tool-kit.ts";
 import {
   runReadOnlyMcpConnector,
   type ZodToolRegistrar,
 } from "../../../shared/run-read-only-mcp-connector.ts";
+import { asRecord } from "../../../shared/search-filter.ts";
 import { filterPowerBiReports } from "./search-filter.ts";
 
-function requireEnv(name: string): string {
-  const v = process.env[name]?.trim();
-  if (v === undefined || v === "") {
-    throw new Error(`${name} is not set`);
-  }
-  return v;
-}
-
 async function fetchAccessToken(
   tenantId: string,
   clientId: string,
@@ -39,11 +34,11 @@ async function fetchAccessToken(
   if (!res.ok) {
     throw new Error(`Power BI token error ${String(res.status)}: ${text.slice(0, 400)}`);
   }
-  const parsed = JSON.parse(text) as unknown;
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+  const root = asRecord(JSON.parse(text) as unknown);
+  if (root === undefined) {
     throw new Error("Power BI token response: unexpected shape");
   }
-  const token = (parsed as Record<string, unknown>)["access_token"];
+  const token = root["access_token"];
   if (typeof token !== "string" || token === "") {
     throw new Error("Power BI token response: missing access_token");
   }
@@ -55,18 +50,12 @@ const POWERBI_API_BASE = "https://api.powerbi.com";
 /** Mint an AAD access token from the connector's client-credentials env. */
 async function accessToken(): Promise<string> {
   return fetchAccessToken(
-    requireEnv("POWERBI_TENANT_ID"),
-    requireEnv("POWERBI_CLIENT_ID"),
-    requireEnv("POWERBI_CLIENT_SECRET"),
+    requiredEnv("POWERBI_TENANT_ID"),
+    requiredEnv("POWERBI_CLIENT_ID"),
+    requiredEnv("POWERBI_CLIENT_SECRET"),
   );
 }
 
-function asRec(value: unknown): Record<string, unknown> | undefined {
-  return value !== null && typeof value === "object" && !Array.isArray(value)
-    ? (value as Record<string, unknown>)
-    : undefined;
-}
-
 async function listReports(accessToken: string): Promise<unknown[]> {
   const res = await fetchWithTimeout("https://api.powerbi.com/v1.0/myorg/reports", {
     headers: { Authorization: `Bearer ${accessToken}`, Accept: "application/json" },
@@ -75,7 +64,7 @@ async function listReports(accessToken: string): Promise<unknown[]> {
   if (!res.ok) {
     throw new Error(`Power BI reports error ${String(res.status)}: ${text.slice(0, 400)}`);
   }
-  const value = asRec(JSON.parse(text) as unknown)?.["value"];
+  const value = asRecord(JSON.parse(text) as unknown)?.["value"];
   return Array.isArray(value) ? value : [];
 }
 
@@ -86,11 +75,11 @@ async function fetchDatasetTables(accessToken: string, datasetId: string): Promi
     { headers: { Authorization: `Bearer ${accessToken}`, Accept: "application/json" } },
   );
   if (!res.ok) return [];
-  const value = asRec(JSON.parse(await res.text()) as unknown)?.["value"];
+  const value = asRecord(JSON.parse(await res.text()) as unknown)?.["value"];
   if (!Array.isArray(value)) return [];
   const out: string[] = [];
   for (const item of value) {
-    const name = asRec(item)?.["name"];
+    const name = asRecord(item)?.["name"];
     if (typeof name === "string" && name !== "") out.push(name);
   }
   return out;
@@ -98,7 +87,7 @@ async function fetchDatasetTables(accessToken: string, datasetId: string): Promi
 
 /** Attach each report's dataset-table refs in-session, so the gateway never makes a second credentialed call. */
 async function expandReport(accessToken: string, report: unknown): Promise<unknown> {
-  const r = asRec(report);
+  const r = asRecord(report);
   if (r === undefined) return report;
   const datasetId = r["datasetId"];
   const datasetTables =
@@ -108,6 +97,27 @@ async function expandReport(accessToken: string, report: unknown): Promise<unkno
   return { ...r, datasetTables };
 }
 
+/**
+ * Queue a refresh by POSTing `{ notifyOption: "NoNotification" }` to a `…/refreshes` URL. Power BI
+ * answers 202 and refreshes asynchronously; a failure throws `Power BI <what> refresh <status>`.
+ */
+async function queueRefresh(
+  accessToken: string,
+  url: string,
+  what: "dataset" | "dataflow",
+): Promise<void> {
+  const res = await fetchWithTimeout(url, {
+    method: "POST",
+    headers: { Authorization: `Bearer ${accessToken}`, "Content-Type": "application/json" },
+    body: JSON.stringify({ notifyOption: "NoNotification" }),
+  });
+  if (!res.ok) {
+    throw new Error(
+      `Power BI ${what} refresh ${String(res.status)}: ${(await res.text()).slice(0, 400)}`,
+    );
+  }
+}
+
 export function registerPowerBiTools(reg: ZodToolRegistrar, server: unknown): void {
   // Despite the read-only helper's name, this connector exposes write tools. The consent
   // kit needs the real server, which the helper now passes through as its second argument.
@@ -120,19 +130,13 @@ export function registerPowerBiTools(reg: ZodToolRegistrar, server: unknown): vo
   reg(
     "powerbi_list",
     "List Power BI reports (`GET /v1.0/myorg/reports`), each expanded with its dataset-table refs for lineage. The reports endpoint returns the full org list in one response and has no reliable server paging, so this is a single fetch returning ALL reports with `nextCursor: null` (`cursor`/`limit` are accepted for `_list` API symmetry but never truncate).",
-    z.object({
-      cursor: z.string().nullable().optional(),
-      limit: z.number().int().min(1).max(500).optional(),
-    }),
+    cursorListInputSchema(),
     async (_p) => {
-      const tenantId = requireEnv("POWERBI_TENANT_ID");
-      const clientId = requireEnv("POWERBI_CLIENT_ID");
-      const clientSecret = requireEnv("POWERBI_CLIENT_SECRET");
-      const accessToken = await fetchAccessToken(tenantId, clientId, clientSecret);
+      const token = await accessToken();
       // Return EVERY report: slicing to `limit` would silently drop reports (nextCursor is null, so
       // the gateway drain stops) and lose them from the index for orgs with many reports.
-      const reports = await listReports(accessToken);
-      const items = await Promise.all(reports.map((r) => expandReport(accessToken, r)));
+      const reports = await listReports(token);
+      const items = await Promise.all(reports.map((r) => expandReport(token, r)));
       return jsonResult({ items, nextCursor: null });
     },
   );
@@ -144,15 +148,8 @@ export function registerPowerBiTools(reg: ZodToolRegistrar, server: unknown): vo
       id: z.string().min(1),
     }),
     async (p) => {
-      const tenantId = requireEnv("POWERBI_TENANT_ID");
-      const clientId = requireEnv("POWERBI_CLIENT_ID");
-      const clientSecret = requireEnv("POWERBI_CLIENT_SECRET");
-      const accessToken = await fetchAccessToken(tenantId, clientId, clientSecret);
-      const reports = await listReports(accessToken);
-      const found = reports.find((r) => {
-        if (r === null || typeof r !== "object" || Array.isArray(r)) return false;
-        return (r as Record<string, unknown>)["id"] === p.id;
-      });
+      const reports = await listReports(await accessToken());
+      const found = reports.find((r) => asRecord(r)?.["id"] === p.id);
       if (found === undefined) {
         throw new Error(`Power BI report not found: ${p.id}`);
       }
@@ -165,11 +162,7 @@ export function registerPowerBiTools(reg: ZodToolRegistrar, server: unknown): vo
     "Substring search across Power BI reports. Matches the query (case-insensitive) against report name and description. Returns a `{ matches: [...] }` envelope.",
     searchToolInputSchema(200),
     async (p) => {
-      const tenantId = requireEnv("POWERBI_TENANT_ID");
-      const clientId = requireEnv("POWERBI_CLIENT_ID");
-      const clientSecret = requireEnv("POWERBI_CLIENT_SECRET");
-      const accessToken = await fetchAccessToken(tenantId, clientId, clientSecret);
-      const reports = await listReports(accessToken);
+      const reports = await listReports(await accessToken());
       const matches = filterPowerBiReports(reports, { query: p.query, limit: p.limit });
       return jsonResult({ matches });
     },
@@ -195,16 +188,7 @@ export function registerPowerBiTools(reg: ZodToolRegistrar, server: unknown): vo
         group === undefined
           ? `${POWERBI_API_BASE}/v1.0/myorg/datasets/${encodeURIComponent(p.datasetId)}/refreshes`
           : `${POWERBI_API_BASE}/v1.0/myorg/groups/${encodeURIComponent(group)}/datasets/${encodeURIComponent(p.datasetId)}/refreshes`;
-      const res = await fetchWithTimeout(datasetUrl, {
-        method: "POST",
-        headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
-        body: JSON.stringify({ notifyOption: "NoNotification" }),
-      });
-      if (!res.ok) {
-        throw new Error(
-          `Power BI dataset refresh ${String(res.status)}: ${(await res.text()).slice(0, 400)}`,
-        );
-      }
+      await queueRefresh(token, datasetUrl, "dataset");
       return jsonResult({
         status: "queued",
         ...(group === undefined ? {} : { groupId: group }),
@@ -225,16 +209,7 @@ export function registerPowerBiTools(reg: ZodToolRegistrar, server: unknown): vo
     async (p) => {
       const token = await accessToken();
       const url = `${POWERBI_API_BASE}/v1.0/myorg/groups/${encodeURIComponent(p.groupId)}/dataflows/${encodeURIComponent(p.dataflowId)}/refreshes`;
-      const res = await fetchWithTimeout(url, {
-        method: "POST",
-        headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
-        body: JSON.stringify({ notifyOption: "NoNotification" }),
-      });
-      if (!res.ok) {
-        throw new Error(
-          `Power BI dataflow refresh ${String(res.status)}: ${(await res.text()).slice(0, 400)}`,
-        );
-      }
+      await queueRefresh(token, url, "dataflow");
       return jsonResult({ status: "queued", groupId: p.groupId, dataflowId: p.dataflowId });
     },
   );

package/connectors/prefect/src/search-filter.ts

@@ -1,27 +1,13 @@
 import {
   asObjectish,
   makeQueryFilter,
+  nonEmptyStringsText,
   type SearchMatchOptions,
   stringField,
 } from "../../../shared/search-filter.ts";
 
 export type PrefectSearchMatchOptions = SearchMatchOptions;
 
-/** Prefect deployment tags are a bare string array (not `{name}` objects). */
-function tagNames(row: Record<string, unknown>): string {
-  const tags = row["tags"];
-  if (!Array.isArray(tags)) {
-    return "";
-  }
-  const names: string[] = [];
-  for (const t of tags) {
-    if (typeof t === "string" && t !== "") {
-      names.push(t);
-    }
-  }
-  return names.join(" ");
-}
-
 function fieldsOf(item: unknown): readonly string[] | null {
   const row = asObjectish(item);
   if (row === undefined) {
@@ -33,7 +19,8 @@ function fieldsOf(item: unknown): readonly string[] | null {
     stringField(row, "work_pool_name"),
     stringField(row, "work_queue_name"),
     stringField(row, "status"),
-    tagNames(row),
+    // Prefect deployment tags are a bare string array (not `{name}` objects).
+    nonEmptyStringsText(row, "tags"),
   ];
 }
 

package/connectors/prefect/src/server.ts

@@ -1,94 +1,6 @@
-import { z } from "zod";
-import { searchToolInputSchema } from "../../../shared/mcp-search-tool.ts";
-import { mcpJsonResult as jsonResult } from "../../../shared/mcp-tool-kit.ts";
 import { runReadOnlyMcpConnector } from "../../../shared/run-read-only-mcp-connector.ts";
-import { filterPrefectDeployments } from "./search-filter.ts";
-
-function trimTrailingSlash(s: string): string {
-  return s.endsWith("/") ? s.slice(0, -1) : s;
-}
-
-function apiBase(): string {
-  const v = process.env["PREFECT_API_URL"]?.trim();
-  if (v === undefined || v === "") {
-    throw new Error("PREFECT_API_URL is not set");
-  }
-  return trimTrailingSlash(v);
-}
-
-function authHeaders(): Record<string, string> {
-  const headers: Record<string, string> = { Accept: "application/json" };
-  // Prefect Cloud requires a Bearer API key; self-hosted Prefect Server may run
-  // keyless, so an empty key is tolerated (the header is simply omitted).
-  const apiKey = process.env["PREFECT_API_KEY"]?.trim();
-  if (apiKey !== undefined && apiKey !== "") {
-    headers["Authorization"] = `Bearer ${apiKey}`;
-  }
-  return headers;
-}
-
-async function prefectGet(path: string): Promise<unknown> {
-  const res = await fetch(`${apiBase()}${path}`, { headers: authHeaders() });
-  const text = await res.text();
-  if (!res.ok) {
-    throw new Error(`Prefect ${String(res.status)}: ${text.slice(0, 400)}`);
-  }
-  return JSON.parse(text) as unknown;
-}
-
-async function prefectListDeployments(offset: number, limit: number): Promise<unknown> {
-  const res = await fetch(`${apiBase()}/deployments/filter`, {
-    method: "POST",
-    headers: { ...authHeaders(), "Content-Type": "application/json" },
-    body: JSON.stringify({ limit, offset, sort: "CREATED_DESC" }),
-  });
-  const text = await res.text();
-  if (!res.ok) {
-    throw new Error(`Prefect ${String(res.status)}: ${text.slice(0, 400)}`);
-  }
-  return JSON.parse(text) as unknown;
-}
-
-function deploymentsFrom(root: unknown): unknown[] {
-  return Array.isArray(root) ? root : [];
-}
+import { registerPrefectTools } from "./tools.ts";
 
 await runReadOnlyMcpConnector("nimbus-prefect", (reg) => {
-  reg(
-    "prefect_list",
-    "List Prefect deployments (POST <api_url>/deployments/filter with a JSON body { limit, offset, sort: CREATED_DESC }). Prefect's list endpoints are POST-with-body filters, not GET query-string endpoints; the response is a bare JSON array of deployment objects. The optional offset arg (default 0) selects the page start; limit is fixed at 100.",
-    z.object({
-      offset: z.number().int().min(0).optional(),
-    }),
-    async (p) => {
-      const offset = p.offset ?? 0;
-      const root = await prefectListDeployments(offset, 100);
-      return jsonResult({ items: deploymentsFrom(root) });
-    },
-  );
-
-  reg(
-    "prefect_get",
-    "Fetch one Prefect deployment by its id (GET <api_url>/deployments/{id}). The id is the deployment UUID string. Returns the deployment object directly (NOT wrapped in an array). Throws when no deployment with that id exists.",
-    z.object({
-      id: z.string().min(1),
-    }),
-    async (p) => {
-      return jsonResult(await prefectGet(`/deployments/${encodeURIComponent(p.id)}`));
-    },
-  );
-
-  reg(
-    "prefect_search",
-    "Substring search across the first page of Prefect deployments. Matches the query (case-insensitive) against the deployment name, description, work pool, work queue, status, and tags. Returns a matches envelope.",
-    searchToolInputSchema(100),
-    async (p) => {
-      const root = await prefectListDeployments(0, 100);
-      const matches = filterPrefectDeployments(deploymentsFrom(root), {
-        query: p.query,
-        limit: p.limit,
-      });
-      return jsonResult({ matches });
-    },
-  );
+  registerPrefectTools(reg);
 });

package/connectors/prefect/src/tools.ts

@@ -0,0 +1,83 @@
+import { z } from "zod";
+import { createJsonGetter, requiredBaseUrl } from "../../../shared/env-json-api.ts";
+import { searchToolInputSchema } from "../../../shared/mcp-search-tool.ts";
+import { mcpJsonResult as jsonResult } from "../../../shared/mcp-tool-kit.ts";
+import type { ZodToolRegistrar } from "../../../shared/run-read-only-mcp-connector.ts";
+import { filterPrefectDeployments } from "./search-filter.ts";
+
+function apiBase(): string {
+  return requiredBaseUrl("PREFECT_API_URL");
+}
+
+function authHeaders(): Record<string, string> {
+  const headers: Record<string, string> = { Accept: "application/json" };
+  // Prefect Cloud requires a Bearer API key; self-hosted Prefect Server may run
+  // keyless, so an empty key is tolerated (the header is simply omitted).
+  const apiKey = process.env["PREFECT_API_KEY"]?.trim();
+  if (apiKey !== undefined && apiKey !== "") {
+    headers["Authorization"] = `Bearer ${apiKey}`;
+  }
+  return headers;
+}
+
+const prefectGet = createJsonGetter({ base: apiBase, label: "Prefect", headers: authHeaders });
+
+async function prefectListDeployments(offset: number, limit: number): Promise<unknown> {
+  const res = await fetch(`${apiBase()}/deployments/filter`, {
+    method: "POST",
+    headers: { ...authHeaders(), "Content-Type": "application/json" },
+    body: JSON.stringify({ limit, offset, sort: "CREATED_DESC" }),
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    throw new Error(`Prefect ${String(res.status)}: ${text.slice(0, 400)}`);
+  }
+  return JSON.parse(text) as unknown;
+}
+
+function deploymentsFrom(root: unknown): unknown[] {
+  return Array.isArray(root) ? root : [];
+}
+
+/** Tool names exposed by this connector — for contract/introspection tests. */
+export const PREFECT_TOOL_NAMES = ["prefect_get", "prefect_list", "prefect_search"] as const;
+
+export function registerPrefectTools(reg: ZodToolRegistrar): void {
+  reg(
+    "prefect_list",
+    "List Prefect deployments (POST <api_url>/deployments/filter with a JSON body { limit, offset, sort: CREATED_DESC }). Prefect's list endpoints are POST-with-body filters, not GET query-string endpoints; the response is a bare JSON array of deployment objects. The optional offset arg (default 0) selects the page start; limit is fixed at 100.",
+    z.object({
+      offset: z.number().int().min(0).optional(),
+    }),
+    async (p) => {
+      const offset = p.offset ?? 0;
+      const root = await prefectListDeployments(offset, 100);
+      return jsonResult({ items: deploymentsFrom(root) });
+    },
+  );
+
+  reg(
+    "prefect_get",
+    "Fetch one Prefect deployment by its id (GET <api_url>/deployments/{id}). The id is the deployment UUID string. Returns the deployment object directly (NOT wrapped in an array). Throws when no deployment with that id exists.",
+    z.object({
+      id: z.string().min(1),
+    }),
+    async (p) => {
+      return jsonResult(await prefectGet(`/deployments/${encodeURIComponent(p.id)}`));
+    },
+  );
+
+  reg(
+    "prefect_search",
+    "Substring search across the first page of Prefect deployments. Matches the query (case-insensitive) against the deployment name, description, work pool, work queue, status, and tags. Returns a matches envelope.",
+    searchToolInputSchema(100),
+    async (p) => {
+      const root = await prefectListDeployments(0, 100);
+      const matches = filterPrefectDeployments(deploymentsFrom(root), {
+        query: p.query,
+        limit: p.limit,
+      });
+      return jsonResult({ matches });
+    },
+  );
+}

package/connectors/protonmail/src/mail-core.ts

@@ -10,10 +10,24 @@
  * or parses attachment bytes and never fetches the full message body.
  *
  * The IMAP client and SMTP mailer are injected so tests never open real sockets.
+ *
+ * "The same shape as the generic IMAP connector core" used to be a comment
+ * above a second copy of that shape. It is now a re-export of it, from
+ * `shared/imap-mail-core.ts`.
  */
 
-import type { MailAddress } from "../../../shared/imap-mail-core.ts";
-
+export type {
+  MailAddress,
+  MailAttachmentMeta,
+  MailClient,
+  MailEnvelope,
+  MailListOptions,
+  MailMessageMeta,
+  MailSearchOptions,
+  SendMailInput,
+  SendMailResult,
+  SmtpMailer,
+} from "../../../shared/imap-mail-core.ts";
 export {
   capPreview,
   clampLimit,
@@ -21,76 +35,3 @@ export {
   PREVIEW_FETCH_BYTES,
   PREVIEW_MAX_CHARS,
 } from "../../../shared/imap-mail-core.ts";
-export type { MailAddress };
-
-/** Message ENVELOPE — RFC 2822 header fields only. */
-export interface MailEnvelope {
-  readonly date?: Date | string | null;
-  readonly subject?: string | null;
-  readonly messageId?: string | null;
-  readonly from?: readonly MailAddress[];
-  readonly to?: readonly MailAddress[];
-  readonly cc?: readonly MailAddress[];
-}
-
-/** Attachment METADATA only — filename, size, mimetype. NEVER the bytes. */
-export interface MailAttachmentMeta {
-  readonly filename: string | null;
-  readonly sizeBytes: number | null;
-  readonly mimeType: string | null;
-}
-
-/**
- * A single mailbox message reduced to header + attachment-metadata + a capped
- * text preview. This is the ONLY shape the connector ever materializes.
- */
-export interface MailMessageMeta {
-  readonly uid: number;
-  readonly mailbox: string;
-  readonly uidValidity: string | null;
-  readonly envelope: MailEnvelope;
-  readonly attachments: readonly MailAttachmentMeta[];
-  /** Plain-text body preview, already capped to {@link PREVIEW_MAX_CHARS}. */
-  readonly preview: string;
-}
-
-export interface MailListOptions {
-  readonly mailbox?: string;
-  readonly limit?: number;
-}
-
-export interface MailSearchOptions {
-  readonly query: string;
-  readonly mailbox?: string;
-  readonly limit?: number;
-}
-
-/**
- * Minimal IMAP client surface the connector depends on. Implemented for real by
- * the imapflow adapter in `server.ts` and by a fake in tests.
- */
-export interface MailClient {
-  list(options: MailListOptions): Promise<MailMessageMeta[]>;
-  get(uid: number, mailbox?: string): Promise<MailMessageMeta | null>;
-  search(options: MailSearchOptions): Promise<MailMessageMeta[]>;
-}
-
-/** Outgoing message for the SMTP send tool. */
-export interface SendMailInput {
-  readonly to: string;
-  readonly subject: string;
-  readonly body: string;
-  readonly cc?: string;
-  readonly bcc?: string;
-}
-
-export interface SendMailResult {
-  readonly messageId: string | null;
-  readonly accepted: readonly string[];
-  readonly rejected: readonly string[];
-}
-
-/** Minimal SMTP mailer surface; implemented for real over nodemailer. */
-export interface SmtpMailer {
-  send(input: SendMailInput): Promise<SendMailResult>;
-}