@alfe.ai/openclaw-voice 0.1.14 → 0.2.0

package/README.md

@@ -1,54 +1,37 @@
-# packages/openclaw-voice (`@alfe.ai/openclaw-voice`)
+# `@alfe.ai/openclaw-voice`
 
-OpenClaw voice plugin for Alfe — Discord audio, Twilio phone calls, and meeting bots.
+OpenClaw tools for Alfe's agent-authenticated one-shot voice endpoints.
 
-## What It Does
+The plugin registers two tools:
 
-OpenClaw plugin that integrates voice capabilities into the agent runtime. All heavy voice logic lives in `voice-service` — this package is the OpenClaw integration layer.
+- `voice_tts` converts 1–5000 characters to a new workspace-relative WAV or
+  raw PCM file.
+- `voice_stt` transcribes a workspace-relative WAV or raw mono 16-bit PCM file
+  of at most 10 MiB.
 
-On activation, the plugin:
+Both tools resolve the agent API key and voice-service URL from
+`@alfe.ai/config`, call through `AgentApiClient`, and leave billing to the
+server. The plugin has no provider credential fields, gateway RPC, daemon
+connection, or channel-specific call controls.
 
-- **Registers voice tools** — `voice_hangup`, `voice_transfer` (Twilio), `voice_dtmf` (Twilio)
-- **Registers HTTP routes** — `/twilio/inbound` and `/twilio/status` webhook handlers
-- **Registers gateway RPC** — `voice.speak` for TTS and direct audio output
-- **Hooks into OpenClaw events** — auto-joins/leaves Discord voice on session start/end, auto-injects session IDs into tool calls
-- **Connects to Alfe daemon IPC** — registers voice capabilities; gracefully degrades if unavailable
+File arguments are treated as model-controlled input: real paths must stay
+inside the current workspace, input files must be regular files within the
+size cap, and TTS creates output exclusively without replacing existing files.
 
-Follows the standard OpenClaw plugin pattern: exports `id`, `name`, `activate`, `deactivate`.
-
-## Key Files
-
-```
-src/
-├── plugin.ts           # Plugin entry point (activate/deactivate lifecycle, tools, routes, hooks)
-└── index.ts            # Public re-exports
-```
-
-## Session Management
-
-The plugin maintains bidirectional maps between OpenClaw session keys and voice session IDs. On `before_tool_call`, it auto-injects `sessionId` into voice tool parameters so the agent doesn't need to track sessions explicitly.
-
-Discord sessions are detected via the pattern `voice-discord:{guildId}:{channelId}`.
+Channel voice sessions, calls, barge-in, and streaming audio live in the voice
+service and channel adapters; they are not part of this tool-only package.
 
 ## Development
 
-```bash
-pnpm install
-pnpm --filter @alfe.ai/openclaw-voice build
-```
-
-## Testing
-
 ```bash
 pnpm --filter @alfe.ai/openclaw-voice test
+pnpm --filter @alfe.ai/openclaw-voice lint
+pnpm --filter @alfe.ai/openclaw-voice build
 ```
 
-## Dependencies
-
-- **voice-service** — core voice logic (TTS, audio pipeline, Discord/Twilio adapters)
-- **@alfe.ai/openclaw** — OpenClaw runtime plugin API
+See [`DEVELOPING.md`](DEVELOPING.md) for the file-I/O and runtime contracts.
 
 ## Links
 
