@a5c-ai/adapters-harness-mock 5.1.1-staging.00ceebd28cf2

package/dist/types.d.ts

@@ -0,0 +1,463 @@
+/**
+ * Types for the harness mock/simulator.
+ *
+ * A "harness" is a CLI tool (claude-code, codex, etc.) that adapters
+ * invokes as a subprocess. This package simulates harness behavior for
+ * testing without requiring the real CLI tools to be installed.
+ */
+/** Supported harness types for mocking. */
+export type HarnessType = 'claude-code' | 'codex' | 'gemini' | 'amp' | 'copilot' | 'cursor' | 'droid' | 'opencode' | 'pi' | 'omp' | 'openclaw' | 'hermes' | 'qwen' | 'aider' | 'goose' | 'custom' | 'claude-agent-sdk' | 'codex-sdk' | 'codex-websocket' | 'pi-sdk' | 'opencode-http';
+/** Adapter execution types supported by harness-mock. */
+export type AdapterExecutionType = 'subprocess' | 'http' | 'websocket' | 'sdk';
+/** A simulated file operation that the harness would perform. */
+export interface FileOperation {
+    /** Type of file operation. */
+    type: 'create' | 'modify' | 'delete' | 'rename';
+    /** Absolute path to the file. */
+    path: string;
+    /** New path (only for 'rename'). */
+    newPath?: string;
+    /** Content to write (for 'create' and 'modify'). */
+    content?: string;
+    /** Diff/patch content (for 'modify', alternative to full content). */
+    patch?: string;
+}
+/** Simulated process exit behavior. */
+export interface ProcessBehavior {
+    /** Exit code. 0 = success. */
+    exitCode: number;
+    /** Delay in ms before the process "starts producing output". */
+    startupDelayMs?: number;
+    /** Delay in ms before the process exits after all output is sent. */
+    shutdownDelayMs?: number;
+    /** If set, the process will crash with this signal after the given delay. */
+    crashAfterMs?: number;
+    /** Signal to crash with (default: SIGTERM). */
+    crashSignal?: string;
+    /** Whether the process hangs indefinitely (for timeout testing). */
+    hang?: boolean;
+}
+/** A single output chunk from the simulated harness. */
+export interface OutputChunk {
+    /** Which stream this goes to. */
+    stream: 'stdout' | 'stderr';
+    /** The data to emit. */
+    data: string;
+    /** Delay in ms before emitting this chunk (relative to previous chunk). */
+    delayMs?: number;
+}
+/** An expected stdin prompt and the mock's response behavior. */
+export interface InteractionResolution {
+    /** Output to emit after the interaction resolves. */
+    output?: OutputChunk[];
+    /** Exit code to use after resolution. If omitted, resume the base scenario. */
+    exitCode?: number;
+}
+export interface StdinInteraction {
+    /** Pattern to match on stdout/stderr before this interaction fires. */
+    triggerPattern: string | RegExp;
+    /** Auto-response to feed into stdin when the prompt appears. */
+    response: string;
+    /** Delay before responding (ms). */
+    delayMs?: number;
+    /** Explicit allow matcher for manual stdin input. Defaults to /^y(es)?\\s*$/i. */
+    allowPattern?: string | RegExp;
+    /** Explicit deny matcher for manual stdin input. Defaults to /^n(o)?\\s*$/i. */
+    denyPattern?: string | RegExp;
+    /** How long to wait for approval input before timing out. */
+    timeoutMs?: number;
+    /** Output/exit behavior once the interaction is allowed. */
+    onAllow?: InteractionResolution;
+    /** Output/exit behavior once the interaction is denied. */
+    onDeny?: InteractionResolution;
+    /** Output/exit behavior once the interaction times out. */
+    onTimeout?: InteractionResolution;
+}
+/** A simulated agent event (matching the adapters event schema). */
+export interface MockEvent {
+    /** Event type matching the adapters event taxonomy. */
+    type: string;
+    /** Delay before emitting this event (ms, relative to previous). */
+    delayMs?: number;
+    /** Event payload. */
+    data: Record<string, unknown>;
+}
+export interface RuntimeHookScenarioStep {
+    /** Zero-based output chunk index intercepted by the runtime hook. */
+    chunkIndex: number;
+    /** Hook kind being simulated. */
+    kind: 'preToolUse' | 'postToolUse' | 'sessionStart' | 'sessionEnd' | 'stop' | 'userPromptSubmit';
+    /** Payload surfaced on the emitted runtime-hook event. */
+    payload?: Record<string, unknown>;
+    /** Mock runtime-hook decision. */
+    decision: 'allow' | 'deny' | 'timeout';
+    /** Delay before the decision resolves. */
+    delayMs?: number;
+    /** Optional stderr line when the hook denies the action. */
+    errorMessage?: string;
+}
+/** Configuration for HTTP server mocking. */
+export interface HttpServerConfig {
+    /** Port to bind the mock server to. */
+    port?: number;
+    /** Host to bind to (default: localhost). */
+    host?: string;
+    /** Startup delay in milliseconds. */
+    startupDelayMs?: number;
+    /** Whether server startup should fail. */
+    startupFails?: boolean;
+    /** Routes and their response configurations. */
+    routes?: Record<string, HttpRouteConfig>;
+    /** Global response delay (applies to all routes). */
+    globalDelayMs?: number;
+    /** Enable CORS headers. */
+    enableCors?: boolean;
+}
+/** Configuration for a single HTTP route. */
+export interface HttpRouteConfig {
+    /** HTTP method (GET, POST, etc.). */
+    method?: string;
+    /** Response status code. */
+    status?: number;
+    /** Response headers. */
+    headers?: Record<string, string>;
+    /** Response body (string, object, or function). */
+    body?: string | object | ((req: unknown) => unknown);
+    /** Response delay for this specific route. */
+    delayMs?: number;
+    /** Whether to stream the response. */
+    streaming?: boolean;
+    /** For streaming responses, chunks to send. */
+    streamChunks?: Array<{
+        data: string;
+        delayMs?: number;
+    }>;
+}
+/** Configuration for WebSocket server mocking. */
+export interface WebSocketConfig {
+    /** Port to bind the WebSocket server to. */
+    port?: number;
+    /** Host to bind to (default: localhost). */
+    host?: string;
+    /** Startup delay in milliseconds. */
+    startupDelayMs?: number;
+    /** Whether server startup should fail. */
+    startupFails?: boolean;
+    /** Channels to support. */
+    channels?: string[];
+    /** Ping interval in milliseconds. */
+    pingIntervalMs?: number;
+    /** Connection timeout in milliseconds. */
+    connectionTimeoutMs?: number;
+    /** Maximum number of concurrent connections. */
+    maxConnections?: number;
+    /** Whether to simulate connection drops. */
+    simulateDrops?: {
+        /** Drop connections after this many messages. */
+        afterMessages?: number;
+        /** Delay before reconnection is allowed. */
+        reconnectDelayMs?: number;
+    };
+}
+/** Configuration for SDK mocking. */
+export interface SdkConfig {
+    /** SDK name/identifier. */
+    sdkName?: string;
+    /** Version to simulate. */
+    version?: string;
+    /** Authentication configuration. */
+    auth?: {
+        /** Whether authentication should succeed. */
+        succeeds: boolean;
+        /** Delay for auth operations. */
+        delayMs?: number;
+        /** Required API keys or tokens. */
+        requiredKeys?: string[];
+    };
+    /** API call simulation. */
+    apiCalls?: Record<string, SdkMethodConfig>;
+    /** Global settings for all SDK methods. */
+    globalConfig?: {
+        /** Default delay for all operations. */
+        defaultDelayMs?: number;
+        /** Rate limiting simulation. */
+        rateLimitMs?: number;
+        /** Network failure simulation rate (0-1). */
+        failureRate?: number;
+    };
+}
+/** Configuration for a single SDK method. */
+export interface SdkMethodConfig {
+    /** Response to return. */
+    response?: unknown;
+    /** Delay before response. */
+    delayMs?: number;
+    /** Whether this method should fail. */
+    shouldFail?: boolean;
+    /** Error to throw if shouldFail is true. */
+    error?: {
+        code: string;
+        message: string;
+    };
+    /** Whether this method supports streaming. */
+    streaming?: boolean;
+    /** For streaming methods, events to emit. */
+    streamEvents?: Array<{
+        type: string;
+        data: unknown;
+        delayMs?: number;
+    }>;
+}
+/**
+ * A complete scenario describing how a mock harness should behave.
+ * This is the primary configuration object for setting up mock tests.
+ */
+export interface HarnessScenario {
+    /** Which harness to simulate. */
+    harness: HarnessType;
+    /** Human-readable scenario name (for test output). */
+    name?: string;
+    /** The execution type for this harness (default: subprocess). */
+    executionType?: AdapterExecutionType;
+    /** Process behavior (exit code, timing, crashes). */
+    process?: ProcessBehavior;
+    /** Sequence of output chunks to emit. */
+    output?: OutputChunk[];
+    /** Interactive stdin/stdout exchanges. */
+    interactions?: StdinInteraction[];
+    /** Environment variables the harness expects. */
+    expectedEnv?: Record<string, string>;
+    /** Expected command-line arguments. */
+    expectedArgs?: string[];
+    /** Expected working directory. */
+    expectedCwd?: string;
+    /** Sequence of events the harness would produce. */
+    events?: MockEvent[];
+    /** File operations the harness would perform. */
+    fileOperations?: FileOperation[];
+    /** Simulated telemetry data. */
+    telemetry?: {
+        spans?: Array<{
+            name: string;
+            attributes?: Record<string, string | number | boolean>;
+            status?: 'ok' | 'error';
+            delayMs?: number;
+        }>;
+        metrics?: Array<{
+            name: string;
+            value: number;
+            attributes?: Record<string, string | number | boolean>;
+            delayMs?: number;
+        }>;
+    };
+    /** Optional runtime-hook interception points for subprocess scenarios. */
+    runtimeHooks?: {
+        steps: RuntimeHookScenarioStep[];
+    };
+    /** HTTP server configuration (for HTTP adapters). */
+    httpServer?: HttpServerConfig;
+    /** WebSocket server configuration (for WebSocket adapters). */
+    websocketServer?: WebSocketConfig;
+    /** SDK configuration (for programmatic adapters). */
+    sdk?: SdkConfig;
+}
+/** Base handle to a running mock harness. */
+export interface MockHarnessHandle {
+    /** The scenario being executed. */
+    readonly scenario: HarnessScenario;
+    /** Unique identifier for this mock instance. */
+    readonly id: number;
+    /** Whether the mock has stopped. */
+    readonly exited: boolean;
+    /** Files that were "modified" by this mock. */
+    readonly fileChanges: FileOperation[];
+    /** Stop the mock (gracefully if possible). */
+    stop(): Promise<void>;
+    /** Force stop the mock immediately. */
+    forceStop(): void;
+    /** Wait for the mock to complete. */
+    waitForCompletion(): Promise<MockExecutionResult>;
+}
+/** Result of mock execution. */
+export interface MockExecutionResult {
+    /** Whether execution completed successfully. */
+    success: boolean;
+    /** Duration of execution in milliseconds. */
+    durationMs: number;
+    /** Any error that occurred. */
+    error?: {
+        code: string;
+        message: string;
+    };
+    /** Execution-type specific results. */
+    results: SubprocessResult | HttpServerResult | WebSocketServerResult | SdkResult;
+}
+/** Subprocess-specific handle (traditional harness mock). */
+export interface SubprocessMockHandle extends MockHarnessHandle {
+    /** The exit code (undefined until exited). */
+    readonly exitCode: number | undefined;
+    /** All stdout data collected so far. */
+    readonly stdout: string;
+    /** All stderr data collected so far. */
+    readonly stderr: string;
+    /** Write to the mock's stdin. */
+    write(data: string): void;
+    /** Send a signal to the mock process. */
+    kill(signal?: string): void;
+    /** Wait for the mock process to exit. */
+    waitForExit(): Promise<{
+        exitCode: number;
+        stdout: string;
+        stderr: string;
+    }>;
+}
+/** HTTP server-specific handle. */
+export interface HttpServerMockHandle extends MockHarnessHandle {
+    /** Server endpoint URL. */
+    readonly serverUrl: string;
+    /** Server port. */
+    readonly port: number;
+    /** Whether the server is running. */
+    readonly isRunning: boolean;
+    /** Request history. */
+    readonly requestHistory: Array<{
+        method: string;
+        path: string;
+        headers: Record<string, string>;
+        body: unknown;
+        timestamp: Date;
+    }>;
+    /** Get server status. */
+    getStatus(): {
+        isRunning: boolean;
+        requestCount: number;
+        uptime: number;
+    };
+    /** Reset request history and state. */
+    reset(): void;
+}
+/** WebSocket server-specific handle. */
+export interface WebSocketServerMockHandle extends MockHarnessHandle {
+    /** Server endpoint URL. */
+    readonly serverUrl: string;
+    /** Server port. */
+    readonly port: number;
+    /** Whether the server is running. */
+    readonly isRunning: boolean;
+    /** Connected clients count. */
+    readonly connectionCount: number;
+    /** Message history for all connections. */
+    readonly messageHistory: Array<{
+        connectionId: string;
+        direction: 'inbound' | 'outbound';
+        message: unknown;
+        timestamp: Date;
+    }>;
+    /** Send message to all connected clients. */
+    broadcast(message: unknown): void;
+    /** Send message to specific connection. */
+    sendTo(connectionId: string, message: unknown): void;
+    /** Simulate connection drop for a specific client. */
+    dropConnection(connectionId: string): void;
+    /** Get connection status. */
+    getConnectionStatus(): Array<{
+        connectionId: string;
+        connectedAt: Date;
+        messageCount: number;
+    }>;
+}
+/** SDK-specific handle. */
+export interface SdkMockHandle extends MockHarnessHandle {
+    /** SDK instance name. */
+    readonly sdkName: string;
+    /** Method call history. */
+    readonly methodHistory: Array<{
+        method: string;
+        args: unknown[];
+        result: unknown;
+        durationMs: number;
+        timestamp: Date;
+    }>;
+    /** Whether authentication was successful. */
+    readonly isAuthenticated: boolean;
+    /** Simulate a method call. */
+    callMethod(method: string, ...args: unknown[]): Promise<unknown>;
+    /** Get method call statistics. */
+    getStats(): {
+        totalCalls: number;
+        uniqueMethods: string[];
+        averageDurationMs: number;
+    };
+    /** Reset method history and state. */
+    reset(): void;
+}
+/** Subprocess execution result. */
+export interface SubprocessResult {
+    type: 'subprocess';
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    signalKilled?: string;
+}
+/** HTTP server execution result. */
+export interface HttpServerResult {
+    type: 'http';
+    requestCount: number;
+    requestHistory: Array<{
+        method: string;
+        path: string;
+        status: number;
+    }>;
+    averageResponseTimeMs: number;
+}
+/** WebSocket server execution result. */
+export interface WebSocketServerResult {
+    type: 'websocket';
+    connectionCount: number;
+    messageCount: number;
+    averageConnectionDurationMs: number;
+}
+/** SDK execution result. */
+export interface SdkResult {
+    type: 'sdk';
+    methodCallCount: number;
+    uniqueMethods: string[];
+    averageMethodDurationMs: number;
+    authenticationAttempts: number;
+}
+/**
+ * A captured behavior profile from probing a real harness.
+ * Used to compare mock fidelity against actual harness behavior.
+ */
+export interface HarnessBehaviorProfile {
+    /** Harness type. */
+    harness: HarnessType;
+    /** Execution transport captured by the profile. */
+    executionType: AdapterExecutionType;
+    /** Version of the harness that was probed. */
+    version: string;
+    /** Timestamp of when the profile was captured. */
+    capturedAt: string;
+    /** Startup time in ms. */
+    startupTimeMs: number;
+    /** How the harness formats its output (jsonl, streaming text, etc). */
+    outputFormat: string;
+    /** Additional traits observed or expected for the output stream. */
+    outputFormatTraits: string[];
+    /** Whether the harness supports stdin interaction. */
+    supportsStdin: boolean;
+    /** Prompt/signal markers associated with stdin interaction. */
+    stdinSignals: string[];
+    /** File operation patterns observed. */
+    fileOperationPatterns: string[];
+    /** Exit code mapping: scenario → exit code. */
+    exitCodes: Record<string, number>;
+    /** Environment variables the harness reads. */
+    environmentVariables: string[];
+    /** CLI argument patterns. */
+    cliPatterns: Record<string, string>;
+    /** Where this probe is expected to run. */
+    availability: 'ci' | 'ci-or-local' | 'local-manual' | 'offline-only';
+    /** Free-form notes for drift reviewers. */
+    probeNotes: string[];
+}

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Types for the harness mock/simulator.
+ *
+ * A "harness" is a CLI tool (claude-code, codex, etc.) that adapters
+ * invokes as a subprocess. This package simulates harness behavior for
+ * testing without requiring the real CLI tools to be installed.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/websocket-mock.d.ts

