@econ-v1/ports 7.0.19 → 7.0.20

package/dist/index.d.ts

@@ -189,6 +189,18 @@ export type OwnerClaimGenesisDevice = import("./owner-claim-session.js").OwnerCl
 export type OwnerClaimSessionPort = import("./owner-claim-session.js").OwnerClaimSessionPort;
 export type OwnerClaimSessionTokens = import("./owner-claim-session.js").OwnerClaimSessionTokens;
 export type OwnerClaimCryptoPort = import("./owner-claim.js").OwnerClaimCryptoPort;
+export type AppsLifecycleRepository = import("./repositories/apps-lifecycle-repository.js").AppsLifecycleRepository;
+export type LeaseDecisionKind = import("./repositories/apps-lifecycle-repository.js").LeaseDecisionKind;
+export type LifecycleAppView = import("./repositories/apps-lifecycle-repository.js").LifecycleAppView;
+export type LifecycleDecisionRecord = import("./repositories/apps-lifecycle-repository.js").LifecycleDecisionRecord;
+export type LifecycleDeviceView = import("./repositories/apps-lifecycle-repository.js").LifecycleDeviceView;
+export type LifecycleFeedState = import("./repositories/apps-lifecycle-repository.js").LifecycleFeedState;
+export type LifecycleLeaseView = import("./repositories/apps-lifecycle-repository.js").LifecycleLeaseView;
+export type LifecycleMode = import("./repositories/apps-lifecycle-repository.js").LifecycleMode;
+export type LifecycleOverviewResponse = import("./repositories/apps-lifecycle-repository.js").LifecycleOverviewResponse;
+export type LifecyclePolicyView = import("./repositories/apps-lifecycle-repository.js").LifecyclePolicyView;
+export type LifecycleStormView = import("./repositories/apps-lifecycle-repository.js").LifecycleStormView;
+export type LifecycleTransitionView = import("./repositories/apps-lifecycle-repository.js").LifecycleTransitionView;
 export type NodeAppInstallSource = import("./repositories/node-app-memory-repository.js").NodeAppInstallSource;
 export type NodeAppBudgetState = import("./repositories/node-app-memory-repository.js").NodeAppBudgetState;
 export type NodeAppBudgetVerdict = import("./repositories/node-app-memory-repository.js").NodeAppBudgetVerdict;

package/dist/index.d.ts.map

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

package/dist/repositories/apps-lifecycle-repository.d.ts

