@squadbase/vite-server 0.1.9-dev.87dd3f7 → 0.1.9-dev.a120137

package/dist/connectors/monday.js

@@ -0,0 +1,853 @@
+// ../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/monday/parameters.ts
+var parameters = {
+  apiToken: new ParameterDefinition({
+    slug: "api-token",
+    name: "monday.com API Token",
+    description: "Personal API token generated from monday.com Profile > Developers > My access tokens. Account-scoped tokens (Admin > API) are also supported.",
+    envVarBaseKey: "MONDAY_API_TOKEN",
+    type: "text",
+    secret: true,
+    required: true
+  })
+};
+
+// ../connectors/src/connectors/monday/sdk/index.ts
+var BASE_URL = "https://api.monday.com/v2";
+function createClient(params) {
+  const apiToken = params[parameters.apiToken.slug];
+  if (!apiToken) {
+    throw new Error(
+      `monday: missing required parameter: ${parameters.apiToken.slug}`
+    );
+  }
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", apiToken);
+    headers.set("Content-Type", "application/json");
+    return headers;
+  }
+  async function gql(query, variables) {
+    const body = { query };
+    if (variables) body.variables = variables;
+    const res = await fetch(BASE_URL, {
+      method: "POST",
+      headers: authHeaders(),
+      body: JSON.stringify(body)
+    });
+    const json = await res.json();
+    if (json.errors && json.errors.length > 0) {
+      throw new Error(
+        `monday graphql: ${json.errors.map((e) => e.message).join("; ")}`
+      );
+    }
+    if (json.error_message) {
+      throw new Error(`monday graphql: ${json.error_message}`);
+    }
+    if (!json.data) {
+      throw new Error("monday graphql: no data in response");
+    }
+    return json.data;
+  }
+  return {
+    graphql: gql,
+    request(init) {
+      const headers = new Headers(init?.headers);
+      headers.set("Authorization", apiToken);
+      headers.set("Content-Type", "application/json");
+      return fetch(BASE_URL, { ...init, headers });
+    },
+    async me() {
+      const result = await gql(
+        `{ me { id name email enabled is_admin is_guest is_view_only created_at account { id name } } }`
+      );
+      return result.me;
+    },
+    async listBoards(options) {
+      const result = await gql(
+        `query($limit: Int, $page: Int, $ids: [ID!], $workspace_ids: [ID!], $state: State) {
+          boards(limit: $limit, page: $page, ids: $ids, workspace_ids: $workspace_ids, state: $state) {
+            id name description state board_kind item_terminology updated_at
+            workspace { id name kind }
+            owners { id name }
+          }
+        }`,
+        {
+          limit: options?.limit ?? 25,
+          page: options?.page ?? 1,
+          ids: options?.ids?.map(String),
+          workspace_ids: options?.workspaceIds?.map(String),
+          state: options?.state ?? "active"
+        }
+      );
+      return result.boards;
+    },
+    async getBoard(boardId) {
+      const result = await gql(
+        `query($ids: [ID!]) {
+          boards(ids: $ids) {
+            id name description state board_kind item_terminology updated_at
+            workspace { id name kind }
+            owners { id name }
+            groups { id title color position }
+            columns { id title type description settings_str archived }
+            tags { id name color }
+          }
+        }`,
+        { ids: [String(boardId)] }
+      );
+      const board = result.boards?.[0];
+      if (!board) {
+        throw new Error(`monday: board ${boardId} not found`);
+      }
+      return board;
+    },
+    async listItems(boardId, options) {
+      const result = await gql(
+        `query($ids: [ID!], $limit: Int, $cursor: String) {
+          boards(ids: $ids) {
+            items_page(limit: $limit, cursor: $cursor) {
+              cursor
+              items {
+                id name state created_at updated_at
+                group { id title }
+                creator { id name }
+                column_values { id type text value column { title } }
+              }
+            }
+          }
+        }`,
+        {
+          ids: [String(boardId)],
+          limit: options?.limit ?? 25,
+          cursor: options?.cursor ?? null
+        }
+      );
+      const page = result.boards?.[0]?.items_page;
+      if (!page) {
+        throw new Error(`monday: board ${boardId} not found`);
+      }
+      return page;
+    },
+    async getItem(itemId) {
+      const result = await gql(
+        `query($ids: [ID!]) {
+          items(ids: $ids) {
+            id name state created_at updated_at
+            board { id name }
+            group { id title }
+            creator { id name }
+            column_values { id type text value column { title } }
+          }
+        }`,
+        { ids: [String(itemId)] }
+      );
+      const item = result.items?.[0];
+      if (!item) {
+        throw new Error(`monday: item ${itemId} not found`);
+      }
+      return item;
+    },
+    async createItem(input) {
+      const result = await gql(
+        `mutation($boardId: ID!, $itemName: String!, $groupId: String, $columnValues: JSON, $createLabelsIfMissing: Boolean) {
+          create_item(
+            board_id: $boardId,
+            item_name: $itemName,
+            group_id: $groupId,
+            column_values: $columnValues,
+            create_labels_if_missing: $createLabelsIfMissing
+          ) { id name state created_at }
+        }`,
+        {
+          boardId: String(input.boardId),
+          itemName: input.itemName,
+          groupId: input.groupId,
+          columnValues: input.columnValues ? JSON.stringify(input.columnValues) : void 0,
+          createLabelsIfMissing: input.createLabelsIfMissing ?? false
+        }
+      );
+      return result.create_item;
+    },
+    async listUsers(options) {
+      const result = await gql(
+        `query($limit: Int, $page: Int, $kind: UserKind) {
+          users(limit: $limit, page: $page, kind: $kind) {
+            id name email enabled is_admin is_guest is_view_only created_at
+          }
+        }`,
+        {
+          limit: options?.limit ?? 25,
+          page: options?.page ?? 1,
+          kind: options?.kind ?? "all"
+        }
+      );
+      return result.users;
+    },
+    async listWorkspaces(options) {
+      const result = await gql(
+        `query($limit: Int, $page: Int) {
+          workspaces(limit: $limit, page: $page) {
+            id name kind description state created_at
+          }
+        }`,
+        {
+          limit: options?.limit ?? 25,
+          page: options?.page ?? 1
+        }
+      );
+      return result.workspaces;
+    }
+  };
+}
+
+// ../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;
+  categories;
+  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.categories = config.categories ?? [];
+    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, opts) {
+    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)) {
+      const tool = t.createTool(myConnections, config);
+      const originalToModelOutput = tool.toModelOutput;
+      result[`${this.connectorKey}_${t.name}`] = {
+        ...tool,
+        toModelOutput: async (options) => {
+          if (!originalToModelOutput) {
+            return opts.truncateOutput(options.output);
+          }
+          const modelOutput = await originalToModelOutput(options);
+          if (modelOutput.type === "text" || modelOutput.type === "json") {
+            return opts.truncateOutput(modelOutput.value);
+          }
+          return modelOutput;
+        }
+      };
+    }
+    return result;
+  }
+  static deriveKey(slug, authType) {
+    if (authType) return `${slug}-${authType}`;
+    const LEGACY_NULL_AUTH_TYPE_MAP = {
+      // user-password
+      "postgresql": "user-password",
+      "mysql": "user-password",
+      "clickhouse": "user-password",
+      "kintone": "user-password",
+      "squadbase-db": "user-password",
+      // service-account
+      "snowflake": "service-account",
+      "bigquery": "service-account",
+      "google-analytics": "service-account",
+      "google-calendar": "service-account",
+      "aws-athena": "service-account",
+      "redshift": "service-account",
+      // api-key
+      "databricks": "api-key",
+      "dbt": "api-key",
+      "airtable": "api-key",
+      "openai": "api-key",
+      "gemini": "api-key",
+      "anthropic": "api-key",
+      "wix-store": "api-key"
+    };
+    const fallbackAuthType = LEGACY_NULL_AUTH_TYPE_MAP[slug];
+    if (fallbackAuthType) return `${slug}-${fallbackAuthType}`;
+    return 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/monday/setup.ts
+var mondayOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call monday_request with query \`{ me { id name email account { id name } } }\` to verify the token and identify the account
+2. Call monday_request with query \`{ boards(limit: 10) { id name state board_kind workspace { id name } } }\` to list boards
+3. For a target board, call monday_request with query \`{ boards(ids: [BOARD_ID]) { id name columns { id title type settings_str } } }\` to inspect column definitions
+4. Sample items with \`{ boards(ids: [BOARD_ID]) { items_page(limit: 5) { cursor items { id name created_at updated_at column_values { id text value } } } } }\`
+5. Explore other resources (workspaces, users, tags) as needed`,
+    ja: `1. monday_request \u3067\u30AF\u30A8\u30EA \`{ me { id name email account { id name } } }\` \u3092\u547C\u3073\u51FA\u3057\u3001\u30C8\u30FC\u30AF\u30F3\u306E\u691C\u8A3C\u3068\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u78BA\u8A8D
+2. monday_request \u3067\u30AF\u30A8\u30EA \`{ boards(limit: 10) { id name state board_kind workspace { id name } } }\` \u3092\u547C\u3073\u51FA\u3057\u3001\u30DC\u30FC\u30C9\u4E00\u89A7\u3092\u53D6\u5F97
+3. \u5BFE\u8C61\u30DC\u30FC\u30C9\u306B\u5BFE\u3057\u3066 \`{ boards(ids: [BOARD_ID]) { id name columns { id title type settings_str } } }\` \u3092\u547C\u3073\u51FA\u3057\u3001\u30AB\u30E9\u30E0\u5B9A\u7FA9\u3092\u78BA\u8A8D
+4. \`{ boards(ids: [BOARD_ID]) { items_page(limit: 5) { cursor items { id name created_at updated_at column_values { id text value } } } } }\` \u3067\u30A2\u30A4\u30C6\u30E0\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
+5. \u5FC5\u8981\u306B\u5FDC\u3058\u3066\u4ED6\u306E\u30EA\u30BD\u30FC\u30B9\uFF08workspaces\u3001users\u3001tags\uFF09\u3092\u63A2\u7D22`
+  }
+});
+
+// ../connectors/src/connectors/monday/tools/request.ts
+import { z } from "zod";
+var BASE_URL2 = "https://api.monday.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 monday.com connection to use"),
+  query: z.string().describe(
+    `GraphQL query or mutation string. Example query: '{ boards(limit: 10) { id name state } }'. Example mutation: 'mutation { create_item(board_id: 123, item_name: "New task") { id name } }'. Pass IDs as strings (the API uses the ID scalar) and JSON column values as escaped JSON strings.`
+  ),
+  variables: z.record(z.string(), z.unknown()).optional().describe(
+    `Optional GraphQL variables object. Use with parameterized queries, e.g. { "boardId": "1234567890", "limit": 25 }. Variable types must match the operation's declared types.`
+  ),
+  apiVersion: z.string().optional().describe(
+    "Optional monday.com API version header (e.g. '2024-10'). When omitted, the current stable version is used."
+  )
+});
+var outputSchema = z.discriminatedUnion("success", [
+  z.object({
+    success: z.literal(true),
+    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 GraphQL queries and mutations to the monday.com API (https://api.monday.com/v2).
+Use this tool for all monday.com interactions: querying boards, items, groups, columns, users, workspaces, tags, updates, and performing mutations like create_item, change_column_value, create_board, etc.
+monday.com's API is GraphQL-only \u2014 there is no REST API. All requests are POST with a JSON body containing "query" and optional "variables".
+Items are paginated with a cursor-based \`items_page(limit, cursor)\` field on a board; pass the returned cursor on the next call. Boards/users/workspaces use page-based pagination via \`limit\`/\`page\`. Rate limits are complexity-based per minute, so prefer narrow field selections over wildcards.`,
+  inputSchema,
+  outputSchema,
+  async execute({ connectionId, query, variables, apiVersion }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-request] monday/${connection2.name}: GraphQL request`
+    );
+    try {
+      const apiToken = parameters.apiToken.getValue(connection2);
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const body = { query };
+        if (variables) body.variables = variables;
+        const headers = {
+          Authorization: apiToken,
+          "Content-Type": "application/json"
+        };
+        if (apiVersion) headers["API-Version"] = apiVersion;
+        const response = await fetch(BASE_URL2, {
+          method: "POST",
+          headers,
+          body: JSON.stringify(body),
+          signal: controller.signal
+        });
+        const result = await response.json();
+        if (!response.ok) {
+          const errorMessage = typeof result?.error_message === "string" ? result.error_message : typeof result?.message === "string" ? result.message : typeof result?.error === "string" ? result.error : `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
+        }
+        if (result.errors && Array.isArray(result.errors) && result.errors.length > 0) {
+          const messages = result.errors.map((e) => e.message).join("; ");
+          if (!result.data) {
+            return { success: false, error: messages };
+          }
+          return {
+            success: true,
+            data: { ...result, _warnings: messages }
+          };
+        }
+        if (typeof result.error_message === "string") {
+          return { success: false, error: result.error_message };
+        }
+        return {
+          success: true,
+          data: result.data ?? result
+        };
+      } finally {
+        clearTimeout(timeout);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/monday/index.ts
+var tools = { request: requestTool };
+var mondayConnector = new ConnectorPlugin({
+  slug: "monday",
+  authType: AUTH_TYPES.API_KEY,
+  name: "monday.com",
+  description: "Connect to monday.com Work OS for boards, items, columns, groups, users, and workspaces via the GraphQL API.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/5ZyTQYHVtA8PPnSusr8HPU/faab9875d83a5d63888875425a540688/monday-icon.svg",
+  parameters,
+  releaseFlag: { dev1: true, dev2: true, prod: true },
+  categories: ["productivity"],
+  onboarding: mondayOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`monday_request\`: The only way to call the monday.com GraphQL API. Use it to query and mutate all monday.com resources: boards, items, groups, columns, column values, users, workspaces, tags, teams, and updates. Authentication is configured automatically. monday.com's API is GraphQL-only \u2014 send a query string and optional variables. Items on a board are paginated with cursor-based \`items_page(limit, cursor)\`; boards/users/workspaces use page-based \`limit\`/\`page\`. IDs are passed as the GraphQL \`ID\` scalar (string).
+
+### 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.graphql(query, variables?)\` \u2014 send any GraphQL query/mutation. **Returns the GraphQL \`data\` payload directly with the outer \`{ data, errors }\` envelope already stripped.** For \`{ boards { ... } }\` you get \`{ boards: [...] }\`, NOT \`{ data: { boards: [...] } }\`. Access fields as \`result.boards\`, never \`result.data.boards\`. Errors are thrown automatically.
+- \`client.request(init?)\` \u2014 low-level authenticated fetch to the GraphQL endpoint (returns the raw \`Response\`; you parse the full \`{ data, errors }\` envelope yourself)
+- \`client.me()\` \u2014 get the authenticated user and account
+- \`client.listBoards(options?)\` \u2014 list boards with optional ids, workspaceIds, state, page, limit
+- \`client.getBoard(boardId)\` \u2014 fetch a single board with columns, groups, owners, tags
+- \`client.listItems(boardId, options?)\` \u2014 cursor-paginated items on a board (returns \`{ cursor, items }\`)
+- \`client.getItem(itemId)\` \u2014 fetch a single item with column values
+- \`client.createItem(input)\` \u2014 create an item (\`boardId\`, \`itemName\`, optional \`groupId\`, \`columnValues\`)
+- \`client.listUsers(options?)\` \u2014 list users with kind/page/limit
+- \`client.listWorkspaces(options?)\` \u2014 list workspaces with page/limit
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/monday";
+
+const monday = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { boardId, limit = 25, cursor } = await c.req.json<{
+    boardId: string;
+    limit?: number;
+    cursor?: string;
+  }>();
+
+  const { items, cursor: nextCursor } = await monday.listItems(boardId, { limit, cursor });
+
+  return c.json({ items, cursor: nextCursor });
+}
+\`\`\`
+
+#### \`client.graphql()\` return shape (common pitfall)
+
+\`client.graphql()\` already unwraps the GraphQL response envelope. **Do not access \`.data\` on the return value** \u2014 it is always \`undefined\` and will silently produce empty results.
+
+\`\`\`ts
+// \u2705 Correct \u2014 fields are at the top level
+const res = await monday.graphql<{ boards: { items_page: { items: unknown[] } }[] }>(
+  \`query($ids: [ID!], $limit: Int) {
+    boards(ids: $ids) {
+      items_page(limit: $limit) { cursor items { id name } }
+    }
+  }\`,
+  { ids: [boardId], limit: 100 },
+);
+const items = res.boards?.[0]?.items_page?.items ?? [];
+
+// \u274C Wrong \u2014 \`res.data\` is undefined; \`.data\` was already stripped by the SDK
+const items = res.data?.boards?.[0]?.items_page?.items; // always undefined!
+\`\`\`
+
+### monday.com GraphQL API Reference
+
+- Endpoint: \`https://api.monday.com/v2\`
+- Authentication: API token passed as \`Authorization: <API_TOKEN>\` header (no \`Bearer\` prefix; handled automatically)
+- All requests are POST with JSON body: \`{ "query": "...", "variables": {...} }\`
+- Optional \`API-Version\` header (e.g. \`2024-10\`) pins a specific API version; otherwise the current stable version is used
+- Rate limit: complexity-based per minute (each query consumes a complexity score). Prefer narrow field selections.
+- IDs are the \`ID\` scalar (serialized as string). Always quote them in variables.
+- Pagination:
+  - Items on a board: \`items_page(limit, cursor)\` returns \`{ cursor, items }\`. Pass the returned \`cursor\` next time. \`cursor\` is null when there are no more pages.
+  - Boards / users / workspaces: page-based with \`limit\` and \`page\` arguments.
+
+#### Common Queries
+- \`{ me { id name email account { id name } } }\` \u2014 authenticated user and account
+- \`{ boards(limit: 10) { id name state board_kind workspace { id name } } }\` \u2014 list boards
+- \`{ boards(ids: [BOARD_ID]) { columns { id title type settings_str } groups { id title } } }\` \u2014 get board schema
+- \`{ boards(ids: [BOARD_ID]) { items_page(limit: 25) { cursor items { id name column_values { id text value } } } } }\` \u2014 list items
+- \`{ items(ids: [ITEM_ID]) { id name column_values { id text value column { title } } } }\` \u2014 get a single item
+- \`{ users(limit: 25) { id name email enabled is_admin is_guest } }\` \u2014 list users
+- \`{ workspaces(limit: 25) { id name kind state } }\` \u2014 list workspaces
+
+#### Common Mutations
+- \`mutation { create_item(board_id: BOARD_ID, item_name: "New task", column_values: "{\\"status\\":{\\"label\\":\\"Done\\"}}") { id name } }\` \u2014 create an item (column_values must be a JSON string)
+- \`mutation { change_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: "status", value: "{\\"label\\":\\"Done\\"}") { id } }\` \u2014 update a column value
+- \`mutation { create_update(item_id: ITEM_ID, body: "Hello") { id } }\` \u2014 post an update on an item
+- \`mutation { delete_item(item_id: ITEM_ID) { id } }\` \u2014 delete an item
+
+#### Notes
+- \`column_values\` arguments accept a JSON-encoded string; remember to escape inner quotes when embedding in a query string, or pass it via GraphQL variables to avoid escaping.
+- The \`ID\` scalar accepts both numeric and string forms; using strings in variables is the safest.
+- Some fields (e.g. \`board.tags\`) are only populated for boards that explicitly use them.`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`monday_request\`: monday.com GraphQL API\u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30DC\u30FC\u30C9\u3001\u30A2\u30A4\u30C6\u30E0\u3001\u30B0\u30EB\u30FC\u30D7\u3001\u30AB\u30E9\u30E0\u3001\u30AB\u30E9\u30E0\u5024\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u3001\u30BF\u30B0\u3001\u30C1\u30FC\u30E0\u3001\u30A2\u30C3\u30D7\u30C7\u30FC\u30C8\u306A\u3069\u3059\u3079\u3066\u306E\u30EA\u30BD\u30FC\u30B9\u306E\u30AF\u30A8\u30EA\u3068\u30DF\u30E5\u30FC\u30C6\u30FC\u30B7\u30E7\u30F3\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002monday.com \u306E API \u306F GraphQL \u306E\u307F\u3067\u3001\u30AF\u30A8\u30EA\u6587\u5B57\u5217\u3068\u30AA\u30D7\u30B7\u30E7\u30F3\u306E\u5909\u6570\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30DC\u30FC\u30C9\u4E0A\u306E\u30A2\u30A4\u30C6\u30E0\u306F\u30AB\u30FC\u30BD\u30EB\u30D9\u30FC\u30B9\u306E \`items_page(limit, cursor)\` \u3067\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3055\u308C\u3001\u30DC\u30FC\u30C9\uFF0F\u30E6\u30FC\u30B6\u30FC\uFF0F\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306F\u30DA\u30FC\u30B8\u30D9\u30FC\u30B9\u306E \`limit\`/\`page\` \u3092\u4F7F\u7528\u3057\u307E\u3059\u3002ID \u306F GraphQL \u306E \`ID\` \u30B9\u30AB\u30E9\u30FC\uFF08\u6587\u5B57\u5217\uFF09\u3068\u3057\u3066\u6E21\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.graphql(query, variables?)\` \u2014 \u4EFB\u610F\u306EGraphQL\u30AF\u30A8\u30EA/\u30DF\u30E5\u30FC\u30C6\u30FC\u30B7\u30E7\u30F3\u3092\u9001\u4FE1\u3002**\u623B\u308A\u5024\u306F GraphQL \u30EC\u30B9\u30DD\u30F3\u30B9\u306E \`data\` \u30D5\u30A3\u30FC\u30EB\u30C9\u3092\u65E2\u306B\u30A2\u30F3\u30E9\u30C3\u30D7\u3057\u305F\u3082\u306E**\u3002\`{ boards { ... } }\` \u3092\u6295\u3052\u305F\u5834\u5408\u306E\u623B\u308A\u5024\u306F \`{ boards: [...] }\` \u3067\u3042\u308A\u3001\`{ data: { boards: [...] } }\` \u3067\u306F\u306A\u3044\u3002\`result.boards\` \u306E\u3088\u3046\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u3001\`result.data.boards\` \u306E\u3088\u3046\u306B \`.data\` \u3092\u7D4C\u7531\u3057\u3066\u306F\u3044\u3051\u306A\u3044\u3002\u30A8\u30E9\u30FC\u306F\u81EA\u52D5\u3067\u4F8B\u5916\u3068\u3057\u3066\u6295\u3052\u3089\u308C\u308B\u3002
+- \`client.request(init?)\` \u2014 GraphQL\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u3078\u306E\u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304Dfetch\uFF08\u751F\u306E \`Response\` \u3092\u8FD4\u3059\u3002\`{ data, errors }\` \u30A8\u30F3\u30D9\u30ED\u30FC\u30D7\u3092\u81EA\u5206\u3067\u30D1\u30FC\u30B9\u3059\u308B\u5FC5\u8981\u304C\u3042\u308B\uFF09
+- \`client.me()\` \u2014 \u8A8D\u8A3C\u6E08\u307F\u30E6\u30FC\u30B6\u30FC\u3068\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u53D6\u5F97
+- \`client.listBoards(options?)\` \u2014 ids/workspaceIds/state/page/limit \u3067\u30DC\u30FC\u30C9\u4E00\u89A7\u3092\u53D6\u5F97
+- \`client.getBoard(boardId)\` \u2014 1\u3064\u306E\u30DC\u30FC\u30C9\u3092 columns/groups/owners/tags \u4ED8\u304D\u3067\u53D6\u5F97
+- \`client.listItems(boardId, options?)\` \u2014 \u30DC\u30FC\u30C9\u4E0A\u306E\u30A2\u30A4\u30C6\u30E0\u3092\u30AB\u30FC\u30BD\u30EB\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u3067\u53D6\u5F97\uFF08\`{ cursor, items }\` \u3092\u8FD4\u3059\uFF09
+- \`client.getItem(itemId)\` \u2014 1\u3064\u306E\u30A2\u30A4\u30C6\u30E0\u3092\u30AB\u30E9\u30E0\u5024\u4ED8\u304D\u3067\u53D6\u5F97
+- \`client.createItem(input)\` \u2014 \u30A2\u30A4\u30C6\u30E0\u3092\u4F5C\u6210 (\`boardId\`, \`itemName\`, \u4EFB\u610F\u3067 \`groupId\`, \`columnValues\`)
+- \`client.listUsers(options?)\` \u2014 kind/page/limit \u3067\u30E6\u30FC\u30B6\u30FC\u4E00\u89A7\u3092\u53D6\u5F97
+- \`client.listWorkspaces(options?)\` \u2014 page/limit \u3067\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/monday";
+
+const monday = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { boardId, limit = 25, cursor } = await c.req.json<{
+    boardId: string;
+    limit?: number;
+    cursor?: string;
+  }>();
+
+  const { items, cursor: nextCursor } = await monday.listItems(boardId, { limit, cursor });
+
+  return c.json({ items, cursor: nextCursor });
+}
+\`\`\`
+
+#### \`client.graphql()\` \u306E\u623B\u308A\u5024\uFF08\u3088\u304F\u3042\u308B\u9593\u9055\u3044\uFF09
+
+\`client.graphql()\` \u306F GraphQL \u30EC\u30B9\u30DD\u30F3\u30B9\u306E \`data\` \u3092\u3059\u3067\u306B\u30A2\u30F3\u30E9\u30C3\u30D7\u3057\u3066\u3044\u308B\u3002**\u623B\u308A\u5024\u306B\u5BFE\u3057\u3066 \`.data\` \u3092\u7D4C\u7531\u3057\u3066\u306F\u3044\u3051\u306A\u3044** \u2014 \u5E38\u306B \`undefined\` \u3068\u306A\u308A\u3001\u7D50\u679C\u304C\u7121\u97F3\u3067\u7A7A\u306B\u306A\u308B\u3002
+
+\`\`\`ts
+// \u2705 \u6B63\u3057\u3044 \u2014 \u30D5\u30A3\u30FC\u30EB\u30C9\u306F\u30C8\u30C3\u30D7\u30EC\u30D9\u30EB\u306B\u3042\u308B
+const res = await monday.graphql<{ boards: { items_page: { items: unknown[] } }[] }>(
+  \`query($ids: [ID!], $limit: Int) {
+    boards(ids: $ids) {
+      items_page(limit: $limit) { cursor items { id name } }
+    }
+  }\`,
+  { ids: [boardId], limit: 100 },
+);
+const items = res.boards?.[0]?.items_page?.items ?? [];
+
+// \u274C \u8AA4\u308A \u2014 \`res.data\` \u306F undefined\uFF08SDK\u304C\u65E2\u306B \`.data\` \u3092\u5265\u304C\u3057\u3066\u3044\u308B\uFF09
+const items = res.data?.boards?.[0]?.items_page?.items; // \u5E38\u306B undefined\uFF01
+\`\`\`
+
+### monday.com GraphQL API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8: \`https://api.monday.com/v2\`
+- \u8A8D\u8A3C: API\u30C8\u30FC\u30AF\u30F3\u3092 \`Authorization: <API_TOKEN>\` \u30D8\u30C3\u30C0\u30FC\u3067\u9001\u4FE1\uFF08\`Bearer\` \u30D7\u30EC\u30D5\u30A3\u30C3\u30AF\u30B9\u306F\u4E0D\u8981\u3001\u81EA\u52D5\u8A2D\u5B9A\uFF09
+- \u3059\u3079\u3066\u306E\u30EA\u30AF\u30A8\u30B9\u30C8\u306FPOST\u3067JSON\u30DC\u30C7\u30A3: \`{ "query": "...", "variables": {...} }\`
+- \u4EFB\u610F\u306E \`API-Version\` \u30D8\u30C3\u30C0\u30FC\uFF08\u4F8B: \`2024-10\`\uFF09\u3067API\u30D0\u30FC\u30B8\u30E7\u30F3\u3092\u56FA\u5B9A\u53EF\u80FD\u3002\u6307\u5B9A\u3057\u306A\u3044\u5834\u5408\u306F\u73FE\u5728\u306E\u5B89\u5B9A\u7248\u304C\u4F7F\u7528\u3055\u308C\u308B
+- \u30EC\u30FC\u30C8\u5236\u9650: 1\u5206\u3042\u305F\u308A\u306E\u8907\u96D1\u5EA6\uFF08complexity\uFF09\u30D9\u30FC\u30B9\u3002\u5404\u30AF\u30A8\u30EA\u306F\u8907\u96D1\u5EA6\u30B9\u30B3\u30A2\u3092\u6D88\u8CBB\u3059\u308B\u305F\u3081\u3001\u5FC5\u8981\u306A\u30D5\u30A3\u30FC\u30EB\u30C9\u3060\u3051\u3092\u9078\u629E\u3059\u308B
+- ID \u306F \`ID\` \u30B9\u30AB\u30E9\u30FC\uFF08\u6587\u5B57\u5217\u3068\u3057\u3066\u30B7\u30EA\u30A2\u30E9\u30A4\u30BA\u3055\u308C\u308B\uFF09\u3002\u5909\u6570\u3067\u306F\u5FC5\u305A\u6587\u5B57\u5217\u3068\u3057\u3066\u6E21\u3059
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3:
+  - \u30DC\u30FC\u30C9\u4E0A\u306E\u30A2\u30A4\u30C6\u30E0: \`items_page(limit, cursor)\` \u304C \`{ cursor, items }\` \u3092\u8FD4\u3059\u3002\u6B21\u56DE\u547C\u3073\u51FA\u3057\u6642\u306B \`cursor\` \u3092\u6E21\u3059\u3002\`cursor\` \u304C null \u306B\u306A\u308C\u3070\u7D42\u7AEF
+  - \u30DC\u30FC\u30C9\uFF0F\u30E6\u30FC\u30B6\u30FC\uFF0F\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9: \`limit\` \u3068 \`page\` \u5F15\u6570\u306E\u30DA\u30FC\u30B8\u30D9\u30FC\u30B9
+
+#### \u4E3B\u8981\u30AF\u30A8\u30EA
+- \`{ me { id name email account { id name } } }\` \u2014 \u8A8D\u8A3C\u30E6\u30FC\u30B6\u30FC\u3068\u30A2\u30AB\u30A6\u30F3\u30C8
+- \`{ boards(limit: 10) { id name state board_kind workspace { id name } } }\` \u2014 \u30DC\u30FC\u30C9\u4E00\u89A7
+- \`{ boards(ids: [BOARD_ID]) { columns { id title type settings_str } groups { id title } } }\` \u2014 \u30DC\u30FC\u30C9\u306E\u30B9\u30AD\u30FC\u30DE\u53D6\u5F97
+- \`{ boards(ids: [BOARD_ID]) { items_page(limit: 25) { cursor items { id name column_values { id text value } } } } }\` \u2014 \u30A2\u30A4\u30C6\u30E0\u4E00\u89A7
+- \`{ items(ids: [ITEM_ID]) { id name column_values { id text value column { title } } } }\` \u2014 \u5358\u4E00\u30A2\u30A4\u30C6\u30E0\u53D6\u5F97
+- \`{ users(limit: 25) { id name email enabled is_admin is_guest } }\` \u2014 \u30E6\u30FC\u30B6\u30FC\u4E00\u89A7
+- \`{ workspaces(limit: 25) { id name kind state } }\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7
+
+#### \u4E3B\u8981\u30DF\u30E5\u30FC\u30C6\u30FC\u30B7\u30E7\u30F3
+- \`mutation { create_item(board_id: BOARD_ID, item_name: "New task", column_values: "{\\"status\\":{\\"label\\":\\"Done\\"}}") { id name } }\` \u2014 \u30A2\u30A4\u30C6\u30E0\u4F5C\u6210\uFF08column_values \u306F JSON\u6587\u5B57\u5217\uFF09
+- \`mutation { change_column_value(board_id: BOARD_ID, item_id: ITEM_ID, column_id: "status", value: "{\\"label\\":\\"Done\\"}") { id } }\` \u2014 \u30AB\u30E9\u30E0\u5024\u306E\u66F4\u65B0
+- \`mutation { create_update(item_id: ITEM_ID, body: "Hello") { id } }\` \u2014 \u30A2\u30A4\u30C6\u30E0\u306B\u30A2\u30C3\u30D7\u30C7\u30FC\u30C8\uFF08\u30B3\u30E1\u30F3\u30C8\uFF09\u3092\u6295\u7A3F
+- \`mutation { delete_item(item_id: ITEM_ID) { id } }\` \u2014 \u30A2\u30A4\u30C6\u30E0\u524A\u9664
+
+#### \u6CE8\u610F\u70B9
+- \`column_values\` \u306F JSON\u30A8\u30F3\u30B3\u30FC\u30C9\u3055\u308C\u305F\u6587\u5B57\u5217\u3092\u53D7\u3051\u53D6\u308B\u3002\u30AF\u30A8\u30EA\u6587\u5B57\u5217\u306B\u76F4\u66F8\u304D\u3059\u308B\u969B\u306F\u5185\u5074\u306E\u30AF\u30AA\u30FC\u30C8\u3092\u30A8\u30B9\u30B1\u30FC\u30D7\u3059\u308B\u304B\u3001GraphQL\u5909\u6570\u7D4C\u7531\u3067\u6E21\u3057\u3066\u30A8\u30B9\u30B1\u30FC\u30D7\u3092\u907F\u3051\u308B\u306E\u304C\u5B89\u5168
+- \`ID\` \u30B9\u30AB\u30E9\u30FC\u306F\u6570\u5024\u30FB\u6587\u5B57\u5217\u3069\u3061\u3089\u3082\u53D7\u3051\u4ED8\u3051\u308B\u304C\u3001\u5909\u6570\u3067\u306F\u6587\u5B57\u5217\u3067\u6E21\u3059\u306E\u304C\u5B89\u5168
+- \`board.tags\` \u306E\u3088\u3046\u306B\u3001\u660E\u793A\u7684\u306B\u4F7F\u308F\u308C\u3066\u3044\u308B\u30DC\u30FC\u30C9\u3067\u306E\u307F\u5024\u304C\u8FD4\u308B\u30D5\u30A3\u30FC\u30EB\u30C9\u3082\u3042\u308B`
+  },
+  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 normalizeHeaders(input) {
+  const out = {};
+  if (!input) return out;
+  new Headers(input).forEach((value, key) => {
+    out[key] = value;
+  });
+  return out;
+}
+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,
+        headers: normalizeHeaders(init?.headers),
+        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,
+        headers: normalizeHeaders(init?.headers),
+        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/monday.ts
+var connection = createConnectorSdk(mondayConnector, createClient);
+export {
+  connection
+};