@hydracept/sdk 0.3.1 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.3.3 — 2026-08-26
+
+- Public product shape: `run`, `context`, `doctor --fix`, `jobs recover`, `funding`
+- `hydracept.run-result.v1` façade across CLI / SDK / MCP
+- Server-authoritative `maxCost` admission; `FundingRequired` machine error
+
+## 0.3.2 — 2026-08-26
+
+- Ship with the 0.3.2 public-install constellation (receipt `pricing.charge`, first-success smoke)
+
 ## 0.3.1 — 2026-08-26
 
 - Job downloads compare receipt SHA-256 as hex (`sha256:<hex>` prefix is stripped)

package/README.md

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

package/dist/index.d.ts

@@ -25,4 +25,6 @@ export declare function createHydraceptClient(options: HydraceptClientOptions):
 export { HydraceptWorkspace } from './workspace.js';
 export { createHydraceptJobRunner } from './jobs.js';
 export type { HydraceptJobRunner, HydraceptJobRunResult } from './jobs.js';
+export type { HydraceptRunResult, HydraceptRunArtifact, HydraceptRunPricing, HydraceptRunOptions, } from './run-result.js';
+export { pricingFromJob } from './run-result.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;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"}
+{"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;AAC3E,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -18,3 +18,4 @@ export function createHydraceptClient(options) {
 }
 export { HydraceptWorkspace } from './workspace.js';
 export { createHydraceptJobRunner } from './jobs.js';
+export { pricingFromJob } from './run-result.js';

package/dist/jobs.d.ts

