@walkhi/code-relax 0.1.0-beta.10 → 0.1.0-beta.101

package/dist/bin/manage-relay-admin.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import mysql from 'mysql2/promise';
+
+const path = process.env.RELAY_MYSQL_CONFIG_FILE;
+const action = process.argv[2];
+const email = (process.argv[3] || '').trim().toLowerCase();
+if (!path || !['--grant', '--revoke', '--list'].includes(action) ||
+    (action !== '--list' && !/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email))) {
+  throw new Error('Use --grant EMAIL, --revoke EMAIL or --list with RELAY_MYSQL_CONFIG_FILE');
+}
+const db = await mysql.createConnection({ ...JSON.parse(fs.readFileSync(path, 'utf8')),
+  dateStrings: true, timezone: 'Z', multipleStatements: false });
+try {
+  if (action === '--grant') await db.execute(`INSERT INTO relay_admin_emails (email,granted_at)
+    VALUES (?,UTC_TIMESTAMP(3)) ON DUPLICATE KEY UPDATE email=VALUES(email)`, [email]);
+  else if (action === '--revoke') await db.execute('DELETE FROM relay_admin_emails WHERE email=?', [email]);
+  const [rows] = await db.query('SELECT email FROM relay_admin_emails ORDER BY email');
+  console.log(JSON.stringify({ admins: rows.map(row => row.email) }));
+} finally { await db.end(); }