@@ -0,0 +1,58 @@
+/**
+ * WebSocket server mock implementation for harness-mock.
+ */
+import { EventEmitter } from 'node:events';
+import type { FileOperation, HarnessScenario, MockExecutionResult, WebSocketServerMockHandle } from './types.js';
+export declare class WebSocketServerMock extends EventEmitter implements WebSocketServerMockHandle {
+    readonly scenario: HarnessScenario;
+    readonly id: number;
+    private _port;
+    private _serverUrl;
+    private _server;
+    private _exited;
+    private _isRunning;
+    private _startTime;
+    private _fileChanges;
+    private readonly _messageHistory;
+    private readonly _connections;
+    private readonly _completedConnections;
+    private _reconnectAllowedAt;
+    private _reconnectTimer;
+    constructor(scenario: HarnessScenario, id: number);
+    get port(): number;
+    get serverUrl(): string;
+    get exited(): boolean;
+    get fileChanges(): FileOperation[];
+    get isRunning(): boolean;
+    get connectionCount(): number;
+    get messageHistory(): {
+        connectionId: string;
+        direction: "inbound" | "outbound";
+        message: unknown;
+        timestamp: Date;
+    }[];
+    start(): Promise<void>;
+    broadcast(message: unknown): void;
+    sendTo(connectionId: string, message: unknown): void;
+    receiveFrom(connectionId: string, message: unknown): void;
+    dropConnection(connectionId: string): void;
+    getConnectionStatus(): {
+        connectionId: string;
+        connectedAt: Date;
+        messageCount: number;
+    }[];
+    stop(): Promise<void>;
+    forceStop(): void;
+    waitForCompletion(): Promise<MockExecutionResult>;
+    private createConnection;
+    private scheduleScenarioEvents;
+    private recordMessage;
+    private sendFrame;
+    private attachSocketHandlers;
+    private decodeMessage;
+    private normalizeRawData;
+    private closeConnection;
+    private finalizeConnection;
+    private checkForDrop;
+    private getHistoricalConnections;
+}

package/dist/websocket-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-mock.d.ts","sourceRoot":"","sources":["../src/websocket-mock.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EAE1B,MAAM,YAAY,CAAC;AAapB,qBAAa,mBAAoB,SAAQ,YAAa,YAAW,yBAAyB;IACxF,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAgC;IAE/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAKxB;IACR,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA6B;IACnE,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,eAAe,CAA8C;gBAEzD,QAAQ,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM;IASjD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,WAAW,IAAI,aAAa,EAAE,CAEjC;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,eAAe,IAAI,MAAM,CAE5B;IAED,IAAI,cAAc;sBA3CF,MAAM;mBACT,SAAS,GAAG,UAAU;iBACxB,OAAO;mBACL,IAAI;QA0ChB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+F5B,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMjC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAWpD,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAazD,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAuB1C,mBAAmB;;;;;IAQb,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,SAAS,IAAI,IAAI;IAIX,iBAAiB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAyBvD,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,sBAAsB;IAmB9B,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,oBAAoB;IAiB5B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,wBAAwB;CAUjC"}