@hypercli.com/sdk 2026.7.31 → 2026.8.11

package/dist/agents.d.ts

@@ -1,23 +1,30 @@
+import { type AgentSlot, type AgentSlotInventory } from './agent-slots.js';
+export { agentSlotFromDict, type AgentSlot, type AgentSlotInventory, type AgentSlotSize, } from './agent-slots.js';
 import { HTTPClient, type RequestOverrides } from './http.js';
 import { GatewayClient, type ChatAttachment, type ChatEvent, type GatewayIntegrationAuthStartParams, type GatewayIntegrationAuthStartResult, type GatewayIntegrationAuthStatusParams, type GatewayIntegrationAuthStatusResult, type GatewayIntegrationDisconnectParams, type GatewayIntegrationDisconnectResult, type GatewayIntegrationStatusParams, type GatewayIntegrationStatusResult, type GatewayOptions, type GatewaySessionsListResult, type GatewayWebLoginStartOptions, type GatewayWebLoginStartResult, type GatewayWebLoginWaitOptions, type GatewayWebLoginWaitResult, type GatewayWaitReadyOptions, type OpenClawConfigSchemaResponse, type OpenClawSlackRelayOptions } from './openclaw/gateway.js';
 import type { OpenClawTelegramConfigPatch, OpenClawWhatsAppConfigPatch } from './openclaw/channels.js';
 import type { OpenClawSlackHttpConfiguration, OpenClawSlackRelayConfiguration, OpenClawSlackSocketConfiguration } from './openclaw/slack.js';
+import { HermesApiClient } from './hermes/gateway.js';
 export declare const DEFAULT_OPENCLAW_IMAGE = "ghcr.io/hypercli/hypercli-openclaw:pro-latest";
 export declare const DEFAULT_OPENCLAW_PRO_IMAGE = "ghcr.io/hypercli/hypercli-openclaw:pro-latest";
+export declare const DEFAULT_HERMES_AGENT_IMAGE = "ghcr.io/hypercli/hypercli-hermes-agent:latest";
 export declare const DEFAULT_OPENCODE_IMAGE = "ghcr.io/hypercli/hypercli-opencode:latest";
 export declare const DEFAULT_CODEX_IMAGE = "ghcr.io/hypercli/hypercli-codex:latest";
 export declare const DEFAULT_CLAUDE_CODE_IMAGE = "ghcr.io/hypercli/hypercli-claude-code:latest";
 export declare const DEFAULT_GOOSE_IMAGE = "ghcr.io/hypercli/hypercli-goose:latest";
 export declare const DEFAULT_KIMI_CODE_IMAGE = "ghcr.io/hypercli/hypercli-kimi-code:latest";
+export declare const DEFAULT_BUZZ_AGENT_IMAGE = "ghcr.io/hypercli/hypercli-buzz-agent:latest";
 export declare const DEFAULT_BUZZ_OPENCODE_IMAGE = "ghcr.io/hypercli/hypercli-buzz-opencode:latest";
 export declare const DEFAULT_BUZZ_CODEX_IMAGE = "ghcr.io/hypercli/hypercli-buzz-codex:latest";
 export declare const DEFAULT_BUZZ_CLAUDE_CODE_IMAGE = "ghcr.io/hypercli/hypercli-buzz-claude:latest";
 export declare const DEFAULT_BUZZ_GOOSE_IMAGE = "ghcr.io/hypercli/hypercli-buzz-goose:latest";
 export declare const DEFAULT_BUZZ_KIMI_CODE_IMAGE = "ghcr.io/hypercli/hypercli-buzz-kimi-code:latest";
+export declare const DEFAULT_AGENT_RUNTIME_SCOPES: readonly string[];
 export declare const DEFAULT_CODING_AGENT_SYNC_ROOT = "/home/node";