package/dist/bin/migrate-relay-db.mjs

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import { createHash } from 'node:crypto';
+import { fileURLToPath } from 'node:url';
+import mysql from 'mysql2/promise';
+import { relaySchemaVersions } from '../database/versions.mjs';
+import { deviceStore } from '../src/self-relay/device-store.mjs';
+import { relayAdminState } from '../src/self-relay/admin-state.mjs';
+
+const command = process.argv[2];
+if (!['--schema', '--import', '--check'].includes(command) || !process.env.RELAY_MYSQL_CONFIG_FILE) {
+  throw new Error('Use --schema, --import or --check with RELAY_MYSQL_CONFIG_FILE');
+}
+const config = JSON.parse(fs.readFileSync(process.env.RELAY_MYSQL_CONFIG_FILE, 'utf8'));
+const db = await mysql.createConnection({ ...config, dateStrings: true, timezone: 'Z', multipleStatements: false });
+const sqlTime = value => value.replace('T', ' ').replace(/Z$/, '');
+const migrations = relaySchemaVersions;
+try {
+  if (command === '--schema') {
+    const [existing] = await db.query("SHOW TABLES LIKE 'schema_migrations'");
+    const [applied] = existing.length ? await db.query('SELECT version, sha256 FROM schema_migrations') : [[]];
+    const known = new Map(applied.map(row => [row.version, row.sha256]));
+    if (known.size !== applied.length || [...known.keys()].some(version => !migrations.includes(version))) throw new Error('Unexpected schema version');
+    for (const version of migrations) {
+      const source = fs.readFileSync(fileURLToPath(new URL(`../database/${version}.sql`, import.meta.url)), 'utf8');
+      const sha256 = createHash('sha256').update(source).digest('hex');
+      if (known.has(version)) {
+        if (known.get(version) !== sha256) throw new Error(`Migration changed: ${version}`);
+        continue;
+      }
+      if (version !== migrations[0] && !known.has(migrations[migrations.indexOf(version) - 1])) throw new Error('Previous migration missing');
+      const statements = source.split('\n').filter(line => !line.trimStart().startsWith('--')).join('\n');
+      for (const statement of statements.split(';').map(item => item.trim()).filter(Boolean)) await db.query(statement);
+      await db.execute('INSERT INTO schema_migrations (version, sha256) VALUES (?,?)', [version, sha256]);
+      known.set(version, sha256);
+      console.log(JSON.stringify({ schema: version, sha256 }));
+    }
+  } else {
+    const [versions] = await db.query('SELECT version FROM schema_migrations');
+    if (!versions.some(row => row.version === '001_relay_core') || versions.some(row => !migrations.includes(row.version))) throw new Error('Unexpected schema version');
+    if (command === '--check') {
+      const names = ['computers', 'mobile_authorizations', 'official_computers', 'announcements', 'relay_settings', 'users', 'user_login_identities'];
+      if (versions.some(row => row.version === '002_email_accounts')) names.push('email_login_challenges', 'user_sessions', 'email_send_limits');
+      if (versions.some(row => row.version === '003_relay_usage')) names.push('relay_admin_emails', 'relay_usage_settings', 'relay_usage_totals', 'relay_usage_computer_totals', 'relay_usage_entitlements', 'relay_usage_budgets', 'relay_usage_computer_budgets', 'relay_usage_sessions');
+      if (versions.some(row => row.version === '004_relay_usage_actions')) names.push('relay_usage_actions');
+      if (versions.some(row => row.version === '006_relay_diagnostics')) names.push('relay_diagnostics');
+      if (versions.some(row => row.version === '007_relay_usage_daily')) names.push('relay_usage_user_days', 'relay_usage_computer_days');
+      const counts = {};
+      for (const name of names) { const [rows] = await db.query(`SELECT COUNT(*) AS count FROM ${name}`); counts[name] = rows[0].count; }
+      if (process.env.RELAY_STATE_FILE && process.env.RELAY_ADMIN_STATE_FILE) {
+        const devices = deviceStore(process.env.RELAY_STATE_FILE).entries();
+        const admin = relayAdminState(process.env.RELAY_ADMIN_STATE_FILE, 8).read();
+        const expected = { computers: devices.length,
+          mobile_authorizations: devices.reduce((sum, item) => sum + item.clients.length, 0),
+          official_computers: devices.filter(item => item.officialComputer).length,
+          announcements: admin.announcements.length, relay_settings: 1 };
+        if (Object.keys(expected).some(name => counts[name] !== expected[name])) throw new Error('Imported row counts differ from JSON');
+        const [saved] = await db.query('SELECT id,host_hash,status,revision FROM computers');
+        const original = new Map(devices.map(item => [item.id, item]));
+        for (const row of saved) {
+          const item = original.get(row.id);
+          if (!item || item.hostHash !== row.host_hash || item.status !== row.status || item.revision !== Number(row.revision)) {
+            throw new Error('Imported computer identity differs from JSON');
+          }
+        }
+        const [authorized] = await db.query('SELECT computer_id,client_id,credential_hash FROM mobile_authorizations');
+        for (const row of authorized) {
+          const item = original.get(row.computer_id)?.clients.find(client => client.id === row.client_id);
+          if (!item || item.hash !== row.credential_hash) throw new Error('Imported mobile authorization differs from JSON');
+        }
+        const [settings] = await db.query('SELECT max_relay_sessions FROM relay_settings WHERE id=1');
+        if (settings[0]?.max_relay_sessions !== admin.maxRelaySessions) throw new Error('Imported relay setting differs from JSON');
+        console.log(JSON.stringify({ verified: true, counts }));
+      } else console.log(JSON.stringify(counts));
+    } else {
+      const stateFile = process.env.RELAY_STATE_FILE, adminFile = process.env.RELAY_ADMIN_STATE_FILE;
+      if (!stateFile || !adminFile) throw new Error('RELAY_STATE_FILE and RELAY_ADMIN_STATE_FILE required for import');
+      const devices = deviceStore(stateFile).entries();
+      const admin = relayAdminState(adminFile, 8).read();
+      const [existing] = await db.query('SELECT (SELECT COUNT(*) FROM computers) AS computers, (SELECT COUNT(*) FROM relay_settings) AS settings');
+      if (existing[0].computers || existing[0].settings) throw new Error('Import target is not empty');
+      await db.beginTransaction();
+      try {
+        for (const item of devices) {
+          await db.execute('INSERT INTO computers (id,host_hash,status,revision,created_at,updated_at) VALUES (?,?,?,?,?,?)',
+            [item.id, item.hostHash, item.status, item.revision, sqlTime(item.createdAt), sqlTime(item.updatedAt)]);
+          for (const client of item.clients) await db.execute(
+            'INSERT INTO mobile_authorizations (computer_id,client_id,credential_hash,created_at,updated_at) VALUES (?,?,?,?,?)',
+            [item.id, client.id, client.hash, sqlTime(client.createdAt), sqlTime(client.updatedAt)]);
+          if (item.officialComputer) {
+            const official = item.officialComputer;
+            await db.execute('INSERT INTO official_computers (computer_id,environment_id,name,hostname,updated_at) VALUES (?,?,?,?,?)',
+              [item.id, official.environmentId, official.name, official.hostname, sqlTime(official.updatedAt)]);
+          }
+        }
+        await db.execute('INSERT INTO relay_settings (id,max_relay_sessions,updated_at) VALUES (1,?,UTC_TIMESTAMP(3))', [admin.maxRelaySessions]);
+        for (const item of admin.announcements) await db.execute(
+          'INSERT INTO announcements (id,title,message,status,created_at,updated_at,published_at) VALUES (?,?,?,?,?,?,?)',
+          [item.id, item.title, item.message, item.status, sqlTime(item.createdAt), sqlTime(item.updatedAt),
+            item.publishedAt ? sqlTime(item.publishedAt) : null]);
+        await db.commit();
+      } catch (error) { await db.rollback(); throw error; }
+      console.log(JSON.stringify({ imported: true, computers: devices.length,
+        mobileAuthorizations: devices.reduce((sum, item) => sum + item.clients.length, 0),
+        officialComputers: devices.filter(item => item.officialComputer).length,
+        announcements: admin.announcements.length }));
+    }
+  }
+} finally { await db.end(); }

