@squadbase/vite-server 0.1.10 → 0.1.12-dev.8860f37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli/index.js CHANGED
@@ -438,6 +438,37 @@ import { z } from "zod";
438
438
 
439
439
  // ../connectors/src/connectors/snowflake/utils.ts
440
440
  import crypto from "crypto";
441
+
442
+ // ../connectors/src/lib/approx-bytes.ts
443
+ function approxBytes(value, acc, limit) {
444
+ if (acc > limit) return acc;
445
+ if (value == null) return acc;
446
+ const t = typeof value;
447
+ if (t === "string") return acc + value.length;
448
+ if (t === "number" || t === "boolean") return acc + 8;
449
+ if (t === "bigint") return acc + 16;
450
+ if (value instanceof Date) return acc + 8;
451
+ if (Buffer.isBuffer(value)) return acc + value.byteLength;
452
+ if (Array.isArray(value)) {
453
+ for (const item of value) {
454
+ acc = approxBytes(item, acc, limit);
455
+ if (acc > limit) return acc;
456
+ }
457
+ return acc;
458
+ }
459
+ if (t === "object") {
460
+ const obj = value;
461
+ for (const k in obj) {
462
+ acc += k.length;
463
+ acc = approxBytes(obj[k], acc, limit);
464
+ if (acc > limit) return acc;
465
+ }
466
+ return acc;
467
+ }
468
+ return acc;
469
+ }
470
+
471
+ // ../connectors/src/connectors/snowflake/utils.ts
441
472
  function decryptPrivateKey(pem, passphrase) {
442
473
  if (!passphrase) return pem;
443
474
  return crypto.createPrivateKey({
@@ -446,10 +477,46 @@ function decryptPrivateKey(pem, passphrase) {
446
477
  passphrase
447
478
  }).export({ type: "pkcs8", format: "pem" });
448
479
  }
480
+ async function executeWithSizeLimit(conn, sql, options) {
481
+ const rows = [];
482
+ let acc = 0;
483
+ let exceeded = false;
484
+ await new Promise((resolve, reject) => {
485
+ const stmt = conn.execute({
486
+ sqlText: sql,
487
+ streamResult: true
488
+ });
489
+ const stream = stmt.streamRows();
490
+ stream.on("data", (row) => {
491
+ if (exceeded) return;
492
+ acc = approxBytes(row, acc, options.maxBytes);
493
+ if (acc > options.maxBytes) {
494
+ exceeded = true;
495
+ stream.destroy();
496
+ stmt.cancel(() => {
497
+ });
498
+ resolve();
499
+ return;
500
+ }
501
+ rows.push(row);
502
+ });
503
+ stream.on("end", () => {
504
+ resolve();
505
+ });
506
+ stream.on("error", (err) => {
507
+ if (exceeded) return;
508
+ reject(new Error(`Snowflake query failed: ${err.message}`));
509
+ });
510
+ });
511
+ if (exceeded) {
512
+ return { exceeded: true };
513
+ }
514
+ return { exceeded: false, rows };
515
+ }
449
516
 
450
517
  // ../connectors/src/connectors/snowflake/tools/execute-query.ts
451
- var MAX_ROWS = 500;
452
- var QUERY_TIMEOUT_MS = 6e4;
518
+ var MAX_RESULT_BYTES = 5 * 1024 * 1024;
519
+ var STATEMENT_TIMEOUT_SECONDS = 60;
453
520
  var inputSchema = z.object({
454
521
  toolUseIntent: z.string().optional().describe(
455
522
  "Brief description of what you intend to accomplish with this tool call"
@@ -463,7 +530,6 @@ var outputSchema = z.discriminatedUnion("success", [
463
530
  z.object({
464
531
  success: z.literal(true),
465
532
  rowCount: z.number(),
466
- truncated: z.boolean(),
467
533
  rows: z.array(z.record(z.string(), z.unknown()))
468
534
  }),
469
535
  z.object({
@@ -473,9 +539,12 @@ var outputSchema = z.discriminatedUnion("success", [
473
539
  ]);
474
540
  var executeQueryTool = new ConnectorTool({
475
541
  name: "executeQuery",
476
- description: `Execute SQL against Snowflake. Returns up to ${MAX_ROWS} rows.
477
- Use for: schema exploration (SHOW DATABASES/SCHEMAS/TABLES, DESCRIBE TABLE, INFORMATION_SCHEMA), data sampling, analytical queries.
478
- Avoid loading large amounts of data; always include LIMIT in queries.`,
542
+ description: `Execute SQL against Snowflake. Results are streamed; if the approximate result size exceeds 5MB the call fails with an explicit error and you must retry with a smaller query (add LIMIT, wrap wide text columns with SUBSTR, or aggregate inside Snowflake).
543
+ Use for: schema exploration (SHOW DATABASES/SCHEMAS/TABLES, DESCRIBE TABLE, INFORMATION_SCHEMA), sampling (LIMIT, SAMPLE), and analytical queries.
544
+ Memory guidance:
545
+ - Avoid SELECT * on tables with long text columns (logs, JSON, concatenated text). Project only the columns you need; truncate wide text with SUBSTR(col, 1, N).
546
+ - For full-dataset analysis, do the aggregation inside Snowflake (COUNT, SUM, GROUP BY, APPROX_TOP_K, HISTOGRAM) instead of returning raw rows.
547
+ - Exploration is iterative: start with a small LIMIT to inspect shape, then refine.`,
479
548
  inputSchema,
480
549
  outputSchema,
481
550
  async execute({ connectionId, sql }, connections) {
@@ -517,39 +586,43 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
517
586
  else resolve();
518
587
  });
519
588
  });
520
- const allRows = await new Promise(
521
- (resolve, reject) => {
522
- const timeoutId = setTimeout(() => {
523
- reject(
524
- new Error(
525
- "Snowflake query timeout: query exceeded 60 seconds"
526
- )
527
- );
528
- }, QUERY_TIMEOUT_MS);
589
+ try {
590
+ await new Promise((resolve, reject) => {
529
591
  conn.execute({
530
- sqlText: sql,
531
- complete: (err, _stmt, rows) => {
532
- clearTimeout(timeoutId);
592
+ sqlText: `ALTER SESSION SET STATEMENT_TIMEOUT_IN_SECONDS = ${STATEMENT_TIMEOUT_SECONDS}`,
593
+ complete: (err) => {
533
594
  if (err)
534
- reject(new Error(`Snowflake query failed: ${err.message}`));
535
- else resolve(rows ?? []);
595
+ reject(
596
+ new Error(
597
+ `Failed to set Snowflake statement timeout: ${err.message}`
598
+ )
599
+ );
600
+ else resolve();
536
601
  }
537
602
  });
603
+ });
604
+ const result = await executeWithSizeLimit(conn, sql, {
605
+ maxBytes: MAX_RESULT_BYTES
606
+ });
607
+ if (result.exceeded) {
608
+ return {
609
+ success: false,
610
+ error: "Result size exceeded 5MB. Reduce the query: add LIMIT, wrap wide text columns with SUBSTR(col, 1, N), or aggregate inside Snowflake (COUNT/SUM/GROUP BY)."
611
+ };
538
612
  }
539
- );
540
- conn.destroy((err) => {
541
- if (err)
542
- console.warn(
543
- `[connector-query] Snowflake destroy error: ${err.message}`
544
- );
545
- });
546
- const truncated = allRows.length > MAX_ROWS;
547
- return {
548
- success: true,
549
- rowCount: Math.min(allRows.length, MAX_ROWS),
550
- truncated,
551
- rows: allRows.slice(0, MAX_ROWS)
552
- };
613
+ return {
614
+ success: true,
615
+ rowCount: result.rows.length,
616
+ rows: result.rows
617
+ };
618
+ } finally {
619
+ conn.destroy((err) => {
620
+ if (err)
621
+ console.warn(
622
+ `[connector-query] Snowflake destroy error: ${err.message}`
623
+ );
624
+ });
625
+ }
553
626
  } catch (err) {
554
627
  const msg = err instanceof Error ? err.message : String(err);
555
628
  return { success: false, error: msg };
@@ -738,8 +811,8 @@ var parameters2 = {
738
811
 
739
812
  // ../connectors/src/connectors/snowflake-pat/tools/execute-query.ts
740
813
  import { z as z2 } from "zod";
741
- var MAX_ROWS2 = 500;
742
- var QUERY_TIMEOUT_MS2 = 6e4;
814
+ var MAX_ROWS = 500;
815
+ var QUERY_TIMEOUT_MS = 6e4;
743
816
  var inputSchema2 = z2.object({
744
817
  toolUseIntent: z2.string().optional().describe(
745
818
  "Brief description of what you intend to accomplish with this tool call"
@@ -763,7 +836,7 @@ var outputSchema2 = z2.discriminatedUnion("success", [
763
836
  ]);
764
837
  var executeQueryTool2 = new ConnectorTool({
765
838
  name: "executeQuery",
766
- description: `Execute SQL against Snowflake. Returns up to ${MAX_ROWS2} rows.
839
+ description: `Execute SQL against Snowflake. Returns up to ${MAX_ROWS} rows.
767
840
  Use for: schema exploration (SHOW DATABASES/SCHEMAS/TABLES, DESCRIBE TABLE, INFORMATION_SCHEMA), data sampling, analytical queries.
768
841
  Avoid loading large amounts of data; always include LIMIT in queries.`,
769
842
  inputSchema: inputSchema2,
@@ -809,7 +882,7 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
809
882
  "Snowflake query timeout: query exceeded 60 seconds"
810
883
  )
811
884
  );
812
- }, QUERY_TIMEOUT_MS2);
885
+ }, QUERY_TIMEOUT_MS);
813
886
  conn.execute({
814
887
  sqlText: sql,
815
888
  complete: (err, _stmt, rows) => {
@@ -827,12 +900,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
827
900
  `[connector-query] Snowflake destroy error: ${err.message}`
828
901
  );
829
902
  });
830
- const truncated = allRows.length > MAX_ROWS2;
903
+ const truncated = allRows.length > MAX_ROWS;
831
904
  return {
832
905
  success: true,
833
- rowCount: Math.min(allRows.length, MAX_ROWS2),
906
+ rowCount: Math.min(allRows.length, MAX_ROWS),
834
907
  truncated,
835
- rows: allRows.slice(0, MAX_ROWS2)
908
+ rows: allRows.slice(0, MAX_ROWS)
836
909
  };
837
910
  } catch (err) {
838
911
  const msg = err instanceof Error ? err.message : String(err);
@@ -1166,7 +1239,7 @@ var POSTGRES_DEFAULT_PORT = 5432;
1166
1239
 
1167
1240
  // ../connectors/src/connectors/postgresql/tools/execute-query.ts
1168
1241
  import { z as z3 } from "zod";
1169
- var MAX_ROWS3 = 500;
1242
+ var MAX_ROWS2 = 500;
1170
1243
  var CONNECT_TIMEOUT_MS = 1e4;
1171
1244
  var STATEMENT_TIMEOUT_MS = 6e4;
1172
1245
  var inputSchema3 = z3.object({
@@ -1190,7 +1263,7 @@ var outputSchema3 = z3.discriminatedUnion("success", [
1190
1263
  ]);
1191
1264
  var executeQueryTool3 = new ConnectorTool({
1192
1265
  name: "executeQuery",
1193
- description: `Execute SQL against PostgreSQL. Returns up to ${MAX_ROWS3} rows.
1266
+ description: `Execute SQL against PostgreSQL. Returns up to ${MAX_ROWS2} rows.
1194
1267
  Use for: schema exploration (information_schema), data sampling, analytical queries.
1195
1268
  Avoid loading large amounts of data; always include LIMIT in queries.`,
1196
1269
  inputSchema: inputSchema3,
@@ -1228,12 +1301,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
1228
1301
  STATEMENT_TIMEOUT_MS
1229
1302
  );
1230
1303
  const rows = result.rows;
1231
- const truncated = rows.length > MAX_ROWS3;
1304
+ const truncated = rows.length > MAX_ROWS2;
1232
1305
  return {
1233
1306
  success: true,
1234
- rowCount: Math.min(rows.length, MAX_ROWS3),
1307
+ rowCount: Math.min(rows.length, MAX_ROWS2),
1235
1308
  truncated,
1236
- rows: rows.slice(0, MAX_ROWS3)
1309
+ rows: rows.slice(0, MAX_ROWS2)
1237
1310
  };
1238
1311
  } finally {
1239
1312
  await pool.end();
@@ -1370,9 +1443,9 @@ var MYSQL_DEFAULT_PORT = 3306;
1370
1443
 
1371
1444
  // ../connectors/src/connectors/mysql/tools/execute-query.ts
1372
1445
  import { z as z4 } from "zod";
1373
- var MAX_ROWS4 = 500;
1446
+ var MAX_ROWS3 = 500;
1374
1447
  var CONNECT_TIMEOUT_MS2 = 1e4;
1375
- var QUERY_TIMEOUT_MS3 = 6e4;
1448
+ var QUERY_TIMEOUT_MS2 = 6e4;
1376
1449
  var inputSchema4 = z4.object({
1377
1450
  toolUseIntent: z4.string().optional().describe(
1378
1451
  "Brief description of what you intend to accomplish with this tool call"
@@ -1394,7 +1467,7 @@ var outputSchema4 = z4.discriminatedUnion("success", [
1394
1467
  ]);
1395
1468
  var executeQueryTool4 = new ConnectorTool({
1396
1469
  name: "executeQuery",
1397
- description: `Execute SQL against MySQL. Returns up to ${MAX_ROWS4} rows.
1470
+ description: `Execute SQL against MySQL. Returns up to ${MAX_ROWS3} rows.
1398
1471
  Use for: schema exploration (information_schema), data sampling, analytical queries.
1399
1472
  Avoid loading large amounts of data; always include LIMIT in queries.`,
1400
1473
  inputSchema: inputSchema4,
@@ -1427,16 +1500,16 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
1427
1500
  try {
1428
1501
  const queryPromise = pool.query(sql);
1429
1502
  const timeoutPromise = new Promise(
1430
- (_, reject) => setTimeout(() => reject(new Error("Query timed out after 60 seconds")), QUERY_TIMEOUT_MS3)
1503
+ (_, reject) => setTimeout(() => reject(new Error("Query timed out after 60 seconds")), QUERY_TIMEOUT_MS2)
1431
1504
  );
1432
1505
  const [rows] = await Promise.race([queryPromise, timeoutPromise]);
1433
1506
  const resultRows = Array.isArray(rows) ? rows : [];
1434
- const truncated = resultRows.length > MAX_ROWS4;
1507
+ const truncated = resultRows.length > MAX_ROWS3;
1435
1508
  return {
1436
1509
  success: true,
1437
- rowCount: Math.min(resultRows.length, MAX_ROWS4),
1510
+ rowCount: Math.min(resultRows.length, MAX_ROWS3),
1438
1511
  truncated,
1439
- rows: resultRows.slice(0, MAX_ROWS4)
1512
+ rows: resultRows.slice(0, MAX_ROWS3)
1440
1513
  };
1441
1514
  } finally {
1442
1515
  await pool.end();
@@ -1763,7 +1836,7 @@ var bigqueryOnboarding = new ConnectorOnboarding({
1763
1836
 
1764
1837
  // ../connectors/src/connectors/bigquery/tools/execute-query.ts
1765
1838
  import { z as z7 } from "zod";
1766
- var MAX_ROWS5 = 500;
1839
+ var MAX_ROWS4 = 500;
1767
1840
  var inputSchema7 = z7.object({
1768
1841
  toolUseIntent: z7.string().optional().describe(
1769
1842
  "Brief description of what you intend to accomplish with this tool call"
@@ -1787,7 +1860,7 @@ var outputSchema7 = z7.discriminatedUnion("success", [
1787
1860
  ]);
1788
1861
  var executeQueryTool5 = new ConnectorTool({
1789
1862
  name: "executeQuery",
1790
- description: `Execute SQL against BigQuery. Returns up to ${MAX_ROWS5} rows.
1863
+ description: `Execute SQL against BigQuery. Returns up to ${MAX_ROWS4} rows.
1791
1864
  Use for: schema exploration (INFORMATION_SCHEMA), data sampling, analytical queries.
1792
1865
  Avoid loading large amounts of data; always include LIMIT in queries.`,
1793
1866
  inputSchema: inputSchema7,
@@ -1814,12 +1887,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
1814
1887
  const [job] = await bq.createQueryJob({ query: sql });
1815
1888
  const [rows] = await job.getQueryResults();
1816
1889
  const allRows = rows;
1817
- const truncated = allRows.length > MAX_ROWS5;
1890
+ const truncated = allRows.length > MAX_ROWS4;
1818
1891
  return {
1819
1892
  success: true,
1820
- rowCount: Math.min(allRows.length, MAX_ROWS5),
1893
+ rowCount: Math.min(allRows.length, MAX_ROWS4),
1821
1894
  truncated,
1822
- rows: allRows.slice(0, MAX_ROWS5)
1895
+ rows: allRows.slice(0, MAX_ROWS4)
1823
1896
  };
1824
1897
  } catch (err) {
1825
1898
  const msg = err instanceof Error ? err.message : String(err);
@@ -2220,7 +2293,7 @@ var bigqueryOnboarding2 = new ConnectorOnboarding({
2220
2293
 
2221
2294
  // ../connectors/src/connectors/bigquery-oauth/tools/execute-query.ts
2222
2295
  import { z as z10 } from "zod";
2223
- var MAX_ROWS6 = 500;
2296
+ var MAX_ROWS5 = 500;
2224
2297
  var REQUEST_TIMEOUT_MS3 = 6e4;
2225
2298
  var cachedToken3 = null;
2226
2299
  async function getProxyToken3(config) {
@@ -2287,7 +2360,7 @@ function parseQueryResponse(data) {
2287
2360
  }
2288
2361
  var executeQueryTool6 = new ConnectorTool({
2289
2362
  name: "executeQuery",
2290
- description: `Execute SQL against BigQuery via OAuth. Returns up to ${MAX_ROWS6} rows.
2363
+ description: `Execute SQL against BigQuery via OAuth. Returns up to ${MAX_ROWS5} rows.
2291
2364
  Use for: schema exploration (INFORMATION_SCHEMA), data sampling, analytical queries.
2292
2365
  Avoid loading large amounts of data; always include LIMIT in queries.`,
2293
2366
  inputSchema: inputSchema10,
@@ -2320,7 +2393,7 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
2320
2393
  body: JSON.stringify({
2321
2394
  url: queryUrl,
2322
2395
  method: "POST",
2323
- body: { query: sql, useLegacySql: false, maxResults: MAX_ROWS6 }
2396
+ body: { query: sql, useLegacySql: false, maxResults: MAX_ROWS5 }
2324
2397
  }),
2325
2398
  signal: controller.signal
2326
2399
  });
@@ -2330,12 +2403,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
2330
2403
  return { success: false, error: errorMessage };
2331
2404
  }
2332
2405
  const rows = parseQueryResponse(data);
2333
- const truncated = rows.length > MAX_ROWS6;
2406
+ const truncated = rows.length > MAX_ROWS5;
2334
2407
  return {
2335
2408
  success: true,
2336
- rowCount: Math.min(rows.length, MAX_ROWS6),
2409
+ rowCount: Math.min(rows.length, MAX_ROWS5),
2337
2410
  truncated,
2338
- rows: rows.slice(0, MAX_ROWS6)
2411
+ rows: rows.slice(0, MAX_ROWS5)
2339
2412
  };
2340
2413
  } finally {
2341
2414
  clearTimeout(timeout);
@@ -2515,7 +2588,7 @@ var parameters7 = {
2515
2588
 
2516
2589
  // ../connectors/src/connectors/aws-athena/tools/execute-query.ts
2517
2590
  import { z as z11 } from "zod";
2518
- var MAX_ROWS7 = 500;
2591
+ var MAX_ROWS6 = 500;
2519
2592
  var POLL_INTERVAL_MS = 1e3;
2520
2593
  var POLL_TIMEOUT_MS = 12e4;
2521
2594
  var inputSchema11 = z11.object({
@@ -2539,7 +2612,7 @@ var outputSchema11 = z11.discriminatedUnion("success", [
2539
2612
  ]);
2540
2613
  var executeQueryTool7 = new ConnectorTool({
2541
2614
  name: "executeQuery",
2542
- description: `Execute SQL against AWS Athena. Returns up to ${MAX_ROWS7} rows.
2615
+ description: `Execute SQL against AWS Athena. Returns up to ${MAX_ROWS6} rows.
2543
2616
  Use for: schema exploration (SHOW DATABASES/TABLES, DESCRIBE TABLE), data sampling, analytical queries on S3 data.
2544
2617
  Avoid loading large amounts of data; always include LIMIT in queries.`,
2545
2618
  inputSchema: inputSchema11,
@@ -2616,12 +2689,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
2616
2689
  });
2617
2690
  return obj;
2618
2691
  });
2619
- const truncated = dataRows.length > MAX_ROWS7;
2692
+ const truncated = dataRows.length > MAX_ROWS6;
2620
2693
  return {
2621
2694
  success: true,
2622
- rowCount: Math.min(dataRows.length, MAX_ROWS7),
2695
+ rowCount: Math.min(dataRows.length, MAX_ROWS6),
2623
2696
  truncated,
2624
- rows: dataRows.slice(0, MAX_ROWS7)
2697
+ rows: dataRows.slice(0, MAX_ROWS6)
2625
2698
  };
2626
2699
  } catch (err) {
2627
2700
  const msg = err instanceof Error ? err.message : String(err);
@@ -3536,7 +3609,7 @@ var parameters9 = {
3536
3609
 
3537
3610
  // ../connectors/src/connectors/redshift/tools/execute-query.ts
3538
3611
  import { z as z15 } from "zod";
3539
- var MAX_ROWS8 = 500;
3612
+ var MAX_ROWS7 = 500;
3540
3613
  var POLL_INTERVAL_MS2 = 1e3;
3541
3614
  var POLL_TIMEOUT_MS2 = 12e4;
3542
3615
  var inputSchema15 = z15.object({
@@ -3562,7 +3635,7 @@ var outputSchema15 = z15.discriminatedUnion("success", [
3562
3635
  ]);
3563
3636
  var executeQueryTool8 = new ConnectorTool({
3564
3637
  name: "executeQuery",
3565
- description: `Execute SQL against Amazon Redshift. Returns up to ${MAX_ROWS8} rows.
3638
+ description: `Execute SQL against Amazon Redshift. Returns up to ${MAX_ROWS7} rows.
3566
3639
  Use for: schema exploration, data sampling, analytical queries.
3567
3640
  Avoid loading large amounts of data; always include LIMIT in queries.`,
3568
3641
  inputSchema: inputSchema15,
@@ -3641,12 +3714,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
3641
3714
  });
3642
3715
  return row;
3643
3716
  });
3644
- const truncated = allRows.length > MAX_ROWS8;
3717
+ const truncated = allRows.length > MAX_ROWS7;
3645
3718
  return {
3646
3719
  success: true,
3647
- rowCount: Math.min(allRows.length, MAX_ROWS8),
3720
+ rowCount: Math.min(allRows.length, MAX_ROWS7),
3648
3721
  truncated,
3649
- rows: allRows.slice(0, MAX_ROWS8)
3722
+ rows: allRows.slice(0, MAX_ROWS7)
3650
3723
  };
3651
3724
  } catch (err) {
3652
3725
  const msg = err instanceof Error ? err.message : String(err);
@@ -3867,7 +3940,7 @@ var parameters10 = {
3867
3940
 
3868
3941
  // ../connectors/src/connectors/databricks/tools/execute-query.ts
3869
3942
  import { z as z16 } from "zod";
3870
- var MAX_ROWS9 = 500;
3943
+ var MAX_ROWS8 = 500;
3871
3944
  var inputSchema16 = z16.object({
3872
3945
  toolUseIntent: z16.string().optional().describe(
3873
3946
  "Brief description of what you intend to accomplish with this tool call"
@@ -3889,7 +3962,7 @@ var outputSchema16 = z16.discriminatedUnion("success", [
3889
3962
  ]);
3890
3963
  var executeQueryTool9 = new ConnectorTool({
3891
3964
  name: "executeQuery",
3892
- description: `Execute SQL against Databricks. Returns up to ${MAX_ROWS9} rows.
3965
+ description: `Execute SQL against Databricks. Returns up to ${MAX_ROWS8} rows.
3893
3966
  Use for: schema exploration (SHOW CATALOGS/DATABASES/TABLES, DESCRIBE TABLE), data sampling, analytical queries.
3894
3967
  Avoid loading large amounts of data; always include LIMIT in queries.`,
3895
3968
  inputSchema: inputSchema16,
@@ -3920,12 +3993,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
3920
3993
  runAsync: true
3921
3994
  });
3922
3995
  const allRows = await operation.fetchAll();
3923
- const truncated = allRows.length > MAX_ROWS9;
3996
+ const truncated = allRows.length > MAX_ROWS8;
3924
3997
  return {
3925
3998
  success: true,
3926
- rowCount: Math.min(allRows.length, MAX_ROWS9),
3999
+ rowCount: Math.min(allRows.length, MAX_ROWS8),
3927
4000
  truncated,
3928
- rows: allRows.slice(0, MAX_ROWS9)
4001
+ rows: allRows.slice(0, MAX_ROWS8)
3929
4002
  };
3930
4003
  } finally {
3931
4004
  if (operation) await operation.close().catch(() => {
@@ -10870,7 +10943,7 @@ var parameters29 = {
10870
10943
 
10871
10944
  // ../connectors/src/connectors/squadbase-db/tools/execute-query.ts
10872
10945
  import { z as z40 } from "zod";
10873
- var MAX_ROWS10 = 500;
10946
+ var MAX_ROWS9 = 500;
10874
10947
  var CONNECT_TIMEOUT_MS3 = 1e4;
10875
10948
  var STATEMENT_TIMEOUT_MS2 = 6e4;
10876
10949
  var inputSchema40 = z40.object({
@@ -10894,7 +10967,7 @@ var outputSchema40 = z40.discriminatedUnion("success", [
10894
10967
  ]);
10895
10968
  var executeQueryTool10 = new ConnectorTool({
10896
10969
  name: "executeQuery",
10897
- description: `Execute SQL against Squadbase DB (PostgreSQL). Returns up to ${MAX_ROWS10} rows.
10970
+ description: `Execute SQL against Squadbase DB (PostgreSQL). Returns up to ${MAX_ROWS9} rows.
10898
10971
  Use for: schema exploration (information_schema), data sampling, analytical queries.
10899
10972
  Avoid loading large amounts of data; always include LIMIT in queries.`,
10900
10973
  inputSchema: inputSchema40,
@@ -10923,12 +10996,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
10923
10996
  try {
10924
10997
  const result = await pool.query(sql);
10925
10998
  const rows = result.rows;
10926
- const truncated = rows.length > MAX_ROWS10;
10999
+ const truncated = rows.length > MAX_ROWS9;
10927
11000
  return {
10928
11001
  success: true,
10929
- rowCount: Math.min(rows.length, MAX_ROWS10),
11002
+ rowCount: Math.min(rows.length, MAX_ROWS9),
10930
11003
  truncated,
10931
- rows: rows.slice(0, MAX_ROWS10)
11004
+ rows: rows.slice(0, MAX_ROWS9)
10932
11005
  };
10933
11006
  } finally {
10934
11007
  await pool.end();
@@ -13702,8 +13775,8 @@ var parameters41 = {
13702
13775
 
13703
13776
  // ../connectors/src/connectors/clickhouse/tools/execute-query.ts
13704
13777
  import { z as z49 } from "zod";
13705
- var MAX_ROWS11 = 500;
13706
- var QUERY_TIMEOUT_MS4 = 6e4;
13778
+ var MAX_ROWS10 = 500;
13779
+ var QUERY_TIMEOUT_MS3 = 6e4;
13707
13780
  var inputSchema49 = z49.object({
13708
13781
  toolUseIntent: z49.string().optional().describe(
13709
13782
  "Brief description of what you intend to accomplish with this tool call"
@@ -13725,7 +13798,7 @@ var outputSchema49 = z49.discriminatedUnion("success", [
13725
13798
  ]);
13726
13799
  var executeQueryTool11 = new ConnectorTool({
13727
13800
  name: "executeQuery",
13728
- description: `Execute SQL against ClickHouse. Returns up to ${MAX_ROWS11} rows.
13801
+ description: `Execute SQL against ClickHouse. Returns up to ${MAX_ROWS10} rows.
13729
13802
  Use for: schema exploration (SHOW DATABASES, SHOW TABLES, DESCRIBE TABLE), data sampling, analytical queries on large-scale columnar data.
13730
13803
  Avoid loading large amounts of data; always include LIMIT in queries.`,
13731
13804
  inputSchema: inputSchema49,
@@ -13753,7 +13826,7 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
13753
13826
  username,
13754
13827
  password: password || "",
13755
13828
  database: database || "default",
13756
- request_timeout: QUERY_TIMEOUT_MS4
13829
+ request_timeout: QUERY_TIMEOUT_MS3
13757
13830
  });
13758
13831
  try {
13759
13832
  const resultSet = await client.query({
@@ -13761,12 +13834,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
13761
13834
  format: "JSONEachRow"
13762
13835
  });
13763
13836
  const allRows = await resultSet.json();
13764
- const truncated = allRows.length > MAX_ROWS11;
13837
+ const truncated = allRows.length > MAX_ROWS10;
13765
13838
  return {
13766
13839
  success: true,
13767
- rowCount: Math.min(allRows.length, MAX_ROWS11),
13840
+ rowCount: Math.min(allRows.length, MAX_ROWS10),
13768
13841
  truncated,
13769
- rows: allRows.slice(0, MAX_ROWS11)
13842
+ rows: allRows.slice(0, MAX_ROWS10)
13770
13843
  };
13771
13844
  } finally {
13772
13845
  await client.close();
@@ -13922,7 +13995,7 @@ var parameters42 = {
13922
13995
  import { z as z50 } from "zod";
13923
13996
  var MAX_DOCUMENTS = 500;
13924
13997
  var CONNECT_TIMEOUT_MS4 = 1e4;
13925
- var QUERY_TIMEOUT_MS5 = 6e4;
13998
+ var QUERY_TIMEOUT_MS4 = 6e4;
13926
13999
  var inputSchema50 = z50.object({
13927
14000
  toolUseIntent: z50.string().optional().describe(
13928
14001
  "Brief description of what you intend to accomplish with this tool call"
@@ -13981,7 +14054,7 @@ For listing collections, use the aggregate tool with an empty pipeline on the sp
13981
14054
  const client = new MongoClient(connectionUrl, {
13982
14055
  connectTimeoutMS: CONNECT_TIMEOUT_MS4,
13983
14056
  serverSelectionTimeoutMS: CONNECT_TIMEOUT_MS4,
13984
- socketTimeoutMS: QUERY_TIMEOUT_MS5
14057
+ socketTimeoutMS: QUERY_TIMEOUT_MS4
13985
14058
  });
13986
14059
  try {
13987
14060
  await client.connect();
@@ -14027,7 +14100,7 @@ For listing collections, use the aggregate tool with an empty pipeline on the sp
14027
14100
  import { z as z51 } from "zod";
14028
14101
  var MAX_DOCUMENTS2 = 500;
14029
14102
  var CONNECT_TIMEOUT_MS5 = 1e4;
14030
- var QUERY_TIMEOUT_MS6 = 6e4;
14103
+ var QUERY_TIMEOUT_MS5 = 6e4;
14031
14104
  var inputSchema51 = z51.object({
14032
14105
  toolUseIntent: z51.string().optional().describe(
14033
14106
  "Brief description of what you intend to accomplish with this tool call"
@@ -14078,7 +14151,7 @@ Common stages: $match (filter), $group (aggregate), $sort (order), $project (res
14078
14151
  const client = new MongoClient(connectionUrl, {
14079
14152
  connectTimeoutMS: CONNECT_TIMEOUT_MS5,
14080
14153
  serverSelectionTimeoutMS: CONNECT_TIMEOUT_MS5,
14081
- socketTimeoutMS: QUERY_TIMEOUT_MS6
14154
+ socketTimeoutMS: QUERY_TIMEOUT_MS5
14082
14155
  });
14083
14156
  try {
14084
14157
  await client.connect();
@@ -23307,7 +23380,7 @@ function redactJdbcUrl(jdbcUrl) {
23307
23380
  }
23308
23381
 
23309
23382
  // ../connectors/src/connectors/jdbc/tools/execute-query.ts
23310
- var MAX_ROWS12 = 500;
23383
+ var MAX_ROWS11 = 500;
23311
23384
  var CONNECT_TIMEOUT_MS7 = 1e4;
23312
23385
  var STATEMENT_TIMEOUT_MS3 = 6e4;
23313
23386
  var inputSchema82 = z82.object({
@@ -23333,7 +23406,7 @@ var outputSchema82 = z82.discriminatedUnion("success", [
23333
23406
  ]);
23334
23407
  var executeQueryTool12 = new ConnectorTool({
23335
23408
  name: "executeQuery",
23336
- description: `Execute a SQL query through the JDBC connector. Returns up to ${MAX_ROWS12} rows.
23409
+ description: `Execute a SQL query through the JDBC connector. Returns up to ${MAX_ROWS11} rows.
23337
23410
  Use for: schema exploration via \`information_schema\` (or USER_TABLES on Oracle), data sampling, analytical queries.
23338
23411
  The connector dispatches by JDBC URL prefix to the matching driver
23339
23412
  (PostgreSQL / Redshift / MySQL / MariaDB / SQL Server / Oracle), so use the dialect that matches the connection.
@@ -23374,9 +23447,9 @@ Always bound results: LIMIT for PG/MySQL/Redshift, TOP for SQL Server, FETCH FIR
23374
23447
  const rows = result.rows;
23375
23448
  return {
23376
23449
  success: true,
23377
- rowCount: Math.min(rows.length, MAX_ROWS12),
23378
- truncated: rows.length > MAX_ROWS12,
23379
- rows: rows.slice(0, MAX_ROWS12)
23450
+ rowCount: Math.min(rows.length, MAX_ROWS11),
23451
+ truncated: rows.length > MAX_ROWS11,
23452
+ rows: rows.slice(0, MAX_ROWS11)
23380
23453
  };
23381
23454
  }
23382
23455
  if (parsed.driver === "oracle") {
@@ -23391,9 +23464,9 @@ Always bound results: LIMIT for PG/MySQL/Redshift, TOP for SQL Server, FETCH FIR
23391
23464
  const rows = result.rows;
23392
23465
  return {
23393
23466
  success: true,
23394
- rowCount: Math.min(rows.length, MAX_ROWS12),
23395
- truncated: rows.length > MAX_ROWS12,
23396
- rows: rows.slice(0, MAX_ROWS12)
23467
+ rowCount: Math.min(rows.length, MAX_ROWS11),
23468
+ truncated: rows.length > MAX_ROWS11,
23469
+ rows: rows.slice(0, MAX_ROWS11)
23397
23470
  };
23398
23471
  }
23399
23472
  let tunnel;
@@ -23417,12 +23490,12 @@ Always bound results: LIMIT for PG/MySQL/Redshift, TOP for SQL Server, FETCH FIR
23417
23490
  STATEMENT_TIMEOUT_MS3
23418
23491
  );
23419
23492
  const rows = result.rows;
23420
- const truncated = rows.length > MAX_ROWS12;
23493
+ const truncated = rows.length > MAX_ROWS11;
23421
23494
  return {
23422
23495
  success: true,
23423
- rowCount: Math.min(rows.length, MAX_ROWS12),
23496
+ rowCount: Math.min(rows.length, MAX_ROWS11),
23424
23497
  truncated,
23425
- rows: rows.slice(0, MAX_ROWS12)
23498
+ rows: rows.slice(0, MAX_ROWS11)
23426
23499
  };
23427
23500
  } finally {
23428
23501
  await pool2.end();
@@ -23443,12 +23516,12 @@ Always bound results: LIMIT for PG/MySQL/Redshift, TOP for SQL Server, FETCH FIR
23443
23516
  );
23444
23517
  const [rows] = await Promise.race([queryPromise, timeoutPromise]);
23445
23518
  const resultRows = Array.isArray(rows) ? rows : [];
23446
- const truncated = resultRows.length > MAX_ROWS12;
23519
+ const truncated = resultRows.length > MAX_ROWS11;
23447
23520
  return {
23448
23521
  success: true,
23449
- rowCount: Math.min(resultRows.length, MAX_ROWS12),
23522
+ rowCount: Math.min(resultRows.length, MAX_ROWS11),
23450
23523
  truncated,
23451
- rows: resultRows.slice(0, MAX_ROWS12)
23524
+ rows: resultRows.slice(0, MAX_ROWS11)
23452
23525
  };
23453
23526
  } finally {
23454
23527
  await pool.end();
@@ -24717,7 +24790,7 @@ var parameters70 = {
24717
24790
 
24718
24791
  // ../connectors/src/connectors/supabase/tools/execute-query.ts
24719
24792
  import { z as z86 } from "zod";
24720
- var MAX_ROWS13 = 500;
24793
+ var MAX_ROWS12 = 500;
24721
24794
  var CONNECT_TIMEOUT_MS8 = 1e4;
24722
24795
  var STATEMENT_TIMEOUT_MS4 = 6e4;
24723
24796
  var inputSchema86 = z86.object({
@@ -24743,7 +24816,7 @@ var outputSchema86 = z86.discriminatedUnion("success", [
24743
24816
  ]);
24744
24817
  var executeQueryTool13 = new ConnectorTool({
24745
24818
  name: "executeQuery",
24746
- description: `Execute SQL against a Supabase Postgres database. Returns up to ${MAX_ROWS13} rows.
24819
+ description: `Execute SQL against a Supabase Postgres database. Returns up to ${MAX_ROWS12} rows.
24747
24820
  Use for: schema exploration (information_schema), data sampling, and analytical queries against Supabase tables.
24748
24821
  User tables live in the \`public\` schema by default; Supabase-managed metadata lives in \`auth\` and \`storage\`.
24749
24822
  Avoid loading large amounts of data; always include LIMIT in queries.`,
@@ -24773,12 +24846,12 @@ Avoid loading large amounts of data; always include LIMIT in queries.`,
24773
24846
  try {
24774
24847
  const result = await pool.query(sql);
24775
24848
  const rows = result.rows;
24776
- const truncated = rows.length > MAX_ROWS13;
24849
+ const truncated = rows.length > MAX_ROWS12;
24777
24850
  return {
24778
24851
  success: true,
24779
- rowCount: Math.min(rows.length, MAX_ROWS13),
24852
+ rowCount: Math.min(rows.length, MAX_ROWS12),
24780
24853
  truncated,
24781
- rows: rows.slice(0, MAX_ROWS13)
24854
+ rows: rows.slice(0, MAX_ROWS12)
24782
24855
  };
24783
24856
  } finally {
24784
24857
  await pool.end();
@@ -25257,7 +25330,7 @@ var parameters72 = {
25257
25330
 
25258
25331
  // ../connectors/src/connectors/sqlserver/tools/execute-query.ts
25259
25332
  import { z as z88 } from "zod";
25260
- var MAX_ROWS14 = 500;
25333
+ var MAX_ROWS13 = 500;
25261
25334
  var inputSchema88 = z88.object({
25262
25335
  toolUseIntent: z88.string().optional().describe(
25263
25336
  "Brief description of what you intend to accomplish with this tool call"
@@ -25281,7 +25354,7 @@ var outputSchema88 = z88.discriminatedUnion("success", [
25281
25354
  ]);
25282
25355
  var executeQueryTool14 = new ConnectorTool({
25283
25356
  name: "executeQuery",
25284
- description: `Execute a T-SQL query against Microsoft SQL Server. Returns up to ${MAX_ROWS14} rows.
25357
+ description: `Execute a T-SQL query against Microsoft SQL Server. Returns up to ${MAX_ROWS13} rows.
25285
25358
  Use for: schema exploration via \`INFORMATION_SCHEMA\`, data sampling, and analytical queries.
25286
25359
  SQL Server uses \`TOP n\` instead of \`LIMIT n\`. Identifiers can be wrapped in square brackets (\`[schema].[table]\`).
25287
25360
  Avoid loading large amounts of data; always include \`TOP\` in queries.`,
@@ -25314,12 +25387,12 @@ Avoid loading large amounts of data; always include \`TOP\` in queries.`,
25314
25387
  const { rows } = await runMssqlQuery(parsed, sql, {
25315
25388
  tunnelParams: connectionParamsToRecord(connection)
25316
25389
  });
25317
- const truncated = rows.length > MAX_ROWS14;
25390
+ const truncated = rows.length > MAX_ROWS13;
25318
25391
  return {
25319
25392
  success: true,
25320
- rowCount: Math.min(rows.length, MAX_ROWS14),
25393
+ rowCount: Math.min(rows.length, MAX_ROWS13),
25321
25394
  truncated,
25322
- rows: rows.slice(0, MAX_ROWS14)
25395
+ rows: rows.slice(0, MAX_ROWS13)
25323
25396
  };
25324
25397
  } catch (err) {
25325
25398
  let msg = err instanceof Error ? err.message : String(err);
@@ -25452,7 +25525,7 @@ var parameters73 = {
25452
25525
 
25453
25526
  // ../connectors/src/connectors/azure-sql/tools/execute-query.ts
25454
25527
  import { z as z89 } from "zod";
25455
- var MAX_ROWS15 = 500;
25528
+ var MAX_ROWS14 = 500;
25456
25529
  var inputSchema89 = z89.object({
25457
25530
  toolUseIntent: z89.string().optional().describe(
25458
25531
  "Brief description of what you intend to accomplish with this tool call"
@@ -25476,7 +25549,7 @@ var outputSchema89 = z89.discriminatedUnion("success", [
25476
25549
  ]);
25477
25550
  var executeQueryTool15 = new ConnectorTool({
25478
25551
  name: "executeQuery",
25479
- description: `Execute a T-SQL query against Azure SQL Database. Returns up to ${MAX_ROWS15} rows.
25552
+ description: `Execute a T-SQL query against Azure SQL Database. Returns up to ${MAX_ROWS14} rows.
25480
25553
  Use for: schema exploration via \`INFORMATION_SCHEMA\`, data sampling, and analytical queries.
25481
25554
  Azure SQL is T-SQL: use \`TOP n\` instead of \`LIMIT n\`. Identifiers can be wrapped in square brackets.
25482
25555
  Avoid loading large amounts of data; always include \`TOP\` in queries.`,
@@ -25510,12 +25583,12 @@ Avoid loading large amounts of data; always include \`TOP\` in queries.`,
25510
25583
  forceEncrypt: true,
25511
25584
  tunnelParams: connectionParamsToRecord(connection)
25512
25585
  });
25513
- const truncated = rows.length > MAX_ROWS15;
25586
+ const truncated = rows.length > MAX_ROWS14;
25514
25587
  return {
25515
25588
  success: true,
25516
- rowCount: Math.min(rows.length, MAX_ROWS15),
25589
+ rowCount: Math.min(rows.length, MAX_ROWS14),
25517
25590
  truncated,
25518
- rows: rows.slice(0, MAX_ROWS15)
25591
+ rows: rows.slice(0, MAX_ROWS14)
25519
25592
  };
25520
25593
  } catch (err) {
25521
25594
  let msg = err instanceof Error ? err.message : String(err);
@@ -25992,7 +26065,7 @@ var parameters75 = {
25992
26065
 
25993
26066
  // ../connectors/src/connectors/oracle/tools/execute-query.ts
25994
26067
  import { z as z92 } from "zod";
25995
- var MAX_ROWS16 = 500;
26068
+ var MAX_ROWS15 = 500;
25996
26069
  var inputSchema92 = z92.object({
25997
26070
  toolUseIntent: z92.string().optional().describe(
25998
26071
  "Brief description of what you intend to accomplish with this tool call"
@@ -26016,7 +26089,7 @@ var outputSchema92 = z92.discriminatedUnion("success", [
26016
26089
  ]);
26017
26090
  var executeQueryTool16 = new ConnectorTool({
26018
26091
  name: "executeQuery",
26019
- description: `Execute a query against an Oracle Database. Returns up to ${MAX_ROWS16} rows.
26092
+ description: `Execute a query against an Oracle Database. Returns up to ${MAX_ROWS15} rows.
26020
26093
  Use for: schema exploration via \`USER_TABLES\` / \`USER_TAB_COLUMNS\` / \`ALL_TABLES\`, data sampling, and analytical queries.
26021
26094
  Oracle uses \`FETCH FIRST n ROWS ONLY\` (12c+) or \`ROWNUM\` for row limiting \u2014 there is no \`LIMIT\` keyword.
26022
26095
  Unquoted identifiers are stored upper-case (\`SELECT * FROM employees\` resolves to \`EMPLOYEES\`).
@@ -26051,12 +26124,12 @@ Do NOT terminate statements with a semicolon; the driver rejects trailing termin
26051
26124
  const { rows } = await runOracleQuery(parsed, cleanSql, {
26052
26125
  tunnelParams: connectionParamsToRecord(connection)
26053
26126
  });
26054
- const truncated = rows.length > MAX_ROWS16;
26127
+ const truncated = rows.length > MAX_ROWS15;
26055
26128
  return {
26056
26129
  success: true,
26057
- rowCount: Math.min(rows.length, MAX_ROWS16),
26130
+ rowCount: Math.min(rows.length, MAX_ROWS15),
26058
26131
  truncated,
26059
- rows: rows.slice(0, MAX_ROWS16)
26132
+ rows: rows.slice(0, MAX_ROWS15)
26060
26133
  };
26061
26134
  } catch (err) {
26062
26135
  let msg = err instanceof Error ? err.message : String(err);
@@ -26075,7 +26148,7 @@ var oracleConnector = new ConnectorPlugin({
26075
26148
  description: "Connect to Oracle Database using a JDBC-style URL via the pure-JS Thin driver (no Oracle Instant Client required).",
26076
26149
  iconUrl: "https://images.ctfassets.net/9ncizv60xc5y/3iGEdzvGHncU5bYqFOROiV/9e7bdda7230d7ca6b34e7f6a862de876/oracle-icon.webp",
26077
26150
  parameters: parameters75,
26078
- releaseFlag: { dev1: true, dev2: false, prod: false },
26151
+ releaseFlag: { dev1: true, dev2: true, prod: true },
26079
26152
  categories: ["database"],
26080
26153
  onboarding: oracleOnboarding,
26081
26154
  systemPrompt: {
@@ -27552,115 +27625,1741 @@ export default async function handler(c: Context) {
27552
27625
  tools: tools79
27553
27626
  });
27554
27627
 
27555
- // ../connectors/src/connectors/registry.ts
27556
- var plugins = {
27557
- snowflake: snowflakeConnector,
27558
- snowflakePat: snowflakePatConnector,
27559
- bigquery: bigqueryConnector,
27560
- bigqueryOauth: bigqueryOauthConnector,
27561
- databricks: databricksConnector,
27562
- redshift: redshiftConnector,
27563
- dbt: dbtConnector,
27564
- awsAthena: awsAthenaConnector,
27565
- awsBilling: awsBillingConnector,
27566
- postgresql: postgresqlConnector,
27567
- mysql: mysqlConnector,
27568
- googleAds: googleAdsConnector,
27569
- googleAnalytics: googleAnalyticsConnector,
27570
- googleAnalyticsOauth: googleAnalyticsOauthConnector,
27571
- googleCalendar: googleCalendarConnector,
27572
- googleCalendarOauth: googleCalendarOauthConnector,
27573
- googleDocs: googleDocsConnector,
27574
- googleDrive: googleDriveConnector,
27575
- googleSheets: googleSheetsConnector,
27576
- googleSlides: googleSlidesConnector,
27577
- hubspotOauth: hubspotOauthConnector,
27578
- stripeOauth: stripeOauthConnector,
27579
- stripeApiKey: stripeApiKeyConnector,
27580
- airtable: airtableConnector,
27581
- airtableOauth: airtableOauthConnector,
27582
- squadbaseDb: squadbaseDbConnector,
27583
- kintone: kintoneConnector,
27584
- kintoneApiToken: kintoneApiTokenConnector,
27585
- wixStore: wixStoreConnector,
27586
- openai: openaiConnector,
27587
- gemini: geminiConnector,
27588
- anthropic: anthropicConnector,
27589
- amplitude: amplitudeConnector,
27590
- attio: attioConnector,
27591
- shopify: shopifyConnector,
27592
- shopifyOauth: shopifyOauthConnector,
27593
- hubspot: hubspotConnector,
27594
- jira: jiraConnector,
27595
- linear: linearConnector,
27596
- asana: asanaConnector,
27597
- clickhouse: clickhouseConnector,
27598
- mongodb: mongodbConnector,
27599
- notion: notionConnector,
27600
- notionOauth: notionOauthConnector,
27601
- metaAds: metaAdsConnector,
27602
- metaAdsOauth: metaAdsOauthConnector,
27603
- tiktokAds: tiktokAdsConnector,
27604
- mailchimp: mailchimpConnector,
27605
- mailchimpOauth: mailchimpOauthConnector,
27606
- customerio: customerioConnector,
27607
- gmail: gmailConnector,
27608
- gmailOauth: gmailOauthConnector,
27609
- googleAuditLog: googleAuditLogConnector,
27610
- linkedinAds: linkedinAdsConnector,
27611
- zendesk: zendeskConnector,
27612
- zendeskOauth: zendeskOauthConnector,
27613
- intercom: intercomConnector,
27614
- intercomOauth: intercomOauthConnector,
27615
- mixpanel: mixpanelConnector,
27616
- grafana: grafanaConnector,
27617
- backlog: backlogConnector,
27618
- gamma: gammaConnector,
27619
- sentry: sentryConnector,
27620
- salesforce: salesforceConnector,
27621
- influxdb: influxdbConnector,
27622
- monday: mondayConnector,
27623
- jdbc: jdbcConnector,
27624
- semrush: semrushConnector,
27625
- googleSearchConsoleOauth: googleSearchConsoleOauthConnector,
27626
- supabase: supabaseConnector,
27627
- clickup: clickupConnector,
27628
- sqlserver: sqlserverConnector,
27629
- azureSql: azureSqlConnector,
27630
- cosmosdb: cosmosdbConnector,
27631
- oracle: oracleConnector,
27632
- freshservice: freshserviceConnector,
27633
- freshdesk: freshdeskConnector,
27634
- freshsales: freshsalesConnector,
27635
- github: githubConnector
27636
- };
27637
- var connectors = {
27638
- ...plugins,
27639
- /**
27640
- * Return plugins that have at least one matching connection.
27641
- */
27642
- pluginsFor(connections) {
27643
- const keys = new Set(
27644
- connections.map(
27645
- (c) => ConnectorPlugin.deriveKey(c.connector.slug, c.connector.authType)
27646
- )
27647
- );
27648
- return Object.values(plugins).filter((p) => keys.has(p.connectorKey));
27628
+ // ../connectors/src/connectors/powerbi/setup.ts
27629
+ var powerbiOnboarding = new ConnectorOnboarding({
27630
+ connectionSetupInstructions: {
27631
+ en: `Follow these steps to verify the Power BI Service Principal connection.
27632
+
27633
+ 1. Call \`powerbi_request\` with \`method: "GET"\` and \`path: "/groups"\` to list workspaces the Service Principal can access
27634
+ 2. If the response is an empty \`value\` array, ask the user to add the Service Principal as Member/Admin to at least one workspace (Power BI Service > Workspace > Access). The 'Allow service principals to use Power BI APIs' tenant setting must also be enabled
27635
+
27636
+ #### Constraints
27637
+ - **Do NOT execute DAX queries or refresh datasets during setup**. Only the workspace listing above is allowed
27638
+ - Service Principals cannot access "My workspace" \u2014 always work through workspace (group) IDs`,
27639
+ ja: `Power BI Service Principal \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u306F\u4EE5\u4E0B\u306E\u624B\u9806\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
27640
+
27641
+ 1. \`powerbi_request\` \u3092 \`method: "GET"\`\u3001\`path: "/groups"\` \u3067\u547C\u3073\u51FA\u3057\u3001Service Principal \u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
27642
+ 2. \`value\` \u304C\u7A7A\u914D\u5217\u3067\u8FD4\u3063\u3066\u304D\u305F\u5834\u5408\u306F\u3001Power BI Service > \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9 > \u30A2\u30AF\u30BB\u30B9 \u304B\u3089\u8A72\u5F53\u306E Service Principal \u3092 Member/Admin \u3068\u3057\u3066\u8FFD\u52A0\u3059\u308B\u3088\u3046\u30E6\u30FC\u30B6\u30FC\u306B\u4F1D\u3048\u308B\u3002\u30C6\u30CA\u30F3\u30C8\u7BA1\u7406\u8A2D\u5B9A\u3067\u300C\u30B5\u30FC\u30D3\u30B9 \u30D7\u30EA\u30F3\u30B7\u30D1\u30EB\u306B Power BI API \u306E\u4F7F\u7528\u3092\u8A31\u53EF\u3059\u308B\u300D\u3082\u6709\u52B9\u3067\u3042\u308B\u5FC5\u8981\u304C\u3042\u308B
27643
+
27644
+ #### \u5236\u7D04
27645
+ - **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B DAX \u30AF\u30A8\u30EA\u306E\u5B9F\u884C\u3084\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306E\u66F4\u65B0\u3092\u884C\u308F\u306A\u3044\u3053\u3068**\u3002\u4E0A\u8A18\u306E\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u53D6\u5F97\u306E\u307F\u8A31\u53EF
27646
+ - Service Principal \u306F\u300C\u30DE\u30A4 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u300D\u306B\u30A2\u30AF\u30BB\u30B9\u3067\u304D\u306A\u3044 \u2014 \u5FC5\u305A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9 (group) ID \u7D4C\u7531\u3067\u64CD\u4F5C\u3059\u308B\u3053\u3068`
27649
27647
  },
27650
- /**
27651
- * Find a plugin by slug and authType.
27652
- */
27653
- findByKey(slug, authType) {
27654
- const key = ConnectorPlugin.deriveKey(slug, authType);
27655
- return Object.values(plugins).find((p) => p.connectorKey === key);
27656
- }
27648
+ dataOverviewInstructions: {
27649
+ en: `1. Call powerbi_request with GET /groups to list accessible workspaces
27650
+ 2. For a target workspace, call powerbi_request with GET /groups/{groupId}/datasets to list datasets
27651
+ 3. Call powerbi_request with GET /groups/{groupId}/reports to list reports
27652
+ 4. For each interesting dataset call powerbi_request with GET /groups/{groupId}/datasets/{datasetId}/tables to inspect tables (requires the dataset to allow XMLA / metadata reads)`,
27653
+ ja: `1. powerbi_request \u3067 GET /groups \u3092\u547C\u3073\u51FA\u3057\u3001\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97
27654
+ 2. \u5BFE\u8C61\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306B\u5BFE\u3057\u3066 powerbi_request \u3067 GET /groups/{groupId}/datasets \u3092\u547C\u3073\u51FA\u3057\u3001\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
27655
+ 3. powerbi_request \u3067 GET /groups/{groupId}/reports \u3092\u547C\u3073\u51FA\u3057\u3001\u30EC\u30DD\u30FC\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
27656
+ 4. \u8208\u5473\u306E\u3042\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306B\u3064\u3044\u3066 powerbi_request \u3067 GET /groups/{groupId}/datasets/{datasetId}/tables \u3092\u547C\u3073\u51FA\u3057\u3001\u30C6\u30FC\u30D6\u30EB\u69CB\u9020\u3092\u78BA\u8A8D\uFF08XMLA / \u30E1\u30BF\u30C7\u30FC\u30BF\u8AAD\u307F\u53D6\u308A\u304C\u8A31\u53EF\u3055\u308C\u3066\u3044\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306B\u9650\u308B\uFF09`
27657
+ }
27658
+ });
27659
+
27660
+ // ../connectors/src/connectors/powerbi/parameters.ts
27661
+ var parameters80 = {
27662
+ tenantId: new ParameterDefinition({
27663
+ slug: "tenant-id",
27664
+ name: "Azure Tenant ID",
27665
+ description: "The Microsoft Entra ID (Azure AD) tenant ID that owns the Service Principal. Found in Azure Portal > Microsoft Entra ID > Overview > Tenant ID.",
27666
+ envVarBaseKey: "POWERBI_TENANT_ID",
27667
+ type: "text",
27668
+ secret: false,
27669
+ required: true
27670
+ }),
27671
+ clientId: new ParameterDefinition({
27672
+ slug: "client-id",
27673
+ name: "Application (Client) ID",
27674
+ description: "The Application (client) ID of the Microsoft Entra app registration used as the Power BI Service Principal. Found in Azure Portal > App registrations > Overview.",
27675
+ envVarBaseKey: "POWERBI_CLIENT_ID",
27676
+ type: "text",
27677
+ secret: false,
27678
+ required: true
27679
+ }),
27680
+ clientSecret: new ParameterDefinition({
27681
+ slug: "client-secret",
27682
+ name: "Client Secret",
27683
+ description: "A client secret value for the app registration. Generated under App registrations > Certificates & secrets > Client secrets. The Service Principal must be granted Power BI tenant access (via 'Allow service principals to use Power BI APIs' admin setting) and added to each workspace as a Member/Admin.",
27684
+ envVarBaseKey: "POWERBI_CLIENT_SECRET",
27685
+ type: "text",
27686
+ secret: true,
27687
+ required: true
27688
+ })
27657
27689
  };
27658
27690
 
27659
- // src/connector-client/env.ts
27660
- function resolveEnvVar(entry, key, connectionId) {
27661
- const envVarName = entry.envVars[key];
27662
- if (!envVarName) {
27663
- throw new Error(`Connection "${connectionId}" is missing envVars mapping for key "${key}"`);
27691
+ // ../connectors/src/connectors/powerbi/tools/request.ts
27692
+ import { z as z97 } from "zod";
27693
+ var BASE_HOST12 = "https://api.powerbi.com";
27694
+ var BASE_PATH_SEGMENT15 = "/v1.0/myorg";
27695
+ var BASE_URL41 = `${BASE_HOST12}${BASE_PATH_SEGMENT15}`;
27696
+ var TOKEN_SCOPE = "https://analysis.windows.net/powerbi/api/.default";
27697
+ var REQUEST_TIMEOUT_MS74 = 6e4;
27698
+ var tokenCache = /* @__PURE__ */ new Map();
27699
+ async function getAccessToken(tenantId, clientId, clientSecret) {
27700
+ const cacheKey = `${tenantId}:${clientId}`;
27701
+ const cached = tokenCache.get(cacheKey);
27702
+ if (cached && cached.expiresAt > Date.now() + 6e4) {
27703
+ return cached.token;
27704
+ }
27705
+ const tokenUrl = `https://login.microsoftonline.com/${encodeURIComponent(tenantId)}/oauth2/v2.0/token`;
27706
+ const body = new URLSearchParams({
27707
+ grant_type: "client_credentials",
27708
+ client_id: clientId,
27709
+ client_secret: clientSecret,
27710
+ scope: TOKEN_SCOPE
27711
+ });
27712
+ const res = await fetch(tokenUrl, {
27713
+ method: "POST",
27714
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
27715
+ body: body.toString()
27716
+ });
27717
+ if (!res.ok) {
27718
+ const errorText = await res.text().catch(() => res.statusText);
27719
+ throw new Error(
27720
+ `Power BI token request failed: HTTP ${res.status} ${errorText}`
27721
+ );
27722
+ }
27723
+ const data = await res.json();
27724
+ tokenCache.set(cacheKey, {
27725
+ token: data.access_token,
27726
+ expiresAt: Date.now() + data.expires_in * 1e3
27727
+ });
27728
+ return data.access_token;
27729
+ }
27730
+ var inputSchema97 = z97.object({
27731
+ toolUseIntent: z97.string().optional().describe(
27732
+ "Brief description of what you intend to accomplish with this tool call"
27733
+ ),
27734
+ connectionId: z97.string().describe("ID of the Power BI connection to use"),
27735
+ method: z97.enum(["GET", "POST", "PATCH", "PUT", "DELETE"]).describe(
27736
+ "HTTP method. Use GET for reading workspaces/datasets/reports, POST for execute queries / refresh, PATCH/PUT for updates, DELETE for removal."
27737
+ ),
27738
+ path: z97.string().describe(
27739
+ "API path appended to https://api.powerbi.com/v1.0/myorg (e.g., '/groups', '/groups/{groupId}/datasets', '/groups/{groupId}/reports/{reportId}'). Service Principal cannot access 'My workspace' \u2014 always work through workspace (group) IDs."
27740
+ ),
27741
+ queryParams: z97.record(z97.string(), z97.string()).optional().describe(
27742
+ `Query parameters to append to the URL (e.g., { $top: '50', $filter: "name eq 'Sales'" }). OData operators ($filter, $top, $skip, $expand) are supported on many list endpoints.`
27743
+ ),
27744
+ body: z97.record(z97.string(), z97.unknown()).optional().describe(
27745
+ "JSON request body for POST/PATCH/PUT/DELETE. Example: executeQueries body { queries: [{ query: 'EVALUATE TOPN(10, Sales)' }], serializerSettings: { includeNulls: true } }."
27746
+ )
27747
+ });
27748
+ var outputSchema97 = z97.discriminatedUnion("success", [
27749
+ z97.object({
27750
+ success: z97.literal(true),
27751
+ status: z97.number(),
27752
+ data: z97.unknown()
27753
+ }),
27754
+ z97.object({
27755
+ success: z97.literal(false),
27756
+ error: z97.string()
27757
+ })
27758
+ ]);
27759
+ var requestTool56 = new ConnectorTool({
27760
+ name: "request",
27761
+ description: `Send authenticated requests to the Power BI REST API v1.0.
27762
+ Authentication uses a Microsoft Entra Service Principal (client_credentials) \u2014 the token is acquired and cached automatically.
27763
+ All paths are relative to https://api.powerbi.com/v1.0/myorg. Service Principals cannot access 'My workspace'; always operate on workspaces ('groups') the SP has been added to.
27764
+ Use the executeQueries endpoint (POST /groups/{groupId}/datasets/{datasetId}/executeQueries) to run DAX against a dataset.`,
27765
+ inputSchema: inputSchema97,
27766
+ outputSchema: outputSchema97,
27767
+ async execute({ connectionId, method, path: path5, queryParams, body }, connections) {
27768
+ const connection = connections.find((c) => c.id === connectionId);
27769
+ if (!connection) {
27770
+ return {
27771
+ success: false,
27772
+ error: `Connection ${connectionId} not found`
27773
+ };
27774
+ }
27775
+ console.log(
27776
+ `[connector-request] powerbi/${connection.name}: ${method} ${path5}`
27777
+ );
27778
+ try {
27779
+ const tenantId = parameters80.tenantId.getValue(connection);
27780
+ const clientId = parameters80.clientId.getValue(connection);
27781
+ const clientSecret = parameters80.clientSecret.getValue(connection);
27782
+ const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT15);
27783
+ let url = `${BASE_URL41}${normalizedPath}`;
27784
+ if (queryParams) {
27785
+ const searchParams = new URLSearchParams(queryParams);
27786
+ url += `?${searchParams.toString()}`;
27787
+ }
27788
+ const token = await getAccessToken(tenantId, clientId, clientSecret);
27789
+ const controller = new AbortController();
27790
+ const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS74);
27791
+ try {
27792
+ const init = {
27793
+ method,
27794
+ headers: {
27795
+ Authorization: `Bearer ${token}`,
27796
+ "Content-Type": "application/json",
27797
+ Accept: "application/json"
27798
+ },
27799
+ signal: controller.signal
27800
+ };
27801
+ if (body !== void 0) {
27802
+ init.body = JSON.stringify(body);
27803
+ }
27804
+ const response = await fetch(url, init);
27805
+ const text = await response.text();
27806
+ const data = text ? (() => {
27807
+ try {
27808
+ return JSON.parse(text);
27809
+ } catch {
27810
+ return text;
27811
+ }
27812
+ })() : null;
27813
+ if (!response.ok) {
27814
+ const errorMessage = data && typeof data === "object" && "error" in data ? JSON.stringify(data.error) : typeof data === "string" && data ? data : `HTTP ${response.status} ${response.statusText}`;
27815
+ return { success: false, error: errorMessage };
27816
+ }
27817
+ return { success: true, status: response.status, data };
27818
+ } finally {
27819
+ clearTimeout(timeout);
27820
+ }
27821
+ } catch (err) {
27822
+ const msg = err instanceof Error ? err.message : String(err);
27823
+ return { success: false, error: msg };
27824
+ }
27825
+ }
27826
+ });
27827
+
27828
+ // ../connectors/src/connectors/powerbi/index.ts
27829
+ var tools80 = { request: requestTool56 };
27830
+ var powerbiConnector = new ConnectorPlugin({
27831
+ slug: "powerbi",
27832
+ authType: AUTH_TYPES.API_KEY,
27833
+ name: "Power BI",
27834
+ description: "Connect to Microsoft Power BI via a Service Principal (Microsoft Entra ID app + tenant ID / client ID / client secret). Use it to enumerate workspaces, datasets, and reports, and to run DAX queries.",
27835
+ iconUrl: "https://upload.wikimedia.org/wikipedia/commons/c/cf/New_Power_BI_Logo.svg",
27836
+ parameters: parameters80,
27837
+ releaseFlag: { dev1: true, dev2: false, prod: false },
27838
+ categories: ["other"],
27839
+ onboarding: powerbiOnboarding,
27840
+ systemPrompt: {
27841
+ en: `### Tools
27842
+
27843
+ - \`powerbi_request\`: The only way to call the Power BI REST API v1.0. Use it to list workspaces (\`/groups\`), datasets, reports, dashboards, and to run DAX via the \`executeQueries\` endpoint. Service Principal authentication (\`client_credentials\`) is handled automatically and the bearer token is cached.
27844
+
27845
+ ### Business Logic
27846
+
27847
+ The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT read credentials from environment variables.
27848
+
27849
+ SDK methods (client created via \`connection(connectionId)\`):
27850
+ - \`client.request(path, init?)\` \u2014 low-level authenticated fetch (path appended to \`https://api.powerbi.com/v1.0/myorg\`)
27851
+ - \`client.listGroups(options?)\` \u2014 list workspaces (\`$top\`, \`$skip\`, \`$filter\`)
27852
+ - \`client.listDatasets(groupId)\` / \`client.listReports(groupId)\` \u2014 list datasets / reports in a workspace
27853
+ - \`client.getDataset(groupId, datasetId)\` \u2014 fetch a single dataset
27854
+ - \`client.executeQueries(groupId, datasetId, queries, options?)\` \u2014 run DAX queries against a dataset
27855
+ - \`client.refreshDataset(groupId, datasetId, options?)\` \u2014 trigger an async refresh
27856
+
27857
+ \`\`\`ts
27858
+ import type { Context } from "hono";
27859
+ import { connection } from "@squadbase/vite-server/connectors/powerbi";
27860
+
27861
+ const powerbi = connection("<connectionId>");
27862
+
27863
+ export default async function handler(c: Context) {
27864
+ const { groupId, datasetId, dax } = await c.req.json<{
27865
+ groupId: string;
27866
+ datasetId: string;
27867
+ dax: string;
27868
+ }>();
27869
+
27870
+ const result = await powerbi.executeQueries(groupId, datasetId, [dax]);
27871
+ const rows = result.results[0]?.tables[0]?.rows ?? [];
27872
+ return c.json({ rows });
27873
+ }
27874
+ \`\`\`
27875
+
27876
+ ### Power BI REST API Reference
27877
+
27878
+ - Base URL: \`https://api.powerbi.com/v1.0/myorg\`
27879
+ - Authentication: Microsoft Entra Service Principal via OAuth2 \`client_credentials\` grant against \`https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token\` with scope \`https://analysis.windows.net/powerbi/api/.default\` (handled automatically)
27880
+ - Service Principals cannot access "My workspace"; the SP must be added as Member/Admin to each workspace
27881
+ - The tenant admin must enable "Allow service principals to use Power BI APIs" in the Power BI admin portal
27882
+
27883
+ #### Common Endpoints
27884
+ - GET \`/groups\` \u2014 List workspaces accessible to the Service Principal
27885
+ - GET \`/groups/{groupId}/datasets\` \u2014 List datasets in a workspace
27886
+ - GET \`/groups/{groupId}/datasets/{datasetId}\` \u2014 Get dataset metadata
27887
+ - GET \`/groups/{groupId}/datasets/{datasetId}/tables\` \u2014 List tables (requires XMLA / metadata reads enabled)
27888
+ - GET \`/groups/{groupId}/reports\` \u2014 List reports
27889
+ - GET \`/groups/{groupId}/dashboards\` \u2014 List dashboards
27890
+ - POST \`/groups/{groupId}/datasets/{datasetId}/executeQueries\` \u2014 Run DAX (body: \`{ queries: [{ query: "EVALUATE ..." }], serializerSettings: { includeNulls: true } }\`)
27891
+ - POST \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 Trigger a dataset refresh
27892
+ - GET \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 List recent refresh history
27893
+
27894
+ #### DAX Tips
27895
+ - \`EVALUATE TOPN(10, 'TableName')\` \u2014 sample 10 rows from a table
27896
+ - \`EVALUATE SUMMARIZECOLUMNS('Date'[Year], "Sales", SUM('Sales'[Amount]))\` \u2014 aggregate
27897
+ - Each \`executeQueries\` call accepts one query in the \`queries\` array (per current Power BI API limits); large result sets are truncated server-side (100k rows max)`,
27898
+ ja: `### \u30C4\u30FC\u30EB
27899
+
27900
+ - \`powerbi_request\`: Power BI REST API v1.0 \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9 (\`/groups\`)\u3001\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u3001\u30EC\u30DD\u30FC\u30C8\u3001\u30C0\u30C3\u30B7\u30E5\u30DC\u30FC\u30C9\u306E\u4E00\u89A7\u53D6\u5F97\u3084\u3001\`executeQueries\` \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306B\u3088\u308B DAX \u306E\u5B9F\u884C\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002Service Principal \u8A8D\u8A3C (\`client_credentials\`) \u306F\u81EA\u52D5\u3067\u51E6\u7406\u3055\u308C\u3001Bearer \u30C8\u30FC\u30AF\u30F3\u306F\u30AD\u30E3\u30C3\u30B7\u30E5\u3055\u308C\u307E\u3059\u3002
27901
+
27902
+ ### Business Logic
27903
+
27904
+ \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\u30BF SDK \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
27905
+
27906
+ SDK\u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
27907
+ - \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304D fetch (path \u306F \`https://api.powerbi.com/v1.0/myorg\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059)
27908
+ - \`client.listGroups(options?)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7 (\`$top\`, \`$skip\`, \`$filter\`)
27909
+ - \`client.listDatasets(groupId)\` / \`client.listReports(groupId)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8/\u30EC\u30DD\u30FC\u30C8\u4E00\u89A7
27910
+ - \`client.getDataset(groupId, datasetId)\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u5358\u4F53\u53D6\u5F97
27911
+ - \`client.executeQueries(groupId, datasetId, queries, options?)\` \u2014 DAX \u30AF\u30A8\u30EA\u5B9F\u884C
27912
+ - \`client.refreshDataset(groupId, datasetId, options?)\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u66F4\u65B0\u3092\u975E\u540C\u671F\u30C8\u30EA\u30AC\u30FC
27913
+
27914
+ \`\`\`ts
27915
+ import type { Context } from "hono";
27916
+ import { connection } from "@squadbase/vite-server/connectors/powerbi";
27917
+
27918
+ const powerbi = connection("<connectionId>");
27919
+
27920
+ export default async function handler(c: Context) {
27921
+ const { groupId, datasetId, dax } = await c.req.json<{
27922
+ groupId: string;
27923
+ datasetId: string;
27924
+ dax: string;
27925
+ }>();
27926
+
27927
+ const result = await powerbi.executeQueries(groupId, datasetId, [dax]);
27928
+ const rows = result.results[0]?.tables[0]?.rows ?? [];
27929
+ return c.json({ rows });
27930
+ }
27931
+ \`\`\`
27932
+
27933
+ ### Power BI REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
27934
+
27935
+ - \u30D9\u30FC\u30B9 URL: \`https://api.powerbi.com/v1.0/myorg\`
27936
+ - \u8A8D\u8A3C: Microsoft Entra Service Principal \u306B\u3088\u308B OAuth2 \`client_credentials\` \u30B0\u30E9\u30F3\u30C8\u3002\`https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token\` \u306B\u5BFE\u3057\u30B9\u30B3\u30FC\u30D7 \`https://analysis.windows.net/powerbi/api/.default\` \u3067\u30C8\u30FC\u30AF\u30F3\u53D6\u5F97 (\u81EA\u52D5)
27937
+ - Service Principal \u306F\u300C\u30DE\u30A4 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u300D\u306B\u30A2\u30AF\u30BB\u30B9\u4E0D\u53EF\u3002\u5404\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306B Member/Admin \u3068\u3057\u3066\u8FFD\u52A0\u304C\u5FC5\u8981
27938
+ - \u30C6\u30CA\u30F3\u30C8\u7BA1\u7406\u8005\u304C Power BI \u7BA1\u7406\u30DD\u30FC\u30BF\u30EB\u3067\u300C\u30B5\u30FC\u30D3\u30B9 \u30D7\u30EA\u30F3\u30B7\u30D1\u30EB\u306B Power BI API \u306E\u4F7F\u7528\u3092\u8A31\u53EF\u3059\u308B\u300D\u3092\u6709\u52B9\u306B\u3057\u3066\u3044\u308B\u5FC5\u8981\u304C\u3042\u308A\u307E\u3059
27939
+
27940
+ #### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
27941
+ - GET \`/groups\` \u2014 Service Principal \u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7
27942
+ - GET \`/groups/{groupId}/datasets\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7
27943
+ - GET \`/groups/{groupId}/datasets/{datasetId}\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8 \u30E1\u30BF\u30C7\u30FC\u30BF
27944
+ - GET \`/groups/{groupId}/datasets/{datasetId}/tables\` \u2014 \u30C6\u30FC\u30D6\u30EB\u4E00\u89A7 (XMLA / \u30E1\u30BF\u30C7\u30FC\u30BF\u8AAD\u307F\u53D6\u308A\u304C\u6709\u52B9\u3067\u3042\u308B\u5FC5\u8981\u3042\u308A)
27945
+ - GET \`/groups/{groupId}/reports\` \u2014 \u30EC\u30DD\u30FC\u30C8\u4E00\u89A7
27946
+ - GET \`/groups/{groupId}/dashboards\` \u2014 \u30C0\u30C3\u30B7\u30E5\u30DC\u30FC\u30C9\u4E00\u89A7
27947
+ - POST \`/groups/{groupId}/datasets/{datasetId}/executeQueries\` \u2014 DAX \u5B9F\u884C (body: \`{ queries: [{ query: "EVALUATE ..." }], serializerSettings: { includeNulls: true } }\`)
27948
+ - POST \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u66F4\u65B0\u30C8\u30EA\u30AC\u30FC
27949
+ - GET \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 \u76F4\u8FD1\u306E\u66F4\u65B0\u5C65\u6B74
27950
+
27951
+ #### DAX Tips
27952
+ - \`EVALUATE TOPN(10, 'TableName')\` \u2014 \u30C6\u30FC\u30D6\u30EB\u304B\u3089 10 \u884C\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
27953
+ - \`EVALUATE SUMMARIZECOLUMNS('Date'[Year], "Sales", SUM('Sales'[Amount]))\` \u2014 \u96C6\u8A08
27954
+ - \`executeQueries\` \u306F\u73FE\u72B6 1 \u30EA\u30AF\u30A8\u30B9\u30C8\u306B\u3064\u304D 1 \u30AF\u30A8\u30EA\u306E\u307F\u3002\u7D50\u679C\u306F\u6700\u5927 10 \u4E07\u884C\u307E\u3067\u30B5\u30FC\u30D0\u30FC\u5074\u3067\u5207\u308A\u8A70\u3081\u3089\u308C\u307E\u3059`
27955
+ },
27956
+ tools: tools80,
27957
+ async checkConnection(params) {
27958
+ const tenantId = params[parameters80.tenantId.slug];
27959
+ const clientId = params[parameters80.clientId.slug];
27960
+ const clientSecret = params[parameters80.clientSecret.slug];
27961
+ if (!tenantId || !clientId || !clientSecret) {
27962
+ return {
27963
+ success: false,
27964
+ error: "Missing required parameters: tenant-id, client-id, client-secret"
27965
+ };
27966
+ }
27967
+ try {
27968
+ const tokenUrl = `https://login.microsoftonline.com/${encodeURIComponent(tenantId)}/oauth2/v2.0/token`;
27969
+ const body = new URLSearchParams({
27970
+ grant_type: "client_credentials",
27971
+ client_id: clientId,
27972
+ client_secret: clientSecret,
27973
+ scope: "https://analysis.windows.net/powerbi/api/.default"
27974
+ });
27975
+ const tokenRes = await fetch(tokenUrl, {
27976
+ method: "POST",
27977
+ headers: { "Content-Type": "application/x-www-form-urlencoded" },
27978
+ body: body.toString()
27979
+ });
27980
+ if (!tokenRes.ok) {
27981
+ const errorText = await tokenRes.text().catch(() => tokenRes.statusText);
27982
+ return {
27983
+ success: false,
27984
+ error: `Power BI token request failed: HTTP ${tokenRes.status} ${errorText}`
27985
+ };
27986
+ }
27987
+ const { access_token } = await tokenRes.json();
27988
+ const apiRes = await fetch(
27989
+ "https://api.powerbi.com/v1.0/myorg/groups?$top=1",
27990
+ {
27991
+ method: "GET",
27992
+ headers: {
27993
+ Authorization: `Bearer ${access_token}`,
27994
+ Accept: "application/json"
27995
+ }
27996
+ }
27997
+ );
27998
+ if (!apiRes.ok) {
27999
+ const errorText = await apiRes.text().catch(() => apiRes.statusText);
28000
+ return {
28001
+ success: false,
28002
+ error: `Power BI API failed: HTTP ${apiRes.status} ${errorText}`
28003
+ };
28004
+ }
28005
+ return { success: true };
28006
+ } catch (error) {
28007
+ return {
28008
+ success: false,
28009
+ error: error instanceof Error ? error.message : String(error)
28010
+ };
28011
+ }
28012
+ }
28013
+ });
28014
+
28015
+ // ../connectors/src/connectors/powerbi-oauth/tools/request.ts
28016
+ import { z as z98 } from "zod";
28017
+ var BASE_HOST13 = "https://api.powerbi.com";
28018
+ var BASE_PATH_SEGMENT16 = "/v1.0/myorg";
28019
+ var BASE_URL42 = `${BASE_HOST13}${BASE_PATH_SEGMENT16}`;
28020
+ var REQUEST_TIMEOUT_MS75 = 6e4;
28021
+ var cachedToken32 = null;
28022
+ async function getProxyToken32(config) {
28023
+ if (cachedToken32 && cachedToken32.expiresAt > Date.now() + 6e4) {
28024
+ return cachedToken32.token;
28025
+ }
28026
+ const url = `${config.appApiBaseUrl}/v0/database/${config.projectId}/environment/${config.environmentId}/oauth-request-proxy-token`;
28027
+ const res = await fetch(url, {
28028
+ method: "POST",
28029
+ headers: {
28030
+ "Content-Type": "application/json",
28031
+ "x-api-key": config.appApiKey,
28032
+ "project-id": config.projectId
28033
+ },
28034
+ body: JSON.stringify({
28035
+ sandboxId: config.sandboxId,
28036
+ issuedBy: "coding-agent"
28037
+ })
28038
+ });
28039
+ if (!res.ok) {
28040
+ const errorText = await res.text().catch(() => res.statusText);
28041
+ throw new Error(
28042
+ `Failed to get proxy token: HTTP ${res.status} ${errorText}`
28043
+ );
28044
+ }
28045
+ const data = await res.json();
28046
+ cachedToken32 = {
28047
+ token: data.token,
28048
+ expiresAt: new Date(data.expiresAt).getTime()
28049
+ };
28050
+ return data.token;
28051
+ }
28052
+ var inputSchema98 = z98.object({
28053
+ toolUseIntent: z98.string().optional().describe(
28054
+ "Brief description of what you intend to accomplish with this tool call"
28055
+ ),
28056
+ connectionId: z98.string().describe("ID of the Power BI OAuth connection to use"),
28057
+ method: z98.enum(["GET", "POST", "PATCH", "PUT", "DELETE"]).describe(
28058
+ "HTTP method. GET for reading workspaces/datasets/reports, POST for executeQueries / refresh, PATCH/PUT for updates, DELETE for removal."
28059
+ ),
28060
+ path: z98.string().describe(
28061
+ "API path appended to https://api.powerbi.com/v1.0/myorg (e.g., '/groups', '/groups/{groupId}/datasets'). The authenticated user must have access to the workspace."
28062
+ ),
28063
+ queryParams: z98.record(z98.string(), z98.string()).optional().describe(
28064
+ `Query parameters to append (e.g., { $top: '50', $filter: "name eq 'Sales'" }).`
28065
+ ),
28066
+ body: z98.record(z98.string(), z98.unknown()).optional().describe(
28067
+ "JSON request body for POST/PATCH/PUT/DELETE. Example executeQueries body: { queries: [{ query: 'EVALUATE TOPN(10, Sales)' }], serializerSettings: { includeNulls: true } }."
28068
+ )
28069
+ });
28070
+ var outputSchema98 = z98.discriminatedUnion("success", [
28071
+ z98.object({
28072
+ success: z98.literal(true),
28073
+ status: z98.number(),
28074
+ data: z98.unknown()
28075
+ }),
28076
+ z98.object({
28077
+ success: z98.literal(false),
28078
+ error: z98.string()
28079
+ })
28080
+ ]);
28081
+ var requestTool57 = new ConnectorTool({
28082
+ name: "request",
28083
+ description: `Send authenticated requests to the Power BI REST API v1.0 using the user's Microsoft Entra OAuth token (proxied automatically).
28084
+ All paths are relative to https://api.powerbi.com/v1.0/myorg. Use the executeQueries endpoint to run DAX against a dataset.
28085
+ The signed-in user must have access to the workspace; unlike Service Principals, OAuth users can also access "My workspace" via the \`/datasets\` (without \`/groups/\`) endpoints.`,
28086
+ inputSchema: inputSchema98,
28087
+ outputSchema: outputSchema98,
28088
+ async execute({ connectionId, method, path: path5, queryParams, body }, connections, config) {
28089
+ const connection = connections.find((c) => c.id === connectionId);
28090
+ if (!connection) {
28091
+ return {
28092
+ success: false,
28093
+ error: `Connection ${connectionId} not found`
28094
+ };
28095
+ }
28096
+ console.log(
28097
+ `[connector-request] powerbi-oauth/${connection.name}: ${method} ${path5}`
28098
+ );
28099
+ try {
28100
+ const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT16);
28101
+ let url = `${BASE_URL42}${normalizedPath}`;
28102
+ if (queryParams) {
28103
+ const searchParams = new URLSearchParams(queryParams);
28104
+ url += `?${searchParams.toString()}`;
28105
+ }
28106
+ const token = await getProxyToken32(config.oauthProxy);
28107
+ const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
28108
+ const controller = new AbortController();
28109
+ const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS75);
28110
+ try {
28111
+ const response = await fetch(proxyUrl, {
28112
+ method: "POST",
28113
+ headers: {
28114
+ "Content-Type": "application/json",
28115
+ Authorization: `Bearer ${token}`
28116
+ },
28117
+ body: JSON.stringify({
28118
+ url,
28119
+ method,
28120
+ ...body !== void 0 ? { body } : {}
28121
+ }),
28122
+ signal: controller.signal
28123
+ });
28124
+ const text = await response.text();
28125
+ const data = text ? (() => {
28126
+ try {
28127
+ return JSON.parse(text);
28128
+ } catch {
28129
+ return text;
28130
+ }
28131
+ })() : null;
28132
+ if (!response.ok) {
28133
+ const errorMessage = data && typeof data === "object" && "error" in data ? JSON.stringify(data.error) : typeof data === "string" && data ? data : `HTTP ${response.status} ${response.statusText}`;
28134
+ return { success: false, error: errorMessage };
28135
+ }
28136
+ return { success: true, status: response.status, data };
28137
+ } finally {
28138
+ clearTimeout(timeout);
28139
+ }
28140
+ } catch (err) {
28141
+ const msg = err instanceof Error ? err.message : String(err);
28142
+ return { success: false, error: msg };
28143
+ }
28144
+ }
28145
+ });
28146
+
28147
+ // ../connectors/src/connectors/powerbi-oauth/setup.ts
28148
+ var requestToolName13 = `powerbi-oauth_${requestTool57.name}`;
28149
+ var powerbiOauthOnboarding = new ConnectorOnboarding({
28150
+ connectionSetupInstructions: {
28151
+ ja: `Power BI OAuth \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u306F\u4EE5\u4E0B\u306E\u624B\u9806\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
28152
+
28153
+ 1. \`${requestToolName13}\` \u3092 \`method: "GET"\`\u3001\`path: "/groups"\` \u3067\u547C\u3073\u51FA\u3057\u3001\u30E6\u30FC\u30B6\u30FC\u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B
28154
+ 2. \u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u3001OAuth \u8A8D\u8A3C\u304C\u6B63\u3057\u304F\u5B8C\u4E86\u3057\u3066\u3044\u308B\u304B\u78BA\u8A8D\u3059\u308B\u3088\u3046\u30E6\u30FC\u30B6\u30FC\u306B\u4F1D\u3048\u308B
28155
+
28156
+ #### \u5236\u7D04
28157
+ - **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B DAX \u30AF\u30A8\u30EA\u306E\u5B9F\u884C\u3084\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306E\u66F4\u65B0\u3092\u884C\u308F\u306A\u3044\u3053\u3068**\u3002\u4E0A\u8A18\u306E\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u53D6\u5F97\u306E\u307F\u8A31\u53EF
28158
+ - \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057`,
28159
+ en: `Follow these steps to set up the Power BI OAuth connection.
28160
+
28161
+ 1. Call \`${requestToolName13}\` with \`method: "GET"\` and \`path: "/groups"\` to list the workspaces the user has access to
28162
+ 2. If an error is returned, ask the user to verify that OAuth authentication completed correctly
28163
+
28164
+ #### Constraints
28165
+ - **Do NOT execute DAX queries or refresh datasets during setup**. Only the workspace listing above is allowed
28166
+ - Write only 1 sentence between tool calls, then immediately call the next tool`
28167
+ },
28168
+ dataOverviewInstructions: {
28169
+ en: `1. Call powerbi-oauth_request with GET /groups to list accessible workspaces
28170
+ 2. For a target workspace, call powerbi-oauth_request with GET /groups/{groupId}/datasets to list datasets
28171
+ 3. Call powerbi-oauth_request with GET /groups/{groupId}/reports to list reports
28172
+ 4. For each interesting dataset call powerbi-oauth_request with GET /groups/{groupId}/datasets/{datasetId}/tables to inspect tables`,
28173
+ ja: `1. powerbi-oauth_request \u3067 GET /groups \u3092\u547C\u3073\u51FA\u3057\u3001\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97
28174
+ 2. \u5BFE\u8C61\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u306B\u5BFE\u3057\u3066 powerbi-oauth_request \u3067 GET /groups/{groupId}/datasets \u3092\u547C\u3073\u51FA\u3057\u3001\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
28175
+ 3. powerbi-oauth_request \u3067 GET /groups/{groupId}/reports \u3092\u547C\u3073\u51FA\u3057\u3001\u30EC\u30DD\u30FC\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
28176
+ 4. \u8208\u5473\u306E\u3042\u308B\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u306B\u3064\u3044\u3066 powerbi-oauth_request \u3067 GET /groups/{groupId}/datasets/{datasetId}/tables \u3092\u547C\u3073\u51FA\u3057\u3001\u30C6\u30FC\u30D6\u30EB\u69CB\u9020\u3092\u78BA\u8A8D`
28177
+ }
28178
+ });
28179
+
28180
+ // ../connectors/src/connectors/powerbi-oauth/parameters.ts
28181
+ var parameters81 = {};
28182
+
28183
+ // ../connectors/src/connectors/powerbi-oauth/index.ts
28184
+ var tools81 = { request: requestTool57 };
28185
+ var powerbiOauthConnector = new ConnectorPlugin({
28186
+ slug: "powerbi",
28187
+ authType: AUTH_TYPES.OAUTH,
28188
+ name: "Power BI",
28189
+ description: "Connect to Microsoft Power BI using OAuth (Microsoft Entra ID). Use it to enumerate workspaces, datasets, and reports the signed-in user has access to, and to run DAX queries.",
28190
+ iconUrl: "https://upload.wikimedia.org/wikipedia/commons/c/cf/New_Power_BI_Logo.svg",
28191
+ parameters: parameters81,
28192
+ releaseFlag: { dev1: true, dev2: false, prod: false },
28193
+ categories: ["other"],
28194
+ onboarding: powerbiOauthOnboarding,
28195
+ proxyPolicy: {
28196
+ allowlist: [
28197
+ {
28198
+ host: "api.powerbi.com",
28199
+ methods: ["GET", "POST", "PATCH", "PUT", "DELETE"]
28200
+ }
28201
+ ]
28202
+ },
28203
+ systemPrompt: {
28204
+ en: `### Tools
28205
+
28206
+ - \`powerbi-oauth_request\`: The only way to call the Power BI REST API v1.0. Use it to list workspaces (\`/groups\`), datasets, reports, and to run DAX via the \`executeQueries\` endpoint. Authentication is configured automatically via OAuth (Microsoft Entra ID).
28207
+
28208
+ ### Business Logic
28209
+
28210
+ The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT access credentials directly from environment variables and do NOT read \`INTERNAL_SQUADBASE_*\` env vars \u2014 the SDK takes care of OAuth.
28211
+
28212
+ SDK surface (client created via \`connection(connectionId)\`):
28213
+ - \`client.request(path, init?)\` \u2014 low-level authenticated fetch (path appended to \`https://api.powerbi.com/v1.0/myorg\`)
28214
+ - \`client.listGroups(options?)\` \u2014 list workspaces (\`$top\`, \`$skip\`, \`$filter\`)
28215
+ - \`client.listDatasets(groupId)\` / \`client.listReports(groupId)\` \u2014 list datasets / reports in a workspace
28216
+ - \`client.getDataset(groupId, datasetId)\` \u2014 fetch a single dataset
28217
+ - \`client.executeQueries(groupId, datasetId, queries, options?)\` \u2014 run DAX queries
28218
+ - \`client.refreshDataset(groupId, datasetId, options?)\` \u2014 trigger an async refresh
28219
+
28220
+ If a handler test fails with \`Connection proxy is not configured\`, retry \u2014 the sandbox is still initializing. Do NOT abandon the SDK and construct OAuth proxy URLs manually.
28221
+
28222
+ \`\`\`ts
28223
+ import type { Context } from "hono";
28224
+ import { connection } from "@squadbase/vite-server/connectors/powerbi-oauth";
28225
+
28226
+ const powerbi = connection("<connectionId>");
28227
+
28228
+ export default async function handler(c: Context) {
28229
+ const { groupId, datasetId, dax } = await c.req.json<{
28230
+ groupId: string;
28231
+ datasetId: string;
28232
+ dax: string;
28233
+ }>();
28234
+
28235
+ const result = await powerbi.executeQueries(groupId, datasetId, [dax]);
28236
+ const rows = result.results[0]?.tables[0]?.rows ?? [];
28237
+ return c.json({ rows });
28238
+ }
28239
+ \`\`\`
28240
+
28241
+ ### Power BI REST API Reference
28242
+
28243
+ - Base URL: \`https://api.powerbi.com/v1.0/myorg\`
28244
+ - Authentication: Microsoft Entra OAuth (delegated; handled automatically)
28245
+ - Unlike Service Principals, OAuth users can also access "My workspace" via the \`/datasets\` (without \`/groups/\`) endpoints
28246
+
28247
+ #### Common Endpoints
28248
+ - GET \`/groups\` \u2014 List workspaces the signed-in user has access to
28249
+ - GET \`/groups/{groupId}/datasets\` \u2014 List datasets in a workspace
28250
+ - GET \`/groups/{groupId}/datasets/{datasetId}\` \u2014 Get dataset metadata
28251
+ - GET \`/groups/{groupId}/reports\` \u2014 List reports
28252
+ - POST \`/groups/{groupId}/datasets/{datasetId}/executeQueries\` \u2014 Run DAX (body: \`{ queries: [{ query: "EVALUATE ..." }], serializerSettings: { includeNulls: true } }\`)
28253
+ - POST \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 Trigger a dataset refresh
28254
+ - GET \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 List recent refresh history
28255
+
28256
+ #### DAX Tips
28257
+ - \`EVALUATE TOPN(10, 'TableName')\` \u2014 sample 10 rows from a table
28258
+ - \`EVALUATE SUMMARIZECOLUMNS('Date'[Year], "Sales", SUM('Sales'[Amount]))\` \u2014 aggregate
28259
+ - Each \`executeQueries\` call accepts one query in the \`queries\` array (per current Power BI API limits)`,
28260
+ ja: `### \u30C4\u30FC\u30EB
28261
+
28262
+ - \`powerbi-oauth_request\`: Power BI REST API v1.0 \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9 (\`/groups\`)\u3001\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u3001\u30EC\u30DD\u30FC\u30C8\u306E\u4E00\u89A7\u53D6\u5F97\u3084\u3001\`executeQueries\` \u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306B\u3088\u308B DAX \u306E\u5B9F\u884C\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002OAuth (Microsoft Entra ID) \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
28263
+
28264
+ ### Business Logic
28265
+
28266
+ \u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BF SDK \u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002\`INTERNAL_SQUADBASE_*\` \u306E\u74B0\u5883\u5909\u6570\u3092\u4F7F\u3063\u3066\u624B\u52D5\u3067 OAuth \u30D7\u30ED\u30AD\u30B7\u3092\u53E9\u304F\u3053\u3068\u3082\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044 \u2014 SDK \u304C OAuth \u3092\u51E6\u7406\u3057\u307E\u3059\u3002
28267
+
28268
+ SDK (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
28269
+ - \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304D fetch (path \u306F \`https://api.powerbi.com/v1.0/myorg\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059)
28270
+ - \`client.listGroups(options?)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7 (\`$top\`, \`$skip\`, \`$filter\`)
28271
+ - \`client.listDatasets(groupId)\` / \`client.listReports(groupId)\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8/\u30EC\u30DD\u30FC\u30C8\u4E00\u89A7
28272
+ - \`client.getDataset(groupId, datasetId)\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u5358\u4F53\u53D6\u5F97
28273
+ - \`client.executeQueries(groupId, datasetId, queries, options?)\` \u2014 DAX \u30AF\u30A8\u30EA\u5B9F\u884C
28274
+ - \`client.refreshDataset(groupId, datasetId, options?)\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u66F4\u65B0\u3092\u975E\u540C\u671F\u30C8\u30EA\u30AC\u30FC
28275
+
28276
+ \u30CF\u30F3\u30C9\u30E9\u306E\u30C6\u30B9\u30C8\u304C \`Connection proxy is not configured\` \u3067\u5931\u6557\u3059\u308B\u5834\u5408\u306F\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002SDK \u3092\u8AE6\u3081\u3066 OAuth \u30D7\u30ED\u30AD\u30B7\u306E URL \u3092\u81EA\u5206\u3067\u7D44\u307F\u7ACB\u3066\u308B\u3053\u3068\u306F **\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044**\u3002
28277
+
28278
+ \`\`\`ts
28279
+ import type { Context } from "hono";
28280
+ import { connection } from "@squadbase/vite-server/connectors/powerbi-oauth";
28281
+
28282
+ const powerbi = connection("<connectionId>");
28283
+
28284
+ export default async function handler(c: Context) {
28285
+ const { groupId, datasetId, dax } = await c.req.json<{
28286
+ groupId: string;
28287
+ datasetId: string;
28288
+ dax: string;
28289
+ }>();
28290
+
28291
+ const result = await powerbi.executeQueries(groupId, datasetId, [dax]);
28292
+ const rows = result.results[0]?.tables[0]?.rows ?? [];
28293
+ return c.json({ rows });
28294
+ }
28295
+ \`\`\`
28296
+
28297
+ ### Power BI REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
28298
+
28299
+ - \u30D9\u30FC\u30B9 URL: \`https://api.powerbi.com/v1.0/myorg\`
28300
+ - \u8A8D\u8A3C: Microsoft Entra OAuth (\u59D4\u4EFB\u578B\u3001\u81EA\u52D5\u8A2D\u5B9A)
28301
+ - Service Principal \u3068\u7570\u306A\u308A\u3001OAuth \u30E6\u30FC\u30B6\u30FC\u306F \`/datasets\` (\`/groups/\` \u7121\u3057) \u3067\u300C\u30DE\u30A4 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u300D\u306B\u3082\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD
28302
+
28303
+ #### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
28304
+ - GET \`/groups\` \u2014 \u30E6\u30FC\u30B6\u30FC\u304C\u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u4E00\u89A7
28305
+ - GET \`/groups/{groupId}/datasets\` \u2014 \u30EF\u30FC\u30AF\u30B9\u30DA\u30FC\u30B9\u5185\u306E\u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u4E00\u89A7
28306
+ - GET \`/groups/{groupId}/datasets/{datasetId}\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8 \u30E1\u30BF\u30C7\u30FC\u30BF
28307
+ - GET \`/groups/{groupId}/reports\` \u2014 \u30EC\u30DD\u30FC\u30C8\u4E00\u89A7
28308
+ - POST \`/groups/{groupId}/datasets/{datasetId}/executeQueries\` \u2014 DAX \u5B9F\u884C (body: \`{ queries: [{ query: "EVALUATE ..." }], serializerSettings: { includeNulls: true } }\`)
28309
+ - POST \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 \u30C7\u30FC\u30BF\u30BB\u30C3\u30C8\u66F4\u65B0\u30C8\u30EA\u30AC\u30FC
28310
+ - GET \`/groups/{groupId}/datasets/{datasetId}/refreshes\` \u2014 \u76F4\u8FD1\u306E\u66F4\u65B0\u5C65\u6B74
28311
+
28312
+ #### DAX Tips
28313
+ - \`EVALUATE TOPN(10, 'TableName')\` \u2014 \u30C6\u30FC\u30D6\u30EB\u304B\u3089 10 \u884C\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
28314
+ - \`EVALUATE SUMMARIZECOLUMNS('Date'[Year], "Sales", SUM('Sales'[Amount]))\` \u2014 \u96C6\u8A08
28315
+ - \`executeQueries\` \u306F\u73FE\u72B6 1 \u30EA\u30AF\u30A8\u30B9\u30C8\u306B\u3064\u304D 1 \u30AF\u30A8\u30EA\u306E\u307F`
28316
+ },
28317
+ tools: tools81,
28318
+ async checkConnection(_params, config) {
28319
+ const { proxyFetch } = config;
28320
+ const url = "https://api.powerbi.com/v1.0/myorg/groups?$top=1";
28321
+ try {
28322
+ const res = await proxyFetch(url, { method: "GET" });
28323
+ if (!res.ok) {
28324
+ const errorText = await res.text().catch(() => res.statusText);
28325
+ return {
28326
+ success: false,
28327
+ error: `Power BI API failed: HTTP ${res.status} ${errorText}`
28328
+ };
28329
+ }
28330
+ return { success: true };
28331
+ } catch (error) {
28332
+ return {
28333
+ success: false,
28334
+ error: error instanceof Error ? error.message : String(error)
28335
+ };
28336
+ }
28337
+ }
28338
+ });
28339
+
28340
+ // ../connectors/src/connectors/tableau/setup.ts
28341
+ var tableauOnboarding = new ConnectorOnboarding({
28342
+ connectionSetupInstructions: {
28343
+ en: `Follow these steps to verify the Tableau PAT connection.
28344
+
28345
+ 1. Call \`tableau_request\` with \`method: "GET"\` and \`path: "/sites/{siteId}/projects?pageSize=5"\` to list a few projects on the signed-in site
28346
+ 2. If the call fails with HTTP 401, ask the user to confirm the PAT name/secret and that the Site Content URL matches the site where the PAT was issued (Tableau Cloud sites are case-sensitive)
28347
+
28348
+ #### Constraints
28349
+ - **Do NOT mutate Tableau resources during setup** (no publish/update/delete). Only the project listing above is allowed
28350
+ - The literal placeholder \`{siteId}\` in the path is automatically replaced with the session's site ID \u2014 do NOT hardcode the ID`,
28351
+ ja: `Tableau PAT \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u306F\u4EE5\u4E0B\u306E\u624B\u9806\u3067\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
28352
+
28353
+ 1. \`tableau_request\` \u3092 \`method: "GET"\`\u3001\`path: "/sites/{siteId}/projects?pageSize=5"\` \u3067\u547C\u3073\u51FA\u3057\u3001\u30B5\u30A4\u30F3\u30A4\u30F3\u5148\u30B5\u30A4\u30C8\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3092\u3044\u304F\u3064\u304B\u53D6\u5F97\u3059\u308B
28354
+ 2. HTTP 401 \u3067\u5931\u6557\u3057\u305F\u5834\u5408\u306F\u3001PAT \u540D/\u30B7\u30FC\u30AF\u30EC\u30C3\u30C8\u304A\u3088\u3073 Site Content URL \u304C PAT \u767A\u884C\u30B5\u30A4\u30C8\u3068\u4E00\u81F4\u3057\u3066\u3044\u308B\u304B\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u78BA\u8A8D\u3059\u308B\u3088\u3046\u4F1D\u3048\u308B\uFF08Tableau Cloud \u306E\u30B5\u30A4\u30C8\u540D\u306F\u5927\u6587\u5B57\u5C0F\u6587\u5B57\u3092\u533A\u5225\uFF09
28355
+
28356
+ #### \u5236\u7D04
28357
+ - **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B Tableau \u30EA\u30BD\u30FC\u30B9\u3092\u5909\u66F4\u3057\u306A\u3044\u3053\u3068**\uFF08publish/update/delete \u4E0D\u53EF\uFF09\u3002\u4E0A\u8A18\u306E\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u53D6\u5F97\u306E\u307F\u8A31\u53EF
28358
+ - \u30D1\u30B9\u5185\u306E\u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC \`{siteId}\` \u306F\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B5\u30A4\u30C8 ID \u3067\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059 \u2014 ID \u3092\u30CF\u30FC\u30C9\u30B3\u30FC\u30C9\u3057\u306A\u3044\u3053\u3068`
28359
+ },
28360
+ dataOverviewInstructions: {
28361
+ en: `1. Call tableau_request with GET /sites/{siteId}/projects to list projects
28362
+ 2. Call tableau_request with GET /sites/{siteId}/workbooks?pageSize=20 to list workbooks
28363
+ 3. For a target workbook, call tableau_request with GET /sites/{siteId}/workbooks/{workbookId}/views to list its views
28364
+ 4. Call tableau_request with GET /sites/{siteId}/datasources?pageSize=20 to list published data sources`,
28365
+ ja: `1. tableau_request \u3067 GET /sites/{siteId}/projects \u3092\u547C\u3073\u51FA\u3057\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7\u3092\u53D6\u5F97
28366
+ 2. tableau_request \u3067 GET /sites/{siteId}/workbooks?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u4E00\u89A7\u3092\u53D6\u5F97
28367
+ 3. \u5BFE\u8C61\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u306B\u3064\u3044\u3066 tableau_request \u3067 GET /sites/{siteId}/workbooks/{workbookId}/views \u3092\u547C\u3073\u51FA\u3057\u3001\u30D3\u30E5\u30FC\u4E00\u89A7\u3092\u53D6\u5F97
28368
+ 4. tableau_request \u3067 GET /sites/{siteId}/datasources?pageSize=20 \u3092\u547C\u3073\u51FA\u3057\u3001\u516C\u958B\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u4E00\u89A7\u3092\u53D6\u5F97`
28369
+ }
28370
+ });
28371
+
28372
+ // ../connectors/src/connectors/tableau/parameters.ts
28373
+ var parameters82 = {
28374
+ serverUrl: new ParameterDefinition({
28375
+ slug: "server-url",
28376
+ name: "Tableau Server URL",
28377
+ description: "Base URL of your Tableau Cloud / Server instance (no trailing slash). Examples: https://us-east-1.online.tableau.com, https://prod-useast-a.online.tableau.com, https://tableau.example.com.",
28378
+ envVarBaseKey: "TABLEAU_SERVER_URL",
28379
+ type: "text",
28380
+ secret: false,
28381
+ required: true
28382
+ }),
28383
+ siteContentUrl: new ParameterDefinition({
28384
+ slug: "site-content-url",
28385
+ name: "Site Content URL",
28386
+ description: "The site's content URL (the value after '/site/' in the Tableau URL). On Tableau Cloud this is required (e.g. 'mycompany'). On Tableau Server the Default site uses an empty string \u2014 pass an empty string explicitly.",
28387
+ envVarBaseKey: "TABLEAU_SITE_CONTENT_URL",
28388
+ type: "text",
28389
+ secret: false,
28390
+ required: true
28391
+ }),
28392
+ patName: new ParameterDefinition({
28393
+ slug: "pat-name",
28394
+ name: "Personal Access Token Name",
28395
+ description: "Name of the Personal Access Token (PAT) generated under Account Settings > Personal Access Tokens. The owning user's site role determines the API permissions.",
28396
+ envVarBaseKey: "TABLEAU_PAT_NAME",
28397
+ type: "text",
28398
+ secret: false,
28399
+ required: true
28400
+ }),
28401
+ patSecret: new ParameterDefinition({
28402
+ slug: "pat-secret",
28403
+ name: "Personal Access Token Secret",
28404
+ description: "Secret value shown once when the PAT is created. Tokens expire after 15 days of inactivity (default) and must be rotated regularly.",
28405
+ envVarBaseKey: "TABLEAU_PAT_SECRET",
28406
+ type: "text",
28407
+ secret: true,
28408
+ required: true
28409
+ }),
28410
+ apiVersion: new ParameterDefinition({
28411
+ slug: "api-version",
28412
+ name: "REST API Version",
28413
+ description: "Optional Tableau REST API version (e.g., '3.28'). Defaults to '3.28' which works with current Tableau Cloud and recent Tableau Server releases. Use the version listed at https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm if you need to pin.",
28414
+ envVarBaseKey: "TABLEAU_API_VERSION",
28415
+ type: "text",
28416
+ secret: false,
28417
+ required: false
28418
+ })
28419
+ };
28420
+
28421
+ // ../connectors/src/connectors/tableau/tools/request.ts
28422
+ import { z as z99 } from "zod";
28423
+ var DEFAULT_API_VERSION = "3.28";
28424
+ var REQUEST_TIMEOUT_MS76 = 6e4;
28425
+ var sessionCache = /* @__PURE__ */ new Map();
28426
+ function buildBaseUrl4(serverUrl, apiVersion) {
28427
+ return `${serverUrl.replace(/\/$/, "")}/api/${apiVersion}`;
28428
+ }
28429
+ async function signIn(serverUrl, apiVersion, siteContentUrl, patName, patSecret) {
28430
+ const url = `${buildBaseUrl4(serverUrl, apiVersion)}/auth/signin`;
28431
+ const body = {
28432
+ credentials: {
28433
+ personalAccessTokenName: patName,
28434
+ personalAccessTokenSecret: patSecret,
28435
+ site: { contentUrl: siteContentUrl }
28436
+ }
28437
+ };
28438
+ const res = await fetch(url, {
28439
+ method: "POST",
28440
+ headers: {
28441
+ "Content-Type": "application/json",
28442
+ Accept: "application/json"
28443
+ },
28444
+ body: JSON.stringify(body)
28445
+ });
28446
+ if (!res.ok) {
28447
+ const errorText = await res.text().catch(() => res.statusText);
28448
+ throw new Error(
28449
+ `Tableau sign-in failed: HTTP ${res.status} ${errorText}`
28450
+ );
28451
+ }
28452
+ const data = await res.json();
28453
+ return {
28454
+ authToken: data.credentials.token,
28455
+ siteId: data.credentials.site.id,
28456
+ userId: data.credentials.user.id,
28457
+ expiresAt: Date.now() + 30 * 60 * 1e3
28458
+ };
28459
+ }
28460
+ async function getSession(serverUrl, apiVersion, siteContentUrl, patName, patSecret) {
28461
+ const cacheKey = `${serverUrl}|${siteContentUrl}|${patName}`;
28462
+ const cached = sessionCache.get(cacheKey);
28463
+ if (cached && cached.expiresAt > Date.now() + 6e4) {
28464
+ return cached;
28465
+ }
28466
+ const session = await signIn(
28467
+ serverUrl,
28468
+ apiVersion,
28469
+ siteContentUrl,
28470
+ patName,
28471
+ patSecret
28472
+ );
28473
+ sessionCache.set(cacheKey, session);
28474
+ return session;
28475
+ }
28476
+ var inputSchema99 = z99.object({
28477
+ toolUseIntent: z99.string().optional().describe(
28478
+ "Brief description of what you intend to accomplish with this tool call"
28479
+ ),
28480
+ connectionId: z99.string().describe("ID of the Tableau connection to use"),
28481
+ method: z99.enum(["GET", "POST", "PUT", "DELETE"]).describe(
28482
+ "HTTP method. GET for listing/reading, POST for creating, PUT for updates, DELETE for removal."
28483
+ ),
28484
+ path: z99.string().describe(
28485
+ "API path appended to {serverUrl}/api/{apiVersion} (e.g., '/sites/{siteId}/projects', '/sites/{siteId}/workbooks/{workbookId}', '/sites/{siteId}/views/{viewId}/data'). The {siteId} placeholder is automatically replaced with the signed-in site ID."
28486
+ ),
28487
+ queryParams: z99.record(z99.string(), z99.string()).optional().describe(
28488
+ "Query parameters to append (e.g., { pageSize: '100', filter: 'name:eq:Sales' }). Tableau supports field filtering via 'fields' and sorting via 'sort'."
28489
+ ),
28490
+ body: z99.record(z99.string(), z99.unknown()).optional().describe(
28491
+ "JSON request body for POST/PUT (Tableau also accepts XML, but JSON is recommended with Accept: application/json)."
28492
+ )
28493
+ });
28494
+ var outputSchema99 = z99.discriminatedUnion("success", [
28495
+ z99.object({
28496
+ success: z99.literal(true),
28497
+ status: z99.number(),
28498
+ data: z99.unknown()
28499
+ }),
28500
+ z99.object({
28501
+ success: z99.literal(false),
28502
+ error: z99.string()
28503
+ })
28504
+ ]);
28505
+ var requestTool58 = new ConnectorTool({
28506
+ name: "request",
28507
+ description: `Send authenticated requests to the Tableau REST API.
28508
+ The tool signs in once with the configured Personal Access Token (PAT) to obtain an X-Tableau-Auth token (cached per connection), then forwards the request with the token attached.
28509
+ All paths are relative to {serverUrl}/api/{apiVersion}. Use the literal placeholder \`{siteId}\` in the path \u2014 it is automatically substituted with the site ID returned from sign-in.
28510
+ Accept and Content-Type headers default to application/json so list responses come back as JSON instead of Tableau's default XML.`,
28511
+ inputSchema: inputSchema99,
28512
+ outputSchema: outputSchema99,
28513
+ async execute({ connectionId, method, path: path5, queryParams, body }, connections) {
28514
+ const connection = connections.find((c) => c.id === connectionId);
28515
+ if (!connection) {
28516
+ return {
28517
+ success: false,
28518
+ error: `Connection ${connectionId} not found`
28519
+ };
28520
+ }
28521
+ console.log(
28522
+ `[connector-request] tableau/${connection.name}: ${method} ${path5}`
28523
+ );
28524
+ try {
28525
+ const serverUrl = parameters82.serverUrl.getValue(connection);
28526
+ const siteContentUrl = parameters82.siteContentUrl.getValue(connection);
28527
+ const patName = parameters82.patName.getValue(connection);
28528
+ const patSecret = parameters82.patSecret.getValue(connection);
28529
+ const apiVersion = parameters82.apiVersion.tryGetValue(connection) || DEFAULT_API_VERSION;
28530
+ const session = await getSession(
28531
+ serverUrl,
28532
+ apiVersion,
28533
+ siteContentUrl,
28534
+ patName,
28535
+ patSecret
28536
+ );
28537
+ const resolvedPath = path5.trim().replace(/\{siteId\}/g, session.siteId).replace(/^([^/])/, "/$1");
28538
+ let url = `${buildBaseUrl4(serverUrl, apiVersion)}${resolvedPath}`;
28539
+ if (queryParams) {
28540
+ const searchParams = new URLSearchParams(queryParams);
28541
+ url += `?${searchParams.toString()}`;
28542
+ }
28543
+ const controller = new AbortController();
28544
+ const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS76);
28545
+ try {
28546
+ const init = {
28547
+ method,
28548
+ headers: {
28549
+ "X-Tableau-Auth": session.authToken,
28550
+ Accept: "application/json",
28551
+ "Content-Type": "application/json"
28552
+ },
28553
+ signal: controller.signal
28554
+ };
28555
+ if (body !== void 0) {
28556
+ init.body = JSON.stringify(body);
28557
+ }
28558
+ const response = await fetch(url, init);
28559
+ const text = await response.text();
28560
+ const data = text ? (() => {
28561
+ try {
28562
+ return JSON.parse(text);
28563
+ } catch {
28564
+ return text;
28565
+ }
28566
+ })() : null;
28567
+ if (!response.ok) {
28568
+ const errorMessage = data && typeof data === "object" && "error" in data ? JSON.stringify(data.error) : typeof data === "string" && data ? data : `HTTP ${response.status} ${response.statusText}`;
28569
+ return { success: false, error: errorMessage };
28570
+ }
28571
+ return { success: true, status: response.status, data };
28572
+ } finally {
28573
+ clearTimeout(timeout);
28574
+ }
28575
+ } catch (err) {
28576
+ const msg = err instanceof Error ? err.message : String(err);
28577
+ return { success: false, error: msg };
28578
+ }
28579
+ }
28580
+ });
28581
+
28582
+ // ../connectors/src/connectors/tableau/index.ts
28583
+ var tools82 = { request: requestTool58 };
28584
+ var tableauConnector = new ConnectorPlugin({
28585
+ slug: "tableau",
28586
+ authType: AUTH_TYPES.PAT,
28587
+ name: "Tableau",
28588
+ description: "Connect to Tableau Cloud or Tableau Server via a Personal Access Token (PAT). Use it to enumerate projects, workbooks, views, and data sources, and to pull view data.",
28589
+ iconUrl: "https://upload.wikimedia.org/wikipedia/commons/4/4b/Tableau_Logo.png",
28590
+ parameters: parameters82,
28591
+ releaseFlag: { dev1: true, dev2: false, prod: false },
28592
+ categories: ["other"],
28593
+ onboarding: tableauOnboarding,
28594
+ systemPrompt: {
28595
+ en: `### Tools
28596
+
28597
+ - \`tableau_request\`: The only way to call the Tableau REST API. Use it for projects, workbooks, views, data sources, users, and permissions. The tool signs in once with the configured PAT to obtain an \`X-Tableau-Auth\` token (cached), then forwards each request with the token attached. Use the literal \`{siteId}\` placeholder in the path \u2014 it is replaced with the session's site ID automatically.
28598
+
28599
+ ### Business Logic
28600
+
28601
+ The business logic type for this connector is "typescript". Use the connector SDK in your handler. Do NOT read credentials from environment variables.
28602
+
28603
+ SDK methods (client created via \`connection(connectionId)\`):
28604
+ - \`client.request(path, init?)\` \u2014 low-level authenticated fetch (path is appended to \`{serverUrl}/api/{apiVersion}\`; \`{siteId}\` is substituted)
28605
+ - \`client.getSession()\` \u2014 sign in (if needed) and return \`{ authToken, siteId, userId }\`
28606
+ - \`client.listProjects(options?)\` / \`client.listWorkbooks(options?)\` / \`client.listDatasources(options?)\`
28607
+ - \`client.listViewsForWorkbook(workbookId)\`
28608
+ - \`client.getViewData(viewId)\` \u2014 returns the view's underlying data as CSV text
28609
+
28610
+ \`\`\`ts
28611
+ import type { Context } from "hono";
28612
+ import { connection } from "@squadbase/vite-server/connectors/tableau";
28613
+
28614
+ const tableau = connection("<connectionId>");
28615
+
28616
+ export default async function handler(c: Context) {
28617
+ const { pageSize = 20 } = await c.req.json<{ pageSize?: number }>();
28618
+ const { workbooks, pagination } = await tableau.listWorkbooks({ pageSize });
28619
+ return c.json({
28620
+ workbooks: workbooks.workbook,
28621
+ totalAvailable: Number(pagination.totalAvailable),
28622
+ });
28623
+ }
28624
+ \`\`\`
28625
+
28626
+ ### Tableau REST API Reference
28627
+
28628
+ - Base URL: \`{serverUrl}/api/{apiVersion}\` (default version 3.28; see https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)
28629
+ - Authentication: Sign-in with a PAT returns \`X-Tableau-Auth\` token, site ID, and user ID. Sessions expire after ~240 minutes idle on Tableau Cloud
28630
+ - Response format: JSON when \`Accept: application/json\` is sent (default); otherwise Tableau returns XML
28631
+ - Pagination: \`?pageSize=&pageNumber=\` query params with \`pagination\` object in response
28632
+
28633
+ #### Common Endpoints
28634
+ - POST \`/auth/signin\` \u2014 sign in (handled automatically)
28635
+ - POST \`/auth/signout\` \u2014 sign out
28636
+ - GET \`/sites/{siteId}/projects\` \u2014 list projects
28637
+ - GET \`/sites/{siteId}/workbooks\` \u2014 list workbooks (supports \`filter\`, \`sort\`)
28638
+ - GET \`/sites/{siteId}/workbooks/{workbookId}\` \u2014 get a workbook
28639
+ - GET \`/sites/{siteId}/workbooks/{workbookId}/views\` \u2014 list views in a workbook
28640
+ - GET \`/sites/{siteId}/views/{viewId}/data\` \u2014 get view data as CSV
28641
+ - GET \`/sites/{siteId}/views/{viewId}/image\` \u2014 get view as PNG
28642
+ - GET \`/sites/{siteId}/views/{viewId}/pdf\` \u2014 get view as PDF
28643
+ - GET \`/sites/{siteId}/datasources\` \u2014 list published data sources
28644
+ - GET \`/sites/{siteId}/users\` \u2014 list users
28645
+ - GET \`/sites/{siteId}/groups\` \u2014 list groups
28646
+
28647
+ #### Filter Syntax
28648
+ - \`filter=name:eq:Sales\` \u2014 exact match
28649
+ - \`filter=name:in:[Sales,Marketing]\` \u2014 set membership
28650
+ - \`filter=updatedAt:gte:2024-01-01T00:00:00Z\` \u2014 comparison operators (gt/gte/lt/lte)
28651
+ - Combine: \`filter=ownerName:eq:alice,tags:in:[finance]\``,
28652
+ ja: `### \u30C4\u30FC\u30EB
28653
+
28654
+ - \`tableau_request\`: Tableau REST API \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\u3002\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3001\u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u3001\u30D3\u30E5\u30FC\u3001\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u3001\u30E6\u30FC\u30B6\u30FC\u3001\u6A29\u9650\u306A\u3069\u306B\u4F7F\u7528\u3057\u307E\u3059\u3002\u8A2D\u5B9A\u3055\u308C\u305F PAT \u3067\u4E00\u5EA6\u30B5\u30A4\u30F3\u30A4\u30F3\u3057\u3066 \`X-Tableau-Auth\` \u30C8\u30FC\u30AF\u30F3\u3092\u53D6\u5F97 (\u30AD\u30E3\u30C3\u30B7\u30E5) \u3057\u3001\u5404\u30EA\u30AF\u30A8\u30B9\u30C8\u306B\u305D\u306E\u30C8\u30FC\u30AF\u30F3\u3092\u4ED8\u3051\u3066\u9001\u4FE1\u3057\u307E\u3059\u3002\u30D1\u30B9\u5185\u306B\u306F \`{siteId}\` \u30D7\u30EC\u30FC\u30B9\u30DB\u30EB\u30C0\u30FC\u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044 \u2014 \u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B5\u30A4\u30C8 ID \u3067\u81EA\u52D5\u7F6E\u63DB\u3055\u308C\u307E\u3059\u3002
28655
+
28656
+ ### Business Logic
28657
+
28658
+ \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\u30BF SDK \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
28659
+
28660
+ SDK \u30E1\u30BD\u30C3\u30C9 (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
28661
+ - \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304D fetch (path \u306F \`{serverUrl}/api/{apiVersion}\` \u306B\u8FFD\u52A0\u3055\u308C\u3001\`{siteId}\` \u306F\u7F6E\u63DB\u3055\u308C\u307E\u3059)
28662
+ - \`client.getSession()\` \u2014 \u30B5\u30A4\u30F3\u30A4\u30F3 (\u5FC5\u8981\u306A\u3089) \u3057\u3066 \`{ authToken, siteId, userId }\` \u3092\u8FD4\u3059
28663
+ - \`client.listProjects(options?)\` / \`client.listWorkbooks(options?)\` / \`client.listDatasources(options?)\`
28664
+ - \`client.listViewsForWorkbook(workbookId)\`
28665
+ - \`client.getViewData(viewId)\` \u2014 \u30D3\u30E5\u30FC\u306E\u30C7\u30FC\u30BF\u3092 CSV \u30C6\u30AD\u30B9\u30C8\u3067\u8FD4\u3059
28666
+
28667
+ \`\`\`ts
28668
+ import type { Context } from "hono";
28669
+ import { connection } from "@squadbase/vite-server/connectors/tableau";
28670
+
28671
+ const tableau = connection("<connectionId>");
28672
+
28673
+ export default async function handler(c: Context) {
28674
+ const { pageSize = 20 } = await c.req.json<{ pageSize?: number }>();
28675
+ const { workbooks, pagination } = await tableau.listWorkbooks({ pageSize });
28676
+ return c.json({
28677
+ workbooks: workbooks.workbook,
28678
+ totalAvailable: Number(pagination.totalAvailable),
28679
+ });
28680
+ }
28681
+ \`\`\`
28682
+
28683
+ ### Tableau REST API \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9
28684
+
28685
+ - \u30D9\u30FC\u30B9 URL: \`{serverUrl}/api/{apiVersion}\` (\u30C7\u30D5\u30A9\u30EB\u30C8\u30D0\u30FC\u30B8\u30E7\u30F3 3.28; https://help.tableau.com/current/api/rest_api/en-us/REST/rest_api_concepts_versions.htm)
28686
+ - \u8A8D\u8A3C: PAT \u3067\u30B5\u30A4\u30F3\u30A4\u30F3\u3059\u308B\u3068 \`X-Tableau-Auth\` \u30C8\u30FC\u30AF\u30F3\u3001\u30B5\u30A4\u30C8 ID\u3001\u30E6\u30FC\u30B6\u30FC ID \u304C\u8FD4\u3055\u308C\u308B\u3002Tableau Cloud \u3067\u306F\u7D04 240 \u5206\u306E\u30A2\u30A4\u30C9\u30EB\u3067\u30BB\u30C3\u30B7\u30E7\u30F3\u5931\u52B9
28687
+ - \u30EC\u30B9\u30DD\u30F3\u30B9\u5F62\u5F0F: \`Accept: application/json\` \u3092\u9001\u308B\u3068 JSON (\u30C7\u30D5\u30A9\u30EB\u30C8)\u3002\u9001\u3089\u306A\u3044\u5834\u5408\u306F XML
28688
+ - \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3: \`?pageSize=&pageNumber=\` \u30AF\u30A8\u30EA\u3002\u30EC\u30B9\u30DD\u30F3\u30B9\u306B \`pagination\` \u30AA\u30D6\u30B8\u30A7\u30AF\u30C8
28689
+
28690
+ #### \u4E3B\u8981\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
28691
+ - POST \`/auth/signin\` \u2014 \u30B5\u30A4\u30F3\u30A4\u30F3 (\u81EA\u52D5\u51E6\u7406)
28692
+ - POST \`/auth/signout\` \u2014 \u30B5\u30A4\u30F3\u30A2\u30A6\u30C8
28693
+ - GET \`/sites/{siteId}/projects\` \u2014 \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u4E00\u89A7
28694
+ - GET \`/sites/{siteId}/workbooks\` \u2014 \u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u4E00\u89A7 (\`filter\`, \`sort\` \u5BFE\u5FDC)
28695
+ - GET \`/sites/{siteId}/workbooks/{workbookId}\` \u2014 \u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u53D6\u5F97
28696
+ - GET \`/sites/{siteId}/workbooks/{workbookId}/views\` \u2014 \u30EF\u30FC\u30AF\u30D6\u30C3\u30AF\u5185\u306E\u30D3\u30E5\u30FC\u4E00\u89A7
28697
+ - GET \`/sites/{siteId}/views/{viewId}/data\` \u2014 \u30D3\u30E5\u30FC\u30C7\u30FC\u30BF\u3092 CSV \u3067\u53D6\u5F97
28698
+ - GET \`/sites/{siteId}/views/{viewId}/image\` \u2014 \u30D3\u30E5\u30FC\u3092 PNG \u3067\u53D6\u5F97
28699
+ - GET \`/sites/{siteId}/views/{viewId}/pdf\` \u2014 \u30D3\u30E5\u30FC\u3092 PDF \u3067\u53D6\u5F97
28700
+ - GET \`/sites/{siteId}/datasources\` \u2014 \u516C\u958B\u30C7\u30FC\u30BF\u30BD\u30FC\u30B9\u4E00\u89A7
28701
+ - GET \`/sites/{siteId}/users\` \u2014 \u30E6\u30FC\u30B6\u30FC\u4E00\u89A7
28702
+ - GET \`/sites/{siteId}/groups\` \u2014 \u30B0\u30EB\u30FC\u30D7\u4E00\u89A7
28703
+
28704
+ #### \u30D5\u30A3\u30EB\u30BF\u69CB\u6587
28705
+ - \`filter=name:eq:Sales\` \u2014 \u5B8C\u5168\u4E00\u81F4
28706
+ - \`filter=name:in:[Sales,Marketing]\` \u2014 \u96C6\u5408\u306B\u542B\u307E\u308C\u308B
28707
+ - \`filter=updatedAt:gte:2024-01-01T00:00:00Z\` \u2014 \u6BD4\u8F03\u6F14\u7B97\u5B50 (gt/gte/lt/lte)
28708
+ - \u7D44\u307F\u5408\u308F\u305B: \`filter=ownerName:eq:alice,tags:in:[finance]\``
28709
+ },
28710
+ tools: tools82,
28711
+ async checkConnection(params) {
28712
+ const serverUrl = params[parameters82.serverUrl.slug];
28713
+ const siteContentUrl = params[parameters82.siteContentUrl.slug];
28714
+ const patName = params[parameters82.patName.slug];
28715
+ const patSecret = params[parameters82.patSecret.slug];
28716
+ const apiVersion = params[parameters82.apiVersion.slug] || "3.28";
28717
+ if (!serverUrl || siteContentUrl == null || !patName || !patSecret) {
28718
+ return {
28719
+ success: false,
28720
+ error: "Missing required parameters: server-url, site-content-url, pat-name, pat-secret"
28721
+ };
28722
+ }
28723
+ try {
28724
+ const res = await fetch(
28725
+ `${serverUrl.replace(/\/$/, "")}/api/${apiVersion}/auth/signin`,
28726
+ {
28727
+ method: "POST",
28728
+ headers: {
28729
+ "Content-Type": "application/json",
28730
+ Accept: "application/json"
28731
+ },
28732
+ body: JSON.stringify({
28733
+ credentials: {
28734
+ personalAccessTokenName: patName,
28735
+ personalAccessTokenSecret: patSecret,
28736
+ site: { contentUrl: siteContentUrl }
28737
+ }
28738
+ })
28739
+ }
28740
+ );
28741
+ if (!res.ok) {
28742
+ const errorText = await res.text().catch(() => res.statusText);
28743
+ return {
28744
+ success: false,
28745
+ error: `Tableau sign-in failed: HTTP ${res.status} ${errorText}`
28746
+ };
28747
+ }
28748
+ return { success: true };
28749
+ } catch (error) {
28750
+ return {
28751
+ success: false,
28752
+ error: error instanceof Error ? error.message : String(error)
28753
+ };
28754
+ }
28755
+ }
28756
+ });
28757
+
28758
+ // ../connectors/src/connectors/outlook-oauth/tools/request.ts
28759
+ import { z as z100 } from "zod";
28760
+ var BASE_HOST14 = "https://graph.microsoft.com";
28761
+ var BASE_PATH_SEGMENT17 = "/v1.0";
28762
+ var BASE_URL43 = `${BASE_HOST14}${BASE_PATH_SEGMENT17}`;
28763
+ var REQUEST_TIMEOUT_MS77 = 6e4;
28764
+ var cachedToken33 = null;
28765
+ async function getProxyToken33(config) {
28766
+ if (cachedToken33 && cachedToken33.expiresAt > Date.now() + 6e4) {
28767
+ return cachedToken33.token;
28768
+ }
28769
+ const url = `${config.appApiBaseUrl}/v0/database/${config.projectId}/environment/${config.environmentId}/oauth-request-proxy-token`;
28770
+ const res = await fetch(url, {
28771
+ method: "POST",
28772
+ headers: {
28773
+ "Content-Type": "application/json",
28774
+ "x-api-key": config.appApiKey,
28775
+ "project-id": config.projectId
28776
+ },
28777
+ body: JSON.stringify({
28778
+ sandboxId: config.sandboxId,
28779
+ issuedBy: "coding-agent"
28780
+ })
28781
+ });
28782
+ if (!res.ok) {
28783
+ const errorText = await res.text().catch(() => res.statusText);
28784
+ throw new Error(
28785
+ `Failed to get proxy token: HTTP ${res.status} ${errorText}`
28786
+ );
28787
+ }
28788
+ const data = await res.json();
28789
+ cachedToken33 = {
28790
+ token: data.token,
28791
+ expiresAt: new Date(data.expiresAt).getTime()
28792
+ };
28793
+ return data.token;
28794
+ }
28795
+ var inputSchema100 = z100.object({
28796
+ toolUseIntent: z100.string().optional().describe(
28797
+ "Brief description of what you intend to accomplish with this tool call"
28798
+ ),
28799
+ connectionId: z100.string().describe("ID of the Outlook OAuth connection to use"),
28800
+ method: z100.enum(["GET"]).describe("HTTP method (read-only, GET only)"),
28801
+ path: z100.string().describe(
28802
+ "Microsoft Graph path appended to https://graph.microsoft.com/v1.0. Covers Outlook Mail (e.g. '/me', '/me/messages', '/me/messages/{id}', '/me/mailFolders', '/me/messages/{id}/attachments') and Outlook Calendar (e.g. '/me/calendars', '/me/events', '/me/events/{id}', '/me/calendarView'). Use '/me' as the user prefix."
28803
+ ),
28804
+ queryParams: z100.record(z100.string(), z100.string()).optional().describe(
28805
+ `Query parameters to append. Microsoft Graph supports OData operators ($filter, $orderby, $top, $skip, $select, $expand, $search). Examples: { $top: '10', $select: 'subject,from,receivedDateTime' } for mail; { $filter: "conversationId eq '<id>'", $orderby: 'receivedDateTime asc' } for a thread; { startDateTime: '2025-01-15T00:00:00Z', endDateTime: '2025-01-16T00:00:00Z', $orderby: 'start/dateTime' } for calendarView.`
28806
+ )
28807
+ });
28808
+ var outputSchema100 = z100.discriminatedUnion("success", [
28809
+ z100.object({
28810
+ success: z100.literal(true),
28811
+ status: z100.number(),
28812
+ data: z100.record(z100.string(), z100.unknown())
28813
+ }),
28814
+ z100.object({
28815
+ success: z100.literal(false),
28816
+ error: z100.string()
28817
+ })
28818
+ ]);
28819
+ var requestTool59 = new ConnectorTool({
28820
+ name: "request",
28821
+ description: `Send authenticated GET requests to Microsoft Graph for Outlook Mail and Calendar.
28822
+ Authentication is handled automatically via OAuth proxy (Microsoft Entra ID).
28823
+ All paths are relative to https://graph.microsoft.com/v1.0. Use '/me' as the user prefix.
28824
+ Covers mailbox (\`/me/messages\`, \`/me/mailFolders\`), threads (\`/me/messages?$filter=conversationId eq '<id>'\`), attachments (\`/me/messages/{id}/attachments\`), calendars (\`/me/calendars\`), and events (\`/me/events\`, \`/me/calendarView\` for expanded occurrences).
28825
+ For full-text search use the \`$search\` query parameter (must be wrapped in double quotes); for filtering use \`$filter\` with OData syntax (e.g., \`receivedDateTime ge 2025-01-01T00:00:00Z\`).`,
28826
+ inputSchema: inputSchema100,
28827
+ outputSchema: outputSchema100,
28828
+ async execute({ connectionId, method, path: path5, queryParams }, connections, config) {
28829
+ const connection = connections.find((c) => c.id === connectionId);
28830
+ if (!connection) {
28831
+ return {
28832
+ success: false,
28833
+ error: `Connection ${connectionId} not found`
28834
+ };
28835
+ }
28836
+ console.log(
28837
+ `[connector-request] outlook-oauth/${connection.name}: ${method} ${path5}`
28838
+ );
28839
+ try {
28840
+ const normalizedPath = normalizeRequestPath(path5, BASE_PATH_SEGMENT17);
28841
+ let url = `${BASE_URL43}${normalizedPath}`;
28842
+ if (queryParams) {
28843
+ const searchParams = new URLSearchParams(queryParams);
28844
+ url += `?${searchParams.toString()}`;
28845
+ }
28846
+ const token = await getProxyToken33(config.oauthProxy);
28847
+ const proxyUrl = `https://${config.oauthProxy.sandboxId}.${config.oauthProxy.previewBaseDomain}/_sqcore/connections/${connectionId}/request`;
28848
+ const controller = new AbortController();
28849
+ const timeout = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS77);
28850
+ try {
28851
+ const response = await fetch(proxyUrl, {
28852
+ method: "POST",
28853
+ headers: {
28854
+ "Content-Type": "application/json",
28855
+ Authorization: `Bearer ${token}`
28856
+ },
28857
+ body: JSON.stringify({
28858
+ url,
28859
+ method
28860
+ }),
28861
+ signal: controller.signal
28862
+ });
28863
+ const data = await response.json();
28864
+ if (!response.ok) {
28865
+ const errorMessage = typeof data?.error === "string" ? data.error : typeof data?.message === "string" ? data.message : `HTTP ${response.status} ${response.statusText}`;
28866
+ return { success: false, error: errorMessage };
28867
+ }
28868
+ return { success: true, status: response.status, data };
28869
+ } finally {
28870
+ clearTimeout(timeout);
28871
+ }
28872
+ } catch (err) {
28873
+ const msg = err instanceof Error ? err.message : String(err);
28874
+ return { success: false, error: msg };
28875
+ }
28876
+ }
28877
+ });
28878
+
28879
+ // ../connectors/src/connectors/outlook-oauth/setup.ts
28880
+ var requestToolName14 = `outlook-oauth_${requestTool59.name}`;
28881
+ var outlookOnboarding = new ConnectorOnboarding({
28882
+ connectionSetupInstructions: {
28883
+ ja: `\u4EE5\u4E0B\u306E\u624B\u9806\u3067 Outlook \u30B3\u30CD\u30AF\u30B7\u30E7\u30F3\u306E\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u3092\u884C\u3063\u3066\u304F\u3060\u3055\u3044\u3002
28884
+
28885
+ 1. \`${requestToolName14}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u8A8D\u8A3C\u6E08\u307F\u30E6\u30FC\u30B6\u30FC\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u3092\u53D6\u5F97\u3059\u308B:
28886
+ - \`method\`: \`"GET"\`
28887
+ - \`path\`: \`"/me"\`
28888
+ 2. \u30A8\u30E9\u30FC\u304C\u8FD4\u3055\u308C\u305F\u5834\u5408\u306F\u3001OAuth \u8A8D\u8A3C\u304C\u6B63\u3057\u304F\u5B8C\u4E86\u3057\u3066\u3044\u308B\u304B\u3092\u30E6\u30FC\u30B6\u30FC\u306B\u78BA\u8A8D\u3059\u308B\u3088\u3046\u4F1D\u3048\u308B
28889
+ 3. \`${requestToolName14}\` \u3092\u547C\u3073\u51FA\u3057\u3066\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u3092\u53D6\u5F97\u3059\u308B:
28890
+ - \`method\`: \`"GET"\`
28891
+ - \`path\`: \`"/me/mailFolders"\`
28892
+
28893
+ #### \u5236\u7D04
28894
+ - **\u30BB\u30C3\u30C8\u30A2\u30C3\u30D7\u4E2D\u306B\u30E1\u30C3\u30BB\u30FC\u30B8\u672C\u6587\u3092\u8AAD\u307F\u53D6\u3089\u306A\u3044\u3053\u3068**\u3002\u5B9F\u884C\u3057\u3066\u3088\u3044\u306E\u306F\u4E0A\u8A18\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u53D6\u5F97\u3068\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u53D6\u5F97\u306E\u307F
28895
+ - \u30C4\u30FC\u30EB\u9593\u306F1\u6587\u3060\u3051\u66F8\u3044\u3066\u5373\u6B21\u306E\u30C4\u30FC\u30EB\u547C\u3073\u51FA\u3057`,
28896
+ en: `Follow these steps to set up the Outlook connection.
28897
+
28898
+ 1. Call \`${requestToolName14}\` to get the authenticated user's profile:
28899
+ - \`method\`: \`"GET"\`
28900
+ - \`path\`: \`"/me"\`
28901
+ 2. If an error is returned, ask the user to verify that OAuth authentication completed correctly
28902
+ 3. Call \`${requestToolName14}\` to get the mail folder list:
28903
+ - \`method\`: \`"GET"\`
28904
+ - \`path\`: \`"/me/mailFolders"\`
28905
+
28906
+ #### Constraints
28907
+ - **Do NOT read message bodies during setup**. Only the profile and mail-folder requests specified above are allowed
28908
+ - Write only 1 sentence between tool calls, then immediately call the next tool`
28909
+ },
28910
+ dataOverviewInstructions: {
28911
+ en: `Mail
28912
+ 1. Call outlook-oauth_request with GET /me/mailFolders to list mail folders
28913
+ 2. Call outlook-oauth_request with GET /me/messages?$top=5&$select=id,subject,from,receivedDateTime,conversationId to sample recent messages
28914
+ 3. Call outlook-oauth_request with GET /me/messages/{id} for an interesting message to inspect the full payload
28915
+ 4. Call outlook-oauth_request with GET /me/mailFolders/{folderId}/messages?$top=5 to drill into a specific folder
28916
+ 5. For threading, call outlook-oauth_request with GET /me/messages?$filter=conversationId%20eq%20'<id>'&$orderby=receivedDateTime%20asc to pull every message in a conversation
28917
+
28918
+ Calendar
28919
+ 6. Call outlook-oauth_request with GET /me/calendars to list calendars (default + shared)
28920
+ 7. Call outlook-oauth_request with GET /me/calendarView?startDateTime=<startISO>&endDateTime=<endISO>&$top=5&$select=id,subject,start,end,attendees to sample upcoming occurrences (expands recurring events)
28921
+ 8. Call outlook-oauth_request with GET /me/events/{eventId} for an interesting event to inspect attendees, body, and location`,
28922
+ ja: `\u30E1\u30FC\u30EB
28923
+ 1. outlook-oauth_request \u3067 GET /me/mailFolders \u3092\u547C\u3073\u51FA\u3057\u3001\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7\u3092\u53D6\u5F97
28924
+ 2. outlook-oauth_request \u3067 GET /me/messages?$top=5&$select=id,subject,from,receivedDateTime,conversationId \u3092\u547C\u3073\u51FA\u3057\u3001\u6700\u65B0\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0
28925
+ 3. \u8208\u5473\u306E\u3042\u308B\u30E1\u30C3\u30BB\u30FC\u30B8\u306B\u3064\u3044\u3066 outlook-oauth_request \u3067 GET /me/messages/{id} \u3092\u547C\u3073\u51FA\u3057\u3001\u30DA\u30A4\u30ED\u30FC\u30C9\u5168\u4F53\u3092\u78BA\u8A8D
28926
+ 4. outlook-oauth_request \u3067 GET /me/mailFolders/{folderId}/messages?$top=5 \u3092\u547C\u3073\u51FA\u3057\u3001\u7279\u5B9A\u30D5\u30A9\u30EB\u30C0\u306E\u4E2D\u8EAB\u3092\u78BA\u8A8D
28927
+ 5. \u30B9\u30EC\u30C3\u30C9\u3092\u8FFD\u3046\u5834\u5408\u306F outlook-oauth_request \u3067 GET /me/messages?$filter=conversationId%20eq%20'<id>'&$orderby=receivedDateTime%20asc \u3092\u547C\u3073\u51FA\u3057\u3001\u4F1A\u8A71\u306B\u542B\u307E\u308C\u308B\u5168\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97
28928
+
28929
+ \u30AB\u30EC\u30F3\u30C0\u30FC
28930
+ 6. outlook-oauth_request \u3067 GET /me/calendars \u3092\u547C\u3073\u51FA\u3057\u3001\u30AB\u30EC\u30F3\u30C0\u30FC\u4E00\u89A7 (\u30C7\u30D5\u30A9\u30EB\u30C8 + \u5171\u6709) \u3092\u53D6\u5F97
28931
+ 7. outlook-oauth_request \u3067 GET /me/calendarView?startDateTime=<startISO>&endDateTime=<endISO>&$top=5&$select=id,subject,start,end,attendees \u3092\u547C\u3073\u51FA\u3057\u3001\u76F4\u8FD1\u306E occurrence \u3092\u30B5\u30F3\u30D7\u30EA\u30F3\u30B0 (\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u3092\u5C55\u958B)
28932
+ 8. \u8208\u5473\u306E\u3042\u308B\u30A4\u30D9\u30F3\u30C8\u306B\u3064\u3044\u3066 outlook-oauth_request \u3067 GET /me/events/{eventId} \u3092\u547C\u3073\u51FA\u3057\u3001\u53C2\u52A0\u8005\u30FB\u672C\u6587\u30FB\u5834\u6240\u3092\u78BA\u8A8D`
28933
+ }
28934
+ });
28935
+
28936
+ // ../connectors/src/connectors/outlook-oauth/parameters.ts
28937
+ var parameters83 = {};
28938
+
28939
+ // ../connectors/src/connectors/outlook-oauth/index.ts
28940
+ var tools83 = { request: requestTool59 };
28941
+ var outlookOauthConnector = new ConnectorPlugin({
28942
+ slug: "outlook",
28943
+ authType: AUTH_TYPES.OAUTH,
28944
+ name: "Outlook",
28945
+ description: "Connect to Microsoft Outlook (Mail + Calendar) via Microsoft Graph using OAuth. Read-only access to the user's mailbox, mail folders, messages, attachments, calendars, and events.",
28946
+ iconUrl: "https://upload.wikimedia.org/wikipedia/commons/d/df/Microsoft_Office_Outlook_%282018%E2%80%93present%29.svg",
28947
+ parameters: parameters83,
28948
+ releaseFlag: { dev1: true, dev2: false, prod: false },
28949
+ categories: ["productivity"],
28950
+ onboarding: outlookOnboarding,
28951
+ proxyPolicy: {
28952
+ allowlist: [
28953
+ {
28954
+ host: "graph.microsoft.com",
28955
+ methods: ["GET"]
28956
+ }
28957
+ ]
28958
+ },
28959
+ systemPrompt: {
28960
+ en: `### Tools
28961
+
28962
+ - \`outlook-oauth_request\`: The only way to call Microsoft Graph for Outlook (read-only). Use it to fetch the user profile (\`/me\`), list mail folders (\`/me/mailFolders\`), read messages (\`/me/messages\`, \`/me/messages/{id}\`), fetch attachments (\`/me/messages/{id}/attachments\`), list calendars (\`/me/calendars\`), and read events (\`/me/events\`, \`/me/calendarView\`). Authentication is configured automatically via OAuth.
28963
+
28964
+ ### Microsoft Graph Reference (Outlook Mail)
28965
+
28966
+ #### Available Endpoints
28967
+ - GET \`/me\` \u2014 Get the signed-in user's profile (displayName, mail, userPrincipalName)
28968
+ - GET \`/me/mailFolders\` \u2014 List the user's mail folders (Inbox, SentItems, Drafts, etc.)
28969
+ - GET \`/me/mailFolders/{folderId}\` \u2014 Get a specific mail folder
28970
+ - GET \`/me/mailFolders/{folderId}/messages\` \u2014 List messages within a folder
28971
+ - GET \`/me/messages\` \u2014 List messages across all folders
28972
+ - GET \`/me/messages/{id}\` \u2014 Get a specific message with full body
28973
+ - GET \`/me/messages/{id}/attachments\` \u2014 List attachments on a message
28974
+ - GET \`/me/messages/{id}/attachments/{attachmentId}\` \u2014 Get a specific attachment
28975
+
28976
+ #### Well-Known Folder Names (usable in place of {folderId})
28977
+ - \`inbox\`, \`sentitems\`, \`drafts\`, \`deleteditems\`, \`junkemail\`, \`outbox\`, \`archive\`
28978
+
28979
+ #### Conversations (Threads)
28980
+ - Every message has a \`conversationId\`. Fetch all messages in a thread with: GET \`/me/messages?$filter=conversationId eq '<id>'&$orderby=receivedDateTime asc\` (Gmail-style \`getThread\` equivalent).
28981
+
28982
+ ### Microsoft Graph Reference (Outlook Calendar)
28983
+
28984
+ #### Available Endpoints
28985
+ - GET \`/me/calendars\` \u2014 List the user's calendars (default + any shared/group calendars)
28986
+ - GET \`/me/calendars/{calendarId}\` \u2014 Get a calendar's metadata
28987
+ - GET \`/me/events\` \u2014 List events on the default calendar (recurring events are returned as series masters \u2014 use \`/me/calendarView\` to expand)
28988
+ - GET \`/me/calendars/{calendarId}/events\` \u2014 List events on a specific calendar
28989
+ - GET \`/me/events/{eventId}\` \u2014 Get a single event
28990
+ - GET \`/me/calendarView?startDateTime=&endDateTime=\` \u2014 List event **occurrences** in a date range (expands recurring events). Equivalent to Google Calendar's \`events?singleEvents=true\`
28991
+ - GET \`/me/calendars/{calendarId}/calendarView?startDateTime=&endDateTime=\` \u2014 Same, scoped to a specific calendar
28992
+
28993
+ #### Calendar Tips
28994
+ - Use \`/me/calendarView\` when you want individual occurrences of recurring events; \`/me/events\` is closer to the raw stored series
28995
+ - \`startDateTime\` / \`endDateTime\` must be ISO-8601 UTC, e.g. \`2025-01-15T00:00:00Z\`
28996
+ - Combine with \`$select=subject,start,end,attendees,location\` and \`$orderby=start/dateTime\` to keep responses small and sorted
28997
+
28998
+ #### Key Query Parameters (OData, shared by Mail + Calendar)
28999
+ - \`$top\` \u2014 Maximum number of results (default 10, max 1000)
29000
+ - \`$skip\` \u2014 Skip the first N results (for paging)
29001
+ - \`$select\` \u2014 Comma-separated list of properties (e.g. \`subject,from,receivedDateTime,bodyPreview\`)
29002
+ - \`$orderby\` \u2014 Sort (e.g. \`receivedDateTime desc\`, \`start/dateTime asc\`)
29003
+ - \`$filter\` \u2014 OData filter (e.g. \`receivedDateTime ge 2025-01-01T00:00:00Z\`, \`from/emailAddress/address eq 'a@b.com'\`, \`isRead eq false\`, \`conversationId eq '<id>'\`, \`start/dateTime ge '2025-01-15T00:00:00'\`)
29004
+ - \`$search\` \u2014 Full-text search; must be wrapped in double quotes (e.g. \`$search="project status"\`). \`$search\` and \`$filter\` cannot be combined
29005
+ - \`$expand\` \u2014 Expand related resources (e.g. \`attachments\`, \`instances\` for recurring events)
29006
+ - \`$count=true\` \u2014 Return total count (requires \`ConsistencyLevel: eventual\` header on some endpoints)
29007
+
29008
+ #### Pagination
29009
+ - Responses include \`@odata.nextLink\` when more results exist; call that URL (or its path) to get the next page
29010
+
29011
+ #### Tips
29012
+ - Use \`/me\` for the signed-in user \u2014 never substitute another user ID
29013
+ - Prefer \`$select\` to avoid huge payloads; the full message body can be MB-sized when HTML
29014
+ - \`bodyPreview\` (first ~255 chars) is included by default and is cheap for triage
29015
+ - Date/time values are ISO-8601; calendar event times also include a \`timeZone\` field
29016
+
29017
+ ### Business Logic
29018
+
29019
+ The business logic type for this connector is "typescript". Write handler code using the connector SDK shown below. Do NOT access credentials directly from environment variables and do NOT read \`INTERNAL_SQUADBASE_*\` env vars \u2014 the SDK takes care of OAuth.
29020
+
29021
+ SDK surface (client created via \`connection(connectionId)\`):
29022
+
29023
+ Mail:
29024
+ - \`client.request(path, init?)\` \u2014 low-level authenticated fetch (path appended to \`https://graph.microsoft.com/v1.0\`)
29025
+ - \`client.getProfile()\` \u2014 fetch the authenticated user's profile
29026
+ - \`client.listMailFolders()\` \u2014 list all mail folders
29027
+ - \`client.listMessages(options?)\` \u2014 list messages with optional \`top\`, \`skip\`, \`filter\`, \`orderBy\`, \`select\`, \`search\`
29028
+ - \`client.listMessagesInFolder(folderId, options?)\` \u2014 list messages in a folder (well-known names like \`inbox\` work)
29029
+ - \`client.getMessage(id, options?)\` \u2014 fetch a specific message
29030
+ - \`client.listConversation(conversationId, options?)\` \u2014 fetch every message in a thread (Gmail-style \`getThread\` equivalent; orders oldest-first by default)
29031
+
29032
+ Attachments:
29033
+ - \`client.listAttachments(messageId)\` \u2014 list attachments on a message
29034
+ - \`client.getAttachment(messageId, attachmentId)\` \u2014 fetch a single attachment (file attachments include base64 \`contentBytes\`)
29035
+
29036
+ Calendar:
29037
+ - \`client.listCalendars()\` \u2014 list calendars accessible to the user
29038
+ - \`client.listEvents(options?)\` \u2014 list events on the default calendar (or pass \`{ calendarId }\` for a specific one). Recurring events are returned as series masters
29039
+ - \`client.getEvent(id)\` \u2014 fetch a single event
29040
+ - \`client.listCalendarView(startDateTime, endDateTime, options?)\` \u2014 list event **occurrences** in a date range (recurring events expanded). Equivalent to Google Calendar's \`events?singleEvents=true\`
29041
+
29042
+ If a handler test fails with \`Connection proxy is not configured\`, retry \u2014 the sandbox is still initializing. Do NOT abandon the SDK and construct OAuth proxy URLs manually.
29043
+
29044
+ #### Example
29045
+
29046
+ \`\`\`ts
29047
+ import { connection } from "@squadbase/vite-server/connectors/outlook-oauth";
29048
+
29049
+ const outlook = connection("<connectionId>");
29050
+
29051
+ // Get user profile
29052
+ const profile = await outlook.getProfile();
29053
+ console.log(profile.displayName, profile.mail);
29054
+
29055
+ // List recent unread messages in Inbox
29056
+ const messages = await outlook.listMessagesInFolder("inbox", {
29057
+ top: 10,
29058
+ filter: "isRead eq false",
29059
+ orderBy: "receivedDateTime desc",
29060
+ select: ["id", "subject", "from", "receivedDateTime", "bodyPreview", "conversationId"],
29061
+ });
29062
+ for (const msg of messages.value) {
29063
+ console.log(msg.receivedDateTime, msg.from?.emailAddress.address, msg.subject);
29064
+ }
29065
+
29066
+ // Pull a whole conversation
29067
+ const first = messages.value[0];
29068
+ if (first?.conversationId) {
29069
+ const thread = await outlook.listConversation(first.conversationId);
29070
+ thread.value.forEach(m => console.log(m.receivedDateTime, m.bodyPreview));
29071
+ }
29072
+
29073
+ // Fetch attachments on a message that has them
29074
+ if (first?.hasAttachments) {
29075
+ const atts = await outlook.listAttachments(first.id);
29076
+ for (const a of atts.value) {
29077
+ const full = await outlook.getAttachment(first.id, a.id);
29078
+ console.log(full.name, full.contentType, full.size);
29079
+ // full.contentBytes is base64 for file attachments
29080
+ }
29081
+ }
29082
+
29083
+ // List today's calendar events (expanded occurrences)
29084
+ const todayStart = new Date(); todayStart.setHours(0, 0, 0, 0);
29085
+ const todayEnd = new Date(todayStart); todayEnd.setDate(todayEnd.getDate() + 1);
29086
+ const events = await outlook.listCalendarView(
29087
+ todayStart.toISOString(),
29088
+ todayEnd.toISOString(),
29089
+ { orderBy: "start/dateTime", select: ["id", "subject", "start", "end", "attendees"] },
29090
+ );
29091
+ events.value.forEach(e => console.log(e.start.dateTime, e.subject));
29092
+ \`\`\``,
29093
+ ja: `### \u30C4\u30FC\u30EB
29094
+
29095
+ - \`outlook-oauth_request\`: Outlook \u5411\u3051\u306E Microsoft Graph \u3092\u547C\u3073\u51FA\u3059\u552F\u4E00\u306E\u624B\u6BB5\u3067\u3059\uFF08\u8AAD\u307F\u53D6\u308A\u5C02\u7528\uFF09\u3002\u30E6\u30FC\u30B6\u30FC\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB (\`/me\`)\u3001\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0 (\`/me/mailFolders\`)\u3001\u30E1\u30C3\u30BB\u30FC\u30B8 (\`/me/messages\`)\u3001\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB (\`/me/messages/{id}/attachments\`)\u3001\u30AB\u30EC\u30F3\u30C0\u30FC (\`/me/calendars\`)\u3001\u30A4\u30D9\u30F3\u30C8 (\`/me/events\`, \`/me/calendarView\`) \u306E\u53D6\u5F97\u306B\u4F7F\u3044\u307E\u3059\u3002OAuth \u7D4C\u7531\u3067\u8A8D\u8A3C\u306F\u81EA\u52D5\u8A2D\u5B9A\u3055\u308C\u307E\u3059\u3002
29096
+
29097
+ ### Microsoft Graph \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9 (Outlook \u30E1\u30FC\u30EB)
29098
+
29099
+ #### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
29100
+ - GET \`/me\` \u2014 \u30B5\u30A4\u30F3\u30A4\u30F3\u30E6\u30FC\u30B6\u30FC\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB (displayName, mail, userPrincipalName)
29101
+ - GET \`/me/mailFolders\` \u2014 \u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u4E00\u89A7 (Inbox, SentItems, Drafts \u306A\u3069)
29102
+ - GET \`/me/mailFolders/{folderId}\` \u2014 \u7279\u5B9A\u30D5\u30A9\u30EB\u30C0\u306E\u53D6\u5F97
29103
+ - GET \`/me/mailFolders/{folderId}/messages\` \u2014 \u30D5\u30A9\u30EB\u30C0\u5185\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7
29104
+ - GET \`/me/messages\` \u2014 \u5168\u30D5\u30A9\u30EB\u30C0\u6A2A\u65AD\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7
29105
+ - GET \`/me/messages/{id}\` \u2014 \u7279\u5B9A\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u672C\u6587\u8FBC\u307F\u3067\u53D6\u5F97
29106
+ - GET \`/me/messages/{id}/attachments\` \u2014 \u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u4E00\u89A7
29107
+ - GET \`/me/messages/{id}/attachments/{attachmentId}\` \u2014 \u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u5358\u4F53\u53D6\u5F97
29108
+
29109
+ #### Well-Known \u30D5\u30A9\u30EB\u30C0\u540D ({folderId} \u306E\u4EE3\u308F\u308A\u306B\u4F7F\u7528\u53EF\u80FD)
29110
+ - \`inbox\`, \`sentitems\`, \`drafts\`, \`deleteditems\`, \`junkemail\`, \`outbox\`, \`archive\`
29111
+
29112
+ #### \u4F1A\u8A71 (\u30B9\u30EC\u30C3\u30C9)
29113
+ - \u3059\u3079\u3066\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u306F \`conversationId\` \u3092\u6301\u3064\u3002\u30B9\u30EC\u30C3\u30C9\u5185\u306E\u5168\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97\u3059\u308B\u306B\u306F: GET \`/me/messages?$filter=conversationId eq '<id>'&$orderby=receivedDateTime asc\` (Gmail \u306E \`getThread\` \u76F8\u5F53)\u3002
29114
+
29115
+ ### Microsoft Graph \u30EA\u30D5\u30A1\u30EC\u30F3\u30B9 (Outlook \u30AB\u30EC\u30F3\u30C0\u30FC)
29116
+
29117
+ #### \u5229\u7528\u53EF\u80FD\u306A\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8
29118
+ - GET \`/me/calendars\` \u2014 \u30E6\u30FC\u30B6\u30FC\u306E\u30AB\u30EC\u30F3\u30C0\u30FC\u4E00\u89A7 (\u30C7\u30D5\u30A9\u30EB\u30C8 + \u5171\u6709/\u30B0\u30EB\u30FC\u30D7\u30AB\u30EC\u30F3\u30C0\u30FC)
29119
+ - GET \`/me/calendars/{calendarId}\` \u2014 \u30AB\u30EC\u30F3\u30C0\u30FC\u5358\u4F53\u53D6\u5F97
29120
+ - GET \`/me/events\` \u2014 \u30C7\u30D5\u30A9\u30EB\u30C8\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u30A4\u30D9\u30F3\u30C8\u4E00\u89A7\uFF08\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306F series master \u306E\u307E\u307E\u8FD4\u308B \u2014 \u5C55\u958B\u3057\u305F\u3044\u5834\u5408\u306F \`/me/calendarView\`\uFF09
29121
+ - GET \`/me/calendars/{calendarId}/events\` \u2014 \u7279\u5B9A\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u30A4\u30D9\u30F3\u30C8\u4E00\u89A7
29122
+ - GET \`/me/events/{eventId}\` \u2014 \u30A4\u30D9\u30F3\u30C8\u5358\u4F53\u53D6\u5F97
29123
+ - GET \`/me/calendarView?startDateTime=&endDateTime=\` \u2014 \u65E5\u4ED8\u7BC4\u56F2\u5185\u306E\u30A4\u30D9\u30F3\u30C8 **occurrence** \u4E00\u89A7\uFF08\u7E70\u308A\u8FD4\u3057\u3092\u5C55\u958B\uFF09\u3002Google Calendar \u306E \`events?singleEvents=true\` \u76F8\u5F53
29124
+ - GET \`/me/calendars/{calendarId}/calendarView?startDateTime=&endDateTime=\` \u2014 \u540C\u4E0A\u3001\u7279\u5B9A\u30AB\u30EC\u30F3\u30C0\u30FC\u7248
29125
+
29126
+ #### \u30AB\u30EC\u30F3\u30C0\u30FC Tips
29127
+ - \u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306E\u500B\u5225 occurrence \u304C\u6B32\u3057\u3044\u5834\u5408\u306F \`/me/calendarView\`\u3001\u751F\u306E\u30B7\u30EA\u30FC\u30BA\u304C\u6B32\u3057\u3044\u5834\u5408\u306F \`/me/events\`
29128
+ - \`startDateTime\` / \`endDateTime\` \u306F ISO-8601 UTC\u3001\u4F8B \`2025-01-15T00:00:00Z\`
29129
+ - \`$select=subject,start,end,attendees,location\` \u3068 \`$orderby=start/dateTime\` \u3092\u7D44\u307F\u5408\u308F\u305B\u308B\u3068\u30DA\u30A4\u30ED\u30FC\u30C9\u6291\u5236 + \u30BD\u30FC\u30C8\u3067\u304D\u308B
29130
+
29131
+ #### \u4E3B\u8981\u30AF\u30A8\u30EA\u30D1\u30E9\u30E1\u30FC\u30BF (OData; Mail \u3068 Calendar \u3067\u5171\u901A)
29132
+ - \`$top\` \u2014 \u6700\u5927\u7D50\u679C\u6570 (\u30C7\u30D5\u30A9\u30EB\u30C8 10\u3001\u6700\u5927 1000)
29133
+ - \`$skip\` \u2014 \u5148\u982D N \u4EF6\u3092\u30B9\u30AD\u30C3\u30D7 (\u30DA\u30FC\u30B8\u30F3\u30B0)
29134
+ - \`$select\` \u2014 \u53D6\u5F97\u3059\u308B\u30D7\u30ED\u30D1\u30C6\u30A3\u3092\u30AB\u30F3\u30DE\u533A\u5207\u308A (\u4F8B \`subject,from,receivedDateTime,bodyPreview\`)
29135
+ - \`$orderby\` \u2014 \u30BD\u30FC\u30C8 (\u4F8B \`receivedDateTime desc\`\u3001\`start/dateTime asc\`)
29136
+ - \`$filter\` \u2014 OData \u30D5\u30A3\u30EB\u30BF (\u4F8B \`receivedDateTime ge 2025-01-01T00:00:00Z\`\u3001\`from/emailAddress/address eq 'a@b.com'\`\u3001\`isRead eq false\`\u3001\`conversationId eq '<id>'\`\u3001\`start/dateTime ge '2025-01-15T00:00:00'\`)
29137
+ - \`$search\` \u2014 \u5168\u6587\u691C\u7D22\u3002\u30C0\u30D6\u30EB\u30AF\u30A9\u30FC\u30C8\u3067\u56F2\u3080\u5FC5\u8981\u3042\u308A (\u4F8B \`$search="project status"\`)\u3002\`$filter\` \u3068\u4F75\u7528\u4E0D\u53EF
29138
+ - \`$expand\` \u2014 \u95A2\u9023\u30EA\u30BD\u30FC\u30B9\u3092\u5C55\u958B (\u4F8B \`attachments\`\u3001\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306E \`instances\`)
29139
+ - \`$count=true\` \u2014 \u7DCF\u4EF6\u6570\u3092\u8FD4\u3059 (\u30A8\u30F3\u30C9\u30DD\u30A4\u30F3\u30C8\u306B\u3088\u3063\u3066\u306F \`ConsistencyLevel: eventual\` \u30D8\u30C3\u30C0\u30FC\u304C\u5FC5\u8981)
29140
+
29141
+ #### \u30DA\u30FC\u30B8\u30CD\u30FC\u30B7\u30E7\u30F3
29142
+ - \u7D9A\u304D\u304C\u3042\u308B\u5834\u5408\u30EC\u30B9\u30DD\u30F3\u30B9\u306B \`@odata.nextLink\` \u304C\u542B\u307E\u308C\u308B\u3002\u305D\u306E URL (\u307E\u305F\u306F\u30D1\u30B9) \u3092\u547C\u3073\u51FA\u3057\u3066\u6B21\u30DA\u30FC\u30B8\u3092\u53D6\u5F97
29143
+
29144
+ #### Tips
29145
+ - \u30B5\u30A4\u30F3\u30A4\u30F3\u30E6\u30FC\u30B6\u30FC\u306B\u306F\u5FC5\u305A \`/me\` \u3092\u4F7F\u7528 \u2014 \u4ED6\u30E6\u30FC\u30B6\u30FC\u306E ID \u3092\u5165\u308C\u306A\u3044
29146
+ - \u30DA\u30A4\u30ED\u30FC\u30C9\u80A5\u5927\u5316\u3092\u907F\u3051\u308B\u305F\u3081 \`$select\` \u3092\u6D3B\u7528\u3002HTML \u672C\u6587\u8FBC\u307F\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u306F MB \u5358\u4F4D\u306B\u306A\u308B\u3053\u3068\u304C\u3042\u308B
29147
+ - \`bodyPreview\` (\u5148\u982D\u7D04 255 \u6587\u5B57) \u306F\u30C7\u30D5\u30A9\u30EB\u30C8\u3067\u542B\u307E\u308C\u3066\u304A\u308A\u3001\u30C8\u30EA\u30A2\u30FC\u30B8\u306B\u4FBF\u5229
29148
+ - \u65E5\u6642\u5024\u306F ISO-8601\u3002\u30AB\u30EC\u30F3\u30C0\u30FC\u30A4\u30D9\u30F3\u30C8\u306B\u306F \`timeZone\` \u30D5\u30A3\u30FC\u30EB\u30C9\u3082\u542B\u307E\u308C\u308B
29149
+
29150
+ ### Business Logic
29151
+
29152
+ \u3053\u306E\u30B3\u30CD\u30AF\u30BF\u306E\u30D3\u30B8\u30CD\u30B9\u30ED\u30B8\u30C3\u30AF\u30BF\u30A4\u30D7\u306F "typescript" \u3067\u3059\u3002\u4EE5\u4E0B\u306B\u793A\u3059\u30B3\u30CD\u30AF\u30BF SDK \u3092\u4F7F\u7528\u3057\u3066\u30CF\u30F3\u30C9\u30E9\u30B3\u30FC\u30C9\u3092\u8A18\u8FF0\u3057\u3066\u304F\u3060\u3055\u3044\u3002\u74B0\u5883\u5909\u6570\u304B\u3089\u76F4\u63A5\u8A8D\u8A3C\u60C5\u5831\u306B\u30A2\u30AF\u30BB\u30B9\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044\u3002\`INTERNAL_SQUADBASE_*\` \u306E\u74B0\u5883\u5909\u6570\u3092\u4F7F\u3063\u3066\u624B\u52D5\u3067 OAuth \u30D7\u30ED\u30AD\u30B7\u3092\u53E9\u304F\u3053\u3068\u3082\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044 \u2014 SDK \u304C OAuth \u3092\u51E6\u7406\u3057\u307E\u3059\u3002
29153
+
29154
+ SDK (\`connection(connectionId)\` \u3067\u4F5C\u6210\u3057\u305F\u30AF\u30E9\u30A4\u30A2\u30F3\u30C8):
29155
+
29156
+ \u30E1\u30FC\u30EB:
29157
+ - \`client.request(path, init?)\` \u2014 \u4F4E\u30EC\u30D9\u30EB\u8A8D\u8A3C\u4ED8\u304D fetch (path \u306F \`https://graph.microsoft.com/v1.0\` \u306B\u8FFD\u52A0\u3055\u308C\u307E\u3059)
29158
+ - \`client.getProfile()\` \u2014 \u8A8D\u8A3C\u30E6\u30FC\u30B6\u30FC\u306E\u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u3092\u53D6\u5F97
29159
+ - \`client.listMailFolders()\` \u2014 \u5168\u30E1\u30FC\u30EB\u30D5\u30A9\u30EB\u30C0\u3092\u4E00\u89A7
29160
+ - \`client.listMessages(options?)\` \u2014 \u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7 (\`top\`, \`skip\`, \`filter\`, \`orderBy\`, \`select\`, \`search\` \u5BFE\u5FDC)
29161
+ - \`client.listMessagesInFolder(folderId, options?)\` \u2014 \u30D5\u30A9\u30EB\u30C0\u5185\u306E\u30E1\u30C3\u30BB\u30FC\u30B8\u4E00\u89A7 (\`inbox\` \u306A\u3069\u306E well-known \u540D\u3082\u4F7F\u7528\u53EF)
29162
+ - \`client.getMessage(id, options?)\` \u2014 \u7279\u5B9A\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97
29163
+ - \`client.listConversation(conversationId, options?)\` \u2014 \u30B9\u30EC\u30C3\u30C9\u5185\u306E\u5168\u30E1\u30C3\u30BB\u30FC\u30B8\u3092\u53D6\u5F97 (Gmail \`getThread\` \u76F8\u5F53\u3001\u30C7\u30D5\u30A9\u30EB\u30C8\u3067\u53E4\u3044\u9806)
29164
+
29165
+ \u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB:
29166
+ - \`client.listAttachments(messageId)\` \u2014 \u30E1\u30C3\u30BB\u30FC\u30B8\u306E\u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u4E00\u89A7
29167
+ - \`client.getAttachment(messageId, attachmentId)\` \u2014 \u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u5358\u4F53\u53D6\u5F97 (file attachment \u306F base64 \u306E \`contentBytes\` \u3092\u542B\u3080)
29168
+
29169
+ \u30AB\u30EC\u30F3\u30C0\u30FC:
29170
+ - \`client.listCalendars()\` \u2014 \u30A2\u30AF\u30BB\u30B9\u53EF\u80FD\u306A\u30AB\u30EC\u30F3\u30C0\u30FC\u4E00\u89A7
29171
+ - \`client.listEvents(options?)\` \u2014 \u30C7\u30D5\u30A9\u30EB\u30C8\u30AB\u30EC\u30F3\u30C0\u30FC\u306E\u30A4\u30D9\u30F3\u30C8\u4E00\u89A7 (\`{ calendarId }\` \u3067\u7279\u5B9A\u30AB\u30EC\u30F3\u30C0\u30FC\u6307\u5B9A\u53EF)\u3002\u7E70\u308A\u8FD4\u3057\u30A4\u30D9\u30F3\u30C8\u306F series master \u3068\u3057\u3066\u8FD4\u5374
29172
+ - \`client.getEvent(id)\` \u2014 \u30A4\u30D9\u30F3\u30C8\u5358\u4F53\u53D6\u5F97
29173
+ - \`client.listCalendarView(startDateTime, endDateTime, options?)\` \u2014 \u65E5\u4ED8\u7BC4\u56F2\u5185\u306E\u30A4\u30D9\u30F3\u30C8 **occurrence** \u4E00\u89A7 (\u7E70\u308A\u8FD4\u3057\u3092\u5C55\u958B)\u3002Google Calendar \u306E \`events?singleEvents=true\` \u76F8\u5F53
29174
+
29175
+ \u30CF\u30F3\u30C9\u30E9\u306E\u30C6\u30B9\u30C8\u304C \`Connection proxy is not configured\` \u3067\u5931\u6557\u3059\u308B\u5834\u5408\u306F\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002SDK \u3092\u8AE6\u3081\u3066 OAuth \u30D7\u30ED\u30AD\u30B7\u306E URL \u3092\u81EA\u5206\u3067\u7D44\u307F\u7ACB\u3066\u308B\u3053\u3068\u306F **\u3057\u306A\u3044\u3067\u304F\u3060\u3055\u3044**\u3002
29176
+
29177
+ #### Example
29178
+
29179
+ \`\`\`ts
29180
+ import { connection } from "@squadbase/vite-server/connectors/outlook-oauth";
29181
+
29182
+ const outlook = connection("<connectionId>");
29183
+
29184
+ // \u30D7\u30ED\u30D5\u30A3\u30FC\u30EB\u53D6\u5F97
29185
+ const profile = await outlook.getProfile();
29186
+ console.log(profile.displayName, profile.mail);
29187
+
29188
+ // \u53D7\u4FE1\u30C8\u30EC\u30A4\u306E\u672A\u8AAD\u30E1\u30C3\u30BB\u30FC\u30B8\u6700\u65B010\u4EF6
29189
+ const messages = await outlook.listMessagesInFolder("inbox", {
29190
+ top: 10,
29191
+ filter: "isRead eq false",
29192
+ orderBy: "receivedDateTime desc",
29193
+ select: ["id", "subject", "from", "receivedDateTime", "bodyPreview", "conversationId"],
29194
+ });
29195
+ for (const msg of messages.value) {
29196
+ console.log(msg.receivedDateTime, msg.from?.emailAddress.address, msg.subject);
29197
+ }
29198
+
29199
+ // \u30B9\u30EC\u30C3\u30C9\u5168\u4F53\u3092\u53D6\u5F97
29200
+ const first = messages.value[0];
29201
+ if (first?.conversationId) {
29202
+ const thread = await outlook.listConversation(first.conversationId);
29203
+ thread.value.forEach(m => console.log(m.receivedDateTime, m.bodyPreview));
29204
+ }
29205
+
29206
+ // \u6DFB\u4ED8\u30D5\u30A1\u30A4\u30EB\u3092\u53D6\u5F97
29207
+ if (first?.hasAttachments) {
29208
+ const atts = await outlook.listAttachments(first.id);
29209
+ for (const a of atts.value) {
29210
+ const full = await outlook.getAttachment(first.id, a.id);
29211
+ console.log(full.name, full.contentType, full.size);
29212
+ // full.contentBytes \u306F file attachment \u306E\u5834\u5408 base64
29213
+ }
29214
+ }
29215
+
29216
+ // \u4ECA\u65E5\u306E\u30AB\u30EC\u30F3\u30C0\u30FC\u30A4\u30D9\u30F3\u30C8 (occurrence \u5C55\u958B)
29217
+ const todayStart = new Date(); todayStart.setHours(0, 0, 0, 0);
29218
+ const todayEnd = new Date(todayStart); todayEnd.setDate(todayEnd.getDate() + 1);
29219
+ const events = await outlook.listCalendarView(
29220
+ todayStart.toISOString(),
29221
+ todayEnd.toISOString(),
29222
+ { orderBy: "start/dateTime", select: ["id", "subject", "start", "end", "attendees"] },
29223
+ );
29224
+ events.value.forEach(e => console.log(e.start.dateTime, e.subject));
29225
+ \`\`\``
29226
+ },
29227
+ tools: tools83,
29228
+ async checkConnection(_params, config) {
29229
+ const { proxyFetch } = config;
29230
+ const url = "https://graph.microsoft.com/v1.0/me";
29231
+ try {
29232
+ const res = await proxyFetch(url, { method: "GET" });
29233
+ if (!res.ok) {
29234
+ const errorText = await res.text().catch(() => res.statusText);
29235
+ return {
29236
+ success: false,
29237
+ error: `Microsoft Graph failed: HTTP ${res.status} ${errorText}`
29238
+ };
29239
+ }
29240
+ return { success: true };
29241
+ } catch (error) {
29242
+ return {
29243
+ success: false,
29244
+ error: error instanceof Error ? error.message : String(error)
29245
+ };
29246
+ }
29247
+ }
29248
+ });
29249
+
29250
+ // ../connectors/src/connectors/registry.ts
29251
+ var plugins = {
29252
+ snowflake: snowflakeConnector,
29253
+ snowflakePat: snowflakePatConnector,
29254
+ bigquery: bigqueryConnector,
29255
+ bigqueryOauth: bigqueryOauthConnector,
29256
+ databricks: databricksConnector,
29257
+ redshift: redshiftConnector,
29258
+ dbt: dbtConnector,
29259
+ awsAthena: awsAthenaConnector,
29260
+ awsBilling: awsBillingConnector,
29261
+ postgresql: postgresqlConnector,
29262
+ mysql: mysqlConnector,
29263
+ googleAds: googleAdsConnector,
29264
+ googleAnalytics: googleAnalyticsConnector,
29265
+ googleAnalyticsOauth: googleAnalyticsOauthConnector,
29266
+ googleCalendar: googleCalendarConnector,
29267
+ googleCalendarOauth: googleCalendarOauthConnector,
29268
+ googleDocs: googleDocsConnector,
29269
+ googleDrive: googleDriveConnector,
29270
+ googleSheets: googleSheetsConnector,
29271
+ googleSlides: googleSlidesConnector,
29272
+ hubspotOauth: hubspotOauthConnector,
29273
+ stripeOauth: stripeOauthConnector,
29274
+ stripeApiKey: stripeApiKeyConnector,
29275
+ airtable: airtableConnector,
29276
+ airtableOauth: airtableOauthConnector,
29277
+ squadbaseDb: squadbaseDbConnector,
29278
+ kintone: kintoneConnector,
29279
+ kintoneApiToken: kintoneApiTokenConnector,
29280
+ wixStore: wixStoreConnector,
29281
+ openai: openaiConnector,
29282
+ gemini: geminiConnector,
29283
+ anthropic: anthropicConnector,
29284
+ amplitude: amplitudeConnector,
29285
+ attio: attioConnector,
29286
+ shopify: shopifyConnector,
29287
+ shopifyOauth: shopifyOauthConnector,
29288
+ hubspot: hubspotConnector,
29289
+ jira: jiraConnector,
29290
+ linear: linearConnector,
29291
+ asana: asanaConnector,
29292
+ clickhouse: clickhouseConnector,
29293
+ mongodb: mongodbConnector,
29294
+ notion: notionConnector,
29295
+ notionOauth: notionOauthConnector,
29296
+ metaAds: metaAdsConnector,
29297
+ metaAdsOauth: metaAdsOauthConnector,
29298
+ tiktokAds: tiktokAdsConnector,
29299
+ mailchimp: mailchimpConnector,
29300
+ mailchimpOauth: mailchimpOauthConnector,
29301
+ customerio: customerioConnector,
29302
+ gmail: gmailConnector,
29303
+ gmailOauth: gmailOauthConnector,
29304
+ googleAuditLog: googleAuditLogConnector,
29305
+ linkedinAds: linkedinAdsConnector,
29306
+ zendesk: zendeskConnector,
29307
+ zendeskOauth: zendeskOauthConnector,
29308
+ intercom: intercomConnector,
29309
+ intercomOauth: intercomOauthConnector,
29310
+ mixpanel: mixpanelConnector,
29311
+ grafana: grafanaConnector,
29312
+ backlog: backlogConnector,
29313
+ gamma: gammaConnector,
29314
+ sentry: sentryConnector,
29315
+ salesforce: salesforceConnector,
29316
+ influxdb: influxdbConnector,
29317
+ monday: mondayConnector,
29318
+ jdbc: jdbcConnector,
29319
+ semrush: semrushConnector,
29320
+ googleSearchConsoleOauth: googleSearchConsoleOauthConnector,
29321
+ supabase: supabaseConnector,
29322
+ clickup: clickupConnector,
29323
+ sqlserver: sqlserverConnector,
29324
+ azureSql: azureSqlConnector,
29325
+ cosmosdb: cosmosdbConnector,
29326
+ oracle: oracleConnector,
29327
+ freshservice: freshserviceConnector,
29328
+ freshdesk: freshdeskConnector,
29329
+ freshsales: freshsalesConnector,
29330
+ github: githubConnector,
29331
+ powerbi: powerbiConnector,
29332
+ powerbiOauth: powerbiOauthConnector,
29333
+ tableau: tableauConnector,
29334
+ outlookOauth: outlookOauthConnector
29335
+ };
29336
+ var connectors = {
29337
+ ...plugins,
29338
+ /**
29339
+ * Return plugins that have at least one matching connection.
29340
+ */
29341
+ pluginsFor(connections) {
29342
+ const keys = new Set(
29343
+ connections.map(
29344
+ (c) => ConnectorPlugin.deriveKey(c.connector.slug, c.connector.authType)
29345
+ )
29346
+ );
29347
+ return Object.values(plugins).filter((p) => keys.has(p.connectorKey));
29348
+ },
29349
+ /**
29350
+ * Find a plugin by slug and authType.
29351
+ */
29352
+ findByKey(slug, authType) {
29353
+ const key = ConnectorPlugin.deriveKey(slug, authType);
29354
+ return Object.values(plugins).find((p) => p.connectorKey === key);
29355
+ }
29356
+ };
29357
+
29358
+ // src/connector-client/env.ts
29359
+ function resolveEnvVar(entry, key, connectionId) {
29360
+ const envVarName = entry.envVars[key];
29361
+ if (!envVarName) {
29362
+ throw new Error(`Connection "${connectionId}" is missing envVars mapping for key "${key}"`);
27664
29363
  }
27665
29364
  const value = process.env[envVarName];
27666
29365
  if (!value) {
@@ -27859,62 +29558,62 @@ import { watch as fsWatch2 } from "fs";
27859
29558
  import path2 from "path";
27860
29559
 
27861
29560
  // src/types/server-logic.ts
27862
- import { z as z97 } from "zod";
27863
- var parameterMetaSchema = z97.object({
27864
- name: z97.string(),
27865
- type: z97.enum(["string", "number", "boolean"]),
27866
- description: z97.string(),
27867
- required: z97.boolean().optional(),
27868
- default: z97.union([z97.string(), z97.number(), z97.boolean()]).optional()
27869
- });
27870
- var serverLogicCacheConfigSchema = z97.object({
27871
- ttl: z97.number(),
27872
- staleWhileRevalidate: z97.boolean().optional()
27873
- });
27874
- var serverLogicSchemaObjectSchema = z97.lazy(
27875
- () => z97.object({
27876
- type: z97.enum(["string", "number", "integer", "boolean", "object", "array", "null"]).optional(),
27877
- format: z97.string().optional(),
27878
- description: z97.string().optional(),
27879
- nullable: z97.boolean().optional(),
27880
- enum: z97.array(z97.union([z97.string(), z97.number(), z97.boolean(), z97.null()])).optional(),
29561
+ import { z as z101 } from "zod";
29562
+ var parameterMetaSchema = z101.object({
29563
+ name: z101.string(),
29564
+ type: z101.enum(["string", "number", "boolean"]),
29565
+ description: z101.string(),
29566
+ required: z101.boolean().optional(),
29567
+ default: z101.union([z101.string(), z101.number(), z101.boolean()]).optional()
29568
+ });
29569
+ var serverLogicCacheConfigSchema = z101.object({
29570
+ ttl: z101.number(),
29571
+ staleWhileRevalidate: z101.boolean().optional()
29572
+ });
29573
+ var serverLogicSchemaObjectSchema = z101.lazy(
29574
+ () => z101.object({
29575
+ type: z101.enum(["string", "number", "integer", "boolean", "object", "array", "null"]).optional(),
29576
+ format: z101.string().optional(),
29577
+ description: z101.string().optional(),
29578
+ nullable: z101.boolean().optional(),
29579
+ enum: z101.array(z101.union([z101.string(), z101.number(), z101.boolean(), z101.null()])).optional(),
27881
29580
  items: serverLogicSchemaObjectSchema.optional(),
27882
- properties: z97.record(z97.string(), serverLogicSchemaObjectSchema).optional(),
27883
- required: z97.array(z97.string()).optional(),
27884
- additionalProperties: z97.union([z97.boolean(), serverLogicSchemaObjectSchema]).optional(),
27885
- minimum: z97.number().optional(),
27886
- maximum: z97.number().optional(),
27887
- minLength: z97.number().optional(),
27888
- maxLength: z97.number().optional(),
27889
- pattern: z97.string().optional()
29581
+ properties: z101.record(z101.string(), serverLogicSchemaObjectSchema).optional(),
29582
+ required: z101.array(z101.string()).optional(),
29583
+ additionalProperties: z101.union([z101.boolean(), serverLogicSchemaObjectSchema]).optional(),
29584
+ minimum: z101.number().optional(),
29585
+ maximum: z101.number().optional(),
29586
+ minLength: z101.number().optional(),
29587
+ maxLength: z101.number().optional(),
29588
+ pattern: z101.string().optional()
27890
29589
  })
27891
29590
  );
27892
- var serverLogicMediaTypeSchema = z97.object({
29591
+ var serverLogicMediaTypeSchema = z101.object({
27893
29592
  schema: serverLogicSchemaObjectSchema.optional(),
27894
- example: z97.unknown().optional()
29593
+ example: z101.unknown().optional()
27895
29594
  });
27896
- var serverLogicResponseSchema = z97.object({
27897
- description: z97.string().optional(),
27898
- content: z97.record(z97.string(), serverLogicMediaTypeSchema).optional()
29595
+ var serverLogicResponseSchema = z101.object({
29596
+ description: z101.string().optional(),
29597
+ content: z101.record(z101.string(), serverLogicMediaTypeSchema).optional()
27899
29598
  });
27900
29599
  var jsonBaseFields = {
27901
- description: z97.string(),
27902
- parameters: z97.array(parameterMetaSchema).optional(),
29600
+ description: z101.string(),
29601
+ parameters: z101.array(parameterMetaSchema).optional(),
27903
29602
  response: serverLogicResponseSchema.optional(),
27904
29603
  cache: serverLogicCacheConfigSchema.optional()
27905
29604
  };
27906
- var jsonSqlServerLogicSchema = z97.object({
29605
+ var jsonSqlServerLogicSchema = z101.object({
27907
29606
  ...jsonBaseFields,
27908
- type: z97.literal("sql").optional(),
27909
- query: z97.string(),
27910
- connectionId: z97.string()
29607
+ type: z101.literal("sql").optional(),
29608
+ query: z101.string(),
29609
+ connectionId: z101.string()
27911
29610
  });
27912
- var jsonTypeScriptServerLogicSchema = z97.object({
29611
+ var jsonTypeScriptServerLogicSchema = z101.object({
27913
29612
  ...jsonBaseFields,
27914
- type: z97.literal("typescript"),
27915
- handlerPath: z97.string()
29613
+ type: z101.literal("typescript"),
29614
+ handlerPath: z101.string()
27916
29615
  });
27917
- var anyJsonServerLogicSchema = z97.union([
29616
+ var anyJsonServerLogicSchema = z101.union([
27918
29617
  jsonTypeScriptServerLogicSchema,
27919
29618
  jsonSqlServerLogicSchema
27920
29619
  ]);