@boxrouter/sdk 0.0.1-alpha.0 → 0.12.190

package/dist/types.gen.js

@@ -1,2 +1,3 @@
+"use strict";
 // This file is auto-generated by @hey-api/openapi-ts
-export {};
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/user-agent.d.ts

@@ -0,0 +1,2 @@
+export declare const userAgent = "boxrouter-typescript/0.12.190";
+export declare function appendUserAgentSuffix(value: string, suffix: string): string;

package/dist/user-agent.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userAgent = void 0;
+exports.appendUserAgentSuffix = appendUserAgentSuffix;
+const workflow_policy_gen_1 = require("./workflow-policy.gen");
+const version_gen_1 = require("./version.gen");
+exports.userAgent = `boxrouter-typescript/${version_gen_1.sdkVersion}`;
+function appendUserAgentSuffix(value, suffix) {
+    if (!suffix || (workflow_policy_gen_1.USER_AGENT_SUFFIX_REQUIRE_NON_SPACE && !suffix.trim()) || suffix.length > workflow_policy_gen_1.USER_AGENT_SUFFIX_MAX_CHARACTERS || /[^\x20-\x7e]/.test(suffix)) {
+        throw new TypeError(`User-Agent suffix must be 1–${workflow_policy_gen_1.USER_AGENT_SUFFIX_MAX_CHARACTERS} printable ASCII characters${workflow_policy_gen_1.USER_AGENT_SUFFIX_REQUIRE_NON_SPACE ? ' and include a non-space character' : ''}`);
+    }
+    if (value.endsWith(` ${suffix}`))
+        return value;
+    const result = `${value} ${suffix}`;
+    if (result.length > workflow_policy_gen_1.USER_AGENT_MAX_CHARACTERS)
+        throw new TypeError(`User-Agent must be at most ${workflow_policy_gen_1.USER_AGENT_MAX_CHARACTERS} characters`);
+    return result;
+}

package/dist/version.gen.d.ts

@@ -0,0 +1 @@
+export declare const sdkVersion = "0.12.190";

package/dist/version.gen.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sdkVersion = void 0;
+// SDK release version, independent of the pinned contract.
+exports.sdkVersion = "0.12.190";

package/dist/volumes.d.ts

@@ -0,0 +1,33 @@
+import type { BoxRouterApi } from './sdk.gen';
+import type { CreateVolume, Volume, VolumeFile, VolumesDeleteCheckpointData, VolumesGetCheckpointData, VolumesListData, VolumeCheckpoint, VolumeCheckpointPage, VolumePage } from './types.gen';
+import { type VolumeSaveArguments } from './creation.gen';
+import { type MutationOptions, type RequestOptions } from './sandboxes';
+import { type TransferProgress } from './transfer';
+export interface VolumeUploadOptions extends MutationOptions {
+    concurrency?: number;
+    progress?: TransferProgress;
+}
+type UploadSource = string | Blob | Uint8Array;
+/** Workspace-level persistent volumes and their immutable checkpoints. */
+export declare class VolumeResources {
+    private readonly api;
+    constructor(api: BoxRouterApi);
+    create(body: CreateVolume, options?: MutationOptions): Promise<Volume>;
+    list(options?: RequestOptions & NonNullable<VolumesListData['query']>): Promise<VolumePage>;
+    get(id: string, options?: RequestOptions): Promise<Volume>;
+    listCheckpoints(id: string, options?: RequestOptions): Promise<VolumeCheckpointPage>;
+    getCheckpoint(id: string, checkpoint: VolumesGetCheckpointData['path']['checkpoint'], options?: RequestOptions): Promise<VolumeCheckpoint>;
+    save(id: string, ...[body, options]: VolumeSaveArguments): Promise<VolumeCheckpoint>;
+    deleteCheckpoint(id: string, checkpoint: VolumesDeleteCheckpointData['path']['checkpoint'], options?: MutationOptions): Promise<void>;
+    release(id: string, options?: MutationOptions): Promise<void>;
+    /** Upload one file or every regular file in a local directory to the volume head. */
+    upload(id: string, source: UploadSource, path?: string, options?: VolumeUploadOptions): Promise<void>;
+    /** Download one file to disk, or return its stream; a trailing slash or empty path selects a prefix. */
+    download(id: string, path: string, destination?: string): Promise<ReadableStream<Uint8Array> | void>;
+    /** Iterate over every file in path order, following the API's opaque pagination cursor. */
+    listFiles(id: string, options?: {
+        prefix?: string;
+    }): AsyncGenerator<VolumeFile>;
+    delete(id: string, options?: MutationOptions): Promise<void>;
+}
+export {};

