@xopcai/xopc 0.0.321 → 0.0.324

package/dist/packages/gateway-contract/src/local-apps.js

@@ -0,0 +1,215 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { z } from "zod";
+//#region packages/gateway-contract/src/local-apps.ts
+var LocalAppSourceHashSchema, LocalAppStatusSchema, LocalAppInstallationStateSchema, LocalAppReleaseHealthSchema, LocalAppAcceptanceCheckSchema, LocalAppAcceptanceResultSchema, LocalAppAcceptanceInputSchema, LocalAppAcceptanceOutputSchema, LocalAppReleaseSchema, LocalAppRecordSchema, LocalAppAcceptanceRunSchema, LocalAppDetailSchema, LocalAppValidationIssueSchema, LocalAppChangedFileSchema, LocalAppAcceptanceScenarioSummarySchema, LocalAppValidationSchema, LocalAppPreviewSnapshotSchema, LocalAppDiagnosticPhaseSchema, LocalAppDiagnosticSchema, LocalAppFixGuidanceInputSchema, LocalAppRuntimeIssueSchema, LocalAppCriteriaScenarioResultSchema, LocalAppCriteriaResultSchema, runtimeEnvelope;
+var init_local_apps = __esmMin((() => {
+	LocalAppSourceHashSchema = z.string().regex(/^[a-f0-9]{64}$/);
+	LocalAppStatusSchema = z.enum([
+		"preview_ready",
+		"installed",
+		"degraded"
+	]);
+	LocalAppInstallationStateSchema = z.enum(["not_installed", "installed"]);
+	LocalAppReleaseHealthSchema = z.enum(["healthy", "failed"]);
+	LocalAppAcceptanceCheckSchema = z.strictObject({
+		id: z.enum([
+			"document",
+			"content",
+			"interaction",
+			"criteria"
+		]),
+		status: z.enum([
+			"passed",
+			"failed",
+			"skipped"
+		]),
+		message: z.string().trim().min(1).max(500)
+	});
+	LocalAppAcceptanceResultSchema = z.strictObject({
+		status: z.enum(["passed", "failed"]),
+		checks: z.array(LocalAppAcceptanceCheckSchema).min(1).max(10),
+		interactiveCount: z.number().int().min(0).max(1e4)
+	});
+	LocalAppAcceptanceInputSchema = LocalAppAcceptanceResultSchema.extend({ sourceHash: LocalAppSourceHashSchema }).refine((value) => value.checks.length >= 3 && value.checks.length <= 4, {
+		message: "Acceptance input must contain three or four checks",
+		path: ["checks"]
+	});
+	LocalAppAcceptanceOutputSchema = LocalAppAcceptanceInputSchema.safeExtend({
+		id: z.string().min(1),
+		appId: z.string().min(1),
+		createdAt: z.number().int().nonnegative()
+	});
+	LocalAppReleaseSchema = z.strictObject({
+		id: z.string().min(1),
+		appId: z.string().min(1),
+		version: z.number().int().positive(),
+		sourceHash: LocalAppSourceHashSchema,
+		healthStatus: LocalAppReleaseHealthSchema,
+		createdAt: z.number().int().nonnegative(),
+		activatedAt: z.number().int().nonnegative().optional(),
+		isActive: z.boolean()
+	});
+	LocalAppRecordSchema = z.strictObject({
+		id: z.string().min(1),
+		extensionId: z.string().min(1),
+		projectId: z.string().min(1),
+		name: z.string().min(1),
+		description: z.string().optional(),
+		idea: z.string().min(1),
+		status: LocalAppStatusSchema,
+		workspaceRoot: z.string().min(1),
+		draftVersion: z.number().int().positive(),
+		activeVersion: z.number().int().positive().optional(),
+		activeReleaseId: z.string().min(1).optional(),
+		installationState: LocalAppInstallationStateSchema,
+		enabled: z.boolean(),
+		createdAt: z.number().int().nonnegative(),
+		updatedAt: z.number().int().nonnegative(),
+		installedAt: z.number().int().nonnegative().optional()
+	});
+	LocalAppAcceptanceRunSchema = LocalAppAcceptanceOutputSchema;
+	LocalAppDetailSchema = LocalAppRecordSchema.extend({
+		draftPreviewUrl: z.string().startsWith("/api/local-apps/preview/"),
+		permissions: z.array(z.string()),
+		releases: z.array(LocalAppReleaseSchema),
+		acceptanceRuns: z.array(LocalAppAcceptanceRunSchema)
+	});
+	LocalAppValidationIssueSchema = z.strictObject({
+		code: z.string().trim().min(1).max(80),
+		severity: z.enum(["error", "warning"]),
+		message: z.string().trim().min(1).max(500)
+	});
+	LocalAppChangedFileSchema = z.strictObject({
+		path: z.string().min(1).max(4096),
+		status: z.enum([
+			"added",
+			"modified",
+			"deleted"
+		])
+	});
+	LocalAppAcceptanceScenarioSummarySchema = z.strictObject({
+		id: z.string().trim().min(1).max(80),
+		name: z.string().trim().min(1).max(120),
+		stepCount: z.number().int().nonnegative()
+	});
+	LocalAppValidationSchema = z.strictObject({
+		status: z.enum(["healthy", "failed"]),
+		checkedAt: z.number().int().nonnegative(),
+		sourceHash: LocalAppSourceHashSchema.optional(),
+		hasDraftChanges: z.boolean(),
+		changedFiles: z.array(LocalAppChangedFileSchema).max(50),
+		changedFileCount: z.number().int().nonnegative(),
+		permissions: z.array(z.string()),
+		permissionDelta: z.strictObject({
+			added: z.array(z.string()),
+			removed: z.array(z.string())
+		}),
+		acceptanceScenarioCount: z.number().int().nonnegative(),
+		acceptanceScenarios: z.array(LocalAppAcceptanceScenarioSummarySchema),
+		issues: z.array(LocalAppValidationIssueSchema).max(100)
+	});
+	LocalAppPreviewSnapshotSchema = z.strictObject({
+		appId: z.string().min(1),
+		sourceHash: LocalAppSourceHashSchema,
+		status: z.enum(["ready", "invalid"]),
+		createdAt: z.number().int().nonnegative(),
+		entryPath: z.string().min(1).max(4096).optional(),
+		previewUrl: z.string().startsWith("/api/local-apps/preview/").optional(),
+		validation: LocalAppValidationSchema
+	}).superRefine((snapshot, context) => {
+		const runnable = snapshot.status === "ready";
+		if (runnable !== Boolean(snapshot.entryPath)) context.addIssue({
+			code: "custom",
+			path: ["entryPath"],
+			message: "Ready snapshots require an entry path"
+		});
+		if (snapshot.previewUrl && !runnable) context.addIssue({
+			code: "custom",
+			path: ["previewUrl"],
+			message: "Invalid snapshots cannot have a preview URL"
+		});
+		if (snapshot.validation.sourceHash !== snapshot.sourceHash) context.addIssue({
+			code: "custom",
+			path: ["validation", "sourceHash"],
+			message: "Snapshot validation hash must match the snapshot"
+		});
+	});
+	LocalAppDiagnosticPhaseSchema = z.enum([
+		"build",
+		"boot",
+		"runtime",
+		"acceptance",
+		"runner",
+		"capability"
+	]);
+	LocalAppDiagnosticSchema = z.strictObject({
+		phase: LocalAppDiagnosticPhaseSchema,
+		message: z.string().trim().min(1).max(500),
+		code: z.string().trim().min(1).max(80).optional()
+	});
+	LocalAppFixGuidanceInputSchema = z.strictObject({
+		sourceHash: LocalAppSourceHashSchema.optional(),
+		locale: z.enum(["en", "zh"]).default("en"),
+		diagnostics: z.array(LocalAppDiagnosticSchema).min(1).max(20)
+	});
+	z.strictObject({
+		appId: z.string().min(1),
+		sourceHash: LocalAppSourceHashSchema.optional(),
+		owner: z.enum([
+			"generated_code",
+			"platform",
+			"configuration"
+		]),
+		action: z.enum([
+			"fix_code",
+			"retry",
+			"fix_config"
+		]),
+		diagnostics: z.array(LocalAppDiagnosticSchema).max(20),
+		prompt: z.string().min(1)
+	});
+	LocalAppRuntimeIssueSchema = z.strictObject({
+		kind: z.enum(["script_error", "unhandled_rejection"]),
+		message: z.string().trim().min(1).max(500),
+		filename: z.string().max(500).optional(),
+		line: z.number().nonnegative().optional(),
+		column: z.number().nonnegative().optional()
+	});
+	LocalAppCriteriaScenarioResultSchema = z.strictObject({
+		id: z.string().trim().min(1).max(80),
+		name: z.string().trim().min(1).max(120),
+		status: z.enum(["passed", "failed"]),
+		message: z.string().trim().min(1).max(500),
+		failureKind: z.enum(["scenario", "runner"]).default("scenario")
+	});
+	LocalAppCriteriaResultSchema = z.strictObject({
+		status: z.enum(["passed", "failed"]),
+		scenarioCount: z.number().int().min(0).max(10),
+		scenarios: z.array(LocalAppCriteriaScenarioResultSchema).max(10)
+	});
+	runtimeEnvelope = z.strictObject({
+		source: z.literal("xopc-local-app-preview"),
+		version: z.literal(1)
+	});
+	z.discriminatedUnion("type", [
+		runtimeEnvelope.extend({
+			type: z.literal("ready"),
+			detail: z.strictObject({ readyState: z.string().max(100).optional() })
+		}),
+		runtimeEnvelope.extend({
+			type: z.literal("error"),
+			detail: LocalAppRuntimeIssueSchema
+		}),
+		runtimeEnvelope.extend({
+			type: z.literal("acceptance"),
+			detail: LocalAppAcceptanceResultSchema
+		}),
+		runtimeEnvelope.extend({
+			type: z.literal("criteria"),
+			detail: LocalAppCriteriaResultSchema
+		})
+	]);
+}));
+//#endregion
+init_local_apps();
+export { LocalAppAcceptanceCheckSchema, LocalAppAcceptanceInputSchema, LocalAppAcceptanceOutputSchema, LocalAppAcceptanceResultSchema, LocalAppAcceptanceRunSchema, LocalAppAcceptanceScenarioSummarySchema, LocalAppChangedFileSchema, LocalAppCriteriaResultSchema, LocalAppCriteriaScenarioResultSchema, LocalAppDetailSchema, LocalAppDiagnosticPhaseSchema, LocalAppDiagnosticSchema, LocalAppFixGuidanceInputSchema, LocalAppInstallationStateSchema, LocalAppPreviewSnapshotSchema, LocalAppRecordSchema, LocalAppReleaseHealthSchema, LocalAppReleaseSchema, LocalAppRuntimeIssueSchema, LocalAppSourceHashSchema, LocalAppStatusSchema, LocalAppValidationIssueSchema, LocalAppValidationSchema, init_local_apps };

