@agimon-ai/doompi-core 0.0.1-alpha.100

package/dist/src/web/services/sessionRegistry/index.mjs

@@ -0,0 +1,66 @@
+//#region src/web/services/sessionRegistry/index.ts
+/** Overrides the runtime directory the hub and its session servers share. */
+const REGISTRY_DIR_ENV = "DOOMPI_RUNTIME_DIR";
+/** The version a hub advertisement must carry to be read at all. */
+const HUB_ADVERTISEMENT_VERSION = 1;
+const DEFAULT_RUN_DIR_SEGMENT = ".doompi/run";
+const HUB_ADVERTISEMENT_FILE = "hub.json";
+/**
+* The single definition of where the session registry lives.
+*
+* The hub, the session server, and any package that spawns a session must land
+* on the same directory or a spawned session never appears in the rail. This
+* used to be copied into each of them; it lives here so there is one answer.
+*/
+function resolveRegistryDir(input) {
+	if (input.flagValue) return input.flagValue;
+	if (input.envValue) return input.envValue;
+	return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;
+}
+/** Where the hub publishes its local address, at the registry root. */
+function hubAdvertisementPath(registryDir) {
+	return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;
+}
+/**
+* Reads a hub advertisement's contents.
+*
+* Like the lineage sidecar, every failure collapses to "no hub advertised",
+* because a caller can do nothing different with a torn write than with a
+* missing file. The url is required to be a loopback http origin: this file is
+* a discovery hint for local processes, and honouring an arbitrary address out
+* of it would let anything that can write the registry directory redirect a
+* session-create call to a host of its choosing.
+*/
+function parseHubAdvertisement(raw) {
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		return;
+	}
+	if (typeof parsed !== "object" || parsed === null) return void 0;
+	const record = parsed;
+	if (record.version !== 1) return void 0;
+	if (typeof record.url !== "string" || !isLoopbackHttpUrl(record.url)) return void 0;
+	if (typeof record.pid !== "number" || !Number.isInteger(record.pid) || record.pid <= 0) return void 0;
+	return {
+		version: 1,
+		url: record.url,
+		pid: record.pid
+	};
+}
+/** Whether a url is plain http to this machine, which is all this file may name. */
+function isLoopbackHttpUrl(value) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		return false;
+	}
+	if (url.protocol !== "http:") return false;
+	return url.hostname === "127.0.0.1" || url.hostname === "localhost" || url.hostname === "[::1]" || url.hostname === "::1";
+}
+//#endregion
+export { HUB_ADVERTISEMENT_VERSION, REGISTRY_DIR_ENV, hubAdvertisementPath, parseHubAdvertisement, resolveRegistryDir };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/web/services/sessionRegistry/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/web/services/sessionRegistry/index.ts"],"sourcesContent":["import type { HubAdvertisement, RegistryDirInput } from '../../types/sessionRegistry';\n\n/** Overrides the runtime directory the hub and its session servers share. */\nexport const REGISTRY_DIR_ENV = 'DOOMPI_RUNTIME_DIR';\n\n/** The version a hub advertisement must carry to be read at all. */\nexport const HUB_ADVERTISEMENT_VERSION = 1;\n\nconst DEFAULT_RUN_DIR_SEGMENT = '.doompi/run';\nconst HUB_ADVERTISEMENT_FILE = 'hub.json';\n\n/**\n * The single definition of where the session registry lives.\n *\n * The hub, the session server, and any package that spawns a session must land\n * on the same directory or a spawned session never appears in the rail. This\n * used to be copied into each of them; it lives here so there is one answer.\n */\nexport function resolveRegistryDir(input: RegistryDirInput): string {\n  if (input.flagValue) return input.flagValue;\n  if (input.envValue) return input.envValue;\n  return `${input.homeDir}/${DEFAULT_RUN_DIR_SEGMENT}`;\n}\n\n/** Where the hub publishes its local address, at the registry root. */\nexport function hubAdvertisementPath(registryDir: string): string {\n  return `${registryDir}/${HUB_ADVERTISEMENT_FILE}`;\n}\n\n/**\n * Reads a hub advertisement's contents.\n *\n * Like the lineage sidecar, every failure collapses to \"no hub advertised\",\n * because a caller can do nothing different with a torn write than with a\n * missing file. The url is required to be a loopback http origin: this file is\n * a discovery hint for local processes, and honouring an arbitrary address out\n * of it would let anything that can write the registry directory redirect a\n * session-create call to a host of its choosing.\n */\nexport function parseHubAdvertisement(raw: string): HubAdvertisement | undefined {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    return undefined;\n  }\n  if (typeof parsed !== 'object' || parsed === null) return undefined;\n  const record = parsed as Partial<HubAdvertisement>;\n  if (record.version !== HUB_ADVERTISEMENT_VERSION) return undefined;\n  if (typeof record.url !== 'string' || !isLoopbackHttpUrl(record.url)) return undefined;\n  if (typeof record.pid !== 'number' || !Number.isInteger(record.pid) || record.pid <= 0) return undefined;\n  return { version: HUB_ADVERTISEMENT_VERSION, url: record.url, pid: record.pid };\n}\n\n/** Whether a url is plain http to this machine, which is all this file may name. */\nfunction isLoopbackHttpUrl(value: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'http:') return false;\n  return (\n    url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '[::1]' || url.hostname === '::1'\n  );\n}\n"],"mappings":";;AAGA,MAAa,mBAAmB;;AAGhC,MAAa,4BAA4B;AAEzC,MAAM,0BAA0B;AAChC,MAAM,yBAAyB;;;;;;;;AAS/B,SAAgB,mBAAmB,OAAiC;CAClE,IAAI,MAAM,WAAW,OAAO,MAAM;CAClC,IAAI,MAAM,UAAU,OAAO,MAAM;CACjC,OAAO,GAAG,MAAM,QAAQ,GAAG;AAC7B;;AAGA,SAAgB,qBAAqB,aAA6B;CAChE,OAAO,GAAG,YAAY,GAAG;AAC3B;;;;;;;;;;;AAYA,SAAgB,sBAAsB,KAA2C;CAC/E,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,MAAM,GAAG;CACzB,QAAQ;EACN;CACF;CACA,IAAI,OAAO,WAAW,YAAY,WAAW,MAAM,OAAO,KAAA;CAC1D,MAAM,SAAS;CACf,IAAI,OAAO,YAAA,GAAuC,OAAO,KAAA;CACzD,IAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,kBAAkB,OAAO,GAAG,GAAG,OAAO,KAAA;CAC7E,IAAI,OAAO,OAAO,QAAQ,YAAY,CAAC,OAAO,UAAU,OAAO,GAAG,KAAK,OAAO,OAAO,GAAG,OAAO,KAAA;CAC/F,OAAO;EAAE,SAAA;EAAoC,KAAK,OAAO;EAAK,KAAK,OAAO;CAAI;AAChF;;AAGA,SAAS,kBAAkB,OAAwB;CACjD,IAAI;CACJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK;CACrB,QAAQ;EACN,OAAO;CACT;CACA,IAAI,IAAI,aAAa,SAAS,OAAO;CACrC,OACE,IAAI,aAAa,eAAe,IAAI,aAAa,eAAe,IAAI,aAAa,WAAW,IAAI,aAAa;AAEjH"}

package/dist/src/web/services/testing/channels.cjs

