@ganju/utils 0.0.9 → 0.0.11

package/dist/index.d.ts

@@ -14,16 +14,19 @@ import type { CustomCodeTokenPayload } from './customCodeToken';
 import type { ContainmentTokenPayload } from './containmentToken';
 import type { OAuthProviderConfig } from './oauthProviders';
 import type { ExposableResource } from './exposedResource';
+import type { SyncableResource, ResourceSyncProvider } from './syncableResource';
 import type { CustomCodeProject, ProjectPathIssue } from './customCodeProject';
 import type { AttachmentResource, ResolvedAttachment, ResolveAttachmentResult } from './attachment';
 import type { MintedAccessToken } from './accessToken';
-import type { CatalogGroup, CatalogTool, CatalogToolDescriptor, ToolGroupKey, ToolKey } from './toolCatalog';
+import type { CatalogGroup, CatalogTool, CatalogToolDescriptor, ToolAnnotations, ToolGroupKey, ToolKey } from './toolCatalog';
 import type { Separator, ChunkMetadata, PreparedChunk } from './chunking';
+import type { RerankAiBinding } from './resourceRerank';
 import type { RateLimitRetryOptions } from './retry';
 import type { QueueBatchLike, QueueMessageLike, ProcessQueueBatchHandlers } from './processQueueBatch';
 import type { ExtractedDocument, ExtractedDocumentMetadata, ExtractedDocumentSource } from './extractedDocument';
 import type { ChannelNotifier, ToolStatusEvent } from './channelNotifier';
-import type { BufferedChannelMessage, ChannelBufferEnvelope, ChannelBufferFlush } from './channelDebounce';
+import type { BufferedChannelMessage, BufferedChannelCommand, ChannelBufferEnvelope, ChannelBufferFlush } from './channelDebounce';
+import type { PendingToolConfirmation, PendingToolConfirmations, ToolEffect } from './toolConfirmation';
 import type { Source, ResourceUrlContext, SourceButton } from './sources';
 import { OAuthReauthRequiredError } from './oauth';
 import type { RefreshOAuthTokenInput, RefreshedOAuthToken } from './oauth';
