@nextclaw/service 0.2.12 → 0.2.14

package/dist/services/platform-auth/platform-auth-commands.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-auth-commands.service.js","names":[],"sources":["../../../src/services/platform-auth/platform-auth-commands.service.ts"],"sourcesContent":["import { getConfigPath, loadConfig, saveConfig } from \"@nextclaw/core\";\nimport { createInterface } from \"node:readline\";\nimport { buildPlatformApiBaseErrorMessage, resolvePlatformApiBase } from \"@nextclaw-service/controllers/commands/remote-command.controller.js\";\nimport {\n  readBrowserAuthPollPayload,\n  readBrowserAuthStartPayload,\n  readLoginPayload,\n  readPlatformAuthResultPayload,\n  readPlatformErrorMessage,\n  readPlatformUserPayload\n} from \"@nextclaw-service/utils/platform-auth/payload.utils.js\";\nimport { printAccountStatus, printUsernameUpdated, toAccountStatusView } from \"./account-status.service.js\";\nimport type { AccountCommandOptions, AccountSetUsernameCommandOptions, LoginCommandOptions } from \"@nextclaw-service/types/cli.types.js\";\nimport { openBrowser, prompt } from \"@nextclaw-service/utils/cli.utils.js\";\n\ntype NextclawProviderConfig = {\n  displayName?: string;\n  apiKey?: string;\n  apiBase?: string | null;\n  extraHeaders?: Record<string, string> | null;\n  wireApi?: \"auto\" | \"chat\" | \"responses\";\n  models?: string[];\n};\n\nexport type PlatformLoginResult = {\n  token: string;\n  role: string;\n  email: string;\n  platformBase: string;\n  v1Base: string;\n};\n\nexport type PlatformUserView = {\n  id: string;\n  email: string;\n  username: string | null;\n  role: string;\n};\n\nexport type PlatformMeResult = {\n  user: PlatformUserView;\n  token: string;\n  platformBase: string;\n  v1Base: string;\n};\n\nexport type PlatformBrowserAuthStartResult = {\n  sessionId: string;\n  verificationUri: string;\n  expiresAt: string;\n  intervalMs: number;\n  platformBase: string;\n  v1Base: string;\n};\n\nexport type PlatformBrowserAuthPollResult =\n  | {\n    status: \"pending\";\n    nextPollMs: number;\n  }\n  | {\n    status: \"authorized\";\n    token: string;\n    role: string;\n    email: string;\n    platformBase: string;\n    v1Base: string;\n  }\n  | {\n    status: \"expired\";\n    message: string;\n  };\n\nfunction resolveProviderConfig(opts: LoginCommandOptions): {\n  configPath: string;\n  config: ReturnType<typeof loadConfig>;\n  providers: Record<string, NextclawProviderConfig>;\n  nextclawProvider: NextclawProviderConfig;\n  platformBase: string;\n  v1Base: string;\n  inputApiBase: string;\n} {\n  const configPath = getConfigPath();\n  const config = loadConfig(configPath);\n  const providers = config.providers as Record<string, NextclawProviderConfig>;\n  const nextclawProvider = providers.nextclaw ?? {\n    displayName: \"\",\n    apiKey: \"\",\n    apiBase: null,\n    extraHeaders: null,\n    wireApi: \"auto\",\n    models: []\n  };\n  const configuredApiBase =\n    typeof nextclawProvider.apiBase === \"string\" && nextclawProvider.apiBase.trim().length > 0\n      ? nextclawProvider.apiBase.trim()\n      : \"https://ai-gateway-api.nextclaw.io/v1\";\n  const requestedApiBase =\n    typeof opts.apiBase === \"string\" && opts.apiBase.trim().length > 0\n      ? opts.apiBase.trim()\n      : configuredApiBase;\n  const { platformBase, v1Base, inputApiBase } = resolvePlatformApiBase({\n    explicitApiBase: requestedApiBase,\n    fallbackApiBase: \"https://ai-gateway-api.nextclaw.io/v1\"\n  });\n  return {\n    configPath,\n    config,\n    providers,\n    nextclawProvider,\n    platformBase,\n    v1Base,\n    inputApiBase\n  };\n}\n\nasync function resolveCredentials(opts: LoginCommandOptions): Promise<{ email: string; password: string }> {\n  let email = typeof opts.email === \"string\" ? opts.email.trim() : \"\";\n  let password = typeof opts.password === \"string\" ? opts.password : \"\";\n  if (email && password) {\n    return { email, password };\n  }\n\n  const rl = createInterface({\n    input: process.stdin,\n    output: process.stdout\n  });\n  try {\n    if (!email) {\n      email = (await prompt(rl, \"Email: \")).trim();\n    }\n    if (!password) {\n      password = await prompt(rl, \"Password: \");\n    }\n  } finally {\n    rl.close();\n  }\n\n  if (!email || !password) {\n    throw new Error(\"Email and password are required.\");\n  }\n  return { email, password };\n}\n\nfunction persistPlatformToken(params: {\n  configPath: string;\n  config: ReturnType<typeof loadConfig>;\n  providers: Record<string, NextclawProviderConfig>;\n  nextclawProvider: NextclawProviderConfig;\n  v1Base: string;\n  token: string;\n}): void {\n  const { configPath, config, providers, nextclawProvider, v1Base, token } = params;\n  nextclawProvider.apiBase = v1Base;\n  nextclawProvider.apiKey = token;\n  providers.nextclaw = nextclawProvider;\n  saveConfig(config, configPath);\n}\n\nexport class PlatformAuthCommands {\n  private shouldUseBrowserLogin = (opts: LoginCommandOptions): boolean => {\n    const email = typeof opts.email === \"string\" ? opts.email.trim() : \"\";\n    const password = typeof opts.password === \"string\" ? opts.password : \"\";\n    return !email && !password;\n  };\n\n  private waitFor = async (delayMs: number): Promise<void> => {\n    await new Promise((resolve) => setTimeout(resolve, delayMs));\n  };\n\n  private formatLoginDeadline = (expiresAt: string): string => {\n    const value = Date.parse(expiresAt);\n    return Number.isNaN(value) ? expiresAt : new Date(value).toLocaleString();\n  };\n\n  private printLoginSuccess = (result: PlatformLoginResult): void => {\n    console.log(`✓ Logged in to NextClaw platform (${result.platformBase})`);\n    console.log(`✓ Account: ${result.email} (${result.role})`);\n    console.log(\"✓ Token saved into providers.nextclaw.apiKey\");\n  };\n\n  private printBrowserLoginIntro = (params: {\n    verificationUri: string;\n    expiresAt: string;\n    open: boolean;\n    openedBrowser: boolean;\n  }): void => {\n    const {\n      expiresAt,\n      open,\n      openedBrowser,\n      verificationUri\n    } = params;\n    const expiresText = this.formatLoginDeadline(expiresAt);\n    console.log(\"NextClaw browser sign-in\");\n    console.log(`Open this link to continue: ${verificationUri}`);\n    if (open) {\n      if (openedBrowser) {\n        console.log(\"✓ Opened the default browser. Finish sign-in there and this terminal will complete automatically.\");\n      } else {\n        console.log(\"Browser did not open automatically. Open the link above in any browser to continue.\");\n      }\n    } else {\n      console.log(\"Automatic browser opening is disabled. Open the link above in any browser to continue.\");\n    }\n    console.log(\"This link can be opened on this machine or on another device if your CLI is running remotely.\");\n    console.log(`Waiting for authorization until ${expiresText}...`);\n  };\n\n  private waitForBrowserLoginResult = async (params: {\n    apiBase?: string;\n    sessionId: string;\n  }): Promise<PlatformLoginResult> => {\n    while (true) {\n      const result = await this.pollBrowserAuth({\n        apiBase: params.apiBase,\n        sessionId: params.sessionId\n      });\n      if (result.status === \"pending\") {\n        await this.waitFor(result.nextPollMs);\n        continue;\n      }\n      if (result.status === \"expired\") {\n        throw new Error(`${result.message} Run \\`nextclaw login\\` again to generate a new sign-in link.`);\n      }\n      return {\n        token: result.token,\n        role: result.role,\n        email: result.email,\n        platformBase: result.platformBase,\n        v1Base: result.v1Base\n      };\n    }\n  };\n\n  private loginWithBrowserResult = async (opts: LoginCommandOptions = {}): Promise<PlatformLoginResult> => {\n    const startResult = await this.startBrowserAuth({\n      apiBase: opts.apiBase\n    });\n    const shouldOpenBrowser = opts.open !== false;\n    const openedBrowser = shouldOpenBrowser ? openBrowser(startResult.verificationUri) : false;\n    this.printBrowserLoginIntro({\n      verificationUri: startResult.verificationUri,\n      expiresAt: startResult.expiresAt,\n      open: shouldOpenBrowser,\n      openedBrowser\n    });\n    const result = await this.waitForBrowserLoginResult({\n      apiBase: opts.apiBase,\n      sessionId: startResult.sessionId\n    });\n    console.log(\"✓ Browser authorization completed.\");\n    return result;\n  };\n\n  private readStoredToken = (params: { apiBase?: string } = {}): {\n    configPath: string;\n    config: ReturnType<typeof loadConfig>;\n    providers: Record<string, NextclawProviderConfig>;\n    nextclawProvider: NextclawProviderConfig;\n    platformBase: string;\n    v1Base: string;\n    inputApiBase: string;\n    token: string;\n  } => {\n    const resolved = resolveProviderConfig({ apiBase: params.apiBase });\n    const token = resolved.nextclawProvider.apiKey?.trim() ?? \"\";\n    if (!token) {\n      throw new Error(\"Not logged in. Run `nextclaw login` first.\");\n    }\n    return {\n      ...resolved,\n      token\n    };\n  };\n\n  loginResult = async (opts: LoginCommandOptions = {}): Promise<PlatformLoginResult> => {\n    const { configPath, config, providers, nextclawProvider, platformBase, v1Base, inputApiBase } = resolveProviderConfig(opts);\n    const { email, password } = await resolveCredentials(opts);\n    const response = await fetch(`${platformBase}/platform/auth/login`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify({ email, password })\n    });\n    const raw = await response.text();\n\n    if (!response.ok) {\n      throw new Error(buildPlatformApiBaseErrorMessage(inputApiBase, readPlatformErrorMessage(raw, response.status)));\n    }\n\n    const { token, role } = readLoginPayload(raw);\n    persistPlatformToken({\n      configPath,\n      config,\n      providers,\n      nextclawProvider,\n      v1Base,\n      token\n    });\n\n    return {\n      token,\n      role,\n      email,\n      platformBase,\n      v1Base\n    };\n  };\n\n  startBrowserAuth = async (opts: Pick<LoginCommandOptions, \"apiBase\"> = {}): Promise<PlatformBrowserAuthStartResult> => {\n    const { platformBase, v1Base, inputApiBase } = resolveProviderConfig(opts);\n    const response = await fetch(`${platformBase}/platform/auth/browser/start`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify({})\n    });\n    const raw = await response.text();\n    if (!response.ok) {\n      throw new Error(buildPlatformApiBaseErrorMessage(inputApiBase, readPlatformErrorMessage(raw, response.status)));\n    }\n    const result = readBrowserAuthStartPayload(raw);\n    return {\n      ...result,\n      platformBase,\n      v1Base\n    };\n  };\n\n  pollBrowserAuth = async (params: {\n    apiBase?: string;\n    sessionId: string;\n  }): Promise<PlatformBrowserAuthPollResult> => {\n    const { configPath, config, providers, nextclawProvider, platformBase, v1Base, inputApiBase } = resolveProviderConfig({\n      apiBase: params.apiBase\n    });\n    const response = await fetch(`${platformBase}/platform/auth/browser/poll`, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify({\n        sessionId: params.sessionId\n      })\n    });\n    const raw = await response.text();\n    if (!response.ok) {\n      throw new Error(buildPlatformApiBaseErrorMessage(inputApiBase, readPlatformErrorMessage(raw, response.status)));\n    }\n    const result = readBrowserAuthPollPayload(raw);\n    if (result.status === \"pending\") {\n      return {\n        status: \"pending\",\n        nextPollMs: result.nextPollMs ?? 1500\n      };\n    }\n    if (result.status === \"expired\") {\n      return {\n        status: \"expired\",\n        message: result.message ?? \"Authorization session expired.\"\n      };\n    }\n\n    persistPlatformToken({\n      configPath,\n      config,\n      providers,\n      nextclawProvider,\n      v1Base,\n      token: result.token ?? \"\"\n    });\n    return {\n      status: \"authorized\",\n      token: result.token ?? \"\",\n      role: result.role ?? \"user\",\n      email: result.email ?? \"\",\n      platformBase,\n      v1Base\n    };\n  };\n\n  login = async (opts: LoginCommandOptions = {}): Promise<void> => {\n    const result = this.shouldUseBrowserLogin(opts)\n      ? await this.loginWithBrowserResult(opts)\n      : await this.loginResult(opts);\n    this.printLoginSuccess(result);\n  };\n\n  me = async (params: { apiBase?: string } = {}): Promise<PlatformMeResult> => {\n    const { platformBase, v1Base, inputApiBase, token } = this.readStoredToken(params);\n    const response = await fetch(`${platformBase}/platform/auth/me`, {\n      headers: {\n        Authorization: `Bearer ${token}`\n      }\n    });\n    const raw = await response.text();\n    if (!response.ok) {\n      throw new Error(buildPlatformApiBaseErrorMessage(inputApiBase, readPlatformErrorMessage(raw, response.status)));\n    }\n    return {\n      user: readPlatformUserPayload(raw),\n      token,\n      platformBase,\n      v1Base\n    };\n  };\n\n  updateProfile = async (params: { username: string; apiBase?: string }): Promise<PlatformMeResult> => {\n    const {\n      configPath,\n      config,\n      providers,\n      nextclawProvider,\n      platformBase,\n      v1Base,\n      inputApiBase,\n      token\n    } = this.readStoredToken(params);\n    const response = await fetch(`${platformBase}/platform/auth/profile`, {\n      method: \"PATCH\",\n      headers: {\n        Authorization: `Bearer ${token}`,\n        \"Content-Type\": \"application/json\"\n      },\n      body: JSON.stringify({\n        username: params.username\n      })\n    });\n    const raw = await response.text();\n    if (!response.ok) {\n      throw new Error(buildPlatformApiBaseErrorMessage(inputApiBase, readPlatformErrorMessage(raw, response.status)));\n    }\n    const result = readPlatformAuthResultPayload(raw);\n    persistPlatformToken({\n      configPath,\n      config,\n      providers,\n      nextclawProvider,\n      v1Base,\n      token: result.token\n    });\n    return {\n      user: result.user,\n      token: result.token,\n      platformBase,\n      v1Base\n    };\n  };\n\n  logout = (): { cleared: boolean } => {\n    const { configPath, config, providers, nextclawProvider } = resolveProviderConfig({});\n    const cleared = Boolean(nextclawProvider.apiKey?.trim());\n    nextclawProvider.apiKey = \"\";\n    providers.nextclaw = nextclawProvider;\n    saveConfig(config, configPath);\n    return { cleared };\n  };\n\n  accountStatus = async (opts: AccountCommandOptions = {}): Promise<void> => {\n    const result = await this.me({ apiBase: opts.apiBase });\n    const view = toAccountStatusView(result);\n    if (opts.json) {\n      console.log(JSON.stringify(view, null, 2));\n      return;\n    }\n    printAccountStatus(view);\n  };\n\n  accountSetUsername = async (opts: AccountSetUsernameCommandOptions & { username: string }): Promise<void> => {\n    const result = await this.updateProfile({\n      apiBase: opts.apiBase,\n      username: opts.username\n    });\n    const view = toAccountStatusView(result);\n    if (opts.json) {\n      console.log(JSON.stringify(view, null, 2));\n      return;\n    }\n    printUsernameUpdated(view);\n    printAccountStatus(view);\n  };\n}\n"],"mappings":"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"}

