@hydracept/sdk 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.3.2 — 2026-08-26
+
+- Ship with the 0.3.2 public-install constellation (receipt `pricing.charge`, first-success smoke)
+
+## 0.3.1 — 2026-08-26
+
+- Job downloads compare receipt SHA-256 as hex (`sha256:<hex>` prefix is stripped)
+- High-level submit omits stale `execution.quoteId` / `estimateId`
+- Audio downloads add `.ogg` when the receipt has no filename
+
 ## 0.2.3 — 2026-08-13
 
 - Pinned Execution: `createPinnedInference`, `getPinnedReceipt`, `listPinnedReceipts`

package/README.md

@@ -68,7 +68,7 @@ const created = await client.panels.createPanelSession({
 console.log(created.sessionId, created.accessToken);
 ```
 
-Pair with [`@hydracept/elements`](../../packages/elements) to mount the hosted iframe — do not copy protocol code.
+Pair with [`@hydracept/elements`](https://www.npmjs.com/package/@hydracept/elements) to mount the hosted iframe — do not copy protocol code.
 
 Activate at https://hydracept.com/start · Docs: https://docs.hydracept.com
 

package/dist/jobs.d.ts

@@ -17,5 +17,6 @@ export type HydraceptJobRunner = {
         pollMs?: number;
     }): Promise<HydraceptJobRunResult>;
 };
+export declare function normalizeSha256Digest(value: string | undefined | null): string;
 export declare function createHydraceptJobRunner(client: HydraceptClient, binding: HydraceptJobBinding): HydraceptJobRunner;
 //# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAWF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CACD,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC,CAAC;AAMF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAyDpB"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAWF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CACD,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC,CAAC;AAmBF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAI9E;AAyBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CA+DpB"}

package/dist/jobs.js

@@ -14,10 +14,51 @@ function nextActionForJob(job) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+const MEDIA_EXTENSIONS = {
+    'audio/ogg': '.ogg',
+    'application/ogg': '.ogg',
+    'audio/wav': '.wav',
+    'audio/mpeg': '.mp3',
+    'image/png': '.png',
+    'image/jpeg': '.jpg',
+    'image/webp': '.webp',
+    'model/gltf-binary': '.glb',
+    'video/mp4': '.mp4',
+    'application/json': '.json',
+};
+export function normalizeSha256Digest(value) {
+    let raw = String(value || '').trim().toLowerCase();
+    if (raw.startsWith('sha256:'))
+        raw = raw.slice(7);
+    return raw;
+}
+function filenameForDownload(item, artifactId) {
+    const media = String(item.mediaType || item.mimeType || '')
+        .split(';')[0]
+        .trim()
+        .toLowerCase();
+    let name = String(item.filename || item.label || artifactId || 'artifact')
+        .replace(/\\/g, '/')
+        .split('/')
+        .pop() || 'artifact';
+    const ext = MEDIA_EXTENSIONS[media];
+    if (ext && !name.toLowerCase().endsWith(ext))
+        name = `${name}${ext}`;
+    return name;
+}
+function omitStaleQuoteIds(body) {
+    const execution = body.execution;
+    if (!execution || typeof execution !== 'object')
+        return body;
+    const cleaned = { ...execution };
+    delete cleaned.quoteId;
+    delete cleaned.estimateId;
+    return { ...body, execution: cleaned };
+}
 export function createHydraceptJobRunner(client, binding) {
     return {
         async run(capabilityKey, body, options = {}) {
-            const payload = {
+            const payload = omitStaleQuoteIds({
                 ...body,
                 context: {
                     productId: binding.projectId,
@@ -25,7 +66,7 @@ export function createHydraceptJobRunner(client, binding) {
                     environment: binding.environment || 'development',
                     ...(body.context ?? {}),
                 },
-            };
+            });
             const submitted = (await client.runtime.submitCapabilityJob(capabilityKey, payload));
             const jobId = String(submitted.jobId || submitted.id || '');
             if (!jobId)
@@ -53,12 +94,15 @@ export function createHydraceptJobRunner(client, binding) {
                         continue;
                     const buffer = await client.http.fetchBytes(`/jobs/${encodeURIComponent(jobId)}/artifacts/${encodeURIComponent(artifactId)}`);
                     const bytes = new Uint8Array(buffer);
-                    const expected = String(item.sha256 || '').toLowerCase();
+                    const nested = item.digest && typeof item.digest === 'object'
+                        ? item.digest
+                        : {};
+                    const expected = normalizeSha256Digest(String(item.sha256 || nested.sha256 || ''));
                     const actual = createHash('sha256').update(bytes).digest('hex');
                     if (expected && expected !== actual) {
                         throw new Error(`SHA-256 mismatch for ${artifactId}`);
                     }
-                    const filename = String(item.filename || item.label || artifactId);
+                    const filename = filenameForDownload(item, artifactId);
                     const target = join(options.downloadDir, filename);
                     mkdirSync(dirname(target), { recursive: true });
                     writeFileSync(target, bytes);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydracept/sdk",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "TypeScript client for Hydracept — production-ready game assets, with a receipt for every run.",
   "type": "module",
   "main": "./dist/index.js",