-export type ManagedAgentRuntime = 'generic' | 'openclaw' | 'openclaw-pro' | 'opencode' | 'codex' | 'claude-code' | 'goose' | 'kimi-code';
-export type CodingAgentRuntime = Extract<ManagedAgentRuntime, 'opencode' | 'codex' | 'claude-code' | 'goose' | 'kimi-code'>;
+export type ManagedAgentRuntime = 'generic' | 'openclaw' | 'openclaw-pro' | 'hermes-agent' | 'buzz-agent' | 'opencode' | 'codex' | 'claude-code' | 'goose' | 'kimi-code';
+export type CodingAgentRuntime = Extract<ManagedAgentRuntime, 'buzz-agent' | 'opencode' | 'codex' | 'claude-code' | 'goose' | 'kimi-code'>;
 export declare const DEFAULT_CODING_AGENT_IMAGES: Readonly<Record<CodingAgentRuntime, string>>;
+export declare const DEFAULT_CODING_AGENT_SYNC_INCLUDES: Readonly<Record<CodingAgentRuntime, readonly string[]>>;
 export declare const DEFAULT_BUZZ_CODING_AGENT_IMAGES: Readonly<Record<CodingAgentRuntime, string>>;
 export declare const DEFAULT_BUZZ_RUST_LOG = "buzz_acp=info,pool::prompt=info,acp::stream=off";
 export declare const OPENCLAW_MEMORY_SEARCH_ENV_DEFAULTS: {
@@ -30,9 +37,12 @@ export declare const OPENCLAW_MEMORY_SEARCH_ENV_DEFAULTS: {
 };
 export declare const OPENCLAW_WORKSPACES_SYNC_ENV_DEFAULTS: {
     readonly HYPER_WORKSPACES_BOOT_SYNC: "1";
-    readonly HYPER_WORKSPACES_DIR: "/home/node/workspaces";
+    readonly HYPER_WORKSPACES_DIR: "/home/node/shared";
     readonly HYPER_WORKSPACES_SYNC_READY_ONLY: "1";
 };
+export declare const DEFAULT_HERMES_AGENT_SYNC_ROOT = "/opt/data";
+export declare const DEFAULT_HERMES_AGENT_SYNC_UID = 10000;
+export declare const DEFAULT_HERMES_AGENT_SYNC_GID = 10000;
 export declare const AGENT_FILE_MAX_BYTES: number;
 export declare const AGENT_FILE_TRANSFER_CHUNK_BYTES: number;
 export declare const AGENT_FILE_OPERATION_TIMEOUT_MS = 300000;
@@ -43,7 +53,6 @@ export interface AgentExecResult {
 }
 export interface AgentTokenResponse {
     agent_id?: string;
-    pod_id?: string;
     token?: string;
     jwt?: string;
     expires_at?: string | null;
@@ -53,15 +62,38 @@ export interface BrowserDesktopUrlOptions {
     resize?: string | null;
 }
 export interface AgentGatewayContext {
-    agent_id?: string;
-    hostname?: string | null;
-    gateway_token?: string | null;
+    agent_id: string;
+    gateway_url: string;
+    gateway_token: string;
+    launch_epoch: number;
+}
+export interface AgentEnvResponse {
+    agent_id: string;
+    env: Record<string, string>;
+    launch_epoch: number;
+}
+export interface AgentSecretNamesResponse {
+    agent_id: string;
+    names: string[];
+    launch_epoch: number;
+}
+export interface AgentSecretResponse {
+    agent_id: string;
+    key: string;
+    value: string;
+    launch_epoch: number;
 }
 export interface GatewayContextWaitOptions {
     timeoutMs?: number;
     retryIntervalMs?: number;
     signal?: AbortSignal;
 }
+export interface OpenClawOperationsSnapshot {
+    sessions: GatewaySessionsListResult | null;
+    cronJobs: any[] | null;
+    failures: Partial<Record<'sessions' | 'cron', string>>;
+    capturedAt: number;
+}
 export interface AgentShellTokenResponse {
     agent_id?: string;
     jwt: string;
@@ -125,6 +157,15 @@ export interface ListAgentsOptions extends RequestOverrides {
     query?: string | null;
     includeDeleted?: boolean | null;
 }
+export interface AgentCapacity {
+    items: Agent[];
+    totalAgents: number;
+    maxAgentsPerAccount: number;
+    runningAgents: number;
+    slots: Record<string, AgentSlotInventory>;
+    agentSlots: AgentSlot[];
+    pooledTpd: number;
+}
 export interface SlackOAuthStartOptions {
     relayBaseUrl: string;
     token: string;
@@ -218,15 +259,17 @@ export interface AgentRouteConfig {
     port: number;
     prefix?: string;
     auth?: boolean;
-    strip_prefix?: boolean;
-    [key: string]: any;
+}
+export interface AgentRoutesState {
+    agentId: string;
+    routes: Record<string, AgentRouteConfig>;
+    routeStatuses: Record<string, Record<string, unknown>>;
 }
 export type LaunchConfigFlatMap = Record<string, unknown>;
 export interface AgentDesktopConfigSource {
     launchConfig?: unknown;
     launch_config?: unknown;
     routes?: unknown;
-    ports?: unknown;
 }
 export interface RegistryAuth {
     username?: string;
@@ -236,18 +279,20 @@ export interface RegistryAuth {
 }
 export interface BuildAgentConfigOptions {
     env?: Record<string, string>;
-    ports?: Record<string, any>[] | null;
+    secrets?: Record<string, string>;
     routes?: Record<string, AgentRouteConfig> | null;
     command?: string[] | null;
     entrypoint?: string[] | null;
     image?: string | null;
     syncRoot?: string | null;
-    syncEnabled?: boolean | null;
+    syncInclude?: readonly string[] | null;
+    syncExclude?: readonly string[] | null;
     syncUid?: number | null;
     syncGid?: number | null;
     registryUrl?: string | null;
     registryAuth?: RegistryAuth | null;
     restart?: boolean | null;
+    runtimeScopes?: readonly string[] | null;
     gatewayToken?: string | null;
     heartbeat?: OpenClawHeartbeatConfig | null;
     /** Disable to avoid automatically locking browser control UI access to globalThis.location.origin. */
@@ -265,6 +310,11 @@ export interface OpenClawRouteOptions {
     gatewayPrefix?: string;
     desktopPrefix?: string;
 }
+export interface HermesAgentRouteOptions {
+    port?: number;
+    auth?: boolean;
+    prefix?: string;
+}
 export interface OpenClawMemoryIndexOptions {
     enabled?: boolean | null;
     onSessionStart?: boolean | null;
@@ -275,7 +325,6 @@ export interface OpenClawMemoryIndexOptions {
 }
 export interface OpenClawWorkspacesSyncOptions {
     enabled?: boolean | null;
-    outputDir?: string | null;
     readyOnly?: boolean | null;
     workspace?: string | null;
 }
@@ -304,7 +353,6 @@ export interface AgentUiAvatarMeta {
 }
 export interface AgentUiMeta {
     avatar?: AgentUiAvatarMeta | null;
-    [key: string]: any;
 }
 export interface AgentMeta {
     ui?: AgentUiMeta | null;
@@ -395,7 +443,7 @@ export interface UpdateAgentOptions {
     size?: string;
     launchConfig?: Record<string, any> | null;
     refreshFromLagoon?: boolean;
-    lastError?: string | null;
+    error?: string | null;
 }
 export interface OpenClawCreateAgentOptions extends CreateAgentOptions {
     openClawRoutes?: OpenClawRouteOptions | null;
@@ -409,6 +457,16 @@ export interface OpenClawStartAgentOptions extends StartAgentOptions {
     memoryIndex?: OpenClawMemoryIndexOptions | null;
     workspacesSync?: OpenClawWorkspacesSyncOptions | boolean | null;
 }
+export interface HermesAgentCreateOptions extends CreateAgentOptions {
+    hermesRoute?: HermesAgentRouteOptions | null;
+    /** Explicit inbound Hermes API credential; a fresh 32-byte key is generated when omitted. */
+    apiServerKey?: string | null;
+}
+export interface HermesAgentStartOptions extends StartAgentOptions {
+    hermesRoute?: HermesAgentRouteOptions | null;
+    /** Explicit inbound Hermes API credential; a fresh 32-byte key is generated when omitted. */
+    apiServerKey?: string | null;
+}
 export interface CodingAgentCreateOptions extends Omit<CreateAgentOptions, 'runtime' | 'injectGatewayToken'> {
     workspacesSync?: OpenClawWorkspacesSyncOptions | boolean | null;
     /** @deprecated Use the typed `buzz` launch contract. */
@@ -427,9 +485,11 @@ export interface BuzzLaunchConfig {
     parallelism?: number;
     respondTo?: string | null;
     respondToAllowlist?: string[];
+    displayName?: string | null;
+    textMentions?: boolean;
+    requireReply?: boolean;
     sessionTitle?: string | null;
     rustLog?: string;
-    restart?: boolean;
 }
 export interface RuntimeAuthMethod {
     id: string;
@@ -557,12 +617,33 @@ export interface AgentDirectoryListing {
     truncated?: boolean;
     [key: string]: any;
 }
-export type AgentState = 'PENDING' | 'RESTORING' | 'RESTORE_FAILED' | 'SYNCING' | 'SYNC_FAILED' | 'STARTING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'FAILED' | (string & {});
+export type AgentState = 'CREATING' | 'STARTING' | 'RESTORING' | 'RUNNING' | 'STOPPING' | 'STOPPED' | 'ARCHIVING' | 'ARCHIVED' | 'FAILED' | 'DELETED' | (string & {});
+/** Canonical states understood by this SDK. AgentState remains forward-open. */
+export declare const CANONICAL_AGENT_STATES: readonly ["CREATING", "STARTING", "RESTORING", "RUNNING", "STOPPING", "STOPPED", "ARCHIVING", "ARCHIVED", "FAILED", "DELETED"];
+export declare const AGENT_TRANSITIONAL_STATES: ReadonlySet<AgentState>;
+export declare const AGENT_RUNTIME_INACTIVE_STATES: ReadonlySet<AgentState>;
+export declare function isAgentTransitionalState(state: string): boolean;
+export declare function isAgentRuntimeInactiveState(state: string): boolean;
+export interface DeploymentTransitionEvent {
+    type: 'deployment.transition';
+    agent_id: string;
+    state?: AgentState;
+    reason?: string | null;
+    error?: string | null;
+    message?: string | null;
+    launch_epoch?: number;
+    resources_exist?: boolean;
+    namespace_exists?: boolean;
+}
+export type DeploymentEvent = DeploymentTransitionEvent;
+export interface DeploymentSubscribeOptions {
+    signal?: AbortSignal;
+    /** Runs after socket authentication and before transition frames are read. */
+    onReady?: () => void | Promise<void>;
+}
 export interface AgentStateFields {
     id: string;
     userId: string;
-    podId: string;
-    podName: string;
     state: AgentState;
     name?: string | null;
     handle?: string | null;
@@ -583,7 +664,9 @@ export interface AgentStateFields {
     jwtExpiresAt?: Date | null;
     startedAt?: Date | null;
     stoppedAt?: Date | null;
-    lastError?: string | null;
+    archivedAt?: Date | null;
+    clusterId?: string | null;
+    launchEpoch?: number;
     createdAt?: Date | null;
     updatedAt?: Date | null;
     launchConfig?: Record<string, any> | null;
@@ -591,14 +674,11 @@ export interface AgentStateFields {
     routes: Record<string, AgentRouteConfig>;
     command: string[];
     entrypoint: string[];
-    ports: Record<string, any>[];
     dryRun: boolean;
 }
 export interface AgentHydrationData {
     id?: string;
     user_id?: string;
-    pod_id?: string;
-    pod_name?: string;
     state?: AgentState;
     name?: string | null;
     handle?: string | null;
@@ -619,7 +699,9 @@ export interface AgentHydrationData {
     jwt_expires_at?: string | null;
     started_at?: string | null;
     stopped_at?: string | null;
-    last_error?: string | null;
+    archived_at?: string | null;
+    cluster_id?: string | null;
+    launch_epoch?: number;
     created_at?: string | null;
     updated_at?: string | null;
     launch_config?: Record<string, any> | null;
@@ -629,24 +711,21 @@ export interface AgentHydrationData {
     routes?: Record<string, AgentRouteConfig> | null;
     command?: string[] | null;
     entrypoint?: string[] | null;
-    ports?: Record<string, any>[] | null;
     dry_run?: boolean;
     openclaw_url?: string | null;
     gateway_url?: string | null;
-    gateway_token?: string | null;
     [key: string]: any;
 }
 export declare function flattenLaunchConfig(launchConfig: unknown): LaunchConfigFlatMap;
 export declare function getLaunchConfigValue(launchConfig: unknown, path: string | Array<string | number>): unknown;
 export declare function routesHaveDesktop(routes: unknown): boolean;
-export declare function portsHaveDesktop(ports: unknown): boolean;
 export declare function launchConfigHasDesktop(launchConfig: unknown): boolean;
 export declare function agentConfigHasDesktop(source: AgentDesktopConfigSource | null | undefined): boolean;
 export declare function buildBrowserDesktopUrl(desktopBaseUrl: string, token: string, options?: BrowserDesktopUrlOptions): string;
 export declare function resolveAgentsApiBase(apiBase: string): string;
 export declare function buildAgentConfig(config?: Record<string, any>, options?: BuildAgentConfigOptions): {
     config: Record<string, any>;
-    gatewayToken: string;
+    gatewayToken: string | null;
 };
 export declare function startSlackOAuth(options: SlackOAuthStartOptions): Promise<SlackOAuthStartResult>;
 export declare function getSlackInstallStatus(options: SlackInstallStatusOptions): Promise<SlackInstallStatus>;
@@ -654,13 +733,12 @@ export declare function listSlackDirectoryConversations(options: SlackDirectoryC
 export declare function listSlackDirectoryUsers(options: SlackDirectoryOptions): Promise<SlackDirectoryUsersResult>;
 export declare function attachSlackRelayAgent(options: AttachSlackRelayAgentOptions): Promise<AttachSlackRelayAgentResult>;
 export declare function buildOpenClawRoutes(options?: OpenClawRouteOptions): Record<string, AgentRouteConfig>;
+export declare function buildHermesAgentRoutes(options?: HermesAgentRouteOptions): Record<string, AgentRouteConfig>;
 export declare function buildOpenClawMemoryIndexEnv(memoryIndex?: OpenClawMemoryIndexOptions | null): Record<string, string>;
 export declare function buildOpenClawWorkspacesSyncEnv(workspacesSync?: OpenClawWorkspacesSyncOptions | boolean | null): Record<string, string>;
 export declare class Agent {
     readonly id: string;
     readonly userId: string;
-    readonly podId: string;
-    readonly podName: string;
     readonly state: string;
     readonly name: string | null;
     readonly handle: string | null;
@@ -681,7 +759,9 @@ export declare class Agent {
     jwtExpiresAt: Date | null;
     readonly startedAt: Date | null;
     readonly stoppedAt: Date | null;
-    readonly lastError: string | null;
+    readonly archivedAt: Date | null;
+    readonly clusterId: string | null;
+    readonly launchEpoch: number;
     readonly createdAt: Date | null;
     readonly updatedAt: Date | null;
     launchConfig: Record<string, any> | null;
@@ -689,7 +769,6 @@ export declare class Agent {
     routes: Record<string, AgentRouteConfig>;
     command: string[];
     entrypoint: string[];
-    ports: Record<string, any>[];
     readonly dryRun: boolean;
     _deployments: Deployments | null;
     constructor(fields: AgentStateFields);
@@ -701,8 +780,12 @@ export declare class Agent {
     get vncUrl(): string | null;
     browserDesktopUrl(token: string, options?: BrowserDesktopUrlOptions): string | null;
     get shellUrl(): string | null;
-    get executorUrl(): string | null;
     get isRunning(): boolean;
+    get isTransitioning(): boolean;
+    /** True when the agent is cold-restorable from its verified archive. */
+    get isArchived(): boolean;
+    /** True only for an explicitly included deletion tombstone. */
+    get isDeleted(): boolean;
     get hasDesktop(): boolean;
     protected requireDeployments(): Deployments;
     routeRequiresAuth(routeName: string, defaultValue?: boolean): boolean;
@@ -711,8 +794,9 @@ export declare class Agent {
     update(options: UpdateAgentOptions): Promise<Agent>;
     resize(options: Pick<UpdateAgentOptions, 'size'>): Promise<Agent>;
     env(): Promise<Record<string, string>>;
+    secretNames(): Promise<string[]>;
+    secret(key: string): Promise<string>;
     exec(command: string, options?: AgentExecOptions): Promise<AgentExecResult>;
-    health(): Promise<Record<string, any>>;
     /**
      * The gateway file writer a subclass supplies — the seam that enables the
      * `gateway` source. The base agent has none (gateway calls throw); an agent
@@ -745,10 +829,12 @@ export declare class Agent {
 export declare class RuntimeLoginSession {
     private readonly authClient;
     readonly socket: WebSocket;
+    private readonly requiresDeviceChallenge;
     output: string;
     verificationUrl: string | null;
     userCode: string | null;
     interactiveRequired: boolean;
+    private rawOutput;
     private exitCode;
     private readonly marker;
     private readonly completion;
@@ -756,7 +842,7 @@ export declare class RuntimeLoginSession {
     private complete;
     private markReady;
     private constructor();
-    static start(authClient: RuntimeAuthClient, command: string[], challengeTimeoutMs?: number): Promise<RuntimeLoginSession>;
+    static start(authClient: RuntimeAuthClient, command: string[], challengeTimeoutMs?: number, requiresDeviceChallenge?: boolean): Promise<RuntimeLoginSession>;
     private consume;
     send(text: string): void;
     wait(timeoutMs?: number): Promise<RuntimeAuthStatus>;
@@ -773,28 +859,56 @@ export declare class RuntimeAuthClient {
 }
 export declare class CodingAgent extends Agent {
     readonly runtime: CodingAgentRuntime;
+    static readonly defaultSyncInclude: readonly string[] | null;
     get auth(): RuntimeAuthClient;
 }
+export declare class BuzzAgent extends CodingAgent {
+    readonly runtime: 'buzz-agent';
+    static readonly defaultSyncInclude: readonly string[];
+    static fromDict(data: AgentHydrationData): BuzzAgent;
+}
 export declare class OpenCodeAgent extends CodingAgent {
     readonly runtime: 'opencode';
+    static readonly defaultSyncInclude: readonly string[];
     static fromDict(data: AgentHydrationData): OpenCodeAgent;
 }
 export declare class CodexAgent extends CodingAgent {
     readonly runtime: 'codex';
+    static readonly defaultSyncInclude: readonly string[];
     static fromDict(data: AgentHydrationData): CodexAgent;
 }
 export declare class ClaudeCodeAgent extends CodingAgent {
     readonly runtime: 'claude-code';
+    static readonly defaultSyncInclude: readonly string[];
     static fromDict(data: AgentHydrationData): ClaudeCodeAgent;
 }
 export declare class GooseAgent extends CodingAgent {
     readonly runtime: 'goose';
+    static readonly defaultSyncInclude: readonly string[];
     static fromDict(data: AgentHydrationData): GooseAgent;
 }
 export declare class KimiCodeAgent extends CodingAgent {
     readonly runtime: 'kimi-code';
+    static readonly defaultSyncInclude: readonly string[];
     static fromDict(data: AgentHydrationData): KimiCodeAgent;
 }
+export declare class HermesAgent extends Agent {
+    readonly runtime: 'hermes-agent';
+    readonly apiUrl: string | null;
+    readonly openaiBaseUrl: string | null;
+    /** Available only on the instance returned by createHermesAgent/startHermesAgent. */
+    apiServerKey: string | null;
+    constructor(fields: AgentStateFields & {
+        apiUrl?: string | null;
+        apiServerKey?: string | null;
+    });
+    static fromDict(data: AgentHydrationData): HermesAgent;
+    /** Create a client for this agent's authenticated Hermes API. */
+    get api(): HermesApiClient | null;
+    /** Require a ready URL and the one-time SDK-retained API server key. */
+    apiClient(): HermesApiClient;
+    waitRunning(timeoutMs?: number, pollIntervalMs?: number): Promise<HermesAgent>;
+}
 export declare class OpenClawAgent extends Agent {
     gatewayUrl: string | null;
     gatewayToken: string | null;
@@ -804,15 +918,7 @@ export declare class OpenClawAgent extends Agent {
     });
     static fromDict(data: AgentHydrationData): OpenClawAgent;
     protected static gatewayUrlFromHostname(hostname: string | null | undefined): string | null;
-    private currentGatewayHostname;
-    /**
-     * Resolve gateway context through the deployment record plus `/env`.
-     *
-     * Agent startup is eventually consistent: the deployment record may lag
-     * behind hostname attachment, and runtime env can lag behind both. The SDK
-     * derives the gateway URL from the attached hostname and reads the gateway
-     * token from `OPENCLAW_GATEWAY_TOKEN` in the agent env route.
-     */
+    /** Resolve OpenClaw connection context from the generic Agent and Secret APIs. */
     waitForGatewayContext(options?: GatewayContextWaitOptions): Promise<AgentGatewayContext>;
     resolveGatewayToken(): Promise<string | null>;
     gateway(options?: Omit<Partial<GatewayOptions>, 'url' | 'token'>): GatewayClient;
@@ -858,6 +964,7 @@ export declare class OpenClawAgent extends Agent {
     modelsList(options?: Omit<Partial<GatewayOptions>, 'url' | 'token'>): Promise<any[]>;
     sessionsList(options?: Omit<Partial<GatewayOptions>, 'url' | 'token'>): Promise<any[]>;
     sessionsListResult(options?: Omit<Partial<GatewayOptions>, 'url' | 'token'>): Promise<GatewaySessionsListResult>;
+    operationsSnapshot(options?: Omit<Partial<GatewayOptions>, 'url' | 'token'>): Promise<OpenClawOperationsSnapshot>;
     chatSend(message: string, sessionKey: string, options?: Omit<Partial<GatewayOptions>, 'url' | 'token'> & {
         attachments?: ChatAttachment[];
     }): AsyncGenerator<ChatEvent>;
@@ -935,14 +1042,16 @@ export declare class Deployments {
     private hydrateAgent;
     private getById;
     resolveAgent(agentIdOrName: string, requestOptions?: RequestOverrides): Promise<Agent>;
-    resolveAgentId(agentIdOrName: string, requestOptions?: RequestOverrides): Promise<string>;
+    resolveAgentId(agentIdOrName: string, requestOptions?: RequestOverrides, allowSelf?: boolean): Promise<string>;
     private agentIdFor;
     private fetchRaw;
     create(options?: CreateAgentOptions): Promise<Agent>;
     createOpenClaw(options?: OpenClawCreateAgentOptions): Promise<Agent>;
+    createHermesAgent(options?: HermesAgentCreateOptions): Promise<HermesAgent>;
     createOpenClawPro(options?: OpenClawCreateAgentOptions): Promise<Agent>;
     private createCodingAgent;
     createOpenCode(options?: CodingAgentCreateOptions): Promise<OpenCodeAgent>;
+    createBuzzAgent(options?: CodingAgentCreateOptions): Promise<BuzzAgent>;
     createCodex(options?: CodingAgentCreateOptions): Promise<CodexAgent>;
     createClaudeCode(options?: CodingAgentCreateOptions): Promise<ClaudeCodeAgent>;
     createGoose(options?: CodingAgentCreateOptions): Promise<GooseAgent>;
@@ -951,6 +1060,7 @@ export declare class Deployments {
     bootstrapInference(messages: BootstrapInferenceMessage[], responseFormat?: BootstrapInferenceResponseFormat, requestOptions?: RequestOverrides): Promise<BootstrapInferenceResult>;
     metrics(agentIdOrName: string): Promise<Record<string, any>>;
     list(options?: ListAgentsOptions): Promise<Agent[]>;
+    listWithCapacity(options?: ListAgentsOptions): Promise<AgentCapacity>;
     get(agentIdOrName: string, requestOptions?: RequestOverrides): Promise<Agent>;
     createExternalAgent(options: CreateExternalAgentOptions): Promise<Agent>;
     updateExternalAgent(externalAgentId: string, options: UpdateExternalAgentOptions): Promise<Agent>;
@@ -959,9 +1069,12 @@ export declare class Deployments {
     deleteExternalAgentProfileImage(externalAgentId: string): Promise<AgentProfileImageUploadResult>;
     rotateExternalAgentKey(agentIdOrName: string): Promise<Record<string, any>>;
     attachSlackRelayAgent(agentIdOrName: string, options: AttachDeploymentSlackRelayAgentOptions): Promise<AttachSlackRelayAgentResult>;
-    waitRunning(agentIdOrName: string, timeoutMs?: number, pollIntervalMs?: number): Promise<Agent>;
+    subscribe(handler: (event: DeploymentEvent) => void | Promise<void>, options?: DeploymentSubscribeOptions): Promise<void>;
+    waitForState(agentIdOrName: string, states: readonly AgentState[], timeoutMs?: number, failureStates?: readonly AgentState[], minimumLaunchEpoch?: number, pollIntervalMs?: number): Promise<Agent>;
+    waitRunning(agentIdOrName: string, timeoutMs?: number, pollIntervalMs?: number, minimumLaunchEpoch?: number): Promise<Agent>;
     start(agentIdOrName: string, options?: StartAgentOptions): Promise<Agent>;
     startOpenClaw(agentIdOrName: string, options?: OpenClawStartAgentOptions): Promise<Agent>;
+    startHermesAgent(agentIdOrName: string, options?: HermesAgentStartOptions): Promise<HermesAgent>;
     startOpenClawPro(agentIdOrName: string, options?: OpenClawStartAgentOptions): Promise<Agent>;
     update(agentIdOrName: string, options?: UpdateAgentOptions): Promise<Agent>;
     uploadProfileImage(agentId: string, content: Blob | ArrayBuffer | ArrayBufferView, contentType?: string): Promise<AgentProfileImageUploadResult>;
@@ -975,17 +1088,21 @@ export declare class Deployments {
      * deployment slot as released.
      */
     stop(agentIdOrName: string): Promise<Agent>;
+    /** Restore durable storage. The accepted snapshot is `RESTORING`; completion is `STOPPED`. */
+    restore(agentIdOrName: string): Promise<Agent>;
+    getRoutes(agentIdOrName: string): Promise<AgentRoutesState>;
+    setRoutes(agentIdOrName: string, routes: Record<string, AgentRouteConfig>): Promise<AgentRoutesState>;
+    setRoute(agentIdOrName: string, name: string, route: AgentRouteConfig): Promise<AgentRoutesState>;
+    removeRoute(agentIdOrName: string, name: string): Promise<AgentRoutesState>;
     delete(agentIdOrName: string): Promise<Record<string, any>>;
     refreshToken(agentIdOrName: string): Promise<AgentTokenResponse>;
     createScopedKey(agentIdOrName: string, name?: string): Promise<Record<string, any>>;
     webSearch(query: string, options?: BraveWebSearchOptions): Promise<BraveWebSearchResponse>;
     logsToken(agentIdOrName: string): Promise<AgentLogsTokenResponse>;
-    env(agentIdOrName: string, requestOptions?: RequestOverrides): Promise<{
-        agent_id: string;
-        env: Record<string, string>;
-    }>;
+    env(agentIdOrName: string, requestOptions?: RequestOverrides): Promise<AgentEnvResponse>;
+    secretNames(agentIdOrName: string, requestOptions?: RequestOverrides): Promise<AgentSecretNamesResponse>;
+    secret(agentIdOrName: string, key: string, requestOptions?: RequestOverrides): Promise<AgentSecretResponse>;
     exec(target: Agent | string, command: string, options?: AgentExecOptions): Promise<AgentExecResult>;
-    health(target: Agent): Promise<Record<string, any>>;
     filesList(target: Agent | string, path?: string, source?: 'auto' | 'pod' | 's3'): Promise<AgentFileEntry[]>;
     fileReadBytesWithMetadata(target: Agent | string, path: string, source?: 'auto' | 'pod' | 's3', options?: AgentFileReadOptions): Promise<AgentFileReadBytesResult>;
     fileReadBytes(target: Agent | string, path: string, source?: 'auto' | 'pod' | 's3', options?: AgentFileReadOptions): Promise<Uint8Array>;