package/dist/services/remote/remote-access-host.service.d.ts

@@ -0,0 +1,42 @@
+import { PlatformAuthCommands } from "../platform-auth/platform-auth-commands.service.js";
+import { RemoteCommands } from "../../controllers/commands/remote-command.controller.js";
+import { RemoteAccessHostServiceCommands, RemoteRuntimeController } from "./remote-service-control.service.js";
+import { RemoteAccessView, RemoteBrowserAuthPollRequest, RemoteBrowserAuthPollResult, RemoteBrowserAuthStartRequest, RemoteBrowserAuthStartResult, RemoteDoctorView, RemoteServiceAction, RemoteServiceActionResult, RemoteSettingsUpdateRequest, UiRemoteAccessHost } from "@nextclaw/server";
+
+//#region src/services/remote/remote-access-host.service.d.ts
+declare class RemoteAccessHost implements UiRemoteAccessHost {
+  private readonly deps;
+  constructor(deps: {
+    serviceCommands: RemoteAccessHostServiceCommands;
+    requestManagedServiceRestart: (options?: {
+      uiPort?: number;
+      reason?: string;
+    }) => Promise<void>;
+    remoteCommands: RemoteCommands;
+    platformAuthCommands: PlatformAuthCommands;
+    currentUi?: {
+      host: string;
+      port: number;
+    };
+    remoteRuntimeController?: RemoteRuntimeController | null;
+  });
+  getStatus: () => RemoteAccessView;
+  login: (input: {
+    email: string;
+    password: string;
+    apiBase?: string;
+  }) => Promise<RemoteAccessView>;
+  startBrowserAuth: (input: RemoteBrowserAuthStartRequest) => Promise<RemoteBrowserAuthStartResult>;
+  pollBrowserAuth: (input: RemoteBrowserAuthPollRequest) => Promise<RemoteBrowserAuthPollResult>;
+  logout: () => RemoteAccessView;
+  updateSettings: (input: RemoteSettingsUpdateRequest) => RemoteAccessView;
+  runDoctor: () => Promise<RemoteDoctorView>;
+  controlService: (action: RemoteServiceAction) => Promise<RemoteServiceActionResult>;
+  private readAccountView;
+  updateProfile: (input: {
+    username: string;
+  }) => Promise<RemoteAccessView>;
+}
+//#endregion
+export { RemoteAccessHost };
+//# sourceMappingURL=remote-access-host.service.d.ts.map

