@xopcai/xopc 0.0.414 → 0.0.416

package/dist/src/browser/setup/service.js

@@ -0,0 +1,404 @@
+import { createLogger } from "../../utils/logger/index.js";
+import { init_logger } from "../../utils/logger.js";
+import { getBrowserTabBinding, init_browser_tab_binding_repository } from "../../storage/sqlite/browser-tab-binding-repository.js";
+import "../../../packages/browser-control-contract/src/index.js";
+import { createBrowserSetup, findBrowserSetup, readBrowserSetup, saveBrowserSetup } from "./repository.js";
+import { createHash, randomUUID } from "node:crypto";
+//#region src/browser/setup/service.ts
+init_browser_tab_binding_repository();
+init_logger();
+const log = createLogger("BrowserSetup");
+const VERSION = "1";
+const MAX_ACTIONS = 12;
+const VERIFY_MS = 12e4;
+const ref = (name, section) => ({
+	sceneId: "browser",
+	path: `references/browser/${name}.md`,
+	resourceVersion: VERSION,
+	...section ? { section } : {}
+});
+const browserConfigRevision = (config) => createHash("sha256").update(JSON.stringify(config.browser)).digest("hex");
+/** Mutations require a local-owner grant created by the product UI, never model-supplied identity. */
+var BrowserSetupService = class {
+	preparing = /* @__PURE__ */ new Set();
+	constructor(deps) {
+		this.deps = deps;
+	}
+	policyRevision(agentId) {
+		return this.deps.policyRevision?.(agentId) ?? String(this.deps.canUseBrowser(agentId));
+	}
+	endpoints() {
+		return this.deps.endpoints.registry.list().filter((e) => e.kind === "browser" && e.tools.some((t) => t.descriptor.name === "browser.control")).map((e) => ({
+			endpointId: e.endpointId,
+			principalId: e.principalId,
+			displayName: e.displayName,
+			appVersion: e.appVersion
+		}));
+	}
+	owned(id, conversationId, agentId) {
+		const setup = readBrowserSetup(id);
+		if (!setup || setup.conversationId !== conversationId || setup.agentId !== agentId) throw new Error("SETUP_NOT_FOUND");
+		return setup;
+	}
+	view(setup) {
+		if (setup.state === "verifying" && setup.attempt && Date.now() > setup.attempt.expiresAt) setup = {
+			...setup,
+			state: "needs_attention",
+			error: "VERIFICATION_EXPIRED: Release the demo session before starting a new test."
+		};
+		const attempt = setup.attempt ? (({ observation: _observation, ...summary }) => summary)(setup.attempt) : void 0;
+		const endpoint = setup.attempt ? this.endpoints().find((e) => e.endpointId === setup.attempt.endpointId) : void 0;
+		const changed = setup.configRevision !== browserConfigRevision(this.deps.getConfig()) || Boolean(setup.attempt && (setup.attempt.policyRevision !== this.policyRevision(setup.agentId) || !this.deps.canUseBrowser(setup.agentId) || endpoint && (endpoint.principalId !== setup.attempt.principalId || endpoint.appVersion !== setup.attempt.appVersion)));
+		return {
+			...setup,
+			attempt: setup.attempt ? attempt : void 0,
+			sceneId: "browser",
+			skillName: "configure-xopc",
+			resourceVersion: VERSION,
+			stale: changed,
+			toolPermission: this.deps.canUseBrowser(setup.agentId) ? "allowed" : "denied",
+			currentDriverKind: this.deps.getConfig().browser.driver.kind,
+			endpoints: this.endpoints(),
+			settingsPath: `/settings/agent-browser?browserSetup=${setup.id}&conversationId=${setup.conversationId}`,
+			checks: {
+				configured: this.deps.getConfig().browser.enabled && this.deps.getConfig().browser.driver.kind === "extension",
+				read: setup.attempt?.read ?? false,
+				clicked: setup.attempt?.clicked ?? false,
+				filled: setup.attempt?.filled ?? false,
+				released: setup.attempt?.released ?? false
+			},
+			guidanceRefs: [ref(setup.state === "verifying" || setup.state === "completed" ? "acceptance" : setup.error ? "troubleshooting" : "chrome-extension")],
+			allowedActions: setup.state === "cancelled" ? ["get"] : setup.state === "completed" ? ["get", "verification_report"] : [
+				"get",
+				"recheck",
+				"cancel",
+				...setup.approvedBy && !changed ? ["advance"] : []
+			]
+		};
+	}
+	async inspect(conversationId, agentId) {
+		const config = this.deps.getConfig();
+		const existing = findBrowserSetup(conversationId, agentId);
+		const installation = await this.deps.doctor();
+		return {
+			sceneId: "browser",
+			supportedConnection: "extension",
+			configRevision: browserConfigRevision(config),
+			installation: {
+				installed: installation.installed,
+				needsRefresh: installation.needsRefresh ?? false,
+				nativeHostInstalled: installation.nativeHost?.installed === true
+			},
+			toolPermission: this.deps.canUseBrowser(agentId) ? "allowed" : "denied",
+			enabled: config.browser.enabled,
+			driverKind: config.browser.driver.kind,
+			sharedScope: "gateway",
+			endpoints: this.endpoints(),
+			setup: existing ? this.view(existing) : null,
+			guidanceRefs: [ref("overview")],
+			ownerActionRequired: true,
+			supportedActions: [
+				"inspect",
+				"preview",
+				"start",
+				"get",
+				"advance",
+				"recheck",
+				"request_interaction",
+				"begin_verification",
+				"verification_report",
+				"cancel"
+			]
+		};
+	}
+	async command(command, args, context, dryRun = false) {
+		if (command === "inspect" || command === "preview") return this.inspect(context.conversationId, context.agentId);
+		if (dryRun) return {
+			dryRun: true,
+			...await this.inspect(context.conversationId, context.agentId),
+			message: "No changes made. Open the product setup panel to approve installation."
+		};
+		if (command === "start") {
+			const previous = findBrowserSetup(context.conversationId, context.agentId);
+			if (previous?.attempt && !previous.attempt.released) return this.view(previous);
+			if (previous && this.view(previous).stale && (!previous.attempt || previous.attempt.released)) this.cancel(previous);
+			return this.view(createBrowserSetup(context.conversationId, context.agentId, browserConfigRevision(this.deps.getConfig())));
+		}
+		if (typeof args.setupId !== "string") throw new Error("setupId is required");
+		const setup = this.owned(args.setupId, context.conversationId, context.agentId);
+		if (command === "get" || command === "verification_report" || command === "request_interaction") return this.view(setup);
+		if (command === "recheck") return this.view(await this.recheck(setup));
+		if (command === "advance") {
+			if (!setup.approvedBy) return {
+				...this.view(setup),
+				message: "Approve this plan in the local-owner setup panel first."
+			};
+			return this.view(await this.prepare(setup));
+		}
+		if (command === "begin_verification") return {
+			...this.view(setup),
+			message: "Select Chrome and start the test in the local-owner setup panel. The test uses normal browser_use calls."
+		};
+		if (command === "cancel") return this.view(this.cancel(setup));
+		throw new Error("Unsupported browser_setup command");
+	}
+	approve(setup, principalId, revision) {
+		this.revision(setup, revision);
+		if (setup.state === "cancelled" || setup.state === "verifying" || setup.state === "completed") throw new Error("SETUP_STATE_CHANGED");
+		if (setup.configRevision !== browserConfigRevision(this.deps.getConfig())) throw new Error("CONFIG_CHANGED: Review the current configuration before approving.");
+		return saveBrowserSetup({
+			...setup,
+			approvedBy: principalId,
+			error: void 0
+		}, setup.revision);
+	}
+	revision(setup, revision) {
+		if (setup.revision !== revision) throw new Error("SETUP_CONFLICT: Read the current progress.");
+	}
+	async prepare(setup) {
+		if (!setup.approvedBy || setup.state === "cancelled" || setup.state === "verifying" || setup.state === "completed") throw new Error("OWNER_APPROVAL_REQUIRED");
+		if (setup.attempt && !setup.attempt.released) throw new Error("CONTROL_RELEASE_REQUIRED");
+		if (this.preparing.has(setup.id)) return readBrowserSetup(setup.id);
+		if (["waiting_extension", "ready_for_verification"].includes(setup.state) && !setup.error) return this.recheck(setup);
+		const config = this.deps.getConfig();
+		if (setup.configRevision !== browserConfigRevision(config)) throw new Error("CONFIG_CHANGED: Review a new plan.");
+		if (config.browser.enabled && config.browser.driver.kind !== "extension" && this.deps.canSwitchDriver?.(setup.conversationId) === false) return saveBrowserSetup({
+			...setup,
+			state: "needs_attention",
+			error: "BROWSER_BUSY: Release existing browser sessions and wait for other runs before switching the shared driver."
+		}, setup.revision);
+		this.preparing.add(setup.id);
+		let current = saveBrowserSetup({
+			...setup,
+			state: "preparing",
+			error: void 0,
+			operation: {
+				key: setup.operation?.key ?? randomUUID(),
+				startedAt: Date.now()
+			}
+		}, setup.revision);
+		try {
+			const next = structuredClone(config);
+			next.browser.enabled = true;
+			next.browser.driver = { kind: "extension" };
+			if (browserConfigRevision(next) !== browserConfigRevision(config)) {
+				if (!(await this.deps.saveConfig(next, config)).saved) throw new Error("CONFIG_CHANGED: Configuration was not saved. Review the current settings.");
+			}
+			current = readBrowserSetup(setup.id);
+			if (current.state === "cancelled") return current;
+			current = saveBrowserSetup({
+				...current,
+				configRevision: browserConfigRevision(this.deps.getConfig())
+			}, current.revision);
+			await this.deps.prepare();
+			current = readBrowserSetup(setup.id);
+			if (current.state === "cancelled") return current;
+			this.preparing.delete(setup.id);
+			return await this.recheck(saveBrowserSetup({
+				...current,
+				state: "waiting_extension",
+				operation: void 0
+			}, current.revision));
+		} catch (error) {
+			log.warn({
+				err: error,
+				setupId: setup.id
+			}, "Browser setup preparation failed");
+			current = readBrowserSetup(setup.id);
+			if (current.state === "cancelled") return current;
+			return saveBrowserSetup({
+				...current,
+				state: "needs_attention",
+				operation: void 0,
+				error: "PREPARE_FAILED: Check the local installation and retry. Existing settings and files may have been prepared."
+			}, current.revision);
+		} finally {
+			this.preparing.delete(setup.id);
+		}
+	}
+	async recheck(setup) {
+		if (setup.state === "cancelled" || setup.state === "completed" || setup.state === "verifying" || this.preparing.has(setup.id)) return setup;
+		if (!setup.approvedBy || setup.attempt && !setup.attempt.released) return setup;
+		if (setup.configRevision !== browserConfigRevision(this.deps.getConfig())) return saveBrowserSetup({
+			...setup,
+			state: "needs_attention",
+			approvedBy: void 0,
+			error: "CONFIG_CHANGED: Restart the plan using the current settings."
+		}, setup.revision);
+		const doctor = await this.deps.doctor();
+		const current = readBrowserSetup(setup.id);
+		if (current.revision !== setup.revision) return current;
+		const ready = doctor.installed && !doctor.needsRefresh && doctor.nativeHost?.installed === true;
+		return saveBrowserSetup({
+			...setup,
+			state: ready ? this.endpoints().length ? "ready_for_verification" : "waiting_extension" : "needs_attention",
+			operation: void 0,
+			error: ready ? void 0 : "INSTALLATION_REQUIRED: Prepare or repair the local extension files."
+		}, setup.revision);
+	}
+	async open(setup, action) {
+		if (!setup.approvedBy || setup.state === "cancelled") throw new Error("OWNER_APPROVAL_REQUIRED");
+		return this.deps.open(action);
+	}
+	begin(setup, endpointId, origin, revision) {
+		this.revision(setup, revision);
+		if (!setup.approvedBy || setup.state !== "ready_for_verification") throw new Error("SETUP_NOT_READY");
+		if (setup.configRevision !== browserConfigRevision(this.deps.getConfig())) throw new Error("CONFIG_CHANGED");
+		if (setup.attempt && !setup.attempt.released) throw new Error("CONTROL_RELEASE_REQUIRED");
+		if (!this.deps.canUseBrowser(setup.agentId)) throw new Error("AGENT_BROWSER_DENIED: Enable browser_use for this Agent and start a refreshed turn.");
+		if (getBrowserTabBinding(setup.conversationId)) throw new Error("TAB_ALREADY_ATTACHED: Release the existing tab before starting this test.");
+		const endpoint = this.endpoints().find((e) => e.endpointId === endpointId);
+		if (!endpoint) throw new Error("ENDPOINT_OFFLINE");
+		const url = new URL(origin);
+		if (!["http:", "https:"].includes(url.protocol) || url.username || url.password) throw new Error("INVALID_ORIGIN");
+		const id = randomUUID();
+		const marker = `XOPC-${randomUUID()}`;
+		return saveBrowserSetup({
+			...setup,
+			state: "verifying",
+			error: void 0,
+			attempt: {
+				id,
+				endpointId,
+				principalId: endpoint.principalId,
+				appVersion: endpoint.appVersion,
+				policyRevision: this.policyRevision(setup.agentId),
+				fixtureUrl: `${url.origin}/browser-setup-test.html#${marker}`,
+				marker,
+				sample: `Hello-${id.slice(0, 8)}`,
+				sessionId: randomUUID(),
+				expiresAt: Date.now() + VERIFY_MS,
+				actions: 0,
+				read: false,
+				clicked: false,
+				filled: false,
+				released: false
+			}
+		}, setup.revision);
+	}
+	cancel(setup) {
+		if (setup.state === "cancelled") return setup;
+		return saveBrowserSetup({
+			...setup,
+			state: "cancelled",
+			approvedBy: void 0,
+			error: setup.attempt && !setup.attempt.released ? "CONTROL_RELEASE_REQUIRED: Close the verification browser session; cancellation does not prove release." : void 0
+		}, setup.revision);
+	}
+	async release(setup) {
+		if (!setup.attempt || setup.attempt.released) return setup;
+		const endpoint = this.endpoints().find((e) => e.endpointId === setup.attempt.endpointId);
+		if (!endpoint || endpoint.principalId !== setup.attempt.principalId) throw new Error("ENDPOINT_OFFLINE: Control release cannot be confirmed.");
+		const result = await this.deps.release(setup.attempt.endpointId, setup.attempt.sessionId);
+		return this.afterAction(setup.id, setup.attempt.id, { action: "close" }, result) ?? readBrowserSetup(setup.id);
+	}
+	canRestoreSession(taskKey, sessionId) {
+		const [prefix, setupId, attemptId] = taskKey.split(":");
+		if (prefix !== "browser-setup" || !setupId) return false;
+		const setup = readBrowserSetup(setupId);
+		return Boolean(setup?.attempt?.id === attemptId && setup.attempt.sessionId === sessionId && !setup.attempt.released);
+	}
+	allowsVerificationUrl(taskKey, url) {
+		const [prefix, setupId, attemptId] = taskKey.split(":");
+		if (prefix !== "browser-setup" || !setupId) return false;
+		const setup = readBrowserSetup(setupId);
+		return Boolean(setup?.approvedBy && setup.state === "verifying" && setup.attempt?.id === attemptId && setup.attempt.fixtureUrl === url && Date.now() <= setup.attempt.expiresAt && setup.configRevision === browserConfigRevision(this.deps.getConfig()));
+	}
+	/** Called only by the real Agent browser tool, before its normal runtime/policy path. */
+	beforeAction(conversationId, agentId, input) {
+		let setup = findBrowserSetup(conversationId, agentId);
+		if (setup?.attempt?.released && input.action === "close" && input.sessionId === setup.attempt.sessionId) throw new Error("VERIFICATION_ALREADY_RELEASED");
+		if (!setup?.attempt || setup.attempt.released || ![
+			"verifying",
+			"needs_attention",
+			"cancelled"
+		].includes(setup.state)) return void 0;
+		const a = setup.attempt;
+		if (!(input.action === "close")) {
+			if (setup.state !== "verifying") throw new Error("VERIFICATION_STOPPED: Close the verification session first.");
+			if (Date.now() > a.expiresAt || a.actions >= MAX_ACTIONS) throw new Error("VERIFICATION_BUDGET_EXCEEDED: Close the verification session.");
+			if (setup.configRevision !== browserConfigRevision(this.deps.getConfig()) || a.policyRevision !== this.policyRevision(setup.agentId)) throw new Error("CONFIG_CHANGED: Close the verification session.");
+			const endpoint = this.endpoints().find((e) => e.endpointId === a.endpointId);
+			if (!endpoint || endpoint.principalId !== a.principalId || endpoint.appVersion !== a.appVersion) throw new Error("ENDPOINT_CHANGED");
+			const node = "ref" in input ? a.observation?.nodes.find((n) => n.ref === input.ref) : void 0;
+			if (!(input.action === "navigate" ? !a.tabId && input.url === a.fixtureUrl : input.action === "observe" ? Boolean(a.sessionId) : input.action === "click" ? a.read && !a.clicked && node?.role === "button" && node.name === "Test click" && input.revision === a.observation?.revision : input.action === "fill" ? a.clicked && !a.filled && node?.name === "Test input" && input.value === a.sample && input.submit !== true && input.revision === a.observation?.revision : false)) throw new Error("VERIFICATION_ACTION_DENIED: Follow the test instructions using fresh observation refs.");
+		}
+		if (input.sessionId && input.sessionId !== a.sessionId) throw new Error("VERIFICATION_SESSION_MISMATCH");
+		setup = saveBrowserSetup({
+			...setup,
+			attempt: {
+				...a,
+				actions: a.actions + 1
+			}
+		}, setup.revision);
+		return {
+			setupId: setup.id,
+			attemptId: a.id,
+			taskKey: `browser-setup:${setup.id}:${a.id}`,
+			input: {
+				...input,
+				...a.sessionId ? { sessionId: a.sessionId } : {},
+				target: {
+					kind: "endpoint",
+					endpointId: a.endpointId
+				}
+			}
+		};
+	}
+	afterAction(setupId, attemptId, input, result) {
+		const setup = readBrowserSetup(setupId);
+		if (!setup?.attempt || setup.attempt.id !== attemptId) return;
+		const a = { ...setup.attempt };
+		if (input.action === "close" && result.ok && result.receipt.action === "close" && result.receipt.verified) {
+			a.released = true;
+			delete a.observation;
+			const complete = setup.state === "verifying" && setup.configRevision === browserConfigRevision(this.deps.getConfig()) && Date.now() <= a.expiresAt && a.policyRevision === this.policyRevision(setup.agentId) && this.deps.canUseBrowser(setup.agentId) && a.read && a.clicked && a.filled;
+			return saveBrowserSetup({
+				...setup,
+				attempt: a,
+				state: setup.state === "cancelled" ? "cancelled" : complete ? "completed" : "needs_attention",
+				error: complete || setup.state === "cancelled" ? void 0 : setup.error?.startsWith("BROWSER_CONTROL_REVOKED") ? setup.error : "VERIFICATION_INCOMPLETE: Review the checks and start a new test."
+			}, setup.revision);
+		}
+		if ("error" in result) return saveBrowserSetup({
+			...setup,
+			state: setup.state === "cancelled" ? "cancelled" : "needs_attention",
+			error: result.error.message.includes("BROWSER_CONTROL_REVOKED") ? "BROWSER_CONTROL_REVOKED: Chrome control was stopped by the user. Release the demo, then resume control in the extension before starting a new test." : "BROWSER_ACTION_FAILED: Close the verification session before retrying."
+		}, setup.revision);
+		if (result.receipt.action !== input.action) return saveBrowserSetup({
+			...setup,
+			state: setup.state === "cancelled" ? "cancelled" : "needs_attention",
+			error: "VERIFICATION_RECEIPT_MISMATCH: Release the demo session."
+		}, setup.revision);
+		const o = result.receipt.observation;
+		if (!o || !result.receipt.verified) return;
+		if (o.url !== a.fixtureUrl || a.tabId && o.tabId !== a.tabId || a.documentId && o.documentId !== a.documentId || a.sessionId && o.sessionId !== a.sessionId) return saveBrowserSetup({
+			...setup,
+			state: setup.state === "cancelled" ? "cancelled" : "needs_attention",
+			error: "VERIFICATION_TARGET_CHANGED: Close the verification session."
+		}, setup.revision);
+		a.sessionId = o.sessionId;
+		a.tabId = o.tabId;
+		a.documentId = o.documentId;
+		a.observation = {
+			revision: o.revision,
+			nodes: o.nodes.map(({ ref, role, name, value, states }) => ({
+				ref,
+				role,
+				name,
+				value,
+				states
+			}))
+		};
+		const names = o.nodes.map((n) => n.name);
+		if (names.includes(`Read check: ${a.marker}`)) a.read = true;
+		if (input.action === "click" && names.includes(`Click passed: ${a.marker}`)) a.clicked = true;
+		if (input.action === "fill" && a.clicked && names.includes(`Input passed: ${a.sample}`)) a.filled = true;
+		return saveBrowserSetup({
+			...setup,
+			attempt: a
+		}, setup.revision);
+	}
+};
+//#endregion
+export { BrowserSetupService, browserConfigRevision };

