@bytetrue/byspace 0.14.6 → 0.16.0

package/node_modules/@bytetrue/protocol/dist/messages.js

@@ -191,6 +191,22 @@ export const MutableDaemonConfigSchema = z
     })
         .passthrough()
         .optional(),
+    // COMPAT(daemonServiceInstall): added in v0.14.7. Derived view of the OS service
+    // manager state; the daemon re-queries it lazily, never caches a stale verdict.
+    service: z
+        .object({
+        state: z.enum([
+            "not-installed",
+            "installed-stopped",
+            "installed-running-not-this-process",
+            "managed-by-service",
+            "unknown",
+        ]),
+        label: z.string(),
+        linger: z.boolean().optional(),
+    })
+        .passthrough()
+        .optional(),
 })
     .passthrough();
 export const MutableDaemonConfigPatchSchema = z
@@ -232,6 +248,15 @@ export const MutableDaemonConfigPatchSchema = z
     })
         .passthrough()
         .optional(),
+    // COMPAT(daemonServiceInstall): added in v0.14.7; old daemons drop these patches.
+    // Install/uninstall execute in the daemon process and need its install-origin
+    // context, so they ride the same config-patch pipe instead of a separate RPC.
+    service: z
+        .object({
+        install: z.boolean().optional(),
+    })
+        .passthrough()
+        .optional(),
 })
     .partial()
     .passthrough();
@@ -3207,6 +3232,10 @@ export const ServerInfoStatusPayloadSchema = z
         // Old daemons drop network/auth config patches silently, so clients must
         // hide the network settings instead of letting a save appear to succeed.
         daemonNetworkConfig: z.boolean().optional(),
+        // COMPAT(daemonServiceInstall): added in v0.14.7. When false (or absent on
+        // an older daemon), the app hides the service-management switch instead of
+        // letting an install appear to succeed.
+        daemonServiceInstall: z.boolean().optional(),
     })
         .optional(),
 })

package/node_modules/@bytetrue/protocol/dist/validation/ws-outbound-schema-metadata.d.ts