package/dist/services/remote/remote-access-host.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-access-host.service.d.ts","names":[],"sources":["../../../src/services/remote/remote-access-host.service.ts"],"mappings":";;;;;;cAmDa,gBAAA,YAA4B,kBAAA;EAAA,iBAEpB,IAAA;cAAA,IAAA;IACf,eAAA,EAAiB,+BAAA;IACjB,4BAAA,GAA+B,OAAA;MAAY,MAAA;MAAiB,MAAA;IAAA,MAAsB,OAAA;IAClF,cAAA,EAAgB,cAAA;IAChB,oBAAA,EAAsB,oBAAA;IACtB,SAAA;MACE,IAAA;MACA,IAAA;IAAA;IAEF,uBAAA,GAA0B,uBAAA;EAAA;EAI9B,SAAA,QAAgB,gBAAA;EAuBhB,KAAA,GAAe,KAAA;IACb,KAAA;IACA,QAAA;IACA,OAAA;EAAA,MACE,OAAA,CAAQ,gBAAA;EAKZ,gBAAA,GAA0B,KAAA,EAAO,6BAAA,KAAgC,OAAA,CAAQ,4BAAA;EAYzE,eAAA,GAAyB,KAAA,EAAO,4BAAA,KAA+B,OAAA,CAAQ,2BAAA;EAmBvE,MAAA,QAAa,gBAAA;EAKb,cAAA,GAAkB,KAAA,EAAO,2BAAA,KAA8B,gBAAA;EASvD,SAAA,QAAsB,OAAA,CAAQ,gBAAA;EAY9B,cAAA,GAAwB,MAAA,EAAQ,mBAAA,KAAsB,OAAA,CAAQ,yBAAA;EAAA,QAItD,eAAA;EA4BR,aAAA,GAAuB,KAAA;IAAS,QAAA;EAAA,MAAqB,OAAA,CAAQ,gBAAA;AAAA"}

package/dist/services/remote/remote-access-host.service.js