@@ -0,0 +1,142 @@
+/**
+ * `"resident" | "warm" | "cold"` — which of the three lease states an app is
+ * currently in. Mirrors `core/app-host/src/models.rs`'s `LifecycleMode`.
+ */
+export type LifecycleMode = "resident" | "warm" | "cold";
+/**
+ * `"ready" | "loading" | "error"` — the feed's own readiness, distinct from
+ * the lease-mode vocabulary above. Mirrors `LifecycleFeedState`.
+ */
+export type LifecycleFeedState = "ready" | "loading" | "error";
+/**
+ * The engine's own vocabulary of life events — `spawn`/`idle-exit`/`crash`/
+ * `promote`/`demote`/`storm`/`pressure`. Serialized kebab-case by the host
+ * (`core/app-host/src/governor_lease.rs`'s `LeaseDecisionKind`), so the
+ * client-side values keep the same spelling rather than being camelCased.
+ */
+export type LeaseDecisionKind = "spawn" | "idle-exit" | "crash" | "promote" | "demote" | "storm" | "pressure";
+/**
+ * A warm app's draining lease. `totalSeconds` is the `T` the engine granted;
+ * `remainingSeconds` counts down to zero and is floored there.
+ */
+export type LifecycleLeaseView = {
+    totalSeconds: number;
+    remainingSeconds: number;
+};
+/**
+ * The measured inputs behind the engine's lease choice for one app.
+ */
+export type LifecyclePolicyView = {
+    callsPerMin: number;
+    spawnMs: number;
+    pressureFactor: number;
+    /**
+     * `"interactive" | "background"`.
+     */
+    latencyClass: string;
+};
+/**
+ * Machine retry traffic — not real demand — that is what is keeping an app
+ * awake.
+ */
+export type LifecycleStormView = {
+    callsPerMin: number;
+    caller: string;
+};
+/**
+ * The app's last life event: a clean self-sleep, a promotion/demotion
+ * between tiers, or a crash.
+ */
+export type LifecycleTransitionView = {
+    kind: LeaseDecisionKind;
+    atMs: number;
+    exitCode?: number;
+};
+/**
+ * One app as the lease engine's operator surface sees it.
+ */
+export type LifecycleAppView = {
+    id: string;
+    name: string;
+    mode: LifecycleMode;
+    /**
+     * Owner override: never sleep this app.
+     */
+    pinned: boolean;
+    /**
+     * `null` when cold.
+     */
+    memoryKb: number | null;
+    /**
+     * `null` outside the warm tier.
+     */
+    lease: LifecycleLeaseView | null;
+    policy: LifecyclePolicyView;
+    /**
+     * 12 buckets, most recent last.
+     */
+    activity: readonly number[];
+    storm: LifecycleStormView | null;
+    lastTransition: LifecycleTransitionView | null;
+    /**
+     * Capability names this app's
+     * manifest declares (`provides`/`capabilities.provides`) — the
+     * capability->app mapping the cold-start waking affordance resolves
+     * against. Empty, never omitted, for an app that declares none.
+     */
+    provides: readonly string[];
+};
+/**
+ * Device-wide band for the lease engine's operator surface.
+ */
+export type LifecycleDeviceView = {
+    memTotalKb: number;
+    /**
+     * Device-wide `MemAvailable`, `null`
+     * where the platform does not report it. Present so `residentKb` can be
+     * framed against the device's real headroom: apps are one tenant, and
+     * `residentKb / memTotalKb` would claim the remainder is free when
+     * node-server's own baseline and the OS hold most of it.
+     */
+    memAvailableKb: number | null;
+    /**
+     * Sum of `memoryKb` across every resident/warm
+     * app — a SUBSET of the device's used memory, never the whole of it.
+     */
+    residentKb: number;
+    /**
+     * Sum of the last-known footprint of every non-pinned cold app.
+     */
+    reclaimedKb: number;
+    /**
+     * `"ok" | "elevated" | "critical"`.
+     */
+    pressure: string;
+};
+/**
+ * The engine's decisions ring, most recent first.
+ */
+export type LifecycleDecisionRecord = {
+    app: string;
+    kind: LeaseDecisionKind;
+    atMs: number;
+    /**
+     * Free-form — the engine's own per-kind fields.
+     */
+    detail: Record<string, unknown>;
+};
+/**
+ * Response for `GET /api/v2/node-apps/lifecycle` — `apps.lifecycle.v1`
+ * (design contract §"Ask 13").
+ */
+export type LifecycleOverviewResponse = {
+    state: LifecycleFeedState;
+    device: LifecycleDeviceView;
+    apps: readonly LifecycleAppView[];
+    decisions: readonly LifecycleDecisionRecord[];
+};
+export type AppsLifecycleRepository = {
+    readOverview: () => Promise<LifecycleOverviewResponse>;
+    setLeasePin: (id: string, pinned: boolean) => Promise<LifecycleAppView>;
+};
+//# sourceMappingURL=apps-lifecycle-repository.d.ts.map