@@ -14,6 +14,7 @@ export type HydraceptJobRunResult = {
 export type HydraceptJobRunner = {
     run(capabilityKey: string, body: Record<string, unknown>, options?: {
         downloadDir?: string;
+        outputRoot?: string;
         pollMs?: number;
     }): Promise<HydraceptJobRunResult>;
 };

package/dist/jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAWF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,CACD,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAClD,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACnC,CAAC;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"}
+{"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,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACvE,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,CAoEpB"}

package/dist/jobs.js

@@ -71,14 +71,19 @@ export function createHydraceptJobRunner(client, binding) {
             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);
+            const dest = options.downloadDir ||
+                (options.outputRoot ? join(options.outputRoot, '.hydracept', 'output', jobId) : undefined);
+            const pollMs = options.pollMs ?? 120_000;
+            const deadline = Number.isFinite(pollMs) ? Date.now() + pollMs : Number.POSITIVE_INFINITY;
             let job = submitted;
             let status = String(submitted.status || 'queued');
-            while (Date.now() < deadline) {
+            while (true) {
                 job = (await client.runtime.getJob(jobId));
                 status = String(job.status || 'unknown');
                 if (['succeeded', 'failed', 'canceled', 'cancelled'].includes(status))
                     break;
+                if (Date.now() >= deadline)
+                    break;
                 await sleep(2000);
             }
             let receipt = null;
@@ -86,7 +91,7 @@ export function createHydraceptJobRunner(client, binding) {
                 receipt = (await client.runtime.getJobReceipt(jobId));
             }
             const downloads = [];
-            if (options.downloadDir && status === 'succeeded' && receipt) {
+            if (dest && status === 'succeeded' && receipt) {
                 const artifacts = receipt.artifacts || [];
                 for (const item of artifacts) {
                     const artifactId = String(item.artifactId || item.id || '');
@@ -103,7 +108,7 @@ export function createHydraceptJobRunner(client, binding) {
                         throw new Error(`SHA-256 mismatch for ${artifactId}`);
                     }
                     const filename = filenameForDownload(item, artifactId);
-                    const target = join(options.downloadDir, filename);
+                    const target = join(dest, filename);
                     mkdirSync(dirname(target), { recursive: true });
                     writeFileSync(target, bytes);
                     downloads.push(target);

package/dist/run-result.d.ts

@@ -0,0 +1,39 @@
+export type HydraceptRunArtifact = {
+    artifactId: string;
+    mediaType: string;
+    sha256?: string | null;
+    byteLength?: number | null;
+    remoteRef?: string | null;
+    localPath?: string | null;
+    verified: boolean;
+};
+export type HydraceptRunPricing = {
+    estimatedCost: number | null;
+    actualCost: number | null;
+    currency: string;
+};
+/** hydracept.run-result.v1 — semantic contract shared with Python/CLI/MCP. */
+export type HydraceptRunResult = {
+    schemaVersion: 'hydracept.run-result.v1';
+    capability: string;
+    jobId: string | null;
+    executionId: string | null;
+    status: string;
+    output?: unknown;
+    typedOutput?: unknown;
+    artifacts: HydraceptRunArtifact[];
+    pricing: HydraceptRunPricing;
+    receipt: Record<string, unknown> | null;
+    idempotencyKey: string | null;
+    error?: Record<string, unknown> | null;
+    diagnostics?: Record<string, unknown> | null;
+};
+export type HydraceptRunOptions = {
+    wait?: boolean;
+    timeoutMs?: number;
+    maxCostUsd?: number;
+    idempotencyKey?: string;
+    out?: string;
+};
+export declare function pricingFromJob(job: Record<string, unknown>, receipt: Record<string, unknown> | null | undefined): HydraceptRunPricing;
+//# sourceMappingURL=run-result.d.ts.map

package/dist/run-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-result.d.ts","sourceRoot":"","sources":["../src/run-result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,yBAAyB,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAQF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAClD,mBAAmB,CAqBrB"}

package/dist/run-result.js

@@ -0,0 +1,32 @@
+function asNumber(value) {
+    if (value == null || value === '')
+        return null;
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+export function pricingFromJob(job, receipt) {
+    let estimated = asNumber(job.estimatedCost);
+    let actual = asNumber(job.actualCost);
+    const status = String(job.status || '').toLowerCase();
+    if (receipt) {
+        const pricing = receipt.pricing || {};
+        const charge = (pricing.charge?.customerCharge ||
+            {});
+        const quote = (pricing.quote?.customerTotal ||
+            {});
+        if (estimated == null) {
+            const micros = asNumber(quote.amountMicros);
+            if (micros != null)
+                estimated = micros / 1_000_000;
+        }
+        const sealed = asNumber(charge.amountMicros);
+        if (sealed != null)
+            actual = sealed / 1_000_000;
+        else if (status !== 'succeeded')
+            actual = null;
+    }
+    else if (status !== 'succeeded' && status !== 'failed') {
+        actual = null;
+    }
+    return { estimatedCost: estimated, actualCost: actual, currency: 'USD' };
+}

package/dist/workspace.d.ts

@@ -13,5 +13,13 @@ export declare class HydraceptWorkspace {
     readonly binding: HydraceptWorkspaceBinding;
     private constructor();
     static open(root?: string): HydraceptWorkspace;
+    run(capabilityKey: string, body: Record<string, unknown>, options?: {
+        wait?: boolean;
+        timeoutMs?: number;
+        maxCostUsd?: number;
+        idempotencyKey?: string;
+        out?: string;
+    }): Promise<import('./run-result.js').HydraceptRunResult>;
+    private ensureExecutionProject;
 }
 //# sourceMappingURL=workspace.d.ts.map

package/dist/workspace.d.ts.map

@@ -1 +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"}
+{"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;AAGlD,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;IAsCxC,GAAG,CACP,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,GAAE;QACP,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,GAAG,CAAC,EAAE,MAAM,CAAC;KACT,GACL,OAAO,CAAC,OAAO,iBAAiB,EAAE,kBAAkB,CAAC;YAgE1C,sBAAsB;CAsCrC"}

package/dist/workspace.js

@@ -5,6 +5,7 @@ import { createHydraceptControlApi } from './control.js';
 import { createHydraceptPanelsApi } from './panels.js';
 import { createHydraceptRuntimeApi } from './runtime.js';
 import { createHydraceptJobRunner } from './jobs.js';
+import { pricingFromJob } from './run-result.js';
 export class HydraceptWorkspace {
     client;
     jobs;
@@ -51,4 +52,91 @@ export class HydraceptWorkspace {
         const jobs = createHydraceptJobRunner(client, binding);
         return new HydraceptWorkspace(projectRoot, binding, client, jobs);
     }
+    async run(capabilityKey, body, options = {}) {
+        await this.ensureExecutionProject();
+        const { randomUUID } = await import('node:crypto');
+        const key = options.idempotencyKey || `run-${randomUUID().replace(/-/g, '')}`;
+        let payload = { ...body };
+        if (!('input' in payload)
+            && !('context' in payload)
+            && !('execution' in payload)
+            && !('idempotencyKey' in payload)) {
+            payload = { input: payload };
+        }
+        payload.idempotencyKey = key;
+        if (options.maxCostUsd != null) {
+            const existing = payload.execution || {};
+            const constraints = {
+                ...(existing.executionConstraints || {}),
+                maxCostUsd: options.maxCostUsd,
+            };
+            payload.execution = { ...existing, executionConstraints: constraints };
+        }
+        if (options.wait === false) {
+            const submitted = (await this.client.runtime.submitCapabilityJob(capabilityKey, payload));
+            const jobId = String(submitted.jobId || submitted.id || '');
+            if (!jobId)
+                throw new Error('No jobId in submit response');
+            return {
+                schemaVersion: 'hydracept.run-result.v1',
+                capability: capabilityKey,
+                jobId,
+                executionId: jobId,
+                status: 'running',
+                artifacts: [],
+                pricing: pricingFromJob(submitted, null),
+                receipt: null,
+                idempotencyKey: key,
+            };
+        }
+        const result = await this.jobs.run(capabilityKey, payload, {
+            downloadDir: options.out,
+            outputRoot: options.out ? undefined : this.root,
+            pollMs: options.timeoutMs ?? Number.POSITIVE_INFINITY,
+        });
+        return {
+            schemaVersion: 'hydracept.run-result.v1',
+            capability: capabilityKey,
+            jobId: result.jobId,
+            executionId: result.jobId,
+            status: result.status,
+            artifacts: result.downloads.map((localPath) => ({
+                artifactId: '',
+                mediaType: 'application/octet-stream',
+                localPath,
+                verified: true,
+            })),
+            pricing: pricingFromJob(result.job, result.receipt),
+            receipt: result.receipt,
+            idempotencyKey: key,
+        };
+    }
+    async ensureExecutionProject() {
+        let token = '';
+        try {
+            const diag = (await this.client.http.fetchJson('/diagnostics/session'));
+            token = String(diag.tokenProjectId || diag.principalProjectId || diag.projectId || '').trim();
+        }
+        catch {
+            throw new Error('Cannot resolve an execution project — checkout and credential must match. Run python -m hydracept doctor --fix');
+        }
+        let home = '';
+        try {
+            const session = (await this.client.http.fetchJson('/session/context'));
+            home = String(session.project?.id || '').trim();
+        }
+        catch {
+            home = '';
+        }
+        const checkout = this.binding.projectId;
+        if (token && home && token === home && token !== checkout) {
+            token = '';
+        }
+        if (!token) {
+            throw new Error('Cannot resolve an execution project — checkout and credential must match. Run python -m hydracept doctor --fix');
+        }
+        if (token !== checkout) {
+            throw new Error(`Checkout project ${checkout} disagrees with credential project ${token}. Hydracept will not manufacture an execution project.`);
+        }
+    }
 }

package/package.json

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