@tensorlakeai/tensorlake 0.5.159 → 0.5.161

package/dist/index.d.cts

@@ -2078,6 +2078,150 @@ declare class RepositoryClient {
     private tracedJson;
 }
 
+/** How far back to read instead of the current billing period. */
+type UsageLookback = "1d" | "7d" | "30d";
+interface UsageClientOptions {
+    /** Tensorlake API key. Defaults to `TENSORLAKE_API_KEY`. */
+    apiKey?: string;
+    /** Organization to read. Defaults to `TENSORLAKE_ORGANIZATION_ID`. */
+    organizationId?: string;
+    /** Cloud API URL. Defaults to `TENSORLAKE_API_URL`. */
+    apiUrl?: string;
+}
+interface UsageReadOptions {
+    /** Read the last `1d`, `7d` or `30d` instead of the current billing period. */
+    last?: UsageLookback;
+    /**
+     * Range start, as a `Date` or an RFC 3339 string. Can't be combined with
+     * `last`. The server serves ranges that start inside the current billing
+     * period or the last 30 days, whichever starts earlier.
+     */
+    fromDate?: Date | string;
+    /** Range end. Requires `fromDate`; defaults to now. */
+    toDate?: Date | string;
+}
+/** Metered usage, excluding subscription fees and tax. */
+interface UsageCharge {
+    currency: string;
+    amountMinor: string;
+    resources: {
+        cpuAmountMinor: string;
+        memoryAmountMinor: string;
+        sandboxStorageAmountMinor: string;
+        snapshotStorageAmountMinor: string;
+    };
+}
+/** Plan allowance consumption, valued at the overage rate. */
+interface IncludedUsage {
+    currency: string;
+    includedAmountMinor: string;
+    periodUsedAmountMinor: string;
+    rangeUsageAmountMinor: string;
+    periodStart: string;
+    periodEnd: string;
+}
+/** Organization usage totals for a window. */
+interface UsageSummary {
+    windowStart: string;
+    windowEnd: string;
+    computeUnits: string;
+    /**
+     * `null` when the organization has no metered price, and on plans with
+     * included usage (Pro, Enterprise) when the window is not inside the current
+     * billing period. Use `usageValue` then.
+     */
+    usageCharge: UsageCharge | null;
+    includedUsage: IncludedUsage | null;
+    /**
+     * Usage valued at the plan's overage rate, before included usage. Set for
+     * every window on plans with included usage, `null` otherwise.
+     */
+    usageValue: UsageCharge | null;
+    runningSandboxes: number;
+    projects: Array<{
+        projectId: string;
+        projectName: string;
+        computeUnits: string;
+    }>;
+}
+interface ResourceUsage {
+    quantity: string;
+    /** `vCPU-hour`, `GiB-hour` or `GiB`. */
+    unit: string;
+    attributedAmountMinor: string | null;
+    usageValueAmountMinor: string | null;
+}
+/** Usage of one sandbox and its share of the organization's usage charge. */
+interface SandboxUsage {
+    sandboxId: string;
+    /** `null` for usage whose project no longer exists. */
+    project: {
+        projectId: string;
+        projectName: string;
+    } | null;
+    attributedAmountMinor: string | null;
+    usageValueAmountMinor: string | null;
+    resources: {
+        cpu: ResourceUsage;
+        memory: ResourceUsage;
+        sandboxStorage: ResourceUsage;
+        snapshotStorage: ResourceUsage;
+        networkEgress: ResourceUsage;
+    };
+}
+/** A share of the organization's pooled usage charge. */
+interface AttributedUsageCharge {
+    currency: string;
+    amountMinor: string;
+    /** `invoice` for a finalized invoice, `current_price_estimate` otherwise. */
+    basis: "invoice" | "current_price_estimate" | "unknown";
+}
+/** Every sandbox of a window with its usage and attributed charge. */
+interface SandboxUsageExport {
+    windowStart: string;
+    windowEnd: string;
+    /**
+     * The organization's usage charge; the sandboxes' attributed amounts add up
+     * to it exactly. `null` when the organization has no metered price, and on
+     * plans with included usage when the window is not inside the current
+     * billing period.
+     */
+    attributedUsageCharge: AttributedUsageCharge | null;
+    includedUsage: IncludedUsage | null;
+    /**
+     * The organization's usage at the plan's overage rate; the sandboxes' usage
+     * values add up to it exactly. Set for every window on plans with included
+     * usage.
+     */
+    attributedUsageValue: {
+        currency: string;
+        amountMinor: string;
+    } | null;
+    sandboxes: SandboxUsage[];
+}
+/**
+ * Read an organization's sandbox usage and cost.
+ *
+ * Every read covers the current billing period, unless you set either `last`
+ * (`1d`, `7d` or `30d`) or a range with `fromDate` and an optional `toDate`.
+ * Requests, windows and response parsing are done
+ * by the Rust SDK, the same as for Python and the CLI.
+ */
+declare class UsageClient {
+    private readonly native;
+    constructor(options?: UsageClientOptions);
+    close(): void;
+    /** Organization usage totals for the window. */
+    summary(options?: UsageReadOptions): Promise<UsageSummary>;
+    /**
+     * Usage and attributed cost of every sandbox that ran in the window.
+     *
+     * The server computes the attribution once and returns every sandbox in one
+     * response.
+     */
+    sandboxes(options?: UsageReadOptions): Promise<SandboxUsageExport>;
+}
+
 /**
  * Build operations for CAS sandbox images.
  *
@@ -2847,4 +2991,4 @@ declare class RequestExecutionError extends Error {
     constructor(message: string, functionName?: string);
 }
 
-export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancellationOutcome, ImageBuildCancelledError, ImageBuildError, ImageBuildErrorCode, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildKind, ImageBuildNotFoundError, ImageBuildPhase, type ImageBuildResult, ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };
+export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, type AttributedUsageCharge, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancellationOutcome, ImageBuildCancelledError, ImageBuildError, ImageBuildErrorCode, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildKind, ImageBuildNotFoundError, ImageBuildPhase, type ImageBuildResult, ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type IncludedUsage, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type ResourceUsage, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, type SandboxUsage, type SandboxUsageExport, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, type UsageCharge, UsageClient, type UsageClientOptions, type UsageLookback, type UsageReadOptions, type UsageSummary, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };

package/dist/index.d.ts

@@ -2078,6 +2078,150 @@ declare class RepositoryClient {
     private tracedJson;
 }
 
+/** How far back to read instead of the current billing period. */
+type UsageLookback = "1d" | "7d" | "30d";
+interface UsageClientOptions {
+    /** Tensorlake API key. Defaults to `TENSORLAKE_API_KEY`. */
+    apiKey?: string;
+    /** Organization to read. Defaults to `TENSORLAKE_ORGANIZATION_ID`. */
+    organizationId?: string;
+    /** Cloud API URL. Defaults to `TENSORLAKE_API_URL`. */
+    apiUrl?: string;
+}
+interface UsageReadOptions {
+    /** Read the last `1d`, `7d` or `30d` instead of the current billing period. */
+    last?: UsageLookback;
+    /**
+     * Range start, as a `Date` or an RFC 3339 string. Can't be combined with
+     * `last`. The server serves ranges that start inside the current billing
+     * period or the last 30 days, whichever starts earlier.
+     */
+    fromDate?: Date | string;
+    /** Range end. Requires `fromDate`; defaults to now. */
+    toDate?: Date | string;
+}
+/** Metered usage, excluding subscription fees and tax. */
+interface UsageCharge {
+    currency: string;
+    amountMinor: string;
+    resources: {
+        cpuAmountMinor: string;
+        memoryAmountMinor: string;
+        sandboxStorageAmountMinor: string;
+        snapshotStorageAmountMinor: string;
+    };
+}
+/** Plan allowance consumption, valued at the overage rate. */
+interface IncludedUsage {
+    currency: string;
+    includedAmountMinor: string;
+    periodUsedAmountMinor: string;
+    rangeUsageAmountMinor: string;
+    periodStart: string;
+    periodEnd: string;
+}
+/** Organization usage totals for a window. */
+interface UsageSummary {
+    windowStart: string;
+    windowEnd: string;
+    computeUnits: string;
+    /**
+     * `null` when the organization has no metered price, and on plans with
+     * included usage (Pro, Enterprise) when the window is not inside the current
+     * billing period. Use `usageValue` then.
+     */
+    usageCharge: UsageCharge | null;
+    includedUsage: IncludedUsage | null;
+    /**
+     * Usage valued at the plan's overage rate, before included usage. Set for
+     * every window on plans with included usage, `null` otherwise.
+     */
+    usageValue: UsageCharge | null;
+    runningSandboxes: number;
+    projects: Array<{
+        projectId: string;
+        projectName: string;
+        computeUnits: string;
+    }>;
+}
+interface ResourceUsage {
+    quantity: string;
+    /** `vCPU-hour`, `GiB-hour` or `GiB`. */
+    unit: string;
+    attributedAmountMinor: string | null;
+    usageValueAmountMinor: string | null;
+}
+/** Usage of one sandbox and its share of the organization's usage charge. */
+interface SandboxUsage {
+    sandboxId: string;
+    /** `null` for usage whose project no longer exists. */
+    project: {
+        projectId: string;
+        projectName: string;
+    } | null;
+    attributedAmountMinor: string | null;
+    usageValueAmountMinor: string | null;
+    resources: {
+        cpu: ResourceUsage;
+        memory: ResourceUsage;
+        sandboxStorage: ResourceUsage;
+        snapshotStorage: ResourceUsage;
+        networkEgress: ResourceUsage;
+    };
+}
+/** A share of the organization's pooled usage charge. */
+interface AttributedUsageCharge {
+    currency: string;
+    amountMinor: string;
+    /** `invoice` for a finalized invoice, `current_price_estimate` otherwise. */
+    basis: "invoice" | "current_price_estimate" | "unknown";
+}
+/** Every sandbox of a window with its usage and attributed charge. */
+interface SandboxUsageExport {
+    windowStart: string;
+    windowEnd: string;
+    /**
+     * The organization's usage charge; the sandboxes' attributed amounts add up
+     * to it exactly. `null` when the organization has no metered price, and on
+     * plans with included usage when the window is not inside the current
+     * billing period.
+     */
+    attributedUsageCharge: AttributedUsageCharge | null;
+    includedUsage: IncludedUsage | null;
+    /**
+     * The organization's usage at the plan's overage rate; the sandboxes' usage
+     * values add up to it exactly. Set for every window on plans with included
+     * usage.
+     */
+    attributedUsageValue: {
+        currency: string;
+        amountMinor: string;
+    } | null;
+    sandboxes: SandboxUsage[];
+}
+/**
+ * Read an organization's sandbox usage and cost.
+ *
+ * Every read covers the current billing period, unless you set either `last`
+ * (`1d`, `7d` or `30d`) or a range with `fromDate` and an optional `toDate`.
+ * Requests, windows and response parsing are done
+ * by the Rust SDK, the same as for Python and the CLI.
+ */
+declare class UsageClient {
+    private readonly native;
+    constructor(options?: UsageClientOptions);
+    close(): void;
+    /** Organization usage totals for the window. */
+    summary(options?: UsageReadOptions): Promise<UsageSummary>;
+    /**
+     * Usage and attributed cost of every sandbox that ran in the window.
+     *
+     * The server computes the attribution once and returns every sandbox in one
+     * response.
+     */
+    sandboxes(options?: UsageReadOptions): Promise<SandboxUsageExport>;
+}
+
 /**
  * Build operations for CAS sandbox images.
  *
@@ -2847,4 +2991,4 @@ declare class RequestExecutionError extends Error {
     constructor(message: string, functionName?: string);
 }
 
-export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancellationOutcome, ImageBuildCancelledError, ImageBuildError, ImageBuildErrorCode, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildKind, ImageBuildNotFoundError, ImageBuildPhase, type ImageBuildResult, ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };
+export { ApplicationBuildContext, ApplicationBuildResponse, ApplicationManifest, ApplicationSummary, type ArchivedSandboxInfo, type AttachFileSystemOptions, type AttributedUsageCharge, BinaryPayload, type Branch, BuildInfo, BuildLogEntry, type CancelImageBuildOutcome, type CancelImageBuildSelector, type CheckpointOptions, type CheckpointType, type ClaimSandboxOptions, CliNotFoundError, CloudClient, CloudClientOptions, CommandExitReason, type CommandResult, type CommitJobError, type CommitJobReadBack, type CommitJobStatus, type ConflictPath, type ConflictTerm, type ConnectDesktopOptions, type ConnectOptions, type ContainerResourcesInfo, ContainerState, type CopiedSandboxResponse, type CopySandboxOptions, type CopySandboxResponse, type CreateAndConnectOptions, CreateApplicationBuildRequest, type CreatePoolOptions, type CreatePtyOptions, type CreatePtySessionOptions, type CreateSandboxOptions, type CreateSandboxPoolResponse, type CreateSandboxResponse, type CreateSnapshotResponse, type CreateTunnelOptions, type DaemonInfo, Desktop, type DesktopDoubleClickOptions, type DesktopPointerOptions, type DirectoryEntry, type FileEntry, FileNotFoundInFilesystemError, FileSystem, type FileSystemMount, Filesystem, FilesystemAPIError, FilesystemClient, type FilesystemClientOptions, FilesystemError, type FilesystemFileRead, type FilesystemInfo, FilesystemMount, FilesystemNotFoundError, type FilesystemReadOptions, type FilesystemSnapshot, type FilesystemSnapshotInfo, type FilesystemStatus, type FilesystemVersion, type GPUResources, type GetOrCreateOptions, type GetOrCreateOutcome, type GetSandboxLogsOptions, type GitCredential, type GitRef, type GitRepository, type GpuModel, type GpuRequest, type HealthResponse, Image, ImageBuildCancellationOutcome, ImageBuildCancelledError, ImageBuildError, ImageBuildErrorCode, type ImageBuildErrorDetails, type ImageBuildEvent, ImageBuildFailedError, ImageBuildHandle, ImageBuildInProgressError, type ImageBuildInfo, ImageBuildInterruptedError, ImageBuildKind, ImageBuildNotFoundError, ImageBuildPhase, type ImageBuildResult, ImageBuildStatus, ImageBuildTimeoutError, type ImageBuildWaitOptions, type IncludedUsage, type ListArchivedSandboxesOptions, type ListArchivedSandboxesResponse, type ListDirectoryResponse, type ManagedProcessExit, type ManagedProcessHealthStatus, type ManagedProcessInfo, type ManagedProcessStatus, type MergeConflict, type MergeConflictRecord, type MergeEntry, type MergeOptions, type MergeReport, type MergeStats, MountError, type MountStatus, type MouseButton, type NetworkConfig, NewSecret, type Operation, type OperationRef, type OutputEvent, OutputMode, type OutputResponse, PendingSandbox, type PendingSandboxRecord, type PoolContainerInfo, PoolInUseError, PoolNotFoundError, type ProcessHealthCheck, type ProcessHealthCheckType, type ProcessInfo, ProcessStatus, type ProcessUser, type ProcessUserSpec, Pty, type PtyConnectionOptions, type PtyDataHandler, type PtyExitHandler, type PtySessionInfo, type PushReport, type PushWorktreeOptions, ReadOnlyMountNotSupportedError, type ReadyOptions, RemoteAPIError, RepositoryClient, type RepositoryClientOptions, type RepositoryHandle, type RepositoryInfo, RepositoryMount, type RepositoryMountOptions, type RepositoryMountStatus, type RepositoryUnmountOptions, RequestExecutionError, RequestFailedError, RequestInput, RequestMetadata, RequestNotFinishedError, RequestOutput, ResizeErrorReason, ResizeStatus, type ResourceResizeWaitOptions, type ResourceUsage, type RestartPolicy, type RestartPolicyConfig, type RunOptions, Sandbox, SandboxClient, type SandboxClientOptions, SandboxConnectionError, SandboxError, SandboxException, type SandboxInfo, type SandboxLogLevel, type SandboxLogSignal, type SandboxLogsResponse, SandboxNotFoundError, type SandboxOptions, SandboxPending, SandboxPendingReason, type SandboxPoolInfo, type SandboxPortAccess, type SandboxProcessLogFilter, type SandboxProcessLogFiltersResponse, SandboxResizeError, type SandboxResourceResizeInfo, SandboxStatus, SandboxTemplate, type SandboxUsage, type SandboxUsageExport, Secret, SecretsList, type SendSignalResponse, type SnapshotAndWaitOptions, type SnapshotInfo, type SnapshotOptions, SnapshotStatus, type SnapshotType, type SnapshotWaitCondition, type StartImageBuildOptions, StartImageBuildRequest, type StartImageImportOptions, type StartProcessOptions, StdinMode, type SuspendResumeOptions, TERMINATION_REASON_CANCELLED, TERMINATION_REASON_NO_CAPACITY, TcpTunnel, type TunnelAddress, type UpdatePoolOptions, type UpdateSandboxOptions, UpsertSecretResponse, type UsageCharge, UsageClient, type UsageClientOptions, type UsageLookback, type UsageReadOptions, type UsageSummary, cancelImageBuild, createFileSystem, deleteFileSystem, getImageBuild, isSandboxPending, listFileSystems, sandboxUrlFromIngressEndpoint, startImageBuild, startImageImport, waitImageBuild };

package/dist/index.js

@@ -46,7 +46,7 @@ var init_defaults = __esm({
   "src/defaults.ts"() {
     "use strict";
     init_esm_shims();
-    SDK_VERSION = "0.5.159";
+    SDK_VERSION = "0.5.161";
     API_URL = process.env.TENSORLAKE_API_URL ?? "https://api.tensorlake.ai";
     API_KEY = process.env.TENSORLAKE_API_KEY ?? void 0;
     NAMESPACE = process.env.INDEXIFY_NAMESPACE ?? "default";
@@ -332,6 +332,11 @@ function createWorkerBinding(runtime) {
         return runtime.handle("NativeRepositoryClient", args);
       }
     },
+    NativeUsageClient: class {
+      constructor(...args) {
+        return runtime.handle("NativeUsageClient", args);
+      }
+    },
     NativeTcpTunnel: class {
       constructor() {
         return runtime.handle("NativeTcpTunnel", []);
@@ -514,7 +519,7 @@ var init_native_worker_client = __esm({
       }
     };
     runtimeKey = /* @__PURE__ */ Symbol.for(
-      `tensorlake.native.worker.${false ? "source" : "0.5.159"}.v1`
+      `tensorlake.native.worker.${false ? "source" : "0.5.161"}.v1`
     );
     runtimes = globalThis;
   }
