@stdiobus/workers-registry 1.4.14 → 1.5.0-beta.2

package/out/tsc/workers-registry/registry-launcher/src/router/message-router.property.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/src/router/message-router.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/src/runtime/manager.property.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/src/runtime/manager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/src/stream/ndjson-handler.property.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/src/stream/ndjson-handler.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/auth-flow.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/auth-required-flow.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/helpers/api-keys.d.ts

@@ -0,0 +1,32 @@
+/** Configuration for a single agent's API key entry. */
+export interface AgentApiKeyConfig {
+    /** API key value */
+    apiKey?: string;
+    /** Environment variables to inject into the agent process */
+    env?: Record<string, string>;
+}
+/**
+ * Helper for creating and managing temporary api-keys.json files.
+ *
+ * Tracks all created temp directories for cleanup.
+ */
+export declare class ApiKeysHelper {
+    private tempDirs;
+    /**
+     * Create a temporary api-keys.json file with the given agent configs.
+     *
+     * @param agents - Map of agent ID to API key configuration.
+     * @returns Absolute path to the created api-keys.json file.
+     */
+    createApiKeysFile(agents: Record<string, AgentApiKeyConfig>): string;
+    /**
+     * Create an empty api-keys.json (no agents configured).
+     *
+     * @returns Absolute path to the created api-keys.json file.
+     */
+    createEmptyApiKeysFile(): string;
+    /**
+     * Clean up all temporary files and directories created by this helper.
+     */
+    cleanup(): void;
+}

package/out/tsc/workers-registry/registry-launcher/tests/e2e/helpers/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * E2E test helper infrastructure.
+ *
+ * Provides helpers for spawning the production launcher binary,
+ * serving mock registries, and managing temporary api-keys files.
+ *
+ * IMPORTANT: These helpers work ONLY with the production binary (dist/).
+ * No imports from src/ are allowed.
+ *
+ * @module tests/e2e/helpers
+ */
+export { LauncherHarness } from './launcher-harness';
+export type { LauncherOptions } from './launcher-harness';
+export { MockRegistryServer } from './registry-server';
+export type { MockAgent } from './registry-server';
+export { ApiKeysHelper } from './api-keys';
+export type { AgentApiKeyConfig } from './api-keys';

package/out/tsc/workers-registry/registry-launcher/tests/e2e/helpers/launcher-harness.d.ts

@@ -0,0 +1,101 @@
+/** Options for starting the launcher process. */
+export interface LauncherOptions {
+    /** Environment variables to pass to the launcher */
+    env?: Record<string, string>;
+    /** Path to api-keys.json file */
+    apiKeysPath?: string;
+    /** URL for the mock registry server */
+    registryUrl?: string;
+    /** Additional CLI args */
+    args?: string[];
+    /** Timeout for launcher ready in ms (default: 15000) */
+    readyTimeoutMs?: number;
+}
+/**
+ * Test harness for the production Registry Launcher binary.
+ *
+ * Manages spawning, communication, and cleanup of the launcher process
+ * for E2E testing.
+ */
+export declare class LauncherHarness {
+    private process;
+    private stderrBuffer;
+    private stdoutBuffer;
+    private responses;
+    private responseListeners;
+    private stderrListeners;
+    /** Path to the production launcher binary. */
+    private readonly launcherPath;
+    constructor();
+    /**
+     * Spawn the launcher process and wait for "Registry Launcher ready" in stderr.
+     *
+     * @param opts - Launcher options (env vars, registry URL, api keys path, etc.)
+     * @throws Error if the launcher fails to start or doesn't become ready within timeout.
+     */
+    start(opts?: LauncherOptions): Promise<void>;
+    /**
+     * Send an NDJSON message to the launcher's stdin.
+     *
+     * @param msg - Object to serialize as JSON and write to stdin.
+     * @throws Error if the launcher is not running.
+     */
+    sendMessage(msg: object): void;
+    /**
+     * Wait for a response with a matching `id` from stdout.
+     *
+     * Checks already-received responses first, then listens for new ones.
+     *
+     * @param id - The JSON-RPC request id to match.
+     * @param timeoutMs - Maximum time to wait in ms (default: 10000).
+     * @returns The parsed response object.
+     * @throws Error on timeout or if the launcher exits unexpectedly.
+     */
+    waitForResponse(id: string | number, timeoutMs?: number): Promise<object>;
+    /**
+     * Wait for a pattern to appear in stderr output.
+     *
+     * Checks already-collected stderr first, then listens for new data.
+     *
+     * @param pattern - String or RegExp to match against stderr.
+     * @param timeoutMs - Maximum time to wait in ms (default: 10000).
+     * @returns The matching stderr line or chunk.
+     * @throws Error on timeout.
+     */
+    waitForStderr(pattern: string | RegExp, timeoutMs?: number): Promise<string>;
+    /**
+     * Collect all responses from stdout for a given period.
+     *
+     * @param timeoutMs - Duration to collect responses in ms.
+     * @returns Array of all parsed response objects received during the period.
+     */
+    collectAllResponses(timeoutMs: number): Promise<object[]>;
+    /**
+     * Send SIGTERM and wait for process exit, then cleanup.
+     *
+     * @returns Object with the exit code (null if force-killed).
+     */
+    stop(): Promise<{
+        exitCode: number | null;
+    }>;
+    /**
+     * Get all stderr output collected so far.
+     *
+     * @returns The full stderr buffer as a string.
+     */
+    getStderr(): string;
+    /**
+     * Check if the launcher process is running.
+     *
+     * @returns true if the process is alive.
+     */
+    isRunning(): boolean;
+    /** Parse complete NDJSON lines from the stdout buffer. */
+    private parseStdoutLines;
+    /** Find an already-received response by id. */
+    private findResponse;
+    /** Check if a response object has a matching id. */
+    private matchesId;
+    /** Check if text matches a string or RegExp pattern. */
+    private matchesPattern;
+}

