@agent-commons/sdk 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type ModelProvider = 'openai' | 'anthropic' | 'google' | 'mistral' | 'groq' | 'ollama' | 'openrouter' | 'xai' | 'custom';
+type ModelProvider = "openai" | "anthropic" | "google" | "mistral" | "groq" | "ollama" | "openrouter" | "xai" | "custom";
 interface ModelConfig {
     provider: ModelProvider;
     modelId: string;
@@ -7,8 +7,28 @@ interface ModelConfig {
     temperature?: number;
     maxTokens?: number;
     topP?: number;
-    reasoningEffort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-    verbosity?: 'low' | 'medium' | 'high';
+    reasoningEffort?: "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+    verbosity?: "low" | "medium" | "high";
+}
+type AgentRuntimeType = "native" | "openclaw" | "hermes" | "custom";
+type AgentRuntimeStatus = "disabled" | "provisioning" | "starting" | "ready" | "degraded" | "stopped" | "failed";
+interface AgentRuntimeConfig {
+    deploymentMode?: "managed" | "external";
+    channelPolicy?: "pairing" | "allowlist" | "open" | "disabled";
+    enabledPlugins?: string[];
+    enabledToolsets?: string[];
+    memoryMode?: "native" | "platform" | "hybrid";
+    metadata?: Record<string, string | number | boolean>;
+}
+interface AgentRuntime {
+    runtimeType: AgentRuntimeType;
+    version?: string | null;
+    status: AgentRuntimeStatus;
+    config: AgentRuntimeConfig;
+    capabilities: Record<string, boolean>;
+    updatedAt?: string | null;
+    managed: boolean;
+    computer?: AgentComputer | null;
 }
 interface Agent {
     agentId: string;
@@ -31,36 +51,179 @@ interface Agent {
     isLiaison?: boolean;
     externalUrl?: string;
     createdAt: string;
+    isDefault?: boolean;
+    isSystemManaged?: boolean;
+    copilotAccessMode?: "full" | "scoped" | "confirm" | null;
+    copilotScopes?: string[];
+    runtimeType?: AgentRuntimeType;
+    runtimeVersion?: string | null;
+    runtimeStatus?: AgentRuntimeStatus;
+    runtimeConfig?: AgentRuntimeConfig;
+    runtimeCapabilities?: Record<string, boolean>;
+}
+interface CopilotChange {
+    changeId: string;
+    agentId: string;
+    ownerUserId: string;
+    scope: string;
+    resourceType: string;
+    resourceId?: string | null;
+    action: "create" | "update" | "delete";
+    status: "pending" | "applied" | "rejected" | "reverted";
+    title: string;
+    description?: string | null;
+    before?: unknown;
+    after?: unknown;
+    diff?: unknown;
+    createdAt: string;
+    reviewedAt?: string | null;
+    appliedAt?: string | null;
+}
+/** Agent computers are durable. Runtime pods may be replaced, but this identity persists. */
+type AgentComputerLifecycle = "persistent";
+type ComputerPersistence = AgentComputerLifecycle;
+type ComputerLifecycle = AgentComputerLifecycle;
+type ComputerResourceProfile = "starter" | "standard" | "performance" | "gpu";
+type ComputerResourceMode = "fixed" | "elastic";
+type AgentComputerResourceProfile = ComputerResourceProfile;
+type AgentComputerResourceMode = ComputerResourceMode;
+/**
+ * Common accelerator names. Providers may expose additional values without
+ * requiring an SDK release, so string extensions remain valid.
+ */
+type ComputerGpuType = "nvidia-t4" | "nvidia-l4" | "nvidia-a10" | "nvidia-a100" | "nvidia-h100" | "nvidia-h200" | "nvidia-b200" | (string & {});
+interface ComputerGpu {
+    count: number;
+    type?: ComputerGpuType;
+}
+type AgentComputerGpuType = ComputerGpuType;
+type AgentComputerGpu = ComputerGpu;
+/** Public, provider-neutral resource units. */
+interface ComputerResources {
+    vcpu: number;
+    memoryGiB: number;
+    storageGiB: number;
+    gpu?: ComputerGpu | null;
+}
+type AgentComputerResources = ComputerResources;
+interface ComputerResourceUpdate {
+    vcpu?: number;
+    memoryGiB?: number;
+    storageGiB?: number;
+    gpu?: ComputerGpu | null;
+}
+type AgentComputerDesiredState = "running" | "sleeping" | "disabled";
+type AgentComputerStatus = "disabled" | "provisioning" | "starting" | "running" | "idle" | "sleeping" | "resizing" | "restarting" | "stopping" | "error" | "unavailable" | "stopped" | "terminated" | "failed";
+type ComputerNetworkAccess = "standard" | "restricted" | "disabled" | (string & {});
+/**
+ * Mutable computer settings only. Server-owned identity, provider, billing,
+ * timestamps, and runtime fields intentionally cannot be submitted here.
+ */
+interface ComputerConfigUpdate {
+    enabled?: boolean;
+    autoWake?: boolean;
+    allowAgentUse?: boolean;
+    allowBrowser?: boolean;
+    allowTerminal?: boolean;
+    allowFilesystem?: boolean;
+    networkAccess?: ComputerNetworkAccess;
+    resourceProfile?: ComputerResourceProfile;
+    resourceMode?: ComputerResourceMode;
+    resources?: ComputerResourceUpdate;
 }
-type AgentComputerLifecycle = 'persistent' | 'ephemeral';
-type AgentComputerStatus = 'provisioning' | 'starting' | 'running' | 'idle' | 'stopping' | 'stopped' | 'terminated' | 'failed' | 'error' | 'unavailable';
 interface AgentComputerConfig {
     configId: string;
     agentId: string;
     enabled: boolean;
-    defaultMode: AgentComputerLifecycle;
+    /** @deprecated Computers are always persistent. */
+    defaultMode: AgentComputerLifecycle | "ephemeral";
+    /** @deprecated Use autoWake. */
     autoStart: boolean;
+    /** @deprecated Use allowAgentUse. */
     allowAgentStart: boolean;
+    /** @deprecated The singleton computer is selected implicitly. */
     allowUserSelect: boolean;
     allowBrowser: boolean;
     allowTerminal: boolean;
     allowFilesystem: boolean;
-    networkAccess: 'standard' | 'restricted' | 'disabled' | string;
+    networkAccess: ComputerNetworkAccess;
+    /** @deprecated The singleton limit is always one. */
     maxPersistentComputers: number;
+    /** @deprecated Ephemeral computers are no longer supported. */
     maxEphemeralComputers: number;
+    /** @deprecated The singleton limit is always one. */
     maxConcurrentComputers: number;
+    /** @deprecated Use the service's sleep policy. */
     idleTtlMinutes: number;
+    /** @deprecated Persistent computers are not scoped to chat sessions. */
     sessionTtlMinutes: number;
     image?: string | null;
+    /** @deprecated Provider quantities are represented by resources. */
     cpuLimit?: string | null;
+    /** @deprecated Provider quantities are represented by resources. */
     memoryLimit?: string | null;
+    /** @deprecated Provider quantities are represented by resources. */
     storageLimit?: string | null;
     region?: string | null;
     provider: string;
     metadata?: Record<string, any> | null;
     createdAt: string;
     updatedAt: string;
+    persistence?: ComputerPersistence;
+    autoWake?: boolean;
+    allowAgentUse?: boolean;
+    resourceProfile?: ComputerResourceProfile;
+    resourceMode?: ComputerResourceMode;
+    resources?: ComputerResources;
+    cpuRequest?: string | null;
+    memoryRequest?: string | null;
+    gpuType?: ComputerGpuType | null;
+    gpuCount?: number;
+    billingMode?: "tier" | "usage" | (string & {});
+}
+interface AgentComputerBrowser {
+    status?: "off" | "starting" | "on" | "error";
+    url?: string | null;
+    title?: string | null;
+    screenshot?: string | null;
+    lastAction?: string | null;
+    error?: string | null;
+    updatedAt?: string | null;
+}
+interface AgentComputerTerminal {
+    lastCommand?: string | null;
+    lastExitCode?: number | null;
+    lastOutput?: string | null;
+    updatedAt?: string | null;
+}
+/** The one persistent cloud computer assigned to an agent. */
+interface AgentComputer {
+    computerId: string;
+    agentId: string;
+    enabled: boolean;
+    persistence: ComputerPersistence;
+    desiredState: AgentComputerDesiredState;
+    status: AgentComputerStatus;
+    resourceProfile: ComputerResourceProfile;
+    resourceMode: ComputerResourceMode;
+    resources: ComputerResources;
+    provider?: string;
+    cloudProvider?: string | null;
+    region?: string | null;
+    runtimeId?: string | null;
+    runtimeGeneration?: number;
+    namespaceId?: string | null;
+    workspaceRoot?: string | null;
+    browser?: AgentComputerBrowser | null;
+    terminal?: AgentComputerTerminal | null;
+    lastActivityAt?: string | null;
+    startedAt?: string | null;
+    sleptAt?: string | null;
+    errorMessage?: string | null;
+    createdAt: string;
+    updatedAt: string;
 }
+/** @deprecated Use AgentComputer. */
 interface AgentComputerInstance {
     computerId: string;
     agentId: string;
@@ -68,7 +231,8 @@ interface AgentComputerInstance {
     ownerUserId?: string | null;
     workspaceId?: string | null;
     name: string;
-    lifecycle: AgentComputerLifecycle;
+    /** @deprecated Ephemeral values may be read from historical records only. */
+    lifecycle: AgentComputerLifecycle | "ephemeral";
     status: AgentComputerStatus;
     provider: string;
     cloudProvider?: string | null;
@@ -81,21 +245,8 @@ interface AgentComputerInstance {
     storageLimit?: string | null;
     workspaceRoot?: string | null;
     workspaceSnapshot?: string | null;
-    browser?: {
-        status?: 'off' | 'starting' | 'on' | 'error';
-        url?: string | null;
-        title?: string | null;
-        screenshot?: string | null;
-        lastAction?: string | null;
-        error?: string | null;
-        updatedAt?: string | null;
-    } | null;
-    terminal?: {
-        lastCommand?: string | null;
-        lastExitCode?: number | null;
-        lastOutput?: string | null;
-        updatedAt?: string | null;
-    } | null;
+    browser?: AgentComputerBrowser | null;
+    terminal?: AgentComputerTerminal | null;
     metadata?: Record<string, any> | null;
     lastActivityAt?: string | null;
     expiresAt?: string | null;
@@ -104,6 +255,42 @@ interface AgentComputerInstance {
     errorMessage?: string | null;
     createdAt: string;
     updatedAt: string;
+    canonical?: boolean;
+    enabled?: boolean;
+    persistence?: ComputerPersistence;
+    desiredState?: AgentComputerDesiredState;
+    resourceProfile?: ComputerResourceProfile;
+    resourceMode?: ComputerResourceMode;
+    resources?: ComputerResources;
+    cpuRequest?: string | null;
+    memoryRequest?: string | null;
+    gpuType?: ComputerGpuType | null;
+    gpuCount?: number;
+    runtimeId?: string | null;
+    runtimeGeneration?: number;
+    persistentVolumeId?: string | null;
+    computeTenantId?: string | null;
+    computeCellId?: string | null;
+}
+interface ComputerActionParams {
+    reason?: string;
+}
+interface ComputerResizeParams {
+    resourceProfile?: ComputerResourceProfile;
+    resourceMode?: ComputerResourceMode;
+    resources?: ComputerResourceUpdate;
+}
+interface ComputerCommandParams {
+    command: string;
+    cwd?: string;
+    timeoutSeconds?: number;
+}
+interface ComputerFile {
+    path: string;
+    content: string;
+}
+interface ComputerBrowserOpenParams {
+    url: string;
 }
 interface AgentComputerEvent {
     eventId: string;
@@ -136,6 +323,9 @@ interface CreateAgentParams {
     topP?: number;
     commonTools?: string[];
     avatar?: string;
+    runtimeType?: AgentRuntimeType;
+    runtimeVersion?: string;
+    runtimeConfig?: AgentRuntimeConfig;
 }
 interface Session {
     sessionId: string;
@@ -147,9 +337,9 @@ interface Session {
     };
     createdAt: string;
     /** 'cli' | 'web' — origin of the session, used for filtering in the UI */
-    source?: 'cli' | 'web';
+    source?: "cli" | "web";
     /** Same as source; returned from the backend column `initiator_type` */
-    initiatorType?: 'cli' | 'web';
+    initiatorType?: "cli" | "web";
 }
 interface RunParams {
     agentId: string;
@@ -158,8 +348,10 @@ interface RunParams {
     initiatorId?: string;
     computerRequest?: {
         enabled: boolean;
+        /** @deprecated The agent's singleton computer is selected implicitly. */
         computerIds?: string[];
-        lifecycle?: AgentComputerLifecycle;
+        /** @deprecated Computers are always persistent; this value is ignored. */
+        lifecycle?: AgentComputerLifecycle | "ephemeral";
     };
     /** Uploaded file references. Raw file bytes must be uploaded separately. */
     attachments?: Array<{
@@ -175,12 +367,12 @@ interface RunParams {
     }>;
 }
 interface ChatMessage {
-    role: 'user' | 'assistant' | 'system' | 'tool';
+    role: "user" | "assistant" | "system" | "tool";
     content: string | Array<{
-        type: 'text';
+        type: "text";
         text: string;
     } | {
-        type: 'image_url';
+        type: "image_url";
         image_url: {
             url: string;
         };
@@ -188,18 +380,18 @@ interface ChatMessage {
     tool_call_id?: string;
     name?: string;
 }
-type StreamEventType = 'token' | 'tool' | 'toolProgress' | 'toolStart' | 'toolEnd' | 'agent_step' | 'run_started' | 'final' | 'completed' | 'failed' | 'cancelled' | 'status' | 'keepalive' | 'cli_tool_request' | 'error';
+type StreamEventType = "token" | "tool" | "toolProgress" | "toolStart" | "toolEnd" | "agent_step" | "run_started" | "final" | "completed" | "failed" | "cancelled" | "status" | "keepalive" | "cli_tool_request" | "error";
 interface StreamEvent {
     type: StreamEventType;
     /** Identifies the run; pass to POST /v1/agents/runs/:runId/stream to resume a dropped stream. */
     runId?: string;
     /** Monotonic per-run sequence number; resume with `after: <last seen seq>` to avoid duplicates. */
     seq?: number;
-    phase?: 'commentary' | 'final_answer' | string;
+    phase?: "commentary" | "final_answer" | string;
     role?: string;
     content?: string;
     stage?: string;
-    status?: 'queued' | 'running' | 'completed' | 'failed' | string;
+    status?: "queued" | "running" | "completed" | "failed" | string;
     name?: string;
     toolName?: string;
     tool?: string;
@@ -221,7 +413,7 @@ interface Workflow {
     description?: string;
     definition: WorkflowDefinition;
     ownerId: string;
-    ownerType: 'user' | 'agent';
+    ownerType: "user" | "agent";
     isPublic?: boolean;
     category?: string;
     tags?: string[];
@@ -234,11 +426,16 @@ interface WorkflowDefinition {
     edges: WorkflowEdge[];
     outputMapping?: Record<string, string>;
 }
-type WorkflowNodeType = 'tool' | 'input' | 'output' | 'condition' | 'transform' | 'loop' | 'agent_processor' | 'workflow' | 'human_approval';
+type WorkflowNodeType = "tool" | "input" | "output" | "condition" | "transform" | "loop" | "agent_processor" | "workflow" | "human_approval";
 interface WorkflowNode {
     id: string;
     type: WorkflowNodeType | string;
     toolId?: string;
+    toolName?: string;
+    agentId?: string;
+    agentAvatar?: string;
+    workflowId?: string;
+    label?: string;
     position?: {
         x: number;
         y: number;
@@ -253,15 +450,22 @@ interface WorkflowEdge {
     sourceHandle?: string;
     targetHandle?: string;
     mapping?: Record<string, string>;
+    /** Runtime target types used for dynamic (`any`) values and safe coercion. */
+    targetTypes?: Record<string, string>;
+    mappingMode?: "exact" | "dynamic" | "coerce";
 }
 interface WorkflowExecution {
     executionId: string;
     workflowId: string;
-    status: 'running' | 'completed' | 'failed' | 'cancelled' | 'awaiting_approval';
+    status: "running" | "completed" | "failed" | "cancelled" | "awaiting_approval";
     startedAt?: string;
     completedAt?: string;
     outputData?: any;
+    /** Alias returned by the immediate execute/status REST response. */
+    result?: any;
     nodeResults?: Record<string, any>;
+    /** Alias returned by the immediate execute/status REST response. */
+    stepResults?: Record<string, any>;
     errorMessage?: string;
     currentNode?: string;
     /** Set when status is 'awaiting_approval' */
@@ -274,8 +478,8 @@ interface Task {
     sessionId: string;
     title: string;
     description?: string;
-    status: 'pending' | 'started' | 'running' | 'completed' | 'failed' | 'cancelled';
-    executionMode: 'single' | 'workflow' | 'sequential';
+    status: "pending" | "started" | "running" | "completed" | "failed" | "cancelled";
+    executionMode: "single" | "workflow" | "sequential";
     workflowId?: string;
     cronExpression?: string;
     isRecurring?: boolean;
@@ -294,7 +498,7 @@ interface Task {
     summary?: string;
     errorMessage?: string;
     createdBy: string;
-    createdByType: 'user' | 'agent';
+    createdByType: "user" | "agent";
     createdAt: string;
     updatedAt?: string;
 }
@@ -303,7 +507,7 @@ interface CreateTaskParams {
     sessionId: string;
     title: string;
     description?: string;
-    executionMode?: 'single' | 'workflow' | 'sequential';
+    executionMode?: "single" | "workflow" | "sequential";
     workflowId?: string;
     workflowInputs?: Record<string, any>;
     cronExpression?: string;
@@ -311,13 +515,13 @@ interface CreateTaskParams {
     isRecurring?: boolean;
     dependsOn?: string[];
     tools?: string[];
-    toolConstraintType?: 'hard' | 'soft' | 'none';
+    toolConstraintType?: "hard" | "soft" | "none";
     toolInstructions?: string;
     priority?: number;
     /** Max execution time in milliseconds for workflow tasks */
     timeoutMs?: number;
     createdBy: string;
-    createdByType: 'user' | 'agent';
+    createdByType: "user" | "agent";
 }
 interface Tool {
     toolId: string;
@@ -338,15 +542,15 @@ interface CreateToolParams {
     apiSpec?: {
         baseUrl: string;
         path: string;
-        method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | string;
+        method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | string;
         headers?: Record<string, string>;
         queryParams?: Record<string, string>;
         bodyTemplate?: any;
-        authType?: 'none' | 'bearer' | 'api-key' | 'basic' | 'oauth2' | string;
+        authType?: "none" | "bearer" | "api-key" | "basic" | "oauth2" | string;
         authKeyName?: string;
         oauthProviderKey?: string;
         oauthScopes?: string[];
-        oauthTokenLocation?: 'header' | 'query' | 'body';
+        oauthTokenLocation?: "header" | "query" | "body";
         oauthTokenKey?: string;
         oauthTokenPrefix?: string;
     };
@@ -355,8 +559,8 @@ interface CreateToolParams {
     inputSchema?: any;
     outputSchema?: any;
     owner?: string;
-    ownerType?: 'user' | 'agent';
-    visibility?: 'private' | 'public' | 'platform';
+    ownerType?: "user" | "agent";
+    visibility?: "private" | "public" | "platform";
     tags?: string[];
     version?: string;
     rateLimitPerMinute?: number;
@@ -366,7 +570,7 @@ interface ToolKey {
     keyId: string;
     toolId?: string;
     ownerId: string;
-    ownerType: 'user' | 'agent';
+    ownerType: "user" | "agent";
     keyName: string;
     displayName?: string;
     description?: string;
@@ -377,37 +581,40 @@ interface ToolKey {
 }
 interface CreateToolKeyParams {
     toolId?: string;
-    ownerId: string;
-    ownerType: 'user' | 'agent';
+    /** @deprecated Ownership is derived from the authenticated principal. */
+    ownerId?: string;
+    /** @deprecated Ownership is derived from the authenticated principal. */
+    ownerType?: "user" | "agent";
     keyName: string;
     value: string;
     displayName?: string;
     description?: string;
-    keyType?: string;
+    keyType?: "api-key" | "bearer-token" | "oauth-token" | "secret";
+    expiresAt?: string;
 }
 interface ToolPermission {
     id: string;
     toolId: string;
     subjectId: string;
-    subjectType: 'user' | 'agent';
-    permission: 'read' | 'execute' | 'admin';
+    subjectType: "user" | "agent";
+    permission: "read" | "execute" | "admin";
     grantedBy?: string;
     createdAt: string;
     expiresAt?: string;
 }
-type A2ATaskState = 'submitted' | 'working' | 'input-required' | 'completed' | 'failed' | 'canceled';
+type A2ATaskState = "submitted" | "working" | "input-required" | "completed" | "failed" | "canceled";
 interface A2ATextPart {
-    type: 'text';
+    type: "text";
     text: string;
     metadata?: Record<string, any>;
 }
 interface A2ADataPart {
-    type: 'data';
+    type: "data";
     data: Record<string, any>;
     metadata?: Record<string, any>;
 }
 interface A2AFilePart {
-    type: 'file';
+    type: "file";
     file: {
         name?: string;
         mimeType?: string;
@@ -418,7 +625,7 @@ interface A2AFilePart {
 }
 type A2AMessagePart = A2ATextPart | A2ADataPart | A2AFilePart;
 interface A2AMessage {
-    role: 'user' | 'agent';
+    role: "user" | "agent";
     parts: A2AMessagePart[];
     contextId?: string;
     messageId?: string;
@@ -476,19 +683,19 @@ interface A2ASendTaskParams {
         token?: string;
     };
 }
-type McpConnectionType = 'stdio' | 'sse' | 'http' | 'streamable-http';
+type McpConnectionType = "stdio" | "sse" | "http" | "streamable-http";
 interface McpServer {
     serverId: string;
     name: string;
     description?: string;
     connectionType: McpConnectionType;
     connectionConfig: Record<string, any>;
-    status: 'connected' | 'disconnected' | 'error';
+    status: "connected" | "disconnected" | "error";
     toolsCount: number;
     capabilities?: Record<string, any>;
     isPublic: boolean;
     ownerId: string;
-    ownerType: 'user' | 'agent';
+    ownerType: "user" | "agent";
     createdAt: string;
 }
 interface McpResource {
@@ -509,6 +716,13 @@ interface McpPrompt {
 interface CommonsClientConfig {
     /** Defaults to the unified Commons API platform. */
     baseUrl?: string;
+    /** Commons Identity origin used for developer projects and project API keys. */
+    identityUrl?: string;
+    /**
+     * Commons account session or OAuth access token for Commons Identity.
+     * This is distinct from `apiKey`, which authenticates platform API calls.
+     */
+    identityToken?: string;
     apiKey?: string;
     initiator?: string;
     /** Fetch implementation — defaults to global fetch */
@@ -552,15 +766,15 @@ interface CreateSkillParams {
     tools?: string[];
     triggers?: string[];
     ownerId?: string;
-    ownerType?: 'platform' | 'user' | 'agent';
+    ownerType?: "platform" | "user" | "agent";
     isPublic?: boolean;
     tags?: string[];
     icon?: string;
     source?: string;
     sourceUrl?: string;
 }
-type MemoryType = 'episodic' | 'semantic' | 'procedural';
-type MemorySourceType = 'auto' | 'manual';
+type MemoryType = "episodic" | "semantic" | "procedural";
+type MemorySourceType = "auto" | "manual";
 interface AgentMemory {
     memoryId: string;
     agentId: string;
@@ -602,6 +816,18 @@ interface UpdateMemoryParams {
     isActive?: boolean;
     memoryType?: MemoryType;
 }
+interface SharedMemoryScope {
+    scopeId: string;
+    name: string;
+    description?: string | null;
+    access?: "read" | "write" | "admin";
+    updatedAt: string;
+}
+interface CreateSharedMemoryScopeParams {
+    name: string;
+    description?: string;
+    agentIds: string[];
+}
 interface UsageEvent {
     eventId: string;
     agentId: string;
@@ -629,15 +855,15 @@ interface UsageAggregation {
     callCount: number;
     events: UsageEvent[];
 }
-type CreditDirection = 'grant' | 'debit' | 'adjustment' | 'refund' | 'expiration';
-type CreditPlatform = 'agent_commons' | 'commonlab' | 'common_os' | 'system';
+type CreditDirection = "grant" | "debit" | "adjustment" | "refund" | "expiration";
+type CreditPlatform = "agent_commons" | "commonlab" | "common_os" | "system";
 interface CreditLedgerEntry {
     entryId: string;
     principalId: string;
-    principalType: 'user' | 'agent' | 'service';
+    principalType: "user" | "agent" | "service";
     workspaceId?: string | null;
     amount: number;
-    currency: 'credits';
+    currency: "credits";
     direction: CreditDirection;
     eventType: string;
     sourcePlatform: CreditPlatform;
@@ -661,11 +887,42 @@ interface CreditBalance {
     principalId: string;
     workspaceId?: string | null;
     balance: number;
-    currency: 'credits';
+    reserved: number;
+    available: number;
+    currency: "credits";
+}
+interface CreditCampaign {
+    campaignKey: string;
+    name: string;
+    description?: string | null;
+    rewardCredits: number;
+    triggerType: "once" | "daily" | "monthly" | "event";
+    sourcePlatform: CreditPlatform;
+    claimable: boolean;
+    claimed: boolean;
+}
+interface CreditTransfer {
+    transferId: string;
+    senderPrincipalId: string;
+    recipientPrincipalId: string;
+    amount: number;
+    message?: string | null;
+    status: "completed" | "reversed";
+    createdAt: string;
+}
+interface CreditSummary {
+    balance: CreditBalance;
+    month: {
+        earned: number;
+        spent: number;
+    };
+    recent: CreditLedgerEntry[];
+    campaigns: CreditCampaign[];
+    transfers: CreditTransfer[];
 }
 interface CreditWriteParams {
     principalId: string;
-    principalType?: 'user' | 'agent' | 'service';
+    principalType?: "user" | "agent" | "service";
     workspaceId?: string | null;
     amount: number;
     eventType: string;
@@ -681,7 +938,222 @@ interface CreditWriteParams {
     usageEventId?: string;
     metadata?: Record<string, unknown>;
 }
-type WalletType = 'eoa' | 'erc4337' | 'external';
+type PlanKey = "free" | "plus" | "pro" | "max";
+type ComputeProfile = "starter" | "standard" | "performance" | "gpu";
+type ModelTier = "frontier" | "standard" | "fast" | "local";
+interface PlanEntitlements {
+    computerUse: boolean;
+    allowedProfiles: ComputeProfile[];
+    maxComputerAgents: number;
+    maxConcurrentComputers: number;
+    modelTiers: ModelTier[];
+    maxConcurrentRuns: number;
+}
+interface BillingCatalog {
+    creditsPerUsd: number;
+    plans: Array<{
+        key: PlanKey;
+        name: string;
+        priceUsd: number;
+        monthlyCredits: number;
+        entitlements: PlanEntitlements;
+    }>;
+    topups: Array<{
+        key: string;
+        name: string;
+        credits: number;
+        priceUsd: number;
+    }>;
+}
+interface SubscriptionInfo {
+    planKey: PlanKey;
+    planName: string;
+    monthlyCredits: number;
+    entitlements: PlanEntitlements;
+    status: string;
+    currentPeriodEnd: string | null;
+    cancelAtPeriodEnd: boolean;
+}
+interface FlagEvaluation {
+    key: string;
+    enabled: boolean;
+    variant: string | null;
+    payload?: unknown;
+}
+interface ActivityEvent {
+    eventId?: string;
+    actorId: string;
+    actorType?: "user" | "agent" | "service" | string;
+    eventType: string;
+    resourceType?: string | null;
+    resourceId?: string | null;
+    metadata?: Record<string, unknown> | null;
+    createdAt: string;
+}
+interface AgentLog {
+    logId?: string;
+    agentId: string;
+    sessionId?: string | null;
+    action?: string;
+    message?: string | null;
+    status?: "success" | "error" | "warning" | string;
+    responseTime?: number | null;
+    tools?: unknown[];
+    timestamp: string;
+    [key: string]: unknown;
+}
+interface FileArtifact {
+    fileId: string;
+    name?: string;
+    originalName?: string;
+    mimeType?: string;
+    size?: number;
+    storageProvider?: "s3" | "ipfs" | string;
+    agentId?: string | null;
+    sessionId?: string | null;
+    ownerId?: string | null;
+    workspaceId?: string | null;
+    createdAt?: string;
+    [key: string]: unknown;
+}
+interface FileContent {
+    fileId?: string;
+    content?: string;
+    mimeType?: string;
+    offset?: number;
+    nextOffset?: number | null;
+    truncated?: boolean;
+    imageUrls?: string[];
+    downloadUrl?: string;
+    [key: string]: unknown;
+}
+interface UploadFileInput {
+    data: Blob;
+    name?: string;
+}
+interface LibraryItem extends FileArtifact {
+    itemId?: string;
+    description?: string | null;
+    isFavorite?: boolean;
+    source?: string;
+    grants?: LibraryGrant[];
+    shareLinks?: LibraryShareLink[];
+}
+interface LibraryGrant {
+    grantId: string;
+    subjectType: "user" | "agent" | "workspace";
+    subjectId: string;
+    permission: "read" | "edit" | "manage";
+    expiresAt?: string | null;
+    [key: string]: unknown;
+}
+interface LibraryShareLink {
+    shareId: string;
+    token?: string;
+    url?: string;
+    expiresAt?: string | null;
+    [key: string]: unknown;
+}
+interface Space {
+    spaceId: string;
+    name: string;
+    description?: string | null;
+    visibility?: string;
+    createdBy?: string;
+    createdByType?: "agent" | "human";
+    createdAt?: string;
+    updatedAt?: string;
+    members?: SpaceMember[];
+    [key: string]: unknown;
+}
+interface SpaceMember {
+    memberId: string;
+    memberType: "agent" | "human";
+    role?: string;
+    status?: string;
+    permissions?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+interface SpaceMessage {
+    messageId: string;
+    spaceId: string;
+    senderId: string;
+    senderType: "agent" | "human";
+    content: string;
+    metadata?: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface CodeProjectFile {
+    path: string;
+    content: string;
+}
+interface CodeProject {
+    projectId: string;
+    agentId: string;
+    name: string;
+    description?: string | null;
+    sessionId?: string | null;
+    files?: CodeProjectFile[];
+    previewSlug?: string | null;
+    previewUrl?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+    [key: string]: unknown;
+}
+interface Goal {
+    goalId: string;
+    status: "pending" | "started" | "completed" | "failed";
+    progress: number;
+    title?: string;
+    description?: string;
+    agentId?: string;
+    [key: string]: unknown;
+}
+interface OAuthProvider {
+    providerKey: string;
+    displayName: string;
+    isActive: boolean;
+    scopes?: string[];
+    scopeGroups?: Record<string, string[]>;
+    [key: string]: unknown;
+}
+interface OAuthConnection {
+    connectionId: string;
+    providerKey: string;
+    providerDisplayName?: string;
+    providerUserId?: string | null;
+    providerUserEmail?: string | null;
+    providerUserName?: string | null;
+    scopes: string[];
+    status: string;
+    lastUsedAt?: string | null;
+    expiresAt?: string | null;
+    metadata?: Record<string, unknown> | null;
+    [key: string]: unknown;
+}
+interface BillingInvoice {
+    id: string;
+    status?: string | null;
+    currency?: string;
+    amountDue?: number;
+    amountPaid?: number;
+    created?: number | string;
+    hostedInvoiceUrl?: string | null;
+    invoicePdf?: string | null;
+    [key: string]: unknown;
+}
+interface BillingPaymentMethod {
+    id: string;
+    type: string;
+    brand?: string;
+    last4?: string;
+    expMonth?: number;
+    expYear?: number;
+    [key: string]: unknown;
+}
+type WalletType = "eoa" | "erc4337" | "external";
 interface AgentWallet {
     id: string;
     agentId: string;
@@ -707,7 +1179,7 @@ interface CreateWalletParams {
     externalAddress?: string;
     chainId?: string;
 }
-type ApiKeyPrincipalType = 'user' | 'agent';
+type ApiKeyPrincipalType = "user" | "agent";
 interface ApiKey {
     id: string;
     label?: string | null;
@@ -726,15 +1198,70 @@ interface CreateApiKeyParams {
 interface CreatedApiKey extends ApiKey {
     key: string;
 }
+type DeveloperProjectEnvironment = "production" | "development" | "staging";
+interface DeveloperProject {
+    id: string;
+    workspaceId: string;
+    name: string;
+    slug: string;
+    environment: DeveloperProjectEnvironment;
+    status: string;
+    createdAt: string;
+}
+interface DeveloperApiKey {
+    id: string;
+    projectId: string;
+    keyPrefix: string;
+    name: string;
+    scopes: string[];
+    status: string;
+    expiresAt?: string | null;
+    lastUsedAt?: string | null;
+    createdAt: string;
+}
+interface CreatedDeveloperApiKey extends DeveloperApiKey {
+    /** Plaintext key — shown once at creation time. */
+    key: string;
+}
+type WorkflowValueKind = "text" | "markdown" | "number" | "boolean" | "json" | "image" | "audio" | "video" | "file" | "link" | "email" | "calendar_event" | "tool_result";
+interface WorkflowValue {
+    kind: WorkflowValueKind;
+    /** Canonical string representation — always present. */
+    text: string;
+    data?: Record<string, any>;
+    mime?: string;
+    label?: string;
+    meta?: Record<string, any>;
+}
+/** Optional hint a tool/node declares for how its output should be presented. */
+interface OutputPresentation {
+    kind?: WorkflowValueKind;
+    textPath?: string;
+    fieldMap?: Record<string, string>;
+    label?: string;
+}
 
+interface CommonsRequestOptions {
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
 declare class CommonsClient {
     private readonly baseUrl;
+    private readonly identityUrl;
+    private readonly identityToken?;
     private readonly apiKey?;
     private readonly initiator?;
     private readonly _fetch;
     constructor(config: CommonsClientConfig);
     private headers;
-    private request;
+    /**
+     * Call an API route that is not yet represented by a resource namespace.
+     * Most applications should use the typed helpers below.
+     */
+    request<T>(method: string, path: string, body?: unknown, options?: CommonsRequestOptions): Promise<T>;
+    private errorPayload;
+    private errorMessage;
+    private identityRequest;
     get models(): {
         /** List all available LLM models from the registry */
         list: () => Promise<{
@@ -755,6 +1282,33 @@ declare class CommonsClient {
         update: (agentId: string, params: Partial<CreateAgentParams>) => Promise<{
             data: Agent;
         }>;
+        getRuntime: (agentId: string) => Promise<{
+            data: AgentRuntime;
+        }>;
+        configureRuntime: (agentId: string, params: {
+            runtimeType?: AgentRuntimeType;
+            version?: string | null;
+            config?: AgentRuntimeConfig;
+            deploy?: boolean;
+        }) => Promise<{
+            data: AgentRuntime;
+        }>;
+        deployRuntime: (agentId: string) => Promise<{
+            data: AgentRuntime;
+        }>;
+        sleepRuntime: (agentId: string) => Promise<{
+            data: AgentRuntime;
+        }>;
+        restartRuntime: (agentId: string) => Promise<{
+            data: AgentRuntime;
+        }>;
+        manageRuntimeChannel: (agentId: string, channel: string, action: string, params?: {
+            pairingCode?: string;
+            target?: string;
+            message?: string;
+        }) => Promise<{
+            data: unknown;
+        }>;
         /** List tools assigned to an agent. */
         listTools: (agentId: string) => Promise<{
             data: any[];
@@ -766,6 +1320,13 @@ declare class CommonsClient {
         }) => Promise<{
             data: any;
         }>;
+        /** Update an agent tool assignment. */
+        updateTool: (assignmentId: string, params: {
+            usageComments?: string;
+            enabled?: boolean;
+        }) => Promise<{
+            data: any;
+        }>;
         /** Remove a tool assignment from an agent. */
         removeTool: (assignmentId: string) => Promise<void>;
         /** Create a liaison agent for an external agent. */
@@ -780,6 +1341,11 @@ declare class CommonsClient {
          * }
          */
         stream: (params: RunParams) => AsyncGenerator<StreamEvent>;
+        /** Resume a streamed run after executing a caller-owned CLI tool. */
+        submitCliToolResult: (requestId: string, result: string) => Promise<{
+            data?: unknown;
+            message?: string;
+        }>;
         /** Get the current heartbeat status for an agent. */
         getAutonomy: (agentId: string) => Promise<{
             data: {
@@ -838,16 +1404,59 @@ declare class CommonsClient {
         getComputerConfig: (agentId: string) => Promise<{
             data: AgentComputerConfig;
         }>;
-        updateComputerConfig: (agentId: string, params: Partial<AgentComputerConfig>) => Promise<{
+        updateComputerConfig: (agentId: string, params: ComputerConfigUpdate) => Promise<{
             data: AgentComputerConfig;
         }>;
-        listComputers: (agentId: string, filter?: {
+        /** Get the agent's one persistent cloud computer. */
+        getComputer: (agentId: string, _legacyComputerId?: string) => Promise<{
+            data: AgentComputer | null;
+        }>;
+        /** Wake the agent's persistent cloud computer, provisioning it if needed. */
+        wakeComputer: (agentId: string, params?: ComputerActionParams) => Promise<{
+            data: AgentComputer;
+        }>;
+        /** Sleep the runtime while preserving the computer's durable workspace. */
+        sleepComputer: (agentId: string, params?: ComputerActionParams) => Promise<{
+            data: AgentComputer;
+        }>;
+        /** Replace the runtime without replacing the persistent computer. */
+        restartComputer: (agentId: string, params?: ComputerActionParams) => Promise<{
+            data: AgentComputer;
+        }>;
+        resizeComputer: (agentId: string, params: ComputerResizeParams) => Promise<{
+            data: AgentComputer;
+        }>;
+        execComputer: (agentId: string, params: ComputerCommandParams) => Promise<{
+            data: any;
+        }>;
+        readComputerFile: (agentId: string, pathOrLegacyComputerId: string, legacyPath?: string) => Promise<{
+            data: ComputerFile;
+        }>;
+        writeComputerFile: (agentId: string, params: {
+            path: string;
+            content: string;
+            encoding?: "utf8" | "base64";
+        }) => Promise<{
+            data: ComputerFile;
+        }>;
+        openComputerBrowser: (agentId: string, paramsOrLegacyComputerId: ComputerBrowserOpenParams | string, legacyParams?: ComputerBrowserOpenParams) => Promise<{
+            data: any;
+        }>;
+        testComputerBrowser: (agentId: string) => Promise<{
+            data: Record<string, unknown>;
+        }>;
+        listComputerEvents: (agentId: string, limitOrLegacyComputerId?: number | string, legacyLimit?: number) => Promise<{
+            data: AgentComputerEvent[];
+        }>;
+        /** @deprecated Use getComputer. The singleton is returned as a one-item list. */
+        listComputers: (agentId: string, _filter?: {
             sessionId?: string;
             includeTerminated?: boolean;
         }) => Promise<{
             data: AgentComputerInstance[];
         }>;
-        startComputer: (agentId: string, params: {
+        /** @deprecated Use wakeComputer. Lifecycle, name, and session are ignored. */
+        startComputer: (agentId: string, params?: {
             sessionId?: string;
             lifecycle?: "persistent" | "ephemeral";
             name?: string;
@@ -855,36 +1464,18 @@ declare class CommonsClient {
         }) => Promise<{
             data: AgentComputerInstance;
         }>;
-        getComputer: (agentId: string, computerId: string) => Promise<{
+        /** @deprecated Use getComputer. Computer IDs are ignored. */
+        refreshComputer: (agentId: string, _computerId?: string) => Promise<{
             data: AgentComputerInstance;
         }>;
-        refreshComputer: (agentId: string, computerId: string) => Promise<{
+        /** @deprecated Use sleepComputer. Computer IDs are ignored. */
+        stopComputer: (agentId: string, _computerId?: string) => Promise<{
             data: AgentComputerInstance;
         }>;
-        stopComputer: (agentId: string, computerId: string) => Promise<{
-            data: AgentComputerInstance;
-        }>;
-        readComputerFile: (agentId: string, computerId: string, path: string) => Promise<{
-            data: {
-                path: string;
-                content: string;
-            };
-        }>;
-        runComputerCommand: (agentId: string, computerId: string, params: {
-            command: string;
-            cwd?: string;
-            timeoutSeconds?: number;
-        }) => Promise<{
-            data: any;
-        }>;
-        openComputerBrowser: (agentId: string, computerId: string, params: {
-            url: string;
-        }) => Promise<{
+        /** @deprecated Use execComputer. Computer IDs are ignored. */
+        runComputerCommand: (agentId: string, paramsOrLegacyComputerId: ComputerCommandParams | string, legacyParams?: ComputerCommandParams) => Promise<{
             data: any;
         }>;
-        listComputerEvents: (agentId: string, computerId: string, limit?: number) => Promise<{
-            data: AgentComputerEvent[];
-        }>;
         /**
          * List available TTS voices for a provider.
          * @param provider - 'openai' (default) or 'elevenlabs'
@@ -894,6 +1485,33 @@ declare class CommonsClient {
             data: any[];
         }>;
     };
+    get copilot(): {
+        get: () => Promise<{
+            data: Agent | null;
+        }>;
+        updateSettings: (params: {
+            accessMode: "full" | "scoped" | "confirm";
+            scopes?: string[];
+        }) => Promise<{
+            data: Agent;
+        }>;
+        listChanges: (filter?: {
+            status?: string;
+            resourceType?: string;
+            resourceId?: string;
+        }) => Promise<{
+            data: CopilotChange[];
+        }>;
+        acceptChange: (changeId: string) => Promise<{
+            data: CopilotChange;
+        }>;
+        rejectChange: (changeId: string) => Promise<{
+            data: CopilotChange;
+        }>;
+        revertChange: (changeId: string) => Promise<{
+            data: CopilotChange;
+        }>;
+    };
     get run(): {
         once: (params: RunParams) => Promise<any>;
     };
@@ -909,11 +1527,34 @@ declare class CommonsClient {
             tags?: string[];
         }) => Promise<Workflow>;
         list: (ownerId: string, ownerType: "user" | "agent") => Promise<Workflow[]>;
+        discoverPublic: (filter?: {
+            category?: string;
+            tags?: string[];
+            limit?: number;
+        }) => Promise<Workflow[]>;
         get: (workflowId: string) => Promise<Workflow>;
         update: (workflowId: string, updates: Partial<Workflow>) => Promise<Workflow>;
         delete: (workflowId: string) => Promise<{
             success: boolean;
         }>;
+        fork: (workflowId: string, params: {
+            newOwnerId: string;
+            newOwnerType: "user" | "agent";
+            customizations?: {
+                name?: string;
+                description?: string;
+                isPublic?: boolean;
+            };
+        }) => Promise<Workflow>;
+        getWebhook: (workflowId: string) => Promise<Record<string, unknown>>;
+        rotateWebhookToken: (workflowId: string) => Promise<{
+            token: string;
+            webhookUrl: string;
+        }>;
+        disableWebhook: (workflowId: string) => Promise<{
+            success: boolean;
+        }>;
+        executeWebhook: (token: string, payload: unknown, query?: Record<string, string>) => Promise<unknown>;
         execute: (workflowId: string, params: {
             agentId?: string;
             sessionId?: string;
@@ -1022,6 +1663,18 @@ declare class CommonsClient {
         getFull: (sessionId: string) => Promise<{
             data: any;
         }>;
+        /** Rename a session. */
+        rename: (sessionId: string, title: string) => Promise<{
+            data: Session;
+        }>;
+        /** Delete a session and its owned session data. */
+        delete: (sessionId: string) => Promise<{
+            data: unknown;
+        }>;
+        /** Get the full chat transcript for a session. */
+        getChat: (sessionId: string) => Promise<{
+            data: unknown;
+        }>;
     };
     get tools(): {
         list: (filter?: {
@@ -1049,12 +1702,69 @@ declare class CommonsClient {
             data: Tool[];
         }>;
     };
-    get toolKeys(): {
-        list: (filter: {
+    get oauth(): {
+        /** List OAuth providers available on the platform (Google Workspace, GitHub, …). */
+        listProviders: () => Promise<{
+            providers: OAuthProvider[];
+        }>;
+        /** Get one provider's details, including its scope groups. */
+        getProvider: (providerKey: string) => Promise<{
+            provider: OAuthProvider;
+        }>;
+        /**
+         * List the caller's OAuth connections (the accounts agents act with).
+         * `ownerId` is only needed when authenticating with a management key.
+         */
+        listConnections: (params?: {
             ownerId?: string;
-            ownerType?: string;
-            toolId?: string;
+            ownerType?: "user" | "agent";
+        }) => Promise<{
+            connections: OAuthConnection[];
+        }>;
+        /** Get one OAuth connection. */
+        getConnection: (connectionId: string) => Promise<{
+            connection: OAuthConnection;
+        }>;
+        /** Update connection metadata or its active status. */
+        updateConnection: (connectionId: string, params: {
+            displayName?: string;
+            isActive?: boolean;
         }) => Promise<{
+            success: boolean;
+            connection: OAuthConnection;
+        }>;
+        /**
+         * Start an OAuth connect flow. Returns the authorization URL the user
+         * must open in a browser to grant access.
+         */
+        connect: (params: {
+            providerKey: string;
+            scopes?: string[];
+            redirectUri?: string;
+        }) => Promise<{
+            authorizationUrl: string;
+            state: string;
+            expiresAt: string;
+        }>;
+        /** Refresh a connection's access token now. */
+        refresh: (connectionId: string) => Promise<{
+            success: boolean;
+        }>;
+        /** Check whether a connection's token is valid. */
+        test: (connectionId: string) => Promise<{
+            success: boolean;
+            status: string;
+            accessTokenValid: boolean;
+            providerUserEmail?: string;
+            error?: string;
+        }>;
+        /** Revoke a connection and delete its tokens. */
+        revoke: (connectionId: string) => Promise<{
+            success: boolean;
+        }>;
+    };
+    get toolKeys(): {
+        list: () => Promise<{
             success: boolean;
             data: ToolKey[];
         }>;
@@ -1062,28 +1772,112 @@ declare class CommonsClient {
             success: boolean;
             data: ToolKey;
         }>;
+        get: (keyId: string) => Promise<{
+            success: boolean;
+            data: ToolKey;
+        }>;
+        updateMetadata: (keyId: string, params: {
+            displayName?: string;
+            description?: string;
+            isActive?: boolean;
+            expiresAt?: string;
+        }) => Promise<{
+            success: boolean;
+            data: ToolKey;
+        }>;
+        updateValue: (keyId: string, value: string) => Promise<{
+            success: boolean;
+            data: unknown;
+        }>;
+        test: (keyId: string) => Promise<{
+            success: boolean;
+            data: unknown;
+        }>;
+        mapToTool: (params: {
+            toolId: string;
+            keyId: string;
+            contextId: string;
+            contextType: "user" | "agent" | "global";
+            priority?: number;
+        }) => Promise<{
+            success: boolean;
+            data: unknown;
+        }>;
+        removeMapping: (mappingId: string) => Promise<{
+            success: boolean;
+        }>;
         delete: (keyId: string) => Promise<{
             success: boolean;
         }>;
     };
     get toolPermissions(): {
-        list: (toolId?: string) => Promise<{
+        /** @deprecated Use listForTool with a tool ID. */
+        list: (toolId: string) => Promise<{
+            success: boolean;
+            data: ToolPermission[];
+        }>;
+        listForTool: (toolId: string) => Promise<{
+            success: boolean;
+            data: ToolPermission[];
+        }>;
+        listForSubject: (subjectId: string, subjectType: "user" | "agent") => Promise<{
             success: boolean;
             data: ToolPermission[];
         }>;
+        accessibleTools: (subjectId: string, subjectType: "user" | "agent") => Promise<{
+            success: boolean;
+            data: Tool[];
+        }>;
         grant: (params: {
             toolId: string;
             subjectId: string;
             subjectType: "user" | "agent";
             permission: "read" | "execute" | "admin";
-            grantedBy?: string;
+            grantedBy: string;
+            expiresAt?: string;
         }) => Promise<{
             success: boolean;
             data: ToolPermission;
         }>;
+        batchGrant: (params: {
+            toolId: string;
+            subjects: Array<{
+                subjectId: string;
+                subjectType: "user" | "agent";
+            }>;
+            permission: "read" | "execute" | "admin";
+            grantedBy: string;
+            expiresAt?: string;
+        }) => Promise<{
+            success: boolean;
+            data: ToolPermission[];
+        }>;
         revoke: (permissionId: string) => Promise<{
             success: boolean;
         }>;
+        check: (params: {
+            toolId: string;
+            subjectId: string;
+            subjectType: "user" | "agent";
+            permission: "read" | "execute" | "admin";
+        }) => Promise<{
+            success: boolean;
+            data: {
+                hasPermission: boolean;
+            };
+        }>;
+        checkAgentAccess: (toolId: string, agentId: string, userId?: string) => Promise<{
+            success: boolean;
+            data: unknown;
+        }>;
+        transferOwnership: (params: {
+            toolId: string;
+            newOwnerId: string;
+            newOwnerType: "user" | "agent";
+        }) => Promise<{
+            success: boolean;
+            data: Tool;
+        }>;
     };
     get skills(): {
         list: (filter?: {
@@ -1158,6 +1952,38 @@ declare class CommonsClient {
             principalType: string | null;
         }>;
     };
+    get developer(): {
+        scopes: () => Promise<{
+            data: string[];
+        }>;
+        listProjects: () => Promise<{
+            data: DeveloperProject[];
+        }>;
+        createProject: (params: {
+            workspaceId: string;
+            name: string;
+            environment?: DeveloperProjectEnvironment;
+        }) => Promise<{
+            data: DeveloperProject;
+        }>;
+        listApiKeys: (projectId: string) => Promise<{
+            data: DeveloperApiKey[];
+        }>;
+        createApiKey: (projectId: string, params: {
+            name: string;
+            scopes?: string[];
+            expiresAt?: string | null;
+        }) => Promise<{
+            data: CreatedDeveloperApiKey;
+        }>;
+        revokeApiKey: (keyId: string) => Promise<void>;
+    };
+    /**
+     * Legacy per-principal keys (`sk-ac-*`).
+     *
+     * New developer integrations should use `client.developer`, which creates
+     * project-scoped `csk_*` keys with explicit environments and scopes.
+     */
     get apiKeys(): {
         /**
          * Generate a new API key for a principal (user or agent).
@@ -1305,6 +2131,14 @@ declare class CommonsClient {
         }>;
         /** Soft-delete (deactivate) a memory. */
         delete: (memoryId: string) => Promise<void>;
+        /** Create an append-only memory scope shared by a set of owned agents. */
+        createSharedScope: (params: CreateSharedMemoryScopeParams) => Promise<{
+            data: SharedMemoryScope;
+        }>;
+        /** List shared-memory scopes available to an agent. */
+        listSharedScopes: (agentId: string) => Promise<{
+            data: SharedMemoryScope[];
+        }>;
     };
     get usage(): {
         /** Get aggregated token + cost usage for an agent. */
@@ -1319,6 +2153,298 @@ declare class CommonsClient {
             data: UsageAggregation;
         }>;
     };
+    get activity(): {
+        list: (filter?: {
+            actorId?: string;
+            eventType?: string;
+            since?: string;
+            limit?: number;
+        }) => Promise<{
+            data: ActivityEvent[];
+        }>;
+    };
+    get logs(): {
+        list: (agentId: string, filter?: {
+            sessionId?: string;
+            limit?: number;
+        }) => Promise<{
+            data: AgentLog[];
+        }>;
+        observability: (agentId: string, filter?: {
+            from?: string;
+            to?: string;
+            limit?: number;
+        }) => Promise<Record<string, unknown>>;
+    };
+    get files(): {
+        upload: (files: UploadFileInput[], params?: {
+            agentId?: string;
+            sessionId?: string;
+            workspaceId?: string;
+            storageProvider?: "s3" | "ipfs";
+        }) => Promise<{
+            data: FileArtifact[];
+        }>;
+        get: (fileId: string, context?: {
+            agentId?: string;
+            sessionId?: string;
+        }) => Promise<{
+            data: FileArtifact;
+        }>;
+        content: (fileId: string, options?: {
+            agentId?: string;
+            sessionId?: string;
+            offset?: number;
+            maxChars?: number;
+            includeImageUrls?: boolean;
+            includeDownloadUrl?: boolean;
+        }) => Promise<{
+            data: FileContent;
+        }>;
+    };
+    get library(): {
+        list: (filter?: {
+            query?: string;
+            view?: string;
+            source?: string;
+            favorite?: boolean;
+            sessionId?: string;
+            limit?: number;
+            offset?: number;
+        }) => Promise<{
+            data: LibraryItem[];
+            total?: number;
+        }>;
+        get: (itemId: string) => Promise<{
+            data: LibraryItem;
+        }>;
+        download: (itemId: string) => Promise<Record<string, unknown>>;
+        preview: (itemId: string) => Promise<Record<string, unknown>>;
+        update: (itemId: string, params: {
+            name?: string;
+            description?: string;
+            isFavorite?: boolean;
+        }) => Promise<{
+            data: LibraryItem;
+        }>;
+        delete: (itemId: string) => Promise<{
+            success?: boolean;
+        }>;
+        storagePreference: () => Promise<{
+            data?: {
+                defaultStorageProvider: "s3" | "ipfs";
+            };
+            defaultStorageProvider?: "s3" | "ipfs";
+        }>;
+        setStoragePreference: (defaultStorageProvider: "s3" | "ipfs") => Promise<{
+            data?: {
+                defaultStorageProvider: "s3" | "ipfs";
+            };
+            defaultStorageProvider?: "s3" | "ipfs";
+        }>;
+        grant: (itemId: string, params: {
+            subjectType: "user" | "agent" | "workspace";
+            subjectId: string;
+            permission?: "read" | "edit" | "manage";
+            expiresAt?: string | null;
+        }) => Promise<{
+            data: LibraryGrant;
+        }>;
+        revokeGrant: (itemId: string, grantId: string) => Promise<{
+            success?: boolean;
+        }>;
+        createShareLink: (itemId: string, expiresAt?: string | null) => Promise<{
+            data: LibraryShareLink;
+        }>;
+        revokeShareLink: (itemId: string, shareId: string) => Promise<{
+            success?: boolean;
+        }>;
+        resolveShare: (token: string) => Promise<{
+            data: LibraryItem;
+        }>;
+    };
+    get spaces(): {
+        list: (filter?: {
+            memberId?: string;
+            memberType?: "agent" | "human";
+            agentIds?: string[];
+            publicOnly?: boolean;
+            search?: string;
+            includeMembers?: boolean;
+            limit?: number;
+            offset?: number;
+        }) => Promise<{
+            data: Space[];
+            total?: number;
+            limit?: number;
+            offset?: number;
+        }>;
+        create: (params: {
+            name: string;
+            description?: string;
+            sessionId?: string;
+            isPublic?: boolean;
+            maxMembers?: number;
+            image?: string;
+            settings?: Record<string, unknown>;
+        }, creator: {
+            id: string;
+            type: "agent" | "human";
+        }) => Promise<{
+            data: Space;
+        }>;
+        get: (spaceId: string) => Promise<{
+            data: Space;
+        }>;
+        getFull: (spaceId: string) => Promise<{
+            data: Space;
+        }>;
+        update: (spaceId: string, params: Partial<{
+            name: string;
+            description: string;
+            sessionId: string;
+            isPublic: boolean;
+            maxMembers: number;
+            image: string;
+            settings: Record<string, unknown>;
+        }>) => Promise<{
+            data: Space;
+        }>;
+        delete: (spaceId: string) => Promise<{
+            success?: boolean;
+        }>;
+        issueRtcTicket: (spaceId: string) => Promise<{
+            data: {
+                ticket: string;
+            };
+        }>;
+        listMembers: (spaceId: string) => Promise<{
+            data: SpaceMember[];
+        }>;
+        addMember: (spaceId: string, params: {
+            memberId: string;
+            memberType: "agent" | "human";
+            role?: string;
+            permissions?: Record<string, unknown>;
+        }) => Promise<{
+            data: SpaceMember;
+        }>;
+        updateMember: (spaceId: string, memberId: string, memberType: "agent" | "human", params: {
+            role?: string;
+            permissions?: Record<string, unknown>;
+            status?: string;
+        }) => Promise<{
+            data: SpaceMember;
+        }>;
+        removeMember: (spaceId: string, memberId: string, memberType: "agent" | "human") => Promise<{
+            success?: boolean;
+        }>;
+        listMessages: (spaceId: string, filter?: {
+            limit?: number;
+            offset?: number;
+            memberId?: string;
+        }) => Promise<{
+            data: SpaceMessage[];
+        }>;
+        sendMessage: (spaceId: string, params: {
+            content: string;
+            targetType?: "broadcast" | "direct" | "group";
+            targetIds?: string[];
+            messageType?: string;
+            metadata?: Record<string, unknown>;
+            sessionId?: string;
+        }, sender: {
+            id: string;
+            type: "agent" | "human";
+        }) => Promise<{
+            data: SpaceMessage;
+        }>;
+        updateMessage: (spaceId: string, messageId: string, params: {
+            content?: string;
+            metadata?: Record<string, unknown>;
+        }) => Promise<{
+            data: SpaceMessage;
+        }>;
+        deleteMessage: (spaceId: string, messageId: string) => Promise<{
+            success?: boolean;
+        }>;
+    };
+    get projects(): {
+        list: (agentId: string) => Promise<{
+            data: CodeProject[];
+        }>;
+        create: (agentId: string, params: {
+            name: string;
+            description?: string;
+            sessionId?: string;
+            files?: CodeProjectFile[];
+        }) => Promise<{
+            data: CodeProject;
+        }>;
+        get: (agentId: string, projectId: string) => Promise<{
+            data: CodeProject;
+        }>;
+        writeFiles: (agentId: string, projectId: string, files: CodeProjectFile[], replace?: boolean) => Promise<{
+            data: CodeProject;
+        }>;
+        publish: (agentId: string, projectId: string) => Promise<{
+            data: Record<string, unknown>;
+        }>;
+        verify: (agentId: string, projectId: string, actions?: Array<Record<string, unknown>>) => Promise<{
+            data: Record<string, unknown>;
+        }>;
+        exportToComputer: (agentId: string, projectId: string, params?: {
+            directory?: string;
+            sessionId?: string;
+        }) => Promise<{
+            data: Record<string, unknown>;
+        }>;
+        exportToGitHub: (agentId: string, projectId: string, params?: {
+            repositoryName?: string;
+            private?: boolean;
+        }) => Promise<{
+            data: Record<string, unknown>;
+        }>;
+    };
+    get goals(): {
+        create: (params: Record<string, unknown>) => Promise<{
+            data: Goal;
+        }>;
+        get: (goalId: string) => Promise<{
+            data: Goal;
+        }>;
+        updateProgress: (goalId: string, progress: number, status: Goal["status"]) => Promise<{
+            data: Goal;
+        }>;
+    };
+    get audio(): {
+        transcribe: (file: UploadFileInput, options?: {
+            durationMs?: number;
+            idempotencyKey?: string;
+        }) => Promise<{
+            data: {
+                text: string;
+            };
+        }>;
+    };
+    get liaisons(): {
+        create: (params: {
+            name: string;
+            owner: string;
+            externalOwner: string;
+            persona?: string;
+            instructions?: string;
+            externalUrl?: string;
+            externalEndpoint?: string;
+        }) => Promise<{
+            data: Agent;
+            liaisonKey: string;
+            note: string;
+        }>;
+        interact: (liaisonAgentId: string, liaisonKey: string, message?: string) => Promise<{
+            data: unknown;
+        }>;
+    };
     get credits(): {
         balance: (filter?: {
             principalId?: string;
@@ -1333,6 +2459,31 @@ declare class CommonsClient {
         }) => Promise<{
             data: CreditLedgerEntry[];
         }>;
+        summary: () => Promise<{
+            data: CreditSummary;
+        }>;
+        campaigns: () => Promise<{
+            data: CreditCampaign[];
+        }>;
+        claimCampaign: (params: {
+            campaignKey: string;
+            eventId?: string;
+        }) => Promise<{
+            data: {
+                alreadyClaimed: boolean;
+            };
+        }>;
+        transfers: () => Promise<{
+            data: CreditTransfer[];
+        }>;
+        gift: (params: {
+            recipientPrincipalId: string;
+            amount: number;
+            message?: string;
+            idempotencyKey: string;
+        }) => Promise<{
+            data: CreditTransfer;
+        }>;
         grant: (params: CreditWriteParams) => Promise<{
             data: CreditLedgerEntry;
         }>;
@@ -1340,6 +2491,56 @@ declare class CommonsClient {
             data: CreditLedgerEntry;
         }>;
     };
+    get billing(): {
+        /** Public product catalog served from the backend source of truth. */
+        catalog: () => Promise<{
+            data: BillingCatalog;
+        }>;
+        /** Current plan, status, and entitlements for the caller. */
+        subscription: () => Promise<{
+            data: SubscriptionInfo;
+        }>;
+        /** Entitlements only (what paid features the caller may use). */
+        entitlements: () => Promise<{
+            data: PlanEntitlements;
+        }>;
+        /** Stripe invoice history for the caller. */
+        invoices: () => Promise<{
+            data: BillingInvoice[];
+        }>;
+        /** Saved Stripe payment methods for the caller. */
+        paymentMethods: () => Promise<{
+            data: BillingPaymentMethod[];
+        }>;
+        /** Create a Stripe Checkout session for a subscription plan. */
+        subscribe: (planKey: "plus" | "pro" | "max") => Promise<{
+            data: {
+                url: string;
+            };
+        }>;
+        /** Create a Stripe Checkout session for a one-time credit top-up. */
+        topup: (packKey: string) => Promise<{
+            data: {
+                url: string;
+            };
+        }>;
+        /** Open the Stripe billing portal. */
+        portal: () => Promise<{
+            data: {
+                url: string;
+            };
+        }>;
+    };
+    get flags(): {
+        /** Evaluate all active flags for the caller (call once at boot). */
+        all: () => Promise<{
+            data: Record<string, FlagEvaluation>;
+        }>;
+        /** Evaluate a single flag for the caller. */
+        evaluate: (key: string) => Promise<{
+            data: FlagEvaluation;
+        }>;
+    };
 }
 declare class CommonsError extends Error {
     readonly status: number;
@@ -1383,4 +2584,4 @@ declare function listWorkflowTemplates(): readonly [{
 }];
 declare function buildWorkflowTemplate(templateName: WorkflowTemplateName, ctx: WorkflowTemplateContext): WorkflowTemplateBuild;
 
-export { type A2AArtifact, type A2ADataPart, type A2AFilePart, type A2AMessage, type A2AMessagePart, type A2ASendTaskParams, type A2ASkill, type A2ATask, type A2ATaskState, type A2ATextPart, type Agent, type AgentCard, type AgentMemory, type AgentWallet, type ApiKey, type ApiKeyPrincipalType, type ChatMessage, CommonsClient, type CommonsClientConfig, CommonsError, type CreateAgentParams, type CreateApiKeyParams, type CreateMemoryParams, type CreateSkillParams, type CreateTaskParams, type CreateToolKeyParams, type CreateToolParams, type CreateWalletParams, type CreatedApiKey, type McpConnectionType, type McpPrompt, type McpResource, type McpServer, type MemorySourceType, type MemoryStats, type MemoryType, type ModelConfig, type ModelProvider, type RunParams, type Session, type Skill, type SkillIndex, type StreamEvent, type StreamEventType, type Task, type Tool, type ToolKey, type ToolPermission, type UpdateMemoryParams, type UsageAggregation, type UsageEvent, type WalletBalance, type WalletType, type Workflow, type WorkflowDefinition, type WorkflowEdge, type WorkflowExecution, type WorkflowNode, type WorkflowNodeType, type WorkflowTemplateBuild, type WorkflowTemplateContext, type WorkflowTemplateName, type WorkflowTemplateTool, buildWorkflowTemplate, listWorkflowTemplates };
+export { type A2AArtifact, type A2ADataPart, type A2AFilePart, type A2AMessage, type A2AMessagePart, type A2ASendTaskParams, type A2ASkill, type A2ATask, type A2ATaskState, type A2ATextPart, type ActivityEvent, type Agent, type AgentCard, type AgentComputer, type AgentComputerBrowser, type AgentComputerConfig, type AgentComputerDesiredState, type AgentComputerEvent, type AgentComputerGpu, type AgentComputerGpuType, type AgentComputerInstance, type AgentComputerLifecycle, type AgentComputerResourceMode, type AgentComputerResourceProfile, type AgentComputerResources, type AgentComputerStatus, type AgentComputerTerminal, type AgentLog, type AgentMemory, type AgentWallet, type ApiKey, type ApiKeyPrincipalType, type BillingCatalog, type BillingInvoice, type BillingPaymentMethod, type ChatMessage, type CodeProject, type CodeProjectFile, CommonsClient, type CommonsClientConfig, CommonsError, type CommonsRequestOptions, type ComputeProfile, type ComputerActionParams, type ComputerBrowserOpenParams, type ComputerCommandParams, type ComputerConfigUpdate, type ComputerFile, type ComputerGpu, type ComputerGpuType, type ComputerLifecycle, type ComputerNetworkAccess, type ComputerPersistence, type ComputerResizeParams, type ComputerResourceMode, type ComputerResourceProfile, type ComputerResourceUpdate, type ComputerResources, type CreateAgentParams, type CreateApiKeyParams, type CreateMemoryParams, type CreateSkillParams, type CreateTaskParams, type CreateToolKeyParams, type CreateToolParams, type CreateWalletParams, type CreatedApiKey, type CreatedDeveloperApiKey, type CreditBalance, type CreditCampaign, type CreditDirection, type CreditLedgerEntry, type CreditPlatform, type CreditSummary, type CreditTransfer, type CreditWriteParams, type DeveloperApiKey, type DeveloperProject, type DeveloperProjectEnvironment, type FileArtifact, type FileContent, type FlagEvaluation, type Goal, type LibraryGrant, type LibraryItem, type LibraryShareLink, type McpConnectionType, type McpPrompt, type McpResource, type McpServer, type MemorySourceType, type MemoryStats, type MemoryType, type ModelConfig, type ModelProvider, type ModelTier, type OAuthConnection, type OAuthProvider, type OutputPresentation, type PlanEntitlements, type PlanKey, type RunParams, type Session, type Skill, type SkillIndex, type Space, type SpaceMember, type SpaceMessage, type StreamEvent, type StreamEventType, type SubscriptionInfo, type Task, type Tool, type ToolKey, type ToolPermission, type UpdateMemoryParams, type UploadFileInput, type UsageAggregation, type UsageEvent, type WalletBalance, type WalletType, type Workflow, type WorkflowDefinition, type WorkflowEdge, type WorkflowExecution, type WorkflowNode, type WorkflowNodeType, type WorkflowTemplateBuild, type WorkflowTemplateContext, type WorkflowTemplateName, type WorkflowTemplateTool, type WorkflowValue, type WorkflowValueKind, buildWorkflowTemplate, listWorkflowTemplates };