package/dist/volumes.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VolumeResources = void 0;
+const creation_gen_1 = require("./creation.gen");
+const sandboxes_1 = require("./sandboxes");
+const transfer_1 = require("./transfer");
+const MAX_PATH_BYTES = 1024;
+function operationMutationOptions(options, fileIndex, operation) {
+    const key = options.idempotencyKey;
+    if (key === undefined)
+        return (0, sandboxes_1.mutationOptions)(options);
+    const suffix = `:${fileIndex}:${operation}`;
+    return (0, sandboxes_1.mutationOptions)({ ...options, idempotencyKey: `${key.slice(0, 128 - suffix.length)}${suffix}` });
+}
+function validateVolumePath(path) {
+    if (path.length === 0 || path.startsWith('/') || path.includes('\0') ||
+        new TextEncoder().encode(path).byteLength > MAX_PATH_BYTES ||
+        path.split('/').some(segment => segment.length === 0 || segment === '.' || segment === '..')) {
+        throw new TypeError(`Invalid volume file path: ${JSON.stringify(path)}`);
+    }
+}
+function pathEscapes(root, target, relative, sep) {
+    const value = relative(root, target);
+    return value === '..' || value.startsWith(`..${sep}`) || value.startsWith(sep);
+}
+async function uploadEntries(source, targetPath) {
+    if (typeof source !== 'string') {
+        if (targetPath === undefined)
+            throw new TypeError('path is required when uploading a Blob or Uint8Array');
+        validateVolumePath(targetPath);
+        return [{ source, path: targetPath, size: source instanceof Blob ? source.size : source.byteLength }];
+    }
+    const fs = await import('node:fs/promises');
+    const paths = await import('node:path');
+    const info = await fs.stat(source);
+    if (info.isFile()) {
+        const target = targetPath ?? paths.basename(source);
+        validateVolumePath(target);
+        return [{ source, path: target, size: info.size }];
+    }
+    if (!info.isDirectory())
+        throw new TypeError('source must be a file, directory, Blob, or Uint8Array');
+    const rootName = paths.basename(paths.resolve(source));
+    const destinationRoot = (targetPath || rootName).replace(/\/+$/, '');
+    const entries = [];
+    const walk = async (directory) => {
+        const children = await fs.readdir(directory, { withFileTypes: true });
+        children.sort((left, right) => left.name.localeCompare(right.name));
+        for (const child of children) {
+            const absolute = paths.join(directory, child.name);
+            if (child.isDirectory()) {
+                await walk(absolute);
+            }
+            else if (child.isFile()) {
+                const relative = paths.relative(source, absolute).split(paths.sep).join('/');
+                const target = `${destinationRoot}/${relative}`;
+                validateVolumePath(target);
+                const file = await fs.stat(absolute);
+                entries.push({ source: absolute, path: target, size: file.size });
+            }
+            else if (child.isSymbolicLink()) {
+                const linked = await fs.stat(absolute);
+                if (linked.isFile()) {
+                    const relative = paths.relative(source, absolute).split(paths.sep).join('/');
+                    const target = `${destinationRoot}/${relative}`;
+                    validateVolumePath(target);
+                    entries.push({ source: absolute, path: target, size: linked.size });
+                }
+            }
+        }
+    };
+    await walk(source);
+    return entries;
+}
+async function uploadFile(api, id, entry, concurrency, options, fileIndex) {
+    const source = await (0, transfer_1.openSource)({ source: entry.source, size: entry.size }, options.signal);
+    try {
+        const session = await api.volumes.createUpload({ path: { volume_id: id }, body: { path: entry.path, size: entry.size },
+            ...operationMutationOptions(options, fileIndex, 'create') });
+        try {
+            // An Archil part PUT replaces the earlier copy of the part, so a part may be sent again.
+            const sent = await (0, transfer_1.sendParts)(source, session.parts, { concurrency, replayParts: true, label: 'Volume',
+                progress: options.progress, signal: options.signal });
+            // Volume completion needs every part's ETag; the engine itself does not.
+            const parts = sent.map(({ number, etag }) => {
+                if (!etag)
+                    throw new Error('Volume upload part response did not include an ETag');
+                return { number, etag };
+            });
+            await (0, transfer_1.retryCompletion)(key => api.volumes.completeUpload({ path: { volume_id: id, upload_id: session.id }, body: { parts },
+                ...(key === undefined ? operationMutationOptions(options, fileIndex, 'complete')
+                    : (0, sandboxes_1.mutationOptions)({ signal: options.signal, idempotencyKey: key })) }), options.signal);
+        }
+        catch (error) {
+            try {
+                await api.volumes.abortUpload({ path: { volume_id: id, upload_id: session.id },
+                    ...operationMutationOptions({ ...options, signal: undefined }, fileIndex, 'abort') });
+            }
+            catch {
+                // Preserve the failure that caused cleanup.
+            }
+            throw error;
+        }
+    }
+    finally {
+        await source.close();
+    }
+}
+/** Workspace-level persistent volumes and their immutable checkpoints. */
+class VolumeResources {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    async create(body, options = {}) {
+        return this.api.volumes.create({ body, ...(0, sandboxes_1.mutationOptions)(options) });
+    }
+    async list(options = {}) {
+        const { signal, ...query } = options;
+        return this.api.volumes.list({ query, signal });
+    }
+    async get(id, options = {}) {
+        return this.api.volumes.get({ path: { volume_id: id }, signal: options.signal });
+    }
+    async listCheckpoints(id, options = {}) {
+        return this.api.volumes.listCheckpoints({ path: { volume_id: id }, signal: options.signal });
+    }
+    async getCheckpoint(id, checkpoint, options = {}) {
+        return this.api.volumes.getCheckpoint({ path: { volume_id: id, checkpoint }, signal: options.signal });
+    }
+    async save(id, ...[body, options = {}]) {
+        return this.api.volumes.save({ path: { volume_id: id }, body: (0, creation_gen_1.volumeSaveBody)(body), ...(0, sandboxes_1.mutationOptions)(options) });
+    }
+    async deleteCheckpoint(id, checkpoint, options = {}) {
+        await this.api.volumes.deleteCheckpoint({ path: { volume_id: id, checkpoint }, ...(0, sandboxes_1.mutationOptions)(options) });
+    }
+    async release(id, options = {}) {
+        await this.api.volumes.release({ path: { volume_id: id }, ...(0, sandboxes_1.mutationOptions)(options) });
+    }
+    /** Upload one file or every regular file in a local directory to the volume head. */
+    async upload(id, source, path, options = {}) {
+        const entries = await uploadEntries(source, path);
+        const concurrency = options.concurrency ?? 4;
+        if (!Number.isInteger(concurrency) || concurrency < 1)
+            throw new TypeError('concurrency must be a positive integer');
+        for (const [index, entry] of entries.entries())
+            await uploadFile(this.api, id, entry, concurrency, options, index);
+    }
+    /** Download one file to disk, or return its stream; a trailing slash or empty path selects a prefix. */
+    async download(id, path, destination) {
+        const prefix = path === '' || path.endsWith('/');
+        if (!prefix)
+            validateVolumePath(path);
+        if (prefix && destination === undefined)
+            throw new TypeError('destination is required for a volume prefix download');
+        if (!prefix) {
+            const link = await this.api.volumes.createDownload({ path: { volume_id: id }, body: { path } });
+            if (destination === undefined)
+                return (0, transfer_1.downloadStream)(link, { label: 'Volume' });
+            await (0, transfer_1.downloadToFile)(link, destination, { label: 'Volume' });
+            return;
+        }
+        const fs = await import('node:fs/promises');
+        const paths = await import('node:path');
+        const root = paths.resolve(destination);
+        await fs.mkdir(root, { recursive: true });
+        const realRoot = await fs.realpath(root);
+        const prefixPath = path;
+        for await (const file of this.listFiles(id, { prefix: prefixPath })) {
+            const relative = prefixPath === '' ? file.path : file.path.startsWith(prefixPath) ? file.path.slice(prefixPath.length) : '';
+            if (relative === '')
+                throw new Error(`Volume file path is outside requested prefix: ${file.path}`);
+            validateVolumePath(relative);
+            const target = paths.resolve(realRoot, ...relative.split('/'));
+            if (pathEscapes(realRoot, target, paths.relative, paths.sep)) {
+                throw new Error(`Volume file path would escape destination: ${file.path}`);
+            }
+            const segments = relative.split('/');
+            let parent = realRoot;
+            for (const segment of segments.slice(0, -1)) {
+                parent = paths.join(parent, segment);
+                try {
+                    const info = await fs.lstat(parent);
+                    if (info.isSymbolicLink() || !info.isDirectory())
+                        throw new Error(`Volume destination is not a directory: ${parent}`);
+                }
+                catch (error) {
+                    if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT')
+                        await fs.mkdir(parent);
+                    else
+                        throw error;
+                }
+            }
+            const targetInfo = await fs.lstat(target).catch(error => {
+                if (error && typeof error === 'object' && 'code' in error && error.code === 'ENOENT')
+                    return undefined;
+                throw error;
+            });
+            if (targetInfo?.isSymbolicLink())
+                throw new Error(`Volume destination is a symbolic link: ${target}`);
+            const link = await this.api.volumes.createDownload({ path: { volume_id: id }, body: { path: file.path } });
+            await (0, transfer_1.downloadToFile)(link, target, { label: 'Volume' });
+        }
+    }
+    /** Iterate over every file in path order, following the API's opaque pagination cursor. */
+    async *listFiles(id, options = {}) {
+        let cursor;
+        do {
+            const page = await this.api.volumes.listFiles({ path: { volume_id: id }, query: {
+                    ...(options.prefix === undefined ? {} : { prefix: options.prefix }),
+                    ...(cursor === undefined ? {} : { cursor }),
+                } });
+            yield* page.data;
+            cursor = page.next_cursor ?? undefined;
+        } while (cursor !== undefined);
+    }
+    async delete(id, options = {}) {
+        await this.api.volumes.delete({ path: { volume_id: id }, ...(0, sandboxes_1.mutationOptions)(options) });
+    }
+}
+exports.VolumeResources = VolumeResources;

