codmir 0.3.3 → 0.4.1

package/dist/voice-agent/index.d.mts

@@ -0,0 +1,134 @@
+/**
+ * Voice assistant states.
+ */
+type AssistantState = "idle" | "listening" | "thinking" | "speaking" | "error";
+/**
+ * Command types that can be executed by the voice daemon.
+ */
+type CodmirCommand = {
+    type: "open_app";
+    name: string;
+} | {
+    type: "open_url";
+    url: string;
+} | {
+    type: "focus_window";
+    titleContains: string;
+} | {
+    type: "type_text";
+    text: string;
+} | {
+    type: "press_key";
+    key: string;
+} | {
+    type: "click";
+    button?: number;
+} | {
+    type: "scroll";
+    direction: "up" | "down";
+    amount?: number;
+} | {
+    type: "speak";
+    text: string;
+    voice?: string;
+};
+/**
+ * Events emitted by the voice agent.
+ */
+interface VoiceAgentEvents {
+    connected: () => void;
+    disconnected: () => void;
+    wake: (wakeword: string) => void;
+    stateChange: (state: AssistantState, previousState: AssistantState) => void;
+    transcript: (text: string, isFinal: boolean) => void;
+    response: (text: string, commands?: CodmirCommand[]) => void;
+    commandExecuted: (command: CodmirCommand, success: boolean, error?: string) => void;
+    error: (message: string, code?: string) => void;
+}
+/**
+ * Configuration options for the voice agent.
+ */
+interface VoiceAgentOptions {
+    /** WebSocket URL of the voice daemon. Default: ws://127.0.0.1:9410 */
+    url?: string;
+    /** Client ID for identification. */
+    clientId?: string;
+    /** Client type for identification. */
+    clientType?: "overlay" | "cli" | "ide" | "web" | "other";
+    /** Automatically reconnect on disconnect. Default: true */
+    autoReconnect?: boolean;
+    /** Reconnect delay in milliseconds. Default: 2000 */
+    reconnectDelay?: number;
+}
+
+/**
+ * Client SDK for connecting to the codmir voice daemon.
+ *
+ * @example
+ * ```typescript
+ * import { VoiceAgent } from '@codmir/voice-agent';
+ *
+ * const agent = new VoiceAgent({ clientId: 'my-app', clientType: 'web' });
+ *
+ * agent.on('wake', (wakeword) => {
+ *   console.log('Wake word detected:', wakeword);
+ * });
+ *
+ * agent.on('stateChange', (state, prev) => {
+ *   console.log('State changed:', prev, '->', state);
+ * });
+ *
+ * await agent.connect();
+ * ```
+ */
+declare class VoiceAgent {
+    private readonly options;
+    private ws;
+    private connected;
+    private reconnecting;
+    private listeners;
+    constructor(options?: VoiceAgentOptions);
+    /**
+     * Connect to the voice daemon.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the voice daemon.
+     */
+    disconnect(): void;
+    /**
+     * Check if connected to the daemon.
+     */
+    isConnected(): boolean;
+    /**
+     * Register an event listener.
+     */
+    on<K extends keyof VoiceAgentEvents>(event: K, callback: VoiceAgentEvents[K]): () => void;
+    /**
+     * Execute a command on the daemon.
+     */
+    executeCommand(command: CodmirCommand): Promise<void>;
+    /**
+     * Mute the voice assistant.
+     */
+    mute(): void;
+    /**
+     * Unmute the voice assistant.
+     */
+    unmute(): void;
+    /**
+     * Ping the daemon.
+     */
+    ping(): void;
+    /**
+     * Simulate a wake word detection (for testing).
+     */
+    simulateWake(wakeword?: string): void;
+    private sendIdentify;
+    private send;
+    private handleMessage;
+    private emit;
+    private scheduleReconnect;
+}
+
+export { type AssistantState, type CodmirCommand, VoiceAgent, type VoiceAgentEvents, type VoiceAgentOptions, VoiceAgent as default };