package/dist/src/browser/setup/types.d.ts

@@ -0,0 +1,38 @@
+import type { BrowserObservation } from '@xopcai/browser-control-contract';
+export type SetupState = 'plan_ready' | 'preparing' | 'waiting_extension' | 'ready_for_verification' | 'verifying' | 'needs_attention' | 'completed' | 'cancelled';
+export interface BrowserSetup {
+    id: string;
+    conversationId: string;
+    agentId: string;
+    revision: number;
+    state: SetupState;
+    configRevision: string;
+    approvedBy?: string;
+    createdAt: number;
+    updatedAt: number;
+    operation?: {
+        key: string;
+        startedAt: number;
+    };
+    error?: string;
+    attempt?: {
+        id: string;
+        endpointId: string;
+        principalId: string;
+        appVersion: string;
+        policyRevision: string;
+        fixtureUrl: string;
+        marker: string;
+        sample: string;
+        expiresAt: number;
+        actions: number;
+        sessionId?: string;
+        tabId?: string;
+        documentId?: string;
+        observation?: Pick<BrowserObservation, 'revision' | 'nodes'>;
+        read: boolean;
+        clicked: boolean;
+        filled: boolean;
+        released: boolean;
+    };
+}

package/dist/src/browser/setup/types.js

@@ -0,0 +1 @@
+export {};

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -32,7 +32,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${readSchemaVersion(getSqliteDatabase())} (current release v259).`,
+		message: `SQLite schema v${readSchemaVersion(getSqliteDatabase())} (current release v260).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/extension-marketplace.js