-- 🌐 Website: <https://alfe.ai>
-- 📚 Docs: <https://docs.alfe.ai>
+- [Alfe](https://alfe.ai)
+- [Documentation](https://docs.alfe.ai)

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import plugin from "./plugin.cjs";
+import { t as plugin } from "./plugin.cjs";
 export { plugin as default };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import plugin from "./plugin.js";
+import { t as plugin } from "./plugin.js";
 export { plugin as default };

package/dist/plugin.d.cts

@@ -1,5 +1,26 @@
-import { TSchema } from "@sinclair/typebox";
+//#region ../openclaw-plugin-kit/dist/index.d.ts
 
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/tools.d.ts
+/** Shape returned to OpenClaw from a tool `execute`. */
+interface ToolResult {
+  content: {
+    type: "text";
+    text: string;
+  }[];
+  details: unknown;
+  isError?: boolean;
+}
+interface ToolDef<TParameters = unknown> {
+  name: string;
+  description: string;
+  label: string;
+  parameters: TParameters;
+  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */
+//#endregion
 //#region src/plugin.d.ts
 
 interface Logger {
@@ -8,56 +29,9 @@ interface Logger {
   error(msg: string, ...args: unknown[]): void;
   debug(msg: string, ...args: unknown[]): void;
 }
-interface VoicePluginConfig {
-  voiceServiceUrl?: string;
-  voiceServicePort?: string | number;
-  voiceServiceApiKey?: string;
-  daemonSocket?: string;
-  [key: string]: unknown;
-}
-interface OpenClawConfig {
-  plugins?: {
-    entries?: Record<string, {
-      config?: VoicePluginConfig;
-      [key: string]: unknown;
-    }>;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-interface PluginServiceContext {
-  config: Record<string, unknown>;
-  workspaceDir?: string;
-  stateDir: string;
-  logger: Logger;
-}
 interface OpenClawPluginApi {
   logger: Logger;
-  registrationMode?: 'full' | 'setup-only' | 'setup-runtime' | 'cli-metadata';
-  config?: OpenClawConfig;
   registerTool(tool: ToolDef): void;
-  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
-  registerService(service: {
-    id: string;
-    start: (ctx: PluginServiceContext) => void | Promise<void>;
-    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
-  }): void;
-  on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
-    priority?: number;
-  }): void;
-}
-interface ToolDef {
-  name: string;
-  description: string;
-  label: string;
-  parameters: TSchema;
-  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
-    content: {
-      type: 'text';
-      text: string;
-    }[];
-    details: unknown;
-  }>;
 }
 declare const plugin: {
   id: string;
@@ -68,4 +42,4 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { plugin as default };
+export { plugin as t };

package/dist/plugin.d.ts

@@ -1,5 +1,26 @@
-import { TSchema } from "@sinclair/typebox";
+//#region ../openclaw-plugin-kit/dist/index.d.ts
 
+//# sourceMappingURL=types.d.ts.map
+//#endregion
+//#region src/tools.d.ts
+/** Shape returned to OpenClaw from a tool `execute`. */
+interface ToolResult {
+  content: {
+    type: "text";
+    text: string;
+  }[];
+  details: unknown;
+  isError?: boolean;
+}
+interface ToolDef<TParameters = unknown> {
+  name: string;
+  description: string;
+  label: string;
+  parameters: TParameters;
+  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<ToolResult>;
+}
+/** Deliberately model-safe validation/usage failure. Other exceptions stay private. */
+//#endregion
 //#region src/plugin.d.ts
 
 interface Logger {
@@ -8,56 +29,9 @@ interface Logger {
   error(msg: string, ...args: unknown[]): void;
   debug(msg: string, ...args: unknown[]): void;
 }
-interface VoicePluginConfig {
-  voiceServiceUrl?: string;
-  voiceServicePort?: string | number;
-  voiceServiceApiKey?: string;
-  daemonSocket?: string;
-  [key: string]: unknown;
-}
-interface OpenClawConfig {
-  plugins?: {
-    entries?: Record<string, {
-      config?: VoicePluginConfig;
-      [key: string]: unknown;
-    }>;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-interface PluginServiceContext {
-  config: Record<string, unknown>;
-  workspaceDir?: string;
-  stateDir: string;
-  logger: Logger;
-}
 interface OpenClawPluginApi {
   logger: Logger;
-  registrationMode?: 'full' | 'setup-only' | 'setup-runtime' | 'cli-metadata';
-  config?: OpenClawConfig;
   registerTool(tool: ToolDef): void;
-  registerGatewayMethod(name: string, handler: (...args: unknown[]) => Promise<unknown>): void;
-  registerService(service: {
-    id: string;
-    start: (ctx: PluginServiceContext) => void | Promise<void>;
-    stop?: (ctx: PluginServiceContext) => void | Promise<void>;
-  }): void;
-  on(event: string, handler: (...args: unknown[]) => void | Promise<void>, options?: {
-    priority?: number;
-  }): void;
-}
-interface ToolDef {
-  name: string;
-  description: string;
-  label: string;
-  parameters: TSchema;
-  execute: (toolCallId: string, params: Record<string, unknown>) => Promise<{
-    content: {
-      type: 'text';
-      text: string;
-    }[];
-    details: unknown;
-  }>;
 }
 declare const plugin: {
   id: string;
@@ -68,4 +42,4 @@ declare const plugin: {
   deactivate(api: OpenClawPluginApi): void;
 };
 //#endregion
-export { plugin as default };
+export { plugin as t };