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

package/dist/connectors/stripe-oauth.js

@@ -296,9 +296,13 @@ var stripeOauthConnector = new ConnectorPlugin({
     ]
   },
   systemPrompt: {
-    en: `### Stripe API (OAuth)
+    en: `### Tools
 
-### Available Endpoints
+- \`stripe-oauth_request\`: The only way to call the Stripe API. Use it to query charges, customers, invoices, subscriptions, products, prices, payment intents, balances, and more. Authentication is configured automatically via OAuth. Stripe uses cursor-based pagination with \`starting_after\` and \`has_more\`.
+
+### Stripe API Reference
+
+#### Available Endpoints
 - GET \`/v1/charges\` \u2014 List charges
 - GET \`/v1/charges/{chargeId}\` \u2014 Get a charge
 - GET \`/v1/customers\` \u2014 List customers
@@ -341,9 +345,13 @@ const stripe = connection("<connectionId>");
 const res = await stripe.request("/v1/customers?limit=10");
 const data = await res.json();
 \`\`\``,
-    ja: `### Stripe API (OAuth)
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`stripe-oauth_request\`: Stripe API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u8ACB\u6C42\u3001\u9867\u5BA2\u3001\u8ACB\u6C42\u66F8\u3001\u30B5\u30D6\u30B9\u30AF\u30EA\u30D7\u30B7\u30E7\u30F3\u3001\u5546\u54C1\u3001\u4FA1\u683C\u3001\u652F\u6255\u3044\u30A4\u30F3\u30C6\u30F3\u30C8\u3001\u6B8B\u9AD8\u306A\u3069\u306E\u30AF\u30A8\u30EA\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002Stripe\u306F \`starting_after\` \u3068 \`has_more\` \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
+
+### Stripe API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
 
-### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+#### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
 - GET \`/v1/charges\` \u2014 \u8ACB\u6C42\u4E00\u89A7\u3092\u53D6\u5F97
 - GET \`/v1/charges/{chargeId}\` \u2014 \u8ACB\u6C42\u3092\u53D6\u5F97
 - GET \`/v1/customers\` \u2014 \u9867\u5BA2\u4E00\u89A7\u3092\u53D6\u5F97

package/dist/connectors/zendesk-oauth.d.ts

@@ -0,0 +1,5 @@
+import * as _squadbase_connectors_sdk from '@squadbase/connectors/sdk';
+
+declare const connection: (connectionId: string) => _squadbase_connectors_sdk.ZendeskOauthConnectorSdk;
+
+export { connection };

package/dist/connectors/zendesk-oauth.js

@@ -0,0 +1,505 @@
+// ../connectors/src/connectors/zendesk-oauth/sdk/index.ts
+function createClient(_params, fetchFn = fetch) {
+  function request(path2, init) {
+    return fetchFn(path2, init);
+  }
+  return { request };
+}
+
+// ../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/auth-types.ts
+var AUTH_TYPES = {
+  OAUTH: "oauth",
+  API_KEY: "api-key",
+  JWT: "jwt",
+  SERVICE_ACCOUNT: "service-account",
+  PAT: "pat"
+};
+
+// ../connectors/src/connectors/zendesk-oauth/tools/request.ts
+import { z } from "zod";
+var REQUEST_TIMEOUT_MS = 6e4;
+var cachedToken = null;
+async function getProxyToken(config) {
+  if (cachedToken && cachedToken.expiresAt > Date.now() + 6e4) {
+    return cachedToken.token;
+  }
+  const url = `${config.appApiBaseUrl}/v0/database/${config.projectId}/environment/${config.environmentId}/oauth-request-proxy-token`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": config.appApiKey,
+      "project-id": config.projectId
+    },
+    body: JSON.stringify({
+      sandboxId: config.sandboxId,
+      issuedBy: "coding-agent"
+    })
+  });
+  if (!res.ok) {
+    const errorText = await res.text().catch(() => res.statusText);
+    throw new Error(
+      `Failed to get proxy token: HTTP ${res.status} ${errorText}`
+    );
+  }
+  const data = await res.json();
+  cachedToken = {
+    token: data.token,
+    expiresAt: new Date(data.expiresAt).getTime()
+  };
+  return data.token;
+}
+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 Zendesk OAuth connection to use"),
+  method: z.enum(["GET", "POST", "PUT", "DELETE"]).describe("HTTP method"),
+  path: z.string().describe(
+    "API path appended to the Zendesk base URL (e.g., '/api/v2/tickets.json', '/api/v2/search.json?query=status:open')"
+  ),
+  queryParams: z.record(z.string(), z.string()).optional().describe("Query parameters to append to the URL"),
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST/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 Zendesk Support API.
+Authentication is handled automatically via OAuth proxy.
+Use this tool for all Zendesk API interactions: querying tickets, users, organizations, groups, and searching.
+Zendesk uses cursor-based pagination with page[size] and page[after] parameters. All endpoint paths end with .json.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, path: path2, queryParams, body }, connections, config) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] zendesk-oauth/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      let url = path2;
+      if (queryParams) {
+        const searchParams = new URLSearchParams(queryParams);
+        const separator = url.includes("?") ? "&" : "?";
+        url += `${separator}${searchParams.toString()}`;
+      }
+      const token = await getProxyToken(config.oauthProxy);
+      const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(proxyUrl, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${token}`
+          },
+          body: JSON.stringify({
+            url,
+            method,
+            body: body ? JSON.stringify(body) : void 0
+          }),
+          signal: controller.signal
+        });
+        const data = await response.json();
+        if (!response.ok) {
+          const errorMessage = typeof data?.error === "string" ? data.error : typeof data?.description === "string" ? data.description : `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/zendesk-oauth/setup.ts
+var requestToolName = `zendesk-oauth_${requestTool.name}`;
+var zendeskOauthOnboarding = new ConnectorOnboarding({
+  connectionSetupInstructions: {
+    en: `Follow these steps to set up the Zendesk connection.
+
+1. Call \`${requestToolName}\` to fetch account info:
+   - \`method\`: \`"GET"\`
+   - \`path\`: \`"/api/v2/account/settings.json"\`
+2. If an error is returned, ask the user to check the OAuth connection settings
+3. Call \`updateConnectionContext\`:
+   - \`account\`: Zendesk subdomain or account name
+   - \`note\`: Brief description of the setup
+
+#### Constraints
+- **Do NOT read business data during setup**. Only the metadata request specified in the steps above is allowed
+- Write only 1 sentence between tool calls, then immediately call the next tool. Skip unnecessary explanations and proceed efficiently`,
+    ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067Zendesk\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
+
+1. \`${requestToolName}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u3001\u30A2\u30AB\u30A6\u30F3\u30C8\u60C5\u5831\u3092\u53D6\u5F97\u3059\u308B:
+   - \`method\`: \`"GET"\`
+   - \`path\`: \`"/api/v2/account/settings.json"\`
+2. \u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u3001\u30E6\u30FC\u30B6\u30FC\u306BOAuth\u63A5\u7D9A\u306E\u8A2D\u5B9A\u3092\u78BA\u8A8D\u3059\u308B\u3088\u3046\u4F1D\u3048\u308B
+3. \`updateConnectionContext\` \u3092\u547C\u3073\u51FA\u3059:
+   - \`account\`: Zendesk\u30B5\u30D6\u30C9\u30E1\u30A4\u30F3\u307E\u305F\u306F\u30A2\u30AB\u30A6\u30F3\u30C8\u540D
+   - \`note\`: \u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u5185\u5BB9\u306E\u7C21\u5358\u306A\u8AAC\u660E
+
+#### \u5236\u7D04
+- **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B\u30D3\u30B8\u30CD\u30B9\u30C7\u30FC\u30BF\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3053\u3068**\u3002\u5B9F\u884C\u3057\u3066\u3088\u3044\u306E\u306F\u4E0A\u8A18\u624B\u9806\u3067\u6307\u5B9A\u3055\u308C\u305F\u30E1\u30BF\u30C7\u30FC\u30BF\u53D6\u5F97\u30EA\u30AF\u30A8\u30B9\u30C8\u306E\u307F
+- \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057\u3002\u4E0D\u8981\u306A\u8AAC\u660E\u306F\u7701\u7565\u3057\u3001\u52B9\u7387\u7684\u306B\u9032\u3081\u308B`
+  },
+  dataOverviewInstructions: {
+    en: `1. Call zendesk-oauth_request with GET /api/v2/ticket_fields.json to list available ticket fields
+2. Call zendesk-oauth_request with GET /api/v2/tickets.json?page[size]=5 to explore ticket structure
+3. Call zendesk-oauth_request with GET /api/v2/users.json?page[size]=5 to explore user structure
+4. Call zendesk-oauth_request with GET /api/v2/organizations.json?page[size]=5 to explore organization structure`,
+    ja: `1. zendesk-oauth_request \u3067 GET /api/v2/ticket_fields.json \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30C1\u30B1\u30C3\u30C8\u30D5\u30A3\u30FC\u30EB\u30C9\u3092\u78BA\u8A8D
+2. zendesk-oauth_request \u3067 GET /api/v2/tickets.json?page[size]=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30C1\u30B1\u30C3\u30C8\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+3. zendesk-oauth_request \u3067 GET /api/v2/users.json?page[size]=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u306E\u69CB\u9020\u3092\u78BA\u8A8D
+4. zendesk-oauth_request \u3067 GET /api/v2/organizations.json?page[size]=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u7D44\u7E54\u306E\u69CB\u9020\u3092\u78BA\u8A8D`
+  }
+});
+
+// ../connectors/src/connectors/zendesk-oauth/parameters.ts
+var parameters = {};
+
+// ../connectors/src/connectors/zendesk-oauth/index.ts
+var tools = { request: requestTool };
+var zendeskOauthConnector = new ConnectorPlugin({
+  slug: "zendesk",
+  authType: AUTH_TYPES.OAUTH,
+  name: "Zendesk (OAuth)",
+  description: "Connect to Zendesk Support for tickets, users, organizations, and customer service data using OAuth.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/4vJHzNjXZ5gPabCCjTMz7v/2afba49a2b7e901f1e6c3cfa16d76e82/zendesk.svg",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: zendeskOauthOnboarding,
+  proxyPolicy: {
+    allowlist: [
+      {
+        host: "*.zendesk.com",
+        methods: ["GET", "POST", "PUT", "DELETE"]
+      }
+    ]
+  },
+  systemPrompt: {
+    en: `### Tools
+
+- \`zendesk-oauth_request\`: The only way to call the Zendesk Support API. Use it to query tickets, users, organizations, groups, and perform searches. Authentication is configured automatically via OAuth. Zendesk uses cursor-based pagination with \`page[size]\` and \`page[after]\` parameters. All endpoint paths end with \`.json\`.
+
+### Zendesk API Reference
+
+#### Tickets
+- GET \`/api/v2/tickets.json\` \u2014 List tickets
+- GET \`/api/v2/tickets/{id}.json\` \u2014 Get a ticket
+- POST \`/api/v2/tickets.json\` \u2014 Create a ticket
+- PUT \`/api/v2/tickets/{id}.json\` \u2014 Update a ticket
+- DELETE \`/api/v2/tickets/{id}.json\` \u2014 Delete a ticket
+- GET \`/api/v2/tickets/{id}/comments.json\` \u2014 List ticket comments
+
+#### Users
+- GET \`/api/v2/users.json\` \u2014 List users
+- GET \`/api/v2/users/{id}.json\` \u2014 Get a user
+
+#### Organizations
+- GET \`/api/v2/organizations.json\` \u2014 List organizations
+- GET \`/api/v2/organizations/{id}.json\` \u2014 Get an organization
+
+#### Groups
+- GET \`/api/v2/groups.json\` \u2014 List groups
+
+#### Search
+- GET \`/api/v2/search.json?query={query}\` \u2014 Search tickets, users, organizations
+- Query params: \`sort_by\` (updated_at, created_at, priority, status), \`sort_order\` (asc, desc)
+
+#### Ticket Fields & Forms
+- GET \`/api/v2/ticket_fields.json\` \u2014 List ticket fields
+- GET \`/api/v2/ticket_forms.json\` \u2014 List ticket forms
+
+#### Views
+- GET \`/api/v2/views.json\` \u2014 List views
+- GET \`/api/v2/views/{id}/tickets.json\` \u2014 List tickets in a view
+
+### Tips
+- All endpoint paths end with \`.json\`
+- Pagination uses cursor-based \`page[size]\` and \`page[after]\` parameters
+- Search uses Zendesk query syntax (e.g., \`type:ticket status:open\`)
+- Max 100 results per page
+
+### Business Logic
+
+The business logic type for this connector is "typescript". Write handler code using the connector SDK shown below. Do NOT access credentials directly from environment variables.
+
+#### Example
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/zendesk-oauth";
+
+const zendesk = connection("<connectionId>");
+
+// Authenticated fetch (returns standard Response)
+const res = await zendesk.request("/api/v2/tickets.json?page[size]=10");
+const data = await res.json();
+\`\`\``,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`zendesk-oauth_request\`: Zendesk Support API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30C1\u30B1\u30C3\u30C8\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u7D44\u7E54\u3001\u30B0\u30EB\u30FC\u30D7\u306E\u30AF\u30A8\u30EA\u3084\u691C\u7D22\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002Zendesk\u306F \`page[size]\` \u3068 \`page[after]\` \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\u5168\u3066\u306E\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u30D1\u30B9\u306F \`.json\` \u3067\u7D42\u308F\u308A\u307E\u3059\u3002
+
+### Zendesk API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+#### \u30C1\u30B1\u30C3\u30C8
+- GET \`/api/v2/tickets.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
+- GET \`/api/v2/tickets/{id}.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u3092\u53D6\u5F97
+- POST \`/api/v2/tickets.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u3092\u4F5C\u6210
+- PUT \`/api/v2/tickets/{id}.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u3092\u66F4\u65B0
+- DELETE \`/api/v2/tickets/{id}.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u3092\u524A\u9664
+- GET \`/api/v2/tickets/{id}/comments.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u30B3\u30E1\u30F3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
+
+#### \u30E6\u30FC\u30B6\u30FC
+- GET \`/api/v2/users.json\` \u2014 \u30E6\u30FC\u30B6\u30FC\u4E00\u89A7\u3092\u53D6\u5F97
+- GET \`/api/v2/users/{id}.json\` \u2014 \u30E6\u30FC\u30B6\u30FC\u3092\u53D6\u5F97
+
+#### \u7D44\u7E54
+- GET \`/api/v2/organizations.json\` \u2014 \u7D44\u7E54\u4E00\u89A7\u3092\u53D6\u5F97
+- GET \`/api/v2/organizations/{id}.json\` \u2014 \u7D44\u7E54\u3092\u53D6\u5F97
+
+#### \u30B0\u30EB\u30FC\u30D7
+- GET \`/api/v2/groups.json\` \u2014 \u30B0\u30EB\u30FC\u30D7\u4E00\u89A7\u3092\u53D6\u5F97
+
+#### \u691C\u7D22
+- GET \`/api/v2/search.json?query={query}\` \u2014 \u30C1\u30B1\u30C3\u30C8\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u7D44\u7E54\u3092\u691C\u7D22
+- \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF: \`sort_by\`\uFF08updated_at, created_at, priority, status\uFF09\u3001\`sort_order\`\uFF08asc, desc\uFF09
+
+#### \u30C1\u30B1\u30C3\u30C8\u30D5\u30A3\u30FC\u30EB\u30C9\u30FB\u30D5\u30A9\u30FC\u30E0
+- GET \`/api/v2/ticket_fields.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u30D5\u30A3\u30FC\u30EB\u30C9\u4E00\u89A7\u3092\u53D6\u5F97
+- GET \`/api/v2/ticket_forms.json\` \u2014 \u30C1\u30B1\u30C3\u30C8\u30D5\u30A9\u30FC\u30E0\u4E00\u89A7\u3092\u53D6\u5F97
+
+#### \u30D3\u30E5\u30FC
+- GET \`/api/v2/views.json\` \u2014 \u30D3\u30E5\u30FC\u4E00\u89A7\u3092\u53D6\u5F97
+- GET \`/api/v2/views/{id}/tickets.json\` \u2014 \u30D3\u30E5\u30FC\u5185\u306E\u30C1\u30B1\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
+
+### \u30D2\u30F3\u30C8
+- \u5168\u3066\u306E\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u30D1\u30B9\u306F \`.json\` \u3067\u7D42\u308F\u308A\u307E\u3059
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u306F\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E \`page[size]\` \u3068 \`page[after]\` \u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u4F7F\u7528\u3057\u307E\u3059
+- \u691C\u7D22\u306FZendesk\u30AF\u30A8\u30EA\u69CB\u6587\u3092\u4F7F\u7528\u3057\u307E\u3059\uFF08\u4F8B: \`type:ticket status:open\`\uFF09
+- 1\u30DA\u30FC\u30B8\u3042\u305F\u308A\u6700\u5927100\u4EF6
+
+### 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\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BFSDK\u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+
+#### Example
+
+\`\`\`ts
+import { connection } from "@squadbase/vite-server/connectors/zendesk-oauth";
+
+const zendesk = connection("<connectionId>");
+
+// Authenticated fetch (returns standard Response)
+const res = await zendesk.request("/api/v2/tickets.json?page[size]=10");
+const data = await res.json();
+\`\`\``
+  },
+  tools,
+  async checkConnection(_params, config) {
+    const { proxyFetch } = config;
+    try {
+      const res = await proxyFetch("/api/v2/account/settings.json", {
+        method: "GET"
+      });
+      if (!res.ok) {
+        const errorText = await res.text().catch(() => res.statusText);
+        return {
+          success: false,
+          error: `Zendesk API failed: HTTP ${res.status} ${errorText}`
+        };
+      }
+      return { success: true };
+    } catch (error) {
+      return {
+        success: false,
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  }
+});
+
+// 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/zendesk-oauth.ts
+var connection = createConnectorSdk(zendeskOauthConnector, createClient);
+export {
+  connection
+};

package/dist/connectors/zendesk.d.ts

@@ -0,0 +1,5 @@
+import * as _squadbase_connectors_sdk from '@squadbase/connectors/sdk';
+
+declare const connection: (connectionId: string) => _squadbase_connectors_sdk.ZendeskConnectorSdk;
+
+export { connection };