@@ -0,0 +1,128 @@
+import { controlRemoteService, resolveRemoteServiceView } from "./remote-service-control.service.js";
+import { getConfigPath, loadConfig } from "@nextclaw/core";
+import { readPlatformSessionTokenState } from "@nextclaw/remote";
+//#region src/services/remote/remote-access-host.service.ts
+function normalizeOptionalString(value) {
+	if (typeof value !== "string") return null;
+	const trimmed = value.trim();
+	return trimmed.length > 0 ? trimmed : null;
+}
+function toRemoteRuntimeView(runtime) {
+	if (!runtime) return null;
+	return {
+		enabled: runtime.enabled,
+		mode: runtime.mode,
+		state: runtime.state,
+		deviceId: runtime.deviceId,
+		deviceName: runtime.deviceName,
+		platformBase: runtime.platformBase,
+		localOrigin: runtime.localOrigin,
+		lastConnectedAt: runtime.lastConnectedAt,
+		lastError: runtime.lastError,
+		updatedAt: runtime.updatedAt
+	};
+}
+var RemoteAccessHost = class {
+	constructor(deps) {
+		this.deps = deps;
+	}
+	getStatus = () => {
+		const config = loadConfig(getConfigPath());
+		const status = this.deps.remoteCommands.getStatusView();
+		return {
+			account: this.readAccountView({
+				token: normalizeOptionalString(config.providers.nextclaw?.apiKey),
+				apiBase: normalizeOptionalString(config.providers.nextclaw?.apiBase),
+				platformBase: status.platformBase
+			}),
+			settings: {
+				enabled: config.remote.enabled,
+				deviceName: config.remote.deviceName,
+				platformApiBase: config.remote.platformApiBase
+			},
+			service: resolveRemoteServiceView(this.deps.currentUi),
+			localOrigin: status.localOrigin,
+			configuredEnabled: status.configuredEnabled,
+			platformBase: status.platformBase,
+			runtime: toRemoteRuntimeView(status.runtime)
+		};
+	};
+	login = async (input) => {
+		await this.deps.platformAuthCommands.loginResult(input);
+		return this.getStatus();
+	};
+	startBrowserAuth = async (input) => {
+		const result = await this.deps.platformAuthCommands.startBrowserAuth({ apiBase: input.apiBase });
+		return {
+			sessionId: result.sessionId,
+			verificationUri: result.verificationUri,
+			expiresAt: result.expiresAt,
+			intervalMs: result.intervalMs
+		};
+	};
+	pollBrowserAuth = async (input) => {
+		const config = loadConfig(getConfigPath());
+		const result = await this.deps.platformAuthCommands.pollBrowserAuth({
+			apiBase: normalizeOptionalString(input.apiBase) ?? normalizeOptionalString(config.remote.platformApiBase) ?? normalizeOptionalString(config.providers.nextclaw?.apiBase) ?? void 0,
+			sessionId: input.sessionId
+		});
+		if (result.status !== "authorized") return result;
+		return {
+			status: "authorized",
+			email: result.email,
+			role: result.role
+		};
+	};
+	logout = () => {
+		this.deps.platformAuthCommands.logout();
+		return this.getStatus();
+	};
+	updateSettings = (input) => {
+		this.deps.remoteCommands.updateConfig({
+			enabled: input.enabled,
+			apiBase: input.platformApiBase,
+			name: input.deviceName
+		});
+		return this.getStatus();
+	};
+	runDoctor = async () => {
+		const report = await this.deps.remoteCommands.getDoctorView();
+		return {
+			generatedAt: report.generatedAt,
+			checks: report.checks,
+			snapshot: {
+				configuredEnabled: report.snapshot.configuredEnabled,
+				runtime: toRemoteRuntimeView(report.snapshot.runtime)
+			}
+		};
+	};
+	controlService = async (action) => {
+		return controlRemoteService(action, this.deps);
+	};
+	readAccountView = (params) => {
+		const { apiBase, platformBase, token } = params;
+		const tokenState = readPlatformSessionTokenState(token);
+		if (!tokenState.valid) return {
+			loggedIn: false,
+			apiBase,
+			platformBase
+		};
+		const payload = tokenState.payload;
+		return {
+			loggedIn: true,
+			email: typeof payload?.email === "string" ? payload.email : void 0,
+			username: typeof payload?.username === "string" ? payload.username : void 0,
+			role: typeof payload?.role === "string" ? payload.role : void 0,
+			apiBase,
+			platformBase
+		};
+	};
+	updateProfile = async (input) => {
+		await this.deps.platformAuthCommands.updateProfile({ username: input.username });
+		return this.getStatus();
+	};
+};
+//#endregion
+export { RemoteAccessHost };
+
+//# sourceMappingURL=remote-access-host.service.js.map

package/dist/services/remote/remote-access-host.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-access-host.service.js","names":[],"sources":["../../../src/services/remote/remote-access-host.service.ts"],"sourcesContent":["import { getConfigPath, loadConfig } from \"@nextclaw/core\";\nimport { readPlatformSessionTokenState } from \"@nextclaw/remote\";\nimport type {\n  RemoteAccessView,\n  RemoteAccountView,\n  RemoteBrowserAuthPollRequest,\n  RemoteBrowserAuthPollResult,\n  RemoteBrowserAuthStartRequest,\n  RemoteBrowserAuthStartResult,\n  RemoteDoctorView,\n  RemoteRuntimeView,\n  RemoteServiceAction,\n  RemoteServiceActionResult,\n  RemoteSettingsUpdateRequest,\n  UiRemoteAccessHost\n} from \"@nextclaw/server\";\nimport type { PlatformAuthCommands } from \"@nextclaw-service/controllers/commands/platform-auth-command.controller.js\";\nimport type { RemoteCommands } from \"@nextclaw-service/controllers/commands/remote-command.controller.js\";\nimport {\n  controlRemoteService,\n  resolveRemoteServiceView,\n  type RemoteAccessHostServiceCommands,\n  type RemoteRuntimeController\n} from \"./remote-service-control.service.js\";\n\nfunction normalizeOptionalString(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : null;\n}\n\nfunction toRemoteRuntimeView(runtime: ReturnType<RemoteCommands[\"getStatusView\"]>[\"runtime\"]): RemoteRuntimeView | null {\n  if (!runtime) {\n    return null;\n  }\n  return {\n    enabled: runtime.enabled,\n    mode: runtime.mode,\n    state: runtime.state,\n    deviceId: runtime.deviceId,\n    deviceName: runtime.deviceName,\n    platformBase: runtime.platformBase,\n    localOrigin: runtime.localOrigin,\n    lastConnectedAt: runtime.lastConnectedAt,\n    lastError: runtime.lastError,\n    updatedAt: runtime.updatedAt\n  };\n}\n\nexport class RemoteAccessHost implements UiRemoteAccessHost {\n  constructor(\n    private readonly deps: {\n      serviceCommands: RemoteAccessHostServiceCommands;\n      requestManagedServiceRestart: (options?: { uiPort?: number; reason?: string }) => Promise<void>;\n      remoteCommands: RemoteCommands;\n      platformAuthCommands: PlatformAuthCommands;\n      currentUi?: {\n        host: string;\n        port: number;\n      };\n      remoteRuntimeController?: RemoteRuntimeController | null;\n    }\n  ) {}\n\n  getStatus = (): RemoteAccessView => {\n    const config = loadConfig(getConfigPath());\n    const status = this.deps.remoteCommands.getStatusView();\n    const account = this.readAccountView({\n      token: normalizeOptionalString(config.providers.nextclaw?.apiKey),\n      apiBase: normalizeOptionalString(config.providers.nextclaw?.apiBase),\n      platformBase: status.platformBase\n    });\n    return {\n      account,\n      settings: {\n        enabled: config.remote.enabled,\n        deviceName: config.remote.deviceName,\n        platformApiBase: config.remote.platformApiBase\n      },\n      service: resolveRemoteServiceView(this.deps.currentUi),\n      localOrigin: status.localOrigin,\n      configuredEnabled: status.configuredEnabled,\n      platformBase: status.platformBase,\n      runtime: toRemoteRuntimeView(status.runtime)\n    };\n  };\n\n  login = async (input: {\n    email: string;\n    password: string;\n    apiBase?: string;\n  }): Promise<RemoteAccessView> => {\n    await this.deps.platformAuthCommands.loginResult(input);\n    return this.getStatus();\n  };\n\n  startBrowserAuth = async (input: RemoteBrowserAuthStartRequest): Promise<RemoteBrowserAuthStartResult> => {\n    const result = await this.deps.platformAuthCommands.startBrowserAuth({\n      apiBase: input.apiBase\n    });\n    return {\n      sessionId: result.sessionId,\n      verificationUri: result.verificationUri,\n      expiresAt: result.expiresAt,\n      intervalMs: result.intervalMs\n    };\n  };\n\n  pollBrowserAuth = async (input: RemoteBrowserAuthPollRequest): Promise<RemoteBrowserAuthPollResult> => {\n    const config = loadConfig(getConfigPath());\n    const result = await this.deps.platformAuthCommands.pollBrowserAuth({\n      apiBase: normalizeOptionalString(input.apiBase)\n        ?? normalizeOptionalString(config.remote.platformApiBase)\n        ?? normalizeOptionalString(config.providers.nextclaw?.apiBase)\n        ?? undefined,\n      sessionId: input.sessionId\n    });\n    if (result.status !== \"authorized\") {\n      return result;\n    }\n    return {\n      status: \"authorized\",\n      email: result.email,\n      role: result.role\n    };\n  };\n\n  logout = (): RemoteAccessView => {\n    this.deps.platformAuthCommands.logout();\n    return this.getStatus();\n  };\n\n  updateSettings = (input: RemoteSettingsUpdateRequest): RemoteAccessView => {\n    this.deps.remoteCommands.updateConfig({\n      enabled: input.enabled,\n      apiBase: input.platformApiBase,\n      name: input.deviceName\n    });\n    return this.getStatus();\n  };\n\n  runDoctor = async (): Promise<RemoteDoctorView> => {\n    const report = await this.deps.remoteCommands.getDoctorView();\n    return {\n      generatedAt: report.generatedAt,\n      checks: report.checks,\n      snapshot: {\n        configuredEnabled: report.snapshot.configuredEnabled,\n        runtime: toRemoteRuntimeView(report.snapshot.runtime)\n      }\n    };\n  };\n\n  controlService = async (action: RemoteServiceAction): Promise<RemoteServiceActionResult> => {\n    return controlRemoteService(action, this.deps);\n  };\n\n  private readAccountView = (params: {\n    token: string | null;\n    apiBase: string | null;\n    platformBase: string | null;\n  }): RemoteAccountView => {\n    const { apiBase, platformBase, token } = params;\n    const tokenState = readPlatformSessionTokenState(token);\n    if (!tokenState.valid) {\n      return {\n        loggedIn: false,\n        apiBase,\n        platformBase\n      };\n    }\n    const payload = tokenState.payload;\n    const email = typeof payload?.email === \"string\" ? payload.email : undefined;\n    const username = typeof payload?.username === \"string\" ? payload.username : undefined;\n    const role = typeof payload?.role === \"string\" ? payload.role : undefined;\n    return {\n      loggedIn: true,\n      email,\n      username,\n      role,\n      apiBase,\n      platformBase\n    };\n  };\n\n  updateProfile = async (input: { username: string }): Promise<RemoteAccessView> => {\n    await this.deps.platformAuthCommands.updateProfile({\n      username: input.username\n    });\n    return this.getStatus();\n  };\n}\n"],"mappings":"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"}

