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

package/dist/connectors/github.js

@@ -0,0 +1,963 @@
+// ../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/github/parameters.ts
+var parameters = {
+  personalAccessToken: new ParameterDefinition({
+    slug: "personal-access-token",
+    name: "GitHub Personal Access Token",
+    description: "Personal Access Token (Classic \u2014 `ghp_\u2026` \u2014 or fine-grained \u2014 `github_pat_\u2026`). Generate one at https://github.com/settings/tokens. The token must have the scopes / repository access required for the data you want to read (e.g. `repo` for private repositories, `read:org` for org metadata).",
+    envVarBaseKey: "GITHUB_PAT",
+    type: "text",
+    secret: true,
+    required: true
+  }),
+  baseUrl: new ParameterDefinition({
+    slug: "base-url",
+    name: "GitHub API Base URL",
+    description: "Optional. Override the API base URL for GitHub Enterprise Server (e.g. `https://github.example.com/api/v3`). Leave empty to use the public API at `https://api.github.com`.",
+    envVarBaseKey: "GITHUB_API_BASE_URL",
+    type: "text",
+    secret: false,
+    required: false
+  })
+};
+var DEFAULT_BASE_URL = "https://api.github.com";
+
+// ../connectors/src/connectors/github/sdk/index.ts
+function createClient(params) {
+  const token = params[parameters.personalAccessToken.slug];
+  if (!token) {
+    throw new Error(
+      `github: missing required parameter: ${parameters.personalAccessToken.slug}`
+    );
+  }
+  const baseUrlParam = params[parameters.baseUrl.slug]?.trim();
+  const baseUrl = baseUrlParam && baseUrlParam.replace(/\/+$/, "") || DEFAULT_BASE_URL;
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("Authorization", `Bearer ${token}`);
+    headers.set("Accept", "application/vnd.github+json");
+    headers.set("X-GitHub-Api-Version", "2022-11-28");
+    if (!headers.has("User-Agent")) {
+      headers.set("User-Agent", "squadbase-connectors-github");
+    }
+    return headers;
+  }
+  async function assertOk(res, label) {
+    if (!res.ok) {
+      const body = await res.text().catch(() => "(unreadable body)");
+      throw new Error(
+        `github ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  function buildQuery(base) {
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(base)) {
+      if (value !== void 0) search.set(key, String(value));
+    }
+    const qs = search.toString();
+    return qs ? `?${qs}` : "";
+  }
+  return {
+    request(path2, init) {
+      const url = `${baseUrl}${path2.startsWith("/") ? "" : "/"}${path2}`;
+      const headers = authHeaders(
+        init?.headers
+      );
+      if (!headers.has("Content-Type") && init?.body !== void 0) {
+        headers.set("Content-Type", "application/json");
+      }
+      return fetch(url, { ...init, headers });
+    },
+    async getAuthenticatedUser() {
+      const res = await fetch(`${baseUrl}/user`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "getAuthenticatedUser");
+      return await res.json();
+    },
+    async listAuthenticatedRepos(options) {
+      const qs = buildQuery({
+        visibility: options?.visibility,
+        affiliation: options?.affiliation,
+        type: options?.type,
+        sort: options?.sort,
+        direction: options?.direction,
+        per_page: options?.per_page,
+        page: options?.page
+      });
+      const res = await fetch(`${baseUrl}/user/repos${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "listAuthenticatedRepos");
+      return await res.json();
+    },
+    async listOrgRepos(org, options) {
+      const qs = buildQuery({
+        type: options?.type,
+        sort: options?.sort,
+        direction: options?.direction,
+        per_page: options?.per_page,
+        page: options?.page
+      });
+      const res = await fetch(
+        `${baseUrl}/orgs/${encodeURIComponent(org)}/repos${qs}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listOrgRepos");
+      return await res.json();
+    },
+    async getRepo(owner, repo) {
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getRepo");
+      return await res.json();
+    },
+    async listIssues(owner, repo, options) {
+      const qs = buildQuery({
+        state: options?.state,
+        labels: options?.labels,
+        sort: options?.sort,
+        direction: options?.direction,
+        since: options?.since,
+        assignee: options?.assignee,
+        creator: options?.creator,
+        mentioned: options?.mentioned,
+        milestone: options?.milestone !== void 0 ? String(options.milestone) : void 0,
+        per_page: options?.per_page,
+        page: options?.page
+      });
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues${qs}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listIssues");
+      return await res.json();
+    },
+    async getIssue(owner, repo, issueNumber) {
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getIssue");
+      return await res.json();
+    },
+    async createIssue(owner, repo, issueData) {
+      const headers = authHeaders();
+      headers.set("Content-Type", "application/json");
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues`,
+        { method: "POST", headers, body: JSON.stringify(issueData) }
+      );
+      await assertOk(res, "createIssue");
+      return await res.json();
+    },
+    async createIssueComment(owner, repo, issueNumber, body) {
+      const headers = authHeaders();
+      headers.set("Content-Type", "application/json");
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/issues/${issueNumber}/comments`,
+        { method: "POST", headers, body: JSON.stringify({ body }) }
+      );
+      await assertOk(res, "createIssueComment");
+      return await res.json();
+    },
+    async listPullRequests(owner, repo, options) {
+      const qs = buildQuery({
+        state: options?.state,
+        head: options?.head,
+        base: options?.base,
+        sort: options?.sort,
+        direction: options?.direction,
+        per_page: options?.per_page,
+        page: options?.page
+      });
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls${qs}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listPullRequests");
+      return await res.json();
+    },
+    async getPullRequest(owner, repo, pullNumber) {
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/pulls/${pullNumber}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getPullRequest");
+      return await res.json();
+    },
+    async listCommits(owner, repo, options) {
+      const qs = buildQuery({
+        sha: options?.sha,
+        path: options?.path,
+        author: options?.author,
+        since: options?.since,
+        until: options?.until,
+        per_page: options?.per_page,
+        page: options?.page
+      });
+      const res = await fetch(
+        `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/commits${qs}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listCommits");
+      return await res.json();
+    },
+    async searchRepositories(q, options) {
+      const qs = buildQuery({
+        q,
+        sort: options?.sort,
+        order: options?.order,
+        per_page: options?.per_page,
+        page: options?.page
+      });
+      const res = await fetch(`${baseUrl}/search/repositories${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "searchRepositories");
+      return await res.json();
+    },
+    async searchIssues(q, options) {
+      const qs = buildQuery({
+        q,
+        sort: options?.sort,
+        order: options?.order,
+        per_page: options?.per_page,
+        page: options?.page
+      });
+      const res = await fetch(`${baseUrl}/search/issues${qs}`, {
+        method: "GET",
+        headers: authHeaders()
+      });
+      await assertOk(res, "searchIssues");
+      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;
+  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/github/setup.ts
+var githubOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call github_request with GET /user to confirm credentials and discover the authenticated account (login, name, plan).
+2. Call github_request with GET /user/repos?per_page=10&sort=updated to sample repositories the token can see. For organisation-owned repos, use GET /orgs/{org}/repos.
+3. Pick a representative repo and inspect its activity:
+   - GET /repos/{owner}/{repo}/issues?state=open&per_page=10 \u2014 recent open issues (the GitHub API treats pull requests as issues; filter with the \`pull_request\` field if you want only issues).
+   - GET /repos/{owner}/{repo}/pulls?state=open&per_page=10 \u2014 open pull requests.
+   - GET /repos/{owner}/{repo}/commits?per_page=10 \u2014 recent commits on the default branch.
+4. For broad discovery, use the search endpoints (GET /search/repositories?q=..., /search/issues?q=..., /search/code?q=...). These are heavily rate-limited (30 req/min for authenticated users), so use them sparingly.
+5. Pagination is page-based: \`?page=1&per_page=100\` (max 100). The \`Link\` response header carries \`rel="next"\` / \`rel="last"\` URLs when more results exist.`,
+    ja: `1. github_request \u3067 GET /user \u3092\u547C\u3073\u51FA\u3057\u3001\u8A8D\u8A3C\u60C5\u5831\u306E\u78BA\u8A8D\u3068\u8A8D\u8A3C\u6E08\u307F\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u60C5\u5831\uFF08login, name, plan\uFF09\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002
+2. github_request \u3067 GET /user/repos?per_page=10&sort=updated \u3092\u547C\u3073\u51FA\u3057\u3066\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EA\u30DD\u30B8\u30C8\u30EA\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0\u3057\u307E\u3059\u3002Organization \u6240\u6709\u306E\u30EA\u30DD\u30B8\u30C8\u30EA\u306F GET /orgs/{org}/repos \u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
+3. \u4EE3\u8868\u7684\u306A\u30EA\u30DD\u30B8\u30C8\u30EA\u3092\u9078\u3073\u3001\u30A2\u30AF\u30C6\u30A3\u30D3\u30C6\u30A3\u3092\u78BA\u8A8D\u3057\u307E\u3059:
+   - GET /repos/{owner}/{repo}/issues?state=open&per_page=10 \u2014 \u76F4\u8FD1\u306E\u30AA\u30FC\u30D7\u30F3\u30A4\u30B7\u30E5\u30FC\uFF08GitHub API \u306F\u30D7\u30EB\u30EA\u30AF\u30A8\u30B9\u30C8\u3082\u30A4\u30B7\u30E5\u30FC\u6271\u3044\u3057\u307E\u3059\u3002\u30A4\u30B7\u30E5\u30FC\u306E\u307F\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F \`pull_request\` \u30D5\u30A3\u30FC\u30EB\u30C9\u3067\u9664\u5916\uFF09\u3002
+   - GET /repos/{owner}/{repo}/pulls?state=open&per_page=10 \u2014 \u30AA\u30FC\u30D7\u30F3\u306A\u30D7\u30EB\u30EA\u30AF\u30A8\u30B9\u30C8\u4E00\u89A7\u3002
+   - GET /repos/{owner}/{repo}/commits?per_page=10 \u2014 \u30C7\u30D5\u30A9\u30EB\u30C8\u30D6\u30E9\u30F3\u30C1\u306E\u76F4\u8FD1\u30B3\u30DF\u30C3\u30C8\u3002
+4. \u6A2A\u65AD\u7684\u306B\u63A2\u7D22\u3059\u308B\u5834\u5408\u306F\u30B5\u30FC\u30C1\u7CFB\uFF08GET /search/repositories?q=..., /search/issues?q=..., /search/code?q=...\uFF09\u3092\u4F7F\u7528\u3057\u307E\u3059\u304C\u3001\u8A8D\u8A3C\u30E6\u30FC\u30B6\u30FC\u3067\u308230 req/\u5206\u306E\u53B3\u3057\u3044\u30EC\u30FC\u30C8\u5236\u9650\u304C\u3042\u308B\u305F\u3081\u547C\u3073\u51FA\u3057\u306F\u63A7\u3048\u3081\u306B\u3002
+5. \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\u306F1\u59CB\u307E\u308A\u306E \`page\` \u3068 \`per_page\`\uFF08\u6700\u5927100\uFF09\u3002\`Link\` \u30EC\u30B9\u30DD\u30F3\u30B9\u30D8\u30C3\u30C0\u306E \`rel="next"\` / \`rel="last"\` \u304B\u3089\u6B21URL\u3092\u53D6\u5F97\u3067\u304D\u307E\u3059\u3002`
+  }
+});
+
+// ../connectors/src/connectors/github/tools/request.ts
+import { z } from "zod";
+var REQUEST_TIMEOUT_MS = 6e4;
+function resolveBaseUrl(connectionBaseUrl) {
+  const trimmed = connectionBaseUrl?.trim();
+  return trimmed && trimmed.replace(/\/+$/, "") || DEFAULT_BASE_URL;
+}
+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 GitHub connection to use"),
+  method: z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).describe(
+    "HTTP method. GET for reading, POST for creating, PATCH for partial updates, PUT for replacement (e.g. starring), DELETE for removal."
+  ),
+  path: z.string().describe(
+    "API path (e.g., '/user', '/repos/{owner}/{repo}/issues', '/search/repositories?q=topic:react'). Append query parameters such as '?state=open&per_page=100&page=1'."
+  ),
+  body: z.union([
+    z.record(z.string(), z.unknown()),
+    z.array(z.unknown())
+  ]).optional().describe(
+    'Request body (JSON). Example creating an issue: { "title": "...", "body": "...", "labels": ["bug"] }.'
+  )
+});
+var outputSchema = z.discriminatedUnion("success", [
+  z.object({
+    success: z.literal(true),
+    status: z.number(),
+    data: z.union([
+      z.record(z.string(), z.unknown()),
+      z.array(z.unknown())
+    ])
+  }),
+  z.object({
+    success: z.literal(false),
+    error: z.string()
+  })
+]);
+var requestTool = new ConnectorTool({
+  name: "request",
+  description: `Send authenticated requests to the GitHub REST API.
+Authentication uses the Personal Access Token via \`Authorization: Bearer <PAT>\` (handled automatically). Both Classic (\`ghp_\u2026\`) and fine-grained (\`github_pat_\u2026\`) tokens work \u2014 the scopes / repository access of the token determine what data is reachable.
+
+Provide the API path relative to the base URL (default \`https://api.github.com\`; can be overridden per-connection for GitHub Enterprise Server).
+
+Common endpoints:
+- GET /user \u2014 Authenticated user (auth probe)
+- GET /user/repos?sort=updated \u2014 Repos accessible to the token
+- GET /orgs/{org}/repos \u2014 Repos owned by an organisation
+- GET /repos/{owner}/{repo} \u2014 Repository metadata
+- GET /repos/{owner}/{repo}/branches \u2014 Branches
+- GET /repos/{owner}/{repo}/commits \u2014 Commits on the default branch (\`?sha=branch\` to switch)
+- GET /repos/{owner}/{repo}/contents/{path} \u2014 File or directory contents
+- GET /repos/{owner}/{repo}/issues?state=open \u2014 Issues (note: pull requests are returned too \u2014 they have a \`pull_request\` field; filter on it to separate)
+- GET /repos/{owner}/{repo}/issues/{number} \u2014 Single issue / PR
+- POST /repos/{owner}/{repo}/issues \u2014 Create an issue (body: { title, body, labels })
+- PATCH /repos/{owner}/{repo}/issues/{number} \u2014 Update an issue (close: { "state": "closed" })
+- GET /repos/{owner}/{repo}/issues/{number}/comments \u2014 List issue comments
+- POST /repos/{owner}/{repo}/issues/{number}/comments \u2014 Add a comment
+- GET /repos/{owner}/{repo}/pulls?state=open \u2014 Pull requests
+- GET /repos/{owner}/{repo}/pulls/{number} \u2014 Single PR (includes mergeability)
+- GET /repos/{owner}/{repo}/pulls/{number}/files \u2014 Files changed in a PR
+- GET /repos/{owner}/{repo}/pulls/{number}/reviews \u2014 Reviews on a PR
+- GET /repos/{owner}/{repo}/actions/runs \u2014 GitHub Actions workflow runs
+- GET /repos/{owner}/{repo}/releases \u2014 Releases
+- GET /search/repositories?q=topic:react \u2014 Repository search
+- GET /search/issues?q=is:pr+repo:foo/bar \u2014 Issue / PR search
+- GET /search/code?q=...+repo:foo/bar \u2014 Code search
+- GET /rate_limit \u2014 Inspect remaining quota
+
+Pagination: 1-indexed \`page\` + \`per_page\` (max 100). The \`Link\` response header exposes \`rel="next"\`/\`rel="last"\` URLs.
+
+Rate limits: 5,000 req/hr on REST endpoints, 30 req/min on /search/*. Inspect \`X-RateLimit-Remaining\` to throttle.`,
+  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] github/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const token = parameters.personalAccessToken.getValue(connection2);
+      const baseUrl = resolveBaseUrl(parameters.baseUrl.tryGetValue(connection2));
+      const trimmedPath = path2.trim().replace(/^\/+/, "/");
+      const url = `${baseUrl}${trimmedPath.startsWith("/") ? "" : "/"}${trimmedPath}`;
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            Authorization: `Bearer ${token}`,
+            Accept: "application/vnd.github+json",
+            "X-GitHub-Api-Version": "2022-11-28",
+            "User-Agent": "squadbase-connectors-github",
+            "Content-Type": "application/json"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        const text = await response.text();
+        const data = text ? JSON.parse(text) : {};
+        if (!response.ok) {
+          const errObj = !Array.isArray(data) ? data : {};
+          const message = typeof errObj.message === "string" && errObj.message || typeof errObj.error === "string" && errObj.error;
+          const errors = errObj.errors;
+          const fieldDetail = Array.isArray(errors) && errors.length > 0 ? ` \u2014 ${errors[0]?.message ?? JSON.stringify(errors[0])}` : "";
+          const errorMessage = message ? `${message}${fieldDetail}` : `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/github/index.ts
+var tools = { request: requestTool };
+var githubConnector = new ConnectorPlugin({
+  slug: "github",
+  authType: AUTH_TYPES.PAT,
+  name: "GitHub",
+  description: "Connect to GitHub for repository, issue, pull request, commit, and search data via Personal Access Token (Classic or fine-grained).",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/2flOAufkhDrLKuOQqEVS3/1f9dcf145680ef77aef149709263e2d4/github-icon.svg",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  categories: ["productivity"],
+  onboarding: githubOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`github_request\`: The only way to call the GitHub REST API. Use it to read repositories, issues, pull requests, commits, comments, releases, GitHub Actions runs, organisation metadata, and the search endpoints. Authentication (\`Authorization: Bearer <PAT>\`) and required headers (\`Accept: application/vnd.github+json\`, \`X-GitHub-Api-Version: 2022-11-28\`, \`User-Agent\`) are configured automatically. Both Classic (\`ghp_\u2026\`) and fine-grained (\`github_pat_\u2026\`) tokens work.
+
+### Cloning Repositories for Deep Code Exploration
+
+\`github_request\` plus \`/repos/{owner}/{repo}/contents/{path}\` is fine for reading a few files. When the task requires deep exploration \u2014 reading many files, searching across the codebase with ripgrep / grep, or inspecting many commits \u2014 prefer \`git clone\` via the bash tool. Follow these rules **strictly**:
+
+1. **Always clone OUTSIDE the dashboard project.** The current working directory is the user's Vite-based dashboard project, which is itself a git repository. Cloning into it (or any subdirectory of it) would pollute the dashboard's git index, risk accidental commits, and create nested-repo confusion. Always clone into a path outside the project \u2014 use \`$(mktemp -d)\`, \`/tmp/<unique-name>\`, or \`~/.cache/<unique-name>\`.
+2. **NEVER commit, push, or otherwise write to the cloned repo.** This is a strictly read-only flow. Do not run \`git commit\`, \`git push\`, \`git tag\`, \`git rebase\`, or any other write operation inside the cloned working tree. The connector is for reading source; if the task requires writing back to GitHub (creating an issue, posting a comment, etc.), use \`github_request\` \u2014 never \`git push\`.
+3. **Authenticate via HTTPS using the PAT inline.** Run \`git clone https://<TOKEN>@github.com/<owner>/<repo>.git <target-dir>\`. Avoid logging the URL with the token interpolated; redact when echoing commands.
+4. **Prefer shallow clones.** Use \`--depth=1 --single-branch\` unless full history is specifically required.
+5. **Clean up when done.** Remove the cloned directory (\`rm -rf <target-dir>\`) once exploration is complete.
+
+### 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 (default base \`https://api.github.com\`, overridable per-connection for GitHub Enterprise Server)
+- \`client.getAuthenticatedUser()\` \u2014 calling user (auth probe)
+- \`client.listAuthenticatedRepos(options?)\` / \`client.listOrgRepos(org, options?)\` \u2014 repos
+- \`client.getRepo(owner, repo)\` \u2014 single repo
+- \`client.listIssues(owner, repo, options?)\` / \`client.getIssue(owner, repo, n)\` / \`client.createIssue(owner, repo, data)\` \u2014 issues
+- \`client.createIssueComment(owner, repo, n, body)\` \u2014 add a comment to an issue or PR
+- \`client.listPullRequests(owner, repo, options?)\` / \`client.getPullRequest(owner, repo, n)\` \u2014 pull requests
+- \`client.listCommits(owner, repo, options?)\` \u2014 commits
+- \`client.searchRepositories(q, options?)\` / \`client.searchIssues(q, options?)\` \u2014 search (rate-limited 30 req/min)
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/github";
+
+const gh = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { owner, repo } = await c.req.json<{ owner: string; repo: string }>();
+  const issues = await gh.listIssues(owner, repo, {
+    state: "open",
+    sort: "updated",
+    direction: "desc",
+    per_page: 100,
+  });
+  // GitHub returns PRs in the issues endpoint \u2014 filter them out.
+  const onlyIssues = issues.filter((i) => !("pull_request" in i));
+  return c.json({ issues: onlyIssues });
+}
+\`\`\`
+
+### GitHub REST API Reference
+
+- Base URL: \`https://api.github.com\` (overridable per-connection for GitHub Enterprise Server, e.g. \`https://github.example.com/api/v3\`)
+- Authentication: \`Authorization: Bearer <PAT>\`. Required headers (handled automatically): \`Accept: application/vnd.github+json\`, \`X-GitHub-Api-Version: 2022-11-28\`, \`User-Agent\`.
+- Token scopes determine reachable data: e.g. \`repo\` for private repositories, \`read:org\` for organisation metadata. Fine-grained tokens additionally restrict by repository.
+- Pagination: 1-indexed \`page\` + \`per_page\` (max 100). The \`Link\` response header carries \`rel="next"\` / \`rel="last"\` URLs.
+- Rate limits: 5,000 req/hr for authenticated REST endpoints, 30 req/min for \`/search/*\`. Inspect \`X-RateLimit-Remaining\` / \`X-RateLimit-Reset\`.
+- Caveat: \`/repos/{owner}/{repo}/issues\` returns pull requests too. They include a \`pull_request\` object \u2014 filter on it (or call \`/repos/{owner}/{repo}/pulls\` directly).
+
+#### Resource Endpoints
+
+**User & Orgs**
+- GET \`/user\` \u2014 Authenticated user
+- GET \`/users/{username}\` \u2014 Public profile
+- GET \`/orgs/{org}\` \u2014 Org metadata
+- GET \`/orgs/{org}/members\` \u2014 Org members
+
+**Repositories**
+- GET \`/user/repos?sort=updated\` \u2014 Repos visible to the token
+- GET \`/orgs/{org}/repos\` \u2014 Org repos
+- GET \`/repos/{owner}/{repo}\` \u2014 Repo metadata
+- GET \`/repos/{owner}/{repo}/branches\` \u2014 Branches
+- GET \`/repos/{owner}/{repo}/contents/{path}\` \u2014 File or directory
+- GET \`/repos/{owner}/{repo}/topics\` \u2014 Topics
+
+**Issues**
+- GET \`/repos/{owner}/{repo}/issues?state=open\` \u2014 Issues (includes PRs \u2014 see caveat)
+- GET \`/repos/{owner}/{repo}/issues/{number}\` \u2014 Single issue
+- POST \`/repos/{owner}/{repo}/issues\` \u2014 Create
+- PATCH \`/repos/{owner}/{repo}/issues/{number}\` \u2014 Update (close: \`{ "state": "closed" }\`)
+- GET \`/repos/{owner}/{repo}/issues/{number}/comments\` \u2014 Comments
+- POST \`/repos/{owner}/{repo}/issues/{number}/comments\` \u2014 Add comment
+
+**Pull requests**
+- GET \`/repos/{owner}/{repo}/pulls?state=open\` \u2014 PRs
+- GET \`/repos/{owner}/{repo}/pulls/{number}\` \u2014 Single PR (includes \`mergeable\`, \`mergeable_state\`)
+- GET \`/repos/{owner}/{repo}/pulls/{number}/files\` \u2014 Files changed
+- GET \`/repos/{owner}/{repo}/pulls/{number}/commits\` \u2014 Commits in PR
+- GET \`/repos/{owner}/{repo}/pulls/{number}/reviews\` \u2014 Reviews
+
+**Commits & Releases**
+- GET \`/repos/{owner}/{repo}/commits?sha=branch\` \u2014 Commits
+- GET \`/repos/{owner}/{repo}/commits/{ref}\` \u2014 Single commit (with files / stats)
+- GET \`/repos/{owner}/{repo}/releases\` \u2014 Releases
+- GET \`/repos/{owner}/{repo}/releases/latest\` \u2014 Latest release
+
+**Actions**
+- GET \`/repos/{owner}/{repo}/actions/runs\` \u2014 Workflow runs
+- GET \`/repos/{owner}/{repo}/actions/workflows\` \u2014 Workflows
+
+**Search (rate-limited)**
+- GET \`/search/repositories?q=topic:react+language:typescript\` \u2014 Repos
+- GET \`/search/issues?q=is:open+is:pr+repo:foo/bar\` \u2014 Issues / PRs
+- GET \`/search/code?q=...+repo:foo/bar\` \u2014 Code (token must have \`repo\` scope)
+- GET \`/search/users?q=...\` \u2014 Users
+
+**Quota**
+- GET \`/rate_limit\` \u2014 Inspect remaining quota across REST / GraphQL / search`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`github_request\`: GitHub REST API \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30EA\u30DD\u30B8\u30C8\u30EA\u3001Issue\u3001Pull Request\u3001\u30B3\u30DF\u30C3\u30C8\u3001\u30B3\u30E1\u30F3\u30C8\u3001Release\u3001GitHub Actions \u306E\u30E9\u30F3\u3001\u7D44\u7E54\u30E1\u30BF\u60C5\u5831\u3001\u30B5\u30FC\u30C1\u7CFB\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306E\u53D6\u5F97\u30FB\u66F4\u65B0\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08\`Authorization: Bearer <PAT>\`\uFF09\u3068\u5FC5\u9808\u30D8\u30C3\u30C0\uFF08\`Accept: application/vnd.github+json\`\u3001\`X-GitHub-Api-Version: 2022-11-28\`\u3001\`User-Agent\`\uFF09\u306F\u81EA\u52D5\u3067\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002Classic\uFF08\`ghp_\u2026\`\uFF09/ fine-grained\uFF08\`github_pat_\u2026\`\uFF09\u3069\u3061\u3089\u306E PAT \u3082\u5229\u7528\u53EF\u80FD\u3067\u3059\u3002
+
+### \u6DF1\u3044\u30B3\u30FC\u30C9\u63A2\u7D22\u306E\u305F\u3081\u306E\u30EA\u30DD\u30B8\u30C8\u30EA\u30AF\u30ED\u30FC\u30F3
+
+\u6570\u30D5\u30A1\u30A4\u30EB\u3092\u8AAD\u3080\u7A0B\u5EA6\u306A\u3089 \`github_request\` \u3068 \`/repos/{owner}/{repo}/contents/{path}\` \u3067\u5341\u5206\u3067\u3059\u3002\u591A\u6570\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u8AAD\u3080\u3001ripgrep / grep \u3067\u6A2A\u65AD\u691C\u7D22\u3059\u308B\u3001\u8907\u6570\u30B3\u30DF\u30C3\u30C8\u3092\u8ABF\u3079\u308B\u306A\u3069 **\u6DF1\u3044\u63A2\u7D22\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F** bash \u30C4\u30FC\u30EB\u7D4C\u7531\u3067 \`git clone\` \u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002\u4EE5\u4E0B\u306E\u30EB\u30FC\u30EB\u3092 **\u53B3\u5B88** \u3059\u308B\u3053\u3068\uFF1A
+
+1. **\u5FC5\u305A\u30C0\u30C3\u30B7\u30E5\u30DC\u30FC\u30C9\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u5916\u306B\u30AF\u30ED\u30FC\u30F3\u3059\u308B\u3053\u3068\u3002** \u73FE\u5728\u306E\u4F5C\u696D\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u306F\u30E6\u30FC\u30B6\u30FC\u306E Vite \u30D9\u30FC\u30B9\u306E\u30C0\u30C3\u30B7\u30E5\u30DC\u30FC\u30C9\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\uFF08\u305D\u308C\u81EA\u4F53\u304C git \u30EA\u30DD\u30B8\u30C8\u30EA\uFF09\u3067\u3059\u3002\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u5185\uFF08\u3042\u308B\u3044\u306F\u305D\u306E\u30B5\u30D6\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\uFF09\u306B\u30AF\u30ED\u30FC\u30F3\u3059\u308B\u3068\u30C0\u30C3\u30B7\u30E5\u30DC\u30FC\u30C9\u306E git \u306E\u72B6\u614B\u3092\u6C5A\u67D3\u3057\u3001\u8AA4\u30B3\u30DF\u30C3\u30C8\u3084\u30CD\u30B9\u30C8\u3057\u305F\u30EA\u30DD\u30B8\u30C8\u30EA\u306E\u6DF7\u4E71\u306E\u539F\u56E0\u306B\u306A\u308A\u307E\u3059\u3002\u5FC5\u305A\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u5916\u306E\u30D1\u30B9\uFF08\`$(mktemp -d)\`, \`/tmp/<unique-name>\`, \`~/.cache/<unique-name>\` \u306A\u3069\uFF09\u306B\u30AF\u30ED\u30FC\u30F3\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+2. **\u7D76\u5BFE\u306B commit / push / \u66F8\u304D\u8FBC\u307F\u64CD\u4F5C\u3092\u3057\u306A\u3044\u3053\u3068\u3002** \u3053\u308C\u306F\u53B3\u5BC6\u306B read-only \u306E\u30D5\u30ED\u30FC\u3067\u3059\u3002\u30AF\u30ED\u30FC\u30F3\u3057\u305F\u4F5C\u696D\u30C4\u30EA\u30FC\u5185\u3067 \`git commit\` / \`git push\` / \`git tag\` / \`git rebase\` \u306A\u3069\u306E\u66F8\u304D\u8FBC\u307F\u64CD\u4F5C\u3092\u884C\u308F\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002GitHub \u3078\u306E\u66F8\u304D\u8FBC\u307F\u304C\u5FC5\u8981\u306A\u5834\u5408\uFF08Issue \u4F5C\u6210\u3001\u30B3\u30E1\u30F3\u30C8\u6295\u7A3F\u7B49\uFF09\u306F \`github_request\` \u3092\u4F7F\u7528\u3057\u3001\`git push\` \u3067\u884C\u308F\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+3. **HTTPS \u8A8D\u8A3C\u3067 PAT \u3092\u30A4\u30F3\u30E9\u30A4\u30F3\u3067\u6E21\u3059\u3053\u3068\u3002** \`git clone https://<TOKEN>@github.com/<owner>/<repo>.git <target-dir>\` \u306E\u3088\u3046\u306B\u57CB\u3081\u8FBC\u307F\u307E\u3059\u3002\u30C8\u30FC\u30AF\u30F3\u5165\u308A\u306E URL \u3092\u305D\u306E\u307E\u307E\u30ED\u30B0\u306B\u51FA\u529B\u3057\u306A\u3044\u3088\u3046\u3001\u30B3\u30DE\u30F3\u30C9\u3092\u30A8\u30B3\u30FC\u3059\u308B\u969B\u306F\u30DE\u30B9\u30AF\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+4. **shallow clone \u3092\u512A\u5148\u3059\u308B\u3053\u3068\u3002** \u5C65\u6B74\u304C\u7279\u306B\u5FC5\u8981\u3067\u306A\u3044\u9650\u308A \`--depth=1 --single-branch\` \u3092\u4F7F\u7528\u3057\u307E\u3059\u3002
+5. **\u4F5C\u696D\u5F8C\u306F\u524A\u9664\u3059\u308B\u3053\u3068\u3002** \u63A2\u7D22\u304C\u7D42\u308F\u3063\u305F\u3089\u30AF\u30ED\u30FC\u30F3\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\u3092\u524A\u9664\uFF08\`rm -rf <target-dir>\`\uFF09\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\u65E2\u5B9A base \`https://api.github.com\`\u3001\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u5358\u4F4D\u3067 GitHub Enterprise Server \u7528\u306B\u4E0A\u66F8\u304D\u53EF\u80FD\uFF09
+- \`client.getAuthenticatedUser()\` \u2014 \u8A8D\u8A3C\u30E6\u30FC\u30B6\u30FC\uFF08\u758E\u901A\u78BA\u8A8D\uFF09
+- \`client.listAuthenticatedRepos(options?)\` / \`client.listOrgRepos(org, options?)\` \u2014 \u30EA\u30DD\u30B8\u30C8\u30EA
+- \`client.getRepo(owner, repo)\` \u2014 \u5358\u4E00\u30EA\u30DD\u30B8\u30C8\u30EA
+- \`client.listIssues(owner, repo, options?)\` / \`client.getIssue(owner, repo, n)\` / \`client.createIssue(owner, repo, data)\` \u2014 Issue
+- \`client.createIssueComment(owner, repo, n, body)\` \u2014 Issue / PR \u306B\u30B3\u30E1\u30F3\u30C8\u3092\u8FFD\u52A0
+- \`client.listPullRequests(owner, repo, options?)\` / \`client.getPullRequest(owner, repo, n)\` \u2014 Pull Request
+- \`client.listCommits(owner, repo, options?)\` \u2014 \u30B3\u30DF\u30C3\u30C8
+- \`client.searchRepositories(q, options?)\` / \`client.searchIssues(q, options?)\` \u2014 \u30B5\u30FC\u30C1\uFF0830 req/\u5206\u306E\u5236\u9650\uFF09
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/github";
+
+const gh = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { owner, repo } = await c.req.json<{ owner: string; repo: string }>();
+  const issues = await gh.listIssues(owner, repo, {
+    state: "open",
+    sort: "updated",
+    direction: "desc",
+    per_page: 100,
+  });
+  // GitHub \u306E issues \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306F PR \u3082\u8FD4\u3059\u305F\u3081\u9664\u5916\u3057\u307E\u3059\u3002
+  const onlyIssues = issues.filter((i) => !("pull_request" in i));
+  return c.json({ issues: onlyIssues });
+}
+\`\`\`
+
+### GitHub REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://api.github.com\`\uFF08GitHub Enterprise Server \u306E\u5834\u5408\u306F\u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u5358\u4F4D\u3067\u4E0A\u66F8\u304D\u53EF\u80FD\u3001\u4F8B: \`https://github.example.com/api/v3\`\uFF09
+- \u8A8D\u8A3C: \`Authorization: Bearer <PAT>\`\u3002\u5FC5\u9808\u30D8\u30C3\u30C0\uFF08\u81EA\u52D5\u4ED8\u4E0E\uFF09: \`Accept: application/vnd.github+json\`\u3001\`X-GitHub-Api-Version: 2022-11-28\`\u3001\`User-Agent\`\u3002
+- \u30C8\u30FC\u30AF\u30F3\u306E\u30B9\u30B3\u30FC\u30D7\u6B21\u7B2C\u3067\u53D6\u5F97\u3067\u304D\u308B\u30C7\u30FC\u30BF\u304C\u6C7A\u307E\u308A\u307E\u3059\uFF08\u4F8B: \u30D7\u30E9\u30A4\u30D9\u30FC\u30C8\u30EA\u30DD\u306F \`repo\`\u3001Org \u30E1\u30BF\u60C5\u5831\u306F \`read:org\`\uFF09\u3002fine-grained \u30C8\u30FC\u30AF\u30F3\u306F\u3055\u3089\u306B\u30EA\u30DD\u30B8\u30C8\u30EA\u5358\u4F4D\u3067\u5236\u9650\u3055\u308C\u307E\u3059\u3002
+- \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3: 1\u59CB\u307E\u308A\u306E \`page\` \u3068 \`per_page\`\uFF08\u6700\u5927100\uFF09\u3002\`Link\` \u30EC\u30B9\u30DD\u30F3\u30B9\u30D8\u30C3\u30C0\u306E \`rel="next"\` / \`rel="last"\` \u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \u30EC\u30FC\u30C8\u5236\u9650: \u8A8D\u8A3C\u6E08\u307F REST \u306F 5,000 req/\u6642\u3001\`/search/*\` \u306F 30 req/\u5206\u3002\`X-RateLimit-Remaining\` / \`X-RateLimit-Reset\` \u3092\u53C2\u7167\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+- \u6CE8\u610F\u70B9: \`/repos/{owner}/{repo}/issues\` \u306F Pull Request \u3082\u8FD4\u3057\u307E\u3059\u3002\u30EC\u30B9\u30DD\u30F3\u30B9\u306B \`pull_request\` \u30D5\u30A3\u30FC\u30EB\u30C9\u304C\u542B\u307E\u308C\u3066\u3044\u308B\u5834\u5408\u306F PR \u3067\u3059\u3002Issue \u306E\u307F\u304C\u5FC5\u8981\u306A\u5834\u5408\u306F\u305D\u306E\u30D5\u30A3\u30FC\u30EB\u30C9\u3067\u9664\u5916\u3059\u308B\u304B\u3001\`/repos/{owner}/{repo}/pulls\` \u3092\u76F4\u63A5\u5229\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002
+
+#### \u30EA\u30BD\u30FC\u30B9\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+
+**\u30E6\u30FC\u30B6\u30FC & \u7D44\u7E54**
+- GET \`/user\` \u2014 \u8A8D\u8A3C\u30E6\u30FC\u30B6\u30FC
+- GET \`/users/{username}\` \u2014 \u516C\u958B\u30D7\u30ED\u30D5\u30A1\u30A4\u30EB
+- GET \`/orgs/{org}\` \u2014 \u7D44\u7E54\u30E1\u30BF\u60C5\u5831
+- GET \`/orgs/{org}/members\` \u2014 \u7D44\u7E54\u30E1\u30F3\u30D0\u30FC
+
+**\u30EA\u30DD\u30B8\u30C8\u30EA**
+- GET \`/user/repos?sort=updated\` \u2014 \u30C8\u30FC\u30AF\u30F3\u3067\u53C2\u7167\u53EF\u80FD\u306A\u30EA\u30DD\u30B8\u30C8\u30EA
+- GET \`/orgs/{org}/repos\` \u2014 \u7D44\u7E54\u6240\u6709\u306E\u30EA\u30DD\u30B8\u30C8\u30EA
+- GET \`/repos/{owner}/{repo}\` \u2014 \u30EA\u30DD\u30B8\u30C8\u30EA\u306E\u30E1\u30BF\u60C5\u5831
+- GET \`/repos/{owner}/{repo}/branches\` \u2014 \u30D6\u30E9\u30F3\u30C1\u4E00\u89A7
+- GET \`/repos/{owner}/{repo}/contents/{path}\` \u2014 \u30D5\u30A1\u30A4\u30EB / \u30C7\u30A3\u30EC\u30AF\u30C8\u30EA
+- GET \`/repos/{owner}/{repo}/topics\` \u2014 \u30C8\u30D4\u30C3\u30AF
+
+**Issue**
+- GET \`/repos/{owner}/{repo}/issues?state=open\` \u2014 Issue \u4E00\u89A7\uFF08PR \u3092\u542B\u3080\u70B9\u306B\u6CE8\u610F\uFF09
+- GET \`/repos/{owner}/{repo}/issues/{number}\` \u2014 \u5358\u4E00 Issue
+- POST \`/repos/{owner}/{repo}/issues\` \u2014 \u4F5C\u6210
+- PATCH \`/repos/{owner}/{repo}/issues/{number}\` \u2014 \u66F4\u65B0\uFF08\u30AF\u30ED\u30FC\u30BA: \`{ "state": "closed" }\`\uFF09
+- GET \`/repos/{owner}/{repo}/issues/{number}/comments\` \u2014 \u30B3\u30E1\u30F3\u30C8\u4E00\u89A7
+- POST \`/repos/{owner}/{repo}/issues/{number}/comments\` \u2014 \u30B3\u30E1\u30F3\u30C8\u8FFD\u52A0
+
+**Pull Request**
+- GET \`/repos/{owner}/{repo}/pulls?state=open\` \u2014 PR \u4E00\u89A7
+- GET \`/repos/{owner}/{repo}/pulls/{number}\` \u2014 \u5358\u4E00 PR\uFF08\`mergeable\`, \`mergeable_state\` \u3092\u542B\u3080\uFF09
+- GET \`/repos/{owner}/{repo}/pulls/{number}/files\` \u2014 \u5909\u66F4\u30D5\u30A1\u30A4\u30EB
+- GET \`/repos/{owner}/{repo}/pulls/{number}/commits\` \u2014 PR \u5185\u306E\u30B3\u30DF\u30C3\u30C8
+- GET \`/repos/{owner}/{repo}/pulls/{number}/reviews\` \u2014 \u30EC\u30D3\u30E5\u30FC
+
+**\u30B3\u30DF\u30C3\u30C8 & \u30EA\u30EA\u30FC\u30B9**
+- GET \`/repos/{owner}/{repo}/commits?sha=branch\` \u2014 \u30B3\u30DF\u30C3\u30C8\u4E00\u89A7
+- GET \`/repos/{owner}/{repo}/commits/{ref}\` \u2014 \u5358\u4E00\u30B3\u30DF\u30C3\u30C8\uFF08\u5DEE\u5206\u30FB\u7D71\u8A08\u3042\u308A\uFF09
+- GET \`/repos/{owner}/{repo}/releases\` \u2014 \u30EA\u30EA\u30FC\u30B9\u4E00\u89A7
+- GET \`/repos/{owner}/{repo}/releases/latest\` \u2014 \u6700\u65B0\u30EA\u30EA\u30FC\u30B9
+
+**Actions**
+- GET \`/repos/{owner}/{repo}/actions/runs\` \u2014 \u30EF\u30FC\u30AF\u30D5\u30ED\u30FC\u306E\u5B9F\u884C
+- GET \`/repos/{owner}/{repo}/actions/workflows\` \u2014 \u30EF\u30FC\u30AF\u30D5\u30ED\u30FC\u5B9A\u7FA9
+
+**\u30B5\u30FC\u30C1\uFF08\u30EC\u30FC\u30C8\u5236\u9650\u3042\u308A\uFF09**
+- GET \`/search/repositories?q=topic:react+language:typescript\` \u2014 \u30EA\u30DD\u30B8\u30C8\u30EA
+- GET \`/search/issues?q=is:open+is:pr+repo:foo/bar\` \u2014 Issue / PR
+- GET \`/search/code?q=...+repo:foo/bar\` \u2014 \u30B3\u30FC\u30C9\uFF08\u30C8\u30FC\u30AF\u30F3\u306B \`repo\` \u30B9\u30B3\u30FC\u30D7\u304C\u5FC5\u8981\uFF09
+- GET \`/search/users?q=...\` \u2014 \u30E6\u30FC\u30B6\u30FC
+
+**\u30AF\u30A9\u30FC\u30BF**
+- GET \`/rate_limit\` \u2014 REST / GraphQL / search \u306E\u6B8B\u30EC\u30FC\u30C8\u78BA\u8A8D`
+  },
+  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/github.ts
+var connection = createConnectorSdk(githubConnector, createClient);
+export {
+  connection
+};