@hydracept/sdk 0.2.3 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 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

@@ -72,4 +72,4 @@ Pair with [`@hydracept/elements`](../../packages/elements) to mount the hosted i
 
 Activate at https://hydracept.com/start · Docs: https://docs.hydracept.com
 
-A Zencode product · © Zencode Consulting Inc.
+A Zencode company · © Zencode Consulting Inc.

package/dist/index.d.ts

@@ -22,4 +22,7 @@ export type HydraceptClient = {
     panels: ReturnType<typeof createHydraceptPanelsApi>;
 };
 export declare function createHydraceptClient(options: HydraceptClientOptions): HydraceptClient;
+export { HydraceptWorkspace } from './workspace.js';
+export { createHydraceptJobRunner } from './jobs.js';
+export type { HydraceptJobRunner, HydraceptJobRunResult } from './jobs.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACtD,OAAO,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACtD,MAAM,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;CACrD,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAQtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACpG,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACtD,OAAO,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;IACtD,MAAM,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;CACrD,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAQtF;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -16,3 +16,5 @@ export function createHydraceptClient(options) {
         panels: createHydraceptPanelsApi(http),
     };
 }
+export { HydraceptWorkspace } from './workspace.js';
+export { createHydraceptJobRunner } from './jobs.js';

package/dist/jobs.d.ts

@@ -0,0 +1,22 @@
+import type { HydraceptClient } from './index.js';
+export type HydraceptJobBinding = {
+    projectId: string;
+    environment?: string;
+};
+export type HydraceptJobRunResult = {
+    jobId: string;
+    status: string;
+    job: Record<string, unknown>;
+    receipt: Record<string, unknown> | null;
+    downloads: string[];
+    nextAction: string;
+};
+export type HydraceptJobRunner = {
+    run(capabilityKey: string, body: Record<string, unknown>, options?: {
+        downloadDir?: string;
+        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

@@ -0,0 +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;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

@@ -0,0 +1,115 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+function nextActionForJob(job) {
+    const status = String(job.status || '').toLowerCase();
+    const artifacts = job.artifacts;
+    const hasArtifacts = Array.isArray(artifacts) && artifacts.length > 0;
+    if (['queued', 'running', 'awaiting_approval', 'canceling'].includes(status))
+        return 'poll';
+    if (status === 'succeeded')
+        return hasArtifacts ? 'download' : 'receipt';
+    return 'done';
+}
+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 = omitStaleQuoteIds({
+                ...body,
+                context: {
+                    productId: binding.projectId,
+                    projectId: binding.projectId,
+                    environment: binding.environment || 'development',
+                    ...(body.context ?? {}),
+                },
+            });
+            const submitted = (await client.runtime.submitCapabilityJob(capabilityKey, payload));
+            const jobId = String(submitted.jobId || submitted.id || '');
+            if (!jobId)
+                throw new Error('No jobId in submit response');
+            const deadline = Date.now() + (options.pollMs ?? 120_000);
+            let job = submitted;
+            let status = String(submitted.status || 'queued');
+            while (Date.now() < deadline) {
+                job = (await client.runtime.getJob(jobId));
+                status = String(job.status || 'unknown');
+                if (['succeeded', 'failed', 'canceled', 'cancelled'].includes(status))
+                    break;
+                await sleep(2000);
+            }
+            let receipt = null;
+            if (status === 'succeeded') {
+                receipt = (await client.runtime.getJobReceipt(jobId));
+            }
+            const downloads = [];
+            if (options.downloadDir && status === 'succeeded' && receipt) {
+                const artifacts = receipt.artifacts || [];
+                for (const item of artifacts) {
+                    const artifactId = String(item.artifactId || item.id || '');
+                    if (!artifactId)
+                        continue;
+                    const buffer = await client.http.fetchBytes(`/jobs/${encodeURIComponent(jobId)}/artifacts/${encodeURIComponent(artifactId)}`);
+                    const bytes = new Uint8Array(buffer);
+                    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 = filenameForDownload(item, artifactId);
+                    const target = join(options.downloadDir, filename);
+                    mkdirSync(dirname(target), { recursive: true });
+                    writeFileSync(target, bytes);
+                    downloads.push(target);
+                }
+            }
+            return { jobId, status, job, receipt, downloads, nextAction: nextActionForJob(job) };
+        },
+    };
+}

