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

package/dist/connectors/intercom/connector.json

@@ -0,0 +1,249 @@
+{
+  "id": "intercom",
+  "name": "Intercom",
+  "description": "Let agents read client conversations in Intercom, look up the person and company behind them, leave internal notes for your team and assign conversations. If you allow it, they can also reply to clients.",
+  "logo": "/brand/registry/intercom.svg",
+  "identity": "The access token of an app in your Intercom workspace. It acts as the workspace, with the permissions you tick on the app, so keep them to the ones below.",
+  "accountKey": "host",
+  "connectionKind": "guided",
+  "setup": [
+    {
+      "title": "Create an app for agents",
+      "body": "You need an Intercom admin for this. An app made in your own workspace gets an access token for that workspace straight away.",
+      "link": {
+        "label": "Intercom: authentication",
+        "href": "https://developers.intercom.com/docs/build-an-integration/learn-more/authentication"
+      },
+      "click": [
+        "Open the Intercom Developer Hub (app.intercom.com/a/apps/_/developer-hub) and select New app.",
+        "Name it Agents, pick your workspace, then Create app."
+      ]
+    },
+    {
+      "title": "Set its permissions and copy the token",
+      "body": "Tick only the permissions below, then copy the access token for the form below.",
+      "link": {
+        "label": "Intercom: permissions",
+        "href": "https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/oauth-scopes"
+      },
+      "click": [
+        "In the app, go to Configure, then Authentication, and select Edit.",
+        "Tick only the permissions below, then Save.",
+        "Copy the Access token shown on the same page."
+      ],
+      "copy": ["{scope}"]
+    }
+  ],
+  "afterConnect": [],
+  "fields": [
+    {
+      "id": "host",
+      "label": "API address",
+      "help": "api.intercom.io, or api.eu.intercom.io or api.au.intercom.io if your workspace is hosted in Europe or Australia.",
+      "placeholder": "api.intercom.io",
+      "secret": false
+    },
+    {
+      "id": "access_token",
+      "label": "Access token",
+      "secret": true
+    }
+  ],
+  "capabilities": [
+    {
+      "id": "read",
+      "label": "Read conversations",
+      "description": "List and read conversations, read a person's contact record, look up a company (its plan and custom attributes, such as what it is entitled to) and its people, and list your teammates.",
+      "required": true,
+      "note": "Reaches every conversation, person and company in the workspace. Read-only.",
+      "scopes": ["Read conversations", "Read and list users and companies", "Read admins"],
+      "permissions": [],
+      "tools": [
+        "intercom_list_conversations",
+        "intercom_get_conversation",
+        "intercom_get_contact",
+        "intercom_find_company",
+        "intercom_list_company_contacts",
+        "intercom_list_admins"
+      ]
+    },
+    {
+      "id": "triage",
+      "label": "Add notes and assign",
+      "description": "Leave an internal note on a conversation, which clients never see, and assign a conversation to a teammate or team.",
+      "scopes": ["Write conversations"],
+      "permissions": [],
+      "tools": ["intercom_add_note", "intercom_assign_conversation"]
+    },
+    {
+      "id": "reply",
+      "label": "Reply to clients",
+      "description": "Reply to a conversation as a teammate. The client sees the reply.",
+      "destructive": true,
+      "note": "Sends messages to your clients.",
+      "scopes": ["Write conversations"],
+      "permissions": [],
+      "tools": ["intercom_reply"]
+    }
+  ],
+  "limits": [],
+  "verify": {
+    "method": "GET",
+    "path": "/me",
+    "label": "Intercom workspace",
+    "show": "app.name"
+  },
+  "revoke": "In the Intercom Developer Hub, open the app, go to Configure, then Authentication, and regenerate the access token, or delete the app. Agents lose access to Intercom at once.",
+  "http": {
+    "baseUrl": "https://{host}",
+    "allowedHosts": ["api.intercom.io", "api.eu.intercom.io", "api.au.intercom.io"],
+    "auth": { "type": "bearer", "token": "access_token" },
+    "headers": { "Intercom-Version": "2.14" },
+    "tools": [
+      {
+        "name": "intercom_list_conversations",
+        "description": "List conversations, most recently updated first.",
+        "method": "GET",
+        "path": "/conversations",
+        "params": {
+          "per_page": { "type": "integer", "description": "Conversations per page, up to 150", "in": "query", "default": 20 },
+          "starting_after": { "type": "string", "description": "The next page's cursor, from the previous answer", "in": "query", "required": false }
+        },
+        "result": {
+          "items": "conversations",
+          "fields": [
+            "id",
+            "title",
+            "state",
+            "open",
+            "created_at",
+            "updated_at",
+            "waiting_since",
+            "admin_assignee_id",
+            "team_assignee_id",
+            "source.author.name",
+            "source.author.email",
+            "source.subject",
+            "contacts.contacts.id",
+            "tags.tags.name"
+          ]
+        },
+        "paging": { "param": "starting_after", "body": "pages.next.starting_after" }
+      },
+      {
+        "name": "intercom_get_conversation",
+        "description": "Read one conversation with its messages, as plain text.",
+        "method": "GET",
+        "path": "/conversations/{conversation_id}",
+        "params": {
+          "conversation_id": { "type": "string", "description": "The conversation id", "in": "path" },
+          "display_as": { "type": "string", "description": "Message format", "in": "query", "enum": ["plaintext"], "default": "plaintext" }
+        },
+        "result": {
+          "fields": [
+            "id",
+            "title",
+            "state",
+            "created_at",
+            "admin_assignee_id",
+            "team_assignee_id",
+            "custom_attributes",
+            "source.author.name",
+            "source.author.email",
+            "source.subject",
+            "source.body",
+            "contacts.contacts.id",
+            "conversation_parts.conversation_parts.part_type",
+            "conversation_parts.conversation_parts.body",
+            "conversation_parts.conversation_parts.created_at",
+            "conversation_parts.conversation_parts.author.name",
+            "conversation_parts.conversation_parts.author.type"
+          ]
+        }
+      },
+      {
+        "name": "intercom_get_contact",
+        "description": "Read one person's contact record: name, email, companies and custom attributes.",
+        "method": "GET",
+        "path": "/contacts/{contact_id}",
+        "params": {
+          "contact_id": { "type": "string", "description": "The contact id (from a conversation's contacts)", "in": "path" }
+        },
+        "result": {
+          "fields": ["id", "role", "name", "email", "phone", "external_id", "custom_attributes", "companies.data.id", "location.country", "last_seen_at"]
+        }
+      },
+      {
+        "name": "intercom_find_company",
+        "description": "Find a company by your own company id or by name: its plan, size and custom attributes, such as what it is entitled to.",
+        "method": "GET",
+        "path": "/companies",
+        "params": {
+          "company_id": { "type": "string", "description": "Your own id for the company", "in": "query", "required": false },
+          "name": { "type": "string", "description": "The company's name", "in": "query", "required": false }
+        }
+      },
+      {
+        "name": "intercom_list_company_contacts",
+        "description": "List the people at a company.",
+        "method": "GET",
+        "path": "/companies/{id}/contacts",
+        "params": {
+          "id": { "type": "string", "description": "Intercom's id for the company (its id field, not company_id)", "in": "path" }
+        },
+        "result": { "items": "data", "fields": ["id", "name", "email", "role"] }
+      },
+      {
+        "name": "intercom_list_admins",
+        "description": "List your teammates (admins), with their ids, emails and whether they are away. Use an id to assign a conversation or to write as that teammate.",
+        "method": "GET",
+        "path": "/admins",
+        "result": { "items": "admins", "fields": ["id", "name", "email", "job_title", "away_mode_enabled", "team_ids"] }
+      },
+      {
+        "name": "intercom_add_note",
+        "description": "Leave an internal note on a conversation. Clients never see notes.",
+        "method": "POST",
+        "path": "/conversations/{conversation_id}/reply",
+        "params": {
+          "conversation_id": { "type": "string", "description": "The conversation id", "in": "path" },
+          "admin_id": { "type": "string", "description": "The teammate the note is from", "in": "body" },
+          "body": { "type": "string", "description": "The note, as text or simple HTML", "in": "body" },
+          "message_type": { "type": "string", "description": "Always a note", "in": "body", "enum": ["note"], "default": "note" },
+          "type": { "type": "string", "description": "Always from a teammate", "in": "body", "enum": ["admin"], "default": "admin" }
+        },
+        "result": { "fields": ["id", "state", "admin_assignee_id"] }
+      },
+      {
+        "name": "intercom_assign_conversation",
+        "description": "Assign a conversation to a teammate or a team, with an optional note.",
+        "method": "POST",
+        "path": "/conversations/{conversation_id}/parts",
+        "params": {
+          "conversation_id": { "type": "string", "description": "The conversation id", "in": "path" },
+          "admin_id": { "type": "string", "description": "The teammate doing the assigning", "in": "body" },
+          "assignee_id": { "type": "string", "description": "The teammate or team to assign it to", "in": "body" },
+          "type": { "type": "string", "description": "Whether assignee_id is a teammate or a team", "in": "body", "enum": ["admin", "team"] },
+          "body": { "type": "string", "description": "An optional note with the assignment", "in": "body", "required": false },
+          "message_type": { "type": "string", "description": "Always an assignment", "in": "body", "enum": ["assignment"], "default": "assignment" }
+        },
+        "result": { "fields": ["id", "state", "admin_assignee_id", "team_assignee_id"] }
+      },
+      {
+        "name": "intercom_reply",
+        "description": "Reply to a conversation as a teammate. The client sees the reply.",
+        "method": "POST",
+        "path": "/conversations/{conversation_id}/reply",
+        "destructive": true,
+        "params": {
+          "conversation_id": { "type": "string", "description": "The conversation id", "in": "path" },
+          "admin_id": { "type": "string", "description": "The teammate the reply is from", "in": "body" },
+          "body": { "type": "string", "description": "The reply, as text or simple HTML", "in": "body" },
+          "message_type": { "type": "string", "description": "Always a reply", "in": "body", "enum": ["comment"], "default": "comment" },
+          "type": { "type": "string", "description": "Always from a teammate", "in": "body", "enum": ["admin"], "default": "admin" }
+        },
+        "result": { "fields": ["id", "state", "admin_assignee_id"] }
+      }
+    ]
+  }
+}

