@agent-commons/sdk 0.5.0 → 0.6.0

package/dist/index.d.mts

@@ -327,6 +327,22 @@ interface CreateAgentParams {
     runtimeVersion?: string;
     runtimeConfig?: AgentRuntimeConfig;
 }
+interface GenerateImageParams {
+    prompt: string;
+    n?: number;
+    size?: "1024x1024" | "1024x1536" | "1536x1024" | "auto";
+    quality?: "low" | "medium" | "high" | "auto";
+    sessionId?: string;
+    /** Stable caller-provided identifier used to make capability billing idempotent. */
+    operationId?: string;
+}
+interface GeneratedImageAsset {
+    fileId: string;
+    name: string;
+    url?: string;
+    prompt: string;
+    model: string;
+}
 interface Session {
     sessionId: string;
     agentId: string;
@@ -748,6 +764,19 @@ interface Skill {
     sourceUrl?: string | null;
     createdAt: string;
     updatedAt: string;
+    assignedAgents?: SkillAgentAssignment[];
+}
+interface SkillAgentAssignment {
+    assignmentId: string;
+    agentId: string;
+    agentName: string;
+    agentAvatar?: string | null;
+    isDefault: boolean;
+    isEnabled: boolean;
+}
+interface AgentSkill extends Skill {
+    assignmentId?: string | null;
+    assigned: boolean;
 }
 interface SkillIndex {
     skillId: string;
@@ -773,6 +802,71 @@ interface CreateSkillParams {
     source?: string;
     sourceUrl?: string;
 }
+type CapabilityName = "web_search" | "computer" | "wallet";
+interface CapabilityProviderDefinition {
+    id: string;
+    name: string;
+    credentialFields: string[];
+    endpoint?: boolean;
+}
+interface CapabilityProviderConfiguration {
+    id: string;
+    capability: CapabilityName;
+    provider: string;
+    displayName?: string | null;
+    endpointUrl?: string | null;
+    settings: Record<string, unknown>;
+    status: "active" | "disabled";
+    hasCredentials: boolean;
+    updatedAt: string;
+}
+interface CapabilityProviderInput {
+    provider: string;
+    displayName?: string;
+    endpointUrl?: string;
+    settings?: Record<string, unknown>;
+    credentials?: Record<string, string>;
+    status?: "active" | "disabled";
+}
+type UiPluginPermission = "theme.read" | "navigation";
+interface UiPluginSurface {
+    type: "page" | "widget";
+    title?: string;
+    width?: number;
+    height?: number;
+}
+interface UiPlugin {
+    pluginId: string;
+    ownerUserId: string;
+    workspaceId?: string | null;
+    createdByAgentId?: string | null;
+    codeProjectId: string;
+    name: string;
+    slug: string;
+    description?: string | null;
+    version: string;
+    entryUrl: string;
+    manifest: {
+        schemaVersion: "1";
+        surfaces: UiPluginSurface[];
+        permissions: UiPluginPermission[];
+    };
+    status: "draft" | "active" | "disabled";
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateUiPluginParams {
+    name: string;
+    slug?: string;
+    description?: string;
+    version?: string;
+    codeProjectId: string;
+    manifest: {
+        schemaVersion?: "1";
+        surfaces: UiPluginSurface[];
+        permissions?: UiPluginPermission[];
+    };
+}
 type MemoryType = "episodic" | "semantic" | "procedural";
 type MemorySourceType = "auto" | "manual";
 interface AgentMemory {
@@ -1016,13 +1110,39 @@ interface FileArtifact {
     createdAt?: string;
     [key: string]: unknown;
 }
+interface FileContentDownload {
+    itemId?: string;
+    name?: string;
+    mimeType?: string;
+    url?: string;
+    [key: string]: unknown;
+}
+interface FileContentArtifact {
+    artifactId?: string;
+    kind?: string;
+    mimeType?: string;
+    pageNumber?: number | null;
+    width?: number | null;
+    height?: number | null;
+    url?: string;
+    [key: string]: unknown;
+}
 interface FileContent {
     fileId?: string;
+    name?: string;
     content?: string;
     mimeType?: string;
+    kind?: string;
+    status?: string;
     offset?: number;
     nextOffset?: number | null;
+    totalChars?: number;
     truncated?: boolean;
+    textPreview?: string | null;
+    metadata?: Record<string, unknown>;
+    download?: FileContentDownload;
+    artifacts?: FileContentArtifact[];
+    /** Convenience aliases returned alongside the structured fields. */
     imageUrls?: string[];
     downloadUrl?: string;
     [key: string]: unknown;
@@ -1128,7 +1248,9 @@ interface OAuthConnection {
     providerUserName?: string | null;
     scopes: string[];
     status: string;
+    canRefresh?: boolean;
     lastUsedAt?: string | null;
+    accessTokenExpiresAt?: string | null;
     expiresAt?: string | null;
     metadata?: Record<string, unknown> | null;
     [key: string]: unknown;
@@ -1164,6 +1286,8 @@ interface AgentWallet {
     label?: string | null;
     isActive: boolean;
     createdAt: string;
+    provider?: string | null;
+    providerWalletId?: string | null;
 }
 interface WalletBalance {
     address: string;
@@ -1282,6 +1406,13 @@ declare class CommonsClient {
         update: (agentId: string, params: Partial<CreateAgentParams>) => Promise<{
             data: Agent;
         }>;
+        /**
+         * Generate durable image assets for this agent without routing a
+         * deterministic image operation through an LLM tool-selection turn.
+         */
+        generateImage: (agentId: string, params: GenerateImageParams) => Promise<{
+            data: GeneratedImageAsset[];
+        }>;
         getRuntime: (agentId: string) => Promise<{
             data: AgentRuntime;
         }>;
@@ -1893,6 +2024,12 @@ declare class CommonsClient {
         getIndex: (ownerId?: string) => Promise<{
             data: SkillIndex[];
         }>;
+        listForAgent: (agentId: string) => Promise<{
+            data: AgentSkill[];
+        }>;
+        setAgentAvailability: (skillIdOrSlug: string, agentId: string, isEnabled: boolean) => Promise<{
+            data: unknown;
+        }>;
         create: (params: CreateSkillParams) => Promise<{
             data: Skill;
         }>;
@@ -1902,6 +2039,41 @@ declare class CommonsClient {
         delete: (skillIdOrSlug: string) => Promise<{
             deleted: boolean;
         }>;
+        import: (file: Blob, options?: {
+            fileName?: string;
+            agentId?: string;
+        }) => Promise<{
+            data: Skill;
+        }>;
+    };
+    get providers(): {
+        list: () => Promise<{
+            catalog: Record<CapabilityName, CapabilityProviderDefinition[]>;
+            configurations: CapabilityProviderConfiguration[];
+        }>;
+        configure: (capability: CapabilityName, input: CapabilityProviderInput) => Promise<{
+            data: CapabilityProviderConfiguration;
+        }>;
+        remove: (capability: CapabilityName) => Promise<{
+            deleted: boolean;
+        }>;
+    };
+    get uiPlugins(): {
+        list: (activeOnly?: boolean) => Promise<{
+            data: UiPlugin[];
+        }>;
+        getBySlug: (slug: string) => Promise<{
+            data: UiPlugin;
+        }>;
+        create: (input: CreateUiPluginParams) => Promise<{
+            data: UiPlugin;
+        }>;
+        setStatus: (pluginId: string, status: "draft" | "active" | "disabled") => Promise<{
+            data: UiPlugin;
+        }>;
+        delete: (pluginId: string) => Promise<{
+            deleted: boolean;
+        }>;
     };
     get wallets(): {
         /** List all wallets for an agent. */
@@ -2209,6 +2381,7 @@ declare class CommonsClient {
             source?: string;
             favorite?: boolean;
             sessionId?: string;
+            agentId?: string;
             limit?: number;
             offset?: number;
         }) => Promise<{
@@ -2584,4 +2757,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 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 };
+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 AgentSkill, type AgentWallet, type ApiKey, type ApiKeyPrincipalType, type BillingCatalog, type BillingInvoice, type BillingPaymentMethod, type CapabilityName, type CapabilityProviderConfiguration, type CapabilityProviderDefinition, type CapabilityProviderInput, 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 CreateUiPluginParams, 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 FileContentArtifact, type FileContentDownload, type FlagEvaluation, type GenerateImageParams, type GeneratedImageAsset, 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 SkillAgentAssignment, type SkillIndex, type Space, type SpaceMember, type SpaceMessage, type StreamEvent, type StreamEventType, type SubscriptionInfo, type Task, type Tool, type ToolKey, type ToolPermission, type UiPlugin, type UiPluginPermission, type UiPluginSurface, 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 };

package/dist/index.d.ts

@@ -327,6 +327,22 @@ interface CreateAgentParams {
     runtimeVersion?: string;
     runtimeConfig?: AgentRuntimeConfig;
 }
+interface GenerateImageParams {
+    prompt: string;
+    n?: number;
+    size?: "1024x1024" | "1024x1536" | "1536x1024" | "auto";
+    quality?: "low" | "medium" | "high" | "auto";
+    sessionId?: string;
+    /** Stable caller-provided identifier used to make capability billing idempotent. */
+    operationId?: string;
+}
+interface GeneratedImageAsset {
+    fileId: string;
+    name: string;
+    url?: string;
+    prompt: string;
+    model: string;
+}
 interface Session {
     sessionId: string;
     agentId: string;
@@ -748,6 +764,19 @@ interface Skill {
     sourceUrl?: string | null;
     createdAt: string;
     updatedAt: string;
+    assignedAgents?: SkillAgentAssignment[];
+}
+interface SkillAgentAssignment {
+    assignmentId: string;
+    agentId: string;
+    agentName: string;
+    agentAvatar?: string | null;
+    isDefault: boolean;
+    isEnabled: boolean;
+}
+interface AgentSkill extends Skill {
+    assignmentId?: string | null;
+    assigned: boolean;
 }
 interface SkillIndex {
     skillId: string;
@@ -773,6 +802,71 @@ interface CreateSkillParams {
     source?: string;
     sourceUrl?: string;
 }
+type CapabilityName = "web_search" | "computer" | "wallet";
+interface CapabilityProviderDefinition {
+    id: string;
+    name: string;
+    credentialFields: string[];
+    endpoint?: boolean;
+}
+interface CapabilityProviderConfiguration {
+    id: string;
+    capability: CapabilityName;
+    provider: string;
+    displayName?: string | null;
+    endpointUrl?: string | null;
+    settings: Record<string, unknown>;
+    status: "active" | "disabled";
+    hasCredentials: boolean;
+    updatedAt: string;
+}
+interface CapabilityProviderInput {
+    provider: string;
+    displayName?: string;
+    endpointUrl?: string;
+    settings?: Record<string, unknown>;
+    credentials?: Record<string, string>;
+    status?: "active" | "disabled";
+}
+type UiPluginPermission = "theme.read" | "navigation";
+interface UiPluginSurface {
+    type: "page" | "widget";
+    title?: string;
+    width?: number;
+    height?: number;
+}
+interface UiPlugin {
+    pluginId: string;
+    ownerUserId: string;
+    workspaceId?: string | null;
+    createdByAgentId?: string | null;
+    codeProjectId: string;
+    name: string;
+    slug: string;
+    description?: string | null;
+    version: string;
+    entryUrl: string;
+    manifest: {
+        schemaVersion: "1";
+        surfaces: UiPluginSurface[];
+        permissions: UiPluginPermission[];
+    };
+    status: "draft" | "active" | "disabled";
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateUiPluginParams {
+    name: string;
+    slug?: string;
+    description?: string;
+    version?: string;
+    codeProjectId: string;
+    manifest: {
+        schemaVersion?: "1";
+        surfaces: UiPluginSurface[];
+        permissions?: UiPluginPermission[];
+    };
+}
 type MemoryType = "episodic" | "semantic" | "procedural";
 type MemorySourceType = "auto" | "manual";
 interface AgentMemory {
@@ -1016,13 +1110,39 @@ interface FileArtifact {
     createdAt?: string;
     [key: string]: unknown;
 }
+interface FileContentDownload {
+    itemId?: string;
+    name?: string;
+    mimeType?: string;
+    url?: string;
+    [key: string]: unknown;
+}
+interface FileContentArtifact {
+    artifactId?: string;
+    kind?: string;
+    mimeType?: string;
+    pageNumber?: number | null;
+    width?: number | null;
+    height?: number | null;
+    url?: string;
+    [key: string]: unknown;
+}
 interface FileContent {
     fileId?: string;
+    name?: string;
     content?: string;
     mimeType?: string;
+    kind?: string;
+    status?: string;
     offset?: number;
     nextOffset?: number | null;
+    totalChars?: number;
     truncated?: boolean;
+    textPreview?: string | null;
+    metadata?: Record<string, unknown>;
+    download?: FileContentDownload;
+    artifacts?: FileContentArtifact[];
+    /** Convenience aliases returned alongside the structured fields. */
     imageUrls?: string[];
     downloadUrl?: string;
     [key: string]: unknown;
@@ -1128,7 +1248,9 @@ interface OAuthConnection {
     providerUserName?: string | null;
     scopes: string[];
     status: string;
+    canRefresh?: boolean;
     lastUsedAt?: string | null;
+    accessTokenExpiresAt?: string | null;
     expiresAt?: string | null;
     metadata?: Record<string, unknown> | null;
     [key: string]: unknown;
@@ -1164,6 +1286,8 @@ interface AgentWallet {
     label?: string | null;
     isActive: boolean;
     createdAt: string;
+    provider?: string | null;
+    providerWalletId?: string | null;
 }
 interface WalletBalance {
     address: string;
@@ -1282,6 +1406,13 @@ declare class CommonsClient {
         update: (agentId: string, params: Partial<CreateAgentParams>) => Promise<{
             data: Agent;
         }>;
+        /**
+         * Generate durable image assets for this agent without routing a
+         * deterministic image operation through an LLM tool-selection turn.
+         */
+        generateImage: (agentId: string, params: GenerateImageParams) => Promise<{
+            data: GeneratedImageAsset[];
+        }>;
         getRuntime: (agentId: string) => Promise<{
             data: AgentRuntime;
         }>;
@@ -1893,6 +2024,12 @@ declare class CommonsClient {
         getIndex: (ownerId?: string) => Promise<{
             data: SkillIndex[];
         }>;
+        listForAgent: (agentId: string) => Promise<{
+            data: AgentSkill[];
+        }>;
+        setAgentAvailability: (skillIdOrSlug: string, agentId: string, isEnabled: boolean) => Promise<{
+            data: unknown;
+        }>;
         create: (params: CreateSkillParams) => Promise<{
             data: Skill;
         }>;
@@ -1902,6 +2039,41 @@ declare class CommonsClient {
         delete: (skillIdOrSlug: string) => Promise<{
             deleted: boolean;
         }>;
+        import: (file: Blob, options?: {
+            fileName?: string;
+            agentId?: string;
+        }) => Promise<{
+            data: Skill;
+        }>;
+    };
+    get providers(): {
+        list: () => Promise<{
+            catalog: Record<CapabilityName, CapabilityProviderDefinition[]>;
+            configurations: CapabilityProviderConfiguration[];
+        }>;
+        configure: (capability: CapabilityName, input: CapabilityProviderInput) => Promise<{
+            data: CapabilityProviderConfiguration;
+        }>;
+        remove: (capability: CapabilityName) => Promise<{
+            deleted: boolean;
+        }>;
+    };
+    get uiPlugins(): {
+        list: (activeOnly?: boolean) => Promise<{
+            data: UiPlugin[];
+        }>;
+        getBySlug: (slug: string) => Promise<{
+            data: UiPlugin;
+        }>;
+        create: (input: CreateUiPluginParams) => Promise<{
+            data: UiPlugin;
+        }>;
+        setStatus: (pluginId: string, status: "draft" | "active" | "disabled") => Promise<{
+            data: UiPlugin;
+        }>;
+        delete: (pluginId: string) => Promise<{
+            deleted: boolean;
+        }>;
     };
     get wallets(): {
         /** List all wallets for an agent. */
@@ -2209,6 +2381,7 @@ declare class CommonsClient {
             source?: string;
             favorite?: boolean;
             sessionId?: string;
+            agentId?: string;
             limit?: number;
             offset?: number;
         }) => Promise<{
@@ -2584,4 +2757,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 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 };
+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 AgentSkill, type AgentWallet, type ApiKey, type ApiKeyPrincipalType, type BillingCatalog, type BillingInvoice, type BillingPaymentMethod, type CapabilityName, type CapabilityProviderConfiguration, type CapabilityProviderDefinition, type CapabilityProviderInput, 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 CreateUiPluginParams, 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 FileContentArtifact, type FileContentDownload, type FlagEvaluation, type GenerateImageParams, type GeneratedImageAsset, 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 SkillAgentAssignment, type SkillIndex, type Space, type SpaceMember, type SpaceMessage, type StreamEvent, type StreamEventType, type SubscriptionInfo, type Task, type Tool, type ToolKey, type ToolPermission, type UiPlugin, type UiPluginPermission, type UiPluginSurface, 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 };

package/dist/index.mjs

@@ -104,6 +104,15 @@ var CommonsClient = class {
       list: (owner) => this.request("GET", `/v1/agents${owner ? `?owner=${owner}` : ""}`),
       get: (agentId) => this.request("GET", `/v1/agents/${agentId}`),
       update: (agentId, params) => this.request("PUT", `/v1/agents/${agentId}`, params),
+      /**
+       * Generate durable image assets for this agent without routing a
+       * deterministic image operation through an LLM tool-selection turn.
+       */
+      generateImage: (agentId, params) => this.request(
+        "POST",
+        `/v1/agents/${encodeURIComponent(agentId)}/assets/images`,
+        params
+      ),
       getRuntime: (agentId) => this.request("GET", `/v1/agents/${agentId}/runtime`),
       configureRuntime: (agentId, params) => this.request("PUT", `/v1/agents/${agentId}/runtime`, params),
       deployRuntime: (agentId) => this.request("POST", `/v1/agents/${agentId}/runtime/deploy`),
@@ -595,14 +604,71 @@ var CommonsClient = class {
         const qs = params.toString();
         return this.request("GET", `/v1/skills${qs ? `?${qs}` : ""}`);
       },
-      get: (skillIdOrSlug) => this.request("GET", `/v1/skills/${skillIdOrSlug}`),
+      get: (skillIdOrSlug) => this.request("GET", `/v1/skills/${encodeURIComponent(skillIdOrSlug)}`),
       getIndex: (ownerId) => {
         const qs = ownerId ? `?ownerId=${ownerId}` : "";
         return this.request("GET", `/v1/skills/index${qs}`);
       },
+      listForAgent: (agentId) => this.request("GET", `/v1/skills/agents/${encodeURIComponent(agentId)}`),
+      setAgentAvailability: (skillIdOrSlug, agentId, isEnabled) => this.request(
+        "PUT",
+        `/v1/skills/${encodeURIComponent(skillIdOrSlug)}/agents/${encodeURIComponent(agentId)}`,
+        { isEnabled }
+      ),
       create: (params) => this.request("POST", "/v1/skills", params),
-      update: (skillIdOrSlug, updates) => this.request("PUT", `/v1/skills/${skillIdOrSlug}`, updates),
-      delete: (skillIdOrSlug) => this.request("DELETE", `/v1/skills/${skillIdOrSlug}`)
+      update: (skillIdOrSlug, updates) => this.request(
+        "PUT",
+        `/v1/skills/${encodeURIComponent(skillIdOrSlug)}`,
+        updates
+      ),
+      delete: (skillIdOrSlug) => this.request(
+        "DELETE",
+        `/v1/skills/${encodeURIComponent(skillIdOrSlug)}`
+      ),
+      import: (file, options) => {
+        const body = new FormData();
+        body.append("file", file, options?.fileName || "SKILL.md");
+        if (options?.agentId) body.set("agentId", options.agentId);
+        return this.request("POST", "/v1/skills/import", body);
+      }
+    };
+  }
+  // ── Capability providers ─────────────────────────────────────────────────
+  get providers() {
+    return {
+      list: () => this.request("GET", "/v1/providers"),
+      configure: (capability, input) => this.request(
+        "PUT",
+        `/v1/providers/${encodeURIComponent(capability)}`,
+        input
+      ),
+      remove: (capability) => this.request(
+        "DELETE",
+        `/v1/providers/${encodeURIComponent(capability)}`
+      )
+    };
+  }
+  // ── Sandboxed UI plugins ─────────────────────────────────────────────────
+  get uiPlugins() {
+    return {
+      list: (activeOnly = false) => this.request(
+        "GET",
+        `/v1/ui-plugins${activeOnly ? "?active=true" : ""}`
+      ),
+      getBySlug: (slug) => this.request(
+        "GET",
+        `/v1/ui-plugins/slug/${encodeURIComponent(slug)}`
+      ),
+      create: (input) => this.request("PUT", "/v1/ui-plugins", input),
+      setStatus: (pluginId, status) => this.request(
+        "PUT",
+        `/v1/ui-plugins/${encodeURIComponent(pluginId)}/status`,
+        { status }
+      ),
+      delete: (pluginId) => this.request(
+        "DELETE",
+        `/v1/ui-plugins/${encodeURIComponent(pluginId)}`
+      )
     };
   }
   // ── Wallets ───────────────────────────────────────────────────────────────
@@ -980,6 +1046,7 @@ var CommonsClient = class {
         if (filter?.favorite !== void 0)
           query.set("favorite", String(filter.favorite));
         if (filter?.sessionId) query.set("sessionId", filter.sessionId);
+        if (filter?.agentId) query.set("agentId", filter.agentId);
         if (filter?.limit !== void 0)
           query.set("limit", String(filter.limit));
         if (filter?.offset !== void 0)