@byok-sdk/server 0.7.0 → 0.8.0

package/dist/hub.d.ts

@@ -1,9 +1,9 @@
 import type { WebSocket } from 'ws';
-import { type Envelope, type RuntimeId, type RuntimeInfo, type TaskState, type ToolsetId } from '@byok-sdk/protocol';
+import { type Envelope, type AgentHomeProjectionCompletionRequest, type AgentHomeProjectionReadback, type RuntimeId, type RuntimeInfo, type TaskState, type ToolsetId } from '@byok-sdk/protocol';
 import type { DeviceRegistry } from './auth';
 import { RateLimiter } from './rate-limiter';
 import type { TaskStore } from './task-store';
-import type { ByokServerEvent, AgentContentReadRequest, AgentEgressReceipt, DispatchInput, HubStats, MachineInfo, TaskHandle, TaskSnapshot } from './types';
+import type { ByokServerEvent, AgentContentReadRequest, AgentHomeProjectionRequest, AgentEgressReceipt, DispatchInput, FreshAgentEgressDispatchInput, HubStats, MachineInfo, TaskHandle, TaskSnapshot } from './types';
 /**
  * The connection hub: tracks each device's live transport (WS or long-poll —
  * never both at once, see {@link takeOverAsLongPoll}), routes `dispatch()`'d
@@ -189,6 +189,11 @@ export declare class SteerRejectedError extends Error {
     /** `TaskSnapshot.claimedRuntime` — `undefined` when nothing was ever recorded (which is itself a reason `steer_unsupported_runtime` can fire). */
     runtime: RuntimeId | undefined);
 }
+export type AgentHomeProjectionCompletionErrorCode = 'not_found' | 'conflict' | 'invalid';
+export declare class AgentHomeProjectionCompletionError extends Error {
+    readonly code: AgentHomeProjectionCompletionErrorCode;
+    constructor(code: AgentHomeProjectionCompletionErrorCode, message: string);
+}
 export declare class ConnectionHub {
     private readonly taskStore;
     private readonly devices;
@@ -217,6 +222,10 @@ export declare class ConnectionHub {
     private readonly agentContentReadRequests;
     /** Content-free explicit-read audit facts keyed by exact authenticated device/request identity. */
     private readonly agentContentReceipts;
+    /** Immutable requested projection facts, keyed by authenticated device/request. */
+    private readonly agentHomeProjectionRequests;
+    /** First terminal completion for each exact projection request. */
+    private readonly agentHomeProjectionCompletions;
     /**
      * Per-task last-inbound-activity timestamp (epoch ms) — the task-lease
      * reaper's condition (c), see the "task-lease reaper" section below. Reset
@@ -749,8 +758,14 @@ export declare class ConnectionHub {
     /** Reap one lease-expired task through the exact same TaskStore/canTransition path — and terminal-event emission — as any other `task.fail` (see {@link applyOrFail}). */
     private reapTask;
     dispatch(input: DispatchInput): Promise<TaskHandle>;
+    dispatchFreshAgentEgress(input: FreshAgentEgressDispatchInput): Promise<TaskHandle>;
+    private dispatchInternal;
     /** Capability-gated control-plane read request; no request enters the outbox on omission. */
     requestAgentContentRead(input: AgentContentReadRequest): Promise<void>;
+    /** Task-free exact-device projection; no task record, runtime or session is created. */
+    enqueueAgentHomeProjection(input: AgentHomeProjectionRequest): Promise<AgentHomeProjectionReadback>;
+    readAgentHomeProjection(deviceId: string, requestId: string): AgentHomeProjectionReadback | undefined;
+    completeAgentHomeProjection(deviceId: string, input: AgentHomeProjectionCompletionRequest): AgentHomeProjectionReadback;
     private buildTaskHandle;
     /** Idempotent: cancelling an already-terminal task is a no-op, not an error. */
     private cancelTask;

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import type { Server as HttpServer } from 'node:http';
 import type { Hono } from 'hono';
 import { type TenantId } from './auth';
 import { type PairingCodeClaims, type PairingCodeInfo } from './pairing';
-import type { ByokServerEvent, AgentContentReadRequest, AgentEgressReceipt, CreateByokServerOptions, DispatchInput, HubStats, MachineInfo, TaskHandle, TaskSnapshot } from './types';
-export type { ByokServerEvent, AgentContentReadRequest, AgentEgressReceipt, CreateByokServerOptions, DispatchInput, HubStats, MachineInfo, ServerTaskEvent, TaskHandle, TaskResult, TaskSnapshot, } from './types';
+import type { ByokServerEvent, AgentContentReadRequest, AgentHomeProjectionRequest, AgentHomeProjectionStatusReadback, AgentEgressReceipt, CreateByokServerOptions, DispatchInput, FreshAgentEgressDispatchInput, HubStats, MachineInfo, TaskHandle, TaskSnapshot } from './types';
+export type { ByokServerEvent, AgentContentReadRequest, AgentHomeProjectionRequest, AgentHomeProjectionStatusReadback, AgentEgressReceipt, CreateByokServerOptions, DispatchInput, FreshAgentEgressDispatchInput, HubStats, MachineInfo, ServerTaskEvent, TaskHandle, TaskResult, TaskSnapshot, } from './types';
 export type { CreateTaskInput, TaskRecord, TaskStore } from './task-store';
 export { IllegalTaskTransitionError, InMemoryTaskStore } from './task-store';
 /**
@@ -24,6 +24,8 @@ export { StaleApprovalError } from './hub';
  */
 export { SteerRejectedError } from './hub';
 export type { SteerRejectionCode } from './hub';
+export { AgentHomeProjectionCompletionError } from './hub';
+export type { AgentHomeProjectionCompletionErrorCode } from './hub';
 export { PairingCodeInvalidError } from './pairing';
 export type { PairingCodeClaims, PairingCodeInfo } from './pairing';
 export type { AccessTokenClaims, AuthenticatedDevice, DeviceRecord, TenantId, TokenSigner, } from './auth';
@@ -60,8 +62,14 @@ export interface ByokServer {
         createPairingCode(claims: PairingCodeClaims): PairingCodeInfo;
     };
     dispatch(input: DispatchInput): Promise<TaskHandle>;
+    /** Dispatch a fresh Agent execution whose runtime will mint its session after start. */
+    dispatchFreshAgentEgress(input: FreshAgentEgressDispatchInput): Promise<TaskHandle>;
     /** Enqueue one capability-gated, exact-identity content-read request. */
     requestAgentContentRead(input: AgentContentReadRequest): Promise<void>;
+    /** Enqueue one task-free, exact-device Agent-home projection. */
+    enqueueAgentHomeProjection(input: AgentHomeProjectionRequest): Promise<AgentHomeProjectionStatusReadback>;
+    /** Reference-only in-process status readback; production durability belongs to @byok-sdk/cloud stores. */
+    readAgentHomeProjection(deviceId: string, requestId: string): AgentHomeProjectionStatusReadback | undefined;
     tasks: {
         get(taskId: string): TaskSnapshot | undefined;
         list(): TaskSnapshot[];