package/dist/connectors/lusha/connector.json

@@ -0,0 +1,59 @@
+{
+  "id": "lusha",
+  "name": "Lusha",
+  "description": "Let agents look up business contacts and companies in Lusha: job title, work email and phone, company size, industry and funding. For account research, call lists and matching event delegates to sponsors.",
+  "logo": "/brand/registry/lusha.svg",
+  "identity": "A Lusha API key. Every lookup that reveals an email or phone number spends your company's Lusha credits, so give the key its own credit limit.",
+  "accountKey": "host",
+  "connectionKind": "guided",
+  "setup": [
+    {
+      "title": "Create an API key with a credit limit",
+      "body": "You need a Lusha admin or manager for this, so the key can carry a credit limit of its own. The key acts as the person who made it and spends from your company's shared credits. Lusha shows the key on the API page; copy it for the form below.",
+      "link": {
+        "label": "Lusha: manage API keys",
+        "href": "https://dashboard.lusha.com/api/manage-api-keys"
+      },
+      "click": [
+        "In Lusha, open API & connectors in the left sidebar, then the Manage API Keys tab.",
+        "Create a key for agents and set its credit limit to what agents may spend.",
+        "Copy the key."
+      ],
+      "copy": [
+        "curl -s -H \"api_key: $LUSHA_API_KEY\" https://api.lusha.com/v3/account/usage"
+      ],
+      "shell": "bash"
+    }
+  ],
+  "afterConnect": [],
+  "fields": [{ "id": "api_key", "label": "API key", "secret": true }],
+  "capabilities": [
+    {
+      "id": "contacts",
+      "label": "Look up contacts",
+      "description": "Find one person by email, LinkedIn address, Lusha id, or name and company: job title, seniority, department, start date and previous job, location, work email and phone.",
+      "required": true,
+      "note": "Each search, and each email or phone number revealed, spends Lusha credits, up to the key's credit limit.",
+      "scopes": [],
+      "permissions": [],
+      "tools": ["lusha_find_contact"]
+    },
+    {
+      "id": "companies",
+      "label": "Look up companies",
+      "description": "Find one company by domain, name or Lusha id: size, revenue, industry, location, description and funding.",
+      "note": "Spends Lusha credits.",
+      "scopes": [],
+      "permissions": [],
+      "tools": ["lusha_find_company"]
+    }
+  ],
+  "limits": [],
+  "verify": {
+    "method": "GET",
+    "path": "/v3/account/usage",
+    "label": "Lusha credits remaining",
+    "show": "credits.remaining"
+  },
+  "revoke": "In Lusha, open API & connectors, then Manage API Keys, and delete the key. Agents lose access to Lusha at once."
+}

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

