@gjermundgaraba/clankerbox-sdk 0.2.0

package/dist/gen/clankerbox/v1/session_pb.d.ts

@@ -0,0 +1,760 @@
+import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { ErrorDetail } from "./resources_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file clankerbox/v1/session.proto.
+ */
+export declare const file_clankerbox_v1_session: GenFile;
+/**
+ * Authenticated private guest endpoint. Identical terminal messages across relays.
+ *
+ * @generated from message clankerbox.v1.DescribeGuestRequest
+ */
+export type DescribeGuestRequest = Message<"clankerbox.v1.DescribeGuestRequest"> & {
+    /**
+     * @generated from field: string machine_id = 1;
+     */
+    machineId: string;
+};
+/**
+ * Describes the message clankerbox.v1.DescribeGuestRequest.
+ * Use `create(DescribeGuestRequestSchema)` to create a new message.
+ */
+export declare const DescribeGuestRequestSchema: GenMessage<DescribeGuestRequest>;
+/**
+ * @generated from message clankerbox.v1.GuestDescription
+ */
+export type GuestDescription = Message<"clankerbox.v1.GuestDescription"> & {
+    /**
+     * @generated from field: string machine_id = 1;
+     */
+    machineId: string;
+    /**
+     * @generated from field: string incarnation = 2;
+     */
+    incarnation: string;
+    /**
+     * @generated from field: string boot_id = 3;
+     */
+    bootId: string;
+    /**
+     * @generated from field: string daemon_version = 4;
+     */
+    daemonVersion: string;
+    /**
+     * @generated from field: string os = 5;
+     */
+    os: string;
+    /**
+     * @generated from field: string user = 6;
+     */
+    user: string;
+    /**
+     * @generated from field: string engine_digest = 7;
+     */
+    engineDigest: string;
+    /**
+     * @generated from field: uint32 max_sessions = 8;
+     */
+    maxSessions: number;
+    /**
+     * @generated from field: string schema = 9;
+     */
+    schema: string;
+};
+/**
+ * Describes the message clankerbox.v1.GuestDescription.
+ * Use `create(GuestDescriptionSchema)` to create a new message.
+ */
+export declare const GuestDescriptionSchema: GenMessage<GuestDescription>;
+/**
+ * @generated from message clankerbox.v1.Session
+ */
+export type Session = Message<"clankerbox.v1.Session"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string label = 2;
+     */
+    label: string;
+    /**
+     * @generated from field: string cwd = 3;
+     */
+    cwd: string;
+    /**
+     * @generated from field: repeated string argv = 4;
+     */
+    argv: string[];
+    /**
+     * @generated from field: uint32 cols = 5;
+     */
+    cols: number;
+    /**
+     * @generated from field: uint32 rows = 6;
+     */
+    rows: number;
+    /**
+     * @generated from field: clankerbox.v1.SessionStatus status = 7;
+     */
+    status: SessionStatus;
+    /**
+     * @generated from field: optional int32 exit_code = 8;
+     */
+    exitCode?: number | undefined;
+    /**
+     * @generated from field: optional string signal = 9;
+     */
+    signal?: string | undefined;
+    /**
+     * @generated from field: int64 pid = 10;
+     */
+    pid: bigint;
+    /**
+     * RFC3339Nano strings preserve the session manager's durable creation identity.
+     *
+     * @generated from field: string created_at = 11;
+     */
+    createdAt: string;
+    /**
+     * @generated from field: optional string ended_at = 12;
+     */
+    endedAt?: string | undefined;
+    /**
+     * @generated from field: uint64 offset = 13;
+     */
+    offset: bigint;
+    /**
+     * @generated from field: uint64 retained_from = 14;
+     */
+    retainedFrom: bigint;
+    /**
+     * @generated from field: optional uint64 last_resize_offset = 15;
+     */
+    lastResizeOffset?: bigint | undefined;
+    /**
+     * @generated from field: string incarnation = 16;
+     */
+    incarnation: string;
+    /**
+     * @generated from field: uint64 reply_overflow = 17;
+     */
+    replyOverflow: bigint;
+};
+/**
+ * Describes the message clankerbox.v1.Session.
+ * Use `create(SessionSchema)` to create a new message.
+ */
+export declare const SessionSchema: GenMessage<Session>;
+/**
+ * @generated from message clankerbox.v1.CreateSessionRequest
+ */
+export type CreateSessionRequest = Message<"clankerbox.v1.CreateSessionRequest"> & {
+    /**
+     * @generated from field: string machine_id = 1;
+     */
+    machineId: string;
+    /**
+     * @generated from field: string session_id = 2;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string label = 3;
+     */
+    label: string;
+    /**
+     * @generated from field: string cwd = 4;
+     */
+    cwd: string;
+    /**
+     * @generated from field: repeated string argv = 5;
+     */
+    argv: string[];
+    /**
+     * @generated from field: map<string, string> env = 6;
+     */
+    env: {
+        [key: string]: string;
+    };
+    /**
+     * @generated from field: uint32 cols = 7;
+     */
+    cols: number;
+    /**
+     * @generated from field: uint32 rows = 8;
+     */
+    rows: number;
+    /**
+     * Caller decision time for creation deduplication/retry-horizon enforcement.
+     *
+     * @generated from field: string created_at = 9;
+     */
+    createdAt: string;
+};
+/**
+ * Describes the message clankerbox.v1.CreateSessionRequest.
+ * Use `create(CreateSessionRequestSchema)` to create a new message.
+ */
+export declare const CreateSessionRequestSchema: GenMessage<CreateSessionRequest>;
+/**
+ * @generated from message clankerbox.v1.ListSessionsRequest
+ */
+export type ListSessionsRequest = Message<"clankerbox.v1.ListSessionsRequest"> & {
+    /**
+     * @generated from field: string machine_id = 1;
+     */
+    machineId: string;
+};
+/**
+ * Describes the message clankerbox.v1.ListSessionsRequest.
+ * Use `create(ListSessionsRequestSchema)` to create a new message.
+ */
+export declare const ListSessionsRequestSchema: GenMessage<ListSessionsRequest>;
+/**
+ * @generated from message clankerbox.v1.ListSessionsResponse
+ */
+export type ListSessionsResponse = Message<"clankerbox.v1.ListSessionsResponse"> & {
+    /**
+     * @generated from field: repeated clankerbox.v1.Session sessions = 1;
+     */
+    sessions: Session[];
+};
+/**
+ * Describes the message clankerbox.v1.ListSessionsResponse.
+ * Use `create(ListSessionsResponseSchema)` to create a new message.
+ */
+export declare const ListSessionsResponseSchema: GenMessage<ListSessionsResponse>;
+/**
+ * @generated from message clankerbox.v1.EndSessionRequest
+ */
+export type EndSessionRequest = Message<"clankerbox.v1.EndSessionRequest"> & {
+    /**
+     * @generated from field: string machine_id = 1;
+     */
+    machineId: string;
+    /**
+     * @generated from field: string session_id = 2;
+     */
+    sessionId: string;
+};
+/**
+ * Describes the message clankerbox.v1.EndSessionRequest.
+ * Use `create(EndSessionRequestSchema)` to create a new message.
+ */
+export declare const EndSessionRequestSchema: GenMessage<EndSessionRequest>;
+/**
+ * @generated from message clankerbox.v1.ResumeCursor
+ */
+export type ResumeCursor = Message<"clankerbox.v1.ResumeCursor"> & {
+    /**
+     * @generated from field: uint64 offset = 1;
+     */
+    offset: bigint;
+    /**
+     * @generated from field: string incarnation = 2;
+     */
+    incarnation: string;
+};
+/**
+ * Describes the message clankerbox.v1.ResumeCursor.
+ * Use `create(ResumeCursorSchema)` to create a new message.
+ */
+export declare const ResumeCursorSchema: GenMessage<ResumeCursor>;
+/**
+ * @generated from message clankerbox.v1.Open
+ */
+export type Open = Message<"clankerbox.v1.Open"> & {
+    /**
+     * @generated from field: string machine_id = 1;
+     */
+    machineId: string;
+    /**
+     * @generated from field: string session_id = 2;
+     */
+    sessionId: string;
+    /**
+     * @generated from field: string expected_engine_digest = 3;
+     */
+    expectedEngineDigest: string;
+    /**
+     * @generated from field: clankerbox.v1.ResumeCursor resume_cursor = 4;
+     */
+    resumeCursor?: ResumeCursor | undefined;
+};
+/**
+ * Describes the message clankerbox.v1.Open.
+ * Use `create(OpenSchema)` to create a new message.
+ */
+export declare const OpenSchema: GenMessage<Open>;
+/**
+ * @generated from message clankerbox.v1.Input
+ */
+export type Input = Message<"clankerbox.v1.Input"> & {
+    /**
+     * @generated from field: uint64 sequence = 1;
+     */
+    sequence: bigint;
+    /**
+     * @generated from field: bytes data = 2;
+     */
+    data: Uint8Array;
+};
+/**
+ * Describes the message clankerbox.v1.Input.
+ * Use `create(InputSchema)` to create a new message.
+ */
+export declare const InputSchema: GenMessage<Input>;
+/**
+ * @generated from message clankerbox.v1.Resize
+ */
+export type Resize = Message<"clankerbox.v1.Resize"> & {
+    /**
+     * @generated from field: uint64 sequence = 1;
+     */
+    sequence: bigint;
+    /**
+     * @generated from field: uint32 cols = 2;
+     */
+    cols: number;
+    /**
+     * @generated from field: uint32 rows = 3;
+     */
+    rows: number;
+};
+/**
+ * Describes the message clankerbox.v1.Resize.
+ * Use `create(ResizeSchema)` to create a new message.
+ */
+export declare const ResizeSchema: GenMessage<Resize>;
+/**
+ * @generated from message clankerbox.v1.AttachmentRequest
+ */
+export type AttachmentRequest = Message<"clankerbox.v1.AttachmentRequest"> & {
+    /**
+     * Exactly one Open first. Controls are processed in stream order thereafter.
+     *
+     * @generated from oneof clankerbox.v1.AttachmentRequest.command
+     */
+    command: {
+        /**
+         * @generated from field: clankerbox.v1.Open open = 1;
+         */
+        value: Open;
+        case: "open";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.Input input = 2;
+         */
+        value: Input;
+        case: "input";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.Resize resize = 3;
+         */
+        value: Resize;
+        case: "resize";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message clankerbox.v1.AttachmentRequest.
+ * Use `create(AttachmentRequestSchema)` to create a new message.
+ */
+export declare const AttachmentRequestSchema: GenMessage<AttachmentRequest>;
+/**
+ * @generated from message clankerbox.v1.Cursor
+ */
+export type Cursor = Message<"clankerbox.v1.Cursor"> & {
+    /**
+     * @generated from field: uint32 x = 1;
+     */
+    x: number;
+    /**
+     * @generated from field: uint32 y = 2;
+     */
+    y: number;
+};
+/**
+ * Describes the message clankerbox.v1.Cursor.
+ * Use `create(CursorSchema)` to create a new message.
+ */
+export declare const CursorSchema: GenMessage<Cursor>;
+/**
+ * @generated from message clankerbox.v1.View
+ */
+export type View = Message<"clankerbox.v1.View"> & {
+    /**
+     * @generated from field: clankerbox.v1.Cursor cursor = 1;
+     */
+    cursor?: Cursor | undefined;
+    /**
+     * @generated from field: uint64 bytes = 2;
+     */
+    bytes: bigint;
+};
+/**
+ * Describes the message clankerbox.v1.View.
+ * Use `create(ViewSchema)` to create a new message.
+ */
+export declare const ViewSchema: GenMessage<View>;
+/**
+ * @generated from message clankerbox.v1.Opened
+ */
+export type Opened = Message<"clankerbox.v1.Opened"> & {
+    /**
+     * @generated from field: clankerbox.v1.GuestDescription guest = 1;
+     */
+    guest?: GuestDescription | undefined;
+    /**
+     * @generated from field: clankerbox.v1.Session session = 2;
+     */
+    session?: Session | undefined;
+    /**
+     * @generated from field: clankerbox.v1.OpenMode mode = 3;
+     */
+    mode: OpenMode;
+    /**
+     * @generated from field: uint64 cut = 4;
+     */
+    cut: bigint;
+    /**
+     * @generated from field: uint64 snapshot_bytes = 5;
+     */
+    snapshotBytes: bigint;
+    /**
+     * Present only when the ended terminal still has a final screen available.
+     *
+     * @generated from field: clankerbox.v1.View view = 6;
+     */
+    view?: View | undefined;
+    /**
+     * First retained offset when resuming; distinct from the atomic live cut.
+     *
+     * @generated from field: uint64 start_offset = 7;
+     */
+    startOffset: bigint;
+};
+/**
+ * Describes the message clankerbox.v1.Opened.
+ * Use `create(OpenedSchema)` to create a new message.
+ */
+export declare const OpenedSchema: GenMessage<Opened>;
+/**
+ * @generated from message clankerbox.v1.SnapshotChunk
+ */
+export type SnapshotChunk = Message<"clankerbox.v1.SnapshotChunk"> & {
+    /**
+     * Position is attachment bootstrap-local, not a committed output cursor.
+     *
+     * @generated from field: uint64 position = 1;
+     */
+    position: bigint;
+    /**
+     * @generated from field: bytes data = 2;
+     */
+    data: Uint8Array;
+    /**
+     * @generated from field: bool final = 3;
+     */
+    final: boolean;
+};
+/**
+ * Describes the message clankerbox.v1.SnapshotChunk.
+ * Use `create(SnapshotChunkSchema)` to create a new message.
+ */
+export declare const SnapshotChunkSchema: GenMessage<SnapshotChunk>;
+/**
+ * @generated from message clankerbox.v1.ViewChunk
+ */
+export type ViewChunk = Message<"clankerbox.v1.ViewChunk"> & {
+    /**
+     * @generated from field: uint64 position = 1;
+     */
+    position: bigint;
+    /**
+     * @generated from field: bytes data = 2;
+     */
+    data: Uint8Array;
+    /**
+     * @generated from field: bool final = 3;
+     */
+    final: boolean;
+};
+/**
+ * Describes the message clankerbox.v1.ViewChunk.
+ * Use `create(ViewChunkSchema)` to create a new message.
+ */
+export declare const ViewChunkSchema: GenMessage<ViewChunk>;
+/**
+ * @generated from message clankerbox.v1.Output
+ */
+export type Output = Message<"clankerbox.v1.Output"> & {
+    /**
+     * @generated from field: uint64 next_offset = 1;
+     */
+    nextOffset: bigint;
+    /**
+     * @generated from field: bytes data = 2;
+     */
+    data: Uint8Array;
+};
+/**
+ * Describes the message clankerbox.v1.Output.
+ * Use `create(OutputSchema)` to create a new message.
+ */
+export declare const OutputSchema: GenMessage<Output>;
+/**
+ * @generated from message clankerbox.v1.Resized
+ */
+export type Resized = Message<"clankerbox.v1.Resized"> & {
+    /**
+     * @generated from field: uint64 offset = 1;
+     */
+    offset: bigint;
+    /**
+     * @generated from field: uint32 cols = 2;
+     */
+    cols: number;
+    /**
+     * @generated from field: uint32 rows = 3;
+     */
+    rows: number;
+};
+/**
+ * Describes the message clankerbox.v1.Resized.
+ * Use `create(ResizedSchema)` to create a new message.
+ */
+export declare const ResizedSchema: GenMessage<Resized>;
+/**
+ * @generated from message clankerbox.v1.Ack
+ */
+export type Ack = Message<"clankerbox.v1.Ack"> & {
+    /**
+     * @generated from field: uint64 sequence = 1;
+     */
+    sequence: bigint;
+    /**
+     * Accepted means bounded writer admission, never confirmed shell execution.
+     *
+     * @generated from field: bool accepted = 2;
+     */
+    accepted: boolean;
+    /**
+     * @generated from field: string reason = 3;
+     */
+    reason: string;
+    /**
+     * @generated from field: clankerbox.v1.ErrorDetail error = 4;
+     */
+    error?: ErrorDetail | undefined;
+};
+/**
+ * Describes the message clankerbox.v1.Ack.
+ * Use `create(AckSchema)` to create a new message.
+ */
+export declare const AckSchema: GenMessage<Ack>;
+/**
+ * @generated from message clankerbox.v1.SessionExited
+ */
+export type SessionExited = Message<"clankerbox.v1.SessionExited"> & {
+    /**
+     * @generated from field: clankerbox.v1.Session session = 1;
+     */
+    session?: Session | undefined;
+};
+/**
+ * Describes the message clankerbox.v1.SessionExited.
+ * Use `create(SessionExitedSchema)` to create a new message.
+ */
+export declare const SessionExitedSchema: GenMessage<SessionExited>;
+/**
+ * @generated from message clankerbox.v1.Gap
+ */
+export type Gap = Message<"clankerbox.v1.Gap"> & {
+    /**
+     * @generated from field: string reason = 1;
+     */
+    reason: string;
+};
+/**
+ * Describes the message clankerbox.v1.Gap.
+ * Use `create(GapSchema)` to create a new message.
+ */
+export declare const GapSchema: GenMessage<Gap>;
+/**
+ * @generated from message clankerbox.v1.AttachmentEvent
+ */
+export type AttachmentEvent = Message<"clankerbox.v1.AttachmentEvent"> & {
+    /**
+     * Guest owns the atomic cut/subscription and ordering. Bootstrap completes
+     * before live output; no relay creates terminal state or replays uncertain input.
+     *
+     * @generated from oneof clankerbox.v1.AttachmentEvent.event
+     */
+    event: {
+        /**
+         * @generated from field: clankerbox.v1.Opened opened = 1;
+         */
+        value: Opened;
+        case: "opened";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.SnapshotChunk snapshot_chunk = 2;
+         */
+        value: SnapshotChunk;
+        case: "snapshotChunk";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.ViewChunk view_chunk = 3;
+         */
+        value: ViewChunk;
+        case: "viewChunk";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.Output output = 4;
+         */
+        value: Output;
+        case: "output";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.Resized resized = 5;
+         */
+        value: Resized;
+        case: "resized";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.Ack ack = 6;
+         */
+        value: Ack;
+        case: "ack";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.SessionExited session_exited = 7;
+         */
+        value: SessionExited;
+        case: "sessionExited";
+    } | {
+        /**
+         * @generated from field: clankerbox.v1.Gap gap = 8;
+         */
+        value: Gap;
+        case: "gap";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message clankerbox.v1.AttachmentEvent.
+ * Use `create(AttachmentEventSchema)` to create a new message.
+ */
+export declare const AttachmentEventSchema: GenMessage<AttachmentEvent>;
+/**
+ * @generated from enum clankerbox.v1.SessionStatus
+ */
+export declare enum SessionStatus {
+    /**
+     * @generated from enum value: SESSION_STATUS_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: SESSION_STATUS_STARTING = 1;
+     */
+    STARTING = 1,
+    /**
+     * @generated from enum value: SESSION_STATUS_RUNNING = 2;
+     */
+    RUNNING = 2,
+    /**
+     * @generated from enum value: SESSION_STATUS_EXITED = 3;
+     */
+    EXITED = 3,
+    /**
+     * @generated from enum value: SESSION_STATUS_LOST = 4;
+     */
+    LOST = 4
+}
+/**
+ * Describes the enum clankerbox.v1.SessionStatus.
+ */
+export declare const SessionStatusSchema: GenEnum<SessionStatus>;
+/**
+ * @generated from enum clankerbox.v1.OpenMode
+ */
+export declare enum OpenMode {
+    /**
+     * @generated from enum value: OPEN_MODE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: OPEN_MODE_RESUME = 1;
+     */
+    RESUME = 1,
+    /**
+     * @generated from enum value: OPEN_MODE_SNAPSHOT = 2;
+     */
+    SNAPSHOT = 2,
+    /**
+     * @generated from enum value: OPEN_MODE_UNAVAILABLE = 3;
+     */
+    UNAVAILABLE = 3,
+    /**
+     * @generated from enum value: OPEN_MODE_ENDED = 4;
+     */
+    ENDED = 4
+}
+/**
+ * Describes the enum clankerbox.v1.OpenMode.
+ */
+export declare const OpenModeSchema: GenEnum<OpenMode>;
+/**
+ * Public controller routing. Applications receive neither guest credentials nor
+ * arbitrary endpoint routing. All session methods address an immutable machine ID.
+ *
+ * @generated from service clankerbox.v1.SessionService
+ */
+export declare const SessionService: GenService<{
+    /**
+     * @generated from rpc clankerbox.v1.SessionService.DescribeGuest
+     */
+    describeGuest: {
+        methodKind: "unary";
+        input: typeof DescribeGuestRequestSchema;
+        output: typeof GuestDescriptionSchema;
+    };
+    /**
+     * @generated from rpc clankerbox.v1.SessionService.CreateSession
+     */
+    createSession: {
+        methodKind: "unary";
+        input: typeof CreateSessionRequestSchema;
+        output: typeof SessionSchema;
+    };
+    /**
+     * @generated from rpc clankerbox.v1.SessionService.ListSessions
+     */
+    listSessions: {
+        methodKind: "unary";
+        input: typeof ListSessionsRequestSchema;
+        output: typeof ListSessionsResponseSchema;
+    };
+    /**
+     * @generated from rpc clankerbox.v1.SessionService.EndSession
+     */
+    endSession: {
+        methodKind: "unary";
+        input: typeof EndSessionRequestSchema;
+        output: typeof SessionSchema;
+    };
+    /**
+     * @generated from rpc clankerbox.v1.SessionService.AttachSession
+     */
+    attachSession: {
+        methodKind: "bidi_streaming";
+        input: typeof AttachmentRequestSchema;
+        output: typeof AttachmentEventSchema;
+    };
+}>;