@xopcai/xopc 0.0.284 → 0.0.286

package/dist/src/agent/tools/chain-tracker.js

@@ -24,11 +24,11 @@ var ToolChainTracker = class {
 	/**
 	* Start a new tool chain for a session
 	*/
-	startChain(sessionKey) {
+	startChain(conversationId) {
 		if (!this.config.enabled) return "";
-		const chainId = this.generateChainId(sessionKey);
+		const chainId = this.generateChainId(conversationId);
 		const chain = {
-			sessionKey,
+			conversationId,
 			startTime: Date.now(),
 			nodes: [],
 			totalCalls: 0,
@@ -37,9 +37,9 @@ var ToolChainTracker = class {
 			totalDurationMs: 0
 		};
 		this.chains.set(chainId, chain);
-		this.currentChainId.set(sessionKey, chainId);
+		this.currentChainId.set(conversationId, chainId);
 		log.debug({
-			sessionKey,
+			conversationId,
 			chainId
 		}, "Started new tool chain");
 		return chainId;
@@ -47,12 +47,12 @@ var ToolChainTracker = class {
 	/**
 	* Record a tool call in the chain
 	*/
-	recordCall(sessionKey, toolName, params, durationMs = 0) {
+	recordCall(conversationId, toolName, params, durationMs = 0) {
 		if (!this.config.enabled) return "";
-		const chainId = this.currentChainId.get(sessionKey);
+		const chainId = this.currentChainId.get(conversationId);
 		if (!chainId) {
 			log.warn({
-				sessionKey,
+				conversationId,
 				toolName
 			}, `Tool chain: recordCall skipped — no active chain for session (missing turn_start?); tool=${toolName}`);
 			return "";
@@ -61,7 +61,7 @@ var ToolChainTracker = class {
 		if (!chain) {
 			log.warn({
 				chainId,
-				sessionKey,
+				conversationId,
 				toolName
 			}, `Tool chain: id ${chainId} missing from store; tool=${toolName}`);
 			return "";
@@ -90,9 +90,9 @@ var ToolChainTracker = class {
 	/**
 	* Record tool call result
 	*/
-	recordResult(sessionKey, nodeId, result, error, durationMs) {
+	recordResult(conversationId, nodeId, result, error, durationMs) {
 		if (!this.config.enabled) return;
-		const chainId = this.currentChainId.get(sessionKey);
+		const chainId = this.currentChainId.get(conversationId);
 		if (!chainId) return;
 		const chain = this.chains.get(chainId);
 		if (!chain) return;
@@ -101,7 +101,7 @@ var ToolChainTracker = class {
 			log.warn({
 				nodeId,
 				chainId,
-				sessionKey,
+				conversationId,
 				chainNodeCount: chain.nodes.length
 			}, `Tool chain: recordResult skipped — node ${nodeId} not in chain`);
 			return;
@@ -123,8 +123,8 @@ var ToolChainTracker = class {
 	/**
 	* End the current chain for a session
 	*/
-	endChain(sessionKey) {
-		const chainId = this.currentChainId.get(sessionKey);
+	endChain(conversationId) {
+		const chainId = this.currentChainId.get(conversationId);
 		if (!chainId) return;
 		const chain = this.chains.get(chainId);
 		if (chain) {
@@ -136,21 +136,21 @@ var ToolChainTracker = class {
 				duration: chain.endTime - chain.startTime
 			}, "Tool chain ended");
 		}
-		this.currentChainId.delete(sessionKey);
-		if (this.config.autoPrune) this.pruneOldChains(sessionKey);
+		this.currentChainId.delete(conversationId);
+		if (this.config.autoPrune) this.pruneOldChains(conversationId);
 	}
 	/**
 	* Get chain summary as text
 	*/
-	getChainSummary(sessionKey) {
-		const chainId = this.currentChainId.get(sessionKey);
+	getChainSummary(conversationId) {
+		const chainId = this.currentChainId.get(conversationId);
 		if (!chainId) return "No active tool chain";
 		const chain = this.chains.get(chainId);
 		if (!chain) return "Chain not found";
 		const lines = [
 			`Tool Chain Summary (Chain: ${chainId})`,
 			`================================`,
-			`Session: ${sessionKey}`,
+			`Session: ${conversationId}`,
 			`Status: ${chain.endTime ? "Completed" : "Active"}`,
 			`Duration: ${chain.endTime ? ((chain.endTime - chain.startTime) / 1e3).toFixed(1) : "Ongoing"}s`,
 			"",
@@ -171,8 +171,8 @@ var ToolChainTracker = class {
 	/**
 	* Get chain visualization (ASCII tree)
 	*/
-	getChainVisualization(sessionKey) {
-		const chainId = this.currentChainId.get(sessionKey);
+	getChainVisualization(conversationId) {
+		const chainId = this.currentChainId.get(conversationId);
 		if (!chainId) return "No active chain";
 		const chain = this.chains.get(chainId);
 		if (!chain) return "Chain not found";
@@ -188,14 +188,14 @@ var ToolChainTracker = class {
 	/**
 	* Get all chains for a session
 	*/
-	getSessionChains(sessionKey) {
-		return Array.from(this.chains.values()).filter((chain) => chain.sessionKey === sessionKey);
+	getSessionChains(conversationId) {
+		return Array.from(this.chains.values()).filter((chain) => chain.conversationId === conversationId);
 	}
 	/**
 	* Get current active chain
 	*/
-	getCurrentChain(sessionKey) {
-		const chainId = this.currentChainId.get(sessionKey);
+	getCurrentChain(conversationId) {
+		const chainId = this.currentChainId.get(conversationId);
 		if (!chainId) return void 0;
 		return this.chains.get(chainId);
 	}
@@ -217,9 +217,9 @@ var ToolChainTracker = class {
 	/**
 	* Export chains as JSON
 	*/
-	exportChains(sessionKey) {
+	exportChains(conversationId) {
 		let chains = Array.from(this.chains.values());
-		if (sessionKey) chains = chains.filter((c) => c.sessionKey === sessionKey);
+		if (conversationId) chains = chains.filter((c) => c.conversationId === conversationId);
 		return JSON.stringify({
 			exportedAt: (/* @__PURE__ */ new Date()).toISOString(),
 			totalChains: chains.length,
@@ -255,8 +255,8 @@ var ToolChainTracker = class {
 			...config
 		};
 	}
-	generateChainId(sessionKey) {
-		return `${sessionKey}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+	generateChainId(conversationId) {
+		return `${conversationId}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
 	}
 	generateNodeId() {
 		return `node-${Math.random().toString(36).substr(2, 9)}`;
@@ -273,8 +273,8 @@ var ToolChainTracker = class {
 			log.debug({ removed: nodesToRemove }, "Pruned old nodes from chain");
 		}
 	}
-	pruneOldChains(sessionKey) {
-		const sessionChains = this.getSessionChains(sessionKey);
+	pruneOldChains(conversationId) {
+		const sessionChains = this.getSessionChains(conversationId);
 		if (sessionChains.length > this.config.maxChainsPerSession) {
 			sessionChains.sort((a, b) => a.startTime - b.startTime);
 			const chainsToRemove = sessionChains.slice(0, sessionChains.length - this.config.maxChainsPerSession);

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

@@ -16,7 +16,7 @@ export type ClarifyRequestResult = {
     expiresAt?: number;
 };
 export type GatewayClarifyRequestFn = (context: {
-    sessionKey: string;
+    conversationId: string;
     runId: string;
     toolCallId: string;
 }, request: ClarifyRequestPayload) => Promise<ClarifyRequestResult>;

package/dist/src/agent/tools/create-share-tool.js

@@ -1,4 +1,5 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { assertWorkspaceTreeReadable, checkedFilePath } from "../sandbox/fileAccess.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
 import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
@@ -26,6 +27,7 @@ import { Type } from "@sinclair/typebox";
 * to share with a friend on WeChat (or anywhere)" — the model itself decides
 * when to call it, with optional hints about audience.
 */
+init_src();
 const CreateShareSchema = Type.Object({
 	filePath: Type.String({ description: "File or folder to share. Relative paths resolve under the agent workspace; absolute paths are used as given (must be inside the workspace)." }),
 	audience: Type.Optional(Type.Enum({

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

@@ -9,7 +9,7 @@ export interface DelegateToolDeps {
     bus: import('../../infra/bus/index.js').MessageBus;
     getConfig: () => import('../../config/schema.js').Config | undefined;
     getCurrentContext?: () => {
-        sessionKey?: string;
+        conversationId?: string;
         channel?: string;
         accountId?: string;
         to?: string;

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

@@ -85,12 +85,12 @@ function createDelegateTool(deps) {
 			const mode = input.mode ?? "inspect";
 			const tools = delegateToolNames(mode, input.toolset);
 			if (!tools.length) throw new Error("No permitted tools in the requested toolset");
-			const parentSessionKey = deps.getCurrentContext?.()?.sessionKey;
+			const parentConversationId = deps.getCurrentContext?.()?.conversationId;
 			const model = deps.getSubagentModel();
 			let workspace = deps.workspace, environmentId;
 			if (mode === "implement") {
-				if (!parentSessionKey) throw new Error("Implementation delegation requires a project session");
-				const parent = new SessionEnvironmentService().get(parentSessionKey);
+				if (!parentConversationId) throw new Error("Implementation delegation requires a project session");
+				const parent = new SessionEnvironmentService().get(parentConversationId);
 				if (!parent?.projectId) throw new Error("Attach this session to a project before implementation delegation");
 				const environment = await new LocalWorktreeManager().provisionManagedWorktree({
 					projectId: parent.projectId,
@@ -104,7 +104,7 @@ function createDelegateTool(deps) {
 				workspace,
 				goal: mode === "review" ? `Independently review the actual changes. Inspect review_workspace and relevant source/tests. Report actionable defects with file and line evidence, severity and a concrete failure example. If there are no findings, state the checks and remaining uncertainty. Do not treat the parent's completion claim as evidence.\n\n${input.goal}` : input.goal,
 				context: input.context,
-				requesterSessionKey: parentSessionKey,
+				requesterConversationId: parentConversationId,
 				allowedToolNames: tools,
 				maxIterations: input.maxIterations ?? 30,
 				model,

package/dist/src/agent/tools/exec-command.d.ts

@@ -33,7 +33,7 @@ export interface ExecCommandUpdateDetails {
 export interface CreateExecCommandToolOptions {
     /** Env var names allowed through prepareSafeToolEnv even if they match secret heuristics. */
     getCommandIsolation?: () => CommandIsolation | undefined;
-    getSessionKey?: () => string | undefined;
+    getConversationId?: () => string | undefined;
     getSkillPassthroughEnvVarNames?: () => string[];
     prepareEnv?: (baseEnv: Record<string, string>, cwd: string) => Promise<Record<string, string>>;
 }

package/dist/src/agent/tools/exec-command.js

@@ -124,7 +124,7 @@ function createExecCommandTool(workspaceCwd, options) {
 			const timeoutMs = commandTimeout(params.timeoutMs, policy.timeoutMs);
 			const maxOutputChars = clampMaxOutputChars(params.maxOutputChars);
 			const runtimeEnv = options?.prepareEnv ? await options.prepareEnv(policy.sanitizedEnv, policy.effectiveCwd) : policy.sanitizedEnv;
-			const owner = options?.getSessionKey?.() ?? workspaceCwd;
+			const owner = options?.getConversationId?.() ?? workspaceCwd;
 			const registry = commandRegistry();
 			let commandResult = await registry.start({
 				workspace: workspaceCwd,

package/dist/src/agent/tools/factory.d.ts

@@ -31,7 +31,7 @@ export interface ToolFactoryDeps {
     getCurrentContext: () => {
         channel: string;
         chatId: string;
-        sessionKey: string;
+        conversationId: string;
         origin: TurnOrigin;
     } | null;
     endpointTools?: EndpointToolRuntime;
@@ -93,7 +93,7 @@ export interface CreateCoreToolsOptions {
     getPrimaryModel?: () => Model<Api>;
     getMemoryManager?: () => MemoryManager;
     agentId?: string;
-    sessionKey?: string;
+    conversationId?: string;
     /** When set, registers local skill tools plus marketplace discovery for this workspace. */
     getSkillManager?: () => SkillManager;
 }
@@ -113,7 +113,7 @@ export declare class AgentToolsFactory {
     /** Close Playwright and all pages (gateway stop, agent manager dispose, or config hot-reload). */
     shutdownBrowser(): Promise<void>;
     /** Drop the tab for a session when its agent instance is removed. */
-    closeBrowserPageForSession(sessionKey: string): Promise<void>;
+    closeBrowserPageForSession(conversationId: string): Promise<void>;
     createCoreTools(options?: CreateCoreToolsOptions): AgentTool<any, any>[];
     createCapabilityTools(capabilityNames: readonly string[], options?: Pick<CreateCoreToolsOptions, 'disabledTools'>): AgentTool<any, any>[];
     getLazyCapabilityToolNames(): string[];

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

@@ -7,7 +7,7 @@ import { getSessionMetadata } from "../../storage/sqlite/session-repository.js";
 import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/session-task-plan-repository.js";
 import "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
-import { resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
+import { resolveEffectiveAgentConfigForAgent, resolveEffectiveAgentConfigForSession } from "../../config/agent-profile.js";
 import "../../../packages/browser-control-contract/src/index.js";
 import { getEmbeddedExecutionRunId, getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { wrapToolsWithProtection } from "./executor.js";
@@ -154,13 +154,13 @@ var AgentToolsFactory = class AgentToolsFactory {
 			},
 			allowedUploadRoots: [this.deps.workspace],
 			emit: this.deps.emitBrowserEvent,
-			resolveTarget: (sessionKey) => {
-				const binding = getBrowserTabBinding(sessionKey);
+			resolveTarget: (conversationId) => {
+				const binding = getBrowserTabBinding(conversationId);
 				if (binding) return {
 					kind: "attached_tab",
 					bindingId: binding.id
 				};
-				const endpointBinding = this.deps.endpointTools?.bindings.get(sessionKey);
+				const endpointBinding = this.deps.endpointTools?.bindings.get(conversationId);
 				return endpointBinding ? {
 					kind: "endpoint",
 					endpointId: endpointBinding.endpointId
@@ -177,8 +177,8 @@ var AgentToolsFactory = class AgentToolsFactory {
 		this.browserRuntime = null;
 	}
 	/** Drop the tab for a session when its agent instance is removed. */
-	async closeBrowserPageForSession(sessionKey) {
-		await this.browserRuntime?.closeTaskSession(sessionKey);
+	async closeBrowserPageForSession(conversationId) {
+		await this.browserRuntime?.closeTaskSession(conversationId);
 	}
 	createCoreTools(options) {
 		const workspace = options?.workspace ?? this.deps.workspace;
@@ -204,16 +204,20 @@ var AgentToolsFactory = class AgentToolsFactory {
 		});
 		const agentId = options?.agentId;
 		const resolvedAgentId = agentId ?? (cfg ? resolveDefaultAgentId(cfg) : "main");
-		const currentSessionKey = () => options?.sessionKey ?? this.deps.getCurrentContext?.()?.sessionKey;
-		const currentAccess = () => resolveUserContextSessionAccess(this.deps.getConfig?.(), currentSessionKey());
+		const currentConversationId = () => options?.conversationId ?? this.deps.getCurrentContext?.()?.conversationId;
+		const deliveryContext = () => {
+			if (currentConversationId() && getSessionMetadata(currentConversationId())?.sessionType === "heartbeat") throw new Error("Heartbeat notifications must be returned in the final response for policy-controlled delivery.");
+			return this.deps.getCurrentContext();
+		};
+		const currentAccess = () => resolveUserContextSessionAccess(this.deps.getConfig?.(), currentConversationId());
 		const knowledgeWritePolicy = () => this.deps.getConfig?.()?.userContext.knowledgeMemory.writePolicy ?? "deny";
 		const currentProjectId = () => {
-			const key = currentSessionKey();
+			const key = currentConversationId();
 			return key ? getSessionMetadata(key)?.projectId : void 0;
 		};
 		const getCommandIsolation = () => {
 			const config = this.deps.getConfig?.();
-			return config ? resolveEffectiveAgentConfigForSession(config, this.deps.getCurrentContext()?.sessionKey ?? `agent:${agentId ?? "main"}:internal`).config.runtime.commandIsolation : void 0;
+			return config ? (currentConversationId() ? resolveEffectiveAgentConfigForSession(config, currentConversationId()) : resolveEffectiveAgentConfigForAgent(config, resolvedAgentId)).config.runtime.commandIsolation : void 0;
 		};
 		const externalTools = createDefaultExternalToolGatewayTools({
 			workspace,
@@ -245,28 +249,28 @@ var AgentToolsFactory = class AgentToolsFactory {
 				const executionSession = getEmbeddedExecutionSession();
 				const runId = getEmbeddedExecutionRunId();
 				if (executionSession && runId) return (request) => req({
-					sessionKey: executionSession,
+					conversationId: executionSession,
 					runId,
 					toolCallId
 				}, request);
 				const ctx = this.deps.getCurrentContext();
-				if (!ctx?.sessionKey) return null;
+				if (!ctx?.conversationId) return null;
 				if (!CLARIFY_SUPPORTED_CHANNELS.has(ctx.channel)) return null;
 				if (!runId) return null;
 				return (request) => req({
-					sessionKey: ctx.sessionKey,
+					conversationId: ctx.conversationId,
 					runId,
 					toolCallId
 				}, request);
 			} }),
 			createTodoTool({
-				getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				repository: {
 					isAvailable: isXopcDatabaseOpen,
-					read: (sessionKey) => getSessionTaskPlan(sessionKey)?.items ?? [],
-					write: (sessionKey, items) => {
+					read: (conversationId) => getSessionTaskPlan(conversationId)?.items ?? [],
+					write: (conversationId, items) => {
 						setSessionTaskPlan({
-							sessionKey,
+							conversationId,
 							items
 						});
 					}
@@ -297,7 +301,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			...this.deps.installSkillFromSource || this.deps.installSkillFromMarketplace ? [createSkillInstallTool({
 				installSkillFromSource: this.deps.installSkillFromSource,
 				installSkillFromMarketplace: this.deps.installSkillFromMarketplace,
-				getSessionKey: () => this.deps.getCurrentContext()?.sessionKey
+				getConversationId: () => this.deps.getCurrentContext()?.conversationId
 			})] : [],
 			readTool,
 			writeTool,
@@ -307,27 +311,27 @@ var AgentToolsFactory = class AgentToolsFactory {
 			find,
 			createExecCommandTool(workspace, {
 				getCommandIsolation,
-				getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,
 				prepareEnv: this.prepareRuntimeEnv
 			}),
 			createReviewWorkspaceTool(workspace),
 			createLanguageDiagnosticsTool(workspace, {
 				getCommandIsolation,
-				getSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				prepareEnv: this.prepareRuntimeEnv
 			}),
-			createManagedJobTool(workspace, () => this.deps.getCurrentContext()?.sessionKey, this.deps.getSkillPassthroughEnvVarNames, this.prepareRuntimeEnv, getCommandIsolation),
+			createManagedJobTool(workspace, () => this.deps.getCurrentContext()?.conversationId, this.deps.getSkillPassthroughEnvVarNames, this.prepareRuntimeEnv, getCommandIsolation),
 			createWebSearchTool(() => this.deps.getConfig?.()),
 			createWebFetchTool(() => this.deps.getConfig?.()),
 			createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),
-			createMessageTool(bus, () => this.deps.getCurrentContext()),
+			createMessageTool(bus, deliveryContext),
 			...mergeTtsConfigFromAppConfig(cfg?.messages?.tts).enabled ? [createTextToSpeechTool({
 				bus,
-				getContext: () => this.deps.getCurrentContext(),
+				getContext: deliveryContext,
 				getConfig: () => this.deps.getConfig?.()
 			})] : [],
-			createSendMediaTool(workspace, bus, () => this.deps.getCurrentContext()),
+			createSendMediaTool(workspace, bus, deliveryContext),
 			createPublishArtifactsTool(workspace),
 			createReadMediaTool(),
 			...isShareToolAvailable(cfg) ? [createCreateShareTool({
@@ -337,33 +341,33 @@ var AgentToolsFactory = class AgentToolsFactory {
 			createUserContextSearchTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
-				getSessionId: currentSessionKey,
+				getSessionId: currentConversationId,
 				getProjectId: currentProjectId,
 				canRead: () => currentAccess().userModel
 			}),
 			createUserContextGetTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
-				getSessionId: currentSessionKey,
+				getSessionId: currentConversationId,
 				getProjectId: currentProjectId,
 				canRead: () => currentAccess().userModel
 			}),
 			createUserContextUpdateTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
-				getSessionId: currentSessionKey,
+				getSessionId: currentConversationId,
 				getProjectId: currentProjectId,
 				canRead: () => currentAccess().userModel,
 				canWrite: () => currentAccess().userModel,
 				getCurrentUserText: () => {
-					const sessionKey = currentSessionKey();
-					return sessionKey ? getPendingTranscriptUserText(sessionKey) : void 0;
+					const conversationId = currentConversationId();
+					return conversationId ? getPendingTranscriptUserText(conversationId) : void 0;
 				}
 			}),
 			createKnowledgeSearchTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
-				getSessionId: currentSessionKey,
+				getSessionId: currentConversationId,
 				getProjectId: currentProjectId,
 				canRead: () => currentAccess().knowledge,
 				canWrite: () => currentAccess().knowledge,
@@ -373,7 +377,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			createKnowledgeGetTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
-				getSessionId: currentSessionKey,
+				getSessionId: currentConversationId,
 				getProjectId: currentProjectId,
 				canRead: () => currentAccess().knowledge,
 				canWrite: () => currentAccess().knowledge,
@@ -383,7 +387,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 			createKnowledgeWriteTool({
 				agentId: resolvedAgentId,
 				workspaceId: workspace,
-				getSessionId: currentSessionKey,
+				getSessionId: currentConversationId,
 				getProjectId: currentProjectId,
 				canRead: () => currentAccess().knowledge,
 				canWrite: () => currentAccess().knowledge,
@@ -392,12 +396,12 @@ var AgentToolsFactory = class AgentToolsFactory {
 			}),
 			...this.deps.getSessionStore ? [createSessionRecallTool({
 				getSessionStore: this.deps.getSessionStore,
-				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey
+				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId
 			})] : [],
 			...this.deps.getSessionStore && getPrimary ? [createSessionSearchTool({
 				getSessionStore: this.deps.getSessionStore,
 				getPrimaryModel: getPrimary,
-				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				canAccess: () => currentAccess().crossSessionHistory
 			})] : [],
 			...this.deps.getAutomationService ? [createAutomationTool({ getAutomationService: this.deps.getAutomationService })] : [],
@@ -406,7 +410,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 				getWorkspace: () => this.deps.workspace,
 				getConfig: () => this.deps.getConfig?.(),
 				getCurrentAgentId: () => options.agentId,
-				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				getAutomationService: this.deps.getAutomationService,
 				getNotesService: this.deps.getNotesService,
 				getProjectService: this.deps.getProjectService,
@@ -416,12 +420,12 @@ var AgentToolsFactory = class AgentToolsFactory {
 			})] : [],
 			...browserEnabled ? [createBrowserUseTool({
 				getRuntime: () => this.ensureBrowserRuntime(),
-				getTaskId: () => options?.sessionKey ?? this.deps.getCurrentContext()?.sessionKey ?? "default",
+				getTaskId: () => options?.conversationId ?? this.deps.getCurrentContext()?.conversationId ?? "default",
 				getReadiness: () => this.checkBrowserReadinessCached()
 			})] : [],
 			...primary ? [createWorkflowTool({
 				catalog: createWorkflowCatalog(),
-				getCurrentSessionKey: () => this.deps.getCurrentContext()?.sessionKey,
+				getCurrentConversationId: () => this.deps.getCurrentContext()?.conversationId,
 				getConfig: () => this.deps.getConfig?.(),
 				startWorkflowRun: this.deps.getWorkflowRunService ? (params) => this.deps.getWorkflowRunService().startWorkflowRun(params) : void 0
 			})] : [],
@@ -449,7 +453,7 @@ var AgentToolsFactory = class AgentToolsFactory {
 						workspace: childOpts.workspace,
 						getPrimaryModel: () => childOpts.model,
 						agentId: options?.agentId ?? childOpts.agentId,
-						sessionKey: childOpts.browserSessionKey,
+						conversationId: childOpts.browserConversationId,
 						disabledTools: new Set([
 							EXTERNAL_TOOL_NAMES.search,
 							EXTERNAL_TOOL_NAMES.describe,

package/dist/src/agent/tools/knowledge-memory-tool.js

@@ -38,7 +38,7 @@ function visibility(options) {
 	return {
 		agentId: options.agentId,
 		workspaceId: options.workspaceId,
-		sessionId: options.getSessionId() ?? "",
+		conversationId: options.getSessionId() ?? "",
 		...projectId ? { projectId } : {}
 	};
 }
@@ -165,7 +165,7 @@ function createKnowledgeWriteTool(options) {
 					importance: input.importance ?? .5,
 					originClass: "agent",
 					sourceAgentId: options.agentId,
-					...sessionId ? { sourceSessionId: sessionId } : {},
+					...sessionId ? { sourceConversationId: sessionId } : {},
 					source: { tool: "knowledge_write" }
 				}),
 				writePolicy

package/dist/src/agent/tools/managed-job-tool.d.ts

@@ -1,3 +1,3 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { CommandIsolation } from '../commands/command-isolation.js';
-export declare function createManagedJobTool(workspace: string, getSessionKey: () => string | undefined, getSkillPassthroughEnvVarNames?: () => string[], prepareEnv?: (baseEnv: Record<string, string>, cwd: string) => Promise<Record<string, string>>, getCommandIsolation?: () => CommandIsolation | undefined): AgentTool;
+export declare function createManagedJobTool(workspace: string, getConversationId: () => string | undefined, getSkillPassthroughEnvVarNames?: () => string[], prepareEnv?: (baseEnv: Record<string, string>, cwd: string) => Promise<Record<string, string>>, getCommandIsolation?: () => CommandIsolation | undefined): AgentTool;

package/dist/src/agent/tools/managed-job-tool.js

@@ -43,7 +43,7 @@ function result(value) {
 		details: Array.isArray(value) ? { jobs: value } : value
 	};
 }
-function createManagedJobTool(workspace, getSessionKey, getSkillPassthroughEnvVarNames, prepareEnv, getCommandIsolation) {
+function createManagedJobTool(workspace, getConversationId, getSkillPassthroughEnvVarNames, prepareEnv, getCommandIsolation) {
 	return {
 		name: "managed_job",
 		label: "Managed Job",
@@ -52,7 +52,7 @@ function createManagedJobTool(workspace, getSessionKey, getSkillPassthroughEnvVa
 		supportsParallel: true,
 		idempotent: false,
 		async execute(_toolCallId, input, signal) {
-			const owner = getSessionKey() ?? workspace;
+			const owner = getConversationId() ?? workspace;
 			const registry = commandRegistry();
 			if (input.action === "list") return result(registry.list(owner));
 			if (input.action !== "start") {

package/dist/src/agent/tools/publish-artifacts.js

@@ -1,4 +1,5 @@
 import { turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
@@ -8,6 +9,7 @@ import { basename, isAbsolute, relative, sep } from "node:path";
 import { realpath } from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/publish-artifacts.ts
+init_src();
 const PublishArtifactsSchema = Type.Object({ paths: Type.Array(Type.String({ minLength: 1 }), {
 	minItems: 1,
 	maxItems: 50,

package/dist/src/agent/tools/review-workspace.js

@@ -4,8 +4,8 @@ import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
 import { checkedFilePath, readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { resolve } from "node:path";
 import { execFile } from "node:child_process";
-import { lstat, readlink, realpath } from "node:fs/promises";
 import { promisify } from "node:util";
+import { lstat, readlink, realpath } from "node:fs/promises";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/review-workspace.ts
 const exec = promisify(execFile);

package/dist/src/agent/tools/send-media.js

@@ -1,4 +1,5 @@
 import { turnOutcomeKindFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { readWorkspaceFile } from "../sandbox/fileAccess.js";
 import { checkFileSafety } from "../prompt/safety.js";
 import { resolvePathUnderWorkspace } from "./tool-paths.js";
@@ -7,6 +8,7 @@ import { persistToolMedia } from "./tool-media.js";
 import { basename } from "node:path";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/send-media.ts
+init_src();
 const SendMediaSchema = Type.Object({
 	filePath: Type.String({ description: "File to send. Relative paths are under the current agent workspace; absolute paths must remain inside the workspace." }),
 	mediaType: Type.Optional(Type.Enum({

package/dist/src/agent/tools/session-recall-tool.d.ts

@@ -2,6 +2,6 @@ import type { AgentTool } from '@earendil-works/pi-agent-core';
 import type { SessionStore } from '../../session/store.js';
 export interface SessionRecallToolDeps {
     getSessionStore: () => SessionStore;
-    getCurrentSessionKey: () => string | undefined;
+    getCurrentConversationId: () => string | undefined;
 }
 export declare function createSessionRecallTool(deps: SessionRecallToolDeps): AgentTool;

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

@@ -39,8 +39,8 @@ function createSessionRecallTool(deps) {
 		idempotent: true,
 		async execute(_toolCallId, params) {
 			const input = params;
-			const sessionKey = deps.getCurrentSessionKey();
-			if (!sessionKey) return {
+			const conversationId = deps.getCurrentConversationId();
+			if (!conversationId) return {
 				content: [{
 					type: "text",
 					text: "session_recall is unavailable outside an active session."
@@ -50,7 +50,7 @@ function createSessionRecallTool(deps) {
 			const query = input.query.trim();
 			const limit = Math.min(20, Math.max(1, input.limit ?? 8));
 			const maxChars = Math.min(2e4, Math.max(500, input.maxCharsPerResult ?? 6e3));
-			const results = deps.getSessionStore().recallSession(sessionKey, query, {
+			const results = deps.getSessionStore().recallSession(conversationId, query, {
 				limit,
 				...input.beforeSeq ? { beforeSeq: input.beforeSeq } : {}
 			}).map((match) => ({

package/dist/src/agent/tools/session-search-tool.d.ts

@@ -4,7 +4,7 @@ import type { SessionStore } from '../../session/store.js';
 export interface SessionSearchToolDeps {
     getSessionStore: () => SessionStore;
     getPrimaryModel: () => Model<Api>;
-    getCurrentSessionKey?: () => string | undefined;
+    getCurrentConversationId?: () => string | undefined;
     canAccess?: () => boolean;
 }
 export declare function createSessionSearchTool(deps: SessionSearchToolDeps): AgentTool;