@xopcai/xopc 0.0.413 → 0.0.415

package/dist/src/gateway/hono/routes/home.js

@@ -4,8 +4,8 @@ import { acknowledgeHomeAttention } from "../../../storage/sqlite/home-attention
 import { decideConnectorApproval } from "../../../storage/sqlite/connector-repository.js";
 import { init_sqlite } from "../../../storage/sqlite/index.js";
 import { HomeQueryService, buildHomeWorkbench, decisionFromTask } from "../../../tasks/home-query-service.js";
-import { resumeApprovedConnectorAction } from "../../../connectors/approval-resume.js";
 import { HomeOpportunityActionError, HomeOpportunityNotFoundError } from "../../../home-intelligence/application-service.js";
+import { resumeApprovedConnectorAction } from "../../../connectors/approval-resume.js";
 //#region src/gateway/hono/routes/home.ts
 init_src();
 init_sqlite();

package/dist/src/gateway/hono/routes/notes.js

@@ -1,9 +1,9 @@
 import { NoteDeleteOutputSchema, NoteGetOutputSchema, ProductReadContracts } from "../../../../packages/gateway-contract/src/capabilities.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
-import { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
-import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
+import { init_session_key, resolveConversationId } from "../../../routing/session-key.js";
+import { agentExists, getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { resolveGatewayEffectiveHost } from "../../../config/gateway-bind.js";
 import { getShareStore } from "../../../share/share-store.js";
 import { resolveShareUrl } from "../../../share/share-url.js";

package/dist/src/gateway/hono/routes/phone.js

@@ -4,6 +4,7 @@ import { MOCK_PHONE_MODEL, PhoneActionSchema, PhoneConfigSchema, PhoneDeviceSche
 import { getDefaultAgentId, init_resolve_route } from "../../../routing/resolve-route.js";
 import { getModelRegistry, init_model_registry } from "../../../providers/model-registry.js";
 import { init_providers, isProviderConfiguredSync } from "../../../providers/index.js";
+import { normalizePhoneAppAccess, phoneAppAccess } from "../../../phone/app-access.js";
 import { createPhoneModel, phoneModelProfile } from "../../../phone/model-adapter.js";
 import { getPhoneRuntime, phoneExecutionContext } from "../../../phone/runtime.js";
 import { getGatewayPrincipal } from "../../security/gateway-principal.js";
@@ -129,6 +130,31 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 			}
 		});
 	});
+	app.get("/api/phone/apps", async (c) => {
+		const input = z.object({ serial: z.string().min(1).max(200) }).strict().parse(c.req.query());
+		const applications = await runtime.applications(input, service.currentConfig, c.req.raw.signal);
+		c.header("Cache-Control", "no-store");
+		return c.json({
+			ok: true,
+			payload: { applications }
+		});
+	});
+	app.get("/api/phone/devices/:id/apps", async (c) => {
+		const applications = await runtime.applications({ deviceId: c.req.param("id") }, service.currentConfig, c.req.raw.signal);
+		c.header("Cache-Control", "no-store");
+		return c.json({
+			ok: true,
+			payload: { applications }
+		});
+	});
+	app.get("/api/phone/devices/:id/input-status", async (c) => {
+		const payload = await runtime.textInputStatus(c.req.param("id"), service.currentConfig, c.req.raw.signal);
+		c.header("Cache-Control", "no-store");
+		return c.json({
+			ok: true,
+			payload
+		});
+	});
 	app.post("/api/phone/devices", strictRateLimitMiddleware, async (c) => {
 		const input = deviceInput.parse(await c.req.json());
 		if (!(await runtime.discover(service.currentConfig, c.req.raw.signal)).some((device) => device.serial === input.serial && device.state === "device")) throw new PhoneError("PHONE_DEVICE_OFFLINE", "Choose a connected and authorized ADB device");
@@ -143,13 +169,15 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 		const id = c.req.param("id");
 		const previous = runtime.repository.get(id);
 		const patch = deviceInput.omit({ serial: true }).partial().parse(await c.req.json());
+		const next = normalizePhoneAppAccess({
+			...previous,
+			...patch,
+			...patch.allowedApps && patch.appAccess === void 0 ? { appAccess: "selected" } : {}
+		});
 		await runtime.stopDevice(id);
 		return c.json({
 			ok: true,
-			payload: runtime.repository.save({
-				...previous,
-				...patch
-			}, id)
+			payload: runtime.repository.save(next, id)
 		});
 	});
 	app.delete("/api/phone/devices/:id", strictRateLimitMiddleware, async (c) => {
@@ -173,6 +201,7 @@ function registerPhoneRoutes(parent, deps, runtime = getPhoneRuntime()) {
 				state: found?.state ?? "disconnected",
 				emulator: found?.emulator ?? false,
 				runner: "gateway-local",
+				appAccess: phoneAppAccess(device),
 				allowedApps: device.allowedApps
 			}
 		});

