@testin-official/xagent 0.3.7

package/README.md

@@ -0,0 +1,157 @@
+# XAgent CLI
+
+XAgent CLI is the local client for the XAgent Developer Public API. It runs on developer machines and CI runners; it is not a second cloud task service.
+
+## Component boundary
+
+```text
+Local terminal / CI / local Agent
+  -> xagent CLI and MCP
+  -> HTTPS Developer Public API
+  -> test-agent-service
+  -> Redis / Go exec / cloud device
+```
+
+This repository owns local commands, Profile and credential handling, local YAML validation, the shared HTTP SDK, machine-readable output, exit codes, MCP adapters, packaging, and release artifacts. It must not import Flask applications, server DAOs, Redis clients, task services, or device-internal protocols.
+
+The server repository `D:\Py\test-agent-service` owns authentication authority, Developer Token storage, Principal resolution, public API routes, resource authorization, Run orchestration, task dispatch, persistence, and report mapping. The Go executor repository `D:\Py\exec` owns strict consumption of the agreed queue protocol.
+
+## Current source layout
+
+```text
+src/                 TypeScript CLI, SDK, MCP, Script and local Draft implementation
+tests/               contract, stdio and behavior tests
+contracts/           synchronized public contract snapshot
+skills/              packaged Skill documents and References
+```
+
+The authoritative public contract is maintained in `D:\Py\test-agent-service\contracts\developer\v1`. Files under this repository's `contracts/` directory are release inputs synchronized from that source; client agents must not change their semantics independently.
+
+The cross-component product and system design documents remain under `D:\Py\test-agent-service-dev1.1\docs\xagent-cli`; its repository-routing table determines which project each implementation task may modify.
+
+## Run scripts
+
+Personal Runs use `package_id` from YAML or `--package-id` to select an existing
+platform APK. Project CI Runs can instead upload the APK built from the current
+commit and pass the returned temporary ID to `run`.
+
+```powershell
+xagent run D:\Py\xagent-cli\examples\existing-app-smoke.yaml --device-id DEVICE_ID
+xagent run D:\Py\xagent-cli\examples\smoke.yaml --device-id DEVICE_ID
+xagent run D:\Py\xagent-cli\examples\smoke.yaml --package-id OTHER_PACKAGE_ID --device-id DEVICE_ID
+```
+
+Project CI flow:
+
+```powershell
+xagent init --base-url https://xagent.example --upload-base-url https://files.example --token-type project_ci --name ci --token-env XAGENT_CI_TOKEN
+xagent --json --profile ci apps upload .\app-debug.apk
+xagent --json --profile ci --config .\xagent.yaml run .\tests\smoke.yaml --target android-single --app-upload-id APP_UPLOAD_ID --idempotency-key PIPELINE_KEY --wait
+xagent --json --profile ci apps release APP_UPLOAD_ID
+```
+
+File-service upload requests default to a 15-minute timeout. Override it when needed with
+`xagent apps upload .\app-debug.apk --upload-timeout 900` or
+`xagent run tests\smoke.yaml --apk .\app-debug.apk --device-id DEVICE_001 --upload-timeout 900`.
+
+`apps upload` and `apps release` require a newly issued `project_ci` Token with
+the `app:upload` capability. One upload can be bound to one Run. Release is
+idempotent and should run from CI cleanup (`after_script` / `finally`).
+The Profile's `upload_base_url` points to the file service. The CLI sends the
+same Developer Token only to `/app/ci/init`; chunk requests use a short-lived
+upload ticket and never persist the Token in project files.
+
+## Development
+
+The supported runtime and build path is Node.js 18 or later. No Python runtime,
+PyInstaller or platform compiler is needed to build the customer package.
+
+```powershell
+Set-Location D:\Py\xagent-cli
+npm ci
+npm run check
+node .\dist\cli.js --json version
+node .\dist\cli.js --json validate .\examples\smoke.yaml
+npm pack --dry-run
+```
+
+`npm run check` runs the synchronized contract fixtures, Target hash checks,
+local Draft persistence tests and a real MCP stdio `initialize` / `tools/list`
+exchange.
+
+## npm installation
+
+The customer-facing installation package is the single package `@testin-official/xagent`.
+It contains the compiled TypeScript CLI, MCP server, synchronized public schemas,
+Skills and References. It does not download a platform-specific binary package
+and does not contain Python source.
+
+```text
+npm install --global @testin-official/xagent
+xagent --json version
+```
+
+## Agent Host Skill and routing
+
+The npm package is the execution client. Customers also receive one complete
+external `xagent-skill` directory that can be imported directly into an Agent
+Host. It discovers XAgent and routes one request to one isolated MCP domain:
+
+```powershell
+xagent integrations install codex
+xagent integrations doctor --host codex
+xagent --json integrations options
+xagent --json integrations route author --profile personal
+```
+
+The default `xagent-local` MCP remains `action`. It is a long-lived stateful
+device-control process that owns the current device Session, screen evidence,
+pre-action renewal checks, and graceful-shutdown release. An idle MCP process
+does not renew a Session in the background. Do not replace it with setup mode.
+The Skill must tell the user this default and present the behavior choices
+before any side-effect route is selected.
+
+The route is explicit and one-to-one:
+
+```text
+setup   -> mcp --mode setup   -> xagent-cli
+action  -> mcp --mode action  -> xagent-explore-device
+author  -> mcp --mode author  -> xagent-author-test
+run     -> mcp --mode run     -> xagent-run-test
+analyze -> mcp --mode analyze -> xagent-analyze-failure
+repair  -> mcp --mode repair  -> xagent-repair-test
+report  -> mcp --mode report  -> xagent-test-report
+```
+
+The same route is available without Shell through setup MCP's local
+`xagent_workflow_route` Tool. Each MCP process exposes one domain only; changing
+domains requires restarting it with the new explicit `--mode`. A mode can load
+only its mapped Skill, and a failed Skill load must stop all device, upload,
+Authoring, Run, and report side effects.
+
+`xagent integrations install` writes only XAgent's own Skill files. It does
+not overwrite an existing Host configuration or write Developer Tokens. The
+integration package can be prepared for a market or GitLab Release with:
+
+```powershell
+npm run package:integrations
+```
+
+The generated versioned Skill directory and ZIP are under `release/` and are
+intended to be published as static Release assets, not served by a runtime API.
+The ZIP extracts with `SKILL.md` at its root. The npm package and the Skill ZIP
+are separate artifacts: the former executes requests, while the latter is the
+Agent Host entry and routing contract.
+
+The same package runs on Windows, Linux and macOS on x64 or arm64 with Node.js 20.9
+or later. Interactive saved credentials use the operating system credential
+store through a prebuilt N-API adapter; CI Profiles continue to use explicitly
+named environment variables. Downstream CI jobs install from npm and are never
+granted permission to clone this repository.
+
+GitLab runs the TypeScript tests and build once on Linux, then produces the same
+npm tarball for every supported operating system. Publishing is manual and
+requires a masked `NPM_TOKEN`; no Windows Runner is required.
+
+Migration boundaries, Agent Host integration and platform limitations are
+documented in `docs/typescript-migration.md`.

