@byok-sdk/core 0.4.2 → 0.6.0

package/dist/presence.d.ts

@@ -17,6 +17,41 @@ import type { TenantId } from './tenant';
 /** The five presence levels. */
 export declare const PRESENCE_LEVELS: readonly ['online', 'thinking', 'working', 'error', 'offline'];
 export type PresenceLevel = (typeof PRESENCE_LEVELS)[number];
+/** Runtime facts observed by a daemon's real local probe. Omitted fields are unknown. */
+export interface PresenceRuntimeFact {
+    readonly id: string;
+    readonly version?: string;
+    readonly authPresent?: boolean;
+}
+/** Unexpired presence facts nested in the tenant aggregate. */
+export interface TenantReadinessPresence {
+    readonly level: PresenceLevel;
+    readonly detail?: string;
+    readonly configuredToolsets?: readonly string[];
+    readonly clientVersion?: string;
+    readonly protocolVersions?: readonly number[];
+    readonly runtimes?: readonly PresenceRuntimeFact[];
+    readonly observedAt: string;
+    readonly expiresAt: string;
+}
+/** Durable device state plus its optional live observation, scoped to one tenant. */
+export interface TenantReadinessDevice {
+    readonly deviceId: string;
+    readonly productId: string;
+    readonly deviceName: string;
+    readonly revoked: boolean;
+    /** Omitted when absent/expired or when the durable device is revoked. */
+    readonly presence?: TenantReadinessPresence;
+}
+/** SDK-owned tenant read model; this is observation, never an execution gate. */
+export interface TenantReadiness {
+    readonly tenantId: TenantId;
+    readonly activePairedDeviceCount: number;
+    readonly revokedDeviceCount: number;
+    readonly observedPresenceCount: number;
+    readonly observedPresenceByLevel: Readonly<Record<PresenceLevel, number>>;
+    readonly devices: readonly TenantReadinessDevice[];
+}
 /** A device-level hint. `expiresAt` is authoritative: past it, the hint does not exist. */
 export interface PresenceHint {
     readonly tenantId: TenantId;
@@ -30,6 +65,12 @@ export interface PresenceHint {
      * means legacy/unknown; an empty array means known-none.
      */
     readonly configuredToolsets?: readonly string[];
+    /** The U4a Local Agent release version, when the daemon supplied it. */
+    readonly clientVersion?: string;
+    /** Protocol versions actually advertised by this daemon. */
+    readonly protocolVersions?: readonly number[];
+    /** Runtime/auth facts from a real local probe; unknown facts are omitted. */
+    readonly runtimes?: readonly PresenceRuntimeFact[];
     readonly observedAt: string;
     readonly expiresAt: string;
 }
@@ -39,6 +80,12 @@ export interface PresenceHintInput {
     readonly detail?: string;
     /** Validated logical IDs only; executable connector definitions never belong here. */
     readonly configuredToolsets?: readonly string[];
+    /** The U4a Local Agent release version, when available. */
+    readonly clientVersion?: string;
+    /** Protocol versions actually advertised by this daemon. */
+    readonly protocolVersions?: readonly number[];
+    /** Runtime/auth facts from a real local probe; unknown facts are omitted. */
+    readonly runtimes?: readonly PresenceRuntimeFact[];
     /** Hint lifetime. §12.7.5 suggests 60-120s for presence. */
     readonly ttlMs: number;
     /** Minimum time between accepted publications for this device. `0` explicitly disables throttling. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/core",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "description": "BYOK SDK platform contracts: branded tenant identity, tenant-first store ports, device proof canonicalization, and the composition conformance reference",
   "type": "module",
   "license": "MIT",