@camstack/types 1.1.34 → 1.1.36

package/dist/capabilities/server-management.cap.d.ts

@@ -0,0 +1,194 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/**
+ * server-management — per-NODE singleton capability for a node's ROOT
+ * package lifecycle (runtime-updatable node packages, phase 2: hub + docker
+ * agents).
+ *
+ * Each node's root package (`@camstack/server` on the hub, `@camstack/agent`
+ * on agents) carries the whole software stack in its npm dep tree, so ONE
+ * version describes the node. Updates install into
+ * `<dataDir>/server-root/versions/<v>/` and apply on restart via the baked
+ * starter (probation boot + auto-rollback to N-1).
+ *
+ * Providers:
+ *   - HUB: `ServerUpdateService` behind the `server-provided` mount
+ *     (`buildServerProviders` in trpc.router.ts) — the default target for
+ *     unpinned calls.
+ *   - AGENT: `AgentUpdateService` registered by the agent bootstrap under
+ *     the synthetic `agent-runtime` addonId and declared in the agent's
+ *     `$hub.registerNode` manifest.
+ *
+ * Node routing: singleton caps get the codegen/runtime-builder `nodeId`
+ * injection on every method — `input.nodeId` (or `nodePin(nodeId)` from the
+ * SDK) routes the call to that node's provider via the standard remote
+ * proxy (`createCapabilityProxy` → `$agent-cap-fwd` → the agent's
+ * in-process provider lookup). No `nodeId` → the hub's own provider.
+ *
+ * Spec: docs/superpowers/specs/2026-07-12-runtime-updatable-node-packages-design.md
+ */
+/**
+ * Where the running hub's code was loaded from:
+ *  - `workspace` — dev checkout (tsx / workspace dist); the starter defers to
+ *    plain resolution and runtime updates are refused.
+ *  - `baked`     — the immutable image seed closure (no data-dir root active).
+ *  - `data-root` — the runtime-updatable `<dataDir>/server-root` closure.
+ */
+declare const ServerBootModeSchema: z.ZodEnum<{
+    workspace: "workspace";
+    baked: "baked";
+    "data-root": "data-root";
+}>;
+/**
+ * Update lifecycle state:
+ *  - `idle` / `checking` / `staging` — steady / in-flight registry work.
+ *  - `pending-restart` — a version is staged and the node has NOT yet
+ *    restarted onto it (still running the OLD version).
+ *  - `awaiting-confirmation` — the node HAS restarted onto the staged version
+ *    (it is the active probation boot) and is waiting to confirm boot-health.
+ *    Apply/rollback are refused in this state and the node must NOT be
+ *    manually restarted, or the probation boot auto-rolls-back.
+ */
+declare const ServerUpdateStateSchema: z.ZodEnum<{
+    idle: "idle";
+    checking: "checking";
+    staging: "staging";
+    "pending-restart": "pending-restart";
+    "awaiting-confirmation": "awaiting-confirmation";
+}>;
+declare const ServerRollbackInfoSchema: z.ZodObject<{
+    fromVersion: z.ZodString;
+    toVersion: z.ZodNullable<z.ZodString>;
+    atMs: z.ZodNumber;
+    reason: z.ZodString;
+}, z.core.$strip>;
+declare const ServerPackageStatusSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    runningVersion: z.ZodNullable<z.ZodString>;
+    nodeRuntimeVersion: z.ZodNullable<z.ZodString>;
+    activeVersion: z.ZodNullable<z.ZodString>;
+    previousVersion: z.ZodNullable<z.ZodString>;
+    seedVersion: z.ZodNullable<z.ZodString>;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    updateAvailable: z.ZodBoolean;
+    bootMode: z.ZodEnum<{
+        workspace: "workspace";
+        baked: "baked";
+        "data-root": "data-root";
+    }>;
+    updateState: z.ZodEnum<{
+        idle: "idle";
+        checking: "checking";
+        staging: "staging";
+        "pending-restart": "pending-restart";
+        "awaiting-confirmation": "awaiting-confirmation";
+    }>;
+    pendingVersion: z.ZodNullable<z.ZodString>;
+    rolledBack: z.ZodNullable<z.ZodObject<{
+        fromVersion: z.ZodString;
+        toVersion: z.ZodNullable<z.ZodString>;
+        atMs: z.ZodNumber;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    stateFileCorrupt: z.ZodBoolean;
+    lastCheckedAtMs: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+declare const ServerUpdateCheckResultSchema: z.ZodObject<{
+    packageName: z.ZodString;
+    runningVersion: z.ZodNullable<z.ZodString>;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    updateAvailable: z.ZodBoolean;
+    checkedAtMs: z.ZodNumber;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const ServerUpdateActionResultSchema: z.ZodObject<{
+    accepted: z.ZodBoolean;
+    targetVersion: z.ZodNullable<z.ZodString>;
+    restarting: z.ZodBoolean;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const serverManagementCapability: {
+    readonly name: "server-management";
+    readonly scope: "system";
+    readonly mode: "singleton";
+    readonly methods: {
+        readonly getServerPackageStatus: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            packageName: z.ZodString;
+            runningVersion: z.ZodNullable<z.ZodString>;
+            nodeRuntimeVersion: z.ZodNullable<z.ZodString>;
+            activeVersion: z.ZodNullable<z.ZodString>;
+            previousVersion: z.ZodNullable<z.ZodString>;
+            seedVersion: z.ZodNullable<z.ZodString>;
+            latestVersion: z.ZodNullable<z.ZodString>;
+            updateAvailable: z.ZodBoolean;
+            bootMode: z.ZodEnum<{
+                workspace: "workspace";
+                baked: "baked";
+                "data-root": "data-root";
+            }>;
+            updateState: z.ZodEnum<{
+                idle: "idle";
+                checking: "checking";
+                staging: "staging";
+                "pending-restart": "pending-restart";
+                "awaiting-confirmation": "awaiting-confirmation";
+            }>;
+            pendingVersion: z.ZodNullable<z.ZodString>;
+            rolledBack: z.ZodNullable<z.ZodObject<{
+                fromVersion: z.ZodString;
+                toVersion: z.ZodNullable<z.ZodString>;
+                atMs: z.ZodNumber;
+                reason: z.ZodString;
+            }, z.core.$strip>>;
+            stateFileCorrupt: z.ZodBoolean;
+            lastCheckedAtMs: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly checkServerUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            packageName: z.ZodString;
+            runningVersion: z.ZodNullable<z.ZodString>;
+            latestVersion: z.ZodNullable<z.ZodString>;
+            updateAvailable: z.ZodBoolean;
+            checkedAtMs: z.ZodNumber;
+            error: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>, "mutation">;
+        readonly applyServerUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            accepted: z.ZodBoolean;
+            targetVersion: z.ZodNullable<z.ZodString>;
+            restarting: z.ZodBoolean;
+            message: z.ZodString;
+        }, z.core.$strip>, "mutation">;
+        readonly rollbackServerUpdate: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            accepted: z.ZodBoolean;
+            targetVersion: z.ZodNullable<z.ZodString>;
+            restarting: z.ZodBoolean;
+            message: z.ZodString;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * Plain process restart of the node's root process — no version change.
+         * The supervisor (docker restart policy / launchd / Electron main)
+         * relaunches and the starter loads the SAME active version. Refused while
+         * a stage is in flight or a version is already staged awaiting restart
+         * (use apply/rollback instead, so the pending version is not skipped).
+         */
+        readonly restartServer: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            accepted: z.ZodBoolean;
+            targetVersion: z.ZodNullable<z.ZodString>;
+            restarting: z.ZodBoolean;
+            message: z.ZodString;
+        }, z.core.$strip>, "mutation">;
+    };
+    /** BIG PLAN 2: declarative mount hint — read by `@camstack/system` `buildCapRouters`. */
+    readonly mount: {
+        readonly kind: "server-provided";
+    };
+};
+export type IServerManagementProvider = InferProvider<typeof serverManagementCapability>;
+export type ServerBootMode = z.infer<typeof ServerBootModeSchema>;
+export type ServerUpdateState = z.infer<typeof ServerUpdateStateSchema>;
+export type ServerRollbackInfo = z.infer<typeof ServerRollbackInfoSchema>;
+export type ServerPackageStatus = z.infer<typeof ServerPackageStatusSchema>;
+export type ServerUpdateCheckResult = z.infer<typeof ServerUpdateCheckResultSchema>;
+export type ServerUpdateActionResult = z.infer<typeof ServerUpdateActionResultSchema>;
+export { ServerBootModeSchema, ServerUpdateStateSchema, ServerRollbackInfoSchema, ServerPackageStatusSchema, ServerUpdateCheckResultSchema, ServerUpdateActionResultSchema, };

package/dist/capabilities/viewer-ui.cap.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { type InferProvider } from './capability-definition.js';
+/**
+ * viewer-ui — serves the CamStack VIEWER web build (the Expo/React-Native
+ * universal client's PWA export) from the hub, alongside admin-ui. Mirrors
+ * `admin-ui` exactly: a singleton, server-internal cap exposing the static
+ * dist directory + build version so `main.ts` can mount the SPA under a
+ * dedicated prefix.
+ */
+export declare const viewerUiCapability: {
+    readonly name: "viewer-ui";
+    readonly scope: "system";
+    readonly mode: "singleton";
+    readonly internal: true;
+    readonly methods: {
+        readonly getStaticDir: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            staticDir: z.ZodString;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly getVersion: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodObject<{
+            version: z.ZodString;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+};
+export type IViewerUiProvider = InferProvider<typeof viewerUiCapability>;