package/dist/action/client.d.ts

@@ -0,0 +1,13 @@
+import type { XAgentClient } from "../sdk/client.js";
+export declare class DeviceActionClient {
+    private readonly client;
+    constructor(client: XAgentClient);
+    acquireDevice(deviceId: string, idempotencyKey: string): Promise<Record<string, any>>;
+    getSession(sessionId: string): Promise<Record<string, any>>;
+    renewSession(sessionId: string): Promise<Record<string, any>>;
+    observe(sessionId: string): Promise<Record<string, any>>;
+    executeAction(sessionId: string, request: Record<string, unknown>, idempotencyKey: string): Promise<Record<string, any>>;
+    release(sessionId: string, idempotencyKey: string): Promise<Record<string, any>>;
+    cancel(sessionId: string, idempotencyKey: string): Promise<Record<string, any>>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/action/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/action/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IACjD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IAGtD,UAAU,CAAC,SAAS,EAAE,MAAM;IAG5B,YAAY,CAAC,SAAS,EAAE,MAAM;IAG9B,OAAO,CAAC,SAAS,EAAE,MAAM;IAGzB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,EAAE,MAAM;IAGzF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IAGjD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;CAGjD"}

package/dist/action/client.js

@@ -0,0 +1,28 @@
+export class DeviceActionClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    acquireDevice(deviceId, idempotencyKey) {
+        return this.client.request("POST", "/agent/api/developer/v1/device-control/devices/acquire", { json: { device_id: deviceId }, idempotencyKey, timeoutMs: 90_000 });
+    }
+    getSession(sessionId) {
+        return this.client.request("GET", `/agent/api/developer/v1/device-control/sessions/${encodeURIComponent(sessionId)}`);
+    }
+    renewSession(sessionId) {
+        return this.client.request("POST", `/agent/api/developer/v1/device-control/sessions/${encodeURIComponent(sessionId)}/renew`, { json: {}, timeoutMs: 90_000 });
+    }
+    observe(sessionId) {
+        return this.client.request("GET", `/agent/api/developer/v1/device-control/sessions/${encodeURIComponent(sessionId)}/observe`, { timeoutMs: 90_000 });
+    }
+    executeAction(sessionId, request, idempotencyKey) {
+        return this.client.request("POST", `/agent/api/developer/v1/device-control/sessions/${encodeURIComponent(sessionId)}/actions`, { json: request, idempotencyKey, timeoutMs: 300_000 });
+    }
+    release(sessionId, idempotencyKey) {
+        return this.client.request("POST", `/agent/api/developer/v1/device-control/sessions/${encodeURIComponent(sessionId)}/release`, { json: {}, idempotencyKey, timeoutMs: 90_000 });
+    }
+    cancel(sessionId, idempotencyKey) {
+        return this.release(sessionId, idempotencyKey);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/action/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/action/client.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IACrD,aAAa,CAAC,QAAgB,EAAE,cAAsB;QACpD,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,wDAAwD,EAAE,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACrK,CAAC;IACD,UAAU,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,mDAAmD,kBAAkB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACxH,CAAC;IACD,YAAY,CAAC,SAAiB;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,mDAAmD,kBAAkB,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAChK,CAAC;IACD,OAAO,CAAC,SAAiB;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,mDAAmD,kBAAkB,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACvJ,CAAC;IACD,aAAa,CAAC,SAAiB,EAAE,OAAgC,EAAE,cAAsB;QACvF,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,mDAAmD,kBAAkB,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACxL,CAAC;IACD,OAAO,CAAC,SAAiB,EAAE,cAAsB;QAC/C,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,mDAAmD,kBAAkB,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IAClL,CAAC;IACD,MAAM,CAAC,SAAiB,EAAE,cAAsB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/action/mcp-content.d.ts

@@ -0,0 +1,2 @@
+export declare function actionMcpContent(toolName: string, result: Record<string, any>): Promise<Array<Record<string, string>>>;
+//# sourceMappingURL=mcp-content.d.ts.map

package/dist/action/mcp-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-content.d.ts","sourceRoot":"","sources":["../../src/action/mcp-content.ts"],"names":[],"mappings":"AAkEA,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CA8B5H"}

package/dist/action/mcp-content.js

@@ -0,0 +1,116 @@
+import { XAgentApiError } from "../core/errors.js";
+import sharp from "sharp";
+const MAX_IMAGE_BYTES = 15 * 1024 * 1024;
+const MAX_MCP_IMAGE_BYTES = 200 * 1024;
+const JPEG_QUALITIES = [82, 78, 74, 70, 66, 62, 58];
+const IMAGE_TYPES = new Set(["image/png", "image/jpeg", "image/webp"]);
+function textFor(toolName, result) {
+    const consoleUrl = result.session?.console_url;
+    if (toolName === "xagent_device_acquire" && typeof consoleUrl === "string" && consoleUrl.trim()) {
+        return `Device observation console URL (valid for this Session): ${consoleUrl}\n${JSON.stringify(result)}`;
+    }
+    return JSON.stringify(result);
+}
+function observationFor(toolName, result) {
+    if (toolName === "xagent_device_acquire")
+        return result.observation;
+    if (toolName === "xagent_device_observe")
+        return result;
+    if (toolName === "xagent_device_action")
+        return result.after_observation ?? undefined;
+    return undefined;
+}
+function assertImageUrl(value) {
+    if (typeof value !== "string")
+        throw new XAgentApiError("invalid_response", "Device observation has no screenshot URL");
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new XAgentApiError("invalid_response", "Device observation screenshot URL is invalid");
+    }
+    const localHttp = url.protocol === "http:" && ["localhost", "127.0.0.1", "::1"].includes(url.hostname);
+    if (url.protocol !== "https:" && !localHttp)
+        throw new XAgentApiError("invalid_response", "Device observation screenshot URL must use HTTPS");
+    return url;
+}
+async function prepareMcpImage(bytes, mimeType) {
+    if (bytes.length <= MAX_MCP_IMAGE_BYTES)
+        return { bytes, mimeType };
+    const pipeline = sharp(bytes, { failOn: "error", limitInputPixels: 100_000_000 })
+        .rotate()
+        .flatten({ background: "#ffffff" });
+    let smallest;
+    for (const quality of JPEG_QUALITIES) {
+        const candidate = await pipeline.clone().jpeg({ quality, mozjpeg: true }).toBuffer();
+        if (!smallest || candidate.length < smallest.length)
+            smallest = candidate;
+        if (candidate.length <= MAX_MCP_IMAGE_BYTES)
+            return { bytes: candidate, mimeType: "image/jpeg" };
+    }
+    const metadata = await pipeline.metadata();
+    let longestEdge = Math.max(metadata.width ?? 0, metadata.height ?? 0);
+    if (longestEdge < 1 || !smallest)
+        throw new XAgentApiError("invalid_response", "Device observation screenshot dimensions are invalid");
+    let candidate = smallest;
+    while (candidate.length > MAX_MCP_IMAGE_BYTES && longestEdge > 640) {
+        const ratio = Math.min(0.9, Math.sqrt(MAX_MCP_IMAGE_BYTES / candidate.length) * 0.95);
+        longestEdge = Math.max(640, Math.floor(longestEdge * ratio));
+        candidate = await pipeline.clone()
+            .resize({ width: longestEdge, height: longestEdge, fit: "inside", withoutEnlargement: true })
+            .jpeg({ quality: 72, mozjpeg: true })
+            .toBuffer();
+    }
+    if (candidate.length > MAX_MCP_IMAGE_BYTES) {
+        throw new XAgentApiError("invalid_response", "Device observation screenshot cannot be reduced to the MCP image limit");
+    }
+    return { bytes: candidate, mimeType: "image/jpeg" };
+}
+export async function actionMcpContent(toolName, result) {
+    const content = [{ type: "text", text: textFor(toolName, result) }];
+    const observation = observationFor(toolName, result);
+    if (!observation)
+        return content;
+    const url = assertImageUrl(observation.screenshot_url);
+    let response;
+    try {
+        response = await fetch(url, { signal: AbortSignal.timeout(30_000) });
+    }
+    catch (error) {
+        throw new XAgentApiError("infrastructure_failed", "Unable to fetch Device observation screenshot", { details: { cause: error instanceof Error ? error.message : String(error) } });
+    }
+    if (!response.ok)
+        throw new XAgentApiError("infrastructure_failed", `Device observation screenshot returned HTTP ${response.status}`);
+    const mimeType = String(response.headers.get("content-type") ?? "").split(";", 1)[0].toLowerCase();
+    if (!IMAGE_TYPES.has(mimeType))
+        throw new XAgentApiError("invalid_response", "Device observation screenshot is not an allowed image MIME type");
+    const length = Number(response.headers.get("content-length") ?? 0);
+    if (length > MAX_IMAGE_BYTES)
+        throw new XAgentApiError("invalid_response", "Device observation screenshot is too large");
+    const reader = response.body?.getReader();
+    if (!reader)
+        throw new XAgentApiError("invalid_response", "Device observation screenshot has no body");
+    const chunks = [];
+    let total = 0;
+    try {
+        for (;;) {
+            const next = await reader.read();
+            if (next.done)
+                break;
+            total += next.value.byteLength;
+            if (total > MAX_IMAGE_BYTES)
+                throw new XAgentApiError("invalid_response", "Device observation screenshot is too large");
+            chunks.push(next.value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    if (total === 0)
+        throw new XAgentApiError("invalid_response", "Device observation screenshot is empty");
+    const image = await prepareMcpImage(Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))), mimeType);
+    content.push({ type: "image", data: image.bytes.toString("base64"), mimeType: image.mimeType });
+    return content;
+}
+//# sourceMappingURL=mcp-content.js.map

package/dist/action/mcp-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-content.js","sourceRoot":"","sources":["../../src/action/mcp-content.ts"],"names":[],"mappings":"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"}

package/dist/action/protocol.d.ts

@@ -0,0 +1,36 @@
+export type ResolvedDeviceAction = Record<string, unknown> & {
+    action: string;
+};
+export type DeviceObservation = {
+    schema_version: "xagent-device-observation/v1";
+    screen_id: string;
+    session_id: string;
+    device_id: string;
+    screenshot_url: string;
+    mime_type: "image/png" | "image/jpeg" | "image/webp";
+    width: number;
+    height: number;
+    orientation: "portrait" | "landscape";
+    captured_at: string;
+    expires_at: string;
+};
+export type DeviceActionResult = {
+    schema_version: "xagent-device-action-result/v1";
+    session_id: string;
+    device_id: string;
+    screen_id: string;
+    status: "PASSED" | "FAILED" | "INFRASTRUCTURE_FAILED";
+    action: ResolvedDeviceAction;
+    result: {
+        success: boolean;
+        message: string;
+        data: unknown;
+        infrastructure_error?: string;
+    };
+    after_observation: DeviceObservation | null;
+};
+export declare function buildDeviceActionRequest(input: {
+    screenId?: unknown;
+    requestJson?: unknown;
+}): Record<string, unknown>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/action/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/action/protocol.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAChF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,8BAA8B,CAAC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,UAAU,GAAG,WAAW,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,cAAc,EAAE,gCAAgC,CAAC;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,uBAAuB,CAAC;IACtD,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5F,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBtH"}

package/dist/action/protocol.js

@@ -0,0 +1,29 @@
+import { CliError } from "../core/errors.js";
+export function buildDeviceActionRequest(input) {
+    if (input.requestJson === undefined)
+        throw new CliError("invalid_request", "device action requires --request-json");
+    let parsed;
+    try {
+        parsed = JSON.parse(String(input.requestJson));
+    }
+    catch {
+        throw new CliError("invalid_request", "--request-json must be valid JSON");
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        throw new CliError("invalid_request", "--request-json must be a JSON object");
+    const object = parsed;
+    const embeddedScreen = typeof object.screen_id === "string" ? object.screen_id.trim() : "";
+    if (embeddedScreen && typeof input.screenId === "string" && input.screenId.trim() && embeddedScreen !== input.screenId.trim()) {
+        throw new CliError("invalid_request", "--screen-id does not match screen_id in --request-json");
+    }
+    const screenId = typeof input.screenId === "string" && input.screenId.trim() ? input.screenId.trim() : embeddedScreen;
+    const action = object.action && typeof object.action === "object" && !Array.isArray(object.action)
+        ? object.action
+        : object;
+    if (!screenId)
+        throw new CliError("invalid_request", "device action requires --screen-id or screen_id in --request-json");
+    if (typeof action.action !== "string" || !action.action.trim())
+        throw new CliError("invalid_request", "device action JSON must contain action");
+    return { screen_id: screenId, action };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/action/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/action/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA2B7C,MAAM,UAAU,wBAAwB,CAAC,KAAoD;IAC3F,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;QAAE,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,uCAAuC,CAAC,CAAC;IACpH,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAAC,CAAC;IACvD,MAAM,CAAC;QAAC,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,mCAAmC,CAAC,CAAC;IAAC,CAAC;IACrF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,sCAAsC,CAAC,CAAC;IAClJ,MAAM,MAAM,GAAG,MAAiC,CAAC;IACjD,MAAM,cAAc,GAAG,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3F,IAAI,cAAc,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,cAAc,KAAK,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QAC9H,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,wDAAwD,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;IACtH,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAChG,CAAC,CAAC,MAAM,CAAC,MAAiC;QAC1C,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,mEAAmE,CAAC,CAAC;IAC1H,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,QAAQ,CAAC,iBAAiB,EAAE,wCAAwC,CAAC,CAAC;IAChJ,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC"}

package/dist/assets/contracts/app-list.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/contracts/developer/v1/app-list.schema.json",
+  "title": "XAgent Developer Application List",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "apps", "page", "page_size", "total"],
+  "properties": {
+    "schema_version": {"const": "xagent-app-list/v1"},
+    "apps": {"type": "array", "items": {"$ref": "#/$defs/app"}},
+    "page": {"type": "integer", "minimum": 1},
+    "page_size": {"type": "integer", "minimum": 1, "maximum": 100},
+    "total": {"type": "integer", "minimum": 0}
+  },
+  "$defs": {
+    "app": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package_id", "app_id", "name", "package_name", "version_name", "version_code", "launch_path"],
+      "properties": {
+        "package_id": {"type": "integer", "minimum": 1},
+        "app_id": {"type": ["integer", "null"], "minimum": 1},
+        "name": {"type": "string"},
+        "package_name": {"type": "string", "minLength": 1},
+        "version_name": {"type": "string"},
+        "version_code": {"type": "string"},
+        "launch_path": {"type": "string"}
+      }
+    }
+  }
+}