@@ -4,17 +4,17 @@ import { AgentPluginStore } from "../../extensions/agent-plugins/store.js";
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl, verifyStoreArtifactSha256 } from "../../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { loadConfig } from "../../config/loader.js";
 import { getContextWithOpts } from "../context.js";
-import { isAgentPluginArchive } from "../../extensions/agent-plugins/sources.js";
-import { fetchRegistry, findExtension, getExtensionMarketplaceStoreBaseUrl, listExtensions, searchExtensions } from "../../extensions/marketplace.js";
 import { peekExtensionManifestFromStoreZip } from "../../extensions/install.js";
 import { commitStagedExtensionInstall, finalizeStagedExtensionInstall, rollbackStagedExtensionInstall, stageExtensionLocal, stageExtensionNpm, stageExtensionStoreZip } from "../../extensions/install-transaction.js";
+import { fetchRegistry, findExtension, getExtensionMarketplaceStoreBaseUrl, listExtensions, searchExtensions } from "../../extensions/marketplace.js";
+import { isAgentPluginArchive } from "../../extensions/agent-plugins/sources.js";
 import { colors } from "../utils/colors.js";
 import { installAgentPluginFromCli, isAgentPluginSource } from "./extension-agent-plugin.js";
 import { validateExtensionPackageDirectory } from "./extension-pack.js";
 import { join, resolve } from "node:path";
 import { existsSync, readFileSync, statSync } from "node:fs";
