@framers/agentos-ext-voice-plivo 0.1.0 → 0.1.2

package/dist/tools/voiceCall.js

@@ -0,0 +1,205 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview ITool implementation for Plivo voice calls.
+ *
+ * Provides the `plivoVoiceCall` tool that agents can invoke to make
+ * outbound phone calls, speak text into active calls, hang up calls,
+ * and query call status.
+ *
+ * Follows the same VoiceCallTool pattern used by Twilio/Telnyx extensions.
+ *
+ * @module @framers/agentos-ext-voice-plivo/tools/voiceCall
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlivoVoiceCallTool = void 0;
+// ============================================================================
+// Tool Implementation
+// ============================================================================
+class PlivoVoiceCallTool {
+    constructor(handler) {
+        this.handler = handler;
+        this.id = 'plivoVoiceCall';
+        this.name = 'plivoVoiceCall';
+        this.displayName = 'Plivo Voice Call';
+        this.description = 'Make and manage phone calls via Plivo. ' +
+            'Actions: "call" (initiate outbound call), "speak" (play TTS into active call), ' +
+            '"hangup" (terminate call), "status" (get call info), "list" (get all active calls).';
+        this.category = 'telephony';
+        this.version = '0.1.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            required: ['action'],
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['call', 'speak', 'hangup', 'status', 'list'],
+                    description: 'The voice call action to perform.',
+                },
+                toNumber: {
+                    type: 'string',
+                    description: 'E.164 phone number to call (required for "call" action).',
+                },
+                callId: {
+                    type: 'string',
+                    description: 'Call ID (required for "speak", "hangup", "status" actions).',
+                },
+                message: {
+                    type: 'string',
+                    description: 'Text to speak. For "call" in notify mode, this is the message. For "speak", this is played into the active call.',
+                },
+                mode: {
+                    type: 'string',
+                    enum: ['notify', 'conversation'],
+                    description: 'Call mode (default: "conversation"). "notify" speaks a message and hangs up.',
+                },
+            },
+        };
+        this.outputSchema = {
+            type: 'object',
+            properties: {
+                callId: { type: 'string', description: 'The call ID' },
+                state: { type: 'string', description: 'Current call state' },
+                calls: {
+                    type: 'array',
+                    description: 'List of active calls (for "list" action)',
+                    items: { type: 'object' },
+                },
+            },
+        };
+    }
+    async execute(args, _context) {
+        try {
+            switch (args.action) {
+                case 'call':
+                    return await this.handleCall(args);
+                case 'speak':
+                    return this.handleSpeak(args);
+                case 'hangup':
+                    return await this.handleHangup(args);
+                case 'status':
+                    return this.handleStatus(args);
+                case 'list':
+                    return this.handleList();
+                default:
+                    return {
+                        success: false,
+                        error: `Unknown action: "${args.action}". Valid actions: call, speak, hangup, status, list.`,
+                    };
+            }
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    validateArgs(args) {
+        const errors = [];
+        if (!args.action) {
+            errors.push('action is required');
+        }
+        else {
+            const validActions = ['call', 'speak', 'hangup', 'status', 'list'];
+            if (!validActions.includes(args.action)) {
+                errors.push(`Invalid action "${args.action}". Must be one of: ${validActions.join(', ')}`);
+            }
+            if (args.action === 'call' && !args.toNumber) {
+                errors.push('toNumber is required for "call" action');
+            }
+            if (['speak', 'hangup', 'status'].includes(args.action) && !args.callId) {
+                errors.push(`callId is required for "${args.action}" action`);
+            }
+            if (args.action === 'speak' && !args.message) {
+                errors.push('message is required for "speak" action');
+            }
+        }
+        return { isValid: errors.length === 0, errors };
+    }
+    // ── Action Handlers ──
+    async handleCall(args) {
+        if (!args.toNumber) {
+            return { success: false, error: 'toNumber is required for "call" action' };
+        }
+        const call = await this.handler.initiateCall(args.toNumber, args.message, args.mode ?? 'conversation');
+        return {
+            success: true,
+            output: {
+                callId: call.callId,
+                providerCallId: call.providerCallId,
+                state: call.state,
+                direction: call.direction,
+                mode: call.mode,
+                fromNumber: call.fromNumber,
+                toNumber: call.toNumber,
+            },
+        };
+    }
+    handleSpeak(args) {
+        if (!args.callId) {
+            return { success: false, error: 'callId is required for "speak" action' };
+        }
+        if (!args.message) {
+            return { success: false, error: 'message is required for "speak" action' };
+        }
+        this.handler.speakText(args.callId, args.message);
+        return {
+            success: true,
+            output: { callId: args.callId, action: 'speak', text: args.message },
+        };
+    }
+    async handleHangup(args) {
+        if (!args.callId) {
+            return { success: false, error: 'callId is required for "hangup" action' };
+        }
+        await this.handler.hangupCall(args.callId);
+        return {
+            success: true,
+            output: { callId: args.callId, action: 'hangup' },
+        };
+    }
+    handleStatus(args) {
+        if (!args.callId) {
+            return { success: false, error: 'callId is required for "status" action' };
+        }
+        const call = this.handler.getCallStatus(args.callId);
+        if (!call) {
+            return { success: false, error: `No call found with ID: ${args.callId}` };
+        }
+        return {
+            success: true,
+            output: {
+                callId: call.callId,
+                providerCallId: call.providerCallId,
+                state: call.state,
+                direction: call.direction,
+                mode: call.mode,
+                fromNumber: call.fromNumber,
+                toNumber: call.toNumber,
+                transcript: call.transcript,
+                createdAt: call.createdAt,
+                endedAt: call.endedAt,
+                errorMessage: call.errorMessage,
+            },
+        };
+    }
+    handleList() {
+        const calls = this.handler.getActiveCalls();
+        return {
+            success: true,
+            output: {
+                count: calls.length,
+                calls: calls.map((c) => ({
+                    callId: c.callId,
+                    state: c.state,
+                    direction: c.direction,
+                    mode: c.mode,
+                    fromNumber: c.fromNumber,
+                    toNumber: c.toNumber,
+                    createdAt: c.createdAt,
+                })),
+            },
+        };
+    }
+}
+exports.PlivoVoiceCallTool = PlivoVoiceCallTool;
+//# sourceMappingURL=voiceCall.js.map

package/dist/tools/voiceCall.js.map

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

package/manifest.json

@@ -2,7 +2,7 @@
   "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
   "id": "com.framers.voice.plivo",
   "name": "Plivo Voice Provider Extension",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Plivo telephony provider for voice calls — supports outbound/inbound calls, XML response generation, notify and conversation modes.",
   "categories": ["voice", "telephony"],
   "platforms": ["plivo"],

package/package.json

@@ -1,30 +1,53 @@
 {
   "name": "@framers/agentos-ext-voice-plivo",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Plivo voice call provider for AgentOS — outbound/inbound calls via Plivo Voice API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
-    "test": "vitest run",
-    "clean": "rm -rf dist"
+  "keywords": [
+    "agentos",
+    "extension",
+    "voice",
+    "plivo",
+    "telephony"
+  ],
+  "author": {
+    "name": "Framers AI",
+    "url": "https://frame.dev"
   },
-  "keywords": ["agentos", "extension", "voice", "plivo", "telephony"],
-  "author": { "name": "Framers AI", "url": "https://frame.dev" },
   "license": "MIT",
-  "files": ["dist", "manifest.json"],
+  "files": [
+    "dist",
+    "manifest.json"
+  ],
   "peerDependencies": {
-    "@framers/agentos": "^0.1.0"
+    "@framers/agentos": "^0.10.34"
   },
   "dependencies": {
     "plivo": "^4.0.0"
   },
   "devDependencies": {
-    "@framers/agentos": "workspace:*",
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0",
-    "vitest": "^1.0.0"
+    "vitest": "^1.0.0",
+    "@framers/agentos": "^0.10.34"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/framerslab/agentos-extensions.git",
+    "directory": "registry/curated/voice/plivo"
   },
-  "engines": { "node": ">=18.0.0" }
-}
+  "homepage": "https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/voice/plivo#readme",
+  "bugs": {
+    "url": "https://github.com/framerslab/agentos-extensions/issues"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}