package/dist/src/gateway/hono/routes/projects.js

@@ -6,12 +6,12 @@ import { loadTranscriptRowsForSession } from "../../../storage/sqlite/transcript
 import { init_sqlite } from "../../../storage/sqlite/index.js";
 import { ActivityService } from "../../../activity/service.js";
 import "../../../activity/index.js";
+import { CapabilityError } from "../../../capabilities/runtime/errors.js";
+import "../../../capabilities/runtime/dispatcher.js";
 import { listKnowledgeItems, writeKnowledgeItem } from "../../../knowledge-memory/repository.js";
 import "../../../knowledge-memory/index.js";
 import { resolveEffectiveAgentProfile } from "../../../config/agent-profile.js";
 import { TaskReadModelProjector } from "../../../tasks/task-read-model-projector.js";
-import { CapabilityError } from "../../../capabilities/runtime/errors.js";
-import "../../../capabilities/runtime/dispatcher.js";
 import { ProjectWorkspaceConflictError, ProjectWorkspaceMissingError } from "../../../projects/workspace-project.js";
 import { inferProjectExecutionMode, inferProjectKind } from "../../../projects/project-kind.js";
 import { ProjectDeletionBlockedError, ProjectWorkspaceInUseError } from "../../../projects/project-service.js";

package/dist/src/gateway/hono/routes/public-gateway.js

@@ -2,8 +2,8 @@ import { PACKAGE_VERSION, init_package_version } from "../../../package-version.
 import { claimConnectorWebhookDelivery, completeConnectorWebhookDelivery, releaseConnectorWebhookDelivery } from "../../../storage/sqlite/connector-repository.js";
 import { init_sqlite } from "../../../storage/sqlite/index.js";
 import { resolveAutomationWebhookSecret } from "../../../automations/webhook-secrets.js";
-import { composioLogoResponse } from "../../../connectors/composio-logo.js";
 import { appendComposioTriggerEvent, applyComposioConnectionLifecycleEvent, normalizeComposioTriggerPayload, verifyComposioWebhook } from "../../../connectors/composio-triggers.js";
+import { composioLogoResponse } from "../../../connectors/composio-logo.js";
 import { serveStaticFile } from "../lib/static-ui.js";
 import { createHash, timingSafeEqual } from "node:crypto";
 //#region src/gateway/hono/routes/public-gateway.ts

package/dist/src/gateway/hono/routes/session-input-handler.js

@@ -5,9 +5,9 @@ import { endpointContextSchema } from "../../../../packages/gateway-contract/src
 import { parseUserTurnDocument, userTurnDocumentRefIds } from "../../../../packages/gateway-contract/src/user-turn-document.js";
 import { init_src } from "../../../../packages/gateway-contract/src/index.js";
 import { endpointTurnClaimSchema, init_src as init_src$1 } from "../../../../packages/endpoint-tools-protocol/src/index.js";
-import { init_providers, resolveModel } from "../../../providers/index.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
+import { init_providers, resolveModel } from "../../../providers/index.js";
 import { getModelThinking } from "../../../providers/model-thinking.js";
 import { parseTurnContextRefs } from "../../../agent/source-context/types.js";
 import { validateWebchatAttachments, validateWebchatContent } from "../../chat-limits.js";

package/dist/src/gateway/hono/routes/tasks.js

@@ -6,9 +6,9 @@ import { hasGatewayScope, init_gateway_scopes } from "../../security/gateway-sco
 import { enqueueTaskChangedEvent, init_task_change_events } from "../../../tasks/task-change-events.js";
 import { TaskRepository, init_task_repository } from "../../../tasks/task-repository.js";
 import { TaskRunRepository, init_task_run_repository } from "../../../tasks/task-run-repository.js";
-import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { CapabilityError } from "../../../capabilities/runtime/errors.js";
 import "../../../capabilities/runtime/dispatcher.js";
+import { TaskConversationRepository } from "../../../tasks/task-conversation-repository.js";
 import { TaskCollaborationRepository } from "../../../tasks/task-collaboration-repository.js";
 import { TaskCriterionReviewRepository } from "../../../tasks/task-criterion-review-repository.js";
 import { TaskContextMutationOutputSchema } from "../../../tasks/capabilities/relations.js";

package/dist/src/gateway/image-generation-setup.js

@@ -1,11 +1,11 @@
 import { normalizeAgentId } from "../agent-catalog/id.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
 import { init_agent_scope } from "../agent/agent-scope.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
 import { resolveEffectiveAgentConfigForAgent } from "../config/agent-profile.js";
 import { fetchWithTimeoutGuarded } from "../media-shared/http/provider-http.js";
 import "../media-shared/http/index.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { getImageGenerationProvider, listImageGenerationProvidersSummary } from "../agent/image/generation/provider-registry.js";
 //#region src/gateway/image-generation-setup.ts
 init_repository();