package/dist/waits.d.ts

@@ -0,0 +1,31 @@
+/** A wait the SDK owns was still pending when its bound ran out. The work continues on BoxRouter. */
+export declare class WaitTimeoutError extends Error {
+    /** The id to read for the current state: an operation, launch or image. */
+    readonly id: string;
+    constructor(id: string, message: string);
+}
+export interface WaitTiming {
+    intervalSeconds: number;
+    boundSeconds: number;
+}
+/**
+ * The clock and the declared timing every SDK-owned wait uses. Internal: tests replace these members to
+ * run waits without real sleeping; nothing here is exported from the package entry.
+ */
+export declare const waitHooks: {
+    /** Seconds on a monotonic clock. */
+    now: () => number;
+    sleep: (seconds: number) => Promise<void>;
+    /** The timing a wait runs with; the declared one in production. */
+    timing: (declared: WaitTiming) => WaitTiming;
+};
+/**
+ * Read again while the value is pending: if one more interval would pass the bound, reject with
+ * the timeout; otherwise sleep an interval and read. HTTP errors from `read` propagate unchanged.
+ */
+export declare function pollWhile<T>(first: T, options: {
+    pending: (value: T) => boolean;
+    read: () => Promise<T>;
+    timing: WaitTiming;
+    timeout: () => WaitTimeoutError;
+}): Promise<T>;

