@hydracept/sdk 0.1.0

package/README.md

@@ -0,0 +1,22 @@
+# @hydracept/sdk
+
+TypeScript client for the Hydracept public API — AI execution infrastructure for games.
+
+```bash
+npm install @hydracept/sdk
+```
+
+```ts
+import { createHydraceptClient } from '@hydracept/sdk';
+
+const client = createHydraceptClient({
+  baseUrl: 'https://api.hydracept.com',
+  getToken: () => process.env.HYDRACEPT_API_KEY ?? '',
+});
+
+const caps = await client.runtime.capabilities();
+```
+
+Docs: https://docs.hydracept.com
+
+A Zencode product · © Zencode Consulting Inc.

package/dist/control.d.ts

@@ -0,0 +1,18 @@
+import type { HydraceptHttp } from './http.js';
+import type { HydraceptAssetOut } from './types.js';
+/** Control-plane helpers used by product authoring UIs (KOL, Workbench). */
+export declare function createHydraceptControlApi(http: HydraceptHttp): {
+    healthz(path?: string): Promise<Response>;
+    listProviders<T = unknown>(): Promise<T>;
+    syncProject<T = unknown>(projectId: string, body: unknown, init?: RequestInit): Promise<T>;
+    listAssets(projectId: string, limit?: number): Promise<HydraceptAssetOut[]>;
+    generateAsset<T = unknown>(assetId: string, body?: unknown, init?: RequestInit): Promise<T>;
+    getWorkflow<T = unknown>(workflowId: string): Promise<T>;
+    getArtifact<T = unknown>(artifactId: string): Promise<T>;
+    getArtifactContent(artifactId: string): Promise<Blob>;
+    createReview<T = unknown>(body: unknown): Promise<T>;
+    createPromotion<T = unknown>(body: unknown): Promise<T>;
+    reportPromotion<T = unknown>(promotionId: string, body: unknown): Promise<T>;
+};
+export type HydraceptControlApi = ReturnType<typeof createHydraceptControlApi>;
+//# sourceMappingURL=control.d.ts.map

package/dist/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAQxE,4EAA4E;AAC5E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,aAAa;4BAE7B,OAAO,CAAC,QAAQ,CAAC;kBAK/B,CAAC,eAAe,OAAO,CAAC,CAAC,CAAC;gBAI5B,CAAC,uBAAuB,MAAM,QAAQ,OAAO,SAAQ,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;0BAQxE,MAAM,mBAAgB,OAAO,CAAC,iBAAiB,EAAE,CAAC;kBAQ1D,CAAC,qBAAqB,MAAM,SAAQ,OAAO,SAAa,WAAW,GAAQ,OAAO,CAAC,CAAC,CAAC;gBAQvF,CAAC,wBAAwB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;gBAI5C,CAAC,wBAAwB,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;mCAIzB,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;iBAIxC,CAAC,kBAAkB,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;oBAOpC,CAAC,kBAAkB,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;oBAOvC,CAAC,yBAAyB,MAAM,QAAQ,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;EAO/E;AAED,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/control.js

