@mirra-messenger/sdk 0.3.0 → 0.5.0

package/dist/generated/adapters.d.ts

@@ -0,0 +1,2355 @@
+/**
+ * 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 FlowsGetFlowsByEventTypeArgs {
+    eventType: string;
+}
+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;
+    types?: any[];
+    startTime?: number;
+    endTime?: number;
+    propertyFilters?: any;
+    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 {
+    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 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 GoogleCalendarGetEventArgs {
+    eventId: string;
+}
+export interface GoogleCalendarUpdateEventArgs {
+    eventId: string;
+    summary?: string;
+    description?: string;
+    location?: string;
+    start?: any;
+    end?: any;
+}
+export interface GoogleCalendarDeleteEventArgs {
+    eventId: string;
+}
+export interface GoogleCalendarSearchEventsArgs {
+    query: string;
+    timeMin?: string;
+    timeMax?: string;
+    maxResults?: number;
+}
+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 GoogleDriveDownloadFileArgs {
+    fileId: string;
+}
+export interface GoogleDriveMoveFileArgs {
+    fileId: string;
+    folderId: string;
+}
+export interface GoogleDriveDeleteFileArgs {
+    fileId: string;
+    permanently?: boolean;
+}
+export interface GoogleDriveSearchFilesArgs {
+    query: string;
+    pageSize?: number;
+}
+export interface GoogleDriveUpdateFileArgs {
+    fileId: string;
+    name?: string;
+    description?: 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 GoogleSheetsGetSpreadsheetArgs {
+    spreadsheetId: string;
+}
+export interface GoogleSheetsInsertAtCellArgs {
+    spreadsheetId: string;
+    cell: string;
+    value: string;
+    bold?: boolean;
+    italic?: boolean;
+    foregroundColor?: string;
+    backgroundColor?: string;
+}
+export interface GoogleSheetsInsertFormulaArgs {
+    spreadsheetId: string;
+    cell: string;
+    formula: string;
+    note?: string;
+}
+export interface GoogleSheetsFormatRangeArgs {
+    spreadsheetId: string;
+    range: string;
+    bold?: boolean;
+    italic?: boolean;
+    foregroundColor?: string;
+    backgroundColor?: string;
+    borders?: boolean;
+}
+export interface GoogleSheetsCreateChartArgs {
+    spreadsheetId: string;
+    sheetId: number;
+    dataRange: string;
+    chartType: string;
+    title: string;
+    position: any;
+}
+export interface GoogleSheetsFindAndReplaceArgs {
+    spreadsheetId: string;
+    findText: string;
+    replaceText: string;
+    sheetName?: string;
+    matchCase?: boolean;
+    matchEntireCell?: boolean;
+}
+export interface GoogleSheetsInsertMultipleRowsArgs {
+    spreadsheetId: string;
+    sheetName: string;
+    rowsData: any[];
+    startingRow?: number;
+    formattingOptions?: any;
+}
+export interface GoogleSheetsClearRangeArgs {
+    spreadsheetId: string;
+    sheetName: string;
+    range: string;
+}
+export interface GoogleSheetsInsertRowsArgs {
+    spreadsheetId: string;
+    sheetId: number;
+    startRowIndex: number;
+    numRows: number;
+}
+export interface GoogleSheetsDeleteRowsArgs {
+    spreadsheetId: string;
+    sheetId: number;
+    startRowIndex: number;
+    numRows: number;
+}
+export interface GoogleSheetsInsertColumnsArgs {
+    spreadsheetId: string;
+    sheetId: number;
+    startColumnIndex: number;
+    numColumns: number;
+}
+export interface GoogleSheetsDeleteColumnsArgs {
+    spreadsheetId: string;
+    sheetId: number;
+    startColumnIndex: number;
+    numColumns: number;
+}
+export interface GoogleSheetsCopyRangeArgs {
+    spreadsheetId: string;
+    sourceSheetId: number;
+    sourceRange: string;
+    targetSheetId: number;
+    targetStartCell: string;
+}
+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 GoogleDocsGetDocumentContentArgs {
+    documentId: string;
+}
+export interface GoogleDocsInsertTextAtPositionArgs {
+    documentId: string;
+    text: string;
+    position: number;
+}
+export interface GoogleDocsInsertTextAfterArgs {
+    documentId: string;
+    searchText: string;
+    textToInsert: string;
+    occurrence?: number;
+}
+export interface GoogleDocsInsertHeadingArgs {
+    documentId: string;
+    text: string;
+    level: number;
+    position?: number;
+    insertAfterText?: string;
+}
+export interface GoogleDocsInsertListArgs {
+    documentId: string;
+    items: any[];
+    listType: string;
+    position?: number;
+    insertAfterText?: string;
+}
+export interface GoogleDocsInsertTableArgs {
+    documentId: string;
+    data: any[];
+    hasHeader?: boolean;
+    position?: number;
+    insertAfterText?: string;
+}
+export interface GoogleDocsUpdateDocumentContentArgs {
+    documentId: string;
+    newContent: string;
+}
+export interface GoogleDocsCreateSectionArgs {
+    documentId: string;
+    heading: string;
+    content: string;
+}
+export interface GoogleDocsFindInsertionPointArgs {
+    documentId: string;
+    position: number;
+    searchText?: 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 JiraDiscoverExtendedArgs {
+    query: string;
+    limit?: number;
+}
+export interface JiraExecuteExtendedArgs {
+    operationId: string;
+    pathParams?: any;
+    queryParams?: any;
+    body?: any;
+}
+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 TrelloDiscoverExtendedArgs {
+    query: string;
+    limit?: number;
+}
+export interface TrelloExecuteExtendedArgs {
+    operationId: string;
+    pathParams?: any;
+    queryParams?: any;
+    body?: any;
+}
+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 JupiterRefreshSwapArgs {
+    feedItemId: string;
+    swapId: string;
+    inputMint: string;
+    outputMint: string;
+    amount: number;
+    inputDecimals: number;
+    slippageBps?: number;
+}
+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 CryptoRefreshTransactionArgs {
+    feedItemId: string;
+    transferId: string;
+    recipient: string;
+    token: string;
+    amount: number;
+    tokenMint?: string;
+    tokenDecimals?: number;
+}
+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;
+}
+export interface FeedbackReportBugArgs {
+    title: string;
+    description: string;
+    severity: string;
+    stepsToReproduce?: any[];
+    expectedBehavior?: string;
+    actualBehavior?: string;
+    errorDetails?: any;
+    context?: any;
+    llmAnalysis?: string;
+}
+export interface FeedbackReportToolFailureArgs {
+    adapterType: string;
+    operation: string;
+    errorMessage: string;
+    errorCode?: string;
+    errorStack?: string;
+    args?: any;
+    llmAnalysis?: string;
+    suggestedFix?: string;
+    context?: any;
+}
+export interface FeedbackReportMissingCapabilityArgs {
+    userRequest: string;
+    reason: string;
+    suggestedCapability?: string;
+    relatedAdapters?: any[];
+    context?: any;
+}
+export interface FeedbackSubmitFeedbackArgs {
+    sentiment: string;
+    feedback: string;
+    category?: string;
+    context?: any;
+}
+export interface FeedbackSubmitFeatureRequestArgs {
+    title: string;
+    description: string;
+    useCase?: string;
+    priority?: string;
+}
+export interface MirraMessagingSendMessageArgs {
+    recipientId: string;
+    content: string;
+    automation?: any;
+}
+export interface MirraMessagingSendGroupMessageArgs {
+    groupId: string;
+    content: string;
+    automation?: any;
+}
+export interface MirraMessagingGetContactsArgs {
+    limit?: number;
+    offset?: number;
+}
+export interface MirraMessagingFindContactArgs {
+    query: string;
+}
+export interface MirraMessagingGetChatsArgs {
+    scope?: string;
+    limit?: number;
+}
+export interface MirraMessagingGetGroupsArgs {
+    limit?: number;
+}
+/**
+ * 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>;
+    /**
+     * Get all active flows that are triggered by a specific event type. Used by frontend to show flow selection for targeted execution (e.g., call.action flows).
+     * @param args.eventType - Event type to filter by (e.g., "call.action", "call.ended", "telegram.message")
+     */
+    getFlowsByEventType: (args: FlowsGetFlowsByEventTypeArgs) => 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 with advanced filtering
+     * @param args.query - Search query text for semantic matching
+     * @param args.types - Filter by entity types (e.g., ["TASK", "NOTE", "IDEA"]) (optional)
+     * @param args.startTime - Filter entities created after this timestamp (Unix milliseconds) (optional)
+     * @param args.endTime - Filter entities created before this timestamp (Unix milliseconds) (optional)
+     * @param args.propertyFilters - Filter by entity properties: { status: ["completed"], tags: ["urgent"], priority: ["high"], roles: ["task"], contexts: ["work"] } (optional)
+     * @param args.limit - Maximum number of results (default: 50, max: 100) (optional)
+     */
+    search: (args: MemorySearchArgs) => Promise<any>;
+    /**
+     * Query memory entities with filters. Returns lightweight summaries with normalized fields: id, type, name, description, status, priority, createdAt, updatedAt
+     * @param args.type - Semantic type filter (e.g., "task", "note", "idea", "reminder", "contact", "document"). Matches against meta_item_type, subType, or semantic_roles (optional)
+     * @param args.filters - Additional filters (not yet implemented) (optional)
+     * @param args.limit - Maximum results (default: 50, max: 100). Use smaller limits to get complete results without truncation (optional)
+     * @param args.offset - Pagination offset for fetching more results (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 private chat contacts from Telegram, ordered by most recent activity. Uses the cached chat list filtered for 1:1 conversations.
+     * @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>;
+    /**
+     * 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>;
+    /**
+     * Get a specific calendar event by ID
+     * @param args.eventId - Calendar event ID
+     */
+    getEvent: (args: GoogleCalendarGetEventArgs) => Promise<any>;
+    /**
+     * Update an existing calendar event
+     * @param args.eventId - Calendar event ID to update
+     * @param args.summary - Updated event title/summary (optional)
+     * @param args.description - Updated event description (optional)
+     * @param args.location - Updated event location (optional)
+     * @param args.start - Updated start time object with dateTime and optional timeZone (optional)
+     * @param args.end - Updated end time object with dateTime and optional timeZone (optional)
+     */
+    updateEvent: (args: GoogleCalendarUpdateEventArgs) => Promise<any>;
+    /**
+     * Delete a calendar event
+     * @param args.eventId - Calendar event ID to delete
+     */
+    deleteEvent: (args: GoogleCalendarDeleteEventArgs) => Promise<any>;
+    /**
+     * Search calendar events by text query
+     * @param args.query - Search query to filter events
+     * @param args.timeMin - Start time for events to search (ISO 8601) (optional)
+     * @param args.timeMax - End time for events to search (ISO 8601) (optional)
+     * @param args.maxResults - Maximum number of events to return (default: 50, max: 100) (optional)
+     */
+    searchEvents: (args: GoogleCalendarSearchEventsArgs) => 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>;
+    /**
+     * Download a file from Google Drive. For Google Docs/Sheets, exports as PDF/XLSX. Returns base64-encoded data.
+     * @param args.fileId - ID of the file to download
+     */
+    downloadFile: (args: GoogleDriveDownloadFileArgs) => Promise<any>;
+    /**
+     * Move a file to a different folder
+     * @param args.fileId - ID of the file to move
+     * @param args.folderId - ID of the destination folder
+     */
+    moveFile: (args: GoogleDriveMoveFileArgs) => Promise<any>;
+    /**
+     * Delete a file or folder. By default moves to trash; set permanently=true to delete forever.
+     * @param args.fileId - ID of the file or folder to delete
+     * @param args.permanently - If true, permanently delete instead of moving to trash (default: false) (optional)
+     */
+    deleteFile: (args: GoogleDriveDeleteFileArgs) => Promise<any>;
+    /**
+     * Search for files using Google Drive query syntax
+     * @param args.query - Search query using Drive syntax (e.g., "name contains 'report'", "mimeType='application/pdf'")
+     * @param args.pageSize - Maximum number of files to return (default: 20) (optional)
+     */
+    searchFiles: (args: GoogleDriveSearchFilesArgs) => Promise<any>;
+    /**
+     * Update file metadata (name, description)
+     * @param args.fileId - ID of the file to update
+     * @param args.name - New name for the file (optional)
+     * @param args.description - New description for the file (optional)
+     */
+    updateFile: (args: GoogleDriveUpdateFileArgs) => 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>;
+    /**
+     * Get spreadsheet metadata and properties
+     * @param args.spreadsheetId - ID of the spreadsheet
+     */
+    getSpreadsheet: (args: GoogleSheetsGetSpreadsheetArgs) => Promise<any>;
+    /**
+     * Insert a value at a specific cell with optional formatting
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.cell - Cell reference in format SheetName!A1
+     * @param args.value - Value to insert
+     * @param args.bold - Make text bold (optional)
+     * @param args.italic - Make text italic (optional)
+     * @param args.foregroundColor - Text color (hex or named color) (optional)
+     * @param args.backgroundColor - Cell background color (hex or named color) (optional)
+     */
+    insertAtCell: (args: GoogleSheetsInsertAtCellArgs) => Promise<any>;
+    /**
+     * Insert a formula at a specific cell
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.cell - Cell reference in format SheetName!A1
+     * @param args.formula - Formula to insert (with or without leading =)
+     * @param args.note - Optional note to add to the cell (optional)
+     */
+    insertFormula: (args: GoogleSheetsInsertFormulaArgs) => Promise<any>;
+    /**
+     * Apply formatting to a range of cells
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.range - Range in format SheetName!A1:B10
+     * @param args.bold - Make text bold (optional)
+     * @param args.italic - Make text italic (optional)
+     * @param args.foregroundColor - Text color (hex or named color) (optional)
+     * @param args.backgroundColor - Cell background color (hex or named color) (optional)
+     * @param args.borders - Add borders to cells (optional)
+     */
+    formatRange: (args: GoogleSheetsFormatRangeArgs) => Promise<any>;
+    /**
+     * Create a chart from spreadsheet data
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetId - ID of the sheet containing data
+     * @param args.dataRange - Data range for the chart (e.g., A1:B10)
+     * @param args.chartType - Chart type: BAR, LINE, AREA, PIE, or SCATTER
+     * @param args.title - Chart title
+     * @param args.position - Chart position with row, column, rowCount, columnCount
+     */
+    createChart: (args: GoogleSheetsCreateChartArgs) => Promise<any>;
+    /**
+     * Find and replace text in a spreadsheet
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.findText - Text to find
+     * @param args.replaceText - Text to replace with
+     * @param args.sheetName - Limit search to specific sheet (optional)
+     * @param args.matchCase - Case-sensitive search (optional)
+     * @param args.matchEntireCell - Match entire cell content only (optional)
+     */
+    findAndReplace: (args: GoogleSheetsFindAndReplaceArgs) => Promise<any>;
+    /**
+     * Insert multiple rows of data at once
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetName - Name of the sheet
+     * @param args.rowsData - 2D array of row data to insert
+     * @param args.startingRow - Row number to start insertion (1-indexed). If not provided, appends to end (optional)
+     * @param args.formattingOptions - Optional formatting to apply (bold, italic, foregroundColor, backgroundColor, borders) (optional)
+     */
+    insertMultipleRows: (args: GoogleSheetsInsertMultipleRowsArgs) => Promise<any>;
+    /**
+     * Clear content from a range of cells
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetName - Name of the sheet
+     * @param args.range - Range to clear (e.g., A1:B10)
+     */
+    clearRange: (args: GoogleSheetsClearRangeArgs) => Promise<any>;
+    /**
+     * Insert empty rows at a specific position in a sheet. IMPORTANT: Requires numeric sheetId (get from getSpreadsheet), not sheet name. Row indices are 0-indexed (row 1 in UI = index 0).
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetId - Numeric sheet ID (get from getSpreadsheet response: sheets[0].properties.sheetId). This is NOT the sheet name.
+     * @param args.startRowIndex - Row index to start inserting at (0-indexed). To insert before row 5 in the UI, use index 4.
+     * @param args.numRows - Number of rows to insert
+     */
+    insertRows: (args: GoogleSheetsInsertRowsArgs) => Promise<any>;
+    /**
+     * Delete rows from a sheet. IMPORTANT: Requires numeric sheetId (get from getSpreadsheet), not sheet name. Row indices are 0-indexed (row 1 in UI = index 0).
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetId - Numeric sheet ID (get from getSpreadsheet response: sheets[0].properties.sheetId). This is NOT the sheet name.
+     * @param args.startRowIndex - Row index to start deleting from (0-indexed). To delete row 5 in the UI, use index 4.
+     * @param args.numRows - Number of rows to delete
+     */
+    deleteRows: (args: GoogleSheetsDeleteRowsArgs) => Promise<any>;
+    /**
+     * Insert empty columns at a specific position in a sheet. IMPORTANT: Requires numeric sheetId (get from getSpreadsheet), not sheet name. Column indices are 0-indexed (A=0, B=1, C=2, etc.).
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetId - Numeric sheet ID (get from getSpreadsheet response: sheets[0].properties.sheetId). This is NOT the sheet name.
+     * @param args.startColumnIndex - Column index to start inserting at (0-indexed: A=0, B=1, C=2, D=3, etc.). To insert before column D, use index 3.
+     * @param args.numColumns - Number of columns to insert
+     */
+    insertColumns: (args: GoogleSheetsInsertColumnsArgs) => Promise<any>;
+    /**
+     * Delete columns from a sheet. IMPORTANT: Requires numeric sheetId (get from getSpreadsheet), not sheet name. Column indices are 0-indexed (A=0, B=1, C=2, etc.).
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sheetId - Numeric sheet ID (get from getSpreadsheet response: sheets[0].properties.sheetId). This is NOT the sheet name.
+     * @param args.startColumnIndex - Column index to start deleting from (0-indexed: A=0, B=1, C=2, D=3, etc.). To delete column D, use index 3.
+     * @param args.numColumns - Number of columns to delete
+     */
+    deleteColumns: (args: GoogleSheetsDeleteColumnsArgs) => Promise<any>;
+    /**
+     * Copy data from one range to another location within the same spreadsheet. IMPORTANT: Requires numeric sheetIds (get from getSpreadsheet), not sheet names. Can copy within same sheet or across sheets.
+     * @param args.spreadsheetId - ID of the spreadsheet
+     * @param args.sourceSheetId - Numeric sheet ID of the source sheet (get from getSpreadsheet response: sheets[n].properties.sheetId)
+     * @param args.sourceRange - Source range in A1 notation WITHOUT sheet name (e.g., "A1:C5", not "Sheet1!A1:C5")
+     * @param args.targetSheetId - Numeric sheet ID of the target sheet (can be same as sourceSheetId to copy within same sheet)
+     * @param args.targetStartCell - Target start cell in A1 notation (e.g., "E1"). The copied data will fill cells starting from this position.
+     */
+    copyRange: (args: GoogleSheetsCopyRangeArgs) => 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>;
+    /**
+     * Get the text content of a Google Doc
+     * @param args.documentId - ID of the document
+     */
+    getDocumentContent: (args: GoogleDocsGetDocumentContentArgs) => Promise<any>;
+    /**
+     * Insert text at a specific position in the document
+     * @param args.documentId - ID of the document
+     * @param args.text - Text to insert
+     * @param args.position - Character position to insert at (1-indexed)
+     */
+    insertTextAtPosition: (args: GoogleDocsInsertTextAtPositionArgs) => Promise<any>;
+    /**
+     * Insert text after a search string in the document
+     * @param args.documentId - ID of the document
+     * @param args.searchText - Text to search for
+     * @param args.textToInsert - Text to insert after the search text
+     * @param args.occurrence - Which occurrence to insert after (default: 1) (optional)
+     */
+    insertTextAfter: (args: GoogleDocsInsertTextAfterArgs) => Promise<any>;
+    /**
+     * Insert a heading into the document
+     * @param args.documentId - ID of the document
+     * @param args.text - Heading text
+     * @param args.level - Heading level (1-6)
+     * @param args.position - Character position to insert at (optional)
+     * @param args.insertAfterText - Insert after this text instead of at position (optional)
+     */
+    insertHeading: (args: GoogleDocsInsertHeadingArgs) => Promise<any>;
+    /**
+     * Insert a bulleted or numbered list into the document
+     * @param args.documentId - ID of the document
+     * @param args.items - Array of list items
+     * @param args.listType - Type of list: "bulleted" or "numbered"
+     * @param args.position - Character position to insert at (optional)
+     * @param args.insertAfterText - Insert after this text instead of at position (optional)
+     */
+    insertList: (args: GoogleDocsInsertListArgs) => Promise<any>;
+    /**
+     * Insert a table into the document
+     * @param args.documentId - ID of the document
+     * @param args.data - 2D array of table data (rows x columns)
+     * @param args.hasHeader - Whether the first row is a header (default: true) (optional)
+     * @param args.position - Character position to insert at (optional)
+     * @param args.insertAfterText - Insert after this text instead of at position (optional)
+     */
+    insertTable: (args: GoogleDocsInsertTableArgs) => Promise<any>;
+    /**
+     * Replace the entire content of a document
+     * @param args.documentId - ID of the document
+     * @param args.newContent - New content to replace existing content
+     */
+    updateDocumentContent: (args: GoogleDocsUpdateDocumentContentArgs) => Promise<any>;
+    /**
+     * Create a new section with a heading and content
+     * @param args.documentId - ID of the document
+     * @param args.heading - Section heading text
+     * @param args.content - Section content text
+     */
+    createSection: (args: GoogleDocsCreateSectionArgs) => Promise<any>;
+    /**
+     * Find the character position for insertion based on position or search text
+     * @param args.documentId - ID of the document
+     * @param args.position - Position to find (1 for start, -1 for end)
+     * @param args.searchText - Text to search for (returns position after this text) (optional)
+     */
+    findInsertionPoint: (args: GoogleDocsFindInsertionPointArgs) => 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>;
+    /**
+     * Search Jira API for available operations beyond core tools
+     * @param args.query - Describe what you want to do (e.g., "add label to card")
+     * @param args.limit - Max results to return (default 5) (optional)
+     */
+    discoverExtended: (args: JiraDiscoverExtendedArgs) => Promise<any>;
+    /**
+     * Execute a Jira API operation by operationId
+     * @param args.operationId - The operationId from discoverExtended results
+     * @param args.pathParams - Path parameters, e.g., { id: "abc123" } (optional)
+     * @param args.queryParams - Query string parameters (optional)
+     * @param args.body - Request body for POST/PUT/PATCH operations (optional)
+     */
+    executeExtended: (args: JiraExecuteExtendedArgs) => 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. Must provide either userId OR userName.
+     * @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>;
+    /**
+     * Search Trello API for available operations beyond core tools
+     * @param args.query - Describe what you want to do (e.g., "add label to card")
+     * @param args.limit - Max results to return (default 5) (optional)
+     */
+    discoverExtended: (args: TrelloDiscoverExtendedArgs) => Promise<any>;
+    /**
+     * Execute a Trello API operation by operationId
+     * @param args.operationId - The operationId from discoverExtended results
+     * @param args.pathParams - Path parameters, e.g., { id: "abc123" } (optional)
+     * @param args.queryParams - Query string parameters (optional)
+     * @param args.body - Request body for POST/PUT/PATCH operations (optional)
+     */
+    executeExtended: (args: TrelloExecuteExtendedArgs) => 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>;
+    /**
+     * Refresh an expired swap with new quote and transaction
+     * @param args.feedItemId - Feed item ID containing the swap to refresh
+     * @param args.swapId - Original swap ID
+     * @param args.inputMint - Input token mint address
+     * @param args.outputMint - Output token mint address
+     * @param args.amount - Amount to swap (in UI units)
+     * @param args.inputDecimals - Input token decimals
+     * @param args.slippageBps - Slippage tolerance in basis points (optional)
+     */
+    refreshSwap: (args: JupiterRefreshSwapArgs) => 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>;
+    /**
+     * Refresh an expired transaction with new blockhash and updated details
+     * @param args.feedItemId - Feed item ID containing the transaction to refresh
+     * @param args.transferId - Original transfer ID
+     * @param args.recipient - Recipient address
+     * @param args.token - Token symbol or mint address
+     * @param args.amount - Amount to send
+     * @param args.tokenMint - Token mint address (optional, will resolve if not provided) (optional)
+     * @param args.tokenDecimals - Token decimals (optional) (optional)
+     */
+    refreshTransaction: (args: CryptoRefreshTransactionArgs) => 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>;
+};
+/**
+ * Feedback Adapter
+ * Category: internal
+ */
+declare function createFeedbackAdapter(sdk: MirraSDK): {
+    /**
+     * Report a bug with detailed context and reproduction steps
+     * @param args.title - Brief bug description
+     * @param args.description - Detailed description of the bug
+     * @param args.severity - Bug severity: critical, high, medium, or low
+     * @param args.stepsToReproduce - Steps to reproduce the bug (optional)
+     * @param args.expectedBehavior - What should happen (optional)
+     * @param args.actualBehavior - What actually happens (optional)
+     * @param args.errorDetails - Error details: { message, stack, code } (optional)
+     * @param args.context - Additional context: { conversationId, recentMessages, platform, appVersion } (optional)
+     * @param args.llmAnalysis - LLM analysis of the issue (optional)
+     */
+    reportBug: (args: FeedbackReportBugArgs) => Promise<any>;
+    /**
+     * Auto-report tool or adapter failures for debugging
+     * @param args.adapterType - Adapter type (e.g., jupiter, crypto)
+     * @param args.operation - Operation that failed (e.g., swap, sendToken)
+     * @param args.errorMessage - Error message from the failure
+     * @param args.errorCode - Error code if available (optional)
+     * @param args.errorStack - Error stack trace (optional)
+     * @param args.args - Sanitized arguments that caused the failure (optional)
+     * @param args.llmAnalysis - LLM analysis of why it failed (optional)
+     * @param args.suggestedFix - LLM suggested fix (optional)
+     * @param args.context - Additional context: { conversationId, userId, timestamp } (optional)
+     */
+    reportToolFailure: (args: FeedbackReportToolFailureArgs) => Promise<any>;
+    /**
+     * Report when LLM cannot fulfill a user request
+     * @param args.userRequest - What the user asked for
+     * @param args.reason - Why it could not be fulfilled
+     * @param args.suggestedCapability - What capability would enable this (optional)
+     * @param args.relatedAdapters - Adapters that might be relevant (optional)
+     * @param args.context - Additional context: { conversationId } (optional)
+     */
+    reportMissingCapability: (args: FeedbackReportMissingCapabilityArgs) => Promise<any>;
+    /**
+     * Submit general user feedback
+     * @param args.sentiment - Sentiment: positive, negative, or neutral
+     * @param args.feedback - Feedback content
+     * @param args.category - Category: ux, performance, feature, or general (optional)
+     * @param args.context - Additional context: { feature, screen } (optional)
+     */
+    submitFeedback: (args: FeedbackSubmitFeedbackArgs) => Promise<any>;
+    /**
+     * Submit a feature request
+     * @param args.title - Feature title
+     * @param args.description - Feature description
+     * @param args.useCase - Why the user needs this feature (optional)
+     * @param args.priority - Priority: high, medium, or low (optional)
+     */
+    submitFeatureRequest: (args: FeedbackSubmitFeatureRequestArgs) => Promise<any>;
+};
+/**
+ * Mirra Messaging Adapter
+ * Category: communication
+ */
+declare function createMirraMessagingAdapter(sdk: MirraSDK): {
+    /**
+     * Send a direct message to a contact. The message is sent as the authenticated user with optional automation metadata.
+     * @param args.recipientId - User ID of the recipient (use findContact to look up by username)
+     * @param args.content - Message text content
+     * @param args.automation - Automation metadata: { source: "sdk" | "flow", flowId?: string, flowTitle?: string } (optional)
+     */
+    sendMessage: (args: MirraMessagingSendMessageArgs) => Promise<any>;
+    /**
+     * Send a message to a group chat. The message is sent as the authenticated user with optional automation metadata.
+     * @param args.groupId - Group ID to send the message to
+     * @param args.content - Message text content
+     * @param args.automation - Automation metadata: { source: "sdk" | "flow", flowId?: string, flowTitle?: string } (optional)
+     */
+    sendGroupMessage: (args: MirraMessagingSendGroupMessageArgs) => Promise<any>;
+    /**
+     * Get list of accepted contacts for the user
+     * @param args.limit - Maximum number of contacts to return (default 50) (optional)
+     * @param args.offset - Offset for pagination (default 0) (optional)
+     */
+    getContacts: (args: MirraMessagingGetContactsArgs) => Promise<any>;
+    /**
+     * Find a contact by username or partial name match
+     * @param args.query - Username or name to search for
+     */
+    findContact: (args: MirraMessagingFindContactArgs) => Promise<any>;
+    /**
+     * Get list of chat instances for the user
+     * @param args.scope - Filter by scope: direct, user, group, or all (default all) (optional)
+     * @param args.limit - Maximum number of chats to return (default 50) (optional)
+     */
+    getChats: (args: MirraMessagingGetChatsArgs) => Promise<any>;
+    /**
+     * Get list of groups the user is a member of
+     * @param args.limit - Maximum number of groups to return (default 50) (optional)
+     */
+    getGroups: (args: MirraMessagingGetGroupsArgs) => 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;
+    feedback: typeof createFeedbackAdapter;
+    mirraMessaging: typeof createMirraMessagingAdapter;
+};
+export {};
+//# sourceMappingURL=adapters.d.ts.map