package/dist/src/gateway/service/session-input-coordinator.js

@@ -15,8 +15,8 @@ import { TaskApplicationService } from "../../tasks/task-application-service.js"
 import { injectSourceContextsIntoUserMessage } from "../../agent/source-context/injector.js";
 import { deleteMediaUrisNoLongerReferenced } from "../../media/session-references.js";
 import { fitSourceContextsToBudget } from "../../agent/source-context/budget.js";
-import { isDeepStrictEqual } from "node:util";
 import crypto from "node:crypto";
+import { isDeepStrictEqual } from "node:util";
 //#region src/gateway/service/session-input-coordinator.ts
 init_session_input_repository();
 init_connection_wait_repository();

package/dist/src/gateway/service.js

@@ -95,13 +95,6 @@ import { DiscussionSealer } from "../discussions/sealer.js";
 import "../discussions/index.js";
 import { EndpointToolRuntime } from "../endpoint-tools/runtime.js";
 import "../endpoint-tools/index.js";
-import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
-import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
-import "../knowledge/index.js";
-import { PersonalReplyComposer } from "../personal-agent/reply-composer.js";
-import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
-import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
-import { startConnectorSupervisor } from "../connectors/supervisor.js";
 import { HomeCapabilityPreflightService } from "../home-intelligence/capability-preflight.js";
 import { HomeAdviceGenerator } from "../home-intelligence/generator.js";
 import { HomeIntelligenceHost } from "../home-intelligence/host.js";
@@ -119,6 +112,8 @@ import { buildFileAgentContext } from "../agent/source-context/file-context.js";
 import { buildSessionAgentContext } from "../agent/source-context/session-context.js";
 import { buildBrowserTabAgentContext } from "../agent/source-context/browser-tab.js";
 import { WorkDiscoveryService } from "../work-discovery/service.js";
+import { PersonalReplyComposer } from "../personal-agent/reply-composer.js";
+import { ConnectionRecoveryService } from "../connectors/connection-recovery-service.js";
 import { buildVoiceMemoryContext } from "../voice/realtime/memory-context.js";
 import { buildVoicePersonaContext } from "../voice/realtime/persona-context.js";
 import { voiceMemoryBudget, voicePersonaBudget } from "../voice/realtime/conversation-context.js";
@@ -156,6 +151,10 @@ import { DurableVoiceAgentBroker } from "../voice/realtime/agentBroker.js";
 import { reconcileMemoryMaintenanceAutomations } from "./memory-maintenance-automation-reconciler.js";
 import { GatewayReadiness } from "./startup-readiness.js";
 import { createGatewayStartupTrace } from "./startup-trace.js";
+import { startConnectorSupervisor } from "../connectors/supervisor.js";
+import { startConnectedKnowledgeCoordinator } from "../knowledge/coordinator.js";
+import "../knowledge/index.js";
+import { startConnectorLearningCoordinator } from "../connectors/learning-coordinator.js";
 import { TaskCollaborationDelivery } from "../tasks/task-collaboration-delivery.js";
 import { TaskMainUpdateExhaustedError } from "../tasks/task-main-update-retry.js";
 import { TaskMainUpdateDelivery } from "../tasks/task-main-update-delivery.js";
