@cyanheads/mcp-ts-core 0.13.10 → 0.13.12

package/dist/testing/apps/index.d.ts.map

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

package/dist/testing/apps/index.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Headless MCP Apps host. `renderAppTool` connects to a server as a client
+ * advertising `io.modelcontextprotocol/ui`, calls a tool, loads its `ui://` resource into
+ * headless `chrome-headless-shell` inside the double-iframe sandbox and CSP the MCP Apps
+ * specification prescribes, plays the host half of the protocol through the official
+ * `AppBridge`, runs scripted steps against the view, and returns a report.
+ *
+ * Import from `@cyanheads/mcp-ts-core/testing/apps`. The optional peers
+ * `@modelcontextprotocol/client` and `@modelcontextprotocol/ext-apps` are loaded on first
+ * use; importing this subpath without them succeeds.
+ *
+ * @example
+ * ```ts
+ * import { renderAppTool } from '@cyanheads/mcp-ts-core/testing/apps';
+ *
+ * const run = await renderAppTool({
+ *   server: { command: 'bun', args: ['run', 'dist/index.js'] },
+ *   tool: 'my_app_tool',
+ *   arguments: { query: 'probe' },
+ *   steps: [{ click: '#action-btn' }, { screenshot: 'after-click' }],
+ * });
+ * ```
+ * @module src/testing/apps
+ */
+/**
+ * Render an app tool's view in a headless MCP Apps host and report what happened.
+ * Resolves with the report whenever the run reached the browser, even when the view
+ * failed. Throws only on setup failures: a missing optional peer, no browser, the server
+ * unreachable, the tool missing, or its UI resource absent, unreadable, or declaring a
+ * `_meta.ui.csp` entry that is not a plain origin.
+ */
+export async function renderAppTool(options) {
+    const { runAppRender } = await import('./run.js');
+    return runAppRender(options);
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/apps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/apps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAmIH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAA6B;IAC/D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/testing/apps/partial-json.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Growing prefixes of a tool's argument JSON for `ui/notifications/tool-input-partial`
+ * streaming. Each prefix of the serialized arguments is closed into a valid JSON object:
+ * an open string is terminated, open containers are closed, and a trailing token that
+ * cannot be completed (a dangling key, a partial literal) is backed off.
+ * @module src/testing/apps/partial-json
+ */
+/**
+ * Partial argument objects for growing prefixes of `JSON.stringify(args)`, in order. Every
+ * entry is a plain object; consecutive duplicates are dropped and the complete arguments
+ * are never included (those go out as `tool-input`).
+ */
+export declare function partialArguments(args: Record<string, unknown>): Record<string, unknown>[];
+//# sourceMappingURL=partial-json.d.ts.map

package/dist/testing/apps/partial-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial-json.d.ts","sourceRoot":"","sources":["../../../src/testing/apps/partial-json.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAazF"}

package/dist/testing/apps/partial-json.js

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Growing prefixes of a tool's argument JSON for `ui/notifications/tool-input-partial`
+ * streaming. Each prefix of the serialized arguments is closed into a valid JSON object:
+ * an open string is terminated, open containers are closed, and a trailing token that
+ * cannot be completed (a dangling key, a partial literal) is backed off.
+ * @module src/testing/apps/partial-json
+ */
+/** At most this many partials are produced for one argument object. */
+const MAX_PARTIALS = 8;
+/**
+ * Partial argument objects for growing prefixes of `JSON.stringify(args)`, in order. Every
+ * entry is a plain object; consecutive duplicates are dropped and the complete arguments
+ * are never included (those go out as `tool-input`).
+ */
+export function partialArguments(args) {
+    const json = JSON.stringify(args);
+    const count = Math.min(MAX_PARTIALS, json.length - 1);
+    const partials = [];
+    let previous = '';
+    for (let i = 1; i <= count; i++) {
+        const cut = Math.max(1, Math.floor((json.length * i) / (count + 1)));
+        const closed = closePrefix(json.slice(0, cut));
+        if (closed === undefined || closed === previous || closed === json)
+            continue;
+        previous = closed;
+        partials.push(JSON.parse(closed));
+    }
+    return partials;
+}
+/** The longest closing of `prefix` (backing off one character at a time) that parses as an object. */
+function closePrefix(prefix) {
+    for (let end = prefix.length; end > 0; end--) {
+        const candidate = close(prefix.slice(0, end));
+        try {
+            const value = JSON.parse(candidate);
+            if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                return JSON.stringify(value);
+            }
+        }
+        catch {
+            // Not closable at this length; back off.
+        }
+    }
+    return undefined;
+}
+/** `text` with its open string and open containers closed. */
+function close(text) {
+    const closers = [];
+    let inString = false;
+    let escaped = false;
+    for (const ch of text) {
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (ch === '\\')
+                escaped = true;
+            else if (ch === '"')
+                inString = false;
+        }
+        else if (ch === '"')
+            inString = true;
+        else if (ch === '{')
+            closers.push('}');
+        else if (ch === '[')
+            closers.push(']');
+        else if (ch === '}' || ch === ']')
+            closers.pop();
+    }
+    return `${text}${inString ? '"' : ''}${closers.reverse().join('')}`;
+}
+//# sourceMappingURL=partial-json.js.map

package/dist/testing/apps/partial-json.js.map

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

package/dist/testing/apps/run.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview One headless MCP Apps host run, loaded on demand by `renderAppTool`.
+ * Node holds the MCP client and the official `AppBridge`; the bridge's transport relays
+ * JSON-RPC through the host page's isolated-world relay into the sandbox proxy and the
+ * view. CDP supplies the instrumentation: exceptions and console errors from
+ * `Runtime`, CSP violations from `Audits` issues, frames from `Page`. The optional peers
+ * are imported here, inside the run, never at module load.
+ * @module src/testing/apps/run
+ */
+import type { AppRenderReport, RenderAppToolOptions } from './index.js';
+/** Run one render. See `renderAppTool`. */
+export declare function runAppRender(options: RenderAppToolOptions): Promise<AppRenderReport>;
+//# sourceMappingURL=run.d.ts.map

package/dist/testing/apps/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/testing/apps/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2CH,OAAO,KAAK,EAGV,eAAe,EAIf,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAsBpB,2CAA2C;AAC3C,wBAAsB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6F1F"}