@byok-sdk/server 0.5.0 → 0.6.1

package/dist/task-store.d.ts

@@ -1,4 +1,4 @@
-import { type PermissionPolicy, type RuntimeId, type TaskState, type ToolsetId } from '@byok-sdk/protocol';
+import { type AgentRef, 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 {
@@ -15,6 +15,7 @@ export interface CreateTaskInput {
     requiredToolsets?: ToolsetId[];
     deviceId?: string;
     sessionRef?: string;
+    agentRef?: AgentRef;
 }
 /** A task's full persisted state, as tracked by any {@link TaskStore} implementation. Same shape as {@link TaskSnapshot} — kept as its own (structurally identical) type so this storage-layer contract can evolve independently of the SDK-facing `TaskSnapshot` if a future need arises. */
 export interface TaskRecord extends TaskSnapshot {

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { AgentEventOrUnknown, BlobRef, DispatchSelection, PermissionPolicy, RuntimeCapabilities, RuntimeId, RuntimeInfo, TaskApprovalResolvedPayload, TaskArtifactPayload, TaskState, ToolsetId } from '@byok-sdk/protocol';
+import type { AgentContentReadPayload, AgentEventOrUnknown, AgentEgressPolicy, AgentEgressReliablePayload, AgentRef, 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';
@@ -95,6 +95,25 @@ export interface DispatchInput {
     sessionRef?: string;
     /** Logical device-local MCP toolsets required for this task; never executable definitions. */
     requiredToolsets?: ToolsetId[];
+    /** Explicit durable Agent identity; dispatches through task.offer_for_agent. */
+    agentRef?: AgentRef;
+    /**
+     * An explicit, consumed Agent egress policy. This may only travel with an
+     * Agent-bound offer on the distinct egress-aware wire message.
+     */
+    egressPolicy?: AgentEgressPolicy;
+}
+/** Host control-plane input for one exact content-read request. */
+export interface AgentContentReadRequest {
+    readonly deviceId: string;
+    readonly payload: AgentContentReadPayload;
+}
+/** First-write-wins reference-server readback for a reliable Agent egress item. */
+export interface AgentEgressReceipt {
+    readonly deviceId: string;
+    readonly payload: AgentEgressReliablePayload;
+    readonly receiptId: string;
+    readonly recordedAt: string;
 }
 /** Outcome of a task that reached a terminal state. */
 export interface TaskResult {
@@ -188,6 +207,8 @@ export interface MachineInfo {
     deviceName: string;
     connected: boolean;
     lastSeen?: string;
+    /** Process-immutable Local Agent release from the current/last WS hello; omission means legacy/unknown. */
+    clientVersion?: string;
     /** Runtimes detected on this device, as reported in its last `conn.hello` (M1: typed, replaces the old untyped `agents`). */
     runtimes?: RuntimeInfo[];
     /** Logical toolset IDs reported by the current daemon; omission means legacy/unknown. */
@@ -213,6 +234,8 @@ export interface TaskSnapshot {
     requiredToolsets?: ToolsetId[];
     deviceId?: string;
     sessionRef?: string;
+    /** Exact Agent identity for an Agent-bound task; absent for legacy tasks. */
+    agentRef?: AgentRef;
     createdAt: string;
     updatedAt: string;
     result?: TaskResult;
@@ -254,8 +277,8 @@ export interface TaskSnapshot {
      *
      * Sourced from the claim and from nothing else. The connection-level
      * `conn.hello.runtimes[].capabilities` is discovery data — it describes a
-     * device rather than a task, and a long-poll-only daemon never sends
-     * `conn.hello` at all — so it is never read here or by the gate; see
+     * device rather than the adapter that claimed this task — so it is never
+     * read here or by the gate; see
      * `SteerRejectedError` (`hub.ts`) for the full argument.
      *
      * A SNAPSHOT, deliberately — not a live read of anything: the same device

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/server",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "BYOK SDK server: in-memory M0 reference implementation of the SaaS-side coordinator",
   "type": "module",
   "license": "MIT",
@@ -44,8 +44,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@byok-sdk/core": "0.5.0",
-    "@byok-sdk/protocol": "0.5.0",
+    "@byok-sdk/core": "0.6.1",
+    "@byok-sdk/protocol": "0.6.1",
     "@hono/node-server": "^2.0.10",
     "hono": "^4.12.30",
     "jose": "^6.2.3",