@testin-official/xagent 0.3.7

package/dist/sdk/client.js

@@ -0,0 +1,241 @@
+import { createHash } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { open, stat } from "node:fs/promises";
+import path from "node:path";
+import { XAgentApiError } from "../core/errors.js";
+import { DeviceActionClient } from "../action/client.js";
+import { AuthoringClient } from "./authoring.js";
+const TERMINAL = new Set(["passed", "failed", "infrastructure_failed", "cancelled", "timed_out"]);
+export class XAgentClient {
+    baseUrl;
+    token;
+    uploadBaseUrl;
+    timeoutMs;
+    uploadTimeoutMs;
+    authoring = new AuthoringClient(this);
+    action = new DeviceActionClient(this);
+    constructor(baseUrl, token, uploadBaseUrl, timeoutMs = 30_000, uploadTimeoutMs = 900_000) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+        this.uploadBaseUrl = uploadBaseUrl;
+        this.timeoutMs = timeoutMs;
+        this.uploadTimeoutMs = uploadTimeoutMs;
+        if (!baseUrl.trim())
+            throw new XAgentApiError("invalid_configuration", "service URL is required");
+        if (!token.trim())
+            throw new XAgentApiError("authentication_required", "Developer Token is required");
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.uploadBaseUrl = uploadBaseUrl?.replace(/\/+$/, "");
+        this.token = token.trim();
+    }
+    getPrincipal() { return this.request("GET", "/agent/api/developer/v1/principal"); }
+    listEffectiveSkills() { return this.request("GET", "/agent/api/developer/v1/skills"); }
+    getEffectiveSkill(name) { return this.request("GET", `/agent/api/developer/v1/skills/${encodeURIComponent(name)}`); }
+    getEffectiveSkillReference(name, referencePath) { return this.request("GET", `/agent/api/developer/v1/skills/${encodeURIComponent(name)}/references/${referencePath.split("/").map(encodeURIComponent).join("/")}`); }
+    createRun(request, idempotencyKey) { return this.request("POST", "/agent/api/developer/v1/runs", { json: request, idempotencyKey }); }
+    previewTarget(request) { return this.request("POST", "/agent/api/developer/v1/targets/preview", { json: request }); }
+    getRun(runId) { return this.request("GET", `/agent/api/developer/v1/runs/${encodeURIComponent(runId)}`); }
+    cancelRun(runId) { return this.request("POST", `/agent/api/developer/v1/runs/${encodeURIComponent(runId)}/cancel`); }
+    listApps(query = {}) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(query))
+            if (value !== undefined)
+                params.set(key, String(value));
+        const suffix = params.toString() ? `?${params.toString()}` : "";
+        return this.request("GET", `/agent/api/developer/v1/apps${suffix}`);
+    }
+    getApp(packageId) {
+        if (!Number.isInteger(packageId) || packageId < 1)
+            throw new XAgentApiError("invalid_request", "package_id must be a positive integer");
+        return this.request("GET", `/agent/api/developer/v1/apps/${packageId}`);
+    }
+    releaseApp(uploadId) { return this.request("POST", `/agent/api/developer/v1/apps/uploads/${encodeURIComponent(uploadId)}/release`); }
+    /** `signal` aborts the wait itself; the Run keeps going server-side unless the caller also cancels it. */
+    async waitRun(runId, timeoutSeconds = 600, pollInterval = 2, onUpdate, signal) {
+        const deadline = Date.now() + timeoutSeconds * 1000;
+        const aborted = () => new XAgentApiError("cancelled", "wait for Run was cancelled");
+        for (;;) {
+            if (signal?.aborted)
+                throw aborted();
+            try {
+                const run = await this.getRun(runId);
+                onUpdate?.(run);
+                if (TERMINAL.has(run.status))
+                    return run;
+            }
+            catch (error) {
+                if (!isTransient(error))
+                    throw error;
+            }
+            if (signal?.aborted)
+                throw aborted();
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                throw new XAgentApiError("timeout", "timed out while waiting for Run");
+            // The sleep dominates the loop, so an abort has to interrupt it rather than
+            // wait out a full poll interval before being noticed.
+            await new Promise((resolve) => {
+                const timer = setTimeout(finish, Math.min(Math.max(0, pollInterval * 1000), remaining));
+                function finish() { clearTimeout(timer); signal?.removeEventListener("abort", finish); resolve(); }
+                signal?.addEventListener("abort", finish, { once: true });
+            });
+        }
+    }
+    async request(method, route, options = {}) {
+        const headers = { Authorization: `Bearer ${this.token}`, Accept: "application/json", ...options.headers };
+        if (options.idempotencyKey)
+            headers["Idempotency-Key"] = options.idempotencyKey;
+        let body = options.body;
+        if (options.json !== undefined) {
+            headers["Content-Type"] = "application/json";
+            body = JSON.stringify(options.json);
+        }
+        const response = await this.fetchRequest(`${this.baseUrl}${route}`, { method, headers, body }, options.timeoutMs ?? this.timeoutMs, false);
+        const payload = await parseJsonResponse(response, "server returned a non-JSON response");
+        if (!response.ok || (payload && typeof payload === "object" && "error" in payload)) {
+            const error = payload?.error ?? {};
+            throw new XAgentApiError(String(error.code ?? "infrastructure_failed"), String(error.message ?? "XAgent request failed"), { statusCode: response.status, details: typeof error.details === "object" ? error.details : undefined });
+        }
+        if (!payload || typeof payload.data !== "object" || Array.isArray(payload.data))
+            throw new XAgentApiError("invalid_response", "server returned an invalid response envelope", { statusCode: response.status });
+        return payload.data;
+    }
+    async uploadApp(apkPath, progress) {
+        if (!this.uploadBaseUrl)
+            throw new XAgentApiError("invalid_configuration", "file service URL is required for apps upload");
+        const file = await stat(apkPath);
+        const [md5, sha256] = await Promise.all([hashFile(apkPath, "md5"), hashFile(apkPath, "sha256")]);
+        const init = await this.directRequest("POST", `${this.uploadBaseUrl}/app/ci/init`, { json: { filename: path.basename(apkPath), size: file.size, md5, sha256 }, headers: { Authorization: `Bearer ${this.token}` } });
+        const ticket = String(init.ticket);
+        const chunkSize = Number(init.chunk_size ?? 5 * 1024 * 1024);
+        const total = Math.ceil(file.size / chunkSize);
+        const handle = await open(apkPath, "r");
+        try {
+            for (let chunk = 0; chunk < total; chunk += 1) {
+                const length = Math.min(chunkSize, file.size - chunk * chunkSize);
+                const buffer = Buffer.allocUnsafe(length);
+                await handle.read(buffer, 0, length, chunk * chunkSize);
+                const common = { fileMd5: md5, chunk: String(chunk), chunkSize: String(length) };
+                const checked = await retryTransient(() => this.directRequest("POST", `${this.uploadBaseUrl}/app/ci/checkChunk`, { form: common, headers: { "X-XAgent-Upload-Ticket": ticket } }), { chunk, total, step: "checkChunk" });
+                if (Number(checked.data?.ifExist ?? 0) !== 1) {
+                    // The form is rebuilt per attempt: a FormData/Blob body cannot be replayed once consumed.
+                    const uploaded = await retryTransient(() => {
+                        const form = new FormData();
+                        form.set("fileMd5", md5);
+                        form.set("chunk", String(chunk));
+                        form.set("UPLOAD-JSON", JSON.stringify({ suffix: "apk", eid: init.eid ?? 0, projectId: init.project_id ?? 0, uid: init.user_id ?? "", uname: "XAgent CI", originalFilename: path.basename(apkPath) }));
+                        form.set("file", new Blob([buffer], { type: "application/vnd.android.package-archive" }), path.basename(apkPath));
+                        return this.directRequest("POST", `${this.uploadBaseUrl}/app/ci/upload`, { body: form, headers: { "X-XAgent-Upload-Ticket": ticket } });
+                    }, { chunk, total, step: "upload" });
+                    const uploadedCode = Number(uploaded.code ?? -1);
+                    // 20002 means the file service already had this content (dedup) —
+                    // that is a success, same as the outer envelope check in directRequest.
+                    if (![0, 20002].includes(uploadedCode)) {
+                        throw new XAgentApiError("infrastructure_failed", `APK chunk upload failed: ${String(uploaded.msg ?? "unknown file service error")}`, { details: { chunk, total, chunk_code: uploadedCode } });
+                    }
+                }
+                progress?.(chunk + 1, total);
+            }
+        }
+        finally {
+            await handle.close();
+        }
+        const merged = await this.directRequest("POST", `${this.uploadBaseUrl}/app/ci/mergeChunk`, { form: { fileMd5: md5, chunksTotal: String(total), ext: "apk", biz: "public", storageType: "1" }, headers: { "X-XAgent-Upload-Ticket": ticket } });
+        if (!merged.uploadReceipt)
+            throw new XAgentApiError("invalid_response", "file service did not return an upload receipt");
+        return this.request("POST", `/agent/api/developer/v1/apps/uploads/${encodeURIComponent(String(init.upload_id))}/complete`, { json: { upload_id: init.upload_id, ticket, receipt: merged.uploadReceipt }, timeoutMs: this.uploadTimeoutMs });
+    }
+    async directRequest(method, url, options) {
+        const headers = { Accept: "application/json", ...options.headers };
+        let body = options.body;
+        if (options.json !== undefined) {
+            headers["Content-Type"] = "application/json";
+            body = JSON.stringify(options.json);
+        }
+        if (options.form) {
+            headers["Content-Type"] = "application/x-www-form-urlencoded";
+            body = new URLSearchParams(options.form);
+        }
+        const response = await this.fetchRequest(url, { method, headers, body }, options.timeoutMs ?? this.uploadTimeoutMs, true);
+        const payload = await parseJsonResponse(response, "file service upload request failed");
+        const code = Number(payload?.code ?? 0);
+        if (!response.ok || ![0, 20002].includes(code)) {
+            const message = String(payload?.msg ?? "file service upload failed");
+            const errorCode = code === 2402 && message.includes("Bearer") ? "authentication_required" : code === 2402 ? "permission_denied" : "infrastructure_failed";
+            throw new XAgentApiError(errorCode, message, { statusCode: response.status });
+        }
+        return payload;
+    }
+    async fetchRequest(url, init, timeoutMs, upload) {
+        try {
+            return await fetch(url, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+        }
+        catch (error) {
+            // Carry the underlying reason through. A reset socket, a DNS failure and
+            // a refused connection all used to surface as the same opaque sentence.
+            const reason = String(error?.cause?.message ?? error?.message ?? "").trim();
+            const syscode = error?.cause?.code ?? error?.code;
+            const details = { url, ...(syscode ? { cause_code: String(syscode) } : {}), ...(reason ? { cause: reason } : {}) };
+            if (error?.name === "TimeoutError" || error?.name === "AbortError") {
+                throw new XAgentApiError("timeout", `${upload ? "file service upload request" : "request"} timed out after ${timeoutMs}ms`, { details });
+            }
+            const base = upload ? "file service upload request failed" : "unable to reach XAgent service";
+            throw new XAgentApiError("infrastructure_failed", reason ? `${base}: ${reason}` : base, { details });
+        }
+    }
+}
+async function parseJsonResponse(response, message) {
+    try {
+        return await response.json();
+    }
+    catch {
+        throw new XAgentApiError("invalid_response", message, { statusCode: response.status });
+    }
+}
+/** A transport failure or a server-side 5xx is worth another attempt; a business
+ *  rejection answered with HTTP 200 (bad md5, expired ticket) never is. */
+function isTransient(error) {
+    if (!(error instanceof XAgentApiError))
+        return false;
+    if (error.code !== "timeout" && error.code !== "infrastructure_failed")
+        return false;
+    return error.statusCode === undefined || error.statusCode >= 500;
+}
+/** Retries one chunk-level upload step on transient transport failures.
+ *  A ~300MB APK ships as ~60 chunks, so a single dropped socket used to throw
+ *  away the whole transfer. checkChunk is read-only and re-uploading the same
+ *  chunk overwrites identical bytes, so both steps are safe to repeat.
+ *  mergeChunk is deliberately NOT retried — it is not idempotent. */
+async function retryTransient(attempt, context, attempts = 3) {
+    let last;
+    let tried = 0;
+    for (let tries = 1; tries <= attempts; tries += 1) {
+        tried = tries;
+        try {
+            return await attempt();
+        }
+        catch (error) {
+            last = error;
+            if (!isTransient(error) || tries === attempts)
+                break;
+            await new Promise((resolve) => setTimeout(resolve, 1000 * tries));
+        }
+    }
+    if (last instanceof XAgentApiError) {
+        // Only claim retries that actually happened — annotating a fail-fast
+        // rejection with an attempt count sends readers after a phantom flake.
+        const retried = tried > 1;
+        throw new XAgentApiError(last.code, retried ? `${last.message} (after ${tried} attempts)` : last.message, {
+            statusCode: last.statusCode,
+            details: { ...last.details, ...context, ...(retried ? { attempts: tried } : {}) },
+        });
+    }
+    throw last;
+}
+async function hashFile(filePath, algorithm) {
+    return new Promise((resolve, reject) => {
+        const hash = createHash(algorithm);
+        createReadStream(filePath).on("error", reject).on("data", (chunk) => hash.update(chunk)).on("end", () => resolve(hash.digest("hex")));
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/sdk/client.js.map

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

package/dist/skills/catalog.d.ts

@@ -0,0 +1,7 @@
+export declare const SKILL_NAMES: readonly ["xagent-cli", "xagent-explore-device", "xagent-author-test", "xagent-run-test", "xagent-analyze-failure", "xagent-repair-test", "xagent-test-report"];
+export declare function listSkills(): string[];
+export declare function readSkill(name: string): Promise<string>;
+export declare function listSkillReferences(name: string): Promise<string[]>;
+export declare function readSkillReference(name: string, reference: string): Promise<string>;
+export declare function exportSkills(directory: string, overwrite?: boolean): Promise<string[]>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/skills/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/skills/catalog.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,iKAAkK,CAAC;AAU3L,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAA6B;AACnE,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG7D;AACD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAKzE;AACD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzF;AACD,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiB1F"}

package/dist/skills/catalog.js

@@ -0,0 +1,59 @@
+import { cp, mkdir, readFile, readdir, stat } from "node:fs/promises";
+import path from "node:path";
+import { skillRoot } from "../core/assets.js";
+export const SKILL_NAMES = ["xagent-cli", "xagent-explore-device", "xagent-author-test", "xagent-run-test", "xagent-analyze-failure", "xagent-repair-test", "xagent-test-report"];
+function requireSkill(name) { if (!SKILL_NAMES.includes(name))
+    throw new Error("skill_not_found"); }
+function normalizeReference(reference) {
+    const value = String(reference ?? "").replaceAll("\\", "/").replace(/^\/+|\/+$/g, "");
+    const parts = value.split("/");
+    if (!value || parts.includes(".."))
+        throw new Error("reference_not_found");
+    return parts[0] === "references" ? parts.join("/") : ["references", ...parts].join("/");
+}
+export function listSkills() { return [...SKILL_NAMES]; }
+export async function readSkill(name) {
+    requireSkill(name);
+    return readFile(path.join(await skillRoot(), name, "SKILL.md"), "utf8");
+}
+export async function listSkillReferences(name) {
+    requireSkill(name);
+    const root = path.join(await skillRoot(), name, "references");
+    try {
+        return (await readdir(root, { withFileTypes: true })).filter((entry) => entry.isFile() && entry.name.endsWith(".md")).map((entry) => `references/${entry.name}`).sort();
+    }
+    catch {
+        return [];
+    }
+}
+export async function readSkillReference(name, reference) {
+    const normalized = normalizeReference(reference);
+    if (!(await listSkillReferences(name)).includes(normalized))
+        throw new Error("reference_not_found");
+    return readFile(path.join(await skillRoot(), name, ...normalized.split("/")), "utf8");
+}
+export async function exportSkills(directory, overwrite = false) {
+    const root = await skillRoot();
+    const written = [];
+    for (const name of SKILL_NAMES) {
+        const relatives = ["SKILL.md", ...(await listSkillReferences(name)), "agents/openai.yaml"];
+        for (const relative of relatives) {
+            const destination = path.join(directory, name, ...relative.split("/"));
+            if (!overwrite) {
+                try {
+                    await stat(destination);
+                    throw new Error(`destination_exists:${destination}`);
+                }
+                catch (error) {
+                    if (String(error?.message).startsWith("destination_exists:"))
+                        throw error;
+                }
+            }
+            await mkdir(path.dirname(destination), { recursive: true });
+            await cp(path.join(root, name, ...relative.split("/")), destination);
+            written.push(destination);
+        }
+    }
+    return written;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/skills/catalog.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@testin-official/xagent",
+  "version": "0.3.7",
+  "description": "Cross-platform XAgent Developer CLI and MCP server",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "xagent": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20.9"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "clean": "node scripts/clean-build.mjs",
+    "build": "npm run clean && tsc -p tsconfig.json && node scripts/copy-assets.mjs",
+    "test": "node --import tsx --test tests/device-action.test.ts tests/cli-entry.test.ts tests/cli-errors.test.ts tests/cli-routing.test.ts tests/config-draft.test.ts tests/integrations.test.ts tests/interrupt.test.ts tests/mcp-skills.test.ts tests/mcp-stdio.test.ts tests/run-progress.test.ts tests/script.test.ts tests/sdk.test.ts tests/sdk-upload.test.ts tests/session-lease.test.ts tests/version-package.test.ts",
+    "check": "npm test && npm run build",
+    "package:integrations": "node scripts/package-integrations.mjs",
+    "package:skill": "node scripts/package-integrations.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.5",
+    "@napi-rs/keyring": "^1.3.0",
+    "ajv": "^8.17.1",
+    "commander": "^12.1.0",
+    "sharp": "^0.35.3",
+    "yaml": "^2.8.1"
+  },
+  "optionalDependencies": {
+    "keytar": "^7.9.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.3",
+    "tsx": "^4.20.5",
+    "typescript": "^5.9.2"
+  }
+}