@compose-market/sdk 0.8.2 → 0.8.5

package/dist/types/index.d.ts

@@ -0,0 +1,1859 @@
+/**
+ * Canonical Compose Market API types.
+ *
+ * These types are the public wire contract between the Compose backend
+ * (`api.compose.market`) and the SDK. They mirror the OpenAPI sources under
+ * `packages/sdk/specs`; if a mismatch is ever observed, the server contract is
+ * authoritative and this file is the one that needs updating.
+ *
+ * Base wire types (payment, receipt, session, errors) are re-exported from
+ * `@compose-market/core`. SDK-specific types (model catalog, inference,
+ * agent/workflow streams, memory loop, feedback) are declared below.
+ */
+export type { ErrorCode, ErrorEnvelope, PaymentRequirements, PaymentRequiredResource, PaymentRequired, PaymentPayload, X402PaymentSignature, X402PaymentRequest, X402PaymentSigner, PaymentMode, ReceiptLineItem, ReceiptFees, ReceiptBill, Receipt, SessionBudgetSnapshot, SessionInvalidReason, SessionActiveEvent, SessionExpiredEvent, SessionLeaseEvent, SessionEvent, Alert, } from "@compose-market/core";
+import type { Receipt, SessionBudgetSnapshot, SessionInvalidReason } from "@compose-market/core";
+import type { AgentStreamControls } from "@compose-market/core/msm";
+export type { AgentStreamControls } from "@compose-market/core/msm";
+export interface SettleResponse {
+    success: boolean;
+    errorReason?: string;
+    errorMessage?: string;
+    payer?: string;
+    transaction?: string;
+    network?: string;
+    amount?: string;
+}
+export interface VerifyResponse {
+    isValid: boolean;
+    invalidReason?: string;
+    invalidMessage?: string;
+    payer?: string;
+}
+export interface FacilitatorSupportedResponse {
+    kinds: Array<{
+        x402Version: number;
+        scheme: string;
+        network: string;
+        extra?: Record<string, unknown>;
+    }>;
+    extensions: string[];
+    signers?: Record<string, string[]>;
+}
+export interface FacilitatorChain {
+    chainId: number;
+    name: string;
+    network: `eip155:${number}`;
+    shortName?: string;
+    isTestnet: boolean;
+    explorer?: string;
+    usdcAddress: `0x${string}`;
+    schemes: readonly ("exact" | "upto")[];
+    asset: "USDC";
+    decimals: 6;
+}
+export interface FacilitatorChainsResponse {
+    chains: FacilitatorChain[];
+    defaultChainId: number;
+}
+export type PaymentIntentStatus = "authorized" | "settling" | "settled" | "aborted" | "failed";
+export interface MeterLineItem {
+    key: string;
+    unit: string;
+    quantity: number;
+    unitPriceUsd: number;
+}
+export interface MeteredInput {
+    subject: string;
+    lineItems: MeterLineItem[];
+}
+export interface MeteredQuotedLineItem extends MeterLineItem {
+    amountWei: string;
+}
+export interface MeteredQuote {
+    subject: string;
+    lineItems: MeteredQuotedLineItem[];
+    providerAmountWei: string;
+    platformFeeWei: string;
+    finalAmountWei: string;
+}
+export interface ModelMeterQuote extends MeteredQuote {
+    modelId: string;
+    provider: ModelProvider;
+    known: boolean;
+    meter: MeteredInput;
+}
+export interface PaymentPrepareInput {
+    service: string;
+    action: string;
+    resource: string;
+    method: string;
+    maxAmountWei?: string;
+    meter?: MeteredInput;
+    runId?: string;
+    idempotencyKey?: string;
+}
+export interface PaymentPrepareResponse {
+    paymentIntentId: string;
+    maxAmountWei: string;
+    status: PaymentIntentStatus;
+    [key: string]: unknown;
+}
+export interface PaymentSettleInput {
+    paymentIntentId: string;
+    finalAmountWei?: string;
+    meter?: MeteredInput;
+}
+export interface PaymentSettleResponse {
+    paymentIntentId: string;
+    maxAmountWei: string;
+    finalAmountWei: string;
+    status: PaymentIntentStatus;
+    meterSubject?: string;
+    lineItems?: MeteredQuotedLineItem[];
+    providerAmountWei?: string;
+    platformFeeWei?: string;
+    txHash?: string;
+    [key: string]: unknown;
+}
+export interface PaymentAbortInput {
+    paymentIntentId: string;
+    reason?: string;
+}
+export interface PaymentAbortResponse {
+    success?: boolean;
+    paymentIntentId: string;
+    status?: PaymentIntentStatus;
+    reason?: string;
+    [key: string]: unknown;
+}
+export interface ModelMeterInput {
+    modelId: string;
+    modality: CanonicalModality | string;
+    usage?: Record<string, unknown>;
+    media?: Record<string, unknown>;
+}
+export type FeedbackTargetType = "endpoint" | "x402" | "model" | "agent" | "workflow";
+export type FeedbackCategory = "general" | "bug" | "latency" | "quality" | "pricing" | "settlement" | "model_capability" | "safety" | "docs" | "integration";
+export type FeedbackVerificationKind = "anonymous" | "wallet_header" | "compose_key";
+export interface FeedbackTarget {
+    type: FeedbackTargetType;
+    id: string;
+}
+export interface FeedbackContext {
+    requestId?: string;
+    paymentIntentId?: string;
+    runId?: string;
+    chainId?: number;
+    modelId?: string;
+    provider?: string;
+    agentWallet?: string;
+    workflowWallet?: string;
+    endpoint?: {
+        method?: string;
+        path?: string;
+        url?: string;
+    };
+    receipt?: {
+        network?: string;
+        txHash?: string;
+        finalAmountWei?: string;
+    };
+    sdk?: {
+        name?: string;
+        version?: string;
+    };
+}
+export interface FeedbackSubmitInput {
+    target: FeedbackTarget;
+    category?: FeedbackCategory;
+    rating?: number;
+    message?: string;
+    labels?: string[];
+    context?: FeedbackContext;
+    metadata?: Record<string, unknown>;
+}
+export interface FeedbackSubmitResponse {
+    feedbackId: string;
+    target: FeedbackTarget;
+    verification: FeedbackVerificationKind;
+    createdAt: number;
+}
+export interface FeedbackRecord {
+    id: string;
+    target: FeedbackTarget;
+    category: FeedbackCategory;
+    rating?: number;
+    message?: string;
+    labels: string[];
+    context: FeedbackContext;
+    metadata: Record<string, unknown>;
+    verification: FeedbackVerificationKind;
+    createdAt: number;
+}
+export interface FeedbackListResponse {
+    object: "list";
+    data: FeedbackRecord[];
+}
+export interface FeedbackSummary {
+    target: FeedbackTarget;
+    count: number;
+    ratingCount: number;
+    ratingAverage: number | null;
+    ratings: Record<"1" | "2" | "3" | "4" | "5", number>;
+    categories: Record<FeedbackCategory, number>;
+    verification: Record<FeedbackVerificationKind, number>;
+    recent: FeedbackRecord[];
+}
+export type KeyPurpose = "session" | "api";
+export interface KeyCreateResponse {
+    keyId: string;
+    token: string;
+    purpose: KeyPurpose;
+    budgetLimit: string;
+    budgetUsed: string;
+    budgetRemaining: string;
+    createdAt: number;
+    expiresAt: number;
+    chainId: number;
+    name?: string;
+}
+export interface KeyRecord {
+    keyId: string;
+    purpose: KeyPurpose;
+    budgetLimit: string;
+    budgetUsed: string;
+    budgetReserved?: string;
+    budgetRemaining: string;
+    createdAt: number;
+    expiresAt: number;
+    revokedAt?: number;
+    lastUsedAt?: number;
+    name?: string;
+    chainId?: number;
+}
+export interface ActiveSessionMetadata {
+    hasSession: boolean;
+    reason?: string;
+    keyId?: string;
+    token?: string;
+    budgetLimit?: string;
+    budgetUsed?: string;
+    budgetLocked?: string;
+    budgetRemaining?: string;
+    expiresAt?: number;
+    chainId?: number;
+    name?: string;
+    status?: {
+        isActive: boolean;
+        isExpired: boolean;
+        expiresInSeconds: number;
+        budgetPercentRemaining: number;
+        warnings: {
+            budgetDepleted: boolean;
+            budgetLow: boolean;
+            expiringSoon: boolean;
+            expired: boolean;
+        };
+    };
+}
+export interface ReceiptCumulative {
+    totalAmountWei: string;
+    providerAmountWei?: string;
+    platformFeeWei?: string;
+    receiptCount: number;
+}
+export interface ReceiptListResponse {
+    userAddress: string;
+    chainId: number;
+    cumulative: ReceiptCumulative;
+    receipts: Receipt[];
+}
+export type ModelProvider = "gemini" | "openai" | "fireworks" | "asicloud" | "alibaba" | "hugging face" | "azure" | "aiml" | "vertex" | "cloudflare" | "deepgram" | "elevenlabs" | "cartesia" | "roboflow";
+export type CanonicalModality = "text" | "image" | "audio" | "video" | "embedding" | "realtime";
+export interface PricingUnit {
+    unitKey: string;
+    unit?: string;
+    header?: string;
+    entries: Record<string, number>;
+    valueKeys: string[];
+    default?: boolean;
+}
+export interface ModelOperationCapability {
+    modality: CanonicalModality;
+    operation: string;
+    sourceTypes: string[];
+    input: string[];
+    output: string[];
+    pricingUnits: PricingUnit[];
+    streamable: boolean;
+}
+export interface OperationCatalogEntry {
+    operation: string;
+    modelCount: number;
+    sourceTypes: string[];
+    pricingUnits: PricingUnit[];
+}
+export interface ModalityCatalogEntry {
+    modality: CanonicalModality;
+    operations: OperationCatalogEntry[];
+    modelCount: number;
+    pricingUnits: PricingUnit[];
+}
+export interface ModalityListResponse {
+    object: "list";
+    data: ModalityCatalogEntry[];
+}
+export interface OperationListResponse {
+    object: "list";
+    data: OperationCatalogEntry[];
+}
+/**
+ * Canonical Compose model card. This is exactly what `/v1/models`,
+ * `/v1/models/all`, `/v1/models/search`, and `/v1/models/:id` return — one
+ * entry per row, no wrapper, no translation layer.
+ */
+export interface Model {
+    modelId: string;
+    upstreamModelId?: string;
+    name: string | null;
+    provider: ModelProvider;
+    type: string | string[] | null;
+    description: string | null;
+    input: unknown;
+    output: unknown;
+    contextWindow: unknown;
+    pricing: unknown;
+    maxOutputTokens?: number;
+    capabilities?: unknown;
+    modelType?: unknown;
+    sourceMetadata?: unknown;
+    params?: unknown;
+    operations?: ModelOperationCapability[];
+    ownedBy?: string;
+    createdAt?: string | number;
+    available?: boolean;
+    availableFrom?: ModelProvider[];
+    hfInferenceProvider?: string;
+    hfProviderId?: string;
+}
+export interface ModelListResponse {
+    object: "list";
+    data: Model[];
+}
+export interface ModelSearchInput {
+    q?: string;
+    modality?: CanonicalModality;
+    operation?: string;
+    provider?: ModelProvider;
+    priceMaxPerMTok?: number;
+    contextWindowMin?: number;
+    streaming?: boolean;
+    cursor?: string | null;
+    limit?: number;
+}
+export interface ModelSearchResponse {
+    object: "list";
+    data: Model[];
+    total: number;
+    next_cursor: string | null;
+}
+export type OperationModel = Model & {
+    operations: ModelOperationCapability[];
+};
+export interface OperationModelsInput {
+    q?: string;
+    provider?: ModelProvider;
+    streaming?: boolean;
+    cursor?: string | null;
+    limit?: number;
+}
+export interface OperationModelsResponse {
+    object: "list";
+    data: OperationModel[];
+    total: number;
+    next_cursor: string | null;
+}
+export interface ModelParamDefinition {
+    type: "string" | "integer" | "number" | "boolean" | "array" | "object";
+    required: boolean;
+    default?: string | number | boolean;
+    options?: Array<string | number>;
+    minimum?: number;
+    maximum?: number;
+    description?: string;
+}
+export interface ModelParamsResponse {
+    modelId: string;
+    type: CanonicalModality | null;
+    provider: string | null;
+    params: Record<string, ModelParamDefinition>;
+    defaults: Record<string, unknown>;
+}
+export interface PricingModel {
+    modelId: string;
+    provider: ModelProvider | string;
+    pricing: unknown;
+}
+export interface PricingResponse {
+    models: PricingModel[];
+    version: string;
+}
+export interface HealthResponse {
+    status: "ok" | string;
+    timestamp?: string;
+    [key: string]: unknown;
+}
+export interface RuntimeFramework {
+    id?: string;
+    name?: string;
+    description?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+export interface FrameworksResponse {
+    frameworks: RuntimeFramework[];
+}
+export type ChatRole = "system" | "developer" | "user" | "assistant" | "tool";
+export type AttachmentKind = "image" | "audio" | "video" | "pdf" | "file" | "text" | "json" | "url";
+export interface Attachment {
+    type?: AttachmentKind | (string & {
+        readonly __brand?: "AttachmentKind";
+    });
+    url?: string;
+    uri?: string;
+    data?: string;
+    base64?: string;
+    mimeType?: string;
+    mime_type?: string;
+    contentType?: string;
+    content_type?: string;
+    name?: string;
+    filename?: string;
+    text?: string;
+    content?: string;
+    detail?: "auto" | "low" | "high";
+    metadata?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export type AttachmentInput = Attachment | string;
+export interface MessageTextPart {
+    type: "text";
+    text: string;
+}
+export interface MessageImagePart {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    } | string;
+}
+export interface MessageAudioPart {
+    type: "input_audio";
+    input_audio: {
+        url: string;
+    } | string;
+}
+export interface MessageVideoPart {
+    type: "video_url";
+    video_url: {
+        url: string;
+    } | string;
+}
+export type MessageContentPart = MessageTextPart | MessageImagePart | MessageAudioPart | MessageVideoPart;
+export interface Message {
+    role: ChatRole;
+    content: string | MessageContentPart[] | null;
+    name?: string;
+    tool_call_id?: string;
+    tool_calls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+export interface ToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description?: string;
+        parameters?: Record<string, unknown>;
+        strict?: boolean;
+    };
+}
+export type ChatToolChoice = "none" | "auto" | "required" | {
+    type: "function";
+    function: {
+        name: string;
+    };
+};
+export interface ResponseFormat {
+    type: "text" | "json_object" | "json_schema";
+    json_schema?: {
+        name?: string;
+        schema?: Record<string, unknown>;
+        strict?: boolean;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface StreamOptions {
+    include_usage?: boolean;
+    include_obfuscation?: boolean;
+    [key: string]: unknown;
+}
+export interface ReasoningOptions {
+    effort?: string;
+    summary?: string;
+    [key: string]: unknown;
+}
+export interface OpenAIPassthroughParams {
+    frequency_penalty?: number;
+    include?: string[];
+    logit_bias?: Record<string, number>;
+    metadata?: Record<string, unknown>;
+    parallel_tool_calls?: boolean;
+    presence_penalty?: number;
+    prompt_cache_key?: string;
+    promptCacheKey?: string;
+    prompt_cache_retention?: string;
+    promptCacheRetention?: string;
+    reasoning?: ReasoningOptions;
+    reasoning_effort?: string;
+    reasoningEffort?: string;
+    response_format?: ResponseFormat;
+    seed?: number;
+    service_tier?: string;
+    store?: boolean;
+    stream_options?: StreamOptions;
+    text?: Record<string, unknown>;
+    textVerbosity?: string;
+    top_p?: number;
+    user?: string;
+    verbosity?: string;
+    custom_params?: Record<string, unknown>;
+}
+export interface ChatCompletionsCreateParams extends OpenAIPassthroughParams {
+    model: string;
+    messages: Message[];
+    attachments?: AttachmentInput[];
+    attachment?: AttachmentInput;
+    stream?: boolean;
+    temperature?: number;
+    n?: number;
+    stop?: string | string[];
+    max_tokens?: number;
+    max_completion_tokens?: number;
+    tools?: ToolDefinition[];
+    tool_choice?: ChatToolChoice;
+    [key: string]: unknown;
+}
+export interface ChatUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    reasoning_tokens?: number;
+    cached_input_tokens?: number;
+}
+export interface ChatCompletion {
+    id: string;
+    object: "chat.completion";
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: "assistant";
+            content: string | null;
+            reasoning_content?: string;
+            tool_calls?: Array<{
+                id: string;
+                type: "function";
+                function: {
+                    name: string;
+                    arguments: string;
+                };
+            }>;
+        };
+        finish_reason: string;
+    }>;
+    usage: ChatUsage;
+    receipt?: Record<string, unknown>;
+}
+export interface ChatCompletionChunk {
+    id: string;
+    object: "chat.completion.chunk";
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        delta: {
+            role?: "assistant";
+            content?: string;
+            reasoning_content?: string;
+            tool_calls?: Array<{
+                index: number;
+                id?: string;
+                type?: "function";
+                function?: {
+                    name?: string;
+                    arguments?: string;
+                };
+            }>;
+        };
+        finish_reason: string | null;
+    }>;
+    usage?: ChatUsage;
+}
+export interface ResponsesCreateParams extends OpenAIPassthroughParams {
+    model: string;
+    input: unknown;
+    attachments?: AttachmentInput[];
+    attachment?: AttachmentInput;
+    modalities?: Array<"text" | "image" | "audio" | "video" | "embedding">;
+    stream?: boolean;
+    instructions?: string;
+    previous_response_id?: string;
+    max_output_tokens?: number;
+    temperature?: number;
+    tools?: ToolDefinition[];
+    tool_choice?: ChatToolChoice;
+    n?: number;
+    size?: string;
+    quality?: string;
+    image_url?: string;
+    voice?: string;
+    language?: string;
+    speed?: number;
+    duration?: number;
+    aspect_ratio?: string;
+    resolution?: string;
+    [key: string]: unknown;
+}
+export interface ResponseObject {
+    id: string;
+    object: "response";
+    created_at: number;
+    status: "completed" | "in_progress" | "failed" | "cancelled";
+    model: string;
+    output: Array<Record<string, unknown>>;
+    usage?: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+    error?: {
+        message: string;
+        type?: string;
+        code?: string;
+    };
+    previous_response_id?: string;
+    job_id?: string;
+    receipt?: Record<string, unknown>;
+}
+export interface ResponseOutputItem {
+    type: string;
+    role?: "assistant";
+    text?: string;
+    image_url?: string;
+    audio_url?: string;
+    video_url?: string;
+    embedding?: number[];
+    job_id?: string;
+    status?: string;
+    progress?: number;
+    mime_type?: string;
+    [key: string]: unknown;
+}
+export interface EmbeddingsCreateParams {
+    model: string;
+    input: string | string[];
+    attachments?: AttachmentInput[];
+    attachment?: AttachmentInput;
+    dimensions?: number;
+    encoding_format?: "float" | "base64" | string;
+    user?: string;
+    [key: string]: unknown;
+}
+export interface EmbeddingsResponse {
+    object: "list";
+    data: Array<{
+        object: "embedding";
+        embedding: number[];
+        index: number;
+    }>;
+    model: string;
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+    receipt?: Record<string, unknown>;
+}
+export interface ImagesGenerateParams {
+    model: string;
+    prompt: string;
+    attachments?: AttachmentInput[];
+    attachment?: AttachmentInput;
+    n?: number;
+    size?: string;
+    quality?: string;
+    response_format?: "url" | "b64_json" | string;
+    style?: "vivid" | "natural" | string;
+    user?: string;
+    [key: string]: unknown;
+}
+export interface ImagesEditParams extends ImagesGenerateParams {
+    image?: string;
+    mask?: string;
+}
+export interface ImagesResponse {
+    created: number;
+    data: Array<{
+        url?: string;
+        b64_json?: string;
+        revised_prompt?: string;
+    }>;
+    receipt?: Record<string, unknown>;
+}
+export interface AudioSpeechCreateParams {
+    model: string;
+    input: string;
+    attachments?: AttachmentInput[];
+    attachment?: AttachmentInput;
+    voice?: string;
+    response_format?: string;
+    speed?: number;
+    user?: string;
+    [key: string]: unknown;
+}
+export interface AudioTranscriptionCreateParams {
+    model: string;
+    file: string | Blob | File | Uint8Array;
+    attachments?: AttachmentInput[];
+    attachment?: AttachmentInput;
+    filename?: string;
+    language?: string;
+    response_format?: string;
+    prompt?: string;
+    temperature?: number;
+    timestamp_granularities?: Array<"word" | "segment" | string>;
+    [key: string]: unknown;
+}
+export interface AudioTranscriptionResponse {
+    text: string;
+    task?: string;
+    language?: string;
+    duration?: number;
+    words?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    segments?: Array<Record<string, unknown>>;
+    receipt?: Record<string, unknown>;
+}
+export interface VideoGenerateParams {
+    model: string;
+    prompt?: string;
+    attachments?: AttachmentInput[];
+    attachment?: AttachmentInput;
+    duration?: number;
+    aspect_ratio?: string;
+    resolution?: string;
+    size?: string;
+    fps?: number;
+    image?: string;
+    image_url?: string;
+    user?: string;
+    [key: string]: unknown;
+}
+export interface VideoGenerateResponse {
+    id?: string;
+    object?: "video.generation";
+    status?: string;
+    created?: number;
+    model?: string;
+    job_id?: string;
+    data?: Array<{
+        url?: string;
+        b64_json?: string;
+        base64?: string;
+        duration?: number;
+        [key: string]: unknown;
+    }>;
+    receipt?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface VideoJobStatus {
+    id: string;
+    object: "video.generation";
+    status: "queued" | "processing" | "completed" | "failed";
+    url?: string;
+    error?: string;
+    progress?: number;
+}
+export type VideoStatusStreamEvent = {
+    type: "compose.video.status";
+    jobId: string;
+    status: "queued" | "processing" | "completed" | "failed";
+    progress?: number;
+    url?: string;
+    error?: string;
+} | {
+    type: "compose.error";
+    code: string;
+    message: string;
+    details?: Record<string, unknown>;
+} | {
+    type: "done";
+};
+/**
+ * Events emitted by the Compose agent runtime on /agent/:wallet/stream.
+ * Mirrors the runtime's native SSE vocabulary — no translation, no renaming.
+ */
+export type AgentDisplayKind = "tool" | "model" | "connector" | "agent" | "search" | "harness" | "swarm" | "conclave" | "route";
+export interface AgentEventDisplay {
+    kind: AgentDisplayKind;
+    id?: string;
+    name?: string;
+    target?: string;
+    summary?: string;
+    details?: Record<string, unknown>;
+}
+export type PlanDecision = "approved" | "rejected" | "changes_requested";
+export type AgentArtifactKind = "image" | "audio" | "video" | "embedding" | "realtime" | "file" | "artifact";
+export interface AgentStreamCreateParams extends AgentStreamControls {
+    agentWallet: string;
+    message: string;
+    threadId: string;
+    userAddress: string;
+    agentCard?: unknown;
+    cloudPermissions?: unknown;
+    runId?: string;
+    attachment?: AttachmentInput;
+    attachments?: AttachmentInput[];
+}
+export interface AgentStreamFinalResult {
+    text: string;
+    toolCalls: Array<{
+        toolName: string;
+        displayName?: string;
+        summary?: string;
+        failed: boolean;
+        error?: string;
+        targetKind?: AgentDisplayKind;
+        target?: string;
+        display?: AgentEventDisplay;
+    }>;
+    requestId: string | null;
+    receipt: Receipt | null;
+    budget: SessionBudgetSnapshot | null;
+    sessionInvalidReason: SessionInvalidReason | null;
+}
+export interface AgentDecisionInput {
+    agentWallet: string;
+    runId: string;
+    proposalId: string;
+    version: number;
+    approvalId?: string;
+    decision: PlanDecision;
+    approver?: string;
+    reason?: string;
+    feedback?: string;
+}
+export interface AgentDecisionResult {
+    ok?: boolean;
+    proposalId?: string;
+    version?: number;
+    state?: string;
+    decision?: PlanDecision;
+    [key: string]: unknown;
+}
+export interface WorkflowStreamCreateParams {
+    workflowWallet: string;
+    message: string;
+    threadId: string;
+    userAddress: string;
+    runId?: string;
+    continuous?: boolean;
+    lastEventIndex?: number;
+    attachment?: AttachmentInput;
+    attachments?: AttachmentInput[];
+}
+export interface WorkflowStreamFinalResult {
+    text: string;
+    structuredOutput: unknown;
+    toolCalls: Array<{
+        toolName: string;
+        summary?: string;
+        failed: boolean;
+        error?: string;
+    }>;
+    requestId: string | null;
+    receipt: Receipt | null;
+    budget: SessionBudgetSnapshot | null;
+    sessionInvalidReason: SessionInvalidReason | null;
+}
+export interface LocalLinkCreateInput {
+    userAddress?: string;
+    chainId?: number;
+    agentWallet?: string;
+    agentCardCid?: string;
+    deviceId?: string;
+}
+export interface LocalLinkCreateResponse {
+    success: boolean;
+    token: string;
+    mode: "local-first" | "web-first";
+    expiresAt: number;
+    deepLinkUrl: string;
+    hasSession: boolean;
+}
+export interface LocalLinkRedeemInput {
+    token: string;
+    deviceId: string;
+    connectedUserAddress?: string;
+}
+export interface LocalRedeemedContext {
+    agentWallet: string;
+    userAddress: string;
+    chainId: number;
+    key: {
+        keyId: string;
+        token: string;
+        expiresAt: number;
+    };
+    session: {
+        sessionId: string;
+        budget: string;
+        duration: number;
+        expiresAt: number;
+    };
+    market: {
+        entry: "local" | string;
+        agentWallet: string;
+        agentCardCid: string | null;
+    };
+    deviceId: string;
+    hasSession: boolean;
+    linkMode: "local-first" | "web-first";
+}
+export interface LocalLinkRedeemResponse {
+    success: boolean;
+    context: LocalRedeemedContext;
+}
+export interface LocalDeploymentRegisterInput {
+    agentWallet: string;
+    userAddress?: string;
+    keyId: string;
+    agentCardCid: string;
+    localVersion: string;
+    deployedAt: number;
+    chainId?: number;
+}
+export interface LocalDeploymentRecord {
+    version: number;
+    deploymentId: string;
+    agentWallet: string;
+    userAddress: string;
+    keyId: string;
+    agentCardCid: string;
+    localVersion: string;
+    deployedAt: number;
+    chainId: number;
+    registeredAt: number;
+    updatedAt: number;
+}
+export interface LocalDeploymentRegisterResponse {
+    success: boolean;
+    idempotent: boolean;
+    deployment: LocalDeploymentRecord;
+}
+export interface LocalPeerSummary {
+    peerId: string;
+    lastSeenAt: number;
+    stale: boolean;
+    caps: string[];
+    listenMultiaddrs: string[];
+    deviceId?: string | null;
+    agentWallet?: string | null;
+}
+export interface LocalNetworkUpsertInput {
+    userAddress?: string;
+    chainId?: number;
+    agentWallet?: string;
+    deviceId?: string;
+    peers: LocalPeerSummary[];
+}
+export interface LocalNetworkUpsertResponse {
+    success: boolean;
+    upserted: number;
+    chainId: number;
+}
+export interface LocalNetworkPeersInput {
+    userAddress?: string;
+    chainId?: number;
+    agentWallet?: string;
+}
+export interface LocalNetworkPeersResponse {
+    success: boolean;
+    chainId: number;
+    userAddress: string;
+    peers: LocalPeerSummary[];
+}
+export interface LocalSynapseSessionInput {
+    agentWallet: string;
+    deviceId: string;
+    sessionKeyAddress: string;
+    sessionKeyExpiresAt: number;
+    depositAmount?: string | number;
+}
+export interface LocalStorageSessionResponse {
+    success: boolean;
+    agentWallet: string;
+    deviceId: string;
+    payerAddress: string;
+    sessionKeyAddress: string;
+    sessionKeyExpiresAt: number;
+    availableFunds: string;
+    depositAmount: string;
+    depositExecuted: boolean;
+    network: string;
+    source: string;
+}
+export type LocalSynapseSessionResponse = LocalStorageSessionResponse;
+export interface LocalFilecoinPinSessionInput {
+    agentWallet: string;
+    deviceId: string;
+    sessionKeyAddress: string;
+    sessionKeyExpiresAt: number;
+    fileSizeBytes: number;
+    copies?: number;
+}
+export interface LocalFilecoinPinSessionResponse extends LocalStorageSessionResponse {
+    fileSizeBytes: number;
+    providerIds: string[];
+}
+export interface DispenserStatus {
+    chainId: number;
+    chainName: string;
+    totalClaims: number;
+    maxClaims: number;
+    remainingClaims: number;
+    dispenserBalance: string;
+    dispenserBalanceFormatted: string;
+    isPaused: boolean;
+    dispenserAddress: string;
+    usdcAddress: string;
+    isConfigured: boolean;
+}
+export interface DispenserClaimInput {
+    address?: string;
+    chainId?: number;
+}
+export interface DispenserClaimResponse {
+    success: boolean;
+    txHash?: string;
+    alreadyClaimed?: boolean;
+    globalClaimStatus?: {
+        claimedOnChain?: number;
+        claimedOnChainName?: string;
+        claimedAt?: number;
+    };
+    error?: string;
+}
+export interface DispenserStatusResponse {
+    dispensers: DispenserStatus[];
+    claimAmount: number;
+    claimAmountFormatted: string;
+    maxClaims: number;
+}
+export interface DispenserStatusByChainResponse {
+    available: boolean;
+    reason?: string;
+    status?: DispenserStatus;
+}
+export interface DispenserCheckResponse {
+    address: string;
+    hasClaimed: boolean;
+    claimedOnChain?: number;
+    claimedOnChainName?: string;
+    claimedAt?: number;
+}
+export interface SettlementStatusInput {
+    userAddress?: string;
+    chainId?: number;
+}
+export interface SettlementBudgetInfo {
+    budgetLimit?: string | number;
+    budgetUsed?: string | number;
+    budgetLocked?: string | number;
+    budgetRemaining?: string | number;
+    expiresAt?: number;
+    chainId?: number;
+    [key: string]: unknown;
+}
+export interface SettlementStatusResponse {
+    hasActiveBudget: boolean;
+    message?: string;
+    budget?: SettlementBudgetInfo;
+}
+export type PermissionConsentType = "filesystem" | "camera" | "microphone" | "geolocation" | "clipboard" | "notifications" | string;
+export interface PermissionGrant {
+    userAddress: string;
+    agentWallet: string;
+    consentType: PermissionConsentType;
+    granted: boolean;
+    grantedAt: number;
+    expiresAt?: number;
+}
+export interface PermissionListInput {
+    userAddress?: string;
+    agentWallet: string;
+}
+export interface PermissionListResponse {
+    permissions: PermissionGrant[];
+}
+export interface PermissionGrantInput {
+    userAddress?: string;
+    agentWallet: string;
+    consentType: PermissionConsentType;
+    expiresAt?: number;
+}
+export interface PermissionRevokeInput {
+    userAddress?: string;
+    agentWallet: string;
+    consentType: PermissionConsentType;
+}
+export interface PermissionWriteResponse {
+    success: boolean;
+    permission?: PermissionGrant;
+}
+export interface AccountConnectInput {
+    userAddress?: string;
+    agentWallet: string;
+    toolkit: string;
+}
+export interface AccountConnectResponse {
+    redirectUrl: string;
+    userAddress: string;
+    agentWallet: string;
+    toolkit: string;
+    connectedAccountId: string;
+    authMode?: string;
+}
+export interface AccountListInput {
+    userAddress?: string;
+    agentWallet: string;
+    toolkit?: string;
+}
+export interface AccountConnection {
+    slug: string;
+    name: string;
+    connected: boolean;
+    connectedAccountId: string;
+    accountId: string;
+    status?: string;
+    source: "composio" | string;
+}
+export interface AccountListResponse {
+    connections: AccountConnection[];
+}
+export interface AccountStatusInput {
+    userAddress?: string;
+    agentWallet: string;
+    toolkit: string;
+    connectedAccountId: string;
+}
+export type AccountStatusResponse = AccountConnection;
+export interface AccountDisconnectInput {
+    userAddress?: string;
+    agentWallet: string;
+    toolkit: string;
+    connectedAccountId: string;
+}
+export interface AccountDisconnectResponse {
+    success: boolean;
+}
+export interface AccountExecuteInput {
+    userAddress?: string;
+    agentWallet: string;
+    toolkit: string;
+    connectedAccountId: string;
+    action: string;
+    params?: Record<string, unknown>;
+    text?: string;
+}
+export interface AccountExecuteResponse {
+    success: boolean;
+    result?: unknown;
+    error?: string;
+}
+export interface AccountToolkitsInput {
+    search?: string;
+    limit?: number;
+}
+export interface AccountToolkit {
+    slug: string;
+    name: string;
+    logo: string;
+    description: string;
+    categories: string[];
+    authSchemes: string[];
+    composioManagedSchemes: string[];
+}
+export interface AccountToolkitsResponse {
+    toolkits: AccountToolkit[];
+}
+export interface AccountToolkitActionsInput {
+    limit?: number;
+}
+export interface AccountToolkitAction {
+    slug: string;
+    name: string;
+    description: string;
+    toolkitSlug: string;
+    toolkitName: string;
+    noAuth: boolean;
+    scopes: string[];
+    inputParameters: Record<string, unknown>;
+}
+export interface AccountToolkitActionsResponse {
+    toolkit: string;
+    actions: AccountToolkitAction[];
+}
+export type ChannelName = "telegram" | "slack" | "discord" | "whatsapp";
+export interface ChannelRoute {
+    id: string;
+    channel: ChannelName;
+    userAddress: string;
+    agentWallet: string;
+    accountId: string;
+    threadId: string;
+    label?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ChannelListResponse {
+    channels: ChannelName[];
+}
+export interface ChannelGetResponse {
+    channel: ChannelName;
+    link: string;
+    status: string;
+    disconnect: string;
+    webhook: string | null;
+    socket: string | null;
+}
+export interface ChannelLinkInput {
+    userAddress?: string;
+    agentWallet: string;
+    agentName?: string;
+    mode?: "user" | "guild";
+    privacy?: "public" | "private";
+}
+export interface ChannelLinkResponse {
+    code: string;
+    channel: ChannelName;
+    userAddress: string;
+    agentWallet: string;
+    agentName?: string;
+    mode?: "user" | "guild";
+    privacy?: "public" | "private";
+    createdAt: number;
+    expiresAt: number;
+    url: string | null;
+    action?: {
+        type: "redirect" | "websocket" | "oauth";
+        label: string;
+        url: string | null;
+        socket?: string;
+        command?: string;
+    };
+}
+export interface ChannelStatusInput {
+    userAddress?: string;
+    agentWallet: string;
+    accountId?: string;
+    threadId?: string;
+}
+export interface ChannelStatusResponse {
+    channel: ChannelName;
+    connected: boolean;
+    routes: ChannelRoute[];
+}
+export interface ChannelDisconnectInput {
+    userAddress?: string;
+    agentWallet: string;
+    accountId?: string;
+    threadId?: string;
+}
+export interface ChannelDisconnectResponse {
+    channel: ChannelName;
+    disconnected: number;
+}
+export interface DirectoryAgent {
+    schemaVersion: string;
+    name: string;
+    description: string;
+    skills: string[];
+    x402Support: boolean;
+    image?: string;
+    avatar?: string;
+    avatarUrl?: string;
+    dnaHash: string;
+    walletAddress: string;
+    walletTimestamp?: number;
+    chain: number;
+    model: string;
+    framework?: "manowar" | string;
+    licensePrice: string;
+    creatorFee?: number;
+    licenses: number;
+    licensesAvailable?: number;
+    cloneable: boolean;
+    isClone?: boolean;
+    parentAgentId?: number;
+    agentId?: number;
+    knowledge?: string[];
+    endpoint?: string;
+    protocols: Array<{
+        name: string;
+        version: string;
+    }>;
+    connectors?: Array<{
+        registryId: string;
+        name: string;
+        origin: string;
+    }>;
+    createdAt: string;
+    creator?: string;
+    cid?: string;
+    score?: number;
+}
+export interface DirectoryWorkflow {
+    schemaVersion: string;
+    title: string;
+    description: string;
+    image?: string;
+    dnaHash: string;
+    walletAddress: string;
+    walletTimestamp: number;
+    agents: DirectoryAgent[];
+    edges?: Array<{
+        source: number;
+        target: number;
+        label?: string;
+    }>;
+    coordinator?: {
+        hasCoordinator: boolean;
+        model: string;
+    };
+    pricing: {
+        totalAgentPrice: string;
+    };
+    lease?: {
+        enabled: boolean;
+        durationDays: number;
+        creatorPercent: number;
+    };
+    rfa?: {
+        title: string;
+        description: string;
+        skills: string[];
+        offerAmount: string;
+    };
+    creator: string;
+    createdAt: string;
+    cid?: string;
+}
+export interface DirectoryAgentListResponse {
+    agents: DirectoryAgent[];
+    total: number;
+    count?: number;
+    nextCursor?: string | null;
+    hasMore?: boolean;
+}
+export interface DirectoryWorkflowListResponse {
+    workflows: DirectoryWorkflow[];
+    total: number;
+}
+export interface AgentverseQuery {
+    search?: string;
+    q?: string;
+    category?: string;
+    tags?: string[];
+    limit?: number;
+    offset?: number;
+    sort?: "relevancy" | "created-at" | "last-modified" | "interactions";
+    direction?: "asc" | "desc";
+}
+export type AgentverseResponse = Record<string, unknown>;
+export type AgentMemoryLayer = "working" | "scene" | "graph" | "patterns" | "archives" | "vectors";
+export type AgentMemoryLoopStep = "pre_turn" | "post_turn" | "remember";
+export interface AgentMemoryScopeInput {
+    agentWallet: string;
+    userAddress?: string;
+    threadId?: string;
+    mode?: "global" | "local";
+    haiId?: string;
+    filters?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentMemoryContextParams extends AgentMemoryScopeInput {
+    query: string;
+    layers?: AgentMemoryLayer[];
+    limit?: number;
+    maxItems?: number;
+    maxItemChars?: number;
+    budget?: {
+        maxCharacters?: number;
+        max_chars?: number;
+        maxContextCharacters?: number;
+        max_context_chars?: number;
+        mode?: "compact" | "balanced" | "recall";
+    };
+    includeRaw?: boolean;
+}
+export interface AgentMemoryTurnMessage {
+    role: "user" | "assistant" | "system" | "tool";
+    content: string;
+    timestamp?: number;
+    toolCalls?: Array<{
+        name: string;
+        args: Record<string, unknown>;
+    }>;
+}
+export interface AgentMemoryRecordTurnParams extends AgentMemoryScopeInput {
+    contextId?: string;
+    turnId?: string;
+    sessionId?: string;
+    messages?: AgentMemoryTurnMessage[];
+    toolEvents?: Array<{
+        name: string;
+        toolName?: string;
+        tool?: string;
+        args?: Record<string, unknown>;
+        input?: Record<string, unknown>;
+        result?: string;
+        output?: string;
+        status?: string;
+        timestamp?: number;
+    }>;
+    userMessage?: string;
+    assistantMessage?: string;
+    modelUsed?: string;
+    model?: string;
+    totalTokens?: number;
+    tokenCount?: number;
+    contextWindow?: number;
+    summary?: string;
+}
+export interface AgentMemoryRememberParams extends AgentMemoryScopeInput {
+    content: string;
+    type?: string;
+    scope?: string;
+    retention?: string;
+    conflictPolicy?: string;
+    confidence?: number;
+    enableGraph?: boolean;
+}
+export type AgentMemoryLoopParams = ({
+    step: "pre_turn";
+} & AgentMemoryContextParams) | ({
+    step: "post_turn";
+} & AgentMemoryRecordTurnParams) | ({
+    step: "remember";
+} & AgentMemoryRememberParams);
+export interface AgentMemoryCompactItem {
+    layer: string;
+    text: string;
+    id?: string;
+    score?: number;
+    source?: string;
+    createdAt?: number;
+}
+export interface AgentMemoryLoopEnvelope<TStep extends AgentMemoryLoopStep> {
+    v: "compose.agent_memory_loop.v1";
+    step: TStep;
+    next: AgentMemoryLoopStep[];
+}
+export interface AgentMemoryContextResponse {
+    loop: AgentMemoryLoopEnvelope<"pre_turn">;
+    contextId: string;
+    prompt: string | null;
+    items: AgentMemoryCompactItem[];
+    totals: Record<string, number>;
+    contextUsage: {
+        characters: number;
+        rawCharacters: number;
+        budgetCharacters?: number;
+        savedCharactersVsRaw: number;
+        items: number;
+    };
+    omitted: Record<string, number>;
+    raw?: Record<string, unknown[]>;
+}
+export interface AgentMemoryRecordTurnResponse {
+    loop: AgentMemoryLoopEnvelope<"post_turn">;
+    success: true;
+    sessionId: string;
+    threadId: string;
+    turnId: string;
+    vectorId?: string;
+    stored: {
+        /** Full transcript persisted to the `scene` layer (Mongo session_transcripts). */
+        transcript: boolean;
+        /** Working-memory rolling buffer updated for the active session. */
+        working: boolean;
+        /** Per-turn dense vector indexed for hybrid recall (Atlas $vectorSearch). */
+        vector: boolean;
+        /**
+         * Durable facts extracted by the first-party graph layer
+         * (gemini-3.1-flash-lite-preview → Voyage embeddings → `source: "fact"`
+         * vectors). True if at least one fact was indexed or an existing
+         * fact's accessCount was bumped.
+         */
+        graph: boolean;
+    };
+}
+export interface AgentMemoryRememberResponse {
+    loop: AgentMemoryLoopEnvelope<"remember">;
+    success: boolean;
+    graphSaved: boolean;
+    vectorSaved: boolean;
+    vectorId?: string;
+    memory?: {
+        id?: string;
+        text: string;
+        type: string;
+        retention?: string;
+        confidence?: number;
+        status: "active";
+    };
+}
+export type AgentMemoryLoopResponse = AgentMemoryContextResponse | AgentMemoryRecordTurnResponse | AgentMemoryRememberResponse;
+export interface LayeredSearchParams extends AgentMemoryScopeInput {
+    query: string;
+    layers?: AgentMemoryLayer[];
+    limit?: number;
+}
+export interface LayeredSearchResult {
+    query: string;
+    layers: Record<string, unknown[]>;
+    totals: Record<string, number>;
+}
+export type MemorySource = "session" | "knowledge" | "pattern" | "archive" | "fact";
+export interface SearchResult {
+    id: string;
+    vectorId?: string;
+    content: string;
+    score?: number;
+    source: MemorySource;
+    agentWallet: string;
+    userAddress?: string;
+    threadId?: string;
+    mode?: "global" | "local";
+    haiId?: string;
+    decayScore?: number;
+    accessCount?: number;
+    createdAt?: number;
+}
+export interface MemoryVector {
+    vectorId: string;
+    id?: string;
+    content: string;
+    embedding?: number[];
+    score?: number;
+    source: MemorySource;
+    agentWallet: string;
+    userAddress?: string;
+    threadId?: string;
+    mode?: "global" | "local";
+    haiId?: string;
+    scopeKind?: "global" | "local";
+    scopeId?: string;
+    decayScore: number;
+    accessCount: number;
+    createdAt: number;
+    lastAccessedAt: number;
+    updatedAt?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface MemoryItemQuery {
+    agentWallet?: string;
+    userAddress?: string;
+}
+export interface MemoryItemUpdateParams extends MemoryItemQuery {
+    threadId?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+    retention?: string;
+    confidence?: number;
+    status?: "active" | "superseded" | "archived";
+    filters?: Record<string, unknown>;
+}
+export interface MemoryItemDeleteParams extends MemoryItemQuery {
+    hardDelete?: boolean;
+}
+export interface MemoryJobCreateParams {
+    type: "consolidate" | "patterns_extract" | "archive_create" | "decay_update" | "cleanup";
+    execution?: "inline" | "temporal";
+    agentWallet?: string;
+    agentWallets?: string[];
+    timeRange?: {
+        start: number;
+        end: number;
+    };
+    dateRange?: {
+        start: number;
+        end: number;
+    };
+    confidenceThreshold?: number;
+    batchSize?: number;
+    halfLifeDays?: number;
+    olderThanDays?: number;
+    compress?: boolean;
+    syncToIpfs?: boolean;
+}
+export interface MemoryJobRecord {
+    jobId: string;
+    type: MemoryJobCreateParams["type"];
+    execution: "inline" | "temporal";
+    status: "running" | "completed" | "failed";
+    agentWallet?: string;
+    temporalWorkflowId?: string;
+    temporalRunId?: string;
+    data?: unknown;
+    error?: string;
+    createdAt: number;
+    completedAt?: number;
+}
+export interface MemoryEvalRunParams extends AgentMemoryScopeInput {
+    layers?: AgentMemoryLayer[];
+    testCases: Array<{
+        query: string;
+        expected?: string;
+        expectedMemoryId?: string;
+    }>;
+}
+export interface MemoryEvalRunResponse {
+    evalRunId: string;
+    status: "completed";
+    scores: {
+        recallAtK: number;
+        precisionAtK: number;
+        avgContextCharacters: number;
+        cases: number;
+    };
+    avgSearchLatencyMs: number;
+    results: Array<{
+        query: string;
+        hit: boolean;
+        returned: number;
+        contextCharacters: number;
+    }>;
+}
+export interface MemoryLoopStepManifest {
+    operationId: string;
+    method: "GET" | "POST" | "PATCH" | "DELETE";
+    path: string;
+    purpose?: string;
+}
+export interface MemoryLoopManifest {
+    id: string;
+    version: "compose.agent_memory_loop.v1";
+    description: string;
+    loop?: "hot" | "durable" | "maintenance";
+    tokenPolicy?: "returns compact prompt only" | "returns metadata only";
+    steps: MemoryLoopStepManifest[];
+}
+export interface ProceduralPattern {
+    patternId: string;
+    agentWallet: string;
+    mode?: "global" | "local";
+    haiId?: string;
+    patternType?: "routine" | "decision" | "response" | "tool_sequence";
+    trigger?: {
+        type: string;
+        value: string;
+        conditions?: Record<string, unknown>;
+    };
+    steps?: Array<{
+        action: string;
+        params?: Record<string, unknown>;
+        expectedOutcome?: string;
+        order: number;
+    }>;
+    summary: string;
+    successRate?: number;
+    executionCount?: number;
+    lastExecuted?: number;
+    metadata?: Record<string, unknown>;
+    createdAt?: number;
+    updatedAt?: number;
+}
+export interface LearnedSkill {
+    skillId: string;
+    name: string;
+    description: string;
+    category: string;
+    trigger?: Record<string, unknown>;
+    spawnConfig?: Record<string, unknown>;
+    successRate?: number;
+    usageCount?: number;
+    creator?: string;
+    agents?: string[];
+    tags?: string[];
+    createdAt?: number;
+    updatedAt?: number;
+}
+export interface MemoryPatternValidation {
+    valid: boolean;
+    confidence: number;
+    occurrences: number;
+    successRate: number;
+    toolSequence: string[];
+}
+export interface MemoryScheduleStatus {
+    scheduleId: string;
+    paused: boolean;
+    lastRunAt?: number;
+    nextRunAt?: number;
+    note?: string;
+}
+export interface SessionMemory {
+    sessionId: string;
+    agentWallet: string;
+    userAddress?: string;
+    threadId?: string;
+    mode?: "global" | "local";
+    haiId?: string;
+    workingMemory: {
+        context: string[];
+        entities: Record<string, unknown>;
+        state: Record<string, unknown>;
+    };
+    metadata?: Record<string, unknown>;
+    compressed: boolean;
+    createdAt: number;
+    expiresAt: number;
+    lastAccessedAt: number;
+}
+export interface RealtimeSessionConfig {
+    readonly modalities: ReadonlyArray<"text" | "audio">;
+    readonly instructions?: string;
+    readonly voice?: string;
+    readonly inputAudioFormat?: string;
+    readonly outputAudioFormat?: string;
+    readonly turnDetection?: {
+        readonly type: "server_vad" | "none";
+        readonly threshold?: number;
+        readonly silenceDurationMs?: number;
+    };
+    readonly tools?: ToolDefinition[];
+    readonly toolChoice?: "auto" | "none" | "required" | {
+        readonly type: "tool";
+        readonly toolName: string;
+    } | any;
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number | "inf";
+}
+export interface RealtimeResponseConfig {
+    readonly modalities?: ReadonlyArray<"text" | "audio">;
+    readonly instructions?: string;
+    readonly voice?: string;
+    readonly outputAudioFormat?: string;
+    readonly tools?: ToolDefinition[];
+    readonly toolChoice?: RealtimeSessionConfig["toolChoice"];
+    readonly temperature?: number;
+    readonly maxOutputTokens?: number | "inf";
+}
+export type RealtimeClientEvent = {
+    readonly type: "session.update";
+    readonly session: Partial<RealtimeSessionConfig>;
+} | {
+    readonly type: "input_audio_buffer.append";
+    readonly audio: Uint8Array | string;
+} | {
+    readonly type: "input_audio_buffer.commit";
+} | {
+    readonly type: "input_audio_buffer.clear";
+} | {
+    readonly type: "conversation.item.create";
+    readonly item: any;
+} | {
+    readonly type: "conversation.item.delete";
+    readonly itemId: string;
+} | {
+    readonly type: "response.create";
+    readonly response?: Partial<RealtimeResponseConfig>;
+} | {
+    readonly type: "response.cancel";
+};
+export type RealtimeServerEvent = {
+    readonly type: "session.created";
+    readonly sessionId: string;
+    readonly modelId: string;
+} | {
+    readonly type: "session.updated";
+    readonly session: RealtimeSessionConfig;
+} | {
+    readonly type: "input_audio_buffer.speech_started";
+} | {
+    readonly type: "input_audio_buffer.speech_stopped";
+} | {
+    readonly type: "input_audio_buffer.committed";
+    readonly itemId: string;
+} | {
+    readonly type: "conversation.item.created";
+    readonly itemId: string;
+} | {
+    readonly type: "response.created";
+    readonly responseId: string;
+} | {
+    readonly type: "response.audio.delta";
+    readonly responseId: string;
+    readonly audio: Uint8Array | string;
+} | {
+    readonly type: "response.audio.done";
+    readonly responseId: string;
+} | {
+    readonly type: "response.text.delta";
+    readonly responseId: string;
+    readonly text: string;
+} | {
+    readonly type: "response.text.done";
+    readonly responseId: string;
+    readonly text: string;
+} | {
+    readonly type: "response.tool_call";
+    readonly responseId: string;
+    readonly id: string;
+    readonly name: string;
+    readonly arguments: string;
+} | {
+    readonly type: "response.done";
+    readonly responseId: string;
+    readonly usage: any;
+} | {
+    readonly type: "error";
+    readonly error: any;
+};
+export interface RealtimeRequest {
+    model: string;
+    input?: unknown;
+    instructions?: string;
+    customParams?: Record<string, unknown>;
+}
+export interface RealtimeSession {
+    readonly id: string;
+    readonly modelId: string;
+    send(event: RealtimeClientEvent): void;
+    readonly events: AsyncIterableIterator<RealtimeServerEvent>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map