@@ -0,0 +1,8 @@
+declare const _default: {
+    id: string;
+    create: () => {
+        vendor: import("../../packages/connector-kit/src/types.js").Vendor;
+        toolset: import("../../packages/connector-kit/src/common.js").Toolset;
+    };
+};
+export default _default;

package/dist/connectors/lusha/index.js

@@ -0,0 +1,7 @@
+import { lushaTools } from "./tools.js";
+import { lushaVendor } from "./vendor.js";
+export default {
+    id: "lusha",
+    create: () => ({ vendor: lushaVendor(), toolset: lushaTools }),
+};
+//# sourceMappingURL=index.js.map

package/dist/connectors/lusha/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../connectors/lusha/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,eAAe;IACb,EAAE,EAAE,OAAO;IACX,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;CACrC,CAAC"}

package/dist/connectors/lusha/tools.d.ts

@@ -0,0 +1,2 @@
+import { type Toolset } from "../../packages/connector-kit/src/common.js";
+export declare const lushaTools: Toolset;

package/dist/connectors/lusha/tools.js

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import { argumentsTarget, audited, Denied, json, VendorFailed, } from "../../packages/connector-kit/src/common.js";
+import { lushaError } from "./vendor.js";
+const text = z.string().trim().min(1).max(300);
+async function first(ctx, mark, path, body) {
+    const res = await ctx.call({ method: "POST", path, body });
+    mark(res.status);
+    if (res.status < 200 || res.status >= 300)
+        throw new VendorFailed(res.status, lushaError(res));
+    const data = (res.data ?? {});
+    const found = data.results?.[0];
+    return { found, credits: data.billing?.creditsCharged ?? null };
+}
+const pick = (o, keys) => o ? Object.fromEntries(keys.filter((k) => o[k] != null).map((k) => [k, o[k]])) : null;
+export const lushaTools = {
+    names: ["lusha_find_contact", "lusha_find_company"],
+    register(server, ctx, allowed) {
+        if (allowed.has("lusha_find_contact"))
+            server.registerTool("lusha_find_contact", {
+                description: "Find one person in Lusha. Send email, or linkedin_url, or person_id, or first_name and last_name with company_name or company_domain. Spends credits for the search and for each email and phone revealed.",
+                inputSchema: z
+                    .object({
+                    email: text.optional(),
+                    linkedin_url: text.optional(),
+                    person_id: text.optional(),
+                    first_name: text.optional(),
+                    last_name: text.optional(),
+                    company_name: text.optional(),
+                    company_domain: text.optional(),
+                    reveal: z
+                        .array(z.enum(["emails", "phones"]))
+                        .default(["emails", "phones"])
+                        .describe("What to reveal; each one spends credits. Empty reveals neither."),
+                })
+                    .strict(),
+                annotations: { readOnlyHint: true, openWorldHint: true },
+            }, (args) => audited(ctx, "lusha_find_contact", argumentsTarget(args), async (mark) => {
+                const named = args.first_name && args.last_name && (args.company_name || args.company_domain);
+                if (!args.email && !args.linkedin_url && !args.person_id && !named)
+                    throw new Denied("Send email, linkedin_url or person_id, or first_name and last_name with company_name or company_domain");
+                const contact = Object.fromEntries(Object.entries({
+                    id: args.person_id,
+                    email: args.email,
+                    linkedinUrl: args.linkedin_url,
+                    firstName: args.first_name,
+                    lastName: args.last_name,
+                    companyName: args.company_name,
+                    companyDomain: args.company_domain,
+                }).filter(([, v]) => v !== undefined));
+                const { found, credits } = await first(ctx, mark, "/v3/contacts/search-and-enrich", {
+                    contacts: [contact],
+                    reveal: args.reveal,
+                });
+                if (!found || found.error)
+                    return json({ found: false, error: found?.error ?? null, credits });
+                return json({
+                    found: true,
+                    credits,
+                    person_id: found.id ?? null,
+                    name: found.fullName ?? null,
+                    job_title: found.jobTitle ?? null,
+                    company: found.company ?? null,
+                    location: pick(found.location, ["city", "state", "country"]),
+                    emails: (found.emails ?? []).map((e) => pick(e, ["email", "type", "confidence"])),
+                    phones: (found.phones ?? []).map((p) => pick(p, ["number", "type", "doNotCall"])),
+                    linkedin: found.socialLinks?.linkedin ?? null,
+                    previous_jobs: (found.previousEmployment ?? []).slice(0, 5),
+                });
+            }));
+        if (allowed.has("lusha_find_company"))
+            server.registerTool("lusha_find_company", {
+                description: "Find one company in Lusha by domain, name or Lusha id: size, revenue, industry, location, description and funding. Spends credits.",
+                inputSchema: z
+                    .object({
+                    domain: text.optional(),
+                    name: text.optional(),
+                    company_id: text.optional(),
+                })
+                    .strict(),
+                annotations: { readOnlyHint: true, openWorldHint: true },
+            }, (args) => audited(ctx, "lusha_find_company", argumentsTarget(args), async (mark) => {
+                if (!args.domain && !args.name && !args.company_id)
+                    throw new Denied("Send domain, name or company_id");
+                const company = Object.fromEntries(Object.entries({ id: args.company_id, name: args.name, domain: args.domain }).filter(([, v]) => v !== undefined));
+                const { found, credits } = await first(ctx, mark, "/v3/companies/search-and-enrich", {
+                    companies: [company],
+                });
+                if (!found || found.error)
+                    return json({ found: false, error: found?.error ?? null, credits });
+                return json({
+                    found: true,
+                    credits,
+                    ...pick(found, [
+                        "id",
+                        "name",
+                        "domain",
+                        "companyType",
+                        "yearFounded",
+                        "employeeCount",
+                        "revenueRange",
+                        "industry",
+                        "subIndustry",
+                        "location",
+                        "funding",
+                        "technologies",
+                    ]),
+                    description: typeof found.description === "string" ? found.description.slice(0, 1000) : null,
+                    linkedin: found.socialLinks?.linkedin ?? null,
+                });
+            }));
+    },
+};
+//# sourceMappingURL=tools.js.map