package/out/tsc/workers-registry/registry-launcher/tests/e2e/helpers/registry-server.d.ts

@@ -0,0 +1,46 @@
+/** Agent definition for the mock registry. */
+export interface MockAgent {
+    /** Unique agent identifier */
+    id: string;
+    /** Human-readable agent name */
+    name: string;
+    /** Agent version */
+    version?: string;
+    /** Agent description */
+    description?: string;
+    /** Command to run the agent (e.g., 'node') */
+    cmd: string;
+    /** Arguments for the command (e.g., path to agent script) */
+    args: string[];
+}
+/**
+ * Mock HTTP server that serves an ACP registry JSON.
+ *
+ * Binds to 127.0.0.1 on a random port and serves the registry
+ * at any request path.
+ */
+export declare class MockRegistryServer {
+    private server;
+    private port;
+    /**
+     * Start the HTTP server on a random port, serving the registry JSON.
+     *
+     * @param agents - Array of mock agent definitions to include in the registry.
+     * @returns The full URL to the registry JSON (e.g., `http://127.0.0.1:12345/registry.json`).
+     */
+    start(agents: MockAgent[]): Promise<string>;
+    /**
+     * Stop the server and release resources.
+     */
+    stop(): Promise<void>;
+    /**
+     * Get the URL of the mock registry.
+     *
+     * @returns URL in format `http://127.0.0.1:{port}/registry.json`.
+     */
+    getUrl(): string;
+    /**
+     * Build a valid ACP registry JSON from the provided agents.
+     */
+    private buildRegistryJson;
+}

package/out/tsc/workers-registry/registry-launcher/tests/e2e/production-agent-auth.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/production-api-keys.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/production-auth-required.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/production-cli.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/production-concurrent.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/production-lifecycle.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/e2e/production-terminal-auth.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/integration/agent-auth.integration.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * E2E tests for Agent Auth flow.
+ *
+ * Tests the complete Agent Auth flow:
+ * - initialize → AUTH_REQUIRED → authenticate → session/new success
+ *
+ * Uses mock-agent-auth.mjs which simulates an agent that requires Agent Auth.
+ */
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/integration/registry-launcher.test.d.ts

@@ -0,0 +1 @@
+export {};

package/out/tsc/workers-registry/registry-launcher/tests/integration/terminal-auth.integration.test.d.ts