package/dist/assets/contracts/app-upload.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/app-upload.schema.json",
+  "title": "XAgent Temporary App Upload v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "id",
+    "package_id",
+    "status",
+    "file_name",
+    "sha256",
+    "size",
+    "app",
+    "expires_at"
+  ],
+  "properties": {
+    "schema_version": {"const": "xagent-app-upload/v1"},
+    "id": {"type": "string", "pattern": "^appup_[a-f0-9]{32}$"},
+    "package_id": {"type": "integer", "minimum": 1},
+    "status": {
+      "enum": ["active", "bound", "release_requested", "released", "expired"]
+    },
+    "file_name": {"type": "string", "minLength": 1, "maxLength": 512},
+    "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "size": {"type": "integer", "minimum": 1},
+    "app": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "package_name", "version_name", "version_code", "launch_path"],
+      "properties": {
+        "name": {"type": "string"},
+        "package_name": {"type": "string", "minLength": 1},
+        "version_name": {"type": "string"},
+        "version_code": {"type": "string"},
+        "launch_path": {"type": "string"}
+      }
+    },
+    "expires_at": {"type": "string", "format": "date-time"},
+    "bound_run_id": {"type": "string", "minLength": 1},
+    "release_requested_at": {"type": "string", "format": "date-time"},
+    "released_at": {"type": "string", "format": "date-time"}
+  }
+}

