@byok-sdk/server 0.23.0 → 0.24.0

package/dist/stores/sqlite/index.d.ts

@@ -5,7 +5,7 @@ import type { DatabaseSync } from 'node:sqlite';
 export interface SqliteEmbeddedStoreOptions {
     readonly path: string;
     readonly urlTtlMs?: number;
-    readonly migration?: 'v1-to-v3' | 'v2-to-v3';
+    readonly migration?: 'v1-to-v4' | 'v2-to-v4' | 'v3-to-v4';
 }
 export interface SqliteEmbeddedStores {
     readonly core: CoreStores;
@@ -17,7 +17,7 @@ export interface SqliteEmbeddedStores {
 declare class SqliteCoordinator {
     #private;
     readonly db: DatabaseSync;
-    constructor(path: string, migration?: 'v1-to-v3' | 'v2-to-v3');
+    constructor(path: string, migration?: 'v1-to-v4' | 'v2-to-v4' | 'v3-to-v4');
     run<T>(operation: (db: DatabaseSync) => T | Promise<T>): Promise<T>;
     transaction<T>(operation: (db: DatabaseSync) => T | Promise<T>): Promise<T>;
     close(): Promise<void>;
@@ -70,6 +70,7 @@ export declare class SqliteTaskAttemptStore implements TaskAttemptStore {
         taskId: string;
         deviceId: string;
         runtime?: RuntimeId;
+        harnessId?: string;
         capabilities?: RuntimeCapabilities;
     }): Promise<TaskAttempt | undefined>;
     recordStatus(tenant: TenantId, input: {

package/dist/types.d.ts

@@ -11,8 +11,8 @@ export type ByokServerStorage = {
     readonly path: string;
     /** Lifetime of signed blob upload/download URLs. Default 15 minutes. */
     readonly urlTtlMs?: number;
-    /** One-shot adoption of a legacy database without task history. Stop all writers and back up first; old builds cannot reopen v3. */
-    readonly migration?: 'v1-to-v3' | 'v2-to-v3';
+    /** One-shot schema adoption: v1/v2 require no task history; v3 requires no ambiguous claimed identity. Stop all writers and back up first; old builds cannot reopen v4. */
+    readonly migration?: 'v1-to-v4' | 'v2-to-v4' | 'v3-to-v4';
 };
 /** Options for {@link createByokServer}. */
 export interface CreateByokServerOptions {
@@ -48,8 +48,9 @@ export interface CreateByokServerOptions {
     /**
      * How long after a task reaches a terminal its relay buffer and terminal
      * promise are RETAINED before being reclaimed, ms. A late `events()` reader
-     * within this window still replays the whole feed; past it, the durable read
-     * model (`tasks.get`) is the only answer. Default 5 minutes.
+     * within this window still replays the retained feed; past it, new event
+     * reads complete empty. Use the durable read model (`tasks.get`, `result()`)
+     * for terminal facts after expiry. Default 5 minutes.
      *
      * Retention never decides when a feed ENDS: {@link TaskHandle.events}
      * completes at the terminal event itself, whenever that happens, so a
@@ -238,6 +239,12 @@ export type ServerTaskEvent = {
 /** Handle returned by {@link ByokServer.dispatch} for one in-flight task. */
 export interface TaskHandle {
     readonly taskId: string;
+    /**
+     * Replay retained notifications and follow live updates until terminal.
+     * New reads after terminal retention expires or the server stops complete
+     * empty; they never reopen a feed. Durable terminal facts remain available
+     * through `result()` and `ByokServer.tasks.get`.
+     */
     events(): AsyncIterable<ServerTaskEvent>;
     cancel(reason?: string): Promise<void>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/server",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "description": "BYOK SDK server: in-memory M0 reference implementation of the SaaS-side coordinator",
   "type": "module",
   "license": "MIT",
@@ -14,7 +14,7 @@
   },
   "homepage": "https://github.com/Ancienttwo/byok-sdk#readme",
   "engines": {
-    "node": ">=22.22.0"
+    "node": ">=24.15.0"
   },
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -44,9 +44,9 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@byok-sdk/cloud": "0.23.0",
-    "@byok-sdk/core": "0.23.0",
-    "@byok-sdk/protocol": "0.23.0",
+    "@byok-sdk/cloud": "0.24.0",
+    "@byok-sdk/core": "0.24.0",
+    "@byok-sdk/protocol": "0.24.0",
     "@hono/node-server": "^2.0.10",
     "hono": "^4.12.30"
   },