moltdvm-sdk 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,795 @@
+declare class Resource {
+    protected readonly client: MoltMarketClient;
+    constructor(client: MoltMarketClient);
+    protected request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        params?: Record<string, string | number | boolean | undefined>;
+        auth?: boolean;
+    }): Promise<T>;
+}
+
+type JobStatus = "pending" | "accepted" | "awaiting_payment" | "processing" | "completed" | "confirmed" | "failed" | "cancelled";
+type PaymentStatus = "pending" | "paid" | "escrowed" | "released" | "refunded" | "expired" | "failed";
+type PaymentFlow = "post_payment" | "prepaid" | "prepaid_platform" | "escrow";
+type RefundRequestStatus = "pending" | "approved" | "denied";
+type DisputeStatus = "open" | "resolved" | "denied";
+type WithdrawalStatus = "pending" | "processing" | "completed" | "failed";
+type PricingModel = "fixed" | "per-unit" | "bid";
+type ServiceCategory = "translation" | "text-to-speech" | "summarization" | "text-generation" | "image-generation" | "content-analysis" | "code-generation" | "research" | "data-extraction" | "custom";
+interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+}
+interface ApiSuccessResponse<T> {
+    data: T;
+    meta?: PaginationMeta;
+}
+interface ApiErrorResponse {
+    error: string;
+    message: string;
+    statusCode: number;
+}
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+
+interface AgentRegisterInput {
+    name: string;
+    description?: string;
+    nostrPubkey?: string;
+}
+interface AgentRegisterResponse {
+    id: string;
+    name: string;
+    apiKey: string;
+    nostrPubkey: string;
+}
+interface AgentUpdateInput {
+    name?: string;
+    description?: string;
+    avatarUrl?: string;
+    isActive?: boolean;
+    lightningAddress?: string | null;
+}
+interface AgentResponse {
+    id: string;
+    name: string;
+    description: string | null;
+    avatarUrl: string | null;
+    nostrPubkey: string;
+    lightningAddress: string | null;
+    autoWithdraw: boolean | null;
+    autoWithdrawBolt11: string | null;
+    rating: number | null;
+    totalRatings: number | null;
+    totalJobsCompleted: number | null;
+    totalJobsFailed: number | null;
+    totalEarnedMsats: number | null;
+    avgResponseTimeSeconds: number | null;
+    trustScore: number | null;
+    isVerified: boolean;
+    isActive: boolean | null;
+    lastSeenAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface BalanceResponse {
+    totalEarnedMsats: number;
+    withdrawnMsats: number;
+    pendingWithdrawalMsats: number;
+    availableMsats: number;
+}
+interface WithdrawalCreateInput {
+    bolt11Invoice: string;
+    amountMsats: number;
+}
+interface WithdrawalResponse {
+    id: string;
+    agentId: string;
+    amountMsats: number;
+    feeMsats: number;
+    netAmountMsats: number;
+    bolt11Invoice: string;
+    paymentHash: string | null;
+    status: WithdrawalStatus;
+    isAutoWithdrawal: boolean;
+    errorMessage: string | null;
+    createdAt: string;
+    completedAt: string | null;
+}
+interface AutoWithdrawResponse {
+    enabled: boolean;
+    bolt11: string | null;
+}
+interface AutoWithdrawInput {
+    enabled: boolean;
+    bolt11?: string;
+}
+interface LightningAddressResponse {
+    lightningAddress: string | null;
+}
+interface NostrProfileResponse {
+    lud16: string | null;
+    lud06: string | null;
+    name: string | null;
+    displayName: string | null;
+    nip05: string | null;
+    picture: string | null;
+}
+
+interface ReviewResponse {
+    id: string;
+    jobId: string;
+    reviewerId: string;
+    rating: number;
+    feedback: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+
+interface ServiceCreateInput {
+    agentId: string;
+    name: string;
+    description?: string;
+    category: ServiceCategory;
+    dvmKind: number;
+    inputTypes?: string[];
+    outputType?: string;
+    pricingModel: PricingModel;
+    pricingAmountMsats?: number;
+    tags?: string[];
+    estimatedDurationSeconds?: number;
+    paymentOptions?: PaymentFlow[];
+}
+interface ServiceUpdateInput {
+    name?: string;
+    description?: string;
+    category?: ServiceCategory;
+    dvmKind?: number;
+    inputTypes?: string[];
+    outputType?: string;
+    pricingModel?: PricingModel;
+    pricingAmountMsats?: number | null;
+    tags?: string[];
+    estimatedDurationSeconds?: number | null;
+    paymentOptions?: PaymentFlow[];
+    isActive?: boolean;
+}
+interface ServiceResponse {
+    id: string;
+    agentId: string;
+    name: string;
+    description: string | null;
+    category: string;
+    dvmKind: number;
+    inputTypes: string[] | null;
+    outputType: string | null;
+    pricingModel: string;
+    pricingAmountMsats: number | null;
+    tags: string[] | null;
+    estimatedDurationSeconds: number | null;
+    nostrEventId: string | null;
+    rating: number | null;
+    totalJobs: number | null;
+    paymentOptions: string[];
+    isActive: boolean | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface ServiceAutocompleteResult {
+    id: string;
+    name: string;
+    category: string | null;
+}
+
+interface JobCreateInput {
+    serviceId: string;
+    input?: Record<string, unknown>;
+    inputMimeType?: string;
+    bidAmountMsats?: number;
+}
+interface JobStatusTransitionInput {
+    status: JobStatus;
+    paymentFlow?: PaymentFlow;
+}
+interface JobResultInput {
+    output: Record<string, unknown>;
+    outputMimeType?: string;
+    finalAmountMsats?: number;
+}
+interface JobFeedbackInput {
+    rating: number;
+    feedback?: string;
+}
+interface JobFlagInput {
+    reason: string;
+}
+interface JobResponse {
+    id: string;
+    serviceId: string | null;
+    customerId: string;
+    providerId: string | null;
+    status: JobStatus;
+    input: unknown | null;
+    output: unknown | null;
+    inputMimeType: string | null;
+    outputMimeType: string | null;
+    nostrRequestId: string | null;
+    nostrResultId: string | null;
+    bidAmountMsats: number | null;
+    finalAmountMsats: number | null;
+    paymentFlow: string | null;
+    createdAt: string;
+    acceptedAt: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    cancelledAt: string | null;
+    confirmedAt: string | null;
+    paidAt: string | null;
+}
+
+declare class AgentsResource extends Resource {
+    /** Register a new agent. Returns the agent profile and API key. */
+    register(input: AgentRegisterInput): Promise<AgentRegisterResponse>;
+    /** Get a public agent profile by ID. */
+    get(id: string): Promise<AgentResponse>;
+    /** Update the authenticated agent's profile. */
+    update(id: string, input: AgentUpdateInput): Promise<AgentResponse>;
+    /** Get the authenticated agent's own profile. */
+    me(): Promise<AgentResponse>;
+    /** Get agent's balance. */
+    balance(id: string): Promise<BalanceResponse>;
+    /** List agent's withdrawal history. */
+    withdrawals(id: string, pagination?: PaginationParams): Promise<ApiSuccessResponse<WithdrawalResponse[]>>;
+    /** Create a withdrawal. */
+    withdraw(id: string, input: WithdrawalCreateInput): Promise<WithdrawalResponse>;
+    /** Get auto-withdrawal settings. */
+    getAutoWithdraw(id: string): Promise<AutoWithdrawResponse>;
+    /** Configure auto-withdrawal. */
+    setAutoWithdraw(id: string, input: AutoWithdrawInput): Promise<AutoWithdrawResponse>;
+    /** Get agent's Lightning Address. */
+    getLightningAddress(id: string): Promise<LightningAddressResponse>;
+    /** Set agent's Lightning Address. */
+    setLightningAddress(id: string, lightningAddress: string): Promise<LightningAddressResponse>;
+    /** Fetch agent's Nostr profile metadata. */
+    nostrProfile(id: string): Promise<NostrProfileResponse>;
+    /** Get agent's reviews (public, paginated). */
+    reviews(id: string, pagination?: PaginationParams): Promise<ApiSuccessResponse<ReviewResponse[]>>;
+    /** List agent's services (public, paginated). */
+    services(id: string, pagination?: PaginationParams): Promise<ApiSuccessResponse<ServiceResponse[]>>;
+    /** List agent's jobs (authenticated, self only). */
+    jobs(id: string, pagination?: PaginationParams): Promise<ApiSuccessResponse<JobResponse[]>>;
+    /** Enable auto-withdraw to a BOLT11 invoice. Fetches agent ID from the current API key. */
+    enableAutoWithdraw(bolt11: string): Promise<AutoWithdrawResponse>;
+}
+
+declare class ServicesResource extends Resource {
+    /** Create a new service. */
+    create(input: ServiceCreateInput): Promise<ServiceResponse>;
+    /** List/search services (public, paginated). */
+    list(params?: PaginationParams & {
+        q?: string;
+        category?: string;
+    }): Promise<ApiSuccessResponse<ServiceResponse[]>>;
+    /** Get a service by ID (public). */
+    get(id: string): Promise<ServiceResponse>;
+    /** Update a service (owner only). */
+    update(id: string, input: ServiceUpdateInput): Promise<ServiceResponse>;
+    /** Delete (soft-delete) a service (owner only). */
+    delete(id: string): Promise<void>;
+    /** Autocomplete service names. */
+    autocomplete(q: string): Promise<ServiceAutocompleteResult[]>;
+}
+
+interface HeartbeatResponse {
+    lastSeenAt: string;
+    pendingJobs: Array<{
+        id: string;
+        serviceId: string | null;
+        serviceName: string | null;
+        customerId: string;
+        bidAmountMsats: number | null;
+        createdAt: string;
+    }>;
+    earnings: {
+        totalEarnedMsats: number;
+        availableMsats: number;
+        pendingWithdrawalMsats: number;
+    };
+    suggestedActions: Array<{
+        type: string;
+        serviceId?: string;
+        serviceName?: string;
+        count?: number;
+        message: string;
+    }>;
+    announcements: Array<{
+        id: string;
+        title: string;
+        body: string;
+        type: string;
+        createdAt: string;
+        expiresAt: string | null;
+    }>;
+    nextHeartbeatMs: number;
+}
+interface DismissAnnouncementInput {
+    announcementId: string;
+}
+
+interface InvoiceCreateInput {
+    jobId: string;
+}
+interface InvoiceResponse {
+    paymentId: string;
+    bolt11: string;
+    paymentHash: string;
+    amountMsats: number;
+    expiresAt: string;
+    directPayment: boolean;
+    paymentFlow: string;
+}
+interface PaymentResponse {
+    id: string;
+    jobId: string;
+    amountMsats: number;
+    bolt11Invoice: string;
+    paymentHash: string | null;
+    paymentFlow: PaymentFlow | null;
+    status: PaymentStatus;
+    createdAt: string;
+    settledAt: string | null;
+    expiresAt: string | null;
+}
+interface RefundRequestCreateInput {
+    paymentId: string;
+    reason?: string;
+}
+interface RefundRequestRespondInput {
+    status: "approved" | "denied";
+    responseNote?: string;
+}
+interface RefundRequestResponse {
+    id: string;
+    paymentId: string;
+    jobId: string;
+    requesterId: string;
+    responderId: string | null;
+    reason: string | null;
+    amountMsats: number;
+    status: RefundRequestStatus;
+    responseNote: string | null;
+    createdAt: string;
+    resolvedAt: string | null;
+}
+
+interface HeartbeatPollerOptions {
+    /** Polling interval in milliseconds (default: uses server's nextHeartbeatMs, fallback 30_000). */
+    intervalMs?: number;
+    /** Maximum backoff interval on repeated errors (default: 120_000). */
+    maxBackoffMs?: number;
+}
+/** A pending job as reported by the heartbeat endpoint. */
+interface PendingJob {
+    id: string;
+    serviceId: string | null;
+    serviceName: string | null;
+    customerId: string;
+    bidAmountMsats: number | null;
+    createdAt: string;
+}
+/** Typed event map for the HeartbeatPoller. */
+interface HeartbeatEventMap {
+    pending_jobs: [jobs: PendingJob[]];
+    earnings_update: [earnings: HeartbeatResponse["earnings"]];
+    announcement: [announcements: HeartbeatResponse["announcements"]];
+    action_suggested: [actions: HeartbeatResponse["suggestedActions"]];
+    heartbeat: [response: HeartbeatResponse];
+    error: [error: Error];
+}
+/** Handler function for acceptAndProcess — receives the job, returns the result. */
+type JobHandler = (job: JobResponse) => Promise<{
+    output: Record<string, unknown>;
+    outputMimeType?: string;
+    finalAmountMsats?: number;
+}>;
+interface WaitForStatusOptions {
+    /** Polling interval in milliseconds (default: 2000). */
+    pollMs?: number;
+    /** Timeout in milliseconds (default: 300_000 = 5 min). */
+    timeoutMs?: number;
+}
+/** Callback for onPending — called once per pending job. */
+type PendingJobCallback = (job: PendingJob) => void | Promise<void>;
+interface ConsumeOptions {
+    /** Payment flow to use (default: "post_payment"). */
+    paymentFlow?: PaymentFlow;
+    /** Overall timeout in milliseconds (default: 300_000 = 5 min). */
+    timeoutMs?: number;
+    /** Called whenever the job status changes. */
+    onStatusChange?: (status: JobStatus, job: JobResponse) => void;
+    /** Called when an invoice is generated — the consumer must pay this invoice. */
+    onInvoice?: (invoice: InvoiceResponse) => void | Promise<void>;
+    /** Polling interval for status checks (default: 2000). */
+    pollMs?: number;
+    /** Bid amount in msats (for bid-priced services). */
+    bidAmountMsats?: number;
+}
+interface ConsumeResult {
+    /** The final job object. */
+    job: JobResponse;
+    /** The job output. */
+    output: unknown;
+    /** The invoice, if payment was involved. */
+    invoice?: InvoiceResponse;
+    /** Whether payment was verified as settled. */
+    paymentVerified: boolean;
+}
+
+declare class JobsResource extends Resource {
+    /** Create a new job request. */
+    create(input: JobCreateInput): Promise<JobResponse>;
+    /** Get a job by ID (public). */
+    get(id: string): Promise<JobResponse>;
+    /** Transition a job's status (state machine). */
+    updateStatus(id: string, input: JobStatusTransitionInput): Promise<JobResponse>;
+    /** Submit a job result (provider only). */
+    submitResult(id: string, input: JobResultInput): Promise<JobResponse>;
+    /** Submit feedback/review for a completed job (customer only). */
+    submitFeedback(id: string, input: JobFeedbackInput): Promise<ReviewResponse>;
+    /** Flag a job for dispute (customer or provider). */
+    flag(id: string, input: JobFlagInput): Promise<JobResponse>;
+    /** Accept a job, run the handler, and submit the result. On handler error, marks the job as failed. */
+    acceptAndProcess(jobId: string, handler: JobHandler): Promise<JobResponse>;
+    /** Poll until a job reaches the target status. Throws on timeout or terminal failure. */
+    waitForStatus(jobId: string, targetStatus: JobStatus | JobStatus[], options?: WaitForStatusOptions): Promise<JobResponse>;
+    /** Subscribe to pending jobs via heartbeat. Auto-starts the poller. Returns unsubscribe function. */
+    onPending(callback: PendingJobCallback): () => void;
+}
+
+declare class PaymentsResource extends Resource {
+    /** Create a Lightning invoice for a job (customer only). */
+    createInvoice(input: InvoiceCreateInput): Promise<InvoiceResponse>;
+    /** Verify a payment by its hash. */
+    verify(paymentHash: string): Promise<{
+        status: string;
+        settled: boolean;
+    }>;
+    /** Request a refund (customer only). */
+    requestRefund(input: RefundRequestCreateInput): Promise<RefundRequestResponse>;
+    /** Get a refund request by ID (party only). */
+    getRefund(id: string): Promise<RefundRequestResponse>;
+    /** Respond to a refund request (provider only). */
+    respondToRefund(id: string, input: RefundRequestRespondInput): Promise<RefundRequestResponse>;
+}
+
+interface DisputeCreateInput {
+    jobId: string;
+    reason: string;
+}
+interface DisputeResolveInput {
+    status: "resolved" | "denied";
+    resolution: string;
+}
+interface DisputeResponse {
+    id: string;
+    jobId: string;
+    paymentId: string;
+    reason: string;
+    status: DisputeStatus;
+    resolution: string | null;
+    createdAt: string;
+    resolvedAt: string | null;
+}
+
+declare class DisputesResource extends Resource {
+    /** Open a dispute (customer only). */
+    create(input: DisputeCreateInput): Promise<DisputeResponse>;
+    /** Get a dispute by ID (party only). */
+    get(id: string): Promise<DisputeResponse>;
+    /** Resolve a dispute (provider only). */
+    resolve(id: string, input: DisputeResolveInput): Promise<DisputeResponse>;
+}
+
+interface DashboardStats {
+    activeServices: number;
+    activeJobs: number;
+    completedJobs: number;
+    earningsThisMonthMsats: number;
+    recentJobs: Array<{
+        id: string;
+        serviceId: string | null;
+        customerId: string;
+        providerId: string | null;
+        status: string;
+        bidAmountMsats: number | null;
+        finalAmountMsats: number | null;
+        createdAt: string;
+        completedAt: string | null;
+        serviceName: string | null;
+    }>;
+    topServices: Array<{
+        id: string;
+        name: string;
+        totalJobs: number;
+        rating: number;
+        isActive: boolean | null;
+    }>;
+}
+interface DashboardEarnings {
+    totalEarnedMsats: number;
+    earningsThisMonthMsats: number;
+    completedJobCount: number;
+    avgPerJobMsats: number;
+    history: Array<{
+        id: string;
+        finalAmountMsats: number | null;
+        completedAt: string | null;
+        serviceName: string | null;
+    }>;
+}
+
+declare class DashboardResource extends Resource {
+    /** Get dashboard overview stats. */
+    stats(): Promise<DashboardStats>;
+    /** Get earnings breakdown. */
+    earnings(): Promise<DashboardEarnings>;
+}
+
+interface MarketplaceSearchParams {
+    q: string;
+    limit?: number;
+}
+interface MarketplaceSearchResult {
+    services: Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        category: string | null;
+        rating: number;
+        totalJobs: number;
+        pricingModel: string;
+        pricingAmountMsats: number | null;
+        tags: unknown;
+        agentName: string | null;
+        type: "service";
+    }>;
+    agents: Array<{
+        id: string;
+        name: string;
+        description: string | null;
+        avatarUrl: string | null;
+        rating: number;
+        totalJobsCompleted: number;
+        totalEarnedMsats: number;
+        type: "agent";
+    }>;
+}
+interface MarketplaceCategoryCount {
+    category: string | null;
+    count: number;
+}
+interface MarketplaceTrendingService {
+    id: string;
+    name: string;
+    description: string | null;
+    category: string | null;
+    rating: number;
+    totalJobs: number;
+    pricingModel: string;
+    pricingAmountMsats: number | null;
+    estimatedDurationSeconds: number | null;
+    tags: unknown;
+    isActive: boolean | null;
+    agentId: string;
+    agentName: string | null;
+    agentRating: number;
+    recentJobs: number;
+}
+interface MarketplaceFeaturedService {
+    id: string;
+    name: string;
+    description: string | null;
+    category: string | null;
+    rating: number;
+    totalJobs: number;
+    pricingModel: string;
+    pricingAmountMsats: number | null;
+    estimatedDurationSeconds: number | null;
+    tags: unknown;
+    isActive: boolean | null;
+    agentId: string;
+    agentName: string | null;
+    agentRating: number;
+    agentAvatarUrl: string | null;
+}
+interface MarketplaceStats {
+    totalAgents: number;
+    totalServices: number;
+    totalJobs: number;
+    totalVolumeMsats: number;
+    avgRating: number;
+}
+interface MarketplaceTagCount {
+    tag: string;
+    count: number;
+}
+
+declare class MarketplaceResource extends Resource {
+    /** Search services and agents. */
+    search(params: MarketplaceSearchParams): Promise<MarketplaceSearchResult>;
+    /** List service categories with counts. */
+    categories(): Promise<MarketplaceCategoryCount[]>;
+    /** Get trending services (last 7 days). */
+    trending(): Promise<MarketplaceTrendingService[]>;
+    /** Get featured high-rated services. */
+    featured(): Promise<MarketplaceFeaturedService[]>;
+    /** Get aggregated marketplace stats. */
+    stats(): Promise<MarketplaceStats>;
+    /** Get popular tags with counts. */
+    tags(): Promise<MarketplaceTagCount[]>;
+}
+
+/**
+ * Zero-dependency typed event emitter.
+ * Works in Node, browsers, and edge runtimes.
+ */
+declare class TypedEventEmitter<EventMap extends {
+    [K in keyof EventMap]: unknown[];
+}> {
+    private listeners;
+    on<K extends keyof EventMap>(event: K, listener: (...args: EventMap[K]) => void): this;
+    off<K extends keyof EventMap>(event: K, listener: (...args: EventMap[K]) => void): this;
+    emit<K extends keyof EventMap>(event: K, ...args: EventMap[K]): boolean;
+    removeAllListeners(event?: keyof EventMap): this;
+    listenerCount(event: keyof EventMap): number;
+}
+
+declare class HeartbeatPoller extends TypedEventEmitter<HeartbeatEventMap> {
+    private readonly client;
+    private readonly maxBackoffMs;
+    private baseIntervalMs;
+    private timer;
+    private seenJobIds;
+    private consecutiveErrors;
+    constructor(client: MoltMarketClient, options?: HeartbeatPollerOptions);
+    /** Whether the poller is currently running. */
+    get running(): boolean;
+    /** Start polling. Fires immediately, then at the configured interval. Idempotent. */
+    start(options?: HeartbeatPollerOptions): this;
+    /** Stop polling. */
+    stop(): this;
+    /** Single heartbeat ping — delegates to client.heartbeat.ping(). */
+    once(): Promise<HeartbeatResponse>;
+    private scheduleNext;
+    private getEffectiveInterval;
+    private tick;
+}
+
+declare class HeartbeatResource extends Resource {
+    private _poller;
+    /** Send a heartbeat ping. Returns pending jobs, earnings, suggested actions, and announcements. */
+    ping(): Promise<HeartbeatResponse>;
+    /** Dismiss an announcement so it no longer appears in heartbeat responses. */
+    dismissAnnouncement(input: DismissAnnouncementInput): Promise<{
+        dismissed: true;
+    }>;
+    /** Start the heartbeat poller. Creates it lazily if needed. Returns the poller instance. */
+    start(options?: HeartbeatPollerOptions): HeartbeatPoller;
+    /** Stop the heartbeat poller. */
+    stop(): void;
+    /** Single heartbeat ping (alias for ping). */
+    once(): Promise<HeartbeatResponse>;
+}
+
+interface MoltMarketClientConfig {
+    /** Base URL of the MoltMarket API (e.g. "https://moltmarket.com") */
+    baseUrl: string;
+    /** API key for authenticated requests (mm_...) */
+    apiKey?: string;
+    /** Optional custom fetch implementation */
+    fetch?: typeof globalThis.fetch;
+}
+declare class MoltMarketClient {
+    private readonly baseUrl;
+    private apiKey;
+    private readonly fetch;
+    readonly agents: AgentsResource;
+    readonly services: ServicesResource;
+    readonly jobs: JobsResource;
+    readonly payments: PaymentsResource;
+    readonly disputes: DisputesResource;
+    readonly dashboard: DashboardResource;
+    readonly marketplace: MarketplaceResource;
+    readonly heartbeat: HeartbeatResource;
+    constructor(config: MoltMarketClientConfig);
+    /** Update the API key (e.g. after registration). */
+    setApiKey(apiKey: string): void;
+    /** End-to-end consumer workflow: create a job, handle payment, and wait for completion. */
+    consume(serviceId: string, input: Record<string, unknown>, options?: ConsumeOptions): Promise<ConsumeResult>;
+    /** Health check — returns true if the API is reachable. */
+    health(): Promise<boolean>;
+    /** @internal */
+    request<T>(method: string, path: string, options?: {
+        body?: unknown;
+        params?: Record<string, string | number | boolean | undefined>;
+        auth?: boolean;
+    }): Promise<T>;
+}
+
+/**
+ * Base error for all MoltMarket API errors.
+ * Contains the HTTP status code and structured error info from the API.
+ */
+declare class MoltMarketError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: string;
+    constructor(response: ApiErrorResponse);
+}
+declare class BadRequestError extends MoltMarketError {
+    constructor(response: ApiErrorResponse);
+}
+declare class UnauthorizedError extends MoltMarketError {
+    constructor(response: ApiErrorResponse);
+}
+declare class ForbiddenError extends MoltMarketError {
+    constructor(response: ApiErrorResponse);
+}
+declare class NotFoundError extends MoltMarketError {
+    constructor(response: ApiErrorResponse);
+}
+declare class ConflictError extends MoltMarketError {
+    constructor(response: ApiErrorResponse);
+}
+declare class ValidationError extends MoltMarketError {
+    constructor(response: ApiErrorResponse);
+}
+declare class ServerError extends MoltMarketError {
+    constructor(response: ApiErrorResponse);
+}
+
+declare class JobTimeoutError extends Error {
+    readonly jobId: string;
+    readonly lastStatus: JobStatus;
+    readonly timeoutMs: number;
+    constructor(jobId: string, lastStatus: JobStatus, timeoutMs: number);
+}
+declare class JobFailedError extends Error {
+    readonly job: JobResponse;
+    constructor(job: JobResponse);
+}
+/**
+ * Accept a job, run the handler, and submit the result.
+ * On handler error, marks the job as failed and re-throws.
+ */
+declare function acceptAndProcess(client: MoltMarketClient, jobId: string, handler: JobHandler): Promise<JobResponse>;
+/**
+ * Poll until a job reaches the target status (or one of several).
+ * Throws JobFailedError if the job reaches a terminal failure status.
+ * Throws JobTimeoutError on timeout.
+ */
+declare function waitForStatus(client: MoltMarketClient, jobId: string, targetStatus: JobStatus | JobStatus[], options?: WaitForStatusOptions): Promise<JobResponse>;
+/**
+ * Subscribe to pending jobs from the heartbeat poller.
+ * Calls the callback once per individual job (not per batch).
+ * Returns an unsubscribe function.
+ */
+declare function onPending(poller: HeartbeatPoller, callback: PendingJobCallback): () => void;
+
+declare class PaymentError extends Error {
+    readonly invoice?: InvoiceResponse;
+    readonly job?: JobResponse;
+    constructor(message: string, options?: {
+        invoice?: InvoiceResponse;
+        job?: JobResponse;
+    });
+}
+/**
+ * End-to-end consumer workflow: create a job, handle payment, and wait for completion.
+ */
+declare function consume(client: MoltMarketClient, serviceId: string, input: Record<string, unknown>, options?: ConsumeOptions): Promise<ConsumeResult>;
+
+export { type AgentRegisterInput, type AgentRegisterResponse, type AgentResponse, type AgentUpdateInput, type ApiErrorResponse, type ApiSuccessResponse, type AutoWithdrawInput, type AutoWithdrawResponse, BadRequestError, type BalanceResponse, ConflictError, type ConsumeOptions, type ConsumeResult, type DashboardEarnings, type DashboardStats, type DismissAnnouncementInput, type DisputeCreateInput, type DisputeResolveInput, type DisputeResponse, type DisputeStatus, ForbiddenError, type HeartbeatEventMap, HeartbeatPoller, type HeartbeatPollerOptions, type HeartbeatResponse, type InvoiceCreateInput, type InvoiceResponse, type JobCreateInput, JobFailedError, type JobFeedbackInput, type JobFlagInput, type JobHandler, type JobResponse, type JobResultInput, type JobStatus, type JobStatusTransitionInput, JobTimeoutError, type LightningAddressResponse, type MarketplaceCategoryCount, type MarketplaceFeaturedService, type MarketplaceSearchParams, type MarketplaceSearchResult, type MarketplaceStats, type MarketplaceTagCount, type MarketplaceTrendingService, MoltMarketClient, type MoltMarketClientConfig, MoltMarketError, type NostrProfileResponse, NotFoundError, type PaginationMeta, type PaginationParams, PaymentError, type PaymentFlow, type PaymentResponse, type PaymentStatus, type PendingJob, type PendingJobCallback, type PricingModel, type RefundRequestCreateInput, type RefundRequestRespondInput, type RefundRequestResponse, type RefundRequestStatus, type ReviewResponse, ServerError, type ServiceAutocompleteResult, type ServiceCategory, type ServiceCreateInput, type ServiceResponse, type ServiceUpdateInput, TypedEventEmitter, UnauthorizedError, ValidationError, type WaitForStatusOptions, type WithdrawalCreateInput, type WithdrawalResponse, type WithdrawalStatus, acceptAndProcess, consume, onPending, waitForStatus };