@xopcai/xopc 0.0.423 → 0.0.424

package/dist/src/agent/embedded/session-tool-result-guard.js

@@ -1,11 +1,11 @@
 import { init_string_coerce, normalizeOptionalString } from "../../utils/string-coerce.js";
+import { formatContextLimitTruncationNotice } from "./tool-result-context-guard.js";
+import { resolveLiveToolResultMaxChars, truncateToolResultMessage } from "./tool-result-truncation.js";
 import { emitSessionTranscriptUpdate } from "../../session/transcript-events.js";
 import { sanitizeSearchInfo } from "../tools/search/search-info.js";
 import { extractToolCallsFromAssistant, extractToolResultId } from "../transcript/tool-call-id.js";
 import { makeMissingToolResult, sanitizeToolCallInputs } from "../transcript/session-transcript-repair.js";
 import { boundedJsonUtf8Bytes, firstEnumerableOwnKeys, jsonUtf8BytesOrInfinity } from "../../infra/json-utf8-bytes.js";
-import { formatContextLimitTruncationNotice } from "./tool-result-context-guard.js";
-import { resolveLiveToolResultMaxChars, truncateToolResultMessage } from "./tool-result-truncation.js";
 //#region src/agent/embedded/session-tool-result-guard.ts
 init_string_coerce();
 /**

package/dist/src/agent/embedded/tool-result-truncation.js

@@ -1,6 +1,6 @@
 import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../../utils/string-coerce.js";
-import { isDataBatchResult, renderDataBatch } from "../data-acquisition/render.js";
 import { formatContextLimitTruncationNotice } from "./tool-result-context-guard.js";
+import { isDataBatchResult, renderDataBatch } from "../data-acquisition/render.js";
 //#region src/agent/embedded/tool-result-truncation.ts
 init_string_coerce();
 const MAX_TOOL_RESULT_CONTEXT_SHARE = .3;

package/dist/src/agent/external-tools/cliProvider.js

@@ -5,11 +5,11 @@ import { getConnectorAccount, init_connector_account_repository } from "../../st
 import { appendConnectorExecutionAudit, consumeConnectorApproval, createConnectorApproval, getConnectorApproval, getConnectorConnection, getConnectorInstallation, init_connector_repository } from "../../storage/sqlite/connector-repository.js";
 import { connectorObjectiveScope, init_connection_wait_repository, publishConnectionWait, requireSessionConnection } from "../../storage/sqlite/connection-wait-repository.js";
 import "../../storage/sqlite/index.js";
+import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
+import { connectorPrincipalForSession } from "../../connectors/principal.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
 import "../../capabilities/runtime/dispatcher.js";
-import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
-import { connectorPrincipalForSession } from "../../connectors/principal.js";
 import { selectConnectorAccount } from "../../connectors/account-selection.js";
 import { cliContextPath } from "../../connectors/cli/process.js";
 import { getCliAdapter } from "../../connectors/cli/adapterRegistry.js";

package/dist/src/agent/external-tools/composio-provider.js

@@ -5,11 +5,11 @@ import { getConnectorAccount } from "../../storage/sqlite/connector-account-repo
 import { consumeConnectorApproval, createConnectorApproval, getConnectorApproval, getConnectorConnection, getConnectorInstallation, listConnectorActionMetadata, listConnectorConnections, listConnectorInstallations, upsertConnectorActionMetadata, upsertConnectorInstallation } from "../../storage/sqlite/connector-repository.js";
 import { bindObjectiveAccount, connectionBinding, connectionBindings, connectorObjectiveScope, init_connection_wait_repository, publishConnectionWait, requireSessionConnection } from "../../storage/sqlite/connection-wait-repository.js";
 import "../../storage/sqlite/index.js";
-import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
 import { connectorArgumentsHash, connectorArgumentsPreview } from "../../connectors/approval.js";
 import { canAccessConnectorAccount, currentAccountConnections } from "../../connectors/account-access.js";
 import { connectorPrincipalForSession } from "../../connectors/principal.js";
+import { CapabilityError } from "../../capabilities/runtime/errors.js";
+import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
 import { connectorIdentitySummary } from "../../connectors/connector-identity.js";
 import { evaluateConnectorExecutionPolicy } from "../../connectors/policy.js";
 import { ComposioSessionsAdapter } from "../../connectors/composio-sessions.js";

package/dist/src/agent/external-tools/endpoint-provider.js

@@ -1,7 +1,7 @@
-import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
-import { canonicalCapabilityJson } from "../../capabilities/runtime/dispatcher.js";
 import { init_src } from "../../../packages/computer-control-contract/src/index.js";
 import "../../../packages/browser-control-contract/src/index.js";
+import { ExternalEffectNotAppliedError, executeExternalOperation } from "../../capabilities/runtime/external-operations.js";
+import { canonicalCapabilityJson } from "../../capabilities/runtime/dispatcher.js";
 import { externalToolRef, parseExternalToolRef } from "./refs.js";
 import { extractDocumentText } from "../../document-understanding/extract.js";
 import { prepareImageForModel } from "../image/prepare-image-for-model.js";

package/dist/src/agent/inbound/attachment-pipeline.js

@@ -1,7 +1,7 @@
 import { stripRuntimeUserMessageEnvelope } from "../../../packages/gateway-contract/src/user-message-display.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { readAgentMessageContent } from "../memory/agent-message-access.js";
+import { extractProfileAgentId } from "../../config/agent-profile.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { mimeTypeFromMediaPath } from "../../media/store.js";
 import { readMediaReference } from "../../media/media-reference.js";

package/dist/src/agent/memory/compaction.js

@@ -2,9 +2,9 @@ import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_compaction_types, isCompactionHandover } from "../../session/compaction-types.js";
 import { buildSessionContextForLlm, init_session_context_for_llm, isTranscriptCompactionEntry } from "../../session/session-context-for-llm.js";
+import { estimateMessagesTokens, estimateTextTokens } from "./context-budget.js";
 import { getModelUsageOrigin, init_model_usage, isProviderUsageScopeError } from "../../providers/model-usage.js";
 import { completeWithResolvedCredentials } from "../../providers/model-call.js";
-import { estimateMessagesTokens, estimateTextTokens } from "./context-budget.js";
 import { applyCompactionHandoverDelta, consolidateCompactionHandover, handoverForPrompt, renderCompactionHandover } from "./compaction-ledger.js";
 import { estimateCompactionSourceTokens, planCompactionSource } from "./compaction-source-planner.js";
 import { serializeMessageForCompaction } from "./compaction-serializer.js";

package/dist/src/agent/memory/context-budget.js

@@ -1,5 +1,5 @@
-import { readAgentMessageContent } from "./agent-message-access.js";
 import { getToolResultTextLength, truncateToolResultMessage } from "../embedded/tool-result-truncation.js";
+import { readAgentMessageContent } from "./agent-message-access.js";
 //#region src/agent/memory/context-budget.ts
 const MESSAGE_OVERHEAD_TOKENS = 12;
 const REQUEST_OVERHEAD_TOKENS = 256;

package/dist/src/agent/memory/context-recovery.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { stripTrailingErrorAssistantMessages } from "../orchestration/llm-turn-retry.js";
 import { evaluateContextBudget, projectContextForModel, stringifyMessagesForBudget } from "./context-budget.js";
+import { stripTrailingErrorAssistantMessages } from "../orchestration/llm-turn-retry.js";
 //#region src/agent/memory/context-recovery.ts
 init_logger();
 const log = createLogger("ContextRecovery");

package/dist/src/agent/memory/user-message-text.js

@@ -1,5 +1,5 @@
-import { extractTextContent } from "../context/workspace.js";
 import { readAgentMessageContent } from "./agent-message-access.js";
+import { extractTextContent } from "../context/workspace.js";
 //#region src/agent/memory/user-message-text.ts
 /** Plain text from a user-role agent message (string or parts array). */
 function extractAgentUserPlainText(message) {

package/dist/src/agent/service/btw-query.js

@@ -1,6 +1,6 @@
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { completeWithResolvedCredentials, createResolvedModelStream, resolveModelCallApiKey } from "../../providers/model-call.js";
-import { readAgentMessageContent } from "../memory/agent-message-access.js";
 //#region src/agent/service/btw-query.ts
 init_providers();
 function textFromCompleteContent(content) {

package/dist/src/agent/service/direct-turn-helpers.js

@@ -1,5 +1,5 @@
-import { getClarificationResumeInput } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput, init_connection_wait_repository } from "../../storage/sqlite/connection-wait-repository.js";
+import { getClarificationResumeInput } from "../../storage/sqlite/clarification-wait-repository.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { phoneResumeForRun } from "../../phone/assistance.js";
 import { resolveImageHandlingStrategy } from "../image/vision-detection.js";

package/dist/src/agent/service/process-direct-streaming.js

@@ -1,12 +1,12 @@
 import { parseUserTurnDocument, renderUserTurnDocument } from "../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { init_session_input_repository, listTaskUpdateTriggers } from "../../storage/sqlite/session-input-repository.js";
-import { getClarificationResumeInput } from "../../storage/sqlite/clarification-wait-repository.js";
 import { getConnectionResumeInput, init_connection_wait_repository } from "../../storage/sqlite/connection-wait-repository.js";
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
+import { getClarificationResumeInput } from "../../storage/sqlite/clarification-wait-repository.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { init_model_usage, modelUsageOriginFromTurn, withModelUsageOrigin } from "../../providers/model-usage.js";
 import { init_agent_session_key, resolveAgentMainConversationId } from "../../routing/agent-session-key.js";
-import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { phoneResumeForRun } from "../../phone/assistance.js";
 import { abortEmbeddedRun } from "../embedded/runs.js";
 import { clearPendingTranscriptUserMessage, setPendingTranscriptUserMessage } from "../inbound/attachment-pipeline.js";

package/dist/src/agent/service.js

@@ -2,13 +2,13 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { parseNoteAttachmentTarget } from "../notes/attachment-ref.js";
 import { init_agent_scope, resolveAgentHomeDir, resolveDefaultAgentId } from "./agent-scope.js";
-import { extractTextContent } from "./context/workspace.js";
 import { getAgentDefaultModelRef, init_schema } from "../config/schema.js";
 import { init_agent_session_key, resolveAgentIdFromConversationId } from "../routing/agent-session-key.js";
 import { extractProfileAgentId, resolveEffectiveAgentConfigForSession } from "../config/agent-profile.js";
 import { init_providers, resolveModel } from "../providers/index.js";
 import { configureTracing, flushTracing } from "../observability/runtime.js";
 import { getUserTimezone } from "../user-model/repository.js";
+import { extractTextContent } from "./context/workspace.js";
 import { resolveAgentTurnTimeoutMs } from "./orchestration/run-agent-turn-with-timeout.js";
 import { applyConfigOverrides } from "../config/runtime-overrides.js";
 import { effectiveWorkspacePathForSession } from "../session/session-workspace.js";

package/dist/src/agent/skills/index.js

@@ -1,8 +1,8 @@
 import { resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { init_paths } from "../../config/paths.js";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { findInstallSpec, hasBinary, installSkill } from "./installer.js";
 import { applySkillEnvOverrides, createSkillConfigManager, getSkillEnvironment, isSkillEnabled, resolveSkillConfig, validateSkillConfig } from "./config.js";
 import { parseSkillToolConditions } from "./skill-tool-gating.js";

package/dist/src/agent/skills/managed-store.js

@@ -1,5 +1,5 @@
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { init_paths, resolveSkillsDir } from "../../config/paths.js";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { loadSkillsLock } from "./hub-lock.js";
 import { dirname, join, resolve, sep } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";

package/dist/src/agent/skills/skill-manage-ops.js

@@ -1,5 +1,5 @@
-import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { init_paths, resolveSkillsDir } from "../../config/paths.js";
+import { parseFrontmatter } from "../../markdown/frontmatter.js";
 import { resolveWorkspaceSkillsDir } from "./workspace-skills-dir.js";
 import { formatScanSummary, scanSkillDirectory } from "./scanner.js";
 import { fuzzyFindText, normalizeForFuzzyMatch, normalizeToLF, restoreLineEndings } from "../tools/edit-diff.js";

package/dist/src/agent/source-context/types.d.ts

@@ -44,6 +44,7 @@ export interface AgentSourceContext {
     capturedAt?: number;
     documentId?: string;
     fileKind?: 'file' | 'directory';
+    interactionCapabilities?: import('@xopcai/gateway-contract').InteractionCapabilities;
     appContext?: AppContextEnvelope;
     appContextGrant?: AppContextGrant;
 }

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

@@ -1,7 +1,32 @@
+import { clarifyToolInputV2Schema } from "../../../packages/gateway-contract/src/clarification-questions.js";
+import { normalizeClarificationQuestion } from "../../../packages/gateway-contract/src/clarifications.js";
+import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/clarify-tool.ts
+init_src();
+const ChoiceSchema = Type.Object({
+	id: Type.String(),
+	label: Type.String(),
+	description: Type.Optional(Type.String())
+}, { additionalProperties: false });
+const QuestionSchema = Type.Union([Type.Object({
+	id: Type.String(),
+	header: Type.String(),
+	question: Type.String(),
+	type: Type.Literal("text")
+}, { additionalProperties: false }), Type.Object({
+	id: Type.String(),
+	header: Type.String(),
+	question: Type.String(),
+	type: Type.Literal("single_choice"),
+	choices: Type.Array(ChoiceSchema, {
+		minItems: 2,
+		maxItems: 10
+	}),
+	recommendedChoiceId: Type.Optional(Type.String())
+}, { additionalProperties: false })]);
 const ClarifySchema = Type.Object({
-	question: Type.String({ description: "The question to ask the user. Be specific and concise." }),
+	question: Type.Optional(Type.String({ description: "The question to ask the user. Be specific and concise." })),
 	interactionMode: Type.Optional(Type.Union([Type.Literal("quick"), Type.Literal("compose")], { description: "quick submits a choice immediately; compose lets the user select and add details before submitting." })),
 	choiceDetails: Type.Optional(Type.Array(Type.Object({
 		id: Type.String(),
@@ -12,8 +37,17 @@ const ClarifySchema = Type.Object({
 		maxItems: 10,
 		description: "Answer choices with stable unique IDs and optional descriptions."
 	})),
-	recommendedChoiceId: Type.Optional(Type.String())
-}, { additionalProperties: false });
+	recommendedChoiceId: Type.Optional(Type.String()),
+	schemaVersion: Type.Optional(Type.Literal(2)),
+	questions: Type.Optional(Type.Array(QuestionSchema, {
+		minItems: 1,
+		maxItems: 3,
+		description: "Independent questions answered together. Only supported by capable Web/Electron main chats. Never use for approvals."
+	}))
+}, {
+	additionalProperties: false,
+	anyOf: [{ required: ["question"] }, { required: ["schemaVersion", "questions"] }]
+});
 function waitForAbort(signal) {
 	return new Promise((_, reject) => {
 		if (!signal) return;
@@ -40,12 +74,16 @@ function createClarifyTool(deps) {
 				}],
 				details: { answer: "" }
 			};
-			const payload = {
+			const batch = params?.schemaVersion === 2 ? clarifyToolInputV2Schema.parse(params) : void 0;
+			const payload = normalizeClarificationQuestion(batch ? {
+				...batch,
+				question: batch.questions.map((q) => q.header).join(" / ")
+			} : {
 				interactionMode: p.interactionMode,
 				choiceDetails: p.choiceDetails,
 				recommendedChoiceId: p.recommendedChoiceId,
 				question: p.question
-			};
+			});
 			try {
 				const result = await Promise.race([askUser(payload), waitForAbort(signal)]);
 				if (result.status === "waiting") return {

package/dist/src/agent/tools/cli-clarify.js

@@ -6,6 +6,7 @@ import { stdin, stdout } from "node:process";
 init_src();
 function createCliReadlineClarifyRequestFn() {
 	return async (_context, request) => {
+		if (request.schemaVersion === 2) throw new Error("CLARIFICATION_VERSION_UNSUPPORTED: CLI supports single questions");
 		const rl = readline.createInterface({
 			input: stdin,
 			output: stdout

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

@@ -1,8 +1,8 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
+import { renderDataBatch } from "../data-acquisition/render.js";
 import { DataBatchSchema } from "../data-acquisition/schema.js";
 import { acquireData } from "../data-acquisition/service.js";
-import { renderDataBatch } from "../data-acquisition/render.js";
 import { AsyncLocalStorage } from "node:async_hooks";
 //#region src/agent/tools/dataBatch.ts
 init_logger();

package/dist/src/agent/tools/personal-read-tool.js

@@ -1,7 +1,7 @@
-import { CapabilityDispatcher } from "../../capabilities/runtime/dispatcher.js";
 import { isPersonalConversation } from "../../personal-agent/repository.js";
 import { getEmbeddedExecutionSession } from "../embedded/execution-context.js";
 import { LOCAL_READ_MAX_CHARS } from "./local-read-budget.js";
+import { CapabilityDispatcher } from "../../capabilities/runtime/dispatcher.js";
 import { registerNoteReadCapabilities } from "../../notes/capabilities/read.js";
 import { registerProjectReadCapabilities } from "../../projects/capabilities/read.js";
 import { registerAutomationReadCapabilities } from "../../automations/capabilities/read.js";

package/dist/src/agent/tools/personal-task-tool.d.ts

@@ -14,6 +14,7 @@ declare const PersonalTaskModelSchema: import("@sinclair/typebox").TObject<{
     }>>;
     requestId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     description: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    questionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     expectedVersion: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
     idempotencyKey: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     instruction: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
@@ -33,7 +34,6 @@ declare const PersonalTaskModelSchema: import("@sinclair/typebox").TObject<{
     baselineResultId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     supersedesEntryIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
     bodyOffset: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
-    questionId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     command: import("@sinclair/typebox").TString;
     sourceRefs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
         kind: import("@sinclair/typebox").TUnion<import("@sinclair/typebox").TLiteral<string>[]>;

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

@@ -106,7 +106,7 @@ function createPhoneUseTool(deps) {
 		name: "phone_use",
 		label: "Phone",
 		parameters: Schema,
-		description: "Use an authorized Android phone via local ADB or a configured cloud connection. Load tool_manual for phone_use before first use. Discover registered devices, appAccess and allowedApps first. Use the defaultDeviceId returned by discover unless the user explicitly names a different phone. A phone-control conversation may bind its own defaultDeviceId. Match an explicitly named phone to its unique registered name and deviceId; ask when ambiguous and never silently switch phones; open with mode observe/control and optional authorized appPackage, observe native UI text, then discover the effective executionMode. In collaborative mode, plan with the main Agent and run one small goal at a time. In direct mode, delegate the full authorized phone goal to run and let the phone model plan locally. Keep the same taskId across fragments. Do not silently change mode or retry budget exhaustion. Inspect feedback.outcome, outputs and nextAction. Use set_mode only for an explicit user mode change; applyCurrent pauses and requires inspection/handback. Device and model configuration live in Phone Use settings. Connections originate from the Gateway host; cloud credentials are configured in phone management. Mock mode only supports the explicitly requested settings-about emulator test. Never silently switch phones, execute shell commands, bypass app restrictions, or repeat a dispatch with unknown outcome. Request user assistance for login, CAPTCHA or an effect not already authorized. Use request_user with reason when manual assistance is needed; it saves the current task and ends this turn until explicit handback. A plain pause does not request assistance; resume re-observes. Inspect readings for information source and verification; screenshot readings are unverified observations, never proof of completion. Inspect verified, verificationLevel and stopReason before claiming success. Close finishes this task and releases operation control while keeping the phone connected. Do not close or disconnect a phone to resolve PHONE_DEVICE_BUSY; report executionStarted=false and the occupying conversation to the user, and wait for user action. Raw screenshots never enter the chat transcript.",
+		description: "Use an authorized Android phone via local ADB or a configured cloud connection. Load tool_manual for phone_use before first use. Discover registered devices, appAccess and allowedApps first. Use the defaultDeviceId returned by discover unless the user explicitly names a different phone. A phone-control conversation may bind its own defaultDeviceId. Match an explicitly named phone to its unique registered name and deviceId; ask when ambiguous and never silently switch phones; open with mode observe/control and optional authorized appPackage, observe native UI text, then discover the effective executionMode. In collaborative mode, plan with the main Agent and run one small goal at a time. In direct mode, delegate the full authorized phone goal to run and let the phone model plan locally. Keep the same taskId across fragments. Do not silently change mode or retry budget exhaustion. Inspect feedback.outcome, outputs and nextAction. Use set_mode only for an explicit user mode change; applyCurrent pauses and requires inspection/handback. Device and model configuration live in Phone Use settings. Connections originate from the Gateway host; cloud credentials are configured in phone management. Mock mode only supports the explicitly requested settings-about emulator test. Never silently switch phones, execute shell commands, bypass app restrictions, or repeat a dispatch with unknown outcome. Request user assistance for login, CAPTCHA or an effect not already authorized. Use request_user with reason when manual assistance is needed; it saves the current task and ends this turn until explicit handback. Explain the required user action in a normal chat reply and direct the user to the existing phone entry. Do not create approval cards or auto-open the phone. The user can click Done, continue task or explicitly confirm completion in chat. A plain pause does not request assistance; resume re-observes. Inspect readings for information source and verification; screenshot readings are unverified observations, never proof of completion. Inspect verified, verificationLevel and stopReason before claiming success. Close finishes this task and releases operation control while keeping the phone connected. Do not close or disconnect a phone to resolve PHONE_DEVICE_BUSY; report executionStarted=false and the occupying conversation to the user, and wait for user action. Raw screenshots never enter the chat transcript.",
 		async execute(_id, raw, signal, onUpdate) {
 			const { owner, ...context } = deps.context();
 			const runId = getEmbeddedExecutionRunId();
@@ -137,7 +137,7 @@ function createPhoneUseTool(deps) {
 					deviceId: report.deviceId,
 					reason: report.message,
 					nextAction: "user_takeover",
-					message: "请接管手机，完成登录、验证码等操作后点击“已完成，继续任务”，原任务会从当前页面继续。"
+					message: "请通过聊天顶部的手机入口完成所需操作，完成后点击“完成，继续任务”或返回聊天告诉我继续。"
 				};
 				onUpdate({
 					content: [{

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

@@ -1,10 +1,10 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { init_fts, sessionSearchTerms } from "../../storage/sqlite/fts.js";
+import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import { init_providers, resolveModel } from "../../providers/index.js";
 import { completeWithResolvedCredentials } from "../../providers/model-call.js";
 import { FORGOTTEN_HISTORY_EXCERPT, forgottenHistoryEntries, projectUnadmittedForgottenFields } from "../../memory-learning/forgotten-history.js";
-import { readAgentMessageContent } from "../memory/agent-message-access.js";
 import "./local-read-budget.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/session-search-tool.ts

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

@@ -11,15 +11,15 @@ import { TaskRunRepository } from "../../tasks/task-run-repository.js";
 import { getSessionMetadata } from "../../storage/sqlite/session-read-repository.js";
 import "../../storage/sqlite/index.js";
 import "../../activity/index.js";
-import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import "../../capabilities/runtime/dispatcher.js";
 import { getDefaultAgentId, init_resolve_route } from "../../routing/resolve-route.js";
 import { hasUnlocalizedTaskText, resolveTaskLocale } from "../../tasks/task-language.js";
 import { TaskReadModelProjector } from "../../tasks/task-read-model-projector.js";
 import { TaskOriginRepository } from "../../tasks/task-origin-repository.js";
 import { TaskConversationRepository } from "../../tasks/task-conversation-repository.js";
+import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { getAutomationSetup } from "../../automations/configuration-conversation.js";
 import { getEmbeddedExecutionRunId } from "../embedded/execution-context.js";
+import "../../capabilities/runtime/dispatcher.js";
 import { resolveProjectAgentId } from "../../projects/project-agent.js";
 import "../../projects/index.js";
 import { TaskCollaborationRepository } from "../../tasks/task-collaboration-repository.js";

package/dist/src/agent-catalog/capabilities.js

@@ -1,10 +1,10 @@
 import { AgentEntrySchema, AgentProfileSchema, EffectiveAgentConfigSchema } from "../agent-config/schema.js";
 import { resolveEffectiveAgentConfig } from "../agent-config/resolver.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
-import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
 import { AgentCatalogRepository, init_repository } from "./repository.js";
 import { init_agent_scope, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
+import { defineAtomicCapability, defineReadCapability } from "../capabilities/runtime/dispatcher.js";
 import { AgentCatalogService } from "./service.js";
 import { z } from "zod";
 //#region src/agent-catalog/capabilities.ts

package/dist/src/agent-catalog/repository.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
+import { DEFAULT_AGENT_ID, init_id, normalizeAgentId } from "./id.js";
 import { AgentDefaultsSchema, AgentEntrySchema, DEFAULT_AGENT_MODEL_REF, DEFAULT_SKILL_POLICY } from "../agent-config/schema.js";
 import { init_agent_config } from "../agent-config/index.js";
-import { DEFAULT_AGENT_ID, init_id, normalizeAgentId } from "./id.js";
 import { BindingsSchema, init_binding_schema } from "../routing/binding-schema.js";
 import { randomUUID } from "node:crypto";
 //#region src/agent-catalog/repository.ts

package/dist/src/automations/api/routes.js

@@ -1,9 +1,9 @@
 import { AutomationCancelOutputSchema, AutomationDeleteOutputSchema, AutomationMutationOutputSchema, AutomationReadAllOutputSchema, AutomationReadOutputSchema, AutomationRunMutationOutputSchema, ProductReadContracts } from "../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
-import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import "../../capabilities/runtime/dispatcher.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
+import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { getAutomationSetup, openAutomationConfiguration } from "../configuration-conversation.js";
+import "../../capabilities/runtime/dispatcher.js";
 import { createProductDispatcher } from "../../capabilities/runtime/product.js";
 import { capabilityHttpContext, capabilityHttpError } from "../../capabilities/adapters/http.js";
 import { randomUUID } from "node:crypto";

package/dist/src/automations/capabilities/drafts.js

@@ -3,10 +3,10 @@ import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { resolveAutomationSafetyForTrust } from "../../user-context/trust-policy.js";
 import { getUserTrustPolicy } from "../../storage/sqlite/user-trust-repository.js";
 import "../../storage/sqlite/index.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
 import { ExternalEffectNotAppliedError } from "../../capabilities/runtime/external-operations.js";
 import { defineExternalCapability, defineReadCapability } from "../../capabilities/runtime/dispatcher.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../../agent/agent-scope.js";
 import { AutomationCreateCapabilityInputSchema } from "./write.js";
 import { simulateAutomation } from "../draft/automation-draft-validator.js";
 import { AutomationDraftService } from "../draft/automation-draft-service.js";

package/dist/src/automations/capabilities/write.js

@@ -1,7 +1,6 @@
 import { AutomationCancelOutputSchema, AutomationDeleteInputSchema, AutomationDeleteOutputSchema, AutomationMutationOutputSchema, AutomationReadAllInputSchema, AutomationReadAllOutputSchema, AutomationReadOutputSchema, AutomationRecoveryOutputSchema, AutomationReplayEventInputSchema, AutomationRetryDeliveryInputSchema, AutomationRunMutationOutputSchema, AutomationSetEnabledInputSchema, CapabilityResourceInputSchema } from "../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { CapabilityError } from "../../capabilities/runtime/errors.js";
-import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
 import { CreateAutomationSchema, UpdateAutomationSchema } from "../domain/validation.js";
 import { getAutomation } from "../storage/automation-repository.js";
 import { getAutomationRun, markAllAutomationRunsRead, markAutomationRunRead } from "../storage/automation-run-repository.js";
@@ -9,6 +8,7 @@ import "../storage/index.js";
 import { getAutomationEventForRun } from "../events/event-repository.js";
 import "../events/index.js";
 import { assertAutomationSetupTarget, bindAutomationSetup } from "../configuration-conversation.js";
+import { defineAtomicCapability } from "../../capabilities/runtime/dispatcher.js";
 import { AutomationAlreadyExistsError, AutomationAlreadyRunningError, AutomationInvalidAgentError, AutomationInvalidScheduleError } from "../service/automation-service.js";
 import { z } from "zod";
 //#region src/automations/capabilities/write.ts

package/dist/src/automations/configuration-conversation.js

@@ -3,9 +3,9 @@ import { getSqliteDatabase, init_transaction, runSqliteWriteTransaction } from "
 import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js";
 import { init_session_repository, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { init_agent_scope, listAgentEntries } from "../agent/agent-scope.js";
 import { createConversation, init_conversation_repository } from "../storage/sqlite/conversation-repository.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { getAutomation } from "./storage/automation-repository.js";
 import { getAutomationRun, listAutomationRuns } from "./storage/automation-run-repository.js";
 import { listAutomationResultDeliveries } from "./delivery/delivery-router.js";

package/dist/src/browser/providers/browser-ext-install.js

@@ -13,8 +13,8 @@ import { accessSync, chmodSync, constants, existsSync, mkdirSync, readFileSync,
 import { fileURLToPath } from "node:url";
 import { createHash } from "node:crypto";
 import { execFileSync, spawn } from "node:child_process";
-import { readFile, readdir, rm } from "node:fs/promises";
 import AdmZip from "adm-zip";
+import { readFile, readdir, rm } from "node:fs/promises";
 //#region src/browser/providers/browser-ext-install.ts
 /**
 * Install bundled Chrome extension artifacts into {resolveBinDir()}/browser-ext/.

package/dist/src/capabilities/runtime/dispatcher.js

@@ -1,7 +1,7 @@
 import { SqliteCommitEffectError, init_transaction } from "../../storage/sqlite/transaction.js";
-import { OperationConflictError, executeAtomicOperation } from "./atomic-operations.js";
 import { CapabilityError } from "./errors.js";
 import { executeExternalOperation } from "./external-operations.js";
+import { OperationConflictError, executeAtomicOperation } from "./atomic-operations.js";
 import { createHash } from "node:crypto";
 import { z } from "zod";
 //#region src/capabilities/runtime/dispatcher.ts

package/dist/src/capabilities/runtime/product.js

@@ -1,6 +1,5 @@
 import { CapabilityError } from "./errors.js";
 import { CapabilityDispatcher } from "./dispatcher.js";
-import { registerAgentCapabilities } from "../../agent-catalog/capabilities.js";
 import { registerLocalAppReadCapabilities } from "../../local-apps/capabilities/read.js";
 import { registerNoteReadCapabilities } from "../../notes/capabilities/read.js";
 import { registerNoteWriteCapabilities } from "../../notes/capabilities/write.js";
@@ -17,6 +16,7 @@ import { registerAutomationDraftCapabilities } from "../../automations/capabilit
 import { registerTaskWriteCapabilities } from "../../tasks/capabilities/write.js";
 import { registerSettingsCapability } from "./settings.js";
 import { registerAppContextCapability } from "./app-context.js";
+import { registerAgentCapabilities } from "../../agent-catalog/capabilities.js";
 //#region src/capabilities/runtime/product.ts
 function createProductDispatcher(getNotes, taskWrites) {
 	const dispatcher = new CapabilityDispatcher();

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

@@ -11,9 +11,9 @@ import { MessageBus, MessageBusShutdownError } from "../../infra/bus/queue.js";
 import "../../infra/bus/index.js";
 import { AgentService } from "../../agent/service.js";
 import "../../agent/index.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
+import "../../config/index.js";
 import { getXopcCloudCatalogCoordinator } from "../../providers/xopc-cloud-catalog-coordinator.js";
 import { listSessions } from "./agent/sessions.js";
 import { renderStreamToTerminal } from "./agent/stream-renderer.js";

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

@@ -1,8 +1,8 @@
 import { normalizeAgentId, validateAgentIdForNewAgent } from "../../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
 import { init_agent_scope, resolveAgentDir, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../../agent/agent-scope.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { resolveEffectiveAgentConfigForAgent } from "../../config/agent-profile.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { colors } from "../utils/colors.js";
 //#region src/cli/commands/agents.ts
 init_repository();

package/dist/src/cli/commands/gateway/lifecycle.js

@@ -1,7 +1,7 @@
 import { init_paths, resolveConfigPath } from "../../../config/paths.js";
 import { loadConfig } from "../../../config/loader.js";
-import { isRestartEnabled } from "../../../config/commands.flags.js";
 import "../../../config/index.js";
+import { isRestartEnabled } from "../../../config/commands.flags.js";
 import { resolveGatewayService } from "../../../daemon/service.js";
 import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "../../../infra/restart.js";
 import { findVerifiedGatewayListenerPidsOnPortSync, formatGatewayPidList, signalVerifiedGatewayPidSync } from "../../../infra/gateway-processes.js";

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

@@ -1,17 +1,17 @@
 import { creditDecimal } from "../../../packages/gateway-contract/src/cloud-credits.js";
 import { init_src } from "../../../packages/gateway-contract/src/index.js";
 import { AgentCatalogRepository, init_repository } from "../../agent-catalog/repository.js";
-import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { getAgentDefaultModelRef, init_schema } from "../../config/schema.js";
 import { CredentialResolver, init_credentials } from "../../auth/credentials.js";
 import { getAllModels, getAvailableModels, getConfiguredProviders, getProviderAuthState, getProviderDisplayName, init_providers, isProviderConfigured, providerSupportsApiKey, providerSupportsOAuth, resolveModel } from "../../providers/index.js";
 import { XopcCloudAccountService } from "../../providers/xopc-cloud-account-service.js";
+import { AgentCatalogService } from "../../agent-catalog/service.js";
 import { listImageProviderSpecs } from "../../../packages/image-providers/src/catalog.js";
 import "../../../packages/image-providers/src/index.js";
 import { loadConfig } from "../../config/loader.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
 import { getContextWithOpts } from "../context.js";
+import "../../config/index.js";
 import { prepareUpdateGlobalDefaults } from "../../gateway/global-defaults-admin.js";
 import { disconnectProvider } from "../../providers/provider-disconnect.js";
 import { colors } from "../utils/colors.js";

package/dist/src/cli/commands/onboard/model.js

@@ -1,5 +1,4 @@
 import { AgentCatalogRepository, init_repository } from "../../../agent-catalog/repository.js";
-import { AgentCatalogService } from "../../../agent-catalog/service.js";
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { ConfigSchema, getAgentDefaultModelRef, init_schema } from "../../../config/schema.js";
 import { init_models_json, loadModelsJson, saveModelsJson } from "../../../config/models-json.js";
@@ -7,6 +6,7 @@ import { getApiKeyFromEnv } from "../../../providers/env-keys.js";
 import { getModelRegistry } from "../../../providers/model-registry.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
 import { getAllProviders, getModelsByProvider, getProviderDisplayName, init_providers, providerSupportsApiKey, providerSupportsOAuth } from "../../../providers/index.js";
+import { AgentCatalogService } from "../../../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "../../../gateway/global-defaults-admin.js";
 import { discoverProviderModels, isProviderApiDiscoverable } from "../../../providers/model-discovery.js";
 import { getXopcCloudCatalogCoordinator } from "../../../providers/xopc-cloud-catalog-coordinator.js";

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

@@ -3,8 +3,8 @@ import { AgentCatalogRepository, init_repository } from "../../agent-catalog/rep
 import { ConfigSchema, init_schema } from "../../config/schema.js";
 import { resolveGatewayLocalClientHost } from "../../config/gateway-bind.js";
 import { saveConfig } from "../../config/loader.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { provisionEagerRuntimes } from "../../runtime-tools/bootstrap.js";
 import { colors } from "../utils/colors.js";
 import { initWorkspace } from "../utils/init-workspace.js";

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

@@ -1,6 +1,6 @@
 import { loadConfig, saveConfig } from "../../config/loader.js";
-import "../../config/index.js";
 import { formatExamples, register } from "../registry.js";
+import "../../config/index.js";
 import { PLATFORM_RUNTIME_PROFILE, PLATFORM_RUNTIME_PROVIDER, PlatformRuntimeClient, discoverPlatform } from "../../platform/client.js";
 import "../../platform/index.js";
 import { getProfile, upsertAuthProfile } from "../../auth/profiles/profiles.js";