package/dist/packages/gateway-contract/src/notifications.js

@@ -28,19 +28,12 @@ var init_notifications = __esmMin((() => {
 			kind: z.literal("task"),
 			taskId: z.string().min(1)
 		}),
+		z.object({ kind: z.literal("home") }),
 		z.object({
 			kind: z.literal("automation_run"),
 			automationId: z.string().min(1),
 			runId: z.string().min(1)
 		}),
-		z.object({
-			kind: z.literal("proactive_digest"),
-			digestId: z.string().min(1)
-		}),
-		z.object({
-			kind: z.literal("insight"),
-			inboxItemId: z.string().min(1)
-		}),
 		z.object({
 			kind: z.literal("work_discovery"),
 			runId: z.string().min(1),
@@ -58,9 +51,9 @@ var init_notifications = __esmMin((() => {
 		"task.completed",
 		"automation.completed",
 		"automation.failed",
-		"proactive.insight",
 		"work_discovery.completed",
-		"work_discovery.failed"
+		"work_discovery.failed",
+		"home.opportunity"
 	]);
 	NotificationLocalizedTextSchema = z.object({
 		en: z.string().min(1).max(500),

package/dist/packages/gateway-contract/src/product-delivery.js

@@ -1,4 +1,6 @@
 import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+import { ChatPreviewSourceHashSchema, init_chat_previews } from "./chat-previews.js";
+import { LocalAppSourceHashSchema, init_local_apps } from "./local-apps.js";
 import { z } from "zod";
 //#region packages/gateway-contract/src/product-delivery.ts
 function parseProductDeliveryEnvelope(value) {
@@ -7,7 +9,25 @@ function parseProductDeliveryEnvelope(value) {
 }
 function appendProductDeliveryText(text, delivery) {
 	if (!delivery) return text;
-	return `${text}${delivery.primary ? `\nOpen in xopc: [Open](${productReferenceDeepLink(delivery.primary)})` : delivery.presentation?.kind === "table" && delivery.presentation.items.length ? `\nOpen in xopc: ${delivery.presentation.items.map((item, index) => `[${index + 1}](${productReferenceDeepLink(item)})`).join(" · ")}` : ""}\n${PRODUCT_DELIVERY_TEXT_PREFIX}${encodeURIComponent(JSON.stringify(delivery))}`;
+	const openableItems = delivery.presentation?.kind === "table" ? delivery.presentation.items.filter((item) => productReferenceRoute(item) !== null) : [];
+	return `${text}${delivery.primary && productReferenceRoute(delivery.primary) !== null ? `\nOpen in xopc: [Open](${productReferenceDeepLink(delivery.primary)})` : openableItems.length ? `\nOpen in xopc: ${openableItems.map((item, index) => `[${index + 1}](${productReferenceDeepLink(item)})`).join(" · ")}` : ""}\n${PRODUCT_DELIVERY_TEXT_PREFIX}${encodeURIComponent(JSON.stringify(delivery))}`;
+}
+function productReferenceRoute(reference) {
+	const id = encodeURIComponent(reference.id);
+	switch (reference.kind) {
+		case "task": return `/tasks/${id}`;
+		case "project": return `/projects/${id}`;
+		case "note": return `/notes/${id}`;
+		case "workflow_definition": return `/workflows/${id}`;
+		case "workflow_run": return `/workflows/runs/${id}`;
+		case "automation": return `/automations?automation=${id}`;
+		case "scene": return `/scenes/${id}`;
+		case "local_app": return `/local-apps/${id}`;
+		case "chat_preview": return null;
+		case "session": return `/chat/${id}`;
+		case "settings": return `/settings/${reference.id.replace(/^\/+/, "").split("/").map(encodeURIComponent).join("/")}`;
+		case "file": return null;
+	}
 }
 function productReferenceDeepLink(reference) {
 	return `xopc://open?${new URLSearchParams({
@@ -17,6 +37,8 @@ function productReferenceDeepLink(reference) {
 }
 var ProductReferenceKindSchema, ProductCapabilitySchema, ProductReferenceSchema, ProductDeliveryOperationSchema, ProductDeliveryPresentationSchema, ProductDeliveryEnvelopeSchema, PRODUCT_DELIVERY_TEXT_PREFIX;
 var init_product_delivery = __esmMin((() => {
+	init_chat_previews();
+	init_local_apps();
 	ProductReferenceKindSchema = z.enum([
 		"task",
 		"project",
@@ -26,6 +48,7 @@ var init_product_delivery = __esmMin((() => {
 		"automation",
 		"scene",
 		"local_app",
+		"chat_preview",
 		"file",
 		"session",
 		"settings"
@@ -35,6 +58,7 @@ var init_product_delivery = __esmMin((() => {
 		"preview",
 		"edit",
 		"continue_in_chat",
+		"fix",
 		"run",
 		"pause",
 		"resume",
@@ -60,22 +84,43 @@ var init_product_delivery = __esmMin((() => {
 		"completed",
 		"failed"
 	]);
-	ProductDeliveryPresentationSchema = z.discriminatedUnion("kind", [z.object({
-		kind: z.literal("table"),
-		items: z.array(ProductReferenceSchema).max(50),
-		truncated: z.boolean()
-	}), z.object({
-		kind: z.literal("diff"),
-		title: z.string().max(2e3),
-		truncated: z.boolean(),
-		edits: z.array(z.object({
-			from: z.number().int().nonnegative(),
-			to: z.number().int().nonnegative(),
-			text: z.string().max(16e3)
-		}).refine((edit) => edit.to >= edit.from, "Invalid replacement range")).max(20).refine((edits) => edits.reduce((total, edit) => total + edit.text.length, 0) <= 16e3, "Replacement text exceeds preview limit")
-	})]);
+	ProductDeliveryPresentationSchema = z.discriminatedUnion("kind", [
+		z.object({
+			kind: z.literal("table"),
+			items: z.array(ProductReferenceSchema).max(50),
+			truncated: z.boolean()
+		}),
+		z.object({
+			kind: z.literal("diff"),
+			title: z.string().max(2e3),
+			truncated: z.boolean(),
+			edits: z.array(z.object({
+				from: z.number().int().nonnegative(),
+				to: z.number().int().nonnegative(),
+				text: z.string().max(16e3)
+			}).refine((edit) => edit.to >= edit.from, "Invalid replacement range")).max(20).refine((edits) => edits.reduce((total, edit) => total + edit.text.length, 0) <= 16e3, "Replacement text exceeds preview limit")
+		}),
+		z.object({
+			kind: z.literal("inline_app"),
+			reference: ProductReferenceSchema.refine((reference) => reference.kind === "local_app", "Inline app must reference a local app"),
+			snapshot: z.strictObject({ sourceHash: LocalAppSourceHashSchema }),
+			preferredHeight: z.number().int().min(240).max(720).default(480)
+		}).refine((presentation) => !presentation.reference.revision || presentation.reference.revision === presentation.snapshot.sourceHash, {
+			message: "Inline app reference revision must match its snapshot",
+			path: ["reference", "revision"]
+		}),
+		z.object({
+			kind: z.literal("inline_preview"),
+			reference: ProductReferenceSchema.refine((reference) => reference.kind === "chat_preview", "Inline preview must reference a chat preview"),
+			sourceHash: ChatPreviewSourceHashSchema,
+			preferredHeight: z.number().int().min(240).max(720).default(480)
+		}).refine((presentation) => !presentation.reference.revision || presentation.reference.revision === presentation.sourceHash, {
+			message: "Inline preview reference revision must match its source",
+			path: ["reference", "revision"]
+		})
+	]);
 	ProductDeliveryEnvelopeSchema = z.object({
-		version: z.literal(1),
+		version: z.literal(2),
 		operation: ProductDeliveryOperationSchema,
 		primary: ProductReferenceSchema.optional(),
 		related: z.array(ProductReferenceSchema).optional(),
@@ -85,4 +130,4 @@ var init_product_delivery = __esmMin((() => {
 }));
 //#endregion
 init_product_delivery();
-export { ProductCapabilitySchema, ProductDeliveryEnvelopeSchema, ProductDeliveryOperationSchema, ProductDeliveryPresentationSchema, ProductReferenceKindSchema, ProductReferenceSchema, appendProductDeliveryText, init_product_delivery, parseProductDeliveryEnvelope, productReferenceDeepLink };
+export { ProductCapabilitySchema, ProductDeliveryEnvelopeSchema, ProductDeliveryOperationSchema, ProductDeliveryPresentationSchema, ProductReferenceKindSchema, ProductReferenceSchema, appendProductDeliveryText, init_product_delivery, parseProductDeliveryEnvelope, productReferenceDeepLink, productReferenceRoute };

package/dist/packages/gateway-contract/src/user-turn-document.js

@@ -0,0 +1,60 @@
+import { __esmMin } from "../../../_virtual/_rolldown/runtime.js";
+//#region packages/gateway-contract/src/user-turn-document.ts
+function contextRefWireTokenRe() {
+	return new RegExp(CONTEXT_REF_TOKEN_RE.source, "g");
+}
+function parseUserTurnDocument(wire) {
+	const parts = [];
+	const re = contextRefWireTokenRe();
+	let last = 0;
+	let match;
+	while ((match = re.exec(wire)) !== null) {
+		if (match.index > last) parts.push({
+			type: "text",
+			text: wire.slice(last, match.index)
+		});
+		parts.push({
+			type: "context_ref",
+			refId: match[1] ?? ""
+		});
+		last = match.index + match[0].length;
+	}
+	if (parts.length === 0) return null;
+	if (last < wire.length) parts.push({
+		type: "text",
+		text: wire.slice(last)
+	});
+	return {
+		version: 1,
+		parts
+	};
+}
+function userTurnDocumentRefIds(document) {
+	return document.parts.flatMap((part) => part.type === "context_ref" ? [part.refId] : []);
+}
+function renderUserTurnDocument(document, resolveLabel) {
+	return document.parts.map((part) => {
+		if (part.type === "text") return part.text;
+		const title = resolveLabel(part.refId)?.trim();
+		return title ? `@${title}` : "";
+	}).join("");
+}
+function isUserTurnDocument(value) {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const row = value;
+	if (row.version !== 1 || !Array.isArray(row.parts)) return false;
+	return row.parts.every((part) => {
+		if (!part || typeof part !== "object" || Array.isArray(part)) return false;
+		const candidate = part;
+		return candidate.type === "text" ? typeof candidate.text === "string" : candidate.type === "context_ref" && typeof candidate.refId === "string" && new RegExp(`^${CONTEXT_REF_ID_PATTERN}$`).test(candidate.refId);
+	});
+}
+var CONTEXT_REF_TOKEN_PREFIX, CONTEXT_REF_ID_PATTERN, CONTEXT_REF_TOKEN_RE;
+var init_user_turn_document = __esmMin((() => {
+	CONTEXT_REF_TOKEN_PREFIX = "@xopc-ref:";
+	CONTEXT_REF_ID_PATTERN = "[A-Za-z0-9_-]{1,64}";
+	CONTEXT_REF_TOKEN_RE = new RegExp(`${CONTEXT_REF_TOKEN_PREFIX}(${CONTEXT_REF_ID_PATTERN})`, "g");
+}));
+//#endregion
+init_user_turn_document();
+export { contextRefWireTokenRe, init_user_turn_document, isUserTurnDocument, parseUserTurnDocument, renderUserTurnDocument, userTurnDocumentRefIds };

package/dist/src/activity/emitter.js

@@ -2,9 +2,10 @@ import { currentActivityActor, currentActivityInitiator, currentActivitySource }
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { ActivityService } from "./service.js";
 //#region src/activity/emitter.ts
+init_sqlite();
 init_logger();
 const log = createLogger("ActivityEmitter");
 const activityService = new ActivityService();

package/dist/src/activity/service.js

@@ -1,7 +1,8 @@
 import { createObjectLinkRecord, deleteObjectLinkRecord, getActivityEventRecord, listActivityRecords, listObjectActivityRecords, listObjectLinkRecords, listProjectActivityRecords, recordActivityEvent } from "../storage/sqlite/activity-repository.js";
-import "../storage/sqlite/index.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
 import { randomUUID } from "node:crypto";
 //#region src/activity/service.ts
+init_sqlite();
 function normalizeLimit(limit) {
 	return Math.max(1, Math.min(100, Math.floor(limit ?? 50)));
 }

package/dist/src/agent/agent-manager.d.ts

@@ -98,8 +98,10 @@ export interface AgentManagerConfig {
     getProjectService?: () => ProjectService | undefined;
     getWorkDiscovery?: () => import('../work-discovery/service.js').WorkDiscoveryService | undefined;
     getLocalAppService?: () => import('../local-apps/index.js').LocalAppService | undefined;
+    getChatPreviewService?: () => import('../chat-previews/index.js').ChatPreviewService | undefined;
     dispatchTaskEvents?: () => void;
     dispatchTaskRuns?: () => void;
+    onAgentCatalogMutate?: () => void;
     /** Gateway: starts persisted workflow runs (dedicated chat session per run). */
     getWorkflowRunService?: () => import('../workflows/service/workflow-run-service.types.js').WorkflowRunServiceLike | undefined;
     /** Runtime notification for UI/CLI shells that cache skill catalogs. */
@@ -180,7 +182,7 @@ export declare class AgentManager implements AgentInstanceGateway {
     private pickDefaultModelRef;
     private resolveModelStringToModel;
     /**
-     * Keep defaults in sync when config is hot-reloaded or saved from the UI.
+     * Refresh config-backed services and SQLite-backed Agent defaults after a settings change.
      *
      * The previous implementation rebuilt the entire `AgentToolsFactory` (80+ lines
      * of dependency wiring) on every reload. The factory's deps are now built from
@@ -189,7 +191,7 @@ export declare class AgentManager implements AgentInstanceGateway {
      * reconstruction. The browser is still shut down because its cached settings
      * (headless mode, backend choice) come from the config snapshot at connect time.
      */
-    updateAgentDefaults(config: Config): void;
+    updateRuntimeConfiguration(config: Config): void;
     /**
      * Construct the dep bag passed to `AgentToolsFactory`. Closures reference
      * `this.*` so they remain valid across hot reloads (no rebuild needed).