@elizaos/app-core 2.0.0-alpha.37

package/dist/api/client.d.ts

@@ -0,0 +1,2823 @@
+/**
+ * API client for the Milady backend.
+ *
+ * Thin fetch wrapper + WebSocket for real-time chat/events.
+ * Replaces the gateway WebSocket protocol entirely.
+ */
+import type { AudioGenConfig, AudioGenProvider, CustomActionDef, CustomActionHandler, DatabaseProviderType, ImageConfig, ImageProvider, MediaConfig, MediaMode, ReleaseChannel, VideoConfig, VideoProvider, VisionConfig, VisionProvider } from "@elizaos/autonomous/contracts/config";
+import type { DropStatus, MintResult } from "@elizaos/autonomous/contracts/drop";
+import type { StylePreset } from "@elizaos/autonomous/contracts/onboarding";
+import type { AllPermissionsState, PermissionState, PermissionStatus, SystemPermissionDefinition, SystemPermissionId } from "@elizaos/autonomous/contracts/permissions";
+import type { VerificationResult } from "@elizaos/autonomous/contracts/verification";
+import type { BscTradeExecuteRequest, BscTradeExecuteResponse, BscTradePreflightResponse, BscTradeQuoteRequest, BscTradeQuoteResponse, BscTradeTxStatusResponse, BscTransferExecuteRequest, BscTransferExecuteResponse, EvmChainBalance, EvmNft, EvmTokenBalance, SolanaNft, SolanaTokenBalance, WalletAddresses, WalletBalancesResponse, WalletConfigStatus, WalletNftsResponse, TradePermissionMode as WalletTradePermissionMode, WalletTradingProfileResponse, WalletTradingProfileSourceFilter, WalletTradingProfileWindow } from "@elizaos/autonomous/contracts/wallet";
+import type { ConfigUiHint } from "../types";
+export type { AudioGenConfig, AudioGenProvider, CustomActionDef, CustomActionHandler, DatabaseProviderType, ImageConfig, ImageProvider, MediaConfig, MediaMode, ReleaseChannel, VideoConfig, VideoProvider, VisionConfig, VisionProvider, };
+export type { StylePreset };
+export type { BscTradeExecuteRequest, BscTradeExecuteResponse, BscTransferExecuteRequest, BscTransferExecuteResponse, BscTradePreflightResponse, BscTradeQuoteRequest, BscTradeQuoteResponse, BscTradeTxStatusResponse, EvmChainBalance, EvmNft, EvmTokenBalance, SolanaNft, SolanaTokenBalance, WalletAddresses, WalletBalancesResponse, WalletConfigStatus, WalletNftsResponse, WalletTradingProfileResponse, WalletTradingProfileSourceFilter, WalletTradingProfileWindow, };
+export type { DropStatus, MintResult };
+export type { VerificationResult };
+export type { AllPermissionsState, PermissionState, PermissionStatus, SystemPermissionId, SystemPermissionDefinition as PermissionDefinition, };
+export interface DatabaseStatus {
+    provider: DatabaseProviderType;
+    connected: boolean;
+    serverVersion: string | null;
+    tableCount: number;
+    pgliteDataDir: string | null;
+    postgresHost: string | null;
+}
+export interface DatabaseConfigResponse {
+    config: {
+        provider?: DatabaseProviderType;
+        pglite?: {
+            dataDir?: string;
+        };
+        postgres?: {
+            connectionString?: string;
+            host?: string;
+            port?: number;
+            database?: string;
+            user?: string;
+            password?: string;
+            ssl?: boolean;
+        };
+    };
+    activeProvider: DatabaseProviderType;
+    needsRestart: boolean;
+}
+export interface ConnectionTestResult {
+    success: boolean;
+    serverVersion: string | null;
+    error: string | null;
+    durationMs: number;
+}
+export interface TableInfo {
+    name: string;
+    schema: string;
+    rowCount: number;
+    columns: ColumnInfo[];
+}
+export interface ColumnInfo {
+    name: string;
+    type: string;
+    nullable: boolean;
+    defaultValue: string | null;
+    isPrimaryKey: boolean;
+}
+export interface TableRowsResponse {
+    table: string;
+    rows: Record<string, unknown>[];
+    columns: string[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+export interface QueryResult {
+    columns: string[];
+    rows: Record<string, unknown>[];
+    rowCount: number;
+    durationMs: number;
+}
+export type AgentState = "not_started" | "starting" | "running" | "stopped" | "restarting" | "error";
+export interface AgentStartupDiagnostics {
+    phase: string;
+    attempt: number;
+    lastError?: string;
+    lastErrorAt?: number;
+    nextRetryAt?: number;
+}
+export interface AgentStatus {
+    state: AgentState;
+    agentName: string;
+    model: string | undefined;
+    uptime: number | undefined;
+    startedAt: number | undefined;
+    pendingRestart?: boolean;
+    pendingRestartReasons?: string[];
+    startup?: AgentStartupDiagnostics;
+}
+export type AgentAutomationMode = "connectors-only" | "full";
+export type TradePermissionMode = WalletTradePermissionMode;
+export interface AgentAutomationModeResponse {
+    mode: AgentAutomationMode;
+    options: AgentAutomationMode[];
+}
+export interface TradePermissionModeResponse {
+    mode: TradePermissionMode;
+    options: TradePermissionMode[];
+}
+export interface ApplyProductionWalletDefaultsResponse {
+    ok: boolean;
+    profile: "pure-privy-safe";
+    walletMode: "privy";
+    tradePermissionMode: "user-sign-only";
+    bscExecutionEnabled: false;
+    clearedSecrets: string[];
+}
+export interface AgentSelfStatusSnapshot {
+    generatedAt: string;
+    state: AgentState;
+    agentName: string;
+    model: string | null;
+    provider: string | null;
+    automationMode: AgentAutomationMode;
+    tradePermissionMode: TradePermissionMode;
+    shellEnabled: boolean;
+    wallet: {
+        mode: "privy" | "hybrid";
+        evmAddress: string | null;
+        evmAddressShort: string | null;
+        solanaAddress: string | null;
+        solanaAddressShort: string | null;
+        hasWallet: boolean;
+        hasEvm: boolean;
+        hasSolana: boolean;
+        localSignerAvailable: boolean;
+        managedBscRpcReady: boolean;
+    };
+    plugins: {
+        totalActive: number;
+        active: string[];
+        aiProviders: string[];
+        connectors: string[];
+    };
+    capabilities: {
+        canTrade: boolean;
+        canLocalTrade: boolean;
+        canAutoTrade: boolean;
+        canUseBrowser: boolean;
+        canUseComputer: boolean;
+        canRunTerminal: boolean;
+        canInstallPlugins: boolean;
+        canConfigurePlugins: boolean;
+        canConfigureConnectors: boolean;
+    };
+}
+export type WebSocketConnectionState = "connected" | "disconnected" | "reconnecting" | "failed";
+export interface ConnectionStateInfo {
+    state: WebSocketConnectionState;
+    reconnectAttempt: number;
+    maxReconnectAttempts: number;
+    disconnectedAt: number | null;
+}
+export type ApiErrorKind = "timeout" | "network" | "http";
+export declare class ApiError extends Error {
+    readonly kind: ApiErrorKind;
+    readonly status?: number;
+    readonly path: string;
+    constructor(options: {
+        kind: ApiErrorKind;
+        path: string;
+        message: string;
+        status?: number;
+        cause?: unknown;
+    });
+}
+export declare function isApiError(value: unknown): value is ApiError;
+export interface RuntimeOrderItem {
+    index: number;
+    name: string;
+    className: string;
+    id: string | null;
+}
+export interface RuntimeServiceOrderItem {
+    index: number;
+    serviceType: string;
+    count: number;
+    instances: RuntimeOrderItem[];
+}
+export interface RuntimeDebugSnapshot {
+    runtimeAvailable: boolean;
+    generatedAt: number;
+    settings: {
+        maxDepth: number;
+        maxArrayLength: number;
+        maxObjectEntries: number;
+        maxStringLength: number;
+    };
+    meta: {
+        agentId?: string;
+        agentState: AgentState;
+        agentName: string;
+        model: string | null;
+        pluginCount: number;
+        actionCount: number;
+        providerCount: number;
+        evaluatorCount: number;
+        serviceTypeCount: number;
+        serviceCount: number;
+    };
+    order: {
+        plugins: RuntimeOrderItem[];
+        actions: RuntimeOrderItem[];
+        providers: RuntimeOrderItem[];
+        evaluators: RuntimeOrderItem[];
+        services: RuntimeServiceOrderItem[];
+    };
+    sections: {
+        runtime: unknown;
+        plugins: unknown;
+        actions: unknown;
+        providers: unknown;
+        evaluators: unknown;
+        services: unknown;
+    };
+}
+export type TriggerType = "interval" | "once" | "cron";
+export type TriggerWakeMode = "inject_now" | "next_autonomy_cycle";
+export type TriggerLastStatus = "success" | "error" | "skipped";
+export interface TriggerSummary {
+    id: string;
+    taskId: string;
+    displayName: string;
+    instructions: string;
+    triggerType: TriggerType;
+    enabled: boolean;
+    wakeMode: TriggerWakeMode;
+    createdBy: string;
+    timezone?: string;
+    intervalMs?: number;
+    scheduledAtIso?: string;
+    cronExpression?: string;
+    maxRuns?: number;
+    runCount: number;
+    nextRunAtMs?: number;
+    lastRunAtIso?: string;
+    lastStatus?: TriggerLastStatus;
+    lastError?: string;
+    updatedAt?: number;
+    updateInterval?: number;
+}
+export interface TriggerRunRecord {
+    triggerRunId: string;
+    triggerId: string;
+    taskId: string;
+    startedAt: number;
+    finishedAt: number;
+    status: TriggerLastStatus;
+    error?: string;
+    latencyMs: number;
+    source: "scheduler" | "manual";
+}
+export interface TriggerHealthSnapshot {
+    triggersEnabled: boolean;
+    activeTriggers: number;
+    disabledTriggers: number;
+    totalExecutions: number;
+    totalFailures: number;
+    totalSkipped: number;
+    lastExecutionAt?: number;
+}
+export interface CreateTriggerRequest {
+    displayName?: string;
+    instructions?: string;
+    triggerType?: TriggerType;
+    wakeMode?: TriggerWakeMode;
+    enabled?: boolean;
+    createdBy?: string;
+    timezone?: string;
+    intervalMs?: number;
+    scheduledAtIso?: string;
+    cronExpression?: string;
+    maxRuns?: number;
+}
+export interface UpdateTriggerRequest {
+    displayName?: string;
+    instructions?: string;
+    triggerType?: TriggerType;
+    wakeMode?: TriggerWakeMode;
+    enabled?: boolean;
+    timezone?: string;
+    intervalMs?: number;
+    scheduledAtIso?: string;
+    cronExpression?: string;
+    maxRuns?: number;
+}
+export interface MessageExample {
+    user: string;
+    content: {
+        text: string;
+    };
+}
+export interface ProviderOption {
+    id: string;
+    name: string;
+    envKey: string | null;
+    pluginName: string;
+    keyPrefix: string | null;
+    description: string;
+}
+export interface CloudProviderOption {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface ModelOption {
+    id: string;
+    name: string;
+    provider: string;
+    description: string;
+}
+export interface RpcProviderOption {
+    id: string;
+    name: string;
+    description: string;
+    envKey: string | null;
+    requiresKey: boolean;
+}
+export interface InventoryProviderOption {
+    id: string;
+    name: string;
+    description: string;
+    rpcProviders: RpcProviderOption[];
+}
+export interface OpenRouterModelOption {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface PiAiModelOption {
+    id: string;
+    name: string;
+    provider: string;
+    isDefault: boolean;
+}
+export interface OnboardingOptions {
+    names: string[];
+    styles: StylePreset[];
+    providers: ProviderOption[];
+    cloudProviders: CloudProviderOption[];
+    models: {
+        small: ModelOption[];
+        large: ModelOption[];
+    };
+    openrouterModels?: OpenRouterModelOption[];
+    piAiModels?: PiAiModelOption[];
+    piAiDefaultModel?: string | null;
+    inventoryProviders: InventoryProviderOption[];
+    sharedStyleRules: string;
+    githubOAuthAvailable?: boolean;
+}
+/** Configuration for a single messaging connector. */
+export interface ConnectorConfig {
+    enabled?: boolean;
+    botToken?: string;
+    token?: string;
+    apiKey?: string;
+    [key: string]: string | boolean | number | string[] | Record<string, unknown> | undefined;
+}
+export interface OnboardingData {
+    name: string;
+    runMode: "local" | "cloud";
+    /** Sandbox execution mode: "off" (rawdog), "light" (cloud), "standard" (local sandbox), "max". */
+    sandboxMode?: "off" | "light" | "standard" | "max";
+    bio: string[];
+    systemPrompt: string;
+    style?: {
+        all: string[];
+        chat: string[];
+        post: string[];
+    };
+    adjectives?: string[];
+    topics?: string[];
+    postExamples?: string[];
+    messageExamples?: MessageExample[][];
+    cloudProvider?: string;
+    smallModel?: string;
+    largeModel?: string;
+    provider?: string;
+    providerApiKey?: string;
+    /** Optional primary model override (provider/model), used by pi-ai mode. */
+    primaryModel?: string;
+    openrouterModel?: string;
+    subscriptionProvider?: string;
+    channels?: Record<string, unknown>;
+    inventoryProviders?: Array<{
+        chain: string;
+        rpcProvider: string;
+        rpcApiKey?: string;
+    }>;
+    connectors?: Record<string, ConnectorConfig>;
+    telegramToken?: string;
+    discordToken?: string;
+    whatsappSessionPath?: string;
+    twilioAccountSid?: string;
+    twilioAuthToken?: string;
+    twilioPhoneNumber?: string;
+    blooioApiKey?: string;
+    blooioPhoneNumber?: string;
+    githubToken?: string;
+}
+export interface SubscriptionProviderStatus {
+    provider: string;
+    configured: boolean;
+    valid: boolean;
+    expiresAt: number | null;
+}
+export interface SubscriptionStatusResponse {
+    providers: SubscriptionProviderStatus[];
+}
+export interface SandboxPlatformStatus {
+    platform: string;
+    arch?: string;
+    dockerInstalled?: boolean;
+    dockerAvailable?: boolean;
+    dockerRunning?: boolean;
+    appleContainerAvailable?: boolean;
+    wsl2?: boolean;
+    recommended?: string;
+}
+export interface SandboxStartResponse {
+    success: boolean;
+    message: string;
+    waitMs?: number;
+    error?: string;
+}
+export interface SandboxBrowserEndpoints {
+    cdpEndpoint?: string | null;
+    wsEndpoint?: string | null;
+    noVncEndpoint?: string | null;
+}
+export interface SandboxScreenshotRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface SandboxScreenshotPayload {
+    format: string;
+    encoding: string;
+    width: number | null;
+    height: number | null;
+    data: string;
+}
+export interface SandboxWindowInfo {
+    id: string;
+    title: string;
+    app: string;
+}
+export interface SecretInfo {
+    key: string;
+    description: string;
+    category: string;
+    sensitive: boolean;
+    required: boolean;
+    isSet: boolean;
+    maskedValue: string | null;
+    usedBy: Array<{
+        pluginId: string;
+        pluginName: string;
+        enabled: boolean;
+    }>;
+}
+export interface PluginParamDef {
+    key: string;
+    type: string;
+    description: string;
+    required: boolean;
+    sensitive: boolean;
+    default?: string;
+    /** Predefined options for dropdown selection (e.g. model names). */
+    options?: string[];
+    currentValue: string | null;
+    isSet: boolean;
+}
+export interface PluginInfo {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    enabled: boolean;
+    configured: boolean;
+    envKey: string | null;
+    category: "ai-provider" | "connector" | "streaming" | "database" | "app" | "feature";
+    source: "bundled" | "store";
+    parameters: PluginParamDef[];
+    validationErrors: Array<{
+        field: string;
+        message: string;
+    }>;
+    validationWarnings: Array<{
+        field: string;
+        message: string;
+    }>;
+    npmName?: string;
+    version?: string;
+    pluginDeps?: string[];
+    /** Whether this plugin is actually loaded and running in the runtime. */
+    isActive?: boolean;
+    /** Error message when plugin is installed but failed to load. */
+    loadError?: string;
+    /** Server-provided UI hints for plugin configuration fields. */
+    configUiHints?: Record<string, ConfigUiHint>;
+    /** Optional icon URL or emoji for the plugin card header. */
+    icon?: string | null;
+    homepage?: string;
+    repository?: string;
+    setupGuideUrl?: string;
+}
+export interface CorePluginEntry {
+    npmName: string;
+    id: string;
+    name: string;
+    isCore: boolean;
+    loaded: boolean;
+    enabled: boolean;
+}
+export interface CorePluginsResponse {
+    core: CorePluginEntry[];
+    optional: CorePluginEntry[];
+}
+export interface ChatMessage {
+    role: "user" | "assistant";
+    text: string;
+    timestamp: number;
+}
+export interface Conversation {
+    id: string;
+    title: string;
+    roomId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ConversationGreeting {
+    text: string;
+    agentName: string;
+    generated: boolean;
+    persisted?: boolean;
+}
+export interface CreateConversationOptions {
+    bootstrapGreeting?: boolean;
+    lang?: string;
+}
+/** A plain text content block. */
+export interface TextBlock {
+    type: "text";
+    text: string;
+}
+/** An inline config form block — renders ConfigRenderer in chat. */
+export interface ConfigFormBlock {
+    type: "config-form";
+    pluginId: string;
+    pluginName?: string;
+    schema: Record<string, unknown>;
+    hints?: Record<string, unknown>;
+    values?: Record<string, unknown>;
+}
+/** A UiSpec interactive UI block extracted from agent response. */
+export interface UiSpecBlock {
+    type: "ui-spec";
+    spec: Record<string, unknown>;
+    raw?: string;
+}
+/** Union of all content block types. */
+export type ContentBlock = TextBlock | ConfigFormBlock | UiSpecBlock;
+/** An image attachment to send with a chat message. */
+export interface ImageAttachment {
+    /** Base64-encoded image data (no data URL prefix). */
+    data: string;
+    mimeType: string;
+    name: string;
+}
+export interface ConfigSchemaResponse {
+    schema: unknown;
+    uiHints: Record<string, unknown>;
+    version: string;
+    generatedAt: string;
+}
+export interface ConversationMessage {
+    id: string;
+    role: "user" | "assistant";
+    text: string;
+    timestamp: number;
+    /** Structured content blocks (A2UI). When present, `text` is the fallback. */
+    blocks?: ContentBlock[];
+    /** Source channel when forwarded from another channel (e.g. "autonomy"). */
+    source?: string;
+    /** Username of the sender (e.g. retake viewer username, discord username). */
+    from?: string;
+    /** True when the SSE stream was interrupted before receiving a "done" event. */
+    interrupted?: boolean;
+}
+export type ConversationChannelType = "DM" | "GROUP" | "VOICE_DM" | "VOICE_GROUP" | "API";
+export interface ChatTokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    llmCalls?: number;
+    model?: string;
+}
+export type ConversationMode = "simple" | "power";
+export interface SkillInfo {
+    id: string;
+    name: string;
+    description: string;
+    enabled: boolean;
+    scanStatus?: "clean" | "warning" | "critical" | "blocked" | null;
+}
+export interface SkillScanReportSummary {
+    scannedAt: string;
+    status: "clean" | "warning" | "critical" | "blocked";
+    summary: {
+        scannedFiles: number;
+        critical: number;
+        warn: number;
+        info: number;
+    };
+    findings: Array<{
+        ruleId: string;
+        severity: string;
+        file: string;
+        line: number;
+        message: string;
+        evidence: string;
+    }>;
+    manifestFindings: Array<{
+        ruleId: string;
+        severity: string;
+        file: string;
+        message: string;
+    }>;
+    skillPath: string;
+}
+export interface CatalogSkillStats {
+    comments: number;
+    downloads: number;
+    installsAllTime: number;
+    installsCurrent: number;
+    stars: number;
+    versions: number;
+}
+export interface CatalogSkillVersion {
+    version: string;
+    createdAt: number;
+    changelog: string;
+}
+export interface CatalogSkill {
+    slug: string;
+    displayName: string;
+    summary: string | null;
+    tags: Record<string, string>;
+    stats: CatalogSkillStats;
+    createdAt: number;
+    updatedAt: number;
+    latestVersion: CatalogSkillVersion | null;
+    installed?: boolean;
+}
+export interface CatalogSearchResult {
+    slug: string;
+    displayName: string;
+    summary: string | null;
+    score: number;
+    latestVersion: string | null;
+    downloads: number;
+    stars: number;
+    installs: number;
+}
+export interface LogEntry {
+    timestamp: number;
+    level: string;
+    message: string;
+    source: string;
+    tags: string[];
+}
+export interface LogsResponse {
+    entries: LogEntry[];
+    sources: string[];
+    tags: string[];
+}
+export interface LogsFilter {
+    source?: string;
+    level?: string;
+    tag?: string;
+    since?: number;
+}
+export type SecurityAuditSeverity = "info" | "warn" | "error" | "critical";
+export type SecurityAuditEventType = "sandbox_mode_transition" | "secret_token_replacement_outbound" | "secret_sanitization_inbound" | "privileged_capability_invocation" | "policy_decision" | "signing_request_submitted" | "signing_request_rejected" | "signing_request_approved" | "plugin_fallback_attempt" | "security_kill_switch" | "sandbox_lifecycle" | "fetch_proxy_error";
+export interface SecurityAuditEntry {
+    timestamp: string;
+    type: SecurityAuditEventType;
+    summary: string;
+    metadata?: Record<string, string | number | boolean | null>;
+    severity: SecurityAuditSeverity;
+    traceId?: string;
+}
+export interface SecurityAuditFilter {
+    type?: SecurityAuditEventType;
+    severity?: SecurityAuditSeverity;
+    since?: number | string | Date;
+    limit?: number;
+}
+export interface SecurityAuditResponse {
+    entries: SecurityAuditEntry[];
+    totalBuffered: number;
+    replayed: true;
+}
+export type SecurityAuditStreamEvent = {
+    type: "snapshot";
+    entries: SecurityAuditEntry[];
+    totalBuffered: number;
+} | {
+    type: "entry";
+    entry: SecurityAuditEntry;
+};
+export type StreamEventType = "agent_event" | "heartbeat_event" | "training_event";
+export interface StreamEventEnvelope {
+    type: StreamEventType;
+    version: 1;
+    eventId: string;
+    ts: number;
+    runId?: string;
+    seq?: number;
+    stream?: string;
+    sessionKey?: string;
+    agentId?: string;
+    roomId?: string;
+    payload: object;
+}
+export type TrainingJobStatus = "queued" | "running" | "completed" | "failed" | "cancelled";
+export interface TrainingStatus {
+    runningJobs: number;
+    queuedJobs: number;
+    completedJobs: number;
+    failedJobs: number;
+    modelCount: number;
+    datasetCount: number;
+    runtimeAvailable: boolean;
+}
+export interface TrainingTrajectorySummary {
+    id: string;
+    trajectoryId: string;
+    agentId: string;
+    archetype: string | null;
+    createdAt: string;
+    totalReward: number | null;
+    aiJudgeReward: number | null;
+    episodeLength: number | null;
+    hasLlmCalls: boolean;
+    llmCallCount: number;
+}
+export interface TrainingTrajectoryDetail extends TrainingTrajectorySummary {
+    stepsJson: string;
+    aiJudgeReasoning: string | null;
+}
+export interface TrainingTrajectoryList {
+    available: boolean;
+    reason?: string;
+    total: number;
+    trajectories: TrainingTrajectorySummary[];
+}
+export interface TrainingDatasetRecord {
+    id: string;
+    createdAt: string;
+    jsonlPath: string;
+    trajectoryDir: string;
+    metadataPath: string;
+    sampleCount: number;
+    trajectoryCount: number;
+}
+export interface StartTrainingOptions {
+    datasetId?: string;
+    maxTrajectories?: number;
+    backend?: "mlx" | "cuda" | "cpu";
+    model?: string;
+    iterations?: number;
+    batchSize?: number;
+    learningRate?: number;
+}
+export interface TrainingJobRecord {
+    id: string;
+    createdAt: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    status: TrainingJobStatus;
+    phase: string;
+    progress: number;
+    error: string | null;
+    exitCode: number | null;
+    signal: string | null;
+    options: StartTrainingOptions;
+    datasetId: string;
+    pythonRoot: string;
+    scriptPath: string;
+    outputDir: string;
+    logPath: string;
+    modelPath: string | null;
+    adapterPath: string | null;
+    modelId: string | null;
+    logs: string[];
+}
+export interface TrainingModelRecord {
+    id: string;
+    createdAt: string;
+    jobId: string;
+    outputDir: string;
+    modelPath: string;
+    adapterPath: string | null;
+    sourceModel: string | null;
+    backend: "mlx" | "cuda" | "cpu";
+    ollamaModel: string | null;
+    active: boolean;
+    benchmark: {
+        status: "not_run" | "passed" | "failed";
+        lastRunAt: string | null;
+        output: string | null;
+    };
+}
+export type TrainingEventKind = "job_started" | "job_progress" | "job_log" | "job_completed" | "job_failed" | "job_cancelled" | "dataset_built" | "model_activated" | "model_imported";
+export interface TrainingStreamEvent {
+    kind: TrainingEventKind;
+    ts: number;
+    message: string;
+    jobId?: string;
+    modelId?: string;
+    datasetId?: string;
+    progress?: number;
+    phase?: string;
+}
+export interface AgentEventsResponse {
+    events: StreamEventEnvelope[];
+    latestEventId: string | null;
+    totalBuffered: number;
+    replayed: boolean;
+}
+export interface ExtensionStatus {
+    relayReachable: boolean;
+    relayPort: number;
+    extensionPath: string | null;
+}
+export interface RegistryPlugin {
+    name: string;
+    gitRepo: string;
+    gitUrl: string;
+    description: string;
+    homepage: string | null;
+    topics: string[];
+    stars: number;
+    language: string;
+    npm: {
+        package: string;
+        v0Version: string | null;
+        v1Version: string | null;
+        v2Version: string | null;
+    };
+    git: {
+        v0Branch: string | null;
+        v1Branch: string | null;
+        v2Branch: string | null;
+    };
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    installed: boolean;
+    installedVersion: string | null;
+    loaded: boolean;
+    bundled: boolean;
+    compatibility?: {
+        releaseAvailability: "bundled" | "post-release";
+        installSurface: "runtime" | "app";
+        postReleaseInstallable: boolean;
+        requiresDesktopRuntime: boolean;
+        requiresLocalRuntime: boolean;
+        note?: string;
+    };
+}
+export interface RegistrySearchResult {
+    name: string;
+    description: string;
+    score: number;
+    tags: string[];
+    latestVersion: string | null;
+    stars: number;
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    repository: string;
+}
+export interface InstalledPlugin {
+    name: string;
+    version: string;
+    installPath: string;
+    installedAt: string;
+}
+export interface PluginInstallResult {
+    ok: boolean;
+    plugin?: {
+        name: string;
+        version: string;
+        installPath: string;
+    };
+    requiresRestart?: boolean;
+    message?: string;
+    error?: string;
+}
+export interface WalletExportResult {
+    evm: {
+        privateKey: string;
+        address: string | null;
+    } | null;
+    solana: {
+        privateKey: string;
+        address: string | null;
+    } | null;
+}
+export interface UpdateStatus {
+    currentVersion: string;
+    channel: ReleaseChannel;
+    installMethod: string;
+    updateAvailable: boolean;
+    latestVersion: string | null;
+    channels: Record<ReleaseChannel, string | null>;
+    distTags: Record<ReleaseChannel, string>;
+    lastCheckAt: string | null;
+    error: string | null;
+}
+export interface CloudStatus {
+    connected: boolean;
+    enabled?: boolean;
+    hasApiKey?: boolean;
+    userId?: string;
+    organizationId?: string;
+    topUpUrl?: string;
+    reason?: string;
+}
+export interface CloudCredits {
+    connected: boolean;
+    balance: number | null;
+    low?: boolean;
+    critical?: boolean;
+    topUpUrl?: string;
+}
+export interface CloudBillingPaymentMethod {
+    id: string;
+    type: string;
+    label?: string;
+    brand?: string;
+    last4?: string;
+    expiryMonth?: number;
+    expiryYear?: number;
+    isDefault?: boolean;
+    walletAddress?: string;
+    network?: string;
+}
+export interface CloudBillingHistoryItem {
+    id: string;
+    kind?: string;
+    provider?: string;
+    status: string;
+    amount: number;
+    currency: string;
+    description?: string;
+    receiptUrl?: string;
+    createdAt: string;
+}
+export interface CloudBillingSummary {
+    balance: number | null;
+    currency?: string;
+    low?: boolean;
+    critical?: boolean;
+    topUpUrl?: string;
+    embeddedCheckoutEnabled?: boolean;
+    hostedCheckoutEnabled?: boolean;
+    cryptoEnabled?: boolean;
+    paymentMethods?: CloudBillingPaymentMethod[];
+    history?: CloudBillingHistoryItem[];
+    [key: string]: unknown;
+}
+export interface CloudBillingSettings {
+    success?: boolean;
+    message?: string;
+    error?: string;
+    settings?: {
+        autoTopUp?: {
+            enabled?: boolean;
+            amount?: number | null;
+            threshold?: number | null;
+            hasPaymentMethod?: boolean;
+        };
+        limits?: {
+            minAmount?: number;
+            maxAmount?: number;
+            minThreshold?: number;
+            maxThreshold?: number;
+        };
+    };
+    [key: string]: unknown;
+}
+export interface CloudBillingSettingsUpdateRequest {
+    autoTopUp?: {
+        enabled?: boolean;
+        amount?: number;
+        threshold?: number;
+    };
+}
+export interface CloudBillingCheckoutRequest {
+    amountUsd: number;
+    mode?: "embedded" | "hosted";
+}
+export interface CloudBillingCheckoutResponse {
+    success?: boolean;
+    provider?: string;
+    mode?: "embedded" | "hosted";
+    checkoutUrl?: string;
+    url?: string;
+    publishableKey?: string;
+    clientSecret?: string;
+    sessionId?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+export interface CloudBillingCryptoQuoteRequest {
+    amountUsd: number;
+    currency?: string;
+    network?: string;
+    walletAddress?: string;
+}
+export interface CloudBillingCryptoQuoteResponse {
+    success?: boolean;
+    provider?: string;
+    invoiceId?: string;
+    network?: string;
+    currency?: string;
+    amount?: string;
+    amountUsd?: number;
+    payToAddress?: string;
+    tokenAddress?: string;
+    paymentLinkUrl?: string;
+    expiresAt?: string;
+    memo?: string;
+    [key: string]: unknown;
+}
+export interface CloudLoginResponse {
+    ok: boolean;
+    sessionId: string;
+    browserUrl: string;
+    error?: string;
+}
+export interface CloudLoginPollResponse {
+    status: "pending" | "authenticated" | "expired" | "error";
+    keyPrefix?: string;
+    error?: string;
+}
+export interface CloudCompatAgent {
+    agent_id: string;
+    agent_name: string;
+    node_id: string | null;
+    container_id: string | null;
+    headscale_ip: string | null;
+    bridge_url: string | null;
+    web_ui_url: string | null;
+    status: string;
+    agent_config: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+    containerUrl: string;
+    webUiUrl: string | null;
+    database_status: string;
+    error_message: string | null;
+    last_heartbeat_at: string | null;
+}
+export interface CloudCompatAgentStatus {
+    status: string;
+    lastHeartbeat: string | null;
+    bridgeUrl: string | null;
+    webUiUrl: string | null;
+    currentNode: string | null;
+    suspendedReason: string | null;
+    databaseStatus: string;
+}
+export interface CloudCompatJob {
+    jobId: string;
+    type: string;
+    status: "queued" | "processing" | "completed" | "failed" | "retrying";
+    data: Record<string, unknown>;
+    result: Record<string, unknown> | null;
+    error: string | null;
+    createdAt: string;
+    startedAt: string | null;
+    completedAt: string | null;
+    retryCount: number;
+    id: string;
+    name: string;
+    state: string;
+    created_on: string;
+    completed_on: string | null;
+}
+export interface CloudCompatLaunchResult {
+    agentId: string;
+    agentName: string;
+    appUrl: string;
+    launchSessionId: string | null;
+    issuedAt: string;
+    connection: {
+        apiBase: string;
+        token: string;
+    };
+}
+export interface SkillMarketplaceResult {
+    id: string;
+    slug?: string;
+    name: string;
+    description: string;
+    githubUrl?: string;
+    repository?: string;
+    path?: string;
+    tags?: string[];
+    score?: number;
+    source?: string;
+}
+export interface ShareIngestPayload {
+    title?: string;
+    url?: string;
+    text?: string;
+    files?: Array<{
+        name: string;
+    }>;
+}
+export interface ShareIngestItem {
+    suggestedPrompt: string;
+    files: Array<{
+        name: string;
+    }>;
+}
+export interface WorkbenchTask {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    isCompleted: boolean;
+    updatedAt?: number;
+}
+export interface WorkbenchTodo {
+    id: string;
+    name: string;
+    description: string;
+    priority: number | null;
+    isUrgent: boolean;
+    isCompleted: boolean;
+    type: string;
+}
+export interface WorkbenchOverview {
+    tasks: WorkbenchTask[];
+    triggers: TriggerSummary[];
+    todos: WorkbenchTodo[];
+    autonomy?: {
+        enabled: boolean;
+        thinking: boolean;
+        lastEventAt?: number | null;
+    };
+}
+export interface CodingAgentSession {
+    sessionId: string;
+    agentType: string;
+    label: string;
+    originalTask: string;
+    workdir: string;
+    status: "active" | "blocked" | "completed" | "stopped" | "error" | "tool_running";
+    decisionCount: number;
+    autoResolvedCount: number;
+    /** Description of the active tool when status is "tool_running". */
+    toolDescription?: string;
+    /** Latest activity text for the agent activity box. */
+    lastActivity?: string;
+}
+export interface CodingAgentScratchWorkspace {
+    sessionId: string;
+    label: string;
+    path: string;
+    status: "pending_decision" | "kept" | "promoted";
+    createdAt: number;
+    terminalAt: number;
+    terminalEvent: "stopped" | "task_complete" | "error";
+    expiresAt?: number;
+}
+export interface AgentPreflightResult {
+    adapter?: string;
+    installed?: boolean;
+    installCommand?: string;
+    docsUrl?: string;
+}
+export interface CodingAgentStatus {
+    supervisionLevel: string;
+    taskCount: number;
+    tasks: CodingAgentSession[];
+    pendingConfirmations: number;
+}
+export interface McpServerConfig {
+    type: "stdio" | "streamable-http" | "sse";
+    command?: string;
+    args?: string[];
+    url?: string;
+    env?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+export interface McpMarketplaceResult {
+    name: string;
+    description?: string;
+    connectionType: string;
+    npmPackage?: string;
+    dockerImage?: string;
+}
+export interface McpRegistryServerDetail {
+    packages?: Array<{
+        environmentVariables: Array<{
+            name: string;
+            default?: string;
+            isRequired?: boolean;
+        }>;
+        packageArguments?: Array<{
+            default?: string;
+        }>;
+    }>;
+    remotes?: Array<{
+        type?: string;
+        url: string;
+        headers: Array<{
+            name: string;
+            isRequired?: boolean;
+        }>;
+    }>;
+}
+export interface McpServerStatus {
+    name: string;
+    connected: boolean;
+    error?: string;
+}
+export type VoiceProvider = "elevenlabs" | "simple-voice" | "edge";
+export type VoiceMode = "cloud" | "own-key";
+export interface VoiceConfig {
+    provider?: VoiceProvider;
+    mode?: VoiceMode;
+    elevenlabs?: {
+        apiKey?: string;
+        voiceId?: string;
+        modelId?: string;
+        stability?: number;
+        similarityBoost?: number;
+        speed?: number;
+    };
+    edge?: {
+        voice?: string;
+        lang?: string;
+        rate?: string;
+        pitch?: string;
+        volume?: string;
+    };
+}
+export interface CharacterData {
+    name?: string;
+    username?: string;
+    bio?: string | string[];
+    system?: string;
+    adjectives?: string[];
+    topics?: string[];
+    style?: {
+        all?: string[];
+        chat?: string[];
+        post?: string[];
+    };
+    messageExamples?: Array<{
+        examples: Array<{
+            name: string;
+            content: {
+                text: string;
+            };
+        }>;
+    }>;
+    postExamples?: string[];
+}
+export interface RegistryPluginItem {
+    name: string;
+    description: string;
+    stars: number;
+    repository: string;
+    topics: string[];
+    latestVersion: string | null;
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    npm: {
+        package: string;
+        v0Version: string | null;
+        v1Version: string | null;
+        v2Version: string | null;
+    };
+}
+export interface AppViewerAuthMessage {
+    type: string;
+    authToken?: string;
+    sessionToken?: string;
+    agentId?: string;
+}
+export interface AppViewerConfig {
+    url: string;
+    embedParams?: Record<string, string>;
+    postMessageAuth?: boolean;
+    sandbox?: string;
+    authMessage?: AppViewerAuthMessage;
+}
+export interface AppUiExtensionConfig {
+    detailPanelId: string;
+}
+export interface RegistryAppInfo {
+    name: string;
+    displayName: string;
+    description: string;
+    category: string;
+    launchType: string;
+    launchUrl: string | null;
+    icon: string | null;
+    capabilities: string[];
+    stars: number;
+    repository: string;
+    latestVersion: string | null;
+    supports: {
+        v0: boolean;
+        v1: boolean;
+        v2: boolean;
+    };
+    npm: {
+        package: string;
+        v0Version: string | null;
+        v1Version: string | null;
+        v2Version: string | null;
+    };
+    uiExtension?: AppUiExtensionConfig;
+    viewer?: AppViewerConfig;
+}
+export interface InstalledAppInfo {
+    name: string;
+    displayName: string;
+    version: string;
+    installPath: string;
+    installedAt: string;
+    isRunning: boolean;
+}
+export interface AppLaunchResult {
+    pluginInstalled: boolean;
+    needsRestart: boolean;
+    displayName: string;
+    launchType: string;
+    launchUrl: string | null;
+    viewer: AppViewerConfig | null;
+}
+export interface AppStopResult {
+    success: boolean;
+    appName: string;
+    stoppedAt: string;
+    pluginUninstalled: boolean;
+    needsRestart: boolean;
+    stopScope: "plugin-uninstalled" | "viewer-session" | "no-op";
+    message: string;
+}
+export type HyperscapeScriptedRole = "combat" | "woodcutting" | "fishing" | "mining" | "balanced";
+export type HyperscapeEmbeddedAgentControlAction = "start" | "stop" | "pause" | "resume";
+export type HyperscapeJsonValue = string | number | boolean | null | HyperscapeJsonValue[] | {
+    [key: string]: HyperscapeJsonValue;
+};
+export type HyperscapePosition = [number, number, number] | {
+    x: number;
+    y: number;
+    z: number;
+};
+export interface HyperscapeEmbeddedAgent {
+    agentId: string;
+    characterId: string;
+    accountId: string;
+    name: string;
+    scriptedRole: HyperscapeScriptedRole | null;
+    state: string;
+    entityId: string | null;
+    position: HyperscapePosition | null;
+    health: number | null;
+    maxHealth: number | null;
+    startedAt: number | null;
+    lastActivity: number | null;
+    error: string | null;
+}
+export interface HyperscapeEmbeddedAgentsResponse {
+    success: boolean;
+    agents: HyperscapeEmbeddedAgent[];
+    count: number;
+    error?: string;
+}
+export interface HyperscapeActionResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+export interface HyperscapeEmbeddedAgentMutationResponse extends HyperscapeActionResponse {
+    agent?: HyperscapeEmbeddedAgent | null;
+}
+export interface HyperscapeAvailableGoal {
+    id: string;
+    type: string;
+    description: string;
+    priority: number;
+}
+export interface HyperscapeGoalState {
+    type?: string;
+    description?: string;
+    progress?: number;
+    target?: number;
+    progressPercent?: number;
+    elapsedMs?: number;
+    startedAt?: number;
+    locked?: boolean;
+    lockedBy?: string;
+}
+export interface HyperscapeAgentGoalResponse {
+    success: boolean;
+    goal: HyperscapeGoalState | null;
+    availableGoals?: HyperscapeAvailableGoal[];
+    goalsPaused?: boolean;
+    message?: string;
+    error?: string;
+}
+export interface HyperscapeQuickCommand {
+    id: string;
+    label: string;
+    command: string;
+    icon: string;
+    available: boolean;
+    reason?: string;
+}
+export interface HyperscapeNearbyLocation {
+    id: string;
+    name: string;
+    type: string;
+    distance: number;
+}
+export interface HyperscapeInventoryItem {
+    id: string;
+    name: string;
+    slot: number;
+    quantity: number;
+    canEquip: boolean;
+    canUse: boolean;
+    canDrop: boolean;
+}
+export interface HyperscapeQuickActionsResponse {
+    success: boolean;
+    nearbyLocations: HyperscapeNearbyLocation[];
+    availableGoals: HyperscapeAvailableGoal[];
+    quickCommands: HyperscapeQuickCommand[];
+    inventory: HyperscapeInventoryItem[];
+    playerPosition: [number, number, number] | null;
+    message?: string;
+    error?: string;
+}
+export interface TrajectoryRecord {
+    id: string;
+    agentId: string;
+    roomId: string | null;
+    entityId: string | null;
+    conversationId: string | null;
+    source: string;
+    status: "active" | "completed" | "error";
+    startTime: number;
+    endTime: number | null;
+    durationMs: number | null;
+    llmCallCount: number;
+    providerAccessCount: number;
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TrajectoryLlmCall {
+    id: string;
+    trajectoryId: string;
+    stepId: string;
+    model: string;
+    systemPrompt: string;
+    userPrompt: string;
+    response: string;
+    temperature: number;
+    maxTokens: number;
+    purpose: string;
+    actionType: string;
+    latencyMs: number;
+    promptTokens?: number;
+    completionTokens?: number;
+    timestamp: number;
+    createdAt: string;
+}
+export interface TrajectoryProviderAccess {
+    id: string;
+    trajectoryId: string;
+    stepId: string;
+    providerName: string;
+    purpose: string;
+    data: Record<string, unknown>;
+    query?: Record<string, unknown>;
+    timestamp: number;
+    createdAt: string;
+}
+export interface TrajectoryListOptions {
+    limit?: number;
+    offset?: number;
+    source?: string;
+    status?: "active" | "completed" | "error";
+    startDate?: string;
+    endDate?: string;
+    search?: string;
+}
+export interface TrajectoryListResult {
+    trajectories: TrajectoryRecord[];
+    total: number;
+    offset: number;
+    limit: number;
+}
+export interface TrajectoryDetailResult {
+    trajectory: TrajectoryRecord;
+    llmCalls: TrajectoryLlmCall[];
+    providerAccesses: TrajectoryProviderAccess[];
+}
+export interface TrajectoryStats {
+    totalTrajectories: number;
+    totalLlmCalls: number;
+    totalProviderAccesses: number;
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    averageDurationMs: number;
+    bySource: Record<string, number>;
+    byModel: Record<string, number>;
+}
+export interface TrajectoryConfig {
+    enabled: boolean;
+}
+export type TrajectoryExportFormat = "json" | "csv" | "zip";
+export interface TrajectoryExportOptions {
+    format: TrajectoryExportFormat;
+    includePrompts?: boolean;
+    trajectoryIds?: string[];
+    startDate?: string;
+    endDate?: string;
+}
+export interface KnowledgeStats {
+    documentCount: number;
+    fragmentCount: number;
+    agentId: string;
+}
+export interface KnowledgeDocument {
+    id: string;
+    filename: string;
+    contentType: string;
+    fileSize: number;
+    createdAt: number;
+    fragmentCount: number;
+    source: string;
+    url?: string;
+    content?: {
+        text?: string;
+    };
+}
+export interface KnowledgeDocumentDetail extends KnowledgeDocument {
+    content: {
+        text?: string;
+    };
+}
+export interface KnowledgeDocumentsResponse {
+    documents: KnowledgeDocument[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+export interface KnowledgeFragment {
+    id: string;
+    text: string;
+    position?: number;
+    createdAt: number;
+}
+export interface KnowledgeFragmentsResponse {
+    documentId: string;
+    fragments: KnowledgeFragment[];
+    count: number;
+}
+export interface KnowledgeSearchResult {
+    id: string;
+    text: string;
+    similarity: number;
+    documentId?: string;
+    documentTitle?: string;
+    position?: number;
+}
+export interface KnowledgeSearchResponse {
+    query: string;
+    threshold: number;
+    results: KnowledgeSearchResult[];
+    count: number;
+}
+export interface KnowledgeUploadResult {
+    ok: boolean;
+    documentId: string;
+    fragmentCount: number;
+    filename?: string;
+    contentType?: string;
+    isYouTubeTranscript?: boolean;
+    warnings?: string[];
+}
+export interface KnowledgeBulkUploadItemResult {
+    index: number;
+    ok: boolean;
+    filename: string;
+    documentId?: string;
+    fragmentCount?: number;
+    error?: string;
+    warnings?: string[];
+}
+export interface KnowledgeBulkUploadResult {
+    ok: boolean;
+    total: number;
+    successCount: number;
+    failureCount: number;
+    results: KnowledgeBulkUploadItemResult[];
+}
+export interface MemorySearchResult {
+    id: string;
+    text: string;
+    createdAt: number;
+    score: number;
+}
+export interface MemorySearchResponse {
+    query: string;
+    results: MemorySearchResult[];
+    count: number;
+    limit: number;
+}
+export interface MemoryRememberResponse {
+    ok: boolean;
+    id: string;
+    text: string;
+    createdAt: number;
+}
+export interface QuickContextResponse {
+    query: string;
+    answer: string;
+    memories: MemorySearchResult[];
+    knowledge: KnowledgeSearchResult[];
+}
+export type WsEventHandler = (data: Record<string, unknown>) => void;
+export interface RegistryStatus {
+    registered: boolean;
+    tokenId: number;
+    agentName: string;
+    agentEndpoint: string;
+    capabilitiesHash: string;
+    isActive: boolean;
+    tokenURI: string;
+    walletAddress: string;
+    totalAgents: number;
+    configured: boolean;
+}
+export interface RegistrationResult {
+    tokenId: number;
+    txHash: string;
+}
+export interface RegistryConfig {
+    configured: boolean;
+    chainId: number;
+    registryAddress: string | null;
+    collectionAddress: string | null;
+    explorerUrl: string;
+}
+export interface WhitelistStatus {
+    eligible: boolean;
+    twitterVerified: boolean;
+    ogCode: string | null;
+    walletAddress: string;
+}
+export interface VerificationMessageResponse {
+    message: string;
+    walletAddress: string;
+}
+declare global {
+    interface Window {
+        __MILADY_API_BASE__?: string;
+        __MILADY_API_TOKEN__?: string;
+    }
+}
+export declare class MiladyClient {
+    private _baseUrl;
+    private _explicitBase;
+    private _token;
+    private readonly clientId;
+    private ws;
+    private wsHandlers;
+    private wsSendQueue;
+    private readonly wsSendQueueLimit;
+    private reconnectTimer;
+    private backoffMs;
+    private wsHasConnectedOnce;
+    private connectionState;
+    private reconnectAttempt;
+    private disconnectedAt;
+    private connectionStateListeners;
+    private readonly maxReconnectAttempts;
+    private _uiLanguage;
+    /** Store the current UI language so it can be sent as a header on every request. */
+    setUiLanguage(lang: string): void;
+    private static resolveElectronLocalFallbackBase;
+    private static generateClientId;
+    constructor(baseUrl?: string, token?: string);
+    /**
+     * Resolve the API base URL lazily.
+     * In Electron the main process injects window.__MILADY_API_BASE__ after the
+     * page loads (once the agent runtime starts). Re-checking on every call
+     * ensures we pick up the injected value even if it wasn't set at construction.
+     */
+    private get baseUrl();
+    private get apiToken();
+    hasToken(): boolean;
+    setToken(token: string | null): void;
+    setBaseUrl(baseUrl: string | null): void;
+    /** True when we have a usable HTTP(S) API endpoint. */
+    get apiAvailable(): boolean;
+    private rawRequest;
+    private fetch;
+    getStatus(): Promise<AgentStatus>;
+    getAgentSelfStatus(): Promise<AgentSelfStatusSnapshot>;
+    getRuntimeSnapshot(opts?: {
+        depth?: number;
+        maxArrayLength?: number;
+        maxObjectEntries?: number;
+        maxStringLength?: number;
+    }): Promise<RuntimeDebugSnapshot>;
+    setAutomationMode(mode: "connectors-only" | "full"): Promise<{
+        mode: string;
+    }>;
+    setTradeMode(mode: string): Promise<{
+        ok: boolean;
+        tradePermissionMode: string;
+    }>;
+    playEmote(emoteId: string): Promise<{
+        ok: boolean;
+    }>;
+    runTerminalCommand(command: string): Promise<{
+        ok: boolean;
+    }>;
+    getOnboardingStatus(): Promise<{
+        complete: boolean;
+    }>;
+    getAuthStatus(): Promise<{
+        required: boolean;
+        pairingEnabled: boolean;
+        expiresAt: number | null;
+    }>;
+    pair(code: string): Promise<{
+        token: string;
+    }>;
+    getOnboardingOptions(): Promise<OnboardingOptions>;
+    submitOnboarding(data: OnboardingData): Promise<void>;
+    startAnthropicLogin(): Promise<{
+        authUrl: string;
+    }>;
+    exchangeAnthropicCode(code: string): Promise<{
+        success: boolean;
+        expiresAt?: string;
+        error?: string;
+    }>;
+    submitAnthropicSetupToken(token: string): Promise<{
+        success: boolean;
+    }>;
+    getSubscriptionStatus(): Promise<SubscriptionStatusResponse>;
+    deleteSubscription(provider: string): Promise<{
+        success: boolean;
+    }>;
+    switchProvider(provider: string, apiKey?: string): Promise<{
+        success: boolean;
+        provider: string;
+        restarting: boolean;
+    }>;
+    startOpenAILogin(): Promise<{
+        authUrl: string;
+        state: string;
+        instructions: string;
+    }>;
+    exchangeOpenAICode(code: string): Promise<{
+        success: boolean;
+        expiresAt?: string;
+        accountId?: string;
+        error?: string;
+    }>;
+    getSandboxPlatform(): Promise<SandboxPlatformStatus>;
+    getSandboxBrowser(): Promise<SandboxBrowserEndpoints>;
+    getSandboxScreenshot(region?: SandboxScreenshotRegion): Promise<SandboxScreenshotPayload>;
+    getSandboxWindows(): Promise<{
+        windows: SandboxWindowInfo[];
+        error?: string;
+    }>;
+    startDocker(): Promise<SandboxStartResponse>;
+    startAgent(): Promise<AgentStatus>;
+    stopAgent(): Promise<AgentStatus>;
+    pauseAgent(): Promise<AgentStatus>;
+    resumeAgent(): Promise<AgentStatus>;
+    restartAgent(): Promise<AgentStatus>;
+    /**
+     * Restart the agent if possible, or wait for an in-progress restart to finish.
+     * Polls status until the agent state is "running".
+     */
+    restartAndWait(maxWaitMs?: number): Promise<AgentStatus>;
+    resetAgent(): Promise<void>;
+    getConfig(): Promise<Record<string, unknown>>;
+    getConfigSchema(): Promise<ConfigSchemaResponse>;
+    updateConfig(patch: Record<string, unknown>): Promise<Record<string, unknown>>;
+    uploadCustomVrm(file: File): Promise<void>;
+    /** Uses raw fetch instead of this.fetch() because HEAD returns no JSON body. */
+    hasCustomVrm(): Promise<boolean>;
+    uploadCustomBackground(file: File): Promise<void>;
+    /** Uses raw fetch instead of this.fetch() because HEAD returns no JSON body. */
+    hasCustomBackground(): Promise<boolean>;
+    getConnectors(): Promise<{
+        connectors: Record<string, ConnectorConfig>;
+    }>;
+    saveConnector(name: string, config: ConnectorConfig): Promise<{
+        connectors: Record<string, ConnectorConfig>;
+    }>;
+    deleteConnector(name: string): Promise<{
+        connectors: Record<string, ConnectorConfig>;
+    }>;
+    getTriggers(): Promise<{
+        triggers: TriggerSummary[];
+    }>;
+    getTrigger(id: string): Promise<{
+        trigger: TriggerSummary;
+    }>;
+    createTrigger(request: CreateTriggerRequest): Promise<{
+        trigger: TriggerSummary;
+    }>;
+    updateTrigger(id: string, request: UpdateTriggerRequest): Promise<{
+        trigger: TriggerSummary;
+    }>;
+    deleteTrigger(id: string): Promise<{
+        ok: boolean;
+    }>;
+    runTriggerNow(id: string): Promise<{
+        ok: boolean;
+        result: {
+            status: TriggerLastStatus;
+            error?: string;
+            taskDeleted: boolean;
+        };
+        trigger?: TriggerSummary;
+    }>;
+    getTriggerRuns(id: string): Promise<{
+        runs: TriggerRunRecord[];
+    }>;
+    getTriggerHealth(): Promise<TriggerHealthSnapshot>;
+    getTrainingStatus(): Promise<TrainingStatus>;
+    listTrainingTrajectories(opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<TrainingTrajectoryList>;
+    getTrainingTrajectory(trajectoryId: string): Promise<{
+        trajectory: TrainingTrajectoryDetail;
+    }>;
+    listTrainingDatasets(): Promise<{
+        datasets: TrainingDatasetRecord[];
+    }>;
+    buildTrainingDataset(options?: {
+        limit?: number;
+        minLlmCallsPerTrajectory?: number;
+    }): Promise<{
+        dataset: TrainingDatasetRecord;
+    }>;
+    listTrainingJobs(): Promise<{
+        jobs: TrainingJobRecord[];
+    }>;
+    startTrainingJob(options?: StartTrainingOptions): Promise<{
+        job: TrainingJobRecord;
+    }>;
+    getTrainingJob(jobId: string): Promise<{
+        job: TrainingJobRecord;
+    }>;
+    cancelTrainingJob(jobId: string): Promise<{
+        job: TrainingJobRecord;
+    }>;
+    listTrainingModels(): Promise<{
+        models: TrainingModelRecord[];
+    }>;
+    importTrainingModelToOllama(modelId: string, options?: {
+        modelName?: string;
+        baseModel?: string;
+        ollamaUrl?: string;
+    }): Promise<{
+        model: TrainingModelRecord;
+    }>;
+    activateTrainingModel(modelId: string, providerModel?: string): Promise<{
+        modelId: string;
+        providerModel: string;
+        needsRestart: boolean;
+    }>;
+    benchmarkTrainingModel(modelId: string): Promise<{
+        status: "passed" | "failed";
+        output: string;
+    }>;
+    getPlugins(): Promise<{
+        plugins: PluginInfo[];
+    }>;
+    fetchModels(provider: string, refresh?: boolean): Promise<{
+        provider: string;
+        models: unknown[];
+    }>;
+    getCorePlugins(): Promise<CorePluginsResponse>;
+    toggleCorePlugin(npmName: string, enabled: boolean): Promise<{
+        ok: boolean;
+        restarting?: boolean;
+        message?: string;
+    }>;
+    updatePlugin(id: string, config: Record<string, unknown>): Promise<{
+        ok: boolean;
+        restarting?: boolean;
+    }>;
+    getSecrets(): Promise<{
+        secrets: SecretInfo[];
+    }>;
+    updateSecrets(secrets: Record<string, string>): Promise<{
+        ok: boolean;
+        updated: string[];
+    }>;
+    testPluginConnection(id: string): Promise<{
+        success: boolean;
+        pluginId: string;
+        message?: string;
+        error?: string;
+        durationMs: number;
+    }>;
+    restart(): Promise<{
+        ok: boolean;
+    }>;
+    getSkills(): Promise<{
+        skills: SkillInfo[];
+    }>;
+    refreshSkills(): Promise<{
+        ok: boolean;
+        skills: SkillInfo[];
+    }>;
+    getLogs(filter?: LogsFilter): Promise<LogsResponse>;
+    private buildSecurityAuditParams;
+    getSecurityAudit(filter?: SecurityAuditFilter): Promise<SecurityAuditResponse>;
+    streamSecurityAudit(onEvent: (event: SecurityAuditStreamEvent) => void, filter?: SecurityAuditFilter, signal?: AbortSignal): Promise<void>;
+    getAgentEvents(opts?: {
+        afterEventId?: string;
+        limit?: number;
+        runId?: string;
+        fromSeq?: number;
+    }): Promise<AgentEventsResponse>;
+    getExtensionStatus(): Promise<ExtensionStatus>;
+    getSkillCatalog(opts?: {
+        page?: number;
+        perPage?: number;
+        sort?: string;
+    }): Promise<{
+        total: number;
+        page: number;
+        perPage: number;
+        totalPages: number;
+        skills: CatalogSkill[];
+    }>;
+    searchSkillCatalog(query: string, limit?: number): Promise<{
+        query: string;
+        count: number;
+        results: CatalogSearchResult[];
+    }>;
+    getSkillCatalogDetail(slug: string): Promise<{
+        skill: CatalogSkill;
+    }>;
+    refreshSkillCatalog(): Promise<{
+        ok: boolean;
+        count: number;
+    }>;
+    installCatalogSkill(slug: string, version?: string): Promise<{
+        ok: boolean;
+        slug: string;
+        message: string;
+        alreadyInstalled?: boolean;
+    }>;
+    uninstallCatalogSkill(slug: string): Promise<{
+        ok: boolean;
+        slug: string;
+        message: string;
+    }>;
+    getRegistryPlugins(): Promise<{
+        count: number;
+        plugins: RegistryPlugin[];
+    }>;
+    getRegistryPluginInfo(name: string): Promise<{
+        plugin: RegistryPlugin;
+    }>;
+    getInstalledPlugins(): Promise<{
+        count: number;
+        plugins: InstalledPlugin[];
+    }>;
+    installRegistryPlugin(name: string, autoRestart?: boolean): Promise<PluginInstallResult>;
+    uninstallRegistryPlugin(name: string, autoRestart?: boolean): Promise<{
+        ok: boolean;
+        pluginName: string;
+        message: string;
+        error?: string;
+    }>;
+    /**
+     * Export the agent as a password-encrypted .eliza-agent file.
+     * Returns the raw Response so the caller can stream the binary body.
+     */
+    exportAgent(password: string, includeLogs?: boolean): Promise<Response>;
+    /** Get an estimate of the export size. */
+    getExportEstimate(): Promise<{
+        estimatedBytes: number;
+        memoriesCount: number;
+        entitiesCount: number;
+        roomsCount: number;
+        worldsCount: number;
+        tasksCount: number;
+    }>;
+    /**
+     * Import an agent from a password-encrypted .eliza-agent file.
+     * Encodes the password and file into a binary envelope.
+     */
+    importAgent(password: string, fileBuffer: ArrayBuffer): Promise<{
+        success: boolean;
+        agentId: string;
+        agentName: string;
+        counts: Record<string, number>;
+    }>;
+    getCharacter(): Promise<{
+        character: CharacterData;
+        agentName: string;
+    }>;
+    getRandomName(): Promise<{
+        name: string;
+    }>;
+    generateCharacterField(field: string, context: {
+        name?: string;
+        system?: string;
+        bio?: string;
+        topics?: string[];
+        style?: {
+            all?: string[];
+            chat?: string[];
+            post?: string[];
+        };
+        postExamples?: string[];
+    }, mode?: "append" | "replace"): Promise<{
+        generated: string;
+    }>;
+    updateCharacter(character: CharacterData): Promise<{
+        ok: boolean;
+        character: CharacterData;
+        agentName: string;
+    }>;
+    getWalletAddresses(): Promise<WalletAddresses>;
+    getWalletBalances(): Promise<WalletBalancesResponse>;
+    getWalletNfts(): Promise<WalletNftsResponse>;
+    getWalletConfig(): Promise<WalletConfigStatus>;
+    updateWalletConfig(config: Record<string, string>): Promise<{
+        ok: boolean;
+    }>;
+    exportWalletKeys(exportToken: string): Promise<WalletExportResult>;
+    getBscTradePreflight(tokenAddress?: string): Promise<BscTradePreflightResponse>;
+    getBscTradeQuote(request: BscTradeQuoteRequest): Promise<BscTradeQuoteResponse>;
+    executeBscTrade(request: BscTradeExecuteRequest): Promise<BscTradeExecuteResponse>;
+    executeBscTransfer(request: BscTransferExecuteRequest): Promise<BscTransferExecuteResponse>;
+    getBscTradeTxStatus(hash: string): Promise<BscTradeTxStatusResponse>;
+    getWalletTradingProfile(window?: WalletTradingProfileWindow, source?: WalletTradingProfileSourceFilter): Promise<WalletTradingProfileResponse>;
+    applyProductionWalletDefaults(): Promise<ApplyProductionWalletDefaultsResponse>;
+    getUpdateStatus(force?: boolean): Promise<UpdateStatus>;
+    setUpdateChannel(channel: "stable" | "beta" | "nightly"): Promise<{
+        channel: string;
+    }>;
+    getCloudStatus(): Promise<CloudStatus>;
+    getCloudCredits(): Promise<CloudCredits>;
+    getCloudBillingSummary(): Promise<CloudBillingSummary>;
+    getCloudBillingSettings(): Promise<CloudBillingSettings>;
+    updateCloudBillingSettings(request: CloudBillingSettingsUpdateRequest): Promise<CloudBillingSettings>;
+    getCloudBillingPaymentMethods(): Promise<{
+        success?: boolean;
+        data?: CloudBillingPaymentMethod[];
+        items?: CloudBillingPaymentMethod[];
+        paymentMethods?: CloudBillingPaymentMethod[];
+        [key: string]: unknown;
+    }>;
+    getCloudBillingHistory(): Promise<{
+        success?: boolean;
+        data?: CloudBillingHistoryItem[];
+        items?: CloudBillingHistoryItem[];
+        history?: CloudBillingHistoryItem[];
+        [key: string]: unknown;
+    }>;
+    createCloudBillingCheckout(request: CloudBillingCheckoutRequest): Promise<CloudBillingCheckoutResponse>;
+    createCloudBillingCryptoQuote(request: CloudBillingCryptoQuoteRequest): Promise<CloudBillingCryptoQuoteResponse>;
+    cloudLogin(): Promise<CloudLoginResponse>;
+    cloudLoginPoll(sessionId: string): Promise<CloudLoginPollResponse>;
+    cloudDisconnect(): Promise<{
+        ok: boolean;
+    }>;
+    /** List all cloud-hosted agents for the authenticated user. */
+    getCloudCompatAgents(): Promise<{
+        success: boolean;
+        data: CloudCompatAgent[];
+    }>;
+    /** Create a new cloud-hosted agent. */
+    createCloudCompatAgent(opts: {
+        agentName: string;
+        agentConfig?: Record<string, unknown>;
+        environmentVars?: Record<string, string>;
+    }): Promise<{
+        success: boolean;
+        data: {
+            agentId: string;
+            agentName: string;
+            jobId: string;
+            status: string;
+            nodeId: string | null;
+            message: string;
+        };
+    }>;
+    /** Get a specific cloud-hosted agent by ID. */
+    getCloudCompatAgent(agentId: string): Promise<{
+        success: boolean;
+        data: CloudCompatAgent;
+    }>;
+    /** Delete a cloud-hosted agent. */
+    deleteCloudCompatAgent(agentId: string): Promise<{
+        success: boolean;
+        data: {
+            jobId: string;
+            status: string;
+            message: string;
+        };
+    }>;
+    /** Get status of a cloud-hosted agent. */
+    getCloudCompatAgentStatus(agentId: string): Promise<{
+        success: boolean;
+        data: CloudCompatAgentStatus;
+    }>;
+    /** Get logs from a cloud-hosted agent. */
+    getCloudCompatAgentLogs(agentId: string, tail?: number): Promise<{
+        success: boolean;
+        data: string;
+    }>;
+    /** Restart a cloud-hosted agent. */
+    restartCloudCompatAgent(agentId: string): Promise<{
+        success: boolean;
+        data: {
+            jobId: string;
+            status: string;
+            message: string;
+        };
+    }>;
+    /** Suspend a cloud-hosted agent. */
+    suspendCloudCompatAgent(agentId: string): Promise<{
+        success: boolean;
+        data: {
+            jobId: string;
+            status: string;
+            message: string;
+        };
+    }>;
+    /** Resume a cloud-hosted agent. */
+    resumeCloudCompatAgent(agentId: string): Promise<{
+        success: boolean;
+        data: {
+            jobId: string;
+            status: string;
+            message: string;
+        };
+    }>;
+    /** Launch a managed cloud agent into the Milady app. */
+    launchCloudCompatAgent(agentId: string): Promise<{
+        success: boolean;
+        data: CloudCompatLaunchResult;
+    }>;
+    /** Get cloud availability (capacity info). */
+    getCloudCompatAvailability(): Promise<{
+        success: boolean;
+        data: {
+            totalSlots: number;
+            usedSlots: number;
+            availableSlots: number;
+            acceptingNewAgents: boolean;
+        };
+    }>;
+    /** Poll a cloud job status by job ID. */
+    getCloudCompatJobStatus(jobId: string): Promise<{
+        success: boolean;
+        data: CloudCompatJob;
+    }>;
+    listApps(): Promise<RegistryAppInfo[]>;
+    searchApps(query: string): Promise<RegistryAppInfo[]>;
+    listInstalledApps(): Promise<InstalledAppInfo[]>;
+    stopApp(name: string): Promise<AppStopResult>;
+    getAppInfo(name: string): Promise<RegistryAppInfo>;
+    /** Launch an app: installs its plugin (if needed), returns viewer config for iframe. */
+    launchApp(name: string): Promise<AppLaunchResult>;
+    listRegistryPlugins(): Promise<RegistryPluginItem[]>;
+    searchRegistryPlugins(query: string): Promise<RegistryPluginItem[]>;
+    listHyperscapeEmbeddedAgents(): Promise<HyperscapeEmbeddedAgentsResponse>;
+    createHyperscapeEmbeddedAgent(input: {
+        characterId: string;
+        autoStart?: boolean;
+        scriptedRole?: HyperscapeScriptedRole;
+    }): Promise<HyperscapeEmbeddedAgentMutationResponse>;
+    controlHyperscapeEmbeddedAgent(characterId: string, action: HyperscapeEmbeddedAgentControlAction): Promise<HyperscapeEmbeddedAgentMutationResponse>;
+    sendHyperscapeEmbeddedAgentCommand(characterId: string, command: string, data?: {
+        [key: string]: HyperscapeJsonValue;
+    }): Promise<HyperscapeActionResponse>;
+    sendHyperscapeAgentMessage(agentId: string, content: string): Promise<HyperscapeActionResponse>;
+    getHyperscapeAgentGoal(agentId: string): Promise<HyperscapeAgentGoalResponse>;
+    getHyperscapeAgentQuickActions(agentId: string): Promise<HyperscapeQuickActionsResponse>;
+    searchSkillsMarketplace(query: string, installed: boolean, limit: number): Promise<{
+        results: SkillMarketplaceResult[];
+    }>;
+    getSkillsMarketplaceConfig(): Promise<{
+        keySet: boolean;
+    }>;
+    updateSkillsMarketplaceConfig(apiKey: string): Promise<{
+        keySet: boolean;
+    }>;
+    installMarketplaceSkill(data: {
+        slug?: string;
+        githubUrl?: string;
+        repository?: string;
+        path?: string;
+        name?: string;
+        description?: string;
+        source: string;
+        autoRefresh?: boolean;
+    }): Promise<void>;
+    uninstallMarketplaceSkill(skillId: string, autoRefresh: boolean): Promise<void>;
+    updateSkill(skillId: string, enabled: boolean): Promise<{
+        skill: SkillInfo;
+    }>;
+    createSkill(name: string, description: string): Promise<{
+        ok: boolean;
+        skill: SkillInfo;
+        path: string;
+    }>;
+    openSkill(id: string): Promise<{
+        ok: boolean;
+        path: string;
+    }>;
+    getSkillSource(id: string): Promise<{
+        ok: boolean;
+        skillId: string;
+        content: string;
+        path: string;
+    }>;
+    saveSkillSource(id: string, content: string): Promise<{
+        ok: boolean;
+        skillId: string;
+        skill: SkillInfo;
+    }>;
+    deleteSkill(id: string): Promise<{
+        ok: boolean;
+        skillId: string;
+        source: string;
+    }>;
+    getSkillScanReport(id: string): Promise<{
+        ok: boolean;
+        report: SkillScanReportSummary | null;
+        acknowledged: boolean;
+        acknowledgment: {
+            acknowledgedAt: string;
+            findingCount: number;
+        } | null;
+    }>;
+    acknowledgeSkill(id: string, enable: boolean): Promise<{
+        ok: boolean;
+        skillId: string;
+        acknowledged: boolean;
+        enabled: boolean;
+        findingCount: number;
+    }>;
+    getWorkbenchOverview(): Promise<WorkbenchOverview & {
+        tasksAvailable?: boolean;
+        triggersAvailable?: boolean;
+        todosAvailable?: boolean;
+    }>;
+    listWorkbenchTasks(): Promise<{
+        tasks: WorkbenchTask[];
+    }>;
+    getWorkbenchTask(taskId: string): Promise<{
+        task: WorkbenchTask;
+    }>;
+    createWorkbenchTask(data: {
+        name: string;
+        description?: string;
+        tags?: string[];
+        isCompleted?: boolean;
+    }): Promise<{
+        task: WorkbenchTask;
+    }>;
+    updateWorkbenchTask(taskId: string, data: {
+        name?: string;
+        description?: string;
+        tags?: string[];
+        isCompleted?: boolean;
+    }): Promise<{
+        task: WorkbenchTask;
+    }>;
+    deleteWorkbenchTask(taskId: string): Promise<{
+        ok: boolean;
+    }>;
+    listWorkbenchTodos(): Promise<{
+        todos: WorkbenchTodo[];
+    }>;
+    getWorkbenchTodo(todoId: string): Promise<{
+        todo: WorkbenchTodo;
+    }>;
+    createWorkbenchTodo(data: {
+        name: string;
+        description?: string;
+        priority?: number;
+        isUrgent?: boolean;
+        type?: string;
+        isCompleted?: boolean;
+    }): Promise<{
+        todo: WorkbenchTodo;
+    }>;
+    updateWorkbenchTodo(todoId: string, data: {
+        name?: string;
+        description?: string;
+        priority?: number;
+        isUrgent?: boolean;
+        type?: string;
+        isCompleted?: boolean;
+    }): Promise<{
+        todo: WorkbenchTodo;
+    }>;
+    setWorkbenchTodoCompleted(todoId: string, isCompleted: boolean): Promise<void>;
+    deleteWorkbenchTodo(todoId: string): Promise<{
+        ok: boolean;
+    }>;
+    refreshRegistry(): Promise<void>;
+    getKnowledgeStats(): Promise<KnowledgeStats>;
+    listKnowledgeDocuments(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<KnowledgeDocumentsResponse>;
+    getKnowledgeDocument(documentId: string): Promise<{
+        document: KnowledgeDocumentDetail;
+    }>;
+    deleteKnowledgeDocument(documentId: string): Promise<{
+        ok: boolean;
+        deletedFragments: number;
+    }>;
+    uploadKnowledgeDocument(data: {
+        content: string;
+        filename: string;
+        contentType?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<KnowledgeUploadResult>;
+    uploadKnowledgeDocumentsBulk(data: {
+        documents: Array<{
+            content: string;
+            filename: string;
+            contentType?: string;
+            metadata?: Record<string, unknown>;
+        }>;
+    }): Promise<KnowledgeBulkUploadResult>;
+    uploadKnowledgeFromUrl(url: string, metadata?: Record<string, unknown>): Promise<KnowledgeUploadResult>;
+    searchKnowledge(query: string, options?: {
+        threshold?: number;
+        limit?: number;
+    }): Promise<KnowledgeSearchResponse>;
+    getKnowledgeFragments(documentId: string): Promise<KnowledgeFragmentsResponse>;
+    rememberMemory(text: string): Promise<MemoryRememberResponse>;
+    searchMemory(query: string, options?: {
+        limit?: number;
+    }): Promise<MemorySearchResponse>;
+    quickContext(query: string, options?: {
+        limit?: number;
+    }): Promise<QuickContextResponse>;
+    getMcpConfig(): Promise<{
+        servers: Record<string, McpServerConfig>;
+    }>;
+    getMcpStatus(): Promise<{
+        servers: McpServerStatus[];
+    }>;
+    searchMcpMarketplace(query: string, limit: number): Promise<{
+        results: McpMarketplaceResult[];
+    }>;
+    getMcpServerDetails(name: string): Promise<{
+        server: McpRegistryServerDetail;
+    }>;
+    addMcpServer(name: string, config: McpServerConfig): Promise<void>;
+    removeMcpServer(name: string): Promise<void>;
+    ingestShare(payload: ShareIngestPayload): Promise<{
+        item: ShareIngestItem;
+    }>;
+    consumeShareIngest(): Promise<{
+        items: ShareIngestItem[];
+    }>;
+    connectWs(): void;
+    private scheduleReconnect;
+    private emitConnectionStateChange;
+    /** Get the current WebSocket connection state. */
+    getConnectionState(): ConnectionStateInfo;
+    /** Subscribe to connection state changes. Returns an unsubscribe function. */
+    onConnectionStateChange(listener: (state: ConnectionStateInfo) => void): () => void;
+    /** Reset connection state and restart reconnection attempts. */
+    resetConnection(): void;
+    /** Send an arbitrary JSON message over the WebSocket connection. */
+    sendWsMessage(data: Record<string, unknown>): void;
+    onWsEvent(type: string, handler: WsEventHandler): () => void;
+    private normalizeAssistantText;
+    private normalizeGreetingText;
+    private normalizeConversationMessage;
+    private streamChatEndpoint;
+    /**
+     * Send a chat message via the REST endpoint (reliable — does not depend on
+     * a WebSocket connection).  Returns the agent's response text.
+     */
+    sendChatRest(text: string, channelType?: ConversationChannelType, conversationMode?: ConversationMode): Promise<{
+        text: string;
+        agentName: string;
+    }>;
+    sendChatStream(text: string, onToken: (token: string, accumulatedText?: string) => void, channelType?: ConversationChannelType, signal?: AbortSignal, conversationMode?: ConversationMode): Promise<{
+        text: string;
+        agentName: string;
+        completed: boolean;
+        usage?: ChatTokenUsage;
+    }>;
+    listConversations(): Promise<{
+        conversations: Conversation[];
+    }>;
+    createConversation(title?: string, options?: CreateConversationOptions): Promise<{
+        conversation: Conversation;
+        greeting?: ConversationGreeting;
+    }>;
+    getConversationMessages(id: string): Promise<{
+        messages: ConversationMessage[];
+    }>;
+    truncateConversationMessages(id: string, messageId: string, options?: {
+        inclusive?: boolean;
+    }): Promise<{
+        ok: boolean;
+        deletedCount: number;
+    }>;
+    sendConversationMessage(id: string, text: string, channelType?: ConversationChannelType, images?: ImageAttachment[], conversationMode?: ConversationMode): Promise<{
+        text: string;
+        agentName: string;
+        blocks?: ContentBlock[];
+    }>;
+    sendConversationMessageStream(id: string, text: string, onToken: (token: string, accumulatedText?: string) => void, channelType?: ConversationChannelType, signal?: AbortSignal, images?: ImageAttachment[], conversationMode?: ConversationMode): Promise<{
+        text: string;
+        agentName: string;
+        completed: boolean;
+        usage?: ChatTokenUsage;
+    }>;
+    requestGreeting(id: string, lang?: string): Promise<{
+        text: string;
+        agentName: string;
+        generated: boolean;
+        persisted?: boolean;
+    }>;
+    renameConversation(id: string, title: string): Promise<{
+        conversation: Conversation;
+    }>;
+    deleteConversation(id: string): Promise<{
+        ok: boolean;
+    }>;
+    /** @deprecated Prefer {@link sendChatRest} — WebSocket chat may silently drop messages. */
+    sendChat(text: string): void;
+    getDatabaseStatus(): Promise<DatabaseStatus>;
+    getDatabaseConfig(): Promise<DatabaseConfigResponse>;
+    saveDatabaseConfig(config: {
+        provider?: DatabaseProviderType;
+        pglite?: {
+            dataDir?: string;
+        };
+        postgres?: {
+            connectionString?: string;
+            host?: string;
+            port?: number;
+            database?: string;
+            user?: string;
+            password?: string;
+            ssl?: boolean;
+        };
+    }): Promise<{
+        saved: boolean;
+        needsRestart: boolean;
+    }>;
+    testDatabaseConnection(creds: {
+        connectionString?: string;
+        host?: string;
+        port?: number;
+        database?: string;
+        user?: string;
+        password?: string;
+        ssl?: boolean;
+    }): Promise<ConnectionTestResult>;
+    getDatabaseTables(): Promise<{
+        tables: TableInfo[];
+    }>;
+    getDatabaseRows(table: string, opts?: {
+        offset?: number;
+        limit?: number;
+        sort?: string;
+        order?: "asc" | "desc";
+        search?: string;
+    }): Promise<TableRowsResponse>;
+    insertDatabaseRow(table: string, data: Record<string, unknown>): Promise<{
+        inserted: boolean;
+        row: Record<string, unknown> | null;
+    }>;
+    updateDatabaseRow(table: string, where: Record<string, unknown>, data: Record<string, unknown>): Promise<{
+        updated: boolean;
+        row: Record<string, unknown>;
+    }>;
+    deleteDatabaseRow(table: string, where: Record<string, unknown>): Promise<{
+        deleted: boolean;
+        row: Record<string, unknown>;
+    }>;
+    executeDatabaseQuery(sql: string, readOnly?: boolean): Promise<QueryResult>;
+    getTrajectories(options?: TrajectoryListOptions): Promise<TrajectoryListResult>;
+    getTrajectoryDetail(trajectoryId: string): Promise<TrajectoryDetailResult>;
+    getTrajectoryStats(): Promise<TrajectoryStats>;
+    getTrajectoryConfig(): Promise<TrajectoryConfig>;
+    updateTrajectoryConfig(config: Partial<TrajectoryConfig>): Promise<TrajectoryConfig>;
+    exportTrajectories(options: TrajectoryExportOptions): Promise<Blob>;
+    deleteTrajectories(trajectoryIds: string[]): Promise<{
+        deleted: number;
+    }>;
+    clearAllTrajectories(): Promise<{
+        deleted: number;
+    }>;
+    /**
+     * Get all system permission states.
+     */
+    getPermissions(): Promise<AllPermissionsState>;
+    /**
+     * Get a single permission state.
+     */
+    getPermission(id: SystemPermissionId): Promise<PermissionState>;
+    /**
+     * Request a specific permission (triggers OS prompt if applicable).
+     */
+    requestPermission(id: SystemPermissionId): Promise<PermissionState>;
+    /**
+     * Open system settings for a specific permission.
+     */
+    openPermissionSettings(id: SystemPermissionId): Promise<void>;
+    /**
+     * Refresh all permission states from the OS.
+     */
+    refreshPermissions(): Promise<AllPermissionsState>;
+    /**
+     * Enable or disable shell access.
+     */
+    setShellEnabled(enabled: boolean): Promise<PermissionState>;
+    /**
+     * Get shell enabled status.
+     */
+    isShellEnabled(): Promise<boolean>;
+    /**
+     * Get agent automation permission mode.
+     */
+    getAgentAutomationMode(): Promise<AgentAutomationModeResponse>;
+    /**
+     * Set agent automation permission mode.
+     */
+    setAgentAutomationMode(mode: AgentAutomationMode): Promise<AgentAutomationModeResponse>;
+    /**
+     * Get wallet trade execution permission mode.
+     */
+    getTradePermissionMode(): Promise<TradePermissionModeResponse>;
+    /**
+     * Set wallet trade execution permission mode.
+     */
+    setTradePermissionMode(mode: TradePermissionMode): Promise<TradePermissionModeResponse>;
+    disconnectWs(): void;
+    getRegistryStatus(): Promise<RegistryStatus>;
+    registerAgent(params?: {
+        name?: string;
+        endpoint?: string;
+        tokenURI?: string;
+    }): Promise<RegistrationResult>;
+    updateRegistryTokenURI(tokenURI: string): Promise<{
+        ok: boolean;
+        txHash: string;
+    }>;
+    syncRegistryProfile(params?: {
+        name?: string;
+        endpoint?: string;
+        tokenURI?: string;
+    }): Promise<{
+        ok: boolean;
+        txHash: string;
+    }>;
+    getRegistryConfig(): Promise<RegistryConfig>;
+    getDropStatus(): Promise<DropStatus>;
+    mintAgent(params?: {
+        name?: string;
+        endpoint?: string;
+        shiny?: boolean;
+    }): Promise<MintResult>;
+    mintAgentWhitelist(params: {
+        name?: string;
+        endpoint?: string;
+        proof: string[];
+    }): Promise<MintResult>;
+    getWhitelistStatus(): Promise<WhitelistStatus>;
+    generateTwitterVerificationMessage(): Promise<VerificationMessageResponse>;
+    verifyTwitter(tweetUrl: string): Promise<VerificationResult>;
+    listCustomActions(): Promise<CustomActionDef[]>;
+    createCustomAction(action: Omit<CustomActionDef, "id" | "createdAt" | "updatedAt">): Promise<CustomActionDef>;
+    updateCustomAction(id: string, action: Partial<CustomActionDef>): Promise<CustomActionDef>;
+    deleteCustomAction(id: string): Promise<void>;
+    testCustomAction(id: string, params: Record<string, string>): Promise<{
+        ok: boolean;
+        output: string;
+        error?: string;
+        durationMs: number;
+    }>;
+    generateCustomAction(prompt: string): Promise<{
+        ok: boolean;
+        generated: Record<string, unknown>;
+    }>;
+    getWhatsAppStatus(accountId?: string): Promise<{
+        accountId: string;
+        status: string;
+        authExists: boolean;
+        serviceConnected: boolean;
+        servicePhone: string | null;
+    }>;
+    startWhatsAppPairing(accountId?: string): Promise<{
+        ok: boolean;
+        accountId: string;
+        status: string;
+        error?: string;
+    }>;
+    stopWhatsAppPairing(accountId?: string): Promise<{
+        ok: boolean;
+        accountId: string;
+        status: string;
+    }>;
+    disconnectWhatsApp(accountId?: string): Promise<{
+        ok: boolean;
+        accountId: string;
+    }>;
+    checkBugReportInfo(): Promise<{
+        nodeVersion?: string;
+        platform?: string;
+    }>;
+    submitBugReport(report: {
+        description: string;
+        stepsToReproduce: string;
+        expectedBehavior?: string;
+        actualBehavior?: string;
+        environment?: string;
+        nodeVersion?: string;
+        modelProvider?: string;
+        logs?: string;
+    }): Promise<{
+        url?: string;
+        fallback?: string;
+    }>;
+    getCodingAgentStatus(): Promise<CodingAgentStatus | null>;
+    stopCodingAgent(sessionId: string): Promise<boolean>;
+    listCodingAgentScratchWorkspaces(): Promise<CodingAgentScratchWorkspace[]>;
+    keepCodingAgentScratchWorkspace(sessionId: string): Promise<boolean>;
+    deleteCodingAgentScratchWorkspace(sessionId: string): Promise<boolean>;
+    promoteCodingAgentScratchWorkspace(sessionId: string, name?: string): Promise<CodingAgentScratchWorkspace | null>;
+    /** Subscribe to live PTY output for a session over WebSocket. */
+    subscribePtyOutput(sessionId: string): void;
+    /** Unsubscribe from live PTY output for a session. */
+    unsubscribePtyOutput(sessionId: string): void;
+    /** Send raw keyboard input to a PTY session. */
+    sendPtyInput(sessionId: string, data: string): void;
+    /** Resize a PTY session's terminal dimensions. */
+    resizePty(sessionId: string, cols: number, rows: number): void;
+    /** Fetch buffered terminal output (raw ANSI) for xterm.js hydration. */
+    getPtyBufferedOutput(sessionId: string): Promise<string>;
+    streamGoLive(): Promise<{
+        ok: boolean;
+        live: boolean;
+        rtmpUrl?: string;
+        inputMode?: string;
+        audioSource?: string;
+        message?: string;
+        destination?: string;
+    }>;
+    streamGoOffline(): Promise<{
+        ok: boolean;
+        live: boolean;
+    }>;
+    streamStatus(): Promise<{
+        ok: boolean;
+        running: boolean;
+        ffmpegAlive: boolean;
+        uptime: number;
+        frameCount: number;
+        volume: number;
+        muted: boolean;
+        audioSource: string;
+        inputMode: string | null;
+        destination?: {
+            id: string;
+            name: string;
+        } | null;
+    }>;
+    getStreamingDestinations(): Promise<{
+        ok: boolean;
+        destinations: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>;
+    setActiveDestination(destinationId: string): Promise<{
+        ok: boolean;
+        destination?: {
+            id: string;
+            name: string;
+        };
+    }>;
+    setStreamVolume(volume: number): Promise<{
+        ok: boolean;
+        volume: number;
+        muted: boolean;
+    }>;
+    muteStream(): Promise<{
+        ok: boolean;
+        muted: boolean;
+        volume: number;
+    }>;
+    unmuteStream(): Promise<{
+        ok: boolean;
+        muted: boolean;
+        volume: number;
+    }>;
+    getStreamVoice(): Promise<{
+        ok: boolean;
+        enabled: boolean;
+        autoSpeak: boolean;
+        provider: string | null;
+        configuredProvider: string | null;
+        hasApiKey: boolean;
+        isSpeaking: boolean;
+        isAttached: boolean;
+    }>;
+    saveStreamVoice(settings: {
+        enabled?: boolean;
+        autoSpeak?: boolean;
+        provider?: string;
+    }): Promise<{
+        ok: boolean;
+        voice: {
+            enabled: boolean;
+            autoSpeak: boolean;
+        };
+    }>;
+    streamVoiceSpeak(text: string): Promise<{
+        ok: boolean;
+        speaking: boolean;
+    }>;
+    getOverlayLayout(destinationId?: string | null): Promise<{
+        ok: boolean;
+        layout: unknown;
+        destinationId?: string;
+    }>;
+    saveOverlayLayout(layout: unknown, destinationId?: string | null): Promise<{
+        ok: boolean;
+        layout: unknown;
+        destinationId?: string;
+    }>;
+    getStreamSource(): Promise<{
+        source: {
+            type: string;
+            url?: string;
+        };
+    }>;
+    setStreamSource(sourceType: string, customUrl?: string): Promise<{
+        ok: boolean;
+        source: {
+            type: string;
+            url?: string;
+        };
+    }>;
+    getStreamSettings(): Promise<{
+        ok: boolean;
+        settings: {
+            theme?: string;
+            avatarIndex?: number;
+        };
+    }>;
+    saveStreamSettings(settings: {
+        theme?: string;
+        avatarIndex?: number;
+    }): Promise<{
+        ok: boolean;
+        settings: unknown;
+    }>;
+}
+export declare const client: MiladyClient;
+//# sourceMappingURL=client.d.ts.map