@byok-sdk/cloud 0.2.0 → 0.4.0

package/dist/stores/in-memory/index.d.ts

@@ -14,7 +14,6 @@ export { BLOB_URL_TTL_MS, InMemoryBlobContentProxy, InMemoryCloudBlobStore, crea
 export type { InMemoryBlobs, InMemoryBlobStoreOptions } from './blobs';
 export { DEDUP_RING_CAPACITY, InMemoryInboundDedupStore } from './dedup';
 export { InMemoryDeviceDirectory } from './device-directory';
-export { InMemoryDeviceSequenceStore } from './sequence';
 export { InMemoryNonceStore, NONCE_TTL_MS } from './nonces';
 export { InMemoryPairingCodeStore } from './pairing-codes';
 export { InMemoryRequestReceiptStore } from './receipts';

package/dist/stores/ports-contract.d.ts

@@ -4,7 +4,7 @@
  * The exact counterpart of `@byok-sdk/core`'s `ports-contract.ts`, and it exists
  * for the same reason: the table says what a port IS, so it has to be readable
  * by every enforcer without any of them owning it. `@byok-sdk/conformance` asserts
- * live compositions against it; a durable adapter (`@byok-sdk/cloud-postgres`) is
+ * live compositions against it; a durable adapter (`@byok-sdk/cloud-dataplane`) is
  * written against it.
  *
  * This module adds data and nothing else. It does not re-declare, re-shape, or

package/dist/stores/ports.d.ts

@@ -191,20 +191,6 @@ export interface ProofRequestReceiptStore {
     }>;
     get(tenant: TenantId, deviceId: string, requestId: string): Promise<ProofRequestReceipt | undefined>;
 }
-/**
- * The daemon's redelivery cursor is the envelope-level `seq`, which has to be
- * baked into the envelope BEFORE it can be handed to `MailboxStore.append` —
- * the mailbox transports opaque bytes and cannot number an envelope it is
- * being given. So the delivery number is allocated here first, and the
- * enqueue path then asserts the mailbox agreed (`mailbox_seq_mismatch`)
- * rather than letting two counters drift apart silently.
- *
- * A port rather than a counter held by the composition, so no handler-adjacent
- * module carries mutable state (S3.5 boxes 14-15).
- */
-export interface DeviceSequenceStore {
-    next(tenant: TenantId, deviceId: string): Promise<number>;
-}
 export interface BlobDeclaration {
     readonly size: number;
     readonly contentType: string;
@@ -300,10 +286,9 @@ export interface CloudStores {
     readonly tasks: TaskAttemptStore;
     readonly receipts: RequestReceiptStore;
     readonly proofReceipts: ProofRequestReceiptStore;
-    readonly sequence: DeviceSequenceStore;
     readonly blobs: CloudBlobStore;
     readonly rateLimiter: InboundRateLimiter;
 }
 /** Names of the ports in {@link CloudStores}, in contract order. */
-export declare const CLOUD_STORE_NAMES: readonly ['devices', 'pairingCodes', 'nonces', 'dedup', 'tasks', 'receipts', 'proofReceipts', 'sequence', 'blobs', 'rateLimiter'];
+export declare const CLOUD_STORE_NAMES: readonly ['devices', 'pairingCodes', 'nonces', 'dedup', 'tasks', 'receipts', 'proofReceipts', 'blobs', 'rateLimiter'];
 export type CloudStoreName = (typeof CLOUD_STORE_NAMES)[number];

package/dist/tenant-stores.d.ts

@@ -94,9 +94,6 @@ export interface TenantBoundQuota {
     finalizeReservation(input: StorageFinalizeInput): Promise<StorageFinalizeResult>;
     abortReservation(reservationId: string): Promise<StorageReservation>;
 }
-export interface TenantBoundSequence {
-    next(deviceId: string): Promise<number>;
-}
 export interface TenantBoundRateLimiter {
     consume(deviceId: string): Promise<boolean>;
 }
@@ -113,7 +110,6 @@ export interface TenantStores {
     readonly receipts: TenantBoundReceipts;
     readonly blobs: TenantBoundBlobs;
     readonly quota: TenantBoundQuota;
-    readonly sequence: TenantBoundSequence;
     readonly rateLimiter: TenantBoundRateLimiter;
 }
 /** Every naked store a composition supplies. Only {@link tenantStoresFor} reads this. */

package/dist/terminal-result.d.ts

@@ -0,0 +1,38 @@
+import { type BlobRef } from '@byok-sdk/protocol';
+import type { RequestReceipt } from './stores/ports';
+/**
+ * The typed terminal read model — the hosted counterpart of the embedded
+ * coordinator's `TaskResult`, projected off the receipt the inbound gate
+ * stores. Every field is copied verbatim from the payload the gate already
+ * zod-parsed before storing (`recordTerminal`, `inbound.ts`); this projection
+ * neither re-validates nor synthesizes one.
+ */
+export interface TerminalResult {
+    readonly taskId: string;
+    readonly state: 'complete' | 'failed' | 'cancelled';
+    readonly summary?: string;
+    readonly sessionRef?: string;
+    readonly artifactRefs?: readonly BlobRef[];
+    /**
+     * The product's structured terminal result, verbatim `task.complete.document`.
+     * Absent — key missing, never null — when the daemon sent none, which covers
+     * both a legacy pre-`result-document` build and a daemon with no
+     * `resultDocument` extractor.
+     */
+    readonly document?: unknown;
+    readonly reason?: string;
+    readonly retryable?: boolean;
+    /** When the receipt store wrote the terminal fact — the first one, by its own first-write-wins rule. */
+    readonly recordedAt: string;
+}
+/**
+ * Pure projection of a terminal receipt onto {@link TerminalResult}. `taskId`
+ * names the task the receipt was read for (the receipt's key carries it, its
+ * body does not); `recordedAt` is the receipt store's write time.
+ *
+ * Fail closed on anything but a terminal envelope: the stored body is
+ * `encodeEnvelope` of what the inbound gate accepted, so an undecodable body
+ * or a non-terminal type means the receipt-store contract itself broke — an
+ * error, never a best-effort shape.
+ */
+export declare function projectTerminalResult(taskId: string, receipt: RequestReceipt): TerminalResult;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/cloud",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "BYOK SDK hosted device surface: stateless frozen-v1 HTTP handlers over tenant-first @byok-sdk/core ports",
   "type": "module",
   "license": "MIT",
@@ -38,8 +38,8 @@
   "dependencies": {
     "hono": "^4.12.30",
     "zod": "^4.4.3",
-    "@byok-sdk/protocol": "0.2.0",
-    "@byok-sdk/core": "0.2.0"
+    "@byok-sdk/core": "0.4.0",
+    "@byok-sdk/protocol": "0.4.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",

package/dist/stores/in-memory/sequence.d.ts

@@ -1,11 +0,0 @@
-/**
- * In-memory {@link DeviceSequenceStore}: a monotonic per-(tenant, device)
- * delivery counter starting at 1, matching what a mailbox numbers its first
- * row.
- */
-import { type TenantId } from '@byok-sdk/core';
-import type { DeviceSequenceStore } from '../ports';
-export declare class InMemoryDeviceSequenceStore implements DeviceSequenceStore {
-    #private;
-    next(tenant: TenantId, deviceId: string): Promise<number>;
-}