@squadbase/vite-server 0.1.3-dev.8 → 0.1.3

package/dist/connectors/gamma.js

@@ -0,0 +1,866 @@
+// ../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/gamma/parameters.ts
+var parameters = {
+  apiKey: new ParameterDefinition({
+    slug: "api-key",
+    name: "Gamma API Key",
+    description: "The Gamma API key for authentication. Generate from Account Settings > API Keys. Requires Pro, Ultra, Teams, or Business plan.",
+    envVarBaseKey: "GAMMA_API_KEY",
+    type: "text",
+    secret: true,
+    required: true
+  })
+};
+
+// ../connectors/src/connectors/gamma/sdk/index.ts
+var BASE_URL = "https://public-api.gamma.app/v1.0";
+function createClient(params) {
+  const apiKey = params[parameters.apiKey.slug];
+  if (!apiKey) {
+    throw new Error(
+      `gamma: missing required parameter: ${parameters.apiKey.slug}`
+    );
+  }
+  function authHeaders(extra) {
+    const headers = new Headers(extra);
+    headers.set("X-API-KEY", apiKey);
+    headers.set("Content-Type", "application/json");
+    return headers;
+  }
+  async function assertOk(res, label) {
+    if (!res.ok) {
+      const body = await res.text().catch(() => "(unreadable body)");
+      throw new Error(
+        `gamma ${label}: ${res.status} ${res.statusText} \u2014 ${body}`
+      );
+    }
+  }
+  return {
+    request(path2, init) {
+      const url = `${BASE_URL}${path2}`;
+      const headers = new Headers(init?.headers);
+      headers.set("X-API-KEY", apiKey);
+      headers.set("Content-Type", "application/json");
+      return fetch(url, { ...init, headers });
+    },
+    async listThemes(options) {
+      const params2 = new URLSearchParams();
+      if (options?.query) params2.set("query", options.query);
+      if (options?.limit) params2.set("limit", String(options.limit));
+      if (options?.after) params2.set("after", options.after);
+      const qs = params2.toString();
+      const res = await fetch(
+        `${BASE_URL}/themes${qs ? `?${qs}` : ""}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listThemes");
+      return await res.json();
+    },
+    async listFolders(options) {
+      const params2 = new URLSearchParams();
+      if (options?.query) params2.set("query", options.query);
+      if (options?.limit) params2.set("limit", String(options.limit));
+      if (options?.after) params2.set("after", options.after);
+      const qs = params2.toString();
+      const res = await fetch(
+        `${BASE_URL}/folders${qs ? `?${qs}` : ""}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "listFolders");
+      return await res.json();
+    },
+    async createGeneration(options) {
+      const res = await fetch(`${BASE_URL}/generations`, {
+        method: "POST",
+        headers: authHeaders(),
+        body: JSON.stringify(options)
+      });
+      await assertOk(res, "createGeneration");
+      return await res.json();
+    },
+    async getGeneration(generationId) {
+      const res = await fetch(
+        `${BASE_URL}/generations/${encodeURIComponent(generationId)}`,
+        { method: "GET", headers: authHeaders() }
+      );
+      await assertOk(res, "getGeneration");
+      return await res.json();
+    },
+    async generateAndWait(options) {
+      const { generationId } = await this.createGeneration(options);
+      const deadline = Date.now() + 3e5;
+      while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, 5e3));
+        const result = await this.getGeneration(generationId);
+        if (result.status === "completed" || result.status === "failed") {
+          return result;
+        }
+      }
+      return {
+        generationId,
+        status: "failed",
+        error: {
+          message: `Generation timed out after 300s`,
+          statusCode: 408
+        }
+      };
+    }
+  };
+}
+
+// ../connectors/src/connector-onboarding.ts
+var ConnectorOnboarding = class {
+  /** Phase 1: Connection setup instructions (optional — some connectors don't need this) */
+  connectionSetupInstructions;
+  /** Phase 2: Data overview instructions */
+  dataOverviewInstructions;
+  constructor(config) {
+    this.connectionSetupInstructions = config.connectionSetupInstructions;
+    this.dataOverviewInstructions = config.dataOverviewInstructions;
+  }
+  getConnectionSetupPrompt(language) {
+    return this.connectionSetupInstructions?.[language] ?? null;
+  }
+  getDataOverviewInstructions(language) {
+    return this.dataOverviewInstructions[language];
+  }
+};
+
+// ../connectors/src/connector-tool.ts
+var ConnectorTool = class {
+  name;
+  description;
+  inputSchema;
+  outputSchema;
+  _execute;
+  constructor(config) {
+    this.name = config.name;
+    this.description = config.description;
+    this.inputSchema = config.inputSchema;
+    this.outputSchema = config.outputSchema;
+    this._execute = config.execute;
+  }
+  createTool(connections, config) {
+    return {
+      description: this.description,
+      inputSchema: this.inputSchema,
+      outputSchema: this.outputSchema,
+      execute: (input) => this._execute(input, connections, config)
+    };
+  }
+};
+
+// ../connectors/src/connector-plugin.ts
+var ConnectorPlugin = class _ConnectorPlugin {
+  slug;
+  authType;
+  name;
+  description;
+  iconUrl;
+  parameters;
+  releaseFlag;
+  proxyPolicy;
+  experimentalAttributes;
+  onboarding;
+  systemPrompt;
+  tools;
+  query;
+  checkConnection;
+  constructor(config) {
+    this.slug = config.slug;
+    this.authType = config.authType;
+    this.name = config.name;
+    this.description = config.description;
+    this.iconUrl = config.iconUrl;
+    this.parameters = config.parameters;
+    this.releaseFlag = config.releaseFlag;
+    this.proxyPolicy = config.proxyPolicy;
+    this.experimentalAttributes = config.experimentalAttributes;
+    this.onboarding = config.onboarding;
+    this.systemPrompt = config.systemPrompt;
+    this.tools = config.tools;
+    this.query = config.query;
+    this.checkConnection = config.checkConnection;
+  }
+  get connectorKey() {
+    return _ConnectorPlugin.deriveKey(this.slug, this.authType);
+  }
+  /**
+   * Create tools for connections that belong to this connector.
+   * Filters connections by connectorKey internally.
+   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   */
+  createTools(connections, config, 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/gamma/setup.ts
+var gammaOnboarding = new ConnectorOnboarding({
+  dataOverviewInstructions: {
+    en: `1. Call gamma_request with GET /themes to list available themes in the workspace
+2. Call gamma_request with GET /folders to list workspace folders
+3. Try generating a simple presentation with gamma_generate: inputText "Sample presentation about AI", textMode "generate", numCards 3`,
+    ja: `1. gamma_request \u3067 GET /themes \u3092\u547C\u3073\u51FA\u3057\u3001\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u3067\u5229\u7528\u53EF\u80FD\u306A\u30C6\u30FC\u30DE\u4E00\u89A7\u3092\u53D6\u5F97
+2. gamma_request \u3067 GET /folders \u3092\u547C\u3073\u51FA\u3057\u3001\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306E\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u3092\u53D6\u5F97
+3. gamma_generate \u3067\u30B7\u30F3\u30D7\u30EB\u306A\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3092\u8A66\u4F5C: inputText "AI\u306B\u3064\u3044\u3066\u306E\u30B5\u30F3\u30D7\u30EB\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3", textMode "generate", numCards 3`
+  }
+});
+
+// ../connectors/src/connectors/gamma/tools/request.ts
+import { z } from "zod";
+var BASE_URL2 = "https://public-api.gamma.app/v1.0";
+var REQUEST_TIMEOUT_MS = 6e4;
+var inputSchema = z.object({
+  toolUseIntent: z.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z.string().describe("ID of the Gamma connection to use"),
+  method: z.enum(["GET", "POST"]).describe("HTTP method. GET for listing resources, POST for creating."),
+  path: z.string().describe(
+    "API path (e.g., '/themes', '/folders', '/generations', '/generations/{generationId}')"
+  ),
+  body: z.record(z.string(), z.unknown()).optional().describe("Request body (JSON) for POST requests")
+});
+var outputSchema = z.discriminatedUnion("success", [
+  z.object({
+    success: z.literal(true),
+    status: z.number(),
+    data: z.unknown()
+  }),
+  z.object({
+    success: z.literal(false),
+    error: z.string()
+  })
+]);
+var requestTool = new ConnectorTool({
+  name: "request",
+  description: `Send authenticated requests to the Gamma REST API.
+Authentication is handled automatically using the API Key (X-API-KEY header).
+Use this tool for listing themes, listing folders, checking generation status, and other read operations.
+For creating presentations/documents, prefer the gamma_generate tool instead.`,
+  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] gamma/${connection2.name}: ${method} ${path2}`
+    );
+    try {
+      const apiKey = parameters.apiKey.getValue(connection2);
+      const url = `${BASE_URL2}${path2}`;
+      const controller = new AbortController();
+      const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+      try {
+        const response = await fetch(url, {
+          method,
+          headers: {
+            "X-API-KEY": apiKey,
+            "Content-Type": "application/json"
+          },
+          body: body ? JSON.stringify(body) : void 0,
+          signal: controller.signal
+        });
+        const data = await response.json();
+        if (!response.ok) {
+          const err = data;
+          const errorMessage = typeof err?.message === "string" ? err.message : typeof err?.error === "string" ? err.error : `HTTP ${response.status} ${response.statusText}`;
+          return { success: false, error: errorMessage };
+        }
+        return { success: true, status: response.status, data };
+      } finally {
+        clearTimeout(timeout);
+      }
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/gamma/tools/generate.ts
+import { z as z2 } from "zod";
+var BASE_URL3 = "https://public-api.gamma.app/v1.0";
+var POLL_INTERVAL_MS = 5e3;
+var MAX_POLL_DURATION_MS = 3e5;
+var inputSchema2 = z2.object({
+  toolUseIntent: z2.string().optional().describe(
+    "Brief description of what you intend to accomplish with this tool call"
+  ),
+  connectionId: z2.string().describe("ID of the Gamma connection to use"),
+  inputText: z2.string().describe(
+    "Content for the generation. Can include text and image URLs. Max ~400,000 characters."
+  ),
+  textMode: z2.enum(["generate", "condense", "preserve"]).describe(
+    "How inputText is modified: 'generate' creates new content from the topic, 'condense' shortens existing text, 'preserve' keeps text as-is."
+  ),
+  format: z2.enum(["presentation", "document", "webpage", "social"]).optional().describe("Type of artifact to create. Defaults to 'presentation'."),
+  numCards: z2.number().int().min(1).max(75).optional().describe("Number of cards/slides. Defaults to 10."),
+  themeId: z2.string().optional().describe(
+    "Theme ID for look and feel. Use gamma_request GET /themes to list available themes."
+  ),
+  tone: z2.string().optional().describe(
+    "Tone/voice of the output (e.g., 'professional', 'casual', 'academic'). Max 500 chars."
+  ),
+  audience: z2.string().optional().describe(
+    "Target audience description (e.g., 'marketing executives'). Max 500 chars."
+  ),
+  language: z2.string().optional().describe("Output language code (e.g., 'en', 'ja'). Defaults to 'en'."),
+  textAmount: z2.enum(["brief", "medium", "detailed", "extensive"]).optional().describe("Text volume per card. Defaults to 'medium'."),
+  imageSource: z2.enum([
+    "aiGenerated",
+    "pictographic",
+    "pexels",
+    "giphy",
+    "webAllImages",
+    "webFreeToUse",
+    "webFreeToUseCommercially",
+    "themeAccent",
+    "placeholder",
+    "noImages"
+  ]).optional().describe("Image source. Defaults to 'aiGenerated'."),
+  additionalInstructions: z2.string().optional().describe(
+    "Additional specifications for content, layout, and aesthetics. Max 5000 chars."
+  ),
+  exportAs: z2.enum(["pdf", "pptx", "png"]).optional().describe("Export file format. If omitted, no export file is generated.")
+});
+var outputSchema2 = z2.discriminatedUnion("success", [
+  z2.object({
+    success: z2.literal(true),
+    generationId: z2.string(),
+    gammaId: z2.string(),
+    gammaUrl: z2.string(),
+    exportUrl: z2.string().optional(),
+    credits: z2.object({
+      deducted: z2.number(),
+      remaining: z2.number()
+    }).optional()
+  }),
+  z2.object({
+    success: z2.literal(false),
+    error: z2.string()
+  })
+]);
+var generateTool = new ConnectorTool({
+  name: "generate",
+  description: `Generate a presentation, document, webpage, or social post using Gamma AI.
+This tool creates the generation, then automatically polls until completion and returns the result URL.
+Use gamma_request GET /themes first if you want to pick a specific theme.
+Gamma does NOT support image uploads. To visualize data, embed raw numbers directly into inputText as structured text (markdown tables, bullet lists with figures) \u2014 Gamma AI will render charts and visuals from the data.`,
+  inputSchema: inputSchema2,
+  outputSchema: outputSchema2,
+  async execute({
+    connectionId,
+    inputText,
+    textMode,
+    format,
+    numCards,
+    themeId,
+    tone,
+    audience,
+    language,
+    textAmount,
+    imageSource,
+    additionalInstructions,
+    exportAs
+  }, connections) {
+    const connection2 = connections.find((c) => c.id === connectionId);
+    if (!connection2) {
+      return {
+        success: false,
+        error: `Connection ${connectionId} not found`
+      };
+    }
+    console.log(
+      `[connector-generate] gamma/${connection2.name}: creating ${format ?? "presentation"}`
+    );
+    try {
+      const apiKey = parameters.apiKey.getValue(connection2);
+      const headers = {
+        "X-API-KEY": apiKey,
+        "Content-Type": "application/json"
+      };
+      const body = {
+        inputText,
+        textMode
+      };
+      if (format) body.format = format;
+      if (numCards) body.numCards = numCards;
+      if (themeId) body.themeId = themeId;
+      if (additionalInstructions)
+        body.additionalInstructions = additionalInstructions;
+      if (exportAs) body.exportAs = exportAs;
+      const textOptions = {};
+      if (tone) textOptions.tone = tone;
+      if (audience) textOptions.audience = audience;
+      if (language) textOptions.language = language;
+      if (textAmount) textOptions.amount = textAmount;
+      if (Object.keys(textOptions).length > 0) body.textOptions = textOptions;
+      if (imageSource) body.imageOptions = { source: imageSource };
+      const createRes = await fetch(`${BASE_URL3}/generations`, {
+        method: "POST",
+        headers,
+        body: JSON.stringify(body)
+      });
+      const createData = await createRes.json();
+      if (!createRes.ok) {
+        const errorMessage = typeof createData?.message === "string" ? createData.message : typeof createData?.error === "string" ? createData.error : `HTTP ${createRes.status} ${createRes.statusText}`;
+        return { success: false, error: errorMessage };
+      }
+      const generationId = createData.generationId;
+      if (!generationId) {
+        return {
+          success: false,
+          error: "No generationId returned from API"
+        };
+      }
+      const deadline = Date.now() + MAX_POLL_DURATION_MS;
+      while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+        const pollRes = await fetch(`${BASE_URL3}/generations/${generationId}`, {
+          method: "GET",
+          headers
+        });
+        const pollData = await pollRes.json();
+        if (!pollRes.ok) {
+          const errorMessage = typeof pollData?.message === "string" ? pollData.message : `Polling failed: HTTP ${pollRes.status}`;
+          return { success: false, error: errorMessage };
+        }
+        const status = pollData.status;
+        if (status === "completed") {
+          return {
+            success: true,
+            generationId,
+            gammaId: pollData.gammaId,
+            gammaUrl: pollData.gammaUrl,
+            exportUrl: pollData.exportUrl || void 0,
+            credits: pollData.credits
+          };
+        }
+        if (status === "failed") {
+          const error = pollData.error;
+          const errorMessage = typeof error?.message === "string" ? error.message : "Generation failed";
+          return { success: false, error: errorMessage };
+        }
+      }
+      return {
+        success: false,
+        error: `Generation timed out after ${MAX_POLL_DURATION_MS / 1e3}s. generationId: ${generationId} \u2014 you can check status with GET /generations/${generationId}`
+      };
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      return { success: false, error: msg };
+    }
+  }
+});
+
+// ../connectors/src/connectors/gamma/index.ts
+var tools = { request: requestTool, generate: generateTool };
+var gammaConnector = new ConnectorPlugin({
+  slug: "gamma",
+  authType: AUTH_TYPES.API_KEY,
+  name: "Gamma",
+  description: "Connect to Gamma for AI-powered presentation, document, webpage, and social post generation.",
+  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/KoMGPpPcgtB9oDYe1OBjS/1ba7eb061c4497106bf6d249866dc471/gamma.svg",
+  parameters,
+  releaseFlag: { dev1: true, dev2: false, prod: false },
+  onboarding: gammaOnboarding,
+  systemPrompt: {
+    en: `### Tools
+
+- \`gamma_request\`: Send authenticated requests to the Gamma REST API. Use for listing themes, folders, and checking generation status. Authentication (X-API-KEY) is configured automatically.
+- \`gamma_generate\`: Generate a presentation, document, webpage, or social post using Gamma AI. This tool handles the full workflow: creates the generation, polls for completion, and returns the result URL. Prefer this over manually calling POST /generations + polling.
+
+### Business Logic
+
+The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT read credentials from environment variables.
+
+SDK methods (client created via \`connection(connectionId)\`):
+- \`client.request(path, init?)\` \u2014 low-level authenticated fetch
+- \`client.listThemes(options?)\` \u2014 list available themes (query, limit, after)
+- \`client.listFolders(options?)\` \u2014 list workspace folders (query, limit, after)
+- \`client.createGeneration(options)\` \u2014 create a generation, returns generationId
+- \`client.getGeneration(generationId)\` \u2014 get generation status and result
+- \`client.generateAndWait(options)\` \u2014 create generation and poll until completion
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/gamma";
+
+const gamma = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { topic, numCards = 5 } = await c.req.json<{
+    topic: string;
+    numCards?: number;
+  }>();
+
+  const result = await gamma.generateAndWait({
+    inputText: topic,
+    textMode: "generate",
+    format: "presentation",
+    numCards,
+  });
+
+  return c.json(result);
+}
+\`\`\`
+
+### Gamma REST API Reference
+
+- Base URL: \`https://public-api.gamma.app/v1.0\`
+- Authentication: X-API-KEY header (handled automatically)
+
+#### Endpoints
+
+- POST \`/generations\` \u2014 Create a generation (presentation, document, webpage, social)
+  - Required: \`inputText\` (string), \`textMode\` ("generate" | "condense" | "preserve")
+  - Optional: \`format\`, \`numCards\`, \`themeId\`, \`textOptions\` (tone, audience, language, amount), \`imageOptions\` (source, model, style), \`additionalInstructions\`, \`exportAs\` (pdf, pptx, png), \`folderIds\`, \`sharingOptions\`
+  - Returns: \`{ generationId }\`
+- GET \`/generations/{generationId}\` \u2014 Poll generation status
+  - Returns: \`{ generationId, status, gammaId?, gammaUrl?, exportUrl?, credits?, error? }\`
+  - Status values: "pending", "completed", "failed"
+  - Poll every 5 seconds until status changes from "pending"
+- GET \`/themes\` \u2014 List available themes (query, limit, after for pagination)
+- GET \`/folders\` \u2014 List workspace folders (query, limit, after for pagination)
+
+#### Generation Formats
+- \`presentation\` \u2014 Slide deck (dimensions: fluid, 16x9, 4x3)
+- \`document\` \u2014 Document (dimensions: fluid, pageless, letter, a4)
+- \`webpage\` \u2014 Web page
+- \`social\` \u2014 Social media post (dimensions: 1x1, 4x5, 9x16)
+
+#### Text Modes
+- \`generate\` \u2014 AI generates new content from the input topic
+- \`condense\` \u2014 AI shortens the provided text
+- \`preserve\` \u2014 Input text is used as-is
+
+#### Image Sources
+- \`aiGenerated\`, \`pictographic\`, \`pexels\`, \`giphy\`, \`webFreeToUseCommercially\`, \`noImages\`, etc.
+
+#### Data Visualization
+Gamma does NOT support uploading images. If you want to visualize data (charts, graphs, tables), embed the raw numbers and data directly into \`inputText\` as structured text (e.g., markdown tables, bullet lists with figures). Gamma AI will render appropriate visual elements from the data. Do NOT generate chart images locally and try to include them \u2014 instead, pass the data values inline so Gamma can create its own visualizations.`,
+    ja: `### \u30C4\u30FC\u30EB
+
+- \`gamma_request\`: Gamma REST API\u306B\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30C6\u30FC\u30DE\u4E00\u89A7\u3001\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u3001\u751F\u6210\u30B9\u30C6\u30FC\u30BF\u30B9\u306E\u78BA\u8A8D\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A8D\u8A3C\uFF08X-API-KEY\uFF09\u306F\u81EA\u52D5\u7684\u306B\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`gamma_generate\`: Gamma AI\u3092\u4F7F\u3063\u3066\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3001\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3001\u30A6\u30A7\u30D6\u30DA\u30FC\u30B8\u3001\u30BD\u30FC\u30B7\u30E3\u30EB\u6295\u7A3F\u3092\u751F\u6210\u3057\u307E\u3059\u3002\u751F\u6210\u306E\u4F5C\u6210\u304B\u3089\u30DD\u30FC\u30EA\u30F3\u30B0\u3001\u7D50\u679CURL\u306E\u8FD4\u5374\u307E\u3067\u4E00\u62EC\u3067\u51E6\u7406\u3057\u307E\u3059\u3002\u624B\u52D5\u3067POST /generations + \u30DD\u30FC\u30EA\u30F3\u30B0\u3059\u308B\u3088\u308A\u3082\u3053\u3061\u3089\u3092\u63A8\u5968\u3057\u307E\u3059\u3002
+
+### Business Logic
+
+\u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u30CF\u30F3\u30C9\u30E9\u5185\u3067\u306F\u30B3\u30CD\u30AF\u30BFSDK\u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u8A8D\u8A3C\u60C5\u5831\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002
+
+SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
+- \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u306E\u8A8D\u8A3C\u4ED8\u304Dfetch
+- \`client.listThemes(options?)\` \u2014 \u30C6\u30FC\u30DE\u4E00\u89A7\u306E\u53D6\u5F97\uFF08query, limit, after\uFF09
+- \`client.listFolders(options?)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u306E\u53D6\u5F97\uFF08query, limit, after\uFF09
+- \`client.createGeneration(options)\` \u2014 \u751F\u6210\u306E\u4F5C\u6210\u3001generationId\u3092\u8FD4\u3059
+- \`client.getGeneration(generationId)\` \u2014 \u751F\u6210\u30B9\u30C6\u30FC\u30BF\u30B9\u3068\u7D50\u679C\u306E\u53D6\u5F97
+- \`client.generateAndWait(options)\` \u2014 \u751F\u6210\u3092\u4F5C\u6210\u3057\u5B8C\u4E86\u307E\u3067\u30DD\u30FC\u30EA\u30F3\u30B0
+
+\`\`\`ts
+import type { Context } from "hono";
+import { connection } from "@squadbase/vite-server/connectors/gamma";
+
+const gamma = connection("<connectionId>");
+
+export default async function handler(c: Context) {
+  const { topic, numCards = 5 } = await c.req.json<{
+    topic: string;
+    numCards?: number;
+  }>();
+
+  const result = await gamma.generateAndWait({
+    inputText: topic,
+    textMode: "generate",
+    format: "presentation",
+    numCards,
+  });
+
+  return c.json(result);
+}
+\`\`\`
+
+### Gamma REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
+
+- \u30D9\u30FC\u30B9URL: \`https://public-api.gamma.app/v1.0\`
+- \u8A8D\u8A3C: X-API-KEY\u30D8\u30C3\u30C0\u30FC\uFF08\u81EA\u52D5\u8A2D\u5B9A\uFF09
+
+#### \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
+
+- POST \`/generations\` \u2014 \u751F\u6210\u306E\u4F5C\u6210\uFF08\u30D7\u30EC\u30BC\u30F3\u30C6\u30FC\u30B7\u30E7\u30F3\u3001\u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\u3001\u30A6\u30A7\u30D6\u30DA\u30FC\u30B8\u3001\u30BD\u30FC\u30B7\u30E3\u30EB\uFF09
+  - \u5FC5\u9808: \`inputText\`\uFF08\u6587\u5B57\u5217\uFF09\u3001\`textMode\`\uFF08"generate" | "condense" | "preserve"\uFF09
+  - \u30AA\u30D7\u30B7\u30E7\u30F3: \`format\`, \`numCards\`, \`themeId\`, \`textOptions\`\uFF08tone, audience, language, amount\uFF09, \`imageOptions\`\uFF08source, model, style\uFF09, \`additionalInstructions\`, \`exportAs\`\uFF08pdf, pptx, png\uFF09, \`folderIds\`, \`sharingOptions\`
+  - \u8FD4\u5374: \`{ generationId }\`
+- GET \`/generations/{generationId}\` \u2014 \u751F\u6210\u30B9\u30C6\u30FC\u30BF\u30B9\u306E\u30DD\u30FC\u30EA\u30F3\u30B0
+  - \u8FD4\u5374: \`{ generationId, status, gammaId?, gammaUrl?, exportUrl?, credits?, error? }\`
+  - \u30B9\u30C6\u30FC\u30BF\u30B9\u5024: "pending", "completed", "failed"
+  - status\u304C"pending"\u3067\u306A\u304F\u306A\u308B\u307E\u30675\u79D2\u3054\u3068\u306B\u30DD\u30FC\u30EA\u30F3\u30B0
+- GET \`/themes\` \u2014 \u30C6\u30FC\u30DE\u4E00\u89A7\uFF08query, limit, after\u3067\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\uFF09
+- GET \`/folders\` \u2014 \u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\uFF08query, limit, after\u3067\u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3\uFF09
+
+#### \u751F\u6210\u30D5\u30A9\u30FC\u30DE\u30C3\u30C8
+- \`presentation\` \u2014 \u30B9\u30E9\u30A4\u30C9\u30C7\u30C3\u30AD\uFF08\u5BF8\u6CD5: fluid, 16x9, 4x3\uFF09
+- \`document\` \u2014 \u30C9\u30AD\u30E5\u30E1\u30F3\u30C8\uFF08\u5BF8\u6CD5: fluid, pageless, letter, a4\uFF09
+- \`webpage\` \u2014 \u30A6\u30A7\u30D6\u30DA\u30FC\u30B8
+- \`social\` \u2014 \u30BD\u30FC\u30B7\u30E3\u30EB\u30E1\u30C7\u30A3\u30A2\u6295\u7A3F\uFF08\u5BF8\u6CD5: 1x1, 4x5, 9x16\uFF09
+
+#### \u30C6\u30AD\u30B9\u30C8\u30E2\u30FC\u30C9
+- \`generate\` \u2014 AI\u304C\u5165\u529B\u30C8\u30D4\u30C3\u30AF\u304B\u3089\u65B0\u3057\u3044\u30B3\u30F3\u30C6\u30F3\u30C4\u3092\u751F\u6210
+- \`condense\` \u2014 AI\u304C\u63D0\u4F9B\u3055\u308C\u305F\u30C6\u30AD\u30B9\u30C8\u3092\u77ED\u7E2E
+- \`preserve\` \u2014 \u5165\u529B\u30C6\u30AD\u30B9\u30C8\u3092\u305D\u306E\u307E\u307E\u4F7F\u7528
+
+#### \u753B\u50CF\u30BD\u30FC\u30B9
+- \`aiGenerated\`, \`pictographic\`, \`pexels\`, \`giphy\`, \`webFreeToUseCommercially\`, \`noImages\` \u306A\u3069
+
+#### \u30C7\u30FC\u30BF\u306E\u53EF\u8996\u5316
+Gamma\u306F\u753B\u50CF\u306E\u30A2\u30C3\u30D7\u30ED\u30FC\u30C9\u306B\u5BFE\u5FDC\u3057\u3066\u3044\u307E\u305B\u3093\u3002\u30C7\u30FC\u30BF\u3092\u53EF\u8996\u5316\u3057\u305F\u3044\u5834\u5408\uFF08\u30C1\u30E3\u30FC\u30C8\u3001\u30B0\u30E9\u30D5\u3001\u30C6\u30FC\u30D6\u30EB\u306A\u3069\uFF09\u306F\u3001\`inputText\` \u306B\u6570\u5024\u3084\u30C7\u30FC\u30BF\u3092\u69CB\u9020\u5316\u30C6\u30AD\u30B9\u30C8\uFF08\u30DE\u30FC\u30AF\u30C0\u30A6\u30F3\u30C6\u30FC\u30D6\u30EB\u3001\u6570\u5024\u4ED8\u304D\u7B87\u6761\u66F8\u304D\u306A\u3069\uFF09\u3068\u3057\u3066\u76F4\u63A5\u57CB\u3081\u8FBC\u3093\u3067\u304F\u3060\u3055\u3044\u3002Gamma AI\u304C\u30C7\u30FC\u30BF\u304B\u3089\u9069\u5207\u306A\u30D3\u30B8\u30E5\u30A2\u30EB\u8981\u7D20\u3092\u751F\u6210\u3057\u307E\u3059\u3002\u30ED\u30FC\u30AB\u30EB\u3067\u30C1\u30E3\u30FC\u30C8\u753B\u50CF\u3092\u751F\u6210\u3057\u3066\u542B\u3081\u308B\u306E\u3067\u306F\u306A\u304F\u3001\u30C7\u30FC\u30BF\u306E\u5024\u3092\u30A4\u30F3\u30E9\u30A4\u30F3\u3067\u6E21\u3057\u3066Gamma\u306B\u53EF\u8996\u5316\u3055\u305B\u3066\u304F\u3060\u3055\u3044\u3002`
+  },
+  tools
+});
+
+// src/connectors/create-connector-sdk.ts
+import { readFileSync } from "fs";
+import path from "path";
+
+// src/connector-client/env.ts
+function resolveEnvVar(entry, key, connectionId) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) {
+    throw new Error(`Connection "${connectionId}" is missing envVars mapping for key "${key}"`);
+  }
+  const value = process.env[envVarName];
+  if (!value) {
+    throw new Error(`Environment variable "${envVarName}" (for connection "${connectionId}", key "${key}") is not set`);
+  }
+  return value;
+}
+function resolveEnvVarOptional(entry, key) {
+  const envVarName = entry.envVars[key];
+  if (!envVarName) return void 0;
+  return process.env[envVarName] || void 0;
+}
+
+// src/connector-client/proxy-fetch.ts
+import { getContext } from "hono/context-storage";
+import { getCookie } from "hono/cookie";
+var APP_SESSION_COOKIE_NAME = "__Host-squadbase-session";
+function createSandboxProxyFetch(connectionId) {
+  return async (input, init) => {
+    const token = process.env.INTERNAL_SQUADBASE_OAUTH_MACHINE_CREDENTIAL;
+    const sandboxId = process.env.INTERNAL_SQUADBASE_SANDBOX_ID;
+    if (!token || !sandboxId) {
+      throw new Error(
+        "Connection proxy is not configured. Please check your deployment settings."
+      );
+    }
+    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const originalMethod = init?.method ?? "GET";
+    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
+    const baseDomain = process.env["SQUADBASE_PREVIEW_BASE_DOMAIN"] ?? "preview.app.squadbase.dev";
+    const proxyUrl = `https://${sandboxId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
+    return fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({
+        url: originalUrl,
+        method: originalMethod,
+        body: originalBody
+      })
+    });
+  };
+}
+function createDeployedAppProxyFetch(connectionId) {
+  const projectId = process.env["SQUADBASE_PROJECT_ID"];
+  if (!projectId) {
+    throw new Error(
+      "Connection proxy is not configured. Please check your deployment settings."
+    );
+  }
+  const baseDomain = process.env["SQUADBASE_APP_BASE_DOMAIN"] ?? "squadbase.app";
+  const proxyUrl = `https://${projectId}.${baseDomain}/_sqcore/connections/${connectionId}/request`;
+  return async (input, init) => {
+    const originalUrl = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+    const originalMethod = init?.method ?? "GET";
+    const originalBody = init?.body ? JSON.parse(init.body) : void 0;
+    const c = getContext();
+    const appSession = getCookie(c, APP_SESSION_COOKIE_NAME);
+    if (!appSession) {
+      throw new Error(
+        "No authentication method available for connection proxy."
+      );
+    }
+    return fetch(proxyUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${appSession}`
+      },
+      body: JSON.stringify({
+        url: originalUrl,
+        method: originalMethod,
+        body: originalBody
+      })
+    });
+  };
+}
+function createProxyFetch(connectionId) {
+  if (process.env.INTERNAL_SQUADBASE_SANDBOX_ID) {
+    return createSandboxProxyFetch(connectionId);
+  }
+  return createDeployedAppProxyFetch(connectionId);
+}
+
+// src/connectors/create-connector-sdk.ts
+function loadConnectionsSync() {
+  const filePath = process.env.CONNECTIONS_PATH ?? path.join(process.cwd(), ".squadbase/connections.json");
+  try {
+    const raw = readFileSync(filePath, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function createConnectorSdk(plugin, createClient2) {
+  return (connectionId) => {
+    const connections = loadConnectionsSync();
+    const entry = connections[connectionId];
+    if (!entry) {
+      throw new Error(
+        `Connection "${connectionId}" not found in .squadbase/connections.json`
+      );
+    }
+    if (entry.connector.slug !== plugin.slug) {
+      throw new Error(
+        `Connection "${connectionId}" is not a ${plugin.slug} connection (got "${entry.connector.slug}")`
+      );
+    }
+    const params = {};
+    for (const param of Object.values(plugin.parameters)) {
+      if (param.required) {
+        params[param.slug] = resolveEnvVar(entry, param.slug, connectionId);
+      } else {
+        const val = resolveEnvVarOptional(entry, param.slug);
+        if (val !== void 0) params[param.slug] = val;
+      }
+    }
+    return createClient2(params, createProxyFetch(connectionId));
+  };
+}
+
+// src/connectors/entries/gamma.ts
+var connection = createConnectorSdk(gammaConnector, createClient);
+export {
+  connection
+};