package/dist/repositories/apps-lifecycle-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps-lifecycle-repository.d.ts","sourceRoot":"","sources":["../../src/repositories/apps-lifecycle-repository.js"],"names":[],"mappings":";;;;4BAMa,UAAU,GAAG,MAAM,GAAG,MAAM;;;;;iCAM5B,OAAO,GAAG,SAAS,GAAG,OAAO;;;;;;;gCAQ7B,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU;;;;;;kBAO5E,MAAM;sBACN,MAAM;;;;;;iBAMN,MAAM;aACN,MAAM;oBACN,MAAM;;;;kBACN,MAAM;;;;;;;iBAON,MAAM;YACN,MAAM;;;;;;;UAON,iBAAiB;UACjB,MAAM;eACN,MAAM;;;;;;QAMN,MAAM;UACN,MAAM;UACN,aAAa;;;;YACb,OAAO;;;;cACP,MAAM,GAAG,IAAI;;;;WACb,kBAAkB,GAAG,IAAI;YACzB,mBAAmB;;;;cACnB,SAAS,MAAM,EAAE;WACjB,kBAAkB,GAAG,IAAI;oBACzB,uBAAuB,GAAG,IAAI;;;;;;;cAC9B,SAAS,MAAM,EAAE;;;;;;gBASjB,MAAM;;;;;;;;oBACN,MAAM,GAAG,IAAI;;;;;gBAKb,MAAM;;;;iBAEN,MAAM;;;;cACN,MAAM;;;;;;SAMN,MAAM;UACN,iBAAiB;UACjB,MAAM;;;;YACN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;WAOvB,kBAAkB;YAClB,mBAAmB;UACnB,SAAS,gBAAgB,EAAE;eAC3B,SAAS,uBAAuB,EAAE;;;kBAKlC,MAAM,OAAO,CAAC,yBAAyB,CAAC;iBACxC,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@econ-v1/ports",
-  "version": "7.0.19",
+  "version": "7.0.20",
   "description": "Platform-neutral ports for Node client applications",
   "license": "MIT OR Apache-2.0",
   "author": "Node contributors",

package/src/index.js

@@ -183,6 +183,18 @@ export { StorageOperationError } from "./storage.js";
 /** @typedef {import("./owner-claim-session.js").OwnerClaimSessionPort} OwnerClaimSessionPort */
 /** @typedef {import("./owner-claim-session.js").OwnerClaimSessionTokens} OwnerClaimSessionTokens */
 /** @typedef {import("./owner-claim.js").OwnerClaimCryptoPort} OwnerClaimCryptoPort */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").AppsLifecycleRepository} AppsLifecycleRepository */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LeaseDecisionKind} LeaseDecisionKind */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleAppView} LifecycleAppView */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleDecisionRecord} LifecycleDecisionRecord */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleDeviceView} LifecycleDeviceView */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleFeedState} LifecycleFeedState */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleLeaseView} LifecycleLeaseView */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleMode} LifecycleMode */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleOverviewResponse} LifecycleOverviewResponse */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecyclePolicyView} LifecyclePolicyView */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleStormView} LifecycleStormView */
+/** @typedef {import("./repositories/apps-lifecycle-repository.js").LifecycleTransitionView} LifecycleTransitionView */
 /** @typedef {import("./repositories/node-app-memory-repository.js").NodeAppInstallSource} NodeAppInstallSource */
 /** @typedef {import("./repositories/node-app-memory-repository.js").NodeAppBudgetState} NodeAppBudgetState */
 /** @typedef {import("./repositories/node-app-memory-repository.js").NodeAppBudgetVerdict} NodeAppBudgetVerdict */

package/src/repositories/apps-lifecycle-repository.js

