@hydracept/sdk 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.2.3 — 2026-08-13
+
+- Pinned Execution: `createPinnedInference`, `getPinnedReceipt`, `listPinnedReceipts`
+- Provenance: `createRunManifest`, `getRunManifest`, `verifyRunManifest`, `getLockfile`, `verifyLockfile`
+
 ## 0.2.2 — 2026-08-12
 
 - Typed panel definition list response: `{ definitions: PanelDefinitionView[] }`

package/README.md

@@ -33,6 +33,19 @@ const status = await client.runtime.getJob(job.jobId);
 const receipt = await client.runtime.getJobReceipt(job.jobId);
 ```
 
+### Pinned Execution (RIP)
+
+```ts
+const result = await client.runtime.createPinnedInference({
+  pin: { provider: 'openai', model: 'gpt-5.6-sol', api: 'responses' },
+  isolation: 'stateless',
+  input: 'ping',
+});
+const pinned = await client.runtime.getPinnedReceipt(result.receipt.receipt_id);
+const lock = await client.runtime.getLockfile(pinned.receiptId);
+await client.runtime.verifyLockfile(lock);
+```
+
 ### Panel sessions (embed host)
 
 ```ts
@@ -59,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

@@ -12,7 +12,7 @@ export { createHydraceptRuntimeApi } from './runtime.js';
 export type { HydraceptRuntimeApi } from './runtime.js';
 export { createHydraceptPanelsApi } from './panels.js';
 export type { HydraceptPanelsApi } from './panels.js';
-export type { PanelDefinitionListResponse, PanelDefinitionView, PanelDefinitionVersionView, PanelSessionCreated, } from './panel-types.js';
+export type { PanelDefinitionListResponse, PanelDefinitionView, PanelDefinitionVersionView, PanelSessionCreated, SurfaceActionInputField, } from './panel-types.js';
 export { iterInvocationEvents } from './sse.js';
 export type { HydraceptAssetOut, HydraceptAssetPage, } from './types.js';
 export type HydraceptClient = {
@@ -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,GACpB,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,21 @@
+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 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;AAMF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,mBAAmB,GAC3B,kBAAkB,CAyDpB"}

package/dist/jobs.js

@@ -0,0 +1,71 @@
+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));
+}
+export function createHydraceptJobRunner(client, binding) {
+    return {
+        async run(capabilityKey, body, options = {}) {
+            const payload = {
+                ...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 expected = String(item.sha256 || '').toLowerCase();
+                    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 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

@@ -1,11 +1,17 @@
 /** Panel definition and session response shapes (additive /v1 contracts). */
+export interface SurfaceActionInputField {
+    readonly key: string;
+    readonly label: string;
+    readonly valueType?: 'string' | 'number' | 'boolean' | 'string[]';
+}
 export interface PanelDefinitionVersionView {
     readonly id: string;
     readonly definitionId: string;
     readonly version: number;
-    readonly capabilityKey: string;
-    readonly capabilityVersion: string;
+    readonly capabilityKey?: string | null;
+    readonly capabilityVersion?: string | null;
     readonly allowedOrigins: readonly string[];
+    readonly actions?: readonly unknown[];
 }
 export interface PanelDefinitionView {
     readonly id: string;
@@ -13,6 +19,8 @@ export interface PanelDefinitionView {
     readonly key: string;
     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,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,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;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,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>;
@@ -19,6 +27,14 @@ export declare function createHydraceptRuntimeApi(http: HydraceptHttp): {
     submitComparisonJudgement<T = unknown>(comparisonId: string, body: unknown): Promise<T>;
     getJobReceipt<T = unknown>(jobId: string): Promise<T>;
     cancelJob<T = unknown>(jobId: string): Promise<T>;
+    createPinnedInference<T = unknown>(body: unknown, init?: RequestInit): Promise<T>;
+    getPinnedReceipt<T = unknown>(receiptId: string): Promise<T>;
+    listPinnedReceipts<T = unknown>(): Promise<T>;
+    createRunManifest<T = unknown>(body: unknown, init?: RequestInit): Promise<T>;
+    getRunManifest<T = unknown>(manifestId: string): Promise<T>;
+    verifyRunManifest<T = unknown>(manifestId: string, init?: RequestInit): Promise<T>;
+    getLockfile<T = unknown>(receiptId: string): Promise<T>;
+    verifyLockfile<T = unknown>(body: unknown, init?: RequestInit): Promise<T>;
     downloadJobArtifact(jobId: string, artifactId: string): Promise<Blob>;
     pollJobUntilTerminal<T extends {
         status?: string;

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;+BAItB,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":"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;sBAItC,CAAC,kBAAkB,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;uBAOtC,CAAC,iBAAiB,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;oBAOvD,CAAC,iBAAiB,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;4BAO5C,CAAC,kBAAkB,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;4BAOvC,CAAC,uBAAuB,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;4BAO1D,CAAC,uBAAuB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;yBAM9C,CAAC,uBAAuB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;8BAItC,CAAC,uBAAuB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;qBAIpD,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"}

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',
@@ -80,6 +121,45 @@ export function createHydraceptRuntimeApi(http) {
         cancelJob(jobId) {
             return http.fetchJson(`/jobs/${encodeURIComponent(jobId)}/cancel`, { method: 'POST' });
         },
+        createPinnedInference(body, init = {}) {
+            return http.fetchJson('/inference/pinned', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        getPinnedReceipt(receiptId) {
+            return http.fetchJson(`/inference/pinned/${encodeURIComponent(receiptId)}`);
+        },
+        listPinnedReceipts() {
+            return http.fetchJson('/inference/pinned');
+        },
+        createRunManifest(body, init = {}) {
+            return http.fetchJson('/provenance/manifests', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        getRunManifest(manifestId) {
+            return http.fetchJson(`/provenance/manifests/${encodeURIComponent(manifestId)}`);
+        },
+        verifyRunManifest(manifestId, init = {}) {
+            return http.fetchJson(`/provenance/manifests/${encodeURIComponent(manifestId)}/verify`, {
+                method: 'POST',
+                ...init,
+            });
+        },
+        getLockfile(receiptId) {
+            return http.fetchJson(`/provenance/lockfile?receipt_id=${encodeURIComponent(receiptId)}`);
+        },
+        verifyLockfile(body, init = {}) {
+            return http.fetchJson('/provenance/lockfile/verify', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
         downloadJobArtifact(jobId, artifactId) {
             return http.fetchBlob(`/jobs/${encodeURIComponent(jobId)}/artifacts/${encodeURIComponent(artifactId)}`);
         },

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.2",
-  "description": "One API for AI workloads in games — TypeScript client for Hydracept (BYOK, durable jobs, receipts).",
+  "version": "0.3.0",
+  "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"
   }
 }