@synsci/sdk 2.0.77 → 2.0.78-test.34095579610

package/dist/src/gen/core/queryKeySerializer.gen.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSON-friendly union that mirrors what Pinia Colada can hash.
+ */
+export type JsonValue = null | string | number | boolean | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+/**
+ * Replacer that converts non-JSON values (bigint, Date, etc.) to safe substitutes.
+ */
+export declare const queryKeyJsonReplacer: (_key: string, value: unknown) => {} | null | undefined;
+/**
+ * Safely stringifies a value and parses it back into a JsonValue.
+ */
+export declare const stringifyToJsonValue: (input: unknown) => JsonValue | undefined;
+/**
+ * Normalizes any accepted value into a JSON-friendly shape for query keys.
+ */
+export declare const serializeQueryKeyValue: (value: unknown) => JsonValue | undefined;

package/dist/src/gen/core/queryKeySerializer.gen.js

@@ -0,0 +1,93 @@
+// This file is auto-generated by @hey-api/openapi-ts
+/**
+ * Replacer that converts non-JSON values (bigint, Date, etc.) to safe substitutes.
+ */
+export const queryKeyJsonReplacer = (_key, value) => {
+    if (value === undefined || typeof value === "function" || typeof value === "symbol") {
+        return undefined;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    return value;
+};
+/**
+ * Safely stringifies a value and parses it back into a JsonValue.
+ */
+export const stringifyToJsonValue = (input) => {
+    try {
+        const json = JSON.stringify(input, queryKeyJsonReplacer);
+        if (json === undefined) {
+            return undefined;
+        }
+        return JSON.parse(json);
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Detects plain objects (including objects with a null prototype).
+ */
+const isPlainObject = (value) => {
+    if (value === null || typeof value !== "object") {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+};
+/**
+ * Turns URLSearchParams into a sorted JSON object for deterministic keys.
+ */
+const serializeSearchParams = (params) => {
+    const entries = Array.from(params.entries()).sort(([a], [b]) => a.localeCompare(b));
+    const result = {};
+    for (const [key, value] of entries) {
+        const existing = result[key];
+        if (existing === undefined) {
+            result[key] = value;
+            continue;
+        }
+        if (Array.isArray(existing)) {
+            ;
+            existing.push(value);
+        }
+        else {
+            result[key] = [existing, value];
+        }
+    }
+    return result;
+};
+/**
+ * Normalizes any accepted value into a JSON-friendly shape for query keys.
+ */
+export const serializeQueryKeyValue = (value) => {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (value === undefined || typeof value === "function" || typeof value === "symbol") {
+        return undefined;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (Array.isArray(value)) {
+        return stringifyToJsonValue(value);
+    }
+    if (typeof URLSearchParams !== "undefined" && value instanceof URLSearchParams) {
+        return serializeSearchParams(value);
+    }
+    if (isPlainObject(value)) {
+        return stringifyToJsonValue(value);
+    }
+    return undefined;
+};

package/dist/src/index.d.ts

@@ -6,6 +6,7 @@ export declare function createOpenScience(options?: ServerOptions): Promise<{
     client: import("./client.js").OpenScienceClient;
     server: {
         url: string;
-        close(): void;
+        pid: number;
+        close: () => Promise<void>;
     };
 }>;

package/dist/src/index.js

@@ -3,11 +3,14 @@ export * from "./server.js";
 export * from "./v2/runtime.js";
 import { createOpenScienceClient } from "./client.js";
 import { createOpenScienceServer } from "./server.js";
+import { serverClientOptions } from "./server-process.js";
 export async function createOpenScience(options) {
+    const connection = serverClientOptions(options);
     const server = await createOpenScienceServer({
         ...options,
     });
     const client = createOpenScienceClient({
+        ...connection,
         baseUrl: server.url,
     });
     return {

package/dist/src/server-process.d.ts

@@ -0,0 +1,36 @@
+export type ServerProcessOptions = {
+    /** The runtime is loopback-only. Other hostnames are rejected. */
+    hostname?: string;
+    port?: number;
+    signal?: AbortSignal;
+    /** Maximum time to start and pass the health check, in milliseconds. */
+    timeout?: number;
+    /** Grace period before an owned child is forcibly terminated. */
+    shutdownTimeout?: number;
+    executablePath?: string;
+    /** Arguments before `serve`, for example a Bun executable's source entrypoint. */
+    executableArgs?: string[];
+    cwd?: string;
+    /** Overrides inherited environment; undefined removes a variable. */
+    env?: Record<string, string | undefined>;
+};
+type Options = ServerProcessOptions & {
+    config?: {
+        logLevel?: string;
+    };
+};
+/** Snapshot the same connection scope and credential inherited by an owned child. */
+export declare function serverClientOptions(options?: ServerProcessOptions): {
+    directory: string;
+    headers: {
+        authorization: string;
+    } | undefined;
+};
+/** Own exactly the child started here. Connecting a client to an existing
+ * server uses createOpenScienceClient and never enters this lifecycle. */
+export declare function startServer(options?: Options): Promise<{
+    url: string;
+    pid: number;
+    close: () => Promise<void>;
+}>;
+export {};

package/dist/src/server-process.js

@@ -0,0 +1,199 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+/** Snapshot the same connection scope and credential inherited by an owned child. */
+export function serverClientOptions(options = {}) {
+    const env = { ...process.env, ...options.env };
+    const token = env.OPENSCIENCE_AUTH_TOKEN;
+    return {
+        directory: path.resolve(options.cwd ?? process.cwd()),
+        headers: token ? { authorization: `Bearer ${token}` } : undefined,
+    };
+}
+function localURL(value) {
+    const url = new URL(value);
+    if (url.protocol !== "http:" ||
+        !["localhost", "127.0.0.1", "[::1]"].includes(url.hostname) ||
+        url.username ||
+        url.password ||
+        url.pathname !== "/" ||
+        url.search ||
+        url.hash) {
+        throw new Error("OpenScience announced an invalid local server URL");
+    }
+    return url.origin;
+}
+/** Own exactly the child started here. Connecting a client to an existing
+ * server uses createOpenScienceClient and never enters this lifecycle. */
+export async function startServer(options = {}) {
+    options.signal?.throwIfAborted();
+    if (options.hostname && !["127.0.0.1", "localhost"].includes(options.hostname)) {
+        throw new Error("OpenScience servers can only bind to loopback");
+    }
+    const timeout = options.timeout ?? 5000;
+    const shutdown = options.shutdownTimeout ?? 10_000;
+    if (!Number.isFinite(timeout) || timeout <= 0 || !Number.isFinite(shutdown) || shutdown <= 0) {
+        throw new Error("Server startup and shutdown timeouts must be positive finite milliseconds");
+    }
+    const port = options.port ?? 4096;
+    if (!Number.isInteger(port) || port < 0 || port > 65535)
+        throw new Error("Invalid OpenScience server port");
+    const env = {
+        ...process.env,
+        ...options.env,
+        OPENSCIENCE_SERVER_READY_FORMAT: "json",
+    };
+    const args = [...(options.executableArgs ?? []), "serve", "--port", String(port)];
+    if (options.config?.logLevel)
+        args.push("--log-level", options.config.logLevel);
+    const proc = spawn(options.executablePath ?? "openscience", args, {
+        cwd: options.cwd,
+        env: {
+            ...env,
+            OPENSCIENCE_CONFIG_CONTENT: options.config === undefined ? (env.OPENSCIENCE_CONFIG_CONTENT ?? "{}") : JSON.stringify(options.config),
+        },
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    const state = {
+        exited: false,
+        announced: false,
+        buffer: "",
+        output: "",
+        closing: undefined,
+    };
+    const exited = new Promise((resolve) => {
+        proc.once("close", () => {
+            state.exited = true;
+            options.signal?.removeEventListener("abort", abort);
+            resolve();
+        });
+    });
+    const wait = async (duration) => {
+        const timer = { id: undefined };
+        try {
+            await Promise.race([
+                exited,
+                new Promise((resolve) => {
+                    timer.id = setTimeout(resolve, duration);
+                }),
+            ]);
+        }
+        finally {
+            if (timer.id)
+                clearTimeout(timer.id);
+        }
+    };
+    const close = () => {
+        state.closing ??= (async () => {
+            if (state.exited)
+                return;
+            proc.kill("SIGTERM");
+            await wait(shutdown);
+            if (state.exited)
+                return;
+            proc.kill("SIGKILL");
+            await wait(Math.max(1000, shutdown));
+            if (!state.exited)
+                throw new Error("OpenScience child did not exit after forced shutdown");
+        })();
+        return state.closing;
+    };
+    const controller = new AbortController();
+    const timer = { id: undefined };
+    const abort = () => controller.abort(options.signal?.reason);
+    options.signal?.addEventListener("abort", abort, { once: true });
+    if (options.signal?.aborted)
+        abort();
+    try {
+        const url = await new Promise((resolve, reject) => {
+            const fail = (error) => reject(error);
+            proc.on("error", fail);
+            controller.signal.addEventListener("abort", () => fail(controller.signal.reason), { once: true });
+            if (controller.signal.aborted)
+                return fail(controller.signal.reason);
+            timer.id = setTimeout(() => controller.abort(new Error(`Timeout waiting for server to start after ${timeout}ms`)), timeout);
+            proc.once("exit", (code, signal) => {
+                fail(new Error(`OpenScience server exited before becoming ready (${signal ?? code})${state.output ? `\n${state.output}` : ""}`));
+            });
+            const check = async (value) => {
+                const url = localURL(value);
+                const token = env.OPENSCIENCE_AUTH_TOKEN;
+                const response = await fetch(`${url}/global/health`, {
+                    signal: controller.signal,
+                    redirect: "error",
+                    headers: token ? { authorization: `Bearer ${token}` } : undefined,
+                });
+                const health = await response.json();
+                if (!response.ok ||
+                    !health ||
+                    typeof health !== "object" ||
+                    !("healthy" in health) ||
+                    health.healthy !== true ||
+                    !("version" in health) ||
+                    typeof health.version !== "string") {
+                    throw new Error("OpenScience server did not pass its health check");
+                }
+                return url;
+            };
+            proc.stdout.on("data", (chunk) => {
+                if (state.announced)
+                    return;
+                state.buffer += chunk.toString();
+                const lines = state.buffer.split("\n");
+                state.buffer = (lines.pop() ?? "").slice(-65_536);
+                for (const line of lines) {
+                    try {
+                        const value = (() => {
+                            if (line.startsWith("{")) {
+                                const value = JSON.parse(line);
+                                if (!value || typeof value !== "object" || !("type" in value) || value.type !== "server.ready")
+                                    return;
+                                if (!("schemaVersion" in value) ||
+                                    value.schemaVersion !== 1 ||
+                                    !("url" in value) ||
+                                    typeof value.url !== "string") {
+                                    throw new Error("Unsupported OpenScience server readiness record");
+                                }
+                                if (!("pid" in value) || value.pid !== proc.pid)
+                                    throw new Error("OpenScience server readiness process mismatch");
+                                return value.url;
+                            }
+                            // Older runtimes ignore the readiness environment option. Their
+                            // human announcement remains supported, followed by the same probe.
+                            return line.match(/^openscience server listening on\s+(https?:\/\/[^\s]+)/)?.[1];
+                        })();
+                        if (!value)
+                            continue;
+                        state.announced = true;
+                        void check(value).then(resolve, fail);
+                        break;
+                    }
+                    catch (error) {
+                        fail(error);
+                    }
+                }
+            });
+            proc.stderr.on("data", (chunk) => {
+                state.output = (state.output + chunk.toString()).slice(-8192);
+            });
+        });
+        // Abort continues to own shutdown after startup; attached clients have no
+        // corresponding child or signal hook.
+        controller.signal.addEventListener("abort", () => void close().catch(() => undefined), { once: true });
+        if (controller.signal.aborted) {
+            await close();
+            controller.signal.throwIfAborted();
+        }
+        return { url, pid: proc.pid, close };
+    }
+    catch (error) {
+        controller.abort(error);
+        await close().catch((cleanup) => {
+            throw new AggregateError([error, cleanup], "Server startup and cleanup failed");
+        });
+        throw error;
+    }
+    finally {
+        if (timer.id)
+            clearTimeout(timer.id);
+    }
+}

package/dist/src/server.d.ts

@@ -1,12 +1,10 @@
-import { type Config } from "./gen/types.gen.js";
-export type ServerOptions = {
-    hostname?: string;
-    port?: number;
-    signal?: AbortSignal;
-    timeout?: number;
+import type { Config } from "./gen/types.gen.js";
+import { type ServerProcessOptions } from "./server-process.js";
+export type ServerOptions = ServerProcessOptions & {
     config?: Config;
 };
 export declare function createOpenScienceServer(options?: ServerOptions): Promise<{
     url: string;
-    close(): void;
+    pid: number;
+    close: () => Promise<void>;
 }>;

package/dist/src/server.js

@@ -1,68 +1,4 @@
-import { spawn } from "node:child_process";
-export async function createOpenScienceServer(options) {
-    options = Object.assign({
-        hostname: "127.0.0.1",
-        port: 4096,
-        timeout: 5000,
-    }, options ?? {});
-    const args = [`serve`, `--port=${options.port}`];
-    if (options.config?.logLevel)
-        args.push(`--log-level=${options.config.logLevel}`);
-    const proc = spawn(`openscience`, args, {
-        signal: options.signal,
-        env: {
-            ...process.env,
-            OPENSCIENCE_CONFIG_CONTENT: JSON.stringify(options.config ?? {}),
-        },
-    });
-    const url = await new Promise((resolve, reject) => {
-        const id = setTimeout(() => {
-            reject(new Error(`Timeout waiting for server to start after ${options.timeout}ms`));
-        }, options.timeout);
-        let output = "";
-        proc.stdout?.on("data", (chunk) => {
-            output += chunk.toString();
-            const lines = output.split("\n");
-            for (const line of lines) {
-                if (line.startsWith("openscience server listening")) {
-                    const match = line.match(/on\s+(https?:\/\/[^\s]+)/);
-                    if (!match) {
-                        clearTimeout(id);
-                        reject(new Error(`Failed to parse server url from output: ${line}`));
-                        return;
-                    }
-                    clearTimeout(id);
-                    resolve(match[1]);
-                    return;
-                }
-            }
-        });
-        proc.stderr?.on("data", (chunk) => {
-            output += chunk.toString();
-        });
-        proc.on("exit", (code) => {
-            clearTimeout(id);
-            let msg = `Server exited with code ${code}`;
-            if (output.trim()) {
-                msg += `\nServer output: ${output}`;
-            }
-            reject(new Error(msg));
-        });
-        proc.on("error", (error) => {
-            clearTimeout(id);
-            reject(error);
-        });
-        if (options.signal) {
-            options.signal.addEventListener("abort", () => {
-                clearTimeout(id);
-                reject(new Error("Aborted"));
-            });
-        }
-    });
-    return {
-        url,
-        close() {
-            proc.kill();
-        },
-    };
+import { startServer } from "./server-process.js";
+export function createOpenScienceServer(options) {
+    return startServer(options);
 }

package/dist/src/v2/gen/sdk.gen.d.ts

@@ -1,5 +1,5 @@
 import { type Client, type Options as Options2, type TDataShape } from "./client/index.js";
-import type { AccountBalanceResponses, AccountBillingModeGetResponses, AccountBillingModeSetResponses, AccountDeviceRevokeResponses, AccountDevicesResponses, AccountFundingContextGetResponses, AccountFundingContextSetErrors, AccountFundingContextSetResponses, AccountGetResponses, AccountLoginBrowserResponses, AccountLoginKeyResponses, AccountLogoutResponses, AccountSessionResponses, AgentPartInput, ApiAuth, AppAgentsResponses, AppLogErrors, AppLogResponses, AppSkillDeleteResponses, AppSkillsResponses, AppSkillWriteResponses, Auth as Auth3, AuthOnboardingErrors, AuthOnboardingResponses, AuthRemoveErrors, AuthRemoveResponses, AuthSetErrors, AuthSetResponses, CommandListResponses, Config as Config4, ConfigGetResponses, ConfigProvidersResponses, ConfigUpdateErrors, ConfigUpdateResponses, ConversationPartInput, EventSubscribeResponse, EventSubscribeResponses, ExperimentalResourceListResponses, FileAnnotationsCreateResponses, FileAnnotationsDeleteResponses, FileAnnotationsHistoryResponses, FileAnnotationsListResponses, FileAnnotationsUpdateResponses, FileArtifactSaveErrors, FileArtifactSaveResponses, FileArtifactsResponses, FileArtifactStoreGetErrors, FileArtifactStoreGetResponses, FileArtifactStoreListResponses, FileArtifactStoreRawErrors, FileArtifactStoreRawResponses, FileArtifactStoreRenameErrors, FileArtifactStoreRenameResponses, FileArtifactStoreRestoreErrors, FileArtifactStoreRestoreResponses, FileArtifactStoreTrashErrors, FileArtifactStoreTrashResponses, FileInspectResponses, FileLineageResponses, FileListResponses, FileManifestResponses, FilePartInput, FilePartSource, FileProvenanceResponses, FilePublicationCapabilitiesResponses, FilePublicationErrors, FilePublicationResponses, FileRawErrors, FileRawResponses, FileReadErrors, FileReadResponses, FileRenameErrors, FileRenameResponses, FileReproducibilityResponses, FileResolveReferenceErrors, FileResolveReferenceResponses, FileReviewsCurrentErrors, FileReviewsCurrentResponses, FileReviewsFinalizeErrors, FileReviewsFinalizeResponses, FileReviewsHistoryErrors, FileReviewsHistoryResponses, FileReviewsResolveErrors, FileReviewsResolveResponses, FileReviewsRunErrors, FileReviewsRunResponses, FileStatusResponses, FileTrashCreateErrors, FileTrashCreateResponses, FileTrashListResponses, FileTrashPurgeErrors, FileTrashPurgeResponses, FileTrashRestoreErrors, FileTrashRestoreResponses, FileWriteErrors, FileWriteResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GlobalConfigGetResponses, GlobalConfigRawGetResponses, GlobalConfigRawSetErrors, GlobalConfigRawSetResponses, GlobalConfigUnsetErrors, GlobalConfigUnsetResponses, GlobalConfigUpdateErrors, GlobalConfigUpdateResponses, GlobalDisposeResponses, GlobalEventResponse, GlobalEventResponses, GlobalHealthResponses, GlobalProjectCreateErrors, GlobalProjectCreateResponses, InstanceDisposeResponses, KernelsCommandsResponses, KernelsCommandStopErrors, KernelsCommandStopResponses, KernelsComputeResponses, KernelsDeleteResponses, KernelsExecuteResponses, KernelsInterruptByIdResponses, KernelsInterruptResponses, KernelsListResponses, KernelsRestartByIdResponses, KernelsRestartResponses, KernelsStatusResponses, KernelsStopByIdResponses, KernelsStopResponses, LspStatusResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthCancelErrors, McpAuthCancelResponses, McpAuthPendingResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpAuthWaitErrors, McpAuthWaitResponses, McpConfigRemoveErrors, McpConfigRemoveResponses, McpConfigSetErrors, McpConfigSetResponses, McpConnectResponses, McpDisconnectResponses, McpInspectErrors, McpInspectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, NotebookCommandsResponses, NotebookCommandStopErrors, NotebookCommandStopResponses, NotebookComputeResponses, NotebookExecuteResponses, NotebookInterruptResponses, NotebookKernelDeleteResponses, NotebookKernelInterruptResponses, NotebookKernelRestartResponses, NotebookKernelsResponses, NotebookKernelStopResponses, NotebookRestartResponses, NotebookStatusResponses, NotebookStopResponses, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PathGetResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionRuleset, PermissionStandingListResponses, PermissionStandingRevokeResponses, PostSettingsLocalContextResponses, PostSettingsLocalModelsResponses, PostSettingsLocalResponses, PostSettingsLocalSshResponses, PostSettingsLocalStartResponses, ProjectAccessGetErrors, ProjectAccessGetResponses, ProjectAccessUpdateErrors, ProjectAccessUpdateResponses, ProjectCurrentResponses, ProjectExecutionErrors, ProjectExecutionResponses, ProjectListResponses, ProjectTrustGetErrors, ProjectTrustGetResponses, ProjectTrustUpdateErrors, ProjectTrustUpdateResponses, ProjectUpdateErrors, ProjectUpdateResponses, ProvenanceExecutionsResponses, ProvenanceExportResponses, ProvenanceListResponses, ProvenanceRecordErrors, ProvenanceRecordResponses, ProvenanceReviewsListResponses, ProvenanceTraceErrors, ProvenanceTraceResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, PutSettingsSandboxResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, ResearchEffort, RuntimePromptErrors, RuntimePromptResponses, RuntimeReplayErrors, RuntimeReplayResponses, RuntimeSubscribeResponse, RuntimeSubscribeResponses, SearchQueryResponses, SessionAbortErrors, SessionAbortResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionCreateErrors, SessionCreateResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffResponses, SessionFilesystemGrantErrors, SessionFilesystemGrantResponses, SessionFilesystemListErrors, SessionFilesystemListResponses, SessionFilesystemRevokeErrors, SessionFilesystemRevokeResponses, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionInitErrors, SessionInitResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionTraceErrors, SessionTraceResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUpdateErrors, SessionUpdateResponses, SettingsBillingGetResponses, SettingsBillingUpdateResponses, SettingsComputeEnvironmentsRepairResponses, SettingsComputeGetResponses, SettingsComputeJobsCancelErrors, SettingsComputeJobsCancelResponses, SettingsComputeJobsClearResponses, SettingsComputeJobsEventsErrors, SettingsComputeJobsEventsResponses, SettingsComputeJobsListResponses, SettingsComputeJobsLogErrors, SettingsComputeJobsLogResponses, SettingsComputeJobsPlanErrors, SettingsComputeJobsPlanResponses, SettingsComputeJobsReleaseErrors, SettingsComputeJobsReleaseResponses, SettingsComputeJobsRetryErrors, SettingsComputeJobsRetryResponses, SettingsComputeJobsStartErrors, SettingsComputeJobsStartResponses, SettingsComputeModalCheckErrors, SettingsComputeModalCheckResponses, SettingsComputeModalConfigureErrors, SettingsComputeModalConfigureResponses, SettingsComputeModalUpdateErrors, SettingsComputeModalUpdateResponses, SettingsComputeModalVolumeFileErrors, SettingsComputeModalVolumeFileResponses, SettingsComputeModalVolumeFilesErrors, SettingsComputeModalVolumeFilesResponses, SettingsComputeModalVolumesErrors, SettingsComputeModalVolumesResponses, SettingsComputeProviderConnectErrors, SettingsComputeProviderConnectResponses, SettingsComputeProviderDisconnectResponses, SettingsComputeProviderDoctorErrors, SettingsComputeProviderDoctorResponses, SettingsComputeProviderEnabledErrors, SettingsComputeProviderEnabledResponses, SettingsComputeSshAddErrors, SettingsComputeSshAddResponses, SettingsComputeSshRemoveResponses, SettingsComputeSshTestErrors, SettingsComputeSshTestResponses, SettingsComputeSshUpdateErrors, SettingsComputeSshUpdateResponses, SettingsCredentialsListResponses, SettingsCredentialsRemoveResponses, SettingsCredentialsSetResponses, SettingsNetworkGetResponses, SettingsNetworkSetResponses, SettingsPreferencesClearOnboardingOperationResponses, SettingsPreferencesGetResponses, SettingsPreferencesOnboardingOperationResponses, SettingsPreferencesUpdateResponses, SettingsScientificToolSetupErrors, SettingsScientificToolSetupResponses, SettingsScientificToolsResponses, SettingsSkillsInstallErrors, SettingsSkillsInstallResponses, SettingsStorageClearCacheResponses, SettingsStorageRelocateErrors, SettingsStorageRelocateResponses, SettingsStorageResetLocationErrors, SettingsStorageResetLocationResponses, SettingsStorageUsageResponses, SettingsUpdatesApplyErrors, SettingsUpdatesApplyResponses, SettingsUpdatesCancelResponses, SettingsUpdatesCheckResponses, SettingsUpdatesDisposeErrors, SettingsUpdatesDisposeResponses, SettingsUpdatesInstallErrors, SettingsUpdatesInstallResponses, SettingsUpdatesStageResponses, SettingsUpdatesStateResponses, SettingsWalletGetResponses, SubtaskPartInput, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, VcsGetResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses, WorktreeRemoveErrors, WorktreeRemoveInput, WorktreeRemoveResponses, WorktreeResetErrors, WorktreeResetInput, WorktreeResetResponses } from "./types.gen.js";
+import type { AccountBalanceResponses, AccountBillingModeGetResponses, AccountBillingModeSetResponses, AccountDeviceRevokeResponses, AccountDevicesResponses, AccountFundingContextGetResponses, AccountFundingContextSetErrors, AccountFundingContextSetResponses, AccountGetResponses, AccountLoginBrowserResponses, AccountLoginKeyResponses, AccountLogoutResponses, AccountSessionResponses, AgentPartInput, ApiAuth, AppAgentsResponses, AppLogErrors, AppLogResponses, AppSkillDeleteResponses, AppSkillsResponses, AppSkillWriteResponses, Auth as Auth3, AuthOnboardingErrors, AuthOnboardingResponses, AuthRemoveErrors, AuthRemoveResponses, AuthSetErrors, AuthSetResponses, CommandListResponses, Config as Config4, ConfigGetResponses, ConfigProvidersResponses, ConfigUpdateErrors, ConfigUpdateResponses, ConversationPartInput, EventSubscribeResponse, EventSubscribeResponses, ExperimentalResourceListResponses, FileAnnotationsCreateResponses, FileAnnotationsDeleteResponses, FileAnnotationsHistoryResponses, FileAnnotationsListResponses, FileAnnotationsUpdateResponses, FileArtifactSaveErrors, FileArtifactSaveResponses, FileArtifactsResponses, FileArtifactStoreGetErrors, FileArtifactStoreGetResponses, FileArtifactStoreListResponses, FileArtifactStoreRawErrors, FileArtifactStoreRawResponses, FileArtifactStoreRenameErrors, FileArtifactStoreRenameResponses, FileArtifactStoreRestoreErrors, FileArtifactStoreRestoreResponses, FileArtifactStoreTrashErrors, FileArtifactStoreTrashResponses, FileInspectResponses, FileLineageResponses, FileListResponses, FileManifestResponses, FilePartInput, FilePartSource, FileProvenanceResponses, FilePublicationCapabilitiesResponses, FilePublicationErrors, FilePublicationResponses, FileRawErrors, FileRawResponses, FileReadErrors, FileReadResponses, FileRenameErrors, FileRenameResponses, FileReproducibilityResponses, FileResolveReferenceErrors, FileResolveReferenceResponses, FileReviewsCurrentErrors, FileReviewsCurrentResponses, FileReviewsFinalizeErrors, FileReviewsFinalizeResponses, FileReviewsHistoryErrors, FileReviewsHistoryResponses, FileReviewsResolveErrors, FileReviewsResolveResponses, FileReviewsRunErrors, FileReviewsRunResponses, FileStatusResponses, FileTrashCreateErrors, FileTrashCreateResponses, FileTrashListResponses, FileTrashPurgeErrors, FileTrashPurgeResponses, FileTrashRestoreErrors, FileTrashRestoreResponses, FileWriteErrors, FileWriteResponses, FindFilesResponses, FindSymbolsResponses, FindTextResponses, FormatterStatusResponses, GlobalConfigGetResponses, GlobalConfigRawGetResponses, GlobalConfigRawSetErrors, GlobalConfigRawSetResponses, GlobalConfigUnsetErrors, GlobalConfigUnsetResponses, GlobalConfigUpdateErrors, GlobalConfigUpdateResponses, GlobalDisposeResponses, GlobalEventResponse, GlobalEventResponses, GlobalHealthResponses, GlobalProjectCreateErrors, GlobalProjectCreateResponses, InstanceDisposeResponses, KernelsCommandsResponses, KernelsCommandStopErrors, KernelsCommandStopResponses, KernelsComputeResponses, KernelsDeleteResponses, KernelsExecuteResponses, KernelsInterruptByIdResponses, KernelsInterruptResponses, KernelsListResponses, KernelsRestartByIdResponses, KernelsRestartResponses, KernelsStatusResponses, KernelsStopByIdResponses, KernelsStopResponses, LspStatusResponses, McpAddErrors, McpAddResponses, McpAuthAuthenticateErrors, McpAuthAuthenticateResponses, McpAuthCallbackErrors, McpAuthCallbackResponses, McpAuthCancelErrors, McpAuthCancelResponses, McpAuthPendingResponses, McpAuthRemoveErrors, McpAuthRemoveResponses, McpAuthStartErrors, McpAuthStartResponses, McpAuthWaitErrors, McpAuthWaitResponses, McpConfigRemoveErrors, McpConfigRemoveResponses, McpConfigSetErrors, McpConfigSetResponses, McpConnectResponses, McpDisconnectResponses, McpInspectErrors, McpInspectResponses, McpLocalConfig, McpRemoteConfig, McpStatusResponses, NotebookCommandsResponses, NotebookCommandStopErrors, NotebookCommandStopResponses, NotebookComputeResponses, NotebookExecuteResponses, NotebookInterruptResponses, NotebookKernelDeleteResponses, NotebookKernelInterruptResponses, NotebookKernelRestartResponses, NotebookKernelsResponses, NotebookKernelStopResponses, NotebookRestartResponses, NotebookStatusResponses, NotebookStopResponses, Part as Part2, PartDeleteErrors, PartDeleteResponses, PartUpdateErrors, PartUpdateResponses, PathGetResponses, PermissionListResponses, PermissionReplyErrors, PermissionReplyResponses, PermissionRespondErrors, PermissionRespondResponses, PermissionRuleset, PermissionStandingListResponses, PermissionStandingRevokeResponses, PostSettingsLocalContextResponses, PostSettingsLocalModelsResponses, PostSettingsLocalResponses, PostSettingsLocalSshResponses, PostSettingsLocalStartResponses, ProjectAccessGetErrors, ProjectAccessGetResponses, ProjectAccessUpdateErrors, ProjectAccessUpdateResponses, ProjectCurrentResponses, ProjectExecutionErrors, ProjectExecutionResponses, ProjectListResponses, ProjectTrustGetErrors, ProjectTrustGetResponses, ProjectTrustUpdateErrors, ProjectTrustUpdateResponses, ProjectUpdateErrors, ProjectUpdateResponses, ProvenanceExecutionsResponses, ProvenanceExportResponses, ProvenanceListResponses, ProvenanceRecordErrors, ProvenanceRecordResponses, ProvenanceReviewsListResponses, ProvenanceTraceErrors, ProvenanceTraceResponses, ProviderAuthResponses, ProviderListResponses, ProviderOauthAuthorizeErrors, ProviderOauthAuthorizeResponses, ProviderOauthCallbackErrors, ProviderOauthCallbackResponses, PtyConnectErrors, PtyConnectResponses, PtyCreateErrors, PtyCreateResponses, PtyGetErrors, PtyGetResponses, PtyListResponses, PtyRemoveErrors, PtyRemoveResponses, PtyUpdateErrors, PtyUpdateResponses, PutSettingsSandboxResponses, QuestionAnswer, QuestionListResponses, QuestionRejectErrors, QuestionRejectResponses, QuestionReplyErrors, QuestionReplyResponses, ResearchEffort, RuntimeCancelErrors, RuntimeCancelResponses, RuntimeCapabilitiesResponses, RuntimeDecideErrors, RuntimeDecideResponses, RuntimeDecisionInput, RuntimeGetRunErrors, RuntimeGetRunResponses, RuntimePromptErrors, RuntimePromptResponses, RuntimeReplayErrors, RuntimeReplayResponses, RuntimeSnapshotErrors, RuntimeSnapshotResponses, RuntimeSubscribeResponse, RuntimeSubscribeResponses, SearchQueryResponses, SessionAbortErrors, SessionAbortResponses, SessionChildrenErrors, SessionChildrenResponses, SessionCommandErrors, SessionCommandResponses, SessionCreateErrors, SessionCreateResponses, SessionDeleteErrors, SessionDeleteResponses, SessionDiffResponses, SessionFilesystemGrantErrors, SessionFilesystemGrantResponses, SessionFilesystemListErrors, SessionFilesystemListResponses, SessionFilesystemRevokeErrors, SessionFilesystemRevokeResponses, SessionForkResponses, SessionGetErrors, SessionGetResponses, SessionInitErrors, SessionInitResponses, SessionListResponses, SessionMessageErrors, SessionMessageResponses, SessionMessagesErrors, SessionMessagesResponses, SessionPromptAsyncErrors, SessionPromptAsyncResponses, SessionPromptErrors, SessionPromptResponses, SessionRevertErrors, SessionRevertResponses, SessionShellErrors, SessionShellResponses, SessionStatusErrors, SessionStatusResponses, SessionSummarizeErrors, SessionSummarizeResponses, SessionTodoErrors, SessionTodoResponses, SessionTraceErrors, SessionTraceResponses, SessionUnrevertErrors, SessionUnrevertResponses, SessionUpdateErrors, SessionUpdateResponses, SettingsBillingGetResponses, SettingsBillingUpdateResponses, SettingsComputeEnvironmentsRepairResponses, SettingsComputeGetResponses, SettingsComputeJobsCancelErrors, SettingsComputeJobsCancelResponses, SettingsComputeJobsClearResponses, SettingsComputeJobsEventsErrors, SettingsComputeJobsEventsResponses, SettingsComputeJobsListResponses, SettingsComputeJobsLogErrors, SettingsComputeJobsLogResponses, SettingsComputeJobsPlanErrors, SettingsComputeJobsPlanResponses, SettingsComputeJobsReleaseErrors, SettingsComputeJobsReleaseResponses, SettingsComputeJobsRetryErrors, SettingsComputeJobsRetryResponses, SettingsComputeJobsStartErrors, SettingsComputeJobsStartResponses, SettingsComputeModalCheckErrors, SettingsComputeModalCheckResponses, SettingsComputeModalConfigureErrors, SettingsComputeModalConfigureResponses, SettingsComputeModalUpdateErrors, SettingsComputeModalUpdateResponses, SettingsComputeModalVolumeFileErrors, SettingsComputeModalVolumeFileResponses, SettingsComputeModalVolumeFilesErrors, SettingsComputeModalVolumeFilesResponses, SettingsComputeModalVolumesErrors, SettingsComputeModalVolumesResponses, SettingsComputeProviderConnectErrors, SettingsComputeProviderConnectResponses, SettingsComputeProviderDisconnectResponses, SettingsComputeProviderDoctorErrors, SettingsComputeProviderDoctorResponses, SettingsComputeProviderEnabledErrors, SettingsComputeProviderEnabledResponses, SettingsComputeSshAddErrors, SettingsComputeSshAddResponses, SettingsComputeSshRemoveResponses, SettingsComputeSshTestErrors, SettingsComputeSshTestResponses, SettingsComputeSshUpdateErrors, SettingsComputeSshUpdateResponses, SettingsCredentialsListResponses, SettingsCredentialsRemoveResponses, SettingsCredentialsSetResponses, SettingsNetworkGetResponses, SettingsNetworkSetResponses, SettingsPreferencesClearOnboardingOperationResponses, SettingsPreferencesGetResponses, SettingsPreferencesOnboardingOperationResponses, SettingsPreferencesUpdateResponses, SettingsScientificToolSetupErrors, SettingsScientificToolSetupResponses, SettingsScientificToolsResponses, SettingsSkillsInstallErrors, SettingsSkillsInstallResponses, SettingsStorageClearCacheResponses, SettingsStorageRelocateErrors, SettingsStorageRelocateResponses, SettingsStorageResetLocationErrors, SettingsStorageResetLocationResponses, SettingsStorageUsageResponses, SettingsUpdatesApplyErrors, SettingsUpdatesApplyResponses, SettingsUpdatesCancelResponses, SettingsUpdatesCheckResponses, SettingsUpdatesDisposeErrors, SettingsUpdatesDisposeResponses, SettingsUpdatesInstallErrors, SettingsUpdatesInstallResponses, SettingsUpdatesStageResponses, SettingsUpdatesStateResponses, SettingsWalletGetResponses, SubtaskPartInput, TextPartInput, ToolIdsErrors, ToolIdsResponses, ToolListErrors, ToolListResponses, VcsGetResponses, WorktreeCreateErrors, WorktreeCreateInput, WorktreeCreateResponses, WorktreeListResponses, WorktreeRemoveErrors, WorktreeRemoveInput, WorktreeRemoveResponses, WorktreeResetErrors, WorktreeResetInput, WorktreeResetResponses } from "./types.gen.js";
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean, TResponse = unknown> = Options2<TData, ThrowOnError, TResponse> & {
     /**
      * You can provide a client instance returned by `createClient()` instead of
@@ -1019,6 +1019,7 @@ export declare class Session extends HeyApiClient {
         parentID?: string;
         title?: string;
         permission?: PermissionRuleset;
+        workspace?: "isolated" | "project";
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<SessionCreateResponses, SessionCreateErrors, ThrowOnError, "fields">;
     /**
      * Get session status
@@ -1386,9 +1387,72 @@ export declare class Runtime extends HeyApiClient {
     prompt<ThrowOnError extends boolean = false>(parameters: {
         directory?: string;
         sessionID: string;
-        message: string;
+        messageID?: string;
+        model?: {
+            providerID: string;
+            modelID: string;
+        };
+        variant?: string;
+        tier?: string;
+        context?: number;
+        delegation?: boolean;
+        delegationSettings?: {
+            level?: "off" | "light" | "standard" | "high";
+            workerModel?: {
+                providerID: string;
+                modelID: string;
+            };
+            autonomy?: "interactive" | "balanced" | "autonomous";
+        };
+        requestID?: string;
+        message?: string;
+        parts?: Array<TextPartInput | FilePartInput | AgentPartInput | ConversationPartInput | SubtaskPartInput>;
         effort: "normal" | "ultra";
     }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<RuntimePromptResponses, RuntimePromptErrors, ThrowOnError, "fields">;
+    /**
+     * Cancel one research run
+     *
+     * Cancellation is scoped to the run ID. Repeating it cannot stop a later run. Running tools may need time to settle; read the run receipt for terminal state.
+     */
+    cancel<ThrowOnError extends boolean = false>(parameters: {
+        directory?: string;
+        sessionID: string;
+        runID: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<RuntimeCancelResponses, RuntimeCancelErrors, ThrowOnError, "fields">;
+    /**
+     * Resolve a pending runtime decision
+     *
+     * Retries of an identical decision return its stored receipt. A conflicting response is rejected. Only live requests on the connected runtime can be resolved; an indeterminate receipt requires inspecting current state rather than repeating the action.
+     */
+    decide<ThrowOnError extends boolean = false>(parameters?: {
+        directory?: string;
+        runtimeDecisionInput?: RuntimeDecisionInput;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<RuntimeDecideResponses, RuntimeDecideErrors, ThrowOnError, "fields">;
+    /**
+     * Get supported runtime protocol
+     */
+    capabilities<ThrowOnError extends boolean = false>(parameters?: {
+        directory?: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<RuntimeCapabilitiesResponses, unknown, ThrowOnError, "fields">;
+    /**
+     * Get a durable research run
+     *
+     * Returns the authoritative run receipt and terminal result reference, independently of event retention. A dead runtime is interrupted and never automatically retried.
+     */
+    getRun<ThrowOnError extends boolean = false>(parameters: {
+        directory?: string;
+        sessionID: string;
+        runID: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<RuntimeGetRunResponses, RuntimeGetRunErrors, ThrowOnError, "fields">;
+    /**
+     * Resynchronize a research session
+     *
+     * Returns durable run receipts, an event cursor and live pending decisions belonging to this server process. Replayed decision events are historical; only pending requests in a fresh snapshot are actionable.
+     */
+    snapshot<ThrowOnError extends boolean = false>(parameters: {
+        directory?: string;
+        sessionID: string;
+    }, options?: Options<never, ThrowOnError>): import("./client/types.gen.js").RequestResult<RuntimeSnapshotResponses, RuntimeSnapshotErrors, ThrowOnError, "fields">;
     /**
      * Replay research run events
      *