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

package/dist/connectors/attio.js

@@ -56,6 +56,7 @@ var parameters = {
 };
 
 // ../connectors/src/connectors/attio/sdk/index.ts
+var BASE_URL = "https://api.attio.com/v2";
 function createClient(params) {
   const apiKey = params[parameters.apiKey.slug];
   if (!apiKey) {
@@ -63,9 +64,131 @@ function createClient(params) {
       `attio: missing required parameter: ${parameters.apiKey.slug}`
     );
   }
-  return { apiKey };
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", `Bearer ${apiKey}`);
+    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(
+        `attio ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  return {
+    request(path2, init) {
+      const url = `${BASE_URL}${path2}`;
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", `Bearer ${apiKey}`);
+      headers.set("Content-Type", "application/json");
+      return fetch(url, { ...init, headers });
+    },
+    async listObjects() {
+      const res = await fetch(`${BASE_URL}/objects`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "listObjects");
+      return await res.json();
+    },
+    async listAttributes(object) {
+      const res = await fetch(
+        `${BASE_URL}/objects/${encodeURIComponent(object)}/attributes`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listAttributes");
+      return await res.json();
+    },
+    async queryRecords(object, options) {
+      const body = {};
+      if (options?.filter) body.filter = options.filter;
+      if (options?.sorts) body.sorts = options.sorts;
+      if (options?.limit) body.limit = options.limit;
+      if (options?.offset) body.offset = options.offset;
+      const res = await fetch(
+        `${BASE_URL}/objects/${encodeURIComponent(object)}/records/query`,
+        {
+          method: "POST",
+          headers: authHeaders(),
+          body: JSON.stringify(body)
+        }
+      );
+      await assertOk(res, "queryRecords");
+      return await res.json();
+    },
+    async getRecord(object, recordId) {
+      const res = await fetch(
+        `${BASE_URL}/objects/${encodeURIComponent(object)}/records/${encodeURIComponent(recordId)}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getRecord");
+      return await res.json();
+    },
+    async queryListEntries(listId, options) {
+      const body = {};
+      if (options?.filter) body.filter = options.filter;
+      if (options?.sorts) body.sorts = options.sorts;
+      if (options?.limit) body.limit = options.limit;
+      if (options?.offset) body.offset = options.offset;
+      const res = await fetch(
+        `${BASE_URL}/lists/${encodeURIComponent(listId)}/entries/query`,
+        {
+          method: "POST",
+          headers: authHeaders(),
+          body: JSON.stringify(body)
+        }
+      );
+      await assertOk(res, "queryListEntries");
+      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;
@@ -124,8 +247,100 @@ var ConnectorPlugin = class _ConnectorPlugin {
   }
 };
 
+// ../connectors/src/connectors/attio/setup.ts
+var attioOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call attio_request with GET /objects to list all available objects (people, companies, deals, etc.)
+2. Call attio_request with GET /objects/people/attributes to explore the people object attributes
+3. Call attio_request with POST /objects/people/records/query with { "limit": 5 } to sample people records
+4. Explore other objects (companies, deals) as needed`,
+    ja: `1. attio_request \u3067 GET /objects \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97\uFF08people\u3001companies\u3001deals\u306A\u3069\uFF09
+2. attio_request \u3067 GET /objects/people/attributes \u3092\u547C\u3073\u51FA\u3057\u3001people\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u5C5E\u6027\u3092\u78BA\u8A8D
+3. attio_request \u3067 POST /objects/people/records/query \u3092 { "limit": 5 } \u3067\u547C\u3073\u51FA\u3057\u3001people\u30EC\u30B3\u30FC\u30C9\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
+4. \u5FC5\u8981\u306B\u5FDC\u3058\u3066\u4ED6\u306E\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\uFF08companies\u3001deals\uFF09\u3092\u63A2\u7D22`
+  }
+});
+
+// ../connectors/src/connectors/attio/tools/request.ts
+import { z } from "zod";
+var BASE_URL2 = "https://api.attio.com/v2";
+var REQUEST_TIMEOUT_MS = 6e4;
+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 Attio connection to use"),
+  method: z.enum(["GET", "POST", "PATCH", "DELETE"]).describe(
+    "HTTP method. GET for reading resources, POST for creating or querying records, PATCH for updating, DELETE for removing."
+  ),
+  path: z.string().describe(
+    "API path (e.g., '/objects', '/objects/people/records/query', '/objects/companies/records/{record_id}')"
+  ),
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST/PATCH 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 Attio REST API.
+Authentication is handled automatically using the API Key (Bearer token).
+Use this tool for all Attio API interactions: querying records (people, companies, deals), listing objects and attributes, managing list entries, and working with notes.
+Note that querying records uses POST (not GET) with a request body for filters.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, method, path: path2, body }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] attio/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const apiKey = parameters.apiKey.getValue(connection2);
+      const url = `${BASE_URL2}${path2}`;
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: `Bearer ${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?.message === "string" ? data.message : typeof data?.error === "string" ? data.error : `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/attio/index.ts
-var tools = {};
+var tools = { request: requestTool };
 var attioConnector = new ConnectorPlugin({
   slug: "attio",
   authType: null,
@@ -134,69 +349,122 @@ var attioConnector = new ConnectorPlugin({
   iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/2qqx99vvXJojUM3tSrSWPX/1e7c35e13da6b365b8b475c1effe568f/attio.svg",
   parameters,
   releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: attioOnboarding,
   systemPrompt: {
-    en: `### Attio SDK (TypeScript handler)
-Use the Attio connector via the SDK in TypeScript handlers:
+    en: `### Tools
+
+- \`attio_request\`: The only way to call the Attio REST API. Use it to query records (people, companies, deals), list objects and attributes, manage list entries, and work with notes. Authentication (Bearer token) is configured automatically. Note that querying records uses POST (not GET) with a request body containing filters.
+
+### 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.listObjects()\` \u2014 list all objects (people, companies, deals, etc.)
+- \`client.listAttributes(object)\` \u2014 list attributes for an object
+- \`client.queryRecords(object, options?)\` \u2014 query records with filter/sort/pagination
+- \`client.getRecord(object, recordId)\` \u2014 fetch a single record
+- \`client.queryListEntries(listId, options?)\` \u2014 query list entries with filter/sort/pagination
 
 \`\`\`ts
+import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/attio";
 
-const { apiKey } = connection("<connectionId>");
+const attio = connection("<connectionId>");
 
-// Use the Attio REST API
-const res = await fetch("https://api.attio.com/v2/objects/people/records/query", {
-  method: "POST",
-  headers: {
-    Authorization: "Bearer " + apiKey,
-    "Content-Type": "application/json",
-  },
-  body: JSON.stringify({ limit: 25 }),
-});
-const data = await res.json();
+export default async function handler(c: Context) {
+  const { object = "people", limit = 25 } = await c.req.json<{
+    object?: string;
+    limit?: number;
+  }>();
+
+  const { data } = await attio.queryRecords(object, { limit });
+
+  return c.json({ records: data });
+}
 \`\`\`
 
-### Common Endpoints (Base URL: https://api.attio.com/v2)
+### Attio REST API Reference
+
+- Base URL: \`https://api.attio.com/v2\`
+- Authentication: Bearer token (handled automatically)
+- Querying records uses POST with JSON body (not GET with query params)
+
+#### Common Endpoints
+- GET \`/objects\` \u2014 List all objects
+- GET \`/objects/{object}/attributes\` \u2014 List attributes of an object
 - POST \`/objects/{object}/records/query\` \u2014 Query records (people, companies, deals, etc.)
 - GET \`/objects/{object}/records/{record_id}\` \u2014 Get a record
 - POST \`/objects/{object}/records\` \u2014 Create a record
 - PATCH \`/objects/{object}/records/{record_id}\` \u2014 Update a record
 - DELETE \`/objects/{object}/records/{record_id}\` \u2014 Delete a record
-- GET \`/objects\` \u2014 List all objects
-- GET \`/objects/{object}/attributes\` \u2014 List attributes of an object
 - POST \`/lists/{list_id}/entries/query\` \u2014 Query list entries
 - POST \`/notes\` \u2014 Create a note
-- GET \`/notes?parent_object={object}&parent_record_id={id}\` \u2014 Get notes for a record`,
-    ja: `### Attio SDK\uFF08TypeScript\u30CF\u30F3\u30C9\u30E9\u30FC\uFF09
-TypeScript\u30CF\u30F3\u30C9\u30E9\u30FC\u3067Attio\u30B3\u30CD\u30AF\u30BF\u30FC\u3092SDK\u7D4C\u7531\u3067\u4F7F\u7528\u3057\u307E\u3059\uFF1A
+- GET \`/notes?parent_object={object}&parent_record_id={id}\` \u2014 Get notes for a record
+
+#### Query Body (for POST /objects/{object}/records/query)
+- \`filter\` \u2014 Filter conditions
+- \`sorts\` \u2014 Array of sort specifications
+- \`limit\` \u2014 Max records per page (default 25)
+- \`offset\` \u2014 Pagination offset`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`attio_request\`: Attio REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30EC\u30B3\u30FC\u30C9\uFF08people\u3001companies\u3001deals\uFF09\u306E\u30AF\u30A8\u30EA\u3001\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u3084\u5C5E\u6027\u306E\u4E00\u89A7\u8868\u793A\u3001\u30EA\u30B9\u30C8\u30A8\u30F3\u30C8\u30EA\u306E\u7BA1\u7406\u3001\u30CE\u30FC\u30C8\u306E\u64CD\u4F5C\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08Bearer\u30C8\u30FC\u30AF\u30F3\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002\u30EC\u30B3\u30FC\u30C9\u306E\u30AF\u30A8\u30EA\u306B\u306FGET\u3067\u306F\u306A\u304FPOST\u3092\u30D5\u30A3\u30EB\u30BF\u4ED8\u304D\u306E\u30EA\u30AF\u30A8\u30B9\u30C8\u30DC\u30C7\u30A3\u3067\u4F7F\u7528\u3059\u308B\u70B9\u306B\u6CE8\u610F\u3057\u3066\u304F\u3060\u3055\u3044\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.listObjects()\` \u2014 \u5168\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u4E00\u89A7\uFF08people\u3001companies\u3001deals\u306A\u3069\uFF09
+- \`client.listAttributes(object)\` \u2014 \u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u5C5E\u6027\u4E00\u89A7
+- \`client.queryRecords(object, options?)\` \u2014 \u30D5\u30A3\u30EB\u30BF/\u30BD\u30FC\u30C8/\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u4ED8\u304D\u3067\u30EC\u30B3\u30FC\u30C9\u3092\u30AF\u30A8\u30EA
+- \`client.getRecord(object, recordId)\` \u2014 \u5358\u4E00\u30EC\u30B3\u30FC\u30C9\u3092\u53D6\u5F97
+- \`client.queryListEntries(listId, options?)\` \u2014 \u30D5\u30A3\u30EB\u30BF/\u30BD\u30FC\u30C8/\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u4ED8\u304D\u3067\u30EA\u30B9\u30C8\u30A8\u30F3\u30C8\u30EA\u3092\u30AF\u30A8\u30EA
 
 \`\`\`ts
+import type { Context } from "hono";
 import { connection } from "@squadbase/vite-server/connectors/attio";
 
-const { apiKey } = connection("<connectionId>");
+const attio = connection("<connectionId>");
 
-// Attio REST API\u3092\u4F7F\u7528
-const res = await fetch("https://api.attio.com/v2/objects/people/records/query", {
-  method: "POST",
-  headers: {
-    Authorization: "Bearer " + apiKey,
-    "Content-Type": "application/json",
-  },
-  body: JSON.stringify({ limit: 25 }),
-});
-const data = await res.json();
+export default async function handler(c: Context) {
+  const { object = "people", limit = 25 } = await c.req.json<{
+    object?: string;
+    limit?: number;
+  }>();
+
+  const { data } = await attio.queryRecords(object, { limit });
+
+  return c.json({ records: data });
+}
 \`\`\`
 
-### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\uFF08\u30D9\u30FC\u30B9URL: https://api.attio.com/v2\uFF09
+### Attio REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://api.attio.com/v2\`
+- \u8A8D\u8A3C: Bearer\u30C8\u30FC\u30AF\u30F3\uFF08\u81EA\u52D5\u8A2D\u5B9A\uFF09
+- \u30EC\u30B3\u30FC\u30C9\u306E\u30AF\u30A8\u30EA\u306B\u306FGET\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3067\u306F\u306A\u304FPOST\u3067JSON\u30DC\u30C7\u30A3\u3092\u4F7F\u7528\u3057\u307E\u3059
+
+#### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+- GET \`/objects\` \u2014 \u5168\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u4E00\u89A7
+- GET \`/objects/{object}/attributes\` \u2014 \u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u5C5E\u6027\u4E00\u89A7
 - POST \`/objects/{object}/records/query\` \u2014 \u30EC\u30B3\u30FC\u30C9\u306E\u691C\u7D22\uFF08people\u3001companies\u3001deals\u306A\u3069\uFF09
 - GET \`/objects/{object}/records/{record_id}\` \u2014 \u30EC\u30B3\u30FC\u30C9\u306E\u53D6\u5F97
 - POST \`/objects/{object}/records\` \u2014 \u30EC\u30B3\u30FC\u30C9\u306E\u4F5C\u6210
 - PATCH \`/objects/{object}/records/{record_id}\` \u2014 \u30EC\u30B3\u30FC\u30C9\u306E\u66F4\u65B0
 - DELETE \`/objects/{object}/records/{record_id}\` \u2014 \u30EC\u30B3\u30FC\u30C9\u306E\u524A\u9664
-- GET \`/objects\` \u2014 \u5168\u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u4E00\u89A7
-- GET \`/objects/{object}/attributes\` \u2014 \u30AA\u30D6\u30B8\u30A7\u30AF\u30C8\u306E\u5C5E\u6027\u4E00\u89A7
 - POST \`/lists/{list_id}/entries/query\` \u2014 \u30EA\u30B9\u30C8\u30A8\u30F3\u30C8\u30EA\u306E\u691C\u7D22
 - POST \`/notes\` \u2014 \u30CE\u30FC\u30C8\u306E\u4F5C\u6210
-- GET \`/notes?parent_object={object}&parent_record_id={id}\` \u2014 \u30EC\u30B3\u30FC\u30C9\u306E\u30CE\u30FC\u30C8\u3092\u53D6\u5F97`
+- GET \`/notes?parent_object={object}&parent_record_id={id}\` \u2014 \u30EC\u30B3\u30FC\u30C9\u306E\u30CE\u30FC\u30C8\u3092\u53D6\u5F97
+
+#### \u30AF\u30A8\u30EA\u30DC\u30C7\u30A3 (POST /objects/{object}/records/query)
+- \`filter\` \u2014 \u30D5\u30A3\u30EB\u30BF\u6761\u4EF6
+- \`sorts\` \u2014 \u30BD\u30FC\u30C8\u6307\u5B9A\u306E\u914D\u5217
+- \`limit\` \u2014 \u30DA\u30FC\u30B8\u3042\u305F\u308A\u306E\u6700\u5927\u30EC\u30B3\u30FC\u30C9\u6570\uFF08\u30C7\u30D5\u30A9\u30EB\u30C825\uFF09
+- \`offset\` \u2014 \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u30AA\u30D5\u30BB\u30C3\u30C8`
   },
   tools
 });

package/dist/connectors/customerio.d.ts

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