@mirra-messenger/sdk 0.2.0 → 0.4.0

package/dist/generated/adapters.d.ts

@@ -0,0 +1,1693 @@
+/**
+ * Auto-Generated SDK Adapter Methods
+ *
+ * DO NOT EDIT THIS FILE DIRECTLY
+ * Generated from adapter operation schemas
+ * Run: npm run generate:llm-api
+ */
+import { MirraSDK } from '../client';
+export interface FlowsCreateTimeFlowArgs {
+    title: string;
+    description: string;
+    schedule: string;
+    scriptId: string;
+    scriptInput?: any;
+}
+export interface FlowsCreateEventFlowArgs {
+    title: string;
+    description: string;
+    trigger: any;
+    scriptId: string;
+    scriptInput?: any;
+}
+export interface FlowsListFlowsArgs {
+    status?: string;
+}
+export interface FlowsGetFlowArgs {
+    id: string;
+}
+export interface FlowsUpdateFlowArgs {
+    id: string;
+    title?: string;
+    description?: string;
+    trigger?: any;
+    scriptId?: string;
+    scriptInput?: any;
+    status?: string;
+}
+export interface FlowsDeleteFlowArgs {
+    id: string;
+}
+export interface FlowsPauseFlowArgs {
+    id: string;
+}
+export interface FlowsResumeFlowArgs {
+    id: string;
+}
+export interface FlowsSearchFlowsArgs {
+    status?: string;
+    triggerType?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface FlowsRecordExecutionArgs {
+    id: string;
+    success: boolean;
+    result?: any;
+    error?: string;
+}
+export interface FlowsListEventTypesArgs {
+    includeTemplates?: boolean;
+}
+export interface FlowsTestFlowArgs {
+    flowId: string;
+    dryRun?: boolean;
+    eventOverrides?: any;
+}
+export interface FlowsValidateTriggerArgs {
+    flowId: string;
+    event: any;
+}
+export interface UserUpdateProfileArgs {
+    username?: string;
+    email?: string;
+    timezone?: string;
+    phoneNumber?: string;
+}
+export interface UserUpdatePreferencesArgs {
+    timezone?: string;
+    socials?: any;
+}
+export interface UserDeactivateAccountArgs {
+    confirm: boolean;
+}
+export interface ContactsListContactsArgs {
+    limit?: number;
+    offset?: number;
+}
+export interface ContactsGetContactArgs {
+    contactId?: string;
+    username?: string;
+}
+export interface ContactsAddContactArgs {
+    username: string;
+}
+export interface ContactsRemoveContactArgs {
+    contactId?: string;
+    username?: string;
+}
+export interface ContactsSearchContactsArgs {
+    query: string;
+    searchType?: string;
+    limit?: number;
+}
+export interface ContactsBlockContactArgs {
+    contactId?: string;
+    username?: string;
+}
+export interface ContactsUnblockContactArgs {
+    contactId?: string;
+    username?: string;
+}
+export interface ContactsGetBlockedContactsArgs {
+    limit?: number;
+    offset?: number;
+}
+export interface ContactsGetContactRequestsArgs {
+    type?: string;
+    status?: string;
+}
+export interface MemoryCreateArgs {
+    type: string;
+    content: string;
+    metadata?: any;
+}
+export interface MemorySearchArgs {
+    query: string;
+    limit?: number;
+}
+export interface MemoryQueryArgs {
+    type?: string;
+    filters?: any;
+    limit?: number;
+    offset?: number;
+}
+export interface MemoryFindOneArgs {
+    filters: any;
+}
+export interface MemoryUpdateArgs {
+    id: string;
+    type?: string;
+    content?: string;
+    metadata?: any;
+}
+export interface MemoryDeleteArgs {
+    id: string;
+}
+export interface AiChatArgs {
+    messages: any[];
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface AiDecideArgs {
+    prompt: string;
+    options: any[];
+    context?: string;
+    model?: string;
+}
+export interface DocumentUploadArgs {
+    file: string;
+    filename: string;
+    mimeType: string;
+    graphId?: string;
+    title?: string;
+    productTags?: any[];
+}
+export interface DocumentGetArgs {
+    documentId: string;
+}
+export interface DocumentGetStatusArgs {
+    documentId: string;
+}
+export interface DocumentGetChunksArgs {
+    documentId: string;
+}
+export interface DocumentDeleteArgs {
+    documentId: string;
+}
+export interface DocumentShareArgs {
+    documentId: string;
+    targetGraphId: string;
+    shareReason?: string;
+}
+export interface DocumentUnshareArgs {
+    documentId: string;
+    graphId: string;
+}
+export interface DocumentListGraphsArgs {
+    documentId: string;
+}
+export interface DocumentSearchArgs {
+    query: string;
+    graphId?: string;
+    limit?: number;
+    threshold?: number;
+}
+export interface DocumentListArgs {
+    graphId?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface FeedItemsCreateFeedItemArgs {
+    title: string;
+    subtitle?: string;
+    blocks: any[];
+    itemType: string;
+    actions?: any[];
+    avatar?: any;
+    metadata?: any;
+}
+export interface TelegramSendMessageArgs {
+    chatId: string;
+    text: string;
+}
+export interface TelegramGetChatsArgs {
+    limit?: number;
+    offset?: number;
+    forceRefresh?: boolean;
+}
+export interface TelegramFindChatByNameArgs {
+    name: string;
+}
+export interface TelegramSearchMessagesArgs {
+    chatIds?: any[];
+    query?: string;
+    fromDate?: string;
+    toDate?: string;
+    limit?: number;
+    senderId?: string;
+}
+export interface TelegramGetRecentContactsArgs {
+    sinceDate?: string;
+    onlyNewContacts?: boolean;
+    limit?: number;
+}
+export interface TelegramGetChatMessagesArgs {
+    chatId: string;
+    limit?: number;
+    offsetId?: number;
+    minDate?: string;
+    maxDate?: string;
+}
+export interface TelegramGetUnreadSummaryArgs {
+    chatIds?: any[];
+    priorityOnly?: boolean;
+    groupBy?: string;
+}
+export interface TelegramMarkAsReadArgs {
+    chatId: string;
+    maxMessageId?: number;
+}
+export interface TelegramGetMentionsArgs {
+    chatIds?: any[];
+    sinceDate?: string;
+    onlyUnread?: boolean;
+}
+export interface TelegramGlobalSearchArgs {
+    query: string;
+    filter?: string;
+    limit?: number;
+}
+export interface GoogleGmailSendEmailArgs {
+    to: string;
+    subject: string;
+    body: string;
+    cc?: string;
+    bcc?: string;
+    isHtml?: boolean;
+}
+export interface GoogleGmailSearchEmailsArgs {
+    query: string;
+    maxResults?: number;
+}
+export interface GoogleGmailListEmailsArgs {
+    maxResults?: number;
+}
+export interface GoogleGmailGetEmailArgs {
+    messageId: string;
+}
+export interface GoogleGmailCreateDraftArgs {
+    to: string;
+    subject: string;
+    body: string;
+    cc?: string;
+    bcc?: string;
+    isHtml?: boolean;
+}
+export interface GoogleGmailUpdateDraftArgs {
+    draftId: string;
+    to?: string;
+    subject?: string;
+    body?: string;
+    cc?: string;
+    bcc?: string;
+    isHtml?: boolean;
+}
+export interface GoogleGmailDeleteDraftArgs {
+    draftId: string;
+}
+export interface GoogleGmailListDraftsArgs {
+    maxResults?: number;
+}
+export interface GoogleGmailMarkAsReadArgs {
+    messageId: string;
+}
+export interface GoogleGmailMarkAsUnreadArgs {
+    messageId: string;
+}
+export interface GoogleGmailDeleteEmailArgs {
+    messageId: string;
+}
+export interface GoogleCalendarCreateEventArgs {
+    summary: string;
+    start: any;
+    end: any;
+    description?: string;
+    location?: string;
+    attendees?: any[];
+}
+export interface GoogleCalendarListEventsArgs {
+    timeMin?: string;
+    timeMax?: string;
+    maxResults?: number;
+    query?: string;
+}
+export interface GoogleCalendarGetEventsArgs {
+    timeMin?: string;
+    timeMax?: string;
+    maxResults?: number;
+    query?: string;
+}
+export interface GoogleDriveListFilesArgs {
+    query?: string;
+    pageSize?: number;
+}
+export interface GoogleDriveCreateFileArgs {
+    name: string;
+    mimeType: string;
+    folderId?: string;
+}
+export interface GoogleDriveCreateFolderArgs {
+    name: string;
+    parentFolderId?: string;
+}
+export interface GoogleDriveGetFileInfoArgs {
+    fileId: string;
+}
+export interface GoogleDriveShareFileArgs {
+    fileId: string;
+    email?: string;
+    role?: string;
+}
+export interface GoogleSheetsCreateSpreadsheetArgs {
+    title: string;
+}
+export interface GoogleSheetsReadRangeArgs {
+    spreadsheetId: string;
+    range: string;
+}
+export interface GoogleSheetsWriteRangeArgs {
+    spreadsheetId: string;
+    range: string;
+    values: any[];
+}
+export interface GoogleSheetsAppendRowArgs {
+    spreadsheetId: string;
+    sheetName: string;
+    values: any[];
+}
+export interface GoogleDocsCreateDocumentArgs {
+    title: string;
+}
+export interface GoogleDocsGetDocumentArgs {
+    documentId: string;
+}
+export interface GoogleDocsAppendTextArgs {
+    documentId: string;
+    text: string;
+}
+export interface GoogleDocsReplaceTextArgs {
+    documentId: string;
+    searchText: string;
+    replaceText: string;
+}
+export interface JiraCreateIssueArgs {
+    projectKey: string;
+    summary: string;
+    description?: string;
+    issueType?: string;
+}
+export interface JiraSearchIssuesArgs {
+    jql: string;
+    maxResults?: number;
+}
+export interface JiraGetIssueArgs {
+    issueKey: string;
+}
+export interface JiraUpdateIssueArgs {
+    issueKey: string;
+    summary?: string;
+    description?: string;
+}
+export interface JiraDeleteIssueArgs {
+    issueKey: string;
+}
+export interface JiraAddCommentArgs {
+    issueKey: string;
+    comment: string;
+}
+export interface JiraTransitionIssueArgs {
+    issueKey: string;
+    transitionId: string;
+}
+export interface JiraAssignIssueArgs {
+    issueKey: string;
+    accountId: string;
+}
+export interface JiraGetProjectMetadataArgs {
+    projectKey: string;
+}
+export interface JiraGetTransitionsArgs {
+    issueKey: string;
+}
+export interface JiraListAssignableUsersArgs {
+    projectKey: string;
+}
+export interface JiraGetIssueTypesArgs {
+    projectKey: string;
+}
+export interface TwitterPostTweetArgs {
+    text: string;
+}
+export interface TwitterGetUserTweetsArgs {
+    userId?: string;
+    userName?: string;
+    cursor?: string;
+    includeReplies?: boolean;
+}
+export interface TrelloGetBoardArgs {
+    boardId: string;
+}
+export interface TrelloCreateCardArgs {
+    name: string;
+    idList: string;
+    desc?: string;
+}
+export interface TrelloGetCardArgs {
+    cardId: string;
+}
+export interface TrelloUpdateCardArgs {
+    cardId: string;
+    name?: string;
+    desc?: string;
+    idList?: string;
+    closed?: boolean;
+}
+export interface TrelloDeleteCardArgs {
+    cardId: string;
+}
+export interface TrelloCreateChecklistArgs {
+    cardId: string;
+    name: string;
+}
+export interface TrelloGetChecklistArgs {
+    checklistId: string;
+}
+export interface TrelloUpdateChecklistArgs {
+    checklistId: string;
+    name: string;
+}
+export interface TrelloDeleteChecklistArgs {
+    checklistId: string;
+}
+export interface TrelloAddCheckItemArgs {
+    checklistId: string;
+    name: string;
+}
+export interface TrelloUpdateCheckItemArgs {
+    cardId: string;
+    checkItemId: string;
+    name?: string;
+    state?: string;
+}
+export interface TrelloDeleteCheckItemArgs {
+    checklistId: string;
+    checkItemId: string;
+}
+export interface JupiterSwapArgs {
+    inputMint: string;
+    outputMint: string;
+    amount: number;
+    inputDecimals: number;
+    slippageBps?: number;
+}
+export interface JupiterGetHoldingsArgs {
+    walletAddress?: string;
+}
+export interface JupiterGetTokenSecurityArgs {
+    tokenMint: string;
+}
+export interface JupiterSearchTokensArgs {
+    query: string;
+}
+export interface CryptoGetPriceArgs {
+    tokenAddress: string;
+    chainName?: string;
+}
+export interface CryptoSendTokenArgs {
+    recipient: string;
+    token: string;
+    amount: number;
+}
+export interface CryptoMonitorPriceArgs {
+    tokenAddress: string;
+    direction: string;
+    targetPrice: number;
+    scriptId: string;
+    chainName?: string;
+    percentStep?: number;
+}
+export interface CryptoUnsubscribeAssetArgs {
+    tokenAddress: string;
+}
+export interface ScriptsCreateScriptArgs {
+    name: string;
+    description?: string;
+    runtime?: string;
+    config?: any;
+    code: string;
+}
+export interface ScriptsDeleteScriptArgs {
+    scriptId: string;
+}
+export interface ScriptsCreateVersionArgs {
+    scriptId: string;
+    code: string;
+    commitMessage?: string;
+}
+export interface ScriptsListVersionsArgs {
+    scriptId: string;
+}
+export interface ScriptsDeployScriptArgs {
+    scriptId: string;
+    version?: number;
+}
+export interface ScriptsExecuteScriptArgs {
+    scriptId: string;
+    data?: any;
+    trigger?: any;
+}
+export interface ScriptsGetScriptArgs {
+    scriptId: string;
+}
+export interface ScriptsGetExecutionsArgs {
+    scriptId: string;
+    status?: string;
+    limit?: number;
+}
+export interface ScriptsGetExecutionArgs {
+    executionId: string;
+}
+export interface ScriptsPublishScriptArgs {
+    scriptId: string;
+    pricing?: any;
+}
+export interface ScriptsUnpublishScriptArgs {
+    scriptId: string;
+}
+export interface ScriptsGetMetricsArgs {
+    scriptId: string;
+}
+export interface ScriptsCreateWebhookArgs {
+    scriptId: string;
+    name: string;
+    enabled?: boolean;
+}
+export interface ScriptsCreateScheduleArgs {
+    scriptId: string;
+    name: string;
+    cronExpression: string;
+    enabled?: boolean;
+    data?: any;
+}
+export interface ScriptsGetFlowScriptArgs {
+    flowId: string;
+}
+export interface ScriptsModifyFlowScriptArgs {
+    flowId: string;
+    newCode: string;
+    commitMessage?: string;
+}
+export interface ScriptsLintScriptArgs {
+    code: string;
+}
+/**
+ * Flows Adapter
+ * Category: internal
+ */
+declare function createFlowsAdapter(sdk: MirraSDK): {
+    /**
+     * Create a new time-based flow with cron schedule
+     * @param args.title - Flow title
+     * @param args.description - Detailed description of what the flow does
+     * @param args.schedule - Cron expression for scheduling (e.g., "0 9 * * *" for daily at 9am)
+     * @param args.scriptId - ID of the script to execute when triggered
+     * @param args.scriptInput - Optional static input data for the script (optional)
+     */
+    createTimeFlow: (args: FlowsCreateTimeFlowArgs) => Promise<any>;
+    /**
+     * Create an event-based flow with pre-filtering conditions.
+
+EFFICIENCY RULE: Always filter in eventFilter, not the script.
+- eventFilter conditions: FREE (evaluated in-memory before script runs)
+- Script filtering: EXPENSIVE (invokes Lambda for every event)
+
+BAD: Trigger on "telegram.message" with no filter → script checks sender
+GOOD: Trigger on "telegram.message" with eventFilter for sender
+
+TRIGGER STRUCTURE:
+{
+  type: "event",
+  config: {
+    eventFilter: {
+      operator: "and" | "or",
+      conditions: [
+        { operator: "equals", field: "eventType", value: "call.ended" },
+        { operator: "contains", field: "content.text", value: "urgent" }
+      ]
+    }
+  }
+}
+
+VALID OPERATORS: equals, notEquals, contains, startsWith, endsWith, greaterThan, lessThan, exists, notExists, matchesRegex, and, or, not
+
+COMMON EVENT TYPES: call.started, call.ended, call.action, telegram.message, gmail.email_received
+     * @param args.title - Flow title
+     * @param args.description - Detailed description of what the flow does
+     * @param args.trigger - Event filter conditions that determine WHEN the script runs. Add ALL filtering logic here to minimize Lambda invocations. Must have type:"event" and config.eventFilter with operator and conditions array.
+     * @param args.scriptId - ID of the script to execute when triggered
+     * @param args.scriptInput - Optional static input data for the script (optional)
+     */
+    createEventFlow: (args: FlowsCreateEventFlowArgs) => Promise<any>;
+    /**
+     * List all flows for the user
+     * @param args.status - Filter by status: active, paused, completed, failed (optional)
+     */
+    listFlows: (args: FlowsListFlowsArgs) => Promise<any>;
+    /**
+     * Get a specific flow by ID
+     * @param args.id - Flow ID
+     */
+    getFlow: (args: FlowsGetFlowArgs) => Promise<any>;
+    /**
+     * Update an existing flow
+     * @param args.id - Flow ID to update
+     * @param args.title - New title (optional)
+     * @param args.description - New description (optional)
+     * @param args.trigger - New trigger configuration (optional)
+     * @param args.scriptId - New script ID (optional)
+     * @param args.scriptInput - New script input data (optional)
+     * @param args.status - New status: active, paused, completed, failed (optional)
+     */
+    updateFlow: (args: FlowsUpdateFlowArgs) => Promise<any>;
+    /**
+     * Delete a flow
+     * @param args.id - Flow ID to delete
+     */
+    deleteFlow: (args: FlowsDeleteFlowArgs) => Promise<any>;
+    /**
+     * Pause an active flow
+     * @param args.id - Flow ID to pause
+     */
+    pauseFlow: (args: FlowsPauseFlowArgs) => Promise<any>;
+    /**
+     * Resume a paused flow
+     * @param args.id - Flow ID to resume
+     */
+    resumeFlow: (args: FlowsResumeFlowArgs) => Promise<any>;
+    /**
+     * Search flows with filters
+     * @param args.status - Filter by status (or array of statuses) (optional)
+     * @param args.triggerType - Filter by trigger type: time or event (optional)
+     * @param args.limit - Maximum number of results (default: 100) (optional)
+     * @param args.offset - Pagination offset (default: 0) (optional)
+     */
+    searchFlows: (args: FlowsSearchFlowsArgs) => Promise<any>;
+    /**
+     * Record execution result for a flow
+     * @param args.id - Flow ID
+     * @param args.success - Whether execution succeeded
+     * @param args.result - Execution result data (optional)
+     * @param args.error - Error message if execution failed (optional)
+     */
+    recordExecution: (args: FlowsRecordExecutionArgs) => Promise<any>;
+    /**
+     * List all available event types that can trigger automations
+     * @param args.includeTemplates - Include condition templates for each event type (optional)
+     */
+    listEventTypes: (args: FlowsListEventTypesArgs) => Promise<any>;
+    /**
+     * Test a flow by generating an event that matches the trigger conditions.
+
+MODES:
+- dryRun=true (DEFAULT): Validates trigger matching only. Safe, no side effects, no token consumption.
+- dryRun=false: Executes the real script. WARNING: This causes real side effects (sends messages, makes API calls, consumes tokens).
+
+Use dryRun=true first to verify trigger conditions work, then dryRun=false only when ready to test full execution.
+
+WORKFLOW:
+1. Generates a test event from the flow's trigger conditions
+2. Validates the event matches the trigger (always)
+3. If dryRun=false, executes the script with the test event
+
+RESULT:
+Returns detailed information about trigger matching, including which conditions passed/failed, and optionally full execution results.
+     * @param args.flowId - ID of the flow to test
+     * @param args.dryRun - If true (default), only validate trigger matching without executing script. If false, execute the script (causes side effects). (optional)
+     * @param args.eventOverrides - Custom field values to merge into the generated test event (e.g., {"content.text": "custom message"}) (optional)
+     */
+    testFlow: (args: FlowsTestFlowArgs) => Promise<any>;
+    /**
+     * Check if a custom event would match a flow trigger without any execution. Useful for debugging trigger conditions or testing with real event data.
+     * @param args.flowId - ID of the flow
+     * @param args.event - Event object to test against the trigger (must match IntegrationEvent structure)
+     */
+    validateTrigger: (args: FlowsValidateTriggerArgs) => Promise<any>;
+};
+/**
+ * User Adapter
+ * Category: internal
+ */
+declare function createUserAdapter(sdk: MirraSDK): {
+    /**
+     * Get user profile information including username, email, timezone, phone, and usage stats
+     */
+    getProfile: (args?: {}) => Promise<any>;
+    /**
+     * Update user profile fields (username, email, timezone, phone)
+     * @param args.username - New username (3-30 characters, alphanumeric with underscores/hyphens) (optional)
+     * @param args.email - New email address (optional)
+     * @param args.timezone - IANA timezone identifier (e.g., America/Los_Angeles) (optional)
+     * @param args.phoneNumber - Phone number (7-15 digits with optional formatting) (optional)
+     */
+    updateProfile: (args: UserUpdateProfileArgs) => Promise<any>;
+    /**
+     * Update user preferences (notification settings, etc)
+     * @param args.timezone - Preferred timezone for scheduling (optional)
+     * @param args.socials - Social media links (twitter, discord) (optional)
+     */
+    updatePreferences: (args: UserUpdatePreferencesArgs) => Promise<any>;
+    /**
+     * Get token usage statistics, quota, and billing information
+     */
+    getUsageStats: (args?: {}) => Promise<any>;
+    /**
+     * Get active sessions/devices (based on push token registrations)
+     */
+    getSessions: (args?: {}) => Promise<any>;
+    /**
+     * Soft delete user account (set inactive flag) - CAUTION: This marks the account for deletion
+     * @param args.confirm - Must be true to confirm account deactivation
+     */
+    deactivateAccount: (args: UserDeactivateAccountArgs) => Promise<any>;
+};
+/**
+ * Contacts Adapter
+ * Category: internal
+ */
+declare function createContactsAdapter(sdk: MirraSDK): {
+    /**
+     * Get a list of all accepted contacts for the user with their profile information
+     * @param args.limit - Maximum number of contacts to return (default: 100) (optional)
+     * @param args.offset - Number of contacts to skip for pagination (default: 0) (optional)
+     */
+    listContacts: (args: ContactsListContactsArgs) => Promise<any>;
+    /**
+     * Get detailed information about a specific contact by their ID or username
+     * @param args.contactId - The contact user ID (MongoDB ObjectId) (optional)
+     * @param args.username - The contact username (optional)
+     */
+    getContact: (args: ContactsGetContactArgs) => Promise<any>;
+    /**
+     * Send a contact request to another user by their username
+     * @param args.username - Username of the user to add as a contact
+     */
+    addContact: (args: ContactsAddContactArgs) => Promise<any>;
+    /**
+     * Remove a user from your contacts list (unfriend)
+     * @param args.contactId - The contact user ID to remove (optional)
+     * @param args.username - The contact username to remove (optional)
+     */
+    removeContact: (args: ContactsRemoveContactArgs) => Promise<any>;
+    /**
+     * Search your contacts by username, email, phone, or wallet address
+     * @param args.query - Search query - can be username, email, phone, or wallet address
+     * @param args.searchType - Type of search to perform: all, username, email, phone, or wallet (default: all) (optional)
+     * @param args.limit - Maximum number of results (default: 20) (optional)
+     */
+    searchContacts: (args: ContactsSearchContactsArgs) => Promise<any>;
+    /**
+     * Block a user (prevents them from contacting you)
+     * @param args.contactId - The user ID to block (optional)
+     * @param args.username - The username to block (optional)
+     */
+    blockContact: (args: ContactsBlockContactArgs) => Promise<any>;
+    /**
+     * Unblock a previously blocked user
+     * @param args.contactId - The user ID to unblock (optional)
+     * @param args.username - The username to unblock (optional)
+     */
+    unblockContact: (args: ContactsUnblockContactArgs) => Promise<any>;
+    /**
+     * Get a list of all users you have blocked
+     * @param args.limit - Maximum number of results (default: 100) (optional)
+     * @param args.offset - Number of items to skip for pagination (default: 0) (optional)
+     */
+    getBlockedContacts: (args: ContactsGetBlockedContactsArgs) => Promise<any>;
+    /**
+     * Get pending contact requests (sent by you or received from others)
+     * @param args.type - Type of requests to retrieve: all, sent, or received (default: all) (optional)
+     * @param args.status - Filter by request status: pending, accepted, or rejected (default: pending) (optional)
+     */
+    getContactRequests: (args: ContactsGetContactRequestsArgs) => Promise<any>;
+};
+/**
+ * Memory Adapter
+ * Category: internal
+ */
+declare function createMemoryAdapter(sdk: MirraSDK): {
+    /**
+     * Create a new memory entity in the knowledge graph. Use the type field to specify what kind of memory (task, note, idea, shopping_item, etc.)
+     * @param args.type - Memory subtype: "task" (reminders/todos), "note" (general notes), "idea" (concepts/ideas), "shopping_item" (shopping list), "topic" (general knowledge), "document" (documents), "contact" (people), or "event" (calendar items)
+     * @param args.content - Main content/description of the memory
+     * @param args.metadata - Additional metadata (e.g., priority, deadline, tags, etc.) (optional)
+     */
+    create: (args: MemoryCreateArgs) => Promise<any>;
+    /**
+     * Semantic search across memory entities
+     * @param args.query - Search query text
+     * @param args.limit - Maximum number of results to return (default: 50, max: 100) (optional)
+     */
+    search: (args: MemorySearchArgs) => Promise<any>;
+    /**
+     * Query entities with filters and pagination
+     * @param args.type - Entity type filter (optional)
+     * @param args.filters - Additional filters (optional)
+     * @param args.limit - Maximum results (default: 50, max: 100) (optional)
+     * @param args.offset - Pagination offset (default: 0) (optional)
+     */
+    query: (args: MemoryQueryArgs) => Promise<any>;
+    /**
+     * Find a single entity matching criteria
+     * @param args.filters - Filter criteria (e.g., { id: "..." })
+     */
+    findOne: (args: MemoryFindOneArgs) => Promise<any>;
+    /**
+     * Update an existing memory entity
+     * @param args.id - Entity ID to update
+     * @param args.type - Entity type (optional)
+     * @param args.content - Updated content (optional)
+     * @param args.metadata - Updated metadata (optional)
+     */
+    update: (args: MemoryUpdateArgs) => Promise<any>;
+    /**
+     * Delete a memory entity
+     * @param args.id - Entity ID to delete
+     */
+    delete: (args: MemoryDeleteArgs) => Promise<any>;
+};
+/**
+ * AI Services Adapter
+ * Category: internal
+ */
+declare function createAiAdapter(sdk: MirraSDK): {
+    /**
+     * Have a conversation with an AI assistant. Supports multi-turn conversations with system prompts, user messages, and assistant responses.
+
+PROVIDER: Uses Anthropic (Claude) as the AI provider.
+
+BEST PRACTICES:
+- Use system messages to set AI behavior and constraints
+- Keep conversations focused - avoid unnecessary context
+
+MESSAGE STRUCTURE:
+Each message has:
+- role: "system" | "user" | "assistant"
+- content: string (the message text)
+
+TYPICAL PATTERNS:
+1. Simple query: [{ role: "user", content: "question" }]
+2. With system prompt: [{ role: "system", content: "instructions" }, { role: "user", content: "question" }]
+3. Multi-turn: [system, user, assistant, user, assistant, ...]
+     * @param args.messages - Array of message objects with role ("system" | "user" | "assistant") and content (string). System messages set AI behavior, user messages are queries, assistant messages are previous AI responses.
+     * @param args.model - Specific model to use. Default: "claude-3-haiku-20240307". Use Anthropic Claude model names. (optional)
+     * @param args.temperature - Creativity level 0.0-1.0. Lower=factual/consistent, Higher=creative/varied. Default: 0.7 (optional)
+     * @param args.maxTokens - Maximum tokens in response. Default: 1000. Increase for longer responses (costs more tokens). (optional)
+     */
+    chat: (args: AiChatArgs) => Promise<any>;
+    /**
+     * Use AI to make a decision from a list of options. The AI analyzes your prompt, considers the context, and selects the most appropriate option with reasoning.
+
+USE CASES:
+- Route messages to correct handlers
+- Classify user intents
+- Select appropriate tools or actions
+- Prioritize tasks
+- Choose templates or responses
+- Determine sentiment or category
+
+HOW IT WORKS:
+1. Provide a prompt (the decision context)
+2. List available options (each with id and label)
+3. Optionally add extra context
+4. AI returns selected option ID and reasoning
+
+BEST PRACTICES:
+- Make option labels clear and descriptive
+- Use unique IDs for options
+- Add context when decision needs background info
+- Keep prompt focused on the decision criteria
+- Use metadata field for additional option data
+     * @param args.prompt - The decision prompt - what needs to be decided and why
+     * @param args.options - Array of options to choose from. Each option must have: id (unique identifier), label (descriptive name), and optional metadata (additional data)
+     * @param args.context - Additional context to help the AI make a better decision (optional)
+     * @param args.model - Specific model to use. Defaults to system default. (optional)
+     */
+    decide: (args: AiDecideArgs) => Promise<any>;
+};
+/**
+ * Documents Adapter
+ * Category: storage
+ */
+declare function createDocumentAdapter(sdk: MirraSDK): {
+    /**
+     * Upload and process a document (PDF, DOCX, TXT, MD)
+     * @param args.file - Base64 encoded file content
+     * @param args.filename - Original filename with extension
+     * @param args.mimeType - MIME type (application/pdf, text/plain, etc.)
+     * @param args.graphId - Target graph ID (defaults to user's personal graph) (optional)
+     * @param args.title - Custom document title (optional)
+     * @param args.productTags - Array of product tags for categorization (optional)
+     */
+    upload: (args: DocumentUploadArgs) => Promise<any>;
+    /**
+     * Get document metadata and content
+     * @param args.documentId - Document ID to retrieve
+     */
+    get: (args: DocumentGetArgs) => Promise<any>;
+    /**
+     * Get document processing status
+     * @param args.documentId - Document ID to check
+     */
+    getStatus: (args: DocumentGetStatusArgs) => Promise<any>;
+    /**
+     * Get all chunks for a document
+     * @param args.documentId - Document ID
+     */
+    getChunks: (args: DocumentGetChunksArgs) => Promise<any>;
+    /**
+     * Delete a document and all its chunks
+     * @param args.documentId - Document ID to delete
+     */
+    delete: (args: DocumentDeleteArgs) => Promise<any>;
+    /**
+     * Share a document to another graph (group or user-contact)
+     * @param args.documentId - Document ID to share
+     * @param args.targetGraphId - Target graph ID to share to
+     * @param args.shareReason - Optional reason for sharing (optional)
+     */
+    share: (args: DocumentShareArgs) => Promise<any>;
+    /**
+     * Remove document access from a graph
+     * @param args.documentId - Document ID
+     * @param args.graphId - Graph ID to remove access from
+     */
+    unshare: (args: DocumentUnshareArgs) => Promise<any>;
+    /**
+     * List all graphs a document is shared in
+     * @param args.documentId - Document ID
+     */
+    listGraphs: (args: DocumentListGraphsArgs) => Promise<any>;
+    /**
+     * Semantic search across document chunks
+     * @param args.query - Search query
+     * @param args.graphId - Graph ID to search in (defaults to user's graph) (optional)
+     * @param args.limit - Maximum results (default: 10) (optional)
+     * @param args.threshold - Similarity threshold 0-1 (default: 0.7) (optional)
+     */
+    search: (args: DocumentSearchArgs) => Promise<any>;
+    /**
+     * List documents in a graph
+     * @param args.graphId - Graph ID to list documents from (defaults to user's graph) (optional)
+     * @param args.limit - Maximum results (default: 50) (optional)
+     * @param args.offset - Pagination offset (default: 0) (optional)
+     */
+    list: (args: DocumentListArgs) => Promise<any>;
+};
+/**
+ * Feed Items Adapter
+ * Category: internal
+ */
+declare function createFeedItemsAdapter(sdk: MirraSDK): {
+    /**
+     * Create a feed item with flexible content blocks. Use this to show action results, notifications, or updates to users.
+     * @param args.title - Main title of the feed item (shown prominently)
+     * @param args.subtitle - Optional subtitle (shown below title in muted color) (optional)
+     * @param args.blocks - Array of content blocks to display (text, key_value, list, timestamp, user_mention, divider, image, progress)
+     * @param args.itemType - Type: informative (FYI), actionable (needs response), or error
+     * @param args.actions - Optional action buttons for the feed item (optional)
+     * @param args.avatar - Optional avatar to show (user profile, icon, or custom image) (optional)
+     * @param args.metadata - Additional metadata (searchable, not displayed) (optional)
+     */
+    createFeedItem: (args: FeedItemsCreateFeedItemArgs) => Promise<any>;
+};
+/**
+ * Telegram Adapter
+ * Category: social
+ */
+declare function createTelegramAdapter(sdk: MirraSDK): {
+    /**
+     * Send a text message to a Telegram chat or user. Supports both chat IDs and usernames.
+     * @param args.chatId - Chat ID (numeric) or username (e.g., @username) to send the message to. Chat IDs can be obtained from getChats operation.
+     * @param args.text - The text content of the message to send
+     */
+    sendMessage: (args: TelegramSendMessageArgs) => Promise<any>;
+    /**
+     * Retrieve Telegram chats with pagination support. Use limit and offset to paginate through large chat lists. Results are cached for 10 minutes.
+     * @param args.limit - Maximum number of chats to return (default: 50, max: 100). Use pagination for large chat lists to avoid token limits. (optional)
+     * @param args.offset - Number of chats to skip for pagination (default: 0). Combine with limit to fetch subsequent pages. (optional)
+     * @param args.forceRefresh - If true, bypasses the cache and fetches fresh chat data from Telegram. Default: false (optional)
+     */
+    getChats: (args: TelegramGetChatsArgs) => Promise<any>;
+    /**
+     * Find a Telegram chat by name or username. Searches through user's chats and returns the first match.
+     * @param args.name - Chat name, username (with or without @), or partial match to search for
+     */
+    findChatByName: (args: TelegramFindChatByNameArgs) => Promise<any>;
+    /**
+     * Search for messages across Telegram chats by content, date range, sender, or specific chats.
+     * @param args.chatIds - Array of chat IDs to search within. If not provided, searches globally. (optional)
+     * @param args.query - Text query to search for in messages (optional)
+     * @param args.fromDate - ISO date string for start of date range (optional)
+     * @param args.toDate - ISO date string for end of date range (optional)
+     * @param args.limit - Maximum number of messages to return (default: 100, max: 100) (optional)
+     * @param args.senderId - Filter messages by sender ID (optional)
+     */
+    searchMessages: (args: TelegramSearchMessagesArgs) => Promise<any>;
+    /**
+     * Get recent contacts from Telegram, optionally filtering for new contacts since a specific date.
+     * @param args.sinceDate - ISO date string - only return contacts with activity since this date (optional)
+     * @param args.onlyNewContacts - If true, only return contacts that are new (first message after sinceDate) (optional)
+     * @param args.limit - Maximum number of contacts to return (default: 100, max: 100) (optional)
+     */
+    getRecentContacts: (args: TelegramGetRecentContactsArgs) => Promise<any>;
+    /**
+     * Get message history from a specific Telegram chat with pagination and date filtering.
+     * @param args.chatId - Chat ID to retrieve messages from
+     * @param args.limit - Maximum number of messages to return (default: 50, max: 100) (optional)
+     * @param args.offsetId - Message ID to use as pagination offset (optional)
+     * @param args.minDate - ISO date string for minimum message date (optional)
+     * @param args.maxDate - ISO date string for maximum message date (optional)
+     */
+    getChatMessages: (args: TelegramGetChatMessagesArgs) => Promise<any>;
+    /**
+     * Get summary of unread messages across Telegram chats, including mentions and last message info.
+     * @param args.chatIds - Array of chat IDs to filter by. If not provided, checks all chats. (optional)
+     * @param args.priorityOnly - If true, only return chats with unread messages (optional)
+     * @param args.groupBy - Group results by "chat" or "sender" (optional)
+     */
+    getUnreadSummary: (args: TelegramGetUnreadSummaryArgs) => Promise<any>;
+    /**
+     * Mark messages as read in a Telegram chat up to a specific message ID.
+     * @param args.chatId - Chat ID to mark messages as read in
+     * @param args.maxMessageId - Maximum message ID to mark as read. If not provided, marks all messages as read. (optional)
+     */
+    markAsRead: (args: TelegramMarkAsReadArgs) => Promise<any>;
+    /**
+     * Get messages where the user is mentioned in Telegram chats.
+     * @param args.chatIds - Array of chat IDs to filter mentions by (optional)
+     * @param args.sinceDate - ISO date string - only return mentions since this date (optional)
+     * @param args.onlyUnread - If true, only return unread mentions (optional)
+     */
+    getMentions: (args: TelegramGetMentionsArgs) => Promise<any>;
+    /**
+     * Perform a global search across all Telegram chats for messages matching a query.
+     * @param args.query - Search query text
+     * @param args.filter - Filter results by chat type: "groups", "private", or "channels" (optional)
+     * @param args.limit - Maximum number of results to return (default: 100, max: 100) (optional)
+     */
+    globalSearch: (args: TelegramGlobalSearchArgs) => Promise<any>;
+};
+/**
+ * Gmail Adapter
+ * Category: communication
+ */
+declare function createGoogleGmailAdapter(sdk: MirraSDK): {
+    /**
+     * Send an email via Gmail
+     * @param args.to - Valid email address
+     * @param args.subject - Email subject line
+     * @param args.body - Email body content
+     * @param args.cc - CC recipients (comma-separated email addresses) (optional)
+     * @param args.bcc - BCC recipients (comma-separated email addresses) (optional)
+     * @param args.isHtml - Whether body is HTML format (optional)
+     */
+    sendEmail: (args: GoogleGmailSendEmailArgs) => Promise<any>;
+    /**
+     * Search emails with Gmail query syntax
+     * @param args.query - Gmail search query (e.g., "from:user@example.com is:unread")
+     * @param args.maxResults - Maximum number of results to return (default: 50, max: 100) (optional)
+     */
+    searchEmails: (args: GoogleGmailSearchEmailsArgs) => Promise<any>;
+    /**
+     * List recent emails from inbox
+     * @param args.maxResults - Maximum number of results to return (default: 50, max: 100) (optional)
+     */
+    listEmails: (args: GoogleGmailListEmailsArgs) => Promise<any>;
+    /**
+     * Get details of a specific email by ID
+     * @param args.messageId - Gmail message ID
+     */
+    getEmail: (args: GoogleGmailGetEmailArgs) => Promise<any>;
+    /**
+     * Create a draft email in Gmail
+     * @param args.to - Valid email address
+     * @param args.subject - Email subject line
+     * @param args.body - Email body content
+     * @param args.cc - CC recipients (comma-separated email addresses) (optional)
+     * @param args.bcc - BCC recipients (comma-separated email addresses) (optional)
+     * @param args.isHtml - Whether body is HTML format (optional)
+     */
+    createDraft: (args: GoogleGmailCreateDraftArgs) => Promise<any>;
+    /**
+     * Update an existing draft email
+     * @param args.draftId - Gmail draft ID to update
+     * @param args.to - Updated recipient email address(es) (optional)
+     * @param args.subject - Updated email subject line (optional)
+     * @param args.body - Updated email body content (optional)
+     * @param args.cc - Updated CC recipients (optional)
+     * @param args.bcc - Updated BCC recipients (optional)
+     * @param args.isHtml - Whether body is HTML format (optional)
+     */
+    updateDraft: (args: GoogleGmailUpdateDraftArgs) => Promise<any>;
+    /**
+     * Delete a draft email
+     * @param args.draftId - Gmail draft ID to delete
+     */
+    deleteDraft: (args: GoogleGmailDeleteDraftArgs) => Promise<any>;
+    /**
+     * List all draft emails
+     * @param args.maxResults - Maximum number of drafts to return (default: 10) (optional)
+     */
+    listDrafts: (args: GoogleGmailListDraftsArgs) => Promise<any>;
+    /**
+     * Mark an email as read
+     * @param args.messageId - Gmail message ID to mark as read
+     */
+    markAsRead: (args: GoogleGmailMarkAsReadArgs) => Promise<any>;
+    /**
+     * Mark an email as unread
+     * @param args.messageId - Gmail message ID to mark as unread
+     */
+    markAsUnread: (args: GoogleGmailMarkAsUnreadArgs) => Promise<any>;
+    /**
+     * Delete an email
+     * @param args.messageId - Gmail message ID to delete
+     */
+    deleteEmail: (args: GoogleGmailDeleteEmailArgs) => Promise<any>;
+};
+/**
+ * Google Calendar Adapter
+ * Category: productivity
+ */
+declare function createGoogleCalendarAdapter(sdk: MirraSDK): {
+    /**
+     * Create a new calendar event
+     * @param args.summary - Event title/summary
+     * @param args.start - Start time object with dateTime and optional timeZone
+     * @param args.end - End time object with dateTime and optional timeZone
+     * @param args.description - Event description (optional)
+     * @param args.location - Event location (optional)
+     * @param args.attendees - Array of attendee email addresses (optional)
+     */
+    createEvent: (args: GoogleCalendarCreateEventArgs) => Promise<any>;
+    /**
+     * List calendar events
+     * @param args.timeMin - Start time for events to list (ISO 8601) (optional)
+     * @param args.timeMax - End time for events to list (ISO 8601) (optional)
+     * @param args.maxResults - Maximum number of events to return (default: 50, max: 100) (optional)
+     * @param args.query - Search query to filter events (optional)
+     */
+    listEvents: (args: GoogleCalendarListEventsArgs) => Promise<any>;
+    /**
+     * Get calendar events (alias for listEvents)
+     * @param args.timeMin - Start time for events to list (ISO 8601) (optional)
+     * @param args.timeMax - End time for events to list (ISO 8601) (optional)
+     * @param args.maxResults - Maximum number of events to return (default: 50, max: 100) (optional)
+     * @param args.query - Search query to filter events (optional)
+     */
+    getEvents: (args: GoogleCalendarGetEventsArgs) => Promise<any>;
+};
+/**
+ * Google Drive Adapter
+ * Category: storage
+ */
+declare function createGoogleDriveAdapter(sdk: MirraSDK): {
+    /**
+     * List files in Google Drive
+     * @param args.query - Search query (Google Drive query syntax) (optional)
+     * @param args.pageSize - Maximum number of files to return (default: 20) (optional)
+     */
+    listFiles: (args: GoogleDriveListFilesArgs) => Promise<any>;
+    /**
+     * Create a new file in Google Drive
+     * @param args.name - Name of the file
+     * @param args.mimeType - MIME type of the file
+     * @param args.folderId - Parent folder ID (optional) (optional)
+     */
+    createFile: (args: GoogleDriveCreateFileArgs) => Promise<any>;
+    /**
+     * Create a new folder in Google Drive
+     * @param args.name - Name of the folder
+     * @param args.parentFolderId - Parent folder ID (optional) (optional)
+     */
+    createFolder: (args: GoogleDriveCreateFolderArgs) => Promise<any>;
+    /**
+     * Get information about a file
+     * @param args.fileId - ID of the file
+     */
+    getFileInfo: (args: GoogleDriveGetFileInfoArgs) => Promise<any>;
+    /**
+     * Share a file with others
+     * @param args.fileId - ID of the file to share
+     * @param args.email - Email address to share with (optional) (optional)
+     * @param args.role - Permission role: reader, writer, commenter (default: reader) (optional)
+     */
+    shareFile: (args: GoogleDriveShareFileArgs) => Promise<any>;
+};
+/**
+ * Google Sheets Adapter
+ * Category: productivity
+ */
+declare function createGoogleSheetsAdapter(sdk: MirraSDK): {
+    /**
+     * Create a new Google Sheets spreadsheet
+     * @param args.title - Title of the spreadsheet
+     */
+    createSpreadsheet: (args: GoogleSheetsCreateSpreadsheetArgs) => Promise<any>;
+    /**
+     * Read data from a range in a spreadsheet
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.range - Cell range (e.g., "Sheet1!A1:B10")
+     */
+    readRange: (args: GoogleSheetsReadRangeArgs) => Promise<any>;
+    /**
+     * Write data to a range in a spreadsheet
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.range - Cell range (e.g., "Sheet1!A1:B10")
+     * @param args.values - Data to write (2D array)
+     */
+    writeRange: (args: GoogleSheetsWriteRangeArgs) => Promise<any>;
+    /**
+     * Append a row to a spreadsheet
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetName - Name of the sheet
+     * @param args.values - Row values to append
+     */
+    appendRow: (args: GoogleSheetsAppendRowArgs) => Promise<any>;
+};
+/**
+ * Google Docs Adapter
+ * Category: productivity
+ */
+declare function createGoogleDocsAdapter(sdk: MirraSDK): {
+    /**
+     * Create a new Google Doc
+     * @param args.title - Title of the document
+     */
+    createDocument: (args: GoogleDocsCreateDocumentArgs) => Promise<any>;
+    /**
+     * Get a Google Doc by ID
+     * @param args.documentId - ID of the document
+     */
+    getDocument: (args: GoogleDocsGetDocumentArgs) => Promise<any>;
+    /**
+     * Append text to the end of a document
+     * @param args.documentId - ID of the document
+     * @param args.text - Text to append
+     */
+    appendText: (args: GoogleDocsAppendTextArgs) => Promise<any>;
+    /**
+     * Replace text in a document
+     * @param args.documentId - ID of the document
+     * @param args.searchText - Text to search for
+     * @param args.replaceText - Text to replace with
+     */
+    replaceText: (args: GoogleDocsReplaceTextArgs) => Promise<any>;
+};
+/**
+ * Jira Adapter
+ * Category: project
+ */
+declare function createJiraAdapter(sdk: MirraSDK): {
+    /**
+     * Create a new Jira issue
+     * @param args.projectKey - Jira project key (e.g., "PROJ")
+     * @param args.summary - Issue summary/title
+     * @param args.description - Issue description (optional)
+     * @param args.issueType - Issue type (Task, Bug, Story, etc.) (optional)
+     */
+    createIssue: (args: JiraCreateIssueArgs) => Promise<any>;
+    /**
+     * Search Jira issues using JQL
+     * @param args.jql - JQL query string
+     * @param args.maxResults - Maximum number of results (default: 50, max: 100) (optional)
+     */
+    searchIssues: (args: JiraSearchIssuesArgs) => Promise<any>;
+    /**
+     * Get a specific Jira issue by key or ID
+     * @param args.issueKey - Issue key (e.g., "PROJ-123") or ID
+     */
+    getIssue: (args: JiraGetIssueArgs) => Promise<any>;
+    /**
+     * Update an existing Jira issue
+     * @param args.issueKey - Issue key (e.g., "PROJ-123")
+     * @param args.summary - New issue summary/title (optional)
+     * @param args.description - New issue description (optional)
+     */
+    updateIssue: (args: JiraUpdateIssueArgs) => Promise<any>;
+    /**
+     * Delete a Jira issue
+     * @param args.issueKey - Issue key (e.g., "PROJ-123")
+     */
+    deleteIssue: (args: JiraDeleteIssueArgs) => Promise<any>;
+    /**
+     * Add a comment to a Jira issue
+     * @param args.issueKey - Issue key (e.g., "PROJ-123")
+     * @param args.comment - Comment text
+     */
+    addComment: (args: JiraAddCommentArgs) => Promise<any>;
+    /**
+     * Transition a Jira issue to a different status
+     * @param args.issueKey - Issue key (e.g., "PROJ-123")
+     * @param args.transitionId - ID of the transition to perform
+     */
+    transitionIssue: (args: JiraTransitionIssueArgs) => Promise<any>;
+    /**
+     * Assign a Jira issue to a user
+     * @param args.issueKey - Issue key (e.g., "PROJ-123")
+     * @param args.accountId - Atlassian account ID of the assignee
+     */
+    assignIssue: (args: JiraAssignIssueArgs) => Promise<any>;
+    /**
+     * Get all accessible Jira projects
+     */
+    getProjects: (args?: {}) => Promise<any>;
+    /**
+     * List all accessible Jira projects (alias for getProjects)
+     */
+    listProjects: (args?: {}) => Promise<any>;
+    /**
+     * Get metadata for a specific Jira project
+     * @param args.projectKey - Project key (e.g., "PROJ")
+     */
+    getProjectMetadata: (args: JiraGetProjectMetadataArgs) => Promise<any>;
+    /**
+     * Get available transitions for a Jira issue
+     * @param args.issueKey - Issue key (e.g., "PROJ-123")
+     */
+    getTransitions: (args: JiraGetTransitionsArgs) => Promise<any>;
+    /**
+     * List users that can be assigned to issues in a project
+     * @param args.projectKey - Project key (e.g., "PROJ")
+     */
+    listAssignableUsers: (args: JiraListAssignableUsersArgs) => Promise<any>;
+    /**
+     * Get available issue types for a project
+     * @param args.projectKey - Project key (e.g., "PROJ")
+     */
+    getIssueTypes: (args: JiraGetIssueTypesArgs) => Promise<any>;
+};
+/**
+ * Twitter Adapter
+ * Category: social
+ */
+declare function createTwitterAdapter(sdk: MirraSDK): {
+    /**
+     * Post a tweet
+     * @param args.text - Tweet text (max 280 characters)
+     */
+    postTweet: (args: TwitterPostTweetArgs) => Promise<any>;
+    /**
+     * Retrieve tweets from a Twitter user
+     * @param args.userId - Twitter user ID (recommended for stability and speed) (optional)
+     * @param args.userName - Twitter username/screen name (alternative to userId) (optional)
+     * @param args.cursor - Pagination cursor for next page of results (optional)
+     * @param args.includeReplies - Whether to include replies in results (default: false) (optional)
+     */
+    getUserTweets: (args: TwitterGetUserTweetsArgs) => Promise<any>;
+};
+/**
+ * Trello Adapter
+ * Category: productivity
+ */
+declare function createTrelloAdapter(sdk: MirraSDK): {
+    /**
+     * Get all boards for the authenticated user
+     */
+    getBoards: (args?: {}) => Promise<any>;
+    /**
+     * Get a specific board by ID including its lists
+     * @param args.boardId - The ID of the board to retrieve
+     */
+    getBoard: (args: TrelloGetBoardArgs) => Promise<any>;
+    /**
+     * Create a new card in a Trello list
+     * @param args.name - Card name/title
+     * @param args.idList - ID of the list to add the card to
+     * @param args.desc - Card description (supports markdown) (optional)
+     */
+    createCard: (args: TrelloCreateCardArgs) => Promise<any>;
+    /**
+     * Get a specific card by ID
+     * @param args.cardId - The ID of the card to retrieve
+     */
+    getCard: (args: TrelloGetCardArgs) => Promise<any>;
+    /**
+     * Update an existing card
+     * @param args.cardId - The ID of the card to update
+     * @param args.name - New card name (optional)
+     * @param args.desc - New card description (optional)
+     * @param args.idList - Move card to a different list (optional)
+     * @param args.closed - Archive the card (optional)
+     */
+    updateCard: (args: TrelloUpdateCardArgs) => Promise<any>;
+    /**
+     * Delete a card permanently
+     * @param args.cardId - The ID of the card to delete
+     */
+    deleteCard: (args: TrelloDeleteCardArgs) => Promise<any>;
+    /**
+     * Create a new checklist on a card
+     * @param args.cardId - The ID of the card to add the checklist to
+     * @param args.name - Checklist name
+     */
+    createChecklist: (args: TrelloCreateChecklistArgs) => Promise<any>;
+    /**
+     * Get a specific checklist by ID
+     * @param args.checklistId - The ID of the checklist to retrieve
+     */
+    getChecklist: (args: TrelloGetChecklistArgs) => Promise<any>;
+    /**
+     * Update a checklist name
+     * @param args.checklistId - The ID of the checklist to update
+     * @param args.name - New checklist name
+     */
+    updateChecklist: (args: TrelloUpdateChecklistArgs) => Promise<any>;
+    /**
+     * Delete a checklist from a card
+     * @param args.checklistId - The ID of the checklist to delete
+     */
+    deleteChecklist: (args: TrelloDeleteChecklistArgs) => Promise<any>;
+    /**
+     * Add a check item to a checklist
+     * @param args.checklistId - The ID of the checklist to add the item to
+     * @param args.name - Check item text
+     */
+    addCheckItem: (args: TrelloAddCheckItemArgs) => Promise<any>;
+    /**
+     * Update a check item (name or completion state)
+     * @param args.cardId - The ID of the card containing the check item
+     * @param args.checkItemId - The ID of the check item to update
+     * @param args.name - New check item text (optional)
+     * @param args.state - Check state: "complete" or "incomplete" (optional)
+     */
+    updateCheckItem: (args: TrelloUpdateCheckItemArgs) => Promise<any>;
+    /**
+     * Delete a check item from a checklist
+     * @param args.checklistId - The ID of the checklist containing the item
+     * @param args.checkItemId - The ID of the check item to delete
+     */
+    deleteCheckItem: (args: TrelloDeleteCheckItemArgs) => Promise<any>;
+};
+/**
+ * Jupiter Adapter
+ * Category: crypto
+ */
+declare function createJupiterAdapter(sdk: MirraSDK): {
+    /**
+     * Execute a token swap on Jupiter DEX
+     * @param args.inputMint - Input token mint address
+     * @param args.outputMint - Output token mint address
+     * @param args.amount - Amount to swap (in smallest unit)
+     * @param args.inputDecimals - Number of decimals for input token
+     * @param args.slippageBps - Slippage tolerance in basis points (default: 50) (optional)
+     */
+    swap: (args: JupiterSwapArgs) => Promise<any>;
+    /**
+     * Get token holdings for a wallet
+     * @param args.walletAddress - Wallet address to check (uses actor wallet if not provided) (optional)
+     */
+    getHoldings: (args: JupiterGetHoldingsArgs) => Promise<any>;
+    /**
+     * Get token security information using Jupiter Shield
+     * @param args.tokenMint - Token mint address to check security for
+     */
+    getTokenSecurity: (args: JupiterGetTokenSecurityArgs) => Promise<any>;
+    /**
+     * Search for tokens by symbol, name, or mint address
+     * @param args.query - Search query (symbol, name, or mint address)
+     */
+    searchTokens: (args: JupiterSearchTokensArgs) => Promise<any>;
+};
+/**
+ * Crypto Adapter
+ * Category: crypto
+ */
+declare function createCryptoAdapter(sdk: MirraSDK): {
+    /**
+     * Get the current price of a crypto asset
+     * @param args.tokenAddress - Token contract address (EVM: 0x..., SVM: base58)
+     * @param args.chainName - Specific chain name (auto-detected if not provided) (optional)
+     */
+    getPrice: (args: CryptoGetPriceArgs) => Promise<any>;
+    /**
+     * Send cryptocurrency or tokens (creates pending transaction for signing)
+     * @param args.recipient - Contact username, user ID, or Solana wallet address
+     * @param args.token - Token symbol (SOL, USDC), name, or mint address
+     * @param args.amount - Amount to send (in UI units)
+     */
+    sendToken: (args: CryptoSendTokenArgs) => Promise<any>;
+    /**
+     * Set up automated price monitoring with progressive alerts
+     * @param args.tokenAddress - Token contract address to monitor
+     * @param args.direction - Alert direction: "above" or "below"
+     * @param args.targetPrice - Target price in USD to trigger alert
+     * @param args.scriptId - ID of the script to execute when price target is reached
+     * @param args.chainName - Chain name (auto-detected if not provided) (optional)
+     * @param args.percentStep - Progressive alert step percentage (default: 0.1 = 10%) (optional)
+     */
+    monitorPrice: (args: CryptoMonitorPriceArgs) => Promise<any>;
+    /**
+     * List all active crypto price monitoring assignments
+     */
+    listSubscriptions: (args?: {}) => Promise<any>;
+    /**
+     * Stop monitoring a crypto asset
+     * @param args.tokenAddress - Token address to stop monitoring
+     */
+    unsubscribeAsset: (args: CryptoUnsubscribeAssetArgs) => Promise<any>;
+};
+/**
+ * Scripts Adapter
+ * Category: productivity
+ */
+declare function createScriptsAdapter(sdk: MirraSDK): {
+    /**
+     * Create a new script with initial version and API key. IMPORTANT: The script ID for subsequent operations (deployScript, executeScript, etc.) is returned at data._id in the response.
+     * @param args.name - Name of the script
+     * @param args.description - Description of what the script does (optional)
+     * @param args.runtime - Lambda runtime (default: nodejs18) (optional)
+     * @param args.config - Script configuration (timeout, memory, maxCostPerExecution, etc.) (optional)
+     * @param args.code - Initial JavaScript/TypeScript code for the script
+     */
+    createScript: (args: ScriptsCreateScriptArgs) => Promise<any>;
+    /**
+     * Delete a script and all its versions
+     * @param args.scriptId - ID of the script to delete
+     */
+    deleteScript: (args: ScriptsDeleteScriptArgs) => Promise<any>;
+    /**
+     * Create a new version of an existing script.
+     * @param args.scriptId - ID of the script
+     * @param args.code - Updated code for the new version
+     * @param args.commitMessage - Description of changes in this version (optional)
+     */
+    createVersion: (args: ScriptsCreateVersionArgs) => Promise<any>;
+    /**
+     * List all versions of a script
+     * @param args.scriptId - ID of the script
+     */
+    listVersions: (args: ScriptsListVersionsArgs) => Promise<any>;
+    /**
+     * Deploy a script version to AWS Lambda. Must be called after createScript to make the script executable.
+     * @param args.scriptId - ID of the script to deploy (from createScript response at data._id)
+     * @param args.version - Version number to deploy (default: latest) (optional)
+     */
+    deployScript: (args: ScriptsDeployScriptArgs) => Promise<any>;
+    /**
+     * Execute a deployed script with custom data. Script must be deployed first via deployScript.
+     * @param args.scriptId - ID of the script to execute (from createScript response at data._id)
+     * @param args.data - Input data to pass to the script (optional)
+     * @param args.trigger - Trigger information (type, source, event) (optional)
+     */
+    executeScript: (args: ScriptsExecuteScriptArgs) => Promise<any>;
+    /**
+     * Get details of a specific script
+     * @param args.scriptId - ID of the script
+     */
+    getScript: (args: ScriptsGetScriptArgs) => Promise<any>;
+    /**
+     * List all scripts owned by the user
+     */
+    listScripts: (args?: {}) => Promise<any>;
+    /**
+     * Get execution history for a script
+     * @param args.scriptId - ID of the script
+     * @param args.status - Filter by status (completed, failed, running) (optional)
+     * @param args.limit - Maximum number of executions to return (default: 100) (optional)
+     */
+    getExecutions: (args: ScriptsGetExecutionsArgs) => Promise<any>;
+    /**
+     * Get details of a specific execution
+     * @param args.executionId - ID of the execution
+     */
+    getExecution: (args: ScriptsGetExecutionArgs) => Promise<any>;
+    /**
+     * Publish a script to the marketplace
+     * @param args.scriptId - ID of the script to publish
+     * @param args.pricing - Pricing configuration for the marketplace (optional)
+     */
+    publishScript: (args: ScriptsPublishScriptArgs) => Promise<any>;
+    /**
+     * Remove a script from the marketplace
+     * @param args.scriptId - ID of the script to unpublish
+     */
+    unpublishScript: (args: ScriptsUnpublishScriptArgs) => Promise<any>;
+    /**
+     * List all published scripts in the marketplace
+     */
+    listMarketplaceScripts: (args?: {}) => Promise<any>;
+    /**
+     * Get execution metrics for a script
+     * @param args.scriptId - ID of the script
+     */
+    getMetrics: (args: ScriptsGetMetricsArgs) => Promise<any>;
+    /**
+     * Create a webhook endpoint for the script
+     * @param args.scriptId - ID of the script
+     * @param args.name - Name of the webhook
+     * @param args.enabled - Whether webhook is enabled (default: true) (optional)
+     */
+    createWebhook: (args: ScriptsCreateWebhookArgs) => Promise<any>;
+    /**
+     * Create a cron schedule for the script
+     * @param args.scriptId - ID of the script
+     * @param args.name - Name of the schedule
+     * @param args.cronExpression - Cron expression (e.g., "0 9 * * *" for daily at 9am)
+     * @param args.enabled - Whether schedule is enabled (default: true) (optional)
+     * @param args.data - Data to pass to the script on scheduled execution (optional)
+     */
+    createSchedule: (args: ScriptsCreateScheduleArgs) => Promise<any>;
+    /**
+     * Get the script code for a specific flow
+     * @param args.flowId - ID of the flow to get script code for
+     */
+    getFlowScript: (args: ScriptsGetFlowScriptArgs) => Promise<any>;
+    /**
+     * Modify the script code for a flow. Automatically creates a copy if user doesn't own the original, deploys to Lambda, and updates the flow.
+     * @param args.flowId - ID of the flow to modify
+     * @param args.newCode - New code to deploy
+     * @param args.commitMessage - Description of changes (optional)
+     */
+    modifyFlowScript: (args: ScriptsModifyFlowScriptArgs) => Promise<any>;
+    /**
+     * Validate script code BEFORE creating or deploying. Checks for: 1) Missing async handler wrapper (top-level await errors), 2) Invalid adapter operations. Returns validation errors with suggestions for fixes. ALWAYS use this before createScript/modifyFlowScript.
+     * @param args.code - The script code to validate
+     */
+    lintScript: (args: ScriptsLintScriptArgs) => Promise<any>;
+};
+export declare const generatedAdapters: {
+    flows: typeof createFlowsAdapter;
+    user: typeof createUserAdapter;
+    contacts: typeof createContactsAdapter;
+    memory: typeof createMemoryAdapter;
+    ai: typeof createAiAdapter;
+    document: typeof createDocumentAdapter;
+    feedItems: typeof createFeedItemsAdapter;
+    telegram: typeof createTelegramAdapter;
+    googleGmail: typeof createGoogleGmailAdapter;
+    googleCalendar: typeof createGoogleCalendarAdapter;
+    googleDrive: typeof createGoogleDriveAdapter;
+    googleSheets: typeof createGoogleSheetsAdapter;
+    googleDocs: typeof createGoogleDocsAdapter;
+    jira: typeof createJiraAdapter;
+    twitter: typeof createTwitterAdapter;
+    trello: typeof createTrelloAdapter;
+    jupiter: typeof createJupiterAdapter;
+    crypto: typeof createCryptoAdapter;
+    scripts: typeof createScriptsAdapter;
+};
+export {};
+//# sourceMappingURL=adapters.d.ts.map