@telnyx/ai-agent-lib 0.1.0

package/dist/message.d.ts

@@ -0,0 +1,45 @@
+export type TranscriptMessage = {
+    id: string;
+    jsonrpc: "2.0";
+    method: "ai_conversation";
+    params: {
+        type: string;
+    };
+};
+export declare function isTranscriptMessage(msg: unknown): msg is TranscriptMessage;
+export type ResponseTextDelta = {
+    id: string;
+    jsonrpc: "2.0";
+    method: "ai_conversation";
+    params: {
+        content_index: number;
+        delta: string;
+        item_id: string;
+        output_index: number;
+        response_id: string;
+        type: "response.text.delta";
+    };
+    voice_sdk_id: string;
+};
+export declare function isResponseTextDelta(message: unknown): message is ResponseTextDelta;
+export type ConversationItemCreatedMessage = {
+    id: string;
+    jsonrpc: "2.0";
+    method: "ai_conversation";
+    params: {
+        item: {
+            content: {
+                transcript: string;
+                type: "input_audio";
+            }[];
+            id: string;
+            role: string;
+            status: string;
+            type: string;
+        };
+        previous_item_id: string;
+        type: "conversation.item.created";
+    };
+    voice_sdk_id: string;
+};
+export declare function isConversationItemCreatedMessage(message: unknown): message is ConversationItemCreatedMessage;

package/dist/react/agent-state-auto-update.d.ts

@@ -0,0 +1 @@
+export declare function AgentStateAutoUpdate(): null;

package/dist/react/client-context.d.ts

@@ -0,0 +1,5 @@
+import type { PropsWithChildren } from "react";
+import type { TelnyxAIAgentConstructorParams } from "../client";
+import { TelnyxAIAgent } from "../client";
+export declare const ClientContext: import("react").Context<TelnyxAIAgent | null>;
+export declare const TelnyxAIAgentProvider: ({ children, agentId, environment, versionId, }: PropsWithChildren & TelnyxAIAgentConstructorParams) => import("react/jsx-runtime").JSX.Element;

package/dist/react/connection-state-auto-update.d.ts

@@ -0,0 +1 @@
+export declare function ConnectionStateAutoUpdate(): null;

package/dist/react/conversation-auto-update.d.ts

@@ -0,0 +1 @@
+export declare const ConversationAutoUpdate: () => null;

package/dist/react/transcript-auto-update.d.ts

@@ -0,0 +1 @@
+export declare function TranscriptAutoUpdate(): null;

package/dist/react/use-agent-state.d.ts

@@ -0,0 +1,3 @@
+import type { AgentState } from "../types";
+export declare function useAgentState(): AgentState;
+export declare function useSetAgentState(): (args_0: AgentState | ((prev: AgentState) => AgentState)) => void;

package/dist/react/use-client-connection-state.d.ts

@@ -0,0 +1,3 @@
+export type ConnectionState = "connecting" | "connected" | "disconnected" | "error";
+export declare function useConnectionState(): ConnectionState;
+export declare function useSetConnectionState(): (args_0: ConnectionState | ((prev: ConnectionState) => ConnectionState)) => void;

package/dist/react/use-client.d.ts

@@ -0,0 +1 @@
+export declare const useClient: () => import("..").TelnyxAIAgent;

package/dist/react/use-conversation.d.ts

@@ -0,0 +1,3 @@
+import { type INotification } from "@telnyx/webrtc";
+export declare function useConversation(): INotification | null;
+export declare function useSetConversation(): (args_0: INotification | ((prev: INotification | null) => INotification | null) | null) => void;

package/dist/react/use-transcript.d.ts

@@ -0,0 +1,3 @@
+import type { TranscriptItem } from "../types";
+export declare function useTranscript(): TranscriptItem[];
+export declare function useSetTranscript(): (args_0: TranscriptItem[] | ((prev: TranscriptItem[]) => TranscriptItem[])) => void;

package/dist/transcript.d.ts

@@ -0,0 +1,9 @@
+import EventEmitter from "eventemitter3";
+import type { TranscriptEvents, TranscriptItem } from "./types";
+import { TelnyxRTC } from "@telnyx/webrtc";
+export declare class Transcription extends EventEmitter<TranscriptEvents> {
+    private telnyxRTC;
+    transcript: TranscriptItem[];
+    constructor(client: TelnyxRTC);
+    private onSocketMessage;
+}

package/dist/types.d.ts

@@ -0,0 +1,19 @@
+import type { INotification } from "@telnyx/webrtc";
+export type TranscriptItem = {
+    id: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: Date;
+};
+export type AIAgentEvents = {
+    "agent.connected": () => void;
+    "agent.disconnected": () => void;
+    "agent.error": (error: Error) => void;
+    "transcript.item": (item: TranscriptItem) => void;
+    "conversation.update": (call: INotification) => void;
+    "conversation.agent.state": (state: AgentState) => void;
+    "agent.audio.mute": (muted: boolean) => void;
+};
+export type AgentState = "speaking" | "listening" | "thinking";
+export type TranscriptEvents = Pick<AIAgentEvents, "transcript.item">;
+export type AgentStateEvents = Pick<AIAgentEvents, "conversation.agent.state">;

package/dist/util.d.ts

@@ -0,0 +1 @@
+export declare function debounce<T extends unknown[]>(fn: (...args: T) => void, delay: number): (...args: T) => void;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@telnyx/ai-agent-lib",
+  "private": false,
+  "version": "0.1.0",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview",
+    "release": "release-it"
+  },
+  "dependencies": {
+    "@telnyx/webrtc": "^2.22.15",
+    "@types/node": "^24.1.0",
+    "eventemitter3": "^5.0.1",
+    "jotai": "^2.12.5",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.30.1",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "@vitejs/plugin-react-swc": "^3.10.2",
+    "eslint": "^9.30.1",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.20",
+    "globals": "^16.3.0",
+    "release-it": "^19.0.4",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.35.1",
+    "vite": "^7.0.4"
+  }
+}