byterover-cli 1.7.0 → 1.7.2

package/node_modules/@campfirein/brv-transport-client/dist/infra/schemas/types.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Transport Event Types
+ *
+ * TypeScript types inferred from Zod schemas.
+ * Single source of truth: schemas.ts → types.ts
+ *
+ * Usage:
+ * ```typescript
+ * import type { TaskCreateRequest, LlmChunk, SessionInfo } from '@campfirein/brv-transport-client'
+ *
+ * const request: TaskCreateRequest = {
+ *   taskId: '...',
+ *   type: 'query',
+ *   content: 'What is the weather?',
+ * }
+ * ```
+ */
+import { z } from 'zod';
+import { AgentTerminationReasonSchema, ChunkTypeSchema, LogLevelSchema, TaskTypeSchema, TodoStatusSchema, ToolErrorTypeSchema, UIEventTypeSchema, TaskErrorDataSchema, TodoItemSchema, TokenUsageSchema, TaskAckSchema, TaskCancelledSchema, TaskCancelRequestSchema, TaskCancelResponseSchema, TaskCompletedSchema, TaskCreatedSchema, TaskCreateRequestSchema, TaskErrorSchema, TaskExecuteSchema, TaskStartedSchema, LlmChunkSchema, LlmErrorSchema, LlmOutputTruncatedSchema, LlmResponseSchema, LlmThinkingSchema, LlmThoughtSchema, LlmTodoUpdatedSchema, LlmToolCallSchema, LlmToolResultSchema, LlmUnsupportedInputSchema, LlmWarningSchema, CipherConversationResetSchema, CipherExecutionStartedSchema, CipherExecutionTerminatedSchema, CipherLogSchema, CipherStateChangedSchema, CipherStateResetSchema, CipherUISchema, SessionCreateRequestSchema, SessionCreateResponseSchema, SessionInfoRequestSchema, SessionInfoResponseSchema, SessionInfoSchema, SessionListRequestSchema, SessionListResponseSchema, SessionStatsSchema, SessionSwitchedBroadcastSchema, SessionSwitchRequestSchema, SessionSwitchResponseSchema, AgentNewSessionRequestSchema, AgentNewSessionResponseSchema, AgentRestartRequestSchema, AgentRestartResponseSchema, AgentStatusSchema } from './schemas.js';
+/** Token usage statistics from LLM */
+export type TokenUsage = z.infer<typeof TokenUsageSchema>;
+/** Log levels for agent logging */
+export type LogLevel = z.infer<typeof LogLevelSchema>;
+/** UI event types for terminal output */
+export type UIEventType = z.infer<typeof UIEventTypeSchema>;
+/** Chunk content types for streaming */
+export type ChunkType = z.infer<typeof ChunkTypeSchema>;
+/** Task types supported by the system */
+export type TaskType = z.infer<typeof TaskTypeSchema>;
+/** Todo item status */
+export type TodoStatus = z.infer<typeof TodoStatusSchema>;
+/** Tool execution error types */
+export type ToolErrorType = z.infer<typeof ToolErrorTypeSchema>;
+/** Reasons for agent execution termination */
+export type AgentTerminationReason = z.infer<typeof AgentTerminationReasonSchema>;
+/** Todo item structure */
+export type TodoItem = z.infer<typeof TodoItemSchema>;
+/** Structured error data */
+export type TaskErrorData = z.infer<typeof TaskErrorDataSchema>;
+/** task:create - Request to create a new task */
+export type TaskCreateRequest = z.infer<typeof TaskCreateRequestSchema>;
+/** task:ack - Server acknowledges task creation */
+export type TaskAck = z.infer<typeof TaskAckSchema>;
+/** task:created - Broadcast when new task is created */
+export type TaskCreated = z.infer<typeof TaskCreatedSchema>;
+/** task:execute - Internal: Transport → Agent */
+export type TaskExecute = z.infer<typeof TaskExecuteSchema>;
+/** task:started - Agent began processing */
+export type TaskStarted = z.infer<typeof TaskStartedSchema>;
+/** task:completed - Task finished successfully */
+export type TaskCompleted = z.infer<typeof TaskCompletedSchema>;
+/** task:error - Task failed with error */
+export type TaskError = z.infer<typeof TaskErrorSchema>;
+/** task:cancel - Request to cancel a task */
+export type TaskCancelRequest = z.infer<typeof TaskCancelRequestSchema>;
+/** task:cancel response */
+export type TaskCancelResponse = z.infer<typeof TaskCancelResponseSchema>;
+/** task:cancelled - Task was cancelled */
+export type TaskCancelled = z.infer<typeof TaskCancelledSchema>;
+/** llmservice:thinking - Agent started thinking */
+export type LlmThinking = z.infer<typeof LlmThinkingSchema>;
+/** llmservice:chunk - Streaming content chunk */
+export type LlmChunk = z.infer<typeof LlmChunkSchema>;
+/** llmservice:response - Complete LLM response */
+export type LlmResponse = z.infer<typeof LlmResponseSchema>;
+/** llmservice:toolCall - Agent invokes a tool */
+export type LlmToolCall = z.infer<typeof LlmToolCallSchema>;
+/** llmservice:toolResult - Tool execution result */
+export type LlmToolResult = z.infer<typeof LlmToolResultSchema>;
+/** llmservice:error - LLM service error */
+export type LlmError = z.infer<typeof LlmErrorSchema>;
+/** llmservice:unsupportedInput - Input not supported */
+export type LlmUnsupportedInput = z.infer<typeof LlmUnsupportedInputSchema>;
+/** llmservice:warning - Non-fatal warning */
+export type LlmWarning = z.infer<typeof LlmWarningSchema>;
+/** llmservice:outputTruncated - Output was truncated */
+export type LlmOutputTruncated = z.infer<typeof LlmOutputTruncatedSchema>;
+/** llmservice:thought - Agent reasoning thought */
+export type LlmThought = z.infer<typeof LlmThoughtSchema>;
+/** llmservice:todoUpdated - Todo list was updated */
+export type LlmTodoUpdated = z.infer<typeof LlmTodoUpdatedSchema>;
+/** cipher:executionStarted - Agent execution started */
+export type CipherExecutionStarted = z.infer<typeof CipherExecutionStartedSchema>;
+/** cipher:executionTerminated - Agent execution ended */
+export type CipherExecutionTerminated = z.infer<typeof CipherExecutionTerminatedSchema>;
+/** cipher:conversationReset - Conversation was reset */
+export type CipherConversationReset = z.infer<typeof CipherConversationResetSchema>;
+/** cipher:stateChanged - Agent state changed */
+export type CipherStateChanged = z.infer<typeof CipherStateChangedSchema>;
+/** cipher:stateReset - Agent state was reset */
+export type CipherStateReset = z.infer<typeof CipherStateResetSchema>;
+/** cipher:log - Agent log message */
+export type CipherLog = z.infer<typeof CipherLogSchema>;
+/** cipher:ui - UI event */
+export type CipherUI = z.infer<typeof CipherUISchema>;
+/** Session information structure */
+export type SessionInfo = z.infer<typeof SessionInfoSchema>;
+/** Session statistics */
+export type SessionStats = z.infer<typeof SessionStatsSchema>;
+/** session:info request */
+export type SessionInfoRequest = z.infer<typeof SessionInfoRequestSchema>;
+/** session:info response */
+export type SessionInfoResponse = z.infer<typeof SessionInfoResponseSchema>;
+/** session:list request */
+export type SessionListRequest = z.infer<typeof SessionListRequestSchema>;
+/** session:list response */
+export type SessionListResponse = z.infer<typeof SessionListResponseSchema>;
+/** session:create request */
+export type SessionCreateRequest = z.infer<typeof SessionCreateRequestSchema>;
+/** session:create response */
+export type SessionCreateResponse = z.infer<typeof SessionCreateResponseSchema>;
+/** session:switch request */
+export type SessionSwitchRequest = z.infer<typeof SessionSwitchRequestSchema>;
+/** session:switch response */
+export type SessionSwitchResponse = z.infer<typeof SessionSwitchResponseSchema>;
+/** session:switched broadcast */
+export type SessionSwitchedBroadcast = z.infer<typeof SessionSwitchedBroadcastSchema>;
+/** agent:restart request */
+export type AgentRestartRequest = z.infer<typeof AgentRestartRequestSchema>;
+/** agent:restart response */
+export type AgentRestartResponse = z.infer<typeof AgentRestartResponseSchema>;
+/** agent:newSession request */
+export type AgentNewSessionRequest = z.infer<typeof AgentNewSessionRequestSchema>;
+/** agent:newSession response */
+export type AgentNewSessionResponse = z.infer<typeof AgentNewSessionResponseSchema>;
+/** agent:status payload (health check) */
+export type AgentStatus = z.infer<typeof AgentStatusSchema>;
+/**
+ * Map of task event names to their payload types.
+ * Use with typed event handlers.
+ */
+export type TaskEventPayloadMap = {
+    'task:ack': TaskAck;
+    'task:cancelled': TaskCancelled;
+    'task:completed': TaskCompleted;
+    'task:create': TaskCreateRequest;
+    'task:created': TaskCreated;
+    'task:error': TaskError;
+    'task:execute': TaskExecute;
+    'task:started': TaskStarted;
+};
+/**
+ * Map of LLM event names to their payload types.
+ */
+export type LlmEventPayloadMap = {
+    'llmservice:chunk': LlmChunk;
+    'llmservice:error': LlmError;
+    'llmservice:outputTruncated': LlmOutputTruncated;
+    'llmservice:response': LlmResponse;
+    'llmservice:thinking': LlmThinking;
+    'llmservice:thought': LlmThought;
+    'llmservice:todoUpdated': LlmTodoUpdated;
+    'llmservice:toolCall': LlmToolCall;
+    'llmservice:toolResult': LlmToolResult;
+    'llmservice:unsupportedInput': LlmUnsupportedInput;
+    'llmservice:warning': LlmWarning;
+};
+/**
+ * Map of cipher event names to their payload types.
+ */
+export type CipherEventPayloadMap = {
+    'cipher:conversationReset': CipherConversationReset;
+    'cipher:executionStarted': CipherExecutionStarted;
+    'cipher:executionTerminated': CipherExecutionTerminated;
+    'cipher:log': CipherLog;
+    'cipher:stateChanged': CipherStateChanged;
+    'cipher:stateReset': CipherStateReset;
+    'cipher:ui': CipherUI;
+};
+/**
+ * Map of session event names to their payload types.
+ */
+export type SessionEventPayloadMap = {
+    'session:create': SessionCreateRequest;
+    'session:info': SessionInfoRequest;
+    'session:list': SessionListRequest;
+    'session:switch': SessionSwitchRequest;
+    'session:switched': SessionSwitchedBroadcast;
+};
+/**
+ * Map of all transport event names to their payload types.
+ */
+export type TransportEventPayloadMap = TaskEventPayloadMap & LlmEventPayloadMap & CipherEventPayloadMap & SessionEventPayloadMap;
+/**
+ * Map of request/response pairs for client.request() calls.
+ */
+export type RequestResponseMap = {
+    'agent:newSession': {
+        request: AgentNewSessionRequest;
+        response: AgentNewSessionResponse;
+    };
+    'agent:restart': {
+        request: AgentRestartRequest;
+        response: AgentRestartResponse;
+    };
+    'session:create': {
+        request: SessionCreateRequest;
+        response: SessionCreateResponse;
+    };
+    'session:info': {
+        request: SessionInfoRequest;
+        response: SessionInfoResponse;
+    };
+    'session:list': {
+        request: SessionListRequest;
+        response: SessionListResponse;
+    };
+    'session:switch': {
+        request: SessionSwitchRequest;
+        response: SessionSwitchResponse;
+    };
+    'task:cancel': {
+        request: TaskCancelRequest;
+        response: TaskCancelResponse;
+    };
+    'task:create': {
+        request: TaskCreateRequest;
+        response: TaskAck;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/schemas/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../infra/schemas/types.ts"],"names":[],"mappings":"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"}

package/node_modules/@campfirein/brv-transport-client/dist/infra/schemas/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/schemas/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../infra/schemas/types.ts"],"names":[],"mappings":""}

package/node_modules/@campfirein/brv-transport-client/dist/infra/socket-io-client.d.ts

@@ -0,0 +1,283 @@
+import type { ManagerOptions, SocketOptions } from 'socket.io-client';
+import type { ClientConfig, SocketTransport } from '../core/domain/types.js';
+import type { IClientLogger } from '../core/interfaces/i-client-logger.js';
+import type { ConnectionState, ConnectionStateHandler } from '../core/interfaces/i-connection-state.js';
+import type { EventHandler } from '../core/interfaces/i-event-dispatcher.js';
+import type { ITransportClient, RequestOptions } from '../core/interfaces/i-client.js';
+import type { IReconnectionStrategy } from '../core/interfaces/i-reconnection-strategy.js';
+import type { IWakeDetector } from '../core/interfaces/i-wake-detector.js';
+import { ConnectionStateManager } from './connection-state-manager.js';
+import { EventDispatcher, type HandlerErrorCallback } from './event-dispatcher.js';
+import { RoomManager } from './room-manager.js';
+/**
+ * Immutable configuration for TransportClient.
+ */
+export type TransportClientConfig = {
+    readonly connectTimeoutMs?: number;
+    readonly reconnectionAttempts?: number;
+    readonly reconnectionDelayMs?: number;
+    readonly reconnectionDelayMaxMs?: number;
+    readonly requestTimeoutMs?: number;
+    readonly roomTimeoutMs?: number;
+    readonly transports?: readonly SocketTransport[];
+    /**
+     * Advanced Socket.IO client options for custom configurations.
+     * These options are merged with defaults and can override them.
+     *
+     * @remarks
+     * Common use cases:
+     * - `path`: Custom Socket.IO server path (default: '/socket.io')
+     * - `auth`: Authentication tokens or credentials
+     * - `query`: Query parameters for connection
+     * - `extraHeaders`: Custom HTTP headers
+     * - `withCredentials`: Enable CORS credentials
+     *
+     * @example
+     * ```typescript
+     * const client = new TransportClient({
+     *   socketOptions: {
+     *     path: '/custom-socket-path',
+     *     auth: { token: 'secret' },
+     *     extraHeaders: { 'X-Custom': 'value' }
+     *   }
+     * })
+     * ```
+     */
+    readonly socketOptions?: Partial<ManagerOptions & SocketOptions>;
+};
+/**
+ * Dependencies that can be injected into TransportClient.
+ * Follows Dependency Inversion Principle (DIP) and Interface Segregation Principle (ISP).
+ *
+ * @remarks
+ * All dependencies use interfaces for proper inversion of control.
+ * Internal components for testing are available via separate testing module.
+ */
+export type TransportClientDependencies = {
+    /** Logger for debug output (DIP - injectable) */
+    readonly logger?: IClientLogger;
+    /** Reconnection strategy (DIP - injectable) */
+    readonly reconnectionStrategy?: IReconnectionStrategy;
+    /** Wake detector for sleep recovery (DIP - injectable) */
+    readonly wakeDetector?: IWakeDetector;
+    /**
+     * Callback for event handler errors.
+     * Provides observability when event handlers throw exceptions.
+     * Useful for error tracking services.
+     *
+     * @remarks
+     * **IMPORTANT:** This callback must not throw errors or block the event loop.
+     * - Throwing errors: Will be caught and logged, but degrades observability
+     * - Blocking operations: Will delay event processing and can cause performance issues
+     * - Use async operations (promises) without awaiting if needed
+     *
+     * @example
+     * ```typescript
+     * // Good: Non-blocking error reporting
+     * onHandlerError: (event, error, data) => {
+     *   void errorTracker.report(error) // Fire-and-forget
+     * }
+     *
+     * // Bad: Blocking or throwing
+     * onHandlerError: (event, error, data) => {
+     *   throw new Error('Bad!') // Don't do this
+     *   while(true) {} // Never do this
+     * }
+     * ```
+     */
+    readonly onHandlerError?: HandlerErrorCallback;
+    /**
+     * Callback invoked when handlers are cleared during disconnect.
+     * Provides observability when pending once() handlers and persistent handlers are dropped.
+     *
+     * @param pendingCount - Number of pending once handlers that were cleared
+     * @param persistentCount - Number of persistent event types that were cleared
+     *
+     * @remarks
+     * **IMPORTANT:** This callback must not throw errors or block the event loop.
+     * Throwing errors will be caught and logged but may hide important cleanup issues.
+     */
+    readonly onHandlersCleared?: (pendingCount: number, persistentCount: number) => void;
+    /**
+     * Callback invoked when force reconnect fails.
+     * Provides observability for persistent connection failures.
+     *
+     * @param error - The error that caused the reconnect failure
+     * @param attemptNumber - The attempt number (1-based)
+     *
+     * @remarks
+     * **IMPORTANT:** This callback must not throw errors or block the event loop.
+     * Throwing errors will be caught and logged but may interfere with reconnection logic.
+     */
+    readonly onReconnectError?: (error: Error, attemptNumber: number) => void;
+};
+/**
+ * Full options combining config and dependencies for public API.
+ */
+export type TransportClientOptions = TransportClientConfig & TransportClientDependencies;
+/**
+ * Internal dependencies for testing purposes only.
+ * Allows injection of mock components for unit testing.
+ *
+ * @internal
+ *
+ * @remarks
+ * **DO NOT USE IN PRODUCTION CODE**
+ *
+ * This type exists solely for testing purposes and allows tests to inject
+ * mock implementations of internal components. Using this in production
+ * code violates the encapsulation guarantees of TransportClient.
+ */
+export type InternalTestDependencies = {
+    /** Connection state manager (internal, for testing only) */
+    readonly stateManager?: ConnectionStateManager;
+    /** Event dispatcher (internal, for testing only) */
+    readonly eventDispatcher?: EventDispatcher;
+    /** Room manager (internal, for testing only) */
+    readonly roomManager?: RoomManager;
+};
+/**
+ * Internal options type that includes test dependencies.
+ * Used only within constructor - not exported.
+ * @internal
+ */
+type InternalTransportClientOptions = TransportClientOptions & InternalTestDependencies;
+/**
+ * Socket.IO implementation of ITransportClient.
+ * Uses composition and dependency injection for testability and flexibility.
+ *
+ * Architecture:
+ * - ConnectionStateManager: Manages connection state and notifications
+ * - EventDispatcher: Handles event subscriptions and dispatching
+ * - RoomManager: Manages room join/leave/rejoin
+ * - IReconnectionStrategy: Configurable reconnection behavior
+ * - IWakeDetector: Detects system wake from sleep
+ *
+ * @remarks
+ * This class acts as a facade/coordinator for the specialized components.
+ * Each component follows Single Responsibility Principle.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const client = new TransportClient()
+ * await client.connect('http://localhost:3000')
+ *
+ * // With custom dependencies (DIP)
+ * const client = new TransportClient({
+ *   logger: myLogger,
+ *   reconnectionStrategy: new CustomReconnectionStrategy(),
+ * })
+ * ```
+ */
+export declare class TransportClient implements ITransportClient {
+    #private;
+    /**
+     * Internal getter for socket access within this class.
+     * Provides convenient syntax for internal use.
+     */
+    private get socket();
+    constructor(options?: InternalTransportClientOptions);
+    /**
+     * Checks if connect() operation is allowed in current state.
+     * @returns True if can connect (state is 'disconnected')
+     */
+    private canConnect;
+    /**
+     * Checks if disconnect() operation is allowed in current state.
+     * @returns True if can disconnect (state is not 'disconnected')
+     */
+    private canDisconnect;
+    connect(url: string): Promise<void>;
+    /**
+     * Validates that a timeout value is a positive number.
+     * @throws InvalidTimeoutError if timeout is invalid
+     */
+    private validateTimeout;
+    /**
+     * Disconnects from the server.
+     *
+     * @remarks
+     * WARNING: This clears ALL event handlers including pending once() handlers.
+     * Use onHandlersCleared callback to be notified when handlers are dropped.
+     */
+    disconnect(): Promise<void>;
+    getState(): ConnectionState;
+    getClientId(): string | undefined;
+    isConnected(timeoutMs?: number): Promise<boolean>;
+    onStateChange(handler: ConnectionStateHandler): () => void;
+    on<T = unknown>(event: string, handler: EventHandler<T>): () => void;
+    once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    joinRoom(room: string): Promise<void>;
+    leaveRoom(room: string): Promise<void>;
+    request(event: string, data?: unknown): void;
+    request<T = unknown>(event: string, data: unknown, ack: (response: T) => void): void;
+    requestWithAck<TResponse = unknown, TRequest = unknown>(event: string, data?: TRequest, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Type guard to validate server response structure.
+     */
+    private isValidResponse;
+    /**
+     * Establishes a new socket connection.
+     */
+    private establishConnection;
+    /**
+     * Sets up persistent socket handlers for disconnect, reconnect, etc.
+     */
+    private setupPersistentHandlers;
+    /**
+     * Cleans up existing socket if present.
+     */
+    private cleanupExistingSocket;
+    /**
+     * Handles a force reconnection attempt.
+     * Called by ForceReconnectManager when it's time to attempt reconnection.
+     */
+    private handleForceReconnectAttempt;
+    /**
+     * Starts wake detection to handle sleep/hibernate recovery.
+     */
+    private startWakeDetection;
+    /**
+     * Stops wake detection.
+     */
+    private stopWakeDetection;
+    /**
+     * Handles system wake from sleep.
+     */
+    private handleWakeFromSleep;
+    /**
+     * Logs a debug message.
+     */
+    private log;
+}
+/**
+ * Configuration with logger for backward compatibility.
+ *
+ * @deprecated Use {@link TransportClientOptions} instead.
+ * This type will be removed in a future major version.
+ *
+ * @example Migration
+ * ```typescript
+ * // Before (deprecated):
+ * const config: ClientConfigWithLogger = {
+ *   connectTimeoutMs: 5000,
+ *   logger: myLogger,
+ * }
+ *
+ * // After (recommended):
+ * const options: TransportClientOptions = {
+ *   connectTimeoutMs: 5000,
+ *   logger: myLogger,
+ * }
+ * ```
+ *
+ * @see {@link TransportClientOptions} for the new configuration type
+ * @see {@link TransportClientConfig} for config-only options (no dependencies)
+ * @see {@link TransportClientDependencies} for dependency injection options
+ */
+export type ClientConfigWithLogger = ClientConfig & {
+    logger?: IClientLogger;
+};
+export {};
+//# sourceMappingURL=socket-io-client.d.ts.map

package/node_modules/@campfirein/brv-transport-client/dist/infra/socket-io-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-io-client.d.ts","sourceRoot":"","sources":["../../infra/socket-io-client.ts"],"names":[],"mappings":"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"}