@mono-agent/agent-app 0.11.5 → 0.13.0

package/dist/web-command.d.ts

@@ -1,53 +1,119 @@
-import { startSessionWebServer } from "@mono-agent/session-web";
-import type { SessionWebServerHandle } from "@mono-agent/session-web";
-export declare const DEFAULT_WEB_PORT = 4599;
-export interface RunWebOptions {
-    readonly configPath: string;
-    readonly cwd: string;
+import type { LaunchctlRunner, LaunchdPaths } from "./launchd.js";
+export declare const DEFAULT_WEB_HOST = "0.0.0.0";
+export declare const DEFAULT_WEB_PORT = 5050;
+export declare const WEB_LAUNCHD_LABEL = "com.mono-agent-web";
+declare const TAILSCALE_OWNERSHIP_SCHEMA = "mono-agent.web-tailscale-serve.v1";
+interface WebServerHandle {
+    readonly url: string;
+    readonly host?: string;
+    readonly port?: number;
+    readonly boundAddress?: string;
+    stop(): Promise<void>;
+}
+interface StartWebServerOptions {
+    readonly host?: string;
+    readonly port?: number;
+    readonly registryDirs?: readonly string[];
+    readonly stateDir?: string;
+    readonly env?: Record<string, string | undefined>;
+}
+interface ResetWebStateOptions {
+    readonly stateDir?: string;
+    readonly env?: Record<string, string | undefined>;
+}
+interface PrepareWebStateOptions {
+    readonly stateDir?: string;
+    readonly env?: Record<string, string | undefined>;
+}
+export interface RunWebCommandOptions {
+    readonly positionals: readonly string[];
     readonly env: Record<string, string | undefined>;
-    /** --host: bind address (default 127.0.0.1). */
     readonly host?: string;
-    /** --port: bind port (default 4599). */
     readonly port?: number;
-    /** --no-open: suppress the browser launch (default: open). */
-    readonly open?: boolean;
-    /** --allow-non-loopback: bind a non-loopback host (refused by default). */
-    readonly allowNonLoopback?: boolean;
-    /** --show-auth-url: reveal a configured token only in an interactive terminal. */
-    readonly showAuthUrl?: boolean;
-    /** --include-memory: show memory-maintenance runs in the web operator surface. */
-    readonly includeMemory?: boolean;
-    /**
-     * --max-runs: per-instance cap on the in-memory live-fold working set (and the
-     * initial snapshot size). Disk paging remains the full history source, so this
-     * only bounds memory; it does not limit how far "Load older" can reach.
-     */
-    readonly maxRunsPerInstance?: number;
-}
-/** Test seams: server boot, browser open, and the shutdown wait are injectable. */
-export interface RunWebDeps {
-    readonly startServer?: typeof startSessionWebServer;
-    readonly openUrl?: (url: string) => void;
-    readonly waitForShutdown?: () => Promise<void>;
-    readonly onReady?: (handle: SessionWebServerHandle) => void;
+    readonly loopback?: boolean;
+    readonly follow?: boolean;
+    readonly lines?: number;
+    readonly all?: boolean;
+    readonly yes?: boolean;
+}
+export interface CommandResult {
+    readonly code: number;
+    readonly stdout: string;
+    readonly stderr: string;
+}
+export type CommandRunner = (args: readonly string[]) => Promise<CommandResult>;
+interface ManagedRuntimeResult {
+    readonly cliPath: string;
+    readonly nodePath: string;
+}
+export interface RunWebCommandDeps {
+    readonly platform?: NodeJS.Platform;
+    readonly getuid?: () => number;
+    readonly now?: () => number;
+    readonly sleep?: (ms: number) => Promise<void>;
     readonly stdout?: {
         write(text: string): void;
     };
     readonly stderr?: {
         write(text: string): void;
     };
-    readonly interactive?: boolean;
-    readonly discoverNetworkAddresses?: () => readonly WebNetworkAddress[];
-}
-export interface WebNetworkAddress {
-    readonly address: string;
-    readonly kind: "lan" | "tailscale";
-}
-/**
- * `mono-agent web`: discover every running agent on this machine (trace-source
- * registry, the same mechanism as `mono-agent tui`) and serve the read-only
- * Session Recorder PWA that visualises their runs live. Unlike `tui`, it shows
- * ALL instances at once and needs no TTY — it runs until interrupted.
- */
-export declare function runWeb(options: RunWebOptions, deps?: RunWebDeps): Promise<number>;
+    readonly launchctl?: LaunchctlRunner;
+    readonly tailscale?: CommandRunner;
+    readonly startServer?: (options: StartWebServerOptions) => Promise<WebServerHandle>;
+    readonly resetState?: (options: ResetWebStateOptions) => Promise<void>;
+    readonly prepareState?: (options: PrepareWebStateOptions) => Promise<void>;
+    readonly waitForShutdown?: () => Promise<void>;
+    readonly healthcheck?: (url: string) => Promise<boolean>;
+    readonly isAlive?: (pid: number) => boolean;
+    readonly ensureManagedRuntime?: (input: {
+        readonly currentCliPath: string;
+        readonly nodePath: string;
+    }) => Promise<ManagedRuntimeResult>;
+    readonly spawnTail?: (args: readonly string[]) => Promise<number>;
+    readonly writePrivateFile?: (path: string, contents: string) => Promise<void>;
+    readonly acquireLifecycleLock?: (paths: WebPaths) => Promise<(() => Promise<void>) | undefined>;
+    readonly discoverNetworkAddresses?: () => readonly string[];
+    readonly homeDir?: string;
+}
+export interface TailscaleServeOwnership {
+    readonly schema: typeof TAILSCALE_OWNERSHIP_SCHEMA;
+    readonly webKey: string;
+    readonly httpsPort: number;
+    readonly proxyTarget: string;
+    /** Exact canonical TCP + Web handler config owned at publication time. */
+    readonly configSha256: string;
+    readonly url: string;
+    readonly configuredAt: string;
+}
+type TailscaleServeResult = {
+    readonly kind: "active";
+    readonly ownership: TailscaleServeOwnership;
+    readonly reused: boolean;
+} | {
+    readonly kind: "unavailable";
+    readonly detail: string;
+    /** The old owned route was migrated, so the replacement worker must also be rolled back. */
+    readonly requiresServiceRollback?: true;
+};
+export interface WebPaths {
+    readonly stateDir: string;
+    readonly recordPath: string;
+    readonly tailscalePath: string;
+    readonly launchd: LaunchdPaths;
+}
+export declare function webPaths(homeDir?: string): WebPaths;
+export declare function renderWebHelp(): string;
+/** Route the `mono-agent web` service namespace. Bare invocation is read-only. */
+export declare function runWebCommand(options: RunWebCommandOptions, deps?: RunWebCommandDeps): Promise<number>;
+export declare function webHealthcheck(url: string): Promise<boolean>;
+export declare function ensureTailscaleServe(paths: WebPaths, bindHost: string, appPort: number, env: Record<string, string | undefined>, deps: RunWebCommandDeps, expectedDnsName?: string): Promise<TailscaleServeResult>;
+export declare function tailscaleProxyTarget(bindHost: string, appPort: number): string | undefined;
+export declare function removeOwnedTailscaleServe(paths: WebPaths, deps: RunWebCommandDeps): Promise<{
+    readonly kind: "removed" | "absent";
+} | {
+    readonly kind: "unavailable";
+    readonly detail: string;
+}>;
+export declare function chooseTailscaleHttpsPort(status: Record<string, unknown>): number | undefined;
+export {};
 //# sourceMappingURL=web-command.d.ts.map

package/dist/web-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-command.d.ts","sourceRoot":"","sources":["../src/web-command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAYtE,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAGrC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,gDAAgD;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,mFAAmF;AACnF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,qBAAqB,CAAC;IACpD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,SAAS,iBAAiB,EAAE,CAAC;CACxE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,WAAW,CAAC;CACpC;AAOD;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAkF3F"}
+{"version":3,"file":"web-command.d.ts","sourceRoot":"","sources":["../src/web-command.ts"],"names":[],"mappings":"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"}