aura-code 0.3.0

package/dist/tools/whatsapp.js

@@ -0,0 +1,222 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WHATSAPP_DEFINITION = void 0;
+exports.whatsAppTool = whatsAppTool;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+exports.WHATSAPP_DEFINITION = {
+    name: 'whatsapp',
+    description: 'Send WhatsApp messages via Twilio API or configured HTTP gateway. ' +
+        'Configure ~/.aura/whatsapp.json with { "provider": "twilio", "account_sid": "...", "auth_token": "...", "from": "whatsapp:+14155238886" }. ' +
+        'Or { "provider": "gateway", "url": "http://localhost:3000/send" }.',
+    parameters: {
+        type: 'object',
+        properties: {
+            action: { type: 'string', description: 'Action: send, send_media, status' },
+            to: { type: 'string', description: 'Recipient phone number with country code (e.g., +381641234567)' },
+            message: { type: 'string', description: 'Message text' },
+            media_url: { type: 'string', description: 'URL of media to send (for send_media)' },
+            from: { type: 'string', description: 'Sender WhatsApp number (overrides config)' },
+        },
+        required: ['action'],
+    },
+};
+function loadConfig() {
+    const p = path.join(os.homedir(), '.aura', 'whatsapp.json');
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Providers
+// ─────────────────────────────────────────────────────────────────────────────
+function normalizePhone(phone) {
+    // Ensure it starts with + and has whatsapp: prefix for Twilio
+    const cleaned = phone.replace(/\s/g, '');
+    if (cleaned.startsWith('whatsapp:'))
+        return cleaned;
+    return `whatsapp:${cleaned.startsWith('+') ? cleaned : '+' + cleaned}`;
+}
+async function sendViaTwilio(config, to, message, from) {
+    if (!config.account_sid || !config.auth_token) {
+        return 'Error: Twilio account_sid and auth_token required in config';
+    }
+    const fromNumber = normalizePhone(from ?? config.from ?? '');
+    const toNumber = normalizePhone(to);
+    const url = `https://api.twilio.com/2010-04-01/Accounts/${config.account_sid}/Messages.json`;
+    const params = new URLSearchParams({
+        From: fromNumber,
+        To: toNumber,
+        Body: message,
+    });
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'Authorization': 'Basic ' + Buffer.from(`${config.account_sid}:${config.auth_token}`).toString('base64'),
+        },
+        body: params.toString(),
+        signal: AbortSignal.timeout(15_000),
+    });
+    const data = await response.json();
+    if (!response.ok) {
+        return `Error: Twilio API error: ${data.message ?? 'Unknown error'} (code: ${data.code})`;
+    }
+    return `WhatsApp message sent to ${to} (SID: ${data.sid}, status: ${data.status})`;
+}
+async function sendViaTwilioMedia(config, to, message, mediaUrl, from) {
+    if (!config.account_sid || !config.auth_token) {
+        return 'Error: Twilio account_sid and auth_token required in config';
+    }
+    const fromNumber = normalizePhone(from ?? config.from ?? '');
+    const toNumber = normalizePhone(to);
+    const url = `https://api.twilio.com/2010-04-01/Accounts/${config.account_sid}/Messages.json`;
+    const params = new URLSearchParams({
+        From: fromNumber,
+        To: toNumber,
+        Body: message,
+        MediaUrl: mediaUrl,
+    });
+    const response = await fetch(url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'Authorization': 'Basic ' + Buffer.from(`${config.account_sid}:${config.auth_token}`).toString('base64'),
+        },
+        body: params.toString(),
+        signal: AbortSignal.timeout(15_000),
+    });
+    const data = await response.json();
+    if (!response.ok) {
+        return `Error: Twilio API error: ${data.message ?? 'Unknown error'}`;
+    }
+    return `WhatsApp media sent to ${to} (SID: ${data.sid})`;
+}
+async function sendViaGateway(config, to, message) {
+    if (!config.url)
+        return 'Error: Gateway URL required in config';
+    const response = await fetch(config.url, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            ...(config.api_key ? { 'Authorization': `Bearer ${config.api_key}` } : {}),
+        },
+        body: JSON.stringify({ to, message }),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!response.ok) {
+        const text = await response.text();
+        return `Error: Gateway returned HTTP ${response.status}: ${text.slice(0, 200)}`;
+    }
+    return `WhatsApp message sent to ${to} via gateway`;
+}
+async function checkStatus(config) {
+    if (config.provider === 'twilio') {
+        if (!config.account_sid || !config.auth_token)
+            return 'Error: Twilio credentials not configured';
+        const url = `https://api.twilio.com/2010-04-01/Accounts/${config.account_sid}.json`;
+        const response = await fetch(url, {
+            headers: {
+                'Authorization': 'Basic ' + Buffer.from(`${config.account_sid}:${config.auth_token}`).toString('base64'),
+            },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!response.ok)
+            return 'Error: Cannot connect to Twilio';
+        const data = await response.json();
+        return `Twilio connected. Account: ${data.friendly_name} (${data.status})`;
+    }
+    if (config.provider === 'gateway') {
+        try {
+            const response = await fetch(config.url.replace(/\/send$/, '/health'), { signal: AbortSignal.timeout(5000) });
+            return response.ok ? 'Gateway is reachable' : `Gateway returned HTTP ${response.status}`;
+        }
+        catch {
+            return 'Gateway is not reachable';
+        }
+    }
+    return 'Error: Unknown provider';
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Main executor
+// ─────────────────────────────────────────────────────────────────────────────
+async function whatsAppTool(input) {
+    const config = loadConfig();
+    if (!config) {
+        return 'Error: WhatsApp not configured. Create ~/.aura/whatsapp.json with { "provider": "twilio", "account_sid": "...", "auth_token": "...", "from": "whatsapp:+14155238886" } or { "provider": "gateway", "url": "http://localhost:3000/send" }.';
+    }
+    try {
+        switch (input.action) {
+            case 'send': {
+                if (!input.to)
+                    return 'Error: to (phone number) required';
+                if (!input.message)
+                    return 'Error: message required';
+                if (config.provider === 'twilio')
+                    return await sendViaTwilio(config, input.to, input.message, input.from);
+                if (config.provider === 'gateway')
+                    return await sendViaGateway(config, input.to, input.message);
+                return 'Error: Unknown provider in config';
+            }
+            case 'send_media': {
+                if (!input.to)
+                    return 'Error: to required';
+                if (!input.message)
+                    return 'Error: message required';
+                if (!input.media_url)
+                    return 'Error: media_url required';
+                if (config.provider === 'twilio')
+                    return await sendViaTwilioMedia(config, input.to, input.message, input.media_url, input.from);
+                return 'Error: send_media only supported for Twilio provider';
+            }
+            case 'status': {
+                return await checkStatus(config);
+            }
+            default:
+                return `Error: Unknown whatsapp action: ${input.action}`;
+        }
+    }
+    catch (e) {
+        return `WhatsApp error (${input.action}): ${e?.message ?? String(e)}`;
+    }
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/tools/whatsapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.js","sourceRoot":"","sources":["../../src/tools/whatsapp.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiMA,oCAkCC;AAnOD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AAeZ,QAAA,mBAAmB,GAAmB;IACjD,IAAI,EAAE,UAAU;IAChB,WAAW,EACT,oEAAoE;QACpE,6IAA6I;QAC7I,oEAAoE;IACtE,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,MAAM,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;YAC9E,EAAE,EAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gEAAgE,EAAE;YAC5G,OAAO,EAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;YAC1D,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uCAAuC,EAAE;YACnF,IAAI,EAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;SACxF;QACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;KACrB;CACF,CAAC;AAiBF,SAAS,UAAU;IACjB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,SAAS,cAAc,CAAC,KAAa;IACnC,8DAA8D;IAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC;IACpD,OAAO,YAAY,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,EAAE,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAsB,EAAE,EAAU,EAAE,OAAe,EAAE,IAAa;IAC7F,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9C,OAAO,6DAA6D,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAEpC,MAAM,GAAG,GAAG,8CAA8C,MAAM,CAAC,WAAW,gBAAgB,CAAC;IAC7F,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,OAAO;KACd,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,mCAAmC;YACnD,eAAe,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACzG;QACD,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;QACvB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;IAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,4BAA4B,IAAI,CAAC,OAAO,IAAI,eAAe,WAAW,IAAI,CAAC,IAAI,GAAG,CAAC;IAC5F,CAAC;IAED,OAAO,4BAA4B,EAAE,UAAU,IAAI,CAAC,GAAG,aAAa,IAAI,CAAC,MAAM,GAAG,CAAC;AACrF,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,MAAsB,EAAE,EAAU,EAAE,OAAe,EAAE,QAAgB,EAAE,IAAa;IACpH,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9C,OAAO,6DAA6D,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAEpC,MAAM,GAAG,GAAG,8CAA8C,MAAM,CAAC,WAAW,gBAAgB,CAAC;IAC7F,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,IAAI,EAAE,UAAU;QAChB,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,QAAQ;KACnB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,mCAAmC;YACnD,eAAe,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;SACzG;QACD,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE;QACvB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;IAE1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,4BAA4B,IAAI,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;IACvE,CAAC;IAED,OAAO,0BAA0B,EAAE,UAAU,IAAI,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAAsB,EAAE,EAAU,EAAE,OAAe;IAC/E,IAAI,CAAC,MAAM,CAAC,GAAG;QAAE,OAAO,uCAAuC,CAAC;IAEhE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE;QACvC,MAAM,EAAE,MAAM;QACd,OAAO,EAAE;YACP,cAAc,EAAE,kBAAkB;YAClC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,UAAU,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E;QACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;QACrC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,OAAO,gCAAgC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAClF,CAAC;IAED,OAAO,4BAA4B,EAAE,cAAc,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,MAAsB;IAC/C,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,0CAA0C,CAAC;QACjG,MAAM,GAAG,GAAG,8CAA8C,MAAM,CAAC,WAAW,OAAO,CAAC;QACpF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,OAAO,EAAE;gBACP,eAAe,EAAE,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;aACzG;YACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,iCAAiC,CAAC;QAC3D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAS,CAAC;QAC1C,OAAO,8BAA8B,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC;IAC7E,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,GAAI,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/G,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,yBAAyB,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC3F,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,0BAA0B,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,yBAAyB,CAAC;AACnC,CAAC;AAED,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEzE,KAAK,UAAU,YAAY,CAAC,KAAoB;IACrD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,2OAA2O,CAAC;IACrP,CAAC;IAED,IAAI,CAAC;QACH,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;YACrB,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,IAAI,CAAC,KAAK,CAAC,EAAE;oBAAE,OAAO,mCAAmC,CAAC;gBAC1D,IAAI,CAAC,KAAK,CAAC,OAAO;oBAAE,OAAO,yBAAyB,CAAC;gBACrD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;oBAAE,OAAO,MAAM,aAAa,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1G,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;oBAAE,OAAO,MAAM,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBAChG,OAAO,mCAAmC,CAAC;YAC7C,CAAC;YAED,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,IAAI,CAAC,KAAK,CAAC,EAAE;oBAAE,OAAO,oBAAoB,CAAC;gBAC3C,IAAI,CAAC,KAAK,CAAC,OAAO;oBAAE,OAAO,yBAAyB,CAAC;gBACrD,IAAI,CAAC,KAAK,CAAC,SAAS;oBAAE,OAAO,2BAA2B,CAAC;gBACzD,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ;oBAAE,OAAO,MAAM,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChI,OAAO,sDAAsD,CAAC;YAChE,CAAC;YAED,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,OAAO,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;YACnC,CAAC;YAED;gBACE,OAAO,mCAAmC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC7D,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,OAAO,mBAAmB,KAAK,CAAC,MAAM,MAAM,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/tools/write-file.d.ts

@@ -0,0 +1 @@
+export { writeFile } from './tools.js';

package/dist/tools/write-file.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeFile = void 0;
+var tools_js_1 = require("./tools.js");
+Object.defineProperty(exports, "writeFile", { enumerable: true, get: function () { return tools_js_1.writeFile; } });
+//# sourceMappingURL=write-file.js.map

package/dist/tools/write-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../src/tools/write-file.ts"],"names":[],"mappings":";;;AAAA,uCAAuC;AAA9B,qGAAA,SAAS,OAAA"}

package/dist/tools/youtube-transcript.d.ts

@@ -0,0 +1,9 @@
+import type { ToolDefinition } from '../providers/types.js';
+export interface YouTubeTranscriptInput {
+    url: string;
+    lang?: string;
+    format?: 'text' | 'timestamps' | 'srt';
+    max_chars?: number;
+}
+export declare const YOUTUBE_TRANSCRIPT_DEFINITION: ToolDefinition;
+export declare function youtubeTranscript(input: YouTubeTranscriptInput): Promise<string>;

package/dist/tools/youtube-transcript.js

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YOUTUBE_TRANSCRIPT_DEFINITION = void 0;
+exports.youtubeTranscript = youtubeTranscript;
+const sanitize_js_1 = require("../util/sanitize.js");
+exports.YOUTUBE_TRANSCRIPT_DEFINITION = {
+    name: 'youtube_transcript',
+    description: 'Extract transcript/captions from a YouTube video. Works with regular videos and Shorts. ' +
+        'No API key required. Supports multiple languages and output formats.',
+    parameters: {
+        type: 'object',
+        properties: {
+            url: { type: 'string', description: 'YouTube video URL or video ID' },
+            lang: { type: 'string', description: 'Caption language code (default: en). Use "list" to see available languages.' },
+            format: { type: 'string', description: 'Output format: "text" (plain text), "timestamps" (with timestamps), "srt" (SRT subtitle format). Default: timestamps' },
+            max_chars: { type: 'number', description: 'Max characters to return (default: 50000)' },
+        },
+        required: ['url'],
+    },
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function extractVideoId(input) {
+    // Handle direct video IDs
+    if (/^[a-zA-Z0-9_-]{11}$/.test(input))
+        return input;
+    const patterns = [
+        /(?:youtube\.com\/watch\?.*v=)([a-zA-Z0-9_-]{11})/,
+        /(?:youtube\.com\/shorts\/)([a-zA-Z0-9_-]{11})/,
+        /(?:youtu\.be\/)([a-zA-Z0-9_-]{11})/,
+        /(?:youtube\.com\/embed\/)([a-zA-Z0-9_-]{11})/,
+        /(?:youtube\.com\/v\/)([a-zA-Z0-9_-]{11})/,
+    ];
+    for (const p of patterns) {
+        const m = input.match(p);
+        if (m)
+            return m[1];
+    }
+    return null;
+}
+function parseTimedText(xml) {
+    const segments = [];
+    // YouTube returns XML like: <p t="0" d="5000">Hello world</p>
+    // or newer format: <text start="0" dur="5">Hello world</text>
+    const pRegex = /<p\s[^>]*t="(\d+)"[^>]*d="(\d+)"[^>]*>([\s\S]*?)<\/p>/g;
+    let m;
+    while ((m = pRegex.exec(xml)) !== null) {
+        const start = parseInt(m[1], 10) / 1000;
+        const duration = parseInt(m[2], 10) / 1000;
+        const text = (0, sanitize_js_1.decodeEntities)((0, sanitize_js_1.stripHtml)(m[3]))
+            .replace(/\n/g, ' ')
+            .trim();
+        if (text)
+            segments.push({ start, duration, text });
+    }
+    // Fallback: try <text start="..." dur="..."> format
+    if (segments.length === 0) {
+        const textRegex = /<text\s[^>]*start="([\d.]+)"[^>]*dur="([\d.]+)"[^>]*>([\s\S]*?)<\/text>/g;
+        while ((m = textRegex.exec(xml)) !== null) {
+            const start = parseFloat(m[1]);
+            const duration = parseFloat(m[2]);
+            const text = (0, sanitize_js_1.decodeEntities)((0, sanitize_js_1.stripHtml)(m[3]))
+                .replace(/\n/g, ' ')
+                .trim();
+            if (text)
+                segments.push({ start, duration, text });
+        }
+    }
+    return segments;
+}
+function formatTimestamp(seconds) {
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+    if (h > 0)
+        return `${h}:${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}`;
+    return `${m}:${String(s).padStart(2, '0')}`;
+}
+function formatSrtTimestamp(seconds) {
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+    const ms = Math.floor((seconds % 1) * 1000);
+    return `${String(h).padStart(2, '0')}:${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')},${String(ms).padStart(3, '0')}`;
+}
+function formatTranscript(segments, format) {
+    switch (format) {
+        case 'text':
+            return segments.map(s => s.text).join(' ');
+        case 'srt':
+            return segments.map((s, i) => {
+                const end = s.start + s.duration;
+                return `${i + 1}\n${formatSrtTimestamp(s.start)} --> ${formatSrtTimestamp(end)}\n${s.text}\n`;
+            }).join('\n');
+        case 'timestamps':
+        default:
+            return segments.map(s => `[${formatTimestamp(s.start)}] ${s.text}`).join('\n');
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Main executor
+// ─────────────────────────────────────────────────────────────────────────────
+async function youtubeTranscript(input) {
+    const maxChars = input.max_chars ?? 50_000;
+    const format = input.format ?? 'timestamps';
+    const lang = input.lang ?? 'en';
+    // 1. Extract video ID
+    const videoId = extractVideoId(input.url);
+    if (!videoId) {
+        return `Error: Could not extract video ID from: "${input.url}"\nSupported formats: https://youtube.com/watch?v=ID, https://youtu.be/ID, https://youtube.com/shorts/ID`;
+    }
+    try {
+        // 2. Fetch the YouTube page to find caption tracks
+        const pageUrl = `https://www.youtube.com/watch?v=${videoId}`;
+        const response = await fetch(pageUrl, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Accept-Language': 'en-US,en;q=0.9',
+            },
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (!response.ok) {
+            return `Error: YouTube returned HTTP ${response.status}`;
+        }
+        const html = await response.text();
+        // 3. Extract ytInitialPlayerResponse from the page
+        // Use [\s\S] instead of /s flag for compatibility with older TS targets
+        const playerMatch = html.match(/ytInitialPlayerResponse\s*=\s*(\{[\s\S]+?\});\s*(?:var\s|<\/script)/);
+        if (!playerMatch) {
+            return 'Error: Could not extract player data from YouTube page. The video may be private, age-restricted, or YouTube changed their page structure.';
+        }
+        const playerJson = playerMatch[1];
+        let playerData;
+        try {
+            playerData = JSON.parse(playerJson);
+        }
+        catch {
+            return 'Error: Failed to parse YouTube player data JSON.';
+        }
+        // 4. Navigate to caption tracks
+        const captions = playerData?.captions?.playerCaptionsTracklistRenderer?.captionTracks;
+        if (!captions || captions.length === 0) {
+            const videoDetails = playerData?.videoDetails;
+            const title = videoDetails?.title ?? 'Unknown';
+            return `No captions available for: "${title}" (${videoId})\nThe video may not have subtitles or auto-generated captions.`;
+        }
+        // 5. If lang=list, show available languages
+        if (lang === 'list') {
+            const tracks = captions.map((t) => `  - ${t.languageCode}: ${t.name}${t.isTranslatable ? ' (translatable)' : ''}`);
+            return `Available caption tracks for ${videoId}:\n${tracks.join('\n')}`;
+        }
+        // 6. Find the requested language track
+        let track = captions.find((t) => t.languageCode === lang);
+        if (!track) {
+            // Try partial match (e.g., "en" matches "en-US")
+            track = captions.find((t) => t.languageCode.startsWith(lang));
+        }
+        if (!track) {
+            // Fall back to first available
+            track = captions[0];
+            if (!track) {
+                return `Error: No caption track found for language "${lang}".`;
+            }
+        }
+        // 7. Fetch the caption XML
+        // Remove fmt=srv3 to get simpler XML
+        const captionUrl = track.baseUrl.replace(/&fmt=\w+/, '');
+        const captionResponse = await fetch(captionUrl, {
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36',
+            },
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (!captionResponse.ok) {
+            return `Error: Failed to fetch captions (HTTP ${captionResponse.status})`;
+        }
+        const captionXml = await captionResponse.text();
+        // 8. Parse the timed text
+        const segments = parseTimedText(captionXml);
+        if (segments.length === 0) {
+            return `Error: No caption segments found in the response for language "${track.languageCode}".`;
+        }
+        // 9. Format and return
+        const videoDetails = playerData?.videoDetails;
+        const title = videoDetails?.title ?? 'Unknown';
+        const duration = videoDetails?.lengthSeconds ? `${Math.floor(parseInt(videoDetails.lengthSeconds) / 60)}m${parseInt(videoDetails.lengthSeconds) % 60}s` : '?';
+        const header = `YouTube Transcript: "${title}" (${duration})\nLanguage: ${track.languageCode} | Segments: ${segments.length}\nURL: ${pageUrl}\n\n`;
+        const body = formatTranscript(segments, format);
+        const result = header + body;
+        if (result.length > maxChars) {
+            return result.slice(0, maxChars) + `\n\n... [truncated at ${maxChars} chars]`;
+        }
+        return result;
+    }
+    catch (e) {
+        return `Error fetching YouTube transcript: ${e?.message ?? String(e)}`;
+    }
+}
+//# sourceMappingURL=youtube-transcript.js.map

package/dist/tools/youtube-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-transcript.js","sourceRoot":"","sources":["../../src/tools/youtube-transcript.ts"],"names":[],"mappings":"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"}

package/dist/util/circuit-breaker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Circuit breaker. Trips after N consecutive failures within a time window,
+ * then refuses new calls for a cooldown period. Half-open after cooldown:
+ * a single trial call decides whether to close again or stay open.
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface CircuitBreakerOptions {
+    /** Trip after this many consecutive failures. Default 5. */
+    failureThreshold?: number;
+    /** Time in ms before trying again after the breaker opens. Default 30_000. */
+    cooldownMs?: number;
+    /** Called on every state transition — for observability. */
+    onStateChange?: (state: CircuitState, info: {
+        failures: number;
+        reason?: string;
+    }) => void;
+    /** Sleep function for testing. */
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare class CircuitOpenError extends Error {
+    readonly until: number;
+    constructor(until: number);
+}
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private openedAt;
+    private readonly threshold;
+    private readonly cooldown;
+    private readonly onStateChange?;
+    private readonly sleep;
+    constructor(opts?: CircuitBreakerOptions);
+    /**
+     * Run `fn`. If the breaker is open and still cooling down, throws CircuitOpenError
+     * without calling `fn`. Records success/failure and manages state.
+     */
+    call<T>(fn: () => Promise<T>): Promise<T>;
+    /** Synchronous state check (mostly for tests). */
+    getState(): CircuitState;
+    getFailureCount(): number;
+    private onSuccess;
+    private onFailure;
+    private transition;
+}

package/dist/util/circuit-breaker.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreaker = exports.CircuitOpenError = void 0;
+class CircuitOpenError extends Error {
+    until;
+    constructor(until) {
+        super(`Circuit breaker open until ${new Date(until).toISOString()}`);
+        this.until = until;
+        this.name = 'CircuitOpenError';
+    }
+}
+exports.CircuitOpenError = CircuitOpenError;
+class CircuitBreaker {
+    state = 'closed';
+    failures = 0;
+    openedAt = 0;
+    threshold;
+    cooldown;
+    onStateChange;
+    sleep;
+    constructor(opts = {}) {
+        this.threshold = opts.failureThreshold ?? 5;
+        this.cooldown = opts.cooldownMs ?? 30_000;
+        this.onStateChange = opts.onStateChange;
+        this.sleep = opts.sleep ?? defaultSleep;
+    }
+    /**
+     * Run `fn`. If the breaker is open and still cooling down, throws CircuitOpenError
+     * without calling `fn`. Records success/failure and manages state.
+     */
+    async call(fn) {
+        if (this.state === 'open') {
+            if (Date.now() - this.openedAt >= this.cooldown) {
+                this.transition('half-open', 'cooldown elapsed');
+            }
+            else {
+                throw new CircuitOpenError(this.openedAt + this.cooldown);
+            }
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (e) {
+            this.onFailure(e);
+            throw e;
+        }
+    }
+    /** Synchronous state check (mostly for tests). */
+    getState() { return this.state; }
+    getFailureCount() { return this.failures; }
+    onSuccess() {
+        this.failures = 0;
+        if (this.state !== 'closed')
+            this.transition('closed', 'call succeeded');
+    }
+    onFailure(e) {
+        this.failures++;
+        if (this.state === 'half-open' || (this.state === 'closed' && this.failures >= this.threshold)) {
+            this.openedAt = Date.now();
+            this.transition('open', e instanceof Error ? e.message : String(e));
+        }
+    }
+    transition(to, reason) {
+        if (this.state === to)
+            return;
+        this.state = to;
+        if (to === 'closed')
+            this.failures = 0;
+        this.onStateChange?.(to, { failures: this.failures, reason });
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+function defaultSleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/util/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/util/circuit-breaker.ts"],"names":[],"mappings":"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"}

package/dist/util/env.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Provider-agnostic env-var reader.
+ *
+ * Tries, in order:
+ *   1. The canonical UPPER_SNAKE_CASE var (most SDKs read this)
+ *   2. The lowercase variant (some shells / dotenv loaders normalise to this)
+ *   3. Common alternates passed as `aliases`
+ *
+ * Returns `undefined` if none are set, never throws. Returns `undefined`
+ * (NOT '') for empty / whitespace / placeholder values, so callers can use
+ * the `??` operator and have it fall through to the next fallback.
+ */
+export declare function getApiKey(canonical: string, ...aliases: string[]): string | undefined;
+/**
+ * Same idea for non-secret env vars (base URLs, model names).
+ * Returns `undefined` for unset / empty / whitespace, so `??` chains work.
+ */
+export declare function getEnv(canonical: string, ...aliases: string[]): string | undefined;