package/dist/waits.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitHooks = exports.WaitTimeoutError = void 0;
+exports.pollWhile = pollWhile;
+/** A wait the SDK owns was still pending when its bound ran out. The work continues on BoxRouter. */
+class WaitTimeoutError extends Error {
+    /** The id to read for the current state: an operation, launch or image. */
+    id;
+    constructor(id, message) {
+        super(message);
+        this.name = 'TimeoutError';
+        this.id = id;
+    }
+}
+exports.WaitTimeoutError = WaitTimeoutError;
+/**
+ * The clock and the declared timing every SDK-owned wait uses. Internal: tests replace these members to
+ * run waits without real sleeping; nothing here is exported from the package entry.
+ */
+exports.waitHooks = {
+    /** Seconds on a monotonic clock. */
+    now: () => performance.now() / 1000,
+    sleep: (seconds) => new Promise(resolve => setTimeout(resolve, seconds * 1000)),
+    /** The timing a wait runs with; the declared one in production. */
+    timing: (declared) => declared,
+};
+/**
+ * Read again while the value is pending: if one more interval would pass the bound, reject with
+ * the timeout; otherwise sleep an interval and read. HTTP errors from `read` propagate unchanged.
+ */
+async function pollWhile(first, options) {
+    const { intervalSeconds, boundSeconds } = exports.waitHooks.timing(options.timing);
+    const deadline = exports.waitHooks.now() + boundSeconds;
+    let value = first;
+    while (options.pending(value)) {
+        if (exports.waitHooks.now() + intervalSeconds > deadline)
+            throw options.timeout();
+        await exports.waitHooks.sleep(intervalSeconds);
+        value = await options.read();
+    }
+    return value;
+}

