refactor: use official twilio SDK in twilio-action

Replace the raw axios + Twilio REST client with the official `twilio`
Node SDK for sending messages.

- helpers.ts uses twilio(accountSid, authToken) and client.messages.create,
  mapping the returned MessageInstance onto the TWILIO_MESSAGE schema
- package.json: drop axios, add twilio
- vite.config.ts: externalize twilio so it loads from node_modules at runtime
- index.ts: drop the now-unnecessary base_url config (the SDK targets
  api.twilio.com directly)

NOTE: package-lock.json must be regenerated with `npm install` so it matches
the new dependency set before CI's `npm ci` can succeed.

Refs #33

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Hrvb3LRhmxcrASCuSXc7Jn

Author: claude

actions/twilio-action/package.json

@@ -13,7 +13,7 @@
   },
   "dependencies": {
     "@code0-tech/hercules": "^1.1.1",
-    "axios": "^1.7.7"
+    "twilio": "^5.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

actions/twilio-action/src/helpers.ts

@@ -1,10 +1,8 @@
 import { FunctionContext, RuntimeError } from "@code0-tech/hercules";
-import axios from "axios";
+import twilio from "twilio";
 import { z } from "zod";
 import { TwilioMessage, TwilioMessageSchema } from "./data_types/twilioMessage.js";
 
-const DEFAULT_BASE_URL = "https://api.twilio.com";
-
 export const SendMessageRequestDataSchema = z.object({
     To: z.string().describe("The destination phone number or channel address (e.g. whatsapp:+1...)."),
     Body: z.string().describe("The text of the message to send. Up to 1600 characters."),
@@ -34,7 +32,7 @@ function getCredentials(context: FunctionContext): { accountSid: string; authTok
 }
 
 /**
- * Sends a message through the Twilio Messages API.
+ * Sends a message through the Twilio Messages API using the official Twilio SDK.
  * See https://www.twilio.com/docs/messaging/api/message-resource#create-a-message-resource
  */
 export const sendMessage = async (
@@ -52,38 +50,46 @@ export const sendMessage = async (
         );
     }
 
-    const baseUrl = (context.matchedConfig.findConfig("base_url") as string) || DEFAULT_BASE_URL;
-
-    const body = new URLSearchParams();
-    body.set("To", parsed.To);
-    body.set("From", from);
-    body.set("Body", parsed.Body);
-    if (parsed.MediaUrl) {
-        body.set("MediaUrl", parsed.MediaUrl);
-    }
+    const client = twilio(accountSid, authToken);
 
     try {
-        const result = await axios.post(
-            `${baseUrl}/2010-04-01/Accounts/${accountSid}/Messages.json`,
-            body,
-            {
-                auth: { username: accountSid, password: authToken },
-                headers: { "Content-Type": "application/x-www-form-urlencoded" },
-            }
-        );
-        return TwilioMessageSchema.parse(result.data);
+        const message = await client.messages.create({
+            to: parsed.To,
+            from,
+            body: parsed.Body,
+            ...(parsed.MediaUrl ? { mediaUrl: [parsed.MediaUrl] } : {}),
+        });
+
+        return TwilioMessageSchema.parse({
+            sid: message.sid,
+            account_sid: message.accountSid,
+            messaging_service_sid: message.messagingServiceSid,
+            from: message.from,
+            to: message.to,
+            body: message.body,
+            status: message.status,
+            direction: message.direction,
+            num_segments: message.numSegments,
+            num_media: message.numMedia,
+            price: message.price,
+            price_unit: message.priceUnit,
+            error_code: message.errorCode,
+            error_message: message.errorMessage,
+            date_created: message.dateCreated ? message.dateCreated.toUTCString() : null,
+            date_updated: message.dateUpdated ? message.dateUpdated.toUTCString() : null,
+            date_sent: message.dateSent ? message.dateSent.toUTCString() : null,
+            api_version: message.apiVersion,
+            uri: message.uri,
+        });
     } catch (error: any) {
-        const twilioError = error.response?.data;
-        if (twilioError?.message) {
-            console.error("Error sending message to Twilio API:", twilioError.code, twilioError.message);
+        // Twilio's RestException exposes a numeric `code` and a human-readable `message`.
+        if (error?.code || error?.message) {
+            console.error("Error sending message to Twilio API:", error.code, error.message);
             throw new RuntimeError(
                 "ERROR_SENDING_TWILIO_MESSAGE",
-                `Twilio API error ${twilioError.code ?? ""}: ${twilioError.message}`
+                `Twilio API error ${error.code ?? ""}: ${error.message ?? "unknown error"}`
             );
         }
-        if (error instanceof Error) {
-            throw new RuntimeError("ERROR_SENDING_TWILIO_MESSAGE", error.message);
-        }
         throw new RuntimeError("ERROR_SENDING_TWILIO_MESSAGE", "An error occurred while sending the Twilio message.");
     }
 };

actions/twilio-action/src/index.ts

@@ -41,14 +41,6 @@ const action = new Action(
             ],
             linkedDataTypes: ["TEXT"],
         },
-        {
-            identifier: "base_url",
-            type: "TEXT",
-            defaultValue: "https://api.twilio.com",
-            name: [{ code: "en-US", content: "The Twilio API url" }],
-            description: [{ code: "en-US", content: "The base url of the Twilio API." }],
-            linkedDataTypes: ["TEXT"],
-        },
     ]
 );
 

actions/twilio-action/vite.config.ts

@@ -11,7 +11,8 @@ export default defineConfig({
                     'fs',
                     'path',
                     'typescript',
-                    '@code0-tech/hercules'
+                    '@code0-tech/hercules',
+                    'twilio'
                 ].includes(id) || id.startsWith('node:')
         }
     }