@nextclaw/remote 0.1.14 → 0.1.16

package/dist/index.d.ts

@@ -206,4 +206,17 @@ declare class RemoteServiceModule {
     stop(): Promise<void>;
 }
 
-export { type RegisteredRemoteDevice, type RelayRequestFrame, type RemoteConnectCommandOptions, RemoteConnector, type RemoteConnectorRunOptions, type RemoteDoctorCommandOptions, type RemoteEnableCommandOptions, type RemoteLogger, RemotePlatformClient, type RemotePlatformClientDeps, RemoteRelayBridge, type RemoteRunContext, RemoteRuntimeActions, type RemoteRuntimeState, RemoteServiceModule, type RemoteServiceStateView, type RemoteStatusCommandOptions, type RemoteStatusSnapshot, RemoteStatusStore, type RemoteStatusWriter, buildConfiguredRemoteState, delay, normalizeOptionalString, redactWsUrl, registerRemoteCommands, resolveRemoteStatusSnapshot };
+type PlatformSessionTokenState = {
+    valid: false;
+    reason: "missing" | "malformed" | "expired";
+    payload: Record<string, unknown> | null;
+} | {
+    valid: true;
+    reason: "valid";
+    payload: Record<string, unknown>;
+};
+declare function decodePlatformSessionTokenPayload(token: string): Record<string, unknown> | null;
+declare function readPlatformSessionTokenState(token: string | null | undefined): PlatformSessionTokenState;
+declare function isValidPlatformSessionToken(token: string | null | undefined): token is string;
+
+export { type PlatformSessionTokenState, type RegisteredRemoteDevice, type RelayRequestFrame, type RemoteConnectCommandOptions, RemoteConnector, type RemoteConnectorRunOptions, type RemoteDoctorCommandOptions, type RemoteEnableCommandOptions, type RemoteLogger, RemotePlatformClient, type RemotePlatformClientDeps, RemoteRelayBridge, type RemoteRunContext, RemoteRuntimeActions, type RemoteRuntimeState, RemoteServiceModule, type RemoteServiceStateView, type RemoteStatusCommandOptions, type RemoteStatusSnapshot, RemoteStatusStore, type RemoteStatusWriter, buildConfiguredRemoteState, decodePlatformSessionTokenPayload, delay, isValidPlatformSessionToken, normalizeOptionalString, readPlatformSessionTokenState, redactWsUrl, registerRemoteCommands, resolveRemoteStatusSnapshot };

package/dist/index.js

@@ -5,7 +5,7 @@ function registerRemoteCommands(program, runtime) {
   remote.command("disable").description("Disable service-managed remote access").action(async () => runtime.disable());
   remote.command("status").description("Show remote access status").option("--json", "Print JSON").action(async (opts) => runtime.status(opts));
   remote.command("doctor").description("Run remote access diagnostics").option("--json", "Print JSON").action(async (opts) => runtime.doctor(opts));
-  remote.command("connect").description("Foreground debug mode: register this machine and keep the connector online").option("--api-base <url>", "Platform API base (supports /v1 suffix)").option("--local-origin <url>", "Local NextClaw UI origin (default: active service or http://127.0.0.1:18791)").option("--name <name>", "Device display name").option("--once", "Connect once without auto-reconnect", false).action(async (opts) => runtime.connect(opts));
+  remote.command("connect").description("Foreground debug mode: register this machine and keep the connector online").option("--api-base <url>", "Platform API base (supports /v1 suffix)").option("--local-origin <url>", "Local NextClaw UI origin (default: active service or http://127.0.0.1:55667)").option("--name <name>", "Device display name").option("--once", "Connect once without auto-reconnect", false).action(async (opts) => runtime.connect(opts));
 }
 
 // src/remote-runtime-actions.ts