-import { execSync } from "node:child_process";
 import { createHash } from "node:crypto";
+import { execSync } from "node:child_process";
 import semver from "semver";
 import { confirm } from "@inquirer/prompts";
 import { Command } from "commander";

package/dist/src/cli/commands/extension-pack.js

@@ -7,8 +7,8 @@ import { collectExtensionPackageDependencyIssues } from "../../extensions/packag
 import { colors } from "../utils/colors.js";
 import { basename, join, relative, resolve } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
-import { execSync } from "node:child_process";
 import { createHash } from "node:crypto";
+import { execSync } from "node:child_process";
 import AdmZip from "adm-zip";
 import { Command } from "commander";
 //#region src/cli/commands/extension-pack.ts

package/dist/src/cli/commands/extension.js

@@ -8,9 +8,9 @@ import { checkEngineCompatibility } from "../../extensions/engine-check.js";
 import { ExtensionLoader } from "../../extensions/loader.js";
 import { loadConfig, saveConfig } from "../../config/loader.js";
 import { getContextWithOpts } from "../context.js";
-import { withAgentPluginSource } from "../../extensions/agent-plugins/sources.js";
-import { collectExtensionPackageDependencyIssues } from "../../extensions/package-contract.js";
 import { checkAllExtensionsHealth, getExtensionHealthChecker } from "../../extensions/health.js";
