@stacknet/stacks 0.1.0

package/dist/billing-BaJlf_S8.d.cts

@@ -0,0 +1,1154 @@
+/**
+ * Task-related type definitions
+ */
+type TaskType = 'video' | 'music' | 'image' | 'ai-prompt' | 'mcp-tool';
+type TaskStatus = 'pending' | 'generating' | 'complete' | 'failed';
+interface TaskState {
+    id: string;
+    chatId: string;
+    messageId: string;
+    type: TaskType;
+    status: TaskStatus;
+    progress: number;
+    message: string;
+    result?: string;
+    error?: string;
+    createdAt: number;
+    updatedAt: number;
+}
+interface TaskPayload {
+    type: string;
+    model?: string;
+    prompt?: string;
+    sessionId?: string;
+    temperature?: number;
+    maxTokens?: number;
+    stream?: boolean;
+    search?: boolean;
+    noTools?: boolean;
+    [key: string]: unknown;
+}
+interface TaskResponse {
+    taskId: string;
+    status: TaskStatus;
+    result?: unknown;
+    error?: string;
+}
+
+/**
+ * Chat and message type definitions
+ */
+interface Message {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+interface ChatCompletionRequest {
+    model: string;
+    messages: Message[];
+    stream?: boolean;
+    temperature?: number;
+    max_tokens?: number;
+    sessionId?: string;
+    search?: boolean;
+}
+interface ChatCompletionChunk {
+    id: string;
+    object: 'chat.completion.chunk';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: 'assistant';
+            content?: string;
+        };
+        finish_reason: string | null;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+interface ChatCompletionResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: 'assistant';
+            content: string;
+        };
+        finish_reason: string;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+
+/**
+ * Imagination and file type definitions
+ */
+interface MagmaFile {
+    cid: string;
+    name: string;
+    size: number;
+    type: string;
+    url: string;
+}
+interface WorkflowData {
+    name: string;
+    coverImage?: string;
+    description: string;
+    examples: Array<{
+        id: string;
+        data: string;
+    }>;
+    workflowJson: string;
+}
+interface ImaginationSource {
+    cid: string;
+    type: 'document' | 'link' | 'voice' | 'image' | 'music' | 'text';
+    name: string;
+    size?: number;
+    content?: string;
+}
+interface ImaginationCharacter {
+    name: string;
+    gender: string;
+    age: string;
+    weight: string;
+    personality: string;
+}
+interface ImaginationMetadata {
+    id: string;
+    title: string;
+    createdAt: string;
+    createdBy: string;
+    sources: ImaginationSource[];
+    summary?: string;
+    character?: ImaginationCharacter;
+    workflow?: WorkflowData;
+    is_public?: boolean;
+}
+
+/**
+ * Agent type definitions
+ */
+interface Agent {
+    id: string;
+    name: string;
+    description?: string;
+    system_prompt?: string;
+    model?: string;
+    tools?: string[];
+    triggers?: AgentTrigger[];
+    workflow?: AgentWorkflow;
+    visibility?: 'public' | 'private' | 'template';
+    creator_mid?: string;
+    created_at?: string;
+    updated_at?: string;
+    enabled?: boolean;
+}
+interface AgentTrigger {
+    type: 'webhook' | 'cron' | 'event';
+    config: Record<string, unknown>;
+}
+interface AgentWorkflow {
+    nodes: AgentWorkflowNode[];
+    edges: AgentWorkflowEdge[];
+}
+interface AgentWorkflowNode {
+    id: string;
+    type: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    data: Record<string, unknown>;
+}
+interface AgentWorkflowEdge {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+}
+interface AgentExecuteRequest {
+    input?: string;
+    context?: Record<string, unknown>;
+    stream?: boolean;
+}
+interface AgentExecuteResponse {
+    id: string;
+    output: string;
+    status: 'success' | 'error';
+    metadata?: Record<string, unknown>;
+}
+interface AgentsListResponse {
+    agents: Agent[];
+}
+interface AgentResponse {
+    agent?: Agent;
+    id?: string;
+    name?: string;
+    error?: string;
+}
+interface AgentCreateInput {
+    name: string;
+    description?: string;
+    system_prompt?: string;
+    model?: string;
+    tools?: string[];
+    triggers?: AgentTrigger[];
+    workflow?: AgentWorkflow;
+    visibility?: 'public' | 'private' | 'template';
+    created_by?: string;
+}
+interface AgentUpdateInput {
+    name?: string;
+    description?: string;
+    system_prompt?: string;
+    model?: string;
+    tools?: string[];
+    triggers?: AgentTrigger[];
+    workflow?: AgentWorkflow;
+    visibility?: 'public' | 'private' | 'template';
+    enabled?: boolean;
+}
+interface AgentFromPromptInput {
+    prompt: string;
+    created_by?: string;
+}
+interface AgentsClientConfig {
+    baseUrl?: string;
+    /**
+     * Use the coprocessor API (/cpx/agent/agents) instead of legacy (/agents).
+     * Defaults to true. Set to false for backwards compatibility.
+     */
+    useCpxApi?: boolean;
+}
+
+/**
+ * MCP (Model Context Protocol) type definitions
+ */
+interface MCPSessionConfig {
+    baseUrl?: string;
+    agentId?: string;
+    timeout?: number;
+}
+interface MCPSession {
+    id: string;
+    agentId: string;
+    status: 'active' | 'closed' | 'error';
+    createdAt: Date;
+}
+interface MCPMessage {
+    role: 'user' | 'assistant';
+    content: MCPContent;
+}
+interface MCPContent {
+    type: 'text' | 'image' | 'tool_use' | 'tool_result';
+    text?: string;
+    data?: string;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+}
+interface MCPToolResult {
+    result: unknown;
+    data?: Record<string, unknown>;
+    error?: string;
+}
+
+/**
+ * Social Network Types
+ */
+interface SocialAuthor {
+    mid: string;
+    username: string;
+    avatar_url: string | null;
+    bio?: string | null;
+}
+type MediaType = 'image' | 'video' | 'audio' | 'animation';
+type Orientation = 'portrait' | 'landscape';
+interface SocialPost {
+    id: string;
+    creator_mid: string;
+    content: string;
+    media_url: string;
+    media_type: MediaType;
+    orientation?: Orientation;
+    poster_url?: string;
+    created_at: number;
+    likes_count: number;
+    comments_count: number;
+    views_count: number;
+    plays_count?: number;
+    remix_of?: string;
+    author: SocialAuthor;
+}
+interface SocialComment {
+    id: string;
+    author_mid: string;
+    content: string;
+    created_at: number;
+    author: SocialAuthor;
+}
+interface SocialRemix {
+    id: string;
+    creator_mid: string;
+    content: string;
+    media_url: string;
+    poster_url?: string;
+    created_at: number;
+    author: SocialAuthor;
+}
+interface FeedResponse {
+    posts: SocialPost[];
+    hasMore: boolean;
+    page: number;
+    total?: number;
+}
+interface PostResponse {
+    post: SocialPost;
+}
+interface CommentsResponse {
+    comments: SocialComment[];
+}
+interface RemixesResponse {
+    remixes: SocialRemix[];
+}
+interface LikeCheckResponse {
+    liked: boolean;
+}
+interface LikeResponse {
+    success: boolean;
+    likes_count?: number;
+}
+interface CommentResponse {
+    success: boolean;
+    comment?: SocialComment;
+}
+interface CreatePostInput {
+    creatorMid: string;
+    content: string;
+    mediaUrl: string;
+    mediaType: MediaType;
+    orientation?: Orientation;
+    posterUrl?: string;
+    remixOf?: string;
+}
+interface CreatePostResponse {
+    success: boolean;
+    post?: SocialPost;
+    id?: string;
+}
+interface ProfileResponse {
+    mid: string;
+    username: string;
+    avatar_url: string | null;
+    bio?: string | null;
+}
+interface SocialClientConfig {
+    baseUrl?: string;
+}
+
+/**
+ * Widget type definitions
+ */
+interface Widget {
+    id: string;
+    name: string;
+    description?: string;
+    component_code: string;
+    styles?: string;
+    props_schema?: Record<string, unknown>;
+    default_props?: Record<string, unknown>;
+    scope?: 'public' | 'private';
+    creator_mid?: string;
+    created_at?: string;
+    updated_at?: string;
+    usage_count?: number;
+}
+interface WidgetsListResponse {
+    widgets: Widget[];
+}
+interface WidgetResponse {
+    widget?: Widget;
+    id?: string;
+    error?: string;
+}
+interface WidgetCreateInput {
+    name: string;
+    description?: string;
+    component_code: string;
+    styles?: string;
+    props_schema?: Record<string, unknown>;
+    default_props?: Record<string, unknown>;
+    scope?: 'public' | 'private';
+    creator_mid?: string;
+}
+interface WidgetUpdateInput {
+    name?: string;
+    description?: string;
+    component_code?: string;
+    styles?: string;
+    props_schema?: Record<string, unknown>;
+    default_props?: Record<string, unknown>;
+    scope?: 'public' | 'private';
+}
+interface WidgetSystemPromptResponse {
+    prompt: string;
+}
+interface WidgetsClientConfig {
+    baseUrl?: string;
+}
+
+/**
+ * User type definitions
+ */
+interface UserProfile {
+    mid: string;
+    username: string;
+    avatar_url: string | null;
+    bio?: string | null;
+    preferences?: string | null;
+    created_at?: string;
+    updated_at?: string;
+}
+interface UserProfileUpdateInput {
+    username?: string;
+    avatar_url?: string | null;
+    bio?: string | null;
+    preferences?: string | null;
+}
+interface UserProfileResponse {
+    profile?: UserProfile;
+    error?: string;
+}
+interface UserClientConfig {
+    baseUrl?: string;
+}
+
+/**
+ * File type definitions
+ */
+interface FileUploadResponse {
+    cid: string;
+    url: string;
+    filePath?: string;
+    size?: number;
+    mimeType?: string;
+}
+interface FilesClientConfig {
+    baseUrl?: string;
+}
+
+/**
+ * Skill Types
+ */
+interface Skill {
+    id: string;
+    name: string;
+    description: string;
+    creator_mid: string;
+    skill_md: string;
+    skill_hash: string | null;
+    scripts: {
+        name: string;
+        content: string;
+    }[] | null;
+    references: {
+        name: string;
+        content: string;
+    }[] | null;
+    assets: {
+        name: string;
+        url: string;
+    }[] | null;
+    tags: string[];
+    version: string;
+    is_public: boolean;
+    usage_count: number;
+    created_at: number;
+    updated_at: number;
+}
+interface SkillsListResponse {
+    skills: Skill[];
+}
+interface SkillResponse {
+    skill?: Skill;
+    skill_id?: string;
+    success?: boolean;
+    error?: string;
+}
+interface SkillCreateInput {
+    name: string;
+    description?: string;
+    skill_md: string;
+    scripts?: {
+        name: string;
+        content: string;
+    }[] | null;
+    references?: {
+        name: string;
+        content: string;
+    }[] | null;
+    assets?: {
+        name: string;
+        url: string;
+    }[] | null;
+    tags?: string[];
+    version?: string;
+    is_public?: boolean;
+    creator_mid?: string;
+}
+interface SkillUpdateInput {
+    name?: string;
+    description?: string;
+    skill_md?: string;
+    scripts?: {
+        name: string;
+        content: string;
+    }[] | null;
+    references?: {
+        name: string;
+        content: string;
+    }[] | null;
+    assets?: {
+        name: string;
+        url: string;
+    }[] | null;
+    tags?: string[];
+    version?: string;
+    is_public?: boolean;
+}
+interface SkillsClientConfig {
+    baseUrl?: string;
+    /**
+     * Use the coprocessor API (/cpx/agent/skills) instead of legacy (/skills).
+     * Defaults to true. Set to false for backwards compatibility.
+     */
+    useCpxApi?: boolean;
+}
+interface SkillVerifyResponse {
+    valid: boolean;
+    expected?: string;
+    actual?: string;
+}
+interface SkillVerifyResponse {
+    valid: boolean;
+    expected?: string;
+    actual?: string;
+}
+interface SkillMapResponse {
+    version: number;
+    generated_at: number;
+    skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        content_type: string;
+        category: string | null;
+        usage_count: number;
+        is_precompiled: boolean;
+        skill_hash: string | null;
+    }>;
+}
+interface SkillMapPromptResponse {
+    prompt: string;
+}
+interface SkillSummaryResponse {
+    summary: string;
+    skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        keywords: string[];
+    }>;
+}
+
+/**
+ * Points Types
+ *
+ * Types for the Points Coprocessor SDK client.
+ */
+/**
+ * Context Domain - namespace for points with authority control
+ */
+interface ContextDomain {
+    id: string;
+    name: string;
+    description?: string;
+    authorityAgent: string;
+    seal: string;
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Point Context - defines what actions/achievements points represent
+ */
+interface PointContext {
+    id: string;
+    domainId: string;
+    name: string;
+    description?: string;
+    unit?: string;
+    allowNegative: boolean;
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Delegation - authority delegation to sub-agents
+ */
+interface Delegation {
+    id: string;
+    domainId: string;
+    delegator: string;
+    delegate: string;
+    scope: DelegationScope;
+    validFrom: number;
+    validUntil: number | null;
+    revoked: boolean;
+    revokedAt?: number;
+    signature: string;
+    createdAt: number;
+}
+interface DelegationScope {
+    pointContexts: string[];
+    maxAmount?: number | null;
+    canDelegate: boolean;
+}
+/**
+ * Point Record - individual point addition/deduction
+ */
+interface PointRecord {
+    id: string;
+    mid: string;
+    domainId: string;
+    contextId: string;
+    amount: number;
+    reason?: string;
+    actionProof: ActionProof;
+    issuer: string;
+    delegationChain?: DelegationChainLink[];
+    signature: string;
+    createdAt: number;
+}
+interface ActionProof {
+    taskId?: string;
+    resultHash?: string;
+    consensusProof?: string;
+    failureType?: string;
+    evidenceHash?: string;
+    metadata?: Record<string, unknown>;
+}
+interface DelegationChainLink {
+    delegationId: string;
+    delegator: string;
+    delegate: string;
+    signature: string;
+}
+/**
+ * Point Spend Record
+ */
+interface PointSpend {
+    id: string;
+    mid: string;
+    domainId: string;
+    contextId: string;
+    amount: number;
+    destination: SpendDestination;
+    metaproof?: string;
+    signature: string;
+    createdAt: number;
+}
+interface SpendDestination {
+    type: 'settlement' | 'burn';
+    target?: string;
+}
+/**
+ * Balance response
+ */
+interface PointBalance {
+    mid: string;
+    domain?: string;
+    total: number;
+    byContext: Record<string, number>;
+}
+interface CreateDomainInput {
+    name: string;
+    description?: string;
+    authorityAgent: string;
+    metadata?: Record<string, unknown>;
+}
+interface CreateContextInput {
+    domainId: string;
+    name: string;
+    description?: string;
+    unit?: string;
+    allowNegative?: boolean;
+    metadata?: Record<string, unknown>;
+}
+interface CreateDelegationInput {
+    domainId: string;
+    delegate: string;
+    scope: DelegationScope;
+    validFrom?: number;
+    validUntil?: number | null;
+}
+interface AddPointsInput {
+    mid: string;
+    domainId: string;
+    contextId: string;
+    amount: number;
+    reason?: string;
+    actionProof: ActionProof;
+    delegationChain?: DelegationChainLink[];
+}
+interface SpendPointsInput {
+    mid: string;
+    domainId: string;
+    contextId: string;
+    amount: number;
+    destination: SpendDestination;
+}
+interface HistoryFilters {
+    mid?: string;
+    domainId?: string;
+    contextId?: string;
+    periodStart?: number;
+    periodEnd?: number;
+    taskId?: string;
+    limit?: number;
+    offset?: number;
+}
+interface DelegationFilters {
+    domainId?: string;
+    delegator?: string;
+    delegate?: string;
+    activeOnly?: boolean;
+}
+interface DomainsListResponse {
+    domains: ContextDomain[];
+}
+interface DomainResponse {
+    domain: ContextDomain;
+    paymentRequired?: boolean;
+}
+interface ContextsListResponse {
+    contexts: PointContext[];
+}
+interface ContextResponse {
+    context: PointContext;
+    paymentRequired?: boolean;
+}
+interface DelegationsListResponse {
+    delegations: Delegation[];
+}
+interface DelegationResponse {
+    delegation: Delegation;
+}
+interface PointRecordResponse {
+    record: PointRecord;
+}
+interface PointSpendResponse {
+    spend: PointSpend;
+    metaproof?: string;
+}
+interface HistoryResponse {
+    records: PointRecord[];
+    total: number;
+}
+interface InitNetworkResponse {
+    domain: ContextDomain;
+    contexts: PointContext[];
+}
+interface PaymentRequiredResponse {
+    error: string;
+    paymentRequired: true;
+    paymentDetails: {
+        type: string;
+        amount: number;
+        currency: string;
+        recipient: string;
+    };
+}
+interface PointsClientConfig {
+    baseUrl?: string;
+}
+
+/**
+ * Stack management type definitions
+ * Types for stack CRUD, configuration, providers, capabilities, and allowlists
+ */
+interface StackConfig {
+    id: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    ownerId: string;
+    allowedChains: string[];
+    oauthProviders: StackOAuthProvider[];
+    web3Providers?: StackWeb3Provider[];
+    stripeProvider?: StackStripeProvider;
+    webhookEndpoint?: string;
+    allowedOrigins: string[];
+    rateLimits?: {
+        requestsPerMinute: number;
+        requestsPerDay: number;
+    };
+    features?: {
+        web3Auth: boolean;
+        oauthAuth: boolean;
+        apiKeyAuth: boolean;
+        billing: boolean;
+    };
+    metadata?: Record<string, any>;
+    modelAliases?: StackModelAlias[];
+    logoCid?: string;
+    logoUrl?: string;
+    createdAt: number;
+    updatedAt: number;
+    isActive: boolean;
+    capabilityBitmask?: number;
+}
+interface CreateStackRequest {
+    name: string;
+    displayName: string;
+    description?: string;
+    allowedChains?: string[];
+    allowedOrigins?: string[];
+}
+interface StackResponse {
+    stack: StackConfig;
+}
+interface StackListResponse {
+    stacks: StackConfig[];
+}
+interface StackOAuthProvider {
+    provider: string;
+    clientId: string;
+    scopes: string[];
+    redirectUri?: string;
+    enabled: boolean;
+}
+interface StackWeb3Provider {
+    provider: 'siwe' | 'siws';
+    domain: string;
+    statement: string;
+    chainId: string;
+    expirationTime?: number;
+    enabled: boolean;
+}
+interface StackStripeProvider {
+    provider: 'stripe';
+    publishableKey: string;
+    enabled: boolean;
+    mode: 'test' | 'live';
+}
+/**
+ * @server-only — Contains secrets. Only use from server-side code (API routes, server actions).
+ * Never import or call from browser/client bundles.
+ */
+interface ConfigureOAuthInput {
+    clientId: string;
+    /** @secret OAuth client secret — never expose to the browser */
+    clientSecret: string;
+    scopes?: string[];
+    redirectUri?: string;
+}
+interface ConfigureWeb3Input {
+    domain: string;
+    statement: string;
+    chainId: string;
+    expirationTime?: number;
+}
+/**
+ * @server-only — Contains secrets. Only use from server-side code (API routes, server actions).
+ * Never import or call from browser/client bundles.
+ */
+interface ConfigureStripeInput {
+    publishableKey: string;
+    /** @secret Stripe secret key — never expose to the browser */
+    secretKey: string;
+}
+interface StackKeyInfo {
+    id: string;
+    keyPrefix: string;
+    name: string;
+    permission: 'read' | 'write';
+    lastUsedAt: number | null;
+    createdAt: number;
+    isRevoked: boolean;
+}
+interface CreateKeyResponse {
+    key: string;
+    keyId: string;
+    keyPrefix: string;
+}
+interface StackKeysListResponse {
+    keys: StackKeyInfo[];
+}
+type AllowlistMode = 'global_fallback' | 'open' | 'explicit';
+interface AllowlistConfig {
+    solana: string[];
+    evm: string[];
+    solanaMode: AllowlistMode;
+    evmMode: AllowlistMode;
+    customSignInMessage: string | null;
+}
+interface AllowlistUpdateInput {
+    solana?: string[];
+    evm?: string[];
+    customSignInMessage?: string | null;
+}
+interface StackModelAlias {
+    layer: string;
+    capability: string;
+    alias: string;
+}
+interface ModelLayerInfo {
+    name: string;
+    aliases: Array<{
+        capability: string;
+        alias: string;
+        defaultAlias: string;
+        modelId: string;
+    }>;
+}
+interface ModelLayersResponse {
+    layers: ModelLayerInfo[];
+}
+declare const CAPABILITY_BITS: {
+    readonly text_input: number;
+    readonly image_input: number;
+    readonly file_input: number;
+    readonly audio_input: number;
+    readonly video_input: number;
+    readonly music_input: number;
+    readonly text_output: number;
+    readonly image_output: number;
+    readonly audio_output: number;
+    readonly video_output: number;
+    readonly embeddings_output: number;
+    readonly music_output: number;
+    readonly skills: number;
+    readonly loops: number;
+    readonly tools: number;
+    readonly pipelines: number;
+    readonly training: number;
+};
+declare const ALL_CAPABILITIES_BITMASK = 131071;
+type CapabilityKey = keyof typeof CAPABILITY_BITS;
+interface StackCapabilities {
+    text_input: boolean;
+    image_input: boolean;
+    file_input: boolean;
+    audio_input: boolean;
+    video_input: boolean;
+    music_input: boolean;
+    text_output: boolean;
+    image_output: boolean;
+    audio_output: boolean;
+    video_output: boolean;
+    embeddings_output: boolean;
+    music_output: boolean;
+    skills: boolean;
+    loops: boolean;
+    tools: boolean;
+    pipelines: boolean;
+    training: boolean;
+}
+declare function capabilitiesToBitmask(caps: StackCapabilities): number;
+declare function bitmaskToCapabilities(mask: number): StackCapabilities;
+interface StackMember {
+    id: string;
+    stack_id: string;
+    user_id: string;
+    role: 'admin' | 'user';
+    auth_method?: string;
+    display_name?: string;
+    created_at: number;
+    last_seen_at: number;
+}
+interface StackMemberStats {
+    total: number;
+    admins: number;
+    users: number;
+    activeLastWeek: number;
+}
+interface StackManagementClientConfig {
+    baseUrl?: string;
+    /** JWT auth token for authenticated requests */
+    authToken?: string;
+}
+
+/**
+ * Network, consensus, and metrics type definitions
+ */
+interface NetworkStatus {
+    total_nodes: number;
+    online_nodes: number;
+    current_leader: string;
+    consensus_health: 'healthy' | 'degraded' | 'unhealthy';
+    last_block_time: number;
+    network_version: string;
+    consensus?: ConsensusStatus;
+}
+interface MPCNode {
+    id: string;
+    name: string;
+    endpoint: string;
+    status: 'online' | 'offline' | 'signing' | 'dkg';
+    public_key_share: string;
+    keyId?: string;
+    last_heartbeat: number;
+    load: number;
+    version: string;
+}
+interface ConsensusStatus {
+    enabled: boolean;
+    node_id?: number;
+    is_leader?: boolean;
+    current_leader?: number;
+    term?: number;
+    last_log_index?: number;
+    commit_index?: number;
+    state_summary?: ConsensusStateSummary;
+    running?: boolean;
+}
+interface ConsensusStateSummary {
+    stack_count: number;
+    session_count: number;
+    task_count: number;
+    worker_count: number;
+}
+interface LeaderStatus {
+    is_leader: boolean;
+}
+interface AuthMetrics {
+    total_global_identities: number;
+    total_registered_stacks: number;
+    stack_identities: number;
+    active_sessions: number;
+    total_tokens_input: number;
+    total_tokens_output: number;
+    total_image_megapixels: number;
+    total_video_megabytes: number;
+    total_audio_megabytes: number;
+    total_input_token_value?: string;
+    total_output_token_value?: string;
+    total_token_value?: string;
+    auth_method_breakdown: {
+        email: number;
+        web3_evm: number;
+        web3_solana: number;
+        web3_bitcoin: number;
+        oauth: number;
+    };
+    signatures_24h: number;
+    avg_signing_time_ms: number;
+    avg_latency_ms: number;
+    dkg_ceremonies_completed: number;
+    attestations_issued_24h: number;
+    attestations_verified_24h: number;
+}
+interface NetworkClientConfig {
+    baseUrl?: string;
+    authToken?: string;
+}
+
+/**
+ * Billing and metered usage type definitions
+ */
+type BillingTier = 'free' | 'starter' | 'pro' | 'enterprise';
+interface BillingPlan {
+    id: string;
+    name: string;
+    tier: BillingTier;
+    price_monthly: number;
+    price_yearly: number;
+    included_units: number;
+    overage_price: number;
+    features: string[];
+}
+interface MeteredUsage {
+    stack_identity_id: string;
+    stack_id: string;
+    period_start: number;
+    period_end: number;
+    usage_type: string;
+    quantity: number;
+    unit_price: number;
+    total_amount: number;
+}
+interface BillingState {
+    stack_identity_id: string;
+    stripe_customer_id?: string;
+    current_tier: BillingTier;
+    subscription_id?: string;
+    subscription_status?: 'active' | 'past_due' | 'canceled' | 'trialing';
+    current_period_start?: number;
+    current_period_end?: number;
+    usage_this_period: MeteredUsage[];
+    total_usage_units: number;
+    total_amount_due: number;
+    has_card_on_file: boolean;
+    updated_at: number;
+}
+interface BillingPlansResponse {
+    plans: BillingPlan[];
+}
+interface CreateCheckoutSessionResponse {
+    checkout_url: string;
+    session_id: string;
+}
+interface BillingPortalResponse {
+    portal_url: string;
+}
+interface UsageRecord {
+    id: string;
+    task_id: string;
+    model: string | null;
+    executor_node_id: string;
+    inbound: {
+        text_tokens: number;
+        image_megapixels: number;
+        video_megabytes: number;
+        audio_megabytes: number;
+    };
+    outbound: {
+        text_tokens: number;
+        image_megapixels: number;
+        video_megabytes: number;
+        audio_megabytes: number;
+    };
+    execution_time_ms: number;
+    recorded_at: number;
+    cost: {
+        input_token_value: string;
+        output_token_value: string;
+        image_value: string;
+        video_value: string;
+        audio_value: string;
+        total_value: string;
+    };
+}
+interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+    has_more: boolean;
+}
+interface BillingClientConfig {
+    baseUrl?: string;
+    authToken?: string;
+}
+
+export { type DelegationChainLink as $, ALL_CAPABILITIES_BITMASK as A, type BillingClientConfig as B, CAPABILITY_BITS as C, type CapabilityKey as D, type ChatCompletionChunk as E, type ChatCompletionRequest as F, type ChatCompletionResponse as G, type CommentResponse as H, type CommentsResponse as I, type ConfigureOAuthInput as J, type ConfigureStripeInput as K, type ConfigureWeb3Input as L, type ConsensusStateSummary as M, type ConsensusStatus as N, type ContextDomain as O, type ContextResponse as P, type ContextsListResponse as Q, type CreateCheckoutSessionResponse as R, type CreateContextInput as S, type TaskType as T, type CreateDelegationInput as U, type CreateDomainInput as V, type CreateKeyResponse as W, type CreatePostInput as X, type CreatePostResponse as Y, type CreateStackRequest as Z, type Delegation as _, type TaskState as a, type StackMember as a$, type DelegationFilters as a0, type DelegationResponse as a1, type DelegationScope as a2, type DelegationsListResponse as a3, type DomainResponse as a4, type DomainsListResponse as a5, type FeedResponse as a6, type FileUploadResponse as a7, type FilesClientConfig as a8, type HistoryFilters as a9, type PointRecord as aA, type PointRecordResponse as aB, type PointSpend as aC, type PointSpendResponse as aD, type PointsClientConfig as aE, type PostResponse as aF, type ProfileResponse as aG, type RemixesResponse as aH, type Skill as aI, type SkillCreateInput as aJ, type SkillResponse as aK, type SkillUpdateInput as aL, type SkillsClientConfig as aM, type SkillsListResponse as aN, type SocialAuthor as aO, type SocialClientConfig as aP, type SocialComment as aQ, type SocialPost as aR, type SocialRemix as aS, type SpendDestination as aT, type SpendPointsInput as aU, type StackCapabilities as aV, type StackConfig as aW, type StackKeyInfo as aX, type StackKeysListResponse as aY, type StackListResponse as aZ, type StackManagementClientConfig as a_, type HistoryResponse as aa, type ImaginationCharacter as ab, type ImaginationMetadata as ac, type ImaginationSource as ad, type InitNetworkResponse as ae, type LeaderStatus as af, type LikeCheckResponse as ag, type LikeResponse as ah, type MCPContent as ai, type MCPMessage as aj, type MCPSession as ak, type MCPSessionConfig as al, type MCPToolResult as am, type MPCNode as an, type MagmaFile as ao, type MediaType as ap, type Message as aq, type MeteredUsage as ar, type ModelLayerInfo as as, type ModelLayersResponse as at, type NetworkClientConfig as au, type NetworkStatus as av, type PaginationMeta as aw, type PaymentRequiredResponse as ax, type PointBalance as ay, type PointContext as az, type TaskStatus as b, type StackMemberStats as b0, type StackModelAlias as b1, type StackOAuthProvider as b2, type StackResponse as b3, type StackStripeProvider as b4, type StackWeb3Provider as b5, type TaskPayload as b6, type TaskResponse as b7, type UsageRecord as b8, type UserClientConfig as b9, type UserProfile as ba, type UserProfileResponse as bb, type UserProfileUpdateInput as bc, type Widget as bd, type WidgetCreateInput as be, type WidgetResponse as bf, type WidgetSystemPromptResponse as bg, type WidgetUpdateInput as bh, type WidgetsClientConfig as bi, type WidgetsListResponse as bj, type WorkflowData as bk, bitmaskToCapabilities as bl, capabilitiesToBitmask as bm, type SkillVerifyResponse as bn, type SkillMapResponse as bo, type SkillMapPromptResponse as bp, type SkillSummaryResponse as bq, type Orientation as br, type ActionProof as c, type AddPointsInput as d, type Agent as e, type AgentCreateInput as f, type AgentExecuteRequest as g, type AgentExecuteResponse as h, type AgentFromPromptInput as i, type AgentResponse as j, type AgentTrigger as k, type AgentUpdateInput as l, type AgentWorkflow as m, type AgentWorkflowEdge as n, type AgentWorkflowNode as o, type AgentsClientConfig as p, type AgentsListResponse as q, type AllowlistConfig as r, type AllowlistMode as s, type AllowlistUpdateInput as t, type AuthMetrics as u, type BillingPlan as v, type BillingPlansResponse as w, type BillingPortalResponse as x, type BillingState as y, type BillingTier as z };