@xopcai/xopc 0.0.285 → 0.0.286

package/dist/src/workflows/service/workflow-run-service.js

@@ -1,6 +1,7 @@
-import { TaskRunRepository } from "../../tasks/task-run-repository.js";
+import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
+import { init_conversation_repository, resolveRoutedConversation } from "../../storage/sqlite/conversation-repository.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
-import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
+import { extractProfileAgentId, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
@@ -23,6 +24,8 @@ import { WorkflowRunStore } from "../store/run-store.js";
 import { WorkflowWritebackService, resolveWorkflowWritebackPolicy } from "./workflow-writeback-service.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/service/workflow-run-service.ts
+init_conversation_repository();
+init_task_run_repository();
 init_resolve_route();
 init_providers();
 var WorkflowRunService = class {
@@ -90,7 +93,7 @@ var WorkflowRunService = class {
 	}
 	async startWorkflowRun(params) {
 		const config = this.options.service.currentConfig;
-		const workflowPolicy = config.agents?.list ? resolveEffectiveAgentProfileForSession(config, params.parentSessionKey ?? `agent:${params.agentId}`).config.workflows : void 0;
+		const workflowPolicy = config.agents?.list ? resolveEffectiveAgentProfile(config, params.agentId).config.workflows : void 0;
 		if (workflowPolicy?.allowed && !workflowPolicy.allowed.includes(params.definitionId)) return {
 			ok: false,
 			code: "policy_denied",
@@ -129,12 +132,12 @@ var WorkflowRunService = class {
 		if (existingRun) return {
 			ok: true,
 			runId: existingRun.run.id,
-			sessionKey: existingRun.run.metadata?.sessionKey ?? ""
+			conversationId: existingRun.run.metadata?.conversationId ?? ""
 		};
 		const runId = randomUUID();
 		const goal = params.goal ?? "";
 		const linkedTaskRun = params.taskRunId ? new TaskRunRepository().get(params.taskRunId) : void 0;
-		const inheritedProjectId = params.projectId?.trim() || (linkedTaskRun ? new TaskRepository().get(linkedTaskRun.taskId)?.projectId : void 0) || (params.parentSessionKey?.trim() ? (await this.options.service.sessionIndexInstance.getStore().getMetadata(params.parentSessionKey.trim()))?.projectId : void 0);
+		const inheritedProjectId = params.projectId?.trim() || (linkedTaskRun ? new TaskRepository().get(linkedTaskRun.taskId)?.projectId : void 0) || (params.parentConversationId?.trim() ? (await this.options.service.sessionIndexInstance.getStore().getMetadata(params.parentConversationId.trim()))?.projectId : void 0);
 		const taskId = linkedTaskRun?.taskId;
 		const requestedContextRefs = params.contextRefs ? [...inheritedProjectId && !params.contextRefs.some((ref) => ref.kind === "project" && ref.id === inheritedProjectId) ? [{
 			kind: "project",
@@ -187,14 +190,14 @@ var WorkflowRunService = class {
 				httpStatus: 400
 			};
 		}
-		const { sessionKey } = await this.options.sessionBridge.prepareRunSession({
+		const { conversationId } = await this.options.sessionBridge.prepareRunSession({
 			runId,
 			agentId: params.agentId,
 			definitionId: params.definitionId,
 			definitionTitle: definition.title,
 			triggerSource: params.source.kind,
 			goal,
-			parentSessionKey: params.parentSessionKey,
+			parentConversationId: params.parentConversationId,
 			projectId
 		});
 		if (linkedTaskRun?.status === "queued") {
@@ -203,7 +206,7 @@ var WorkflowRunService = class {
 			const snapshot = context.captureSnapshot({
 				ownerKind: "task_run",
 				ownerId: linkedTaskRun.id,
-				sessionKey,
+				conversationId,
 				query: task.contract?.objective ?? task.title,
 				selectedItems: context.list(task.id),
 				authorizationSnapshot: { grants: context.listActiveGrants(task.id) }
@@ -216,23 +219,23 @@ var WorkflowRunService = class {
 					executorKind: "workflow",
 					definitionId: params.definitionId
 				},
-				sessionKey
+				conversationId
 			})) throw new Error("TaskRun changed before workflow execution started");
 			new TaskConversationRepository().activateExecutionSession({
 				taskId: task.id,
-				sessionKey,
+				conversationId,
 				agentId: params.agentId,
 				runId: linkedTaskRun.id
 			});
 		}
-		const source = normalizeWorkflowRunSourceForSession(params.source, sessionKey, params.parentSessionKey);
+		const source = normalizeWorkflowRunSourceForSession(params.source, conversationId, params.parentConversationId);
 		const abortController = new AbortController();
 		const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);
 		const runStore = new WorkflowRunStore(this.options.service.currentConfig, params.agentId, eventStore);
 		const engine = this.createWorkflowEngine({
 			eventStore,
 			runStore,
-			sessionKey,
+			conversationId,
 			projectId,
 			contextInstructions: resolvedContext?.instructions
 		});
@@ -261,7 +264,7 @@ var WorkflowRunService = class {
 				contextRefs,
 				contextSnapshot: resolvedContext?.snapshot,
 				writebackPolicy,
-				sessionKey,
+				conversationId,
 				source,
 				input: inputEnvelope,
 				retryOfRunId: params.retryOfRunId,
@@ -286,7 +289,7 @@ var WorkflowRunService = class {
 		return {
 			ok: true,
 			runId,
-			sessionKey
+			conversationId
 		};
 	}
 	async retryWorkflowRun(params) {
@@ -297,7 +300,7 @@ var WorkflowRunService = class {
 			message: "Workflow run not found",
 			httpStatus: 404
 		};
-		const parentSessionKey = existing.run.source.kind === "chat" ? existing.run.source.sessionKey : void 0;
+		const parentConversationId = existing.run.source.kind === "chat" ? existing.run.source.conversationId : void 0;
 		const projectId = params.projectId?.trim() || existing.run.metadata?.projectId;
 		return this.startWorkflowRun({
 			agentId: params.agentId,
@@ -312,7 +315,7 @@ var WorkflowRunService = class {
 			inputEnvelope: existing.run.metadata?.input,
 			goal: existing.run.goal,
 			source: existing.run.source,
-			parentSessionKey,
+			parentConversationId,
 			retryOfRunId: existing.run.id
 		});
 	}
@@ -344,7 +347,7 @@ var WorkflowRunService = class {
 		};
 		const replayRunId = randomUUID();
 		const goal = buildReplayGoal(existing, params.scope, targets.targets.length);
-		const parentSessionKey = existing.run.source.kind === "chat" ? existing.run.source.sessionKey : void 0;
+		const parentConversationId = existing.run.source.kind === "chat" ? existing.run.source.conversationId : void 0;
 		const projectId = existing.run.metadata?.projectId;
 		const taskRunId = existing.run.metadata?.taskRunId;
 		const taskId = taskRunId ? new TaskRunRepository().get(taskRunId)?.taskId : void 0;
@@ -383,24 +386,24 @@ var WorkflowRunService = class {
 				httpStatus: 400
 			};
 		}
-		const { sessionKey } = await this.options.sessionBridge.prepareRunSession({
+		const { conversationId } = await this.options.sessionBridge.prepareRunSession({
 			runId: replayRunId,
 			agentId: params.agentId,
 			definitionId: existing.run.definitionId,
 			definitionTitle: `${definition.title} replay`,
 			triggerSource: existing.run.source.kind,
 			goal,
-			parentSessionKey,
+			parentConversationId,
 			projectId
 		});
-		const source = normalizeWorkflowRunSourceForSession(existing.run.source, sessionKey, parentSessionKey);
+		const source = normalizeWorkflowRunSourceForSession(existing.run.source, conversationId, parentConversationId);
 		const abortController = new AbortController();
 		const eventStore = new WorkflowEventStore(this.options.service.currentConfig, params.agentId);
 		const replayRunStore = new WorkflowRunStore(this.options.service.currentConfig, params.agentId, eventStore);
 		const engine = this.createWorkflowEngine({
 			eventStore,
 			runStore: replayRunStore,
-			sessionKey,
+			conversationId,
 			projectId,
 			contextInstructions: resolvedContext?.instructions
 		});
@@ -428,7 +431,7 @@ var WorkflowRunService = class {
 				contextRefs: existing.run.metadata?.contextRefs,
 				contextSnapshot: resolvedContext?.snapshot,
 				writebackPolicy,
-				sessionKey,
+				conversationId,
 				source,
 				input: inputEnvelope,
 				retryOfRunId: existing.run.id,
@@ -462,7 +465,7 @@ var WorkflowRunService = class {
 		return {
 			ok: true,
 			runId: replayRunId,
-			sessionKey
+			conversationId
 		};
 	}
 	async cancelWorkflowRun(params) {
@@ -557,14 +560,14 @@ var WorkflowRunService = class {
 	}
 	createWorkflowEngine(params) {
 		const gatewayService = this.options.service;
-		const profileAgentId = extractProfileAgentId(params.sessionKey, gatewayService.currentConfig);
-		const agentWorkspace = gatewayService.currentConfig.agents?.list ? resolveEffectiveAgentProfileForSession(gatewayService.currentConfig, params.sessionKey).resolvedWorkspacePath : gatewayService.currentWorkspacePath;
-		const workspace = getProjectWorkspacePathForSession(params.sessionKey) ?? agentWorkspace;
+		const profileAgentId = extractProfileAgentId(params.conversationId, gatewayService.currentConfig);
+		const agentWorkspace = gatewayService.currentConfig.agents?.list ? resolveEffectiveAgentProfileForSession(gatewayService.currentConfig, params.conversationId).resolvedWorkspacePath : gatewayService.currentWorkspacePath;
+		const workspace = getProjectWorkspacePathForSession(params.conversationId) ?? agentWorkspace;
 		const runner = new DelegateSubagentRunner({
 			workspace,
 			bus: gatewayService.messageBusInstance,
 			agentId: profileAgentId,
-			getDefaultModel: () => resolveModel(gatewayService.agentService.getModelForSession(params.sessionKey)),
+			getDefaultModel: () => resolveModel(gatewayService.agentService.getModelForSession(params.conversationId)),
 			getConfig: () => gatewayService.currentConfig,
 			sessionStore: gatewayService.sessionIndexInstance.getStore(),
 			buildChildTools: (childOptions) => this.options.buildChildTools({
@@ -583,9 +586,17 @@ var WorkflowRunService = class {
 			resolveModelId: (modelId) => {
 				return resolveModel(resolveModelSelector(gatewayService.currentConfig, profileAgentId, modelId));
 			},
-			parentSessionKey: params.sessionKey,
-			subagentSessionKeyFactory: ({ runId, agentId }) => {
-				return `agent:${profileAgentId}:workflow:${runId}:subagent:${agentId}`;
+			parentConversationId: params.conversationId,
+			subagentConversationIdFactory: ({ runId, agentId }) => {
+				return resolveRoutedConversation({
+					agentId: profileAgentId,
+					source: "workflow",
+					peerKind: "direct",
+					peerId: `${runId}/${agentId}`
+				}, {
+					sessionType: "workflow-subagent",
+					parentConversationId: params.conversationId
+				});
 			},
 			onEventAppended: (event) => {
 				gatewayService.emit("workflow.event.appended", {
@@ -615,21 +626,21 @@ var WorkflowRunService = class {
 				status: view.run.status,
 				definitionId: view.run.definitionId,
 				title: view.run.title,
-				sessionKey: view.run.metadata?.sessionKey,
+				conversationId: view.run.metadata?.conversationId,
 				sourceKind: view.run.source.kind
 			},
 			occurredAtMs: view.run.completedAtMs ?? Date.now()
 		});
 	}
 };
-function normalizeWorkflowRunSourceForSession(source, workflowSessionKey, parentSessionKey) {
-	if (parentSessionKey?.trim()) return {
+function normalizeWorkflowRunSourceForSession(source, workflowConversationId, parentConversationId) {
+	if (parentConversationId?.trim()) return {
 		kind: "chat",
-		sessionKey: parentSessionKey.trim()
+		conversationId: parentConversationId.trim()
 	};
 	if (source.kind === "webui") return {
 		...source,
-		sessionKey: workflowSessionKey
+		conversationId: workflowConversationId
 	};
 	if (source.kind === "chat") return source;
 	return source;
@@ -655,7 +666,7 @@ function buildWorkflowRunMetadata(params) {
 		taskId
 	});
 	return {
-		sessionKey: params.sessionKey,
+		conversationId: params.conversationId,
 		...params.preparationOnly ? { preparationOnly: true } : {},
 		triggerSource: params.source.kind,
 		agentId: params.agentId,
@@ -691,7 +702,7 @@ function buildDefaultWorkflowContextRefs(params) {
 	});
 	if (params.source.kind === "chat") refs.push({
 		kind: "session",
-		id: params.source.sessionKey,
+		id: params.source.conversationId,
 		role: "parent_session"
 	});
 	return refs;
@@ -770,20 +781,20 @@ function normalizePositiveInt(value, fallback) {
 function buildReplayGoal(view, scope, targetCount) {
 	return `Replay ${targetCount} ${scope === "failed_phases" ? "failed phase" : "failed agent"}${targetCount === 1 ? "" : "s"} from workflow run ${view.run.id}: ${view.run.goal}`;
 }
-function extractWorkflowRunSessionKey(source) {
-	if ("sessionKey" in source && typeof source.sessionKey === "string" && source.sessionKey.trim()) return source.sessionKey.trim();
+function extractWorkflowRunConversationId(source) {
+	if ("conversationId" in source && typeof source.conversationId === "string" && source.conversationId.trim()) return source.conversationId.trim();
 	return null;
 }
 function buildWorkflowRunOrigin(source) {
 	switch (source.kind) {
 		case "chat": return {
 			channel: "chat",
-			sessionKey: source.sessionKey,
+			conversationId: source.conversationId,
 			messageId: source.messageId
 		};
 		case "webui": return {
 			channel: "webui",
-			sessionKey: source.sessionKey
+			conversationId: source.conversationId
 		};
 		case "automation": return {
 			channel: "automation",
@@ -818,4 +829,4 @@ function preparationDefinition(original) {
 	return definition;
 }
 //#endregion
-export { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunSessionKey, preparationDefinition, resolveWorkflowReplayTargets };
+export { WorkflowRunService, buildWorkflowRunDefinitionSnapshot, buildWorkflowRunInputEnvelope, buildWorkflowRunMetadata, extractWorkflowRunConversationId, preparationDefinition, resolveWorkflowReplayTargets };

package/dist/src/workflows/service/workflow-run-service.types.d.ts

@@ -4,7 +4,7 @@ export interface StartWorkflowRunServiceParams {
     agentId: string;
     definitionId: string;
     taskRunId?: string;
-    parentSessionKey?: string;
+    parentConversationId?: string;
     projectId?: string;
     contextRefs?: WorkflowRunContextRef[];
     contextSnapshotId?: string;
@@ -22,7 +22,7 @@ export interface StartWorkflowRunServiceParams {
 export interface StartWorkflowRunServiceResult {
     ok: true;
     runId: string;
-    sessionKey: string;
+    conversationId: string;
 }
 export type WorkflowRunServiceErrorCode = 'definition_not_found' | 'run_not_found' | 'invalid_input' | 'policy_denied' | 'connector_preflight_failed' | 'invalid_state';
 export interface WorkflowRunServiceErrorResult {

package/dist/src/workflows/service/workflow-session-bridge.d.ts

@@ -8,12 +8,12 @@ export interface PrepareWorkflowRunSessionParams {
     definitionId: string;
     definitionTitle: string;
     goal: string;
-    parentSessionKey?: string;
+    parentConversationId?: string;
     projectId?: string;
     triggerSource?: string;
 }
 export interface PrepareWorkflowRunSessionResult {
-    sessionKey: string;
+    conversationId: string;
 }
 export declare class WorkflowSessionBridge {
     private readonly gateway;

package/dist/src/workflows/service/workflow-session-bridge.js

@@ -6,7 +6,7 @@ import { renderWorkflowText } from "../../agent/workflow/snapshot.js";
 import { isTerminalWorkflowRunStatus } from "../domain/run.js";
 import "../domain/index.js";
 import { runViewToSnapshot } from "./run-view-to-snapshot.js";
-import { buildWorkflowRunSessionKey } from "./workflow-session-key.js";
+import { buildWorkflowRunConversationId } from "./workflow-session-key.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/service/workflow-session-bridge.ts
 const WORKFLOW_SESSION_TYPE = "workflow-run";
@@ -17,12 +17,12 @@ var WorkflowSessionBridge = class {
 		this.gateway = gateway;
 	}
 	async prepareRunSession(params) {
-		const sessionKey = buildWorkflowRunSessionKey(params.agentId, params.runId);
+		const conversationId = buildWorkflowRunConversationId(params.agentId, params.runId);
 		const goalText = formatWorkflowGoalUserMessage(params.definitionId, params.goal);
 		const sessionName = truncateSessionName(params.goal.trim() || params.definitionTitle || params.definitionId);
 		const store = this.gateway.sessionIndexInstance.getStore();
-		const projectId = params.projectId?.trim() || (params.parentSessionKey?.trim() ? (await store.getMetadata(params.parentSessionKey.trim()))?.projectId : void 0);
-		await store.resolveTranscriptPath(sessionKey, { metadata: {
+		const projectId = params.projectId?.trim() || (params.parentConversationId?.trim() ? (await store.getMetadata(params.parentConversationId.trim()))?.projectId : void 0);
+		await store.resolveTranscriptPath(conversationId, { metadata: {
 			sessionType: WORKFLOW_SESSION_TYPE,
 			projectId,
 			hiddenFromSessionList: true,
@@ -36,7 +36,7 @@ var WorkflowSessionBridge = class {
 				peerId: params.runId
 			}
 		} });
-		await store.updateMetadata(sessionKey, {
+		await store.updateMetadata(conversationId, {
 			sessionType: WORKFLOW_SESSION_TYPE,
 			hiddenFromSessionList: true,
 			workflowRunId: params.runId,
@@ -49,10 +49,10 @@ var WorkflowSessionBridge = class {
 				workflowDefinitionId: params.definitionId,
 				workflowGoal: params.goal,
 				...params.triggerSource ? { triggerSource: params.triggerSource } : {},
-				...params.parentSessionKey ? { parentSessionKey: params.parentSessionKey } : {}
+				...params.parentConversationId ? { parentConversationId: params.parentConversationId } : {}
 			}
 		});
-		await store.appendTranscriptMessage(sessionKey, {
+		await store.appendTranscriptMessage(conversationId, {
 			role: "user",
 			content: [{
 				type: "text",
@@ -60,42 +60,42 @@ var WorkflowSessionBridge = class {
 			}],
 			timestamp: Date.now()
 		});
-		if (params.parentSessionKey?.trim()) await this.writeParentRunLink({
-			parentSessionKey: params.parentSessionKey.trim(),
+		if (params.parentConversationId?.trim()) await this.writeParentRunLink({
+			parentConversationId: params.parentConversationId.trim(),
 			runId: params.runId,
 			ownerAgentId: params.agentId,
-			workflowSessionKey: sessionKey,
+			workflowConversationId: conversationId,
 			definitionId: params.definitionId,
 			goal: params.goal,
 			status: "running"
 		});
 		this.gateway.emit("session.updated", {
-			key: sessionKey,
+			key: conversationId,
 			name: sessionName
 		});
-		return { sessionKey };
+		return { conversationId };
 	}
 	async handleRunViewUpdated(view) {
 		const runId = view.run.id;
-		const sessionKey = view.run.metadata?.sessionKey?.trim();
-		if (!sessionKey || !isTerminalWorkflowRunStatus(view.run.status)) return;
+		const conversationId = view.run.metadata?.conversationId?.trim();
+		if (!conversationId || !isTerminalWorkflowRunStatus(view.run.status)) return;
 		if (this.terminalPersistedRunIds.has(runId)) return;
 		this.terminalPersistedRunIds.add(runId);
-		await this.persistTerminalTranscript(sessionKey, view);
-		const parentSessionKey = readParentSessionKey(view);
-		if (parentSessionKey) await this.writeParentRunLink({
-			parentSessionKey,
+		await this.persistTerminalTranscript(conversationId, view);
+		const parentConversationId = readParentConversationId(view);
+		if (parentConversationId) await this.writeParentRunLink({
+			parentConversationId,
 			runId,
 			ownerAgentId: view.run.metadata?.agentId ?? "",
-			workflowSessionKey: sessionKey,
+			workflowConversationId: conversationId,
 			definitionId: view.run.definitionId,
 			goal: view.run.goal,
 			status: view.run.status
 		});
-		this.recordProjectWorkflowMemory(sessionKey, view);
+		this.recordProjectWorkflowMemory(conversationId, view);
 		new TaskWorkflowCoordinator().handleTerminalRun(view);
 	}
-	async persistTerminalTranscript(sessionKey, view) {
+	async persistTerminalTranscript(conversationId, view) {
 		const store = this.gateway.sessionIndexInstance.getStore();
 		const snapshot = runViewToSnapshot(view);
 		const toolCallId = randomUUID();
@@ -107,7 +107,7 @@ var WorkflowSessionBridge = class {
 			details: snapshot
 		};
 		const isError = view.run.status === "failed" || view.run.status === "timeout";
-		await store.appendTranscriptMessage(sessionKey, {
+		await store.appendTranscriptMessage(conversationId, {
 			role: "assistant",
 			content: [{
 				type: "toolCall",
@@ -117,7 +117,7 @@ var WorkflowSessionBridge = class {
 			}],
 			timestamp: Date.now()
 		});
-		await store.appendTranscriptMessage(sessionKey, {
+		await store.appendTranscriptMessage(conversationId, {
 			role: "toolResult",
 			toolCallId,
 			content: [{
@@ -128,12 +128,12 @@ var WorkflowSessionBridge = class {
 			isError,
 			timestamp: Date.now()
 		});
-		await store.updateMetadata(sessionKey, { status: "active" });
+		await store.updateMetadata(conversationId, { status: "active" });
 	}
 	async writeParentRunLink(params) {
 		const store = this.gateway.sessionIndexInstance.getStore();
 		const text = formatParentRunLinkText(params);
-		await store.appendTranscriptContextEntry(params.parentSessionKey, {
+		await store.appendTranscriptContextEntry(params.parentConversationId, {
 			kind: "context",
 			id: `workflow-run-link:${params.runId}`,
 			text,
@@ -141,7 +141,7 @@ var WorkflowSessionBridge = class {
 				kind: WORKFLOW_RUN_LINK_CONTEXT_KIND,
 				runId: params.runId,
 				...params.ownerAgentId ? { ownerAgentId: params.ownerAgentId } : {},
-				workflowSessionKey: params.workflowSessionKey,
+				workflowConversationId: params.workflowConversationId,
 				definitionId: params.definitionId,
 				goal: params.goal,
 				status: params.status
@@ -149,7 +149,7 @@ var WorkflowSessionBridge = class {
 			createdAt: (/* @__PURE__ */ new Date()).toISOString()
 		});
 	}
-	recordProjectWorkflowMemory(sessionKey, view) {
+	recordProjectWorkflowMemory(conversationId, view) {
 		const projectId = view.run.metadata?.projectId?.trim();
 		const agentId = view.run.metadata?.agentId?.trim();
 		if (!projectId || !agentId) return;
@@ -161,7 +161,7 @@ var WorkflowSessionBridge = class {
 				id: projectId
 			},
 			sourceAgentId: agentId,
-			sourceSessionId: sessionKey,
+			sourceConversationId: conversationId,
 			content: [
 				`Workflow ${view.run.definitionId} finished with status ${view.run.status}.`,
 				view.run.goal ? `Goal: ${view.run.goal}` : void 0,
@@ -192,12 +192,12 @@ function truncateSessionName(name) {
 	if (trimmed.length <= 80) return trimmed;
 	return `${trimmed.slice(0, 77)}…`;
 }
-function readParentSessionKey(view) {
+function readParentConversationId(view) {
 	if (view.run.source.kind === "chat") {
-		const originKey = view.run.source.sessionKey?.trim();
+		const originKey = view.run.source.conversationId?.trim();
 		if (originKey) return originKey;
 	}
-	const customParent = view.run.metadata?.origin?.sessionKey?.trim();
+	const customParent = view.run.metadata?.origin?.conversationId?.trim();
 	if (customParent && view.run.metadata?.triggerSource === "chat") return customParent;
 	return null;
 }

package/dist/src/workflows/service/workflow-session-key.d.ts

@@ -1,3 +1,3 @@
 /** Stable webchat session key for one workflow run (`agent:{id}:webchat:…:direct:wf_{runId}`). */
-export declare function buildWorkflowRunSessionKey(agentId: string, runId: string): string;
+export declare function buildWorkflowRunConversationId(agentId: string, runId: string): string;
 export declare function readWorkflowRunIdFromSessionCustomData(customData: Record<string, unknown> | undefined): string | null;

package/dist/src/workflows/service/workflow-session-key.js

@@ -1,9 +1,9 @@
-import { buildSessionKey, init_session_key } from "../../routing/session-key.js";
+import { init_session_key, resolveConversationId } from "../../routing/session-key.js";
 //#region src/workflows/service/workflow-session-key.ts
 init_session_key();
 /** Stable webchat session key for one workflow run (`agent:{id}:webchat:…:direct:wf_{runId}`). */
-function buildWorkflowRunSessionKey(agentId, runId) {
-	return buildSessionKey({
+function buildWorkflowRunConversationId(agentId, runId) {
+	return resolveConversationId({
 		agentId,
 		source: "webchat",
 		accountId: "default",
@@ -16,4 +16,4 @@ function readWorkflowRunIdFromSessionCustomData(customData) {
 	return typeof raw === "string" && raw.trim() ? raw.trim() : null;
 }
 //#endregion
-export { buildWorkflowRunSessionKey, readWorkflowRunIdFromSessionCustomData };
+export { buildWorkflowRunConversationId, readWorkflowRunIdFromSessionCustomData };

package/dist/src/workflows/service/workflow-writeback-service.js

@@ -1,8 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { TaskRunRepository } from "../../tasks/task-run-repository.js";
+import { TaskRunRepository, init_task_run_repository } from "../../tasks/task-run-repository.js";
 import { ProjectService } from "../../projects/project-service.js";
 //#region src/workflows/service/workflow-writeback-service.ts
+init_task_run_repository();
 init_logger();
 const log = createLogger("WorkflowWriteback");
 var WorkflowWritebackService = class {

package/dist/src/workflows/store/event-store.js

@@ -1,7 +1,9 @@
-import { requireXopcDatabase } from "../../storage/sqlite/connection.js";
-import { runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { init_connection, requireXopcDatabase } from "../../storage/sqlite/connection.js";
+import { init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { randomUUID } from "node:crypto";
 //#region src/workflows/store/event-store.ts
+init_connection();
+init_transaction();
 var WorkflowEventStore = class {
 	constructor(_config, agentId) {
 		this.agentId = agentId;

package/dist/src/workflows/store/run-index-store.js

@@ -1,5 +1,6 @@
-import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 //#region src/workflows/store/run-index-store.ts
+init_transaction();
 function rowToSummary(row) {
 	const source = JSON.parse(row.source_json);
 	const metadata = row.metadata_json ? JSON.parse(row.metadata_json) : void 0;
@@ -21,24 +22,24 @@ function resultPreview(view) {
 	if (result == null) return null;
 	return result.summary.slice(0, 500);
 }
-function parentSessionKey(view) {
-	if (view.run.source.kind === "chat") return view.run.source.sessionKey;
-	return (view.run.metadata?.origin?.sessionKey)?.trim() || null;
+function parentConversationId(view) {
+	if (view.run.source.kind === "chat") return view.run.source.conversationId;
+	return (view.run.metadata?.origin?.conversationId)?.trim() || null;
 }
 var WorkflowRunIndexStore = class {
 	upsert(agentId, view) {
 		const run = view.run;
 		const metadata = run.metadata;
-		const sessionKey = metadata?.sessionKey;
-		if (!sessionKey) return;
+		const conversationId = metadata?.conversationId;
+		if (!conversationId) return;
 		runSqliteWriteTransaction((db) => {
 			db.prepare(`INSERT OR REPLACE INTO workflow_runs (
           run_id, agent_id, definition_id, definition_version, task_run_id,
-          project_id, session_key, parent_session_key, status, source_kind, source_json,
+          project_id, conversation_id, parent_conversation_id, status, source_kind, source_json,
           metadata_json, title,
           created_at_ms, started_at_ms, completed_at_ms, metrics_json,
           result_preview, error_message
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(run.id, agentId, run.definitionId, run.definitionVersion, metadata?.taskRunId ?? null, metadata?.projectId ?? null, sessionKey, parentSessionKey(view), run.status, run.source.kind, JSON.stringify(run.source), metadata ? JSON.stringify(metadata) : null, run.title, run.createdAtMs, run.startedAtMs ?? null, run.completedAtMs ?? null, JSON.stringify(run.metrics), resultPreview(view), run.error?.message ?? null);
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(run.id, agentId, run.definitionId, run.definitionVersion, metadata?.taskRunId ?? null, metadata?.projectId ?? null, conversationId, parentConversationId(view), run.status, run.source.kind, JSON.stringify(run.source), metadata ? JSON.stringify(metadata) : null, run.title, run.createdAtMs, run.startedAtMs ?? null, run.completedAtMs ?? null, JSON.stringify(run.metrics), resultPreview(view), run.error?.message ?? null);
 		});
 	}
 	list(agentId, options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.285",
+  "version": "0.0.286",
   "description": "Local-first personal AI assistant with reviewable user understanding, durable tasks, workflows, automations, and local or cloud models.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -167,10 +167,10 @@
     "vitest": "4.1.5",
     "vue": "^3.5.35",
     "@xopcai/browser-control-contract": "0.1.0",
-    "@xopcai/gateway-contract": "0.0.0",
-    "@xopcai/realtime-client": "0.0.0",
     "@xopcai/endpoint-tools-protocol": "0.0.0",
-    "@xopcai/realtime-protocol": "0.0.0"
+    "@xopcai/gateway-contract": "0.0.0",
+    "@xopcai/realtime-protocol": "0.0.0",
+    "@xopcai/realtime-client": "0.0.0"
   },
   "scripts": {
     "assets:brand": "node scripts/generate-brand-assets.mjs",

package/dist/gateway/static/root/assets/api-COG_Tzpv.js

@@ -1 +0,0 @@
-import{a as e,r as t}from"./locale-store-DlOv7896.js";var n=n=>e(t(n)),r=(n,r,i)=>e(t(n),{method:r,headers:{"content-type":`application/json`},body:JSON.stringify(i)});export{r as n,n as t};