@@ -0,0 +1,12 @@
+/**
+ * E2E tests for Terminal Auth flow.
+ *
+ * Tests the complete Terminal Auth flow:
+ * - initialize → AUTH_REQUIRED → spawn with args → session/new success
+ *
+ * Uses mock-agent-terminal.mjs which simulates an agent that requires Terminal Auth.
+ *
+ * Note: These tests require TTY environment to run Terminal Auth.
+ * In CI/non-TTY environments, Terminal Auth should fail gracefully.
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdiobus/workers-registry",
-  "version": "1.4.14",
+  "version": "1.5.0-beta.2",
   "description": "Worker implementations for stdio Bus kernel - ACP, MCP, and protocol bridges",
   "type": "module",
   "main": "./out/dist/workers-registry/acp-registry/index.js",
@@ -22,17 +22,21 @@
       "import": "./out/dist/workers-registry/acp-worker/agent.js",
       "types": "./out/tsc/workers-registry/acp-worker/src/agent.d.ts"
     },
-    "./workers/acp-worker/registry": {
-      "import": "./out/dist/workers-registry/acp-worker/registry-launcher/registry/index.js",
-      "types": "./out/tsc/workers-registry/acp-worker/src/registry-launcher/registry/index.d.ts"
+    "./workers/registry-launcher": {
+      "import": "./out/dist/workers-registry/registry-launcher/index.js",
+      "types": "./out/tsc/workers-registry/registry-launcher/src/index.d.ts"
     },
-    "./workers/acp-worker/runtime": {
-      "import": "./out/dist/workers-registry/acp-worker/registry-launcher/runtime/manager.js",
-      "types": "./out/tsc/workers-registry/acp-worker/src/registry-launcher/runtime/manager.d.ts"
+    "./workers/registry-launcher/registry": {
+      "import": "./out/dist/workers-registry/registry-launcher/registry/index.js",
+      "types": "./out/tsc/workers-registry/registry-launcher/src/registry/index.d.ts"
     },
-    "./workers/acp-worker/config": {
-      "import": "./out/dist/workers-registry/acp-worker/registry-launcher/config/config.js",
-      "types": "./out/tsc/workers-registry/acp-worker/src/registry-launcher/config/config.d.ts"
+    "./workers/registry-launcher/runtime": {
+      "import": "./out/dist/workers-registry/registry-launcher/runtime/manager.js",
+      "types": "./out/tsc/workers-registry/registry-launcher/src/runtime/manager.d.ts"
+    },
+    "./workers/registry-launcher/config": {
+      "import": "./out/dist/workers-registry/registry-launcher/config/config.js",
+      "types": "./out/tsc/workers-registry/registry-launcher/src/config/config.d.ts"
     },
     "./workers/acp-worker/mcp": {
       "import": "./out/dist/workers-registry/acp-worker/mcp/manager.js",
@@ -98,6 +102,7 @@
     "@modelcontextprotocol/sdk": "^1.27.1"
   },
   "devDependencies": {
+    "@stdiobus/node": "^0.1.0",
     "@types/jest": "^29.5.0",
     "@types/node": "^20.0.0",
     "esbuild": "^0.20.0",
@@ -107,4 +112,4 @@
     "tsc-alias": "^1.8.16",
     "typescript": "^5.0.0"
   }
-}
+}

package/out/tsc/workers-registry/acp-worker/src/registry-launcher/router/message-router.d.ts

@@ -1,199 +0,0 @@
-/**
- * Message Router for the Registry Launcher.
- *
- * Routes incoming JSON-RPC messages to the appropriate agent based on agentId.
- * Handles agentId extraction, message transformation, and error response generation.
- *
- * @module router/message-router
- */
-import type { IRegistryIndex } from '../registry/index.js';
-import type { AgentRuntimeManager } from '../runtime/manager.js';
-/**
- * JSON-RPC error codes for routing errors.
- */
-export declare const RoutingErrorCodes: {
-    /** Missing agentId in request */
-    readonly MISSING_AGENT_ID: -32600;
-    /** Agent not found in registry */
-    readonly AGENT_NOT_FOUND: -32001;
-    /** Platform not supported for binary distribution */
-    readonly PLATFORM_NOT_SUPPORTED: -32002;
-    /** Agent spawn failed */
-    readonly SPAWN_FAILED: -32003;
-};
-/**
- * JSON-RPC error response structure.
- */
-export interface ErrorResponse {
-    jsonrpc: '2.0';
-    id: string | number | null;
-    error: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-/**
- * Callback type for writing responses to stdout.
- */
-export type WriteCallback = (message: object) => boolean;
-/**
- * Create a JSON-RPC error response.
- *
- * @param id - Request ID (null for notifications or unknown)
- * @param code - Error code
- * @param message - Error message
- * @param data - Optional additional error data
- * @returns Error response object
- */
-export declare function createErrorResponse(id: string | number | null, code: number, message: string, data?: unknown): ErrorResponse;
-/**
- * Extract the agentId field from a message.
- *
- * @param message - The message object to extract from
- * @returns The agentId string or undefined if not present
- */
-export declare function extractAgentId(message: object): string | undefined;
-/**
- * Extract the JSON-RPC id field from a message.
- *
- * @param message - The message object to extract from
- * @returns The id (string, number, or null)
- */
-export declare function extractId(message: object): string | number | null;
-/**
- * Transform a message for forwarding to an agent.
- *
- * Removes the agentId field while preserving all other fields.
- *
- * @param message - The original message
- * @returns A new message object without the agentId field
- */
-export declare function transformMessage(message: object): object;
-/**
- * Message Router implementation.
- *
- * Routes incoming JSON-RPC messages to the appropriate agent based on agentId.
- * Handles message transformation, error generation, and request correlation.
- */
-export declare class MessageRouter {
-    /** Registry index for agent lookup and resolution */
-    private readonly registry;
-    /** Runtime manager for agent process lifecycle */
-    private readonly runtimeManager;
-    /** Callback for writing responses to stdout */
-    private readonly writeCallback;
-    /** API keys for agent authentication */
-    private readonly apiKeys;
-    /** Map of request ID to pending request info for correlation */
-    private readonly pendingRequests;
-    /** Map of agent ID to authentication state */
-    private readonly authState;
-    /** Map of agent sessionId to client sessionId for notification routing */
-    private readonly sessionIdMap;
-    /**
-     * Create a new MessageRouter.
-     *
-     * @param registry - Registry index for agent lookup
-     * @param runtimeManager - Runtime manager for agent processes
-     * @param writeCallback - Callback for writing responses to stdout
-     * @param apiKeys - API keys for agent authentication (optional)
-     */
-    constructor(registry: IRegistryIndex, runtimeManager: AgentRuntimeManager, writeCallback: WriteCallback, apiKeys?: Record<string, any>);
-    /**
-     * Inject mcpServers from registry into session/new request params.
-     *
-     * If the agent has mcpServers configured in the registry, they are merged
-     * with any mcpServers already present in the request params.
-     * Registry servers are added first, then request servers (request takes precedence for duplicates).
-     *
-     * @param message - The transformed message (without agentId)
-     * @param agentId - The agent ID to look up in registry
-     * @returns Message with mcpServers injected into params
-     */
-    private injectMcpServers;
-    /**
-     * Route an incoming message to the appropriate agent.
-     *
-     * Extracts agentId, resolves spawn command, and forwards message.
-     *
-     * @param message - The incoming JSON-RPC message
-     * @returns Error response if routing fails, undefined on success
-     */
-    route(message: object): Promise<ErrorResponse | undefined>;
-    /**
-     * Handle a response from an agent process.
-     *
-     * Intercepts initialize responses to trigger automatic authentication.
-     * Handles agent-to-client requests (like session/request_permission) by
-     * auto-responding when they cannot be forwarded to the client.
-     * Tracks sessionId mapping for proper notification routing.
-     * Forwards all responses to stdout.
-     *
-     * @param agentId - The agent that sent the response
-     * @param response - The response object from the agent
-     */
-    handleAgentResponse(agentId: string, response: object): void;
-    /**
-     * Handle a request from an agent to the client.
-     *
-     * Agent-to-client requests (JSON-RPC messages with both `id` and `method`)
-     * require a response. Since the Registry Launcher is headless and cannot
-     * forward these to a human, we auto-respond to keep the agent unblocked.
-     *
-     * Known methods:
-     * - session/request_permission: Auto-approve with the first "allow" option
-     *
-     * Unknown methods get a generic success response so the agent continues.
-     *
-     * @param agentId - The agent that sent the request
-     * @param id - The JSON-RPC request id
-     * @param method - The JSON-RPC method name
-     * @param msg - The full message object
-     */
-    private handleAgentRequest;
-    /**
-     * Build an auto-approve result for session/request_permission.
-     *
-     * Picks the first "allow" option from the request, preferring
-     * allow_always > allow_once > first option as fallback.
-     *
-     * @param msg - The request_permission message
-     * @returns The result object for the response
-     */
-    private buildPermissionResponse;
-    /**
-     * Send a JSON-RPC message directly to an agent process.
-     *
-     * @param agentId - The agent to send to
-     * @param message - The message to send
-     */
-    private sendToAgent;
-    /**
-     * Attempt automatic authentication for an agent.
-     *
-     * Selects the best authentication method and sends authenticate request.
-     *
-     * @param agentId - The agent to authenticate
-     * @param authMethods - Available authentication methods from initialize response
-     */
-    private attemptAuthentication;
-    /**
-     * Get the number of pending requests.
-     *
-     * @returns The count of pending requests
-     */
-    get pendingCount(): number;
-    /**
-     * Check if a request ID is pending.
-     *
-     * @param id - The request ID to check
-     * @returns true if the request is pending, false otherwise
-     */
-    isPending(id: string | number): boolean;
-    /**
-     * Clear all pending requests.
-     * Useful for cleanup during shutdown.
-     */
-    clearPending(): void;
-}