+import { collectExtensionPackageDependencyIssues } from "../../extensions/package-contract.js";
+import { withAgentPluginSource } from "../../extensions/agent-plugins/sources.js";
 import { colors } from "../utils/colors.js";
 import { addAgentPluginLifecycleCommands, isAgentPluginSource } from "./extension-agent-plugin.js";
 import { createExtensionCreateCommand } from "./extension-create.js";

package/dist/src/config/schema.d.ts

@@ -1781,6 +1781,8 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
     phone: z.ZodPrefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         adbPath: z.ZodOptional<z.ZodString>;
+        semanticControls: z.ZodDefault<z.ZodBoolean>;
+        hierarchicalPlanning: z.ZodDefault<z.ZodBoolean>;
         maxActionsPerSession: z.ZodDefault<z.ZodNumber>;
         maxModelRequests: z.ZodDefault<z.ZodNumber>;
         maxOperationDurationMs: z.ZodDefault<z.ZodNumber>;

package/dist/src/extensions/install.js

@@ -6,9 +6,9 @@ import { MAX_EXTENSION_STORE_ZIP_BYTES } from "./store-zip-limits.js";
 import { checkEngineCompatibility } from "./engine-check.js";
 import { EXTENSION_API_VERSION, EXTENSION_UI_API_VERSION, checkExtensionApiCompatibility } from "./api-version.js";
 import { collectExtensionPackageDependencyIssues } from "./package-contract.js";
