@openkaiden/opnshll-sdk 0.0.110

package/dist/client.d.ts

@@ -0,0 +1,594 @@
+import type { MessageInitShape } from '@bufbuild/protobuf';
+import { type CallOptions, type Client, type Transport } from '@connectrpc/connect';
+import { errorCode, SdkError } from './errors.js';
+import { type ExecSandboxInputSchema, OpenShell, SandboxPhase, type SandboxSpecSchema, ServiceStatus, type TcpForwardFrameSchema } from './gen/openshell_pb.js';
+import type { SandboxPolicy, SettingValue } from './gen/sandbox_pb.js';
+import { PolicySource, type SandboxPolicySchema, SettingScope, type SettingValueSchema } from './gen/sandbox_pb.js';
+import { type ConnectOptions } from './transport.js';
+export type { SandboxPolicy, SettingValue } from './gen/sandbox_pb.js';
+export type { ConnectOptions };
+export { errorCode };
+/** Lowercase mirror of the generated `SandboxPhase` enum. Hand-maintained. */
+export type SandboxPhaseName = 'unspecified' | 'provisioning' | 'ready' | 'error' | 'deleting' | 'unknown' | 'stopping' | 'stopped' | 'starting';
+/** Lowercase mirror of the generated `ServiceStatus` enum. Hand-maintained. */
+export type HealthStatus = 'unspecified' | 'healthy' | 'degraded' | 'unhealthy';
+/** Lowercase mirror of the generated `SettingScope` enum. Hand-maintained. */
+export type SettingScopeName = 'unspecified' | 'sandbox' | 'global';
+/** Lowercase mirror of the generated `PolicySource` enum. Hand-maintained. */
+export type PolicySourceName = 'unspecified' | 'sandbox' | 'global';
+export interface Health {
+    status: HealthStatus;
+    version: string;
+}
+export interface SandboxSpec {
+    name?: string;
+    image?: string;
+    labels?: Record<string, string>;
+    environment?: Record<string, string>;
+    providers?: string[];
+    gpu?: boolean;
+    /**
+     * Create-time sandbox policy (the safety boundary). Sandbox-scoped
+     * `setPolicy` cannot introduce static fields later, so express filesystem,
+     * landlock, process, and initial network policy here.
+     */
+    policy?: MessageInitShape<typeof SandboxPolicySchema>;
+    /**
+     * Advanced escape hatch: the full generated proto spec. Curated fields build
+     * the base spec, then `rawSpec` shallow-overrides at the top spec level, so
+     * any field it sets wins. Use it to reach proto spec fields the curated shape
+     * does not surface (template runtime class, resource limits, log level, and
+     * future additions) without an SDK change.
+     */
+    rawSpec?: MessageInitShape<typeof SandboxSpecSchema>;
+}
+export interface SandboxRef {
+    id: string;
+    name: string;
+    phase: SandboxPhaseName;
+    labels: Record<string, string>;
+    /** u64 rendered as a string — JS numbers can't hold it safely. */
+    resourceVersion: string;
+}
+export interface ListOptions {
+    limit?: number;
+    offset?: number;
+    labelSelector?: string;
+}
+export interface ExecOptions {
+    workdir?: string;
+    environment?: Record<string, string>;
+    timeoutSecs?: number;
+    stdin?: Buffer;
+    /** Abort the exec (and the in-flight stream RPC) early. */
+    signal?: AbortSignal;
+}
+export interface ExecResult {
+    exitCode: number;
+    stdout: Buffer;
+    stderr: Buffer;
+}
+/** One stdout/stderr chunk yielded by `execStream`/`execInteractive`. */
+export interface ExecStreamChunk {
+    stream: 'stdout' | 'stderr';
+    data: Buffer;
+}
+export interface ExecExitEvent {
+    type: 'exit';
+    exitCode: number;
+}
+/** An exec stream item: a stdout/stderr chunk or the terminal exit event. */
+export type ExecStreamEvent = ExecStreamChunk | ExecExitEvent;
+export interface ExecInteractiveOptions {
+    workdir?: string;
+    environment?: Record<string, string>;
+    timeoutSecs?: number;
+    /** Request a pseudo-terminal (default true). */
+    tty?: boolean;
+    /** Initial terminal columns (0 = server default). */
+    cols?: number;
+    /** Initial terminal rows (0 = server default). */
+    rows?: number;
+    /** Abort the interactive exec (and the in-flight stream RPC) early. */
+    signal?: AbortSignal;
+}
+export interface ExecInteractiveSession {
+    output: AsyncIterable<ExecStreamEvent>;
+    write(data: Buffer): void;
+    resize(cols: number, rows: number): void;
+    close(): void;
+    done: Promise<number>;
+}
+/** Cancellation for the poll-based wait helpers. */
+export interface WaitOptions {
+    /** Abort the wait (and the in-flight poll RPC) early. */
+    signal?: AbortSignal;
+}
+export interface ForwardOptions {
+    /** Loopback TCP port inside the sandbox to dial. */
+    targetPort: number;
+    /** Target host inside the sandbox (loopback only). Default 127.0.0.1. */
+    targetHost?: string;
+    /** Local port to bind. Default 0 (ephemeral). */
+    localPort?: number;
+    /** Local address to bind. Default 127.0.0.1. */
+    localHost?: string;
+    /** Abort forward setup and tear down the local listener early. */
+    signal?: AbortSignal;
+    /** Receives failures from individual accepted connections. */
+    onConnectionError?: (error: SdkError) => void;
+}
+export interface ForwardHandle {
+    localHost: string;
+    localPort: number;
+    targetHost: string;
+    targetPort: number;
+    close(): Promise<void>;
+    closed: Promise<void>;
+}
+export interface SshSession {
+    sandboxId: string;
+    token: string;
+    gatewayHost: string;
+    gatewayPort: number;
+    gatewayScheme: string;
+    hostKeyFingerprint?: string;
+    /** int64 ms-since-epoch rendered as a string; omitted when 0 (no expiry). */
+    expiresAtMs?: string;
+}
+export interface ProviderRef {
+    id: string;
+    name: string;
+    type: string;
+    labels: Record<string, string>;
+    /** u64 rendered as a string. */
+    resourceVersion: string;
+}
+export interface ProviderChange {
+    sandbox: SandboxRef;
+    /** True when the attach/detach actually changed the attachment set. */
+    changed: boolean;
+}
+export interface ProviderChangeOptions {
+    /** Pin the sandbox resource version for optimistic concurrency (u64 as string). */
+    expectedResourceVersion?: string;
+}
+/** Effective value of one setting plus the scope it resolved from. */
+export interface EffectiveSettingView {
+    value?: SettingValue;
+    /** 'unspecified' | 'sandbox' | 'global'. */
+    scope: SettingScopeName;
+}
+export interface SandboxConfig {
+    policy?: SandboxPolicy;
+    version: number;
+    policyHash: string;
+    settings: Record<string, EffectiveSettingView>;
+    /** u64 rendered as a string. */
+    configRevision: string;
+    /** 'unspecified' | 'sandbox' | 'global'. */
+    policySource: PolicySourceName;
+    globalPolicyVersion: number;
+    /** u64 rendered as a string. */
+    providerEnvRevision: string;
+}
+export interface SetPolicyOptions {
+    /** Pin the sandbox resource version for optimistic concurrency (u64 as string). */
+    expectedResourceVersion?: string;
+    /** Poll getConfig until the applied policy hash is observed. */
+    wait?: boolean;
+    /** Bound the `wait` poll (seconds). Default 60. */
+    waitTimeoutSecs?: number;
+}
+export interface UpdateConfigResult {
+    version: number;
+    policyHash: string;
+    /** u64 rendered as a string. */
+    settingsRevision: string;
+    deleted: boolean;
+}
+export declare const PHASE_NAMES: Record<SandboxPhase, SandboxPhaseName>;
+export declare const STATUS_NAMES: Record<ServiceStatus, HealthStatus>;
+export declare const SCOPE_NAMES: Record<SettingScope, SettingScopeName>;
+export declare const POLICY_SOURCE_NAMES: Record<PolicySource, PolicySourceName>;
+export declare class Pushable<T> implements AsyncIterable<T> {
+    private readonly queue;
+    private readonly waiting;
+    private ended;
+    private error;
+    onDrain?: () => void;
+    get size(): number;
+    push(value: T): void;
+    end(error?: unknown): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}
+export declare class SandboxClient {
+    private readonly grpc;
+    /**
+     * Advanced escape hatch: a generated client for every gateway RPC, including
+     * surface the curated methods do not wrap yet. Request/response types are the
+     * generated wire messages (import them from '@nvidia/openshell-sdk/raw').
+     */
+    readonly raw: Client<typeof OpenShell>;
+    /** The shared Connect transport, for building extra clients over the same connection. */
+    readonly transport: Transport;
+    constructor(transport: Transport, grpc?: Client<import("@bufbuild/protobuf/codegenv2").GenService<{
+        health: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").HealthRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").HealthResponseSchema;
+        };
+        getCurrentUser: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetCurrentUserRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetCurrentUserResponseSchema;
+        };
+        getGatewayInfo: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetGatewayInfoRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetGatewayInfoResponseSchema;
+        };
+        createSandbox: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").CreateSandboxRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").SandboxResponseSchema;
+        };
+        getSandbox: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetSandboxRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").SandboxResponseSchema;
+        };
+        listSandboxes: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListSandboxesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListSandboxesResponseSchema;
+        };
+        listSandboxProviders: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListSandboxProvidersRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListSandboxProvidersResponseSchema;
+        };
+        attachSandboxProvider: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").AttachSandboxProviderRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").AttachSandboxProviderResponseSchema;
+        };
+        detachSandboxProvider: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").DetachSandboxProviderRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").DetachSandboxProviderResponseSchema;
+        };
+        deleteSandbox: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").DeleteSandboxRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").DeleteSandboxResponseSchema;
+        };
+        stopSandbox: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").StopSandboxRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").SandboxResponseSchema;
+        };
+        startSandbox: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").StartSandboxRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").SandboxResponseSchema;
+        };
+        createSshSession: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").CreateSshSessionRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").CreateSshSessionResponseSchema;
+        };
+        exposeService: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ExposeServiceRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ServiceEndpointResponseSchema;
+        };
+        getService: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetServiceRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ServiceEndpointResponseSchema;
+        };
+        listServices: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListServicesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListServicesResponseSchema;
+        };
+        deleteService: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").DeleteServiceRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").DeleteServiceResponseSchema;
+        };
+        revokeSshSession: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").RevokeSshSessionRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").RevokeSshSessionResponseSchema;
+        };
+        execSandbox: {
+            methodKind: "server_streaming";
+            input: typeof import("./gen/openshell_pb.js").ExecSandboxRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ExecSandboxEventSchema;
+        };
+        forwardTcp: {
+            methodKind: "bidi_streaming";
+            input: typeof TcpForwardFrameSchema;
+            output: typeof TcpForwardFrameSchema;
+        };
+        execSandboxInteractive: {
+            methodKind: "bidi_streaming";
+            input: typeof ExecSandboxInputSchema;
+            output: typeof import("./gen/openshell_pb.js").ExecSandboxEventSchema;
+        };
+        createProvider: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").CreateProviderRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ProviderResponseSchema;
+        };
+        getProvider: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetProviderRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ProviderResponseSchema;
+        };
+        listProviders: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListProvidersRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListProvidersResponseSchema;
+        };
+        listProviderProfiles: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListProviderProfilesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListProviderProfilesResponseSchema;
+        };
+        getProviderProfile: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetProviderProfileRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ProviderProfileResponseSchema;
+        };
+        importProviderProfiles: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ImportProviderProfilesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ImportProviderProfilesResponseSchema;
+        };
+        updateProviderProfiles: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").UpdateProviderProfilesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").UpdateProviderProfilesResponseSchema;
+        };
+        lintProviderProfiles: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").LintProviderProfilesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").LintProviderProfilesResponseSchema;
+        };
+        updateProvider: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").UpdateProviderRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ProviderResponseSchema;
+        };
+        getProviderRefreshStatus: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetProviderRefreshStatusRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetProviderRefreshStatusResponseSchema;
+        };
+        configureProviderRefresh: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ConfigureProviderRefreshRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ConfigureProviderRefreshResponseSchema;
+        };
+        rotateProviderCredential: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").RotateProviderCredentialRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").RotateProviderCredentialResponseSchema;
+        };
+        deleteProviderRefresh: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").DeleteProviderRefreshRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").DeleteProviderRefreshResponseSchema;
+        };
+        deleteProvider: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").DeleteProviderRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").DeleteProviderResponseSchema;
+        };
+        deleteProviderProfile: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").DeleteProviderProfileRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").DeleteProviderProfileResponseSchema;
+        };
+        getSandboxConfig: {
+            methodKind: "unary";
+            input: typeof import("./gen/sandbox_pb.js").GetSandboxConfigRequestSchema;
+            output: typeof import("./gen/sandbox_pb.js").GetSandboxConfigResponseSchema;
+        };
+        getGatewayConfig: {
+            methodKind: "unary";
+            input: typeof import("./gen/sandbox_pb.js").GetGatewayConfigRequestSchema;
+            output: typeof import("./gen/sandbox_pb.js").GetGatewayConfigResponseSchema;
+        };
+        updateConfig: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").UpdateConfigRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").UpdateConfigResponseSchema;
+        };
+        getSandboxPolicyStatus: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetSandboxPolicyStatusRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetSandboxPolicyStatusResponseSchema;
+        };
+        listSandboxPolicies: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListSandboxPoliciesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListSandboxPoliciesResponseSchema;
+        };
+        reportPolicyStatus: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ReportPolicyStatusRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ReportPolicyStatusResponseSchema;
+        };
+        getSandboxProviderEnvironment: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetSandboxProviderEnvironmentRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetSandboxProviderEnvironmentResponseSchema;
+        };
+        getSandboxLogs: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetSandboxLogsRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetSandboxLogsResponseSchema;
+        };
+        pushSandboxLogs: {
+            methodKind: "client_streaming";
+            input: typeof import("./gen/openshell_pb.js").PushSandboxLogsRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").PushSandboxLogsResponseSchema;
+        };
+        connectSupervisor: {
+            methodKind: "bidi_streaming";
+            input: typeof import("./gen/openshell_pb.js").SupervisorMessageSchema;
+            output: typeof import("./gen/openshell_pb.js").GatewayMessageSchema;
+        };
+        relayStream: {
+            methodKind: "bidi_streaming";
+            input: typeof import("./gen/openshell_pb.js").RelayFrameSchema;
+            output: typeof import("./gen/openshell_pb.js").RelayFrameSchema;
+        };
+        watchSandbox: {
+            methodKind: "server_streaming";
+            input: typeof import("./gen/openshell_pb.js").WatchSandboxRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").SandboxStreamEventSchema;
+        };
+        submitPolicyAnalysis: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").SubmitPolicyAnalysisRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").SubmitPolicyAnalysisResponseSchema;
+        };
+        getDraftPolicy: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetDraftPolicyRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetDraftPolicyResponseSchema;
+        };
+        approveDraftChunk: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ApproveDraftChunkRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ApproveDraftChunkResponseSchema;
+        };
+        rejectDraftChunk: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").RejectDraftChunkRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").RejectDraftChunkResponseSchema;
+        };
+        approveAllDraftChunks: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ApproveAllDraftChunksRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ApproveAllDraftChunksResponseSchema;
+        };
+        editDraftChunk: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").EditDraftChunkRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").EditDraftChunkResponseSchema;
+        };
+        undoDraftChunk: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").UndoDraftChunkRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").UndoDraftChunkResponseSchema;
+        };
+        clearDraftChunks: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ClearDraftChunksRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ClearDraftChunksResponseSchema;
+        };
+        getDraftHistory: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetDraftHistoryRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetDraftHistoryResponseSchema;
+        };
+        issueSandboxToken: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").IssueSandboxTokenRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").IssueSandboxTokenResponseSchema;
+        };
+        refreshSandboxToken: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").RefreshSandboxTokenRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").RefreshSandboxTokenResponseSchema;
+        };
+        createWorkspace: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").CreateWorkspaceRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").CreateWorkspaceResponseSchema;
+        };
+        getWorkspace: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").GetWorkspaceRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").GetWorkspaceResponseSchema;
+        };
+        listWorkspaces: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListWorkspacesRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListWorkspacesResponseSchema;
+        };
+        deleteWorkspace: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").DeleteWorkspaceRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").DeleteWorkspaceResponseSchema;
+        };
+        addWorkspaceMember: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").AddWorkspaceMemberRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").AddWorkspaceMemberResponseSchema;
+        };
+        removeWorkspaceMember: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").RemoveWorkspaceMemberRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").RemoveWorkspaceMemberResponseSchema;
+        };
+        listWorkspaceMembers: {
+            methodKind: "unary";
+            input: typeof import("./gen/openshell_pb.js").ListWorkspaceMembersRequestSchema;
+            output: typeof import("./gen/openshell_pb.js").ListWorkspaceMembersResponseSchema;
+        };
+    }>>);
+    /**
+     * Constructs a lazy Connect client. No network request is made until the
+     * first RPC; call get() or another operation to verify reachability.
+     */
+    static connect(options: ConnectOptions): Promise<SandboxClient>;
+    create(spec: SandboxSpec): Promise<SandboxRef>;
+    get(name: string, callOptions?: CallOptions): Promise<SandboxRef>;
+    list(options?: ListOptions | null): Promise<SandboxRef[]>;
+    delete(name: string): Promise<boolean>;
+    waitReady(name: string, timeoutSecs: number, options?: WaitOptions | null): Promise<SandboxRef>;
+    waitDeleted(name: string, timeoutSecs: number, options?: WaitOptions | null): Promise<void>;
+    execStream(name: string, command: string[], options?: ExecOptions | null): AsyncGenerator<ExecStreamEvent, void, void>;
+    exec(name: string, command: string[], options?: ExecOptions | null): Promise<ExecResult>;
+    execInteractive(name: string, command: string[], options?: ExecInteractiveOptions | null): Promise<ExecInteractiveSession>;
+    forward(name: string, opts: ForwardOptions): Promise<ForwardHandle>;
+    private forwardConnection;
+    createSshSession(name: string): Promise<SshSession>;
+    revokeSshSession(token: string): Promise<boolean>;
+    attachProvider(name: string, provider: string, options?: ProviderChangeOptions | null): Promise<ProviderChange>;
+    detachProvider(name: string, provider: string, options?: ProviderChangeOptions | null): Promise<ProviderChange>;
+    listProviders(name: string): Promise<ProviderRef[]>;
+    getConfig(name: string, callOptions?: CallOptions): Promise<SandboxConfig>;
+    setPolicy(name: string, policy: MessageInitShape<typeof SandboxPolicySchema>, options?: SetPolicyOptions | null): Promise<UpdateConfigResult>;
+    setSetting(name: string, key: string, value: MessageInitShape<typeof SettingValueSchema>): Promise<UpdateConfigResult>;
+    private waitForPolicyHash;
+}
+export declare class OpenShellClient {
+    /** Sandbox lifecycle + exec: create/get/list/delete, waitReady/waitDeleted, exec. */
+    readonly sandbox: SandboxClient;
+    /**
+     * Advanced escape hatch: a generated client for every gateway RPC, including
+     * surface the curated sub-clients do not wrap yet (gateway config, provider
+     * CRUD, policy status, watch, logs, and the full observed Sandbox). See
+     * '@nvidia/openshell-sdk/raw' for the generated request/response types.
+     */
+    readonly raw: Client<typeof OpenShell>;
+    /** The shared Connect transport, for building extra clients over the same connection. */
+    readonly transport: Transport;
+    private readonly grpc;
+    private constructor();
+    /**
+     * Constructs a lazy Connect client. No network request is made until the
+     * first RPC; call health() when startup must verify gateway reachability.
+     */
+    static connect(options: ConnectOptions): Promise<OpenShellClient>;
+    health(): Promise<Health>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}