package/dist/connectors/lusha/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../connectors/lusha/tools.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,4 @@
+import { type Fetch, type Vendor, type VendorResponse } from "../../packages/connector-kit/src/types.js";
+export declare const LUSHA_HOST = "api.lusha.com";
+export declare function lushaError(res: VendorResponse): string;
+export declare function lushaVendor(unguarded?: Fetch, wait?: (s: number) => Promise<void>): Vendor;

package/dist/connectors/lusha/vendor.js

@@ -0,0 +1,72 @@
+import { retryAfter, vendorFetch } from "../../packages/connector-kit/src/fetch.js";
+import { vendorError } from "../../packages/connector-kit/src/oauth.js";
+import { ConnectError, } from "../../packages/connector-kit/src/types.js";
+// A Lusha API key in the api_key header, against Lusha's v3 API. v2 (GET /v2/person and
+// /v2/company) stops answering on November 30, 2026, and its replacements take a JSON list of
+// people or companies, which is why this app has code rather than an http block.
+// Sources: docs.lusha.com/openapi.json and the V3 migration guide (read November 1, 2026).
+export const LUSHA_HOST = "api.lusha.com";
+const BASE = `https://${LUSHA_HOST}`;
+export function lushaError(res) {
+    if (res.status === 402)
+        return "Lusha says the key is out of credits";
+    if (res.status === 429) {
+        const after = res.data?.retryAfter;
+        const wait = typeof after === "number" ? ` Try again in ${after} seconds.` : "";
+        return `Lusha is limiting how often the app may call it.${wait}`;
+    }
+    const detail = vendorError(res.data);
+    return `Lusha answered ${res.status}${detail ? `: ${detail}` : ""}`;
+}
+export function lushaVendor(unguarded = fetch, wait) {
+    const fetchImpl = vendorFetch("Lusha", unguarded, wait);
+    async function send(key, request) {
+        const res = await fetchImpl(`${BASE}${request.path}`, {
+            method: request.method,
+            headers: {
+                api_key: key,
+                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) {
+            const key = fields.api_key?.trim() ?? "";
+            if (!key)
+                throw new ConnectError("Enter the Lusha API key");
+            const res = await send(key, { method: "GET", path: "/v3/account/usage" });
+            if (res.status === 401)
+                throw new ConnectError("Lusha did not accept the API key");
+            if (res.status === 403)
+                throw new ConnectError(`Lusha refused the key. Ask Lusha to turn on API access for your plan. (${lushaError(res)})`);
+            if (res.status !== 200)
+                throw new ConnectError(`Lusha sign-in failed. ${lushaError(res)}`);
+            return {
+                config: { host: LUSHA_HOST },
+                secret: { api_key: key },
+                accountLabel: `API key ending ${key.slice(-4)}`,
+            };
+        },
+        call: (connection, request) => send(connection.secret.api_key ?? "", request),
+    };
+}
+function parse(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+//# sourceMappingURL=vendor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vendor.js","sourceRoot":"","sources":["../../../connectors/lusha/vendor.ts"],"names":[],"mappings":"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"}

package/dist/connectors/odata/index.js

@@ -2,7 +2,7 @@ import { z } from "zod";
 import { audited, Denied, json, listLimit, VendorFailed, } from "../../packages/connector-kit/src/common.js";
 import { clientCredentials, vendorError } from "../../packages/connector-kit/src/oauth.js";
 import { ConnectError, } from "../../packages/connector-kit/src/types.js";
-import { answerWithin, authHeaders, formValues, guardedFetch, MAX_BODY_BYTES, MAX_TARGET_BYTES, paramLimits, } from "../http/index.js";
+import { answerWithin, authHeaders, formValues, connectionAddress, guardedFetch, MAX_BODY_BYTES, MAX_TARGET_BYTES, paramLimits, } from "../http/index.js";
 const DATETIME = z
     .string()
     .regex(/^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d{1,7})?)?(Z|[+-]\d{2}:\d{2})?)?$/);
