@squadbase/vite-server 0.1.2 → 0.1.3-dev.1

package/dist/connectors/mailchimp.js

@@ -0,0 +1,646 @@
+// ../connectors/src/parameter-definition.ts
+var ParameterDefinition = class {
+  slug;
+  name;
+  description;
+  envVarBaseKey;
+  type;
+  secret;
+  required;
+  constructor(config) {
+    this.slug = config.slug;
+    this.name = config.name;
+    this.description = config.description;
+    this.envVarBaseKey = config.envVarBaseKey;
+    this.type = config.type;
+    this.secret = config.secret;
+    this.required = config.required;
+  }
+  /**
+   * Get the parameter value from a ConnectorConnectionObject.
+   */
+  getValue(connection2) {
+    const param = connection2.parameters.find(
+      (p) => p.parameterSlug === this.slug
+    );
+    if (!param || param.value == null) {
+      throw new Error(
+        `Parameter "${this.slug}" not found or has no value in connection "${connection2.id}"`
+      );
+    }
+    return param.value;
+  }
+  /**
+   * Try to get the parameter value. Returns undefined if not found (for optional params).
+   */
+  tryGetValue(connection2) {
+    const param = connection2.parameters.find(
+      (p) => p.parameterSlug === this.slug
+    );
+    if (!param || param.value == null) return void 0;
+    return param.value;
+  }
+};
+
+// ../connectors/src/connectors/mailchimp/parameters.ts
+var parameters = {
+  apiKey: new ParameterDefinition({
+    slug: "api-key",
+    name: "Mailchimp API Key",
+    description: "Your Mailchimp API key. The key includes the datacenter suffix (e.g., xxxxxxxxxxxxxxxx-us6).",
+    envVarBaseKey: "MAILCHIMP_API_KEY",
+    type: "text",
+    secret: true,
+    required: true
+  })
+};
+
+// ../connectors/src/connectors/mailchimp/sdk/index.ts
+function extractDatacenter(apiKey) {
+  const parts = apiKey.split("-");
+  const dc = parts[parts.length - 1];
+  if (!dc) {
+    throw new Error(
+      "Invalid Mailchimp API key format. Expected format: xxxxxxxxxxxxxxxx-us6"
+    );
+  }
+  return dc;
+}
+function createClient(params) {
+  const apiKey = params[parameters.apiKey.slug];
+  if (!apiKey) {
+    throw new Error(
+      `mailchimp: missing required parameter: ${parameters.apiKey.slug}`
+    );
+  }
+  const dc = extractDatacenter(apiKey);
+  const baseUrl = `https://${dc}.api.mailchimp.com/3.0`;
+  const authHeader = `Basic ${btoa(`anystring:${apiKey}`)}`;
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", authHeader);
+    headers.set("Content-Type", "application/json");
+    return headers;
+  }
+  async function assertOk(res, label) {
+    if (!res.ok) {
+      const body = await res.text().catch(() => "(unreadable body)");
+      throw new Error(
+        `mailchimp ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  function buildQuery(params2) {
+    if (!params2) return "";
+    const entries = Object.entries(params2).filter(
+      ([, v]) => v !== void 0
+    );
+    if (entries.length === 0) return "";
+    const sp = new URLSearchParams();
+    for (const [k, v] of entries) sp.set(k, String(v));
+    return `?${sp.toString()}`;
+  }
+  return {
+    request(path2, init) {
+      const url = `${baseUrl}${path2.startsWith("/") ? "" : "/"}${path2}`;
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", authHeader);
+      headers.set("Content-Type", "application/json");
+      return fetch(url, { ...init, headers });
+    },
+    async getLists(options) {
+      const qs = buildQuery({
+        count: options?.count,
+        offset: options?.offset
+      });
+      const res = await fetch(`${baseUrl}/lists${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getLists");
+      return await res.json();
+    },
+    async getListMembers(listId, options) {
+      const qs = buildQuery({
+        count: options?.count,
+        offset: options?.offset,
+        status: options?.status
+      });
+      const res = await fetch(
+        `${baseUrl}/lists/${encodeURIComponent(listId)}/members${qs}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getListMembers");
+      return await res.json();
+    },
+    async getCampaigns(options) {
+      const qs = buildQuery({
+        count: options?.count,
+        offset: options?.offset,
+        status: options?.status,
+        type: options?.type
+      });
+      const res = await fetch(`${baseUrl}/campaigns${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getCampaigns");
+      return await res.json();
+    },
+    async getReports(options) {
+      const qs = buildQuery({
+        count: options?.count,
+        offset: options?.offset
+      });
+      const res = await fetch(`${baseUrl}/reports${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getReports");
+      return await res.json();
+    }
+  };
+}
+
+// ../connectors/src/connector-onboarding.ts
+var ConnectorOnboarding = class {
+  /** Phase 1: Connection setup instructions (optional — some connectors don't need this) */
+  connectionSetupInstructions;
+  /** Phase 2: Data overview instructions */
+  dataOverviewInstructions;
+  constructor(config) {
+    this.connectionSetupInstructions = config.connectionSetupInstructions;
+    this.dataOverviewInstructions = config.dataOverviewInstructions;
+  }
+  getConnectionSetupPrompt(language) {
+    return this.connectionSetupInstructions?.[language] ?? null;
+  }
+  getDataOverviewInstructions(language) {
+    return this.dataOverviewInstructions[language];
+  }
+};
+
+// ../connectors/src/connector-tool.ts
+var ConnectorTool = class {
+  name;
+  description;
+  inputSchema;
+  outputSchema;
+  _execute;
+  constructor(config) {
+    this.name = config.name;
+    this.description = config.description;
+    this.inputSchema = config.inputSchema;
+    this.outputSchema = config.outputSchema;
+    this._execute = config.execute;
+  }
+  createTool(connections, config) {
+    return {
+      description: this.description,
+      inputSchema: this.inputSchema,
+      outputSchema: this.outputSchema,
+      execute: (input) => this._execute(input, connections, config)
+    };
+  }
+};
+
+// ../connectors/src/connector-plugin.ts
+var ConnectorPlugin = class _ConnectorPlugin {
+  slug;
+  authType;
+  name;
+  description;
+  iconUrl;
+  parameters;
+  releaseFlag;
+  proxyPolicy;
+  experimentalAttributes;
+  onboarding;
+  systemPrompt;
+  tools;
+  query;
+  checkConnection;
+  constructor(config) {
+    this.slug = config.slug;
+    this.authType = config.authType;
+    this.name = config.name;
+    this.description = config.description;
+    this.iconUrl = config.iconUrl;
+    this.parameters = config.parameters;
+    this.releaseFlag = config.releaseFlag;
+    this.proxyPolicy = config.proxyPolicy;
+    this.experimentalAttributes = config.experimentalAttributes;
+    this.onboarding = config.onboarding;
+    this.systemPrompt = config.systemPrompt;
+    this.tools = config.tools;
+    this.query = config.query;
+    this.checkConnection = config.checkConnection;
+  }
+  get connectorKey() {
+    return _ConnectorPlugin.deriveKey(this.slug, this.authType);
+  }
+  /**
+   * Create tools for connections that belong to this connector.
+   * Filters connections by connectorKey internally.
+   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   */
+  createTools(connections, config) {
+    const myConnections = connections.filter(
+      (c) => _ConnectorPlugin.deriveKey(c.connector.slug, c.connector.authType) === this.connectorKey
+    );
+    const result = {};
+    for (const t of Object.values(this.tools)) {
+      result[`${this.connectorKey}_${t.name}`] = t.createTool(
+        myConnections,
+        config
+      );
+    }
+    return result;
+  }
+  static deriveKey(slug, authType) {
+    return authType ? `${slug}-${authType}` : slug;
+  }
+};
+
+// ../connectors/src/connectors/mailchimp/setup.ts
+var mailchimpOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call mailchimp_request with GET /lists to list all audiences
+2. Pick an audience and call GET /lists/{list_id}/members?count=5 to sample members
+3. Call GET /campaigns?count=5 to list recent campaigns
+4. Call GET /reports?count=5 to view campaign reports`,
+    ja: `1. mailchimp_request \u3067 GET /lists \u3092\u547C\u3073\u51FA\u3057\u3001\u5168\u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u4E00\u89A7\u3092\u53D6\u5F97
+2. \u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u3092\u9078\u629E\u3057 GET /lists/{list_id}/members?count=5 \u3067\u30E1\u30F3\u30D0\u30FC\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
+3. GET /campaigns?count=5 \u3067\u6700\u8FD1\u306E\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u4E00\u89A7\u3092\u53D6\u5F97
+4. GET /reports?count=5 \u3067\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u30EC\u30DD\u30FC\u30C8\u3092\u8868\u793A`
+  }
+});
+
+// ../connectors/src/connectors/mailchimp/tools/request.ts
+import { z } from "zod";
+var REQUEST_TIMEOUT_MS = 6e4;
+function extractDatacenter2(apiKey) {
+  const parts = apiKey.split("-");
+  const dc = parts[parts.length - 1];
+  if (!dc) {
+    throw new Error(
+      "Invalid Mailchimp API key format. Expected format: xxxxxxxxxxxxxxxx-us6"
+    );
+  }
+  return dc;
+}
+var inputSchema = z.object({
+  toolUseIntent: z.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z.string().describe("ID of the Mailchimp connection to use"),
+  method: z.enum(["GET", "POST", "PATCH", "PUT", "DELETE"]).describe(
+    "HTTP method. GET for reading, POST for creating, PATCH/PUT for updating, DELETE for removing."
+  ),
+  path: z.string().describe(
+    "API path appended to the base URL (e.g., '/lists', '/campaigns', '/lists/{list_id}/members')"
+  ),
+  queryParams: z.record(z.string(), z.string()).optional().describe("Query parameters to append to the URL (e.g., count, offset)"),
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST/PATCH/PUT requests")
+});
+var outputSchema = z.discriminatedUnion("success", [
+  z.object({
+    success: z.literal(true),
+    status: z.number(),
+    data: z.record(z.string(), z.unknown())
+  }),
+  z.object({
+    success: z.literal(false),
+    error: z.string()
+  })
+]);
+var requestTool = new ConnectorTool({
+  name: "request",
+  description: `Send authenticated requests to the Mailchimp Marketing API v3.
+Authentication is handled automatically using the API Key (Basic Auth).
+Use this tool for all Mailchimp API interactions: managing audiences/lists, campaigns, members/subscribers, templates, automations, and reports.
+The datacenter is automatically extracted from the API key suffix.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, path: path2, queryParams, body }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] mailchimp/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const apiKey = parameters.apiKey.getValue(connection2);
+      const dc = extractDatacenter2(apiKey);
+      const baseUrl = `https://${dc}.api.mailchimp.com/3.0`;
+      let url = `${baseUrl}${path2.startsWith("/") ? "" : "/"}${path2}`;
+      if (queryParams) {
+        const searchParams = new URLSearchParams(queryParams);
+        url += `?${searchParams.toString()}`;
+      }
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: `Basic ${btoa(`anystring:${apiKey}`)}`,
+            "Content-Type": "application/json"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        const data = await response.json();
+        if (!response.ok) {
+          const errorMessage = typeof data?.detail === "string" ? data.detail : typeof data?.title === "string" ? data.title : `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
+        }
+        return { success: true, status: response.status, data };
+      } finally {
+        clearTimeout(timeout);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/mailchimp/index.ts
+var tools = { request: requestTool };
+var mailchimpConnector = new ConnectorPlugin({
+  slug: "mailchimp",
+  authType: null,
+  name: "Mailchimp",
+  description: "Connect to Mailchimp for email marketing, audiences, campaigns, and analytics.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/5JXJ9GsMCDsJtGhO2EgTDj/a3a62e7a4e4e4e4e4e4e4e4e4e4e4e4e/mailchimp.svg",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: mailchimpOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`mailchimp_request\`: The only way to call the Mailchimp Marketing API v3. Use it to manage audiences/lists, subscribers/members, campaigns, templates, automations, and reports. Authentication (Basic Auth with API key) is configured automatically. The datacenter is extracted from the API key suffix.
+
+### Business Logic
+
+The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT read credentials from environment variables.
+
+SDK methods (client created via \`connection(connectionId)\`):
+- \`client.request(path, init?)\` \u2014 low-level authenticated fetch
+- \`client.getLists(options?)\` \u2014 list all audiences/lists
+- \`client.getListMembers(listId, options?)\` \u2014 get members of a list
+- \`client.getCampaigns(options?)\` \u2014 list all campaigns
+- \`client.getReports(options?)\` \u2014 get campaign reports
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/mailchimp";
+
+const mailchimp = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { count = 10, offset = 0 } = await c.req.json<{
+    count?: number;
+    offset?: number;
+  }>();
+
+  const { lists, total_items } = await mailchimp.getLists({ count, offset });
+
+  return c.json({ lists, total_items });
+}
+\`\`\`
+
+### Mailchimp Marketing API v3 Reference
+
+- Base URL: \`https://{dc}.api.mailchimp.com/3.0\` (datacenter auto-detected from API key)
+- Authentication: Basic Auth (\`anystring:{apiKey}\`)
+- Pagination: offset-based with \`count\` (default 10, max 1000) and \`offset\` parameters
+
+#### Audiences / Lists
+- GET \`/lists\` \u2014 List all audiences
+- GET \`/lists/{list_id}\` \u2014 Get audience details
+- POST \`/lists\` \u2014 Create an audience
+- PATCH \`/lists/{list_id}\` \u2014 Update an audience
+- DELETE \`/lists/{list_id}\` \u2014 Delete an audience
+
+#### Members / Subscribers
+- GET \`/lists/{list_id}/members\` \u2014 List members in an audience
+- GET \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 Get member details (subscriber_hash = MD5 of lowercase email)
+- POST \`/lists/{list_id}/members\` \u2014 Add a member
+- PUT \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 Add or update a member
+- PATCH \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 Update a member
+- DELETE \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 Archive a member
+
+#### Campaigns
+- GET \`/campaigns\` \u2014 List campaigns
+- GET \`/campaigns/{campaign_id}\` \u2014 Get campaign details
+- POST \`/campaigns\` \u2014 Create a campaign
+- PATCH \`/campaigns/{campaign_id}\` \u2014 Update a campaign
+- DELETE \`/campaigns/{campaign_id}\` \u2014 Delete a campaign
+- POST \`/campaigns/{campaign_id}/actions/send\` \u2014 Send a campaign
+- GET \`/campaigns/{campaign_id}/content\` \u2014 Get campaign content
+
+#### Templates
+- GET \`/templates\` \u2014 List templates
+- GET \`/templates/{template_id}\` \u2014 Get template details
+- POST \`/templates\` \u2014 Create a template
+- PATCH \`/templates/{template_id}\` \u2014 Update a template
+- DELETE \`/templates/{template_id}\` \u2014 Delete a template
+
+#### Automations
+- GET \`/automations\` \u2014 List automations
+- GET \`/automations/{workflow_id}\` \u2014 Get automation details
+- GET \`/automations/{workflow_id}/emails\` \u2014 List automation emails
+- POST \`/automations/{workflow_id}/actions/pause-all-emails\` \u2014 Pause automation
+- POST \`/automations/{workflow_id}/actions/start-all-emails\` \u2014 Start automation
+
+#### Reports
+- GET \`/reports\` \u2014 List campaign reports
+- GET \`/reports/{campaign_id}\` \u2014 Get a campaign report
+- GET \`/reports/{campaign_id}/click-details\` \u2014 Get click details
+- GET \`/reports/{campaign_id}/open-details\` \u2014 Get open details
+- GET \`/reports/{campaign_id}/sent-to\` \u2014 Get sent-to details
+- GET \`/reports/{campaign_id}/unsubscribed\` \u2014 List unsubscribed members
+
+#### Search
+- GET \`/search-members?query={query}\` \u2014 Search members across all audiences
+
+#### Batch Operations
+- POST \`/batches\` \u2014 Start a batch operation
+- GET \`/batches\` \u2014 List batch operations
+- GET \`/batches/{batch_id}\` \u2014 Get batch status
+
+### Tips
+- Use \`fields\` and \`exclude_fields\` query params to filter response fields
+- The subscriber_hash is the MD5 hash of the lowercase email address
+- Errors return \`type\`, \`title\`, \`status\`, \`detail\`, and \`instance\` fields`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`mailchimp_request\`: Mailchimp Marketing API v3\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9/\u30EA\u30B9\u30C8\u3001\u30B5\u30D6\u30B9\u30AF\u30E9\u30A4\u30D0\u30FC/\u30E1\u30F3\u30D0\u30FC\u3001\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u3001\u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u3001\u30AA\u30FC\u30C8\u30E1\u30FC\u30B7\u30E7\u30F3\u3001\u30EC\u30DD\u30FC\u30C8\u306E\u7BA1\u7406\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08API\u30AD\u30FC\u306B\u3088\u308BBasic Auth\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u30C7\u30FC\u30BF\u30BB\u30F3\u30BF\u30FC\u306FAPI\u30AD\u30FC\u306E\u30B5\u30D5\u30A3\u30C3\u30AF\u30B9\u304B\u3089\u81EA\u52D5\u691C\u51FA\u3055\u308C\u307E\u3059\u3002
+
+### Business Logic
+
+\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u30B3\u30CD\u30AF\u30BFSDK\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u8A8D\u8A3C\u60C5\u5831\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+
+SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
+- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304Dfetch
+- \`client.getLists(options?)\` \u2014 \u5168\u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9/\u30EA\u30B9\u30C8\u306E\u4E00\u89A7
+- \`client.getListMembers(listId, options?)\` \u2014 \u30EA\u30B9\u30C8\u306E\u30E1\u30F3\u30D0\u30FC\u53D6\u5F97
+- \`client.getCampaigns(options?)\` \u2014 \u5168\u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u4E00\u89A7
+- \`client.getReports(options?)\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u30EC\u30DD\u30FC\u30C8\u306E\u53D6\u5F97
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/mailchimp";
+
+const mailchimp = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { count = 10, offset = 0 } = await c.req.json<{
+    count?: number;
+    offset?: number;
+  }>();
+
+  const { lists, total_items } = await mailchimp.getLists({ count, offset });
+
+  return c.json({ lists, total_items });
+}
+\`\`\`
+
+### Mailchimp Marketing API v3 \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://{dc}.api.mailchimp.com/3.0\`\uFF08\u30C7\u30FC\u30BF\u30BB\u30F3\u30BF\u30FC\u306FAPI\u30AD\u30FC\u304B\u3089\u81EA\u52D5\u691C\u51FA\uFF09
+- \u8A8D\u8A3C: Basic Auth (\`anystring:{apiKey}\`)
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3: \`count\`\uFF08\u30C7\u30D5\u30A9\u30EB\u30C810\u3001\u6700\u59271000\uFF09\u3068\`offset\`\u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AA\u30D5\u30BB\u30C3\u30C8\u30D9\u30FC\u30B9
+
+#### \u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9 / \u30EA\u30B9\u30C8
+- GET \`/lists\` \u2014 \u5168\u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u306E\u4E00\u89A7
+- GET \`/lists/{list_id}\` \u2014 \u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u306E\u8A73\u7D30
+- POST \`/lists\` \u2014 \u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u306E\u4F5C\u6210
+- PATCH \`/lists/{list_id}\` \u2014 \u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u306E\u66F4\u65B0
+- DELETE \`/lists/{list_id}\` \u2014 \u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u306E\u524A\u9664
+
+#### \u30E1\u30F3\u30D0\u30FC / \u30B5\u30D6\u30B9\u30AF\u30E9\u30A4\u30D0\u30FC
+- GET \`/lists/{list_id}/members\` \u2014 \u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u306E\u30E1\u30F3\u30D0\u30FC\u4E00\u89A7
+- GET \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 \u30E1\u30F3\u30D0\u30FC\u306E\u8A73\u7D30\uFF08subscriber_hash = \u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9\u5C0F\u6587\u5B57\u306EMD5\uFF09
+- POST \`/lists/{list_id}/members\` \u2014 \u30E1\u30F3\u30D0\u30FC\u306E\u8FFD\u52A0
+- PUT \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 \u30E1\u30F3\u30D0\u30FC\u306E\u8FFD\u52A0\u307E\u305F\u306F\u66F4\u65B0
+- PATCH \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 \u30E1\u30F3\u30D0\u30FC\u306E\u66F4\u65B0
+- DELETE \`/lists/{list_id}/members/{subscriber_hash}\` \u2014 \u30E1\u30F3\u30D0\u30FC\u306E\u30A2\u30FC\u30AB\u30A4\u30D6
+
+#### \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3
+- GET \`/campaigns\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u4E00\u89A7
+- GET \`/campaigns/{campaign_id}\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u8A73\u7D30
+- POST \`/campaigns\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u4F5C\u6210
+- PATCH \`/campaigns/{campaign_id}\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u66F4\u65B0
+- DELETE \`/campaigns/{campaign_id}\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u524A\u9664
+- POST \`/campaigns/{campaign_id}/actions/send\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u306E\u9001\u4FE1
+- GET \`/campaigns/{campaign_id}/content\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u30B3\u30F3\u30C6\u30F3\u30C4\u306E\u53D6\u5F97
+
+#### \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8
+- GET \`/templates\` \u2014 \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u4E00\u89A7
+- GET \`/templates/{template_id}\` \u2014 \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306E\u8A73\u7D30
+- POST \`/templates\` \u2014 \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306E\u4F5C\u6210
+- PATCH \`/templates/{template_id}\` \u2014 \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306E\u66F4\u65B0
+- DELETE \`/templates/{template_id}\` \u2014 \u30C6\u30F3\u30D7\u30EC\u30FC\u30C8\u306E\u524A\u9664
+
+#### \u30AA\u30FC\u30C8\u30E1\u30FC\u30B7\u30E7\u30F3
+- GET \`/automations\` \u2014 \u30AA\u30FC\u30C8\u30E1\u30FC\u30B7\u30E7\u30F3\u4E00\u89A7
+- GET \`/automations/{workflow_id}\` \u2014 \u30AA\u30FC\u30C8\u30E1\u30FC\u30B7\u30E7\u30F3\u306E\u8A73\u7D30
+- GET \`/automations/{workflow_id}/emails\` \u2014 \u30AA\u30FC\u30C8\u30E1\u30FC\u30B7\u30E7\u30F3\u30E1\u30FC\u30EB\u4E00\u89A7
+- POST \`/automations/{workflow_id}/actions/pause-all-emails\` \u2014 \u30AA\u30FC\u30C8\u30E1\u30FC\u30B7\u30E7\u30F3\u306E\u4E00\u6642\u505C\u6B62
+- POST \`/automations/{workflow_id}/actions/start-all-emails\` \u2014 \u30AA\u30FC\u30C8\u30E1\u30FC\u30B7\u30E7\u30F3\u306E\u958B\u59CB
+
+#### \u30EC\u30DD\u30FC\u30C8
+- GET \`/reports\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u30EC\u30DD\u30FC\u30C8\u4E00\u89A7
+- GET \`/reports/{campaign_id}\` \u2014 \u30AD\u30E3\u30F3\u30DA\u30FC\u30F3\u30EC\u30DD\u30FC\u30C8\u306E\u53D6\u5F97
+- GET \`/reports/{campaign_id}/click-details\` \u2014 \u30AF\u30EA\u30C3\u30AF\u8A73\u7D30
+- GET \`/reports/{campaign_id}/open-details\` \u2014 \u958B\u5C01\u8A73\u7D30
+- GET \`/reports/{campaign_id}/sent-to\` \u2014 \u9001\u4FE1\u5148\u8A73\u7D30
+- GET \`/reports/{campaign_id}/unsubscribed\` \u2014 \u914D\u4FE1\u505C\u6B62\u30E1\u30F3\u30D0\u30FC\u4E00\u89A7
+
+#### \u691C\u7D22
+- GET \`/search-members?query={query}\` \u2014 \u5168\u30AA\u30FC\u30C7\u30A3\u30A8\u30F3\u30B9\u306E\u30E1\u30F3\u30D0\u30FC\u691C\u7D22
+
+#### \u30D0\u30C3\u30C1\u64CD\u4F5C
+- POST \`/batches\` \u2014 \u30D0\u30C3\u30C1\u64CD\u4F5C\u306E\u958B\u59CB
+- GET \`/batches\` \u2014 \u30D0\u30C3\u30C1\u64CD\u4F5C\u4E00\u89A7
+- GET \`/batches/{batch_id}\` \u2014 \u30D0\u30C3\u30C1\u72B6\u614B\u306E\u53D6\u5F97
+
+### \u30D2\u30F3\u30C8
+- \`fields\`\u3068\`exclude_fields\`\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3067\u30EC\u30B9\u30DD\u30F3\u30B9\u30D5\u30A3\u30FC\u30EB\u30C9\u3092\u30D5\u30A3\u30EB\u30BF\u53EF\u80FD
+- subscriber_hash\u306F\u30E1\u30FC\u30EB\u30A2\u30C9\u30EC\u30B9\u306E\u5C0F\u6587\u5B57\u306EMD5\u30CF\u30C3\u30B7\u30E5
+- \u30A8\u30E9\u30FC\u306F\`type\`, \`title\`, \`status\`, \`detail\`, \`instance\`\u30D5\u30A3\u30FC\u30EB\u30C9\u3092\u8FD4\u5374`
+  },
+  tools
+});
+
+// src/connectors/create-connector-sdk.ts
+import { readFileSync } from "fs";
+import path from "path";
+
+// src/connector-client/env.ts
+function resolveEnvVar(entry, key, connectionId) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) {
+    throw new Error(`Connection "${connectionId}" is missing envVars mapping for key "${key}"`);
+  }
+  const value = process.env[envVarName];
+  if (!value) {
+    throw new Error(`Environment variable "${envVarName}" (for connection "${connectionId}", key "${key}") is not set`);
+  }
+  return value;
+}
+function resolveEnvVarOptional(entry, key) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) return void 0;
+  return process.env[envVarName] || void 0;
+}
+
+// src/connectors/create-connector-sdk.ts
+function loadConnectionsSync() {
+  const filePath = process.env.CONNECTIONS_PATH ?? path.join(process.cwd(), ".squadbase/connections.json");
+  try {
+    const raw = readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function createConnectorSdk(plugin, createClient2) {
+  return (connectionId) => {
+    const connections = loadConnectionsSync();
+    const entry = connections[connectionId];
+    if (!entry) {
+      throw new Error(
+        `Connection "${connectionId}" not found in .squadbase/connections.json`
+      );
+    }
+    if (entry.connector.slug !== plugin.slug) {
+      throw new Error(
+        `Connection "${connectionId}" is not a ${plugin.slug} connection (got "${entry.connector.slug}")`
+      );
+    }
+    const params = {};
+    for (const param of Object.values(plugin.parameters)) {
+      if (param.required) {
+        params[param.slug] = resolveEnvVar(entry, param.slug, connectionId);
+      } else {
+        const val = resolveEnvVarOptional(entry, param.slug);
+        if (val !== void 0) params[param.slug] = val;
+      }
+    }
+    return createClient2(params);
+  };
+}
+
+// src/connectors/entries/mailchimp.ts
+var connection = createConnectorSdk(mailchimpConnector, createClient);
+export {
+  connection
+};

package/dist/connectors/shopify-oauth.js

@@ -293,9 +293,13 @@ var shopifyOauthConnector = new ConnectorPlugin({
     ]
   },
   systemPrompt: {
-    en: `### Shopify API (OAuth)
+    en: `### Tools
 
-### Available Endpoints (API version: 2024-10)
+- \`shopify-oauth_request\`: The only way to call the Shopify Admin REST API. Use it to query products, orders, customers, inventory, collections, and more. Authentication is configured automatically via OAuth proxy. Shopify uses cursor-based pagination via the \`page_info\` query parameter (obtained from the Link header in the response).
+
+### Shopify Admin REST API Reference
+
+#### Available Endpoints (API version: 2024-10)
 - GET \`/admin/api/2024-10/shop.json\` \u2014 Get shop info
 - GET \`/admin/api/2024-10/products.json\` \u2014 List products
 - GET \`/admin/api/2024-10/products/{id}.json\` \u2014 Get a product
@@ -336,9 +340,13 @@ const shopify = connection("<connectionId>");
 const res = await shopify.request("/admin/api/2024-10/products.json?limit=10");
 const data = await res.json();
 \`\`\``,
-    ja: `### Shopify API (OAuth)
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`shopify-oauth_request\`: Shopify Admin REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u5546\u54C1\u3001\u6CE8\u6587\u3001\u9867\u5BA2\u3001\u5728\u5EAB\u3001\u30B3\u30EC\u30AF\u30B7\u30E7\u30F3\u306A\u3069\u306E\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth\u30D7\u30ED\u30AD\u30B7\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002Shopify\u306F\u30EC\u30B9\u30DD\u30F3\u30B9\u306E Link \u30D8\u30C3\u30C0\u30FC\u304B\u3089\u53D6\u5F97\u3059\u308B \`page_info\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
+
+### Shopify Admin REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 
-### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8 (API\u30D0\u30FC\u30B8\u30E7\u30F3: 2024-10)
+#### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8 (API\u30D0\u30FC\u30B8\u30E7\u30F3: 2024-10)
 - GET \`/admin/api/2024-10/shop.json\` \u2014 \u30B7\u30E7\u30C3\u30D7\u60C5\u5831\u3092\u53D6\u5F97
 - GET \`/admin/api/2024-10/products.json\` \u2014 \u5546\u54C1\u4E00\u89A7\u3092\u53D6\u5F97
 - GET \`/admin/api/2024-10/products/{id}.json\` \u2014 \u5546\u54C1\u3092\u53D6\u5F97