@ganju/utils 0.0.10 → 0.0.12

package/dist/index.d.ts

@@ -18,7 +18,7 @@ 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';
@@ -26,6 +26,8 @@ import type { QueueBatchLike, QueueMessageLike, ProcessQueueBatchHandlers } from
 import type { ExtractedDocument, ExtractedDocumentMetadata, ExtractedDocumentSource } from './extractedDocument';
 import type { ChannelNotifier, ToolStatusEvent } from './channelNotifier';
 import type { BufferedChannelMessage, BufferedChannelCommand, ChannelBufferEnvelope, ChannelBufferFlush } from './channelDebounce';
+import type { PendingToolConfirmation, PendingToolConfirmations, ToolEffect } from './toolConfirmation';
+import type { LintableTool, ToolLintFinding, ToolLintOptions, ToolLintRule } from './toolLint';
 import type { Source, ResourceUrlContext, SourceButton } from './sources';
 import { OAuthReauthRequiredError } from './oauth';
 import type { RefreshOAuthTokenInput, RefreshedOAuthToken } from './oauth';
@@ -54,7 +56,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;
@@ -1067,6 +1070,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<{
@@ -1155,6 +1163,7 @@ export declare const utils: {
                 pattern?: string | undefined;
                 enum?: any[] | undefined;
             } | undefined;
+            effect?: "read" | "write" | "sensitive" | undefined;
             allowedHosts?: string[] | undefined;
         }, {
             name: string;
@@ -1222,6 +1231,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<{
@@ -1291,6 +1301,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<{
@@ -1379,6 +1394,7 @@ export declare const utils: {
                 pattern?: string | undefined;
                 enum?: any[] | undefined;
             } | undefined;
+            effect?: "read" | "write" | "sensitive" | undefined;
             allowedHosts?: string[] | undefined;
         }, {
             name: string;
@@ -1446,6 +1462,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<{
@@ -1528,7 +1545,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;
@@ -1562,6 +1591,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<{
@@ -1598,6 +1633,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<{
@@ -2049,6 +2090,7 @@ export declare const utils: {
         };
         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")[];
@@ -2111,6 +2153,14 @@ 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;
+        MCP_TOOL_CONFIRMATION_TTL_MS: number;
+        MCP_TOOL_CONFIRMATION_ARG: string;
+        MCP_TOOL_CONFIRMATION_ARG_DESCRIPTION: string;
         CHANNEL_DEBOUNCE_DEFAULT_MS: number;
         CHANNEL_DEBOUNCE_MIN_MS: number;
         CHANNEL_DEBOUNCE_MAX_MS: number;
@@ -2143,8 +2193,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;
@@ -2159,6 +2211,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;
@@ -2458,6 +2511,11 @@ export declare const utils: {
     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>;
@@ -2501,91 +2559,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";
@@ -2598,91 +2674,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";
@@ -2695,21 +2789,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";
@@ -2722,6 +2820,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";
@@ -2734,31 +2833,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";
@@ -2771,21 +2876,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";
@@ -2798,11 +2907,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";
@@ -2815,26 +2926,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, 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";
@@ -2847,6 +2963,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";
@@ -2859,6 +2976,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";
@@ -2871,6 +2989,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";
@@ -2883,6 +3002,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")[];
@@ -2935,6 +3055,35 @@ export declare const utils: {
     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"];
+    isSensitiveTool: (annotations: {
+        readOnlyHint?: boolean;
+        destructiveHint?: boolean;
+    } | null | undefined) => boolean;
+    stableJson: (value: unknown) => string;
+    lintTools: (tools: LintableTool[], options?: ToolLintOptions) => ToolLintFinding[];
+    TOOL_LINT_RULES: readonly ["missing-description", "short-description", "no-usage-guidance", "missing-annotations", "undescribed-input", "overlapping-tools", "too-many-tools"];
+    TOOL_LINT_MAX_TOOLS: number;
+    TOOL_LINT_MIN_DESCRIPTION_LENGTH: number;
     isResourceSourceEnabled: (resource: {
         showSource?: string | null;
     } | null | undefined) => boolean;
@@ -2959,5 +3108,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, 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 };
+export type { MintedAccessToken, CustomCodeProject, ProjectPathIssue, CatalogGroup, CatalogTool, CatalogToolDescriptor, ToolAnnotations, PendingToolConfirmation, PendingToolConfirmations, ToolEffect, LintableTool, ToolLintFinding, ToolLintOptions, ToolLintRule, 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