package/dist/services/remote/remote-service-control.service.d.ts

@@ -0,0 +1,34 @@
+import { resolveUiConfig } from "../../utils/cli.utils.js";
+import { RemoteServiceAction, RemoteServiceActionResult, RemoteServiceView } from "@nextclaw/server";
+
+//#region src/services/remote/remote-service-control.service.d.ts
+type RemoteAccessHostServiceCommands = {
+  startService: (options: {
+    uiOverrides: Partial<ReturnType<typeof resolveUiConfig>>;
+    open: boolean;
+  }) => Promise<void>;
+  stopService: () => Promise<void>;
+};
+type RemoteRuntimeController = {
+  start: () => Promise<void> | null;
+  stop: () => Promise<void>;
+  restart: () => Promise<void>;
+};
+type CurrentUi = {
+  host: string;
+  port: number;
+};
+type RemoteServiceControlDeps = {
+  serviceCommands: RemoteAccessHostServiceCommands;
+  requestManagedServiceRestart: (options?: {
+    uiPort?: number;
+    reason?: string;
+  }) => Promise<void>;
+  currentUi?: CurrentUi;
+  remoteRuntimeController?: RemoteRuntimeController | null;
+};
+declare function resolveRemoteServiceView(currentUi?: CurrentUi): RemoteServiceView;
+declare function controlRemoteService(action: RemoteServiceAction, deps: RemoteServiceControlDeps): Promise<RemoteServiceActionResult>;
+//#endregion
+export { RemoteAccessHostServiceCommands, RemoteRuntimeController, controlRemoteService, resolveRemoteServiceView };
+//# sourceMappingURL=remote-service-control.service.d.ts.map

package/dist/services/remote/remote-service-control.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-service-control.service.d.ts","names":[],"sources":["../../../src/services/remote/remote-service-control.service.ts"],"mappings":";;;;KAOY,+BAAA;EACV,YAAA,GAAe,OAAA;IAAW,WAAA,EAAa,OAAA,CAAQ,UAAA,QAAkB,eAAA;IAAmB,IAAA;EAAA,MAAoB,OAAA;EACxG,WAAA,QAAmB,OAAA;AAAA;AAAA,KAGT,uBAAA;EACV,KAAA,QAAa,OAAA;EACb,IAAA,QAAY,OAAA;EACZ,OAAA,QAAe,OAAA;AAAA;AAAA,KAGZ,SAAA;EACH,IAAA;EACA,IAAA;AAAA;AAAA,KAGG,wBAAA;EACH,eAAA,EAAiB,+BAAA;EACjB,4BAAA,GAA+B,OAAA;IAAY,MAAA;IAAiB,MAAA;EAAA,MAAsB,OAAA;EAClF,SAAA,GAAY,SAAA;EACZ,uBAAA,GAA0B,uBAAA;AAAA;AAAA,iBA6MZ,wBAAA,CAAyB,SAAA,GAAY,SAAA,GAAY,iBAAA;AAAA,iBAI3C,oBAAA,CACpB,MAAA,EAAQ,mBAAA,EACR,IAAA,EAAM,wBAAA,GACL,OAAA,CAAQ,yBAAA"}

package/dist/services/remote/remote-service-control.service.js

