@tangle-network/agent-integrations 0.53.28 → 0.53.29

package/dist/{chunk-UC7J6GZF.js → chunk-ARONCYSG.js}

@@ -181,10 +181,12 @@ __export(adapters_exports, {
   copperConnector: () => copperConnector,
   copyAiConnector: () => copyAiConnector,
   couchbaseConnector: () => couchbaseConnector,
+  createSftpConnector: () => createSftpConnector,
   createTangleIdentityClient: () => createTangleIdentityClient,
   crispConnector: () => crispConnector,
   crustdataConnector: () => crustdataConnector,
   cryptolensConnector: () => cryptolensConnector,
+  csvFilesConnector: () => csvFilesConnector,
   customerIoConnector: () => customerIoConnector,
   customgptConnector: () => customgptConnector,
   dappierConnector: () => dappierConnector,
@@ -230,6 +232,7 @@ __export(adapters_exports, {
   etsyConnector: () => etsyConnector,
   everhourConnector: () => everhourConnector,
   exaConnector: () => exaConnector,
+  excelFilesConnector: () => excelFilesConnector,
   facebookLeadsConnector: () => facebookLeadsConnector,
   facebookPagesConnector: () => facebookPagesConnector,
   factorsAiConnector: () => factorsAiConnector,
@@ -466,6 +469,7 @@ __export(adapters_exports, {
   pagerdutyConnector: () => pagerdutyConnector,
   pandadoc: () => pandadoc,
   paperformConnector: () => paperformConnector,
+  parquetFilesConnector: () => parquetFilesConnector,
   parseurConnector: () => parseurConnector,
   pastefyConnector: () => pastefyConnector,
   paychexConnector: () => paychexConnector,
@@ -542,6 +546,7 @@ __export(adapters_exports, {
   serperConnector: () => serperConnector,
   serpstatConnector: () => serpstatConnector,
   serviceNowConnector: () => serviceNowConnector,
+  sftpConnector: () => sftpConnector,
   sharepoint: () => sharepoint,
   shippoConnector: () => shippoConnector,
   shopifyConnector: () => shopifyConnector,
@@ -4446,6 +4451,233 @@ var cartloomConnector = declarativeRestConnector({
   ]
 });
 
+// src/connectors/adapters/csv-files.ts
+import { parse } from "csv-parse/sync";
+import { stringify } from "csv-stringify/sync";
+
+// src/connectors/adapters/file-payload.ts
+var MAX_FILE_BYTES = 10 * 1024 * 1024;
+var MAX_RECORDS = 1e4;
+function readBase64File(value, label = "fileBase64") {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`${label} is required`);
+  }
+  if (value.length % 4 !== 0 || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value)) {
+    throw new Error(`${label} must be canonical base64`);
+  }
+  const file = Buffer.from(value, "base64");
+  if (file.byteLength > MAX_FILE_BYTES) {
+    throw new Error(`${label} exceeds the ${MAX_FILE_BYTES}-byte limit`);
+  }
+  return file;
+}
+function encodeFile(file) {
+  if (file.byteLength > MAX_FILE_BYTES) {
+    throw new Error(`generated file exceeds the ${MAX_FILE_BYTES}-byte limit`);
+  }
+  return {
+    fileBase64: Buffer.from(file).toString("base64"),
+    byteLength: file.byteLength
+  };
+}
+function readRecords(value) {
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error("records must be a non-empty array of objects");
+  }
+  if (value.length > MAX_RECORDS) {
+    throw new Error(`records exceeds the ${MAX_RECORDS}-record limit`);
+  }
+  assertStructuredInputSize(value, "records");
+  return value.map((entry, index) => {
+    if (!isPlainRecord(entry)) {
+      throw new Error(`records[${index}] must be an object`);
+    }
+    return entry;
+  });
+}
+function readRows(value) {
+  if (!Array.isArray(value) || value.length === 0) {
+    throw new Error("rows must be a non-empty array of arrays");
+  }
+  if (value.length > MAX_RECORDS) {
+    throw new Error(`rows exceeds the ${MAX_RECORDS}-row limit`);
+  }
+  assertStructuredInputSize(value, "rows");
+  return value.map((entry, index) => {
+    if (!Array.isArray(entry)) throw new Error(`rows[${index}] must be an array`);
+    return entry;
+  });
+}
+function readOptionalString(value, label) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value !== "string" || value.length === 0) throw new Error(`${label} must be a non-empty string`);
+  return value;
+}
+function readBoolean(value, fallback, label) {
+  if (value === void 0 || value === null) return fallback;
+  if (typeof value !== "boolean") throw new Error(`${label} must be a boolean`);
+  return value;
+}
+function readBoundedInteger(value, fallback, minimum, maximum, label) {
+  if (value === void 0 || value === null) return fallback;
+  if (!Number.isInteger(value) || value < minimum || value > maximum) {
+    throw new Error(`${label} must be an integer from ${minimum} through ${maximum}`);
+  }
+  return value;
+}
+function jsonSafe(value) {
+  if (typeof value === "bigint") return value.toString();
+  if (value instanceof Date) return value.toISOString();
+  if (value instanceof Uint8Array) return Buffer.from(value).toString("base64");
+  if (Array.isArray(value)) return value.map(jsonSafe);
+  if (isPlainRecord(value)) {
+    return Object.fromEntries(Object.entries(value).map(([key, entry]) => [key, jsonSafe(entry)]));
+  }
+  return value;
+}
+function isPlainRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value) && Object.getPrototypeOf(value) === Object.prototype;
+}
+function assertStructuredInputSize(value, label) {
+  let serialized;
+  try {
+    serialized = JSON.stringify(value, (_key, entry) => typeof entry === "bigint" ? entry.toString() : entry);
+  } catch {
+    throw new Error(`${label} must be JSON-serializable`);
+  }
+  if (Buffer.byteLength(serialized, "utf8") > MAX_FILE_BYTES) {
+    throw new Error(`${label} exceeds the ${MAX_FILE_BYTES}-byte input limit`);
+  }
+}
+
+// src/connectors/adapters/csv-files.ts
+var MAX_COLUMNS = 256;
+var MAX_RECORD_SIZE = 1024 * 1024;
+var csvFilesConnector = {
+  manifest: {
+    kind: "csv-files",
+    displayName: "CSV Files",
+    description: "Parse bounded CSV files into records and create CSV files from structured records.",
+    auth: { kind: "none" },
+    defaultConsistencyModel: "advisory",
+    category: "database",
+    capabilities: [
+      {
+        name: "csv.parse",
+        class: "read",
+        description: "Parse a base64-encoded CSV file into object records or row arrays.",
+        parameters: {
+          type: "object",
+          properties: {
+            fileBase64: { type: "string", description: "CSV file content encoded as canonical base64." },
+            delimiter: { type: "string", minLength: 1, maxLength: 1, default: "," },
+            header: { type: "boolean", default: true }
+          },
+          required: ["fileBase64"],
+          additionalProperties: false
+        }
+      },
+      {
+        name: "csv.create",
+        class: "mutation",
+        description: "Create a base64-encoded CSV file from object records.",
+        parameters: {
+          type: "object",
+          properties: {
+            records: { type: "array", minItems: 1, maxItems: MAX_RECORDS, items: { type: "object" } },
+            columns: { type: "array", maxItems: MAX_COLUMNS, items: { type: "string", minLength: 1 } },
+            delimiter: { type: "string", minLength: 1, maxLength: 1, default: "," },
+            header: { type: "boolean", default: true }
+          },
+          required: ["records"],
+          additionalProperties: false
+        },
+        cas: "none",
+        externalEffect: true
+      }
+    ]
+  },
+  async executeRead({ capabilityName, args }) {
+    if (capabilityName !== "csv.parse") throw new Error(`Unknown CSV capability: ${capabilityName}`);
+    const file = readBase64File(args.fileBase64);
+    const delimiter = readDelimiter(args.delimiter);
+    const header2 = readBoolean(args.header, true, "header");
+    let recordCount = 0;
+    const records = parse(file, {
+      bom: true,
+      columns: header2,
+      delimiter,
+      max_record_size: MAX_RECORD_SIZE,
+      skip_empty_lines: true,
+      on_record(record) {
+        recordCount += 1;
+        if (recordCount > MAX_RECORDS) throw new Error(`CSV exceeds the ${MAX_RECORDS}-record limit`);
+        return record;
+      }
+    });
+    if (records.some(
+      (record) => header2 ? Object.keys(record).length > MAX_COLUMNS : Array.isArray(record) && record.length > MAX_COLUMNS
+    )) {
+      throw new Error(`CSV exceeds the ${MAX_COLUMNS}-column limit`);
+    }
+    return {
+      data: { records, recordCount: records.length, header: header2 },
+      fetchedAt: Date.now()
+    };
+  },
+  async executeMutation({ capabilityName, args }) {
+    if (capabilityName !== "csv.create") throw new Error(`Unknown CSV capability: ${capabilityName}`);
+    const records = readRecords(args.records);
+    const columns = readColumns(args.columns, records);
+    const delimiter = readDelimiter(args.delimiter);
+    const header2 = readBoolean(args.header, true, "header");
+    const csv = stringify(
+      records.map((record) => Object.fromEntries(columns.map((column) => [column, csvValue(record[column])]))),
+      { columns, delimiter, header: header2 }
+    );
+    return {
+      status: "committed",
+      data: { ...encodeFile(Buffer.from(csv, "utf8")), text: csv, columns, recordCount: records.length },
+      committedAt: Date.now(),
+      idempotentReplay: false
+    };
+  },
+  async test() {
+    return { ok: true };
+  }
+};
+function readDelimiter(value) {
+  const delimiter = readOptionalString(value, "delimiter") ?? ",";
+  if ([...delimiter].length !== 1 || delimiter === "\r" || delimiter === "\n" || delimiter === '"') {
+    throw new Error("delimiter must be one non-newline character other than a double quote");
+  }
+  return delimiter;
+}
+function readColumns(value, records) {
+  const columns = value === void 0 ? [...new Set(records.flatMap((record) => Object.keys(record)))] : value;
+  if (!Array.isArray(columns) || columns.length === 0 || columns.length > MAX_COLUMNS) {
+    throw new Error(`columns must contain 1 through ${MAX_COLUMNS} names`);
+  }
+  const parsed = columns.map((column, index) => {
+    if (typeof column !== "string" || column.length === 0) throw new Error(`columns[${index}] must be a non-empty string`);
+    return column;
+  });
+  if (new Set(parsed).size !== parsed.length) throw new Error("columns must not contain duplicates");
+  return parsed;
+}
+function csvValue(value) {
+  if (value === null || value === void 0) return null;
+  if (typeof value === "string") return value;
+  if (typeof value === "boolean") return value ? "true" : "false";
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) throw new Error("CSV numeric values must be finite");
+    return value;
+  }
+  if (typeof value === "bigint") return value.toString();
+  if (value instanceof Date) return value.toISOString();
+  return JSON.stringify(value);
+}
+
 // src/connectors/adapters/chain-aware.ts
 var chainAwareConnector = declarativeRestConnector({
   kind: "chain-aware",
@@ -6679,6 +6911,175 @@ var elevenlabsConnector = declarativeRestConnector({
   ]
 });
 
+// src/connectors/adapters/excel-files.ts
+import readXlsxFile from "read-excel-file/node";
+import writeXlsxFile from "write-excel-file/node";
+var MAX_COLUMNS2 = 256;
+var MAX_SHEETS = 50;
+var MAX_UNCOMPRESSED_WORKBOOK_BYTES = 50 * 1024 * 1024;
+var MAX_ZIP_ENTRIES = 1e3;
+var excelFilesConnector = {
+  manifest: {
+    kind: "excel-files",
+    displayName: "Excel Files",
+    description: "Read bounded XLSX workbooks and create XLSX files from structured rows.",
+    auth: { kind: "none" },
+    defaultConsistencyModel: "advisory",
+    category: "spreadsheet",
+    capabilities: [
+      {
+        name: "excel.read",
+        class: "read",
+        description: "Read every sheet, or one named sheet, from a base64-encoded XLSX workbook.",
+        parameters: {
+          type: "object",
+          properties: {
+            fileBase64: { type: "string", description: "XLSX workbook content encoded as canonical base64." },
+            sheet: {
+              description: "Optional sheet name or one-based sheet number.",
+              oneOf: [{ type: "string", minLength: 1 }, { type: "integer", minimum: 1 }]
+            }
+          },
+          required: ["fileBase64"],
+          additionalProperties: false
+        }
+      },
+      {
+        name: "excel.create",
+        class: "mutation",
+        description: "Create a single-sheet base64-encoded XLSX workbook from row arrays.",
+        parameters: {
+          type: "object",
+          properties: {
+            rows: {
+              type: "array",
+              minItems: 1,
+              maxItems: MAX_RECORDS,
+              items: { type: "array", maxItems: MAX_COLUMNS2 }
+            },
+            sheetName: { type: "string", minLength: 1, maxLength: 31, default: "Sheet1" }
+          },
+          required: ["rows"],
+          additionalProperties: false
+        },
+        cas: "none",
+        externalEffect: true
+      }
+    ]
+  },
+  async executeRead({ capabilityName, args }) {
+    if (capabilityName !== "excel.read") throw new Error(`Unknown Excel capability: ${capabilityName}`);
+    const file = readBase64File(args.fileBase64);
+    assertBoundedXlsxArchive(file);
+    const requestedSheet = readSheetSelector(args.sheet);
+    const workbook = await readXlsxFile(file);
+    if (workbook.length > MAX_SHEETS) throw new Error(`workbook exceeds the ${MAX_SHEETS}-sheet limit`);
+    const selected = requestedSheet === void 0 ? workbook : workbook.filter(
+      (sheet, index) => typeof requestedSheet === "number" ? index + 1 === requestedSheet : sheet.sheet === requestedSheet
+    );
+    if (requestedSheet !== void 0 && selected.length === 0) {
+      throw new Error(`sheet not found: ${requestedSheet}`);
+    }
+    let totalRows = 0;
+    const sheets = selected.map((sheet) => {
+      totalRows += sheet.data.length;
+      if (totalRows > MAX_RECORDS) throw new Error(`workbook exceeds the ${MAX_RECORDS}-row limit`);
+      for (const [rowIndex, row] of sheet.data.entries()) {
+        if (row.length > MAX_COLUMNS2) {
+          throw new Error(`sheet ${sheet.sheet} row ${rowIndex + 1} exceeds the ${MAX_COLUMNS2}-column limit`);
+        }
+      }
+      return { name: sheet.sheet, rows: jsonSafe(sheet.data) };
+    });
+    return {
+      data: { sheets, sheetCount: sheets.length, rowCount: totalRows },
+      fetchedAt: Date.now()
+    };
+  },
+  async executeMutation({ capabilityName, args }) {
+    if (capabilityName !== "excel.create") throw new Error(`Unknown Excel capability: ${capabilityName}`);
+    const rows = readRows(args.rows);
+    for (const [index, row] of rows.entries()) {
+      if (row.length > MAX_COLUMNS2) throw new Error(`rows[${index}] exceeds the ${MAX_COLUMNS2}-column limit`);
+    }
+    const sheetName = readOptionalString(args.sheetName, "sheetName") ?? "Sheet1";
+    validateSheetName(sheetName);
+    const sheetData = rows.map((row) => row.map(excelCell));
+    const file = await writeXlsxFile(sheetData, { sheet: sheetName }).toBuffer();
+    return {
+      status: "committed",
+      data: { ...encodeFile(file), sheetName, rowCount: rows.length },
+      committedAt: Date.now(),
+      idempotentReplay: false
+    };
+  },
+  async test() {
+    return { ok: true };
+  }
+};
+function readSheetSelector(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "string" && value.length > 0) return value;
+  if (Number.isInteger(value) && value >= 1) return value;
+  throw new Error("sheet must be a non-empty name or a one-based integer");
+}
+function validateSheetName(value) {
+  if (value.length > 31 || /[\\/*?:[\]]/.test(value)) {
+    throw new Error("sheetName must be at most 31 characters and contain no \\ / * ? : [ ] characters");
+  }
+}
+function excelCell(value) {
+  if (value === null || value === void 0) return null;
+  if (typeof value === "string" || typeof value === "boolean" || value instanceof Date) return value;
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) throw new Error("Excel numeric values must be finite");
+    return value;
+  }
+  if (typeof value === "bigint") return value.toString();
+  return JSON.stringify(value);
+}
+function assertBoundedXlsxArchive(file) {
+  const eocdSignature = 101010256;
+  const centralEntrySignature = 33639248;
+  if (file.byteLength < 22) throw new Error("XLSX file is missing its ZIP directory");
+  const searchStart = Math.max(0, file.byteLength - 65557);
+  let eocdOffset = -1;
+  for (let offset2 = file.byteLength - 22; offset2 >= searchStart; offset2 -= 1) {
+    if (file.readUInt32LE(offset2) === eocdSignature) {
+      eocdOffset = offset2;
+      break;
+    }
+  }
+  if (eocdOffset < 0) throw new Error("XLSX file is missing its ZIP directory");
+  const entryCount = file.readUInt16LE(eocdOffset + 10);
+  const centralSize = file.readUInt32LE(eocdOffset + 12);
+  const centralOffset = file.readUInt32LE(eocdOffset + 16);
+  if (entryCount === 65535 || centralSize === 4294967295 || centralOffset === 4294967295) {
+    throw new Error("ZIP64 XLSX workbooks are not supported");
+  }
+  if (entryCount === 0 || entryCount > MAX_ZIP_ENTRIES || centralOffset + centralSize > file.byteLength) {
+    throw new Error("XLSX ZIP directory is invalid or too large");
+  }
+  let offset = centralOffset;
+  let totalUncompressed = 0;
+  for (let index = 0; index < entryCount; index += 1) {
+    if (offset + 46 > file.byteLength || file.readUInt32LE(offset) !== centralEntrySignature) {
+      throw new Error("XLSX ZIP directory entry is invalid");
+    }
+    const compressedSize = file.readUInt32LE(offset + 20);
+    const uncompressedSize = file.readUInt32LE(offset + 24);
+    const fileNameLength = file.readUInt16LE(offset + 28);
+    const extraLength = file.readUInt16LE(offset + 30);
+    const commentLength = file.readUInt16LE(offset + 32);
+    totalUncompressed += uncompressedSize;
+    if (totalUncompressed > MAX_UNCOMPRESSED_WORKBOOK_BYTES || uncompressedSize > 0 && compressedSize === 0) {
+      throw new Error("XLSX workbook expands beyond the safe processing limit");
+    }
+    offset += 46 + fileNameLength + extraLength + commentLength;
+  }
+  if (offset > centralOffset + centralSize) throw new Error("XLSX ZIP directory length is invalid");
+}
+
 // src/connectors/adapters/everhour.ts
 var everhourConnector = declarativeRestConnector({
   kind: "everhour",
@@ -30336,7 +30737,7 @@ var httpConnector = {
     });
     const data4 = await parseResponse(res, method);
     if (!res.ok) {
-      throw new Error(`http ${method} ${url.toString()} failed: ${res.status} ${truncate(stringify(data4), 200)}`);
+      throw new Error(`http ${method} ${url.toString()} failed: ${res.status} ${truncate(stringify2(data4), 200)}`);
     }
     return {
       data: data4,
@@ -30371,7 +30772,7 @@ var httpConnector = {
       };
     }
     if (!res.ok) {
-      throw new Error(`http ${method} ${url.toString()} failed: ${res.status} ${truncate(stringify(data4), 200)}`);
+      throw new Error(`http ${method} ${url.toString()} failed: ${res.status} ${truncate(stringify2(data4), 200)}`);
     }
     return {
       status: "committed",
@@ -30501,7 +30902,7 @@ function parseRetryAfterMs(header2) {
   if (!Number.isFinite(date)) return 1e3;
   return Math.max(0, date - Date.now());
 }
-function stringify(value) {
+function stringify2(value) {
   if (typeof value === "string") return value;
   try {
     return JSON.stringify(value);
@@ -42934,6 +43335,130 @@ var pipedriveConnector = declarativeRestConnector({
   ]
 });
 
+// src/connectors/adapters/parquet-files.ts
+import { parquetReadObjects } from "hyparquet";
+import { parquetWriteBuffer } from "hyparquet-writer";
+var MAX_COLUMNS3 = 256;
+var parquetFilesConnector = {
+  manifest: {
+    kind: "parquet-files",
+    displayName: "Parquet Files",
+    description: "Read bounded Apache Parquet files and create Parquet files from structured records.",
+    auth: { kind: "none" },
+    defaultConsistencyModel: "advisory",
+    category: "database",
+    capabilities: [
+      {
+        name: "parquet.read",
+        class: "read",
+        description: "Read selected columns and a bounded row range from a base64-encoded Parquet file.",
+        parameters: {
+          type: "object",
+          properties: {
+            fileBase64: { type: "string", description: "Parquet file content encoded as canonical base64." },
+            columns: { type: "array", maxItems: MAX_COLUMNS3, items: { type: "string", minLength: 1 } },
+            rowStart: { type: "integer", minimum: 0, default: 0 },
+            rowLimit: { type: "integer", minimum: 1, maximum: MAX_RECORDS, default: MAX_RECORDS }
+          },
+          required: ["fileBase64"],
+          additionalProperties: false
+        }
+      },
+      {
+        name: "parquet.create",
+        class: "mutation",
+        description: "Create a base64-encoded Parquet file from object records with inferred column types.",
+        parameters: {
+          type: "object",
+          properties: {
+            records: { type: "array", minItems: 1, maxItems: MAX_RECORDS, items: { type: "object" } }
+          },
+          required: ["records"],
+          additionalProperties: false
+        },
+        cas: "none",
+        externalEffect: true
+      }
+    ]
+  },
+  async executeRead({ capabilityName, args }) {
+    if (capabilityName !== "parquet.read") throw new Error(`Unknown Parquet capability: ${capabilityName}`);
+    const file = readBase64File(args.fileBase64);
+    const columns = readColumns2(args.columns);
+    const rowStart = readBoundedInteger(args.rowStart, 0, 0, Number.MAX_SAFE_INTEGER, "rowStart");
+    const rowLimit = readBoundedInteger(args.rowLimit, MAX_RECORDS, 1, MAX_RECORDS, "rowLimit");
+    const records = await parquetReadObjects({
+      file: asyncBuffer(file),
+      columns,
+      rowStart,
+      rowEnd: rowStart + rowLimit
+    });
+    return {
+      data: { records: jsonSafe(records), recordCount: records.length, rowStart },
+      fetchedAt: Date.now()
+    };
+  },
+  async executeMutation({ capabilityName, args }) {
+    if (capabilityName !== "parquet.create") throw new Error(`Unknown Parquet capability: ${capabilityName}`);
+    const records = readRecords(args.records);
+    const columnNames = [...new Set(records.flatMap((record) => Object.keys(record)))];
+    if (columnNames.length === 0 || columnNames.length > MAX_COLUMNS3) {
+      throw new Error(`records must contain 1 through ${MAX_COLUMNS3} columns`);
+    }
+    if (columnNames.some((name) => name.length === 0)) throw new Error("column names must not be empty");
+    const columnData = columnNames.map((name) => {
+      const data4 = records.map((record) => parquetValue(record[name]));
+      return { name, data: data4, type: inferParquetType(data4) };
+    });
+    const file = parquetWriteBuffer({ columnData });
+    return {
+      status: "committed",
+      data: { ...encodeFile(new Uint8Array(file)), columns: columnNames, recordCount: records.length },
+      committedAt: Date.now(),
+      idempotentReplay: false
+    };
+  },
+  async test() {
+    return { ok: true };
+  }
+};
+function asyncBuffer(file) {
+  return {
+    byteLength: file.byteLength,
+    slice(start, end) {
+      const boundedEnd = end === void 0 ? file.byteLength : Math.min(end, file.byteLength);
+      return Uint8Array.from(file.subarray(start, boundedEnd)).buffer;
+    }
+  };
+}
+function readColumns2(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (!Array.isArray(value) || value.length === 0 || value.length > MAX_COLUMNS3) {
+    throw new Error(`columns must contain 1 through ${MAX_COLUMNS3} names`);
+  }
+  const columns = value.map((entry, index) => {
+    if (typeof entry !== "string" || entry.length === 0) throw new Error(`columns[${index}] must be a non-empty string`);
+    return entry;
+  });
+  if (new Set(columns).size !== columns.length) throw new Error("columns must not contain duplicates");
+  return columns;
+}
+function parquetValue(value) {
+  if (value === void 0) return null;
+  if (typeof value === "number" && !Number.isFinite(value)) throw new Error("Parquet numeric values must be finite");
+  return value;
+}
+function inferParquetType(values) {
+  const present = values.filter((value) => value !== null && value !== void 0);
+  if (present.length === 0) return "JSON";
+  if (present.every((value) => typeof value === "boolean")) return "BOOLEAN";
+  if (present.every((value) => typeof value === "string")) return "STRING";
+  if (present.every((value) => typeof value === "number")) return "DOUBLE";
+  if (present.every((value) => typeof value === "bigint")) return "INT64";
+  if (present.every((value) => value instanceof Date)) return "TIMESTAMP";
+  return "JSON";
+}
+
 // src/connectors/adapters/quickbooks.ts
 var quickbooksConnector = declarativeRestConnector({
   kind: "quickbooks",
@@ -44194,6 +44719,372 @@ var salesforceConnector = declarativeRestConnector({
   ]
 });
 
+// src/connectors/adapters/sftp.ts
+import { lookup } from "dns/promises";
+import { timingSafeEqual as timingSafeEqual4 } from "crypto";
+import { posix } from "path";
+import ipaddr from "ipaddr.js";
+import SftpClient from "ssh2-sftp-client";
+var MAX_LIST_ENTRIES = 1e3;
+var MAX_PATH_LENGTH = 1024;
+function createSftpConnector(options = {}) {
+  const createClient = options.createClient ?? (() => new SftpClient());
+  const lookupHost = options.lookupHost ?? resolvePublicAddresses;
+  return {
+    manifest: {
+      kind: "sftp",
+      displayName: "SFTP",
+      description: "List, inspect, download, upload, move, and delete files over host-key-verified SFTP.",
+      auth: {
+        kind: "api-key",
+        hint: "JSON with host, username, SHA-256 hostFingerprint, and password or privateKey; optional port, passphrase, and rootPath."
+      },
+      defaultConsistencyModel: "advisory",
+      category: "storage",
+      rateLimit: { requests: 120, windowMs: 6e4, scope: "data-source" },
+      capabilities: [
+        {
+          name: "sftp.list",
+          class: "read",
+          description: "List a directory within the connection root.",
+          parameters: {
+            type: "object",
+            properties: {
+              path: { type: "string", default: "/" },
+              limit: { type: "integer", minimum: 1, maximum: MAX_LIST_ENTRIES, default: MAX_LIST_ENTRIES }
+            },
+            additionalProperties: false
+          }
+        },
+        {
+          name: "sftp.stat",
+          class: "read",
+          description: "Read file or directory metadata within the connection root.",
+          parameters: pathSchema()
+        },
+        {
+          name: "sftp.download",
+          class: "read",
+          description: `Download a file no larger than ${MAX_FILE_BYTES} bytes as base64.`,
+          parameters: pathSchema()
+        },
+        {
+          name: "sftp.upload",
+          class: "mutation",
+          description: `Upload a base64 file no larger than ${MAX_FILE_BYTES} bytes within the connection root.`,
+          parameters: {
+            type: "object",
+            properties: {
+              path: { type: "string", minLength: 1 },
+              fileBase64: { type: "string" },
+              overwrite: { type: "boolean", default: false }
+            },
+            required: ["path", "fileBase64"],
+            additionalProperties: false
+          },
+          cas: "none",
+          externalEffect: true
+        },
+        {
+          name: "sftp.mkdir",
+          class: "mutation",
+          description: "Create a directory within the connection root.",
+          parameters: {
+            type: "object",
+            properties: {
+              path: { type: "string", minLength: 1 },
+              recursive: { type: "boolean", default: true }
+            },
+            required: ["path"],
+            additionalProperties: false
+          },
+          cas: "none",
+          externalEffect: true
+        },
+        {
+          name: "sftp.rename",
+          class: "mutation",
+          description: "Move or rename a file without overwriting the destination.",
+          parameters: {
+            type: "object",
+            properties: {
+              sourcePath: { type: "string", minLength: 1 },
+              destinationPath: { type: "string", minLength: 1 }
+            },
+            required: ["sourcePath", "destinationPath"],
+            additionalProperties: false
+          },
+          cas: "none",
+          externalEffect: true
+        },
+        {
+          name: "sftp.delete",
+          class: "mutation",
+          description: "Delete a file within the connection root. Repeated deletion is safe.",
+          parameters: pathSchema(),
+          cas: "none",
+          externalEffect: true
+        }
+      ]
+    },
+    async executeRead({ source, capabilityName, args }) {
+      const credentials = readCredentials(source);
+      if (capabilityName === "sftp.list") {
+        const path = resolveRemotePath(credentials.rootPath, args.path ?? "/");
+        const limit = readBoundedInteger(args.limit, MAX_LIST_ENTRIES, 1, MAX_LIST_ENTRIES, "limit");
+        return withSftp(credentials, createClient, lookupHost, async (client) => {
+          const safePath = await canonicalizeExistingPath(client, credentials.rootPath, path);
+          const allEntries = await client.list(safePath);
+          const entries = allEntries.slice(0, limit);
+          return { data: { path: safePath, entries, truncated: allEntries.length > limit }, fetchedAt: Date.now() };
+        });
+      }
+      if (capabilityName === "sftp.stat") {
+        const path = resolveRemotePath(credentials.rootPath, args.path);
+        return withSftp(credentials, createClient, lookupHost, async (client) => {
+          const safePath = await canonicalizeExistingPath(client, credentials.rootPath, path);
+          return { data: { path: safePath, stat: await client.stat(safePath) }, fetchedAt: Date.now() };
+        });
+      }
+      if (capabilityName === "sftp.download") {
+        const path = resolveRemotePath(credentials.rootPath, args.path);
+        return withSftp(credentials, createClient, lookupHost, async (client) => {
+          const safePath = await canonicalizeExistingPath(client, credentials.rootPath, path);
+          const stat = await client.stat(safePath);
+          if (!stat.isFile) throw new Error("sftp.download path is not a file");
+          if (stat.size > MAX_FILE_BYTES) throw new Error(`sftp.download file exceeds the ${MAX_FILE_BYTES}-byte limit`);
+          const file = await client.get(safePath);
+          if (!Buffer.isBuffer(file)) throw new Error("SFTP client returned a non-buffer download");
+          return { data: { path: safePath, ...encodeFile(file), modifyTime: stat.modifyTime }, fetchedAt: Date.now() };
+        });
+      }
+      throw new Error(`Unknown SFTP read capability: ${capabilityName}`);
+    },
+    async executeMutation({ source, capabilityName, args }) {
+      const credentials = readCredentials(source);
+      const prepared = prepareMutation(capabilityName, args, credentials.rootPath);
+      return withSftp(credentials, createClient, lookupHost, async (client) => {
+        let data4;
+        if (prepared.kind === "upload") {
+          const path = await canonicalizeDestinationPath(client, credentials.rootPath, prepared.path);
+          if (!prepared.overwrite && await client.exists(path)) throw new Error("sftp.upload destination already exists");
+          await client.put(prepared.file, path);
+          data4 = { path, byteLength: prepared.file.byteLength };
+        } else if (prepared.kind === "mkdir") {
+          const path = await canonicalizeDestinationPath(client, credentials.rootPath, prepared.path);
+          await client.mkdir(path, prepared.recursive);
+          data4 = { path };
+        } else if (prepared.kind === "rename") {
+          const sourcePath = await canonicalizeExistingPath(client, credentials.rootPath, prepared.sourcePath);
+          const destinationPath = await canonicalizeDestinationPath(client, credentials.rootPath, prepared.destinationPath);
+          if (await client.exists(destinationPath)) throw new Error("sftp.rename destination already exists");
+          await client.rename(sourcePath, destinationPath);
+          data4 = { sourcePath, destinationPath };
+        } else {
+          const path = await canonicalizeDestinationPath(client, credentials.rootPath, prepared.path);
+          await client.delete(path, true);
+          data4 = { path };
+        }
+        return {
+          status: "committed",
+          data: data4,
+          committedAt: Date.now(),
+          idempotentReplay: false
+        };
+      });
+    },
+    async test(source) {
+      try {
+        const credentials = readCredentials(source);
+        await withSftp(credentials, createClient, lookupHost, (client) => client.cwd());
+        return { ok: true };
+      } catch (error) {
+        return { ok: false, reason: error instanceof Error ? error.message : "SFTP connection test failed" };
+      }
+    }
+  };
+}
+function prepareMutation(capabilityName, args, rootPath) {
+  if (capabilityName === "sftp.upload") {
+    return {
+      kind: "upload",
+      path: mutablePath(rootPath, args.path),
+      file: readBase64File(args.fileBase64),
+      overwrite: readBoolean(args.overwrite, false, "overwrite")
+    };
+  }
+  if (capabilityName === "sftp.mkdir") {
+    return {
+      kind: "mkdir",
+      path: mutablePath(rootPath, args.path),
+      recursive: readBoolean(args.recursive, true, "recursive")
+    };
+  }
+  if (capabilityName === "sftp.rename") {
+    return {
+      kind: "rename",
+      sourcePath: mutablePath(rootPath, args.sourcePath),
+      destinationPath: mutablePath(rootPath, args.destinationPath)
+    };
+  }
+  if (capabilityName === "sftp.delete") {
+    return { kind: "delete", path: mutablePath(rootPath, args.path) };
+  }
+  throw new Error(`Unknown SFTP mutation capability: ${capabilityName}`);
+}
+var sftpConnector = createSftpConnector();
+function pathSchema() {
+  return {
+    type: "object",
+    properties: { path: { type: "string", minLength: 1 } },
+    required: ["path"],
+    additionalProperties: false
+  };
+}
+async function withSftp(credentials, createClient, lookupHost, run) {
+  const addresses = await lookupHost(credentials.host);
+  if (addresses.length === 0) throw new Error("SFTP host did not resolve");
+  const client = createClient();
+  try {
+    await client.connect({
+      host: addresses[0],
+      port: credentials.port,
+      username: credentials.username,
+      password: credentials.password,
+      privateKey: credentials.privateKey,
+      passphrase: credentials.passphrase,
+      readyTimeout: 1e4,
+      retries: 1,
+      hostHash: "sha256",
+      hostVerifier: (hashedKey) => fingerprintMatches(credentials.hostFingerprint, hashedKey)
+    });
+    return await run(client);
+  } finally {
+    await client.end().catch(() => false);
+  }
+}
+function readCredentials(source) {
+  let raw;
+  if (source.credentials.kind === "custom") raw = source.credentials.values;
+  else if (source.credentials.kind === "api-key") {
+    try {
+      raw = JSON.parse(source.credentials.apiKey);
+    } catch {
+      throw new Error("SFTP credential must be valid JSON");
+    }
+  } else {
+    throw new Error("SFTP requires a structured credential bundle");
+  }
+  if (!isPlainRecord(raw)) throw new Error("SFTP credential must be a JSON object");
+  const host = requiredCredentialString2(raw.host, "host");
+  validateHostname(host);
+  const username = requiredCredentialString2(raw.username, "username");
+  const password = readOptionalString(raw.password, "password");
+  const privateKey = readOptionalString(raw.privateKey, "privateKey");
+  if (!password && !privateKey) throw new Error("SFTP credential requires password or privateKey");
+  const rootPath = normalizeRootPath(readOptionalString(raw.rootPath, "rootPath") ?? "/");
+  return {
+    host,
+    port: readBoundedInteger(raw.port, 22, 1, 65535, "port"),
+    username,
+    password,
+    privateKey,
+    passphrase: readOptionalString(raw.passphrase, "passphrase"),
+    hostFingerprint: parseFingerprint(requiredCredentialString2(raw.hostFingerprint, "hostFingerprint")),
+    rootPath
+  };
+}
+function requiredCredentialString2(value, label) {
+  const parsed = readOptionalString(value, label);
+  if (!parsed) throw new Error(`SFTP credential ${label} is required`);
+  return parsed;
+}
+function validateHostname(host) {
+  if (host.length > 253 || host.includes("://") || /[\s/@]/.test(host) || host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local")) {
+    throw new Error("SFTP host must be a public hostname or IP address without a scheme");
+  }
+}
+async function resolvePublicAddresses(host) {
+  const addresses = ipaddr.isValid(host) ? [host] : (await lookup(host, { all: true, verbatim: true })).map((entry) => entry.address);
+  if (addresses.length === 0 || addresses.some((address) => !isPublicAddress(address))) {
+    throw new Error("SFTP host is not a public network target");
+  }
+  return addresses;
+}
+function isPublicAddress(value) {
+  if (!ipaddr.isValid(value)) return false;
+  let address = ipaddr.parse(value);
+  if (address.kind() === "ipv6" && address.isIPv4MappedAddress()) {
+    address = address.toIPv4Address();
+  }
+  return address.range() === "unicast";
+}
+function parseFingerprint(value) {
+  if (/^[a-fA-F0-9]{64}$/.test(value)) return Buffer.from(value, "hex");
+  const match = /^SHA256:([A-Za-z0-9+/]{43}=?)$/.exec(value);
+  if (!match) throw new Error("hostFingerprint must be 64 hex characters or an SHA256: base64 fingerprint");
+  const parsed = Buffer.from(match[1], "base64");
+  if (parsed.byteLength !== 32) throw new Error("hostFingerprint must contain a 32-byte SHA-256 digest");
+  return parsed;
+}
+function fingerprintMatches(expected, actual) {
+  const parsed = Buffer.isBuffer(actual) ? actual : /^[a-fA-F0-9]{64}$/.test(actual) ? Buffer.from(actual, "hex") : Buffer.from(actual.replace(/^SHA256:/, ""), "base64");
+  return parsed.byteLength === expected.byteLength && timingSafeEqual4(parsed, expected);
+}
+function normalizeRootPath(value) {
+  if (!value.startsWith("/") || value.includes("\0") || value.length > MAX_PATH_LENGTH) {
+    throw new Error("rootPath must be an absolute SFTP path");
+  }
+  return posix.normalize(value);
+}
+function resolveRemotePath(rootPath, value) {
+  const requested = readOptionalString(value, "path");
+  if (!requested || requested.includes("\0") || requested.length > MAX_PATH_LENGTH) {
+    throw new Error("path must be a non-empty SFTP path");
+  }
+  const resolved = posix.resolve(rootPath, requested.replace(/^\/+/, ""));
+  if (rootPath !== "/" && resolved !== rootPath && !resolved.startsWith(`${rootPath}/`)) {
+    throw new Error("path escapes the configured SFTP root");
+  }
+  return resolved;
+}
+function mutablePath(rootPath, value) {
+  const path = resolveRemotePath(rootPath, value);
+  if (path === rootPath) throw new Error("mutation path cannot target the configured SFTP root");
+  return path;
+}
+async function canonicalizeExistingPath(client, configuredRoot, path) {
+  const root = posix.normalize(await client.realPath(configuredRoot));
+  const target = posix.normalize(await client.realPath(path));
+  assertWithinCanonicalRoot(root, target);
+  return target;
+}
+async function canonicalizeDestinationPath(client, configuredRoot, path) {
+  const root = posix.normalize(await client.realPath(configuredRoot));
+  if (await client.exists(path)) {
+    const existing = posix.normalize(await client.realPath(path));
+    assertWithinCanonicalRoot(root, existing);
+    return existing;
+  }
+  let ancestor = posix.dirname(path);
+  const missingSegments = [posix.basename(path)];
+  while (!await client.exists(ancestor)) {
+    if (ancestor === configuredRoot || ancestor === "/") break;
+    missingSegments.unshift(posix.basename(ancestor));
+    ancestor = posix.dirname(ancestor);
+  }
+  const canonicalAncestor = posix.normalize(await client.realPath(ancestor));
+  assertWithinCanonicalRoot(root, canonicalAncestor);
+  const destination = posix.join(canonicalAncestor, ...missingSegments);
+  assertWithinCanonicalRoot(root, destination);
+  return destination;
+}
+function assertWithinCanonicalRoot(root, target) {
+  if (root !== "/" && target !== root && !target.startsWith(`${root}/`)) {
+    throw new Error("SFTP path resolves outside the configured root");
+  }
+}
+
 // src/connectors/adapters/saleor.ts
 var saleorConnector = declarativeRestConnector({
   kind: "saleor",
@@ -62864,6 +63755,10 @@ var CONNECTOR_ADAPTER_FACTORIES = [
   defineFactoryAdapter(() => amazonSqsConnector, {}),
   defineFactoryAdapter(() => httpConnector, {}),
   defineFactoryAdapter(() => rssConnector, {}),
+  defineFactoryAdapter(() => csvFilesConnector, {}),
+  defineFactoryAdapter(() => excelFilesConnector, {}),
+  defineFactoryAdapter(() => parquetFilesConnector, {}),
+  defineFactoryAdapter(() => sftpConnector, {}),
   defineFactoryAdapter(() => chessComConnector, {}),
   defineFactoryAdapter(() => zapierConnector, {}),
   defineFactoryAdapter(() => makeConnector, {}),
@@ -142735,6 +143630,7 @@ export {
   buttondownConnector,
   cambAiConnector,
   cartloomConnector,
+  csvFilesConnector,
   chainAwareConnector,
   chaindeskConnector,
   chatAidConnector,
@@ -142754,6 +143650,7 @@ export {
   dripConnector,
   echowinConnector,
   elevenlabsConnector,
+  excelFilesConnector,
   everhourConnector,
   featheryConnector,
   fellowConnector,
@@ -142892,12 +143789,15 @@ export {
   plaidConnector,
   pipedreamConnector,
   pipedriveConnector,
+  parquetFilesConnector,
   quickbooksConnector,
   recallAiConnector,
   rampConnector,
   ringcentralConnector,
   rssConnector,
   salesforceConnector,
+  createSftpConnector,
+  sftpConnector,
   saleorConnector,
   savvycalConnector,
   sharepoint,
@@ -143349,4 +144249,4 @@ export {
   demandbaseConnector,
   adapters_exports
 };
-//# sourceMappingURL=chunk-UC7J6GZF.js.map
+//# sourceMappingURL=chunk-ARONCYSG.js.map