@@ -0,0 +1,11 @@
+//#region src/web/services/testing/channels.ts
+function driveChannel(channel, sessionId, payload) {
+	const parsed = channel.parse(payload);
+	if (parsed === null) return { accepted: false };
+	channel.apply(sessionId, parsed);
+	return { accepted: true };
+}
+//#endregion
+exports.driveChannel = driveChannel;
+
+//# sourceMappingURL=channels.cjs.map

package/dist/src/web/services/testing/channels.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.cjs","names":[],"sources":["../../../../../src/web/services/testing/channels.ts"],"sourcesContent":["import type { SessionChannelContribution } from '../../types/webPlugin';\n\nexport interface ChannelDelivery {\n  accepted: boolean;\n}\n\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n"],"mappings":";AAMA,SAAgB,aACd,SACA,WACA,SACiB;CACjB,MAAM,SAAkB,QAAQ,MAAM,OAAO;CAC7C,IAAI,WAAW,MAAM,OAAO,EAAE,UAAU,MAAM;CAC9C,QAAQ,MAAM,WAAW,MAAM;CAC/B,OAAO,EAAE,UAAU,KAAK;AAC1B"}

package/dist/src/web/services/testing/channels.d.mts

@@ -0,0 +1,8 @@
+import { SessionChannelContribution } from "../../types/webPlugin.mjs";
+//#region src/web/services/testing/channels.d.ts
+export interface ChannelDelivery {
+  accepted: boolean;
+}
+export declare function driveChannel(channel: SessionChannelContribution, sessionId: string, payload: unknown): ChannelDelivery;
+//#endregion
+//# sourceMappingURL=channels.d.mts.map

package/dist/src/web/services/testing/channels.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.d.mts","names":[],"sources":["../../../../../src/web/services/testing/channels.ts"],"mappings":";;iBAEiB;EACf;;wBAGc,aACd,SAAS,4BACT,mBACA,mBACC"}

package/dist/src/web/services/testing/channels.mjs

@@ -0,0 +1,11 @@
+//#region src/web/services/testing/channels.ts
+function driveChannel(channel, sessionId, payload) {
+	const parsed = channel.parse(payload);
+	if (parsed === null) return { accepted: false };
+	channel.apply(sessionId, parsed);
+	return { accepted: true };
+}
+//#endregion
+export { driveChannel };
+
+//# sourceMappingURL=channels.mjs.map

package/dist/src/web/services/testing/channels.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.mjs","names":[],"sources":["../../../../../src/web/services/testing/channels.ts"],"sourcesContent":["import type { SessionChannelContribution } from '../../types/webPlugin';\n\nexport interface ChannelDelivery {\n  accepted: boolean;\n}\n\nexport function driveChannel(\n  channel: SessionChannelContribution,\n  sessionId: string,\n  payload: unknown,\n): ChannelDelivery {\n  const parsed: unknown = channel.parse(payload);\n  if (parsed === null) return { accepted: false };\n  channel.apply(sessionId, parsed);\n  return { accepted: true };\n}\n"],"mappings":";AAMA,SAAgB,aACd,SACA,WACA,SACiB;CACjB,MAAM,SAAkB,QAAQ,MAAM,OAAO;CAC7C,IAAI,WAAW,MAAM,OAAO,EAAE,UAAU,MAAM;CAC9C,QAAQ,MAAM,WAAW,MAAM;CAC/B,OAAO,EAAE,UAAU,KAAK;AAC1B"}

package/dist/src/web/services/testing/index.cjs

@@ -0,0 +1,27 @@
+let react = require("react");
+let react_dom_server = require("react-dom/server");
+//#region src/web/services/testing/index.ts
+/** Tag-stripped text, so an assertion reads the page rather than the markup. */
+function textOf(html) {
+	return html.replaceAll(/<[^>]*>/gu, " ").replaceAll(/\s+/gu, " ").trim();
+}
+function renderPlugin(component, props) {
+	try {
+		const html = (0, react_dom_server.renderToStaticMarkup)((0, react.createElement)(component, props));
+		return {
+			html,
+			error: void 0,
+			includes: (text) => textOf(html).includes(text)
+		};
+	} catch (error) {
+		return {
+			html: "",
+			error: error instanceof Error ? error : new Error(String(error)),
+			includes: () => false
+		};
+	}
+}
+//#endregion
+exports.renderPlugin = renderPlugin;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/web/services/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["renderToStaticMarkup","createElement"],"sources":["../../../../../src/web/services/testing/index.ts"],"sourcesContent":["import { createElement } from 'react';\nimport type { ComponentType } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\n\n/**\n * One plugin component, rendered.\n *\n * No plugin component in the repository is imported by any test: stores and\n * pure helpers are covered per package, and the components are exercised only\n * by the browser suite. So the ordinary failures go unseen until a page is\n * opened, and the most ordinary of all is a component that throws on a state\n * the plugin can reach, which the host then catches and replaces with a\n * fallback nobody notices.\n *\n * Static markup rather than a DOM, matching the shared components package. It\n * proves a component mounts, reads the props the host actually sends, and puts\n * the expected text on the page. Clicks, effects, and Radix portals need a real\n * browser and stay with the Playwright suite.\n *\n * Callers pass components as values, never as JSX, so a plugin package needs no\n * JSX configuration in the project that holds its tests.\n */\n\nexport interface RenderedPlugin {\n  /** The markup, or an empty string when the component threw. */\n  html: string;\n  /** What the component threw, which the host would have swallowed. */\n  error: Error | undefined;\n  /** Whether the rendered markup contains this text, ignoring the tags around it. */\n  includes(text: string): boolean;\n}\n\n/** Tag-stripped text, so an assertion reads the page rather than the markup. */\nfunction textOf(html: string): string {\n  return html\n    .replaceAll(/<[^>]*>/gu, ' ')\n    .replaceAll(/\\s+/gu, ' ')\n    .trim();\n}\n\nexport function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin {\n  try {\n    const html = renderToStaticMarkup(createElement(component, props));\n    return { html, error: undefined, includes: (text) => textOf(html).includes(text) };\n  } catch (error) {\n    // Returned rather than rethrown: the host catches a throwing item and keeps\n    // the page up, so a test wanting to prove that needs the error as a value.\n    return {\n      html: '',\n      error: error instanceof Error ? error : new Error(String(error)),\n      includes: () => false,\n    };\n  }\n}\n"],"mappings":";;;;AAiCA,SAAS,OAAO,MAAsB;CACpC,OAAO,KACJ,WAAW,aAAa,GAAG,CAAC,CAC5B,WAAW,SAAS,GAAG,CAAC,CACxB,KAAK;AACV;AAEA,SAAgB,aAAmC,WAAiC,OAA8B;CAChH,IAAI;EACF,MAAM,QAAA,GAAOA,iBAAAA,qBAAAA,EAAAA,GAAqBC,MAAAA,cAAAA,CAAc,WAAW,KAAK,CAAC;EACjE,OAAO;GAAE;GAAM,OAAO,KAAA;GAAW,WAAW,SAAS,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI;EAAE;CACnF,SAAS,OAAO;EAGd,OAAO;GACL,MAAM;GACN,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;GAC/D,gBAAgB;EAClB;CACF;AACF"}

package/dist/src/web/services/testing/index.d.mts

