@byok-sdk/server 0.2.0 → 0.3.0

package/dist/sqlite-blob-store.d.ts

@@ -72,6 +72,7 @@ export declare class SqliteBlobStore implements BlobStore {
     private readonly selectBlobStmt;
     private readonly selectUploadedStmt;
     private readonly writeContentStmt;
+    private closed;
     constructor(opts: SqliteBlobStoreOptions);
     createUpload(input: CreateUploadInput, requestedBlobId?: string): Promise<{
         blobId: string;

package/dist/sqlite-support.d.ts

@@ -1,4 +1,17 @@
 import type { DatabaseSync, DatabaseSyncOptions } from 'node:sqlite';
+export type SqliteOpenStep = 'after-open' | 'after-wal';
+/** Test-only seam for proving that post-open initialization failures release the native handle. */
+export interface SqliteOpenFaultSeam {
+    onStep?(step: SqliteOpenStep): void;
+    close?(db: DatabaseSync): void;
+}
+/**
+ * Preserve the initialization error after deterministically releasing an
+ * already-open SQLite handle. If cleanup itself fails, surface both failures
+ * instead of losing the reason construction failed or pretending ownership
+ * was returned.
+ */
+export declare function closeSqliteDatabaseAfterInitializationFailure(db: DatabaseSync, initializationError: unknown, message: string, close?: (db: DatabaseSync) => void): never;
 /**
  * Thrown when `node:sqlite` isn't available in the running Node.js binary.
  * `node:sqlite` shipped in Node.js 22.5.0 (https://nodejs.org/api/sqlite.html)
@@ -64,7 +77,7 @@ export declare function isSqliteAvailable(): boolean;
  * {@link isSqliteAvailable}) — callers don't need their own guard for that;
  * this is the single choke point.
  */
-export declare function openSqliteDatabase(path: string, options?: DatabaseSyncOptions): DatabaseSync;
+export declare function openSqliteDatabase(path: string, options?: DatabaseSyncOptions, faults?: SqliteOpenFaultSeam): DatabaseSync;
 /**
  * Restrict `dbPath` and its WAL/SHM sibling files (`<path>-wal`,
  * `<path>-shm` — created by SQLite itself once WAL mode is active and a

package/dist/sqlite-task-store.d.ts

@@ -75,6 +75,7 @@ export declare class SqliteTaskStore implements TaskStore {
     private readonly selectStmt;
     private readonly selectAllStmt;
     private readonly updatePendingApprovalIdStmt;
+    private closed;
     constructor(opts: SqliteTaskStoreOptions);
     create(input: CreateTaskInput): TaskRecord;
     get(taskId: string): TaskRecord | undefined;

package/dist/task-store.d.ts

@@ -1,4 +1,4 @@
-import { type PermissionPolicy, type RuntimeId, type TaskState } from '@byok-sdk/protocol';
+import { type PermissionPolicy, type RuntimeId, type TaskState, type ToolsetId } from '@byok-sdk/protocol';
 import type { TaskSnapshot } from './types';
 /** Thrown by a {@link TaskStore}'s `transition` when `from -> to` is not in TASK_TRANSITIONS. Every implementation (in-memory, SQLite, or otherwise) must throw this rather than silently applying an invalid move. */
 export declare class IllegalTaskTransitionError extends Error {
@@ -12,6 +12,7 @@ export interface CreateTaskInput {
     instruction: string;
     runtime?: RuntimeId;
     policy: PermissionPolicy;
+    requiredToolsets?: ToolsetId[];
     deviceId?: string;
     sessionRef?: string;
 }

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentEventOrUnknown, BlobRef, PermissionPolicy, RuntimeCapabilities, RuntimeId, RuntimeInfo, TaskApprovalResolvedPayload, TaskArtifactPayload, TaskState } from '@byok-sdk/protocol';
+import type { AgentEventOrUnknown, BlobRef, DispatchSelection, PermissionPolicy, RuntimeCapabilities, RuntimeId, RuntimeInfo, TaskApprovalResolvedPayload, TaskArtifactPayload, TaskState, ToolsetId } from '@byok-sdk/protocol';
 import type { BlobStore } from './blob-store';
 import type { RateLimiterOptions } from './rate-limiter';
 import type { TaskStore } from './task-store';
@@ -84,10 +84,17 @@ export interface CreateByokServerOptions {
 /** Input to {@link ByokServer.dispatch}. */
 export interface DispatchInput {
     instruction: string;
+    /**
+     * Authoritative web-selected target. When present, `runtime` is derived
+     * from `runtimeId`; supplying a different legacy `runtime` is rejected.
+     */
+    dispatchSelection?: DispatchSelection;
     runtime?: RuntimeId;
     policy?: PermissionPolicy;
     deviceId?: string;
     sessionRef?: string;
+    /** Logical device-local MCP toolsets required for this task; never executable definitions. */
+    requiredToolsets?: ToolsetId[];
 }
 /** Outcome of a task that reached a terminal state. */
 export interface TaskResult {
@@ -97,6 +104,26 @@ export interface TaskResult {
     artifactRefs?: BlobRef[];
     reason?: string;
     retryable?: boolean;
+    /**
+     * The task's structured terminal result, projected verbatim from
+     * `task.complete.document` (`@byok-sdk/protocol`'s `messages.ts`) — the
+     * product's own JSON output, as opposed to `summary` (prose for a human)
+     * or `artifactRefs` (files). `unknown` deliberately: this SDK never
+     * understands or transforms the embedder's document schema. The wire
+     * schema already enforced the only two rules there are (JSON-serializable,
+     * within `RESULT_DOCUMENT_MAX_BYTES`) before this value ever reached the
+     * hub, so the projection neither re-validates nor re-measures it.
+     *
+     * Absent whenever the daemon sent none — which covers both a daemon with
+     * no `resultDocument` extractor configured and a pre-`result-document`
+     * daemon build that has no notion of the field at all.
+     *
+     * Persisted WITH `summary`/`artifactRefs` rather than beside them: the
+     * whole `TaskResult` is stored as a single `result_json` document
+     * (`sqlite-task-store.ts`), so this field reaches durable storage with
+     * exact parity and introduces no second authority for it.
+     */
+    document?: unknown;
 }
 /**
  * Normalized event stream for a dispatched task: incoming `task.progress`
@@ -181,6 +208,7 @@ export interface TaskSnapshot {
      */
     runtime?: RuntimeId;
     policy: PermissionPolicy;
+    requiredToolsets?: ToolsetId[];
     deviceId?: string;
     sessionRef?: string;
     createdAt: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/server",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "BYOK SDK server: in-memory M0 reference implementation of the SaaS-side coordinator",
   "type": "module",
   "license": "MIT",
@@ -40,7 +40,8 @@
     "hono": "^4.12.30",
     "jose": "^6.2.3",
     "ws": "^8.21.1",
-    "@byok-sdk/protocol": "0.2.0"
+    "@byok-sdk/core": "0.3.0",
+    "@byok-sdk/protocol": "0.3.0"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"