@teamscala/service-boot 0.23.524 → 0.23.525

package/src/resource-chat-inject.page-assistant.test.ts

@@ -1,145 +0,0 @@
-// @system codegen
-// @status generated
-// @edit change the suite in the owned-suites band, then re-run codegen. Hand-edits are overwritten.
-//
-// This suite's assertions are OWNED by the codegen band: the band module
-// carries them verbatim, this file is the emission, and hand edits here are
-// overwritten on the next run. The rationale each assertion carries moved
-// with it into the band.
-
-import { describe, expect, mock, test } from "bun:test";
-
-/** The ONE active launcher block_schema slug — the Puck registry key. */
-const REGISTERED_LAUNCHER_SLUG = "ResourceLauncher";
-
-mock.module("@teamscala/db/registry/load-config", () => ({
-	loadRegistryConfig: async () => ({ agentId: "agent-1" }),
-}));
-mock.module("./page-server-orpc/server-client.ts", () => ({
-	getServerClient: () => ({
-		ai_agents: {
-			findFirst: async () => ({
-				name: "Results Assistant",
-				welcome_message: "Hi! Ask me anything about your results.",
-				conversation_starters: ["What are my strengths?"],
-				primary_color: "#6366f1",
-			}),
-		},
-	}),
-}));
-mock.module("@teamscala/logger/app-loggers", () => ({
-	getAppLogger: () => ({ error: (...args: unknown[]) => void args }),
-}));
-
-const { injectResourceChatLauncher } = await import("./resource-chat-inject.ts");
-
-const ORG = "org-1";
-const AGENT_OPTS = {
-	agentConfigSlug: "assessment-assistant-agent" as never,
-	launchLabel: "Ask about your results",
-	placeholder: "Ask about your results…",
-	regionSlots: ["header", "body", "footer"] as readonly string[],
-};
-
-/** A resolved response row as the loader's response source selects it. */
-const RESPONSE_ROW = {
-	id: "resp-1",
-	assessment_id: "asm-1",
-	organisation_id: ORG,
-	total_score: 64,
-	first_name: "Anna",
-};
-
-/** The paired key as resolveReportHalves returns it — present on EVERY link
- *  shape, carrying the anchor half's organisation. */
-const PAIRED = {
-	response: RESPONSE_ROW,
-	research: { id: "research-live", assessment_id: "asm-1", organisation_id: ORG },
-	assessment_id: "asm-1",
-	organisation_id: ORG,
-};
-
-function pageGraph(
-	responseSource: unknown,
-	pairSource: Record<string, unknown>,
-): Record<string, unknown> {
-	return {
-		response: responseSource,
-		pair: pairSource,
-		quiz: { id: "asm-1", organisation_id: ORG, title: "Authority Index" },
-		brand: { primaryColor: "#123456" },
-		body: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-		header: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-		footer: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-	};
-}
-
-/** The launcher renders `position: fixed`, so it may land in whichever
- *  region slot is declared first — count across EVERY slot, not one. */
-function launcherBlocks(
-	resolved: Record<string, unknown>,
-): Array<{ type: string; props?: Record<string, unknown> }> {
-	const out: Array<{ type: string; props?: Record<string, unknown> }> = [];
-	for (const slot of AGENT_OPTS.regionSlots) {
-		const content = (
-			resolved[slot] as {
-				puck_data?: { content?: Array<{ type: string; props?: Record<string, unknown> }> };
-			}
-		).puck_data?.content;
-		for (const block of content ?? []) {
-			if (block.type === REGISTERED_LAUNCHER_SLUG) out.push(block);
-		}
-	}
-	return out;
-}
-
-async function launcherCount(
-	responseSource: unknown,
-	pairSource: Record<string, unknown>,
-	resourceKey: string,
-): Promise<number> {
-	const resolved = pageGraph(responseSource, pairSource);
-	await injectResourceChatLauncher(resolved, "", { ...AGENT_OPTS, resourceKey });
-	return launcherBlocks(resolved).length;
-}
-
-describe("page assistant renders on every link shape", () => {
-	test("response-id link: raw hit exists, launcher renders", async () => {
-		expect(await launcherCount(RESPONSE_ROW, PAIRED, "pair")).toBe(1);
-	});
-
-	test("live research-anchor link: raw hit is null, launcher still renders", async () => {
-		expect(await launcherCount(null, PAIRED, "pair")).toBe(1);
-	});
-
-	test("superseded research-anchor link: raw hit is null, launcher still renders", async () => {
-		// identical graph shape to the live anchor — resolution to the live
-		// pass happens upstream in the pair resolver, so the injection surface
-		// is the same and is exercised identically
-		expect(await launcherCount(null, PAIRED, "pair")).toBe(1);
-	});
-
-	test("the launcher block carries the agent, org scope and context", async () => {
-		const resolved = pageGraph(null, PAIRED);
-		await injectResourceChatLauncher(resolved, "viewer@example.com", {
-			...AGENT_OPTS,
-			resourceKey: "pair",
-		});
-		const launchers = launcherBlocks(resolved);
-		expect(launchers.length).toBe(1);
-		const launcher = launchers[0];
-		expect(launcher.props.agentId).toBe("agent-1");
-		expect(launcher.props.organisationId).toBe(ORG);
-		expect(typeof launcher.props.runtimeContext).toBe("string");
-		expect((launcher.props.runtimeContext as string).length).toBeGreaterThan(0);
-	});
-
-	test("the DEFECT SHAPE: keying the raw response hit on an anchor link silently renders none", async () => {
-		// resource_key "response" + a null raw hit is the 2026-09-08 regression.
-		// The injector contract is fail-soft for the render, so the absence is
-		// quiet — this pins the shape with the reason spelled out, so the row
-		// can never go back to a key that is null on anchor links without the
-		// next reader finding this.
-		expect(await launcherCount(null, PAIRED, "response")).toBe(0);
-	});
-});