package/dist/bin/publish-android-release.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { androidReleaseStorage } from '../relay-admin/android-release-storage.mjs';
+import { readAndroidCatalog } from '../src/self-relay/android-releases.mjs';
+import { readPublicManifest, updatePublicAndroid } from '../src/self-relay/public-releases.mjs';
+
+// This administrative command runs only on the deployment host; no keys cross SSH.
+const [apkFile, metadataFile, mode] = process.argv.slice(2);
+if (mode && mode !== '--existing-object') throw new Error('Invalid publication mode');
+if (!apkFile || !metadataFile) throw new Error('Usage: publish-android-release.mjs APK METADATA');
+const storage = androidReleaseStorage('/etc/codex-relay/android-releases.json', '/etc/codex-relay/tencent-monitor.json');
+const metadata = JSON.parse(fs.readFileSync(metadataFile, 'utf8'));
+if (metadata.packageName !== 'com.walkhi.codexremote' || !/^[a-f0-9]{64}$/.test(metadata.certificateSha256)) throw new Error('Invalid APK identity');
+const { certificateSha256: expectedCertificate } = JSON.parse(fs.readFileSync('/etc/codex-relay/android-releases.json', 'utf8'));
+if (!/^[a-f0-9]{64}$/.test(expectedCertificate) || metadata.certificateSha256 !== expectedCertificate) throw new Error('APK signing certificate does not match release configuration');
+const bytes = fs.readFileSync(apkFile), sha256 = createHash('sha256').update(bytes).digest('hex');
+if (sha256 !== metadata.sha256 || bytes.length !== metadata.size) throw new Error('Uploaded APK integrity mismatch');
+const { versionCode, versionName, size, notes, certificateSha256 } = metadata;
+const release = { versionCode, versionName, size, sha256, notes, certificateSha256,
+  objectKey: `code-relax/android/${versionCode}/Code-Relax-${sha256.slice(0, 16)}.apk` };
+const catalogFile = storage.catalogFile, temporary = catalogFile + '.new', lock = catalogFile + '.lock';
+const lockHandle = fs.openSync(lock, 'wx', 0o600);
+try {
+  readPublicManifest();
+  const catalog = fs.existsSync(catalogFile) ? readAndroidCatalog(catalogFile) : { releases: [] };
+  const previous = catalog.releases.find(item => item.versionCode === versionCode);
+  if (previous && previous.sha256 !== sha256) throw new Error('A different APK already uses this versionCode');
+  if (catalog.latestVersionCode > versionCode) throw new Error('Refusing to publish an older version as latest');
+  const next = { latestVersionCode: versionCode, releases: [...catalog.releases.filter(item => item.versionCode !== versionCode), release] };
+  fs.writeFileSync(temporary, JSON.stringify(next, null, 2) + '\n', { mode: 0o640 });
+  readAndroidCatalog(temporary);
+  if (!previous && mode !== '--existing-object') {
+    await new Promise((resolve, reject) => storage.cos.putObject({ ...storage.object(release), Body: bytes,
+      ContentLength: bytes.length, ContentType: 'application/vnd.android.package-archive',
+      ContentDisposition: `attachment; filename="Code-Relax-${versionName}.apk"`
+    }, (error, value) => error ? reject(error) : resolve(value)));
+  }
+  // Validate the exact signed GET that website and App use, before switching latest.
+  const ticket = await storage.signDownload(release);
+  const response = await fetch(ticket.url, { signal: AbortSignal.timeout(120000) });
+  if (!response.ok) throw new Error(`Signed download failed: HTTP ${response.status}`);
+  const downloaded = Buffer.from(await response.arrayBuffer());
+  if (downloaded.length !== size || createHash('sha256').update(downloaded).digest('hex') !== sha256) throw new Error('Stored APK integrity mismatch');
+  const unsigned = new URL(ticket.url); unsigned.search = '';
+  const denied = await fetch(unsigned, { method: 'HEAD', signal: AbortSignal.timeout(15000) });
+  if (denied.status !== 403) throw new Error(`Private object check failed: HTTP ${denied.status}`);
+  const owner = fs.statSync(path.dirname(catalogFile));
+  fs.chownSync(temporary, owner.uid, owner.gid);
+  fs.renameSync(temporary, catalogFile);
+  updatePublicAndroid(release);
+  console.log(JSON.stringify({ published: true, versionCode, versionName, size, sha256, unsignedStatus: denied.status,
+    entry: 'https://www.coderelax.cn/code-relax/android' }));
+} catch (error) {
+  // COS errors can carry signed request details. Keep CLI output credential-free.
+  console.error('Android publication failed:', error?.code || (error?.name === 'Error' ? error.message : 'storage-request-failed'));
+  process.exitCode = 1;
+} finally {
+  fs.closeSync(lockHandle);
+  fs.unlinkSync(lock);
+  if (fs.existsSync(temporary)) fs.unlinkSync(temporary);
+}