package/dist/voice-agent/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Voice assistant states.
+ */
+type AssistantState = "idle" | "listening" | "thinking" | "speaking" | "error";
+/**
+ * Command types that can be executed by the voice daemon.
+ */
+type CodmirCommand = {
+    type: "open_app";
+    name: string;
+} | {
+    type: "open_url";
+    url: string;
+} | {
+    type: "focus_window";
+    titleContains: string;
+} | {
+    type: "type_text";
+    text: string;
+} | {
+    type: "press_key";
+    key: string;
+} | {
+    type: "click";
+    button?: number;
+} | {
+    type: "scroll";
+    direction: "up" | "down";
+    amount?: number;
+} | {
+    type: "speak";
+    text: string;
+    voice?: string;
+};
+/**
+ * Events emitted by the voice agent.
+ */
+interface VoiceAgentEvents {
+    connected: () => void;
+    disconnected: () => void;
+    wake: (wakeword: string) => void;
+    stateChange: (state: AssistantState, previousState: AssistantState) => void;
+    transcript: (text: string, isFinal: boolean) => void;
+    response: (text: string, commands?: CodmirCommand[]) => void;
+    commandExecuted: (command: CodmirCommand, success: boolean, error?: string) => void;
+    error: (message: string, code?: string) => void;
+}
+/**
+ * Configuration options for the voice agent.
+ */
+interface VoiceAgentOptions {
+    /** WebSocket URL of the voice daemon. Default: ws://127.0.0.1:9410 */
+    url?: string;
+    /** Client ID for identification. */
+    clientId?: string;
+    /** Client type for identification. */
+    clientType?: "overlay" | "cli" | "ide" | "web" | "other";
+    /** Automatically reconnect on disconnect. Default: true */
+    autoReconnect?: boolean;
+    /** Reconnect delay in milliseconds. Default: 2000 */
+    reconnectDelay?: number;
+}
+
+/**
+ * Client SDK for connecting to the codmir voice daemon.
+ *
+ * @example
+ * ```typescript
+ * import { VoiceAgent } from '@codmir/voice-agent';
+ *
+ * const agent = new VoiceAgent({ clientId: 'my-app', clientType: 'web' });
+ *
+ * agent.on('wake', (wakeword) => {
+ *   console.log('Wake word detected:', wakeword);
+ * });
+ *
+ * agent.on('stateChange', (state, prev) => {
+ *   console.log('State changed:', prev, '->', state);
+ * });
+ *
+ * await agent.connect();
+ * ```
+ */
+declare class VoiceAgent {
+    private readonly options;
+    private ws;
+    private connected;
+    private reconnecting;
+    private listeners;
+    constructor(options?: VoiceAgentOptions);
+    /**
+     * Connect to the voice daemon.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the voice daemon.
+     */
+    disconnect(): void;
+    /**
+     * Check if connected to the daemon.
+     */
+    isConnected(): boolean;
+    /**
+     * Register an event listener.
+     */
+    on<K extends keyof VoiceAgentEvents>(event: K, callback: VoiceAgentEvents[K]): () => void;
+    /**
+     * Execute a command on the daemon.
+     */
+    executeCommand(command: CodmirCommand): Promise<void>;
+    /**
+     * Mute the voice assistant.
+     */
+    mute(): void;
+    /**
+     * Unmute the voice assistant.
+     */
+    unmute(): void;
+    /**
+     * Ping the daemon.
+     */
+    ping(): void;
+    /**
+     * Simulate a wake word detection (for testing).
+     */
+    simulateWake(wakeword?: string): void;
+    private sendIdentify;
+    private send;
+    private handleMessage;
+    private emit;
+    private scheduleReconnect;
+}
+
+export { type AssistantState, type CodmirCommand, VoiceAgent, type VoiceAgentEvents, type VoiceAgentOptions, VoiceAgent as default };

package/dist/voice-agent/index.js

