@xopcai/xopc 0.0.308 → 0.0.311

package/dist/src/agent/tools/repository-search.js

@@ -1,84 +1,137 @@
 import { prepareSafeToolEnv } from "../sandbox/sanitize-env-vars.js";
 import { evaluateFilePolicy } from "../sandbox/exec-policy.js";
+import { dataScheduler } from "../data-acquisition/scheduler.js";
 import { resolveRipgrepBinary } from "../../infra/ripgrep.js";
 import { lstatSync } from "node:fs";
 import { spawn } from "node:child_process";
+import { StringDecoder } from "node:string_decoder";
 //#region src/agent/tools/repository-search.ts
-/** Bounded native search; unavailable tools and invalid regexes are explicit failures. */
-async function repositorySearch(cwd, args, signal) {
-	signal?.throwIfAborted();
-	const binary = await resolveRipgrepBinary();
-	return new Promise((resolve, reject) => {
-		const separator = args.indexOf("--");
-		const options = separator < 0 ? args : args.slice(0, separator);
-		const targets = separator < 0 ? [] : args.slice(separator);
-		const excluded = [
-			".git",
-			"node_modules",
-			".env",
-			".env.*",
-			".ssh",
-			".aws",
-			".gnupg",
-			".docker",
-			".config",
-			".netrc",
-			".npmrc",
-			".cargo/credentials",
-			".kube",
-			".xopc"
-		];
-		const child = spawn(binary, [
-			"--no-config",
-			"--hidden",
-			...options,
-			...excluded.flatMap((path) => [
-				"--glob",
-				`!**/${path}`,
-				"--glob",
-				`!**/${path}/**`
-			]),
-			"--no-follow",
-			...targets
-		], {
-			cwd,
-			env: prepareSafeToolEnv(process.env)
-		});
-		const chunks = [];
-		let bytes = 0, truncated = false, stderr = "";
-		const timer = setTimeout(() => child.kill("SIGKILL"), 1e4);
-		const abort = () => child.kill("SIGKILL");
-		signal?.addEventListener("abort", abort, { once: true });
-		child.stdout.on("data", (chunk) => {
-			const remaining = Math.max(0, 5e4 - bytes);
-			chunks.push(chunk.subarray(0, remaining));
-			bytes += chunk.length;
-			if (bytes > 5e4) {
-				truncated = true;
-				child.kill("SIGKILL");
-			}
-		});
-		child.stderr.on("data", (chunk) => {
-			stderr = (stderr + String(chunk)).slice(-4e3);
-		});
-		child.on("error", reject);
-		child.on("close", (code) => {
-			clearTimeout(timer);
-			signal?.removeEventListener("abort", abort);
-			if (signal?.aborted) {
-				reject(signal.reason ?? /* @__PURE__ */ new Error("Search aborted"));
-				return;
-			}
-			if (code !== 0 && code !== 1 && !truncated) {
-				reject(new Error(stderr || "Search did not complete; check ripgrep installation or narrow the search."));
-				return;
-			}
-			resolve({
-				output: Buffer.concat(chunks).toString("utf8"),
-				truncated
+function parseRepositoryMatch(workspace, line) {
+	if (!line) return void 0;
+	const event = JSON.parse(line);
+	if (event.type !== "match" && event.type !== "context") return void 0;
+	const data = event.data;
+	if (typeof data?.path?.text !== "string" || typeof data.lines?.text !== "string" || !Number.isInteger(data.line_number) || !isSearchFileAllowed(workspace, data.path.text)) return void 0;
+	return {
+		path: data.path.text,
+		line: data.line_number,
+		text: data.lines.text.replace(/\r?\n$/, ""),
+		match: event.type === "match"
+	};
+}
+/** One bounded process path for raw filename output and streamed JSON events. */
+async function repositorySearch(cwd, args, signal, options = {}) {
+	const deadline = AbortSignal.any([...signal ? [signal] : [], AbortSignal.timeout(1e4)]);
+	return dataScheduler.run(cwd, deadline, async () => {
+		deadline.throwIfAborted();
+		const binary = await resolveRipgrepBinary();
+		deadline.throwIfAborted();
+		return new Promise((resolve, reject) => {
+			const separator = args.indexOf("--");
+			const searchOptions = separator < 0 ? args : args.slice(0, separator);
+			const targets = separator < 0 ? [] : args.slice(separator);
+			const excluded = [
+				".git",
+				"node_modules",
+				".env",
+				".env.*",
+				".ssh",
+				".aws",
+				".gnupg",
+				".docker",
+				".config",
+				".netrc",
+				".npmrc",
+				".cargo/credentials",
+				".kube",
+				".xopc"
+			];
+			const child = spawn(binary, [
+				"--no-config",
+				"--hidden",
+				...searchOptions,
+				...excluded.flatMap((path) => [
+					"--glob",
+					`!**/${path}`,
+					"--glob",
+					`!**/${path}/**`
+				]),
+				"--no-follow",
+				...targets
+			], {
+				cwd,
+				env: prepareSafeToolEnv(process.env)
+			});
+			const chunks = [];
+			const decoder = new StringDecoder("utf8");
+			let bytes = 0, truncated = false, stderr = "", pending = "";
+			let failure;
+			const stop = () => child.kill("SIGKILL");
+			const consume = (text) => {
+				pending += text;
+				let newline;
+				while (!truncated && (newline = pending.indexOf("\n")) !== -1) {
+					const line = pending.slice(0, newline);
+					pending = pending.slice(newline + 1);
+					if (options.onLine?.(line) === false) {
+						truncated = true;
+						stop();
+					}
+				}
+			};
+			deadline.addEventListener("abort", stop, { once: true });
+			child.stdout.on("data", (chunk) => {
+				if (truncated || failure) return;
+				const remaining = Math.max(0, (options.maxBytes ?? 5e4) - bytes);
+				const selected = chunk.subarray(0, remaining);
+				bytes += chunk.length;
+				try {
+					if (options.onLine) consume(decoder.write(selected));
+					else chunks.push(selected);
+				} catch (error) {
+					failure = error instanceof Error ? error : new Error(String(error));
+					stop();
+				}
+				if (bytes > (options.maxBytes ?? 5e4)) {
+					truncated = true;
+					stop();
+				}
+			});
+			child.stderr.on("data", (chunk) => {
+				stderr = (stderr + String(chunk)).slice(-4e3);
+			});
+			child.on("error", (error) => {
+				failure = error;
+			});
+			child.on("close", (code) => {
+				deadline.removeEventListener("abort", stop);
+				if (deadline.aborted) {
+					reject(deadline.reason);
+					return;
+				}
+				if (failure) {
+					reject(failure);
+					return;
+				}
+				if (code !== 0 && code !== 1 && !truncated) {
+					reject(new Error(stderr || "Search did not complete; narrow the search."));
+					return;
+				}
+				try {
+					if (options.onLine && !truncated) {
+						consume(decoder.end());
+						if (pending && options.onLine(pending) === false) truncated = true;
+					}
+					resolve({
+						output: Buffer.concat(chunks).toString("utf8"),
+						truncated
+					});
+				} catch (error) {
+					reject(error);
+				}
 			});
+			if (deadline.aborted) stop();
 		});
-		if (signal?.aborted) abort();
 	});
 }
 /** Search results must satisfy the same policy as direct file reads. */
@@ -97,4 +150,4 @@ function isSearchFileAllowed(workspace, path) {
 	}
 }
 //#endregion
-export { isSearchFileAllowed, repositorySearch };
+export { isSearchFileAllowed, parseRepositoryMatch, repositorySearch };

package/dist/src/agent/tools/search/providers/xopc-cloud.d.ts

@@ -0,0 +1,20 @@
+import { type ModelCatalogStore } from '../../../../providers/model-catalog-store.js';
+import { type ProviderAuthService } from '../../../../providers/provider-auth-service.js';
+import type { SearchProvider, SearchResult } from '../types.js';
+interface XopcCloudSearchProviderOptions {
+    region: 'cn' | 'global';
+    fetchImpl?: typeof fetch;
+    catalogStore?: Pick<ModelCatalogStore, 'getSource'>;
+    credentials?: Pick<ProviderAuthService, 'resolveApiKey'>;
+}
+export declare class XopcCloudSearchProvider implements SearchProvider {
+    private readonly options;
+    readonly name = "xopc-cloud";
+    private readonly fetchImpl;
+    private readonly catalogStore;
+    private readonly credentials;
+    constructor(options: XopcCloudSearchProviderOptions);
+    isAvailable(): boolean;
+    search(query: string, count: number, signal?: AbortSignal): Promise<SearchResult[]>;
+}
+export {};

package/dist/src/agent/tools/search/providers/xopc-cloud.js

@@ -0,0 +1,56 @@
+import { getModelCatalogStore, init_model_catalog_store } from "../../../../providers/model-catalog-store.js";
+import { getProviderAuthService, init_provider_auth_service } from "../../../../providers/provider-auth-service.js";
+//#region src/agent/tools/search/providers/xopc-cloud.ts
+init_model_catalog_store();
+init_provider_auth_service();
+var XopcCloudSearchProvider = class {
+	name = "xopc-cloud";
+	fetchImpl;
+	catalogStore;
+	credentials;
+	constructor(options) {
+		this.options = options;
+		this.fetchImpl = options.fetchImpl ?? fetch;
+		this.catalogStore = options.catalogStore ?? getModelCatalogStore();
+		this.credentials = options.credentials ?? getProviderAuthService();
+	}
+	isAvailable() {
+		return Boolean(this.catalogStore.getSource("xopc-cloud")?.search);
+	}
+	async search(query, count, signal) {
+		const source = this.catalogStore.getSource("xopc-cloud");
+		if (!source?.search) throw new Error("XOPC Cloud search is not available");
+		const requestSignal = signal ? AbortSignal.any([signal, AbortSignal.timeout(3e4)]) : AbortSignal.timeout(3e4);
+		const accessToken = await this.credentials.resolveApiKey("xopc-cloud", requestSignal);
+		if (!accessToken) throw new Error("XOPC Cloud is not connected");
+		const endpoint = `${source.baseUrl.replace(/\/+$/, "")}/${source.search.endpoint.replace(/^\/+/, "")}`;
+		const response = await this.fetchImpl(endpoint, {
+			method: "POST",
+			headers: {
+				authorization: `Bearer ${accessToken}`,
+				accept: "application/json",
+				"content-type": "application/json"
+			},
+			body: JSON.stringify({
+				query,
+				count: Math.max(1, Math.min(count, source.search.maxResults)),
+				region: this.options.region
+			}),
+			signal: requestSignal
+		});
+		const body = await response.json().catch(() => null);
+		if (!response.ok) throw new Error(typeof body?.error?.message === "string" ? body.error.message : `XOPC Cloud search failed (${response.status})`);
+		if (!Array.isArray(body?.results)) throw new Error("XOPC Cloud search returned an invalid response");
+		return body.results.flatMap((result) => {
+			if (typeof result.title !== "string" || typeof result.url !== "string" || typeof result.description !== "string") return [];
+			return [{
+				title: result.title,
+				url: result.url,
+				description: result.description,
+				source: this.name
+			}];
+		});
+	}
+};
+//#endregion
+export { XopcCloudSearchProvider };

package/dist/src/agent/tools/search/registry.d.ts

@@ -1,8 +1,10 @@
-import type { ResolvedWebSearchConfig, SearchResult } from './types.js';
+import type { ResolvedWebSearchConfig, SearchProvider, SearchResult } from './types.js';
 export declare class SearchProviderRegistry {
     private readonly providers;
     private readonly fallbackProvider;
-    constructor(config: ResolvedWebSearchConfig);
+    constructor(config: ResolvedWebSearchConfig, options?: {
+        cloudProvider?: SearchProvider;
+    });
     private buildProviders;
     hasConfiguredApiProvider(): boolean;
     search(query: string, count: number, signal?: AbortSignal): Promise<{

package/dist/src/agent/tools/search/registry.js

@@ -6,22 +6,24 @@ import { BingApiProvider } from "./providers/bing-api.js";
 import { BingHtmlProvider } from "./providers/bing-html.js";
 import { DuckDuckGoHtmlProvider } from "./providers/duckduckgo-html.js";
 import { SearXNGProvider } from "./providers/searxng.js";
+import { XopcCloudSearchProvider } from "./providers/xopc-cloud.js";
 //#region src/agent/tools/search/registry.ts
 init_logger();
 const log = createLogger("Agent:WebSearch");
 var SearchProviderRegistry = class {
 	providers;
 	fallbackProvider;
-	constructor(config) {
-		this.providers = this.buildProviders(config);
+	constructor(config, options = {}) {
+		this.providers = this.buildProviders(config, options.cloudProvider);
 		this.fallbackProvider = config.region === "cn" ? new BingHtmlProvider() : new DuckDuckGoHtmlProvider();
 		log.debug({
 			region: config.region,
 			configuredCount: this.providers.filter((p) => p.isAvailable()).length
 		}, "Web search registry ready");
 	}
-	buildProviders(config) {
+	buildProviders(config, cloudProvider) {
 		const list = [];
+		if (config.providers.length === 0) list.push(cloudProvider ?? new XopcCloudSearchProvider({ region: config.region }));
 		for (const p of config.providers) {
 			if (p.disabled) continue;
 			switch (p.type) {

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

@@ -1,6 +1,6 @@
 import { SearchProviderRegistry } from "./search/registry.js";
 import { resolveWebSearchConfig } from "./search/resolve-config.js";
-import { checkUrlSafety, checkWebsiteBlocklist } from "./url-safety.js";
+import { fetchPublicText } from "./fetch-text.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/web.ts
 const WebSearchSchema = Type.Object({
@@ -16,6 +16,7 @@ function createWebSearchTool(getConfig) {
 		description: "Search the web. Uses configured search APIs when set; otherwise falls back to a built-in HTML search (region-aware).",
 		parameters: WebSearchSchema,
 		label: "🔍 Web Search",
+		supportsParallel: true,
 		async execute(_toolCallId, params, signal) {
 			const p = params;
 			const cfg = resolveWebSearchConfig(getConfig()?.tools?.web);
@@ -49,13 +50,15 @@ function createWebSearchTool(getConfig) {
 						type: "text",
 						text: `Search error: ${error instanceof Error ? error.message : String(error)}`
 					}],
-					details: { results: [] }
+					details: {
+						results: [],
+						error: error instanceof Error ? error.message : String(error)
+					}
 				};
 			}
 		}
 	};
 }
-const MAX_FETCH_CHARS = 6e6;
 const WebFetchSchema = Type.Object({
 	url: Type.String({ description: "The URL to fetch" }),
 	maxChars: Type.Optional(Type.Number({ description: "Maximum characters to return (default: 10000)" }))
@@ -76,47 +79,35 @@ function createWebFetchTool(getConfig) {
 		description: "Fetch and extract readable content from a URL (HTML via Readability; plain text as-is).",
 		parameters: WebFetchSchema,
 		label: "🌐 Web Fetch",
+		supportsParallel: true,
 		async execute(_toolCallId, params, signal) {
 			try {
 				const p = params;
-				const safety = checkUrlSafety(p.url);
-				if (!safety.safe) return {
-					content: [{
-						type: "text",
-						text: `Blocked: ${safety.reason}`
-					}],
-					details: {}
-				};
-				const blocked = checkWebsiteBlocklist(p.url, getConfig()?.tools?.web?.blocklist);
-				if (blocked) return {
-					content: [{
-						type: "text",
-						text: `Blocked: ${blocked.message}`
-					}],
-					details: {}
-				};
-				const response = await fetch(p.url, { signal });
-				if (!response.ok) throw new Error(`HTTP ${response.status}`);
-				const html = await response.text();
-				if (html.length > MAX_FETCH_CHARS) throw new Error("Response too large");
+				const fetched = await fetchPublicText(p.url, getConfig()?.tools?.web?.blocklist, signal);
+				const html = fetched.text;
 				const maxChars = p.maxChars || 1e4;
-				const contentType = response.headers.get("content-type") ?? "";
+				const contentType = fetched.contentType;
 				const looksHtml = /html|xml/i.test(contentType) || /^[\s\n]*</.test(html.slice(0, Math.min(500, html.length)));
 				let text;
 				if (looksHtml) try {
-					text = await extractReadableText(html, p.url);
+					text = await extractReadableText(html, fetched.url);
 					if (!text || text.length < 40) text = stripHtmlFallback(html);
 				} catch {
 					text = stripHtmlFallback(html);
 				}
 				else text = html.trim();
-				if (text.length > maxChars) text = text.substring(0, maxChars) + "\n\n[truncated...]";
+				const truncated = text.length > maxChars;
+				if (truncated) text = text.substring(0, maxChars) + "\n\n[truncated...]";
 				return {
 					content: [{
 						type: "text",
 						text
 					}],
-					details: {}
+					details: {
+						truncated,
+						complete: !truncated,
+						url: fetched.url
+					}
 				};
 			} catch (error) {
 				return {
@@ -124,7 +115,7 @@ function createWebFetchTool(getConfig) {
 						type: "text",
 						text: `Fetch error: ${error instanceof Error ? error.message : String(error)}`
 					}],
-					details: {}
+					details: { error: error instanceof Error ? error.message : String(error) }
 				};
 			}
 		}

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

@@ -1,3 +1,4 @@
+import type { SceneAccess } from '../../scenes/httpServices.js';
 import type { AgentTool } from '@earendil-works/pi-agent-core';
 import { type ProductDeliveryEnvelope } from '@xopcai/gateway-contract';
 import { type AutomationService } from '../../automations/index.js';
@@ -6,12 +7,12 @@ import type { NotesService } from '../../notes/index.js';
 import { type ProjectService } from '../../projects/index.js';
 import type { LocalAppService } from '../../local-apps/index.js';
 declare const XopcUseToolSchema: import("@sinclair/typebox").TObject<{
-    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"proactive">, import("@sinclair/typebox").TLiteral<"project">, import("@sinclair/typebox").TLiteral<"automation">, import("@sinclair/typebox").TLiteral<"note">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"task_run">, import("@sinclair/typebox").TLiteral<"local_app">, import("@sinclair/typebox").TLiteral<"settings">]>;
+    mode: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"scene">, import("@sinclair/typebox").TLiteral<"project">, import("@sinclair/typebox").TLiteral<"automation">, import("@sinclair/typebox").TLiteral<"note">, import("@sinclair/typebox").TLiteral<"task">, import("@sinclair/typebox").TLiteral<"task_run">, import("@sinclair/typebox").TLiteral<"local_app">, import("@sinclair/typebox").TLiteral<"settings">]>;
     command: import("@sinclair/typebox").TString;
     args: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TAny>>;
     dryRun: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TBoolean>;
 }>;
-export type XopcUseMode = 'proactive' | 'project' | 'automation' | 'note' | 'task' | 'task_run' | 'local_app' | 'settings';
+export type XopcUseMode = 'scene' | 'project' | 'automation' | 'note' | 'task' | 'task_run' | 'local_app' | 'settings';
 export interface XopcUseToolInput {
     mode: XopcUseMode;
     command: string;
@@ -24,6 +25,7 @@ export interface XopcUseToolDeps {
     getCurrentAgentId?: () => string | undefined;
     getCurrentConversationId?: () => string | undefined;
     getAutomationService?: () => AutomationService | undefined;
+    getSceneAccess?: () => SceneAccess | undefined;
     getNotesService?: () => NotesService | undefined;
     getProjectService?: () => ProjectService | undefined;
     getLocalAppService?: () => LocalAppService | undefined;

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

@@ -5,7 +5,7 @@ import { appendProductDeliveryText } from "../../../packages/gateway-contract/sr
 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";
+import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import "../../storage/sqlite/index.js";
 import { ObjectLinkService } from "../../activity/service.js";
 import "../../activity/index.js";
@@ -14,15 +14,11 @@ import { TaskRepository } from "../../tasks/task-repository.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { isValidProjectAgentId, normalizeProjectAgentId, resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
-import { updateControlledSubscription } from "../../proactive/scenarios/control.js";
-import { continueMailFollowUp, mailFollowUpSources, startMailFollowUp, updateMailFollowUp } from "../../proactive/follow-ups.js";
+import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
+import "../../automations/index.js";
 import { TaskContextRepository } from "../../tasks/task-context-repository.js";
 import { TaskDependencyError, TaskDependencyService } from "../../tasks/task-dependency-service.js";
 import { TaskApplicationService } from "../../tasks/task-application-service.js";
-import { getCard } from "../../proactive/inbox/cards.js";
-import { checkDelegation, delegationOverview, startDelegation } from "../../proactive/experience.js";
-import { CreateAutomationSchema, UpdateAutomationSchema } from "../../automations/domain/validation.js";
-import "../../automations/index.js";
 import { defineTaskContract } from "../../tasks/task-contract-definition.js";
 import { TaskDeletionService } from "../../tasks/task-deletion-service.js";
 import "../../tasks/index.js";
@@ -34,7 +30,7 @@ init_resolve_route();
 init_transaction();
 const XopcUseToolSchema = Type.Object({
 	mode: Type.Union([
-		Type.Literal("proactive"),
+		Type.Literal("scene"),
 		Type.Literal("project"),
 		Type.Literal("automation"),
 		Type.Literal("note"),
@@ -43,7 +39,7 @@ const XopcUseToolSchema = Type.Object({
 		Type.Literal("local_app"),
 		Type.Literal("settings")
 	]),
-	command: Type.String({ description: "Object command. Proactive commands: list, get_card {id}, start {scenarioKey: project_delivery_risk|meeting_preparation|discussion_follow_up, projectId?: string, instructions: string}, update {id, expectedRevision, userInstructions?, enabled?, completedAt?}, check {id}. Also supports mail_sources, follow_up {sourceItemId, instructions, dueAt: ISO timestamp}, update_follow_up {id, expectedRevision, instructions?, dueAt?, status?: watching|paused|completed}, continue_card {id}. continue_card binds the current conversation and returns the exact email account; review the full draft and use connector confirmation before sending. Use proactive only for work the user explicitly delegates; inspect list first and update existing work instead of duplicating it. Supports project list/get/create/update/resolve_workspace/list_milestones/create_milestone/update_milestone/list_updates/create_update, automation list/get/create/update/delete/run/pause/resume/history, note list/get/create/append/update/preview_edit/delete, task list/get/create/update_dependencies/add_context/remove_context/command/delete, task_run list/get/cancel, local_app list/get/create/validate, and settings open." }),
+	command: Type.String({ description: "Object command. Scene commands: templates, list, get {id}, mail_accounts, mail_search {accountId, query}, mail_sources, preflight/start {templateKey, templateVersion, goal, scope, permissions}, configure {id, expectedRevision, goal, scope, permissions}, transition {id, expectedRevision, status: paused|active|completed|archived}, check {id}, notes {id, expectedRevision, content, validUntil?}, work_item {id, subjectId, accountId, dueAt}, schedule {id, triggerKey, expectedRevision, schedule}, results {id}. Start and check accept a stable requestId for retries. Scenes prepare read-only suggestions and drafts; never send mail. Only create a scene for work explicitly delegated by the user; inspect existing scenes first. Supports project list/get/create/update/resolve_workspace/list_milestones/create_milestone/update_milestone/list_updates/create_update, automation list/get/create/update/delete/run/pause/resume/history, note list/get/create/append/update/preview_edit/delete, task list/get/create/update_dependencies/add_context/remove_context/command/delete, task_run list/get/cancel, local_app list/get/create/validate, and settings open." }),
 	args: Type.Optional(Type.Record(Type.String(), Type.Any())),
 	dryRun: Type.Optional(Type.Boolean({ description: "Validate and preview the action without mutating xopc state." }))
 });
@@ -1801,7 +1797,7 @@ function createXopcUseTool(deps) {
 						kind: "xopc_use",
 						toolCallId
 					}
-				}, async () => mode === "proactive" ? handleProactive(command, args, deps, dryRun) : mode === "project" ? await handleProject(command, args, deps, dryRun) : mode === "automation" ? await handleAutomation(command, args, deps, dryRun) : mode === "note" ? await handleNote(command, args, deps, dryRun) : mode === "task" ? await handleTask(command, args, deps, dryRun) : mode === "task_run" ? await handleTaskRun(command, args, dryRun, deps) : mode === "local_app" ? await handleLocalApp(command, args, deps, dryRun) : mode === "settings" ? handleSettings(command, args) : {
+				}, async () => mode === "scene" ? await handleScene(command, args, deps, dryRun, toolCallId) : mode === "project" ? await handleProject(command, args, deps, dryRun) : mode === "automation" ? await handleAutomation(command, args, deps, dryRun) : mode === "note" ? await handleNote(command, args, deps, dryRun) : mode === "task" ? await handleTask(command, args, deps, dryRun) : mode === "task_run" ? await handleTaskRun(command, args, dryRun, deps) : mode === "local_app" ? await handleLocalApp(command, args, deps, dryRun) : mode === "settings" ? handleSettings(command, args) : {
 					ok: false,
 					error: `Unsupported mode: ${String(mode)}`
 				});
@@ -1816,44 +1812,51 @@ function createXopcUseTool(deps) {
 		}
 	};
 }
-function handleProactive(command, args, deps, dryRun) {
-	const workspace = deps.getWorkspace?.();
-	if (!workspace) throw new Error("Proactive workspace is unavailable");
-	if (command === "list") return delegationOverview(workspace);
-	if (command === "mail_sources") return { sources: mailFollowUpSources(workspace) };
-	if (command === "get_card") return { card: getCard(String(args.id ?? ""), workspace) };
-	if (dryRun) return {
-		requiresConfirmation: true,
-		command,
-		args,
-		scope: workspace
+async function handleScene(command, args, deps, dryRun, toolCallId) {
+	const access = deps.getSceneAccess?.();
+	if (!access) throw new Error("Scene service is unavailable");
+	const { services, principal } = access;
+	const { id, requestId, triggerKey, ...input } = args;
+	const activationId = typeof id === "string" ? id : "";
+	const request = typeof requestId === "string" && requestId.trim() ? requestId : toolCallId;
+	if (command === "templates") return { templates: services.repository.listTemplates() };
+	if (command === "list") return { activations: services.repository.listActivations(principal) };
+	if (command === "get") return {
+		activation: services.repository.getActivation(principal, activationId),
+		runs: services.repository.listRuns(principal, activationId),
+		schedules: services.repository.listSchedules(principal, activationId)
 	};
-	if (command === "follow_up") return startMailFollowUp(workspace, args);
-	if (command === "update_follow_up") {
-		const { id, ...patch } = args;
-		return updateMailFollowUp(workspace, String(id ?? ""), patch);
+	if (command === "mail_accounts") return { accounts: services.mailDiscovery?.listAccounts(principal) ?? [] };
+	if (command === "mail_search") {
+		if (!services.mailDiscovery) throw new Error("Mail search is unavailable");
+		if (dryRun) return {
+			preview: true,
+			command,
+			input
+		};
+		return { sources: await services.mailDiscovery.searchSources(principal, input, AbortSignal.timeout(15e3)) };
 	}
-	if (command === "continue_card") {
-		const card = getCard(String(args.id ?? ""), workspace);
-		if (!card.communication || [
-			"withdrawn",
-			"expired",
-			"resolved"
-		].includes(card.status)) throw new Error("Open a current communication card");
-		const conversationId = deps.getCurrentConversationId?.();
-		if (!conversationId) throw new Error("A conversation is required");
+	if (command === "read_notes") return { notes: services.repository.readNotes(principal, activationId) };
+	if (command === "mail_sources") return { sources: services.mail.listSources(principal) };
+	if (command === "results") return { outcomes: services.repository.listInbox(principal, 50, "", activationId || null) };
+	if (command === "preflight" || command === "start" && dryRun) return services.application.preflight(principal, input);
+	if (dryRun) {
+		services.repository.getActivation(principal, activationId);
 		return {
-			card,
-			...continueMailFollowUp(workspace, card.communication.id, conversationId)
+			preview: true,
+			command,
+			activationId,
+			input
 		};
 	}
-	if (command === "start") return startDelegation(workspace, args);
-	if (command === "update") {
-		const { id, ...patch } = args;
-		return updateControlledSubscription(workspace, String(id ?? ""), patch);
-	}
-	if (command === "check") return checkDelegation(workspace, String(args.id ?? ""));
-	throw new Error("Unsupported proactive command");
+	if (command === "start") return { activation: await services.application.start(principal, input, request) };
+	if (command === "configure") return { activation: services.application.configure(principal, activationId, input) };
+	if (command === "transition") return { activation: await services.application.transition(principal, activationId, input) };
+	if (command === "check") return { intentId: services.application.check(principal, activationId, request) };
+	if (command === "notes") return { revision: services.application.writeNotes(principal, activationId, input) };
+	if (command === "work_item") return { workItem: services.application.createWorkItem(principal, activationId, input) };
+	if (command === "schedule") return { revision: services.application.setSchedule(principal, activationId, String(triggerKey ?? ""), input) };
+	throw new Error("Unsupported scene command");
 }
 //#endregion
 export { createXopcUseTool };