@@ -163,6 +162,7 @@ import { allowsPersonalTaskNotification, personalReplyNotification, personalRunD
 import { TaskMainUpdateDecisionService } from "../tasks/task-main-update-decision-service.js";
 import { selectTaskMainUpdateAttempt, submitAndConfirmTaskMainUpdate } from "../tasks/task-main-update-input.js";
 import { checkAppContextAccess, prepareAppContext } from "./service/app-context-access.js";
+import { ManagedComposioEventPoller } from "../connectors/composio-managed-events.js";
 import { applyAutomaticVoiceLanguage, inferProductLanguageFromEnvironment, initializeVoiceDefaults } from "../voice/language-profile.js";
 import crypto from "node:crypto";
 //#region src/gateway/service.ts

package/dist/src/gateway/xopc-cloud-capability-setup.js

@@ -1,13 +1,13 @@
 import "../agent-config/schema.js";
 import { init_agent_config } from "../agent-config/index.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { ConfigSchema, init_schema } from "../config/schema.js";
 import { init_model_policy, isComputerModel, isDedicatedComputerProfile } from "../computer/model-policy.js";
 import { voiceSupportsMode } from "../../packages/realtime-protocol/src/voice-catalog.js";
 import { init_voice } from "../../packages/realtime-protocol/src/voice.js";
 import { getModelCatalogStore, init_model_catalog_store } from "../providers/model-catalog-store.js";
 import { compareCatalogModels } from "../providers/model-catalog-ranking.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { prepareUpdateGlobalDefaults } from "./global-defaults-admin.js";
 //#region src/gateway/xopc-cloud-capability-setup.ts
 init_voice();

package/dist/src/imports/importService.js

@@ -11,8 +11,8 @@ import { scanLocal } from "./scanner.js";
 import { dirname, join } from "node:path";
 import { existsSync, lstatSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
-import lockfile from "proper-lockfile";
 import yaml from "js-yaml";
+import lockfile from "proper-lockfile";
 //#region src/imports/importService.ts
 init_write_file_atomic();
 init_logger();

package/dist/src/infra/unhandled-rejections.js

@@ -1,8 +1,8 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_global_singleton, resolveGlobalSingleton } from "../utils/global-singleton.js";
-import { init_process_diagnostics, recordProcessDiagnostic } from "./process-diagnostics.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_global_singleton, resolveGlobalSingleton } from "../utils/global-singleton.js";
+import { init_process_diagnostics, recordProcessDiagnostic } from "./process-diagnostics.js";
 import { init_sqlite_errors, isTransientSqliteError } from "./sqlite-errors.js";
 //#region src/infra/unhandled-rejections.ts
 function installSqliteTransientRejectionHandler() {

package/dist/src/infra/update-restart.js

@@ -2,8 +2,8 @@ import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
 import { init_paths, resolveConfigPath } from "../config/paths.js";
 import { loadConfig } from "../config/loader.js";
-import { isRestartEnabled } from "../config/commands.flags.js";
 import { resolveGatewayService } from "../daemon/service.js";
+import { isRestartEnabled } from "../config/commands.flags.js";
 import { authorizeGatewaySigusr1Restart, writeGatewayRestartIntentSync } from "./restart.js";
 import { findVerifiedGatewayListenerPidsOnPortSync, signalVerifiedGatewayPidSync } from "./gateway-processes.js";
 import { refreshGatewayServiceAfterUpdate } from "./update-service-refresh.js";

package/dist/src/local-apps/service.js

@@ -5,10 +5,10 @@ import { init_logger } from "../utils/logger.js";
 import { afterSqliteCommit, init_transaction, runSqliteWriteTransaction } from "../storage/sqlite/transaction.js";
 import { ExtensionCapabilityBindingsSchema, extensionCapabilityPermissions } from "../../packages/gateway-contract/src/extension-capabilities.js";
 import { init_src } from "../../packages/gateway-contract/src/index.js";
+import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { slugifyProjectName } from "../projects/project-store.js";
 import { LocalAppStore } from "./store.js";
-import { CapabilityError } from "../capabilities/runtime/errors.js";
 import { DomainOutboxDispatcher } from "../infra/domain-outbox-dispatcher.js";
 import { validateLocalAppCapabilityContracts } from "./capabilities/contracts.js";
 import { buildLocalAppFixGuidance } from "./fix-guidance.js";

package/dist/src/personal-agent/prompts.js

@@ -5,7 +5,7 @@ import { PERSONAL_REPLY_EXAMPLES, PERSONAL_REPLY_STYLE_RULES } from "./reply-sty
 //#region src/personal-agent/prompts.ts
 const DELEGATION_RULES = [
 	"Answer directly when your capabilities suffice. Otherwise call personal_task(command=\"submit\") with a short objective. For a self-contained current request send {command:\"submit\", objective:\"short outcome\", useOriginalRequest:true}; command is required. With this mode, the host copies its entire stored text, including exact constraints. Preserve sourceRefs and explicitly requested Agent/Skills. Use a concise complete description instead when earlier conversation must be synthesized. Submit before reading materials. The background Task Router selects and starts the executor. After the tool succeeds, reply only with a short confirmation such as \"Submitted; I will report the result here.\" in the conversation language, then finish. Do not restate any task details, files, requirements or acceptance criteria, and do not wait for the worker. Remain available for conversation.",
-	"Reuse the existing Task. Inspect get/list only when status is needed; updates and results arrive automatically. Read full questions with get/entry (follow nextBodyOffset); use collaboration/afterSequence for older messages. Use instruct for new direction and answer with the exact questionId for a worker question, resolving it from the brief or conversation first. If you asked the user a worker question, deliver their next answer to that question on this same Task. Do not just acknowledge it in chat. Report saved, delivered and executor-confirmed separately; do not wait or poll for acknowledgement. The final result must reflect the latest direction and disclose anything unconfirmed or unmet. retry_allocation retries selection before execution; inspect previous effects before retrying an execution.",
+	"Reuse the existing Task. Inspect get/list only when status is needed; updates and results arrive automatically. Read full questions with get/entry (follow nextBodyOffset); use collaboration/afterSequence for older messages. For running work send {command:\"instruct\", taskId, instruction} directly for new direction; no baseline lookup is needed. Use revise only after completion with an actual returned result baseline; a missing baseline means use instruct, never fabricate baselineResultId/baselineVersion. Use answer with the exact questionId for a worker question, resolving it from the brief or conversation first. If you asked the user a worker question, deliver their next answer to that question on this same Task. Do not just acknowledge it in chat. Report saved, delivered and executor-confirmed separately; do not wait or poll for acknowledgement. The final result must reflect the latest direction and disclose anything unconfirmed or unmet. retry_allocation retries selection before execution; inspect previous effects before retrying an execution.",
 	"For current news or other live facts, require dated sources in the brief. For recurring work, specify the required automation capability. Report actual allocation, execution and verification states; do not treat submission as execution or a successful run as accepted completion."
 ];
 const TASK_BRIEF_RULE = "When useOriginalRequest=true, keep objective to one short outcome (not a list of files or requirements), and omit description and redundant structured fields; the host copies the complete current input, so do not rewrite or summarize away its constraints. For a context-dependent request, prepare the Task brief by preserving the user request, not by planning the execution. For a straightforward request, use one short paragraph or a few bullets, usually no longer than the user request. Preserve all requested inputs, outputs, permissions and verification. Do not invent extra analyses, edge cases, steps, files or constraints; the worker plans and inspects the data. Default submit fields are objective and description, plus a short title when useful. Omit requirements, expectedOutputs, acceptanceCriteria and constraints when they only repeat the description; use requiredSkills or requirements.requestedAgentId only for an explicit user instruction. Preserve long or exact user specifications completely.";

package/dist/src/personal-agent/service.js

@@ -2,13 +2,13 @@ import { getSessionMetadata } from "../storage/sqlite/session-read-repository.js
 import { init_session_repository, patchSessionMetadata } from "../storage/sqlite/session-repository.js";
 import { init_config_repository, setSessionConfig } from "../storage/sqlite/config-repository.js";
 import { AgentCatalogRepository, init_repository } from "../agent-catalog/repository.js";
+import { AgentCatalogService } from "../agent-catalog/service.js";
 import { createConversation, init_conversation_repository } from "../storage/sqlite/conversation-repository.js";
 import { getAvailableModels, init_providers } from "../providers/index.js";
 import { getPersonalAgent, personalAgentId } from "./repository.js";
 import { PERSONAL_MAIN_TOOL_IDS, PERSONAL_READ_TOOL_ALIASES } from "./policy.js";
 import { getModelThinking } from "../providers/model-thinking.js";
 import { personalInstructions } from "./prompts.js";
-import { AgentCatalogService } from "../agent-catalog/service.js";
 import { completePersonalOnboarding } from "./onboarding.js";
 import { z } from "zod";
 //#region src/personal-agent/service.ts

package/dist/src/phone/adb-driver.d.ts

@@ -1,4 +1,4 @@
-import { type DiscoveredPhone, type PhoneAction, type PhoneElement, type PhoneObservation } from './contracts.js';
+import { type PhoneApplication, type PhoneTextInputStatus, type DiscoveredPhone, type PhoneAction, type PhoneElement, type PhoneObservation } from './contracts.js';
 export declare function resolveAdbPath(configured?: string, stateDir?: string): string;
 export declare function runAdb(path: string, args: string[], signal?: AbortSignal, timeout?: number): Promise<Buffer>;
 export declare function parseAdbDevices(text: string): DiscoveredPhone[];
@@ -6,6 +6,8 @@ export declare function parsePhoneUi(xml: string): PhoneElement[];
 export declare function parseAndroidLayout(raw: string): PhoneElement[];
 export interface PhoneDriver {
     discover(signal?: AbortSignal): Promise<DiscoveredPhone[]>;
+    applications?(serial: string, signal: AbortSignal): Promise<PhoneApplication[]>;
+    textInputStatus?(serial: string, signal: AbortSignal): Promise<PhoneTextInputStatus>;
     observe(serial: string, signal: AbortSignal): Promise<PhoneObservation>;
     capture?(serial: string, signal: AbortSignal): Promise<PhoneObservation>;
     observeForText?(serial: string, signal: AbortSignal): Promise<PhoneObservation>;
@@ -20,14 +22,19 @@ export declare class AdbPhoneDriver implements PhoneDriver {
     private readonly adbPath;
     private readonly command;
     private readonly useAndroidCli;
-    constructor(adbPath?: string, command?: typeof runAdb, useAndroidCli?: boolean);
+    private readonly readApplications?;
+    private readonly pasteText?;
+    constructor(adbPath?: string, command?: typeof runAdb, useAndroidCli?: boolean, readApplications?: (signal: AbortSignal) => Promise<PhoneApplication[]>, pasteText?: (text: string, signal: AbortSignal) => Promise<void>);
+    textInputStatus(serial: string, signal: AbortSignal): Promise<PhoneTextInputStatus>;
     discover(signal?: AbortSignal): Promise<DiscoveredPhone[]>;
+    applications(serial: string, signal: AbortSignal): Promise<PhoneApplication[]>;
     foreground(serial: string, signal: AbortSignal): Promise<string>;
     private shell;
     observe(serial: string, signal: AbortSignal): Promise<PhoneObservation>;
     observeForText(serial: string, signal: AbortSignal): Promise<PhoneObservation>;
     /** Pixel capture avoids accessibility dumps on the human interaction path. */
     capture(serial: string, signal: AbortSignal): Promise<PhoneObservation>;
+    private confirmText;
     execute(serial: string, action: PhoneAction, observation: PhoneObservation, signal: AbortSignal, options?: {
         settleMs: number;
         resetTask?: boolean;

package/dist/src/phone/adb-driver.js

@@ -1,6 +1,8 @@
 import { PhoneError, init_contracts } from "./contracts.js";
 import { runPhoneCommandBuffer, runPhoneCommandText } from "../process/phone-process.js";
 import { managedPhoneAdbPath } from "../runtime-tools/phone-dependency-catalog.js";
+import { readScrcpyServer, scrcpyServerPath } from "./scrcpy-assets.js";
+import { parsePhoneApplications, phoneApplicationsCommand } from "./applications.js";
 import { homedir } from "node:os";
 import { delimiter, join } from "node:path";
 import { existsSync } from "node:fs";
@@ -130,15 +132,57 @@ function parseAndroidFocusedEditor(raw, app) {
 		};
 	}
 }
+function sameTextEditor(target, node) {
+	return node.focused && Boolean(node.editable) && !node.password && (target.resourceId ? node.resourceId === target.resourceId : node.bounds.every((value, index) => value === target.bounds[index]));
+}
 var AdbPhoneDriver = class {
-	constructor(adbPath = resolveAdbPath(), command = runAdb, useAndroidCli = true) {
+	constructor(adbPath = resolveAdbPath(), command = runAdb, useAndroidCli = true, readApplications, pasteText) {
 		this.adbPath = adbPath;
 		this.command = command;
 		this.useAndroidCli = useAndroidCli;
+		this.readApplications = readApplications;
+		this.pasteText = pasteText;
+	}
+	async textInputStatus(serial, signal) {
+		const androidSdk = Number((await this.shell(serial, ["getprop", "ro.build.version.sdk"], signal)).trim()) || 0;
+		let ready = false;
+		try {
+			await readScrcpyServer();
+			ready = true;
+		} catch {
+			signal.throwIfAborted();
+		}
+		return {
+			androidSdk,
+			unicode: androidSdk < 24 ? "unsupported" : ready ? "available" : "setup_required",
+			method: "scrcpy-clipboard",
+			keyboardRequired: false
+		};
 	}
 	async discover(signal) {
 		return parseAdbDevices((await this.command(this.adbPath, ["devices", "-l"], signal)).toString());
 	}
+	async applications(serial, signal) {
+		if (this.readApplications) return this.readApplications(signal);
+		await readScrcpyServer();
+		const remote = `/data/local/tmp/xopc-apps-${randomUUID()}.jar`;
+		try {
+			await this.command(this.adbPath, [
+				"-s",
+				serial,
+				"push",
+				scrcpyServerPath(),
+				remote
+			], signal);
+			return parsePhoneApplications(await this.shell(serial, phoneApplicationsCommand(remote), signal));
+		} finally {
+			await this.shell(serial, [
+				"rm",
+				"-f",
+				remote
+			], AbortSignal.timeout(3e3)).catch(() => {});
+		}
+	}
 	async foreground(serial, signal) {
 		const activity = await this.shell(serial, [
 			"sh",
@@ -261,6 +305,21 @@ var AdbPhoneDriver = class {
 			throw error;
 		}
 	}
+	async confirmText(serial, app, target, matches, signal) {
+		for (let attempt = 0; attempt < 3; attempt++) {
+			await setTimeout(150, void 0, { signal });
+			const after = await this.observe(serial, signal);
+			try {
+				if (after.package !== app) break;
+				const candidates = after.elements.filter((node) => target.resourceId === "android:active-editor" ? node.focused && node.editable && !node.password : sameTextEditor(target, node));
+				if (candidates.length === 1 && matches(candidates[0].text)) return;
+				if (candidates.length !== 1) break;
+			} finally {
+				after.frame.fill(0);
+			}
+		}
+		throw new PhoneError("PHONE_TEXT_INPUT_UNCONFIRMED", "Text was sent but the target field value could not be verified. Take over and inspect the input field before retrying.", 409);
+	}
 	async execute(serial, action, observation, signal, options) {
 		const point = ([x, y]) => [String(Math.min(observation.width - 1, Math.round(x * observation.width / 1e3))), String(Math.min(observation.height - 1, Math.round(y * observation.height / 1e3)))];
 		const input = (args) => this.shell(serial, ["input", ...args], signal);
@@ -310,47 +369,64 @@ var AdbPhoneDriver = class {
 					String(action.durationMs)
 				]);
 				break;
-			case "typeText":
-				if (!observation.elements.some((node) => node.focused && node.editable && !node.password)) throw new PhoneError("PHONE_INPUT_NOT_FOCUSED", "Focus a non-password editable field before typing");
-				if (/^[a-zA-Z0-9 .,_@+-]+$/.test(action.text) && !action.text.includes("%")) await input(["text", action.text.replaceAll(" ", "%s")]);
-				else {
-					const previous = (await this.shell(serial, [
-						"settings",
-						"get",
-						"secure",
-						"default_input_method"
-					], signal)).trim();
-					const keyboard = "com.android.adbkeyboard/.AdbIME";
-					if (!(await this.shell(serial, [
-						"ime",
-						"list",
-						"-s"
-					], signal)).split(/\s+/).includes(keyboard)) throw new PhoneError("PHONE_KEYBOARD_REQUIRED", "Unicode input requires ADB Keyboard. Install and enable it on the device first.");
+			case "typeText": {
+				const editors = observation.elements.filter((node) => node.focused && node.editable && !node.password);
+				if (editors.length !== 1) throw new PhoneError("PHONE_INPUT_NOT_FOCUSED", "Focus one non-password editable field before typing");
+				const ascii = /^[a-zA-Z0-9 .,_@+-]+$/.test(action.text) && !action.text.includes("%");
+				if (!ascii) {
+					if ((await this.textInputStatus(serial, signal)).unicode !== "available") throw new PhoneError("PHONE_TEXT_INPUT_UNAVAILABLE", "Automatic text input is unavailable. Check Phone settings or take over and type with the phone keyboard.", 409);
+				}
+				let target = editors[0];
+				if (action.mode === "replace") {
+					if (target.resourceId === "android:active-editor") throw new PhoneError("PHONE_TEXT_INPUT_UNAVAILABLE", "Replacing text requires a visible editable field. Take over and inspect the field.", 409);
+					const fresh = await this.observe(serial, signal);
 					try {
-						await this.shell(serial, [
-							"ime",
-							"set",
-							keyboard
-						], signal);
-						const result = await this.shell(serial, [
-							"am",
-							"broadcast",
-							"-a",
-							"ADB_INPUT_B64",
-							"--es",
-							"msg",
-							Buffer.from(action.text).toString("base64")
-						], signal);
-						if (!/Broadcast completed/.test(result)) throw new PhoneError("PHONE_INPUT_FAILED", "Keyboard input was not acknowledged");
+						const current = fresh.elements.filter((node) => sameTextEditor(target, node));
+						if (fresh.package !== observation.package || current.length !== 1) throw new PhoneError("PHONE_INPUT_NOT_FOCUSED", "The focused input field changed before replacement", 409);
+						target = current[0];
 					} finally {
-						if (/^[\w.]+\/[\w.$]+$/.test(previous)) await this.shell(serial, [
-							"ime",
-							"set",
-							previous
-						], AbortSignal.timeout(3e3));
+						fresh.frame.fill(0);
+					}
+					if (target.text) {
+						if (!(await this.shell(serial, ["input"], signal)).includes("keycombination")) throw new PhoneError("PHONE_TEXT_INPUT_UNAVAILABLE", "This phone cannot safely select all text. Take over and replace the field manually.", 409);
+						try {
+							await input([
+								"keycombination",
+								"KEYCODE_CTRL_LEFT",
+								"KEYCODE_A"
+							]);
+							const selected = await this.observe(serial, signal);
+							try {
+								if (selected.package !== observation.package || selected.elements.filter((node) => sameTextEditor(target, node) && node.text === target.text).length !== 1) throw new Error("Editor changed during selection");
+							} finally {
+								selected.frame.fill(0);
+							}
+						} catch {
+							signal.throwIfAborted();
+							throw new PhoneError("PHONE_TEXT_INPUT_UNCONFIRMED", "Text selection started but the target field could not be verified. Take over and inspect the input field before retrying.", 409);
+						}
 					}
 				}
+				try {
+					if (ascii) await input(["text", action.text.replaceAll(" ", "%s")]);
+					else if (this.pasteText) await this.pasteText(action.text, signal);
+					else {
+						const { LocalScrcpyProvider } = await import("./scrcpy.js");
+						const provider = new LocalScrcpyProvider(this.adbPath, serial, () => {}, void 0, true);
+						try {
+							await provider.pasteText(action.text, signal);
+						} finally {
+							await provider.close();
+						}
+					}
+					await this.confirmText(serial, observation.package, target, (text) => action.mode === "replace" ? text === action.text : text.includes(action.text), signal);
+				} catch (error) {
+					signal.throwIfAborted();
+					if (error instanceof PhoneError && error.code === "PHONE_TEXT_INPUT_UNCONFIRMED") throw error;
+					throw new PhoneError("PHONE_TEXT_INPUT_UNCONFIRMED", "Text may have been sent but insertion could not be verified. Take over and inspect the input field before retrying.", 409);
+				}
 				break;
+			}
 			case "home":
 				await input(["keyevent", "KEYCODE_HOME"]);
 				break;

package/dist/src/phone/app-access.d.ts

@@ -0,0 +1,10 @@
+export type PhoneAppAccess = {
+    appAccess?: 'all' | 'selected';
+    allowedApps: string[];
+};
+/** Preserve legacy allowlists while new connections default to all applications. */
+export declare function phoneAppAccess(device: PhoneAppAccess): 'all' | 'selected';
+export declare function phoneAllowsApp(device: PhoneAppAccess, application: string): boolean;
+export declare function normalizePhoneAppAccess<T extends PhoneAppAccess>(device: T): T & {
+    appAccess: 'all' | 'selected';
+};

package/dist/src/phone/app-access.js

@@ -0,0 +1,21 @@
+import { PhoneError, init_contracts } from "./contracts.js";
+//#region src/phone/app-access.ts
+init_contracts();
+/** Preserve legacy allowlists while new connections default to all applications. */
+function phoneAppAccess(device) {
+	return device.appAccess ?? (device.allowedApps.length ? "selected" : "all");
+}
+function phoneAllowsApp(device, application) {
+	return phoneAppAccess(device) === "all" || device.allowedApps.includes(application);
+}
+function normalizePhoneAppAccess(device) {
+	const appAccess = phoneAppAccess(device);
+	if (appAccess === "selected" && !device.allowedApps.length) throw new PhoneError("PHONE_APPS_REQUIRED", "Select at least one application");
+	return {
+		...device,
+		appAccess,
+		allowedApps: appAccess === "all" ? [] : [...new Set(device.allowedApps)]
+	};
+}
+//#endregion
+export { normalizePhoneAppAccess, phoneAllowsApp, phoneAppAccess };

package/dist/src/phone/applications.d.ts

@@ -0,0 +1,4 @@
+import { type PhoneApplication } from './contracts.js';
+export declare function phoneApplicationsCommand(remote: string): string[];
+/** Parse the pinned scrcpy server's app list, including wrapped long labels. */
+export declare function parsePhoneApplications(raw: string): PhoneApplication[];

package/dist/src/phone/applications.js

@@ -0,0 +1,49 @@
+import { PhoneError, init_contracts } from "./contracts.js";
+import { SCRCPY_VERSION } from "../runtime-tools/phone-dependency-catalog.js";
+//#region src/phone/applications.ts
+init_contracts();
+const packageName = /^[a-zA-Z]\w*(?:\.\w+)+$/;
+function phoneApplicationsCommand(remote) {
+	return [
+		"env",
+		`CLASSPATH=${remote}`,
+		"app_process",
+		"/",
+		"com.genymobile.scrcpy.Server",
+		SCRCPY_VERSION,
+		"list_apps=true",
+		"video=false",
+		"audio=false",
+		"control=false"
+	];
+}
+/** Parse the pinned scrcpy server's app list, including wrapped long labels. */
+function parsePhoneApplications(raw) {
+	const text = raw.replace(/\u001b\[[\d;]*m/g, "");
+	if (text.length > 1024 * 1024 || !text.includes("List of apps:")) throw new PhoneError("PHONE_APPS_UNAVAILABLE", "Unable to read the phone application list. Check the phone connection and scrcpy dependency.");
+	const apps = /* @__PURE__ */ new Map();
+	let pending;
+	for (const line of text.split(/\r?\n/)) {
+		const entry = /^\s*[*-]\s+(.+)$/.exec(line);
+		if (entry) {
+			const match = /^(.*?)\s+([a-zA-Z]\w*(?:\.\w+)+)$/.exec(entry[1].trim());
+			if (match) {
+				pending = void 0;
+				apps.set(match[2], {
+					packageName: match[2],
+					label: match[1].trim().slice(0, 120) || match[2]
+				});
+			} else pending = entry[1].trim().slice(0, 120);
+		} else if (pending && packageName.test(line.trim())) {
+			apps.set(line.trim(), {
+				packageName: line.trim(),
+				label: pending
+			});
+			pending = void 0;
+		}
+		if (apps.size > 500) throw new PhoneError("PHONE_APPS_LIMIT", "Phone application list exceeds 500 entries");
+	}
+	return [...apps.values()].sort((a, b) => a.label.localeCompare(b.label));
+}
+//#endregion
+export { parsePhoneApplications, phoneApplicationsCommand };