@byok-sdk/cloud 0.3.0 → 0.4.0

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/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.3.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/core": "0.3.0",
-    "@byok-sdk/protocol": "0.3.0"
+    "@byok-sdk/core": "0.4.0",
+    "@byok-sdk/protocol": "0.4.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json",