package/dist/assets/contracts/app.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/contracts/developer/v1/app.schema.json",
+  "title": "XAgent Developer Application",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "package_id", "app_id", "name", "package_name", "version_name", "version_code", "launch_path"],
+  "properties": {
+    "schema_version": {"const": "xagent-app/v1"},
+    "package_id": {"type": "integer", "minimum": 1},
+    "app_id": {"type": ["integer", "null"], "minimum": 1},
+    "name": {"type": "string"},
+    "package_name": {"type": "string", "minLength": 1},
+    "version_name": {"type": "string"},
+    "version_code": {"type": "string"},
+    "launch_path": {"type": "string"}
+  }
+}

package/dist/assets/contracts/authoring-attempt-create.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-attempt-create.schema.json",
+  "title": "XAgent Authoring Attempt Create v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["revision_id", "step_index"],
+  "properties": {
+    "revision_id": {"type": "string", "pattern": "^rev_[a-f0-9]{32}$"},
+    "step_index": {"type": "integer", "minimum": 0}
+  }
+}

package/dist/assets/contracts/authoring-attempt.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-attempt.schema.json",
+  "title": "XAgent Authoring Attempt v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["id", "schema_version", "session_id", "revision_id", "script_source", "script_hash", "step_index", "status", "started_at", "finished_at", "result", "artifacts"],
+  "properties": {
+    "id": {"type": "string", "pattern": "^attempt_[a-f0-9]{32}$"},
+    "schema_version": {"const": "xagent-authoring-attempt/v1"},
+    "session_id": {"type": "string", "pattern": "^auth_[a-f0-9]{32}$"},
+    "revision_id": {
+      "oneOf": [
+        {"type": "string", "pattern": "^rev_[a-f0-9]{32}$"},
+        {"type": "null"}
+      ]
+    },
+    "script_source": {"enum": ["revision", "draft"]},
+    "script_hash": {
+      "oneOf": [
+        {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        {"type": "null"}
+      ]
+    },
+    "step_index": {"type": "integer", "minimum": 0},
+    "status": {"enum": ["QUEUED", "RUNNING", "PASSED", "TEST_FAILED", "INFRASTRUCTURE_FAILED", "CANCELLED"]},
+    "started_at": {"type": ["string", "null"], "format": "date-time"},
+    "finished_at": {"type": ["string", "null"], "format": "date-time"},
+    "result": {"type": ["object", "null"]},
+    "artifacts": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["type", "url"],
+        "properties": {
+          "type": {"type": "string", "minLength": 1, "maxLength": 64},
+          "url": {"type": "string", "format": "uri", "pattern": "^https://"}
+        }
+      }
+    },
+    "billing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "billable_minutes", "cost", "discount_rate", "started_at", "ended_at"],
+      "properties": {
+        "status": {"enum": ["pending", "submitting", "succeeded", "failed", "unknown"]},
+        "billable_minutes": {"type": "integer", "minimum": 0},
+        "cost": {"type": "integer", "minimum": 0},
+        "discount_rate": {"type": "number", "minimum": 0},
+        "started_at": {"type": ["string", "null"], "format": "date-time"},
+        "ended_at": {"type": ["string", "null"], "format": "date-time"}
+      }
+    }
+  }
+}

package/dist/assets/contracts/authoring-complete.schema.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-complete.schema.json",
+  "title": "XAgent Authoring Complete Result v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["session", "revision", "yaml"],
+  "properties": {
+    "session": {"$ref": "authoring-session.schema.json"},
+    "revision": {"$ref": "authoring-revision.schema.json"},
+    "yaml": {"type": "string", "minLength": 1}
+  }
+}

package/dist/assets/contracts/authoring-draft-attempt-create.schema.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://xagent.testin.cn/schemas/developer/v1/authoring-draft-attempt-create.schema.json",
+  "title": "XAgent Authoring Draft Attempt Create v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["script", "step_index"],
+  "properties": {
+    "script": {"$ref": "public-script.schema.json"},
+    "step_index": {"type": "integer", "minimum": 0}
+  }
+}