@@ -0,0 +1,64 @@
+function normalizeAssetList(data) {
+    if (Array.isArray(data))
+        return [...data];
+    const page = data;
+    return [...(page.items ?? [])];
+}
+/** Control-plane helpers used by product authoring UIs (KOL, Workbench). */
+export function createHydraceptControlApi(http) {
+    return {
+        healthz(path = '/healthz') {
+            // healthz is outside /v1 — call absolute-ish via fetchResponse with special path handling
+            return http.fetchResponse(path.startsWith('/healthz') ? path : '/healthz');
+        },
+        listProviders() {
+            return http.fetchJson('/providers');
+        },
+        syncProject(projectId, body, init = {}) {
+            return http.fetchJson(`/projects/${encodeURIComponent(projectId)}/syncs`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        listAssets(projectId, limit = 500) {
+            return http
+                .fetchJson(`/assets?projectId=${encodeURIComponent(projectId)}&limit=${limit}`)
+                .then(normalizeAssetList);
+        },
+        generateAsset(assetId, body = {}, init = {}) {
+            return http.fetchJson(`/assets/${encodeURIComponent(assetId)}/generate`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        getWorkflow(workflowId) {
+            return http.fetchJsonWithRetry(`/workflows/${encodeURIComponent(workflowId)}`);
+        },
+        getArtifact(artifactId) {
+            return http.fetchJson(`/artifacts/${encodeURIComponent(artifactId)}`);
+        },
+        getArtifactContent(artifactId) {
+            return http.fetchBlob(`/artifacts/${encodeURIComponent(artifactId)}/content`);
+        },
+        createReview(body) {
+            return http.fetchJson('/reviews', {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        createPromotion(body) {
+            return http.fetchJson('/promotions', {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+        reportPromotion(promotionId, body) {
+            return http.fetchJson(`/promotions/${encodeURIComponent(promotionId)}/report`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        },
+    };
+}

package/dist/http.d.ts

@@ -0,0 +1,16 @@
+import type { HydraceptClientOptions } from './types.js';
+export declare function createHydraceptHttp(options: HydraceptClientOptions): {
+    options: HydraceptClientOptions;
+    authHeaders: (extra?: Record<string, string>) => Record<string, string>;
+    urlFor: (path: string) => string;
+    fetchResponse: (path: string, init?: RequestInit) => Promise<Response>;
+    fetchJson: <T>(path: string, init?: RequestInit) => Promise<T>;
+    fetchBlob: (path: string, init?: RequestInit) => Promise<Blob>;
+    fetchBytes: (path: string, init?: RequestInit) => Promise<ArrayBuffer>;
+    fetchJsonWithRetry: <T>(path: string, init?: RequestInit, retry?: {
+        maxAttempts?: number;
+        baseDelayMs?: number;
+    }) => Promise<T>;
+};
+export type HydraceptHttp = ReturnType<typeof createHydraceptHttp>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAsB,MAAM,YAAY,CAAC;AAyB7E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB;;0BAIrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;mBAO1D,MAAM,KAAG,MAAM;0BAIF,MAAM,SAAQ,WAAW,KAAQ,OAAO,CAAC,QAAQ,CAAC;gBAuB5D,CAAC,QAAQ,MAAM,SAAQ,WAAW,KAAQ,OAAO,CAAC,CAAC,CAAC;sBAK9C,MAAM,SAAQ,WAAW,KAAQ,OAAO,CAAC,IAAI,CAAC;uBAK7C,MAAM,SAAQ,WAAW,KAAQ,OAAO,CAAC,WAAW,CAAC;yBASnD,CAAC,QAC3B,MAAM,SACN,WAAW,UACV;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,KACpD,OAAO,CAAC,CAAC,CAAC;EA0Cd;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/http.js

@@ -0,0 +1,109 @@
+function resolveToken(options) {
+    if (options.getToken)
+        return options.getToken();
+    return options.token ?? '';
+}
+function joinUrl(baseUrl, path) {
+    const base = baseUrl.replace(/\/$/, '');
+    const suffix = path.startsWith('/') ? path : `/${path}`;
+    return `${base}${suffix}`;
+}
+function toV1Path(path, pathsAreV1Relative) {
+    const normalized = path.startsWith('/') ? path : `/${path}`;
+    if (pathsAreV1Relative) {
+        // Caller already speaks /assets, /workflows, etc. (Vite proxy to /v1).
+        return normalized;
+    }
+    if (normalized.startsWith('/v1/') || normalized === '/v1' || normalized === '/healthz') {
+        return normalized;
+    }
+    return `/v1${normalized}`;
+}
+export function createHydraceptHttp(options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const credentials = options.credentials ?? 'omit';
+    function authHeaders(extra = {}) {
+        const token = resolveToken(options);
+        const headers = { ...extra };
+        if (token)
+            headers.Authorization = `Bearer ${token}`;
+        return headers;
+    }
+    function urlFor(path) {
+        return joinUrl(options.baseUrl, toV1Path(path, options.pathsAreV1Relative));
+    }
+    async function fetchResponse(path, init = {}) {
+        const headers = {
+            ...authHeaders(),
+            ...init.headers,
+        };
+        if (init.body && !headers['Content-Type']) {
+            headers['Content-Type'] = 'application/json';
+        }
+        const res = await fetchImpl(urlFor(path), {
+            ...init,
+            headers,
+            credentials,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            const error = new Error(`Hydracept ${path} failed (${res.status}): ${text}`);
+            error.status = res.status;
+            error.body = text;
+            throw error;
+        }
+        return res;
+    }
+    async function fetchJson(path, init = {}) {
+        const res = await fetchResponse(path, init);
+        return res.json();
+    }
+    async function fetchBlob(path, init = {}) {
+        const res = await fetchResponse(path, init);
+        return res.blob();
+    }
+    async function fetchBytes(path, init = {}) {
+        const res = await fetchResponse(path, init);
+        return res.arrayBuffer();
+    }
+    function isRetryableStatus(status) {
+        return status === 408 || status === 429 || status === 500 || status === 502 || status === 503 || status === 504;
+    }
+    async function fetchJsonWithRetry(path, init = {}, retry = {}) {
+        const maxAttempts = retry.maxAttempts ?? 8;
+        const baseDelayMs = retry.baseDelayMs ?? 750;
+        let lastError = null;
+        for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+            try {
+                return await fetchJson(path, init);
+            }
+            catch (err) {
+                const error = err instanceof Error ? err : new Error(String(err));
+                lastError = error;
+                const status = error.status;
+                const retryable = status !== undefined && isRetryableStatus(status);
+                if (!retryable || attempt === maxAttempts)
+                    throw error;
+                const delayMs = baseDelayMs * attempt;
+                await new Promise((resolve, reject) => {
+                    const timer = setTimeout(resolve, delayMs);
+                    init.signal?.addEventListener('abort', () => {
+                        clearTimeout(timer);
+                        reject(init.signal?.reason ?? new DOMException('Aborted', 'AbortError'));
+                    }, { once: true });
+                });
+            }
+        }
+        throw lastError ?? new Error(`Hydracept ${path} failed after retries`);
+    }
+    return {
+        options,
+        authHeaders,
+        urlFor,
+        fetchResponse,
+        fetchJson,
+        fetchBlob,
+        fetchBytes,
+        fetchJsonWithRetry,
+    };
+}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import { createHydraceptControlApi } from './control.js';
+import { type HydraceptHttp } from './http.js';
+import { createHydraceptRuntimeApi } from './runtime.js';
+import type { HydraceptClientOptions } from './types.js';
+export type { HydraceptHttpError, HydraceptClientOptions, HydraceptRuntimeEvent } from './types.js';
+export { createHydraceptHttp } from './http.js';
+export type { HydraceptHttp } from './http.js';
+export { createHydraceptControlApi } from './control.js';
+export type { HydraceptControlApi } from './control.js';
+export { createHydraceptRuntimeApi } from './runtime.js';
+export type { HydraceptRuntimeApi } from './runtime.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>;
+};
+export declare function createHydraceptClient(options: HydraceptClientOptions): HydraceptClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,15 @@
+import { createHydraceptControlApi } from './control.js';
+import { createHydraceptHttp } from './http.js';
+import { createHydraceptRuntimeApi } from './runtime.js';
+export { createHydraceptHttp } from './http.js';
+export { createHydraceptControlApi } from './control.js';
+export { createHydraceptRuntimeApi } from './runtime.js';
+export { iterInvocationEvents } from './sse.js';
+export function createHydraceptClient(options) {
+    const http = createHydraceptHttp(options);
+    return {
+        http,
+        control: createHydraceptControlApi(http),
+        runtime: createHydraceptRuntimeApi(http),
+    };
+}

package/dist/runtime.d.ts

@@ -0,0 +1,24 @@
+import type { HydraceptHttp } from './http.js';
+import type { HydraceptRuntimeEvent } from './types.js';
+/** Runtime helpers used by trusted product backends (product-backend). */
+export declare function createHydraceptRuntimeApi(http: HydraceptHttp): {
+    invoke<T = unknown>(body: unknown, init?: RequestInit): Promise<T>;
+    getInvocation<T = unknown>(executionId: string): Promise<T>;
+    getReceipt<T = unknown>(executionId: string): Promise<T>;
+    cancelInvocation<T = unknown>(executionId: string): Promise<T>;
+    submitJob<T = unknown>(body: unknown, init?: RequestInit): Promise<T>;
+    getJob<T = unknown>(jobId: string): Promise<T>;
+    getJobResult<T = unknown>(jobId: string): Promise<T>;
+    getCapabilities<T = unknown>(): Promise<T>;
+    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>;
+    getJobReceipt<T = unknown>(jobId: string): Promise<T>;
+    cancelJob<T = unknown>(jobId: string): Promise<T>;
+    streamInvocationEvents(executionId: string, options?: {
+        lastEventId?: string;
+        signal?: AbortSignal;
+    }): AsyncGenerator<HydraceptRuntimeEvent, void, unknown>;
+};
+export type HydraceptRuntimeApi = ReturnType<typeof createHydraceptRuntimeApi>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

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

package/dist/runtime.js

@@ -0,0 +1,79 @@
+import { iterInvocationEvents } from './sse.js';
+/** Runtime helpers used by trusted product backends (product-backend). */
+export function createHydraceptRuntimeApi(http) {
+    return {
+        invoke(body, init = {}) {
+            return http.fetchJson('/invocations', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        getInvocation(executionId) {
+            return http.fetchJson(`/invocations/${encodeURIComponent(executionId)}`);
+        },
+        getReceipt(executionId) {
+            return http.fetchJson(`/invocations/${encodeURIComponent(executionId)}/receipt`);
+        },
+        cancelInvocation(executionId) {
+            return http.fetchJson(`/invocations/${encodeURIComponent(executionId)}/cancel`, {
+                method: 'POST',
+            });
+        },
+        submitJob(body, init = {}) {
+            return http.fetchJson('/jobs', {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        getJob(jobId) {
+            return http.fetchJsonWithRetry(`/jobs/${encodeURIComponent(jobId)}`);
+        },
+        getJobResult(jobId) {
+            return http.fetchJson(`/jobs/${encodeURIComponent(jobId)}/result`);
+        },
+        getCapabilities() {
+            return http.fetchJson('/capabilities');
+        },
+        describeCapability(key) {
+            return http.fetchJson(`/capabilities/${encodeURIComponent(key)}`);
+        },
+        invokeCapability(key, body, init = {}) {
+            return http.fetchJson(`/capabilities/${encodeURIComponent(key)}/invoke`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        submitCapabilityJob(key, body, init = {}) {
+            return http.fetchJson(`/capabilities/${encodeURIComponent(key)}/jobs`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+                ...init,
+            });
+        },
+        getJobReceipt(jobId) {
+            return http.fetchJson(`/jobs/${encodeURIComponent(jobId)}/receipt`);
+        },
+        cancelJob(jobId) {
+            return http.fetchJson(`/jobs/${encodeURIComponent(jobId)}/cancel`, { method: 'POST' });
+        },
+        streamInvocationEvents(executionId, options = {}) {
+            const token = http.options.getToken?.() ?? http.options.token ?? '';
+            const sseOptions = {};
+            if (options.lastEventId !== undefined)
+                sseOptions.lastEventId = options.lastEventId;
+            if (options.signal !== undefined)
+                sseOptions.signal = options.signal;
+            if (http.options.pathsAreV1Relative !== undefined) {
+                sseOptions.pathsAreV1Relative = http.options.pathsAreV1Relative;
+            }
+            if (http.options.credentials !== undefined)
+                sseOptions.credentials = http.options.credentials;
+            if (http.options.fetchImpl !== undefined)
+                sseOptions.fetchImpl = http.options.fetchImpl;
+            return iterInvocationEvents(http.options.baseUrl, token, executionId, sseOptions);
+        },
+    };
+}

package/dist/sse.d.ts

@@ -0,0 +1,14 @@
+import type { HydraceptRuntimeEvent } from './types.js';
+/**
+ * Maintained SSE helper for Hydracept invocation events.
+ * Ordinary REST clients should prefer createHydraceptHttp / OpenAPI-generated types.
+ */
+export declare function iterInvocationEvents(baseUrl: string, token: string, executionId: string, options?: {
+    lastEventId?: string;
+    signal?: AbortSignal;
+    /** When true, baseUrl already points at /v1 (or a proxy that strips it). */
+    pathsAreV1Relative?: boolean;
+    fetchImpl?: typeof fetch;
+    credentials?: RequestCredentials;
+}): AsyncGenerator<HydraceptRuntimeEvent, void, unknown>;
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD;;;GAGG;AACH,wBAAuB,oBAAoB,CACzC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAC7B,GACL,cAAc,CAAC,qBAAqB,EAAE,IAAI,EAAE,OAAO,CAAC,CAyDtD"}

package/dist/sse.js

@@ -0,0 +1,65 @@
+/**
+ * Maintained SSE helper for Hydracept invocation events.
+ * Ordinary REST clients should prefer createHydraceptHttp / OpenAPI-generated types.
+ */
+export async function* iterInvocationEvents(baseUrl, token, executionId, options = {}) {
+    const headers = {
+        Authorization: `Bearer ${token}`,
+        Accept: 'text/event-stream',
+    };
+    if (options.lastEventId) {
+        headers['Last-Event-ID'] = options.lastEventId;
+    }
+    const root = baseUrl.replace(/\/$/, '');
+    const path = options.pathsAreV1Relative
+        ? `/invocations/${encodeURIComponent(executionId)}/events`
+        : `/v1/invocations/${encodeURIComponent(executionId)}/events`;
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const response = await fetchImpl(`${root}${path}`, {
+        headers,
+        credentials: options.credentials ?? 'omit',
+        ...(options.signal ? { signal: options.signal } : {}),
+    });
+    if (!response.ok || !response.body) {
+        throw new Error(`SSE failed: ${response.status}`);
+    }
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    let eventName = 'message';
+    let dataLines = [];
+    let eventId;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const parts = buffer.split('\n');
+        buffer = parts.pop() ?? '';
+        for (const line of parts) {
+            if (line === '') {
+                if (dataLines.length) {
+                    const payload = {
+                        event: eventName,
+                        data: JSON.parse(dataLines.join('\n')),
+                    };
+                    if (eventId !== undefined)
+                        payload.id = eventId;
+                    yield payload;
+                }
+                eventName = 'message';
+                dataLines = [];
+                eventId = undefined;
+                continue;
+            }
+            if (line.startsWith(':'))
+                continue;
+            if (line.startsWith('id:'))
+                eventId = line.slice(3).trim();
+            else if (line.startsWith('event:'))
+                eventName = line.slice(6).trim();
+            else if (line.startsWith('data:'))
+                dataLines.push(line.slice(5).trimStart());
+        }
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export type HydraceptRuntimeEvent = {
+    id?: string;
+    event: string;
+    data: unknown;
+};
+export type HydraceptClientOptions = {
+    /** Hydracept API origin (https://api.hydracept.com or http://localhost:8080). */
+    baseUrl: string;
+    /** Static bearer token, or omit and supply getToken. */
+    token?: string;
+    getToken?: () => string;
+    /** fetch credentials mode. Prefer 'omit' for browser API calls. */
+    credentials?: RequestCredentials;
+    /** When true, paths already include /v1 (or proxy strips it). */
+    pathsAreV1Relative?: boolean;
+    fetchImpl?: typeof fetch;
+};
+export type HydraceptHttpError = Error & {
+    status?: number;
+    body?: string;
+};
+export type HydraceptAssetOut = {
+    readonly id: string;
+    readonly logicalKey: string;
+    readonly [key: string]: unknown;
+};
+export type HydraceptAssetPage = {
+    readonly items?: readonly HydraceptAssetOut[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,mEAAmE;IACnE,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@hydracept/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript client for the Hydracept public API — AI execution infrastructure for games.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "homepage": "https://hydracept.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hydracept/hydracept"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.2"
+  }
+}