@xopcai/xopc 0.0.321 → 0.0.324

package/dist/src/gateway/service.js

@@ -5,31 +5,31 @@ import { init_log_stream, subscribeToLogs } from "../utils/logger/log-stream.js"
 import { getRuntimeLogStats } from "../utils/logger/stats.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { closeXopcDatabase, openXopcDatabase } from "../storage/sqlite/connection.js";
+import { closeXopcDatabase } from "../storage/sqlite/connection.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
-import { getBrowserTabBindingById } from "../storage/sqlite/browser-tab-binding-repository.js";
+import { getBrowserTabBindingById, init_browser_tab_binding_repository } from "../storage/sqlite/browser-tab-binding-repository.js";
 import { findSessionInput, init_session_input_repository, insertSessionInput } from "../storage/sqlite/session-input-repository.js";
 import { TaskRepository } from "../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../tasks/task-run-repository.js";
 import { init_changes, notifyUserContextChange } from "../user-context/changes.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
-import { init_session_repository, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
-import { getSessionConfig } from "../storage/sqlite/config-repository.js";
-import "../storage/sqlite/index.js";
+import { init_session_repository, listSessionMetadata, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
+import { getSessionConfig, init_config_repository } from "../storage/sqlite/config-repository.js";
+import { init_sqlite } from "../storage/sqlite/index.js";
+import { normalizeAgentId } from "../agent-catalog/id.js";
+import { init_agent_scope, listAgentEntries, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
+import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
+import { init_config, resolveKnowledgeReadPolicy } from "../user-context/config.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
-import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_agent_session_key, resolveAgentMainConversationId } from "../routing/agent-session-key.js";
 import { init_session_key, resolveConversationId, sanitizeSegment } from "../routing/session-key.js";
 import { getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
-import { init_paths, resolveConfigPath, resolveExtensionsDir } from "../config/paths.js";
-import { areExtensionsGloballyDisabled } from "../extensions/discover-extensions.js";
-import { buildExtensionMetadataSnapshot } from "../extensions/extension-metadata-snapshot.js";
-import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot, init_channel_catalog_service } from "../channels/catalog/channel-catalog-service.js";
-import { loadConfig, saveConfig } from "../config/loader.js";
 import { prewarmModelRegistry } from "../providers/model-registry.js";
 import { init_providers, providers_exports } from "../providers/index.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
+import { listKnowledgeItems } from "../knowledge-memory/repository.js";
+import "../knowledge-memory/index.js";
 import { getEmbeddedExecutionSession } from "../agent/embedded/execution-context.js";
 import { disposeAllSessionMcpRuntimes } from "../agent/mcp/bundle-mcp-runtime.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
@@ -52,18 +52,24 @@ import "../automations/index.js";
 import { TaskRunDispatcher } from "../tasks/task-run-dispatcher.js";
 import "../tasks/index.js";
 import "../agent/mcp/bundle-mcp-tools.js";
+import { areExtensionsGloballyDisabled } from "../extensions/discover-extensions.js";
 import { SessionIndex } from "../session/manager.js";
 import "../session/index.js";
 import { ExtensionLoader } from "../extensions/loader.js";
+import { buildExtensionMetadataSnapshot } from "../extensions/extension-metadata-snapshot.js";
 import "../extensions/index.js";
+import { buildChannelCatalogForConfig, buildChannelCatalogFromSnapshot } from "../channels/catalog/channel-catalog-service.js";
+import { loadConfig, saveConfig } from "../config/loader.js";
 import { MessageBus, MessageBusShutdownError } from "../infra/bus/queue.js";
 import "../infra/bus/index.js";
 import { collectMediaUrisFromMessages, deleteMediaUris } from "../media/session-references.js";
 import { AgentService } from "../agent/service.js";
-import { ensureStarterAgentsInitialized } from "../agent/starter-agents.js";
+import { bootstrapApplicationStateSync } from "../bootstrap/application-state.js";
 import { setPairingBroadcastSink } from "../channels/pairing/pairing-events.js";
 import { registerClarificationChannelRuntime } from "./clarify-runtime.js";
 import { ChannelManager } from "../channels/manager.js";
+import { ChatPreviewService } from "../chat-previews/service.js";
+import "../chat-previews/index.js";
 import { getWorkspacePath } from "../config/workspace-path-helpers.js";
 import "../config/index.js";
 import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
@@ -100,6 +106,7 @@ import { WorkflowRunService } from "../workflows/service/workflow-run-service.js
 import { WorkflowSessionBridge } from "../workflows/service/workflow-session-bridge.js";
 import { EphemeralSideChatManager } from "./side-chat/manager.js";
 import { SideChatRunService } from "./side-chat/run-service.js";
+import { SideChatPromotionService } from "./side-chat/promotion-service.js";
 import "./side-chat/index.js";
 import { wireTunnelEventsToGateway } from "../tunnel/gateway-lifecycle.js";
 import { getExposureManager } from "../remote-access/exposure-manager.js";
@@ -112,7 +119,6 @@ import { assertGatewayRuntimeConfig } from "./runtime-config.js";
 import { auditGatewayConfig } from "./security/audit.js";
 import { getXopcCloudCatalogCoordinator } from "../providers/xopc-cloud-catalog-coordinator.js";
 import { ModelCatalogSyncService } from "../providers/model-catalog-sync-service.js";
-import { runBootstrapMigrationsSync } from "../migrations/runner.js";
 import { NotificationService } from "../notifications/service.js";
 import "../local-apps/index.js";
 import { createRuntimeBrowserAutomationService } from "../browser/automations/runtime-service.js";
@@ -134,14 +140,19 @@ import { createGatewayStartupTrace } from "./startup-trace.js";
 import { GatewaySceneHost } from "./scenes/host.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
+import { HomeIntelligenceHost } from "../home-intelligence/host.js";
+import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
+import { HomeSnapshotBuilder } from "../home-intelligence/snapshot.js";
+import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
 import crypto from "node:crypto";
 //#region src/gateway/service.ts
 init_session_repository();
 init_agent_session_key();
+init_browser_tab_binding_repository();
 init_session_input_repository();
+init_config_repository();
 init_changes();
 init_agent_scope();
-init_channel_catalog_service();
 init_schema();
 init_providers();
 init_logger();
@@ -150,8 +161,10 @@ init_paths();
 init_package_version();
 init_resolve_route();
 init_session_key();
+init_sqlite();
 init_task_run_repository();
 init_transaction();
+init_config();
 const log = createLogger("Gateway:Service");
 var GatewayService = class {
 	bus;
@@ -165,6 +178,7 @@ var GatewayService = class {
 	extensionLoader = null;
 	extensionMetadataSnapshot = null;
 	sceneHost = null;
+	homeIntelligenceHost = null;
 	sessionIndex;
 	running = false;
 	startTime = Date.now();
@@ -192,7 +206,7 @@ var GatewayService = class {
 			const messages = await this.sessionIndex.loadMessages(conversationId);
 			const after = await this.sessionIndex.getSessionMetadata(conversationId);
 			if (after?.transcriptId !== expectedTranscriptId) throw new Error("Conversation changed while loading voice context");
-			const profile = resolveEffectiveAgentProfileForSession(this.config, conversationId);
+			const profile = resolveEffectiveAgentProfileForSession(conversationId);
 			const persona = buildVoicePersonaContext({
 				getConfig: () => this.config,
 				conversationId,
@@ -301,6 +315,7 @@ var GatewayService = class {
 	/** Process-local, non-persistent side conversations forked from durable sessions. */
 	sideChats;
 	sideChatRuns;
+	sideChatPromotions;
 	/**
 	* Session CRUD / search / compaction / tag-archive-pin / stats — the gateway
 	* REST surface for sessions. Routes should depend on this narrow service
@@ -329,6 +344,8 @@ var GatewayService = class {
 	discussionSealer;
 	/** Local user-created apps, their coder projects, previews, and installs. */
 	localApps;
+	/** Immutable, conversation-scoped UI previews that do not create projects. */
+	chatPreviews;
 	get sceneAccess() {
 		return this.sceneHost ? {
 			services: this.sceneHost.http,
@@ -342,14 +359,9 @@ var GatewayService = class {
 		this.serviceConfig = serviceConfig;
 		this.bus = new MessageBus();
 		this.configPath = serviceConfig.configPath || resolveConfigPath();
-		runBootstrapMigrationsSync(this.configPath);
+		bootstrapApplicationStateSync(this.configPath);
 		this.config = loadConfig(this.configPath);
 		let bootstrapConfigChanged = initializeVoiceDefaults(this.config, inferProductLanguageFromEnvironment());
-		const starterResult = ensureStarterAgentsInitialized(this.config);
-		if (starterResult.changed) {
-			this.config = starterResult.config;
-			bootstrapConfigChanged = true;
-		}
 		if (sanitizeTunnelConfig(this.config)) bootstrapConfigChanged = true;
 		if (bootstrapConfigChanged) saveConfig(this.config, this.configPath).catch((err) => {
 			const em = err instanceof Error ? err.message : String(err);
@@ -467,6 +479,7 @@ var GatewayService = class {
 			getExtensionLoader: () => this.extensionLoader,
 			emit: (type, payload) => this.emit(type, payload)
 		});
+		this.chatPreviews = new ChatPreviewService({ localApps: this.localApps });
 		this.agentRunner = new GatewayAgentRunner({
 			validateConnectionResume: async (input) => {
 				for (const source of input.contextSnapshots ?? []) if (source.kind === "app_context") await checkAppContextAccess(source, this.appContextDispatcher(), this.auth);
@@ -529,6 +542,7 @@ var GatewayService = class {
 		let sideChatRuns;
 		this.sideChats = new EphemeralSideChatManager({
 			getParentMetadata: (conversationId) => this.sessionIndex.getSessionMetadata(conversationId),
+			getParentConfig: async (conversationId) => getSessionConfig(conversationId),
 			loadParentMessages: (conversationId) => this.sessionIndex.getStore().load(conversationId),
 			getDefaultModelRef: (conversationId) => this.ensureAgentService().getModelForSession(conversationId),
 			getDefaultThinkingLevel: (conversationId) => this.ensureAgentService().getThinkingLevelForSession(conversationId),
@@ -550,6 +564,11 @@ var GatewayService = class {
 			publishRealtime: (topic, event, data) => this.realtime.broker.publish(topic, event, data),
 			completeRealtimeTopic: (topic) => this.realtime.completeTopic(topic)
 		});
+		this.sideChatPromotions = new SideChatPromotionService({
+			manager: this.sideChats,
+			sessionIndex: this.sessionIndex,
+			getAgentService: () => this.ensureAgentService()
+		});
 		this.sessions = new GatewaySessionsApi({
 			sessionIndex: this.sessionIndex,
 			getAgentService: () => this.ensureAgentService(),
@@ -591,11 +610,23 @@ var GatewayService = class {
 	refreshUserProfileContext() {
 		this._agentService?.refreshUserProfileContext();
 	}
+	/** Refresh long-lived runtime caches after an Agent catalog mutation. */
+	refreshAgentCatalog() {
+		this._agentService?.applyRuntimeConfiguration(this.config);
+		this.reconcileMemoryMaintenanceAutomations().catch((error) => {
+			const errorMessage = error instanceof Error ? error.message : String(error);
+			log.warn({
+				err: error,
+				errorMessage
+			}, `Agent catalog refresh failed: ${errorMessage}`);
+		});
+		this.emit("agent.catalog", {});
+	}
 	ensureAgentService() {
 		if (this._agentService) return this._agentService;
 		this._agentService = new AgentService(this.bus, {
 			workspace: this.workspacePath,
-			model: getAgentDefaultModelRef(this.config),
+			model: getAgentDefaultModelRef(),
 			config: this.config,
 			sessionStore: this.sessionIndex.getStore(),
 			onSessionMetadataUpdated: (conversationId, patch) => {
@@ -627,8 +658,10 @@ var GatewayService = class {
 			getProjectService: () => this.projects,
 			getWorkDiscovery: () => this._workDiscovery ?? void 0,
 			getLocalAppService: () => this.localApps,
+			getChatPreviewService: () => this.chatPreviews,
 			dispatchTaskEvents: () => this.dispatchTaskEvents(),
 			dispatchTaskRuns: () => this.dispatchTaskRuns(),
+			onAgentCatalogMutate: () => this.refreshAgentCatalog(),
 			getWorkflowRunService: () => this.createWorkflowRunService(),
 			sourceContextResolver: async (binding) => {
 				if (binding.kind === "note") {
@@ -662,7 +695,7 @@ var GatewayService = class {
 		});
 		this.automationService.setDeps({
 			agentService: this._agentService,
-			getDefaultAgentId: () => getDefaultAgentId(this.config),
+			getDefaultAgentId: () => getDefaultAgentId(),
 			prepareAgentSession: (input) => prepareAutomationAgentSession(this.sessionIndex.getStore(), this.projects, input),
 			workflowRunService: this.createWorkflowRunService(),
 			browserAutomationService: this.browserAutomations,
@@ -1005,6 +1038,8 @@ var GatewayService = class {
 			await this.stop().catch((cleanupError) => log.error({ err: cleanupError }, "Gateway startup cleanup failed"));
 			await this.sceneHost?.stop();
 			this.sceneHost = null;
+			this.homeIntelligenceHost?.stop();
+			this.homeIntelligenceHost = null;
 			this.stopRealtimeLogBridge?.();
 			this.stopRealtimeLogBridge = null;
 			setPairingBroadcastSink(null);
@@ -1020,7 +1055,42 @@ var GatewayService = class {
 			this.emit(type, payload);
 		});
 		log.debug("Starting gateway service...");
-		openXopcDatabase();
+		const homeCapabilities = new HomeCapabilityPreflightService({
+			config: () => this.config,
+			agentId: () => resolveDefaultAgentId(),
+			skills: (agentId) => this.agentService.getAgentSkillAvailability(agentId).skills,
+			principalId: "local-owner"
+		});
+		this.homeIntelligenceHost = new HomeIntelligenceHost(getSqliteDatabase(), {
+			principal: {
+				ownerId: "local-owner",
+				workspaceId: this.workspacePath
+			},
+			snapshot: new HomeSnapshotBuilder({
+				projects: () => this.projects.list({ limit: 500 }).items,
+				tasks: () => new TaskRepository().list({ limit: 200 }),
+				knowledge: () => listKnowledgeItems({
+					statuses: ["active"],
+					limit: 200
+				}),
+				knowledgePolicy: () => this.config.userContext.knowledgeMemory.enabled ? resolveKnowledgeReadPolicy(this.config.userContext.knowledgeMemory) : {
+					scopes: [],
+					contentSources: []
+				},
+				sessions: () => listSessionMetadata({
+					limit: 50,
+					excludeArchived: true
+				}).items
+			}),
+			generator: new HomeAdviceGenerator(() => this.config),
+			capabilities: () => homeCapabilities.inventory(),
+			resolveCapabilities: (requirements, options) => homeCapabilities.resolve(requirements, options),
+			publish: (type, payload) => this.realtime.broker.publish("gateway", type, payload),
+			notifyOpportunity: (payload) => this.emit("home.opportunity.ready", payload),
+			locale: () => "en",
+			enabled: () => this.config.userContext.enabled,
+			dispatchTaskRuns: () => this.dispatchTaskRuns()
+		});
 		await this.localApps.recoverPendingReleases();
 		const { recoverCapabilityImports } = await import("../imports/runtime.js");
 		await recoverCapabilityImports();
@@ -1042,7 +1112,7 @@ var GatewayService = class {
 		const trace = this.startupTrace;
 		const catalogCoordinator = getXopcCloudCatalogCoordinator();
 		const catalog = await trace.measure("model-catalog.hydrate", () => catalogCoordinator.hydrate());
-		if (getAgentDefaultModelRef(this.config)?.startsWith("xopc-cloud/") && catalog.source === "none") {
+		if (getAgentDefaultModelRef()?.startsWith("xopc-cloud/") && catalog.source === "none") {
 			const readiness = await trace.measure("model-catalog.initial-refresh", () => catalogCoordinator.ensure({
 				reason: "startup",
 				network: "if-empty",
@@ -1065,7 +1135,7 @@ var GatewayService = class {
 			runMessageSending: (to, content, channel) => this.agentService.outboundCoordinator.invokeOutboundMessageSending(to, content, channel),
 			runMessageSent: (to, content, success, error, channel) => this.agentService.outboundCoordinator.invokeOutboundMessageSent(to, content, success, error, channel)
 		});
-		this.channelManager.enableOutboundPersistence(getDefaultAgentId(this.config));
+		this.channelManager.enableOutboundPersistence(getDefaultAgentId());
 		if (this.extensionLoader) this.extensionLoader.setRuntimeContext({
 			bus: this.bus,
 			sessionManager: this.sessionIndex,
@@ -1132,7 +1202,7 @@ var GatewayService = class {
 		log.debug("Session manager initialized");
 		this.automationService.setDeps({
 			agentService: this.agentService,
-			getDefaultAgentId: () => getDefaultAgentId(this.config),
+			getDefaultAgentId: () => getDefaultAgentId(),
 			prepareAgentSession: (input) => prepareAutomationAgentSession(this.sessionIndex.getStore(), this.projects, input),
 			workflowRunService: this.createWorkflowRunService(),
 			browserAutomationService: this.browserAutomations,
@@ -1185,7 +1255,7 @@ var GatewayService = class {
 		});
 		this.connectorLearningCoordinator = startConnectorLearningCoordinator({
 			getConfig: () => this.config,
-			resolveAgentId: () => resolveDefaultAgentId(this.config),
+			resolveAgentId: () => resolveDefaultAgentId(),
 			emit: (type, payload) => this.emit(type, payload)
 		});
 		this.managedComposioEventPoller = new ManagedComposioEventPoller({
@@ -1200,7 +1270,7 @@ var GatewayService = class {
 		});
 		this.managedComposioEventPoller.start();
 		this.connectedKnowledgeCoordinator = startConnectedKnowledgeCoordinator({ resolvePipelineOptions: () => ({
-			agentId: resolveDefaultAgentId(this.config),
+			agentId: resolveDefaultAgentId(),
 			workspaceId: this.currentWorkspacePath
 		}) });
 		import("../browser/providers/browser-ext-install.js").then(({ ensureBrowserExtensionOnStartup }) => ensureBrowserExtensionOnStartup(this.config)).catch((err) => log.warn({ err }, "Browser extension artifact ensure failed"));
@@ -1219,10 +1289,11 @@ var GatewayService = class {
 			triggerInProcessRestart: () => this.triggerGatewayProcessRestart()
 		});
 		wireTunnelEventsToGateway(this);
-		import("../share/share-auto.js").then(({ runStagingSweep }) => runStagingSweep([...new Set([getDefaultAgentId(this.config), ...listAgentEntries(this.config).map((entry) => entry.id)])].map((agentId) => resolveAgentWorkspaceDir(this.config, agentId)))).catch((err) => log.warn({ err }, "Share staging sweep failed"));
+		import("../share/share-auto.js").then(({ runStagingSweep }) => runStagingSweep([...new Set([getDefaultAgentId(), ...listAgentEntries().map((entry) => entry.id)])].map((agentId) => resolveAgentWorkspaceDir(agentId)))).catch((err) => log.warn({ err }, "Share staging sweep failed"));
 		if (this.serviceConfig.deferChannelConnectUntilAfterHttp !== true) this.markGatewayReady();
 		else trace.mark("service.started-awaiting-http");
 		this.sceneHost?.start();
+		this.homeIntelligenceHost.start();
 		log.debug("Gateway service started");
 	}
 	/** Called when the HTTP listener is bound (before deferred channel work). */
@@ -1318,6 +1389,8 @@ var GatewayService = class {
 		await this.sideChats.disposeAll();
 		await this.sceneHost?.stop();
 		this.sceneHost = null;
+		this.homeIntelligenceHost?.stop();
+		this.homeIntelligenceHost = null;
 		this.realtime.close();
 		this.voiceRealtime.close();
 		await this.discussionWorker.stop();
@@ -1605,6 +1678,10 @@ var GatewayService = class {
 	get currentWorkspacePath() {
 		return this.workspacePath;
 	}
+	get homeIntelligence() {
+		if (!this.homeIntelligenceHost) throw new Error("Home intelligence is not running");
+		return this.homeIntelligenceHost;
+	}
 	get messageBusInstance() {
 		return this.bus;
 	}
@@ -1660,15 +1737,15 @@ var GatewayService = class {
 	}
 	collectWorkflowAgentIds() {
 		const ids = /* @__PURE__ */ new Set();
-		ids.add(resolveDefaultAgentId(this.config));
-		for (const entry of listAgentEntries(this.config)) {
+		ids.add(resolveDefaultAgentId());
+		for (const entry of listAgentEntries()) {
 			if (entry.enabled === false) continue;
 			ids.add(normalizeAgentId(entry.id));
 		}
 		return [...ids];
 	}
 	/** Process a message directly through the agent (for CLI mode). */
-	async processDirect(content, conversationId = resolveAgentMainConversationId({ agentId: getDefaultAgentId(this.config) })) {
+	async processDirect(content, conversationId = resolveAgentMainConversationId({ agentId: getDefaultAgentId() })) {
 		return this.agentService.turnDispatcher.processDirect(content, conversationId, {
 			type: "system",
 			source: "internal"
@@ -1676,6 +1753,13 @@ var GatewayService = class {
 	}
 	emit(type, payload) {
 		if (type === "config.reload") notifyUserContextChange({ kind: "policy" });
+		if (type === "connector.learning.updated" && payload && typeof payload === "object") {
+			const job = payload;
+			if (job.status === "completed" && typeof job.sourceInstanceId === "string" && typeof job.updatedAt === "string") this.homeIntelligenceHost?.sourceChanged({
+				sourceInstanceId: job.sourceInstanceId,
+				revision: job.updatedAt
+			});
+		}
 		this.realtime.broker.publish("gateway", type, payload);
 		this.createNotificationService().handleGatewayEvent(type, payload);
 	}
@@ -1720,6 +1804,12 @@ var GatewayService = class {
 				});
 			}
 			if (event.type.startsWith("task.")) this.emit(event.type, event.payload);
+			if (event.type.startsWith("task.") || event.type.startsWith("project.")) {
+				const payload = event.payload;
+				const objectId = event.type.startsWith("task.") ? payload.taskId : payload.projectId;
+				const revision = payload.version ?? payload.revision ?? "unknown";
+				this.homeIntelligenceHost?.requestRefresh(event.type.startsWith("task.") ? "task_changed" : "project_changed", `domain:${event.type}:${String(objectId)}:${String(revision)}`);
+			}
 			this.automationService.triggerEvent(event).catch((err) => {
 				const em = err instanceof Error ? err.message : String(err);
 				log.warn({

package/dist/src/gateway/session-context-summary.js

@@ -1,11 +1,11 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { getSqliteDatabase, init_transaction } from "../storage/sqlite/transaction.js";
-import { hasGatewayScope } from "./security/gateway-scopes.js";
+import { hasGatewayScope, init_gateway_scopes } from "./security/gateway-scopes.js";
 import { TaskRepository, init_task_repository } from "../tasks/task-repository.js";
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository } from "../storage/sqlite/session-repository.js";
-import { getSessionConfig } from "../storage/sqlite/config-repository.js";
+import { getSessionConfig, init_config_repository } from "../storage/sqlite/config-repository.js";
 import { TaskConversationRepository } from "../tasks/task-conversation-repository.js";
 import { getExecutionEnvironmentForSession } from "../execution-environments/subject.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";
@@ -14,10 +14,12 @@ import { runExec } from "../infra/exec.js";
 import { isSessionSourceBinding } from "../agent/source-context/types.js";
 import { realpath, stat } from "node:fs/promises";
 //#region src/gateway/session-context-summary.ts
+init_config_repository();
 init_session_repository();
 init_transaction();
 init_task_repository();
 init_logger();
+init_gateway_scopes();
 const log = createLogger("SessionContextSummary");
 const SOURCE_LIMIT = 20;
 async function readEnvironment(config, conversationId, projectId) {

package/dist/src/gateway/side-chat/index.d.ts

@@ -1,5 +1,7 @@
 export { EphemeralSideChatManager, SideChatError, parseThinkingLevel } from './manager.js';
-export type { EphemeralSideChatManagerOptions } from './manager.js';
+export type { EphemeralSideChatManagerOptions, SideChatPromotionSnapshot } from './manager.js';
 export { validateSideChatSelections } from './context-snapshot.js';
 export { SideChatRunService } from './run-service.js';
+export { SideChatPromotionService } from './promotion-service.js';
+export type { SideChatPromotionResult, SideChatPromotionServiceOptions } from './promotion-service.js';
 export type { CreateSideChatInput, SideChatConfig, SideChatContextSnapshot, SideChatSelection, SideChatStatus, SideChatView, } from './types.js';

package/dist/src/gateway/side-chat/index.js

@@ -1,4 +1,5 @@
 import { validateSideChatSelections } from "./context-snapshot.js";
 import { EphemeralSideChatManager, SideChatError, parseThinkingLevel } from "./manager.js";
 import { SideChatRunService } from "./run-service.js";
-export { EphemeralSideChatManager, SideChatError, SideChatRunService, parseThinkingLevel, validateSideChatSelections };
+import { SideChatPromotionService } from "./promotion-service.js";
+export { EphemeralSideChatManager, SideChatError, SideChatPromotionService, SideChatRunService, parseThinkingLevel, validateSideChatSelections };

package/dist/src/gateway/side-chat/manager.d.ts

@@ -1,7 +1,18 @@
 import type { AgentMessage, ThinkingLevel } from '@earendil-works/pi-agent-core';
 import { InMemoryTranscriptRuntime } from '../../agent/embedded/transcript-runtime.js';
+import type { SessionAgentConfig } from '../../session/config-types.js';
+import type { TranscriptStoredRow } from '../../session/session-context-for-llm.js';
 import type { SessionMetadata } from '../../session/types.js';
 import type { CreateSideChatInput, SideChatConfig, SideChatStatus, SideChatView } from './types.js';
+export interface SideChatPromotionSnapshot {
+    id: string;
+    parentMetadata: SessionMetadata;
+    parentConfig: SessionAgentConfig | null;
+    context: SideChatView['context'];
+    config: SideChatConfig;
+    contextMessages: AgentMessage[];
+    conversationRows: TranscriptStoredRow[];
+}
 export declare class SideChatError extends Error {
     readonly code: 'INVALID_REQUEST' | 'NOT_FOUND' | 'PARENT_NOT_FOUND' | 'LIMIT_REACHED' | 'CAPACITY_REACHED' | 'CONFLICT' | 'EXPIRED';
     readonly reason?: 'idle' | 'waiting';
@@ -9,6 +20,7 @@ export declare class SideChatError extends Error {
 }
 export interface EphemeralSideChatManagerOptions {
     getParentMetadata: (conversationId: string) => Promise<SessionMetadata | null>;
+    getParentConfig?: (conversationId: string) => Promise<SessionAgentConfig | null>;
     loadParentMessages: (conversationId: string) => Promise<AgentMessage[]>;
     getDefaultModelRef: (conversationId: string) => string;
     getDefaultThinkingLevel?: (conversationId: string) => ThinkingLevel;
@@ -39,12 +51,16 @@ export declare class EphemeralSideChatManager {
     get(id: string, clientInstanceId: string): SideChatView;
     getRuntime(id: string, clientInstanceId: string): InMemoryTranscriptRuntime;
     getMessages(id: string, clientInstanceId: string): AgentMessage[];
+    beginPromotion(id: string, clientInstanceId: string): SideChatPromotionSnapshot;
+    cancelPromotion(id: string, clientInstanceId: string): void;
     updateConfig(id: string, clientInstanceId: string, patch: Partial<SideChatConfig>): SideChatView;
     heartbeat(id: string, clientInstanceId: string): SideChatView;
     extend(id: string, clientInstanceId: string): SideChatView;
     setStatus(id: string, clientInstanceId: string, status: SideChatStatus, runId?: string): SideChatView;
     waitForInput(id: string, clientInstanceId: string, clarification: NonNullable<SideChatView['clarification']>, status?: 'waiting-input' | 'waiting-approval'): void;
     dispose(id: string, clientInstanceId: string): Promise<boolean>;
+    disposePromoted(id: string, clientInstanceId: string): Promise<boolean>;
+    private disposeEntry;
     disposeClient(clientInstanceId: string): Promise<number>;
     sweepExpired(at?: number): Promise<number>;
     disposeAll(): Promise<void>;

package/dist/src/gateway/side-chat/manager.js

@@ -70,6 +70,7 @@ var EphemeralSideChatManager = class {
 		const metadata = await this.options.getParentMetadata(parentConversationId);
 		if (!metadata || !metadata.transcriptId) throw new SideChatError("Parent session not found", "PARENT_NOT_FOUND");
 		const parentMessages = await this.options.loadParentMessages(parentConversationId);
+		const parentConfig = await this.options.getParentConfig?.(parentConversationId) ?? null;
 		if (this.stopped) throw new SideChatError("Gateway is stopping", "CAPACITY_REACHED");
 		let selections;
 		try {
@@ -110,7 +111,9 @@ var EphemeralSideChatManager = class {
 				createdAt
 			}),
 			config,
-			runtime
+			runtime,
+			parentMetadata: structuredClone(metadata),
+			parentConfig: structuredClone(parentConfig)
 		};
 		this.entries.set(id, entry);
 		return this.toView(entry);
@@ -127,6 +130,29 @@ var EphemeralSideChatManager = class {
 		entry.messageCount = messages.length;
 		return structuredClone(messages);
 	}
+	beginPromotion(id, clientInstanceId) {
+		const entry = this.requireEntry(id, clientInstanceId);
+		if (entry.status !== "idle") throw new SideChatError("Side chat is busy", "CONFLICT");
+		const conversationRows = entry.runtime.loadConversationRows();
+		if (entry.runtime.loadConversationMessages().length === 0) throw new SideChatError("Side chat has no messages to save", "INVALID_REQUEST");
+		entry.status = "promoting";
+		entry.expiresAt = null;
+		return structuredClone({
+			id: entry.id,
+			parentMetadata: entry.parentMetadata,
+			parentConfig: entry.parentConfig,
+			context: entry.context,
+			config: entry.config,
+			contextMessages: entry.runtime.loadBaselineMessages(),
+			conversationRows
+		});
+	}
+	cancelPromotion(id, clientInstanceId) {
+		const entry = this.requireEntry(id, clientInstanceId);
+		if (entry.status !== "promoting") return;
+		entry.status = "idle";
+		this.touchEntry(entry);
+	}
 	updateConfig(id, clientInstanceId, patch) {
 		const entry = this.requireEntry(id, clientInstanceId);
 		if (entry.status !== "idle") throw new SideChatError("Cannot change config while a run is active", "CONFLICT");
@@ -162,6 +188,14 @@ var EphemeralSideChatManager = class {
 		this.requireEntry(id, clientInstanceId).clarification = clarification;
 	}
 	async dispose(id, clientInstanceId) {
+		const entry = this.entries.get(id);
+		if (entry?.clientInstanceId === clientInstanceId && entry.status === "promoting") throw new SideChatError("Side chat is being saved", "CONFLICT");
+		return this.disposeEntry(id, clientInstanceId);
+	}
+	disposePromoted(id, clientInstanceId) {
+		return this.disposeEntry(id, clientInstanceId);
+	}
+	async disposeEntry(id, clientInstanceId) {
 		const entry = this.entries.get(id);
 		if (!entry) {
 			const pending = this.disposals.get(id);
@@ -187,8 +221,8 @@ var EphemeralSideChatManager = class {
 		return cleanup;
 	}
 	async disposeClient(clientInstanceId) {
-		const ids = [...this.entries.values()].filter((entry) => entry.clientInstanceId === clientInstanceId).map((entry) => entry.id);
-		await Promise.all(ids.map((id) => this.dispose(id, clientInstanceId)));
+		const ids = [...this.entries.values()].filter((entry) => entry.clientInstanceId === clientInstanceId && entry.status !== "promoting").map((entry) => entry.id);
+		await Promise.all(ids.map((id) => this.disposeEntry(id, clientInstanceId)));
 		return ids.length;
 	}
 	async sweepExpired(at = this.now()) {
@@ -201,7 +235,7 @@ var EphemeralSideChatManager = class {
 		if (this.sweepTimer) clearInterval(this.sweepTimer);
 		this.stopped = true;
 		const entries = [...this.entries.values()];
-		await Promise.all(entries.map((entry) => this.dispose(entry.id, entry.clientInstanceId)));
+		await Promise.all(entries.map((entry) => this.disposeEntry(entry.id, entry.clientInstanceId)));
 		await Promise.all([...this.disposals.values()].map((entry) => entry.promise));
 		this.expired.clear();
 	}
@@ -229,7 +263,7 @@ var EphemeralSideChatManager = class {
 			removeAt: this.now() + DEFAULT_IDLE_TTL_MS
 		});
 		this.pruneExpiredRecords(this.now());
-		const cleanup = this.dispose(entry.id, entry.clientInstanceId);
+		const cleanup = this.disposeEntry(entry.id, entry.clientInstanceId);
 		try {
 			this.options.onExpired?.(entry.id, entry.clientInstanceId, reason);
 		} catch (err) {
@@ -245,7 +279,7 @@ var EphemeralSideChatManager = class {
 		while (this.expired.size > MAX_EXPIRED_RECORDS) this.expired.delete(this.expired.keys().next().value);
 	}
 	toView(entry) {
-		const { runtime: _runtime, ...view } = entry;
+		const { runtime: _runtime, parentMetadata: _parentMetadata, parentConfig: _parentConfig, ...view } = entry;
 		return structuredClone({
 			...view,
 			serverNow: new Date(this.now()).toISOString()

package/dist/src/gateway/side-chat/promotion-service.d.ts

@@ -0,0 +1,19 @@
+import type { AgentService } from '../../agent/service.js';
+import type { SessionIndex } from '../../session/manager.js';
+import type { SessionMetadata } from '../../session/types.js';
+import { EphemeralSideChatManager } from './manager.js';
+export interface SideChatPromotionResult {
+    conversationId: string;
+    created: boolean;
+    session: SessionMetadata;
+}
+export interface SideChatPromotionServiceOptions {
+    manager: EphemeralSideChatManager;
+    sessionIndex: SessionIndex;
+    getAgentService: () => AgentService;
+}
+export declare class SideChatPromotionService {
+    private readonly options;
+    constructor(options: SideChatPromotionServiceOptions);
+    promote(sideChatId: string, clientInstanceId: string): Promise<SideChatPromotionResult>;
+}