@squadbase/vite-server 0.1.17-dev.24af54e → 0.1.17-dev.423ee34

package/dist/connectors/google-analytics-oauth.js

@@ -16,6 +16,7 @@ var init_parameter_definition = __esm({
       type;
       secret;
       required;
+      isDeprecated;
       constructor(config) {
         this.slug = config.slug;
         this.name = config.name;
@@ -24,6 +25,7 @@ var init_parameter_definition = __esm({
         this.type = config.type;
         this.secret = config.secret;
         this.required = config.required;
+        this.isDeprecated = config.isDeprecated ?? false;
       }
       /**
        * Get the parameter value from a ConnectorConnectionObject.
@@ -253,7 +255,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
   /**
    * Create tools for connections that belong to this connector.
    * Filters connections by connectorKey internally.
-   * Returns tools keyed as `${connectorKey}_${toolName}`.
+   * Returns tools keyed as `connector_${connectorKey}_${toolName}`.
    */
   createTools(connections, config, opts) {
     const myConnections = connections.filter(
@@ -263,7 +265,7 @@ var ConnectorPlugin = class _ConnectorPlugin {
     for (const t of Object.values(this.tools)) {
       const tool = t.createTool(myConnections, config);
       const originalToModelOutput = tool.toModelOutput;
-      result[`${this.connectorKey}_${t.name}`] = {
+      result[`connector_${this.connectorKey}_${t.name}`] = {
         ...tool,
         toModelOutput: async (options) => {
           if (!originalToModelOutput) {
@@ -319,19 +321,34 @@ async function runSetupFlow(flow, params, ctx, config) {
   };
   let state = flow.initialState();
   let answerIdx = 0;
+  const pendingParameterUpdates = [];
   for (const step of flow.steps) {
     const ans = ctx.answers[answerIdx];
     if (ans && ans.questionSlug === step.slug) {
       state = step.applyAnswer(state, ans.answer);
+      if (step.toParameterUpdates) {
+        pendingParameterUpdates.push(...step.toParameterUpdates(state));
+      }
       answerIdx += 1;
       continue;
     }
+    const resolvedAllowFreeText = step.allowFreeText !== void 0 ? step.allowFreeText : true;
     if (step.type === "text") {
+      if (step.fetchOptions) {
+        const options2 = await step.fetchOptions(state, runtime);
+        if (options2.length === 0) {
+          continue;
+        }
+      }
       return {
         type: "nextQuestion",
         questionSlug: step.slug,
         question: step.question[ctx.language],
-        questionType: "text"
+        questionType: "text",
+        allowFreeText: resolvedAllowFreeText,
+        ...pendingParameterUpdates.length > 0 && {
+          parameterUpdates: pendingParameterUpdates
+        }
       };
     }
     const options = step.fetchOptions ? await step.fetchOptions(state, runtime) : [];
@@ -343,11 +360,21 @@ async function runSetupFlow(flow, params, ctx, config) {
       questionSlug: step.slug,
       question: step.question[ctx.language],
       questionType: step.type,
-      options
+      options,
+      allowFreeText: resolvedAllowFreeText,
+      ...pendingParameterUpdates.length > 0 && {
+        parameterUpdates: pendingParameterUpdates
+      }
     };
   }
   const dataInvestigationResult = await flow.finalize(state, runtime);
-  return { type: "fulfilled", dataInvestigationResult };
+  return {
+    type: "fulfilled",
+    dataInvestigationResult,
+    ...pendingParameterUpdates.length > 0 && {
+      parameterUpdates: pendingParameterUpdates
+    }
+  };
 }
 async function resolveSetupSelection(params) {
   const { selected, allSentinel, fetchAll, limit } = params;
@@ -638,15 +665,16 @@ var googleAnalyticsOauthOnboarding = new ConnectorOnboarding({
 - Write only 1 sentence between tool calls, then immediately call the next tool. Skip unnecessary explanations and proceed efficiently`
   },
   dataOverviewInstructions: {
-    en: `1. Call google-analytics-oauth_request with GET properties/{propertyId}/metadata to list available dimensions and metrics
-2. Call google-analytics-oauth_request with POST properties/{propertyId}:runReport using a small date range and basic metrics to verify data availability`,
-    ja: `1. google-analytics-oauth_request \u3067 GET properties/{propertyId}/metadata \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30C7\u30A3\u30E1\u30F3\u30B7\u30E7\u30F3\u3068\u30E1\u30C8\u30EA\u30AF\u30B9\u306E\u4E00\u89A7\u3092\u53D6\u5F97
-2. google-analytics-oauth_request \u3067 POST properties/{propertyId}:runReport \u3092\u77ED\u3044\u671F\u9593\u3068\u57FA\u672C\u30E1\u30C8\u30EA\u30AF\u30B9\u3067\u547C\u3073\u51FA\u3057\u3001\u30C7\u30FC\u30BF\u306E\u53EF\u7528\u6027\u3092\u78BA\u8A8D`
+    en: `1. Call connector_google-analytics-oauth_request with GET properties/{propertyId}/metadata to list available dimensions and metrics
+2. Call connector_google-analytics-oauth_request with POST properties/{propertyId}:runReport using a small date range and basic metrics to verify data availability`,
+    ja: `1. connector_google-analytics-oauth_request \u3067 GET properties/{propertyId}/metadata \u3092\u547C\u3073\u51FA\u3057\u3001\u5229\u7528\u53EF\u80FD\u306A\u30C7\u30A3\u30E1\u30F3\u30B7\u30E7\u30F3\u3068\u30E1\u30C8\u30EA\u30AF\u30B9\u306E\u4E00\u89A7\u3092\u53D6\u5F97
+2. connector_google-analytics-oauth_request \u3067 POST properties/{propertyId}:runReport \u3092\u77ED\u3044\u671F\u9593\u3068\u57FA\u672C\u30E1\u30C8\u30EA\u30AF\u30B9\u3067\u547C\u3073\u51FA\u3057\u3001\u30C7\u30FC\u30BF\u306E\u53EF\u7528\u6027\u3092\u78BA\u8A8D`
   }
 });
 
 // ../connectors/src/connectors/google-analytics-oauth/setup-flow.ts
 var ADMIN_BASE_URL3 = "https://analyticsadmin.googleapis.com/v1beta";
+var DATA_BASE_URL = "https://analyticsdata.googleapis.com/v1beta";
 var ALL_PROPERTIES = "__ALL_PROPERTIES__";
 var GOOGLE_ANALYTICS_OAUTH_SETUP_MAX_PROPERTIES = 20;
 async function listAccountSummaries(proxyFetch) {
@@ -677,6 +705,44 @@ async function getProperty(proxyFetch, propertyId) {
   if (!res.ok) return null;
   return await res.json();
 }
+async function getMetadata(proxyFetch, propertyId) {
+  try {
+    const res = await proxyFetch(
+      `${DATA_BASE_URL}/properties/${propertyId}/metadata`,
+      { method: "GET" }
+    );
+    if (!res.ok) return { dimensions: [], metrics: [] };
+    const data = await res.json();
+    return {
+      dimensions: data.dimensions ?? [],
+      metrics: data.metrics ?? []
+    };
+  } catch {
+    return { dimensions: [], metrics: [] };
+  }
+}
+async function runSampleReport(proxyFetch, propertyId, dimensions, metrics, limit) {
+  try {
+    const res = await proxyFetch(
+      `${DATA_BASE_URL}/properties/${propertyId}:runReport`,
+      {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          dateRanges: [{ startDate: "28daysAgo", endDate: "today" }],
+          dimensions: dimensions.map((name) => ({ name })),
+          metrics: metrics.map((name) => ({ name })),
+          limit
+        })
+      }
+    );
+    if (!res.ok) return [];
+    const data = await res.json();
+    return data.rows ?? [];
+  } catch {
+    return [];
+  }
+}
 var googleAnalyticsOauthSetupFlow = {
   initialState: () => ({}),
   steps: [
@@ -760,23 +826,111 @@ var googleAnalyticsOauthSetupFlow = {
       sections.push("_No properties selected._", "");
       return sections.join("\n");
     }
-    sections.push(
-      "| Property ID | Display Name | Time Zone | Currency | Industry |"
-    );
-    sections.push(
-      "|-------------|--------------|-----------|----------|----------|"
-    );
     for (const propertyId of targetPropertyIds) {
       const prop = await getProperty(rt.config.proxyFetch, propertyId);
-      const displayName = (prop?.displayName ?? "-").replace(/\|/g, "\\|");
-      const timeZone = prop?.timeZone ?? "-";
-      const currency = prop?.currencyCode ?? "-";
-      const industry = (prop?.industryCategory ?? "-").replace(/\|/g, "\\|");
-      sections.push(
-        `| ${propertyId} | ${displayName} | ${timeZone} | ${currency} | ${industry} |`
+      const displayName = prop?.displayName ?? propertyId;
+      sections.push(`### Property: ${displayName} (${propertyId})`, "");
+      if (prop?.timeZone || prop?.currencyCode || prop?.industryCategory) {
+        const details = [];
+        if (prop.timeZone) details.push(`Time Zone: ${prop.timeZone}`);
+        if (prop.currencyCode) details.push(`Currency: ${prop.currencyCode}`);
+        if (prop.industryCategory)
+          details.push(`Industry: ${prop.industryCategory}`);
+        sections.push(details.join(" | "), "");
+      }
+      const metadata = await getMetadata(rt.config.proxyFetch, propertyId);
+      if (metadata.dimensions.length > 0) {
+        const categories = /* @__PURE__ */ new Map();
+        for (const d of metadata.dimensions) {
+          const cat = d.category || "Other";
+          if (!categories.has(cat)) categories.set(cat, []);
+          categories.get(cat).push(d.uiName ?? d.apiName ?? "");
+        }
+        sections.push("#### Available Dimensions", "");
+        for (const [cat, dims] of categories) {
+          sections.push(
+            `- **${cat}**: ${dims.slice(0, 10).join(", ")}${dims.length > 10 ? ` \u2026+${dims.length - 10}` : ""}`
+          );
+        }
+        sections.push("");
+      }
+      if (metadata.metrics.length > 0) {
+        const categories = /* @__PURE__ */ new Map();
+        for (const m of metadata.metrics) {
+          const cat = m.category || "Other";
+          if (!categories.has(cat)) categories.set(cat, []);
+          categories.get(cat).push(m.uiName ?? m.apiName ?? "");
+        }
+        sections.push("#### Available Metrics", "");
+        for (const [cat, mets] of categories) {
+          sections.push(
+            `- **${cat}**: ${mets.slice(0, 10).join(", ")}${mets.length > 10 ? ` \u2026+${mets.length - 10}` : ""}`
+          );
+        }
+        sections.push("");
+      }
+      const trafficRows = await runSampleReport(
+        rt.config.proxyFetch,
+        propertyId,
+        ["date"],
+        ["sessions", "activeUsers", "screenPageViews"],
+        7
+      );
+      if (trafficRows.length > 0) {
+        sections.push("#### Traffic Summary (last 28 days, by date)", "");
+        sections.push("| Date | Sessions | Active Users | Page Views |");
+        sections.push("|------|----------|-------------|------------|");
+        for (const row of trafficRows) {
+          const d = row.dimensionValues?.[0]?.value ?? "";
+          const s = row.metricValues?.[0]?.value ?? "0";
+          const u = row.metricValues?.[1]?.value ?? "0";
+          const p = row.metricValues?.[2]?.value ?? "0";
+          sections.push(`| ${d} | ${s} | ${u} | ${p} |`);
+        }
+        sections.push("");
+      }
+      const channelRows = await runSampleReport(
+        rt.config.proxyFetch,
+        propertyId,
+        ["sessionDefaultChannelGroup"],
+        ["sessions", "activeUsers"],
+        10
       );
+      if (channelRows.length > 0) {
+        sections.push("#### Top Channels (last 28 days)", "");
+        sections.push("| Channel | Sessions | Active Users |");
+        sections.push("|---------|----------|-------------|");
+        for (const row of channelRows) {
+          const ch = row.dimensionValues?.[0]?.value ?? "";
+          const s = row.metricValues?.[0]?.value ?? "0";
+          const u = row.metricValues?.[1]?.value ?? "0";
+          sections.push(`| ${ch} | ${s} | ${u} |`);
+        }
+        sections.push("");
+      }
+      const pageRows = await runSampleReport(
+        rt.config.proxyFetch,
+        propertyId,
+        ["pagePath"],
+        ["screenPageViews", "activeUsers"],
+        10
+      );
+      if (pageRows.length > 0) {
+        sections.push("#### Top Pages (last 28 days)", "");
+        sections.push("| Page Path | Page Views | Active Users |");
+        sections.push("|-----------|------------|-------------|");
+        for (const row of pageRows) {
+          const pg = (row.dimensionValues?.[0]?.value ?? "").replace(
+            /\|/g,
+            "\\|"
+          );
+          const v = row.metricValues?.[0]?.value ?? "0";
+          const u = row.metricValues?.[1]?.value ?? "0";
+          sections.push(`| ${pg} | ${v} | ${u} |`);
+        }
+        sections.push("");
+      }
     }
-    sections.push("");
     return sections.join("\n");
   }
 };
@@ -929,9 +1083,9 @@ var googleAnalyticsOauthConnector = new ConnectorPlugin({
   systemPrompt: {
     en: `### Tools
 
-- \`google-analytics-oauth_request\`: Send authenticated requests to the GA4 Data API. Use it for running reports, getting metadata, and realtime reports. The {propertyId} placeholder in paths is automatically replaced. Authentication is configured automatically via OAuth.
-- \`google-analytics-oauth_listAccounts\`: List accessible Google Analytics accounts. Use during setup to discover available accounts.
-- \`google-analytics-oauth_listProperties\`: List GA4 properties for a given account. Use during setup to select the target property.
+- \`connector_google-analytics-oauth_request\`: Send authenticated requests to the GA4 Data API. Use it for running reports, getting metadata, and realtime reports. The {propertyId} placeholder in paths is automatically replaced. Authentication is configured automatically via OAuth.
+- \`connector_google-analytics-oauth_listAccounts\`: List accessible Google Analytics accounts. Use during setup to discover available accounts.
+- \`connector_google-analytics-oauth_listProperties\`: List GA4 properties for a given account. Use during setup to select the target property.
 
 ### GA4 Data API Reference
 
@@ -1001,9 +1155,9 @@ const realtime = await ga.runRealtimeReport({
 \`\`\``,
     ja: `### \u30C4\u30FC\u30EB
 
-- \`google-analytics-oauth_request\`: GA4 Data API\u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3001\u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{propertyId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
-- \`google-analytics-oauth_listAccounts\`: \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Analytics\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u5229\u7528\u53EF\u80FD\u306A\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u78BA\u8A8D\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
-- \`google-analytics-oauth_listProperties\`: \u6307\u5B9A\u30A2\u30AB\u30A6\u30F3\u30C8\u306EGA4\u30D7\u30ED\u30D1\u30C6\u30A3\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u30BF\u30FC\u30B2\u30C3\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u9078\u629E\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
+- \`connector_google-analytics-oauth_request\`: GA4 Data API\u3078\u8A8D\u8A3C\u6E08\u307F\u30EA\u30AF\u30A8\u30B9\u30C8\u3092\u9001\u4FE1\u3057\u307E\u3059\u3002\u30EC\u30DD\u30FC\u30C8\u306E\u5B9F\u884C\u3001\u30E1\u30BF\u30C7\u30FC\u30BF\u306E\u53D6\u5F97\u3001\u30EA\u30A2\u30EB\u30BF\u30A4\u30E0\u30EC\u30DD\u30FC\u30C8\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306E{propertyId}\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u306F\u81EA\u52D5\u7684\u306B\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002OAuth\u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
+- \`connector_google-analytics-oauth_listAccounts\`: \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306AGoogle Analytics\u30A2\u30AB\u30A6\u30F3\u30C8\u306E\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u5229\u7528\u53EF\u80FD\u306A\u30A2\u30AB\u30A6\u30F3\u30C8\u3092\u78BA\u8A8D\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
+- \`connector_google-analytics-oauth_listProperties\`: \u6307\u5B9A\u30A2\u30AB\u30A6\u30F3\u30C8\u306EGA4\u30D7\u30ED\u30D1\u30C6\u30A3\u4E00\u89A7\u3092\u53D6\u5F97\u3057\u307E\u3059\u3002\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u6642\u306B\u30BF\u30FC\u30B2\u30C3\u30C8\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u9078\u629E\u3059\u308B\u305F\u3081\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002
 
 ### GA4 Data API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9