@@ -125,23 +125,29 @@ function option(link, name) {
 }
 export function odataVendor(connector, fetchImpl = fetch) {
     const od = connector.odata;
-    const root = new URL(od.serviceRoot);
-    const prefix = root.pathname.replace(/\/+$/, "");
     const auth = od.auth;
-    const safe = guardedFetch([root.origin, ...(auth.type === "oauth2" ? [new URL(auth.tokenUrl).origin] : [])], fetchImpl);
-    const oauth = auth.type === "oauth2" ? clientCredentials(connector.name, safe) : null;
+    const tokenUrl = auth.type === "oauth2" ? auth.tokenUrl : null;
+    const addressOf = connectionAddress(connector, od.serviceRoot, od.allowedHosts, tokenUrl, fetchImpl);
+    // Only ever fetches the token, so one client serves every connection's address.
+    const oauth = tokenUrl
+        ? clientCredentials(connector.name, guardedFetch([new URL(tokenUrl).origin], fetchImpl))
+        : null;
     const creds = (c) => auth.type === "oauth2"
         ? {
             tokenUrl: auth.tokenUrl,
             clientId: c.config[auth.clientId],
             clientSecret: c.secret[auth.clientSecret],
             scope: auth.scope,
+            clientAuth: auth.clientAuth,
+            audience: auth.audience,
         }
         : null;
     const versionHeaders = od.version === "4"
         ? { "odata-version": "4.0", "odata-maxversion": "4.0" }
         : { dataserviceversion: "2.0", maxdataserviceversion: "2.0" };
     async function send(c, request) {
+        const { url: root, safe } = addressOf(c);
+        const prefix = root.pathname.replace(/\/+$/, "");
         // The path is the tool's, already encoded; it must stay under the service root.
         const url = new URL(`${root.origin}${prefix}${request.path}`);
         if (url.origin !== root.origin || !`${url.pathname}/`.startsWith(`${prefix}/`))
@@ -186,6 +192,7 @@ export function odataVendor(connector, fetchImpl = fetch) {
     return {
         async connect(fields) {
             const { config, secret } = formValues(connector, fields);
+            const root = addressOf({ config }).url;
             const conn = { config: { host: root.host, ...config }, secret };
             if (oauth)
                 await oauth.signIn(creds(conn));