@tool-bridge/server 0.1.0 → 0.3.0

package/dist/twilio-M5JI7XHA.js

@@ -0,0 +1,321 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireCredential,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/twilio/api.ts
+var SERVICE = "twilio";
+var API_BASE = "https://api.twilio.com/2010-04-01";
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function integer(value) {
+  return typeof value === "number" && Number.isInteger(value) ? value : void 0;
+}
+function requireText(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} is required.`);
+  return result;
+}
+function basicAuthHeader(ctx) {
+  const accountSid = requireCredential(ctx, SERVICE, "accountSid");
+  const authToken = requireCredential(ctx, SERVICE, "authToken");
+  const bytes = new TextEncoder().encode(`${accountSid}:${authToken}`);
+  let binary = "";
+  for (const byte of bytes) binary += String.fromCharCode(byte);
+  return `Basic ${btoa(binary)}`;
+}
+function errorMessage(payload, raw, status) {
+  const body = record(payload);
+  if (body === void 0) {
+    const trimmed = raw.trim();
+    return trimmed === "" ? `Twilio request failed with ${status}` : trimmed;
+  }
+  const message = text(body.message) ?? text(body.detail) ?? `Twilio request failed with ${status}`;
+  const code = text(body.code) ?? integer(body.code)?.toString();
+  return code === void 0 ? message : `${message} (${code})`;
+}
+async function request(ctx, options) {
+  const url = new URL(`${API_BASE}${options.path}`);
+  for (const [key, value] of Object.entries(options.query ?? {})) {
+    if (value !== void 0) url.searchParams.set(key, String(value));
+  }
+  const headers = {
+    accept: "application/json",
+    authorization: basicAuthHeader(ctx)
+  };
+  if (options.form !== void 0) headers["content-type"] = "application/x-www-form-urlencoded";
+  let response;
+  try {
+    response = await guardedFetch(url.toString(), {
+      method: options.form === void 0 ? "GET" : "POST",
+      headers,
+      ...options.form === void 0 ? {} : { body: options.form.toString() }
+    });
+  } catch (error) {
+    if (error instanceof TBError) throw error;
+    throw upstreamError(
+      502,
+      error instanceof Error ? `Twilio request failed: ${error.message}` : "Twilio request failed"
+    );
+  }
+  const raw = await response.text().catch(() => "");
+  let payload = null;
+  if (raw.trim() !== "") {
+    try {
+      payload = JSON.parse(raw);
+    } catch {
+      if (response.ok) throw new TBError("unavailable", "Twilio \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94", { retryable: true });
+    }
+  }
+  if (!response.ok) throw upstreamError(response.status, errorMessage(payload, raw, response.status));
+  return payload;
+}
+function accountPath(ctx, suffix) {
+  const accountSid = requireCredential(ctx, SERVICE, "accountSid");
+  return `/Accounts/${encodeURIComponent(accountSid)}${suffix}`;
+}
+function normalizeAccount(payload) {
+  const account = record(payload) ?? {};
+  return {
+    accountSid: text(account.sid) ?? "",
+    friendlyName: text(account.friendly_name) ?? null,
+    status: text(account.status) ?? null,
+    type: text(account.type) ?? null
+  };
+}
+function normalizeUsageRecord(value) {
+  const usage = record(value) ?? {};
+  return {
+    accountSid: text(usage.account_sid) ?? null,
+    category: text(usage.category) ?? null,
+    count: text(usage.count) ?? null,
+    countUnit: text(usage.count_unit) ?? null,
+    usage: text(usage.usage) ?? null,
+    usageUnit: text(usage.usage_unit) ?? null,
+    price: text(usage.price) ?? null,
+    priceUnit: text(usage.price_unit) ?? null,
+    startDate: text(usage.start_date) ?? null,
+    endDate: text(usage.end_date) ?? null
+  };
+}
+function normalizeMessage(payload) {
+  const message = record(payload) ?? {};
+  return {
+    messageSid: text(message.sid) ?? "",
+    accountSid: text(message.account_sid) ?? null,
+    status: text(message.status) ?? null,
+    to: text(message.to) ?? null,
+    from: text(message.from) ?? null,
+    body: text(message.body) ?? null
+  };
+}
+function list(value) {
+  return Array.isArray(value) ? value : [];
+}
+async function getAccount(_input, ctx) {
+  return normalizeAccount(await request(ctx, { path: accountPath(ctx, ".json") }));
+}
+async function listUsageRecords(input, ctx) {
+  const payload = record(await request(ctx, {
+    path: accountPath(ctx, "/Usage/Records.json"),
+    query: {
+      Category: text(input.category),
+      StartDate: text(input.startDate),
+      EndDate: text(input.endDate),
+      PageSize: input.pageSize
+    }
+  })) ?? {};
+  return {
+    usageRecords: list(payload.usage_records).map((item) => normalizeUsageRecord(item)),
+    page: integer(payload.page) ?? null,
+    pageSize: integer(payload.page_size) ?? null,
+    nextPageUri: text(payload.next_page_uri) ?? null
+  };
+}
+async function listMessages(input, ctx) {
+  const payload = record(await request(ctx, {
+    path: accountPath(ctx, "/Messages.json"),
+    query: {
+      To: text(input.to),
+      From: text(input.from),
+      PageSize: input.pageSize,
+      PageToken: text(input.pageToken)
+    }
+  })) ?? {};
+  return {
+    messages: list(payload.messages).map((item) => normalizeMessage(item)),
+    nextPageUri: text(payload.next_page_uri) ?? null
+  };
+}
+async function getMessage(input, ctx) {
+  const messageSid = requireText(input.messageSid, "messageSid");
+  return normalizeMessage(await request(ctx, {
+    path: accountPath(ctx, `/Messages/${encodeURIComponent(messageSid)}.json`)
+  }));
+}
+async function sendMessage(input, ctx) {
+  const form = new URLSearchParams();
+  form.append("To", requireText(input.to, "to"));
+  form.append("From", requireText(input.from, "from"));
+  form.append("Body", requireText(input.body, "body"));
+  return normalizeMessage(await request(ctx, {
+    path: accountPath(ctx, "/Messages.json"),
+    form
+  }));
+}
+
+// ../plugins/src/twilio/schema.ts
+var getAccountInput = external_exports.strictObject({}).describe("No input is required for this action.");
+var getAccountOutput = external_exports.strictObject({
+  accountSid: external_exports.string().describe("The Twilio account SID."),
+  friendlyName: external_exports.string().describe("The friendly name of the Twilio account.").nullable(),
+  status: external_exports.string().describe("The current status of the Twilio account.").nullable(),
+  type: external_exports.string().describe("The Twilio account type.").nullable()
+}).describe("The normalized Twilio account payload.");
+var listUsageRecordsInput = external_exports.strictObject({
+  category: external_exports.string().describe("The Twilio usage category to filter by.").optional(),
+  startDate: external_exports.iso.date().describe("The inclusive start date in YYYY-MM-DD format.").optional(),
+  endDate: external_exports.iso.date().describe("The inclusive end date in YYYY-MM-DD format.").optional(),
+  pageSize: external_exports.int().min(1).describe("The maximum number of records to return in one page.").optional()
+}).describe("The input payload for listing Twilio usage records.");
+var listUsageRecordsOutput = external_exports.strictObject({
+  usageRecords: external_exports.array(external_exports.strictObject({
+    accountSid: external_exports.string().describe("The Twilio account SID that owns the usage.").nullable().optional(),
+    category: external_exports.string().describe("The Twilio usage category.").nullable().optional(),
+    count: external_exports.string().describe("The number of units consumed in the record.").nullable().optional(),
+    countUnit: external_exports.string().describe("The unit for the usage count.").nullable().optional(),
+    usage: external_exports.string().describe("The aggregated usage amount.").nullable().optional(),
+    usageUnit: external_exports.string().describe("The unit for the aggregated usage amount.").nullable().optional(),
+    price: external_exports.string().describe("The billed price for the usage record.").nullable().optional(),
+    priceUnit: external_exports.string().describe("The currency unit for the billed price.").nullable().optional(),
+    startDate: external_exports.string().describe("The inclusive start date of the usage record.").nullable().optional(),
+    endDate: external_exports.string().describe("The inclusive end date of the usage record.").nullable().optional()
+  }).describe("One normalized Twilio usage record.")).describe("The normalized usage records returned by Twilio."),
+  page: external_exports.int().describe("The current Twilio result page.").nullable(),
+  pageSize: external_exports.int().describe("The Twilio page size for this result.").nullable(),
+  nextPageUri: external_exports.string().describe("The next page URI returned by Twilio, if any.").nullable()
+}).describe("The output payload for listing Twilio usage records.");
+var listMessagesInput = external_exports.strictObject({
+  to: external_exports.string().describe("Only include messages sent to this phone number.").optional(),
+  from: external_exports.string().describe("Only include messages sent from this phone number.").optional(),
+  pageSize: external_exports.int().min(1).describe("The maximum number of records to return in one page.").optional(),
+  pageToken: external_exports.string().describe("The Twilio page token used to continue a previous listing.").optional()
+}).describe("The input payload for listing Twilio messages.");
+var listMessagesOutput = external_exports.strictObject({
+  messages: external_exports.array(external_exports.strictObject({
+    messageSid: external_exports.string().describe("The Twilio message SID.").optional(),
+    accountSid: external_exports.string().describe("The Twilio account SID that owns the message.").nullable().optional(),
+    status: external_exports.string().describe("The delivery status of the message.").nullable().optional(),
+    to: external_exports.string().describe("The destination phone number.").nullable().optional(),
+    from: external_exports.string().describe("The sender phone number.").nullable().optional(),
+    body: external_exports.string().describe("The text body of the message.").nullable().optional()
+  }).describe("The normalized Twilio message payload.")).describe("The normalized Twilio messages."),
+  nextPageUri: external_exports.string().describe("The next page URI returned by Twilio, if any.").nullable()
+}).describe("The output payload for listing Twilio messages.");
+var getMessageInput = external_exports.strictObject({
+  messageSid: external_exports.string().min(1).describe("The Twilio message SID to fetch.")
+}).describe("The input payload for fetching one Twilio message.");
+var getMessageOutput = external_exports.strictObject({
+  messageSid: external_exports.string().describe("The Twilio message SID.").optional(),
+  accountSid: external_exports.string().describe("The Twilio account SID that owns the message.").nullable().optional(),
+  status: external_exports.string().describe("The delivery status of the message.").nullable().optional(),
+  to: external_exports.string().describe("The destination phone number.").nullable().optional(),
+  from: external_exports.string().describe("The sender phone number.").nullable().optional(),
+  body: external_exports.string().describe("The text body of the message.").nullable().optional()
+}).describe("The normalized Twilio message payload.");
+var sendMessageInput = external_exports.strictObject({
+  to: external_exports.string().min(1).describe("The destination phone number in E.164 format."),
+  from: external_exports.string().min(1).describe("The Twilio phone number sending the message."),
+  body: external_exports.string().min(1).describe("The text body of the outbound message.")
+}).describe("The input payload for sending a Twilio message.");
+var sendMessageOutput = external_exports.strictObject({
+  messageSid: external_exports.string().describe("The Twilio message SID.").optional(),
+  accountSid: external_exports.string().describe("The Twilio account SID that owns the message.").nullable().optional(),
+  status: external_exports.string().describe("The delivery status of the message.").nullable().optional(),
+  to: external_exports.string().describe("The destination phone number.").nullable().optional(),
+  from: external_exports.string().describe("The sender phone number.").nullable().optional(),
+  body: external_exports.string().describe("The text body of the message.").nullable().optional()
+}).describe("The normalized Twilio message payload.");
+var twilioActions = {
+  get_account: {
+    description: "Fetch the current Twilio account profile for the connected credential.",
+    effect: "read",
+    inputSchema: getAccountInput,
+    outputSchema: external_exports.toJSONSchema(getAccountOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_usage_records: {
+    description: "List Twilio usage records for the connected account.",
+    effect: "read",
+    inputSchema: listUsageRecordsInput,
+    outputSchema: external_exports.toJSONSchema(listUsageRecordsOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_messages: {
+    description: "List SMS or MMS messages for the connected Twilio account.",
+    effect: "read",
+    inputSchema: listMessagesInput,
+    outputSchema: external_exports.toJSONSchema(listMessagesOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_message: {
+    description: "Fetch one Twilio message by message SID.",
+    effect: "read",
+    inputSchema: getMessageInput,
+    outputSchema: external_exports.toJSONSchema(getMessageOutput, { io: "output", unrepresentable: "any" })
+  },
+  send_message: {
+    description: "Send an outbound SMS or MMS message with Twilio.",
+    effect: "write",
+    inputSchema: sendMessageInput,
+    outputSchema: external_exports.toJSONSchema(sendMessageOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/twilio/index.ts
+function createTwilioPlugin() {
+  return createProviderPlugin({
+    description: "Twilio",
+    credentialFields: [
+      {
+        key: "accountSid",
+        label: "Account SID",
+        required: true,
+        secret: false,
+        description: "Twilio Account SID(AC \u5F00\u5934),\u4F5C\u4E3A\u8D26\u6237\u6807\u8BC6\u62FC\u8FDB API \u8DEF\u5F84;\u89C1 https://www.twilio.com/console \u7684 Account Info"
+      },
+      {
+        key: "authToken",
+        label: "Auth Token",
+        required: true,
+        secret: true,
+        description: "Twilio Auth Token,\u4E0E accountSid \u4E00\u8D77\u4EE5 HTTP Basic \u53D1\u9001(\u4E0D\u662F Bearer);\u53EF\u5728 https://www.twilio.com/console \u67E5\u770B\u6216\u8F6E\u6362"
+      }
+    ],
+    credentialProbe: "get_account",
+    actions: twilioActions,
+    handlers: {
+      get_account: getAccount,
+      list_usage_records: listUsageRecords,
+      list_messages: listMessages,
+      get_message: getMessage,
+      send_message: sendMessage
+    }
+  });
+}
+var twilio_default = createTwilioPlugin();
+export {
+  createTwilioPlugin,
+  twilio_default as default
+};