@@ -0,0 +1,115 @@
+// @ts-check
+export {};
+
+/**
+ * `"resident" | "warm" | "cold"` — which of the three lease states an app is
+ * currently in. Mirrors `core/app-host/src/models.rs`'s `LifecycleMode`.
+ * @typedef {"resident" | "warm" | "cold"} LifecycleMode
+ */
+
+/**
+ * `"ready" | "loading" | "error"` — the feed's own readiness, distinct from
+ * the lease-mode vocabulary above. Mirrors `LifecycleFeedState`.
+ * @typedef {"ready" | "loading" | "error"} LifecycleFeedState
+ */
+
+/**
+ * The engine's own vocabulary of life events — `spawn`/`idle-exit`/`crash`/
+ * `promote`/`demote`/`storm`/`pressure`. Serialized kebab-case by the host
+ * (`core/app-host/src/governor_lease.rs`'s `LeaseDecisionKind`), so the
+ * client-side values keep the same spelling rather than being camelCased.
+ * @typedef {"spawn" | "idle-exit" | "crash" | "promote" | "demote" | "storm" | "pressure"} LeaseDecisionKind
+ */
+
+/**
+ * A warm app's draining lease. `totalSeconds` is the `T` the engine granted;
+ * `remainingSeconds` counts down to zero and is floored there.
+ * @typedef {object} LifecycleLeaseView
+ * @property {number} totalSeconds
+ * @property {number} remainingSeconds
+ */
+
+/**
+ * The measured inputs behind the engine's lease choice for one app.
+ * @typedef {object} LifecyclePolicyView
+ * @property {number} callsPerMin
+ * @property {number} spawnMs
+ * @property {number} pressureFactor
+ * @property {string} latencyClass `"interactive" | "background"`.
+ */
+
+/**
+ * Machine retry traffic — not real demand — that is what is keeping an app
+ * awake.
+ * @typedef {object} LifecycleStormView
+ * @property {number} callsPerMin
+ * @property {string} caller
+ */
+
+/**
+ * The app's last life event: a clean self-sleep, a promotion/demotion
+ * between tiers, or a crash.
+ * @typedef {object} LifecycleTransitionView
+ * @property {LeaseDecisionKind} kind
+ * @property {number} atMs
+ * @property {number} [exitCode]
+ */
+
+/**
+ * One app as the lease engine's operator surface sees it.
+ * @typedef {object} LifecycleAppView
+ * @property {string} id
+ * @property {string} name
+ * @property {LifecycleMode} mode
+ * @property {boolean} pinned Owner override: never sleep this app.
+ * @property {number | null} memoryKb `null` when cold.
+ * @property {LifecycleLeaseView | null} lease `null` outside the warm tier.
+ * @property {LifecyclePolicyView} policy
+ * @property {readonly number[]} activity 12 buckets, most recent last.
+ * @property {LifecycleStormView | null} storm
+ * @property {LifecycleTransitionView | null} lastTransition
+ * @property {readonly string[]} provides Capability names this app's
+ *   manifest declares (`provides`/`capabilities.provides`) — the
+ *   capability->app mapping the cold-start waking affordance resolves
+ *   against. Empty, never omitted, for an app that declares none.
+ */
+
+/**
+ * Device-wide band for the lease engine's operator surface.
+ * @typedef {object} LifecycleDeviceView
+ * @property {number} memTotalKb
+ * @property {number | null} memAvailableKb Device-wide `MemAvailable`, `null`
+ *   where the platform does not report it. Present so `residentKb` can be
+ *   framed against the device's real headroom: apps are one tenant, and
+ *   `residentKb / memTotalKb` would claim the remainder is free when
+ *   node-server's own baseline and the OS hold most of it.
+ * @property {number} residentKb Sum of `memoryKb` across every resident/warm
+ *   app — a SUBSET of the device's used memory, never the whole of it.
+ * @property {number} reclaimedKb Sum of the last-known footprint of every non-pinned cold app.
+ * @property {string} pressure `"ok" | "elevated" | "critical"`.
+ */
+
+/**
+ * The engine's decisions ring, most recent first.
+ * @typedef {object} LifecycleDecisionRecord
+ * @property {string} app
+ * @property {LeaseDecisionKind} kind
+ * @property {number} atMs
+ * @property {Record<string, unknown>} detail Free-form — the engine's own per-kind fields.
+ */
+
+/**
+ * Response for `GET /api/v2/node-apps/lifecycle` — `apps.lifecycle.v1`
+ * (design contract §"Ask 13").
+ * @typedef {object} LifecycleOverviewResponse
+ * @property {LifecycleFeedState} state
+ * @property {LifecycleDeviceView} device
+ * @property {readonly LifecycleAppView[]} apps
+ * @property {readonly LifecycleDecisionRecord[]} decisions
+ */
+
+/**
+ * @typedef {object} AppsLifecycleRepository
+ * @property {() => Promise<LifecycleOverviewResponse>} readOverview
+ * @property {(id: string, pinned: boolean) => Promise<LifecycleAppView>} setLeasePin
+ */