@@ -1091,8 +1091,8 @@ export declare const WSOutboundMessageSchema: {
                     scripts: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
                         scriptName: import("zod").ZodString;
                         type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                            script: "script";
                             service: "service";
+                            script: "script";
                         }>>>;
                         hostname: import("zod").ZodString;
                         port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -1267,7 +1267,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -1377,7 +1377,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -1685,8 +1685,8 @@ export declare const WSOutboundMessageSchema: {
                 scripts: import("zod").ZodArray<import("zod").ZodObject<{
                     scriptName: import("zod").ZodString;
                     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                        script: "script";
                         service: "service";
+                        script: "script";
                     }>>>;
                     hostname: import("zod").ZodString;
                     port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -2362,8 +2362,8 @@ export declare const WSOutboundMessageSchema: {
                     scripts: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
                         scriptName: import("zod").ZodString;
                         type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                            script: "script";
                             service: "service";
+                            script: "script";
                         }>>>;
                         hostname: import("zod").ZodString;
                         port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -2538,7 +2538,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -2648,7 +2648,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -2877,8 +2877,8 @@ export declare const WSOutboundMessageSchema: {
                     scripts: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
                         scriptName: import("zod").ZodString;
                         type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                            script: "script";
                             service: "service";
+                            script: "script";
                         }>>>;
                         hostname: import("zod").ZodString;
                         port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -3053,7 +3053,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -3163,7 +3163,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -3383,8 +3383,8 @@ export declare const WSOutboundMessageSchema: {
                 script: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
                     scriptName: import("zod").ZodString;
                     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                        script: "script";
                         service: "service";
+                        script: "script";
                     }>>>;
                     hostname: import("zod").ZodString;
                     port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -3405,8 +3405,8 @@ export declare const WSOutboundMessageSchema: {
                 scripts: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     scriptName: import("zod").ZodString;
                     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                        script: "script";
                         service: "service";
+                        script: "script";
                     }>>>;
                     hostname: import("zod").ZodString;
                     port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -3435,8 +3435,8 @@ export declare const WSOutboundMessageSchema: {
                 script: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
                     scriptName: import("zod").ZodString;
                     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                        script: "script";
                         service: "service";
+                        script: "script";
                     }>>>;
                     hostname: import("zod").ZodString;
                     port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -3457,8 +3457,8 @@ export declare const WSOutboundMessageSchema: {
                 scripts: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     scriptName: import("zod").ZodString;
                     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                        script: "script";
                         service: "service";
+                        script: "script";
                     }>>>;
                     hostname: import("zod").ZodString;
                     port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -3487,8 +3487,8 @@ export declare const WSOutboundMessageSchema: {
                 script: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodObject<{
                     scriptName: import("zod").ZodString;
                     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                        script: "script";
                         service: "service";
+                        script: "script";
                     }>>>;
                     hostname: import("zod").ZodString;
                     port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -3509,8 +3509,8 @@ export declare const WSOutboundMessageSchema: {
                 scripts: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
                     scriptName: import("zod").ZodString;
                     type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                        script: "script";
                         service: "service";
+                        script: "script";
                     }>>>;
                     hostname: import("zod").ZodString;
                     port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -4216,8 +4216,8 @@ export declare const WSOutboundMessageSchema: {
                     scripts: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
                         scriptName: import("zod").ZodString;
                         type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                            script: "script";
                             service: "service";
+                            script: "script";
                         }>>>;
                         hostname: import("zod").ZodString;
                         port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -4392,7 +4392,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -4502,7 +4502,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -4913,6 +4913,17 @@ export declare const WSOutboundMessageSchema: {
                     auth: import("zod").ZodOptional<import("zod").ZodObject<{
                         passwordSet: import("zod").ZodBoolean;
                     }, import("zod/v4/core").$loose>>;
+                    service: import("zod").ZodOptional<import("zod").ZodObject<{
+                        state: import("zod").ZodEnum<{
+                            unknown: "unknown";
+                            "not-installed": "not-installed";
+                            "installed-stopped": "installed-stopped";
+                            "installed-running-not-this-process": "installed-running-not-this-process";
+                            "managed-by-service": "managed-by-service";
+                        }>;
+                        label: import("zod").ZodString;
+                        linger: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    }, import("zod/v4/core").$loose>>;
                 }, import("zod/v4/core").$loose>;
             }, import("zod/v4/core").$loose>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -5008,6 +5019,17 @@ export declare const WSOutboundMessageSchema: {
                     auth: import("zod").ZodOptional<import("zod").ZodObject<{
                         passwordSet: import("zod").ZodBoolean;
                     }, import("zod/v4/core").$loose>>;
+                    service: import("zod").ZodOptional<import("zod").ZodObject<{
+                        state: import("zod").ZodEnum<{
+                            unknown: "unknown";
+                            "not-installed": "not-installed";
+                            "installed-stopped": "installed-stopped";
+                            "installed-running-not-this-process": "installed-running-not-this-process";
+                            "managed-by-service": "managed-by-service";
+                        }>;
+                        label: import("zod").ZodString;
+                        linger: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    }, import("zod/v4/core").$loose>>;
                 }, import("zod/v4/core").$loose>;
             }, import("zod/v4/core").$loose>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -6480,8 +6502,8 @@ export declare const WSOutboundMessageSchema: {
                     scripts: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
                         scriptName: import("zod").ZodString;
                         type: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodEnum<{
-                            script: "script";
                             service: "service";
+                            script: "script";
                         }>>>;
                         hostname: import("zod").ZodString;
                         port: import("zod").ZodNullable<import("zod").ZodNumber>;
@@ -6656,7 +6678,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;
@@ -6766,7 +6788,7 @@ export declare const WSOutboundMessageSchema: {
                     activityAt: string | null;
                     scripts: {
                         scriptName: string;
-                        type: "script" | "service";
+                        type: "service" | "script";
                         hostname: string;
                         port: number | null;
                         proxyUrl: string | null;

package/node_modules/@bytetrue/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytetrue/protocol",
-  "version": "0.14.6",
+  "version": "0.16.0",
   "description": "BySpace shared protocol schemas and wire types",
   "files": [
     "dist",

package/node_modules/@bytetrue/relay/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytetrue/relay",
-  "version": "0.14.6",
+  "version": "0.16.0",
   "description": "BySpace relay for bridging daemon and client connections",
   "files": [
     "dist",

package/node_modules/@bytetrue/server/dist/server/server/byspace-env.d.ts

@@ -1,3 +1,4 @@
+export declare const PI_TERMINAL_HOOK_OWNER_PID_ENV_KEY = "BYSPACE_PI_TERMINAL_HOOK_OWNER_PID";
 export type BySpaceNodeEnv = "development" | "production" | "test";
 export type ProcessEnvRecord = Record<string, string | undefined>;
 export type ExternalProcessEnv = NodeJS.ProcessEnv & Record<string, string>;

package/node_modules/@bytetrue/server/dist/server/server/byspace-env.js

@@ -1,5 +1,7 @@
 const BYSPACE_NODE_ENV = "BYSPACE_NODE_ENV";
 const ELECTRON_RUN_AS_NODE = "ELECTRON_RUN_AS_NODE";
+// Shared with the installed Pi extension (which cannot import from here).
+export const PI_TERMINAL_HOOK_OWNER_PID_ENV_KEY = "BYSPACE_PI_TERMINAL_HOOK_OWNER_PID";
 const RUNTIME_CONTROL_ENV_KEYS = [
     BYSPACE_NODE_ENV,
     "BYSPACE_DESKTOP_MANAGED",
@@ -7,6 +9,13 @@ const RUNTIME_CONTROL_ENV_KEYS = [
     ELECTRON_RUN_AS_NODE,
     "ELECTRON_NO_ATTACH_CONSOLE",
     "ESBUILD_BINARY_PATH",
+    // Written into `process.env` by the Pi terminal-activity extension so child Pi
+    // processes do not register a second reporter for the same terminal. If it
+    // survives into a fresh terminal or agent, that Pi process sees a marker whose
+    // value is a stale pid, concludes it is an inherited child, and registers no
+    // handlers at all — the terminal then never reports running/idle. It is
+    // per-process state, never inherited. See docs/terminal-activity.md.
+    PI_TERMINAL_HOOK_OWNER_PID_ENV_KEY,
 ];
 function buildInternalProcessEnv(baseEnv) {
     return { ...baseEnv };

package/node_modules/@bytetrue/server/dist/server/server/daemon-config-store.d.ts

@@ -71,6 +71,17 @@ export declare class DaemonConfigStore {
         tcpPort: number | null;
         allowLanAccess: boolean;
     }): void;
+    /**
+     * Re-probe the OS service manager and refresh the derived service view. Never
+     * persists: the service state is a property of the host, not of config.json.
+     */
+    refreshServiceRuntimeState(): void;
+    /**
+     * Execute a service install/uninstall (issue 043). Install/uninstall are side
+     * effects on the OS service manager, never config state: the mutable view stays
+     * untouched and the service view is re-probed on demand.
+     */
+    private applyServicePatch;
     reload(): DaemonConfigReloadResult;
     private applyReplacement;
     onFieldChange(path: string, handler: FieldChangeHandler): () => void;

package/node_modules/@bytetrue/server/dist/server/server/daemon-config-store.js

@@ -1,5 +1,7 @@
 import { loadPersistedConfig, savePersistedConfig, } from "./persisted-config.js";
 import { hashDaemonPassword } from "./auth.js";
+import { DAEMON_SERVICE_LABEL, queryDaemonServiceView, validateServiceOriginSync, } from "./session/daemon/daemon-service-manager.js";
+import { buildServerServiceSpec, installLaunchdServiceServer, installSystemdServiceServer, uninstallLaunchdServiceServer, uninstallSystemdServiceServer, uninstallWindowsTaskServer, } from "./session/daemon/daemon-service-install.js";
 import { isLanListenString } from "./hostnames.js";
 import { ProviderOverrideSchema } from "./agent/provider-launch-config.js";
 import { MutableDaemonConfigSchema, MutableDaemonConfigPatchSchema, TERMINAL_AGENT_HOOK_LEGACY_GLOBAL_PROVIDER_IDS, TERMINAL_AGENT_HOOK_PROVIDER_IDS, } from "@bytetrue/protocol/messages";
@@ -183,6 +185,7 @@ function pickSupportedPatchFields(patch) {
         ...(patch.pluginsEnabled !== undefined ? { pluginsEnabled: patch.pluginsEnabled } : {}),
         ...(patch.plugins !== undefined ? { plugins: patch.plugins } : {}),
         ...pickNetworkAuthPatchFields(patch),
+        ...(patch.service !== undefined ? { service: patch.service } : {}),
     };
 }
 function pickNetworkAuthPatchFields(patch) {
@@ -285,6 +288,9 @@ export class DaemonConfigStore {
         this.startupPersisted =
             options.startupPersisted ?? loadPersistedConfig(byspaceHome, this.logger);
         this.lastKnownPersisted = this.startupPersisted;
+        // Service view is probed, not persisted: refresh it once at construction so the
+        // first server_info carries a real state, then again after each service patch.
+        this.refreshServiceRuntimeState();
     }
     get() {
         return this.current;
@@ -303,7 +309,14 @@ export class DaemonConfigStore {
         // The network/auth patch never lands in the mutable view verbatim: the
         // plaintext password and listen semantics are translated below, and only
         // the derived view fields (allowLanAccess / passwordSet) surface to clients.
-        const { removeProviders = [], network: networkPatch, auth: authPatch, ...rawConfigPatch } = parsedPatch;
+        const { removeProviders = [], network: networkPatch, auth: authPatch, service: servicePatch, ...rawConfigPatch } = parsedPatch;
+        // Service install is a side effect, not config state: it runs the OS service
+        // registration and the resulting view refresh arrives via the service probe.
+        if (servicePatch?.install !== undefined) {
+            this.applyServicePatch(servicePatch.install);
+            // Re-probe after the side effect so the response carries the new state.
+            this.refreshServiceRuntimeState();
+        }
         let daemonPersistedPatch = null;
         let networkViewPatch = {};
         const resolved = this.resolveDaemonNetworkPatch(networkPatch, authPatch);
@@ -417,6 +430,63 @@ export class DaemonConfigStore {
         });
         this.applyReplacement(next, { removedProviders: [] });
     }
+    /**
+     * Re-probe the OS service manager and refresh the derived service view. Never
+     * persists: the service state is a property of the host, not of config.json.
+     */
+    refreshServiceRuntimeState() {
+        let view;
+        try {
+            view = queryDaemonServiceView();
+        }
+        catch {
+            // The service-manager probe is host-dependent (launchctl/systemctl may be
+            // absent, e.g. unit tests or containers); leave the view out rather than
+            // failing every config operation.
+            return;
+        }
+        const next = MutableDaemonConfigSchema.parse({
+            ...this.current,
+            service: view,
+        });
+        if (JSON.stringify(next) === JSON.stringify(this.current))
+            return;
+        this.applyReplacement(next, { removedProviders: [] });
+    }
+    /**
+     * Execute a service install/uninstall (issue 043). Install/uninstall are side
+     * effects on the OS service manager, never config state: the mutable view stays
+     * untouched and the service view is re-probed on demand.
+     */
+    applyServicePatch(install) {
+        if (install) {
+            // The same npm-global guard the CLI enforces: a service must point at the
+            // published install, not a dev checkout or container filesystem. The daemon
+            // process runs the check because it owns the install-origin context.
+            const originError = validateServiceOriginSync();
+            if (originError)
+                throw new Error(originError);
+            const spec = buildServerServiceSpec(this.byspaceHome);
+            if (process.platform === "darwin") {
+                installLaunchdServiceServer(spec);
+            }
+            else if (process.platform === "linux") {
+                installSystemdServiceServer(spec);
+            }
+            else {
+                throw new Error("Service installation is not supported on this platform (expected macOS or Linux).");
+            }
+        }
+        else if (process.platform === "darwin") {
+            uninstallLaunchdServiceServer(DAEMON_SERVICE_LABEL);
+        }
+        else if (process.platform === "linux") {
+            uninstallSystemdServiceServer(DAEMON_SERVICE_LABEL);
+        }
+        else if (process.platform === "win32") {
+            uninstallWindowsTaskServer(DAEMON_SERVICE_LABEL);
+        }
+    }
     reload() {
         if (!this.reloadSource) {
             throw new Error("Daemon config reload is unavailable for this daemon instance");

package/node_modules/@bytetrue/server/dist/server/server/session/daemon/daemon-service-install.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Server-side service install (issue 043). The daemon installs *itself*: it knows its
+ * own node executable, runner entry, and environment. This deliberately does not
+ * import the CLI's service layer — the server bundle cannot depend on the CLI, and
+ * the CLI command covers the same ground from the outside.
+ *
+ * KeepAlive is false so `byspace daemon stop` stays a real stop.
+ */
+export interface ServerServiceSpec {
+    label: string;
+    nodePath: string;
+    runnerEntry: string;
+    logPath: string;
+    env: Record<string, string>;
+}
+export declare function buildServerServiceSpec(home: string): ServerServiceSpec;
+export declare function renderLaunchdPlist(spec: ServerServiceSpec): string;
+/** Write the plist and load it. The daemon exits after install; launchd takes over. */
+export declare function installLaunchdServiceServer(spec: ServerServiceSpec): void;
+/** Stop and remove the service definition. The daemon keeps running until stopped. */
+export declare function uninstallLaunchdServiceServer(label: string): void;
+export declare function installSystemdServiceServer(spec: ServerServiceSpec): void;
+export declare function uninstallSystemdServiceServer(label: string): void;
+export declare function uninstallWindowsTaskServer(label: string): void;
+//# sourceMappingURL=daemon-service-install.d.ts.map