@@ -0,0 +1,220 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/voice-agent/index.ts
+var voice_agent_exports = {};
+__export(voice_agent_exports, {
+  VoiceAgent: () => VoiceAgent,
+  default: () => voice_agent_default
+});
+module.exports = __toCommonJS(voice_agent_exports);
+var import_ws = __toESM(require("ws"));
+var DEFAULT_OPTIONS = {
+  url: "ws://127.0.0.1:9410",
+  clientId: "sdk-client",
+  clientType: "other",
+  autoReconnect: true,
+  reconnectDelay: 2e3
+};
+var VoiceAgent = class {
+  constructor(options = {}) {
+    this.ws = null;
+    this.connected = false;
+    this.reconnecting = false;
+    this.listeners = /* @__PURE__ */ new Map();
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+  }
+  /**
+   * Connect to the voice daemon.
+   */
+  async connect() {
+    if (this.connected) return;
+    return new Promise((resolve, reject) => {
+      try {
+        this.ws = new import_ws.default(this.options.url);
+        this.ws.on("open", () => {
+          this.connected = true;
+          this.reconnecting = false;
+          this.sendIdentify();
+          this.emit("connected");
+          resolve();
+        });
+        this.ws.on("message", (data) => {
+          this.handleMessage(data.toString("utf8"));
+        });
+        this.ws.on("close", () => {
+          this.connected = false;
+          this.emit("disconnected");
+          if (this.options.autoReconnect && !this.reconnecting) {
+            this.scheduleReconnect();
+          }
+        });
+        this.ws.on("error", (err) => {
+          if (!this.connected) {
+            reject(err);
+          } else {
+            this.emit("error", err.message);
+          }
+        });
+      } catch (err) {
+        reject(err);
+      }
+    });
+  }
+  /**
+   * Disconnect from the voice daemon.
+   */
+  disconnect() {
+    this.reconnecting = false;
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.connected = false;
+  }
+  /**
+   * Check if connected to the daemon.
+   */
+  isConnected() {
+    return this.connected;
+  }
+  /**
+   * Register an event listener.
+   */
+  on(event, callback) {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    const callbacks = this.listeners.get(event);
+    callbacks.add(callback);
+    return () => {
+      callbacks.delete(callback);
+    };
+  }
+  /**
+   * Execute a command on the daemon.
+   */
+  async executeCommand(command) {
+    this.send({ type: "execute_command", command });
+  }
+  /**
+   * Mute the voice assistant.
+   */
+  mute() {
+    this.send({ type: "mute" });
+  }
+  /**
+   * Unmute the voice assistant.
+   */
+  unmute() {
+    this.send({ type: "unmute" });
+  }
+  /**
+   * Ping the daemon.
+   */
+  ping() {
+    this.send({ type: "ping", timestamp: (/* @__PURE__ */ new Date()).toISOString() });
+  }
+  /**
+   * Simulate a wake word detection (for testing).
+   */
+  simulateWake(wakeword = "codmir") {
+    this.send({ type: "wake_detected", wakeword, timestamp: (/* @__PURE__ */ new Date()).toISOString() });
+  }
+  sendIdentify() {
+    this.send({
+      type: "identify",
+      clientId: this.options.clientId,
+      clientType: this.options.clientType,
+      version: "0.1.0"
+    });
+  }
+  send(message) {
+    if (this.ws && this.ws.readyState === import_ws.default.OPEN) {
+      this.ws.send(JSON.stringify(message));
+    }
+  }
+  handleMessage(raw) {
+    let msg;
+    try {
+      msg = JSON.parse(raw);
+    } catch {
+      return;
+    }
+    switch (msg.type) {
+      case "daemon_started":
+        break;
+      case "pong":
+        break;
+      case "state_change":
+        this.emit("stateChange", msg.state, msg.previousState);
+        break;
+      case "wake":
+        this.emit("wake", msg.wakeword);
+        break;
+      case "transcript":
+        this.emit("transcript", msg.text, msg.isFinal);
+        break;
+      case "response":
+        this.emit("response", msg.text, msg.commands);
+        break;
+      case "command_executed":
+        this.emit("commandExecuted", msg.command, msg.success, msg.error);
+        break;
+      case "error":
+        this.emit("error", msg.message, msg.code);
+        break;
+    }
+  }
+  emit(event, ...args) {
+    const callbacks = this.listeners.get(event);
+    if (!callbacks) return;
+    for (const cb of callbacks) {
+      try {
+        cb(...args);
+      } catch (err) {
+        console.error(`Error in ${event} listener:`, err);
+      }
+    }
+  }
+  scheduleReconnect() {
+    this.reconnecting = true;
+    setTimeout(() => {
+      if (this.reconnecting) {
+        this.connect().catch(() => {
+        });
+      }
+    }, this.options.reconnectDelay);
+  }
+};
+var voice_agent_default = VoiceAgent;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VoiceAgent
+});

package/dist/voice-agent/index.mjs

