@squadbase/vite-server 0.1.3-dev.0 → 0.1.3-dev.10

package/dist/connectors/asana.js

@@ -0,0 +1,744 @@
+// ../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/asana/parameters.ts
+var parameters = {
+  personalAccessToken: new ParameterDefinition({
+    slug: "personal-access-token",
+    name: "Asana Personal Access Token",
+    description: "Personal Access Token for Asana API authentication. Generate one at https://app.asana.com/0/my-apps",
+    envVarBaseKey: "ASANA_PERSONAL_ACCESS_TOKEN",
+    type: "text",
+    secret: true,
+    required: true
+  })
+};
+
+// ../connectors/src/connectors/asana/sdk/index.ts
+var BASE_URL = "https://app.asana.com/api/1.0";
+function createClient(params) {
+  const token = params[parameters.personalAccessToken.slug];
+  if (!token) {
+    throw new Error(
+      `asana: missing required parameter: ${parameters.personalAccessToken.slug}`
+    );
+  }
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", `Bearer ${token}`);
+    headers.set("Content-Type", "application/json");
+    headers.set("Accept", "application/json");
+    return headers;
+  }
+  async function assertOk(res, label) {
+    if (!res.ok) {
+      const body = await res.text().catch(() => "(unreadable body)");
+      throw new Error(
+        `asana ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  function buildQuery(base, opt_fields) {
+    const params2 = new URLSearchParams();
+    for (const [key, value] of Object.entries(base)) {
+      if (value !== void 0) params2.set(key, String(value));
+    }
+    if (opt_fields && opt_fields.length > 0) {
+      params2.set("opt_fields", opt_fields.join(","));
+    }
+    const qs = params2.toString();
+    return qs ? `?${qs}` : "";
+  }
+  return {
+    request(path2, init) {
+      const url = `${BASE_URL}${path2}`;
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", `Bearer ${token}`);
+      headers.set("Content-Type", "application/json");
+      headers.set("Accept", "application/json");
+      return fetch(url, { ...init, headers });
+    },
+    async listWorkspaces(options) {
+      const qs = buildQuery(
+        { limit: options?.limit, offset: options?.offset },
+        options?.opt_fields
+      );
+      const res = await fetch(`${BASE_URL}/workspaces${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "listWorkspaces");
+      return await res.json();
+    },
+    async listProjects(workspaceGid, options) {
+      const qs = buildQuery(
+        {
+          workspace: workspaceGid,
+          archived: options?.archived,
+          limit: options?.limit,
+          offset: options?.offset
+        },
+        options?.opt_fields
+      );
+      const res = await fetch(`${BASE_URL}/projects${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "listProjects");
+      return await res.json();
+    },
+    async listTasks(projectGid, options) {
+      const qs = buildQuery(
+        {
+          project: projectGid,
+          completed_since: options?.completed_since,
+          limit: options?.limit,
+          offset: options?.offset
+        },
+        options?.opt_fields
+      );
+      const res = await fetch(`${BASE_URL}/tasks${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "listTasks");
+      return await res.json();
+    },
+    async getTask(taskGid, options) {
+      const qs = buildQuery({}, options?.opt_fields);
+      const res = await fetch(
+        `${BASE_URL}/tasks/${encodeURIComponent(taskGid)}${qs}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getTask");
+      return await res.json();
+    },
+    async createTask(taskData) {
+      const res = await fetch(`${BASE_URL}/tasks`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify({ data: taskData })
+      });
+      await assertOk(res, "createTask");
+      return await res.json();
+    },
+    async updateTask(taskGid, taskData) {
+      const res = await fetch(
+        `${BASE_URL}/tasks/${encodeURIComponent(taskGid)}`,
+        {
+          method: "PUT",
+          headers: authHeaders(),
+          body: JSON.stringify({ data: taskData })
+        }
+      );
+      await assertOk(res, "updateTask");
+      return await res.json();
+    },
+    async listUsers(workspaceGid, options) {
+      const qs = buildQuery(
+        {
+          workspace: workspaceGid,
+          limit: options?.limit,
+          offset: options?.offset
+        },
+        options?.opt_fields
+      );
+      const res = await fetch(`${BASE_URL}/users${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "listUsers");
+      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/auth-types.ts
+var AUTH_TYPES = {
+  OAUTH: "oauth",
+  API_KEY: "api-key",
+  JWT: "jwt",
+  SERVICE_ACCOUNT: "service-account",
+  PAT: "pat",
+  USER_PASSWORD: "user-password"
+};
+
+// ../connectors/src/connectors/asana/setup.ts
+var asanaOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call asana_request with GET /workspaces to list all available workspaces
+2. Pick the first workspace and call asana_request with GET /projects?workspace=WORKSPACE_GID&opt_fields=name,archived,created_at to list projects
+3. Pick one project and call asana_request with GET /tasks?project=PROJECT_GID&opt_fields=name,completed,assignee.name,due_on,created_at&limit=10 to sample tasks
+4. Explore sections via GET /sections?project=PROJECT_GID if the project uses board or section-based workflows`,
+    ja: `1. asana_request \u3067 GET /workspaces \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97
+2. \u6700\u521D\u306E\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u3092\u9078\u3073\u3001asana_request \u3067 GET /projects?workspace=WORKSPACE_GID&opt_fields=name,archived,created_at \u3092\u547C\u3073\u51FA\u3057\u3066\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
+3. \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u30921\u3064\u9078\u3073\u3001asana_request \u3067 GET /tasks?project=PROJECT_GID&opt_fields=name,completed,assignee.name,due_on,created_at&limit=10 \u3092\u547C\u3073\u51FA\u3057\u3066\u30BF\u30B9\u30AF\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
+4. \u30DC\u30FC\u30C9\u3084\u30BB\u30AF\u30B7\u30E7\u30F3\u30D9\u30FC\u30B9\u306E\u30EF\u30FC\u30AF\u30D5\u30ED\u30FC\u306E\u5834\u5408\u306F GET /sections?project=PROJECT_GID \u3067\u30BB\u30AF\u30B7\u30E7\u30F3\u3092\u78BA\u8A8D`
+  }
+});
+
+// ../connectors/src/connectors/asana/tools/request.ts
+import { z } from "zod";
+var BASE_URL2 = "https://app.asana.com/api/1.0";
+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 Asana connection to use"),
+  method: z.enum(["GET", "POST", "PUT", "DELETE"]).describe(
+    "HTTP method. GET for reading resources, POST for creating, PUT for updating, DELETE for removing."
+  ),
+  path: z.string().describe(
+    "API path (e.g., '/workspaces', '/projects', '/tasks', '/tasks/{task_gid}'). Query parameters can be appended (e.g., '/tasks?project=PROJECT_GID&opt_fields=name,completed')."
+  ),
+  body: z.record(z.string(), z.unknown()).optional().describe(
+    'Request body (JSON) for POST/PUT requests. Wrap payload in a "data" key (e.g., { "data": { "name": "My Task", "workspace": "WORKSPACE_GID" } }).'
+  )
+});
+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 Asana REST API.
+Authentication is handled automatically using the Personal Access Token (Bearer token).
+Provide the API path relative to the base URL (https://app.asana.com/api/1.0).
+Use opt_fields query parameter to request specific fields and reduce response size.
+
+Common endpoints:
+- GET /workspaces \u2014 List workspaces
+- GET /projects?workspace=WORKSPACE_GID \u2014 List projects in a workspace
+- GET /tasks?project=PROJECT_GID \u2014 List tasks in a project
+- GET /tasks/{task_gid} \u2014 Get a single task
+- POST /tasks \u2014 Create a task (body: { "data": { "name": "...", "workspace": "..." } })
+- PUT /tasks/{task_gid} \u2014 Update a task
+- GET /users?workspace=WORKSPACE_GID \u2014 List users in a workspace
+- GET /sections?project=PROJECT_GID \u2014 List sections in a project
+- GET /tags?workspace=WORKSPACE_GID \u2014 List tags
+- POST /tasks/{task_gid}/subtasks \u2014 Create a subtask
+- GET /tasks/{task_gid}/stories \u2014 Get task comments/stories
+
+Pagination: Use limit (1-100) and offset query parameters. The response includes next_page.offset for the next page.`,
+  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] asana/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const token = parameters.personalAccessToken.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 ${token}`,
+            "Content-Type": "application/json",
+            Accept: "application/json"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        const data = await response.json();
+        if (!response.ok) {
+          const errors = data?.errors;
+          const errorMessage = Array.isArray(errors) && errors.length > 0 ? errors[0]?.message ?? `HTTP ${response.status} ${response.statusText}` : `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: String(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/asana/index.ts
+var tools = { request: requestTool };
+var asanaConnector = new ConnectorPlugin({
+  slug: "asana",
+  authType: AUTH_TYPES.API_KEY,
+  name: "Asana",
+  description: "Connect to Asana for project management, task tracking, and team collaboration data.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/3eIdaoqzIIZs2Md0OoDJMf/2fa66e0841adb985da4d3120466f3ec4/asana-icon.png",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: asanaOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`asana_request\`: The only way to call the Asana REST API. Use it to list workspaces, projects, tasks, users, sections, tags, and more. Authentication (Bearer token with Personal Access Token) is configured automatically. Provide the API path and optionally append query parameters like opt_fields for field selection.
+
+### 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 (provide path relative to base URL)
+- \`client.listWorkspaces(options?)\` \u2014 list all workspaces
+- \`client.listProjects(workspaceGid, options?)\` \u2014 list projects in a workspace
+- \`client.listTasks(projectGid, options?)\` \u2014 list tasks in a project
+- \`client.getTask(taskGid, options?)\` \u2014 get a single task
+- \`client.createTask(taskData)\` \u2014 create a new task
+- \`client.updateTask(taskGid, taskData)\` \u2014 update an existing task
+- \`client.listUsers(workspaceGid, options?)\` \u2014 list users in a workspace
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/asana";
+
+const asana = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { projectGid } = await c.req.json<{ projectGid: string }>();
+
+  const { data: tasks } = await asana.listTasks(projectGid, {
+    opt_fields: ["name", "completed", "assignee.name", "due_on"],
+    limit: 50,
+  });
+
+  return c.json({ tasks });
+}
+\`\`\`
+
+### Asana REST API Reference
+
+- Base URL: \`https://app.asana.com/api/1.0\`
+- Authentication: Bearer token (Personal Access Token, handled automatically)
+- All write requests wrap the payload in a \`data\` key: \`{ "data": { ... } }\`
+- Use \`opt_fields\` query parameter to select specific fields and reduce response size
+- Pagination: offset-based with \`limit\` (1-100) and \`offset\` query parameters; response includes \`next_page.offset\`
+
+#### Resource Endpoints
+
+**Workspaces**
+- GET \`/workspaces\` \u2014 List all workspaces
+
+**Projects**
+- GET \`/projects?workspace=WORKSPACE_GID\` \u2014 List projects in a workspace
+- GET \`/projects/{project_gid}\` \u2014 Get a project
+- POST \`/projects\` \u2014 Create a project
+- PUT \`/projects/{project_gid}\` \u2014 Update a project
+
+**Tasks**
+- GET \`/tasks?project=PROJECT_GID\` \u2014 List tasks in a project (requires project, or assignee+workspace)
+- GET \`/tasks/{task_gid}\` \u2014 Get a task
+- POST \`/tasks\` \u2014 Create a task (requires workspace or projects in body)
+- PUT \`/tasks/{task_gid}\` \u2014 Update a task
+- DELETE \`/tasks/{task_gid}\` \u2014 Delete a task
+- POST \`/tasks/{task_gid}/subtasks\` \u2014 Create a subtask
+- GET \`/tasks/{task_gid}/subtasks\` \u2014 List subtasks
+
+**Sections**
+- GET \`/sections?project=PROJECT_GID\` \u2014 List sections in a project
+- POST \`/sections/{section_gid}/addTask\` \u2014 Add a task to a section
+
+**Users**
+- GET \`/users?workspace=WORKSPACE_GID\` \u2014 List users in a workspace
+- GET \`/users/me\` \u2014 Get the authenticated user
+- GET \`/users/{user_gid}\` \u2014 Get a user
+
+**Tags**
+- GET \`/tags?workspace=WORKSPACE_GID\` \u2014 List tags in a workspace
+
+**Stories (comments)**
+- GET \`/tasks/{task_gid}/stories\` \u2014 List comments/stories on a task
+- POST \`/tasks/{task_gid}/stories\` \u2014 Add a comment to a task
+
+**Search**
+- GET \`/workspaces/{workspace_gid}/tasks/search?text=QUERY\` \u2014 Search tasks in a workspace
+
+#### Common opt_fields
+- Tasks: name, completed, assignee, assignee.name, due_on, due_at, created_at, modified_at, notes, projects, projects.name, tags, tags.name, parent, parent.name, memberships, memberships.section, memberships.section.name, custom_fields
+- Projects: name, archived, created_at, modified_at, owner, owner.name, team, team.name, members
+- Users: name, email, photo`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`asana_request\`: Asana REST API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3001\u30BF\u30B9\u30AF\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u30BB\u30AF\u30B7\u30E7\u30F3\u3001\u30BF\u30B0\u306A\u3069\u306E\u4E00\u89A7\u53D6\u5F97\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08Personal Access Token\u3092\u4F7F\u7528\u3057\u305FBearer\u30C8\u30FC\u30AF\u30F3\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002API\u30D1\u30B9\u3092\u6307\u5B9A\u3057\u3001\u5FC5\u8981\u306B\u5FDC\u3058\u3066opt_fields\u306A\u3069\u306E\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3092\u4ED8\u52A0\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\uFF08\u30D9\u30FC\u30B9URL\u304B\u3089\u306E\u76F8\u5BFE\u30D1\u30B9\u3092\u6307\u5B9A\uFF09
+- \`client.listWorkspaces(options?)\` \u2014 \u5168\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306E\u4E00\u89A7
+- \`client.listProjects(workspaceGid, options?)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7
+- \`client.listTasks(projectGid, options?)\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u5185\u306E\u30BF\u30B9\u30AF\u4E00\u89A7
+- \`client.getTask(taskGid, options?)\` \u2014 \u5358\u4E00\u30BF\u30B9\u30AF\u306E\u53D6\u5F97
+- \`client.createTask(taskData)\` \u2014 \u65B0\u898F\u30BF\u30B9\u30AF\u306E\u4F5C\u6210
+- \`client.updateTask(taskGid, taskData)\` \u2014 \u65E2\u5B58\u30BF\u30B9\u30AF\u306E\u66F4\u65B0
+- \`client.listUsers(workspaceGid, options?)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30E6\u30FC\u30B6\u30FC\u4E00\u89A7
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/asana";
+
+const asana = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { projectGid } = await c.req.json<{ projectGid: string }>();
+
+  const { data: tasks } = await asana.listTasks(projectGid, {
+    opt_fields: ["name", "completed", "assignee.name", "due_on"],
+    limit: 50,
+  });
+
+  return c.json({ tasks });
+}
+\`\`\`
+
+### Asana REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://app.asana.com/api/1.0\`
+- \u8A8D\u8A3C: Bearer\u30C8\u30FC\u30AF\u30F3\uFF08Personal Access Token\u3001\u81EA\u52D5\u8A2D\u5B9A\uFF09
+- \u66F8\u304D\u8FBC\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u306F\u30DA\u30A4\u30ED\u30FC\u30C9\u3092 \`data\` \u30AD\u30FC\u3067\u56F2\u3080: \`{ "data": { ... } }\`
+- \`opt_fields\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u3067\u7279\u5B9A\u306E\u30D5\u30A3\u30FC\u30EB\u30C9\u3092\u6307\u5B9A\u3057\u3066\u30EC\u30B9\u30DD\u30F3\u30B9\u30B5\u30A4\u30BA\u3092\u524A\u6E1B\u53EF\u80FD
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3: \`limit\`\uFF081-100\uFF09\u3068 \`offset\` \u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF\u306B\u3088\u308B\u30AA\u30D5\u30BB\u30C3\u30C8\u30D9\u30FC\u30B9\u3001\u30EC\u30B9\u30DD\u30F3\u30B9\u306B \`next_page.offset\` \u304C\u542B\u307E\u308C\u308B
+
+#### \u30EA\u30BD\u30FC\u30B9\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+
+**\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9**
+- GET \`/workspaces\` \u2014 \u5168\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306E\u4E00\u89A7
+
+**\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8**
+- GET \`/projects?workspace=WORKSPACE_GID\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7
+- GET \`/projects/{project_gid}\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u53D6\u5F97
+- POST \`/projects\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u4F5C\u6210
+- PUT \`/projects/{project_gid}\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u66F4\u65B0
+
+**\u30BF\u30B9\u30AF**
+- GET \`/tasks?project=PROJECT_GID\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u5185\u306E\u30BF\u30B9\u30AF\u4E00\u89A7\uFF08project\u3001\u307E\u305F\u306Fassignee+workspace\u304C\u5FC5\u8981\uFF09
+- GET \`/tasks/{task_gid}\` \u2014 \u30BF\u30B9\u30AF\u306E\u53D6\u5F97
+- POST \`/tasks\` \u2014 \u30BF\u30B9\u30AF\u306E\u4F5C\u6210\uFF08body\u306Bworkspace\u307E\u305F\u306Fprojects\u304C\u5FC5\u8981\uFF09
+- PUT \`/tasks/{task_gid}\` \u2014 \u30BF\u30B9\u30AF\u306E\u66F4\u65B0
+- DELETE \`/tasks/{task_gid}\` \u2014 \u30BF\u30B9\u30AF\u306E\u524A\u9664
+- POST \`/tasks/{task_gid}/subtasks\` \u2014 \u30B5\u30D6\u30BF\u30B9\u30AF\u306E\u4F5C\u6210
+- GET \`/tasks/{task_gid}/subtasks\` \u2014 \u30B5\u30D6\u30BF\u30B9\u30AF\u306E\u4E00\u89A7
+
+**\u30BB\u30AF\u30B7\u30E7\u30F3**
+- GET \`/sections?project=PROJECT_GID\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u5185\u306E\u30BB\u30AF\u30B7\u30E7\u30F3\u4E00\u89A7
+- POST \`/sections/{section_gid}/addTask\` \u2014 \u30BB\u30AF\u30B7\u30E7\u30F3\u306B\u30BF\u30B9\u30AF\u3092\u8FFD\u52A0
+
+**\u30E6\u30FC\u30B6\u30FC**
+- GET \`/users?workspace=WORKSPACE_GID\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30E6\u30FC\u30B6\u30FC\u4E00\u89A7
+- GET \`/users/me\` \u2014 \u8A8D\u8A3C\u30E6\u30FC\u30B6\u30FC\u306E\u53D6\u5F97
+- GET \`/users/{user_gid}\` \u2014 \u30E6\u30FC\u30B6\u30FC\u306E\u53D6\u5F97
+
+**\u30BF\u30B0**
+- GET \`/tags?workspace=WORKSPACE_GID\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30BF\u30B0\u4E00\u89A7
+
+**\u30B9\u30C8\u30FC\u30EA\u30FC\uFF08\u30B3\u30E1\u30F3\u30C8\uFF09**
+- GET \`/tasks/{task_gid}/stories\` \u2014 \u30BF\u30B9\u30AF\u306E\u30B3\u30E1\u30F3\u30C8/\u30B9\u30C8\u30FC\u30EA\u30FC\u4E00\u89A7
+- POST \`/tasks/{task_gid}/stories\` \u2014 \u30BF\u30B9\u30AF\u306B\u30B3\u30E1\u30F3\u30C8\u3092\u8FFD\u52A0
+
+**\u691C\u7D22**
+- GET \`/workspaces/{workspace_gid}/tasks/search?text=QUERY\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30BF\u30B9\u30AF\u691C\u7D22
+
+#### \u3088\u304F\u4F7F\u3046opt_fields
+- \u30BF\u30B9\u30AF: name, completed, assignee, assignee.name, due_on, due_at, created_at, modified_at, notes, projects, projects.name, tags, tags.name, parent, parent.name, memberships, memberships.section, memberships.section.name, custom_fields
+- \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8: name, archived, created_at, modified_at, owner, owner.name, team, team.name, members
+- \u30E6\u30FC\u30B6\u30FC: name, email, photo`
+  },
+  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/connector-client/proxy-fetch.ts
+import { getContext } from "hono/context-storage";
+import { getCookie } from "hono/cookie";
+var APP_SESSION_COOKIE_NAME = "__Host-squadbase-session";
+function createSandboxProxyFetch(connectionId) {
+  return async (input, init) => {
+    const token = process.env.INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL;
+    const sandboxId = process.env.INTERNAL_SQUADBASE_SANDBOX_ID;
+    if (!token || !sandboxId) {
+      throw new Error(
+        "Connection proxy is not configured. Please check your deployment settings."
+      );
+    }
+    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const originalMethod = init?.method ?? "GET";
+    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
+    const baseDomain = process.env["SQUADBASE_PREVIEW_BASE_DOMAIN"] ?? "preview.app.squadbase.dev";
+    const proxyUrl = `https://${sandboxId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
+    return fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({
+        url: originalUrl,
+        method: originalMethod,
+        body: originalBody
+      })
+    });
+  };
+}
+function createDeployedAppProxyFetch(connectionId) {
+  const projectId = process.env["SQUADBASE_PROJECT_ID"];
+  if (!projectId) {
+    throw new Error(
+      "Connection proxy is not configured. Please check your deployment settings."
+    );
+  }
+  const baseDomain = process.env["SQUADBASE_APP_BASE_DOMAIN"] ?? "squadbase.app";
+  const proxyUrl = `https://${projectId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
+  return async (input, init) => {
+    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const originalMethod = init?.method ?? "GET";
+    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
+    const c = getContext();
+    const appSession = getCookie(c, APP_SESSION_COOKIE_NAME);
+    if (!appSession) {
+      throw new Error(
+        "No authentication method available for connection proxy."
+      );
+    }
+    return fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${appSession}`
+      },
+      body: JSON.stringify({
+        url: originalUrl,
+        method: originalMethod,
+        body: originalBody
+      })
+    });
+  };
+}
+function createProxyFetch(connectionId) {
+  if (process.env.INTERNAL_SQUADBASE_SANDBOX_ID) {
+    return createSandboxProxyFetch(connectionId);
+  }
+  return createDeployedAppProxyFetch(connectionId);
+}
+
+// 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, createProxyFetch(connectionId));
+  };
+}
+
+// src/connectors/entries/asana.ts
+var connection = createConnectorSdk(asanaConnector, createClient);
+export {
+  connection
+};