@prestyj/voice 4.3.191

package/dist/types-Dc4Q3Z6X.d.cts

@@ -0,0 +1,257 @@
+type JsonObject = Record<string, unknown>;
+type VoiceConnectionState = "idle" | "connecting" | "connected" | "closing" | "closed";
+interface VoiceSessionMetadata {
+    readonly sessionId?: string;
+    readonly conversationId?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly createdAt?: string;
+}
+interface VoiceAuthConfig {
+    readonly apiKey?: string;
+    readonly ephemeralKey?: string;
+    readonly accessToken?: string;
+    readonly baseUrl?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+interface VoiceSessionConfig {
+    readonly model: string;
+    readonly instructions?: string;
+    readonly voice?: string;
+    readonly modalities?: readonly ("audio" | "text")[];
+    readonly inputAudioFormat?: string;
+    readonly outputAudioFormat?: string;
+    readonly turnDetection?: JsonObject | null;
+    readonly tools?: readonly VoiceTool[];
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+interface VoiceProviderConnectOptions {
+    readonly auth?: VoiceAuthConfig;
+    readonly session: VoiceSessionConfig;
+    readonly transport?: VoiceTransport;
+    readonly signal?: AbortSignal;
+}
+interface VoiceProvider {
+    readonly name: string;
+    connect(options: VoiceProviderConnectOptions): Promise<VoiceSession>;
+}
+interface VoiceSession {
+    readonly id: string;
+    readonly provider: string;
+    readonly state: VoiceConnectionState;
+    readonly metadata: VoiceSessionMetadata;
+    onEvent(handler: VoiceEventHandler): () => void;
+    sendAudio(chunk: AudioInputChunk, signal?: AbortSignal): Promise<void>;
+    sendText(text: string, signal?: AbortSignal): Promise<void>;
+    sendToolResult(result: VoiceToolResult, signal?: AbortSignal): Promise<void>;
+    updateConfig(config: Partial<VoiceSessionConfig>, signal?: AbortSignal): Promise<void>;
+    close(reason?: string): Promise<void>;
+}
+type VoiceEventHandler = (event: VoiceEvent) => void;
+interface AudioInputChunk {
+    readonly data: ArrayBuffer | Uint8Array | string;
+    readonly format?: string;
+    readonly sampleRate?: number;
+    readonly channels?: number;
+    readonly timestampMs?: number;
+}
+interface AudioOutputChunk {
+    readonly data: ArrayBuffer | Uint8Array | string;
+    readonly format?: string;
+    readonly sampleRate?: number;
+    readonly channels?: number;
+    readonly timestampMs?: number;
+}
+interface VoiceSessionStartedEvent {
+    readonly type: "session_started";
+    readonly session: VoiceSessionMetadata;
+}
+interface VoiceInputTranscriptDeltaEvent {
+    readonly type: "input_transcript_delta";
+    readonly delta: string;
+    readonly itemId?: string;
+}
+interface VoiceInputTranscriptDoneEvent {
+    readonly type: "input_transcript_done";
+    readonly text: string;
+    readonly itemId?: string;
+}
+interface VoiceOutputTextDeltaEvent {
+    readonly type: "output_text_delta";
+    readonly delta: string;
+    readonly itemId?: string;
+}
+interface VoiceOutputTextDoneEvent {
+    readonly type: "output_text_done";
+    readonly text: string;
+    readonly itemId?: string;
+}
+interface VoiceOutputAudioStartedEvent {
+    readonly type: "output_audio_started";
+    readonly itemId?: string;
+}
+interface VoiceOutputAudioDeltaEvent {
+    readonly type: "output_audio_delta";
+    readonly chunk: AudioOutputChunk;
+    readonly itemId?: string;
+}
+interface VoiceOutputAudioDoneEvent {
+    readonly type: "output_audio_done";
+    readonly itemId?: string;
+}
+interface VoiceToolCallEvent {
+    readonly type: "tool_call";
+    readonly call: VoiceToolCall;
+}
+interface VoiceToolResultSentEvent {
+    readonly type: "tool_result_sent";
+    readonly result: VoiceToolResult;
+}
+interface VoiceErrorEvent {
+    readonly type: "error";
+    readonly error: Error;
+    readonly recoverable: boolean;
+}
+interface VoiceClosedEvent {
+    readonly type: "closed";
+    readonly reason?: string;
+}
+type VoiceEvent = VoiceSessionStartedEvent | VoiceInputTranscriptDeltaEvent | VoiceInputTranscriptDoneEvent | VoiceOutputTextDeltaEvent | VoiceOutputTextDoneEvent | VoiceOutputAudioStartedEvent | VoiceOutputAudioDeltaEvent | VoiceOutputAudioDoneEvent | VoiceToolCallEvent | VoiceToolResultSentEvent | VoiceErrorEvent | VoiceClosedEvent;
+interface RealtimeFunctionToolDefinition {
+    readonly type: "function";
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: JsonObject;
+}
+type ToolConfirmationPolicy = "never" | "always" | "destructive" | ((request: ToolConfirmationRequest) => ToolConfirmationDecision | Promise<ToolConfirmationDecision>);
+interface ToolConfirmationRequest {
+    readonly call: VoiceToolCall;
+    readonly tool: VoiceTool;
+}
+type ToolConfirmationDecision = {
+    readonly approved: true;
+} | {
+    readonly approved: false;
+    readonly reason: string;
+};
+type ToolConfirmationResolver = (request: ToolConfirmationRequest) => ToolConfirmationDecision | Promise<ToolConfirmationDecision>;
+interface VoiceToolContext {
+    readonly signal: AbortSignal;
+    readonly toolCallId: string;
+    readonly confirmation?: ToolConfirmationResolver;
+    readonly onUpdate?: (update: unknown) => void;
+}
+interface VoiceTool {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: JsonObject;
+    readonly confirmation?: ToolConfirmationPolicy;
+    readonly destructive?: boolean;
+    execute?(args: JsonObject, context: VoiceToolContext): VoiceToolExecutionResult | Promise<VoiceToolExecutionResult>;
+}
+interface VoiceToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly args: JsonObject;
+    readonly providerCallId?: string;
+    readonly raw?: unknown;
+}
+type VoiceToolExecutionResult = string | JsonObject | readonly JsonObject[];
+interface VoiceToolResult {
+    readonly toolCallId: string;
+    readonly name: string;
+    readonly content: VoiceToolExecutionResult;
+    readonly isError?: boolean;
+}
+interface VoiceToolExecutionError {
+    readonly type: "tool_not_found" | "tool_confirmation_denied" | "tool_execution_failed";
+    readonly message: string;
+    readonly cause?: unknown;
+}
+interface VoiceTransportConnectOptions {
+    readonly auth?: VoiceAuthConfig;
+    readonly session: VoiceSessionConfig;
+    readonly signal?: AbortSignal;
+}
+interface VoiceTransport {
+    readonly kind: "webrtc" | "websocket" | "custom";
+    connect(options: VoiceTransportConnectOptions): Promise<void>;
+    onEvent(handler: VoiceTransportEventHandler): () => void;
+    send(event: VoiceTransportSendEvent, signal?: AbortSignal): Promise<void>;
+    close(reason?: string): Promise<void>;
+}
+type VoiceTransportEventHandler = (event: VoiceTransportEvent) => void;
+type VoiceTransportSendEvent = {
+    readonly type: "audio";
+    readonly chunk: AudioInputChunk;
+} | {
+    readonly type: "text";
+    readonly text: string;
+} | {
+    readonly type: "tool_result";
+    readonly result: VoiceToolResult;
+} | {
+    readonly type: "config";
+    readonly config: Partial<VoiceSessionConfig>;
+};
+type VoiceTransportEvent = VoiceEvent | {
+    readonly type: "raw";
+    readonly data: unknown;
+};
+type VoiceBridgeCommand = {
+    readonly type: "prompt";
+    readonly text: string;
+    readonly sessionId?: string;
+    readonly project?: string;
+} | {
+    readonly type: "cancel";
+    readonly sessionId?: string;
+} | {
+    readonly type: "status";
+    readonly sessionId?: string;
+} | {
+    readonly type: "new_session";
+    readonly project?: string;
+} | {
+    readonly type: "switch_project";
+    readonly project: string;
+} | {
+    readonly type: "switch_model";
+    readonly provider: string;
+    readonly model: string;
+} | {
+    readonly type: "list_projects";
+};
+type VoiceBridgeEvent = {
+    readonly type: "text_delta";
+    readonly text: string;
+    readonly sessionId?: string;
+} | {
+    readonly type: "tool_start";
+    readonly name: string;
+    readonly id?: string;
+    readonly sessionId?: string;
+} | {
+    readonly type: "tool_end";
+    readonly name: string;
+    readonly id?: string;
+    readonly isError?: boolean;
+    readonly sessionId?: string;
+} | {
+    readonly type: "task_dispatch";
+    readonly workerId?: string;
+    readonly text: string;
+} | {
+    readonly type: "completion";
+    readonly sessionId?: string;
+} | {
+    readonly type: "status";
+    readonly status: JsonObject;
+    readonly sessionId?: string;
+} | {
+    readonly type: "error";
+    readonly error: string;
+    readonly sessionId?: string;
+};
+
+export type { AudioInputChunk as A, JsonObject as J, RealtimeFunctionToolDefinition as R, ToolConfirmationDecision as T, VoiceTransport as V, VoiceSessionMetadata as a, VoiceToolResult as b, VoiceSessionConfig as c, VoiceSession as d, VoiceTool as e, VoiceToolCall as f, VoiceToolContext as g, VoiceProvider as h, VoiceEvent as i, VoiceProviderConnectOptions as j, AudioOutputChunk as k, ToolConfirmationPolicy as l, ToolConfirmationRequest as m, ToolConfirmationResolver as n, VoiceAuthConfig as o, VoiceBridgeCommand as p, VoiceBridgeEvent as q, VoiceConnectionState as r, VoiceEventHandler as s, VoiceToolExecutionError as t, VoiceToolExecutionResult as u, VoiceTransportConnectOptions as v, VoiceTransportEvent as w, VoiceTransportEventHandler as x, VoiceTransportSendEvent as y };

package/dist/types-Dc4Q3Z6X.d.ts

@@ -0,0 +1,257 @@
+type JsonObject = Record<string, unknown>;
+type VoiceConnectionState = "idle" | "connecting" | "connected" | "closing" | "closed";
+interface VoiceSessionMetadata {
+    readonly sessionId?: string;
+    readonly conversationId?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly createdAt?: string;
+}
+interface VoiceAuthConfig {
+    readonly apiKey?: string;
+    readonly ephemeralKey?: string;
+    readonly accessToken?: string;
+    readonly baseUrl?: string;
+    readonly headers?: Readonly<Record<string, string>>;
+}
+interface VoiceSessionConfig {
+    readonly model: string;
+    readonly instructions?: string;
+    readonly voice?: string;
+    readonly modalities?: readonly ("audio" | "text")[];
+    readonly inputAudioFormat?: string;
+    readonly outputAudioFormat?: string;
+    readonly turnDetection?: JsonObject | null;
+    readonly tools?: readonly VoiceTool[];
+    readonly metadata?: Readonly<Record<string, string>>;
+}
+interface VoiceProviderConnectOptions {
+    readonly auth?: VoiceAuthConfig;
+    readonly session: VoiceSessionConfig;
+    readonly transport?: VoiceTransport;
+    readonly signal?: AbortSignal;
+}
+interface VoiceProvider {
+    readonly name: string;
+    connect(options: VoiceProviderConnectOptions): Promise<VoiceSession>;
+}
+interface VoiceSession {
+    readonly id: string;
+    readonly provider: string;
+    readonly state: VoiceConnectionState;
+    readonly metadata: VoiceSessionMetadata;
+    onEvent(handler: VoiceEventHandler): () => void;
+    sendAudio(chunk: AudioInputChunk, signal?: AbortSignal): Promise<void>;
+    sendText(text: string, signal?: AbortSignal): Promise<void>;
+    sendToolResult(result: VoiceToolResult, signal?: AbortSignal): Promise<void>;
+    updateConfig(config: Partial<VoiceSessionConfig>, signal?: AbortSignal): Promise<void>;
+    close(reason?: string): Promise<void>;
+}
+type VoiceEventHandler = (event: VoiceEvent) => void;
+interface AudioInputChunk {
+    readonly data: ArrayBuffer | Uint8Array | string;
+    readonly format?: string;
+    readonly sampleRate?: number;
+    readonly channels?: number;
+    readonly timestampMs?: number;
+}
+interface AudioOutputChunk {
+    readonly data: ArrayBuffer | Uint8Array | string;
+    readonly format?: string;
+    readonly sampleRate?: number;
+    readonly channels?: number;
+    readonly timestampMs?: number;
+}
+interface VoiceSessionStartedEvent {
+    readonly type: "session_started";
+    readonly session: VoiceSessionMetadata;
+}
+interface VoiceInputTranscriptDeltaEvent {
+    readonly type: "input_transcript_delta";
+    readonly delta: string;
+    readonly itemId?: string;
+}
+interface VoiceInputTranscriptDoneEvent {
+    readonly type: "input_transcript_done";
+    readonly text: string;
+    readonly itemId?: string;
+}
+interface VoiceOutputTextDeltaEvent {
+    readonly type: "output_text_delta";
+    readonly delta: string;
+    readonly itemId?: string;
+}
+interface VoiceOutputTextDoneEvent {
+    readonly type: "output_text_done";
+    readonly text: string;
+    readonly itemId?: string;
+}
+interface VoiceOutputAudioStartedEvent {
+    readonly type: "output_audio_started";
+    readonly itemId?: string;
+}
+interface VoiceOutputAudioDeltaEvent {
+    readonly type: "output_audio_delta";
+    readonly chunk: AudioOutputChunk;
+    readonly itemId?: string;
+}
+interface VoiceOutputAudioDoneEvent {
+    readonly type: "output_audio_done";
+    readonly itemId?: string;
+}
+interface VoiceToolCallEvent {
+    readonly type: "tool_call";
+    readonly call: VoiceToolCall;
+}
+interface VoiceToolResultSentEvent {
+    readonly type: "tool_result_sent";
+    readonly result: VoiceToolResult;
+}
+interface VoiceErrorEvent {
+    readonly type: "error";
+    readonly error: Error;
+    readonly recoverable: boolean;
+}
+interface VoiceClosedEvent {
+    readonly type: "closed";
+    readonly reason?: string;
+}
+type VoiceEvent = VoiceSessionStartedEvent | VoiceInputTranscriptDeltaEvent | VoiceInputTranscriptDoneEvent | VoiceOutputTextDeltaEvent | VoiceOutputTextDoneEvent | VoiceOutputAudioStartedEvent | VoiceOutputAudioDeltaEvent | VoiceOutputAudioDoneEvent | VoiceToolCallEvent | VoiceToolResultSentEvent | VoiceErrorEvent | VoiceClosedEvent;
+interface RealtimeFunctionToolDefinition {
+    readonly type: "function";
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: JsonObject;
+}
+type ToolConfirmationPolicy = "never" | "always" | "destructive" | ((request: ToolConfirmationRequest) => ToolConfirmationDecision | Promise<ToolConfirmationDecision>);
+interface ToolConfirmationRequest {
+    readonly call: VoiceToolCall;
+    readonly tool: VoiceTool;
+}
+type ToolConfirmationDecision = {
+    readonly approved: true;
+} | {
+    readonly approved: false;
+    readonly reason: string;
+};
+type ToolConfirmationResolver = (request: ToolConfirmationRequest) => ToolConfirmationDecision | Promise<ToolConfirmationDecision>;
+interface VoiceToolContext {
+    readonly signal: AbortSignal;
+    readonly toolCallId: string;
+    readonly confirmation?: ToolConfirmationResolver;
+    readonly onUpdate?: (update: unknown) => void;
+}
+interface VoiceTool {
+    readonly name: string;
+    readonly description: string;
+    readonly parameters: JsonObject;
+    readonly confirmation?: ToolConfirmationPolicy;
+    readonly destructive?: boolean;
+    execute?(args: JsonObject, context: VoiceToolContext): VoiceToolExecutionResult | Promise<VoiceToolExecutionResult>;
+}
+interface VoiceToolCall {
+    readonly id: string;
+    readonly name: string;
+    readonly args: JsonObject;
+    readonly providerCallId?: string;
+    readonly raw?: unknown;
+}
+type VoiceToolExecutionResult = string | JsonObject | readonly JsonObject[];
+interface VoiceToolResult {
+    readonly toolCallId: string;
+    readonly name: string;
+    readonly content: VoiceToolExecutionResult;
+    readonly isError?: boolean;
+}
+interface VoiceToolExecutionError {
+    readonly type: "tool_not_found" | "tool_confirmation_denied" | "tool_execution_failed";
+    readonly message: string;
+    readonly cause?: unknown;
+}
+interface VoiceTransportConnectOptions {
+    readonly auth?: VoiceAuthConfig;
+    readonly session: VoiceSessionConfig;
+    readonly signal?: AbortSignal;
+}
+interface VoiceTransport {
+    readonly kind: "webrtc" | "websocket" | "custom";
+    connect(options: VoiceTransportConnectOptions): Promise<void>;
+    onEvent(handler: VoiceTransportEventHandler): () => void;
+    send(event: VoiceTransportSendEvent, signal?: AbortSignal): Promise<void>;
+    close(reason?: string): Promise<void>;
+}
+type VoiceTransportEventHandler = (event: VoiceTransportEvent) => void;
+type VoiceTransportSendEvent = {
+    readonly type: "audio";
+    readonly chunk: AudioInputChunk;
+} | {
+    readonly type: "text";
+    readonly text: string;
+} | {
+    readonly type: "tool_result";
+    readonly result: VoiceToolResult;
+} | {
+    readonly type: "config";
+    readonly config: Partial<VoiceSessionConfig>;
+};
+type VoiceTransportEvent = VoiceEvent | {
+    readonly type: "raw";
+    readonly data: unknown;
+};
+type VoiceBridgeCommand = {
+    readonly type: "prompt";
+    readonly text: string;
+    readonly sessionId?: string;
+    readonly project?: string;
+} | {
+    readonly type: "cancel";
+    readonly sessionId?: string;
+} | {
+    readonly type: "status";
+    readonly sessionId?: string;
+} | {
+    readonly type: "new_session";
+    readonly project?: string;
+} | {
+    readonly type: "switch_project";
+    readonly project: string;
+} | {
+    readonly type: "switch_model";
+    readonly provider: string;
+    readonly model: string;
+} | {
+    readonly type: "list_projects";
+};
+type VoiceBridgeEvent = {
+    readonly type: "text_delta";
+    readonly text: string;
+    readonly sessionId?: string;
+} | {
+    readonly type: "tool_start";
+    readonly name: string;
+    readonly id?: string;
+    readonly sessionId?: string;
+} | {
+    readonly type: "tool_end";
+    readonly name: string;
+    readonly id?: string;
+    readonly isError?: boolean;
+    readonly sessionId?: string;
+} | {
+    readonly type: "task_dispatch";
+    readonly workerId?: string;
+    readonly text: string;
+} | {
+    readonly type: "completion";
+    readonly sessionId?: string;
+} | {
+    readonly type: "status";
+    readonly status: JsonObject;
+    readonly sessionId?: string;
+} | {
+    readonly type: "error";
+    readonly error: string;
+    readonly sessionId?: string;
+};
+
+export type { AudioInputChunk as A, JsonObject as J, RealtimeFunctionToolDefinition as R, ToolConfirmationDecision as T, VoiceTransport as V, VoiceSessionMetadata as a, VoiceToolResult as b, VoiceSessionConfig as c, VoiceSession as d, VoiceTool as e, VoiceToolCall as f, VoiceToolContext as g, VoiceProvider as h, VoiceEvent as i, VoiceProviderConnectOptions as j, AudioOutputChunk as k, ToolConfirmationPolicy as l, ToolConfirmationRequest as m, ToolConfirmationResolver as n, VoiceAuthConfig as o, VoiceBridgeCommand as p, VoiceBridgeEvent as q, VoiceConnectionState as r, VoiceEventHandler as s, VoiceToolExecutionError as t, VoiceToolExecutionResult as u, VoiceTransportConnectOptions as v, VoiceTransportEvent as w, VoiceTransportEventHandler as x, VoiceTransportSendEvent as y };

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@prestyj/voice",
+  "version": "4.3.191",
+  "type": "module",
+  "description": "Provider-agnostic realtime voice orchestration for EZ tools and agents",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Gahroot/ezcoder.git",
+    "directory": "packages/voice"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./providers/openai-realtime": {
+      "types": "./dist/providers/openai-realtime.d.ts",
+      "import": "./dist/providers/openai-realtime.js",
+      "require": "./dist/providers/openai-realtime.cjs"
+    },
+    "./providers/openai-codex-realtime": {
+      "types": "./dist/providers/openai-codex-realtime.d.ts",
+      "import": "./dist/providers/openai-codex-realtime.js",
+      "require": "./dist/providers/openai-codex-realtime.cjs"
+    },
+    "./bridges/ezcoder-rpc": {
+      "types": "./dist/bridges/ezcoder-rpc.d.ts",
+      "import": "./dist/bridges/ezcoder-rpc.js",
+      "require": "./dist/bridges/ezcoder-rpc.cjs"
+    },
+    "./bridges/ezboss": {
+      "types": "./dist/bridges/ezboss.d.ts",
+      "import": "./dist/bridges/ezboss.js",
+      "require": "./dist/bridges/ezboss.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "zod": "^4.4.3",
+    "@prestyj/agent": "4.3.207",
+    "@prestyj/ai": "4.3.207"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}