@stacknet/stacks 0.1.0

package/dist/clients/index.d.ts

@@ -0,0 +1,752 @@
+import { F as ChatCompletionRequest, E as ChatCompletionChunk, b6 as TaskPayload, ao as MagmaFile, ac as ImaginationMetadata, al as MCPSessionConfig, ak as MCPSession, am as MCPToolResult, aP as SocialClientConfig, ap as MediaType, a6 as FeedResponse, aF as PostResponse, I as CommentsResponse, aH as RemixesResponse, ag as LikeCheckResponse, ah as LikeResponse, H as CommentResponse, X as CreatePostInput, Y as CreatePostResponse, aG as ProfileResponse, p as AgentsClientConfig, q as AgentsListResponse, e as Agent, f as AgentCreateInput, j as AgentResponse, l as AgentUpdateInput, g as AgentExecuteRequest, h as AgentExecuteResponse, i as AgentFromPromptInput, bi as WidgetsClientConfig, bj as WidgetsListResponse, bd as Widget, be as WidgetCreateInput, bf as WidgetResponse, bh as WidgetUpdateInput, bg as WidgetSystemPromptResponse, b9 as UserClientConfig, ba as UserProfile, bc as UserProfileUpdateInput, bb as UserProfileResponse, a8 as FilesClientConfig, a7 as FileUploadResponse, aM as SkillsClientConfig, aN as SkillsListResponse, aI as Skill, aJ as SkillCreateInput, aK as SkillResponse, aL as SkillUpdateInput, bn as SkillVerifyResponse, bo as SkillMapResponse, bp as SkillMapPromptResponse, bq as SkillSummaryResponse, aE as PointsClientConfig, ae as InitNetworkResponse, a5 as DomainsListResponse, O as ContextDomain, V as CreateDomainInput, a4 as DomainResponse, Q as ContextsListResponse, az as PointContext, S as CreateContextInput, P as ContextResponse, a0 as DelegationFilters, a3 as DelegationsListResponse, U as CreateDelegationInput, a1 as DelegationResponse, d as AddPointsInput, aB as PointRecordResponse, aU as SpendPointsInput, aD as PointSpendResponse, ay as PointBalance, a9 as HistoryFilters, aa as HistoryResponse, a_ as StackManagementClientConfig, Z as CreateStackRequest, b3 as StackResponse, aZ as StackListResponse, aW as StackConfig, J as ConfigureOAuthInput, b2 as StackOAuthProvider, L as ConfigureWeb3Input, b5 as StackWeb3Provider, K as ConfigureStripeInput, b4 as StackStripeProvider, W as CreateKeyResponse, aY as StackKeysListResponse, r as AllowlistConfig, t as AllowlistUpdateInput, at as ModelLayersResponse, b0 as StackMemberStats, a$ as StackMember, au as NetworkClientConfig, av as NetworkStatus, an as MPCNode, N as ConsensusStatus, af as LeaderStatus, u as AuthMetrics, B as BillingClientConfig, w as BillingPlansResponse, y as BillingState, R as CreateCheckoutSessionResponse, x as BillingPortalResponse } from '../billing-BaJlf_S8.js';
+
+/**
+ * TaskNetworkClient - OpenAI-compatible SDK for StackNet
+ *
+ * Provides streaming chat completions via the local StackNet
+ */
+
+interface TaskNetworkConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    timeout?: number;
+}
+declare class TaskNetworkClient {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    constructor(config?: TaskNetworkConfig);
+    /**
+     * OpenAI-compatible streaming chat completions
+     */
+    chatCompletions(request: ChatCompletionRequest): AsyncIterable<ChatCompletionChunk>;
+    /**
+     * Submit a task to the network
+     * Returns taskId. If result is immediately available, also includes output.
+     */
+    submitTask(payload: TaskPayload): Promise<string>;
+    /**
+     * Submit a task and get full response (for immediate results)
+     */
+    submitTaskFull(payload: TaskPayload): Promise<{
+        taskId: string;
+        output?: unknown;
+        status?: string;
+    }>;
+    /**
+     * Get task status
+     */
+    getTask(taskId: string): Promise<{
+        status: string;
+        result?: unknown;
+    }>;
+    /**
+     * Stream task results as OpenAI-compatible chunks
+     */
+    streamTaskResults(taskId: string, model: string): AsyncIterable<ChatCompletionChunk>;
+    /**
+     * Stream raw task results (not OpenAI format)
+     */
+    streamTaskRaw(taskId: string): AsyncIterable<unknown>;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get node information
+     */
+    getNode(): Promise<unknown>;
+}
+/**
+ * Factory function to create a client
+ */
+declare function createTaskNetworkClient(config?: TaskNetworkConfig): TaskNetworkClient;
+/**
+ * Default singleton instance
+ */
+declare const taskNetworkClient: TaskNetworkClient;
+
+/**
+ * MagmaClient - File storage and imagination management
+ *
+ * Interfaces with the MetaChain P2P network for distributed file storage
+ */
+
+interface MagmaClientConfig {
+    baseUrl?: string;
+    localServerUrl?: string;
+}
+declare class MagmaClient {
+    private baseUrl;
+    private localServerUrl;
+    constructor(config?: MagmaClientConfig);
+    /**
+     * Upload a file and get its CID
+     */
+    uploadFile(file: File): Promise<MagmaFile>;
+    /**
+     * Upload text content and get its CID
+     */
+    uploadText(text: string, name: string): Promise<MagmaFile>;
+    /**
+     * Store imagination metadata in P2P network
+     */
+    storeImagination(imagination: ImaginationMetadata & {
+        is_public?: boolean;
+    }): Promise<string>;
+    /**
+     * Retrieve imagination from P2P network by ID
+     */
+    getImagination(id: string): Promise<ImaginationMetadata | null>;
+    /**
+     * Get imagination by CID
+     */
+    getImaginationByCID(cid: string): Promise<ImaginationMetadata | null>;
+    /**
+     * List all imaginations for a user
+     */
+    listImaginations(creatorMid?: string): Promise<ImaginationMetadata[]>;
+    /**
+     * Fallback method to list imaginations from localStorage
+     */
+    private listImaginationsFromLocalStorage;
+    /**
+     * Retrieve file from Magma network
+     */
+    getFile(cid: string): Promise<Blob | null>;
+    /**
+     * Helper to convert ArrayBuffer to base64
+     */
+    private arrayBufferToBase64;
+}
+/**
+ * Factory function to create a client
+ */
+declare function createMagmaClient(config?: MagmaClientConfig): MagmaClient;
+/**
+ * Default singleton instance
+ */
+declare const magmaClient: MagmaClient;
+
+/**
+ * MCPClient - Model Context Protocol client
+ *
+ * Simple MCP client for communicating with magmanode MCP services
+ */
+
+declare class MCPClient {
+    private baseUrl;
+    private timeout;
+    private sessions;
+    constructor(config?: MCPSessionConfig);
+    /**
+     * Create a new MCP session
+     */
+    createSession(agentId?: string): Promise<MCPSession>;
+    /**
+     * Get session by ID
+     */
+    getSession(sessionId: string): MCPSession | undefined;
+    /**
+     * Close a session
+     */
+    closeSession(sessionId: string): Promise<void>;
+    /**
+     * Send a message to an MCP session
+     */
+    sendMessage(sessionId: string, message: string): Promise<unknown>;
+    /**
+     * Call an MCP tool
+     */
+    callTool(sessionId: string, toolName: string, args?: Record<string, unknown>): Promise<MCPToolResult>;
+    /**
+     * List available tools for a session
+     */
+    listTools(sessionId: string): Promise<string[]>;
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): MCPSession[];
+    /**
+     * Close all sessions
+     */
+    closeAllSessions(): Promise<void>;
+}
+/**
+ * Factory function to create a client
+ */
+declare function createMCPClient(config?: MCPSessionConfig): MCPClient;
+/**
+ * Default singleton instance
+ */
+declare const mcpClient: MCPClient;
+
+/**
+ * Social Network Client
+ * Client for interacting with the P2P social network API
+ */
+
+declare class SocialClient {
+    private baseUrl;
+    constructor(config?: SocialClientConfig);
+    private get socialUrl();
+    /**
+     * Fetch feed with pagination
+     */
+    getFeed(options?: {
+        page?: number;
+        limit?: number;
+        mediaType?: MediaType;
+    }): Promise<FeedResponse>;
+    /**
+     * Fetch a single post by ID
+     */
+    getPost(postId: string): Promise<PostResponse>;
+    /**
+     * Fetch comments for a post
+     */
+    getComments(postId: string): Promise<CommentsResponse>;
+    /**
+     * Fetch remixes for a post
+     */
+    getRemixes(postId: string): Promise<RemixesResponse>;
+    /**
+     * Check if a user has liked a post
+     */
+    checkLike(postId: string, userMid: string): Promise<LikeCheckResponse>;
+    /**
+     * Like a post
+     */
+    likePost(postId: string, userMid: string): Promise<LikeResponse>;
+    /**
+     * Unlike a post
+     */
+    unlikePost(postId: string, userMid: string): Promise<LikeResponse>;
+    /**
+     * Add a comment to a post
+     */
+    addComment(postId: string, userMid: string, content: string): Promise<CommentResponse>;
+    /**
+     * Create a new post
+     */
+    createPost(input: CreatePostInput): Promise<CreatePostResponse>;
+    /**
+     * Track a view on a post
+     */
+    trackView(postId: string, userMid?: string): Promise<void>;
+    /**
+     * Track a play on audio/video post
+     */
+    trackPlay(postId: string, userMid?: string): Promise<void>;
+    /**
+     * Get user profile by MID
+     */
+    getProfile(mid: string): Promise<ProfileResponse | null>;
+}
+/**
+ * Create a SocialClient instance
+ */
+declare function createSocialClient(config?: SocialClientConfig): SocialClient;
+/**
+ * Default social client instance
+ */
+declare const socialClient: SocialClient;
+
+/**
+ * Agents Client
+ * Client for interacting with the agents API
+ */
+
+declare class AgentsClient {
+    private baseUrl;
+    private useCpxApi;
+    constructor(config?: AgentsClientConfig);
+    private get agentsUrl();
+    /**
+     * List all agents
+     */
+    list(options?: {
+        userMid?: string;
+    }): Promise<AgentsListResponse>;
+    /**
+     * Get an agent by ID
+     */
+    get(id: string): Promise<Agent>;
+    /**
+     * Create a new agent
+     */
+    create(input: AgentCreateInput): Promise<AgentResponse>;
+    /**
+     * Update an agent
+     */
+    update(id: string, input: AgentUpdateInput): Promise<AgentResponse>;
+    /**
+     * Delete an agent
+     */
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Enable an agent
+     */
+    enable(id: string): Promise<AgentResponse>;
+    /**
+     * Disable an agent
+     */
+    disable(id: string): Promise<AgentResponse>;
+    /**
+     * Execute an agent
+     */
+    execute(id: string, request?: AgentExecuteRequest): Promise<AgentExecuteResponse>;
+    /**
+     * Create agent from prompt (AI-generated)
+     */
+    createFromPrompt(input: AgentFromPromptInput): Promise<AgentResponse>;
+}
+/**
+ * Create an AgentsClient instance
+ */
+declare function createAgentsClient(config?: AgentsClientConfig): AgentsClient;
+/**
+ * Default agents client instance
+ */
+declare const agentsClient: AgentsClient;
+
+/**
+ * Widgets Client
+ * Client for interacting with the widgets API
+ */
+
+declare class WidgetsClient {
+    private baseUrl;
+    constructor(config?: WidgetsClientConfig);
+    private get widgetsUrl();
+    /**
+     * List all widgets
+     */
+    list(options?: {
+        scope?: 'public' | 'private';
+        creatorMid?: string;
+    }): Promise<WidgetsListResponse>;
+    /**
+     * Get a widget by ID
+     */
+    get(id: string): Promise<Widget>;
+    /**
+     * Create a new widget
+     */
+    create(input: WidgetCreateInput): Promise<WidgetResponse>;
+    /**
+     * Update a widget
+     */
+    update(id: string, input: WidgetUpdateInput): Promise<WidgetResponse>;
+    /**
+     * Delete a widget
+     */
+    delete(id: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get system prompt for widgets
+     */
+    getSystemPrompt(): Promise<WidgetSystemPromptResponse>;
+    /**
+     * Track widget usage
+     */
+    trackUsage(id: string): Promise<void>;
+}
+/**
+ * Create a WidgetsClient instance
+ */
+declare function createWidgetsClient(config?: WidgetsClientConfig): WidgetsClient;
+/**
+ * Default widgets client instance
+ */
+declare const widgetsClient: WidgetsClient;
+
+/**
+ * User Client
+ * Client for interacting with user profile API
+ */
+
+declare class UserClient {
+    private baseUrl;
+    constructor(config?: UserClientConfig);
+    private get userUrl();
+    /**
+     * Get user profile by MID
+     */
+    getProfile(mid: string): Promise<UserProfile | null>;
+    /**
+     * Update user profile
+     */
+    updateProfile(mid: string, input: UserProfileUpdateInput): Promise<UserProfileResponse>;
+}
+/**
+ * Create a UserClient instance
+ */
+declare function createUserClient(config?: UserClientConfig): UserClient;
+/**
+ * Default user client instance
+ */
+declare const userClient: UserClient;
+
+/**
+ * Files Client
+ * Client for file upload operations
+ */
+
+declare class FilesClient {
+    private baseUrl;
+    constructor(config?: FilesClientConfig);
+    private get filesUrl();
+    /**
+     * Upload a file
+     */
+    upload(file: File | Blob, filename?: string): Promise<FileUploadResponse>;
+    /**
+     * Upload a file from URL
+     */
+    uploadFromUrl(url: string): Promise<FileUploadResponse>;
+    /**
+     * Get file URL by CID
+     */
+    getFileUrl(cid: string): string;
+}
+/**
+ * Create a FilesClient instance
+ */
+declare function createFilesClient(config?: FilesClientConfig): FilesClient;
+/**
+ * Default files client instance
+ */
+declare const filesClient: FilesClient;
+
+/**
+ * Skills Client
+ *
+ * Client for interacting with the Skills API via the Agent Coprocessor
+ */
+
+declare class SkillsClient {
+    private baseUrl;
+    private useCpxApi;
+    constructor(config?: SkillsClientConfig);
+    private get skillsUrl();
+    /**
+     * List skills
+     */
+    list(options?: {
+        scope?: 'public' | 'private' | 'all';
+        creatorMid?: string;
+        contentType?: 'code' | 'text' | 'image' | 'video' | 'music' | string;
+        precompiled?: boolean;
+    }): Promise<SkillsListResponse>;
+    /**
+     * Get a skill by ID
+     */
+    get(id: string): Promise<Skill>;
+    /**
+     * Create a new skill
+     */
+    create(skill: SkillCreateInput): Promise<SkillResponse>;
+    /**
+     * Update a skill
+     */
+    update(id: string, updates: SkillUpdateInput): Promise<SkillResponse>;
+    /**
+     * Delete a skill
+     */
+    delete(id: string): Promise<SkillResponse>;
+    /**
+     * Track skill usage
+     */
+    trackUsage(id: string): Promise<void>;
+    /**
+     * Verify skill hash integrity
+     */
+    verify(id: string): Promise<SkillVerifyResponse>;
+    /**
+     * Rehash a skill (recompute its hash)
+     */
+    rehash(id: string): Promise<{
+        skillId: string;
+        hash: string | null;
+    }>;
+    /**
+     * Rehash all skills
+     */
+    rehashAll(): Promise<{
+        updated: number;
+        total: number;
+    }>;
+    /**
+     * Get skill map (JSON format)
+     */
+    getMap(contentType?: string): Promise<SkillMapResponse>;
+    /**
+     * Get skill map as system prompt
+     */
+    getMapPrompt(contentType?: string): Promise<SkillMapPromptResponse>;
+    /**
+     * Get non-code skill map prompt
+     */
+    getNonCodeMap(): Promise<SkillMapPromptResponse>;
+    /**
+     * Get non-code skill summary
+     */
+    getNonCodeSummary(): Promise<SkillSummaryResponse>;
+}
+declare function createSkillsClient(config?: SkillsClientConfig): SkillsClient;
+declare const skillsClient: SkillsClient;
+
+/**
+ * Points Client
+ *
+ * Client for interacting with the Points Coprocessor API.
+ * Provides access to the internal reward and reputation framework for StackNet.
+ */
+
+declare class PointsClient {
+    private baseUrl;
+    constructor(config?: PointsClientConfig);
+    private get pointsUrl();
+    /**
+     * Initialize the default geoffnet domain and contexts.
+     * Should only be called once during network bootstrap.
+     */
+    initNetworkDomain(): Promise<InitNetworkResponse>;
+    /**
+     * List all context domains
+     */
+    listDomains(): Promise<DomainsListResponse>;
+    /**
+     * Get a domain by ID
+     */
+    getDomain(domainId: string): Promise<ContextDomain | null>;
+    /**
+     * Create a new context domain.
+     * Note: Requires 402 payment for non-default domains.
+     */
+    createDomain(input: CreateDomainInput): Promise<DomainResponse>;
+    /**
+     * List all point contexts, optionally filtered by domain
+     */
+    listContexts(domainId?: string): Promise<ContextsListResponse>;
+    /**
+     * Get a context by ID
+     */
+    getContext(contextId: string): Promise<PointContext | null>;
+    /**
+     * Create a new point context.
+     * Note: Requires 402 payment for non-default contexts.
+     */
+    createContext(input: CreateContextInput): Promise<ContextResponse>;
+    /**
+     * List delegations with optional filters
+     */
+    listDelegations(filters?: DelegationFilters): Promise<DelegationsListResponse>;
+    /**
+     * Create a new delegation
+     */
+    createDelegation(input: CreateDelegationInput): Promise<DelegationResponse>;
+    /**
+     * Revoke a delegation
+     */
+    revokeDelegation(delegationId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Add points (positive or negative) to an MID
+     */
+    addPoints(input: AddPointsInput): Promise<PointRecordResponse>;
+    /**
+     * Spend points (settlement via MetaChain)
+     */
+    spendPoints(input: SpendPointsInput): Promise<PointSpendResponse>;
+    /**
+     * Get points balance for an MID
+     */
+    getBalance(mid: string, options?: {
+        domainId?: string;
+        contextId?: string;
+    }): Promise<PointBalance>;
+    /**
+     * Get points history with optional filters
+     */
+    getHistory(filters?: HistoryFilters): Promise<HistoryResponse>;
+}
+/**
+ * Create a PointsClient instance
+ */
+declare function createPointsClient(config?: PointsClientConfig): PointsClient;
+/**
+ * Default points client instance
+ */
+declare const pointsClient: PointsClient;
+
+/**
+ * Stack Management Client
+ * CRUD operations for stacks, providers, keys, allowlists, capabilities, members, and model layers
+ */
+
+declare class StackManagementClient {
+    private baseUrl;
+    private authToken;
+    constructor(config?: StackManagementClientConfig);
+    /** Update the auth token (e.g. after login via userutils) */
+    setAuthToken(token: string | null): void;
+    private get headers();
+    private url;
+    private request;
+    createStack(input: CreateStackRequest): Promise<StackResponse>;
+    listStacks(): Promise<StackListResponse>;
+    getStack(stackId: string): Promise<StackResponse>;
+    updateStack(stackId: string, updates: Partial<StackConfig>): Promise<StackResponse>;
+    deleteStack(stackId: string): Promise<{
+        deleted: boolean;
+    }>;
+    /** @server-only — Sends OAuth clientSecret. Only call from server-side code. */
+    configureOAuthProvider(stackId: string, provider: string, config: ConfigureOAuthInput): Promise<StackOAuthProvider>;
+    removeOAuthProvider(stackId: string, provider: string): Promise<{
+        removed: boolean;
+    }>;
+    configureWeb3Provider(stackId: string, provider: string, config: ConfigureWeb3Input): Promise<StackWeb3Provider>;
+    removeWeb3Provider(stackId: string, provider: string): Promise<{
+        removed: boolean;
+    }>;
+    /** @server-only — Sends Stripe secretKey. Only call from server-side code. */
+    configureStripeProvider(stackId: string, config: ConfigureStripeInput): Promise<StackStripeProvider>;
+    getStripeProvider(stackId: string): Promise<StackStripeProvider>;
+    removeStripeProvider(stackId: string): Promise<{
+        removed: boolean;
+    }>;
+    createPaymentIntent(stackId: string, amountCents: number, metadata?: Record<string, string>): Promise<{
+        clientSecret: string;
+        paymentIntentId: string;
+    }>;
+    createKey(stackId: string, name: string, permission: 'read' | 'write'): Promise<CreateKeyResponse>;
+    listKeys(stackId: string): Promise<StackKeysListResponse>;
+    revokeKey(stackId: string, keyId: string): Promise<{
+        success: boolean;
+    }>;
+    getAllowlist(stackId: string): Promise<AllowlistConfig>;
+    updateAllowlist(stackId: string, config: AllowlistUpdateInput): Promise<AllowlistConfig>;
+    updateCapabilities(stackId: string, capabilityBitmask: number): Promise<StackResponse>;
+    getModelLayers(stackId: string): Promise<ModelLayersResponse>;
+    updateModelAlias(stackId: string, layer: string, capability: string, alias: string): Promise<{
+        updated: boolean;
+    }>;
+    resetModelAlias(stackId: string, layer: string, capability: string): Promise<{
+        updated: boolean;
+    }>;
+    uploadLogo(stackId: string, file: File): Promise<StackResponse>;
+    deleteLogo(stackId: string): Promise<StackResponse>;
+    getMemberStats(stackId: string): Promise<StackMemberStats>;
+    getMembers(stackId: string, opts?: {
+        limit?: number;
+        offset?: number;
+        role?: string;
+    }): Promise<StackMember[]>;
+    updateMemberRole(stackId: string, userId: string, role: 'admin' | 'user'): Promise<{
+        success: boolean;
+    }>;
+    getUsageRecords(stackId: string, opts?: {
+        page?: number;
+        limit?: number;
+        days?: number;
+        model?: string;
+    }): Promise<{
+        data: any[];
+        pagination: any;
+    }>;
+}
+/**
+ * Create a StackManagementClient instance
+ */
+declare function createStackManagementClient(config?: StackManagementClientConfig): StackManagementClient;
+/**
+ * Default stack management client instance
+ */
+declare const stackManagementClient: StackManagementClient;
+
+/**
+ * Network Client
+ * Network status, MPC nodes, consensus, and auth metrics
+ */
+
+declare class NetworkClient {
+    private baseUrl;
+    private authToken;
+    constructor(config?: NetworkClientConfig);
+    setAuthToken(token: string | null): void;
+    private get headers();
+    private request;
+    checkHealth(): Promise<boolean>;
+    getNetworkStatus(): Promise<NetworkStatus>;
+    getMPCNodes(): Promise<MPCNode[]>;
+    getNodeHealth(nodeId: string): Promise<{
+        healthy: boolean;
+        latency_ms: number;
+    }>;
+    getConsensusStatus(): Promise<ConsensusStatus>;
+    getLeaderStatus(): Promise<LeaderStatus>;
+    getAuthMetrics(stackId?: string): Promise<AuthMetrics>;
+}
+/**
+ * Create a NetworkClient instance
+ */
+declare function createNetworkClient(config?: NetworkClientConfig): NetworkClient;
+/**
+ * Default network client instance
+ */
+declare const networkClient: NetworkClient;
+
+/**
+ * Billing Client
+ * Plans, checkout, usage, and payment management scoped to a stack
+ */
+
+declare class BillingClient {
+    private baseUrl;
+    private authToken;
+    constructor(config?: BillingClientConfig);
+    setAuthToken(token: string | null): void;
+    private get headers();
+    private url;
+    private request;
+    getPlans(stackId: string): Promise<BillingPlansResponse>;
+    getBillingState(stackId: string, identityId: string): Promise<BillingState>;
+    createCheckoutSession(stackId: string, identityId: string, planId: string, successUrl: string, cancelUrl: string): Promise<CreateCheckoutSessionResponse>;
+    createBillingPortal(stackId: string, identityId: string, returnUrl: string): Promise<BillingPortalResponse>;
+    recordUsage(stackId: string, identityId: string, usageType: string, quantity: number, idempotencyKey?: string): Promise<{
+        recorded: boolean;
+        total_usage: number;
+    }>;
+    getCurrentUsage(stackId: string, identityId: string): Promise<{
+        usage: {
+            type: string;
+            quantity: number;
+            amount: number;
+        }[];
+        total_amount: number;
+    }>;
+    linkStripeCustomer(stackId: string, identityId: string, stripeCustomerId: string, sessionId: string): Promise<{
+        linked: boolean;
+    }>;
+    hasPaymentMethod(stackId: string, identityId: string): Promise<{
+        has_payment_method: boolean;
+        card_last_four?: string;
+        card_brand?: string;
+    }>;
+}
+/**
+ * Create a BillingClient instance
+ */
+declare function createBillingClient(config?: BillingClientConfig): BillingClient;
+/**
+ * Default billing client instance
+ */
+declare const billingClient: BillingClient;
+
+export { AgentsClient, AgentsClientConfig, BillingClient, BillingClientConfig, FilesClient, FilesClientConfig, MCPClient, MagmaClient, type MagmaClientConfig, NetworkClient, NetworkClientConfig, PointsClient, PointsClientConfig, SkillsClient, SkillsClientConfig, SocialClient, SocialClientConfig, StackManagementClient, StackManagementClientConfig, TaskNetworkClient, type TaskNetworkConfig, UserClient, UserClientConfig, WidgetsClient, WidgetsClientConfig, agentsClient, billingClient, createAgentsClient, createBillingClient, createFilesClient, createMCPClient, createMagmaClient, createNetworkClient, createPointsClient, createSkillsClient, createSocialClient, createStackManagementClient, createTaskNetworkClient, createUserClient, createWidgetsClient, filesClient, magmaClient, mcpClient, networkClient, pointsClient, skillsClient, socialClient, stackManagementClient, taskNetworkClient, userClient, widgetsClient };