@atelierai/uco 1.0.0

package/dist/server/stub-client/index.js

@@ -0,0 +1,275 @@
+/**
+ * Stub-plugin client — connects to the WS hub and responds to all 14 client-facing
+ * methods with canned/realistic data. Used to validate the JSON envelope contract
+ * end-to-end before the C# plugin rewrite (child 2).
+ *
+ * Can also send the 7 server-facing methods to the server (see scenarios.ts).
+ */
+import WebSocket from 'ws';
+import { parseMessage, makeResponse, makeRequest, serializeMessage, isRequest, isNotification, } from '../ws/envelope.js';
+import { ClientFacingMethod as Methods } from '../types.js';
+/** Default canned data returned by the stub client. */
+export const DEFAULT_STUB_DATA = {
+    tools: [
+        {
+            name: 'ping',
+            title: 'Ping',
+            description: 'Returns pong',
+            enabled: true,
+            inputSchema: { type: 'object', properties: {} },
+        },
+        {
+            name: 'echo',
+            title: 'Echo',
+            description: 'Echoes the input arguments',
+            enabled: true,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    message: { type: 'string', description: 'Message to echo' },
+                },
+            },
+        },
+    ],
+    prompts: [
+        {
+            name: 'greeting',
+            title: 'Greeting',
+            description: 'A greeting prompt',
+            enabled: true,
+            arguments: [{ name: 'name', description: 'Name to greet', required: true }],
+        },
+    ],
+    resources: [
+        {
+            uri: 'config://app/settings',
+            name: 'App Settings',
+            enabled: true,
+            mimeType: 'application/json',
+            description: 'Application settings',
+        },
+    ],
+    resourceTemplates: [
+        {
+            uriTemplate: 'file:///{path}',
+            name: 'File',
+            enabled: true,
+            mimeType: 'text/plain',
+            description: 'Read a file by path',
+        },
+    ],
+};
+export class StubPluginClient {
+    ws = null;
+    nextId = 0;
+    options;
+    data;
+    notifications = [];
+    constructor(options, data = DEFAULT_STUB_DATA) {
+        this.options = options;
+        this.data = data;
+    }
+    /** Connect to the WebSocket hub. Returns a promise that resolves on open. */
+    connect() {
+        return new Promise((resolve, reject) => {
+            const urlObj = new URL(this.options.url);
+            if (this.options.token) {
+                urlObj.searchParams.set('access_token', this.options.token);
+            }
+            if (this.options.instanceId) {
+                urlObj.searchParams.set('instanceId', this.options.instanceId);
+            }
+            this.ws = new WebSocket(urlObj.toString());
+            this.ws.on('open', () => resolve());
+            this.ws.on('error', (err) => reject(err));
+            this.ws.on('message', (raw) => {
+                const text = Buffer.isBuffer(raw) ? raw.toString('utf8') : Buffer.concat(raw).toString('utf8');
+                this.handleMessage(text);
+            });
+            this.ws.on('close', () => {
+                // Connection closed.
+            });
+        });
+    }
+    /** Disconnect from the hub. */
+    disconnect() {
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+    }
+    /** Whether the client is connected. */
+    get isConnected() {
+        return this.ws?.readyState === WebSocket.OPEN;
+    }
+    /**
+     * Send a server-facing request and await the response.
+     * Used by scenarios.ts to exercise the 7 server-facing methods.
+     */
+    sendServerRequest(method, params) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+                reject(new Error('Not connected'));
+                return;
+            }
+            const id = `stub-${++this.nextId}`;
+            const req = makeRequest(id, method, params);
+            const handler = (raw) => {
+                const text = Buffer.isBuffer(raw) ? raw.toString('utf8') : Buffer.concat(raw).toString('utf8');
+                const parsed = parseMessage(text);
+                if (parsed.ok && 'id' in parsed.message && parsed.message.id === id && ('result' in parsed.message || 'error' in parsed.message)) {
+                    this.ws.off('message', handler);
+                    const resp = parsed.message;
+                    if (resp.error) {
+                        reject(new Error(resp.error.message));
+                    }
+                    else {
+                        resolve(resp.result);
+                    }
+                }
+            };
+            this.ws.on('message', handler);
+            this.ws.send(serializeMessage(req));
+            // Timeout after 10s.
+            setTimeout(() => {
+                this.ws?.off('message', handler);
+                reject(new Error(`Timeout waiting for response to ${method}`));
+            }, 10_000);
+        });
+    }
+    // ===== Message handling =====
+    handleMessage(text) {
+        const parsed = parseMessage(text);
+        if (!parsed.ok)
+            return; // Ignore unparseable messages.
+        const msg = parsed.message;
+        if (isRequest(msg)) {
+            this.handleRequest(msg);
+            return;
+        }
+        if (isNotification(msg)) {
+            this.notifications.push({ method: msg.method, params: msg.params });
+            // Notifications are handled silently (no response).
+            return;
+        }
+    }
+    handleRequest(req) {
+        const respond = (result) => {
+            const delay = this.options.responseDelayMs ?? 0;
+            setTimeout(() => {
+                if (this.ws?.readyState === WebSocket.OPEN) {
+                    this.ws.send(serializeMessage(makeResponse(req.id, result)));
+                }
+            }, delay);
+        };
+        switch (req.method) {
+            case Methods.RunListTool:
+                respond(this.makeListToolResponse(req.params));
+                break;
+            case Methods.RunCallTool:
+                respond(this.makeCallToolResponse(req.params));
+                break;
+            case Methods.RunGetPrompt:
+                respond(this.makeGetPromptResponse(req.params));
+                break;
+            case Methods.RunListPrompts:
+                respond(this.makeListPromptsResponse(req.params));
+                break;
+            case Methods.RunResourceContent:
+                respond(this.makeResourceContentResponse(req.params));
+                break;
+            case Methods.RunListResources:
+                respond(this.makeListResourcesResponse(req.params));
+                break;
+            case Methods.RunResourceTemplates:
+                respond(this.makeResourceTemplatesResponse(req.params));
+                break;
+            case Methods.RunSystemTool:
+                respond(this.makeCallToolResponse(req.params));
+                break;
+            case Methods.RunListSystemTool:
+                respond(this.makeListToolResponse(req.params));
+                break;
+            default:
+                // Unknown method — respond with empty success.
+                respond({ status: 'success' });
+                break;
+        }
+    }
+    // ===== Canned response builders =====
+    makeListToolResponse(params) {
+        const p = (params ?? {});
+        return {
+            requestID: p.requestID ?? '',
+            status: 'success',
+            value: this.data.tools,
+        };
+    }
+    makeCallToolResponse(params) {
+        const p = (params ?? {});
+        const name = p.name ?? '';
+        const content = [
+            { type: 'text', text: `Stub result for tool '${name}' with args: ${JSON.stringify(p.arguments ?? {})}` },
+        ];
+        return {
+            requestID: p.requestID ?? '',
+            status: 'success',
+            value: {
+                content,
+                structuredContent: { result: `pong from ${name}` },
+            },
+        };
+    }
+    makeGetPromptResponse(params) {
+        const p = (params ?? {});
+        return {
+            requestID: p.requestID ?? '',
+            status: 'success',
+            value: {
+                description: `Stub prompt '${p.name ?? ''}'`,
+                messages: [
+                    { role: 'user', content: `Hello from stub prompt ${p.name ?? ''}!` },
+                ],
+            },
+        };
+    }
+    makeListPromptsResponse(params) {
+        const p = (params ?? {});
+        return {
+            requestID: p.requestID ?? '',
+            status: 'success',
+            value: { prompts: this.data.prompts },
+        };
+    }
+    makeResourceContentResponse(params) {
+        const p = (params ?? {});
+        return {
+            requestID: p.requestID ?? '',
+            status: 'success',
+            value: [
+                {
+                    uri: p.uri ?? '',
+                    mimeType: 'text/plain',
+                    text: `Stub content for resource '${p.uri ?? ''}'`,
+                },
+            ],
+        };
+    }
+    makeListResourcesResponse(params) {
+        const p = (params ?? {});
+        return {
+            requestID: p.requestID ?? '',
+            status: 'success',
+            value: this.data.resources,
+        };
+    }
+    makeResourceTemplatesResponse(params) {
+        const p = (params ?? {});
+        return {
+            requestID: p.requestID ?? '',
+            status: 'success',
+            value: this.data.resourceTemplates,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/server/stub-client/index.js.map

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

package/dist/server/stub-client/scenarios.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Test scenarios for the stub-plugin client.
+ *
+ * Exercises all 7 server-facing methods (plugin→server) and verifies the
+ * server responds correctly to each. Also verifies the 9 client-facing
+ * request-response methods work via REST round-trip.
+ */
+import type { StubPluginClient } from './index.js';
+export interface ScenarioResult {
+    name: string;
+    passed: boolean;
+    message?: string;
+}
+/**
+ * Run all 7 server-facing method scenarios.
+ * The stub client must already be connected.
+ */
+export declare function runServerFacingScenarios(client: StubPluginClient): Promise<ScenarioResult[]>;
+/**
+ * Run a full test report connecting to a server at the given URL.
+ * Prints pass/fail for each scenario and returns the aggregate result.
+ */
+export declare function runFullTestReport(url: string, token?: string): Promise<boolean>;

package/dist/server/stub-client/scenarios.js

@@ -0,0 +1,150 @@
+/**
+ * Test scenarios for the stub-plugin client.
+ *
+ * Exercises all 7 server-facing methods (plugin→server) and verifies the
+ * server responds correctly to each. Also verifies the 9 client-facing
+ * request-response methods work via REST round-trip.
+ */
+import { ServerFacingMethod } from '../types.js';
+/**
+ * Run all 7 server-facing method scenarios.
+ * The stub client must already be connected.
+ */
+export async function runServerFacingScenarios(client) {
+    const results = [];
+    // 1. PerformVersionHandshake
+    try {
+        const result = await client.sendServerRequest(ServerFacingMethod.PerformVersionHandshake, {
+            pluginVersion: '1.0.0-stub',
+            apiVersion: '1.0',
+            environment: { unity: '2022.3' },
+        });
+        results.push({
+            name: 'PerformVersionHandshake',
+            passed: typeof result?.compatible === 'boolean' && typeof result?.apiVersion === 'string',
+            message: `compatible=${result?.compatible}, apiVersion=${result?.apiVersion}`,
+        });
+    }
+    catch (err) {
+        results.push({ name: 'PerformVersionHandshake', passed: false, message: String(err) });
+    }
+    // 2. GetMcpClientData
+    try {
+        const result = await client.sendServerRequest(ServerFacingMethod.GetMcpClientData);
+        results.push({
+            name: 'GetMcpClientData',
+            passed: Array.isArray(result),
+            message: `count=${result?.length ?? 0}`,
+        });
+    }
+    catch (err) {
+        results.push({ name: 'GetMcpClientData', passed: false, message: String(err) });
+    }
+    // 3. GetMcpServerData
+    try {
+        const result = await client.sendServerRequest(ServerFacingMethod.GetMcpServerData);
+        results.push({
+            name: 'GetMcpServerData',
+            passed: typeof result?.serverVersion === 'string',
+            message: `serverVersion=${result?.serverVersion}, isAiAgentConnected=${result?.isAiAgentConnected}`,
+        });
+    }
+    catch (err) {
+        results.push({ name: 'GetMcpServerData', passed: false, message: String(err) });
+    }
+    // 4. NotifyAboutUpdatedTools
+    try {
+        const result = await client.sendServerRequest(ServerFacingMethod.NotifyAboutUpdatedTools, {
+            requestId: 'scenario-tools',
+            tools: [{ name: 'stub-tool', enabled: true }],
+        });
+        results.push({
+            name: 'NotifyAboutUpdatedTools',
+            passed: result?.status === 'success',
+            message: `status=${result?.status}`,
+        });
+    }
+    catch (err) {
+        results.push({ name: 'NotifyAboutUpdatedTools', passed: false, message: String(err) });
+    }
+    // 5. NotifyAboutUpdatedPrompts
+    try {
+        const result = await client.sendServerRequest(ServerFacingMethod.NotifyAboutUpdatedPrompts, {
+            requestId: 'scenario-prompts',
+            prompts: { prompts: [{ name: 'stub-prompt', enabled: true }] },
+        });
+        results.push({
+            name: 'NotifyAboutUpdatedPrompts',
+            passed: result?.status === 'success',
+            message: `status=${result?.status}`,
+        });
+    }
+    catch (err) {
+        results.push({ name: 'NotifyAboutUpdatedPrompts', passed: false, message: String(err) });
+    }
+    // 6. NotifyAboutUpdatedResources
+    try {
+        const result = await client.sendServerRequest(ServerFacingMethod.NotifyAboutUpdatedResources, {
+            requestId: 'scenario-resources',
+            resources: [{ uri: 'stub://resource', name: 'Stub', enabled: true }],
+        });
+        results.push({
+            name: 'NotifyAboutUpdatedResources',
+            passed: result?.status === 'success',
+            message: `status=${result?.status}`,
+        });
+    }
+    catch (err) {
+        results.push({ name: 'NotifyAboutUpdatedResources', passed: false, message: String(err) });
+    }
+    // 7. NotifyToolRequestCompleted
+    try {
+        const result = await client.sendServerRequest(ServerFacingMethod.NotifyToolRequestCompleted, {
+            requestId: 'scenario-completed',
+            result: {
+                content: [{ type: 'text', text: 'completed via deferred path' }],
+            },
+        });
+        results.push({
+            name: 'NotifyToolRequestCompleted',
+            passed: result?.status === 'success',
+            message: `status=${result?.status}`,
+        });
+    }
+    catch (err) {
+        results.push({ name: 'NotifyToolRequestCompleted', passed: false, message: String(err) });
+    }
+    return results;
+}
+/**
+ * Run a full test report connecting to a server at the given URL.
+ * Prints pass/fail for each scenario and returns the aggregate result.
+ */
+export async function runFullTestReport(url, token) {
+    const { StubPluginClient } = await import('./index.js');
+    const client = new StubPluginClient({ url, token });
+    console.log(`Connecting to ${url}...`);
+    try {
+        await client.connect();
+    }
+    catch (err) {
+        console.error(`Failed to connect: ${err instanceof Error ? err.message : err}`);
+        return false;
+    }
+    console.log('Connected.\n');
+    // Run server-facing scenarios.
+    console.log('=== Server-facing methods (plugin → server) ===');
+    const serverResults = await runServerFacingScenarios(client);
+    for (const r of serverResults) {
+        console.log(`  ${r.passed ? 'PASS' : 'FAIL'}  ${r.name}${r.message ? ' — ' + r.message : ''}`);
+    }
+    // Check notifications received (OnInitialClientData should arrive on connect).
+    console.log('\n=== Notifications received ===');
+    const initialData = client.notifications.find((n) => n.method === 'OnInitialClientData');
+    console.log(`  ${initialData ? 'PASS' : 'FAIL'}  OnInitialClientData received on connect`);
+    client.disconnect();
+    const allPassed = [...serverResults].every((r) => r.passed) && !!initialData;
+    console.log(`\n${allPassed ? 'ALL PASSED' : 'SOME FAILED'}`);
+    return allPassed;
+}
+//# sourceMappingURL=scenarios.js.map

package/dist/server/stub-client/scenarios.js.map

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