@roj-ai/shared 0.0.2

package/dist/projections/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * View model types for client-side projections.
+ */
+import type { AgentCounters, AgentId, AgentPauseReason, AskUserInputType, ChatMessageId, DomainEvent, LLMCallId, MessageId, ProtocolAgentStatus, ToolCallId } from '@roj-ai/sdk';
+/**
+ * Agent tree node for visualization.
+ */
+export interface AgentTreeNode {
+    id: AgentId;
+    definitionName: string;
+    status: ProtocolAgentStatus;
+    parentId: AgentId | null;
+    children: AgentTreeNode[];
+    mailboxCount: number;
+    pendingToolCalls: number;
+    isExecuting: boolean;
+    cost: number;
+}
+/**
+ * Agent detail response - computed client-side from SessionState.
+ */
+export interface GetAgentDetailResponse {
+    id: AgentId;
+    definitionName: string;
+    status: ProtocolAgentStatus;
+    parentId: AgentId | null;
+    mailbox: MailboxMessageView[];
+    conversationHistory: ConversationMessageView[];
+    pendingToolCalls: ToolCallView[];
+    counters: AgentCounters;
+    loadedSkills: {
+        id: string;
+        name: string;
+        loadedAt: number;
+    }[];
+    cost: number;
+    typedInput?: unknown;
+    pauseReason?: AgentPauseReason;
+    pauseMessage?: string;
+}
+export interface MailboxMessageView {
+    id: MessageId;
+    from: string;
+    content: string;
+    timestamp: number;
+    consumed: boolean;
+}
+export type ConversationMessageView = UserConversationMessageView | AssistantConversationMessageView | ToolConversationMessageView | SystemConversationMessageView;
+export interface UserConversationMessageView {
+    role: 'user';
+    content: string;
+    fullContent: string;
+    timestamp?: number;
+}
+export interface AssistantConversationMessageView {
+    role: 'assistant';
+    content: string;
+    fullContent: string;
+    toolCalls?: {
+        id: ToolCallId;
+        name: string;
+        input: unknown;
+    }[];
+    timestamp?: number;
+    cost?: number;
+    llmCallId?: LLMCallId;
+    promptTokens?: number;
+    cachedTokens?: number;
+    cacheWriteTokens?: number;
+}
+export interface ToolConversationMessageView {
+    role: 'tool';
+    toolCallId: ToolCallId;
+    content: string;
+    fullContent: string;
+    isError: boolean;
+    timestamp?: number;
+}
+export interface SystemConversationMessageView {
+    role: 'system';
+    content: string;
+    fullContent: string;
+    timestamp?: number;
+}
+export interface ToolCallView {
+    id: ToolCallId;
+    name: string;
+    input: unknown;
+    status: 'pending' | 'executing' | 'completed' | 'failed';
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Events response - used by sessions.getEvents RPC method.
+ */
+export interface GetEventsResponse {
+    events: DomainEvent[];
+    total: number;
+    lastIndex: number;
+}
+/**
+ * Metrics view - computed client-side from events.
+ */
+export interface ProviderMetrics {
+    llmCalls: number;
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    totalCost: number;
+}
+export interface GetMetricsResponse {
+    totalTokens: number;
+    promptTokens: number;
+    completionTokens: number;
+    totalCost?: number;
+    llmCalls: number;
+    toolCalls: number;
+    agentCount: number;
+    durationMs: number;
+    byProvider: Record<string, ProviderMetrics>;
+}
+/**
+ * Timeline item representing an LLM call, tool execution, or context compaction.
+ */
+export interface TimelineItem {
+    id: string;
+    type: 'llm' | 'tool' | 'compaction';
+    agentId: AgentId;
+    agentName: string;
+    startedAt: number;
+    completedAt?: number;
+    durationMs?: number;
+    status: 'running' | 'success' | 'error';
+    model?: string;
+    promptTokens?: number;
+    completionTokens?: number;
+    cachedTokens?: number;
+    cacheWriteTokens?: number;
+    cost?: number;
+    llmCallId?: LLMCallId;
+    toolName?: string;
+    toolCallId?: ToolCallId;
+    toolInput?: unknown;
+    toolResult?: unknown;
+    originalTokens?: number;
+    compactedTokens?: number;
+    messagesRemoved?: number;
+    error?: string;
+}
+/**
+ * Message in the global mailbox view.
+ */
+export interface GlobalMailboxMessage {
+    id: MessageId;
+    fromAgentId: string;
+    fromAgentName: string;
+    toAgentId: AgentId;
+    toAgentName: string;
+    content: string;
+    timestamp: number;
+    consumed: boolean;
+}
+/**
+ * Debug chat message with links to related entities.
+ */
+export interface DebugChatMessage {
+    type: 'user_message' | 'agent_message' | 'ask_user';
+    messageId: MessageId | ChatMessageId;
+    content: string;
+    timestamp: number;
+    eventIndex: number;
+    agentId?: AgentId;
+    agentName?: string;
+    llmCallId?: LLMCallId;
+    toolCallId?: ToolCallId;
+    mailboxMessageId?: MessageId;
+    format?: 'text' | 'markdown';
+    inputType?: AskUserInputType;
+    answered?: boolean;
+    answer?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/projections/types.d.ts.map

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

package/dist/rpc/client.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Type-safe RPC Client
+ *
+ * Provides a fully typed interface for calling RPC methods.
+ * All method names and input/output types are validated at compile time.
+ *
+ * Supports both single calls and batch calls:
+ * - Single: rpc.call("method", input) -> Result<output, RpcErrorInfo>
+ * - Batch:  rpc.batch(b => [b.add("m1", i1), b.add("m2", i2)]) -> Result<[o1, o2], RpcErrorInfo>
+ */
+import type { RpcInput, RpcMethodName, RpcOutput } from '@roj-ai/sdk/rpc';
+import type { Result } from '../lib/result.js';
+/**
+ * Structured error info from RPC responses.
+ */
+export interface RpcErrorInfo {
+    type: string;
+    message: string;
+    details?: unknown;
+}
+/**
+ * RPC error class for backwards compatibility.
+ */
+export declare class RpcError extends Error {
+    status: number;
+    error: RpcErrorInfo;
+    constructor(status: number, error: RpcErrorInfo);
+}
+/**
+ * A typed marker for a batch call entry. Carries the output type at compile time.
+ */
+export interface BatchEntry<_T> {
+    readonly method: string;
+    readonly input: unknown;
+}
+/**
+ * Batch call builder. Collects typed entries for a batch RPC request.
+ */
+export declare class BatchBuilder {
+    add<M extends RpcMethodName>(method: M, input: RpcInput<M>): BatchEntry<RpcOutput<M>>;
+}
+/**
+ * Maps a tuple of BatchEntry<T> to a tuple of T.
+ */
+type BatchResults<T extends readonly BatchEntry<unknown>[]> = {
+    [K in keyof T]: T[K] extends BatchEntry<infer R> ? R : never;
+};
+/**
+ * Type-safe RPC client for calling server methods.
+ */
+export declare class RpcClient {
+    private baseUrl;
+    private projectId;
+    constructor(baseUrl?: string);
+    /**
+     * Get the base URL for non-RPC requests.
+     */
+    getBaseUrl(): string;
+    /**
+     * Set the project ID for DO-based RPC calls.
+     * When set, the projectId is added as a query parameter to /rpc requests.
+     */
+    setProjectId(projectId: string | null): void;
+    /**
+     * Get the currently configured project ID.
+     */
+    getProjectId(): string | null;
+    private getRpcUrl;
+    /**
+     * Call an RPC method with type-safe input and output.
+     */
+    call<M extends RpcMethodName>(method: M, input: RpcInput<M>): Promise<Result<RpcOutput<M>, RpcErrorInfo>>;
+    /**
+     * Execute multiple RPC calls as a batch.
+     */
+    batch<const T extends readonly BatchEntry<unknown>[]>(buildCalls: (b: BatchBuilder) => T): Promise<Result<BatchResults<T>, RpcErrorInfo>>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/rpc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/rpc/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IAE1B,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,YAAY;gBADnB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY;CAK3B;AAiBD;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,EAAE;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,qBAAa,YAAY;IACxB,GAAG,CAAC,CAAC,SAAS,aAAa,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;CAGrF;AAED;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI;KAC5D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK;CAC5D,CAAA;AAED;;GAEG;AACH,qBAAa,SAAS;IAGT,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,SAAS,CAAsB;gBAEnB,OAAO,GAAE,MAAW;IAExC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAI5C;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;IAI7B,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACG,IAAI,CAAC,CAAC,SAAS,aAAa,EACjC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,GAChB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAuB9C;;OAEG;IACG,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE,EACzD,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,CAAC,GAChC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;CAuCjD"}

package/dist/rpc/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * RPC Module - Shared re-exports for client/CLI consumers.
+ */
+export { BatchBuilder, type BatchEntry, RpcClient, RpcError, type RpcErrorInfo } from './client.js';
+export { Err, flatMapResult, isErr, isOk, mapResult, Ok, unwrapOr, unwrapOrThrow } from '../lib/result.js';
+export type { Result } from '../lib/result.js';
+export type { RpcInput, RpcMethodDef, RpcMethodName, RpcMethods, RpcOutput } from '@roj-ai/sdk/rpc';
+export type { AgentChatMessage, AskUserChatMessage, ChatMessage, UserChatMessage } from '@roj-ai/sdk/rpc';
+//# sourceMappingURL=index.d.ts.map

package/dist/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rpc/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAGnG,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAC1G,YAAY,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACnG,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/src/api-types.d.ts

@@ -0,0 +1,8 @@
+export type SandboxState = 'stopped' | 'starting' | 'running' | 'pausing' | 'paused' | 'failed';
+export interface WebhookEvent {
+    type: string;
+    instanceId: string;
+    organizationId: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}

package/dist/src/index.d.ts

@@ -0,0 +1,17 @@
+export type { WorkspaceConfig } from './workspace-config';
+export type { SandboxState, WebhookEvent } from './api-types';
+export { method, defineMethods } from './rpc/definition';
+export type { MethodDef, MethodInput, MethodOutput, RpcRequest, RpcResponse, RpcError } from './rpc/definition';
+export { platformMethods } from './rpc/methods';
+export type { PlatformMethods, PlatformMethodName } from './rpc/methods';
+export type * from './rpc/methods';
+export { adminMethods } from './rpc/admin-methods';
+export type { AdminMethods, AdminMethodName } from './rpc/admin-methods';
+export type * from './rpc/admin-methods';
+export { instanceMethods } from './rpc/instance-methods';
+export type { InstanceMethods, InstanceMethodName } from './rpc/instance-methods';
+export type * from './rpc/instance-methods';
+export { createRpcRouter } from './rpc/server';
+export type { RpcRouter, MethodHandler, MethodHandlers } from './rpc/server';
+export { createRpcClient } from './rpc/client';
+export type { RpcClient, RpcResult, RpcClientOptions } from './rpc/client';

package/dist/src/rpc/admin-methods.d.ts

@@ -0,0 +1,99 @@
+import type { PauseSandboxInput, ResumeSandboxInput, TerminateSandboxInput, RestartAgentInput, GetAgentLogsInput, GetAgentLogsOutput, SandboxActionOutput } from './methods';
+export interface DebugGetStatusInput {
+    instanceId: string;
+}
+export interface DebugGetStatusOutput {
+    sessions: Array<{
+        id: string;
+        presetId: string | null;
+        status: string;
+        sandboxId: string | null;
+    }>;
+    sandboxes: Array<{
+        id: string;
+        state: string;
+        e2bId: string | null;
+        lastActivityAt: number;
+    }>;
+    agentConnected: boolean;
+    connections: number;
+    initialization: {
+        phase: string | null;
+        error?: string | null;
+        sessionId?: string | null;
+    };
+    lifecycleEvents: Array<{
+        event: string;
+        detail?: string;
+        createdAt: number;
+    }>;
+    serviceUrls: Array<{
+        code: string;
+        sessionId: string | null;
+        serviceType: string | null;
+        port: number;
+    }>;
+}
+export interface DebugSandboxGetLogsInput {
+    instanceId: string;
+    sandboxId: string;
+    lines?: number;
+}
+export interface DebugSandboxGetLogsOutput {
+    logs: string;
+    truncated?: boolean;
+}
+export interface DebugSandboxActionInput {
+    instanceId: string;
+    sandboxId: string;
+    action: 'restartAgent' | 'redeployAgent' | 'pause' | 'resume' | 'terminate';
+}
+export type DebugSandboxActionOutput = null;
+export interface TransferSandboxInput {
+    instanceId: string;
+    sandboxId: string;
+}
+export interface TransferSandboxOutput {
+    newSandboxId: string;
+}
+export type EventLogCategory = 'rpc_in' | 'rpc_session' | 'rpc_agent' | 'sandbox' | 'agent_event' | 'ws' | 'dev_proxy';
+export interface DebugGetEventLogInput {
+    instanceId: string;
+    category?: EventLogCategory;
+    sessionId?: string;
+    sandboxId?: string;
+    correlation?: string;
+    since?: number;
+    until?: number;
+    limit?: number;
+}
+export interface DebugEventLogRow {
+    id: number;
+    ts: number;
+    category: string;
+    event: string;
+    status: string;
+    sessionId: string | null;
+    sandboxId: string | null;
+    method: string | null;
+    durationMs: number | null;
+    errorCode: string | null;
+    errorMsg: string | null;
+    correlation: string | null;
+    details: string | null;
+}
+export type DebugGetEventLogOutput = DebugEventLogRow[];
+export declare const adminMethods: {
+    'debug.getStatus': import("./definition").MethodDef<DebugGetStatusInput, DebugGetStatusOutput>;
+    'debug.sandboxGetLogs': import("./definition").MethodDef<DebugSandboxGetLogsInput, DebugSandboxGetLogsOutput>;
+    'debug.sandboxAction': import("./definition").MethodDef<DebugSandboxActionInput, null>;
+    'debug.getEventLog': import("./definition").MethodDef<DebugGetEventLogInput, DebugGetEventLogOutput>;
+    'sandbox.pause': import("./definition").MethodDef<PauseSandboxInput, SandboxActionOutput>;
+    'sandbox.resume': import("./definition").MethodDef<ResumeSandboxInput, SandboxActionOutput>;
+    'sandbox.terminate': import("./definition").MethodDef<TerminateSandboxInput, SandboxActionOutput>;
+    'sandbox.restartAgent': import("./definition").MethodDef<RestartAgentInput, SandboxActionOutput>;
+    'sandbox.logs': import("./definition").MethodDef<GetAgentLogsInput, GetAgentLogsOutput>;
+    'sandbox.transfer': import("./definition").MethodDef<TransferSandboxInput, TransferSandboxOutput>;
+};
+export type AdminMethods = typeof adminMethods;
+export type AdminMethodName = keyof AdminMethods;

package/dist/src/rpc/client.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Type-safe RPC client.
+ * Mirrors the method definitions for compile-time safety.
+ *
+ * Usage:
+ *   const client = createRpcClient<PlatformMethods>('https://api.buresh.cloud/rpc', {
+ *     headers: { Authorization: `Bearer ${apiKey}` },
+ *   })
+ *   const result = await client.call('instances.create', { ... })
+ */
+import type { MethodDef, MethodInput, MethodOutput, RpcError } from './definition';
+export interface RpcClientOptions {
+    headers?: Record<string, string>;
+    credentials?: RequestCredentials;
+}
+export interface RpcClient<Methods extends Record<string, MethodDef>> {
+    call<M extends string & keyof Methods>(method: M, input: MethodInput<Methods, M>): Promise<RpcResult<MethodOutput<Methods, M>>>;
+}
+export type RpcResult<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: RpcError;
+};
+export declare function createRpcClient<Methods extends Record<string, MethodDef>>(baseUrl: string, options?: RpcClientOptions): RpcClient<Methods>;

package/dist/src/rpc/definition.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Type-safe RPC definition system.
+ * No external dependencies — just TypeScript types + minimal runtime.
+ *
+ * Usage:
+ *   const methods = defineMethods({
+ *     'instances.create': method<CreateInput, CreateOutput>(),
+ *     'sessions.list': method<ListInput, ListOutput>(),
+ *   })
+ */
+/** Marker type for a method definition (input → output). */
+export interface MethodDef<I = unknown, O = unknown> {
+    readonly _input: I;
+    readonly _output: O;
+}
+/** Define a method type. Zero runtime cost — just a type marker. */
+export declare function method<I, O>(): MethodDef<I, O>;
+/** Define a set of methods. Returns the definition object as-is (typed). */
+export declare function defineMethods<T extends Record<string, MethodDef>>(methods: T): T;
+/** Extract input type from a method name. */
+export type MethodInput<Methods extends Record<string, MethodDef>, M extends keyof Methods> = Methods[M]['_input'];
+/** Extract output type from a method name. */
+export type MethodOutput<Methods extends Record<string, MethodDef>, M extends keyof Methods> = Methods[M]['_output'];
+/** RPC request envelope. */
+export interface RpcRequest<M extends string = string> {
+    method: M;
+    input: unknown;
+}
+/** RPC response envelope. */
+export interface RpcResponse<T = unknown> {
+    ok: boolean;
+    value?: T;
+    error?: RpcError;
+}
+export interface RpcError {
+    type: string;
+    message: string;
+    details?: unknown;
+}

package/dist/src/rpc/instance-methods.d.ts

@@ -0,0 +1,94 @@
+import type { PublishSessionOutput, GetAgentLogsOutput } from './methods';
+export type InstanceCreateSandboxInput = {};
+export interface InstanceCreateSandboxOutput {
+    sandboxId: string;
+}
+export interface InstancePauseSandboxInput {
+    sandboxId: string;
+}
+export type InstanceResumeSandboxInput = {};
+export interface InstanceTerminateSandboxInput {
+    sandboxId: string;
+}
+export interface InstanceRestartAgentInput {
+    sandboxId: string;
+}
+export interface InstanceGetAgentLogsInput {
+    sandboxId: string;
+    lines?: number;
+}
+export interface InstanceExecInSandboxInput {
+    command: string;
+}
+export interface InstanceExecInSandboxOutput {
+    stdout: string;
+    stderr: string;
+    success: boolean;
+}
+export interface InstanceValidateSandboxTokenInput {
+    sandboxId: string;
+    token: string;
+}
+export interface InstanceValidateSandboxTokenOutput {
+    value: boolean;
+}
+export interface InstanceCreateSessionInput {
+    presetId: string;
+}
+export interface InstanceCreateSessionOutput {
+    sessionId: string;
+}
+export type InstanceListSessionsInput = {};
+export interface InstanceListSessionsOutput {
+    sessions: Array<{
+        id: string;
+        presetId: string | null;
+        status: string;
+        createdAt: number;
+    }>;
+}
+export interface InstancePublishSessionInput {
+    sessionId: string;
+}
+export interface InstanceGetServiceUrlInput {
+    sessionId: string;
+    serviceType: string;
+}
+export interface InstanceGetServiceUrlOutput {
+    url: string | null;
+}
+export interface InstanceGetServiceUrlsInput {
+    sessionId: string;
+}
+export interface InstanceGetServiceUrlsOutput {
+    services: Array<{
+        serviceType: string;
+        code: string;
+        port: number;
+    }>;
+}
+export interface InstanceEnsureSandboxOutput {
+    sandboxId: string;
+    state: string;
+}
+export interface InstanceOkOutput {
+    ok: boolean;
+}
+export declare const instanceMethods: {
+    createSandbox: import("./definition").MethodDef<InstanceCreateSandboxInput, InstanceCreateSandboxOutput>;
+    pauseSandbox: import("./definition").MethodDef<InstancePauseSandboxInput, InstanceOkOutput>;
+    resumeSandbox: import("./definition").MethodDef<InstanceResumeSandboxInput, InstanceOkOutput>;
+    terminateSandbox: import("./definition").MethodDef<InstanceTerminateSandboxInput, InstanceOkOutput>;
+    restartAgent: import("./definition").MethodDef<InstanceRestartAgentInput, InstanceOkOutput>;
+    getAgentLogs: import("./definition").MethodDef<InstanceGetAgentLogsInput, GetAgentLogsOutput>;
+    execInSandbox: import("./definition").MethodDef<InstanceExecInSandboxInput, InstanceExecInSandboxOutput>;
+    validateSandboxToken: import("./definition").MethodDef<InstanceValidateSandboxTokenInput, InstanceValidateSandboxTokenOutput>;
+    createSession: import("./definition").MethodDef<InstanceCreateSessionInput, InstanceCreateSessionOutput>;
+    listSessions: import("./definition").MethodDef<InstanceListSessionsInput, InstanceListSessionsOutput>;
+    publishSession: import("./definition").MethodDef<InstancePublishSessionInput, PublishSessionOutput>;
+    getServiceUrl: import("./definition").MethodDef<InstanceGetServiceUrlInput, InstanceGetServiceUrlOutput>;
+    getServiceUrls: import("./definition").MethodDef<InstanceGetServiceUrlsInput, InstanceGetServiceUrlsOutput>;
+    ensureSandbox: import("./definition").MethodDef<{}, InstanceEnsureSandboxOutput>;
+};
+export type InstanceMethods = typeof instanceMethods;
+export type InstanceMethodName = keyof InstanceMethods;