@hashgraphonline/standards-sdk 0.1.164 → 0.1.166

package/dist/browser/hcs-10/sdk.d.ts

@@ -0,0 +1,293 @@
+import { Client, PrivateKey, KeyList, TopicMessageSubmitTransaction, Transaction, TransactionReceipt, PublicKey } from '../../node_modules/@hashgraph/sdk';
+import { RetrievedInscriptionResult } from '@kiloscribe/inscription-sdk';
+import { ILogger } from '../utils';
+import { HCS10BaseClient } from './base-client';
+import { HCSClientConfig, CreateAccountResponse, CreateAgentResponse, CreateMCPServerResponse, StoreHCS11ProfileResponse, AgentRegistrationResult, HandleConnectionRequestResponse, WaitForConnectionConfirmationResponse, GetAccountAndSignerResponse, AgentCreationState, RegistrationProgressCallback, InscribePfpResponse, MCPServerCreationState, CreateRegistryTopicOptions, CreateRegistryTopicResponse } from './types';
+import { InboundTopicType, AgentMetadata, MCPServerBuilder } from '../hcs-11';
+import { FeeConfigBuilderInterface, TopicFeeConfig } from '../fees';
+import { AgentBuilder } from '../hcs-11/agent-builder';
+import { PersonBuilder } from '../hcs-11/person-builder';
+import { InscribeProfileResponse } from '../hcs-11/types';
+export { ConnectionsManager } from './connections-manager';
+export declare class HCS10Client extends HCS10BaseClient {
+    private client;
+    private operatorAccountId;
+    network: string;
+    protected logger: ILogger;
+    protected guardedRegistryBaseUrl: string;
+    private hcs11Client;
+    private operatorCtx;
+    constructor(config: HCSClientConfig);
+    private ensureInitialized;
+    getClient(): Client;
+    /**
+     * Creates a new Hedera account
+     * @param initialBalance Optional initial balance in HBAR (default: 50)
+     * @returns Object with account ID and private key
+     */
+    createAccount(initialBalance?: number): Promise<CreateAccountResponse>;
+    /**
+     * Creates an inbound topic for an agent
+     * @param accountId The account ID associated with the inbound topic
+     * @param topicType Type of inbound topic (public, controlled, or fee-based)
+     * @param ttl Optional Time-To-Live for the topic memo, defaults to 60
+     * @param feeConfigBuilder Optional fee configuration builder for fee-based topics
+     * @returns The topic ID of the created inbound topic
+     */
+    createInboundTopic(accountId: string, topicType: InboundTopicType, ttl?: number, feeConfigBuilder?: FeeConfigBuilderInterface): Promise<string>;
+    createConnectionTopic(params: {
+        inboundTopicId: string;
+        connectionId: number;
+        ttl?: number;
+        adminKey?: PublicKey | KeyList;
+        submitKey?: PublicKey | KeyList;
+        feeConfigBuilder?: FeeConfigBuilderInterface;
+    }): Promise<string>;
+    /**
+     * Creates a new agent with inbound and outbound topics
+     * @param builder The agent builder object
+     * @param ttl Optional Time-To-Live for the topic memos, defaults to 60
+     * @param existingState Optional existing state to resume from
+     * @returns Object with topic IDs
+     */
+    createAgent(builder: AgentBuilder, ttl?: number, existingState?: Partial<AgentCreationState>, progressCallback?: RegistrationProgressCallback): Promise<CreateAgentResponse>;
+    /**
+     * Creates a profile (person or agent) with HCS-10 topics and HCS-11 profile.
+     * This method provides a unified interface for creating both person and agent profiles.
+     *
+     * @param builder - AgentBuilder or PersonBuilder instance
+     * @param options - Optional configuration including progress callback and state
+     * @returns Promise resolving to profile creation result
+     */
+    create(builder: AgentBuilder | PersonBuilder, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        existingState?: AgentCreationState;
+        ttl?: number;
+        updateAccountMemo?: boolean;
+    }): Promise<CreateAgentResponse | InscribeProfileResponse>;
+    /**
+     * Inscribes a profile picture to Hedera
+     * @param buffer Profile picture buffer
+     * @param fileName Filename
+     * @returns Response with topic ID and transaction ID
+     */
+    inscribePfp(buffer: Buffer, fileName: string): Promise<InscribePfpResponse>;
+    /**
+     * Stores an HCS-11 profile for an agent
+     * @param agentName Agent name
+     * @param agentBio Agent description
+     * @param inboundTopicId Inbound topic ID
+     * @param outboundTopicId Outbound topic ID
+     * @param capabilities Agent capability tags
+     * @param metadata Additional metadata
+     * @param pfpBuffer Optional profile picture buffer
+     * @param pfpFileName Optional profile picture filename
+     * @returns Response with topic IDs and transaction ID
+     */
+    storeHCS11Profile(agentName: string, agentBio: string, inboundTopicId: string, outboundTopicId: string, capabilities: number[], metadata: AgentMetadata, pfpBuffer?: Buffer, pfpFileName?: string, existingPfpTopicId?: string): Promise<StoreHCS11ProfileResponse>;
+    private setupFees;
+    private setupExemptKeys;
+    /**
+     * Handles a connection request from another account
+     * @param inboundTopicId Inbound topic ID of your agent
+     * @param requestingAccountId Requesting account ID
+     * @param connectionRequestId Connection request ID
+     * @param connectionFeeConfig Optional fee configuration for the connection topic
+     * @param ttl Optional ttl parameter with default
+     * @returns Response with connection details
+     */
+    handleConnectionRequest(inboundTopicId: string, requestingAccountId: string, connectionRequestId: number, connectionFeeConfig?: FeeConfigBuilderInterface, ttl?: number): Promise<HandleConnectionRequestResponse>;
+    /**
+     * Confirms a connection request from another account
+     * @param inboundTopicId Inbound topic ID
+     * @param connectionTopicId Connection topic ID
+     * @param connectedAccountId Connected account ID
+     * @param connectionId Connection ID
+     * @param memo Memo for the connection request
+     * @param submitKey Optional submit key
+     * @returns Sequence number of the confirmed connection
+     */
+    confirmConnection(inboundTopicId: string, connectionTopicId: string, connectedAccountId: string, connectionId: number, memo: string, submitKey?: PrivateKey): Promise<number>;
+    sendMessage(connectionTopicId: string, data: string, memo?: string, submitKey?: PrivateKey, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        waitMaxAttempts?: number;
+        waitIntervalMs?: number;
+    }): Promise<TransactionReceipt>;
+    private executeTopicCreateTransaction;
+    createTopic(memo: string, adminKey?: boolean | PublicKey | KeyList, submitKey?: boolean | PublicKey | KeyList, feeConfig?: TopicFeeConfig): Promise<string>;
+    submitPayload(topicOrTransaction: string | TopicMessageSubmitTransaction, payload?: object | string, submitKey?: PrivateKey, requiresFee?: boolean): Promise<TransactionReceipt>;
+    inscribeFile(buffer: Buffer, fileName: string, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        waitMaxAttempts?: number;
+        waitIntervalMs?: number;
+    }): Promise<RetrievedInscriptionResult>;
+    /**
+     * Waits for confirmation of a connection request
+     * @param inboundTopicId Inbound topic ID
+     * @param connectionRequestId Connection request ID
+     * @param maxAttempts Maximum number of attempts
+     * @param delayMs Delay between attempts in milliseconds
+     * @returns Connection confirmation details
+     */
+    waitForConnectionConfirmation(inboundTopicId: string, connectionRequestId: number, maxAttempts?: number, delayMs?: number, recordConfirmation?: boolean): Promise<WaitForConnectionConfirmationResponse>;
+    getAccountAndSigner(): GetAccountAndSignerResponse;
+    /**
+     * Creates and registers an agent with a Guarded registry.
+     *
+     * This function performs the following steps:
+     * 1. Creates a new account if no existing account is provided.
+     * 2. Initializes an HCS10 client with the new account.
+     * 3. Creates an agent on the client.
+     * 4. Registers the agent with the Hashgraph Online Guarded Registry.
+     *
+     * @param builder The agent builder object
+     * @param options Optional configuration including progress callback and state management
+     * @returns Agent registration result
+     */
+    createAndRegisterAgent(builder: AgentBuilder, options?: {
+        baseUrl?: string;
+        progressCallback?: RegistrationProgressCallback;
+        existingState?: AgentCreationState;
+        initialBalance?: number;
+    }): Promise<AgentRegistrationResult>;
+    /**
+     * Registers an agent with the guarded registry
+     * @param accountId Account ID to register
+     * @param inboundTopicId Inbound topic ID for the agent
+     * @param network Network type ('mainnet' or 'testnet')
+     * @param options Optional configuration including progress callback and confirmation settings
+     * @returns Registration result
+     */
+    registerAgentWithGuardedRegistry(accountId: string, network?: string, options?: {
+        progressCallback?: RegistrationProgressCallback;
+        maxAttempts?: number;
+        delayMs?: number;
+        existingState?: AgentCreationState;
+    }): Promise<AgentRegistrationResult>;
+    /**
+     * Registers an agent with the guarded registry. Should be called by a registry.
+     * @param registryTopicId - The topic ID of the guarded registry.
+     * @param accountId - The account ID of the agent
+     * @param inboundTopicId - The topic ID of the inbound topic
+     * @param memo - The memo of the agent
+     * @param submitKey - The submit key of the agent
+     */
+    registerAgent(registryTopicId: string, accountId: string, inboundTopicId: string, memo: string, submitKey?: PrivateKey): Promise<void>;
+    getInboundTopicType(topicId: string): Promise<InboundTopicType>;
+    getNetwork(): string;
+    getLogger(): ILogger;
+    /**
+     * Public method to get the operator account ID configured for this client instance.
+     * @returns The operator account ID string, or null if not set.
+     */
+    getOperatorAccountId(): string | null;
+    /**
+     * Creates a scheduled transaction from a transaction object
+     * @param transaction The transaction to schedule
+     * @param memo Optional memo to include with the scheduled transaction
+     * @param expirationTime Optional expiration time in seconds from now
+     * @returns Object with schedule ID and transaction ID
+     */
+    private createScheduledTransaction;
+    /**
+     * Sends a transaction operation on a connection topic
+     * @param connectionTopicId Connection topic ID
+     * @param scheduleId Schedule ID of the scheduled transaction
+     * @param data Human-readable description of the transaction, can also be a JSON string or HRL
+     * @param submitKey Optional submit key
+     * @param options Optional parameters including memo (timestamp is no longer used here)
+     * @returns Transaction receipt
+     */
+    sendTransactionOperation(connectionTopicId: string, scheduleId: string, data: string, submitKey?: PrivateKey, options?: {
+        memo?: string;
+    }): Promise<TransactionReceipt>;
+    /**
+     * Creates and sends a transaction operation in one call
+     * @param connectionTopicId Connection topic ID for sending the transaction operation
+     * @param transaction The transaction to schedule
+     * @param data Human-readable description of the transaction, can also be a JSON string or HRL
+     * @param options Optional parameters for schedule creation and operation memo
+     * @returns Object with schedule details (including scheduleId and its transactionId) and HCS-10 operation receipt
+     */
+    sendTransaction(connectionTopicId: string, transaction: Transaction, data: string, options?: {
+        scheduleMemo?: string;
+        expirationTime?: number;
+        submitKey?: PrivateKey;
+        operationMemo?: string;
+        schedulePayerAccountId?: string;
+    }): Promise<{
+        scheduleId: string;
+        transactionId: string;
+        receipt: TransactionReceipt;
+    }>;
+    /**
+     * Creates communication topics (inbound and outbound) for a profile.
+     * Helper method used by the create method.
+     */
+    private createCommunicationTopics;
+    /**
+     * Handles profile picture creation by inscribing it.
+     * Helper method used by the create method.
+     */
+    private handleProfilePictureCreation;
+    /**
+     * Creates and inscribes the HCS-11 profile.
+     * Helper method used by the create method.
+     */
+    private createAndInscribeProfile;
+    /**
+     * Creates a new MCP server with inbound and outbound topics.
+     *
+     * This method creates communication topics and profiles required for an MCP server,
+     * registers the profile with the server's account, and handles profile picture
+     * inscriptions if provided.
+     *
+     * @param builder The MCP server builder object
+     * @param ttl Optional Time-To-Live for the topic memos, defaults to 60
+     * @param existingState Optional existing state to resume from
+     * @returns Object with topic IDs
+     */
+    createMCPServer(builder: MCPServerBuilder, ttl?: number, existingState?: Partial<MCPServerCreationState>, progressCallback?: RegistrationProgressCallback): Promise<CreateMCPServerResponse>;
+    /**
+     * Creates the base topic structure for an entity (agent or MCP server).
+     *
+     * @param ttl Time-To-Live for topic memos
+     * @param existingTopics Object containing any existing topic IDs to reuse
+     * @param accountId The account ID associated with the entity
+     * @param inboundTopicType Type of inbound topic
+     * @param feeConfig Optional fee configuration for fee-based topics
+     * @param pfpBuffer Optional profile picture buffer
+     * @param pfpFileName Optional profile picture filename
+     * @param progressCallback Optional callback for reporting progress
+     * @returns Object with created topic IDs
+     */
+    private _createEntityTopics;
+    /**
+     * Creates and registers an MCP server with a Guarded registry.
+     *
+     * This function creates a new account if needed, initializes an HCS10 client,
+     * creates an MCP server with inbound and outbound topics, and registers
+     * it with the Hashgraph Online Guarded Registry.
+     *
+     * @param builder The MCP server builder object with configuration
+     * @param options Optional settings for registration process
+     * @returns Registration result with success status and metadata
+     */
+    createAndRegisterMCPServer(builder: MCPServerBuilder, options?: {
+        baseUrl?: string;
+        progressCallback?: RegistrationProgressCallback;
+        existingState?: MCPServerCreationState;
+        initialBalance?: number;
+    }): Promise<AgentRegistrationResult>;
+    /**
+     * Creates a new HCS-10 registry topic with optional metadata stored via HCS-1.
+     *
+     * Registry topics serve as directories for AI agent discovery and follow the
+     * HCS-10 memo format: hcs-10:0:{ttl}:3:[metadataTopicId]
+     *
+     * @param options Configuration options for registry creation
+     * @returns Promise resolving to registry creation result
+     */
+    createRegistryTopic(options?: CreateRegistryTopicOptions): Promise<CreateRegistryTopicResponse>;
+}
+//# sourceMappingURL=sdk.d.ts.map