package/dist/workflow-policy.gen.d.ts

@@ -0,0 +1,41 @@
+export declare const TERMINAL_ROWS = 24;
+export declare const TERMINAL_COLS = 80;
+export declare const TERMINAL_SIZE_MINIMUM = 1;
+export declare const TERMINAL_SIZE_MAXIMUM = 1000;
+export declare const TERMINAL_OUTPUT_EVENT_TYPE = "output";
+export declare const TERMINAL_EXIT_EVENT_TYPE = "exit";
+export declare const TERMINAL_ERROR_EVENT_TYPE = "error";
+export declare const TERMINAL_EVENT_ID_FIELD = "id";
+export declare const TERMINAL_EVENT_ID_HEADER = "Last-Event-ID";
+export declare const TERMINAL_INPUT_BYTES = 65536;
+export declare const TERMINAL_INPUT_ERROR = "Terminal input must be bytes of at most 65536 bytes";
+export declare const USER_AGENT_SUFFIX_MAX_CHARACTERS = 256;
+export declare const USER_AGENT_MAX_CHARACTERS = 512;
+export declare const USER_AGENT_SUFFIX_REQUIRE_NON_SPACE = true;
+export declare const PROCESS_WAIT_POLL_INTERVAL_SECONDS = 0.25;
+export declare const PROCESS_WAIT_FIXED_RESULT_JSON = "{\"timed_out\":false,\"stdout_truncated\":false,\"stderr_truncated\":false,\"native_error\":null}";
+export declare const DEFAULT_MAX_RETRIES = 2;
+export declare const RETRY_WHEN = "safe";
+export declare const RETRY_BASE_DELAY_SECONDS = 0.5;
+export declare const RETRY_MAX_DELAY_SECONDS = 8;
+export declare const DEFAULT_BASE_URL = "https://api.boxrouter.ai/api/v1";
+export declare const LAUNCH_PENDING: string[];
+export declare const LAUNCH_POLL_INTERVAL_SECONDS = 1;
+export declare const LAUNCH_BOUND_SECONDS = 600;
+export declare const IMAGES_PREPARE_PENDING: string[];
+export declare const IMAGES_PREPARE_POLL_INTERVAL_SECONDS = 5;
+export declare const IMAGES_PREPARE_BOUND_SECONDS = 600;
+export declare const OPERATION_WAIT_PENDING: string[];
+export declare const OPERATION_WAIT_POLL_INTERVAL_SECONDS = 2;
+export declare const OPERATION_WAIT_BOUND_SECONDS = 120;
+export declare const LAUNCH_OPERATION_NOT_FOUND_GRACE_SECONDS = 5;
+export declare const LAUNCH_OPERATION_POLL_RETRY_INTERVAL_SECONDS = 0.25;
+export declare const LAUNCH_SOURCE_MANIFEST_PATH = "boxrouter.yaml";
+export declare const LAUNCH_SOURCE_DEFAULT_REF = "HEAD";
+export declare const LAUNCH_DEFAULT_SHELL_COMMAND = "sh";
+export declare const LAUNCH_CUSTOM_NAME_PATTERN = "^[a-z][a-z0-9-]{0,62}$";
+export declare const LAUNCH_INPUT_POLICY_JSON = "{\"secret_names\":{\"option\":\"secret_names\",\"flag\":\"secret\",\"format\":\"name\",\"declared_field\":\"legacy_secret_names\",\"extra_field\":\"additional_secret_refs\",\"reference_field\":\"secret_name\",\"help\":\"Declared legacy names use the existing resolver; other names select saved custom secrets.\"},\"provider\":{\"option\":\"provider\",\"flag\":\"provider\",\"format\":\"name\",\"request_path\":[\"overrides\",\"placement\",\"preferences\",\"only\"],\"help\":\"Pin the launch to one provider.\"},\"credential_delivery\":{\"option\":\"credential_delivery\",\"flag\":\"credential-delivery\",\"format\":\"enum\",\"schema\":\"CredentialDeliveryPolicy\",\"request_field\":\"credential_delivery\",\"help\":\"Choose whether environment fallback is allowed.\"},\"retry\":{\"condition\":\"legacySecretMissing\",\"error_code\":\"secret_missing\",\"name_source\":\"manifest.secrets\",\"exclude_referenced_names\":true}}";
+export declare const CREDENTIAL_DELIVERY_VALUES: string[];
+export declare const MAX_ERROR_BYTES = 65536;
+export declare const DEFAULT_EVENT_BYTES = 8388608;
+export declare const CLI_LAUNCH_INPUTS_JSON = "{\"secret_names\":{\"name\":\"secret\",\"allow_repeating\":true,\"help\":\"Declared legacy names use the existing resolver; other names select saved custom secrets.\",\"grammar\":\"name\"},\"provider\":{\"name\":\"provider\",\"grammar\":\"name\",\"help\":\"Pin the launch to one provider.\"},\"credential_delivery\":{\"name\":\"credential-delivery\",\"grammar\":\"enum\",\"values\":[\"prefer_native\",\"require_native\"],\"help\":\"Choose whether environment fallback is allowed.\"}}";