@@ -0,0 +1,31 @@
+import { ComponentType } from "react";
+//#region src/web/services/testing/index.d.ts
+/**
+ * One plugin component, rendered.
+ *
+ * No plugin component in the repository is imported by any test: stores and
+ * pure helpers are covered per package, and the components are exercised only
+ * by the browser suite. So the ordinary failures go unseen until a page is
+ * opened, and the most ordinary of all is a component that throws on a state
+ * the plugin can reach, which the host then catches and replaces with a
+ * fallback nobody notices.
+ *
+ * Static markup rather than a DOM, matching the shared components package. It
+ * proves a component mounts, reads the props the host actually sends, and puts
+ * the expected text on the page. Clicks, effects, and Radix portals need a real
+ * browser and stay with the Playwright suite.
+ *
+ * Callers pass components as values, never as JSX, so a plugin package needs no
+ * JSX configuration in the project that holds its tests.
+ */
+export interface RenderedPlugin {
+  /** The markup, or an empty string when the component threw. */
+  html: string;
+  /** What the component threw, which the host would have swallowed. */
+  error: Error | undefined;
+  /** Whether the rendered markup contains this text, ignoring the tags around it. */
+  includes(text: string): boolean;
+}
+export declare function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/web/services/testing/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../../src/web/services/testing/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAuBiB;;EAEf;;EAEA,OAAO;;EAEP,SAAS;;wBAWK,aAAa,sBAAsB,WAAW,cAAc,QAAQ,OAAO,QAAQ"}

package/dist/src/web/services/testing/index.mjs

