@compose-market/sdk 0.7.11 → 0.8.0

package/dist/types/index.d.ts

@@ -5,56 +5,13 @@
  * (`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 ComposeErrorCode = "validation_error" | "authentication_required" | "authentication_failed" | "forbidden" | "not_found" | "conflict" | "rate_limited" | "payment_required" | "insufficient_balance" | "insufficient_allowance" | "budget_exhausted" | "key_revoked" | "key_expired" | "key_not_found" | "chain_not_supported" | "model_not_found" | "model_ambiguous" | "provider_unavailable" | "upstream_timeout" | "upstream_error" | "internal_error" | "idempotency_conflict" | "idempotency_in_flight" | "settlement_failed" | "session_invalid" | "network_error" | "timeout";
-export interface ComposeErrorEnvelope {
-    error: {
-        code: ComposeErrorCode;
-        message: string;
-        details?: Record<string, unknown>;
-    };
-}
-export interface PaymentRequirements {
-    scheme: string;
-    network: string;
-    amount: string;
-    asset: string;
-    payTo: string;
-    maxTimeoutSeconds: number;
-    extra?: Record<string, unknown> | null;
-}
-export interface PaymentRequired {
-    x402Version: 2;
-    error?: string;
-    resource: {
-        url: string;
-        description?: string;
-        mimeType?: string;
-    };
-    accepts: PaymentRequirements[];
-    extensions?: Record<string, unknown> | null;
-}
-export interface PaymentPayload {
-    x402Version: 2;
-    accepted: PaymentRequirements;
-    payload: unknown;
-    resource?: PaymentRequired["resource"];
-    extensions?: Record<string, unknown> | null;
-}
-export type X402PaymentSignature = string | PaymentPayload;
-export interface X402PaymentRequest {
-    paymentRequired: PaymentRequired;
-    paymentRequiredHeader: string | null;
-    method: string;
-    path: string;
-    url: string;
-    body?: unknown;
-    userAddress?: string | null;
-    chainId?: number | null;
-    maxAmountWei?: string;
-}
-export type X402PaymentSigner = (request: X402PaymentRequest) => X402PaymentSignature | Promise<X402PaymentSignature>;
-export type ComposePaymentMode = "auto" | "composeKey" | "x402";
+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";
 export interface SettleResponse {
     success: boolean;
     errorReason?: string;
@@ -130,7 +87,7 @@ export interface PaymentPrepareInput {
     method: string;
     maxAmountWei?: string;
     meter?: MeteredInput;
-    composeRunId?: string;
+    runId?: string;
     idempotencyKey?: string;
 }
 export interface PaymentPrepareResponse {
@@ -183,7 +140,7 @@ export interface FeedbackTarget {
 export interface FeedbackContext {
     requestId?: string;
     paymentIntentId?: string;
-    composeRunId?: string;
+    runId?: string;
     chainId?: number;
     modelId?: string;
     provider?: string;
@@ -245,11 +202,11 @@ export interface FeedbackSummary {
     verification: Record<FeedbackVerificationKind, number>;
     recent: FeedbackRecord[];
 }
-export type ComposeKeyPurpose = "session" | "api";
-export interface ComposeKeyCreateResponse {
+export type KeyPurpose = "session" | "api";
+export interface KeyCreateResponse {
     keyId: string;
     token: string;
-    purpose: ComposeKeyPurpose;
+    purpose: KeyPurpose;
     budgetLimit: string;
     budgetUsed: string;
     budgetRemaining: string;
@@ -258,9 +215,9 @@ export interface ComposeKeyCreateResponse {
     chainId: number;
     name?: string;
 }
-export interface ComposeKeyRecord {
+export interface KeyRecord {
     keyId: string;
-    purpose: ComposeKeyPurpose;
+    purpose: KeyPurpose;
     budgetLimit: string;
     budgetUsed: string;
     budgetReserved?: string;
@@ -297,117 +254,12 @@ export interface ActiveSessionMetadata {
         };
     };
 }
-/**
- * Live session-budget snapshot parsed from `x-session-budget-*` response
- * headers. Every billable response carries these; the SDK surfaces them as
- * part of `ComposeCompletion<T>` and as a typed `budget` event on the event
- * bus so UIs can update the session indicator without polling `/api/session`.
- */
-export interface SessionBudgetSnapshot {
-    limitWei: string | null;
-    usedWei: string | null;
-    lockedWei: string | null;
-    remainingWei: string | null;
-}
-export type SessionInvalidReason = "budget-depleted" | "expired" | "revoked" | "chain-mismatch" | (string & {
-    readonly __brand?: "SessionInvalidReason";
-});
-/**
- * SSE-frame payload for `/api/session/events`. The server emits two named
- * events: `session-active` (live ledger heartbeat while the session is
- * healthy) and `session-expired` (terminal notification when the session has
- * been revoked, expired, or run out of budget).
- */
-export interface SessionActiveEvent {
-    type: "session-active";
-    userAddress: string;
-    chainId: number;
-    expiresAt?: number;
-    budgetLimit?: string;
-    budgetUsed?: string;
-    budgetLocked?: string;
-    budgetRemaining?: string;
-    timestamp?: number;
-}
-export interface SessionExpiredEvent {
-    type: "session-expired";
-    userAddress: string;
-    chainId: number;
-    reason?: SessionInvalidReason;
-    message?: string;
-    action?: string;
-    expiresAt?: number;
-    timestamp?: number;
-}
-export interface SessionLeaseEvent {
-    type: "session-lease";
-    userAddress: string;
-    chainId: number;
-    reason?: "lease-expired" | (string & {
-        readonly __brand?: "SessionLeaseReason";
-    });
-    message?: string;
-    leaseMs?: number;
-    retryAfterMs?: number;
-    timestamp?: number;
-}
-export type SessionEvent = SessionActiveEvent | SessionExpiredEvent | SessionLeaseEvent;
-export interface ComposeAlert {
-    type: "compose.alert";
-    code: string;
-    severity: "info" | "warning" | "error";
-    source: string;
-    scope: "session" | "agent" | "model" | "workflow" | "api" | (string & {
-        readonly __brand?: "ComposeAlertScope";
-    });
-    title?: string;
-    message: string;
-    userAddress?: string | null;
-    chainId?: number | null;
-    timestamp?: number;
-    metadata?: Record<string, unknown>;
-    leaseMs?: number;
-    retryAfterMs?: number;
-}
-export interface ReceiptLineItem {
-    key: string;
-    unit: string;
-    quantity: number;
-    unitPriceUsd: number;
-    amountWei: string;
-}
-export interface ReceiptFees {
-    total: {
-        percent: string;
-        amount: string;
-    };
-    distribution: Record<string, string>;
-}
-export interface ReceiptBill {
-    agent: string;
-    agentWallet?: string;
-    depth: number;
-    model?: string;
-    tokens: Record<string, number>;
-    tools: string[];
-    total: string;
-    duration: string;
-    txId?: string;
-    fees: ReceiptFees;
-    children?: ReceiptBill[];
-}
 export interface ReceiptCumulative {
     totalAmountWei: string;
     providerAmountWei?: string;
     platformFeeWei?: string;
     receiptCount: number;
 }
-export interface Receipt {
-    user?: string;
-    runId?: string;
-    duration?: string;
-    bills?: ReceiptBill[];
-}
 export interface ReceiptListResponse {
     userAddress: string;
     chainId: number;
@@ -959,7 +811,7 @@ export type VideoStatusStreamEvent = {
  * 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" | "conclave" | "route";
+export type AgentDisplayKind = "tool" | "model" | "connector" | "agent" | "search" | "harness" | "swarm" | "conclave" | "route";
 export interface AgentEventDisplay {
     kind: AgentDisplayKind;
     id?: string;
@@ -968,15 +820,16 @@ export interface AgentEventDisplay {
     summary?: string;
     details?: Record<string, unknown>;
 }
-export type AgentHarnessPlanDecision = "approved" | "rejected" | "changes_requested";
+export type PlanDecision = "approved" | "rejected" | "changes_requested";
 export type AgentArtifactKind = "image" | "audio" | "video" | "embedding" | "realtime" | "file" | "artifact";
 export interface AgentStreamCreateParams {
     agentWallet: string;
     message: string;
     threadId: string;
     userAddress: string;
+    agentCard?: unknown;
     cloudPermissions?: unknown;
-    composeRunId?: string;
+    runId?: string;
     attachment?: AttachmentInput;
     attachments?: AttachmentInput[];
 }
@@ -1002,7 +855,8 @@ export interface AgentDecisionInput {
     runId: string;
     proposalId: string;
     version: number;
-    decision: AgentHarnessPlanDecision;
+    approvalId?: string;
+    decision: PlanDecision;
     approver?: string;
     reason?: string;
     feedback?: string;
@@ -1012,7 +866,7 @@ export interface AgentDecisionResult {
     proposalId?: string;
     version?: number;
     state?: string;
-    decision?: AgentHarnessPlanDecision;
+    decision?: PlanDecision;
     [key: string]: unknown;
 }
 export interface WorkflowStreamCreateParams {
@@ -1020,7 +874,7 @@ export interface WorkflowStreamCreateParams {
     message: string;
     threadId: string;
     userAddress: string;
-    composeRunId?: string;
+    runId?: string;
     continuous?: boolean;
     lastEventIndex?: number;
     attachment?: AttachmentInput;
@@ -1064,7 +918,7 @@ export interface LocalRedeemedContext {
     agentWallet: string;
     userAddress: string;
     chainId: number;
-    composeKey: {
+    key: {
         keyId: string;
         token: string;
         expiresAt: number;
@@ -1091,7 +945,7 @@ export interface LocalLinkRedeemResponse {
 export interface LocalDeploymentRegisterInput {
     agentWallet: string;
     userAddress?: string;
-    composeKeyId: string;
+    keyId: string;
     agentCardCid: string;
     localVersion: string;
     deployedAt: number;
@@ -1102,7 +956,7 @@ export interface LocalDeploymentRecord {
     deploymentId: string;
     agentWallet: string;
     userAddress: string;
-    composeKeyId: string;
+    keyId: string;
     agentCardCid: string;
     localVersion: string;
     deployedAt: number;
@@ -1244,97 +1098,102 @@ export interface SettlementStatusResponse {
     message?: string;
     budget?: SettlementBudgetInfo;
 }
-export type BackpackConsentType = "filesystem" | "camera" | "microphone" | "geolocation" | "clipboard" | "notifications" | string;
-export interface BackpackPermission {
+export type PermissionConsentType = "filesystem" | "camera" | "microphone" | "geolocation" | "clipboard" | "notifications" | string;
+export interface PermissionGrant {
     userAddress: string;
-    sessionId?: string;
-    agentWallet?: string;
-    consentType: BackpackConsentType;
+    agentWallet: string;
+    consentType: PermissionConsentType;
     granted: boolean;
     grantedAt: number;
     expiresAt?: number;
 }
-export interface BackpackPermissionListInput {
+export interface PermissionListInput {
     userAddress?: string;
+    agentWallet: string;
 }
-export interface BackpackPermissionListResponse {
-    permissions: BackpackPermission[];
+export interface PermissionListResponse {
+    permissions: PermissionGrant[];
 }
-export interface BackpackPermissionGrantInput {
+export interface PermissionGrantInput {
     userAddress?: string;
-    consentType: BackpackConsentType;
-    sessionId?: string;
-    agentWallet?: string;
+    agentWallet: string;
+    consentType: PermissionConsentType;
     expiresAt?: number;
 }
-export interface BackpackPermissionRevokeInput {
+export interface PermissionRevokeInput {
     userAddress?: string;
-    consentType: BackpackConsentType;
-    sessionId?: string;
-    agentWallet?: string;
+    agentWallet: string;
+    consentType: PermissionConsentType;
 }
-export interface BackpackPermissionWriteResponse {
+export interface PermissionWriteResponse {
     success: boolean;
+    permission?: PermissionGrant;
 }
-export interface BackpackConnectInput {
+export interface AccountConnectInput {
     userAddress?: string;
+    agentWallet: string;
     toolkit: string;
 }
-export interface BackpackConnectResponse {
-    redirectUrl?: string;
-    url?: string;
-    connectedAccountId?: string;
-    connectionRequestId?: string;
-    [key: string]: unknown;
+export interface AccountConnectResponse {
+    redirectUrl: string;
+    userAddress: string;
+    agentWallet: string;
+    toolkit: string;
+    connectedAccountId: string;
+    authMode?: string;
 }
-export interface BackpackConnectionsInput {
+export interface AccountListInput {
     userAddress?: string;
+    agentWallet: string;
+    toolkit?: string;
 }
-export interface BackpackConnection {
+export interface AccountConnection {
     slug: string;
     name: string;
     connected: boolean;
-    accountId?: string;
+    connectedAccountId: string;
+    accountId: string;
     status?: string;
-    source?: string;
-    sourceLabel?: string;
-    bindingId?: string;
+    source: "composio" | string;
 }
-export interface BackpackConnectionsResponse {
-    connections: BackpackConnection[];
+export interface AccountListResponse {
+    connections: AccountConnection[];
 }
-export interface BackpackStatusInput {
+export interface AccountStatusInput {
     userAddress?: string;
-}
-export interface BackpackStatusResponse {
+    agentWallet: string;
     toolkit: string;
-    connected: boolean;
-    accountId?: string;
+    connectedAccountId: string;
 }
-export interface BackpackDisconnectInput {
+export type AccountStatusResponse = AccountConnection;
+export interface AccountDisconnectInput {
     userAddress?: string;
+    agentWallet: string;
     toolkit: string;
+    connectedAccountId: string;
 }
-export interface BackpackDisconnectResponse {
+export interface AccountDisconnectResponse {
     success: boolean;
 }
-export interface BackpackExecuteInput {
+export interface AccountExecuteInput {
     userAddress?: string;
+    agentWallet: string;
     toolkit: string;
+    connectedAccountId: string;
     action: string;
     params?: Record<string, unknown>;
     text?: string;
 }
-export interface BackpackExecuteResponse {
+export interface AccountExecuteResponse {
     success: boolean;
     result?: unknown;
     error?: string;
 }
-export interface BackpackToolkitsInput {
+export interface AccountToolkitsInput {
     search?: string;
     limit?: number;
 }
-export interface BackpackToolkit {
+export interface AccountToolkit {
     slug: string;
     name: string;
     logo: string;
@@ -1343,13 +1202,13 @@ export interface BackpackToolkit {
     authSchemes: string[];
     composioManagedSchemes: string[];
 }
-export interface BackpackToolkitsResponse {
-    toolkits: BackpackToolkit[];
+export interface AccountToolkitsResponse {
+    toolkits: AccountToolkit[];
 }
-export interface BackpackToolkitActionsInput {
+export interface AccountToolkitActionsInput {
     limit?: number;
 }
-export interface BackpackToolkitAction {
+export interface AccountToolkitAction {
     slug: string;
     name: string;
     description: string;
@@ -1359,24 +1218,80 @@ export interface BackpackToolkitAction {
     scopes: string[];
     inputParameters: Record<string, unknown>;
 }
-export interface BackpackToolkitActionsResponse {
+export interface AccountToolkitActionsResponse {
     toolkit: string;
-    actions: BackpackToolkitAction[];
+    actions: AccountToolkitAction[];
 }
-export interface BackpackTelegramLinkInput {
+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 BackpackTelegramLinkResponse {
-    deepLinkUrl: string;
-    linkCode: string;
+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 BackpackTelegramStatusInput {
+export interface ChannelDisconnectInput {
     userAddress?: string;
+    agentWallet: string;
+    accountId?: string;
+    threadId?: string;
 }
-export interface BackpackTelegramStatusResponse {
-    toolkit: "telegram" | string;
-    bound: boolean;
-    chatId?: string;
+export interface ChannelDisconnectResponse {
+    channel: ChannelName;
+    disconnected: number;
 }
 export interface DirectoryAgent {
     schemaVersion: string;
@@ -1407,7 +1322,7 @@ export interface DirectoryAgent {
         name: string;
         version: string;
     }>;
-    plugins?: Array<{
+    connectors?: Array<{
         registryId: string;
         name: string;
         origin: string;