@modelprofile.com/mcp-crossharness 5.0.0 → 5.2.0

package/dist_ts/classes.mcptoolregistrar.js

@@ -0,0 +1,257 @@
+import * as plugins from './plugins.js';
+import { ConnectionRegistry } from './classes.connectionregistry.js';
+import { DispatchRegistry } from './classes.dispatchregistry.js';
+const harnessNameSchema = plugins.z.enum(['claudecode', 'opencode', 'codex']);
+/**
+ * Registers the Crossharness tool surface on an externally owned MCP server and
+ * owns only the resources used by those tools.
+ */
+export class CrossHarnessMcpToolRegistrar {
+    connections;
+    dispatches;
+    registeredTools = [];
+    registeredServer;
+    registered = false;
+    closeStarted = false;
+    closePromise;
+    resourceShutdownPromise;
+    constructor(connectionsArg = new ConnectionRegistry(), dispatchesArg = new DispatchRegistry()) {
+        this.connections = connectionsArg;
+        this.dispatches = dispatchesArg;
+    }
+    /** Register the tool surface before the externally owned MCP server connects. */
+    register(serverArg) {
+        if (this.closeStarted) {
+            throw new Error('Crossharness MCP tool registrar is closed');
+        }
+        if (this.registered) {
+            throw new Error('Crossharness MCP tools are already registered');
+        }
+        if (serverArg.isConnected()) {
+            throw new Error('Crossharness MCP tools must be registered before the MCP server connects');
+        }
+        const registeredTools = [];
+        try {
+            registeredTools.push(serverArg.registerTool('connect_harness', {
+                title: 'Connect to harness server',
+                description: 'Establish an explicit connection to an allowlisted harness web server. The exact origin must be listed in CROSSHARNESS_ALLOWED_SERVER_URLS. OpenCode uses http(s), Codex uses ws(s), and Claude Code is rejected because it exposes no URL-addressable session server. Returns a connectionId required by every connection-scoped operation; list_connections remains global.',
+                inputSchema: {
+                    harness: harnessNameSchema,
+                    serverUrl: plugins.z.string().max(2048).url().describe('Allowlisted harness server origin'),
+                    directory: plugins.z
+                        .string()
+                        .max(4096)
+                        .startsWith('/')
+                        .describe('Absolute project directory on the harness server'),
+                },
+            }, async (args, extra) => this.wrapToolCall(async () => {
+                const info = await this.connections.connect(args.harness, args.serverUrl, args.directory, extra.signal);
+                return this.describeConnection(info);
+            })));
+            registeredTools.push(serverArg.registerTool('disconnect_harness', {
+                title: 'Disconnect harness server',
+                description: 'Close and remove an established harness connection. In-flight requests fail; async dispatch records remain inspectable with check_reply.',
+                inputSchema: {
+                    connectionId: plugins.z.string().max(128).describe('Connection id returned by connect_harness'),
+                },
+            }, async (args) => this.wrapToolCall(async () => this.describeConnection(await this.connections.disconnect(args.connectionId)))));
+            registeredTools.push(serverArg.registerTool('list_connections', {
+                title: 'List harness connections',
+                description: 'List explicit harness web-server connections established in this MCP process.',
+                inputSchema: {},
+            }, async () => this.wrapToolCall(async () => {
+                const connections = this.connections.list();
+                return connections.length > 0
+                    ? connections.map((connection) => this.describeConnection(connection)).join('\n\n')
+                    : 'No harness server connections established.';
+            })));
+            registeredTools.push(serverArg.registerTool('connection_status', {
+                title: 'Check harness connection',
+                description: 'Run the protocol health check for one explicit harness server connection.',
+                inputSchema: {
+                    connectionId: plugins.z.string().max(128).describe('Connection id returned by connect_harness'),
+                },
+            }, async (args) => this.wrapToolCall(async () => {
+                const status = await this.connections.get(args.connectionId).getStatus();
+                return `${this.describeConnection(status)}\nhealthy: ${status.healthy ? 'yes' : 'no'}\ndetail: ${status.detail}`;
+            })));
+            registeredTools.push(serverArg.registerTool('list_chats', {
+                title: 'List harness chats',
+                description: 'List chats from the server and directory bound to an explicit connection. No local session stores are read.',
+                inputSchema: {
+                    connectionId: plugins.z.string().max(128).describe('Connection id returned by connect_harness'),
+                    limit: plugins.z.number().int().min(1).max(100).optional(),
+                },
+            }, async (args) => this.wrapToolCall(async () => {
+                const chats = await this.connections.get(args.connectionId).listChats(args.limit ?? 10);
+                if (chats.length === 0)
+                    return 'No chats found for this connection.';
+                return [
+                    'harness\tchatId\tupdatedAt\tactivity\ttitle',
+                    ...chats.map((chat) => `${chat.harness}\t${chat.chatId}\t${chat.updatedAt}\t${chat.isActive ? 'active' : 'idle'}\t${chat.title.replace(/\s+/g, ' ').slice(0, 120)}`),
+                ].join('\n');
+            })));
+            registeredTools.push(serverArg.registerTool('read_chat', {
+                title: 'Read harness chat',
+                description: 'Read a chat through the harness web server bound to an explicit connection.',
+                inputSchema: {
+                    connectionId: plugins.z.string().max(128).describe('Connection id returned by connect_harness'),
+                    chatId: plugins.z.string().min(1).max(1024),
+                    limit: plugins.z.number().int().min(1).max(500).optional(),
+                    maxChars: plugins.z.number().int().min(200).max(50000).optional(),
+                },
+            }, async (args) => this.wrapToolCall(async () => {
+                const transcript = await this.connections
+                    .get(args.connectionId)
+                    .readChat(args.chatId, args.limit ?? 20, args.maxChars ?? 2000);
+                const header = [
+                    `harness: ${transcript.harness}`,
+                    `chatId: ${transcript.chatId}`,
+                    `title: ${transcript.title}`,
+                    `directory: ${transcript.directory}`,
+                    transcript.totalMessages === undefined
+                        ? `messages: showing ${transcript.messages.length}; server total unavailable`
+                        : `messages: showing ${transcript.messages.length} of ${transcript.totalMessages}`,
+                ].join('\n');
+                const body = transcript.messages
+                    .map((message) => `-- [${message.role}]${message.timestamp ? ` ${message.timestamp}` : ''}\n${message.text}`)
+                    .join('\n');
+                return `${header}\n\n${body}`;
+            })));
+            registeredTools.push(serverArg.registerTool('send_message', {
+                title: 'Send message through harness server',
+                description: 'Send a message only through the harness web server bound to an explicit connection and wait for the reply. There is no CLI, process, local-store, discovery, or retry fallback.',
+                inputSchema: {
+                    connectionId: plugins.z.string().max(128).describe('Connection id returned by connect_harness'),
+                    chatId: plugins.z.string().min(1).max(1024),
+                    message: plugins.z.string().min(1).max(1024 * 1024),
+                    timeoutSeconds: plugins.z.number().int().min(1).max(3600).optional(),
+                },
+            }, async (args, extra) => this.wrapToolCall(async () => {
+                const result = await this.connections
+                    .get(args.connectionId)
+                    .sendMessage(args.chatId, args.message, args.timeoutSeconds ?? 300, extra.signal);
+                return `${result.reply}\n\n[crossharness transport: ${result.via}]`;
+            })));
+            registeredTools.push(serverArg.registerTool('send_message_async', {
+                title: 'Send message through harness server asynchronously',
+                description: 'Start a server-only send and return a dispatchId immediately. Both this connectionId and the dispatchId are required by check_reply.',
+                inputSchema: {
+                    connectionId: plugins.z.string().max(128).describe('Connection id returned by connect_harness'),
+                    chatId: plugins.z.string().min(1).max(1024),
+                    message: plugins.z.string().min(1).max(1024 * 1024),
+                    timeoutSeconds: plugins.z.number().int().min(1).max(3600).optional(),
+                },
+            }, async (args) => this.wrapToolCall(async () => {
+                const connection = this.connections.get(args.connectionId);
+                const record = this.dispatches.track(args.connectionId, connection.harness, args.chatId, () => connection.sendMessage(args.chatId, args.message, args.timeoutSeconds ?? 900));
+                return [
+                    `connectionId: ${record.connectionId}`,
+                    `dispatchId: ${record.dispatchId}`,
+                    `harness: ${record.harness}`,
+                    `chatId: ${record.chatId}`,
+                    `startedAt: ${record.startedAt}`,
+                ].join('\n');
+            })));
+            registeredTools.push(serverArg.registerTool('check_reply', {
+                title: 'Check async server send',
+                description: 'Check an asynchronous send. The connectionId must own the dispatch. Records remain inspectable after disconnect.',
+                inputSchema: {
+                    connectionId: plugins.z.string().max(128).describe('Connection id used for send_message_async'),
+                    dispatchId: plugins.z.string().max(128).describe('Dispatch id returned by send_message_async'),
+                    waitSeconds: plugins.z.number().int().min(0).max(60).optional(),
+                },
+            }, async (args, extra) => this.wrapToolCall(async () => {
+                const record = await this.dispatches.waitFor(args.connectionId, args.dispatchId, (args.waitSeconds ?? 0) * 1000, extra.signal);
+                if (!record)
+                    throw new Error('unknown dispatchId for this connectionId');
+                const header = [
+                    `connectionId: ${record.connectionId}`,
+                    `dispatchId: ${record.dispatchId}`,
+                    `status: ${record.status}`,
+                    `harness: ${record.harness}`,
+                    `chatId: ${record.chatId}`,
+                    `startedAt: ${record.startedAt}`,
+                    ...(record.completedAt ? [`completedAt: ${record.completedAt}`] : []),
+                ].join('\n');
+                if (record.status === 'working')
+                    return `${header}\n\nStill working.`;
+                if (record.status === 'failed')
+                    return `${header}\n\nError: ${record.error}`;
+                return `${header}\n\n${record.reply}\n\n[crossharness transport: ${record.via}]`;
+            })));
+        }
+        catch (errorArg) {
+            for (const registeredTool of registeredTools.reverse())
+                registeredTool.remove();
+            throw errorArg;
+        }
+        this.registeredTools = registeredTools;
+        this.registeredServer = serverArg;
+        this.registered = true;
+    }
+    /** Close the externally owned MCP server before closing this registrar. */
+    async close() {
+        if (this.closePromise)
+            return this.closePromise;
+        if (this.registeredServer?.isConnected()) {
+            throw new Error('Crossharness MCP tool registrar cannot close while its MCP server is connected; close the shared MCP server first');
+        }
+        this.closeStarted = true;
+        this.removeRegisteredTools();
+        this.registeredServer = undefined;
+        this.closePromise = this.ensureResourceShutdown().finally(() => {
+            this.closePromise = undefined;
+        });
+        return this.closePromise;
+    }
+    removeRegisteredTools() {
+        for (const registeredTool of this.registeredTools.reverse())
+            registeredTool.remove();
+        this.registeredTools = [];
+    }
+    ensureResourceShutdown() {
+        if (this.resourceShutdownPromise)
+            return this.resourceShutdownPromise;
+        let shutdownPromise;
+        shutdownPromise = this.connections.closeAll().finally(() => {
+            this.dispatches.dispose();
+        }).catch((errorArg) => {
+            if (this.resourceShutdownPromise === shutdownPromise) {
+                this.resourceShutdownPromise = undefined;
+            }
+            throw errorArg;
+        });
+        this.resourceShutdownPromise = shutdownPromise;
+        return shutdownPromise;
+    }
+    describeConnection(infoArg) {
+        return [
+            `connectionId: ${infoArg.connectionId}`,
+            `harness: ${infoArg.harness}`,
+            `serverUrl: ${infoArg.serverUrl}`,
+            `directory: ${infoArg.directory}`,
+            `state: ${infoArg.state}`,
+            `connectedAt: ${infoArg.connectedAt}`,
+            ...(infoArg.serverVersion ? [`serverVersion: ${infoArg.serverVersion}`] : []),
+        ].join('\n');
+    }
+    async wrapToolCall(handlerArg) {
+        try {
+            const text = await handlerArg();
+            return { content: [{ type: 'text', text: text.slice(0, 100000) }] };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`.slice(0, 100000),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5tY3B0b29scmVnaXN0cmFyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xhc3Nlcy5tY3B0b29scmVnaXN0cmFyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBRXhDLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ3JFLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBRWpFLE1BQU0saUJBQWlCLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxZQUFZLEVBQUUsVUFBVSxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUM7QUFFOUU7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLDRCQUE0QjtJQUN2QixXQUFXLENBQXFCO0lBQ2hDLFVBQVUsQ0FBbUI7SUFDckMsZUFBZSxHQUE2QixFQUFFLENBQUM7SUFDL0MsZ0JBQWdCLENBQXFEO0lBQ3JFLFVBQVUsR0FBRyxLQUFLLENBQUM7SUFDbkIsWUFBWSxHQUFHLEtBQUssQ0FBQztJQUNyQixZQUFZLENBQTRCO0lBQ3hDLHVCQUF1QixDQUE0QjtJQUUzRCxZQUFZLGNBQWMsR0FBRyxJQUFJLGtCQUFrQixFQUFFLEVBQUUsYUFBYSxHQUFHLElBQUksZ0JBQWdCLEVBQUU7UUFDM0YsSUFBSSxDQUFDLFdBQVcsR0FBRyxjQUFjLENBQUM7UUFDbEMsSUFBSSxDQUFDLFVBQVUsR0FBRyxhQUFhLENBQUM7SUFDbEMsQ0FBQztJQUVELGlGQUFpRjtJQUMxRSxRQUFRLENBQUMsU0FBaUQ7UUFDL0QsSUFBSSxJQUFJLENBQUMsWUFBWSxFQUFFLENBQUM7WUFDdEIsTUFBTSxJQUFJLEtBQUssQ0FBQywyQ0FBMkMsQ0FBQyxDQUFDO1FBQy9ELENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztZQUNwQixNQUFNLElBQUksS0FBSyxDQUFD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

package/dist_ts/index.d.ts

@@ -1,5 +1,7 @@
 export * from './interfaces.js';
+export * from './classes.codexappserverclient.js';
 export * from './classes.connectionregistry.js';
 export * from './classes.dispatchregistry.js';
+export * from './classes.mcptoolregistrar.js';
 export * from './classes.mcpserver.js';
 export declare const runCli: () => Promise<void>;

package/dist_ts/index.js

@@ -1,9 +1,11 @@
 export * from './interfaces.js';
+export * from './classes.codexappserverclient.js';
 export * from './classes.connectionregistry.js';
 export * from './classes.dispatchregistry.js';
+export * from './classes.mcptoolregistrar.js';
 export * from './classes.mcpserver.js';
 import { CrossHarnessMcpServer } from './classes.mcpserver.js';
 export const runCli = async () => {
     await new CrossHarnessMcpServer().start();
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYywrQkFBK0IsQ0FBQztBQUM5QyxjQUFjLHdCQUF3QixDQUFDO0FBRXZDLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBRS9ELE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxLQUFLLElBQW1CLEVBQUU7SUFDOUMsTUFBTSxJQUFJLHFCQUFxQixFQUFFLENBQUMsS0FBSyxFQUFFLENBQUM7QUFDNUMsQ0FBQyxDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsbUNBQW1DLENBQUM7QUFDbEQsY0FBYyxpQ0FBaUMsQ0FBQztBQUNoRCxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsK0JBQStCLENBQUM7QUFDOUMsY0FBYyx3QkFBd0IsQ0FBQztBQUV2QyxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUUvRCxNQUFNLENBQUMsTUFBTSxNQUFNLEdBQUcsS0FBSyxJQUFtQixFQUFFO0lBQzlDLE1BQU0sSUFBSSxxQkFBcUIsRUFBRSxDQUFDLEtBQUssRUFBRSxDQUFDO0FBQzVDLENBQUMsQ0FBQyJ9

package/dist_ts/plugins.d.ts

@@ -5,6 +5,7 @@ import type { AddressInfo } from 'node:net';
 export { crypto, http, stream };
 export type { AddressInfo };
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { Client as McpClient } from '@modelcontextprotocol/sdk/client/index.js';
 import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
@@ -14,4 +15,5 @@ import type { RawData } from 'ws';
 import { z } from 'zod';
 export { InMemoryTransport, McpClient, McpServer, StdioServerTransport, WebSocketServer, WsWebSocket, z, };
 export type { RawData };
+export type { RegisteredTool };
 export type { Transport };

package/dist_ts/plugins.js

@@ -11,4 +11,4 @@ import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';
 import { WebSocket as WsWebSocket, WebSocketServer } from 'ws';
 import { z } from 'zod';
 export { InMemoryTransport, McpClient, McpServer, StdioServerTransport, WebSocketServer, WsWebSocket, z, };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsc0JBQXNCO0FBQ3RCLE9BQU8sS0FBSyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ3RDLE9BQU8sS0FBSyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBQ2xDLE9BQU8sS0FBSyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBR3RDLE9BQU8sRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxDQUFDO0FBR2hDLHNCQUFzQjtBQUN0QixPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0seUNBQXlDLENBQUM7QUFDcEUsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sMkNBQTJDLENBQUM7QUFDakYsT0FBTyxFQUFFLE1BQU0sSUFBSSxTQUFTLEVBQUUsTUFBTSwyQ0FBMkMsQ0FBQztBQUNoRixPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUUxRSxPQUFPLEVBQUUsU0FBUyxJQUFJLFdBQVcsRUFBRSxlQUFlLEVBQUUsTUFBTSxJQUFJLENBQUM7QUFFL0QsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQ0wsaUJBQWlCLEVBQ2pCLFNBQVMsRUFDVCxTQUFTLEVBQ1Qsb0JBQW9CLEVBQ3BCLGVBQWUsRUFDZixXQUFXLEVBQ1gsQ0FBQyxHQUNGLENBQUMifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsc0JBQXNCO0FBQ3RCLE9BQU8sS0FBSyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBQ3RDLE9BQU8sS0FBSyxJQUFJLE1BQU0sV0FBVyxDQUFDO0FBQ2xDLE9BQU8sS0FBSyxNQUFNLE1BQU0sYUFBYSxDQUFDO0FBR3RDLE9BQU8sRUFBRSxNQUFNLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxDQUFDO0FBR2hDLHNCQUFzQjtBQUN0QixPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0seUNBQXlDLENBQUM7QUFFcEUsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sMkNBQTJDLENBQUM7QUFDakYsT0FBTyxFQUFFLE1BQU0sSUFBSSxTQUFTLEVBQUUsTUFBTSwyQ0FBMkMsQ0FBQztBQUNoRixPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx1Q0FBdUMsQ0FBQztBQUUxRSxPQUFPLEVBQUUsU0FBUyxJQUFJLFdBQVcsRUFBRSxlQUFlLEVBQUUsTUFBTSxJQUFJLENBQUM7QUFFL0QsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQ0wsaUJBQWlCLEVBQ2pCLFNBQVMsRUFDVCxTQUFTLEVBQ1Qsb0JBQW9CLEVBQ3BCLGVBQWUsRUFDZixXQUFXLEVBQ1gsQ0FBQyxHQUNGLENBQUMifQ==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelprofile.com/mcp-crossharness",
-  "version": "5.0.0",
+  "version": "5.2.0",
   "private": false,
   "description": "Connection-first MCP server for explicit OpenCode HTTP and Codex WebSocket session servers",
   "main": "dist_ts/index.js",
@@ -26,7 +26,7 @@
     "@git.zone/tsbuild": "^4.4.2",
     "@git.zone/tsrun": "^2.0.6",
     "@git.zone/tstest": "^4.0.0",
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.4.1",
     "@types/ws": "^8.18.1"
   },
   "dependencies": {

package/readme.md

@@ -8,7 +8,7 @@ For reporting bugs, issues, or security vulnerabilities, please visit [community
 
 ## Transport Contract
 
-Crossharness only talks to explicitly connected harness web servers:
+Crossharness MCP tools only talk to explicitly connected harness web servers:
 
 | Harness | Server transport | Support |
 | --- | --- | --- |
@@ -140,13 +140,119 @@ Register the `mcp-crossharness` binary as a stdio MCP server in your client.
 
 ## Library API
 
+### Native Codex app-server client
+
+`CodexAppServerClient` exposes the underlying app-server protocol independently of the MCP
+chat tools. It accepts an explicit WebSocket endpoint or caller-owned JSONL stdio streams;
+it never discovers or spawns a server. The embedding application owns process lifecycle,
+session authorization, history projection, and human approval policy.
+
+```typescript
+import { CodexAppServerClient } from '@modelprofile.com/mcp-crossharness';
+
+const client = new CodexAppServerClient({
+  transport: { type: 'stdio', readable: child.stdout, writable: child.stdin },
+  clientInfo: { name: 'my-app', title: 'My App', version: '1.0.0' },
+  experimentalApi: true,
+  onNotification: ({ method, params }) => handleNotification(method, params),
+  onServerRequest: (request) => showApproval(request),
+  onClose: (error) => handleDisconnected(error),
+});
+await client.connect();
+const models = await client.request('model/list', {});
+// After a human decision, use the exact connection-scoped request ID:
+client.respond(requestId, { decision: 'accept' });
+client.close();
+```
+
+For WebSocket transport use `{ type: 'websocket', url: approvedServerUrl, token: bearerToken }`.
+The caller must authorize the destination before supplying credentials. The client follows no
+redirects and reads no credential environment variables. MCP tools retain their existing
+allowlist and credential policy.
+
+`request(method, params, timeoutMs?, signal?)` returns the protocol result as `unknown` for
+validation by the caller. It performs no retries. A `CodexAppServerRequestError` exposes
+`dispatched` and an optional server error `code`; a timeout or disconnect after dispatch
+does not prove a mutation failed. Never replay an uncertain `thread/start` or `turn/start`.
+The client handles initialize/initialized, response correlation, bounded framing, and close
+cleanup. The default inbound frame limit is 4 MiB; `maxMessageBytes` accepts 1 KiB–64 MiB.
+Outgoing buffers are capped at 4 MiB and pending requests at 256 in each direction.
+
+Server request handlers return immediately so notifications continue during human input.
+Each request carries an `AbortSignal`, aborted when it is answered, resolved by the server,
+or disconnected. `respond(id, result)` and `rejectRequest(id, code, message)` return false
+for an expired ID. Unhandled server requests receive method-not-supported; this low-level
+client never grants or automatically declines a permission. `close()` ends the supplied
+stdio streams but never kills a subprocess. The existing MCP Codex adapter delegates to
+this client and retains its conservative automatic rejection policy.
+
+### Composable tool registration
+
+`CrossHarnessMcpToolRegistrar` registers the same nine Crossharness tools used by the standalone
+server on an MCP SDK 1.30 `McpServer` owned by an embedding application:
+
 ```typescript
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import {
   ConnectionRegistry,
-  DispatchRegistry,
-  CrossHarnessMcpServer,
+  CrossHarnessMcpToolRegistrar,
 } from '@modelprofile.com/mcp-crossharness';
 
+const connections = new ConnectionRegistry({
+  allowedServerUrls: ['http://127.0.0.1:4096/'],
+  openCodeCredentials: {
+    serverUrl: 'http://127.0.0.1:4096/',
+    username: 'opencode',
+    password: controllerOwnedPassword,
+  },
+});
+const crossHarnessTools = new CrossHarnessMcpToolRegistrar(connections);
+const sharedServer = new McpServer({ name: 'controller', version: '1.0.0' });
+
+crossHarnessTools.register(sharedServer);
+await sharedServer.connect(hostOwnedTransport);
+
+// During host shutdown, close the shared server before its Crossharness registrar.
+await sharedServer.close();
+await crossHarnessTools.close();
+```
+
+The registrar takes lifecycle ownership of injected `ConnectionRegistry` and `DispatchRegistry`
+instances. Call `register()` before connecting the shared server. A successful registrar can
+register only once.
+
+Composition supports an ordinary high-level `McpServer` tool surface, including host tools added
+with `McpServer.registerTool()`. A duplicate high-level tool name throws and transactionally removes
+the Crossharness tools added by that attempt without replacing the host's tool.
+
+Do not preinstall custom low-level `tools/list` or `tools/call` handlers with
+`sharedServer.server.setRequestHandler()`. SDK 1.30 adds the first high-level tool to its internal
+map before discovering that low-level handler conflict and throwing, without returning a
+`RegisteredTool` handle. The registrar cannot transactionally roll back that SDK mutation. Use the
+ordinary high-level `McpServer.registerTool()` surface or a separate `McpServer` instead.
+
+`close()` removes the registrar's tool registrations, closes every owned connection, and disposes
+its dispatch registry. If the registered server is still connected, `close()` fails before
+removing tools or mutating either registry. Close the shared server first, then call registrar
+`close()`; failed connection cleanup remains retryable by calling it again. The registrar never
+connects or closes the shared `McpServer`, never owns its transport, and installs no stdin,
+process-signal, or shared-server close listeners.
+
+`CrossHarnessMcpServer` is the standalone stdio lifecycle wrapper. It creates this exact registrar,
+keeps the existing one-shot `start()` contract, and owns only its own MCP server, transport, and
+stdin close handling in addition to delegating tool-resource cleanup to the registrar. It closes
+the server before the registrar, retains the same server and transport when transport close fails,
+and retries them on the next `close()`. Concurrent transport and registrar cleanup failures are
+reported together as an `AggregateError`.
+
+### Direct registry use
+
+The registries remain public for applications that need the connection API without MCP tool
+registration:
+
+```typescript
+import { ConnectionRegistry } from '@modelprofile.com/mcp-crossharness';
+
 const connections = new ConnectionRegistry({
   allowedServerUrls: ['http://127.0.0.1:4096/'],
   openCodeCredentials: {

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@modelprofile.com/mcp-crossharness',
-  version: '5.0.0',
+  version: '5.2.0',
   description: 'Connection-first MCP server for explicit OpenCode HTTP and Codex WebSocket session servers'
 }