package/dist/workflow-policy.gen.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_LAUNCH_INPUTS_JSON = exports.DEFAULT_EVENT_BYTES = exports.MAX_ERROR_BYTES = exports.CREDENTIAL_DELIVERY_VALUES = exports.LAUNCH_INPUT_POLICY_JSON = exports.LAUNCH_CUSTOM_NAME_PATTERN = exports.LAUNCH_DEFAULT_SHELL_COMMAND = exports.LAUNCH_SOURCE_DEFAULT_REF = exports.LAUNCH_SOURCE_MANIFEST_PATH = exports.LAUNCH_OPERATION_POLL_RETRY_INTERVAL_SECONDS = exports.LAUNCH_OPERATION_NOT_FOUND_GRACE_SECONDS = exports.OPERATION_WAIT_BOUND_SECONDS = exports.OPERATION_WAIT_POLL_INTERVAL_SECONDS = exports.OPERATION_WAIT_PENDING = exports.IMAGES_PREPARE_BOUND_SECONDS = exports.IMAGES_PREPARE_POLL_INTERVAL_SECONDS = exports.IMAGES_PREPARE_PENDING = exports.LAUNCH_BOUND_SECONDS = exports.LAUNCH_POLL_INTERVAL_SECONDS = exports.LAUNCH_PENDING = exports.DEFAULT_BASE_URL = exports.RETRY_MAX_DELAY_SECONDS = exports.RETRY_BASE_DELAY_SECONDS = exports.RETRY_WHEN = exports.DEFAULT_MAX_RETRIES = exports.PROCESS_WAIT_FIXED_RESULT_JSON = exports.PROCESS_WAIT_POLL_INTERVAL_SECONDS = exports.USER_AGENT_SUFFIX_REQUIRE_NON_SPACE = exports.USER_AGENT_MAX_CHARACTERS = exports.USER_AGENT_SUFFIX_MAX_CHARACTERS = exports.TERMINAL_INPUT_ERROR = exports.TERMINAL_INPUT_BYTES = exports.TERMINAL_EVENT_ID_HEADER = exports.TERMINAL_EVENT_ID_FIELD = exports.TERMINAL_ERROR_EVENT_TYPE = exports.TERMINAL_EXIT_EVENT_TYPE = exports.TERMINAL_OUTPUT_EVENT_TYPE = exports.TERMINAL_SIZE_MAXIMUM = exports.TERMINAL_SIZE_MINIMUM = exports.TERMINAL_COLS = exports.TERMINAL_ROWS = void 0;
+// Generated from client-workflows.json and OpenAPI.
+exports.TERMINAL_ROWS = 24;
+exports.TERMINAL_COLS = 80;
+exports.TERMINAL_SIZE_MINIMUM = 1;
+exports.TERMINAL_SIZE_MAXIMUM = 1000;
+exports.TERMINAL_OUTPUT_EVENT_TYPE = "output";
+exports.TERMINAL_EXIT_EVENT_TYPE = "exit";
+exports.TERMINAL_ERROR_EVENT_TYPE = "error";
+exports.TERMINAL_EVENT_ID_FIELD = "id";
+exports.TERMINAL_EVENT_ID_HEADER = "Last-Event-ID";
+exports.TERMINAL_INPUT_BYTES = 65536;
+exports.TERMINAL_INPUT_ERROR = "Terminal input must be bytes of at most 65536 bytes";
+exports.USER_AGENT_SUFFIX_MAX_CHARACTERS = 256;
+exports.USER_AGENT_MAX_CHARACTERS = 512;
+exports.USER_AGENT_SUFFIX_REQUIRE_NON_SPACE = true;
+exports.PROCESS_WAIT_POLL_INTERVAL_SECONDS = 0.25;
+exports.PROCESS_WAIT_FIXED_RESULT_JSON = "{\"timed_out\":false,\"stdout_truncated\":false,\"stderr_truncated\":false,\"native_error\":null}";
+exports.DEFAULT_MAX_RETRIES = 2;
+exports.RETRY_WHEN = "safe";
+exports.RETRY_BASE_DELAY_SECONDS = 0.5;
+exports.RETRY_MAX_DELAY_SECONDS = 8;
+exports.DEFAULT_BASE_URL = "https://api.boxrouter.ai/api/v1";
+exports.LAUNCH_PENDING = ["queued", "running"];
+exports.LAUNCH_POLL_INTERVAL_SECONDS = 1;
+exports.LAUNCH_BOUND_SECONDS = 600;
+exports.IMAGES_PREPARE_PENDING = ["queued", "preparing"];
+exports.IMAGES_PREPARE_POLL_INTERVAL_SECONDS = 5;
+exports.IMAGES_PREPARE_BOUND_SECONDS = 600;
+exports.OPERATION_WAIT_PENDING = ["unknown"];
+exports.OPERATION_WAIT_POLL_INTERVAL_SECONDS = 2;
+exports.OPERATION_WAIT_BOUND_SECONDS = 120;
+exports.LAUNCH_OPERATION_NOT_FOUND_GRACE_SECONDS = 5;
+exports.LAUNCH_OPERATION_POLL_RETRY_INTERVAL_SECONDS = 0.25;
+exports.LAUNCH_SOURCE_MANIFEST_PATH = "boxrouter.yaml";
+exports.LAUNCH_SOURCE_DEFAULT_REF = "HEAD";
+exports.LAUNCH_DEFAULT_SHELL_COMMAND = "sh";
+exports.LAUNCH_CUSTOM_NAME_PATTERN = "^[a-z][a-z0-9-]{0,62}$";
+exports.LAUNCH_INPUT_POLICY_JSON = "{\"secret_names\":{\"option\":\"secret_names\",\"flag\":\"secret\",\"format\":\"name\",\"declared_field\":\"legacy_secret_names\",\"extra_field\":\"additional_secret_refs\",\"reference_field\":\"secret_name\",\"help\":\"Declared legacy names use the existing resolver; other names select saved custom secrets.\"},\"provider\":{\"option\":\"provider\",\"flag\":\"provider\",\"format\":\"name\",\"request_path\":[\"overrides\",\"placement\",\"preferences\",\"only\"],\"help\":\"Pin the launch to one provider.\"},\"credential_delivery\":{\"option\":\"credential_delivery\",\"flag\":\"credential-delivery\",\"format\":\"enum\",\"schema\":\"CredentialDeliveryPolicy\",\"request_field\":\"credential_delivery\",\"help\":\"Choose whether environment fallback is allowed.\"},\"retry\":{\"condition\":\"legacySecretMissing\",\"error_code\":\"secret_missing\",\"name_source\":\"manifest.secrets\",\"exclude_referenced_names\":true}}";
+exports.CREDENTIAL_DELIVERY_VALUES = ["prefer_native", "require_native"];
+exports.MAX_ERROR_BYTES = 65536;
+exports.DEFAULT_EVENT_BYTES = 8388608;
+exports.CLI_LAUNCH_INPUTS_JSON = "{\"secret_names\":{\"name\":\"secret\",\"allow_repeating\":true,\"help\":\"Declared legacy names use the existing resolver; other names select saved custom secrets.\",\"grammar\":\"name\"},\"provider\":{\"name\":\"provider\",\"grammar\":\"name\",\"help\":\"Pin the launch to one provider.\"},\"credential_delivery\":{\"name\":\"credential-delivery\",\"grammar\":\"enum\",\"values\":[\"prefer_native\",\"require_native\"],\"help\":\"Choose whether environment fallback is allowed.\"}}";

