@xopcai/xopc 0.0.284 → 0.0.286

package/dist/src/agent/tools/session-search-tool.js

@@ -65,10 +65,10 @@ ${formatMessagesForSummary(messages)}`,
 		const msg = err instanceof Error ? err.message : String(err);
 		log.warn({
 			err,
-			summarizingSessionKey: logMeta?.summarizingSessionKey,
+			summarizingConversationId: logMeta?.summarizingConversationId,
 			queryLength: query.length,
 			messageCount: messages.length
-		}, `session_search LLM summarization failed${logMeta?.summarizingSessionKey ? ` (session ${logMeta.summarizingSessionKey})` : ""}: ${msg}`);
+		}, `session_search LLM summarization failed${logMeta?.summarizingConversationId ? ` (session ${logMeta.summarizingConversationId})` : ""}: ${msg}`);
 		return `[Summarization failed: ${msg}]`;
 	}
 }
@@ -85,7 +85,7 @@ const SessionSearchSchema = Type.Object({
 		minimum: 1,
 		maximum: 15
 	})),
-	excludeSessionKey: Type.Optional(Type.String({ description: "Exclude this session key from keyword results (default: current chat)." }))
+	excludeConversationId: Type.Optional(Type.String({ description: "Exclude this session key from keyword results (default: current chat)." }))
 });
 function createSessionSearchTool(deps) {
 	return {
@@ -144,16 +144,16 @@ function createSessionSearchTool(deps) {
 					key: item.key,
 					score: 1
 				}));
-				const exclude = p.excludeSessionKey?.trim() || deps.getCurrentSessionKey?.() || "";
+				const exclude = p.excludeConversationId?.trim() || deps.getCurrentConversationId?.() || "";
 				if (exclude) matches = matches.filter((m) => m.key !== exclude);
 				const top = matches.slice(0, limit);
 				const summaries = await Promise.all(top.map(async ({ key, score }) => {
 					let messages = await store.load(key);
 					if (p.roleFilter) messages = messages.filter((m) => m.role === p.roleFilter);
 					return {
-						sessionKey: key,
+						conversationId: key,
 						score,
-						summary: await summarizeSession(messages, query, deps, signal, { summarizingSessionKey: key })
+						summary: await summarizeSession(messages, query, deps, signal, { summarizingConversationId: key })
 					};
 				}));
 				return {

package/dist/src/agent/tools/skill-install-tool.d.ts

@@ -7,7 +7,7 @@ export interface SkillInstallToolOptions {
     skillId?: string;
     target?: SkillInstallTarget;
     /** Current session whose resolved workspace should receive workspace installs. */
-    sessionKey?: string;
+    conversationId?: string;
     /** Explicit workspace override for workspace installs. */
     workspace?: string;
     force?: boolean;
@@ -26,7 +26,7 @@ export interface MarketplaceSkillInstallToolOptions {
     name: string;
     version?: string;
     target?: SkillInstallTarget;
-    sessionKey?: string;
+    conversationId?: string;
     force?: boolean;
 }
 export interface MarketplaceSkillInstallToolResult {
@@ -40,6 +40,6 @@ export interface MarketplaceSkillInstallToolResult {
 export interface SkillInstallToolDeps {
     installSkillFromSource?: (opts: SkillInstallToolOptions) => Promise<SkillInstallToolResult>;
     installSkillFromMarketplace?: (opts: MarketplaceSkillInstallToolOptions) => Promise<MarketplaceSkillInstallToolResult>;
-    getSessionKey?: () => string | undefined;
+    getConversationId?: () => string | undefined;
 }
 export declare function createSkillInstallTool(deps: SkillInstallToolDeps): AgentTool;

package/dist/src/agent/tools/skill-install-tool.js

@@ -30,7 +30,7 @@ function createSkillInstallTool(deps) {
 			const provider = clean(params.provider);
 			const name = clean(params.name);
 			const target = isSkillInstallTarget(params.target) ? params.target : "global";
-			const sessionKey = deps.getSessionKey?.();
+			const conversationId = deps.getConversationId?.();
 			if (provider || name) {
 				if (provider !== "store" && provider !== "skillhub" && provider !== "clawhub") return {
 					content: [{
@@ -59,7 +59,7 @@ function createSkillInstallTool(deps) {
 						name,
 						version: clean(params.version),
 						target,
-						sessionKey,
+						conversationId,
 						force: params.force === true
 					});
 					return {
@@ -110,7 +110,7 @@ function createSkillInstallTool(deps) {
 					path: clean(params.path),
 					skillId: clean(params.skillId),
 					target,
-					sessionKey,
+					conversationId,
 					force: params.force === true,
 					strictScan: params.strictScan === true
 				});

package/dist/src/agent/tools/todo-tool.d.ts

@@ -15,11 +15,11 @@ export declare class TodoStore {
 }
 export interface CreateTodoToolOptions {
     /** Resolve session key for isolated lists; defaults to a single in-memory list. */
-    getSessionKey?: () => string | null | undefined;
+    getConversationId?: () => string | null | undefined;
     repository?: {
         isAvailable?: () => boolean;
-        read: (sessionKey: string) => TodoItem[];
-        write: (sessionKey: string, items: TodoItem[]) => void;
+        read: (conversationId: string) => TodoItem[];
+        write: (conversationId: string, items: TodoItem[]) => void;
     };
 }
 /**

package/dist/src/agent/tools/todo-tool.js

@@ -86,8 +86,8 @@ function formatTodoList(items) {
 		...lines
 	].join("\n");
 }
-function resolveSessionKey(getSessionKey) {
-	const raw = getSessionKey();
+function resolveConversationId(getConversationId) {
+	const raw = getConversationId();
 	const s = raw != null ? String(raw).trim() : "";
 	return s.length > 0 ? s : "default";
 }
@@ -95,7 +95,7 @@ function resolveSessionKey(getSessionKey) {
 * In-session task list for multi-step work. One {@link TodoStore} per session key.
 */
 function createTodoTool(options) {
-	const getSessionKey = options?.getSessionKey ?? (() => "default");
+	const getConversationId = options?.getConversationId ?? (() => "default");
 	const stores = /* @__PURE__ */ new Map();
 	const activeRepository = () => {
 		const repository = options?.repository;
@@ -123,7 +123,7 @@ function createTodoTool(options) {
 		async execute(_toolCallId, params, _signal) {
 			let store;
 			try {
-				const key = resolveSessionKey(getSessionKey);
+				const key = resolveConversationId(getConversationId);
 				store = getStore(key);
 				if (params.todos === void 0) {
 					const items = store.read();

package/dist/src/agent/tools/workflow-tool.d.ts

@@ -13,7 +13,7 @@ export type WorkflowToolInput = {
 };
 export interface WorkflowToolDeps {
     catalog: WorkflowCatalog;
-    getCurrentSessionKey?: () => string | undefined;
+    getCurrentConversationId?: () => string | undefined;
     getConfig: () => import('../../config/schema.js').Config | undefined;
     startWorkflowRun?: (params: StartWorkflowRunServiceParams) => Promise<WorkflowRunServiceResult>;
 }

package/dist/src/agent/tools/workflow-tool.js

@@ -1,12 +1,14 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/workflow-tool.ts
 /**
 * `workflow` — starts a persisted workflow run in a dedicated chat session.
 */
+init_src();
 init_logger();
 const log = createLogger("Agent:WorkflowTool");
 const WorkflowToolSchema = Type.Object({
@@ -23,7 +25,7 @@ function createWorkflowTool(deps) {
 		description: [
 			"Start a multi-agent workflow run in its own chat session.",
 			"Use `name` for a workflow from the visual workflow catalog.",
-			"Returns immediately with runId + sessionKey — track progress in the linked chat session."
+			"Returns immediately with runId + conversationId — track progress in the linked chat session."
 		].join(" "),
 		parameters: WorkflowToolSchema,
 		async execute(_toolCallId, params) {
@@ -36,7 +38,7 @@ function createWorkflowTool(deps) {
 			};
 			let definitionId;
 			try {
-				definitionId = resolveDefinitionId(params, deps.catalog, deps.getConfig(), deps.getCurrentSessionKey?.());
+				definitionId = resolveDefinitionId(params, deps.catalog, deps.getConfig(), deps.getCurrentConversationId?.());
 			} catch (e) {
 				const message = e instanceof Error ? e.message : String(e);
 				return {
@@ -48,13 +50,13 @@ function createWorkflowTool(deps) {
 				};
 			}
 			const config = deps.getConfig();
-			const parentSessionKey = deps.getCurrentSessionKey?.()?.trim();
-			const agentId = extractProfileAgentId(parentSessionKey, config);
+			const parentConversationId = deps.getCurrentConversationId?.()?.trim();
+			const agentId = extractProfileAgentId(parentConversationId, config);
 			const goal = params.goal?.trim() || "";
 			const taskRunId = params.taskRunId?.trim();
-			const source = parentSessionKey ? {
+			const source = parentConversationId ? {
 				kind: "chat",
-				sessionKey: parentSessionKey
+				conversationId: parentConversationId
 			} : { kind: "api" };
 			const inputEnvelope = taskRunId ? {
 				payload: params.args ?? {},
@@ -68,7 +70,7 @@ function createWorkflowTool(deps) {
 					taskRunId,
 					input: inputEnvelope ? void 0 : params.args,
 					inputEnvelope,
-					parentSessionKey,
+					parentConversationId,
 					source
 				});
 				if (result.ok === false) return {
@@ -101,7 +103,7 @@ function createWorkflowTool(deps) {
 						]
 					}, {
 						kind: "session",
-						id: result.sessionKey,
+						id: result.conversationId,
 						title: goal || definitionId,
 						capabilities: ["open", "continue_in_chat"]
 					}]
@@ -109,13 +111,13 @@ function createWorkflowTool(deps) {
 				return {
 					content: [{
 						type: "text",
-						text: appendProductDeliveryText(`${summary}\n\nsessionKey: ${result.sessionKey}`, delivery)
+						text: appendProductDeliveryText(`${summary}\n\nconversationId: ${result.conversationId}`, delivery)
 					}],
 					details: {
 						runId: result.runId,
-						sessionKey: result.sessionKey,
+						conversationId: result.conversationId,
 						definitionId,
-						parentSessionKey: parentSessionKey ?? null,
+						parentConversationId: parentConversationId ?? null,
 						delivery
 					}
 				};
@@ -137,13 +139,13 @@ function createWorkflowTool(deps) {
 		}
 	};
 }
-function resolveDefinitionId(params, catalog, config, sessionKey) {
+function resolveDefinitionId(params, catalog, config, conversationId) {
 	const name = params.name?.trim();
 	if (name) {
 		catalog.load(name);
 		return name;
 	}
-	const configuredDefault = config ? resolveEffectiveAgentProfileForSession(config, sessionKey).config.workflows.default : void 0;
+	const configuredDefault = config ? resolveEffectiveAgentProfileForSession(config, conversationId).config.workflows.default : void 0;
 	if (configuredDefault) {
 		catalog.load(configuredDefault);
 		return configuredDefault;

package/dist/src/agent/tools/write.js

@@ -1,4 +1,5 @@
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { writeWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
 import { isBareProfileMarkdownFileName, resolvePathUnderWorkspace, resolveProfileMarkdownPathIfBareName } from "./tool-paths.js";
@@ -7,6 +8,7 @@ import { basename, relative, sep } from "path";
 import { realpath } from "fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/write.ts
+init_src();
 const MAX_FILE_SIZE = 10 * 1024 * 1024;
 const WriteFileSchema = Type.Object({
 	path: Type.String({ description: "File path to write" }),

package/dist/src/agent/tools/xopc-use-tool.d.ts

@@ -22,7 +22,7 @@ export interface XopcUseToolDeps {
     getWorkspace?: () => string;
     getConfig?: () => Config | undefined;
     getCurrentAgentId?: () => string | undefined;
-    getCurrentSessionKey?: () => string | undefined;
+    getCurrentConversationId?: () => string | undefined;
     getAutomationService?: () => AutomationService | undefined;
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;

package/dist/src/agent/tools/xopc-use-tool.js

@@ -1,7 +1,8 @@
 import { runWithActivityContext } from "../../activity/context.js";
-import { runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+import { init_transaction, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
 import { TaskCommandSchema, TaskContextInputSchema } from "../../../packages/gateway-contract/src/tasks.js";
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { enqueueTaskChangedEvent } from "../../tasks/task-change-events.js";
 import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
@@ -28,7 +29,9 @@ import "../../tasks/index.js";
 import { randomUUID } from "node:crypto";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/xopc-use-tool.ts
+init_src();
 init_resolve_route();
+init_transaction();
 const XopcUseToolSchema = Type.Object({
 	mode: Type.Union([
 		Type.Literal("proactive"),
@@ -322,8 +325,8 @@ function deliveryForXopcResult(mode, command, result, dryRun) {
 function currentProjectId(args, deps) {
 	const explicit = trimString(args.projectId);
 	if (explicit) return explicit;
-	const sessionKey = trimString(args.sessionKey) ?? deps.getCurrentSessionKey?.();
-	return sessionKey ? getSessionMetadata(sessionKey)?.projectId : void 0;
+	const conversationId = trimString(args.conversationId) ?? deps.getCurrentConversationId?.();
+	return conversationId ? getSessionMetadata(conversationId)?.projectId : void 0;
 }
 function automationPayload(args, key) {
 	return record(args[key]) ?? args;
@@ -681,7 +684,7 @@ async function handleProject(command, args, deps, dryRun) {
 			actor: {
 				kind: "agent",
 				agentId: deps.getCurrentAgentId?.(),
-				sessionKey: deps.getCurrentSessionKey?.()
+				conversationId: deps.getCurrentConversationId?.()
 			}
 		};
 		if (dryRun) return {
@@ -1260,7 +1263,7 @@ async function handleTask(command, args, deps, dryRun) {
 			};
 			contract[field] = value;
 		}
-		const sessionKey = trimString(args.sessionKey) ?? deps.getCurrentSessionKey?.();
+		const conversationId = trimString(args.conversationId) ?? deps.getCurrentConversationId?.();
 		const config = deps.getConfig?.();
 		const projectService = deps.getProjectService?.();
 		const explicitAgentId = trimString(args.agentId);
@@ -1284,9 +1287,9 @@ async function handleTask(command, args, deps, dryRun) {
 				outputDestinations: []
 			},
 			dependencies: dependsOnTaskIds,
-			context: sessionKey ? [{
+			context: conversationId ? [{
 				targetKind: "session",
-				targetId: sessionKey,
+				targetId: conversationId,
 				role: "input",
 				pinned: false,
 				retrievalPolicy: {},
@@ -1782,17 +1785,17 @@ function createXopcUseTool(deps) {
 			};
 			if (!command) return errorText("command is required", details);
 			try {
-				const sessionKey = deps.getCurrentSessionKey?.();
+				const conversationId = deps.getCurrentConversationId?.();
 				const agentId = deps.getCurrentAgentId?.();
 				const result = await runWithActivityContext({
 					actor: {
 						kind: "agent",
 						agentId,
-						sessionKey
+						conversationId
 					},
 					initiator: {
 						kind: "user",
-						sessionKey
+						conversationId
 					},
 					source: {
 						kind: "xopc_use",
@@ -1837,11 +1840,11 @@ function handleProactive(command, args, deps, dryRun) {
 			"expired",
 			"resolved"
 		].includes(card.status)) throw new Error("Open a current communication card");
-		const sessionKey = deps.getCurrentSessionKey?.();
-		if (!sessionKey) throw new Error("A conversation is required");
+		const conversationId = deps.getCurrentConversationId?.();
+		if (!conversationId) throw new Error("A conversation is required");
 		return {
 			card,
-			...continueMailFollowUp(workspace, card.communication.id, sessionKey)
+			...continueMailFollowUp(workspace, card.communication.id, conversationId)
 		};
 	}
 	if (command === "start") return startDelegation(workspace, args);

package/dist/src/agent/types.d.ts

@@ -49,7 +49,7 @@ export interface AgentConfig {
     list?: Record<string, AgentDefaults>;
 }
 export interface AgentRuntimeState {
-    sessionKey: string;
+    conversationId: string;
     currentModel?: string;
     messageCount: number;
     lastActivity: number;

package/dist/src/agent/workflow/catalog.js

@@ -1,10 +1,12 @@
-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 { DurableState } from "../../storage/sqlite/durable-state.js";
 import { buildWorkflowDefinition } from "../../workflows/domain/definition-utils.js";
 import { validateWorkflowDefinitionInput } from "../../workflows/domain/validation.js";
 import { BUILTIN_WORKFLOWS } from "./builtins/index.js";
 //#region src/agent/workflow/catalog.ts
+init_connection();
+init_transaction();
 const NAME_RE = /^[a-z][a-z0-9_-]*$/;
 function createWorkflowCatalog() {
 	const definitions = new DurableState("workflow-definitions");

package/dist/src/agent/workflow/channel-capability.d.ts

@@ -20,7 +20,7 @@ export type WorkflowProgressMode =
  | 'final-only';
 export interface WorkflowProgressPostInput {
     /** Routing key for the run — channel uses it to resolve the destination chat. */
-    sessionKey: string;
+    conversationId: string;
     /** Pre-rendered progress text (already includes header / phases / logs). */
     text: string;
     /**
@@ -65,7 +65,7 @@ export interface ChannelProgressCapability {
      * Deliver one progress update.
      *
      * Capability is responsible for:
-     * - Resolving `sessionKey` → platform chat/thread id (channel-specific).
+     * - Resolving `conversationId` → platform chat/thread id (channel-specific).
      * - Encoding the text payload (markdown / plain / HTML, line breaks).
      * - Calling editMessageText vs sendMessage based on `previousMessageId`.
      * - Honouring platform rate limits (429 retry-after, etc.).

package/dist/src/agent/workflow/progress-broker.d.ts

@@ -10,7 +10,7 @@
  *                                                       ▼
  *                                          WorkflowProgressBroker
  *                                                       │
- *                                  per-(sessionKey, toolCallId) state
+ *                                  per-(conversationId, toolCallId) state
  *                                                       │
  *                                   ┌───────────────────┼───────────────────┐
  *                                   ▼                   ▼                   ▼
@@ -37,7 +37,7 @@ export interface BrokerListenerHandle {
  */
 export interface SessionBusLike {
     registerListener(type: AgentEvent['type'] | 'all', listener: (event: AgentEvent, context: {
-        sessionKey: string;
+        conversationId: string;
     }) => void): () => void;
 }
 export declare class WorkflowProgressBroker {
@@ -55,9 +55,9 @@ export declare class WorkflowProgressBroker {
     registerChannel(cap: ChannelProgressCapability): () => void;
     attachTo(bus: SessionBusLike): BrokerListenerHandle;
     /** Visible for tests — direct entry path bypassing the SessionBus glue. */
-    onUpdate(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot): void;
+    onUpdate(conversationId: string, toolCallId: string, snapshot: WorkflowSnapshot): void;
     /** Visible for tests — direct entry path bypassing the SessionBus glue. */
-    onEnd(sessionKey: string, toolCallId: string, snapshot: WorkflowSnapshot | null): void;
+    onEnd(conversationId: string, toolCallId: string, snapshot: WorkflowSnapshot | null): void;
     private dispatchToChannel;
     private sendNow;
     private cancelPending;

package/dist/src/agent/workflow/progress-broker.js

@@ -36,13 +36,13 @@ var WorkflowProgressBroker = class {
 			if (e.toolName !== WORKFLOW_TOOL_NAME) return;
 			const snap = extractWorkflowSnapshot(e.partialResult);
 			if (!snap) return;
-			this.onUpdate(ctx.sessionKey, e.toolCallId, snap);
+			this.onUpdate(ctx.conversationId, e.toolCallId, snap);
 		});
 		const offEnd = bus.registerListener("tool_execution_end", (event, ctx) => {
 			const e = event;
 			if (e.toolName !== WORKFLOW_TOOL_NAME) return;
 			const snap = extractWorkflowSnapshot(e.result, { fromResultEnvelope: true });
-			this.onEnd(ctx.sessionKey, e.toolCallId, snap);
+			this.onEnd(ctx.conversationId, e.toolCallId, snap);
 		});
 		return { dispose: () => {
 			offUpdate();
@@ -51,55 +51,55 @@ var WorkflowProgressBroker = class {
 		} };
 	}
 	/** Visible for tests — direct entry path bypassing the SessionBus glue. */
-	onUpdate(sessionKey, toolCallId, snapshot) {
-		const key = stateKey(sessionKey, toolCallId);
+	onUpdate(conversationId, toolCallId, snapshot) {
+		const key = stateKey(conversationId, toolCallId);
 		const state = this.getOrCreateState(key, snapshot);
 		state.prevSnapshot = state.snapshot;
 		state.snapshot = snapshot;
 		const isKey = isKeyEvent(state.prevSnapshot, snapshot);
-		for (const cap of this.subscribers) this.dispatchToChannel(state, sessionKey, cap, {
+		for (const cap of this.subscribers) this.dispatchToChannel(state, conversationId, cap, {
 			isFinal: false,
 			isKey
 		});
 	}
 	/** Visible for tests — direct entry path bypassing the SessionBus glue. */
-	onEnd(sessionKey, toolCallId, snapshot) {
-		const key = stateKey(sessionKey, toolCallId);
+	onEnd(conversationId, toolCallId, snapshot) {
+		const key = stateKey(conversationId, toolCallId);
 		const state = this.states.get(key);
 		if (!state) return;
 		if (snapshot) state.snapshot = snapshot;
 		for (const cap of this.subscribers) {
 			this.cancelPending(state, cap.channelId);
-			this.dispatchToChannel(state, sessionKey, cap, {
+			this.dispatchToChannel(state, conversationId, cap, {
 				isFinal: true,
 				isKey: true
 			});
 		}
 		setTimeout(() => this.states.delete(key), 2e3);
 	}
-	dispatchToChannel(state, sessionKey, cap, flags) {
+	dispatchToChannel(state, conversationId, cap, flags) {
 		const cfg = this.resolveChannelSettings(cap);
 		if (!cfg.enabled) return;
 		if (cfg.mode === "final-only" && !flags.isFinal) return;
 		const chState = this.getOrCreateChannelState(state, cap.channelId);
 		if (flags.isFinal || flags.isKey) {
 			this.cancelPending(state, cap.channelId);
-			this.sendNow(state, sessionKey, cap, cfg, flags.isFinal);
+			this.sendNow(state, conversationId, cap, cfg, flags.isFinal);
 			return;
 		}
 		const elapsed = this.now() - chState.lastSentAt;
 		const wait = Math.max(0, cfg.throttleMs - elapsed);
 		if (wait === 0) {
-			this.sendNow(state, sessionKey, cap, cfg, false);
+			this.sendNow(state, conversationId, cap, cfg, false);
 			return;
 		}
 		if (chState.pendingTimer) return;
 		chState.pendingTimer = setTimeout(() => {
 			chState.pendingTimer = void 0;
-			this.sendNow(state, sessionKey, cap, cfg, false);
+			this.sendNow(state, conversationId, cap, cfg, false);
 		}, wait);
 	}
-	async sendNow(state, sessionKey, cap, cfg, isFinal) {
+	async sendNow(state, conversationId, cap, cfg, isFinal) {
 		const chState = this.getOrCreateChannelState(state, cap.channelId);
 		if (chState.inflight) await chState.inflight.catch(() => void 0);
 		const text = renderWorkflowText(state.snapshot, isFinal, {
@@ -109,7 +109,7 @@ var WorkflowProgressBroker = class {
 		});
 		const previousMessageId = cfg.mode === "edit" ? chState.lastMessageId : void 0;
 		const task = cap.postProgress({
-			sessionKey,
+			conversationId,
 			text,
 			previousMessageId,
 			isFinal,
@@ -123,7 +123,7 @@ var WorkflowProgressBroker = class {
 				err,
 				errorMessage: msg,
 				channelId: cap.channelId,
-				sessionKey
+				conversationId
 			}, `workflow progress postProgress failed: ${msg}`);
 		}).finally(() => {
 			chState.inflight = void 0;
@@ -196,8 +196,8 @@ function getWorkflowProgressBroker() {
 function _resetWorkflowProgressBrokerForTests() {
 	singleton = null;
 }
-function stateKey(sessionKey, toolCallId) {
-	return `${sessionKey}
${toolCallId ?? ""}`;
+function stateKey(conversationId, toolCallId) {
+	return `${conversationId}
${toolCallId ?? ""}`;
 }
 /**
 * Compare two snapshots and decide whether the new one is "key" — i.e. worth

package/dist/src/agent/workflow/subagent-runner.js

@@ -30,7 +30,7 @@ var DelegateSubagentRunner = class {
 		const childOptions = {
 			workspace: this.deps.workspace,
 			goal: fullPrompt,
-			requesterSessionKey: opts.sessionMetadata?.parentSessionKey,
+			requesterConversationId: opts.sessionMetadata?.parentConversationId,
 			allowedToolNames: allowed,
 			maxIterations: opts.maxIterations ?? DEFAULT_MAX_ITERATIONS,
 			model,
@@ -56,11 +56,11 @@ var DelegateSubagentRunner = class {
 				}
 			} : void 0
 		};
-		if (opts.sessionKey && opts.sessionMetadata && this.deps.sessionStore) {
-			await this.preparePersistentSubagentSession(opts.sessionKey, opts.sessionMetadata);
-			childOptions.sessionKey = opts.sessionKey;
+		if (opts.conversationId && opts.sessionMetadata && this.deps.sessionStore) {
+			await this.preparePersistentSubagentSession(opts.conversationId, opts.sessionMetadata);
+			childOptions.conversationId = opts.conversationId;
 			childOptions.transcriptRuntime = await createSqliteTranscriptRuntime({
-				sessionKey: opts.sessionKey,
+				conversationId: opts.conversationId,
 				sessionStore: this.deps.sessionStore
 			});
 		}
@@ -92,13 +92,13 @@ var DelegateSubagentRunner = class {
 			opts.signal?.removeEventListener("abort", onAbort);
 		}
 	}
-	async preparePersistentSubagentSession(sessionKey, metadata) {
+	async preparePersistentSubagentSession(conversationId, metadata) {
 		const store = this.deps.sessionStore;
 		if (!store) return;
-		await store.resolveTranscriptPath(sessionKey, { metadata: {
+		await store.resolveTranscriptPath(conversationId, { metadata: {
 			sessionType: "workflow-subagent",
 			hiddenFromSessionList: true,
-			parentSessionKey: metadata.parentSessionKey,
+			parentConversationId: metadata.parentConversationId,
 			projectId: metadata.projectId,
 			workflowRunId: metadata.workflowRunId,
 			workflowDefinitionId: metadata.workflowDefinitionId,
@@ -114,10 +114,10 @@ var DelegateSubagentRunner = class {
 				peerId: metadata.workflowRunId
 			}
 		} });
-		await store.updateMetadata(sessionKey, {
+		await store.updateMetadata(conversationId, {
 			sessionType: "workflow-subagent",
 			hiddenFromSessionList: true,
-			parentSessionKey: metadata.parentSessionKey,
+			parentConversationId: metadata.parentConversationId,
 			projectId: metadata.projectId,
 			workflowRunId: metadata.workflowRunId,
 			workflowDefinitionId: metadata.workflowDefinitionId,

package/dist/src/agent/workflow/types.d.ts

@@ -131,9 +131,9 @@ export interface SubagentRunOptions<T = unknown> {
     /** Hint about which phase this agent belongs to (passed through for logging). */
     phase?: string;
     /** Persistent hidden session for this workflow subagent. */
-    sessionKey?: string;
+    conversationId?: string;
     sessionMetadata?: {
-        parentSessionKey?: string;
+        parentConversationId?: string;
         projectId?: string;
         workflowRunId: string;
         workflowDefinitionId: string;

package/dist/src/agent/workflow/workflow-child-tools.js

@@ -16,7 +16,7 @@ function buildWorkflowChildTools(childOptions) {
 		workspace: childOptions.workspace,
 		getPrimaryModel: () => childOptions.model,
 		agentId: childOptions.agentId,
-		sessionKey: childOptions.browserSessionKey,
+		conversationId: childOptions.browserConversationId,
 		disabledTools: new Set([
 			EXTERNAL_TOOL_NAMES.search,
 			EXTERNAL_TOOL_NAMES.describe,

package/dist/src/agent/workspace-runtime/registry.js

@@ -1,5 +1,5 @@
-import { init_agent_session_key, normalizeAgentId } from "../../routing/agent-session-key.js";
 import { init_agent_scope, resolveAgentIdForWorkspacePath } from "../agent-scope.js";
+import { init_agent_session_key, normalizeAgentId } from "../../routing/agent-session-key.js";
 import { SkillManager } from "../skills/skill-manager.js";
 import { SystemPromptBuilder } from "../prompt/service-prompt-builder.js";
 import { UserContextRuntimeRegistry } from "../../user-context/runtime.js";