codmir 0.3.2 → 0.4.0

package/dist/index.d.mts

@@ -88,6 +88,51 @@ interface CreateTestCaseInput {
 interface UpdateTestCaseInput extends Partial<CreateTestCaseInput> {
     status?: TestCaseStatus;
 }
+interface TestRunArtifact {
+    label?: string;
+    type?: string;
+    url: string;
+}
+interface TestRunSummaryInput {
+    projectId: string;
+    sprintId?: string;
+    suite: string;
+    framework?: string;
+    passCount: number;
+    failCount: number;
+    flakyCount?: number;
+    durationMs?: number;
+    commitSha?: string;
+    releaseTrainId?: string;
+    artifacts?: TestRunArtifact[];
+}
+interface TestRunRecord extends TestRunSummaryInput {
+    id: string;
+    createdAt: string;
+}
+interface CoverageFeatureBreakdown {
+    name: string;
+    coverage: number;
+    risk?: string;
+}
+interface CoverageInsightRequest {
+    projectId: string;
+    sprintId?: string;
+    linesPct: number;
+    branchesPct?: number;
+    statementsPct?: number;
+    functionsPct?: number;
+    features?: CoverageFeatureBreakdown[];
+}
+interface CoverageSuggestedTest {
+    title: string;
+    reason?: string;
+}
+interface CoverageInsight extends CoverageInsightRequest {
+    id: string;
+    createdAt: string;
+    suggestedTests?: CoverageSuggestedTest[] | null;
+}
 interface ApiResponse<T> {
     data?: T;
     error?: string;
@@ -132,6 +177,7 @@ declare class CodmirClient {
     private readonly config;
     readonly tickets: TicketsAPI;
     readonly testCases: TestCasesAPI;
+    readonly testing: TestingAPI;
     constructor(config: CodmirClientConfig);
     /**
      * Make an HTTP request to the codmir API
@@ -216,5 +262,34 @@ declare class TestCasesAPI {
      */
     delete(projectId: string, testCaseId: string | number): Promise<void>;
 }
+declare class TestingAPI {
+    private config;
+    constructor(config: Required<CodmirClientConfig>);
+    private request;
+    submitTestRun(payload: TestRunSummaryInput): Promise<{
+        run: TestRunRecord;
+        summary: {
+            framework: string;
+            passRate: number;
+            totalDurationMs: number;
+        };
+    }>;
+    listTestRuns(projectId: string, options?: {
+        limit?: number;
+        suite?: string;
+    }): Promise<TestRunRecord[]>;
+    requestCoverageInsight(payload: CoverageInsightRequest): Promise<{
+        report: CoverageInsight;
+        insights: {
+            coverageGauge: number;
+            featureBreakdown?: CoverageInsightRequest['features'];
+            suggestedTests: {
+                title: string;
+                reason?: string;
+            }[];
+        };
+    }>;
+    listCoverageInsights(projectId: string, limit?: number): Promise<CoverageInsight[]>;
+}
 
-export { type ApiResponse, CodmirClient, type CodmirClientConfig, CodmirError, type CreateTestCaseInput, type CreateTicketInput, type PaginatedResponse, type TestCase, type TestCasePriority, type TestCaseStatus, type TestCaseStep, type TestCaseTemplate, type Ticket, type TicketPriority, type TicketStatus, type TicketType, type UpdateTestCaseInput, type UpdateTicketInput, type User };
+export { type ApiResponse, CodmirClient, type CodmirClientConfig, CodmirError, type CoverageFeatureBreakdown, type CoverageInsight, type CoverageInsightRequest, type CoverageSuggestedTest, type CreateTestCaseInput, type CreateTicketInput, type PaginatedResponse, type TestCase, type TestCasePriority, type TestCaseStatus, type TestCaseStep, type TestCaseTemplate, type TestRunArtifact, type TestRunRecord, type TestRunSummaryInput, type Ticket, type TicketPriority, type TicketStatus, type TicketType, type UpdateTestCaseInput, type UpdateTicketInput, type User };

package/dist/index.d.ts

@@ -88,6 +88,51 @@ interface CreateTestCaseInput {
 interface UpdateTestCaseInput extends Partial<CreateTestCaseInput> {
     status?: TestCaseStatus;
 }
+interface TestRunArtifact {
+    label?: string;
+    type?: string;
+    url: string;
+}
+interface TestRunSummaryInput {
+    projectId: string;
+    sprintId?: string;
+    suite: string;
+    framework?: string;
+    passCount: number;
+    failCount: number;
+    flakyCount?: number;
+    durationMs?: number;
+    commitSha?: string;
+    releaseTrainId?: string;
+    artifacts?: TestRunArtifact[];
+}
+interface TestRunRecord extends TestRunSummaryInput {
+    id: string;
+    createdAt: string;
+}
+interface CoverageFeatureBreakdown {
+    name: string;
+    coverage: number;
+    risk?: string;
+}
+interface CoverageInsightRequest {
+    projectId: string;
+    sprintId?: string;
+    linesPct: number;
+    branchesPct?: number;
+    statementsPct?: number;
+    functionsPct?: number;
+    features?: CoverageFeatureBreakdown[];
+}
+interface CoverageSuggestedTest {
+    title: string;
+    reason?: string;
+}
+interface CoverageInsight extends CoverageInsightRequest {
+    id: string;
+    createdAt: string;
+    suggestedTests?: CoverageSuggestedTest[] | null;
+}
 interface ApiResponse<T> {
     data?: T;
     error?: string;
@@ -132,6 +177,7 @@ declare class CodmirClient {
     private readonly config;
     readonly tickets: TicketsAPI;
     readonly testCases: TestCasesAPI;
+    readonly testing: TestingAPI;
     constructor(config: CodmirClientConfig);
     /**
      * Make an HTTP request to the codmir API
@@ -216,5 +262,34 @@ declare class TestCasesAPI {
      */
     delete(projectId: string, testCaseId: string | number): Promise<void>;
 }
+declare class TestingAPI {
+    private config;
+    constructor(config: Required<CodmirClientConfig>);
+    private request;
+    submitTestRun(payload: TestRunSummaryInput): Promise<{
+        run: TestRunRecord;
+        summary: {
+            framework: string;
+            passRate: number;
+            totalDurationMs: number;
+        };
+    }>;
+    listTestRuns(projectId: string, options?: {
+        limit?: number;
+        suite?: string;
+    }): Promise<TestRunRecord[]>;
+    requestCoverageInsight(payload: CoverageInsightRequest): Promise<{
+        report: CoverageInsight;
+        insights: {
+            coverageGauge: number;
+            featureBreakdown?: CoverageInsightRequest['features'];
+            suggestedTests: {
+                title: string;
+                reason?: string;
+            }[];
+        };
+    }>;
+    listCoverageInsights(projectId: string, limit?: number): Promise<CoverageInsight[]>;
+}
 
-export { type ApiResponse, CodmirClient, type CodmirClientConfig, CodmirError, type CreateTestCaseInput, type CreateTicketInput, type PaginatedResponse, type TestCase, type TestCasePriority, type TestCaseStatus, type TestCaseStep, type TestCaseTemplate, type Ticket, type TicketPriority, type TicketStatus, type TicketType, type UpdateTestCaseInput, type UpdateTicketInput, type User };
+export { type ApiResponse, CodmirClient, type CodmirClientConfig, CodmirError, type CoverageFeatureBreakdown, type CoverageInsight, type CoverageInsightRequest, type CoverageSuggestedTest, type CreateTestCaseInput, type CreateTicketInput, type PaginatedResponse, type TestCase, type TestCasePriority, type TestCaseStatus, type TestCaseStep, type TestCaseTemplate, type TestRunArtifact, type TestRunRecord, type TestRunSummaryInput, type Ticket, type TicketPriority, type TicketStatus, type TicketType, type UpdateTestCaseInput, type UpdateTicketInput, type User };

package/dist/index.js

@@ -35,6 +35,7 @@ var CodmirClient = class {
     };
     this.tickets = new TicketsAPI(this.config);
     this.testCases = new TestCasesAPI(this.config);
+    this.testing = new TestingAPI(this.config);
   }
   /**
    * Make an HTTP request to the codmir API
@@ -293,6 +294,75 @@ var TestCasesAPI = class {
     );
   }
 };
+var TestingAPI = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.headers
+    };
+    if (this.config.apiKey) {
+      headers["X-API-Key"] = this.config.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        const error = new Error(errorData.error || `HTTP ${response.status}`);
+        error.statusCode = response.status;
+        error.response = errorData;
+        throw error;
+      }
+      if (response.status === 204) {
+        return {};
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        const timeoutError = new Error("Request timeout");
+        timeoutError.statusCode = 408;
+        throw timeoutError;
+      }
+      throw error;
+    }
+  }
+  async submitTestRun(payload) {
+    return this.request("POST", "/api/testing/test-runs", payload);
+  }
+  async listTestRuns(projectId, options) {
+    const params = new URLSearchParams({ projectId });
+    if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.suite) params.set("suite", options.suite);
+    const response = await this.request(
+      "GET",
+      `/api/testing/test-runs?${params.toString()}`
+    );
+    return response.runs || [];
+  }
+  async requestCoverageInsight(payload) {
+    return this.request("POST", "/api/testing/coverage-insight", payload);
+  }
+  async listCoverageInsights(projectId, limit = 5) {
+    const params = new URLSearchParams({ projectId, limit: String(limit) });
+    const response = await this.request(
+      "GET",
+      `/api/testing/coverage-insight?${params.toString()}`
+    );
+    return response.reports || [];
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CodmirClient

package/dist/index.mjs

@@ -1,6 +1,7 @@
 import {
   CodmirClient
-} from "./chunk-7HVQNURM.mjs";
+} from "./chunk-GU32P57R.mjs";
+import "./chunk-EBO3CZXG.mjs";
 export {
   CodmirClient
 };

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 };