package/src/resource-chat-inject.test.ts

@@ -1,240 +0,0 @@
-// @system codegen
-// @status generated
-// @edit change the suite in the owned-suites band, then re-run codegen. Hand-edits are overwritten.
-//
-// This suite's assertions are OWNED by the codegen band: the band module
-// carries them verbatim, this file is the emission, and hand edits here are
-// overwritten on the next run. The rationale each assertion carries moved
-// with it into the band.
-
-import { describe, expect, mock, test } from "bun:test";
-
-/** The ONE active launcher block_schema slug — the Puck registry key. */
-const REGISTERED_LAUNCHER_SLUG = "ResourceLauncher";
-
-mock.module("@teamscala/db/registry/load-config", () => ({
-	loadRegistryConfig: async () => ({ agentId: "agent-1" }),
-}));
-mock.module("./page-server-orpc/server-client.ts", () => ({
-	getServerClient: () => ({
-		ai_agents: {
-			findFirst: async () => ({
-				name: "Agreement Assistant",
-				welcome_message: "Hi! Ask me anything about this agreement.",
-				conversation_starters: ["What are the key terms?", "How do I sign this?"],
-				primary_color: "#6366f1",
-			}),
-		},
-	}),
-}));
-mock.module("@teamscala/logger/app-loggers", () => ({
-	getAppLogger: () => ({ error: () => {} }),
-}));
-
-const { injectResourceChatLauncher } = await import("./resource-chat-inject.ts");
-
-function makeResolved(resourceKey: string): Record<string, unknown> {
-	return {
-		[resourceKey]: { organisation_id: "org-1", name: "Demo" },
-		brand: { primaryColor: "#123456" },
-		page: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-	};
-}
-
-function pushedBlocks(resolved: Record<string, unknown>) {
-	const pd = (
-		resolved.page as {
-			puck_data: { content: Array<{ type: string; props?: Record<string, unknown> }> };
-		}
-	).puck_data;
-	return pd.content;
-}
-
-describe("chat injectors — pushed block name resolves to a registered block", () => {
-	test("the generic resource injector pushes the registered launcher slug", async () => {
-		const resolved = makeResolved("agreement");
-		await injectResourceChatLauncher(resolved, "viewer@example.com", {
-			resourceKey: "agreement",
-			agentConfigSlug: "agreement-assistant-agent",
-			launchLabel: "Ask about this agreement",
-		});
-		const blocks = pushedBlocks(resolved);
-		expect(blocks).toHaveLength(1);
-		expect(blocks[0].type).toBe(REGISTERED_LAUNCHER_SLUG);
-	});
-
-	test("neither injector pushes a pre-consolidation launcher name", async () => {
-		const a = makeResolved("agreement");
-		await injectResourceChatLauncher(a, "viewer@example.com", {
-			resourceKey: "agreement",
-			agentConfigSlug: "agreement-assistant-agent",
-			launchLabel: "Ask about this agreement",
-		});
-		const p = makeResolved("proposal");
-		await injectResourceChatLauncher(p, "viewer@example.com", {
-			resourceKey: "proposal",
-			agentConfigSlug: "proposal-assistant-agent",
-			launchLabel: "Ask about this proposal",
-		});
-
-		const dead = ["ResourceChatLauncher", "ChatLauncherBlock"];
-		for (const blocks of [pushedBlocks(a), pushedBlocks(p)]) {
-			for (const block of blocks) {
-				expect(dead).not.toContain(block.type);
-			}
-		}
-	});
-
-	test("the assistant's words come from the agent row, not the caller", async () => {
-		// THE REGRESSION THIS PINS: title, welcome message and starters used to
-		// be string literals in the injectors while ai_agents held a blank
-		// column for each. Whoever changed the row saw no change on the page.
-		const resolved = makeResolved("agreement");
-		await injectResourceChatLauncher(resolved, "viewer@example.com", {
-			resourceKey: "agreement",
-			agentConfigSlug: "agreement-assistant-agent",
-			launchLabel: "Ask about this agreement",
-		});
-		const props = pushedBlocks(resolved)[0].props ?? {};
-		expect(props.title).toBe("Agreement Assistant");
-		expect(props.welcomeMessage).toBe("Hi! Ask me anything about this agreement.");
-		expect(props.conversationStarters).toEqual([
-			"What are the key terms?",
-			"How do I sign this?",
-		]);
-		// launchLabel has no column yet, so it is still the caller's.
-		expect(props.launchLabel).toBe("Ask about this agreement");
-	});
-});
-
-/** A region-slot page — the shape a quiz report resolves (no `page` source). */
-function makeAssessmentResolved(): Record<string, unknown> {
-	return {
-		response: {
-			organisation_id: "org-1",
-			email: "reader@example.com",
-			total_score: 95,
-			category_scores: { "Be Seen": 100, "Be Chosen": 83 },
-		},
-		quiz: { id: "quiz-1", report_title: "The Launcha Authority Index" },
-		reportData: { narrative: "You are strongest at being seen." },
-		brand: { primaryColor: "#123456" },
-		header: { puck_data: { content: [{ type: "SiteHeader" }] } },
-		body: { puck_data: { root: { props: {} }, zones: {}, content: [] } },
-		footer: { puck_data: { content: [{ type: "SiteFooter" }] } },
-	};
-}
-
-/** The launcher's props, wherever in the graph it was attached. */
-function launcherProps(resolved: Record<string, unknown>): Record<string, unknown> {
-	for (const value of Object.values(resolved)) {
-		const content = (value as { puck_data?: { content?: unknown } } | null)?.puck_data
-			?.content;
-		if (!Array.isArray(content)) continue;
-		const launcher = (content as Array<{ type: string; props?: Record<string, unknown> }>).find(
-			(block) => block.type === REGISTERED_LAUNCHER_SLUG,
-		);
-		if (launcher) return launcher.props ?? {};
-	}
-	throw new Error("no launcher block was attached to any region");
-}
-
-function bodyBlocks(resolved: Record<string, unknown>) {
-	return (
-		resolved.body as {
-			puck_data: { content: Array<{ type: string; props?: Record<string, unknown> }> };
-		}
-	).puck_data.content;
-}
-
-/**
- * REGION SLOTS COME FROM THE LOADER ROW, exactly as the caller reads them —
- * the injector is never allowed to guess which resolved keys hold content.
- */
-const assessmentOpts = {
-	resourceKey: "response",
-	agentConfigSlug: "assessment-assistant-agent" as never,
-	launchLabel: "Ask about your results",
-	regionSlots: ["header", "body", "footer"],
-};
-
-describe("region-slot pages (a generated report, not an authored document)", () => {
-	test("attaches to a declared region when there is no `page` source", async () => {
-		// THE DEFECT THIS PINS: the injector read resolved.page.puck_data.content
-		// and returned early when absent. A generated report resolves region
-		// slots instead, so the early return fired and the assistant was
-		// silently missing — fail-soft, so nothing was logged.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		// The first declared slot holding a content tree. The launcher is
-		// position:fixed, so any rendered region shows it identically.
-		const header = (
-			resolved.header as { puck_data: { content: Array<{ type: string }> } }
-		).puck_data.content;
-		expect(header.map((block) => block.type)).toContain(REGISTERED_LAUNCHER_SLUG);
-	});
-
-	test("follows the loader's slot order rather than a hardcoded key", async () => {
-		// Reordering the row must move the launcher. If this passes while the
-		// code names "body", the derivation is a literal wearing a costume.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", {
-			...assessmentOpts,
-			regionSlots: ["body", "header", "footer"],
-		});
-		expect(bodyBlocks(resolved).map((block) => block.type)).toContain(
-			REGISTERED_LAUNCHER_SLUG,
-		);
-	});
-
-	test("sends the assessment RESULT, not just the rendered page", async () => {
-		// A report's body page is a shared template — one builda_pages row serves
-		// every respondent — so the content tree holds zero personal facts. An
-		// assistant given only the page would know nothing about this reader.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		expect(context).toContain("total_score");
-		expect(context).toContain("95");
-		expect(context).toContain("Be Chosen");
-		expect(context).toContain("You are strongest at being seen.");
-		expect(context).toContain("The Launcha Authority Index");
-	});
-
-	test("sends the rendered document too, not just the result", async () => {
-		// The mirror of the test above: the reader is asking about what is on
-		// screen, so the assistant needs the document as well as the data.
-		const resolved = makeAssessmentResolved();
-		(
-			resolved.body as { puck_data: { content: unknown[] } }
-		).puck_data.content.push({ type: "ScoreDial", props: { label: "Authority" } });
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		expect(context).toContain("ScoreDial");
-		expect(context).toContain("Authority");
-	});
-
-	test("names no resolved key — it sends whatever the loader produced", async () => {
-		// THE REGRESSION THIS PINS: a draft excluded brand/website/header/footer
-		// by name, which is a loader row copied into TypeScript. Those keys are
-		// database facts, so the serialiser must not have opinions about them —
-		// it walks the graph and a loader edit propagates with no code change.
-		const resolved = makeAssessmentResolved();
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		for (const key of Object.keys(resolved)) {
-			expect(context).toContain(key);
-		}
-	});
-
-	test("carries a source a future loader adds, with no edit here", async () => {
-		// The serialiser walks the graph rather than naming keys, so a loader
-		// resolving a new source reaches the assistant for free.
-		const resolved = makeAssessmentResolved();
-		resolved.benchmarks = { industryMedian: 62 };
-		await injectResourceChatLauncher(resolved, "reader@example.com", assessmentOpts);
-		const context = String(launcherProps(resolved).runtimeContext ?? "");
-		expect(context).toContain("industryMedian");
-		expect(context).toContain("62");
-	});
-});