package/package.json

@@ -1,18 +1,15 @@
 {
   "name": "@boxrouter/sdk",
-  "version": "0.0.1-alpha.0",
-  "type": "module",
-  "description": "Early read-only BoxRouter provider discovery client",
+  "version": "0.12.190",
+  "description": "BoxRouter TypeScript SDK (alpha)",
   "license": "Apache-2.0",
-  "engines": {
-    "node": ">=22.18.0"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
+  "author": "BoxRouter, Inc.",
+  "homepage": "https://docs.boxrouter.ai/typescript",
+  "bugs": {
+    "email": "support@boxrouter.ai"
   },
+  "sideEffects": false,
+  "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
@@ -20,8 +17,121 @@
     "NOTICE",
     "README.md"
   ],
-  "publishConfig": {
-    "access": "public",
-    "tag": "alpha"
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./choices": {
+      "types": "./dist/routing-choices.gen.d.ts",
+      "default": "./dist/routing-choices.gen.js"
+    },
+    "./browser-session": {
+      "types": "./dist/browser-session/index.d.ts",
+      "default": "./dist/browser-session/index.js"
+    },
+    "./namespaces/agents": {
+      "types": "./dist/namespace-agents.d.mts",
+      "import": "./dist/namespace-agents.mjs"
+    },
+    "./namespaces/launches": {
+      "types": "./dist/namespace-launches.d.mts",
+      "import": "./dist/namespace-launches.mjs"
+    },
+    "./namespaces/launch_runs": {
+      "types": "./dist/namespace-launch_runs.d.mts",
+      "import": "./dist/namespace-launch_runs.mjs"
+    },
+    "./namespaces/github": {
+      "types": "./dist/namespace-github.d.mts",
+      "import": "./dist/namespace-github.mjs"
+    },
+    "./namespaces/actions": {
+      "types": "./dist/namespace-actions.d.mts",
+      "import": "./dist/namespace-actions.mjs"
+    },
+    "./namespaces/routing": {
+      "types": "./dist/namespace-routing.d.mts",
+      "import": "./dist/namespace-routing.mjs"
+    },
+    "./namespaces/operations": {
+      "types": "./dist/namespace-operations.d.mts",
+      "import": "./dist/namespace-operations.mjs"
+    },
+    "./namespaces/artifacts": {
+      "types": "./dist/namespace-artifacts.d.mts",
+      "import": "./dist/namespace-artifacts.mjs"
+    },
+    "./namespaces/images": {
+      "types": "./dist/namespace-images.d.mts",
+      "import": "./dist/namespace-images.mjs"
+    },
+    "./namespaces/processes": {
+      "types": "./dist/namespace-processes.d.mts",
+      "import": "./dist/namespace-processes.mjs"
+    },
+    "./namespaces/credits": {
+      "types": "./dist/namespace-credits.d.mts",
+      "import": "./dist/namespace-credits.mjs"
+    },
+    "./namespaces/spend_limits": {
+      "types": "./dist/namespace-spend_limits.d.mts",
+      "import": "./dist/namespace-spend_limits.mjs"
+    },
+    "./namespaces/usage": {
+      "types": "./dist/namespace-usage.d.mts",
+      "import": "./dist/namespace-usage.mjs"
+    },
+    "./namespaces/terminals": {
+      "types": "./dist/namespace-terminals.d.mts",
+      "import": "./dist/namespace-terminals.mjs"
+    },
+    "./namespaces/secrets": {
+      "types": "./dist/namespace-secrets.d.mts",
+      "import": "./dist/namespace-secrets.mjs"
+    },
+    "./namespaces/previews": {
+      "types": "./dist/namespace-previews.d.mts",
+      "import": "./dist/namespace-previews.mjs"
+    },
+    "./namespaces/sandboxes": {
+      "types": "./dist/namespace-sandboxes.d.mts",
+      "import": "./dist/namespace-sandboxes.mjs"
+    },
+    "./namespaces/provider_accounts": {
+      "types": "./dist/namespace-provider_accounts.d.mts",
+      "import": "./dist/namespace-provider_accounts.mjs"
+    },
+    "./namespaces/volumes": {
+      "types": "./dist/namespace-volumes.d.mts",
+      "import": "./dist/namespace-volumes.mjs"
+    },
+    "./namespaces/commands": {
+      "types": "./dist/namespace-commands.d.mts",
+      "import": "./dist/namespace-commands.mjs"
+    },
+    "./namespaces/files": {
+      "types": "./dist/namespace-files.d.mts",
+      "import": "./dist/namespace-files.mjs"
+    },
+    "./namespaces/pricing": {
+      "types": "./dist/namespace-pricing.d.mts",
+      "import": "./dist/namespace-pricing.mjs"
+    },
+    "./namespaces/providers": {
+      "types": "./dist/namespace-providers.d.mts",
+      "import": "./dist/namespace-providers.mjs"
+    }
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "dependencies": {
+    "eventsource-parser": "4.1.0",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "@opentelemetry/api": "1.9.1",
+    "lossless-json": "4.3.1",
+    "undici": "7.30.1"
   }
 }