package/dist/bin/publish-harmony-release.mjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { androidReleaseStorage } from '../relay-admin/android-release-storage.mjs';
+import { readHarmonyConfig, hapName, validateHarmonyMetadata, checkHarmonyVersion,
+  verifyHarmony, activateHarmony } from '../relay-admin/harmony-release.mjs';
+
+// Local PowerShell releases use the same verifier, COS objects and activation as GitHub CD.
+const directory = path.resolve(process.argv[2] || '');
+if (!process.argv[2]) throw Error('Usage: publish-harmony-release.mjs DIRECTORY');
+let stage = 'metadata';
+try {
+  const manifest = JSON.parse(fs.readFileSync(path.join(directory, 'manifest.json5'), 'utf8')).app;
+  const config = readHarmonyConfig();
+  const metadata = { packageName: manifest.bundleName, versionCode: manifest.versionCode,
+    versionName: manifest.versionName, certificateSha256: config.certificateSha256 };
+  if (!Number.isSafeInteger(metadata.versionCode) || metadata.versionCode <= 0
+    || !/^\d+\.\d+\.\d+$/.test(metadata.versionName)) throw Error();
+  metadata.files = [hapName(metadata), 'manifest.json5', 'icon.png'].map(name => {
+    const bytes = fs.readFileSync(path.join(directory, name));
+    return { name, size: bytes.length, sha256: createHash('sha256').update(bytes).digest('hex'),
+      contentMd5: createHash('md5').update(bytes).digest('base64') };
+  });
+  Object.assign(metadata, { size: metadata.files[0].size, sha256: metadata.files[0].sha256,
+    contentMd5: metadata.files[0].contentMd5 });
+  validateHarmonyMetadata(metadata, config);
+  checkHarmonyVersion(metadata);
+  stage = 'signature';
+  await verifyHarmony(directory, metadata, config);
+  const storage = androidReleaseStorage('/etc/codex-relay/android-releases.json', '/etc/codex-relay/tencent-monitor.json');
+  const keys = metadata.files.map(f => `code-relax/harmony/${metadata.versionCode}/${f.name}`);
+  stage = 'upload';
+  for (const [i, file] of metadata.files.entries()) {
+    await new Promise((resolve, reject) => storage.cos.putObject({ ...storage.object({ objectKey: keys[i] }),
+      Body: fs.createReadStream(path.join(directory, file.name)), ContentLength: file.size,
+      ContentMD5: file.contentMd5, ContentType: i === 1 ? 'application/json' : i === 2 ? 'image/png' : 'application/octet-stream',
+      Headers: { 'x-cos-forbid-overwrite': 'true' }
+    }, (error, result) => error ? reject(error) : resolve(result)));
+  }
+  stage = 'publication';
+  console.log(JSON.stringify(await activateHarmony(metadata, storage, keys)));
+} catch {
+  console.error(`Harmony publication failed at ${stage}; inspect objects and current version before retrying.`);
+  process.exitCode = 1;
+}