package/dist/browser/hcs-10/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/hcs-10/sdk.ts"],"names":[],"mappings":"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"}

package/dist/browser/hcs-10/tx.d.ts

@@ -0,0 +1,85 @@
+import { TopicCreateTransaction, TopicMessageSubmitTransaction } from '../../node_modules/@hashgraph/sdk';
+import { buildTopicCreateTx, MaybeKey } from '../common/tx/tx-utils';
+export declare function buildHcs10CreateInboundTopicTx(params: {
+    accountId: string;
+    ttl: number;
+    adminKey?: MaybeKey;
+    submitKey?: MaybeKey;
+    memoOverride?: string;
+    operatorPublicKey?: Parameters<typeof buildTopicCreateTx>[0]['operatorPublicKey'];
+}): TopicCreateTransaction;
+export declare function buildHcs10CreateOutboundTopicTx(params: {
+    ttl: number;
+    submitKey?: MaybeKey;
+    adminKey?: MaybeKey;
+    memoOverride?: string;
+    operatorPublicKey?: Parameters<typeof buildTopicCreateTx>[0]['operatorPublicKey'];
+}): TopicCreateTransaction;
+export declare function buildHcs10CreateConnectionTopicTx(params: {
+    ttl: number;
+    inboundTopicId: string;
+    connectionId: number | string;
+    adminKey?: MaybeKey;
+    submitKey?: MaybeKey;
+    memoOverride?: string;
+    operatorPublicKey?: Parameters<typeof buildTopicCreateTx>[0]['operatorPublicKey'];
+}): TopicCreateTransaction;
+export declare function buildHcs10CreateRegistryTopicTx(params: {
+    ttl: number;
+    metadataTopicId?: string;
+    adminKey?: MaybeKey;
+    submitKey?: MaybeKey;
+    memoOverride?: string;
+    operatorPublicKey?: Parameters<typeof buildTopicCreateTx>[0]['operatorPublicKey'];
+}): TopicCreateTransaction;
+export declare function buildHcs10SubmitConnectionRequestTx(params: {
+    inboundTopicId: string;
+    operatorId: string;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+export declare function buildHcs10ConfirmConnectionTx(params: {
+    inboundTopicId: string;
+    connectionTopicId: string;
+    connectedAccountId: string;
+    operatorId: string;
+    connectionId: number;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+export declare function buildHcs10OutboundConnectionRequestRecordTx(params: {
+    outboundTopicId: string;
+    operatorId: string;
+    connectionRequestId: number;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+export declare function buildHcs10OutboundConnectionCreatedRecordTx(params: {
+    outboundTopicId: string;
+    requestorOutboundTopicId: string;
+    connectionTopicId: string;
+    confirmedRequestId: number;
+    connectionRequestId: number;
+    operatorId: string;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+export declare function buildHcs10SendMessageTx(params: {
+    connectionTopicId: string;
+    operatorId: string;
+    data: string;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+export declare function buildHcs10RegistryRegisterTx(params: {
+    registryTopicId: string;
+    accountId: string;
+    inboundTopicId?: string;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+export declare function buildHcs10RegistryDeleteTx(params: {
+    registryTopicId: string;
+    uid: string;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+export declare function buildHcs10RegistryMigrateTx(params: {
+    registryTopicId: string;
+    targetTopicId: string;
+    memo?: string;
+}): TopicMessageSubmitTransaction;
+//# sourceMappingURL=tx.d.ts.map

package/dist/browser/hcs-10/tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx.d.ts","sourceRoot":"","sources":["../../../src/hcs-10/tx.ts"],"names":[],"mappings":"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"}

package/dist/browser/hcs-10/types.d.ts

@@ -0,0 +1,284 @@
+import { PrivateKey } from '../../node_modules/@hashgraph/sdk';
+import { LogLevel } from '../utils/logger';
+import { AIAgentCapability, AIAgentProfile } from '../hcs-11';
+import { NetworkType } from '../utils/types';
+import { MirrorNodeConfig } from '../services';
+export interface ValidationError {
+    validation: string;
+    code: string;
+    message: string;
+    path: string[];
+}
+export interface RegistrationProgressData {
+    stage: 'preparing' | 'submitting' | 'confirming' | 'completed' | 'verifying' | 'failed';
+    message: string;
+    progressPercent?: number;
+    details?: Record<string, any>;
+}
+export type RegistrationProgressCallback = (data: RegistrationProgressData) => void;
+export interface AgentConfig<T> {
+    accountId: string;
+    privateKey: string;
+    operatorId: string;
+    inboundTopicId: string;
+    outboundTopicId: string;
+    profileTopicId: string;
+    pfpTopicId: string;
+    client: T;
+}
+/**
+ * Configuration for HCS-10 SDK client.
+ *
+ * @example
+ * // Using default Hedera mirror nodes
+ * const config = {
+ *   network: 'testnet',
+ *   operatorId: '0.0.123',
+ *   operatorPrivateKey: 'your-private-key'
+ * };
+ *
+ * @example
+ * // Using HGraph custom mirror node provider
+ * const config = {
+ *   network: 'mainnet',
+ *   operatorId: '0.0.123',
+ *   operatorPrivateKey: 'your-private-key',
+ *   mirrorNode: {
+ *     customUrl: 'https://mainnet.hedera.api.hgraph.dev/v1/<API-KEY>',
+ *     apiKey: 'your-hgraph-api-key'
+ *   }
+ * };
+ */
+export interface HCSClientConfig {
+    /** The Hedera network to connect to */
+    network: NetworkType;
+    /** The operator account ID */
+    operatorId: string;
+    /** The operator private key */
+    operatorPrivateKey: string | PrivateKey;
+    /** The operator public key (optional) */
+    operatorPublicKey?: string;
+    /** Log level for the client */
+    logLevel?: LogLevel;
+    /** Whether to pretty print logs */
+    prettyPrint?: boolean;
+    /** Base URL for the guarded registry */
+    guardedRegistryBaseUrl?: string;
+    /** Default fee amount for HIP-991 fee payments */
+    feeAmount?: number;
+    /** Custom mirror node configuration */
+    mirrorNode?: MirrorNodeConfig;
+    /** Whether to run logger in silent mode */
+    silent?: boolean;
+    /** The key type to use for the operator */
+    keyType?: 'ed25519' | 'ecdsa';
+}
+export interface Message {
+    message: string;
+    sequence_number?: number;
+}
+export interface ApiResponse {
+    messages?: any[];
+    links?: {
+        next?: string;
+    };
+}
+export interface RegistryMetadata {
+    version: string;
+    name: string;
+    description: string;
+    operator: {
+        account: string;
+        name?: string;
+        contact?: string;
+    };
+    categories?: string[];
+    tags?: string[];
+    links?: {
+        documentation?: string;
+        website?: string;
+        community?: string;
+    };
+}
+export interface CreateRegistryTopicOptions {
+    ttl?: number;
+    metadata?: RegistryMetadata;
+    adminKey?: boolean;
+    submitKey?: boolean;
+    waitForConfirmation?: boolean;
+    waitMaxAttempts?: number;
+    waitIntervalMs?: number;
+    progressCallback?: RegistrationProgressCallback;
+}
+export interface CreateRegistryTopicResponse {
+    success: boolean;
+    topicId?: string;
+    transactionId?: string;
+    metadataTopicId?: string;
+    error?: string;
+}
+export interface RegistrationResponse {
+    transaction: string;
+    transaction_id: string;
+}
+export interface Topic {
+    topicId: string;
+    memo: string;
+    adminKey: boolean;
+    submitKey: boolean;
+}
+export interface CreateAgentResponse {
+    inboundTopicId: string;
+    outboundTopicId: string;
+    pfpTopicId: string;
+    profileTopicId: string;
+}
+export interface CreateMCPServerResponse {
+    inboundTopicId: string;
+    outboundTopicId: string;
+    pfpTopicId: string;
+    profileTopicId: string;
+}
+export interface CreateAccountResponse {
+    accountId: string;
+    privateKey: string;
+}
+export interface InscribePfpResponse {
+    pfpTopicId: string;
+    transactionId: string;
+    success: boolean;
+    error?: string;
+}
+export interface TransactMessage {
+    operator_id: string;
+    schedule_id: string;
+    tx_id: string;
+    data?: string;
+    timestamp: number;
+    memo?: string;
+    sequence_number: number;
+}
+export interface StoreHCS11ProfileResponse {
+    profileTopicId: string;
+    pfpTopicId?: string;
+    transactionId: string;
+    success: boolean;
+    error?: string;
+}
+export interface GetTopicsResponse {
+    inboundTopic: string;
+    outboundTopic: string;
+}
+export interface HandleConnectionRequestResponse {
+    connectionTopicId: string;
+    confirmedConnectionSequenceNumber: number;
+    operatorId: string;
+}
+export interface WaitForConnectionConfirmationResponse {
+    connectionTopicId: string;
+    sequence_number: number;
+    confirmedBy: string;
+    memo: string;
+}
+export interface GetAccountAndSignerResponse {
+    accountId: string;
+    signer: PrivateKey;
+}
+export interface AgentRegistrationResult {
+    success: boolean;
+    error?: string;
+    transactionId?: string;
+    transaction?: string;
+    confirmed?: boolean;
+    state?: AgentCreationState;
+    metadata?: {
+        capabilities?: AIAgentCapability[];
+        [key: string]: any;
+    };
+}
+export interface AgentCreationState {
+    pfpTopicId?: string;
+    inboundTopicId?: string;
+    outboundTopicId?: string;
+    profileTopicId?: string;
+    currentStage: 'init' | 'pfp' | 'topics' | 'profile' | 'registration' | 'complete';
+    completedPercentage: number;
+    error?: string;
+    createdResources?: string[];
+    agentMetadata?: Record<string, any>;
+}
+export interface MCPServerCreationState {
+    pfpTopicId?: string;
+    inboundTopicId?: string;
+    outboundTopicId?: string;
+    profileTopicId?: string;
+    currentStage: 'init' | 'pfp' | 'topics' | 'profile' | 'registration' | 'complete';
+    completedPercentage: number;
+    error?: string;
+    createdResources?: string[];
+    serverMetadata?: Record<string, any>;
+}
+export type RegistrationResult = {
+    transaction?: any;
+    transactionId?: string;
+    success: boolean;
+    error?: string;
+    validationErrors?: ValidationError[];
+};
+export interface RegistrationSearchOptions {
+    tags?: AIAgentCapability[];
+    accountId?: string;
+    network?: string;
+}
+interface Registration {
+    id: string;
+    transactionId: string;
+    status: 'pending' | 'success' | 'failed';
+    network: string;
+    accountId: string;
+    inboundTopicId: string;
+    outboundTopicId: string;
+    operatorId: string;
+    metadata: AIAgentProfile;
+    registryTopicId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RegistrationSearchResult {
+    registrations: Registration[];
+    error?: string;
+    success: boolean;
+}
+export interface RegistrationsApiResponse {
+    registrations: Registration[];
+    transaction_id?: string;
+    transaction?: string;
+    error?: string;
+    details?: ValidationError[];
+}
+export interface HCSMessage {
+    p: 'hcs-10';
+    op: 'connection_request' | 'connection_created' | 'message' | 'close_connection' | 'transaction' | 'register' | 'delete' | 'migrate' | 'connection_closed';
+    data?: string;
+    created?: Date;
+    consensus_timestamp?: string;
+    m?: string;
+    payer: string;
+    outbound_topic_id?: string;
+    connection_request_id?: number;
+    confirmed_request_id?: number;
+    connection_topic_id?: string;
+    connected_account_id?: string;
+    requesting_account_id?: string;
+    connection_id?: number;
+    sequence_number: number;
+    operator_id?: string;
+    reason?: string;
+    close_method?: string;
+    schedule_id?: string;
+    account_id?: string;
+    uid?: string;
+    t_id?: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map