@@ -0,0 +1,247 @@
+import { resolveUiApiBase, resolveUiConfig } from "../../utils/cli.utils.js";
+import { managedServiceStateStore } from "../../stores/managed-service-state.store.js";
+import { ManagedServiceSupervisor } from "../runtime/managed-service-supervisor.service.js";
+import { getConfigPath, loadConfig } from "@nextclaw/core";
+import { spawn } from "node:child_process";
+//#region src/services/remote/remote-service-control.service.ts
+const FORCED_PUBLIC_UI_HOST = "0.0.0.0";
+var RemoteServiceControlService = class {
+	managedServiceSupervisor = new ManagedServiceSupervisor();
+	resolveView = (currentUi) => {
+		if (currentUi) return {
+			running: true,
+			currentProcess: true,
+			pid: process.pid,
+			uiUrl: resolveUiApiBase(currentUi.host, currentUi.port),
+			uiPort: currentUi.port
+		};
+		const serviceState = managedServiceStateStore.read();
+		const liveness = this.managedServiceSupervisor.resolveStateLiveness(serviceState);
+		const serviceRunning = Boolean(serviceState && liveness.running);
+		return {
+			running: serviceRunning,
+			currentProcess: Boolean(serviceRunning && serviceState?.pid === process.pid),
+			...serviceState?.pid ? { pid: serviceState.pid } : {},
+			...serviceState?.uiUrl ? { uiUrl: serviceState.uiUrl } : {},
+			...typeof serviceState?.uiPort === "number" ? { uiPort: serviceState.uiPort } : {}
+		};
+	};
+	control = async (action, deps) => {
+		if (deps.remoteRuntimeController) return this.controlCurrentProcessRuntime(action, deps.remoteRuntimeController);
+		return this.controlManagedService(action, deps);
+	};
+	controlCurrentProcessRuntime = async (action, controller) => {
+		if (action === "start") {
+			await controller.start();
+			return {
+				accepted: true,
+				action,
+				message: "Remote runtime started."
+			};
+		}
+		if (action === "stop") {
+			await controller.stop();
+			return {
+				accepted: true,
+				action,
+				message: "Remote runtime stopped."
+			};
+		}
+		await controller.restart();
+		return {
+			accepted: true,
+			action,
+			message: "Remote runtime restarted."
+		};
+	};
+	controlManagedService = async (action, deps) => {
+		const serviceState = this.resolveManagedServiceControlState();
+		const uiOverrides = this.resolveManagedUiOverrides();
+		if (action === "start") return this.startManagedService(action, deps, serviceState, uiOverrides);
+		if (!serviceState.running) return this.controlStoppedManagedService(action, deps, serviceState, uiOverrides);
+		if (serviceState.currentProcess) return this.controlCurrentManagedProcess(action, deps, uiOverrides);
+		return this.controlExternalManagedProcess(action, deps, uiOverrides);
+	};
+	resolveManagedServiceControlState = () => {
+		const state = managedServiceStateStore.read();
+		const liveness = this.managedServiceSupervisor.resolveStateLiveness(state);
+		const running = Boolean(state && liveness.running);
+		return {
+			currentProcess: Boolean(running && state?.pid === process.pid),
+			recordedProcessExists: Boolean(state && liveness.processExists),
+			running
+		};
+	};
+	startManagedService = async (action, deps, serviceState, uiOverrides) => {
+		if (serviceState.running) return {
+			accepted: true,
+			action,
+			message: serviceState.currentProcess ? "Managed service is already running for this UI." : "Managed service is already running."
+		};
+		if (serviceState.recordedProcessExists) return this.controlStaleManagedServiceProcess(action, deps, uiOverrides);
+		await deps.serviceCommands.startService({
+			uiOverrides,
+			open: false
+		});
+		return {
+			accepted: true,
+			action,
+			message: "Managed service started."
+		};
+	};
+	controlStoppedManagedService = async (action, deps, serviceState, uiOverrides) => {
+		if (serviceState.recordedProcessExists) return this.controlStaleManagedServiceProcess(action, deps, uiOverrides);
+		if (action === "restart") {
+			await deps.serviceCommands.startService({
+				uiOverrides,
+				open: false
+			});
+			return {
+				accepted: true,
+				action,
+				message: "Managed service was not running and has been started."
+			};
+		}
+		return {
+			accepted: true,
+			action,
+			message: "No managed service is currently running."
+		};
+	};
+	controlStaleManagedServiceProcess = async (action, deps, uiOverrides) => {
+		if (action === "stop") {
+			await deps.serviceCommands.stopService();
+			return {
+				accepted: true,
+				action,
+				message: "Stale managed service process stopped."
+			};
+		}
+		if (action === "restart") {
+			await deps.serviceCommands.stopService();
+			await deps.serviceCommands.startService({
+				uiOverrides,
+				open: false
+			});
+			return {
+				accepted: true,
+				action,
+				message: "Stale managed service process replaced."
+			};
+		}
+		await deps.serviceCommands.stopService();
+		await deps.serviceCommands.startService({
+			uiOverrides,
+			open: false
+		});
+		return {
+			accepted: true,
+			action,
+			message: "Stale managed service process replaced."
+		};
+	};
+	controlCurrentManagedProcess = async (action, deps, uiOverrides) => {
+		if (action === "restart") await deps.requestManagedServiceRestart({ uiPort: uiOverrides.port ?? 55667 });
+		else launchManagedSelfControl();
+		return {
+			accepted: true,
+			action,
+			message: action === "restart" ? "Restart scheduled. This page may disconnect for a few seconds." : "Stop scheduled. This page will disconnect shortly."
+		};
+	};
+	controlExternalManagedProcess = async (action, deps, uiOverrides) => {
+		if (action === "stop") {
+			await deps.serviceCommands.stopService();
+			return {
+				accepted: true,
+				action,
+				message: "Managed service stopped."
+			};
+		}
+		await deps.serviceCommands.stopService();
+		await deps.serviceCommands.startService({
+			uiOverrides,
+			open: false
+		});
+		return {
+			accepted: true,
+			action,
+			message: "Managed service restarted."
+		};
+	};
+	resolveManagedUiOverrides = () => {
+		return {
+			enabled: true,
+			host: FORCED_PUBLIC_UI_HOST,
+			open: false,
+			port: resolveUiConfig(loadConfig(getConfigPath()), {
+				enabled: true,
+				host: FORCED_PUBLIC_UI_HOST,
+				open: false
+			}).port
+		};
+	};
+};
+const remoteServiceControlService = new RemoteServiceControlService();
+function resolveRemoteServiceView(currentUi) {
+	return remoteServiceControlService.resolveView(currentUi);
+}
+async function controlRemoteService(action, deps) {
+	return remoteServiceControlService.control(action, deps);
+}
+function launchManagedSelfControl(params = {}) {
+	const script = [
+		"const { spawn } = require(\"node:child_process\");",
+		"const { rmSync } = require(\"node:fs\");",
+		`const parentPid = ${process.pid};`,
+		`const serviceStatePath = ${JSON.stringify(managedServiceStateStore.path)};`,
+		`const command = ${JSON.stringify(params.command ?? null)};`,
+		`const args = ${JSON.stringify(params.args ?? [])};`,
+		`const cwd = ${JSON.stringify(process.cwd())};`,
+		"const env = process.env;",
+		"function isRunning(pid) {",
+		"  try {",
+		"    process.kill(pid, 0);",
+		"    return true;",
+		"  } catch {",
+		"    return false;",
+		"  }",
+		"}",
+		"setTimeout(() => {",
+		"  try {",
+		"    process.kill(parentPid, 'SIGTERM');",
+		"  } catch {}",
+		"}, 150);",
+		"const startedAt = Date.now();",
+		"const maxWaitMs = 30000;",
+		"const timer = setInterval(() => {",
+		"  if (isRunning(parentPid)) {",
+		"    if (Date.now() - startedAt > maxWaitMs) {",
+		"      try {",
+		"        process.kill(parentPid, 'SIGKILL');",
+		"      } catch {}",
+		"    }",
+		"    return;",
+		"  }",
+		"  clearInterval(timer);",
+		"  try {",
+		"    rmSync(serviceStatePath, { force: true });",
+		"  } catch {}",
+		"  if (command) {",
+		"    const child = spawn(command, args, { detached: true, stdio: 'ignore', cwd, env });",
+		"    child.unref();",
+		"  }",
+		"  process.exit(0);",
+		"}, 250);"
+	].join("");
+	spawn(process.execPath, ["-e", script], {
+		detached: true,
+		stdio: "ignore",
+		env: process.env,
+		cwd: process.cwd()
+	}).unref();
+}
+//#endregion
+export { controlRemoteService, resolveRemoteServiceView };
+
+//# sourceMappingURL=remote-service-control.service.js.map