@@ -0,0 +1,27 @@
+import { createElement } from "react";
+import { renderToStaticMarkup } from "react-dom/server";
+//#region src/web/services/testing/index.ts
+/** Tag-stripped text, so an assertion reads the page rather than the markup. */
+function textOf(html) {
+	return html.replaceAll(/<[^>]*>/gu, " ").replaceAll(/\s+/gu, " ").trim();
+}
+function renderPlugin(component, props) {
+	try {
+		const html = renderToStaticMarkup(createElement(component, props));
+		return {
+			html,
+			error: void 0,
+			includes: (text) => textOf(html).includes(text)
+		};
+	} catch (error) {
+		return {
+			html: "",
+			error: error instanceof Error ? error : new Error(String(error)),
+			includes: () => false
+		};
+	}
+}
+//#endregion
+export { renderPlugin };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/web/services/testing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../src/web/services/testing/index.ts"],"sourcesContent":["import { createElement } from 'react';\nimport type { ComponentType } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\n\n/**\n * One plugin component, rendered.\n *\n * No plugin component in the repository is imported by any test: stores and\n * pure helpers are covered per package, and the components are exercised only\n * by the browser suite. So the ordinary failures go unseen until a page is\n * opened, and the most ordinary of all is a component that throws on a state\n * the plugin can reach, which the host then catches and replaces with a\n * fallback nobody notices.\n *\n * Static markup rather than a DOM, matching the shared components package. It\n * proves a component mounts, reads the props the host actually sends, and puts\n * the expected text on the page. Clicks, effects, and Radix portals need a real\n * browser and stay with the Playwright suite.\n *\n * Callers pass components as values, never as JSX, so a plugin package needs no\n * JSX configuration in the project that holds its tests.\n */\n\nexport interface RenderedPlugin {\n  /** The markup, or an empty string when the component threw. */\n  html: string;\n  /** What the component threw, which the host would have swallowed. */\n  error: Error | undefined;\n  /** Whether the rendered markup contains this text, ignoring the tags around it. */\n  includes(text: string): boolean;\n}\n\n/** Tag-stripped text, so an assertion reads the page rather than the markup. */\nfunction textOf(html: string): string {\n  return html\n    .replaceAll(/<[^>]*>/gu, ' ')\n    .replaceAll(/\\s+/gu, ' ')\n    .trim();\n}\n\nexport function renderPlugin<Props extends object>(component: ComponentType<Props>, props: Props): RenderedPlugin {\n  try {\n    const html = renderToStaticMarkup(createElement(component, props));\n    return { html, error: undefined, includes: (text) => textOf(html).includes(text) };\n  } catch (error) {\n    // Returned rather than rethrown: the host catches a throwing item and keeps\n    // the page up, so a test wanting to prove that needs the error as a value.\n    return {\n      html: '',\n      error: error instanceof Error ? error : new Error(String(error)),\n      includes: () => false,\n    };\n  }\n}\n"],"mappings":";;;;AAiCA,SAAS,OAAO,MAAsB;CACpC,OAAO,KACJ,WAAW,aAAa,GAAG,CAAC,CAC5B,WAAW,SAAS,GAAG,CAAC,CACxB,KAAK;AACV;AAEA,SAAgB,aAAmC,WAAiC,OAA8B;CAChH,IAAI;EACF,MAAM,OAAO,qBAAqB,cAAc,WAAW,KAAK,CAAC;EACjE,OAAO;GAAE;GAAM,OAAO,KAAA;GAAW,WAAW,SAAS,OAAO,IAAI,CAAC,CAAC,SAAS,IAAI;EAAE;CACnF,SAAS,OAAO;EAGd,OAAO;GACL,MAAM;GACN,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;GAC/D,gBAAgB;EAClB;CACF;AACF"}

package/dist/src/web/services/testing/rpcStub.cjs

@@ -0,0 +1,58 @@
+//#region src/web/services/testing/rpcStub.ts
+const ORIGIN = "http://cockpit.test";
+function describeMiss(method, pathname, matchers) {
+	const known = matchers.map((matcher) => `${matcher.method} ${matcher.pathname}`).join(", ");
+	return `No stub answers ${method} ${pathname}. Registered: ${known === "" ? "(none)" : known}.`;
+}
+function toResponse(reply) {
+	if (reply instanceof Response || reply instanceof Promise) return reply;
+	return Response.json(reply);
+}
+function createRpcStub() {
+	const matchers = [];
+	const calls = [];
+	const misses = [];
+	const stub = {
+		calls,
+		misses,
+		assertNoMisses() {
+			if (misses.length === 0) return;
+			const listed = misses.map((miss) => `${miss.method} ${miss.url}`).join("\n  ");
+			throw new Error(`The stub was asked for routes it does not answer:\n  ${listed}`);
+		},
+		on(call, reply) {
+			matchers.push({
+				method: call.spec.method,
+				pathname: new URL(call.url(), ORIGIN).pathname,
+				reply
+			});
+			return stub;
+		},
+		transport: (input, init) => {
+			const url = new URL(input, ORIGIN);
+			const method = init?.method ?? "GET";
+			calls.push({
+				method,
+				url: input
+			});
+			const matched = matchers.find((matcher) => matcher.method === method && matcher.pathname === url.pathname);
+			if (matched === void 0) {
+				misses.push({
+					method,
+					url: input
+				});
+				return Promise.resolve(Response.json({ error: describeMiss(method, url.pathname, matchers) }, { status: 599 }));
+			}
+			return Promise.resolve(toResponse(matched.reply({
+				url,
+				method,
+				init
+			})));
+		}
+	};
+	return stub;
+}
+//#endregion
+exports.createRpcStub = createRpcStub;
+
+//# sourceMappingURL=rpcStub.cjs.map

package/dist/src/web/services/testing/rpcStub.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcStub.cjs","names":[],"sources":["../../../../../src/web/services/testing/rpcStub.ts"],"sourcesContent":["/**\n * A transport a story or a test hands to a generated client.\n *\n * Keyed off the client's own methods rather than off a substring of a URL.\n * That is the whole point: the cockpit accumulated matchers like\n * `url.includes('/api/plugins/file-edits/detail')`, and when the real route\n * moved under a workspace prefix they silently stopped matching. Three of them\n * were still in the tree, one of them answering a JSON route with a binary\n * blob, because a matcher that never fires looks exactly like one that does.\n *\n * Here a matcher is the method itself, so renaming a route is a type error and\n * deleting one is a missing property. A request nothing matched throws instead\n * of falling through to the next matcher, because falling through is how the\n * wrong fixture gets served.\n */\n\nimport type { ApiMethod, ApiStreamMethod, ApiTransport } from '../apiClient';\n\nconst ORIGIN = 'http://cockpit.test';\n\n/**\n * What a matcher answers with.\n *\n * A `Response` is sent as-is, so a fixture can set a status, a header or raw\n * bytes. Anything else is sent as JSON 200, which is what most fixtures want\n * and saves them wrapping every object. Deliberately `unknown` rather than a\n * union naming `Response`: the union would collapse to this anyway, and the\n * runtime check is what actually decides.\n */\nexport type RpcStubReply = unknown;\n\nexport interface RpcStubRequest {\n  readonly url: URL;\n  readonly method: string;\n  readonly init: RequestInit | undefined;\n}\n\n/** One request the stub carried, in order, for assertions after the fact. */\nexport interface RpcStubCall {\n  readonly method: string;\n  readonly url: string;\n}\n\nexport interface RpcStub {\n  /** Hand this to `createApiClient`. */\n  readonly transport: ApiTransport;\n  /** Answer one route. Chainable, so a story reads as a list of fixtures. */\n  on(call: ApiMethod<never> | ApiStreamMethod, reply: (request: RpcStubRequest) => RpcStubReply): RpcStub;\n  /** Every request the stub carried, matched or not. */\n  readonly calls: readonly RpcStubCall[];\n  /** Requests no matcher claimed. Answered 599 rather than served a neighbour's fixture. */\n  readonly misses: readonly RpcStubCall[];\n  /** Fails the test naming every unmatched request. Call it at the end of one. */\n  assertNoMisses(): void;\n}\n\ninterface Matcher {\n  readonly method: string;\n  readonly pathname: string;\n  readonly reply: (request: RpcStubRequest) => RpcStubReply;\n}\n\nfunction describeMiss(method: string, pathname: string, matchers: readonly Matcher[]): string {\n  const known = matchers.map((matcher) => `${matcher.method} ${matcher.pathname}`).join(', ');\n  return `No stub answers ${method} ${pathname}. Registered: ${known === '' ? '(none)' : known}.`;\n}\n\nfunction toResponse(reply: RpcStubReply): Response | Promise<Response> {\n  if (reply instanceof Response || reply instanceof Promise) return reply as Response | Promise<Response>;\n  return Response.json(reply as Record<string, unknown>);\n}\n\nexport function createRpcStub(): RpcStub {\n  const matchers: Matcher[] = [];\n  const calls: RpcStubCall[] = [];\n  const misses: RpcStubCall[] = [];\n\n  const stub: RpcStub = {\n    calls,\n    misses,\n    assertNoMisses() {\n      if (misses.length === 0) return;\n      const listed = misses.map((miss) => `${miss.method} ${miss.url}`).join('\\n  ');\n      throw new Error(`The stub was asked for routes it does not answer:\\n  ${listed}`);\n    },\n    on(call, reply) {\n      // `url()` with no query gives the route's pathname, which is what\n      // identifies it. The query is the caller's, and a fixture that cared\n      // about it can read it off the request.\n      matchers.push({ method: call.spec.method, pathname: new URL(call.url(), ORIGIN).pathname, reply });\n      return stub;\n    },\n    transport: (input, init) => {\n      const url = new URL(input, ORIGIN);\n      const method = init?.method ?? 'GET';\n      calls.push({ method, url: input });\n      const matched = matchers.find((matcher) => matcher.method === method && matcher.pathname === url.pathname);\n      if (matched === undefined) {\n        misses.push({ method, url: input });\n        // Not a throw: the client turns a transport throw into `status: 0`,\n        // which reads as an unreachable session and is exactly the quiet\n        // outcome this stub exists to prevent. 599 is outside the range any\n        // route answers, so it cannot be mistaken for the real thing, and the\n        // miss is recorded for `assertNoMisses`.\n        return Promise.resolve(Response.json({ error: describeMiss(method, url.pathname, matchers) }, { status: 599 }));\n      }\n      return Promise.resolve(toResponse(matched.reply({ url, method, init })));\n    },\n  };\n  return stub;\n}\n"],"mappings":";AAkBA,MAAM,SAAS;AA4Cf,SAAS,aAAa,QAAgB,UAAkB,UAAsC;CAC5F,MAAM,QAAQ,SAAS,KAAK,YAAY,GAAG,QAAQ,OAAO,GAAG,QAAQ,UAAU,CAAC,CAAC,KAAK,IAAI;CAC1F,OAAO,mBAAmB,OAAO,GAAG,SAAS,gBAAgB,UAAU,KAAK,WAAW,MAAM;AAC/F;AAEA,SAAS,WAAW,OAAmD;CACrE,IAAI,iBAAiB,YAAY,iBAAiB,SAAS,OAAO;CAClE,OAAO,SAAS,KAAK,KAAgC;AACvD;AAEA,SAAgB,gBAAyB;CACvC,MAAM,WAAsB,CAAC;CAC7B,MAAM,QAAuB,CAAC;CAC9B,MAAM,SAAwB,CAAC;CAE/B,MAAM,OAAgB;EACpB;EACA;EACA,iBAAiB;GACf,IAAI,OAAO,WAAW,GAAG;GACzB,MAAM,SAAS,OAAO,KAAK,SAAS,GAAG,KAAK,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,KAAK,MAAM;GAC7E,MAAM,IAAI,MAAM,wDAAwD,QAAQ;EAClF;EACA,GAAG,MAAM,OAAO;GAId,SAAS,KAAK;IAAE,QAAQ,KAAK,KAAK;IAAQ,UAAU,IAAI,IAAI,KAAK,IAAI,GAAG,MAAM,CAAC,CAAC;IAAU;GAAM,CAAC;GACjG,OAAO;EACT;EACA,YAAY,OAAO,SAAS;GAC1B,MAAM,MAAM,IAAI,IAAI,OAAO,MAAM;GACjC,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,KAAK;IAAE;IAAQ,KAAK;GAAM,CAAC;GACjC,MAAM,UAAU,SAAS,MAAM,YAAY,QAAQ,WAAW,UAAU,QAAQ,aAAa,IAAI,QAAQ;GACzG,IAAI,YAAY,KAAA,GAAW;IACzB,OAAO,KAAK;KAAE;KAAQ,KAAK;IAAM,CAAC;IAMlC,OAAO,QAAQ,QAAQ,SAAS,KAAK,EAAE,OAAO,aAAa,QAAQ,IAAI,UAAU,QAAQ,EAAE,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC;GAChH;GACA,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM;IAAE;IAAK;IAAQ;GAAK,CAAC,CAAC,CAAC;EACzE;CACF;CACA,OAAO;AACT"}

package/dist/src/web/services/testing/rpcStub.d.mts

@@ -0,0 +1,37 @@
+import { ApiMethod, ApiStreamMethod, ApiTransport } from "../apiClient/index.mjs";
+//#region src/web/services/testing/rpcStub.d.ts
+/**
+ * What a matcher answers with.
+ *
+ * A `Response` is sent as-is, so a fixture can set a status, a header or raw
+ * bytes. Anything else is sent as JSON 200, which is what most fixtures want
+ * and saves them wrapping every object. Deliberately `unknown` rather than a
+ * union naming `Response`: the union would collapse to this anyway, and the
+ * runtime check is what actually decides.
+ */
+export type RpcStubReply = unknown;
+export interface RpcStubRequest {
+  readonly url: URL;
+  readonly method: string;
+  readonly init: RequestInit | undefined;
+}
+/** One request the stub carried, in order, for assertions after the fact. */
+export interface RpcStubCall {
+  readonly method: string;
+  readonly url: string;
+}
+export interface RpcStub {
+  /** Hand this to `createApiClient`. */
+  readonly transport: ApiTransport;
+  /** Answer one route. Chainable, so a story reads as a list of fixtures. */
+  on(call: ApiMethod<never> | ApiStreamMethod, reply: (request: RpcStubRequest) => RpcStubReply): RpcStub;
+  /** Every request the stub carried, matched or not. */
+  readonly calls: readonly RpcStubCall[];
+  /** Requests no matcher claimed. Answered 599 rather than served a neighbour's fixture. */
+  readonly misses: readonly RpcStubCall[];
+  /** Fails the test naming every unmatched request. Call it at the end of one. */
+  assertNoMisses(): void;
+}
+export declare function createRpcStub(): RpcStub;
+//#endregion
+//# sourceMappingURL=rpcStub.d.mts.map

package/dist/src/web/services/testing/rpcStub.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcStub.d.mts","names":[],"sources":["../../../../../src/web/services/testing/rpcStub.ts"],"mappings":";;;;;;;;;;;YA6BY;iBAEK;WACN,KAAK;WACL;WACA,MAAM;;;iBAIA;WACN;WACA;;iBAGM;;WAEN,WAAW;;EAEpB,GAAG,MAAM,mBAAmB,iBAAiB,QAAQ,SAAS,mBAAmB,eAAe;;WAEvF,gBAAgB;;WAEhB,iBAAiB;;EAE1B;;wBAmBc,iBAAiB"}

package/dist/src/web/services/testing/rpcStub.mjs

@@ -0,0 +1,58 @@
+//#region src/web/services/testing/rpcStub.ts
+const ORIGIN = "http://cockpit.test";
+function describeMiss(method, pathname, matchers) {
+	const known = matchers.map((matcher) => `${matcher.method} ${matcher.pathname}`).join(", ");
+	return `No stub answers ${method} ${pathname}. Registered: ${known === "" ? "(none)" : known}.`;
+}
+function toResponse(reply) {
+	if (reply instanceof Response || reply instanceof Promise) return reply;
+	return Response.json(reply);
+}
+function createRpcStub() {
+	const matchers = [];
+	const calls = [];
+	const misses = [];
+	const stub = {
+		calls,
+		misses,
+		assertNoMisses() {
+			if (misses.length === 0) return;
+			const listed = misses.map((miss) => `${miss.method} ${miss.url}`).join("\n  ");
+			throw new Error(`The stub was asked for routes it does not answer:\n  ${listed}`);
+		},
+		on(call, reply) {
+			matchers.push({
+				method: call.spec.method,
+				pathname: new URL(call.url(), ORIGIN).pathname,
+				reply
+			});
+			return stub;
+		},
+		transport: (input, init) => {
+			const url = new URL(input, ORIGIN);
+			const method = init?.method ?? "GET";
+			calls.push({
+				method,
+				url: input
+			});
+			const matched = matchers.find((matcher) => matcher.method === method && matcher.pathname === url.pathname);
+			if (matched === void 0) {
+				misses.push({
+					method,
+					url: input
+				});
+				return Promise.resolve(Response.json({ error: describeMiss(method, url.pathname, matchers) }, { status: 599 }));
+			}
+			return Promise.resolve(toResponse(matched.reply({
+				url,
+				method,
+				init
+			})));
+		}
+	};
+	return stub;
+}
+//#endregion
+export { createRpcStub };
+
+//# sourceMappingURL=rpcStub.mjs.map

package/dist/src/web/services/testing/rpcStub.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpcStub.mjs","names":[],"sources":["../../../../../src/web/services/testing/rpcStub.ts"],"sourcesContent":["/**\n * A transport a story or a test hands to a generated client.\n *\n * Keyed off the client's own methods rather than off a substring of a URL.\n * That is the whole point: the cockpit accumulated matchers like\n * `url.includes('/api/plugins/file-edits/detail')`, and when the real route\n * moved under a workspace prefix they silently stopped matching. Three of them\n * were still in the tree, one of them answering a JSON route with a binary\n * blob, because a matcher that never fires looks exactly like one that does.\n *\n * Here a matcher is the method itself, so renaming a route is a type error and\n * deleting one is a missing property. A request nothing matched throws instead\n * of falling through to the next matcher, because falling through is how the\n * wrong fixture gets served.\n */\n\nimport type { ApiMethod, ApiStreamMethod, ApiTransport } from '../apiClient';\n\nconst ORIGIN = 'http://cockpit.test';\n\n/**\n * What a matcher answers with.\n *\n * A `Response` is sent as-is, so a fixture can set a status, a header or raw\n * bytes. Anything else is sent as JSON 200, which is what most fixtures want\n * and saves them wrapping every object. Deliberately `unknown` rather than a\n * union naming `Response`: the union would collapse to this anyway, and the\n * runtime check is what actually decides.\n */\nexport type RpcStubReply = unknown;\n\nexport interface RpcStubRequest {\n  readonly url: URL;\n  readonly method: string;\n  readonly init: RequestInit | undefined;\n}\n\n/** One request the stub carried, in order, for assertions after the fact. */\nexport interface RpcStubCall {\n  readonly method: string;\n  readonly url: string;\n}\n\nexport interface RpcStub {\n  /** Hand this to `createApiClient`. */\n  readonly transport: ApiTransport;\n  /** Answer one route. Chainable, so a story reads as a list of fixtures. */\n  on(call: ApiMethod<never> | ApiStreamMethod, reply: (request: RpcStubRequest) => RpcStubReply): RpcStub;\n  /** Every request the stub carried, matched or not. */\n  readonly calls: readonly RpcStubCall[];\n  /** Requests no matcher claimed. Answered 599 rather than served a neighbour's fixture. */\n  readonly misses: readonly RpcStubCall[];\n  /** Fails the test naming every unmatched request. Call it at the end of one. */\n  assertNoMisses(): void;\n}\n\ninterface Matcher {\n  readonly method: string;\n  readonly pathname: string;\n  readonly reply: (request: RpcStubRequest) => RpcStubReply;\n}\n\nfunction describeMiss(method: string, pathname: string, matchers: readonly Matcher[]): string {\n  const known = matchers.map((matcher) => `${matcher.method} ${matcher.pathname}`).join(', ');\n  return `No stub answers ${method} ${pathname}. Registered: ${known === '' ? '(none)' : known}.`;\n}\n\nfunction toResponse(reply: RpcStubReply): Response | Promise<Response> {\n  if (reply instanceof Response || reply instanceof Promise) return reply as Response | Promise<Response>;\n  return Response.json(reply as Record<string, unknown>);\n}\n\nexport function createRpcStub(): RpcStub {\n  const matchers: Matcher[] = [];\n  const calls: RpcStubCall[] = [];\n  const misses: RpcStubCall[] = [];\n\n  const stub: RpcStub = {\n    calls,\n    misses,\n    assertNoMisses() {\n      if (misses.length === 0) return;\n      const listed = misses.map((miss) => `${miss.method} ${miss.url}`).join('\\n  ');\n      throw new Error(`The stub was asked for routes it does not answer:\\n  ${listed}`);\n    },\n    on(call, reply) {\n      // `url()` with no query gives the route's pathname, which is what\n      // identifies it. The query is the caller's, and a fixture that cared\n      // about it can read it off the request.\n      matchers.push({ method: call.spec.method, pathname: new URL(call.url(), ORIGIN).pathname, reply });\n      return stub;\n    },\n    transport: (input, init) => {\n      const url = new URL(input, ORIGIN);\n      const method = init?.method ?? 'GET';\n      calls.push({ method, url: input });\n      const matched = matchers.find((matcher) => matcher.method === method && matcher.pathname === url.pathname);\n      if (matched === undefined) {\n        misses.push({ method, url: input });\n        // Not a throw: the client turns a transport throw into `status: 0`,\n        // which reads as an unreachable session and is exactly the quiet\n        // outcome this stub exists to prevent. 599 is outside the range any\n        // route answers, so it cannot be mistaken for the real thing, and the\n        // miss is recorded for `assertNoMisses`.\n        return Promise.resolve(Response.json({ error: describeMiss(method, url.pathname, matchers) }, { status: 599 }));\n      }\n      return Promise.resolve(toResponse(matched.reply({ url, method, init })));\n    },\n  };\n  return stub;\n}\n"],"mappings":";AAkBA,MAAM,SAAS;AA4Cf,SAAS,aAAa,QAAgB,UAAkB,UAAsC;CAC5F,MAAM,QAAQ,SAAS,KAAK,YAAY,GAAG,QAAQ,OAAO,GAAG,QAAQ,UAAU,CAAC,CAAC,KAAK,IAAI;CAC1F,OAAO,mBAAmB,OAAO,GAAG,SAAS,gBAAgB,UAAU,KAAK,WAAW,MAAM;AAC/F;AAEA,SAAS,WAAW,OAAmD;CACrE,IAAI,iBAAiB,YAAY,iBAAiB,SAAS,OAAO;CAClE,OAAO,SAAS,KAAK,KAAgC;AACvD;AAEA,SAAgB,gBAAyB;CACvC,MAAM,WAAsB,CAAC;CAC7B,MAAM,QAAuB,CAAC;CAC9B,MAAM,SAAwB,CAAC;CAE/B,MAAM,OAAgB;EACpB;EACA;EACA,iBAAiB;GACf,IAAI,OAAO,WAAW,GAAG;GACzB,MAAM,SAAS,OAAO,KAAK,SAAS,GAAG,KAAK,OAAO,GAAG,KAAK,KAAK,CAAC,CAAC,KAAK,MAAM;GAC7E,MAAM,IAAI,MAAM,wDAAwD,QAAQ;EAClF;EACA,GAAG,MAAM,OAAO;GAId,SAAS,KAAK;IAAE,QAAQ,KAAK,KAAK;IAAQ,UAAU,IAAI,IAAI,KAAK,IAAI,GAAG,MAAM,CAAC,CAAC;IAAU;GAAM,CAAC;GACjG,OAAO;EACT;EACA,YAAY,OAAO,SAAS;GAC1B,MAAM,MAAM,IAAI,IAAI,OAAO,MAAM;GACjC,MAAM,SAAS,MAAM,UAAU;GAC/B,MAAM,KAAK;IAAE;IAAQ,KAAK;GAAM,CAAC;GACjC,MAAM,UAAU,SAAS,MAAM,YAAY,QAAQ,WAAW,UAAU,QAAQ,aAAa,IAAI,QAAQ;GACzG,IAAI,YAAY,KAAA,GAAW;IACzB,OAAO,KAAK;KAAE;KAAQ,KAAK;IAAM,CAAC;IAMlC,OAAO,QAAQ,QAAQ,SAAS,KAAK,EAAE,OAAO,aAAa,QAAQ,IAAI,UAAU,QAAQ,EAAE,GAAG,EAAE,QAAQ,IAAI,CAAC,CAAC;GAChH;GACA,OAAO,QAAQ,QAAQ,WAAW,QAAQ,MAAM;IAAE;IAAK;IAAQ;GAAK,CAAC,CAAC,CAAC;EACzE;CACF;CACA,OAAO;AACT"}

package/dist/src/web/services/testing/slotProps.cjs

@@ -0,0 +1,91 @@
+//#region src/web/services/testing/slotProps.ts
+const DEFAULT_SESSION_ID = "s1";
+function slotPropsFixture(options = {}) {
+	const actions = [];
+	const props = {
+		sessionId: options.sessionId === void 0 ? DEFAULT_SESSION_ID : options.sessionId,
+		statuses: options.statuses ?? {},
+		contextInventory: options.contextInventory ?? [],
+		openTab: (tabId) => {
+			actions.push({
+				action: "openTab",
+				target: tabId
+			});
+		},
+		openTransientTab: (tab) => {
+			actions.push({
+				action: "openTransientTab",
+				target: tab.id
+			});
+		},
+		closeTransientTab: (tabId) => {
+			actions.push({
+				action: "closeTransientTab",
+				target: tabId
+			});
+		},
+		fileTabFor: (path) => options.fileTab?.(path),
+		appendComposerDraft: (text) => {
+			actions.push({
+				action: "appendComposerDraft",
+				target: props.sessionId,
+				text
+			});
+		},
+		attachComposerContext: (context) => {
+			actions.push({
+				action: "attachComposerContext",
+				target: props.sessionId,
+				context
+			});
+		},
+		attachComposerCapture: (capture) => {
+			actions.push({
+				action: "attachComposerCapture",
+				target: props.sessionId,
+				capture
+			});
+		},
+		contextActionsFor: (item) => options.contextActions?.(item) ?? [],
+		sendSessionFrame: (sessionId, frame) => {
+			actions.push({
+				action: "sendSessionFrame",
+				target: sessionId,
+				frame
+			});
+		},
+		renderThread: (threadId, threadOptions) => options.thread?.(threadId, threadOptions) ?? null,
+		...options.sessionTranscript === void 0 ? {} : { renderSessionTranscript: options.sessionTranscript },
+		renderSlot: (slot) => options.slotContent?.[slot] ?? null,
+		slotData: (slot) => options.slotData?.[slot.slot] ?? []
+	};
+	return {
+		props,
+		actions,
+		frames: () => actions.flatMap((entry) => entry.frame ? [entry.frame] : [])
+	};
+}
+const DEFAULT_TOOL_CALL_ID = "call-1";
+/** The props a tool's timeline item receives, in any of its four states. */
+function toolMessagePropsFixture(options) {
+	const base = slotPropsFixture(options);
+	const result = options.result === void 0 ? null : options.result;
+	return {
+		...base,
+		props: {
+			...base.props,
+			toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,
+			toolName: options.toolName,
+			args: options.args ?? {},
+			result,
+			output: options.output ?? "",
+			running: options.running ?? false,
+			isError: options.isError ?? false
+		}
+	};
+}
+//#endregion
+exports.slotPropsFixture = slotPropsFixture;
+exports.toolMessagePropsFixture = toolMessagePropsFixture;
+
+//# sourceMappingURL=slotProps.cjs.map

package/dist/src/web/services/testing/slotProps.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotProps.cjs","names":[],"sources":["../../../../../src/web/services/testing/slotProps.ts"],"sourcesContent":["import type { ReactNode } from 'react';\n\nimport type {\n  ComposerCapture,\n  ContextAction,\n  SlotDataFill,\n  SlotDeclaration,\n  ThreadViewOptions,\n  ToolMessageRenderProps,\n  ToolResultView,\n  TransientTab,\n  WebPluginContextItem,\n  WebPluginSlotProps,\n} from '../../types/webPlugin';\n\n/**\n * The props the cockpit hands a plugin's components, built for a test.\n *\n * A plugin component takes fifteen props and reads three of them. Written out\n * by hand in each test, the other twelve are noise that goes stale the moment\n * the contract grows a member; written as a cast, the component compiles\n * against props the host never sends. This builds all of them, records what the\n * component did with the actions, and lets a test override the two or three it\n * cares about.\n */\n\nexport interface RecordedSlotAction {\n  action:\n    | 'appendComposerDraft'\n    | 'attachComposerCapture'\n    | 'attachComposerContext'\n    | 'openTab'\n    | 'openTransientTab'\n    | 'closeTransientTab'\n    | 'sendSessionFrame';\n  /** The tab id, the transient tab's id, or the target session of a frame or composer action. */\n  target: string | null;\n  /** The text passed to `appendComposerDraft`. */\n  text?: string;\n  /** The structured item passed to `attachComposerContext`. */\n  context?: WebPluginContextItem;\n  /** The atomic screenshot and context passed to `attachComposerCapture`. */\n  capture?: ComposerCapture;\n  /** The frame a component sent, for `sendSessionFrame`. */\n  frame?: Record<string, unknown>;\n}\n\nexport interface SlotPropsFixture {\n  props: WebPluginSlotProps;\n  /** Everything the component did through its props, in order. */\n  readonly actions: readonly RecordedSlotAction[];\n  /** Frames the component sent, which is what most assertions want. */\n  frames(): readonly Record<string, unknown>[];\n}\n\nexport interface SlotPropsOptions {\n  sessionId?: string | null;\n  statuses?: Readonly<Record<string, string>>;\n  contextInventory?: WebPluginSlotProps['contextInventory'];\n  /** Component fills this slot owner should see; keyed by slot name. */\n  slotContent?: Readonly<Record<string, ReactNode>>;\n  /** Data fills this slot owner should read back, keyed by slot name. */\n  slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;\n  /** What `renderThread` returns for a plugin that renders one. */\n  thread?: (threadId: string, options?: ThreadViewOptions) => ReactNode;\n  /** What `renderSessionTranscript` returns; omitted, the prop is absent as in a host that has none. */\n  sessionTranscript?: (sessionId: string, options?: ThreadViewOptions) => ReactNode;\n  /** The tab a path opens; by default no path opens one, as with no file plugin installed. */\n  fileTab?: (path: string) => TransientTab | undefined;\n  /** Context actions installed plugins should offer for the item under test. */\n  contextActions?: (item: WebPluginContextItem) => readonly ContextAction[];\n}\n\nconst DEFAULT_SESSION_ID = 's1';\n\nexport function slotPropsFixture(options: SlotPropsOptions = {}): SlotPropsFixture {\n  const actions: RecordedSlotAction[] = [];\n  const props: WebPluginSlotProps = {\n    sessionId: options.sessionId === undefined ? DEFAULT_SESSION_ID : options.sessionId,\n    statuses: options.statuses ?? {},\n    contextInventory: options.contextInventory ?? [],\n    openTab: (tabId) => {\n      actions.push({ action: 'openTab', target: tabId });\n    },\n    openTransientTab: (tab: TransientTab) => {\n      actions.push({ action: 'openTransientTab', target: tab.id });\n    },\n    closeTransientTab: (tabId: string) => {\n      actions.push({ action: 'closeTransientTab', target: tabId });\n    },\n    fileTabFor: (path: string) => options.fileTab?.(path),\n    appendComposerDraft: (text) => {\n      actions.push({ action: 'appendComposerDraft', target: props.sessionId, text });\n    },\n    attachComposerContext: (context) => {\n      actions.push({ action: 'attachComposerContext', target: props.sessionId, context });\n    },\n    attachComposerCapture: (capture) => {\n      actions.push({ action: 'attachComposerCapture', target: props.sessionId, capture });\n    },\n    contextActionsFor: (item) => options.contextActions?.(item) ?? [],\n    sendSessionFrame: (sessionId, frame) => {\n      actions.push({ action: 'sendSessionFrame', target: sessionId, frame });\n    },\n    renderThread: (threadId, threadOptions) => options.thread?.(threadId, threadOptions) ?? null,\n    ...(options.sessionTranscript === undefined ? {} : { renderSessionTranscript: options.sessionTranscript }),\n    renderSlot: (slot) => options.slotContent?.[slot] ?? null,\n    // The host resolves fills by slot name and hands the owner its own typed\n    // view, so a test declares them by name too.\n    slotData: <Data>(slot: SlotDeclaration<Data>) =>\n      (options.slotData?.[slot.slot] ?? []) as readonly SlotDataFill<Data>[],\n  };\n\n  return {\n    props,\n    actions,\n    frames: () => actions.flatMap((entry) => (entry.frame ? [entry.frame] : [])),\n  };\n}\n\nexport interface ToolMessagePropsOptions extends SlotPropsOptions {\n  toolCallId?: string;\n  toolName: string;\n  args?: Record<string, unknown>;\n  /** The newest result; null is what the host sends before any output. */\n  result?: ToolResultView | null;\n  /** The result's text blocks joined, as the host's own fallback item shows them. */\n  output?: string;\n  running?: boolean;\n  isError?: boolean;\n}\n\nexport interface ToolMessagePropsFixture extends Omit<SlotPropsFixture, 'props'> {\n  props: ToolMessageRenderProps;\n}\n\nconst DEFAULT_TOOL_CALL_ID = 'call-1';\n\n/** The props a tool's timeline item receives, in any of its four states. */\nexport function toolMessagePropsFixture(options: ToolMessagePropsOptions): ToolMessagePropsFixture {\n  const base = slotPropsFixture(options);\n  const result = options.result === undefined ? null : options.result;\n  return {\n    ...base,\n    props: {\n      ...base.props,\n      toolCallId: options.toolCallId ?? DEFAULT_TOOL_CALL_ID,\n      toolName: options.toolName,\n      args: options.args ?? {},\n      result,\n      output: options.output ?? '',\n      running: options.running ?? false,\n      isError: options.isError ?? false,\n    },\n  };\n}\n"],"mappings":";AAyEA,MAAM,qBAAqB;AAE3B,SAAgB,iBAAiB,UAA4B,CAAC,GAAqB;CACjF,MAAM,UAAgC,CAAC;CACvC,MAAM,QAA4B;EAChC,WAAW,QAAQ,cAAc,KAAA,IAAY,qBAAqB,QAAQ;EAC1E,UAAU,QAAQ,YAAY,CAAC;EAC/B,kBAAkB,QAAQ,oBAAoB,CAAC;EAC/C,UAAU,UAAU;GAClB,QAAQ,KAAK;IAAE,QAAQ;IAAW,QAAQ;GAAM,CAAC;EACnD;EACA,mBAAmB,QAAsB;GACvC,QAAQ,KAAK;IAAE,QAAQ;IAAoB,QAAQ,IAAI;GAAG,CAAC;EAC7D;EACA,oBAAoB,UAAkB;GACpC,QAAQ,KAAK;IAAE,QAAQ;IAAqB,QAAQ;GAAM,CAAC;EAC7D;EACA,aAAa,SAAiB,QAAQ,UAAU,IAAI;EACpD,sBAAsB,SAAS;GAC7B,QAAQ,KAAK;IAAE,QAAQ;IAAuB,QAAQ,MAAM;IAAW;GAAK,CAAC;EAC/E;EACA,wBAAwB,YAAY;GAClC,QAAQ,KAAK;IAAE,QAAQ;IAAyB,QAAQ,MAAM;IAAW;GAAQ,CAAC;EACpF;EACA,wBAAwB,YAAY;GAClC,QAAQ,KAAK;IAAE,QAAQ;IAAyB,QAAQ,MAAM;IAAW;GAAQ,CAAC;EACpF;EACA,oBAAoB,SAAS,QAAQ,iBAAiB,IAAI,KAAK,CAAC;EAChE,mBAAmB,WAAW,UAAU;GACtC,QAAQ,KAAK;IAAE,QAAQ;IAAoB,QAAQ;IAAW;GAAM,CAAC;EACvE;EACA,eAAe,UAAU,kBAAkB,QAAQ,SAAS,UAAU,aAAa,KAAK;EACxF,GAAI,QAAQ,sBAAsB,KAAA,IAAY,CAAC,IAAI,EAAE,yBAAyB,QAAQ,kBAAkB;EACxG,aAAa,SAAS,QAAQ,cAAc,SAAS;EAGrD,WAAiB,SACd,QAAQ,WAAW,KAAK,SAAS,CAAC;CACvC;CAEA,OAAO;EACL;EACA;EACA,cAAc,QAAQ,SAAS,UAAW,MAAM,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAE;CAC7E;AACF;AAkBA,MAAM,uBAAuB;;AAG7B,SAAgB,wBAAwB,SAA2D;CACjG,MAAM,OAAO,iBAAiB,OAAO;CACrC,MAAM,SAAS,QAAQ,WAAW,KAAA,IAAY,OAAO,QAAQ;CAC7D,OAAO;EACL,GAAG;EACH,OAAO;GACL,GAAG,KAAK;GACR,YAAY,QAAQ,cAAc;GAClC,UAAU,QAAQ;GAClB,MAAM,QAAQ,QAAQ,CAAC;GACvB;GACA,QAAQ,QAAQ,UAAU;GAC1B,SAAS,QAAQ,WAAW;GAC5B,SAAS,QAAQ,WAAW;EAC9B;CACF;AACF"}

package/dist/src/web/services/testing/slotProps.d.mts

@@ -0,0 +1,69 @@
+import { ComposerCapture, ContextAction, SlotDataFill, ThreadViewOptions, ToolMessageRenderProps, ToolResultView, TransientTab, WebPluginContextItem, WebPluginSlotProps } from "../../types/webPlugin.mjs";
+import { ReactNode } from "react";
+//#region src/web/services/testing/slotProps.d.ts
+/**
+ * The props the cockpit hands a plugin's components, built for a test.
+ *
+ * A plugin component takes fifteen props and reads three of them. Written out
+ * by hand in each test, the other twelve are noise that goes stale the moment
+ * the contract grows a member; written as a cast, the component compiles
+ * against props the host never sends. This builds all of them, records what the
+ * component did with the actions, and lets a test override the two or three it
+ * cares about.
+ */
+export interface RecordedSlotAction {
+  action: 'appendComposerDraft' | 'attachComposerCapture' | 'attachComposerContext' | 'openTab' | 'openTransientTab' | 'closeTransientTab' | 'sendSessionFrame';
+  /** The tab id, the transient tab's id, or the target session of a frame or composer action. */
+  target: string | null;
+  /** The text passed to `appendComposerDraft`. */
+  text?: string;
+  /** The structured item passed to `attachComposerContext`. */
+  context?: WebPluginContextItem;
+  /** The atomic screenshot and context passed to `attachComposerCapture`. */
+  capture?: ComposerCapture;
+  /** The frame a component sent, for `sendSessionFrame`. */
+  frame?: Record<string, unknown>;
+}
+export interface SlotPropsFixture {
+  props: WebPluginSlotProps;
+  /** Everything the component did through its props, in order. */
+  readonly actions: readonly RecordedSlotAction[];
+  /** Frames the component sent, which is what most assertions want. */
+  frames(): readonly Record<string, unknown>[];
+}
+export interface SlotPropsOptions {
+  sessionId?: string | null;
+  statuses?: Readonly<Record<string, string>>;
+  contextInventory?: WebPluginSlotProps['contextInventory'];
+  /** Component fills this slot owner should see; keyed by slot name. */
+  slotContent?: Readonly<Record<string, ReactNode>>;
+  /** Data fills this slot owner should read back, keyed by slot name. */
+  slotData?: Readonly<Record<string, readonly SlotDataFill[]>>;
+  /** What `renderThread` returns for a plugin that renders one. */
+  thread?: (threadId: string, options?: ThreadViewOptions) => ReactNode;
+  /** What `renderSessionTranscript` returns; omitted, the prop is absent as in a host that has none. */
+  sessionTranscript?: (sessionId: string, options?: ThreadViewOptions) => ReactNode;
+  /** The tab a path opens; by default no path opens one, as with no file plugin installed. */
+  fileTab?: (path: string) => TransientTab | undefined;
+  /** Context actions installed plugins should offer for the item under test. */
+  contextActions?: (item: WebPluginContextItem) => readonly ContextAction[];
+}
+export declare function slotPropsFixture(options?: SlotPropsOptions): SlotPropsFixture;
+export interface ToolMessagePropsOptions extends SlotPropsOptions {
+  toolCallId?: string;
+  toolName: string;
+  args?: Record<string, unknown>;
+  /** The newest result; null is what the host sends before any output. */
+  result?: ToolResultView | null;
+  /** The result's text blocks joined, as the host's own fallback item shows them. */
+  output?: string;
+  running?: boolean;
+  isError?: boolean;
+}
+export interface ToolMessagePropsFixture extends Omit<SlotPropsFixture, 'props'> {
+  props: ToolMessageRenderProps;
+}
+/** The props a tool's timeline item receives, in any of its four states. */
+export declare function toolMessagePropsFixture(options: ToolMessagePropsOptions): ToolMessagePropsFixture;
+//#endregion
+//# sourceMappingURL=slotProps.d.mts.map

package/dist/src/web/services/testing/slotProps.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slotProps.d.mts","names":[],"sources":["../../../../../src/web/services/testing/slotProps.ts"],"mappings":";;;;;;;;;;;;;iBA0BiB;EACf;;EASA;;EAEA;;EAEA,UAAU;;EAEV,UAAU;;EAEV,QAAQ;;iBAGO;EACf,OAAO;;WAEE,kBAAkB;;EAE3B,mBAAmB;;iBAGJ;EACf;EACA,WAAW,SAAS;EACpB,mBAAmB;;EAEnB,cAAc,SAAS,eAAe;;EAEtC,WAAW,SAAS,wBAAwB;;EAE5C,UAAU,kBAAkB,UAAU,sBAAsB;;EAE5D,qBAAqB,mBAAmB,UAAU,sBAAsB;;EAExE,WAAW,iBAAiB;;EAE5B,kBAAkB,MAAM,kCAAkC;;wBAK5C,iBAAiB,UAAS,mBAAwB;iBA6CjD,gCAAgC;EAC/C;EACA;EACA,OAAO;;EAEP,SAAS;;EAET;EACA;EACA;;iBAGe,gCAAgC,KAAK;EACpD,OAAO;;;wBAMO,wBAAwB,SAAS,0BAA0B"}