@stdiobus/workers-registry 1.3.7

package/out/tsc/workers/acp-worker/src/session/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Session State Management
+ *
+ * This module manages ACP session state including session creation,
+ * lookup, and cleanup. Each session maintains its own MCP connections
+ * and conversation history.
+ *
+ * @module session
+ */
+export { SessionManager } from './manager.js';
+export { Session } from './session.js';
+export type { SessionState, HistoryEntry } from './types.js';

package/out/tsc/workers/acp-worker/src/session/manager.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Session Manager
+ *
+ * Manages the lifecycle of ACP sessions.
+ *
+ * @module session/manager
+ */
+import { type MCPManagerFactory, Session } from './session.js';
+import type { MCPServerConfig } from '../mcp/types.js';
+/**
+ * Manages ACP sessions.
+ */
+export declare class SessionManager {
+    private sessions;
+    private mcpManagerFactory?;
+    /**
+     * Create a new SessionManager.
+     *
+     * @param mcpManagerFactory - Optional factory for creating MCPManager instances (used in tests)
+     */
+    constructor(mcpManagerFactory?: MCPManagerFactory);
+    /**
+     * Create a new session.
+     */
+    createSession(cwd: string, mcpServers?: MCPServerConfig[]): Promise<Session>;
+    /**
+     * Get a session by ID.
+     */
+    getSession(id: string): Session | undefined;
+    /**
+     * Cancel a session.
+     */
+    cancelSession(id: string): boolean;
+    /**
+     * Close and remove a session.
+     */
+    closeSession(id: string): Promise<boolean>;
+    /**
+     * Close all sessions.
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Get all sessions.
+     *
+     * @returns Array of all sessions
+     */
+    getAllSessions(): Session[];
+    /**
+     * Remove a session from the manager without closing it.
+     *
+     * @param id - Session ID to remove
+     * @returns true if session was removed, false if not found
+     */
+    removeSession(id: string): boolean;
+    /**
+     * Generate a unique session ID using crypto.randomUUID().
+     *
+     * Generate unique sessionId using UUID
+     *
+     * @returns A unique UUID string for the session
+     */
+    private generateSessionId;
+}

package/out/tsc/workers/acp-worker/src/session/session.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Session
+ *
+ * Represents a single ACP session with its state and MCP connections.
+ * Stores sessionId, cwd, MCP connections, and cancellation flag.
+ *
+ * @module session/session
+ */
+import type { HistoryEntry, SessionState } from './types.js';
+import { MCPManager } from '../mcp/index.js';
+/**
+ * Factory function type for creating MCPManager instances.
+ * Used for dependency injection in tests.
+ */
+export type MCPManagerFactory = () => MCPManager;
+/**
+ * Represents an ACP session.
+ *
+ * The Session class manages:
+ * - Session identification (sessionId per requirements)
+ * - Working directory context (cwd)
+ * - MCP server connections via MCPManager
+ * - Cancellation state for aborting operations
+ * - Conversation history
+ */
+export declare class Session {
+    /** Unique session identifier (SessionId type per requirements) */
+    readonly id: string;
+    /** Current working directory for the session */
+    readonly cwd: string;
+    /** Manager for MCP server connections */
+    readonly mcpManager: MCPManager;
+    /** Cancellation flag for aborting pending operations */
+    private cancelled;
+    /** Timestamp when the session was created */
+    private createdAt;
+    /** Conversation history for the session */
+    private history;
+    /**
+     * Create a new Session.
+     *
+     * @param id - Unique session identifier
+     * @param cwd - Current working directory for the session
+     * @param mcpManagerFactory - Optional factory for creating MCPManager (used in tests)
+     */
+    constructor(id: string, cwd: string, mcpManagerFactory?: MCPManagerFactory);
+    /**
+     * Check if the session has been cancelled.
+     *
+     * @returns true if the session has been cancelled
+     */
+    isCancelled(): boolean;
+    /**
+     * Cancel the session.
+     * Sets the cancellation flag and aborts pending MCP operations.
+     */
+    cancel(): void;
+    /**
+     * Add an entry to the conversation history.
+     *
+     * @param role - Role of the message sender ('user' or 'agent')
+     * @param content - Content of the message
+     */
+    addHistoryEntry(role: 'user' | 'agent', content: string): void;
+    /**
+     * Get the conversation history.
+     *
+     * @returns Array of history entries
+     */
+    getHistory(): HistoryEntry[];
+    /**
+     * Clear the conversation history.
+     */
+    clearHistory(): void;
+    /**
+     * Get the session state.
+     *
+     * @returns Current session state including id, cwd, cancelled flag, and history
+     */
+    getState(): SessionState;
+    /**
+     * Close the session and cleanup resources.
+     * Closes all MCP server connections.
+     */
+    close(): Promise<void>;
+}

