@camstack/types 0.1.33 → 0.1.34

package/dist/{index-DRWlYskM.js → index-DS7418lf.js}

@@ -3869,10 +3869,30 @@ const mqttBrokerCapability = {
   }
 };
 const LinkStateSchema = zod.z.enum(["unlinked", "linked", "error"]);
+const ExportSetupFieldSchema = zod.z.object({
+  label: zod.z.string(),
+  value: zod.z.string(),
+  /** Mask the value by default + render a reveal toggle (client id, secrets). */
+  secret: zod.z.boolean().optional()
+});
+const ExportSetupSchema = zod.z.object({
+  /** A string to render as a scannable QR — HAP `X-HM://…` URI, a pairing URL, etc. Omitted when there's nothing to scan. */
+  qr: zod.z.string().optional(),
+  /** Label/value rows shown with a copy button (HAP setup code, OAuth URLs, client id, linked-account count, …). */
+  fields: zod.z.array(ExportSetupFieldSchema).readonly().optional(),
+  /** Free-form operator instructions rendered above the fields. */
+  note: zod.z.string().optional()
+});
 const DeviceExportStatusSchema = zod.z.object({
   linkState: LinkStateSchema,
   exposedDeviceCount: zod.z.number(),
-  error: zod.z.string().optional()
+  error: zod.z.string().optional(),
+  /**
+   * Optional pairing/account info the panel renders in a generic
+   * "Setup" section. Addon-agnostic — the addon id identifies the
+   * export target, never an `ecosystem` key here.
+   */
+  setup: ExportSetupSchema.optional()
 });
 const DeviceKindSchema = zod.z.string();
 const ExposedDeviceSchema = zod.z.object({
@@ -7551,7 +7571,25 @@ const MeshStatusSchema = zod.z.object({
    * doesn't rotate keys for the bound host. Operator-facing surface
    * for "your access expires on …" banners.
    */
-  keyExpiry: zod.z.number().nullable()
+  keyExpiry: zod.z.number().nullable(),
+  // ── Onboard-daemon handoff (Tailscale, generic slot) ────────────
+  /**
+   * When the provider runs its OWN mesh daemon (e.g. the Tailscale
+   * client addon in `onboard` mode spawns a private `tailscaled`),
+   * this carries the local control-socket path. Companion addons that
+   * must drive the SAME daemon — chiefly `tailscale-ingress` for
+   * Serve/Funnel — read it to point their CLI at the right socket
+   * instead of the system default. Empty when the provider uses the
+   * host's system daemon (or doesn't have the concept).
+   */
+  daemonSocket: zod.z.string().optional(),
+  /**
+   * Path to the mesh CLI binary the provider downloaded for onboard
+   * mode. Companion addons reuse it so they don't need a system
+   * install when the operator chose a fully self-contained mesh.
+   * Empty in host mode.
+   */
+  daemonCliPath: zod.z.string().optional()
 });
 const meshNetworkCapability = {
   name: "mesh-network",
@@ -8181,6 +8219,7 @@ const nodesCapability = {
   name: "nodes",
   scope: "system",
   mode: "singleton",
+  nodeIdMode: "data",
   methods: {
     topology: method(
       zod.z.void(),
@@ -8462,6 +8501,21 @@ const AddonAutoUpdateSchema = ChannelWithInheritSchema;
 const RestartAddonResultSchema = zod.z.unknown();
 const InstallPackageResultSchema = zod.z.unknown();
 const ReloadPackagesResultSchema = zod.z.unknown();
+const UpdateFrameworkPackageResultSchema = zod.z.object({
+  packageName: zod.z.string(),
+  fromVersion: zod.z.string(),
+  toVersion: zod.z.string(),
+  /** Ms-epoch the server scheduled its self-restart. */
+  restartingAt: zod.z.number()
+});
+const FrameworkPackageStatusSchema = zod.z.object({
+  packageName: zod.z.string(),
+  currentVersion: zod.z.string(),
+  latestVersion: zod.z.string().nullable(),
+  hasUpdate: zod.z.boolean(),
+  /** Optional manifest description for the row tooltip. */
+  description: zod.z.string().optional()
+});
 const LogStreamEntrySchema = zod.z.object({
   timestamp: zod.z.string(),
   level: zod.z.string(),
@@ -8478,6 +8532,7 @@ const addonsCapability = {
   name: "addons",
   scope: "system",
   mode: "singleton",
+  nodeIdMode: "data",
   methods: {
     // ── Listing ──────────────────────────────────────────────────────
     list: method(zod.z.void(), zod.z.array(AddonListItemSchema).readonly()),
@@ -8524,13 +8579,29 @@ const addonsCapability = {
       zod.z.object({ query: zod.z.string().optional() }),
       zod.z.array(SearchResultSchema)
     ),
+    /**
+     * Available package updates for a node. `nodeId` omitted (or
+     * `'hub'`) checks the hub's own installed packages; an agent
+     * `nodeId` checks that agent's installed roster against npm
+     * (the hub does the npm lookups + diff — agents stay npm-free).
+     */
     listUpdates: method(
-      zod.z.void(),
+      zod.z.object({ nodeId: zod.z.string().optional() }),
       zod.z.array(PackageUpdateSchema).readonly(),
       { auth: "admin" }
     ),
+    /**
+     * Update one package on a node. `nodeId` omitted (or `'hub'`)
+     * installs on the hub via npm; an agent `nodeId` makes the hub
+     * pack the resolved version and push the tarball to that agent
+     * (`$agent.deploy` + `$agent.reload`) — agents need no npm runtime.
+     */
     updatePackage: method(
-      zod.z.object({ name: zod.z.string().min(1), version: zod.z.string().optional() }),
+      zod.z.object({
+        name: zod.z.string().min(1),
+        version: zod.z.string().optional(),
+        nodeId: zod.z.string().optional()
+      }),
       zod.z.unknown(),
       { kind: "mutation", auth: "admin" }
     ),
@@ -8551,12 +8622,105 @@ const addonsCapability = {
       zod.z.object({ rolledBackTo: zod.z.string().nullable() }),
       { kind: "mutation", auth: "admin" }
     ),
-    forceRefresh: method(zod.z.void(), zod.z.unknown(), { kind: "mutation", auth: "admin" }),
+    /** Re-check updates for a node, bypassing any cache. `nodeId`
+     *  omitted (or `'hub'`) refreshes the hub; an agent `nodeId`
+     *  re-checks that agent's roster. */
+    forceRefresh: method(
+      zod.z.object({ nodeId: zod.z.string().optional() }),
+      zod.z.unknown(),
+      { kind: "mutation", auth: "admin" }
+    ),
     restartServer: method(
       zod.z.object({ confirm: zod.z.literal(true) }),
       zod.z.unknown(),
       { kind: "mutation", auth: "admin" }
     ),
+    /**
+     * Most-recent restart marker (kind / packageName / from→to versions
+     * / requestedBy / requestedAt). Returns `null` when this process
+     * didn't boot from a tracked restart, or when the
+     * post-boot retention window (5 min) has elapsed.
+     *
+     * Drives the admin-UI reconnect overlay's success toast — the
+     * `system.restart-completed` event itself is fired before the
+     * client has time to re-subscribe, so the client queries this on
+     * first reconnect instead.
+     */
+    getLastRestart: method(
+      zod.z.void(),
+      zod.z.object({
+        kind: zod.z.enum(["framework-update", "manual", "system"]),
+        packageName: zod.z.string().optional(),
+        fromVersion: zod.z.string().optional(),
+        toVersion: zod.z.string().optional(),
+        requestedBy: zod.z.string().optional(),
+        requestedAt: zod.z.number()
+      }).nullable(),
+      { auth: "admin" }
+    ),
+    /**
+     * Snapshot of the framework packages installed under the hub's
+     * `<appRoot>/node_modules/`. Each row carries the currently
+     * installed version and (best-effort) the latest version
+     * available on npm. Drives the admin-UI "System packages" panel.
+     *
+     * Spec: docs/superpowers/specs/2026-05-14-framework-live-update-design.md
+     */
+    listFrameworkPackages: method(
+      zod.z.void(),
+      zod.z.array(FrameworkPackageStatusSchema).readonly(),
+      { auth: "admin" }
+    ),
+    /**
+     * Cluster-wide capability-provider discovery. Returns the list of
+     * `{ addonId, mode, isActive }` tuples for whatever addon(s)
+     * currently provide the requested capability across the cluster.
+     *
+     * Why this lives on `addons` (and not on a `capabilities` cap of
+     * its own): the hub's main-process `CapabilityRegistry` already
+     * aggregates registrations from every forked group-runner and
+     * remote agent via Moleculer event propagation — there's no
+     * cross-process registry mirror to build, just an introspection
+     * shim.
+     *
+     * Use this from addon code when you need to know whether another
+     * addon has registered a specific cap (e.g. `tailscale-ingress`
+     * checking `tailscale-client` is up before calling `tailscale
+     * serve`). Don't reach for `ctx.capabilities.getCollectionEntries`
+     * — that reads the LOCAL registry of the calling addon's group
+     * runner and never sees providers in other processes. See
+     * `CLAUDE.md` → Critical rules → ctx.api vs ctx.capabilities.
+     */
+    listCapabilityProviders: method(
+      zod.z.object({ capName: zod.z.string().min(1) }),
+      zod.z.array(zod.z.object({
+        addonId: zod.z.string(),
+        mode: zod.z.enum(["singleton", "collection"]),
+        isActive: zod.z.boolean()
+      })).readonly()
+    ),
+    /**
+     * Live-update one of the framework packages marked
+     * `camstack.system: true` (`@camstack/types|kernel|core|sdk|ui-library`).
+     * Runs `npm install --prefix <appRoot> <name>@<version> --no-save`,
+     * writes a `.restart-pending` marker, emits `system.restarting`
+     * and schedules a graceful process exit. The supervisor (Docker /
+     * Electron / systemd) brings the hub back up; on first boot after
+     * the restart the marker fires `system.restart-completed`.
+     *
+     * `version` defaults to `'latest'`. The allow-list of valid
+     * `packageName` values is enforced server-side.
+     *
+     * Spec: docs/superpowers/specs/2026-05-14-framework-live-update-design.md
+     */
+    updateFrameworkPackage: method(
+      zod.z.object({
+        packageName: zod.z.string().min(1),
+        version: zod.z.string().optional()
+      }),
+      UpdateFrameworkPackageResultSchema,
+      { kind: "mutation", auth: "admin" }
+    ),
     getVersions: method(
       zod.z.object({ name: zod.z.string() }),
       zod.z.array(PackageVersionInfoSchema).readonly()
@@ -8753,6 +8917,8 @@ exports.EndDownloadInputSchema = EndDownloadInputSchema;
 exports.EnrichedWidgetMetadataSchema = EnrichedWidgetMetadataSchema;
 exports.EventItemSchema = EventItemSchema;
 exports.EventKindSchema = EventKindSchema;
+exports.ExportSetupFieldSchema = ExportSetupFieldSchema;
+exports.ExportSetupSchema = ExportSetupSchema;
 exports.ExposeInputSchema = ExposeInputSchema;
 exports.ExposedDeviceSchema = ExposedDeviceSchema;
 exports.ExposedResourceSchema = ExposedResourceSchema;
@@ -8996,4 +9162,4 @@ exports.webrtcSessionCapability = webrtcSessionCapability;
 exports.zoneAnalyticsCapability = zoneAnalyticsCapability;
 exports.zoneRulesCapability = zoneRulesCapability;
 exports.zonesCapability = zonesCapability;
-//# sourceMappingURL=index-DRWlYskM.js.map
+//# sourceMappingURL=index-DS7418lf.js.map