package/dist/services/remote/remote-service-control.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-service-control.service.js","names":[],"sources":["../../../src/services/remote/remote-service-control.service.ts"],"sourcesContent":["import { getConfigPath, loadConfig } from \"@nextclaw/core\";\nimport type { RemoteServiceAction, RemoteServiceActionResult, RemoteServiceView } from \"@nextclaw/server\";\nimport { spawn } from \"node:child_process\";\nimport { resolveUiApiBase, resolveUiConfig } from \"@nextclaw-service/utils/cli.utils.js\";\nimport { managedServiceStateStore } from \"@nextclaw-service/stores/managed-service-state.store.js\";\nimport { ManagedServiceSupervisor } from \"@nextclaw-service/services/runtime/managed-service-supervisor.service.js\";\n\nexport type RemoteAccessHostServiceCommands = {\n  startService: (options: { uiOverrides: Partial<ReturnType<typeof resolveUiConfig>>; open: boolean }) => Promise<void>;\n  stopService: () => Promise<void>;\n};\n\nexport type RemoteRuntimeController = {\n  start: () => Promise<void> | null;\n  stop: () => Promise<void>;\n  restart: () => Promise<void>;\n};\n\ntype CurrentUi = {\n  host: string;\n  port: number;\n};\n\ntype RemoteServiceControlDeps = {\n  serviceCommands: RemoteAccessHostServiceCommands;\n  requestManagedServiceRestart: (options?: { uiPort?: number; reason?: string }) => Promise<void>;\n  currentUi?: CurrentUi;\n  remoteRuntimeController?: RemoteRuntimeController | null;\n};\n\nconst FORCED_PUBLIC_UI_HOST = \"0.0.0.0\";\ntype ManagedServiceControlState = {\n  currentProcess: boolean;\n  recordedProcessExists: boolean;\n  running: boolean;\n};\n\nclass RemoteServiceControlService {\n  private readonly managedServiceSupervisor = new ManagedServiceSupervisor();\n\n  readonly resolveView = (currentUi?: CurrentUi): RemoteServiceView => {\n    if (currentUi) {\n      return {\n        running: true,\n        currentProcess: true,\n        pid: process.pid,\n        uiUrl: resolveUiApiBase(currentUi.host, currentUi.port),\n        uiPort: currentUi.port\n      };\n    }\n\n    const serviceState = managedServiceStateStore.read();\n    const liveness = this.managedServiceSupervisor.resolveStateLiveness(serviceState);\n    const serviceRunning = Boolean(serviceState && liveness.running);\n    return {\n      running: serviceRunning,\n      currentProcess: Boolean(serviceRunning && serviceState?.pid === process.pid),\n      ...(serviceState?.pid ? { pid: serviceState.pid } : {}),\n      ...(serviceState?.uiUrl ? { uiUrl: serviceState.uiUrl } : {}),\n      ...(typeof serviceState?.uiPort === \"number\" ? { uiPort: serviceState.uiPort } : {})\n    };\n  };\n\n  readonly control = async (\n    action: RemoteServiceAction,\n    deps: RemoteServiceControlDeps\n  ): Promise<RemoteServiceActionResult> => {\n    if (deps.remoteRuntimeController) {\n      return this.controlCurrentProcessRuntime(action, deps.remoteRuntimeController);\n    }\n\n    return this.controlManagedService(action, deps);\n  };\n\n  private readonly controlCurrentProcessRuntime = async (\n    action: RemoteServiceAction,\n    controller: RemoteRuntimeController\n  ): Promise<RemoteServiceActionResult> => {\n    if (action === \"start\") {\n      await controller.start();\n      return { accepted: true, action, message: \"Remote runtime started.\" };\n    }\n    if (action === \"stop\") {\n      await controller.stop();\n      return { accepted: true, action, message: \"Remote runtime stopped.\" };\n    }\n    await controller.restart();\n    return { accepted: true, action, message: \"Remote runtime restarted.\" };\n  };\n\n  private readonly controlManagedService = async (\n    action: RemoteServiceAction,\n    deps: RemoteServiceControlDeps\n  ): Promise<RemoteServiceActionResult> => {\n    const serviceState = this.resolveManagedServiceControlState();\n    const uiOverrides = this.resolveManagedUiOverrides();\n\n    if (action === \"start\") {\n      return this.startManagedService(action, deps, serviceState, uiOverrides);\n    }\n    if (!serviceState.running) {\n      return this.controlStoppedManagedService(action, deps, serviceState, uiOverrides);\n    }\n    if (serviceState.currentProcess) {\n      return this.controlCurrentManagedProcess(action, deps, uiOverrides);\n    }\n    return this.controlExternalManagedProcess(action, deps, uiOverrides);\n  };\n\n  private readonly resolveManagedServiceControlState = (): ManagedServiceControlState => {\n    const state = managedServiceStateStore.read();\n    const liveness = this.managedServiceSupervisor.resolveStateLiveness(state);\n    const running = Boolean(state && liveness.running);\n    return {\n      currentProcess: Boolean(running && state?.pid === process.pid),\n      recordedProcessExists: Boolean(state && liveness.processExists),\n      running\n    };\n  };\n\n  private readonly startManagedService = async (\n    action: RemoteServiceAction,\n    deps: RemoteServiceControlDeps,\n    serviceState: ManagedServiceControlState,\n    uiOverrides: Partial<ReturnType<typeof resolveUiConfig>>\n  ): Promise<RemoteServiceActionResult> => {\n    if (serviceState.running) {\n      return {\n        accepted: true,\n        action,\n        message: serviceState.currentProcess ? \"Managed service is already running for this UI.\" : \"Managed service is already running.\"\n      };\n    }\n    if (serviceState.recordedProcessExists) {\n      return this.controlStaleManagedServiceProcess(action, deps, uiOverrides);\n    }\n    await deps.serviceCommands.startService({ uiOverrides, open: false });\n    return { accepted: true, action, message: \"Managed service started.\" };\n  };\n\n  private readonly controlStoppedManagedService = async (\n    action: RemoteServiceAction,\n    deps: RemoteServiceControlDeps,\n    serviceState: ManagedServiceControlState,\n    uiOverrides: Partial<ReturnType<typeof resolveUiConfig>>\n  ): Promise<RemoteServiceActionResult> => {\n    if (serviceState.recordedProcessExists) {\n      return this.controlStaleManagedServiceProcess(action, deps, uiOverrides);\n    }\n    if (action === \"restart\") {\n      await deps.serviceCommands.startService({ uiOverrides, open: false });\n      return {\n        accepted: true,\n        action,\n        message: \"Managed service was not running and has been started.\"\n      };\n    }\n    return { accepted: true, action, message: \"No managed service is currently running.\" };\n  };\n\n  private readonly controlStaleManagedServiceProcess = async (\n    action: RemoteServiceAction,\n    deps: RemoteServiceControlDeps,\n    uiOverrides: Partial<ReturnType<typeof resolveUiConfig>>\n  ): Promise<RemoteServiceActionResult> => {\n    if (action === \"stop\") {\n      await deps.serviceCommands.stopService();\n      return { accepted: true, action, message: \"Stale managed service process stopped.\" };\n    }\n    if (action === \"restart\") {\n      await deps.serviceCommands.stopService();\n      await deps.serviceCommands.startService({ uiOverrides, open: false });\n      return { accepted: true, action, message: \"Stale managed service process replaced.\" };\n    }\n    await deps.serviceCommands.stopService();\n    await deps.serviceCommands.startService({ uiOverrides, open: false });\n    return { accepted: true, action, message: \"Stale managed service process replaced.\" };\n  };\n\n  private readonly controlCurrentManagedProcess = async (\n    action: RemoteServiceAction,\n    deps: RemoteServiceControlDeps,\n    uiOverrides: Partial<ReturnType<typeof resolveUiConfig>>\n  ): Promise<RemoteServiceActionResult> => {\n    if (action === \"restart\") {\n      await deps.requestManagedServiceRestart({ uiPort: uiOverrides.port ?? 55667 });\n    } else {\n      launchManagedSelfControl();\n    }\n    return {\n      accepted: true,\n      action,\n      message:\n        action === \"restart\"\n          ? \"Restart scheduled. This page may disconnect for a few seconds.\"\n          : \"Stop scheduled. This page will disconnect shortly.\"\n    };\n  };\n\n  private readonly controlExternalManagedProcess = async (\n    action: RemoteServiceAction,\n    deps: RemoteServiceControlDeps,\n    uiOverrides: Partial<ReturnType<typeof resolveUiConfig>>\n  ): Promise<RemoteServiceActionResult> => {\n    if (action === \"stop\") {\n      await deps.serviceCommands.stopService();\n      return { accepted: true, action, message: \"Managed service stopped.\" };\n    }\n\n    await deps.serviceCommands.stopService();\n    await deps.serviceCommands.startService({ uiOverrides, open: false });\n    return { accepted: true, action, message: \"Managed service restarted.\" };\n  };\n\n  private readonly resolveManagedUiOverrides = (): Partial<ReturnType<typeof resolveUiConfig>> => {\n    const config = loadConfig(getConfigPath());\n    const resolved = resolveUiConfig(config, {\n      enabled: true,\n      host: FORCED_PUBLIC_UI_HOST,\n      open: false\n    });\n    return {\n      enabled: true,\n      host: FORCED_PUBLIC_UI_HOST,\n      open: false,\n      port: resolved.port\n    };\n  };\n}\n\nconst remoteServiceControlService = new RemoteServiceControlService();\n\nexport function resolveRemoteServiceView(currentUi?: CurrentUi): RemoteServiceView {\n  return remoteServiceControlService.resolveView(currentUi);\n}\n\nexport async function controlRemoteService(\n  action: RemoteServiceAction,\n  deps: RemoteServiceControlDeps\n): Promise<RemoteServiceActionResult> {\n  return remoteServiceControlService.control(action, deps);\n}\n\nfunction launchManagedSelfControl(params: {\n  command?: string;\n  args?: string[];\n} = {}): void {\n  const script = [\n    'const { spawn } = require(\"node:child_process\");',\n    'const { rmSync } = require(\"node:fs\");',\n    `const parentPid = ${process.pid};`,\n    `const serviceStatePath = ${JSON.stringify(managedServiceStateStore.path)};`,\n    `const command = ${JSON.stringify(params.command ?? null)};`,\n    `const args = ${JSON.stringify(params.args ?? [])};`,\n    `const cwd = ${JSON.stringify(process.cwd())};`,\n    \"const env = process.env;\",\n    \"function isRunning(pid) {\",\n    \"  try {\",\n    \"    process.kill(pid, 0);\",\n    \"    return true;\",\n    \"  } catch {\",\n    \"    return false;\",\n    \"  }\",\n    \"}\",\n    \"setTimeout(() => {\",\n    \"  try {\",\n    \"    process.kill(parentPid, 'SIGTERM');\",\n    \"  } catch {}\",\n    \"}, 150);\",\n    \"const startedAt = Date.now();\",\n    \"const maxWaitMs = 30000;\",\n    \"const timer = setInterval(() => {\",\n    \"  if (isRunning(parentPid)) {\",\n    \"    if (Date.now() - startedAt > maxWaitMs) {\",\n    \"      try {\",\n    \"        process.kill(parentPid, 'SIGKILL');\",\n    \"      } catch {}\",\n    \"    }\",\n    \"    return;\",\n    \"  }\",\n    \"  clearInterval(timer);\",\n    \"  try {\",\n    \"    rmSync(serviceStatePath, { force: true });\",\n    \"  } catch {}\",\n    \"  if (command) {\",\n    \"    const child = spawn(command, args, { detached: true, stdio: 'ignore', cwd, env });\",\n    \"    child.unref();\",\n    \"  }\",\n    \"  process.exit(0);\",\n    \"}, 250);\"\n  ].join(\"\");\n  const helper = spawn(process.execPath, [\"-e\", script], {\n    detached: true,\n    stdio: \"ignore\",\n    env: process.env,\n    cwd: process.cwd()\n  });\n  helper.unref();\n}\n"],"mappings":"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"}

