@byok-sdk/server 0.17.0 → 0.18.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { type PairingCodeInfo } from '@byok-sdk/cloud';
-import { type AgentRef } from '@byok-sdk/protocol';
+import { type EnqueuedOffer, type PairingCodeInfo, type TaskAttempt } from '@byok-sdk/cloud';
+import { type AgentRef, type AgentMessagePublishPayload, type AgentMessageDispositionPayload } from '@byok-sdk/protocol';
 import type { MailboxRetentionInput, MailboxRetentionResult } from '@byok-sdk/core';
 import type { ByokServerEvent, AgentContentReadRequest, AgentHomeProjectionRequest, AgentHomeProjectionStatusReadback, AgentEgressReceipt, CreateByokServerOptions, DispatchInput, FreshAgentEgressDispatchInput, HubStats, MachineInfo, TaskHandle, TaskSnapshot } from './types';
 export type { ByokServerEvent, AgentContentReadRequest, AgentHomeProjectionRequest, AgentHomeProjectionStatusReadback, AgentEgressReceipt, ByokServerStorage, CreateByokServerOptions, DispatchInput, FreshAgentEgressDispatchInput, HubStats, MachineInfo, ServerTaskEvent, TaskHandle, TaskResult, TaskSnapshot, } from './types';
@@ -82,6 +82,10 @@ export interface ByokServer {
         /** Mint a single-use pairing code for this server's product and tenant (docs/protocol.md §6.1). */
         createPairingCode(input: CreatePairingCodeInput): Promise<PairingCodeInfo>;
     };
+    /** Durable recurring submission; no TaskHandle is needed to recover after restart. */
+    recurring: {
+        submit(input: import('@byok-sdk/cloud').RecurringExecutionInput): Promise<EnqueuedOffer>;
+    };
     dispatch(input: DispatchInput): Promise<TaskHandle>;
     /** Dispatch a fresh Agent execution whose runtime will mint its session after start. */
     dispatchFreshAgentEgress(input: FreshAgentEgressDispatchInput): Promise<TaskHandle>;
@@ -92,9 +96,17 @@ export interface ByokServer {
     /** Durable desired-state and terminal-outcome readback for one exact device-and-Agent request. */
     readAgentHomeProjection(deviceId: string, agentRef: AgentRef, requestId: string): Promise<AgentHomeProjectionStatusReadback | undefined>;
     tasks: {
+        /** Canonical durable attempt, including cancellation intent; not a resource-release observation. */
+        attempt(taskId: string): Promise<TaskAttempt | undefined>;
         get(taskId: string): Promise<TaskSnapshot | undefined>;
+        /** Actual device terminal, independently of Host cancellation or home release. */
+        deviceTerminal(taskId: string): Promise<import('@byok-sdk/cloud').DeviceTerminal | undefined>;
         /** Immutable kernel offer readback for verifying a persisted host binding. No transport seq is inferred. */
         offer(taskId: string): Promise<import('@byok-sdk/cloud').TaskOfferReadback | undefined>;
+        /** Discover the unique message and its pending/final disposition through the frozen Agent binding. */
+        agentMessage(taskId: string, deviceId: string, agentRef: AgentRef): Promise<import('@byok-sdk/cloud').TaskAgentMessage | undefined>;
+        /** Exact SDK message decision; pending is undefined and corrupt persisted evidence throws. */
+        messageDisposition(taskId: string, deviceId: string, payload: AgentMessagePublishPayload): Promise<AgentMessageDispositionPayload | undefined>;
         /** Request cancellation through the kernel without a process-owned TaskHandle. */
         cancel(taskId: string, reason?: string): Promise<void>;
         /**

package/dist/index.js

@@ -1174,6 +1174,20 @@ var SqliteTaskAttemptStore = class {
       return "reserved";
     });
   }
+  readTaskAgentMessage(tenant, input) {
+    return this.coordinator.run((db) => {
+      if (readTask(db, tenant, input.taskId)?.deviceId !== input.deviceId) return void 0;
+      const row = db.prepare(
+        `SELECT message_id, payload_body, terminal_body FROM agent_message_admission
+         WHERE tenant_id = ? AND task_id = ?`
+      ).get(tenant, input.taskId);
+      return row === void 0 ? void 0 : {
+        messageId: row.message_id,
+        payloadBody: row.payload_body,
+        ...row.terminal_body === null ? {} : { terminalBody: row.terminal_body }
+      };
+    });
+  }
   readAgentMessage(tenant, input) {
     return this.coordinator.run((db) => {
       const attempt = readTask(db, tenant, input.taskId);
@@ -2311,10 +2325,25 @@ function createByokServer(opts) {
         projectionHash: desired.projectionHash
       });
     },
+    recurring: { submit(input) {
+      return cloud.submitRecurringExecution(tenant, input);
+    } },
     tasks: {
+      attempt(taskId) {
+        return cloud.readTaskAttempt(tenant, taskId);
+      },
+      deviceTerminal(taskId) {
+        return cloud.readDeviceTerminal(tenant, taskId);
+      },
       offer(taskId) {
         return cloud.readTaskOffer(tenant, taskId);
       },
+      agentMessage(taskId, deviceId, agentRef) {
+        return cloud.readTaskAgentMessage(tenant, deviceId, taskId, agentRef);
+      },
+      messageDisposition(taskId, deviceId, payload) {
+        return cloud.readAgentMessageDisposition(tenant, deviceId, taskId, payload);
+      },
       async cancel(taskId, reason) {
         const attempt = await cloud.cancelTask(tenant, taskId, reason);
         if (attempt.cancellation !== void 0) {