@@ -53,6 +53,68 @@ var RemoteRuntimeActions = class {
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { dirname, join } from "path";
 import { hostname, platform as readPlatform } from "os";
+
+// src/platform-session-token.ts
+function decodeBase64UrlSegment(segment) {
+  try {
+    return Buffer.from(segment, "base64url").toString("utf-8");
+  } catch {
+    return null;
+  }
+}
+function decodePlatformSessionTokenPayload(token) {
+  const segments = token.split(".");
+  if (segments.length !== 3 || segments[0] !== "nca" || !segments[1]) {
+    return null;
+  }
+  const raw = decodeBase64UrlSegment(segments[1]);
+  if (!raw) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    return typeof parsed === "object" && parsed !== null ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+function readPlatformSessionTokenState(token) {
+  if (typeof token !== "string" || token.trim().length === 0) {
+    return {
+      valid: false,
+      reason: "missing",
+      payload: null
+    };
+  }
+  const trimmed = token.trim();
+  const payload = decodePlatformSessionTokenPayload(trimmed);
+  if (!payload) {
+    return {
+      valid: false,
+      reason: "malformed",
+      payload: null
+    };
+  }
+  const exp = typeof payload.exp === "number" && Number.isFinite(payload.exp) ? payload.exp : Number.NaN;
+  const now = Math.floor(Date.now() / 1e3);
+  if (!Number.isFinite(exp) || exp <= now) {
+    return {
+      valid: false,
+      reason: "expired",
+      payload
+    };
+  }
+  return {
+    valid: true,
+    reason: "valid",
+    payload
+  };
+}
+function isValidPlatformSessionToken(token) {
+  return readPlatformSessionTokenState(token).valid;
+}
+
+// src/remote-platform-client.ts
 function ensureDir(path) {
   mkdirSync(path, { recursive: true });
 }
@@ -169,16 +231,23 @@ var RemotePlatformClient = class {
     const providers = config.providers;
     const nextclawProvider = providers.nextclaw;
     const token = typeof nextclawProvider?.apiKey === "string" ? nextclawProvider.apiKey.trim() : "";
-    if (!token) {
+    const tokenState = readPlatformSessionTokenState(token);
+    if (tokenState.reason === "missing") {
       throw new Error('NextClaw platform token is missing. Run "nextclaw login" first.');
     }
+    if (tokenState.reason === "expired") {
+      throw new Error('NextClaw platform token expired. Run "nextclaw login" or browser sign-in again.');
+    }
+    if (tokenState.reason === "malformed") {
+      throw new Error('NextClaw platform token is invalid. Run "nextclaw login" again.');
+    }
     const configuredApiBase = normalizeOptionalString(config.remote.platformApiBase) ?? (typeof nextclawProvider?.apiBase === "string" ? nextclawProvider.apiBase.trim() : "");
     const rawApiBase = normalizeOptionalString(opts.apiBase) ?? configuredApiBase;
     if (!rawApiBase) {
       throw new Error("Platform API base is missing. Pass --api-base, run nextclaw login, or set remote.platformApiBase.");
     }
     const platformBase = this.deps.resolvePlatformBase(rawApiBase);
-    return { platformBase, token, config };
+    return { platformBase, token: token.trim(), config };
   }
   resolveLocalOrigin(config, opts) {
     const explicitOrigin = normalizeOptionalString(opts.localOrigin);
@@ -189,7 +258,7 @@ var RemotePlatformClient = class {
     if (state && this.deps.isProcessRunning?.(state.pid) && Number.isFinite(state.uiPort)) {
       return `http://127.0.0.1:${state.uiPort}`;
     }
-    const configuredPort = typeof config.ui?.port === "number" && Number.isFinite(config.ui.port) ? config.ui.port : 18791;
+    const configuredPort = typeof config.ui?.port === "number" && Number.isFinite(config.ui.port) ? config.ui.port : 55667;
     return `http://127.0.0.1:${configuredPort}`;
   }
   resolveDisplayName(config, opts) {
@@ -656,8 +725,11 @@ export {
   RemoteServiceModule,
   RemoteStatusStore,
   buildConfiguredRemoteState,
+  decodePlatformSessionTokenPayload,
   delay,
+  isValidPlatformSessionToken,
   normalizeOptionalString,
+  readPlatformSessionTokenState,
   redactWsUrl,
   registerRemoteCommands,
   resolveRemoteStatusSnapshot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/remote",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "private": false,
   "description": "Remote access runtime for NextClaw device registration, relay bridging, and service-managed connectivity.",
   "type": "module",
@@ -29,8 +29,8 @@
   ],
   "dependencies": {
     "commander": "^12.1.0",
-    "@nextclaw/core": "0.9.7",
-    "@nextclaw/server": "0.10.18"
+    "@nextclaw/server": "0.10.20",
+    "@nextclaw/core": "0.9.8"
   },
   "devDependencies": {
     "@types/node": "^20.17.6",