package/dist/bin/release-upload-server.mjs

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import http from 'node:http';
+import { createHash, randomUUID } from 'node:crypto';
+import { pipeline } from 'node:stream/promises';
+import { Transform, Readable } from 'node:stream';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { fileURLToPath } from 'node:url';
+import { verifyReleaseIdentity, createUploadSigner } from '../relay-admin/release-oidc.mjs';
+import { androidReleaseStorage } from '../relay-admin/android-release-storage.mjs';
+import { readAndroidCatalog } from '../src/self-relay/android-releases.mjs';
+import { updatePublicWorkstations } from '../src/self-relay/public-releases.mjs';
+
+import { readHarmonyConfig, validateHarmonyMetadata, checkHarmonyVersion, verifyHarmony, activateHarmony } from '../relay-admin/harmony-release.mjs';
+
+const execute = promisify(execFile);
+const config = JSON.parse(fs.readFileSync('/etc/codex-relay/android-releases.json', 'utf8'));
+const credential = JSON.parse(fs.readFileSync('/etc/codex-relay/tencent-monitor.json', 'utf8'));
+const storage = androidReleaseStorage('/etc/codex-relay/android-releases.json', '/etc/codex-relay/tencent-monitor.json');
+const signUpload = createUploadSigner(config, { secretId: credential.secretId, secretKey: credential.secretKey });
+const stateDir = '/var/lib/codex-relay/release-publisher';
+fs.mkdirSync(stateDir, { recursive: true, mode: 0o700 });
+const cosCall = (method, args) => new Promise((resolve, reject) => storage.cos[method](args, (e, r) => e ? reject(e) : resolve(r)));
+const object = key => ({ Bucket: config.bucket, Region: config.region, Key: key });
+const identityKey = p => `${p.repository_id}/${p.run_id}/${p.run_attempt}/${p.sha}`;
+const filename = id => path.join(stateDir, id + '.json');
+function save(row) {
+  const temp = filename(row.intentId) + '.' + randomUUID();
+  fs.writeFileSync(temp, JSON.stringify(row), { mode: 0o600 }); fs.renameSync(temp, filename(row.intentId));
+}
+const read = id => fs.existsSync(filename(id)) ? JSON.parse(fs.readFileSync(filename(id))) : null;
+const publicState = row => ({ ok: true, intentId: row.intentId, status: row.status, result: row.result, error: row.error });
+async function readJson(req) {
+  const chunks = []; let size = 0;
+  for await (const chunk of req) { size += chunk.length; if (size > 16384) throw Error('Request too large'); chunks.push(chunk); }
+  return JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}');
+}
+function metadataFrom(data, claims, target) {
+  const { packageName, versionCode, versionName, size, sha256, contentMd5, certificateSha256, notes,
+    buildCommit, artifactId, runId, sourceCommit, verifyOnly } = data;
+  if (!Number.isSafeInteger(versionCode) || versionCode < 1 || versionCode > 2100000000
+    || !/^[a-f0-9]{64}$/.test(sha256)
+    || !Number.isSafeInteger(size) || size < 1 || size > 200 * 1024 * 1024
+    || typeof notes !== 'string' || notes.length > 2000 || !/^[A-Za-z0-9+/]{22}==$/.test(contentMd5)
+    || !/^\d+$/.test(artifactId) || runId !== claims.run_id || sourceCommit !== claims.sha
+    || typeof verifyOnly !== 'boolean' || !/^[a-f0-9]{40}$/.test(buildCommit)) throw Error('Invalid metadata');
+  if (target === 'hap') validateHarmonyMetadata(data, readHarmonyConfig());
+  else if (packageName !== 'com.walkhi.codexremote' || !/^\d+\.\d+\.\d+\.\d+$/.test(versionName)
+    || !versionName.endsWith('.' + versionCode) || certificateSha256 !== config.certificateSha256) throw Error('Invalid Android identity');
+  return { target, ...(target === 'hap' ? { files: data.files } : {}), packageName, versionCode, versionName, size, sha256, contentMd5, certificateSha256, notes,
+    buildCommit, artifactId, runId, sourceCommit, verifyOnly };
+}
+let busy = false;
+const server = http.createServer(async (req, res) => {
+  const reply = (code, data) => { if (!res.destroyed) { res.writeHead(code, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' }); res.end(JSON.stringify(data)); } };
+  let claims;
+  const npmStatus = req.url === '/code-relax/publish/npm/status';
+  try { claims = await verifyReleaseIdentity((req.headers.authorization || '').replace(/^Bearer /, ''), npmStatus ? 'npm' : 'mobile'); }
+  catch { reply(401, { ok: false, error: 'OIDC_REJECTED' }); return; }
+  if (npmStatus) {
+    try {
+      if (req.method !== 'POST') { reply(405, { ok: false, error: 'METHOD_NOT_ALLOWED' }); return; }
+      const { version } = await readJson(req);
+      const response = await fetch('https://registry.npmjs.org/@walkhi%2fcode-relax', { signal: AbortSignal.timeout(15000) });
+      if (!response.ok) throw Error('Registry unavailable');
+      const metadata = await response.json();
+      if (metadata['dist-tags']?.latest !== version || metadata['dist-tags']?.beta !== version
+        || !metadata.versions?.[version]) { reply(409, { ok: false, error: 'NPM_VERSION_MISMATCH' }); return; }
+      updatePublicWorkstations(version);
+      reply(200, { ok: true, version });
+    } catch { reply(500, { ok: false, error: 'NPM_STATUS_SYNC_FAILED' }); }
+    return;
+  }
+  const target = /^\/code-relax\/publish\/(android|hap)\/intents(?:\/|$)/.exec(req.url || '')?.[1];
+  if (!target) { reply(404, { ok: false, error: 'NOT_FOUND' }); return; }
+  const prefix = `/code-relax/publish/${target}/intents`;
+  try {
+    if (req.method === 'POST' && req.url === prefix) {
+      let metadata;
+      try { metadata = metadataFrom(await readJson(req), claims, target); } catch { reply(400, { ok: false, error: 'INVALID_RELEASE' }); return; }
+      if (!metadata.verifyOnly && target === 'hap') {
+        try { checkHarmonyVersion(metadata); } catch { reply(409, { ok: false, error: 'VERSION_CONFLICT' }); return; }
+      }
+      if (!metadata.verifyOnly && target === 'android') {
+        const catalog = readAndroidCatalog(config.catalogFile);
+        const previous = catalog.releases.find(x => x.versionCode === metadata.versionCode);
+        if (catalog.latestVersionCode > metadata.versionCode || (previous && previous.sha256 !== metadata.sha256)) {
+          reply(409, { ok: false, error: 'VERSION_CONFLICT' }); return;
+        }
+      }
+      const identity = identityKey(claims);
+      const intentId = createHash('sha256').update(JSON.stringify({ identity, metadata })).digest('hex');
+      let row = read(intentId);
+      if (row && row.status !== 'prepared') { reply(200, publicState(row)); return; }
+      const key = metadata.verifyOnly ? `code-relax/android/ci-verification/${claims.run_id}/${intentId}.apk`
+        : `code-relax/android/${metadata.versionCode}/Code-Relax-${metadata.sha256.slice(0, 16)}.apk`;
+      const keys = target === 'hap' ? metadata.files.map(f => metadata.verifyOnly
+        ? `code-relax/harmony/ci-verification/${claims.run_id}/${intentId}/${f.name}`
+        : `code-relax/harmony/${metadata.versionCode}/${f.name}`) : [key];
+      row ??= { intentId, identity, metadata, key, keys, status: 'prepared' };
+      save(row);
+      const grant = target === 'hap' ? { uploads: await Promise.all(metadata.files.map(async (f, i) => ({ name: f.name,
+        ...await signUpload(keys[i], f, i === 1 ? 'application/json' : i === 2 ? 'image/png' : 'application/octet-stream') }))) }
+        : await signUpload(key, metadata);
+      reply(200, { ...publicState(row), ...grant }); return;
+    }
+    const match = new RegExp(`^${prefix}/([a-f0-9]{64})(/complete)?$`).exec(req.url || '');
+    if (!match || !((!match[2] && req.method === 'GET') || (match[2] && req.method === 'POST'))) {
+      reply(404, { ok: false, error: 'NOT_FOUND' }); return;
+    }
+    const row = read(match[1]);
+    if (!row || row.identity !== identityKey(claims) || (row.metadata.target || 'android') !== target) { reply(404, { ok: false, error: 'INTENT_NOT_FOUND' }); return; }
+    if (match[2] && row.status === 'prepared') {
+      if (busy) { reply(409, { ok: false, error: 'PUBLICATION_BUSY' }); return; }
+      busy = true; row.status = 'validating'; save(row);
+      void complete(row).finally(() => { busy = false; });
+    }
+    reply(row.status === 'validating' ? 202 : 200, publicState(row));
+  } catch (error) {
+    console.error(JSON.stringify({ event: 'release-api-failed', code: /^[A-Za-z.]+$/.test(error.code || '') ? error.code : 'io-or-provider' }));
+    reply(503, { ok: false, error: 'RELEASE_UNAVAILABLE' });
+  }
+});
+async function complete(row) {
+  const { metadata, key } = row;
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'code-relax-release-'));
+  const apk = path.join(dir, 'release.apk'), json = path.join(dir, 'release.json');
+  const hap = metadata.target === 'hap';
+  const files = hap ? metadata.files : [{ ...metadata, name: 'release.apk' }];
+  let stage = 'download';
+  try {
+    for (const [i, file] of files.entries()) {
+      const ticket = await cosCall('getObjectUrl', { ...object(row.keys?.[i] || key), Sign: true, Method: 'GET', Protocol: 'https:', Expires: 300 });
+      const response = await fetch(ticket.Url, { signal: AbortSignal.timeout(120000) });
+      if (!response.ok || Number(response.headers.get('content-length')) !== file.size) throw Error();
+      let size = 0; const hash = createHash('sha256'), md5 = createHash('md5');
+      await pipeline(Readable.fromWeb(response.body), new Transform({ transform(chunk, encoding, next) {
+        size += chunk.length; if (size > file.size) return next(Error('Oversize'));
+        hash.update(chunk); md5.update(chunk); next(null, chunk);
+      } }), fs.createWriteStream(path.join(dir, file.name), { flags: 'wx', mode: 0o600 }));
+      if (size !== file.size || hash.digest('hex') !== file.sha256 || md5.digest('base64') !== file.contentMd5) throw Error();
+      const unsigned = new URL(ticket.Url); unsigned.search = '';
+      if (!hap && (await fetch(unsigned, { method: 'HEAD', signal: AbortSignal.timeout(15000) })).status !== 403) throw Error();
+    }
+    if (hap) {
+      stage = 'harmony-signature';
+      await verifyHarmony(dir, metadata, readHarmonyConfig());
+      row.result = { sha256: metadata.sha256, versionCode: metadata.versionCode, size: metadata.size };
+      if (metadata.verifyOnly) row.status = 'verified';
+      else { stage = 'harmony-publish'; row.result = await activateHarmony(metadata, storage, row.keys); row.status = 'published'; }
+      save(row); return;
+    }
+    stage = 'signature';
+    const { stdout: signature } = await execute('/usr/bin/apksigner', ['verify', '--print-certs', apk], {
+      timeout: 30000, env: { ...process.env, JAVA_TOOL_OPTIONS: '-Xmx256m' } });
+    const certificates = [...signature.matchAll(/^Signer #\d+ certificate SHA-256 digest: ([a-f0-9]{64})$/gm)];
+    if (certificates.length !== 1 || certificates[0][1] !== metadata.certificateSha256) throw Error();
+    stage = 'identity';
+    const { stdout: badging } = await execute('/usr/bin/aapt', ['dump', 'badging', apk], { timeout: 30000 });
+    const identity = /^package: name='([^']+)' versionCode='(\d+)' versionName='([^']+)'/m.exec(badging);
+    if (!identity || identity[1] !== metadata.packageName || Number(identity[2]) !== metadata.versionCode
+      || identity[3] !== metadata.versionName || /^application-debuggable/m.test(badging)) throw Error();
+    row.result = { sha256: metadata.sha256, versionCode: metadata.versionCode, size: metadata.size };
+    if (metadata.verifyOnly) row.status = 'verified';
+    else {
+      stage = 'publish';
+      fs.writeFileSync(json, JSON.stringify(metadata), { mode: 0o600 });
+      const { stdout } = await execute(process.execPath, [fileURLToPath(new URL('./publish-android-release.mjs', import.meta.url)), apk, json, '--existing-object'], { timeout: 240000 });
+      row.result = JSON.parse(stdout.trim()); row.status = 'published';
+    }
+    save(row);
+  } catch (error) {
+    row.status = 'failed'; row.error = `RELEASE_${stage.toUpperCase()}_FAILED`; save(row);
+    console.error(JSON.stringify({ event: 'release-validation-failed', intentId: row.intentId, stage, code: /^[A-Za-z0-9_.-]+$/.test(error.code || '') ? error.code : 'validation' }));
+  } finally {
+    for (const file of [...files.map(f => path.join(dir, f.name)), json]) fs.rmSync(file, { force: true }); fs.rmdirSync(dir);
+    // Verification objects remain private evidence; the deployment identity has no DeleteObject grant.
+  }
+}
+// A restart never blindly launches an interrupted publisher a second time.
+for (const name of fs.readdirSync(stateDir).filter(x => /^[a-f0-9]{64}\.json$/.test(x))) {
+  const row = read(name.slice(0, -5));
+  if (row.status === 'validating') { row.status = 'failed'; row.error = 'INTERRUPTED_CHECK_LATEST'; save(row); }
+}
+server.requestTimeout = 15000;
+server.listen(45852, '127.0.0.1');
+process.on('SIGTERM', () => { server.close(); const timer = setInterval(() => { if (!busy) { clearInterval(timer); process.exit(0); } }, 250); });

package/dist/bin/self-relay-demo.mjs

@@ -25,7 +25,7 @@ try {
   const health = await client.request('/api/health');
   if (health.status !== 200 || health.body.transportMode !== mode) throw new Error('Relay validation failed');
   console.log(JSON.stringify({ ok: true, simulated: true, mode, relay: demo.relay.url,
-    bridge: demo.bridgeUrl, message: '中继 → 连接器 → 模拟 Bridge 已连通；未连接 Codex，未执行任务。' }, null, 2));
+    bridge: demo.bridgeUrl, message: '中继 → 连接器 → 模拟桌面服务已连通；未连接 Codex，未执行任务。' }, null, 2));
   if (!process.argv.includes('--check')) {
     console.log('验证连接保持运行。Ctrl+C 停止全部模拟进程内服务。');
     await new Promise(resolve => { process.once('SIGINT', resolve); process.once('SIGTERM', resolve); });

package/dist/bin/self-relay-server.mjs

@@ -1,23 +1,29 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import { deviceStore, validId } from '../src/self-relay/device-store.mjs';
+#!/usr/bin/env node
+import fs from 'node:fs';
+import serviceEndpoints from '../shared/service-endpoints.cjs';
+import { deviceStore, validId } from '../src/self-relay/device-store.mjs';
+import { openRelayMysql } from '../src/self-relay/mysql-state.mjs';
 import { startSelfRelay } from '../src/self-relay/server.mjs';
 import { updateDebugAllowlist } from '../src/self-relay/debug-allowlist.mjs';
-
-const keyFile = process.env.RELAY_HOST_KEY_FILE;
-if (!keyFile) throw new Error('RELAY_HOST_KEY_FILE is required');
-const hostKey = fs.readFileSync(keyFile, 'utf8').trim();
-const port = Number(process.env.RELAY_PORT || 45850);
-if (!Number.isInteger(port) || port < 1024 || port > 65535) throw new Error('Invalid RELAY_PORT');
-const stateFile = process.env.RELAY_STATE_FILE;
-if (!stateFile) throw new Error('RELAY_STATE_FILE is required');
+
+const keyFile = process.env.RELAY_HOST_KEY_FILE;
+if (!keyFile) throw new Error('RELAY_HOST_KEY_FILE is required');
+const hostKey = fs.readFileSync(keyFile, 'utf8').trim();
+const port = Number(process.env.RELAY_PORT || 45850);
+if (!Number.isInteger(port) || port < 1024 || port > 65535) throw new Error('Invalid RELAY_PORT');
+const stateFile = process.env.RELAY_STATE_FILE;
+const mysqlConfigFile = process.env.RELAY_MYSQL_CONFIG_FILE;
+const accountConfigFile = process.env.RELAY_ACCOUNT_CONFIG_FILE;
+const longPairingFile = process.env.RELAY_LONG_PAIRING_FILE || '/var/lib/codex-relay/long-pairing.json';
+if (!stateFile && !mysqlConfigFile) throw new Error('RELAY_STATE_FILE or RELAY_MYSQL_CONFIG_FILE is required');
 const debugAllowlistFile = process.env.RELAY_DEBUG_ALLOWLIST_FILE || '/etc/codex-relay/debug-allowlist.json';
 const adminStateFile = process.env.RELAY_ADMIN_STATE_FILE || '/var/lib/codex-relay/admin.json';
 const maxRelaySessions = Number(process.env.RELAY_MAX_RELAY_SESSIONS || 8);
 if (!Number.isSafeInteger(maxRelaySessions) || maxRelaySessions < 1 || maxRelaySessions > 256) throw new Error('Invalid RELAY_MAX_RELAY_SESSIONS');
 const debugCommand = process.argv.find(value => ['--debug-list', '--debug-allow', '--debug-deny'].includes(value));
 if (debugCommand) {
-  const records = deviceStore(stateFile).entries();
+  const database = mysqlConfigFile ? await openRelayMysql(mysqlConfigFile, maxRelaySessions) : null;
+  const records = (database?.devices || deviceStore(stateFile)).entries();
   if (debugCommand === '--debug-list') {
     console.log(JSON.stringify(records.map(record => ({
       deviceId: record.id, status: record.status, clientCount: record.clients.length,
@@ -30,24 +36,31 @@ if (debugCommand) {
     updateDebugAllowlist(debugAllowlistFile, deviceId, debugCommand === '--debug-allow');
     console.log('Debug allowlist updated; restart relay to apply.');
   }
+  if (database) await database.close();
   process.exit(0);
 }
-if (process.argv.includes('--init-state')) { deviceStore(stateFile, { initialize: true }); console.log('Device store initialized'); process.exit(0); }
-const revokeIndex = process.argv.indexOf('--revoke-host');
-if (revokeIndex >= 0) {
-  // Run only with the service stopped: this is an offline administrator operation.
-  if (!process.argv.includes('--offline')) throw new Error('Stop the relay service and supply --offline');
-  const id = process.argv[revokeIndex + 1];
-  if (!validId(id)) throw new Error('Invalid device ID');
-  const store = deviceStore(stateFile), record = store.entries().find(item => item.id === id);
-  if (!record) throw new Error('Device not found');
-  store.save({ ...record, status: 'revoked', clientHash: undefined, clientId: undefined, revision: record.revision + 1, updatedAt: new Date().toISOString() });
-  console.log('Computer and phone authorization revoked'); process.exit(0);
-}
-const relay = await startSelfRelay({ port, hostKey, stateFile, debugAllowlistFile, adminStateFile, maxRelaySessions,
-  publicRelayUrl: process.env.RELAY_PUBLIC_URL || '', appDownloadUrl: process.env.RELAY_APP_DOWNLOAD_URL || '',
+if (process.argv.includes('--init-state')) { if (mysqlConfigFile) throw new Error('Use migrations for MySQL mode'); deviceStore(stateFile, { initialize: true }); console.log('Device store initialized'); process.exit(0); }
+const revokeIndex = process.argv.indexOf('--revoke-host');
+if (revokeIndex >= 0) {
+  // Run only with the service stopped: this is an offline administrator operation.
+  if (!process.argv.includes('--offline')) throw new Error('Stop the relay service and supply --offline');
+  const id = process.argv[revokeIndex + 1];
+  if (!validId(id)) throw new Error('Invalid device ID');
+  const database = mysqlConfigFile ? await openRelayMysql(mysqlConfigFile, maxRelaySessions) : null;
+  const store = database?.devices || deviceStore(stateFile), record = store.entries().find(item => item.id === id);
+  if (!record) throw new Error('Device not found');
+  await store.save({ ...record, status: 'revoked', clients: [], revision: record.revision + 1, updatedAt: new Date().toISOString() });
+  if (database) await database.close();
+  console.log('Computer and phone authorization revoked'); process.exit(0);
+}
+const relay = await startSelfRelay({ port, hostKey, stateFile, mysqlConfigFile, accountConfigFile, debugAllowlistFile, adminStateFile, maxRelaySessions,
+  longPairingFile,
+  androidReleaseConfigFile: process.env.RELAY_ANDROID_RELEASE_CONFIG_FILE,
+  androidReleaseCredentialFile: process.env.CREDENTIALS_DIRECTORY ? `${process.env.CREDENTIALS_DIRECTORY}/tencent-monitor.json` : undefined,
+  usageDiagnosticKeyFile: process.env.RELAY_USAGE_DIAGNOSTIC_KEY_FILE,
+  publicRelayUrl: process.env.RELAY_PUBLIC_URL || serviceEndpoints.relayUrl, appDownloadUrl: process.env.RELAY_APP_DOWNLOAD_URL || serviceEndpoints.installUrl,
   log: entry => console.log(JSON.stringify({ time: new Date().toISOString(), ...entry })) });
-console.log(JSON.stringify({ service: 'codex-self-relay', listen: relay.url, maxConnections: 32, maxRelaySessions,
-  maxFrameMiB: 8, encryption: 'TLS must be supplied by reverse proxy; no end-to-end encryption' }));
-await new Promise(resolve => { process.once('SIGTERM', resolve); process.once('SIGINT', resolve); });
-await relay.close();
+console.log(JSON.stringify({ service: 'codex-self-relay', listen: relay.url, maxConnections: 128, maxRelaySessions,
+  maxFrameMiB: 8, encryption: 'TLS must be supplied by reverse proxy; no end-to-end encryption' }));
+await new Promise(resolve => { process.once('SIGTERM', resolve); process.once('SIGINT', resolve); });
+await relay.close();

package/dist/bin/set-relay-admin-password.mjs

@@ -0,0 +1,11 @@
+import fs from 'node:fs';
+import { randomBytes } from 'node:crypto';
+import { passwordRecord } from '../src/self-relay/admin-auth.mjs';
+
+// Run as the management service user (or root and then chown root:codexrelay).
+// The plaintext is printed once for handoff; only its salted scrypt hash is saved.
+const file = process.argv[2] || '/etc/codex-relay/admin-password.json';
+const password = randomBytes(18).toString('base64url');
+const record = await passwordRecord(password);
+fs.writeFileSync(file, JSON.stringify(record) + '\n', { mode: 0o640, flag: 'wx' });
+console.log(password);

package/dist/build-platform.json

@@ -0,0 +1 @@
+{"layout":"npm-platform-packages","version":"0.1.0-beta.101"}

package/dist/get-shared-service-url.ps1

@@ -1,6 +1,14 @@
-# Detect the Desktop connection, not merely a listening standalone server.
-$connections = @(Get-NetTCPConnection -RemotePort 45839 -State Established -ErrorAction SilentlyContinue | Where-Object {
+param([Parameter(Mandatory=$true)][string]$AppServerUrl)
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
+if ($AppServerUrl -cnotmatch '^ws://127\.0\.0\.1:([1-9][0-9]{0,4})\z' -or [int]$Matches[1] -gt 65535) { throw 'Invalid managed app-server URL.' }
+$port = [int]$Matches[1]
+$package = Get-AppxPackage OpenAI.Codex | Select-Object -First 1
+if (-not $package) { exit }
+$desktop = Join-Path $package.InstallLocation 'app/ChatGPT.exe'
+# Match an installed Desktop process connected to the selected loopback port.
+$connections = @(Get-NetTCPConnection -RemotePort $port -State Established -ErrorAction SilentlyContinue | Where-Object {
     $_.RemoteAddress -eq '127.0.0.1' -and
-    (Get-Process -Id $_.OwningProcess -ErrorAction SilentlyContinue).ProcessName -eq 'ChatGPT'
+    (Get-Process -Id $_.OwningProcess -ErrorAction SilentlyContinue).Path -eq $desktop
 })
-if ($connections.Count) { 'ws://127.0.0.1:45839' }
+if ($connections.Count) { $AppServerUrl }