@hydracept/sdk 0.1.4 → 0.2.2

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.2.2 — 2026-08-12
+
+- Typed panel definition list response: `{ definitions: PanelDefinitionView[] }`
+- Typed `createPanelSession` → `PanelSessionCreated`
+- Exported `PanelDefinitionView`, `PanelDefinitionListResponse`, `PanelSessionCreated`
+
+## 0.2.1
+
+Prior release.

package/README.md

@@ -33,6 +33,30 @@ const status = await client.runtime.getJob(job.jobId);
 const receipt = await client.runtime.getJobReceipt(job.jobId);
 ```
 
+### Panel sessions (embed host)
+
+```ts
+import { createHydraceptClient } from '@hydracept/sdk';
+
+const client = createHydraceptClient({
+  baseUrl: 'https://api.hydracept.com',
+  getToken: () => process.env.HYDRACEPT_API_KEY ?? '',
+});
+
+const { definitions } = await client.panels.listPanelDefinitions();
+const created = await client.panels.createPanelSession({
+  panelDefinitionId: definitions[0]!.id,
+  projectId: process.env.HYDRACEPT_PROJECT,
+  environment: 'development',
+  allowedOrigins: ['http://localhost:5173'],
+});
+
+// Pass sessionId + accessToken to @hydracept/elements PanelIframeManager
+console.log(created.sessionId, created.accessToken);
+```
+
+Pair with [`@hydracept/elements`](../../packages/elements) to mount the hosted iframe — do not copy protocol code.
+
 Activate at https://hydracept.com/start · Docs: https://docs.hydracept.com
 
 A Zencode product · © Zencode Consulting Inc.

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { createHydraceptControlApi } from './control.js';
 import { type HydraceptHttp } from './http.js';
+import { createHydraceptPanelsApi } from './panels.js';
 import { createHydraceptRuntimeApi } from './runtime.js';
 import type { HydraceptClientOptions } from './types.js';
 export type { HydraceptHttpError, HydraceptClientOptions, HydraceptRuntimeEvent } from './types.js';
@@ -9,12 +10,16 @@ export { createHydraceptControlApi } from './control.js';
 export type { HydraceptControlApi } from './control.js';
 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 { iterInvocationEvents } from './sse.js';
 export type { HydraceptAssetOut, HydraceptAssetPage, } from './types.js';
 export type HydraceptClient = {
     http: HydraceptHttp;
     control: ReturnType<typeof createHydraceptControlApi>;
     runtime: ReturnType<typeof createHydraceptRuntimeApi>;
+    panels: ReturnType<typeof createHydraceptPanelsApi>;
 };
 export declare function createHydraceptClient(options: HydraceptClientOptions): HydraceptClient;
 //# 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,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,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;CACvD,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAOtF"}
+{"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"}

package/dist/index.js

@@ -1,9 +1,11 @@
 import { createHydraceptControlApi } from './control.js';
 import { createHydraceptHttp } from './http.js';
+import { createHydraceptPanelsApi } from './panels.js';
 import { createHydraceptRuntimeApi } from './runtime.js';
 export { createHydraceptHttp } from './http.js';
 export { createHydraceptControlApi } from './control.js';
 export { createHydraceptRuntimeApi } from './runtime.js';
+export { createHydraceptPanelsApi } from './panels.js';
 export { iterInvocationEvents } from './sse.js';
 export function createHydraceptClient(options) {
     const http = createHydraceptHttp(options);
@@ -11,5 +13,6 @@ export function createHydraceptClient(options) {
         http,
         control: createHydraceptControlApi(http),
         runtime: createHydraceptRuntimeApi(http),
+        panels: createHydraceptPanelsApi(http),
     };
 }

package/dist/panel-types.d.ts

@@ -0,0 +1,27 @@
+/** Panel definition and session response shapes (additive /v1 contracts). */
+export interface PanelDefinitionVersionView {
+    readonly id: string;
+    readonly definitionId: string;
+    readonly version: number;
+    readonly capabilityKey: string;
+    readonly capabilityVersion: string;
+    readonly allowedOrigins: readonly string[];
+}
+export interface PanelDefinitionView {
+    readonly id: string;
+    readonly organizationId: string;
+    readonly key: string;
+    readonly displayName: string;
+    readonly status: string;
+    readonly currentVersion?: PanelDefinitionVersionView;
+}
+/** GET /v1/panel-definitions list envelope. */
+export interface PanelDefinitionListResponse {
+    readonly definitions: readonly PanelDefinitionView[];
+}
+export interface PanelSessionCreated {
+    readonly sessionId: string;
+    readonly accessToken: string;
+    readonly expiresAt?: string;
+}
+//# sourceMappingURL=panel-types.d.ts.map

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

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

package/dist/panel-types.js

@@ -0,0 +1,2 @@
+/** Panel definition and session response shapes (additive /v1 contracts). */
+export {};

package/dist/panels.d.ts

@@ -0,0 +1,17 @@
+import type { HydraceptHttp } from './http.js';
+import type { PanelDefinitionListResponse, PanelDefinitionView, PanelSessionCreated } from './panel-types.js';
+/** 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>;
+    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>;
+    getPanelSession<T = unknown>(sessionId: string): Promise<T>;
+    revokePanelSession<T = unknown>(sessionId: string, init?: RequestInit): Promise<T>;
+    createPanelLaunchCode<T = unknown>(sessionId: string, init?: RequestInit): Promise<T>;
+    getPanelBootstrap<T = unknown>(init?: RequestInit): Promise<T>;
+    exchangePanelLaunchCode<T = unknown>(body: unknown, init?: RequestInit): Promise<T>;
+};
+export type HydraceptPanelsApi = ReturnType<typeof createHydraceptPanelsApi>;
+//# sourceMappingURL=panels.d.ts.map

package/dist/panels.d.ts.map

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

package/dist/panels.js

@@ -0,0 +1,57 @@
+/** Panel definition and session helpers for hosted panels and embed integrations. */
+export function createHydraceptPanelsApi(http) {
+    return {
+        createPanelDefinition(body, init = {}) {
+            return http.fetchJson('/panel-definitions', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        listPanelDefinitions() {
+            return http.fetchJson('/panel-definitions');
+        },
+        getPanelDefinition(definitionId) {
+            return http.fetchJson(`/panel-definitions/${encodeURIComponent(definitionId)}`);
+        },
+        patchPanelDefinition(definitionId, body, init = {}) {
+            return http.fetchJson(`/panel-definitions/${encodeURIComponent(definitionId)}`, {
+                method: 'PATCH',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        createPanelSession(body, init = {}) {
+            return http.fetchJson('/panel-sessions', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        getPanelSession(sessionId) {
+            return http.fetchJson(`/panel-sessions/${encodeURIComponent(sessionId)}`);
+        },
+        revokePanelSession(sessionId, init = {}) {
+            return http.fetchJson(`/panel-sessions/${encodeURIComponent(sessionId)}/revoke`, {
+                method: 'POST',
+                ...init,
+            });
+        },
+        createPanelLaunchCode(sessionId, init = {}) {
+            return http.fetchJson(`/panel-sessions/${encodeURIComponent(sessionId)}/launch-codes`, {
+                method: 'POST',
+                ...init,
+            });
+        },
+        getPanelBootstrap(init = {}) {
+            return http.fetchJson('/panel/bootstrap', init);
+        },
+        exchangePanelLaunchCode(body, init = {}) {
+            return http.fetchJson('/panel/launch-codes/exchange', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+    };
+}

package/dist/runtime.d.ts

@@ -13,8 +13,22 @@ export declare function createHydraceptRuntimeApi(http: HydraceptHttp): {
     describeCapability<T = unknown>(key: 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>;
+    estimateComparison<T = unknown>(key: string, body: unknown): Promise<T>;
+    getComparison<T = unknown>(comparisonId: string): Promise<T>;
+    submitComparisonJudgement<T = unknown>(comparisonId: string, body: unknown): Promise<T>;
     getJobReceipt<T = unknown>(jobId: string): Promise<T>;
     cancelJob<T = unknown>(jobId: string): Promise<T>;
+    downloadJobArtifact(jobId: string, artifactId: string): Promise<Blob>;
+    pollJobUntilTerminal<T extends {
+        status?: string;
+    } = {
+        status?: string;
+    }>(jobId: string, options?: {
+        intervalMs?: number;
+        signal?: AbortSignal;
+        terminal?: string[];
+    }): Promise<T>;
     streamInvocationEvents(executionId: string, options?: {
         lastEventId?: string;
         signal?: AbortSignal;

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;kBAQC,CAAC,mBAAmB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;cAI3C,CAAC,mBAAmB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;wCAKlC,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;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"}

package/dist/runtime.js

@@ -53,12 +53,51 @@ export function createHydraceptRuntimeApi(http) {
                 ...init,
             });
         },
+        createComparison(key, body) {
+            return http.fetchJson(`/capabilities/${encodeURIComponent(key)}/comparisons`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        estimateComparison(key, body) {
+            return http.fetchJson(`/capabilities/${encodeURIComponent(key)}/comparisons/estimate`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        getComparison(comparisonId) {
+            return http.fetchJson(`/comparisons/${encodeURIComponent(comparisonId)}`);
+        },
+        submitComparisonJudgement(comparisonId, body) {
+            return http.fetchJson(`/comparisons/${encodeURIComponent(comparisonId)}/judgements`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
         getJobReceipt(jobId) {
             return http.fetchJson(`/jobs/${encodeURIComponent(jobId)}/receipt`);
         },
         cancelJob(jobId) {
             return http.fetchJson(`/jobs/${encodeURIComponent(jobId)}/cancel`, { method: 'POST' });
         },
+        downloadJobArtifact(jobId, artifactId) {
+            return http.fetchBlob(`/jobs/${encodeURIComponent(jobId)}/artifacts/${encodeURIComponent(artifactId)}`);
+        },
+        async pollJobUntilTerminal(jobId, options = {}) {
+            const intervalMs = options.intervalMs ?? 2000;
+            const terminal = new Set((options.terminal ?? ['succeeded', 'failed', 'canceled', 'cancelled']).map((s) => s.toLowerCase()));
+            for (;;) {
+                if (options.signal?.aborted) {
+                    throw new DOMException('Aborted', 'AbortError');
+                }
+                const job = await http.fetchJsonWithRetry(`/jobs/${encodeURIComponent(jobId)}`);
+                const status = String(job.status ?? '').toLowerCase();
+                if (terminal.has(status)) {
+                    return job;
+                }
+                await new Promise((resolve) => setTimeout(resolve, intervalMs));
+            }
+        },
         streamInvocationEvents(executionId, options = {}) {
             const token = http.options.getToken?.() ?? http.options.token ?? '';
             const sseOptions = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydracept/sdk",
-  "version": "0.1.4",
+  "version": "0.2.2",
   "description": "One API for AI workloads in games — TypeScript client for Hydracept (BYOK, durable jobs, receipts).",
   "type": "module",
   "main": "./dist/index.js",
@@ -14,7 +14,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",