@runcore-sh/runcore 0.1.2

package/dist/tracing/tracer.js

@@ -0,0 +1,327 @@
+/**
+ * Lightweight tracing for Core agent runtime.
+ *
+ * Hooks into RuntimeBus lifecycle events to automatically create trace spans
+ * for agent operations (spawn, pause, resume, terminate, complete, fail).
+ * Tracks parent→child agent relationships as nested spans within a trace.
+ *
+ * Trace/span IDs use W3C-compatible hex format for future OTel export.
+ */
+import { randomBytes } from "node:crypto";
+// ---------------------------------------------------------------------------
+// ID generation (W3C Trace Context compatible)
+// ---------------------------------------------------------------------------
+/** 16-byte (32 hex char) trace ID. */
+export function generateTraceId() {
+    return randomBytes(16).toString("hex");
+}
+/** 8-byte (16 hex char) span ID. */
+export function generateSpanId() {
+    return randomBytes(8).toString("hex");
+}
+// ---------------------------------------------------------------------------
+// Tracer
+// ---------------------------------------------------------------------------
+export class Tracer {
+    /** All spans indexed by spanId. */
+    spans = new Map();
+    /** agentId → active spanId for that agent. */
+    activeSpans = new Map();
+    /** agentId → traceId (so child agents inherit the parent's trace). */
+    agentTraces = new Map();
+    /** traceId → set of spanIds. */
+    traceSpans = new Map();
+    /** traceId → root spanId. */
+    traceRoots = new Map();
+    /** Maximum number of completed traces to retain. */
+    maxTraces;
+    /** Ordered list of traceIds for eviction. */
+    traceOrder = [];
+    constructor(opts) {
+        this.maxTraces = opts?.maxTraces ?? 500;
+    }
+    // -------------------------------------------------------------------------
+    // Manual span API
+    // -------------------------------------------------------------------------
+    /** Start a new span. If parentAgentId is provided, joins that agent's trace. */
+    startSpan(opts) {
+        // Determine trace context
+        let traceId;
+        let parentSpanId;
+        if (opts.parentAgentId && this.agentTraces.has(opts.parentAgentId)) {
+            // Join parent's trace
+            traceId = this.agentTraces.get(opts.parentAgentId);
+            parentSpanId = this.activeSpans.get(opts.parentAgentId);
+        }
+        else {
+            // New root trace
+            traceId = generateTraceId();
+        }
+        const spanId = generateSpanId();
+        const now = new Date().toISOString();
+        const span = {
+            traceId,
+            spanId,
+            parentSpanId,
+            operationName: opts.operationName,
+            agentId: opts.agentId,
+            taskId: opts.taskId,
+            startTime: now,
+            status: "running",
+            attributes: opts.attributes ?? {},
+            events: [],
+        };
+        this.spans.set(spanId, span);
+        this.activeSpans.set(opts.agentId, spanId);
+        this.agentTraces.set(opts.agentId, traceId);
+        // Track span in trace index
+        if (!this.traceSpans.has(traceId)) {
+            this.traceSpans.set(traceId, new Set());
+            this.traceRoots.set(traceId, spanId);
+            this.traceOrder.push(traceId);
+            this.evict();
+        }
+        this.traceSpans.get(traceId).add(spanId);
+        return span;
+    }
+    /** Add an event to an active span. */
+    addEvent(spanId, name, attributes) {
+        const span = this.spans.get(spanId);
+        if (!span)
+            return;
+        span.events.push({
+            name,
+            timestamp: new Date().toISOString(),
+            attributes,
+        });
+    }
+    /** Set attributes on a span. */
+    setAttributes(spanId, attributes) {
+        const span = this.spans.get(spanId);
+        if (!span)
+            return;
+        Object.assign(span.attributes, attributes);
+    }
+    /** End a span with a status. */
+    endSpan(spanId, status = "ok") {
+        const span = this.spans.get(spanId);
+        if (!span || span.endTime)
+            return;
+        const now = new Date().toISOString();
+        span.endTime = now;
+        span.durationMs = new Date(now).getTime() - new Date(span.startTime).getTime();
+        span.status = status;
+        // Clear active span if this is the current one for the agent
+        if (this.activeSpans.get(span.agentId) === spanId) {
+            this.activeSpans.delete(span.agentId);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Bus integration — auto-create spans from lifecycle events
+    // -------------------------------------------------------------------------
+    /**
+     * Attach to a RuntimeBus to automatically create spans from lifecycle events.
+     * Call this once during runtime initialization.
+     */
+    attachToBus(bus) {
+        bus.on("agent:lifecycle", (event) => {
+            this.handleLifecycleEvent(event);
+        });
+        bus.on("agent:spawned", ({ agentId, pid }) => {
+            const spanId = this.activeSpans.get(agentId);
+            if (spanId) {
+                this.setAttributes(spanId, { pid: pid ?? 0 });
+            }
+        });
+        bus.on("agent:failed", ({ agentId, error }) => {
+            const spanId = this.activeSpans.get(agentId);
+            if (spanId) {
+                this.addEvent(spanId, "error", {
+                    "error.code": error.code,
+                    "error.message": error.message,
+                    "error.recoverable": error.recoverable,
+                });
+            }
+        });
+    }
+    handleLifecycleEvent(event) {
+        const { agentId, previousState, newState, timestamp, reason } = event;
+        // Add state transition as an event on the active span
+        const activeSpanId = this.activeSpans.get(agentId);
+        if (previousState === "initializing" && newState === "running") {
+            // Span was already started during spawn — just add the event
+            if (activeSpanId) {
+                this.addEvent(activeSpanId, "state:running", {
+                    ...(reason ? { reason } : {}),
+                });
+            }
+        }
+        else if (newState === "paused") {
+            if (activeSpanId) {
+                this.addEvent(activeSpanId, "state:paused", {
+                    ...(reason ? { reason } : {}),
+                });
+                // End the running span, mark as ok (paused is not an error)
+                this.endSpan(activeSpanId, "ok");
+            }
+        }
+        else if (previousState === "paused" && newState === "resuming") {
+            // Start a new span for the resumed execution
+            const traceId = this.agentTraces.get(agentId);
+            if (traceId) {
+                const spanId = generateSpanId();
+                const span = {
+                    traceId,
+                    spanId,
+                    parentSpanId: activeSpanId, // chain from the paused span
+                    operationName: "agent:resume",
+                    agentId,
+                    startTime: timestamp,
+                    status: "running",
+                    attributes: {},
+                    events: [{ name: "state:resuming", timestamp }],
+                };
+                this.spans.set(spanId, span);
+                this.activeSpans.set(agentId, spanId);
+                this.traceSpans.get(traceId)?.add(spanId);
+            }
+        }
+        else if (newState === "completed") {
+            if (activeSpanId) {
+                this.addEvent(activeSpanId, "state:completed", {
+                    ...(reason ? { reason } : {}),
+                });
+                this.endSpan(activeSpanId, "ok");
+            }
+            this.agentTraces.delete(agentId);
+        }
+        else if (newState === "failed") {
+            if (activeSpanId) {
+                this.addEvent(activeSpanId, "state:failed", {
+                    ...(reason ? { reason } : {}),
+                });
+                this.endSpan(activeSpanId, "error");
+            }
+            this.agentTraces.delete(agentId);
+        }
+        else if (newState === "terminated") {
+            if (activeSpanId) {
+                this.addEvent(activeSpanId, "state:terminated", {
+                    ...(reason ? { reason } : {}),
+                });
+                this.endSpan(activeSpanId, "ok");
+            }
+            this.agentTraces.delete(agentId);
+        }
+        else if (activeSpanId) {
+            // Generic transition event
+            this.addEvent(activeSpanId, `state:${newState}`, {
+                previousState,
+                ...(reason ? { reason } : {}),
+            });
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Query API
+    // -------------------------------------------------------------------------
+    /** Get a span by ID. */
+    getSpan(spanId) {
+        return this.spans.get(spanId);
+    }
+    /** Get the active span for an agent. */
+    getActiveSpan(agentId) {
+        const spanId = this.activeSpans.get(agentId);
+        return spanId ? this.spans.get(spanId) : undefined;
+    }
+    /** Get a trace summary by ID. */
+    getTrace(traceId) {
+        const spanIds = this.traceSpans.get(traceId);
+        if (!spanIds)
+            return undefined;
+        const rootSpanId = this.traceRoots.get(traceId);
+        if (!rootSpanId)
+            return undefined;
+        const rootSpan = this.spans.get(rootSpanId);
+        if (!rootSpan)
+            return undefined;
+        const spans = [...spanIds].map((id) => this.spans.get(id)).filter(Boolean);
+        const hasError = spans.some((s) => s.status === "error");
+        const allDone = spans.every((s) => s.status !== "running");
+        // Trace end time = latest span end time
+        let endTime;
+        let durationMs;
+        if (allDone) {
+            const endTimes = spans
+                .map((s) => s.endTime)
+                .filter((t) => !!t)
+                .sort();
+            endTime = endTimes[endTimes.length - 1];
+            if (endTime) {
+                durationMs = new Date(endTime).getTime() - new Date(rootSpan.startTime).getTime();
+            }
+        }
+        return {
+            traceId,
+            rootSpanId,
+            startTime: rootSpan.startTime,
+            endTime,
+            durationMs,
+            spanCount: spans.length,
+            status: hasError ? "error" : allDone ? "ok" : "running",
+            label: rootSpan.attributes["agent.label"],
+        };
+    }
+    /** Get full trace detail (summary + all spans). */
+    getTraceDetail(traceId) {
+        const trace = this.getTrace(traceId);
+        if (!trace)
+            return undefined;
+        const spanIds = this.traceSpans.get(traceId);
+        const spans = [...spanIds]
+            .map((id) => this.spans.get(id))
+            .filter(Boolean)
+            .sort((a, b) => new Date(a.startTime).getTime() - new Date(b.startTime).getTime());
+        return { trace, spans };
+    }
+    /** List recent traces, newest first. */
+    listTraces(opts) {
+        const limit = opts?.limit ?? 50;
+        const traces = [];
+        // Walk traceOrder in reverse (newest first)
+        for (let i = this.traceOrder.length - 1; i >= 0 && traces.length < limit; i--) {
+            const trace = this.getTrace(this.traceOrder[i]);
+            if (!trace)
+                continue;
+            if (opts?.status && trace.status !== opts.status)
+                continue;
+            traces.push(trace);
+        }
+        return traces;
+    }
+    /** Get the trace ID associated with an agent. */
+    getAgentTraceId(agentId) {
+        return this.agentTraces.get(agentId);
+    }
+    // -------------------------------------------------------------------------
+    // Internal: eviction
+    // -------------------------------------------------------------------------
+    evict() {
+        while (this.traceOrder.length > this.maxTraces) {
+            const oldTraceId = this.traceOrder.shift();
+            const spanIds = this.traceSpans.get(oldTraceId);
+            if (spanIds) {
+                for (const spanId of spanIds) {
+                    const span = this.spans.get(spanId);
+                    if (span) {
+                        this.activeSpans.delete(span.agentId);
+                        this.agentTraces.delete(span.agentId);
+                    }
+                    this.spans.delete(spanId);
+                }
+            }
+            this.traceSpans.delete(oldTraceId);
+            this.traceRoots.delete(oldTraceId);
+        }
+    }
+}
+//# sourceMappingURL=tracer.js.map

package/dist/tracing/tracer.js.map

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

package/dist/tts/client.d.ts

@@ -0,0 +1,18 @@
+/**
+ * TTS client — sends text to the Piper HTTP server and returns WAV audio.
+ * Piper's API is POST / with JSON body {"text": "..."}, returns WAV bytes.
+ * All functions are safe — they return null on any failure.
+ */
+/**
+ * Health probe — hit GET /voices (a lightweight list endpoint).
+ * 3-second timeout, returns false on any failure.
+ */
+export declare function checkTtsSidecar(): Promise<boolean>;
+/**
+ * Synthesize text to WAV audio via Piper.
+ * POST / with JSON {"text": "..."} → WAV bytes.
+ * Returns a Buffer of WAV bytes, or null on failure.
+ */
+export declare function synthesize(text: string): Promise<Buffer | null>;
+export { isTtsAvailable } from "./sidecar.js";
+//# sourceMappingURL=client.d.ts.map

package/dist/tts/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/tts/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CASxD;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcrE;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/tts/client.js

@@ -0,0 +1,48 @@
+/**
+ * TTS client — sends text to the Piper HTTP server and returns WAV audio.
+ * Piper's API is POST / with JSON body {"text": "..."}, returns WAV bytes.
+ * All functions are safe — they return null on any failure.
+ */
+import { getTtsConfig } from "../settings.js";
+function baseUrl() {
+    return `http://127.0.0.1:${getTtsConfig().port}`;
+}
+/**
+ * Health probe — hit GET /voices (a lightweight list endpoint).
+ * 3-second timeout, returns false on any failure.
+ */
+export async function checkTtsSidecar() {
+    try {
+        const res = await fetch(`${baseUrl()}/voices`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Synthesize text to WAV audio via Piper.
+ * POST / with JSON {"text": "..."} → WAV bytes.
+ * Returns a Buffer of WAV bytes, or null on failure.
+ */
+export async function synthesize(text) {
+    try {
+        const res = await fetch(`${baseUrl()}/`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ text }),
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!res.ok)
+            return null;
+        const arrayBuf = await res.arrayBuffer();
+        return Buffer.from(arrayBuf);
+    }
+    catch {
+        return null;
+    }
+}
+export { isTtsAvailable } from "./sidecar.js";
+//# sourceMappingURL=client.js.map

package/dist/tts/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/tts/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,SAAS,OAAO;IACd,OAAO,oBAAoB,YAAY,EAAE,CAAC,IAAI,EAAE,CAAC;AACnD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE;YAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;YAC9B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC;QACzC,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/tts/sidecar.d.ts

@@ -0,0 +1,16 @@
+/**
+ * TTS sidecar lifecycle manager.
+ * Spawns the Piper HTTP server and monitors its health.
+ * Graceful degradation — if Piper isn't installed, Core works normally as text chat.
+ */
+/**
+ * Start the Piper TTS sidecar.
+ * Downloads the voice model if needed, then spawns the HTTP server.
+ * Returns true if sidecar is available after startup.
+ */
+export declare function startTtsSidecar(): Promise<boolean>;
+/** Check if the TTS sidecar is currently available. */
+export declare function isTtsAvailable(): boolean;
+/** Stop the TTS sidecar process. */
+export declare function stopTtsSidecar(): void;
+//# sourceMappingURL=sidecar.d.ts.map

package/dist/tts/sidecar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/tts/sidecar.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8EH;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAmExD;AAED,uDAAuD;AACvD,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,oCAAoC;AACpC,wBAAgB,cAAc,IAAI,IAAI,CAUrC"}

package/dist/tts/sidecar.js

@@ -0,0 +1,148 @@
+/**
+ * TTS sidecar lifecycle manager.
+ * Spawns the Piper HTTP server and monitors its health.
+ * Graceful degradation — if Piper isn't installed, Core works normally as text chat.
+ */
+import { spawn, execFile } from "node:child_process";
+import { access, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { getTtsConfig } from "../settings.js";
+import { checkTtsSidecar } from "./client.js";
+import { createLogger } from "../utils/logger.js";
+const log = createLogger("tts-sidecar");
+const VOICES_DIR = join(process.cwd(), "sidecar", "tts", "voices");
+// First-run download can take a while; health poll after that is fast
+const HEALTH_POLL_INTERVAL = 500; // ms
+const HEALTH_POLL_TIMEOUT = 15_000; // ms
+const DOWNLOAD_TIMEOUT = 120_000; // ms — model download can be ~100MB
+let sidecarProcess = null;
+let available = false;
+function pythonCommand() {
+    return process.platform === "win32" ? "python" : "python3";
+}
+/**
+ * Resolve the .onnx file path for a voice name.
+ * Piper stores downloaded voices as <voice_name>/<voice_name>.onnx inside the data dir.
+ * Returns the path if found on disk, otherwise null.
+ */
+async function findVoiceModel(voice) {
+    // Check both flat and nested layouts that Piper's downloader might use
+    const candidates = [
+        join(VOICES_DIR, voice, `${voice}.onnx`),
+        join(VOICES_DIR, `${voice}.onnx`),
+    ];
+    for (const p of candidates) {
+        try {
+            await access(p);
+            return p;
+        }
+        catch { }
+    }
+    return null;
+}
+/**
+ * Download a voice model using piper.download_voices if it's not already on disk.
+ * Returns the .onnx path on success, null on failure.
+ */
+async function ensureVoiceModel(voice) {
+    await mkdir(VOICES_DIR, { recursive: true });
+    // Already downloaded?
+    const existing = await findVoiceModel(voice);
+    if (existing)
+        return existing;
+    log.info(` Downloading voice "${voice}" (first run, ~100MB)...`);
+    const python = pythonCommand();
+    return new Promise((resolve) => {
+        execFile(python, ["-m", "piper.download_voices", "--download-dir", VOICES_DIR, voice], { timeout: DOWNLOAD_TIMEOUT }, async (err, _stdout, stderr) => {
+            if (err) {
+                log.info(` Voice download failed: ${err.message}`);
+                if (stderr)
+                    log.info(` ${stderr.trim()}`);
+                resolve(null);
+                return;
+            }
+            log.info(` Voice downloaded successfully`);
+            resolve(await findVoiceModel(voice));
+        });
+    });
+}
+/**
+ * Start the Piper TTS sidecar.
+ * Downloads the voice model if needed, then spawns the HTTP server.
+ * Returns true if sidecar is available after startup.
+ */
+export async function startTtsSidecar() {
+    const config = getTtsConfig();
+    if (!config.enabled) {
+        available = false;
+        return false;
+    }
+    // Check if already running externally
+    if (await checkTtsSidecar()) {
+        available = true;
+        return true;
+    }
+    // Ensure the voice model .onnx file exists on disk
+    const modelPath = await ensureVoiceModel(config.voice);
+    if (!modelPath) {
+        log.info(` No voice model available — TTS disabled`);
+        return false;
+    }
+    const python = pythonCommand();
+    const port = String(config.port);
+    try {
+        sidecarProcess = spawn(python, ["-m", "piper.http_server", "--model", modelPath, "--data-dir", VOICES_DIR, "--port", port], { stdio: ["ignore", "pipe", "pipe"], detached: false });
+        sidecarProcess.stderr?.on("data", (data) => {
+            const msg = data.toString().trim();
+            if (msg)
+                log.info(` ${msg}`);
+        });
+        sidecarProcess.on("error", (err) => {
+            log.info(` Failed to start: ${err.message}`);
+            available = false;
+            sidecarProcess = null;
+        });
+        sidecarProcess.on("exit", (code) => {
+            if (code !== null && code !== 0) {
+                log.info(` Exited with code ${code}`);
+            }
+            available = false;
+            sidecarProcess = null;
+        });
+        // Poll until ready or timeout
+        const start = Date.now();
+        while (Date.now() - start < HEALTH_POLL_TIMEOUT) {
+            if (await checkTtsSidecar()) {
+                available = true;
+                return true;
+            }
+            await new Promise((r) => setTimeout(r, HEALTH_POLL_INTERVAL));
+        }
+        log.info(" Timed out waiting for health check");
+        stopTtsSidecar();
+        return false;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        log.info(` Spawn failed: ${msg}`);
+        return false;
+    }
+}
+/** Check if the TTS sidecar is currently available. */
+export function isTtsAvailable() {
+    return available;
+}
+/** Stop the TTS sidecar process. */
+export function stopTtsSidecar() {
+    if (sidecarProcess) {
+        try {
+            sidecarProcess.kill();
+        }
+        catch {
+            // Already dead
+        }
+        sidecarProcess = null;
+    }
+    available = false;
+}
+//# sourceMappingURL=sidecar.js.map

package/dist/tts/sidecar.js.map

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

package/dist/twilio/call.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Twilio voice call via raw REST API.
+ * No SDK — uses native fetch() with inline TwiML.
+ * Credentials read from process.env (hydrated by vault).
+ */
+export interface CallOptions {
+    to?: string;
+    message?: string;
+    voice?: string;
+}
+export interface CallResult {
+    ok: boolean;
+    sid?: string;
+    message: string;
+}
+/**
+ * Place a voice call via Twilio REST API.
+ * Reads creds from process.env, builds TwiML <Say>, POSTs to Twilio.
+ * Never throws — returns { ok, sid?, message }.
+ */
+export declare function makeCall(options?: CallOptions): Promise<CallResult>;
+//# sourceMappingURL=call.d.ts.map

package/dist/twilio/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/twilio/call.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA+DzE"}