frely-cli 0.23.9 → 0.23.11

package/dist/share/control.d.ts

@@ -14,3 +14,5 @@ export interface ShareControl {
 }
 /** Calls Frely's share route as the signed-in user; the device is this computer's enrolled device. */
 export declare function accountShareControl(): Promise<ShareControl>;
+/** A POST helper for one of Frely's device-relay routes, signed in as the user. */
+export declare function accountRelayCaller(path: string): Promise<(body: Record<string, unknown>) => Promise<unknown>>;

package/dist/share/control.js

@@ -5,15 +5,8 @@ const TIMEOUT_MS = 20_000;
 const SHARES_PATH = "/api/user/device-relay/shares";
 /** Calls Frely's share route as the signed-in user; the device is this computer's enrolled device. */
 export async function accountShareControl() {
-    const auth = await requireLogin();
     const device = await ensureDevice();
-    const call = async (body) => {
-        const response = await relayFetch(auth.config.relayUrl, auth.credential, { method: "POST", body: JSON.stringify(body) });
-        const payload = await response.json().catch(() => null);
-        if (!response.ok)
-            throw new Error(publicError(payload, response.status));
-        return payload;
-    };
+    const call = await accountRelayCaller(SHARES_PATH);
     return {
         async create(input) { return parseShareGrant(await call({ action: "create", deviceId: device.deviceId, ...(input.ttlSeconds !== undefined ? { ttlSeconds: input.ttlSeconds } : {}) })); },
         async heartbeat(sessionId) {
@@ -25,12 +18,23 @@ export async function accountShareControl() {
         async revoke(sessionId) { await call({ action: "revoke", sessionId }); },
     };
 }
-async function relayFetch(relayUrl, credential, init) {
+/** A POST helper for one of Frely's device-relay routes, signed in as the user. */
+export async function accountRelayCaller(path) {
+    const auth = await requireLogin();
+    return async (body) => {
+        const response = await relayFetch(auth.config.relayUrl, auth.credential, path, { method: "POST", body: JSON.stringify(body) });
+        const payload = await response.json().catch(() => null);
+        if (!response.ok)
+            throw new Error(publicError(payload, response.status));
+        return payload;
+    };
+}
+async function relayFetch(relayUrl, credential, path, init) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), TIMEOUT_MS);
     timer.unref?.();
     try {
-        return await fetch(`${relayUrl}${SHARES_PATH}`, { ...init, signal: controller.signal, redirect: "error", headers: { accept: "application/json", origin: relayUrl, "content-type": "application/json", ...(credential.scheme === "bearer" ? { authorization: `Bearer ${credential.value}` } : { cookie: credential.value }) } });
+        return await fetch(`${relayUrl}${path}`, { ...init, signal: controller.signal, redirect: "error", headers: { accept: "application/json", origin: relayUrl, "content-type": "application/json", ...(credential.scheme === "bearer" ? { authorization: `Bearer ${credential.value}` } : { cookie: credential.value }) } });
     }
     catch (error) {
         if (controller.signal.aborted)

package/dist/share/control.js.map

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

package/dist/share/service-config.d.ts

@@ -0,0 +1,39 @@
+/** What the relay returns for a service session (`POST /api/user/device-relay/services`, action session). */
+export interface ServiceGrant {
+    readonly id: string;
+    readonly serviceShareId: string;
+    readonly expiresAt: string;
+    readonly node: string;
+    readonly bandwidthBytesPerSecond: number;
+    readonly remainingBytes: number;
+    readonly frpc: {
+        readonly serverAddr: string;
+        readonly serverPort: number;
+        readonly user: string;
+        readonly token: string;
+        readonly proxyName: "svc";
+        readonly proxyType: "stcp";
+        readonly secretKey: string;
+        readonly allowUsers: readonly string[];
+    };
+}
+export type ServiceType = "mcp" | "a2a";
+/** A registered service as `register` and `list` return it. The local port is never part of it. */
+export interface ServiceShareRecord {
+    readonly id: string;
+    readonly deviceId: string;
+    readonly type: ServiceType;
+    readonly label: string;
+    readonly createdAt: string;
+}
+export declare const SERVICE_SHARE_ID: RegExp;
+/** Checks the grant's shape before anything of it reaches a process or a file; throws on anything unexpected. */
+export declare function parseServiceGrant(value: unknown): ServiceGrant;
+/** Checks a `register` / `list` row. */
+export declare function parseServiceRecord(value: unknown): ServiceShareRecord;
+/**
+ * The frpc config for a service: exactly one stcp proxy that points at a port on loopback. `localIP` is fixed here and the port comes
+ * from the author's own command line; the relay never supplies a target. No client plugin, no admin port and no other proxy type are written.
+ * The stcp key and `allowUsers` (Frely's visitor) come from the grant.
+ */
+export declare function serviceFrpcConfigToml(grant: ServiceGrant, localPort: number): string;

package/dist/share/service-config.js

@@ -0,0 +1,85 @@
+const HOST = /^(?:[A-Za-z0-9](?:[A-Za-z0-9.-]{0,251}[A-Za-z0-9])?|\[[0-9A-Fa-f:]{2,45}\])$/u;
+const SECRET = /^[A-Za-z0-9_-]{20,128}$/u;
+const VISITOR = /^[A-Za-z0-9_.-]{1,80}$/u;
+export const SERVICE_SHARE_ID = /^svcs_[0-9a-f]{24}$/u;
+/** Checks the grant's shape before anything of it reaches a process or a file; throws on anything unexpected. */
+export function parseServiceGrant(value) {
+    const fail = () => { throw new Error("Frely returned an invalid service session."); };
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return fail();
+    const grant = value, frpc = grant.frpc;
+    if (typeof grant.id !== "string" || !/^frps_[0-9a-f]{24}$/u.test(grant.id))
+        return fail();
+    if (typeof grant.serviceShareId !== "string" || !SERVICE_SHARE_ID.test(grant.serviceShareId))
+        return fail();
+    if (typeof grant.expiresAt !== "string" || !Number.isFinite(Date.parse(grant.expiresAt)) || typeof grant.node !== "string" || grant.node.length < 1 || grant.node.length > 64)
+        return fail();
+    if (typeof grant.bandwidthBytesPerSecond !== "number" || !Number.isFinite(grant.bandwidthBytesPerSecond) || grant.bandwidthBytesPerSecond < 0)
+        return fail();
+    if (typeof grant.remainingBytes !== "number" || !Number.isFinite(grant.remainingBytes) || grant.remainingBytes < 0)
+        return fail();
+    if (!frpc || typeof frpc !== "object" || Array.isArray(frpc))
+        return fail();
+    const { serverAddr, serverPort, user, token, proxyName, proxyType, secretKey, allowUsers } = frpc;
+    if (typeof serverAddr !== "string" || !HOST.test(serverAddr))
+        return fail();
+    if (typeof serverPort !== "number" || !Number.isInteger(serverPort) || serverPort < 1 || serverPort > 65535)
+        return fail();
+    if (user !== grant.id || typeof token !== "string" || !/^frs_[A-Za-z0-9_-]{20,64}$/u.test(token))
+        return fail();
+    if (proxyName !== "svc" || proxyType !== "stcp")
+        return fail();
+    if (typeof secretKey !== "string" || !SECRET.test(secretKey))
+        return fail();
+    if (!Array.isArray(allowUsers) || allowUsers.length < 1 || allowUsers.length > 4 || allowUsers.some((entry) => typeof entry !== "string" || !VISITOR.test(entry) || entry === "*"))
+        return fail();
+    return {
+        id: grant.id, serviceShareId: grant.serviceShareId, expiresAt: grant.expiresAt, node: grant.node,
+        bandwidthBytesPerSecond: grant.bandwidthBytesPerSecond, remainingBytes: grant.remainingBytes,
+        frpc: { serverAddr, serverPort, user, token, proxyName, proxyType, secretKey, allowUsers: [...allowUsers] },
+    };
+}
+/** Checks a `register` / `list` row. */
+export function parseServiceRecord(value) {
+    const fail = () => { throw new Error("Frely returned an invalid service."); };
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return fail();
+    const row = value;
+    if (typeof row.id !== "string" || !SERVICE_SHARE_ID.test(row.id) || typeof row.deviceId !== "string" || row.deviceId.length > 64)
+        return fail();
+    if (row.type !== "mcp" && row.type !== "a2a")
+        return fail();
+    if (typeof row.label !== "string" || row.label.length < 1 || row.label.length > 60)
+        return fail();
+    return { id: row.id, deviceId: row.deviceId, type: row.type, label: row.label, createdAt: typeof row.createdAt === "string" ? row.createdAt : "" };
+}
+/**
+ * The frpc config for a service: exactly one stcp proxy that points at a port on loopback. `localIP` is fixed here and the port comes
+ * from the author's own command line; the relay never supplies a target. No client plugin, no admin port and no other proxy type are written.
+ * The stcp key and `allowUsers` (Frely's visitor) come from the grant.
+ */
+export function serviceFrpcConfigToml(grant, localPort) {
+    if (!Number.isInteger(localPort) || localPort < 1 || localPort > 65535)
+        throw new Error("Invalid local port.");
+    const q = (text) => JSON.stringify(text);
+    return [
+        `serverAddr = ${q(grant.frpc.serverAddr.replace(/^\[|\]$/gu, ""))}`,
+        `serverPort = ${grant.frpc.serverPort}`,
+        `user = ${q(grant.frpc.user)}`,
+        `loginFailExit = true`,
+        `metadatas.token = ${q(grant.frpc.token)}`,
+        `transport.tls.enable = true`,
+        `log.to = "console"`,
+        `log.level = "warn"`,
+        ``,
+        `[[proxies]]`,
+        `name = "svc"`,
+        `type = "stcp"`,
+        `secretKey = ${q(grant.frpc.secretKey)}`,
+        `allowUsers = [${grant.frpc.allowUsers.map(q).join(", ")}]`,
+        `localIP = "127.0.0.1"`,
+        `localPort = ${localPort}`,
+        ``,
+    ].join("\n");
+}
+//# sourceMappingURL=service-config.js.map

package/dist/share/service-config.js.map

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

package/dist/share/service-control.d.ts

@@ -0,0 +1,15 @@
+import { type ShareHeartbeat } from "./control.js";
+import { type ServiceGrant, type ServiceShareRecord, type ServiceType } from "./service-config.js";
+export interface ServiceControl {
+    register(input: {
+        type: ServiceType;
+        label: string;
+    }): Promise<ServiceShareRecord>;
+    list(): Promise<ServiceShareRecord[]>;
+    remove(serviceShareId: string): Promise<void>;
+    session(serviceShareId: string): Promise<ServiceGrant>;
+    heartbeat(sessionId: string): Promise<ShareHeartbeat>;
+    revoke(sessionId: string): Promise<void>;
+}
+/** Calls Frely's service route as the signed-in user. Only the type and label are registered; the local port never leaves this computer. */
+export declare function accountServiceControl(): Promise<ServiceControl>;

package/dist/share/service-control.js

@@ -0,0 +1,31 @@
+import { ensureDevice } from "../device/control.js";
+import { accountRelayCaller } from "./control.js";
+import { parseServiceGrant, parseServiceRecord } from "./service-config.js";
+const SERVICES_PATH = "/api/user/device-relay/services";
+/** Calls Frely's service route as the signed-in user. Only the type and label are registered; the local port never leaves this computer. */
+export async function accountServiceControl() {
+    const call = await accountRelayCaller(SERVICES_PATH);
+    return {
+        async register(input) {
+            const device = await ensureDevice();
+            return parseServiceRecord(await call({ action: "register", deviceId: device.deviceId, type: input.type, label: input.label }));
+        },
+        async list() {
+            const value = await call({ action: "list" });
+            const items = value && typeof value === "object" ? value.items : undefined;
+            if (!Array.isArray(items))
+                throw new Error("Frely returned an invalid service list.");
+            return items.map(parseServiceRecord);
+        },
+        async remove(serviceShareId) { await call({ action: "remove", serviceShareId }); },
+        async session(serviceShareId) { return parseServiceGrant(await call({ action: "session", serviceShareId })); },
+        async heartbeat(sessionId) {
+            const value = await call({ action: "heartbeat", sessionId });
+            if (!value || typeof value !== "object" || typeof value.active !== "boolean")
+                throw new Error("Frely returned an invalid service status.");
+            return value;
+        },
+        async revoke(sessionId) { await call({ action: "revoke", sessionId }); },
+    };
+}
+//# sourceMappingURL=service-control.js.map

package/dist/share/service-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-control.js","sourceRoot":"","sources":["../../src/share/service-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAuB,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAgE,MAAM,qBAAqB,CAAC;AAE1I,MAAM,aAAa,GAAG,iCAAiC,CAAC;AAWxD,4IAA4I;AAC5I,MAAM,CAAC,KAAK,UAAU,qBAAqB;IACzC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACrD,OAAO;QACL,KAAK,CAAC,QAAQ,CAAC,KAAK;YAClB,MAAM,MAAM,GAAG,MAAM,YAAY,EAAE,CAAC;YACpC,OAAO,kBAAkB,CAAC,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACjI,CAAC;QACD,KAAK,CAAC,IAAI;YACR,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAA6B,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACpG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACtF,OAAO,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACvC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;QAClF,KAAK,CAAC,OAAO,CAAC,cAAc,IAAI,OAAO,iBAAiB,CAAC,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9G,KAAK,CAAC,SAAS,CAAC,SAAS;YACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAQ,KAA8B,CAAC,MAAM,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACrK,OAAO,KAAuB,CAAC;QACjC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;KACzE,CAAC;AACJ,CAAC"}

package/dist/share/service-run.d.ts

@@ -0,0 +1,55 @@
+import { type ServiceGrant, type ServiceType } from "./service-config.js";
+import { type ServiceControl } from "./service-control.js";
+import { type LocalService } from "./service-state.js";
+import { ALLOWANCE_NOTE } from "./allowance.js";
+import { type FrpcProcess } from "./run.js";
+export { ALLOWANCE_NOTE };
+export interface ServiceShareOptions {
+    readonly type: ServiceType;
+    readonly port: number;
+    readonly label: string;
+    readonly background: boolean;
+    readonly json: boolean;
+}
+export declare function serviceUsage(): string;
+export declare function parseServiceShareArguments(args: readonly string[]): ServiceShareOptions;
+export interface ServiceSessionDeps {
+    readonly control: ServiceControl;
+    readonly ensureFrpc: () => Promise<string>;
+    readonly spawnFrpc: (binary: string, configPath: string) => FrpcProcess;
+    readonly write: (text: string) => void;
+    readonly signal: AbortSignal;
+    readonly heartbeatMs?: number;
+    readonly configLifetimeMs?: number;
+    /** Called once the session is up, with the grant (for the allowance line). */
+    readonly onGrant?: (grant: ServiceGrant) => void;
+}
+/** One session of one service: ask Frely for it, run frpc on it, heartbeat, and revoke when it ends. Returns why it ended. */
+export declare function runServiceSession(service: Pick<LocalService, "serviceShareId" | "port">, deps: ServiceSessionDeps): Promise<{
+    reason: string;
+    stopped: boolean;
+}>;
+export declare function allowanceLines(grant: ServiceGrant): string[];
+/** Keeps one service connected until aborted: when a session ends for any reason but a stop, ask for a new one after a growing pause. */
+export declare function keepServiceConnected(service: Pick<LocalService, "serviceShareId" | "port" | "label">, deps: ServiceSessionDeps, sleep?: (ms: number, signal: AbortSignal) => Promise<void>): Promise<void>;
+/** Runs inside the device daemon: every service saved with `background` stays connected; a stop or removal in the state file ends it within seconds. */
+export declare function superviseServices(options: {
+    signal: AbortSignal;
+    log: (text: string) => void;
+    pollMs?: number;
+    control?: () => Promise<ServiceControl>;
+    session?: Partial<ServiceSessionDeps>;
+}): Promise<void>;
+export interface ServiceCommandIo {
+    readonly write: (text: string) => void;
+}
+export interface ServiceCommandDeps {
+    readonly control: () => Promise<ServiceControl>;
+    readonly probe: (port: number) => Promise<boolean>;
+    readonly ensureFrpc: () => Promise<string>;
+    readonly spawnFrpc: (binary: string, configPath: string) => FrpcProcess;
+    readonly signal: AbortSignal;
+    /** Installs / restarts the background service so it picks the service up. */
+    readonly installDaemon: () => Promise<void>;
+}
+export declare function runServiceCommand(args: readonly string[], io: ServiceCommandIo, deps: ServiceCommandDeps): Promise<number>;

package/dist/share/service-run.js

@@ -0,0 +1,285 @@
+import { chmod, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { serviceFrpcConfigToml, SERVICE_SHARE_ID } from "./service-config.js";
+import { accountServiceControl } from "./service-control.js";
+import { listLocalServices, removeLocalService, saveLocalService } from "./service-state.js";
+import { ensureFrpc } from "./frpc.js";
+import { ALLOWANCE_NOTE, remainingAllowanceLine } from "./allowance.js";
+import { spawnFrpcProcess } from "./run.js";
+const HEARTBEAT_MS = 30_000;
+const HEARTBEAT_FAILURES = 3;
+const POLL_MS = 10_000;
+const RETRY_MIN_MS = 30_000;
+const RETRY_MAX_MS = 10 * 60_000;
+export { ALLOWANCE_NOTE };
+export function serviceUsage() {
+    return [
+        "frely service share --type mcp|a2a --port <n> [--label <text>] [--background] [--json]",
+        "frely service list [--json]",
+        "frely service stop <id|label>",
+        "frely service remove <id|label>",
+    ].join("\n");
+}
+export function parseServiceShareArguments(args) {
+    let type, port, label;
+    let background = false, json = false;
+    const value = (i, arg, name) => {
+        const inline = arg.startsWith(`${name}=`) ? arg.slice(name.length + 1) : args[i + 1];
+        if (inline === undefined || inline === "" || (!arg.includes("=") && inline.startsWith("-")))
+            throw new Error(`${name} needs a value.\n${serviceUsage()}`);
+        return inline;
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const name = arg.split("=")[0];
+        if (name === "--type") {
+            type = value(i, arg, name);
+            if (!arg.includes("="))
+                i++;
+        }
+        else if (name === "--port") {
+            const text = value(i, arg, name);
+            if (!arg.includes("="))
+                i++;
+            port = Number(text);
+            if (!/^\d+$/u.test(text) || port < 1 || port > 65535)
+                throw new Error("--port must be a port number from 1 to 65535 on this computer (127.0.0.1).");
+        }
+        else if (name === "--label") {
+            label = value(i, arg, name);
+            if (!arg.includes("="))
+                i++;
+        }
+        else if (arg === "--background")
+            background = true;
+        else if (arg === "--json")
+            json = true;
+        else
+            throw new Error(`${arg.startsWith("-") ? "Unknown option" : "Unexpected argument"} ${arg}. A service is a port on this computer; no address is accepted.\n${serviceUsage()}`);
+    }
+    if (type !== "mcp" && type !== "a2a")
+        throw new Error(`--type must be mcp or a2a.\n${serviceUsage()}`);
+    if (port === undefined)
+        throw new Error(`--port is required.\n${serviceUsage()}`);
+    const text = (label ?? `local-${type}`).trim();
+    if (text.length < 1 || text.length > 60 || /[\u0000-\u001f\u007f]/u.test(text))
+        throw new Error("--label must be 1 to 60 characters.");
+    return { type, port, label: text, background, json };
+}
+/** One session of one service: ask Frely for it, run frpc on it, heartbeat, and revoke when it ends. Returns why it ended. */
+export async function runServiceSession(service, deps) {
+    const binary = await deps.ensureFrpc();
+    const grant = await deps.control.session(service.serviceShareId);
+    let directory, frpc;
+    let heartbeat, expiry, configTimer;
+    try {
+        directory = await mkdtemp(join(tmpdir(), "frely-service-"));
+        await chmod(directory, 0o700).catch(() => undefined);
+        const configPath = join(directory, "frpc.toml");
+        await writeFile(configPath, serviceFrpcConfigToml(grant, service.port), { mode: 0o600 });
+        frpc = deps.spawnFrpc(binary, configPath);
+        configTimer = setTimeout(() => { void rm(configPath, { force: true }).catch(() => undefined); }, deps.configLifetimeMs ?? 3000);
+        deps.onGrant?.(grant);
+        let stoppedByUser = false;
+        const reason = await new Promise((resolve) => {
+            let failures = 0;
+            const stop = (text) => resolve(text);
+            if (deps.signal.aborted)
+                stop("Stopped.");
+            deps.signal.addEventListener("abort", () => { stoppedByUser = true; stop("Stopped."); }, { once: true });
+            void frpc.done.then(({ code, stderr }) => stop(`frpc exited${code === null ? "" : ` with code ${code}`}${stderr.trim() ? `: ${stderr.trim().split("\n").slice(-3).join(" | ")}` : "."}`));
+            expiry = setTimeout(() => stop("The session expired."), Math.max(0, Date.parse(grant.expiresAt) - Date.now()));
+            heartbeat = setInterval(() => {
+                void deps.control.heartbeat(grant.id).then((status) => {
+                    failures = 0;
+                    if (!status.active)
+                        stop(describeEnd(status.reason));
+                }, () => { failures += 1; if (failures >= HEARTBEAT_FAILURES)
+                    stop("Frely could not be reached."); });
+            }, deps.heartbeatMs ?? HEARTBEAT_MS);
+        });
+        return { reason, stopped: stoppedByUser };
+    }
+    finally {
+        if (heartbeat)
+            clearInterval(heartbeat);
+        if (expiry)
+            clearTimeout(expiry);
+        if (configTimer)
+            clearTimeout(configTimer);
+        frpc?.kill();
+        if (directory)
+            await rm(directory, { recursive: true, force: true }).catch(() => undefined);
+        await deps.control.revoke(grant.id).catch(() => undefined);
+    }
+}
+function describeEnd(reason) {
+    if (reason === "quota_exhausted")
+        return "This week's relay allowance is used up; it renews on Monday (UTC).";
+    if (reason === "expired")
+        return "The session expired.";
+    if (reason === "service_removed")
+        return "The service was removed.";
+    return `Frely ended this session (${reason ?? "revoked"}).`;
+}
+export function allowanceLines(grant) {
+    return [remainingAllowanceLine(grant.remainingBytes), ALLOWANCE_NOTE];
+}
+/** Keeps one service connected until aborted: when a session ends for any reason but a stop, ask for a new one after a growing pause. */
+export async function keepServiceConnected(service, deps, sleep = abortableSleep) {
+    let pause = RETRY_MIN_MS;
+    while (!deps.signal.aborted) {
+        const started = Date.now();
+        try {
+            const { reason } = await runServiceSession(service, deps);
+            if (deps.signal.aborted)
+                return;
+            deps.write(`Service ${service.label}: ${reason}\n`);
+        }
+        catch (error) {
+            if (deps.signal.aborted)
+                return;
+            deps.write(`Service ${service.label}: ${error instanceof Error ? error.message : String(error)}\n`);
+        }
+        pause = Date.now() - started > 60_000 ? RETRY_MIN_MS : Math.min(pause * 2, RETRY_MAX_MS);
+        await sleep(pause, deps.signal);
+    }
+}
+function abortableSleep(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve();
+        const timer = setTimeout(done, ms);
+        function done() { clearTimeout(timer); signal.removeEventListener("abort", done); resolve(); }
+        signal.addEventListener("abort", done, { once: true });
+    });
+}
+/** Runs inside the device daemon: every service saved with `background` stays connected; a stop or removal in the state file ends it within seconds. */
+export async function superviseServices(options) {
+    const running = new Map();
+    let control;
+    const reconcile = async () => {
+        const wanted = (await listLocalServices().catch(() => [])).filter((service) => service.background);
+        for (const [id, entry] of running) {
+            const current = wanted.find((service) => service.serviceShareId === id);
+            if (!current || (current.port !== entry.port)) {
+                entry.abort.abort();
+                await entry.done;
+                running.delete(id);
+            }
+        }
+        for (const service of wanted) {
+            if (running.has(service.serviceShareId))
+                continue;
+            try {
+                control ??= await (options.control ?? accountServiceControl)();
+            }
+            catch (error) {
+                options.log(`Services: ${error instanceof Error ? error.message : String(error)}`);
+                return;
+            }
+            const abort = new AbortController();
+            const onParent = () => abort.abort();
+            options.signal.addEventListener("abort", onParent, { once: true });
+            const done = keepServiceConnected(service, {
+                control, ensureFrpc: () => ensureFrpc({ log: () => undefined }), spawnFrpc: spawnFrpcProcess, write: (text) => options.log(text.trimEnd()), signal: abort.signal,
+                onGrant: (grant) => options.log(`Service ${service.label} connected. ${allowanceLines(grant).join(" ")}`), ...options.session,
+            }).finally(() => options.signal.removeEventListener("abort", onParent));
+            running.set(service.serviceShareId, Object.assign({ abort, done }, { port: service.port }));
+        }
+    };
+    while (!options.signal.aborted) {
+        await reconcile();
+        await abortableSleep(options.pollMs ?? POLL_MS, options.signal);
+    }
+    for (const entry of running.values())
+        entry.abort.abort();
+    await Promise.all([...running.values()].map((entry) => entry.done));
+}
+export async function runServiceCommand(args, io, deps) {
+    const [action, ...rest] = args;
+    if (action === undefined || action === "help" || action === "--help") {
+        io.write(`Usage:\n${serviceUsage().split("\n").map((line) => `  ${line}`).join("\n")}\n`);
+        return 0;
+    }
+    if (action === "share")
+        return shareService(parseServiceShareArguments(rest), io, deps);
+    if (action === "list") {
+        if (rest.some((arg) => arg !== "--json"))
+            throw new Error(`Usage: frely service list [--json]`);
+        const control = await deps.control();
+        const [remote, local] = await Promise.all([control.list(), listLocalServices()]);
+        const rows = remote.map((item) => {
+            const mine = local.find((service) => service.serviceShareId === item.id);
+            return { id: item.id, type: item.type, label: item.label, onThisComputer: Boolean(mine), background: mine?.background ?? false };
+        });
+        if (rest.includes("--json"))
+            io.write(`${JSON.stringify({ services: rows }, null, 2)}\n`);
+        else if (rows.length === 0)
+            io.write("No services are registered.\n");
+        else
+            for (const row of rows)
+                io.write(`${row.id}  ${row.type}  ${row.label}  ${row.onThisComputer ? (row.background ? "background" : "this computer") : "other device"}\n`);
+        return 0;
+    }
+    if (action === "stop" || action === "remove") {
+        if (rest.length !== 1 || rest[0].startsWith("-"))
+            throw new Error(`Usage: frely service ${action} <id|label>`);
+        const service = await findLocal(rest[0]);
+        if (action === "stop") {
+            await saveLocalService({ ...service, background: false });
+            io.write(`Stopped ${service.label}. The background service disconnects it within seconds; a foreground \`frely service share\` stops with Ctrl+C. The service stays registered.\n`);
+            return 0;
+        }
+        await (await deps.control()).remove(service.serviceShareId);
+        await removeLocalService(service.serviceShareId);
+        io.write(`Removed ${service.label}. Products that pointed at it answer as unreachable.\n`);
+        return 0;
+    }
+    throw new Error(`Unknown service command ${action}.\n${serviceUsage()}`);
+}
+async function findLocal(selector) {
+    const services = await listLocalServices();
+    const matches = services.filter((service) => SERVICE_SHARE_ID.test(selector) ? service.serviceShareId === selector : service.label === selector);
+    if (matches.length !== 1)
+        throw new Error(matches.length === 0 ? `No service "${selector}" on this computer. Run frely service list.` : `More than one service is called "${selector}"; use its id.`);
+    return matches[0];
+}
+async function shareService(options, io, deps) {
+    const say = (text) => { if (!options.json)
+        io.write(text); };
+    if (!(await deps.probe(options.port)))
+        throw new Error(`Nothing is listening on 127.0.0.1:${options.port}. Start your ${options.type.toUpperCase()} service first.`);
+    const control = await deps.control();
+    const record = await control.register({ type: options.type, label: options.label });
+    const existing = (await listLocalServices()).find((service) => service.serviceShareId === record.id);
+    if (existing?.background && !options.background)
+        throw new Error(`${record.label} is already kept connected by the background service. Run \`frely service stop ${record.id}\` first, or share it again with --background.`);
+    const service = { serviceShareId: record.id, type: record.type, label: record.label, port: options.port, createdAt: existing?.createdAt || record.createdAt || new Date().toISOString(), background: options.background };
+    await saveLocalService(service);
+    if (options.background) {
+        await deps.installDaemon();
+        if (options.json)
+            io.write(`${JSON.stringify({ serviceShareId: record.id, type: record.type, label: record.label, background: true })}\n`);
+        else
+            io.write(`Service ${record.id} (${record.type}, ${record.label}) is kept connected by the background service. It is not a public link: only Frely can reach it. ${ALLOWANCE_NOTE}\n`);
+        return 0;
+    }
+    const outcome = await runServiceSession(service, {
+        control, ensureFrpc: deps.ensureFrpc, spawnFrpc: deps.spawnFrpc, write: io.write, signal: deps.signal,
+        onGrant: (grant) => {
+            if (options.json) {
+                io.write(`${JSON.stringify({ serviceShareId: record.id, type: record.type, label: record.label, sessionId: grant.id, expiresAt: grant.expiresAt, remainingBytes: grant.remainingBytes })}\n`);
+                return;
+            }
+            say(`Sharing ${record.type.toUpperCase()} service ${record.id} (${record.label}) from 127.0.0.1:${options.port}. There is no public link; only Frely can reach it.\n`);
+            for (const line of allowanceLines(grant))
+                say(`${line}\n`);
+            say(`Expires ${grant.expiresAt}; run again to renew, or use --background to keep it connected. Press Ctrl+C to stop.\n`);
+        },
+    });
+    say(`\n${outcome.reason}\n`);
+    return outcome.stopped ? 0 : 1;
+}
+//# sourceMappingURL=service-run.js.map

package/dist/share/service-run.js.map

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