@@ -0,0 +1,187 @@
+import "../chunk-EBO3CZXG.mjs";
+
+// src/voice-agent/index.ts
+import WebSocket from "ws";
+var DEFAULT_OPTIONS = {
+  url: "ws://127.0.0.1:9410",
+  clientId: "sdk-client",
+  clientType: "other",
+  autoReconnect: true,
+  reconnectDelay: 2e3
+};
+var VoiceAgent = class {
+  constructor(options = {}) {
+    this.ws = null;
+    this.connected = false;
+    this.reconnecting = false;
+    this.listeners = /* @__PURE__ */ new Map();
+    this.options = { ...DEFAULT_OPTIONS, ...options };
+  }
+  /**
+   * Connect to the voice daemon.
+   */
+  async connect() {
+    if (this.connected) return;
+    return new Promise((resolve, reject) => {
+      try {
+        this.ws = new WebSocket(this.options.url);
+        this.ws.on("open", () => {
+          this.connected = true;
+          this.reconnecting = false;
+          this.sendIdentify();
+          this.emit("connected");
+          resolve();
+        });
+        this.ws.on("message", (data) => {
+          this.handleMessage(data.toString("utf8"));
+        });
+        this.ws.on("close", () => {
+          this.connected = false;
+          this.emit("disconnected");
+          if (this.options.autoReconnect && !this.reconnecting) {
+            this.scheduleReconnect();
+          }
+        });
+        this.ws.on("error", (err) => {
+          if (!this.connected) {
+            reject(err);
+          } else {
+            this.emit("error", err.message);
+          }
+        });
+      } catch (err) {
+        reject(err);
+      }
+    });
+  }
+  /**
+   * Disconnect from the voice daemon.
+   */
+  disconnect() {
+    this.reconnecting = false;
+    if (this.ws) {
+      this.ws.close();
+      this.ws = null;
+    }
+    this.connected = false;
+  }
+  /**
+   * Check if connected to the daemon.
+   */
+  isConnected() {
+    return this.connected;
+  }
+  /**
+   * Register an event listener.
+   */
+  on(event, callback) {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    const callbacks = this.listeners.get(event);
+    callbacks.add(callback);
+    return () => {
+      callbacks.delete(callback);
+    };
+  }
+  /**
+   * Execute a command on the daemon.
+   */
+  async executeCommand(command) {
+    this.send({ type: "execute_command", command });
+  }
+  /**
+   * Mute the voice assistant.
+   */
+  mute() {
+    this.send({ type: "mute" });
+  }
+  /**
+   * Unmute the voice assistant.
+   */
+  unmute() {
+    this.send({ type: "unmute" });
+  }
+  /**
+   * Ping the daemon.
+   */
+  ping() {
+    this.send({ type: "ping", timestamp: (/* @__PURE__ */ new Date()).toISOString() });
+  }
+  /**
+   * Simulate a wake word detection (for testing).
+   */
+  simulateWake(wakeword = "codmir") {
+    this.send({ type: "wake_detected", wakeword, timestamp: (/* @__PURE__ */ new Date()).toISOString() });
+  }
+  sendIdentify() {
+    this.send({
+      type: "identify",
+      clientId: this.options.clientId,
+      clientType: this.options.clientType,
+      version: "0.1.0"
+    });
+  }
+  send(message) {
+    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+      this.ws.send(JSON.stringify(message));
+    }
+  }
+  handleMessage(raw) {
+    let msg;
+    try {
+      msg = JSON.parse(raw);
+    } catch {
+      return;
+    }
+    switch (msg.type) {
+      case "daemon_started":
+        break;
+      case "pong":
+        break;
+      case "state_change":
+        this.emit("stateChange", msg.state, msg.previousState);
+        break;
+      case "wake":
+        this.emit("wake", msg.wakeword);
+        break;
+      case "transcript":
+        this.emit("transcript", msg.text, msg.isFinal);
+        break;
+      case "response":
+        this.emit("response", msg.text, msg.commands);
+        break;
+      case "command_executed":
+        this.emit("commandExecuted", msg.command, msg.success, msg.error);
+        break;
+      case "error":
+        this.emit("error", msg.message, msg.code);
+        break;
+    }
+  }
+  emit(event, ...args) {
+    const callbacks = this.listeners.get(event);
+    if (!callbacks) return;
+    for (const cb of callbacks) {
+      try {
+        cb(...args);
+      } catch (err) {
+        console.error(`Error in ${event} listener:`, err);
+      }
+    }
+  }
+  scheduleReconnect() {
+    this.reconnecting = true;
+    setTimeout(() => {
+      if (this.reconnecting) {
+        this.connect().catch(() => {
+        });
+      }
+    }, this.options.reconnectDelay);
+  }
+};
+var voice_agent_default = VoiceAgent;
+export {
+  VoiceAgent,
+  voice_agent_default as default
+};