package/dist/services/restart/restart-coordinator.service.d.ts

@@ -0,0 +1,31 @@
+import { ManagedServiceState } from "../../stores/managed-service-state.store.js";
+
+//#region src/services/restart/restart-coordinator.service.d.ts
+type RestartStrategy = "background-service-or-manual" | "background-service-or-exit" | "exit-process";
+type RestartRequest = {
+  reason: string;
+  strategy?: RestartStrategy;
+  delayMs?: number;
+  manualMessage?: string;
+};
+type RestartResult = {
+  status: "service-restarted" | "restart-in-progress" | "exit-scheduled" | "manual-required";
+  message: string;
+};
+type RestartCoordinatorDeps = {
+  readServiceState: () => ManagedServiceState | null;
+  isProcessRunning: (pid: number) => boolean;
+  currentPid: () => number;
+  restartBackgroundService: (reason: string) => Promise<boolean>;
+  scheduleProcessExit: (delayMs: number, reason: string) => void;
+};
+declare class RestartCoordinator {
+  private deps;
+  private restartingService;
+  private exitScheduled;
+  constructor(deps: RestartCoordinatorDeps);
+  readonly requestRestart: (request: RestartRequest) => Promise<RestartResult>;
+}
+//#endregion
+export { RestartCoordinator, RestartRequest, RestartResult, RestartStrategy };
+//# sourceMappingURL=restart-coordinator.service.d.ts.map

package/dist/services/restart/restart-coordinator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-coordinator.service.d.ts","names":[],"sources":["../../../src/services/restart/restart-coordinator.service.ts"],"mappings":";;;KAEY,eAAA;AAAA,KAEA,cAAA;EACV,MAAA;EACA,QAAA,GAAW,eAAA;EACX,OAAA;EACA,aAAA;AAAA;AAAA,KAGU,aAAA;EACV,MAAA;EACA,OAAA;AAAA;AAAA,KAGG,sBAAA;EACH,gBAAA,QAAwB,mBAAA;EACxB,gBAAA,GAAmB,GAAA;EACnB,UAAA;EACA,wBAAA,GAA2B,MAAA,aAAmB,OAAA;EAC9C,mBAAA,GAAsB,OAAA,UAAiB,MAAA;AAAA;AAAA,cAG5B,kBAAA;EAAA,QAIS,IAAA;EAAA,QAHZ,iBAAA;EAAA,QACA,aAAA;cAEY,IAAA,EAAM,sBAAA;EAAA,SAEjB,cAAA,GAAwB,OAAA,EAAS,cAAA,KAAiB,OAAA,CAAQ,aAAA;AAAA"}

package/dist/services/restart/restart-coordinator.service.js

@@ -0,0 +1,53 @@
+//#region src/services/restart/restart-coordinator.service.ts
+var RestartCoordinator = class {
+	restartingService = false;
+	exitScheduled = false;
+	constructor(deps) {
+		this.deps = deps;
+	}
+	requestRestart = async (request) => {
+		const reason = request.reason.trim() || "config changed";
+		const strategy = request.strategy ?? "background-service-or-manual";
+		if (strategy !== "exit-process") {
+			const state = this.deps.readServiceState();
+			const serviceRunning = Boolean(state && this.deps.isProcessRunning(state.pid));
+			const managedByCurrentProcess = Boolean(state && state.pid === this.deps.currentPid());
+			if (serviceRunning && !managedByCurrentProcess) {
+				if (this.restartingService) return {
+					status: "restart-in-progress",
+					message: "Restart already in progress; skipping duplicate request."
+				};
+				this.restartingService = true;
+				try {
+					if (await this.deps.restartBackgroundService(reason)) return {
+						status: "service-restarted",
+						message: `Restarted background service to apply changes (${reason}).`
+					};
+				} finally {
+					this.restartingService = false;
+				}
+			}
+		}
+		if (strategy === "background-service-or-exit" || strategy === "exit-process") {
+			if (this.exitScheduled) return {
+				status: "exit-scheduled",
+				message: "Restart already scheduled; skipping duplicate request."
+			};
+			const delay = typeof request.delayMs === "number" && Number.isFinite(request.delayMs) ? Math.max(0, Math.floor(request.delayMs)) : 100;
+			this.exitScheduled = true;
+			this.deps.scheduleProcessExit(delay, reason);
+			return {
+				status: "exit-scheduled",
+				message: `Restart scheduled (${reason}).`
+			};
+		}
+		return {
+			status: "manual-required",
+			message: request.manualMessage ?? "Restart the gateway to apply changes."
+		};
+	};
+};
+//#endregion
+export { RestartCoordinator };
+
+//# sourceMappingURL=restart-coordinator.service.js.map