@@ -8795,6 +8800,63 @@ function validateTimeoutMs2(timeoutMs) {
   }
 }
 
+// src/usage.ts
+init_esm_shims();
+init_defaults();
+init_errors();
+init_native_sandbox();
+init_native_worker_client();
+function nativeWindow(options) {
+  const iso = (value) => value === void 0 ? null : value instanceof Date ? value.toISOString() : value;
+  return [options?.last ?? null, iso(options?.fromDate), iso(options?.toDate)];
+}
+var UsageClient = class {
+  native;
+  constructor(options) {
+    const apiKey = options?.apiKey ?? API_KEY;
+    if (!apiKey) {
+      throw new SandboxError("Missing TENSORLAKE_API_KEY credentials.");
+    }
+    const organizationId = options?.organizationId ?? process.env.TENSORLAKE_ORGANIZATION_ID;
+    if (!organizationId) {
+      throw new SandboxError(
+        "An organization ID is required. Pass organizationId or set TENSORLAKE_ORGANIZATION_ID."
+      );
+    }
+    const binding = loadNativeSandboxBinding();
+    if (typeof binding.NativeUsageClient !== "function") {
+      throw new SandboxError(
+        "native binding does not export the usage client; rebuild with 'npm run build:native'"
+      );
+    }
+    this.native = new binding.NativeUsageClient(
+      options?.apiUrl ?? API_URL,
+      apiKey,
+      organizationId,
+      `tensorlake-typescript-sdk/${SDK_VERSION}`,
+      DEFAULT_HTTP_TIMEOUT_MS / 1e3
+    );
+  }
+  close() {
+    releaseNativeHandle(this.native);
+  }
+  /** Organization usage totals for the window. */
+  async summary(options) {
+    const { json } = await callNative(() => this.native.summary(...nativeWindow(options)));
+    return JSON.parse(json);
+  }
+  /**
+   * Usage and attributed cost of every sandbox that ran in the window.
+   *
+   * The server computes the attribution once and returns every sandbox in one
+   * response.
+   */
+  async sandboxes(options) {
+    const { json } = await callNative(() => this.native.sandboxes(...nativeWindow(options)));
+    return JSON.parse(json);
+  }
+};
+
 // src/index.ts
 init_sandbox_image();
 init_image_builds();
@@ -10707,6 +10769,7 @@ export {
   TERMINATION_REASON_CANCELLED,
   TERMINATION_REASON_NO_CAPACITY,
   TcpTunnel,
+  UsageClient,
   cancelImageBuild,
   createFileSystem,
   createSandboxImage,