-import { execFileSync } from "node:child_process";
 import { dirname, isAbsolute, join, resolve, sep } from "path";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
+import { execFileSync } from "node:child_process";
 import AdmZip from "adm-zip";
 import semver from "semver";
 import { tmpdir } from "os";

package/dist/src/extensions/update.js

@@ -4,8 +4,8 @@ import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from ".
 import { computeExtensionDirectoryIntegrity, getExtensionLockfileManager } from "./lockfile.js";
 import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl, verifyStoreArtifactSha256 } from "../agent/skills/marketplace/adapters/store/store-api-client.js";
 import { loadConfig } from "../config/loader.js";
-import { findExtension } from "./marketplace.js";
 import { commitStagedExtensionInstall, finalizeStagedExtensionInstall, rollbackStagedExtensionInstall, stageExtensionNpm, stageExtensionStoreZip } from "./install-transaction.js";
+import { findExtension } from "./marketplace.js";
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { createHash } from "node:crypto";

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -277,4 +277,4 @@ export declare const GATEWAY_BUILTIN_TOOLS: readonly [{
         readonly zh: "使用已验证的参数执行选定的外部工具。";
     };
 }];
-export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "find" | "image" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "user_context_search" | "user_context_get" | "user_context_update" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "web_extract" | "clarify" | "xopc_tool_execute" | "tool_manual" | "session_status" | "read_media" | "xopc_tool_search" | "xopc_tool_describe" | "phone_use" | "image_generate" | "skills_list" | "skill_view" | "skill_manage" | "skills_marketplace_search" | "computer_use" | "send_message" | "text_to_speech" | "execute_code" | "send_media" | "create_share" | "memory_maintenance" | "delegate_task" | "skill_install" | "create_desktop_pet")[];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: ("automation" | "find" | "image" | "knowledge_search" | "knowledge_get" | "knowledge_write" | "user_context_search" | "user_context_get" | "user_context_update" | "web_search" | "web_fetch" | "browser_use" | "grep" | "session_search" | "read_file" | "list_dir" | "write_file" | "apply_patch" | "exec_command" | "update_plan" | "todo" | "web_extract" | "clarify" | "xopc_tool_execute" | "tool_manual" | "session_status" | "read_media" | "xopc_tool_search" | "xopc_tool_describe" | "phone_use" | "skill_view" | "skills_list" | "image_generate" | "skill_manage" | "skills_marketplace_search" | "computer_use" | "send_message" | "text_to_speech" | "execute_code" | "send_media" | "create_share" | "memory_maintenance" | "delegate_task" | "skill_install" | "create_desktop_pet")[];

package/dist/src/gateway/hono/routes/auth-registry-extensions.js

@@ -2,8 +2,8 @@ import { getAllModels, getAvailableModels, init_providers } from "../../../provi
 import { ActivationPlanner } from "../../../extensions/activation-planner.js";
 import { mergeActivationContext } from "../../../extensions/activation-context.js";
 import { validateExtensionConfig } from "../../../extensions/config-validation.js";
-import { listAgentPluginInventory } from "../../../extensions/agent-plugins/inventory.js";
 import { fetchRegistry, listExtensions, searchExtensions } from "../../../extensions/marketplace.js";
+import { listAgentPluginInventory } from "../../../extensions/agent-plugins/inventory.js";
 import { createOAuthAsyncHandler } from "../oauth-async.js";
 import { createOAuthHandler } from "../oauth.js";
 import { extensionAssetMimeType } from "../lib/extension-assets.js";

package/dist/src/gateway/hono/routes/browser-setup.d.ts

@@ -0,0 +1,3 @@
+import type { Hono } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function registerBrowserSetupRoutes(app: Hono, deps: AuthenticatedRouteDeps): void;