@@ -52,7 +55,8 @@ export declare const utils: {
         ORGANIZATION_UPDATE: import("zod").ZodObject<{
             id: import("zod").ZodUUID;
             userId: import("zod").ZodUUID;
-            name: import("zod").ZodString;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            requireToolConfirmation: import("zod").ZodOptional<import("zod").ZodBoolean>;
         }, import("zod/v4/core").$strip>;
         ORGANIZATION_GET: import("zod").ZodObject<{
             id: import("zod").ZodUUID;
@@ -355,18 +359,6 @@ export declare const utils: {
             organizationId: import("zod").ZodUUID;
         }, import("zod/v4/core").$strip>;
         ARTIFACT_CREATE_RESOURCE_VIEW: import("zod").ZodObject<{
-            content: import("zod").ZodOptional<import("zod").ZodString>;
-            type: import("zod").ZodDefault<import("zod").ZodEnum<{
-                static: "static";
-                template: "template";
-            }>>;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            title: import("zod").ZodString;
-            uri: import("zod").ZodString;
-            crawlConfig: import("zod").ZodOptional<import("zod").ZodObject<{
-                maxPages: import("zod").ZodDefault<import("zod").ZodNumber>;
-                maxDepth: import("zod").ZodDefault<import("zod").ZodNumber>;
-            }, import("zod/v4/core").$strip>>;
             mimeType: import("zod").ZodEnum<{
                 "text/plain": "text/plain";
                 "text/csv": "text/csv";
@@ -407,6 +399,19 @@ export declare const utils: {
                 "application/x-perl": "application/x-perl";
                 "application/octet-stream": "application/octet-stream";
             }>;
+            fileName: import("zod").ZodOptional<import("zod").ZodString>;
+            content: import("zod").ZodOptional<import("zod").ZodString>;
+            type: import("zod").ZodDefault<import("zod").ZodEnum<{
+                static: "static";
+                template: "template";
+            }>>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            title: import("zod").ZodString;
+            uri: import("zod").ZodString;
+            crawlConfig: import("zod").ZodOptional<import("zod").ZodObject<{
+                maxPages: import("zod").ZodDefault<import("zod").ZodNumber>;
+                maxDepth: import("zod").ZodDefault<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>>;
             size: import("zod").ZodOptional<import("zod").ZodNumber>;
             sourceType: import("zod").ZodDefault<import("zod").ZodEnum<{
                 FILE: "FILE";
@@ -417,7 +422,6 @@ export declare const utils: {
             }>>;
             encoding: import("zod").ZodOptional<import("zod").ZodString>;
             fileKey: import("zod").ZodOptional<import("zod").ZodString>;
-            fileName: import("zod").ZodOptional<import("zod").ZodString>;
             annotations: import("zod").ZodOptional<import("zod").ZodObject<{
                 audience: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
                     user: "user";
@@ -616,14 +620,6 @@ export declare const utils: {
             organizationId: import("zod").ZodUUID;
         }, import("zod/v4/core").$strip>;
         ARTIFACT_UPDATE_RESOURCE_VIEW: import("zod").ZodObject<{
-            content: import("zod").ZodOptional<import("zod").ZodString>;
-            type: import("zod").ZodDefault<import("zod").ZodEnum<{
-                static: "static";
-                template: "template";
-            }>>;
-            description: import("zod").ZodOptional<import("zod").ZodString>;
-            title: import("zod").ZodString;
-            uri: import("zod").ZodString;
             mimeType: import("zod").ZodEnum<{
                 "text/plain": "text/plain";
                 "text/csv": "text/csv";
@@ -664,6 +660,15 @@ export declare const utils: {
                 "application/x-perl": "application/x-perl";
                 "application/octet-stream": "application/octet-stream";
             }>;
+            fileName: import("zod").ZodOptional<import("zod").ZodString>;
+            content: import("zod").ZodOptional<import("zod").ZodString>;
+            type: import("zod").ZodDefault<import("zod").ZodEnum<{
+                static: "static";
+                template: "template";
+            }>>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            title: import("zod").ZodString;
+            uri: import("zod").ZodString;
             size: import("zod").ZodOptional<import("zod").ZodNumber>;
             sourceType: import("zod").ZodDefault<import("zod").ZodEnum<{
                 FILE: "FILE";
@@ -674,7 +679,6 @@ export declare const utils: {
             }>>;
             encoding: import("zod").ZodOptional<import("zod").ZodString>;
             fileKey: import("zod").ZodOptional<import("zod").ZodString>;
-            fileName: import("zod").ZodOptional<import("zod").ZodString>;
             annotations: import("zod").ZodOptional<import("zod").ZodObject<{
                 audience: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
                     user: "user";
@@ -981,6 +985,23 @@ export declare const utils: {
             userId: import("zod").ZodUUID;
             organizationId: import("zod").ZodUUID;
         }, import("zod/v4/core").$strip>;
+        ARTIFACT_UPDATE_RESOURCE_SYNC_INTERVAL: import("zod").ZodObject<{
+            resourceId: import("zod").ZodUUID;
+            syncInterval: import("zod").ZodEnum<{
+                off: "off";
+                daily: "daily";
+                weekly: "weekly";
+            }>;
+            projectId: import("zod").ZodUUID;
+            userId: import("zod").ZodUUID;
+            organizationId: import("zod").ZodUUID;
+        }, import("zod/v4/core").$strip>;
+        ARTIFACT_SYNC_RESOURCE: import("zod").ZodObject<{
+            resourceId: import("zod").ZodUUID;
+            projectId: import("zod").ZodUUID;
+            userId: import("zod").ZodUUID;
+            organizationId: import("zod").ZodUUID;
+        }, import("zod/v4/core").$strip>;
         HTTP_ENDPOINT_CONFIG: import("zod").ZodPipe<import("zod").ZodObject<{
             name: import("zod").ZodString;
             title: import("zod").ZodOptional<import("zod").ZodString>;
@@ -1048,6 +1069,11 @@ export declare const utils: {
                 jsonPath: import("zod").ZodOptional<import("zod").ZodString>;
                 successStatus: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
             }, import("zod/v4/core").$strip>>;
+            effect: import("zod").ZodOptional<import("zod").ZodEnum<{
+                read: "read";
+                write: "write";
+                sensitive: "sensitive";
+            }>>;
             auth: import("zod").ZodDefault<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
                 kind: import("zod").ZodLiteral<"none">;
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -1136,6 +1162,7 @@ export declare const utils: {
                 pattern?: string | undefined;
                 enum?: any[] | undefined;
             } | undefined;
+            effect?: "read" | "write" | "sensitive" | undefined;
             allowedHosts?: string[] | undefined;
         }, {
             name: string;
@@ -1203,6 +1230,7 @@ export declare const utils: {
                 pattern?: string | undefined;
                 enum?: any[] | undefined;
             } | undefined;
+            effect?: "read" | "write" | "sensitive" | undefined;
             allowedHosts?: string[] | undefined;
         }>>;
         HTTP_ENDPOINT_CONFIG_WRITE: import("zod").ZodPipe<import("zod").ZodObject<{
@@ -1272,6 +1300,11 @@ export declare const utils: {
                 jsonPath: import("zod").ZodOptional<import("zod").ZodString>;
                 successStatus: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodNumber>>;
             }, import("zod/v4/core").$strip>>;
+            effect: import("zod").ZodOptional<import("zod").ZodEnum<{
+                read: "read";
+                write: "write";
+                sensitive: "sensitive";
+            }>>;
             auth: import("zod").ZodDefault<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
                 kind: import("zod").ZodLiteral<"none">;
             }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -1360,6 +1393,7 @@ export declare const utils: {
                 pattern?: string | undefined;
                 enum?: any[] | undefined;
             } | undefined;
+            effect?: "read" | "write" | "sensitive" | undefined;
             allowedHosts?: string[] | undefined;
         }, {
             name: string;
@@ -1427,6 +1461,7 @@ export declare const utils: {
                 pattern?: string | undefined;
                 enum?: any[] | undefined;
             } | undefined;
+            effect?: "read" | "write" | "sensitive" | undefined;
             allowedHosts?: string[] | undefined;
         }>>;
         MCP_PROXY_CONFIG: import("zod").ZodObject<{
@@ -1509,7 +1544,19 @@ export declare const utils: {
                 pattern: import("zod").ZodOptional<import("zod").ZodString>;
                 enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodAny>>;
             }, import("zod/v4/core").$strip>>;
-        }, import("zod/v4/core").$strip>;
+            annotations: import("zod").ZodOptional<import("zod").ZodObject<{
+                readOnlyHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                destructiveHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                idempotentHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                openWorldHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            }, import("zod/v4/core").$strict>>;
+        }, import("zod/v4/core").$strip>;
+        TOOL_ANNOTATIONS: import("zod").ZodObject<{
+            readOnlyHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            destructiveHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            idempotentHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+            openWorldHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strict>;
         CUSTOM_CODE_MANIFEST: import("zod").ZodObject<{
             tools: import("zod").ZodArray<import("zod").ZodObject<{
                 name: import("zod").ZodString;
@@ -1543,6 +1590,12 @@ export declare const utils: {
                     pattern: import("zod").ZodOptional<import("zod").ZodString>;
                     enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodAny>>;
                 }, import("zod/v4/core").$strip>>;
+                annotations: import("zod").ZodOptional<import("zod").ZodObject<{
+                    readOnlyHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    destructiveHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    idempotentHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    openWorldHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                }, import("zod/v4/core").$strict>>;
             }, import("zod/v4/core").$strip>>;
         }, import("zod/v4/core").$strip>;
         ARTIFACT_CUSTOM_CODE_CREATE_VERSION: import("zod").ZodObject<{
@@ -1579,6 +1632,12 @@ export declare const utils: {
                         pattern: import("zod").ZodOptional<import("zod").ZodString>;
                         enum: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodAny>>;
                     }, import("zod/v4/core").$strip>>;
+                    annotations: import("zod").ZodOptional<import("zod").ZodObject<{
+                        readOnlyHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        destructiveHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        idempotentHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                        openWorldHint: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                    }, import("zod/v4/core").$strict>>;
                 }, import("zod/v4/core").$strip>>;
             }, import("zod/v4/core").$strip>;
             config: import("zod").ZodOptional<import("zod").ZodObject<{
@@ -1813,6 +1872,7 @@ export declare const utils: {
         PLAN_FEATURE_EMBEDDED_STORAGE: "embeddedStorage";
         PLAN_FEATURE_MESSAGE: "message";
         PLAN_FEATURE_TOOL_CALL: "toolCall";
+        PLAN_FEATURE_RESOURCE_SYNC: "resourceSync";
         PLAN_LIMIT_ERROR_CODE: string;
         BILLING_METER_MESSAGES: string;
         BILLING_METER_SHARED_MESSAGES: string;
@@ -2018,6 +2078,18 @@ export declare const utils: {
         RESOURCE_SOURCE_TYPE_ONE_DRIVE_FOLDER: "ONE_DRIVE_FOLDER";
         RESOURCE_SOURCE_TYPE_CUSTOM_CODE: "CUSTOM_CODE";
         RESOURCE_SOURCE_TYPES: ("FILE" | "WEBSITE" | "GOOGLE_DRIVE_FOLDER" | "ONE_DRIVE_FOLDER" | "CUSTOM_CODE")[];
+        RESOURCE_SYNC_INTERVAL_OFF: "off";
+        RESOURCE_SYNC_INTERVAL_DAILY: "daily";
+        RESOURCE_SYNC_INTERVAL_WEEKLY: "weekly";
+        RESOURCE_SYNC_INTERVALS: readonly ["off", "daily", "weekly"];
+        RESOURCE_SYNC_INTERVAL_DEFAULT: "weekly";
+        RESOURCE_SYNC_INTERVAL_MS: {
+            readonly daily: number;
+            readonly weekly: number;
+        };
+        RESOURCE_SYNC_BATCH_SIZE: number;
+        RESOURCE_SYNC_MANUAL_COOLDOWN_MS: number;
+        RESOURCE_SYNC_STALE_MS: number;
         CRAWL_RENDERER_CHEERIO: "cheerio";
         CRAWL_RENDERER_PLAYWRIGHT: "playwright";
         CRAWL_RENDERERS: ("cheerio" | "playwright")[];
@@ -2080,6 +2152,11 @@ export declare const utils: {
         SHARED_KEY_HISTORY_LIMIT: number;
         SHARED_KEY_MAX_TOOL_LOOPS: number;
         CHANNEL_MAX_TOOLS: number;
+        TOOL_CONFIRMATION_TTL_MS: number;
+        TOOL_CONFIRMATION_REQUIRED_RESULT: string;
+        TOOL_CONFIRMATION_FALLBACK_QUESTION: string;
+        TOOL_CONFIRMATION_ASK_INSTRUCTION: string;
+        TOOL_CONFIRMATION_SYSTEM_NOTE: string;
         CHANNEL_DEBOUNCE_DEFAULT_MS: number;
         CHANNEL_DEBOUNCE_MIN_MS: number;
         CHANNEL_DEBOUNCE_MAX_MS: number;
@@ -2112,8 +2189,10 @@ export declare const utils: {
         DISCORD_TIMESTAMP_HEADER: string;
         DISCORD_INTERACTION_TYPE_PING: number;
         DISCORD_INTERACTION_TYPE_APPLICATION_COMMAND: number;
+        DISCORD_INTERACTION_TYPE_MESSAGE_COMPONENT: number;
         DISCORD_INTERACTION_RESPONSE_PONG: number;
         DISCORD_INTERACTION_RESPONSE_DEFERRED: number;
+        DISCORD_INTERACTION_RESPONSE_UPDATE_MESSAGE: number;
         DISCORD_CHANNEL_TYPE_DM: number;
         DISCORD_CHANNEL_TYPE_GROUP_DM: number;
         DISCORD_GATEWAY_OP_DISPATCH: number;
@@ -2128,6 +2207,7 @@ export declare const utils: {
         WHATSAPP_API_BASE: string;
         WHATSAPP_API_VERSION: string;
         WHATSAPP_MESSAGE_LIMIT: number;
+        WHATSAPP_INTERACTIVE_BODY_LIMIT: number;
         WHATSAPP_SIGNATURE_HEADER: string;
         WHATSAPP_SIGNATURE_PREFIX: string;
         WHATSAPP_HUB_MODE_PARAM: string;
@@ -2143,6 +2223,12 @@ export declare const utils: {
         CHUNK_TARGET_CHARS: number;
         CHUNK_OVERLAP_CHARS: number;
         EMBED_BATCH_SIZE: number;
+        RESOURCE_SEARCH_CANDIDATES: number;
+        RESOURCE_SEARCH_RRF_K: number;
+        RESOURCE_SEARCH_COMMON_TERM_DIVISOR: number;
+        RESOURCE_SEARCH_COMMON_TERM_MIN: number;
+        RESOURCE_SEARCH_RERANK_CANDIDATES: number;
+        RESOURCE_SEARCH_RERANK_MODEL: string;
         RESOURCE_HANDLER_SLEEP_AFTER: string;
         DOCS_URL: string;
         BASE64_DATA_URI_RE: RegExp;
@@ -2420,6 +2506,13 @@ export declare const utils: {
     oauthProviders: Record<string, OAuthProviderConfig>;
     resolveAttachment: (resource: AttachmentResource, readObject: (key: string) => Promise<ArrayBuffer | null>, verb?: "attach" | "upload") => Promise<ResolveAttachmentResult>;
     isExposedResource: (resource: ExposableResource) => boolean;
+    isSyncableResource: (resource: SyncableResource) => boolean;
+    isResourceSyncInProgress: (resource: {
+        status: string;
+        syncStartedAt?: Date | string | null;
+        createdAt: Date | string;
+    }, now?: number) => boolean;
+    resourceSyncProvider: (resource: SyncableResource) => ResourceSyncProvider | null;
     describeVendorError: (body: unknown, fallback: string) => string;
     withDeadline: <T>(work: Promise<T>, ms: number) => Promise<T>;
     isDeadlineError: (error: unknown) => boolean;
@@ -2462,91 +2555,109 @@ export declare const utils: {
             readonly title: "Batch Modify Labels";
             readonly description: "Add or remove labels on many emails at once (archive, mark read, etc.).";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.modify";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-create-draft";
             readonly title: "Create Draft";
             readonly description: "Save a new draft in Gmail without sending it yet.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.compose";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-delete-draft";
             readonly title: "Delete Draft";
             readonly description: "Permanently delete a draft.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.compose";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-forward-email";
             readonly title: "Forward Email";
             readonly description: "Forward an email to a new recipient.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-get-draft";
             readonly title: "Get Draft";
             readonly description: "Open a saved draft to review its contents.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.compose";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-get-profile";
             readonly title: "Get Profile";
             readonly description: "Show the email address and inbox stats for the connected Gmail account.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-get-thread";
             readonly title: "Get Thread";
             readonly description: "See every message inside one conversation.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-list-drafts";
             readonly title: "List Drafts";
             readonly description: "Browse your saved drafts.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.compose";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-list-emails";
             readonly title: "List Emails";
             readonly description: "Browse your Gmail inbox, with optional search filters.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-list-labels";
             readonly title: "List Labels";
             readonly description: "See all of your Gmail labels and folders.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.labels";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-list-threads";
             readonly title: "List Threads";
             readonly description: "List your Gmail conversations.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-modify-labels";
             readonly title: "Modify Labels";
             readonly description: "Add or remove labels on a single email — archive it, mark it read, star it, and more.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.modify";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-read-email";
             readonly title: "Read Email";
             readonly description: "Open and read a specific email.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-reply-email";
             readonly title: "Reply Email";
             readonly description: "Reply to an email so the response stays in the same conversation.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-send-draft";
             readonly title: "Send Draft";
             readonly description: "Send a draft you've already saved.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-send-email";
             readonly title: "Send Email";
             readonly description: "Compose and send a new email from your connected Gmail account.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-trash-email";
             readonly title: "Move to Trash";
             readonly description: "Move an email to Trash. It stays recoverable for 30 days.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.modify";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "gmail-update-draft";
             readonly title: "Update Draft";
             readonly description: "Edit the contents of a saved draft.";
             readonly requiredScopes: "https://www.googleapis.com/auth/gmail.compose";
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "outlook";
@@ -2559,91 +2670,109 @@ export declare const utils: {
             readonly title: "Batch Move Messages";
             readonly description: "Move up to 20 messages to the same folder.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.ReadWrite";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-create-draft";
             readonly title: "Create Draft";
             readonly description: "Create a draft email saved in Drafts.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.ReadWrite";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-delete-draft";
             readonly title: "Delete Draft";
             readonly description: "Permanently delete a draft.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.ReadWrite";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-forward-email";
             readonly title: "Forward";
             readonly description: "Forward an existing message to a new recipient.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-get-draft";
             readonly title: "Get Draft";
             readonly description: "Read the full contents of a draft.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-get-profile";
             readonly title: "Get Profile";
             readonly description: "Get the connected account's profile and inbox totals.";
             readonly requiredScopes: "https://graph.microsoft.com/User.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-get-thread";
             readonly title: "Get Thread";
             readonly description: "Get summaries of every message in a conversation.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-list-drafts";
             readonly title: "List Drafts";
             readonly description: "List drafts in the Drafts folder.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-list-emails";
             readonly title: "List Emails";
             readonly description: "List inbox messages, optionally filtered by search.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-list-folders";
             readonly title: "List Folders";
             readonly description: "List every mail folder on the account.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-list-threads";
             readonly title: "List Threads";
             readonly description: "List inbox conversation threads.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-move-message";
             readonly title: "Move Message";
             readonly description: "Move a message to a different folder.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.ReadWrite";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-read-email";
             readonly title: "Read Email";
             readonly description: "Read the full contents of one message by ID.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-reply-email";
             readonly title: "Reply";
             readonly description: "Reply to an existing message, preserving the conversation.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-send-draft";
             readonly title: "Send Draft";
             readonly description: "Send an existing draft as-is.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-send-email";
             readonly title: "Send Email";
             readonly description: "Send a brand-new email from the connected account.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.Send";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-trash-email";
             readonly title: "Move to Trash";
             readonly description: "Move a message to the Deleted Items folder.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.ReadWrite";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "outlook-update-draft";
             readonly title: "Update Draft";
             readonly description: "Replace the contents of an existing draft.";
             readonly requiredScopes: "https://graph.microsoft.com/Mail.ReadWrite";
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "slack";
@@ -2656,21 +2785,25 @@ export declare const utils: {
             readonly title: "Get User";
             readonly description: "Look up a Slack user by ID or email.";
             readonly requiredScopes: "users:read,users:read.email";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "slack-list-channels";
             readonly title: "List Channels";
             readonly description: "Browse the channels and DMs the agent can see.";
             readonly requiredScopes: "channels:read,groups:read,mpim:read,im:read";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "slack-send-message";
             readonly title: "Send Message";
             readonly description: "Post a message to a Slack channel, DM, or thread.";
             readonly requiredScopes: "chat:write";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "slack-upload-file";
             readonly title: "Upload File";
             readonly description: "Upload a stored resource into a Slack channel.";
             readonly requiredScopes: "files:write,chat:write";
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "slack-user";
@@ -2683,6 +2816,7 @@ export declare const utils: {
             readonly title: "Search Messages";
             readonly description: "Search messages across the workspace. Requires a Slack user token (xoxp).";
             readonly requiredScopes: "search:read";
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "google-calendar";
@@ -2695,31 +2829,37 @@ export declare const utils: {
             readonly title: "Create Event";
             readonly description: "Add a new event to a calendar.";
             readonly requiredScopes: "https://www.googleapis.com/auth/calendar.events";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calendar-delete-event";
             readonly title: "Delete Event";
             readonly description: "Permanently remove an event from a calendar.";
             readonly requiredScopes: "https://www.googleapis.com/auth/calendar.events";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calendar-find-free-slots";
             readonly title: "Find Free Slots";
             readonly description: "Find open time gaps on a calendar.";
             readonly requiredScopes: "https://www.googleapis.com/auth/calendar.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calendar-list-calendars";
             readonly title: "List Calendars";
             readonly description: "See all calendars on the connected Google account.";
             readonly requiredScopes: "https://www.googleapis.com/auth/calendar.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calendar-list-events";
             readonly title: "List Events";
             readonly description: "Browse events on a calendar within a time range.";
             readonly requiredScopes: "https://www.googleapis.com/auth/calendar.readonly";
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calendar-update-event";
             readonly title: "Update Event";
             readonly description: "Change the details of an existing event.";
             readonly requiredScopes: "https://www.googleapis.com/auth/calendar.events";
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "calcom";
@@ -2732,21 +2872,25 @@ export declare const utils: {
             readonly title: "Cancel Booking";
             readonly description: "Cancel an existing booking by its UID.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calcom-create-booking";
             readonly title: "Create Booking";
             readonly description: "Book an available slot for an attendee.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calcom-list-available-slots";
             readonly title: "List Available Slots";
             readonly description: "Find open booking times for an event type in a date range.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "calcom-list-event-types";
             readonly title: "List Event Types";
             readonly description: "See the bookable meeting types on the connected Cal.com account.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "web";
@@ -2759,11 +2903,13 @@ export declare const utils: {
             readonly title: "Web Extract";
             readonly description: "Fetch the full cleaned text of specific web pages by URL for in-depth reading.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "web-search";
             readonly title: "Web Search";
             readonly description: "Search the live web and return the top results plus a synthesized answer so the model can cite sources.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "builtin";
@@ -2776,26 +2922,31 @@ export declare const utils: {
             readonly title: "List Prompts";
             readonly description: "List the prompts and commands this assistant exposes, and how to run them on the current channel.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "list-resources";
             readonly title: "List Resources";
             readonly description: "List every resource available to this assistant.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "read-resource";
             readonly title: "Read Resource";
             readonly description: "Read the contents of a stored resource.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "search-resources";
             readonly title: "Search Resources";
-            readonly description: "Find the resources most relevant to a question using semantic search.";
+            readonly description: "Find the resources most relevant to a question, by meaning and by exact keywords.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }, {
             readonly key: "send-resource";
             readonly title: "Send Resource";
             readonly description: "Deliver a resource to the user as a chat attachment.";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "greeting";
@@ -2808,6 +2959,7 @@ export declare const utils: {
             readonly title: "Greeting";
             readonly description: "Reply with a friendly hello in English or Spanish (demo tool).";
             readonly requiredScopes: null;
+            readonly annotations: ToolAnnotations;
         }];
     }, {
         readonly key: "http-endpoint";
@@ -2820,6 +2972,7 @@ export declare const utils: {
             readonly title: "HTTP Endpoint";
             readonly description: "A user-configured HTTP request exposed to the agent as its own named tool.";
             readonly requiredScopes: null;
+            readonly annotations: null;
         }];
     }, {
         readonly key: "mcp-proxy";
@@ -2832,6 +2985,7 @@ export declare const utils: {
             readonly title: "MCP Server";
             readonly description: "A connected remote MCP server. Each server you add exposes its tools to the agent under a vendor prefix.";
             readonly requiredScopes: null;
+            readonly annotations: null;
         }];
     }, {
         readonly key: "custom-code";
@@ -2844,6 +2998,7 @@ export declare const utils: {
             readonly title: "Custom code";
             readonly description: "Tools implemented by your own code. One script per artifact; names and schemas come from the published version.";
             readonly requiredScopes: null;
+            readonly annotations: null;
         }];
     }];
     TOOL_KEYS: ("custom-code" | "list-resources" | "search-resources" | "read-resource" | "send-resource" | "list-prompts" | "calendar-list-calendars" | "calendar-create-event" | "calendar-find-free-slots" | "http-endpoint" | "mcp-proxy" | "web-search" | "web-extract" | "greeting" | "gmail-send-email" | "gmail-reply-email" | "gmail-forward-email" | "gmail-send-draft" | "gmail-create-draft" | "gmail-update-draft" | "gmail-delete-draft" | "gmail-trash-email" | "gmail-modify-labels" | "gmail-batch-modify-labels" | "outlook-send-email" | "outlook-reply-email" | "outlook-forward-email" | "outlook-send-draft" | "outlook-create-draft" | "outlook-update-draft" | "outlook-delete-draft" | "outlook-trash-email" | "outlook-move-message" | "outlook-batch-move-messages" | "gmail-get-draft" | "gmail-get-profile" | "gmail-get-thread" | "gmail-list-drafts" | "gmail-list-emails" | "gmail-list-labels" | "gmail-list-threads" | "gmail-read-email" | "outlook-get-draft" | "outlook-get-profile" | "outlook-get-thread" | "outlook-list-drafts" | "outlook-list-emails" | "outlook-list-folders" | "outlook-list-threads" | "outlook-read-email" | "slack-get-user" | "slack-list-channels" | "slack-send-message" | "slack-upload-file" | "slack-search-messages" | "calendar-delete-event" | "calendar-list-events" | "calendar-update-event" | "calcom-cancel-booking" | "calcom-create-booking" | "calcom-list-available-slots" | "calcom-list-event-types")[];
@@ -2879,9 +3034,12 @@ export declare const utils: {
     prepareChunks: (header: string, documents: ExtractedDocument[] | null, fallbackContent: string | null, options?: {
         targetChars?: number;
         overlapChars?: number;
+        mimeType?: string | null;
+        fileName?: string | null;
     }) => PreparedChunk[];
     isEmbeddableMimeType: (mimeType: string) => boolean;
     l2Normalize: (values: number[]) => number[];
+    createResourceReranker: (source: EnvSource) => ((query: string, documents: string[]) => Promise<number[] | null>) | undefined;
     sleep: (ms: number) => Promise<void>;
     isRateLimitError: (err: unknown) => boolean;
     withRateLimitRetry: <T>(fn: () => Promise<T>, options?: RateLimitRetryOptions) => Promise<T>;
@@ -2889,9 +3047,30 @@ export declare const utils: {
     getToolStatusMessage: (toolName: string) => string | null;
     resolveDebounceMs: (config: unknown) => number;
     channelBufferKey: (channelId: string, externalConversationId: string, externalParticipantId: string) => string;
+    batchCommand: (messages: BufferedChannelMessage[]) => BufferedChannelCommand | null;
     joinBufferedMessages: (messages: Array<{
         text: string;
     }>) => string;
+    isConfirmationReply: (text: string) => boolean;
+    confirmationButtonLabels: (locale?: string | null) => {
+        yes: string;
+        no: string;
+    };
+    confirmationButtonId: (answer: "yes" | "no", externalParticipantId: string) => string;
+    parseConfirmationButton: (id: string) => {
+        text: "yes" | "no";
+        externalParticipantId: string;
+    } | null;
+    languageFromPhoneNumber: (phone: string) => string | null;
+    formatConfirmationSummary: (calls: Array<{
+        name: string;
+        arguments: Record<string, unknown>;
+    }>, titleOf: (name: string) => string) => string;
+    annotationsForEffect: (effect: ToolEffect) => {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+    };
+    TOOL_EFFECTS: readonly ["read", "write", "sensitive"];
     isResourceSourceEnabled: (resource: {
         showSource?: string | null;
     } | null | undefined) => boolean;
@@ -2916,5 +3095,5 @@ export declare const utils: {
     PlanLimitError: typeof PlanLimitError;
     isPlanLimitError: (error: unknown) => error is PlanLimitError;
 };
-export type { MintedAccessToken, CustomCodeProject, ProjectPathIssue, CatalogGroup, CatalogTool, CatalogToolDescriptor, ToolGroupKey, ToolKey, CalendarConfigField, JsonSchema, SchemaViolation, MimeAttachment, MimeMessageInput, GmailOperation, GmailSendRequest, GmailSendResponse, OutlookOperation, OutlookSendRequest, OutlookSendResponse, SlackOperation, SlackSendRequest, SlackSendResponse, SlackSendRemoteResourceRequest, TelegramSendRequest, TelegramSendResponse, TelegramSendRemoteResourceRequest, DiscordSendRequest, DiscordSendResponse, DiscordSendRemoteResourceRequest, WhatsappSendRequest, WhatsappSendResponse, WhatsappSendRemoteResourceRequest, EnvSource, Separator, ChunkMetadata, PreparedChunk, ExtractedDocument, ExtractedDocumentMetadata, ExtractedDocumentSource, RateLimitRetryOptions, QueueBatchLike, QueueMessageLike, ProcessQueueBatchHandlers, ChannelNotifier, ToolStatusEvent, BufferedChannelMessage, ChannelBufferEnvelope, ChannelBufferFlush, Source, ResourceUrlContext, SourceButton, RefreshOAuthTokenInput, RefreshedOAuthToken, HttpEndpointToolConfig, McpProxyToolConfig, McpProxyDiscoveredTool, McpProxyDiscoveredResource, McpProxyDiscoveredPrompt, McpProxyDiscovery, CustomCodeToolConfig, CustomCodeToolManifest, CustomCodeManifest, CustomCodeSendFile, CustomCodeCreateResource, CustomCodeTokenPayload, ContainmentTokenPayload, OAuthProviderConfig, AttachmentResource, ResolvedAttachment, ResolveAttachmentResult, ExposableResource, PlanLimitDetails, PlanLimits };
+export type { MintedAccessToken, CustomCodeProject, ProjectPathIssue, CatalogGroup, CatalogTool, CatalogToolDescriptor, ToolAnnotations, PendingToolConfirmation, PendingToolConfirmations, ToolEffect, ToolGroupKey, ToolKey, CalendarConfigField, JsonSchema, SchemaViolation, MimeAttachment, MimeMessageInput, GmailOperation, GmailSendRequest, GmailSendResponse, OutlookOperation, OutlookSendRequest, OutlookSendResponse, SlackOperation, SlackSendRequest, SlackSendResponse, SlackSendRemoteResourceRequest, TelegramSendRequest, TelegramSendResponse, TelegramSendRemoteResourceRequest, DiscordSendRequest, DiscordSendResponse, DiscordSendRemoteResourceRequest, WhatsappSendRequest, WhatsappSendResponse, WhatsappSendRemoteResourceRequest, EnvSource, Separator, ChunkMetadata, PreparedChunk, ExtractedDocument, ExtractedDocumentMetadata, ExtractedDocumentSource, RateLimitRetryOptions, RerankAiBinding, QueueBatchLike, QueueMessageLike, ProcessQueueBatchHandlers, ChannelNotifier, ToolStatusEvent, BufferedChannelMessage, BufferedChannelCommand, ChannelBufferEnvelope, ChannelBufferFlush, Source, ResourceUrlContext, SourceButton, RefreshOAuthTokenInput, RefreshedOAuthToken, HttpEndpointToolConfig, McpProxyToolConfig, McpProxyDiscoveredTool, McpProxyDiscoveredResource, McpProxyDiscoveredPrompt, McpProxyDiscovery, CustomCodeToolConfig, CustomCodeToolManifest, CustomCodeManifest, CustomCodeSendFile, CustomCodeCreateResource, CustomCodeTokenPayload, ContainmentTokenPayload, OAuthProviderConfig, AttachmentResource, ResolvedAttachment, ResolveAttachmentResult, ExposableResource, SyncableResource, ResourceSyncProvider, PlanLimitDetails, PlanLimits };
 //# sourceMappingURL=index.d.ts.map