package/out/tsc/workers/acp-worker/src/session/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Session Types
+ *
+ * Type definitions for session state management.
+ *
+ * @module session/types
+ */
+/**
+ * Represents a history entry in a session.
+ */
+export interface HistoryEntry {
+    /** Role of the message sender */
+    role: 'user' | 'agent';
+    /** Content of the message */
+    content: string;
+    /** Timestamp of the message */
+    timestamp: Date;
+}
+/**
+ * Represents the state of an ACP session.
+ */
+export interface SessionState {
+    /** Unique session identifier (SessionId type per requirements) */
+    id: string;
+    /** Current working directory for the session */
+    cwd: string;
+    /** Whether the session has been cancelled */
+    cancelled: boolean;
+    /** When the session was created */
+    createdAt: Date;
+    /** Conversation history for the session */
+    history: HistoryEntry[];
+}

package/out/tsc/workers/acp-worker/src/test-utils/test-harness.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Integration Test Harness
+ *
+ * Provides utilities for testing full ACP/MCP protocol flows.
+ * Creates mock MCP servers and ACP clients for integration testing.
+ *
+ * @module tests/integration/test-harness
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+/**
+ * Mock MCP server for testing.
+ * Provides configurable tools and resources.
+ */
+export interface MockMCPServer {
+    server: Server;
+    transport: [unknown, unknown];
+    tools: MockTool[];
+    resources: MockResource[];
+    close: () => Promise<void>;
+}
+/**
+ * Mock tool definition.
+ */
+export interface MockTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (args: Record<string, unknown>) => Promise<{
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        isError?: boolean;
+    }>;
+}
+/**
+ * Mock resource definition.
+ */
+export interface MockResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+    content: string | {
+        blob: string;
+    };
+}
+/**
+ * Create a mock MCP server with configurable tools and resources.
+ *
+ * @param name - Server name
+ * @param tools - Array of mock tools
+ * @param resources - Array of mock resources
+ * @returns Mock MCP server instance
+ */
+export declare function createMockMCPServer(name: string, tools?: MockTool[], resources?: MockResource[]): Promise<MockMCPServer>;
+/**
+ * Create an MCP client connected to a mock server.
+ *
+ * @param mockServer - The mock server to connect to
+ * @returns Connected MCP client
+ */
+export declare function createMCPClientForMockServer(mockServer: MockMCPServer): Promise<Client>;
+/**
+ * Default echo tool for testing.
+ */
+export declare const echoTool: MockTool;
+/**
+ * Default error tool for testing error handling.
+ */
+export declare const errorTool: MockTool;
+/**
+ * Default greeting resource for testing.
+ */
+export declare const greetingResource: MockResource;
+/**
+ * Default config resource for testing.
+ */
+export declare const configResource: MockResource;

package/out/tsc/workers/mcp-echo-server/mcp-echo-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@stdiobus/workers-registry",
+  "version": "1.3.7",
+  "description": "Worker implementations for stdio Bus kernel - ACP, MCP, and protocol bridges",
+  "type": "module",
+  "main": "./out/dist/workers/acp-worker/index.js",
+  "types": "./out/tsc/workers/acp-worker/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./out/dist/workers/acp-worker/index.js",
+      "types": "./out/tsc/workers/acp-worker/index.d.ts"
+    },
+    "./workers/acp-worker": {
+      "import": "./out/dist/workers/acp-worker/index.js",
+      "types": "./out/tsc/workers/acp-worker/index.d.ts"
+    },
+    "./workers/echo-worker": "./out/dist/workers/echo-worker/echo-worker.js",
+    "./workers/mcp-echo-server": {
+      "import": "./out/dist/workers/mcp-echo-server/index.js",
+      "types": "./out/tsc/workers/mcp-echo-server/index.d.ts"
+    },
+    "./workers/mcp-to-acp-proxy": "./out/dist/workers/mcp-to-acp-proxy/proxy.js",
+    "./workers": "./out/dist/workers/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "out/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build.js",
+    "build:workers": "node scripts/build.js",
+    "clean": "rm -rf out",
+    "prepublishOnly": "npm run build",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "test:unit": "node --experimental-vm-modules node_modules/jest/bin/jest.js tests/unit",
+    "test:property": "node --experimental-vm-modules node_modules/jest/bin/jest.js tests/property",
+    "test:integration": "node --experimental-vm-modules node_modules/jest/bin/jest.js tests/integration",
+    "sync-acp": "node scripts/sync-acp.js"
+  },
+  "keywords": [
+    "acp",
+    "mcp",
+    "agent",
+    "transport",
+    "json-rpc",
+    "stdio-bus",
+    "worker",
+    "protocol"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stdiobus/workers-registry.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stdiobus/workers-registry/issues"
+  },
+  "homepage": "https://github.com/stdiobus/workers-registry#readme",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.14.1",
+    "@modelcontextprotocol/sdk": "^1.27.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "esbuild": "^0.20.0",
+    "fast-check": "^3.22.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.0.0"
+  }
+}