package/dist/panel-types.d.ts

@@ -20,6 +20,7 @@ export interface PanelDefinitionView {
     readonly displayName: string;
     readonly status: string;
     readonly origin?: 'hydracept' | 'project';
+    readonly projectId?: string | null;
     readonly currentVersion?: PanelDefinitionVersionView;
 }
 /** GET /v1/panel-definitions list envelope. */

package/dist/panel-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel-types.d.ts","sourceRoot":"","sources":["../src/panel-types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;CACnE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,0BAA0B,CAAC;CACtD;AAED,+CAA+C;AAC/C,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}
+{"version":3,"file":"panel-types.d.ts","sourceRoot":"","sources":["../src/panel-types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;CACnE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,0BAA0B,CAAC;CACtD;AAED,+CAA+C;AAC/C,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/panels.d.ts

@@ -3,7 +3,7 @@ import type { PanelDefinitionListResponse, PanelDefinitionView, PanelSessionCrea
 /** Panel definition and session helpers for hosted panels and embed integrations. */
 export declare function createHydraceptPanelsApi(http: HydraceptHttp): {
     createPanelDefinition<T = PanelDefinitionView>(body: unknown, init?: RequestInit): Promise<T>;
-    listPanelDefinitions(): Promise<PanelDefinitionListResponse>;
+    listPanelDefinitions(projectId?: string): Promise<PanelDefinitionListResponse>;
     getPanelDefinition<T = unknown>(definitionId: string): Promise<T>;
     patchPanelDefinition<T = unknown>(definitionId: string, body: unknown, init?: RequestInit): Promise<T>;
     createPanelSession(body: unknown, init?: RequestInit): Promise<PanelSessionCreated>;

package/dist/panels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa;0BAElC,CAAC,8BAA8B,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;4BAQzE,OAAO,CAAC,2BAA2B,CAAC;uBAIzC,CAAC,0BAA0B,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;yBAI5C,CAAC,0BACN,MAAM,QACd,OAAO,SACP,WAAW,GAChB,OAAO,CAAC,CAAC,CAAC;6BAQY,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,mBAAmB,CAAC;oBAQvE,CAAC,uBAAuB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;uBAIxC,CAAC,uBAAuB,MAAM,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;0BAOhE,CAAC,uBAAuB,MAAM,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;sBAUvE,CAAC,mBAAkB,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;4BAI1C,CAAC,kBAAkB,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;EAQ1F;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC"}
+{"version":3,"file":"panels.d.ts","sourceRoot":"","sources":["../src/panels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EACV,2BAA2B,EAC3B,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,aAAa;0BAElC,CAAC,8BAA8B,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;qCAQhE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;uBAK3D,CAAC,0BAA0B,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;yBAI5C,CAAC,0BACN,MAAM,QACd,OAAO,SACP,WAAW,GAChB,OAAO,CAAC,CAAC,CAAC;6BAQY,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,mBAAmB,CAAC;oBAQvE,CAAC,uBAAuB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;uBAIxC,CAAC,uBAAuB,MAAM,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;0BAOhE,CAAC,uBAAuB,MAAM,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;sBAUvE,CAAC,mBAAkB,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;4BAI1C,CAAC,kBAAkB,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;EAQ1F;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/panels.js

@@ -8,8 +8,9 @@ export function createHydraceptPanelsApi(http) {
                 ...init,
             });
         },
-        listPanelDefinitions() {
-            return http.fetchJson('/panel-definitions');
+        listPanelDefinitions(projectId) {
+            const suffix = projectId ? `?projectId=${encodeURIComponent(projectId)}` : '';
+            return http.fetchJson(`/panel-definitions${suffix}`);
         },
         getPanelDefinition(definitionId) {
             return http.fetchJson(`/panel-definitions/${encodeURIComponent(definitionId)}`);

package/dist/runtime.d.ts

@@ -11,6 +11,14 @@ export declare function createHydraceptRuntimeApi(http: HydraceptHttp): {
     getJobResult<T = unknown>(jobId: string): Promise<T>;
     getCapabilities<T = unknown>(): Promise<T>;
     describeCapability<T = unknown>(key: string): Promise<T>;
+    resolveCapability<T = unknown>(body: unknown): Promise<T>;
+    estimateCapability<T = unknown>(key: string, body: unknown): Promise<T>;
+    quoteCapability<T = unknown>(key: string, body: unknown): Promise<T>;
+    createCapabilityRequest<T = unknown>(body: unknown): Promise<T>;
+    reviseCapabilityRequest<T = unknown>(requestId: string, body: unknown): Promise<T>;
+    submitCapabilityRequest<T = unknown>(requestId: string): Promise<T>;
+    getCapabilityRequest<T = unknown>(requestId: string): Promise<T>;
+    getCapabilityRequestQuote<T = unknown>(requestId: string): Promise<T>;
     invokeCapability<T = unknown>(key: string, body: unknown, init?: RequestInit): Promise<T>;
     submitCapabilityJob<T = unknown>(key: string, body: unknown, init?: RequestInit): Promise<T>;
     createComparison<T = unknown>(key: string, body: unknown): Promise<T>;

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,0EAA0E;AAC1E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa;WAElD,CAAC,kBAAkB,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;kBAQxD,CAAC,yBAAyB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;eAIhD,CAAC,yBAAyB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;qBAIvC,CAAC,yBAAyB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;cAMpD,CAAC,kBAAkB,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;WAQlE,CAAC,mBAAmB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;iBAIjC,CAAC,mBAAmB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;oBAIpC,CAAC,eAAe,OAAO,CAAC,CAAC,CAAC;uBAIvB,CAAC,iBAAiB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;qBAIvC,CAAC,iBAAiB,MAAM,QAAQ,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;wBAQzE,CAAC,iBACd,MAAM,QACL,OAAO,SACP,WAAW,GAChB,OAAO,CAAC,CAAC,CAAC;qBAQI,CAAC,iBAAiB,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;uBAOlD,CAAC,iBAAiB,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;kBAOzD,CAAC,0BAA0B,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;8BAIlC,CAAC,0BAA0B,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;kBAOzE,CAAC,mBAAmB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;cAI3C,CAAC,mBAAmB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;0BAI3B,CAAC,kBAAkB,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;qBAQpE,CAAC,uBAAuB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;uBAIzC,CAAC,eAAe,OAAO,CAAC,CAAC,CAAC;sBAI3B,CAAC,kBAAkB,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;mBAQlE,CAAC,wBAAwB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;sBAIzC,CAAC,wBAAwB,MAAM,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;gBAO1E,CAAC,uBAAuB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;mBAMxC,CAAC,kBAAkB,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;+BAQnD,MAAM,cAAc,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;yBAM1C,CAAC,SAAS;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;iBAAc,MAAM;cACnE,MAAM,YACJ;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC1E,OAAO,CAAC,CAAC,CAAC;wCAqBE,MAAM,YACV;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACtD,cAAc,CAAC,qBAAqB,EAAE,IAAI,EAAE,OAAO,CAAC;EAmB1D;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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"}

package/dist/runtime.js

@@ -39,6 +39,47 @@ export function createHydraceptRuntimeApi(http) {
         describeCapability(key) {
             return http.fetchJson(`/capabilities/${encodeURIComponent(key)}`);
         },
+        resolveCapability(body) {
+            return http.fetchJson('/capabilities/resolve', {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        estimateCapability(key, body) {
+            return http.fetchJson(`/capabilities/${encodeURIComponent(key)}/quote`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        quoteCapability(key, body) {
+            return http.fetchJson(`/capabilities/${encodeURIComponent(key)}/quote`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        createCapabilityRequest(body) {
+            return http.fetchJson('/capability-requests', {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        reviseCapabilityRequest(requestId, body) {
+            return http.fetchJson(`/capability-requests/${encodeURIComponent(requestId)}/revisions`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        submitCapabilityRequest(requestId) {
+            return http.fetchJson(`/capability-requests/${encodeURIComponent(requestId)}/submit`, {
+                method: 'POST',
+            });
+        },
+        getCapabilityRequest(requestId) {
+            return http.fetchJson(`/capability-requests/${encodeURIComponent(requestId)}`);
+        },
+        getCapabilityRequestQuote(requestId) {
+            return http.fetchJson(`/capability-requests/${encodeURIComponent(requestId)}/quote`);
+        },
         invokeCapability(key, body, init = {}) {
             return http.fetchJson(`/capabilities/${encodeURIComponent(key)}/invoke`, {
                 method: 'POST',

package/dist/workspace.d.ts

@@ -0,0 +1,17 @@
+import { type HydraceptJobRunner } from './jobs.js';
+import type { HydraceptClient } from './index.js';
+export type HydraceptWorkspaceBinding = {
+    schemaVersion?: string;
+    projectId: string;
+    environment?: string;
+    apiOrigin?: string;
+};
+export declare class HydraceptWorkspace {
+    readonly client: HydraceptClient;
+    readonly jobs: HydraceptJobRunner;
+    readonly root: string;
+    readonly binding: HydraceptWorkspaceBinding;
+    private constructor();
+    static open(root?: string): HydraceptWorkspace;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAMA,OAAO,EAA4B,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAE5C,OAAO;IAYP,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB;CAqC/C"}

package/dist/workspace.js

@@ -0,0 +1,54 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { createHydraceptHttp } from './http.js';
+import { createHydraceptControlApi } from './control.js';
+import { createHydraceptPanelsApi } from './panels.js';
+import { createHydraceptRuntimeApi } from './runtime.js';
+import { createHydraceptJobRunner } from './jobs.js';
+export class HydraceptWorkspace {
+    client;
+    jobs;
+    root;
+    binding;
+    constructor(root, binding, client, jobs) {
+        this.root = root;
+        this.binding = binding;
+        this.client = client;
+        this.jobs = jobs;
+    }
+    static open(root) {
+        const projectRoot = resolve(root ?? process.cwd());
+        const bindingPath = join(projectRoot, '.hydracept', 'project.json');
+        if (!existsSync(bindingPath)) {
+            throw new Error('Missing .hydracept/project.json — run python -m hydracept init');
+        }
+        const binding = JSON.parse(readFileSync(bindingPath, 'utf8'));
+        if (!binding.projectId) {
+            throw new Error('project.json is missing projectId');
+        }
+        const envProject = process.env.HYDRACEPT_PROJECT || process.env.HYDRACEPT_PROJECT_ID;
+        if (envProject && envProject !== binding.projectId) {
+            throw new Error(`HYDRACEPT_PROJECT=${envProject} disagrees with project.json projectId=${binding.projectId}`);
+        }
+        const secretsPath = join(projectRoot, '.hydracept', 'secrets.json');
+        const secrets = existsSync(secretsPath)
+            ? JSON.parse(readFileSync(secretsPath, 'utf8'))
+            : {};
+        const token = process.env.HYDRACEPT_API_KEY || secrets.apiKey || secrets.token;
+        if (!token) {
+            throw new Error('No workspace API key in secrets.json');
+        }
+        const http = createHydraceptHttp({
+            baseUrl: binding.apiOrigin || 'https://api.hydracept.com',
+            token,
+        });
+        const client = {
+            http,
+            control: createHydraceptControlApi(http),
+            runtime: createHydraceptRuntimeApi(http),
+            panels: createHydraceptPanelsApi(http),
+        };
+        const jobs = createHydraceptJobRunner(client, binding);
+        return new HydraceptWorkspace(projectRoot, binding, client, jobs);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hydracept/sdk",
-  "version": "0.2.3",
-  "description": "TypeScript client for Hydracept — AI execution you can trust (BYOK, durable jobs, pinned inference, receipts).",
+  "version": "0.3.1",
+  "description": "TypeScript client for Hydracept — production-ready game assets, with a receipt for every run.",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -33,7 +33,12 @@
     "unreal",
     "ai",
     "llm",
+    "mcp",
     "image-generation",
+    "sprite-sheet",
+    "transparent-png",
+    "reference-image",
+    "multi-provider",
     "audio",
     "byok",
     "api",
@@ -57,6 +62,7 @@
     "provenance": false
   },
   "devDependencies": {
+    "@types/node": "^22.10.0",
     "typescript": "^5.7.2"
   }
 }