attio-mcp 1.0.0 → 1.1.0

package/dist/prompts/v1/qualify-lead.v1.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Qualify Lead v1 Prompt
+ *
+ * Resolve lead, scan 2-3 web sources, return BANT/CHAMP summary with evidence,
+ * propose next actions.
+ */
+import { z } from 'zod';
+import { PromptV1Definition, PromptMessage, PromptArgument } from './types.js';
+/**
+ * Argument schema for qualify_lead.v1
+ */
+export declare const QualifyLeadArgs: z.ZodObject<{
+    target: z.ZodString;
+    icp_preset: z.ZodOptional<z.ZodString>;
+    framework: z.ZodDefault<z.ZodOptional<z.ZodEnum<["bant", "champ"]>>>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["json", "table"]>>>;
+    verbosity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["brief", "normal"]>>>;
+    dry_run: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    limit_web: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    format: "json" | "table";
+    target: string;
+    verbosity: "brief" | "normal";
+    dry_run: boolean;
+    framework: "bant" | "champ";
+    limit_web: number;
+    icp_preset?: string | undefined;
+}, {
+    target: string;
+    format?: "json" | "table" | undefined;
+    verbosity?: "brief" | "normal" | undefined;
+    dry_run?: boolean | undefined;
+    icp_preset?: string | undefined;
+    framework?: "bant" | "champ" | undefined;
+    limit_web?: number | undefined;
+}>;
+export type QualifyLeadArgsType = z.infer<typeof QualifyLeadArgs>;
+/**
+ * Argument definitions for registration
+ */
+export declare const qualifyLeadArguments: PromptArgument[];
+/**
+ * Build prompt messages for qualifying lead
+ */
+export declare function buildQualifyLeadMessages(args: Record<string, unknown>): PromptMessage[];
+/**
+ * Complete prompt definition
+ */
+export declare const qualifyLeadPrompt: PromptV1Definition;
+export default qualifyLeadPrompt;
+//# sourceMappingURL=qualify-lead.v1.d.ts.map

package/dist/prompts/v1/qualify-lead.v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualify-lead.v1.d.ts","sourceRoot":"","sources":["../../../src/prompts/v1/qualify-lead.v1.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI/E;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;EAmC1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAAc,EAgDhD,CAAC;AAEF;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,aAAa,EAAE,CAyCjB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAY/B,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/prompts/v1/qualify-lead.v1.js

@@ -0,0 +1,157 @@
+/**
+ * Qualify Lead v1 Prompt
+ *
+ * Resolve lead, scan 2-3 web sources, return BANT/CHAMP summary with evidence,
+ * propose next actions.
+ */
+import { z } from 'zod';
+import { DryRunArg } from './types.js';
+import { WEB_RESEARCH_LIMITS } from './constants.js';
+/**
+ * Argument schema for qualify_lead.v1
+ */
+export const QualifyLeadArgs = z.object({
+    target: z
+        .string()
+        .min(3)
+        .describe('Attio Person/Company/Deal URL or ID, or "search:<text>"'),
+    icp_preset: z
+        .string()
+        .optional()
+        .describe("Optional ICP preset (e.g., 'SaaS mid-market NA')"),
+    framework: z
+        .enum(['bant', 'champ'])
+        .optional()
+        .default('bant')
+        .describe('Qualification framework'),
+    format: z
+        .enum(['json', 'table'])
+        .optional()
+        .default('json')
+        .describe('Output format'),
+    verbosity: z
+        .enum(['brief', 'normal'])
+        .optional()
+        .default('brief')
+        .describe('Response detail level'),
+    dry_run: DryRunArg,
+    limit_web: z
+        .number()
+        .int()
+        .min(1)
+        .max(WEB_RESEARCH_LIMITS.maxLimitWeb)
+        .optional()
+        .default(WEB_RESEARCH_LIMITS.defaultLimitWeb)
+        .describe(`Max pages to fetch (default ${WEB_RESEARCH_LIMITS.defaultLimitWeb}, max ${WEB_RESEARCH_LIMITS.maxLimitWeb})`),
+});
+/**
+ * Argument definitions for registration
+ */
+export const qualifyLeadArguments = [
+    {
+        name: 'target',
+        description: 'Attio URL, ID, or "search:<text>"',
+        required: true,
+        schema: z.string().min(3),
+    },
+    {
+        name: 'icp_preset',
+        description: "Optional ICP preset (e.g., 'SaaS mid-market NA')",
+        required: false,
+        schema: z.string(),
+    },
+    {
+        name: 'framework',
+        description: 'bant | champ (default bant)',
+        required: false,
+        schema: z.enum(['bant', 'champ']),
+        default: 'bant',
+    },
+    {
+        name: 'format',
+        description: 'json | table (default json)',
+        required: false,
+        schema: z.enum(['json', 'table']),
+        default: 'json',
+    },
+    {
+        name: 'verbosity',
+        description: 'brief | normal (default brief)',
+        required: false,
+        schema: z.enum(['brief', 'normal']),
+        default: 'brief',
+    },
+    {
+        name: 'dry_run',
+        description: "Only propose, don't execute (default false)",
+        required: false,
+        schema: z.boolean(),
+        default: false,
+    },
+    {
+        name: 'limit_web',
+        description: `Max pages (default ${WEB_RESEARCH_LIMITS.defaultLimitWeb}, max ${WEB_RESEARCH_LIMITS.maxLimitWeb})`,
+        required: false,
+        schema: z.number().int().min(1).max(WEB_RESEARCH_LIMITS.maxLimitWeb),
+        default: WEB_RESEARCH_LIMITS.defaultLimitWeb,
+    },
+];
+/**
+ * Build prompt messages for qualifying lead
+ */
+export function buildQualifyLeadMessages(args) {
+    const validated = QualifyLeadArgs.parse(args);
+    const icpContext = validated.icp_preset
+        ? `ICP context: "${validated.icp_preset}" affects scoring thresholds.`
+        : '';
+    const instructions = `Goal: produce a compact lead-qualification summary with evidence, then optionally update fields and create a next-action task.
+
+${icpContext}
+
+Steps:
+1) Resolve \`target\`: If starts with \`search:\`, call \`records_query\` to find one Person/Company (prefer exact domain/email + title+company). If multiple, list up to 5 for disambiguation and STOP.
+
+2) Build a tiny web plan (token-light): At most ${validated.limit_web} pages total. Prioritize: company homepage (domain), LinkedIn company page, product/pricing page. Call \`web.search\` only if domain is unknown; otherwise skip search. Call \`web.fetch\` and extract readable text only (strip nav/boilerplate). Truncate each page to the first ~${WEB_RESEARCH_LIMITS.maxWordsPerPage} words.
+
+3) Extract key facts for ${validated.framework.toUpperCase()}:
+   - Firmographic: industry, employee bucket, region; ICP match
+   - Problem fit: product category/keywords
+   - Budget: pricing tier mentions
+   - Authority: likely buyer role(s)
+   - Timing/Priority: hiring/funding/news in last 12 months
+
+4) Output (${validated.format}):
+   - If json: return ONLY a JSON object with fields: lead, framework, fit, score, summary (≤80w), evidence (≤${WEB_RESEARCH_LIMITS.maxEvidence}), fields_to_update, recommended_next_step (≤20w)
+   - If table: return a 2-column table
+   Verbosity=${validated.verbosity} → no preamble
+
+5) Propose actions: Suggest a single \`records.update\` and optionally \`tasks.create\`. ${validated.dry_run ? 'Output proposed tool call(s) as JSON only.' : 'Ask for approval before any write.'}
+
+Constraints: Pages ≤ ${validated.limit_web}, each ≤ ~${WEB_RESEARCH_LIMITS.maxWordsPerPage} words; evidence max ${WEB_RESEARCH_LIMITS.maxEvidence}. Keep answers short and structured; no raw dumps; JSON under ~120 lines. MORE_AVAILABLE: true when results exceed limits.`;
+    return [
+        {
+            role: 'user',
+            content: {
+                type: 'text',
+                text: instructions,
+            },
+        },
+    ];
+}
+/**
+ * Complete prompt definition
+ */
+export const qualifyLeadPrompt = {
+    metadata: {
+        name: 'qualify_lead.v1',
+        title: 'Qualify a lead (light web research)',
+        description: 'Resolve a lead, scan 2-3 web sources, return a BANT/CHAMP summary with evidence, and propose next actions.',
+        category: 'analysis',
+        version: 'v1',
+    },
+    arguments: qualifyLeadArguments,
+    buildMessages: buildQualifyLeadMessages,
+    tokenBudget: 400, // Per spec (with defaults)
+};
+export default qualifyLeadPrompt;
+//# sourceMappingURL=qualify-lead.v1.js.map

package/dist/prompts/v1/qualify-lead.v1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualify-lead.v1.js","sourceRoot":"","sources":["../../../src/prompts/v1/qualify-lead.v1.ts"],"names":[],"mappings":"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"}

package/dist/prompts/v1/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Type definitions for MCP v1 Prompts
+ *
+ * These types align with the Model Context Protocol specification for prompts
+ * and extend them with token awareness features from issue #775.
+ */
+import { z } from 'zod';
+/**
+ * MCP PromptMessage types
+ * Aligned with @modelcontextprotocol/sdk types
+ */
+export type PromptRole = 'user' | 'assistant';
+export interface TextContent {
+    type: 'text';
+    text: string;
+}
+export interface ImageContent {
+    type: 'image';
+    data: string;
+    mimeType: string;
+}
+export interface EmbeddedResource {
+    type: 'resource';
+    resource: {
+        uri: string;
+        mimeType?: string;
+        text?: string;
+    };
+}
+export type PromptContent = TextContent | ImageContent | EmbeddedResource;
+export interface PromptMessage {
+    role: PromptRole;
+    content: PromptContent;
+}
+/**
+ * Token metadata for prompt responses
+ * Provides token counting information when dev mode is enabled
+ */
+export interface TokenMetadata {
+    /** Total estimated tokens for the prompt */
+    estimated_tokens: number;
+    /** Total character count across all messages */
+    message_chars: number;
+    /** Total bytes for embedded resources */
+    resource_bytes: number;
+    /** Counting method used */
+    method: 'tiktoken' | 'estimate';
+    /** Whether the count is approximate */
+    approx: boolean;
+}
+/**
+ * Argument definition for a prompt parameter
+ */
+export interface PromptArgument {
+    /** Argument name */
+    name: string;
+    /** Human-readable description (≤80 chars per spec) */
+    description: string;
+    /** Whether this argument is required */
+    required: boolean;
+    /** Zod schema for validation */
+    schema: z.ZodTypeAny;
+    /** Default value if not provided */
+    default?: unknown;
+}
+/**
+ * Prompt metadata for discovery
+ */
+export interface PromptMetadata {
+    /** Unique prompt identifier (e.g., "people_search.v1") */
+    name: string;
+    /** Human-readable title */
+    title: string;
+    /** Short description (≤140 chars per spec) */
+    description: string;
+    /** Category for grouping */
+    category: 'search' | 'activity' | 'workflow' | 'analysis' | 'general';
+    /** Prompt version */
+    version: string;
+}
+/**
+ * Complete prompt definition
+ */
+export interface PromptV1Definition {
+    /** Prompt metadata */
+    metadata: PromptMetadata;
+    /** Argument definitions with Zod schemas */
+    arguments: PromptArgument[];
+    /** Function to build prompt messages from validated arguments */
+    buildMessages: (args: Record<string, unknown>) => PromptMessage[];
+    /** Optional: expected token budget for this prompt */
+    tokenBudget?: number;
+}
+/**
+ * Result structure for prompts/get endpoint with optional dev metadata
+ */
+export interface GetPromptV1Result {
+    /** Description of the prompt */
+    description?: string;
+    /** Array of prompt messages */
+    messages: PromptMessage[];
+    /** Optional dev metadata (when ?dev=true) */
+    _meta?: TokenMetadata;
+}
+/**
+ * Universal argument schemas for read prompts
+ */
+export declare const UniversalReadArgs: {
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["table", "json", "ids"]>>>;
+    fields_preset: z.ZodDefault<z.ZodOptional<z.ZodEnum<["sales_short", "full"]>>>;
+    verbosity: z.ZodDefault<z.ZodOptional<z.ZodEnum<["brief", "normal"]>>>;
+};
+/**
+ * Universal argument for write prompts
+ */
+export declare const DryRunArg: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+/**
+ * Validation error structure
+ */
+export interface ValidationError {
+    field: string;
+    message: string;
+    code: string;
+}
+/**
+ * Budget enforcement result
+ */
+export interface BudgetCheckResult {
+    withinBudget: boolean;
+    estimatedTokens: number;
+    budgetLimit: number;
+    exceededBy?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/prompts/v1/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/prompts/v1/types.ts"],"names":[],"mappings":"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"}

package/dist/prompts/v1/types.js

@@ -0,0 +1,36 @@
+/**
+ * Type definitions for MCP v1 Prompts
+ *
+ * These types align with the Model Context Protocol specification for prompts
+ * and extend them with token awareness features from issue #775.
+ */
+import { z } from 'zod';
+/**
+ * Universal argument schemas for read prompts
+ */
+export const UniversalReadArgs = {
+    format: z
+        .enum(['table', 'json', 'ids'])
+        .optional()
+        .default('table')
+        .describe('Output format: table (Markdown), json (structured array), or ids (comma-separated)'),
+    fields_preset: z
+        .enum(['sales_short', 'full'])
+        .optional()
+        .default('sales_short')
+        .describe('Field verbosity: sales_short (minimal, token-efficient) or full (all fields)'),
+    verbosity: z
+        .enum(['brief', 'normal'])
+        .optional()
+        .default('brief')
+        .describe('Response detail level: brief (concise) or normal (detailed)'),
+};
+/**
+ * Universal argument for write prompts
+ */
+export const DryRunArg = z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe('If true, only propose tool calls without executing writes');
+//# sourceMappingURL=types.js.map

package/dist/prompts/v1/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/prompts/v1/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8GxB;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;SAC9B,QAAQ,EAAE;SACV,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CACP,oFAAoF,CACrF;IAEH,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;SAC7B,QAAQ,EAAE;SACV,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CACP,8EAA8E,CAC/E;IAEH,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;SACzB,QAAQ,EAAE;SACV,OAAO,CAAC,OAAO,CAAC;SAChB,QAAQ,CAAC,6DAA6D,CAAC;CAC3E,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC;KACvB,OAAO,EAAE;KACT,QAAQ,EAAE;KACV,OAAO,CAAC,KAAK,CAAC;KACd,QAAQ,CAAC,2DAA2D,CAAC,CAAC"}

package/dist/prompts/v1/utils/telemetry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Telemetry logging for v1 prompts
+ *
+ * Provides structured logging of prompt usage metrics when enabled.
+ * Respects PROMPT_TELEMETRY_ENABLED environment variable.
+ */
+import { TokenMetadata } from '../types.js';
+/**
+ * Telemetry event data structure
+ */
+export interface PromptTelemetryEvent {
+    /** Name of the prompt executed */
+    prompt_name: string;
+    /** Estimated tokens in the response */
+    estimated_tokens: number;
+    /** Number of messages in the response */
+    message_count: number;
+    /** Total bytes of embedded resources */
+    resource_bytes: number;
+    /** Duration of prompt execution in milliseconds */
+    duration_ms: number;
+    /** Timestamp of the event */
+    timestamp: string;
+    /** Whether the prompt exceeded its budget */
+    budget_exceeded?: boolean;
+    /** User ID if available */
+    user_id?: string;
+    /** Request ID for correlation */
+    request_id?: string;
+}
+/**
+ * Log a prompt telemetry event
+ *
+ * Only logs if PROMPT_TELEMETRY_ENABLED=true
+ *
+ * @param event - Telemetry event data
+ */
+export declare function logPromptTelemetry(event: PromptTelemetryEvent): void;
+/**
+ * Create a telemetry event from execution data
+ *
+ * @param promptName - Name of the prompt
+ * @param tokenMetadata - Token metadata from execution
+ * @param messageCount - Number of messages generated
+ * @param startTime - Execution start time (Date.now())
+ * @param budgetExceeded - Whether budget was exceeded
+ * @param userId - Optional user ID
+ * @param requestId - Optional request ID
+ * @returns Telemetry event
+ */
+export declare function createTelemetryEvent(promptName: string, tokenMetadata: TokenMetadata, messageCount: number, startTime: number, budgetExceeded?: boolean, userId?: string, requestId?: string): PromptTelemetryEvent;
+/**
+ * Track prompt execution with automatic telemetry
+ *
+ * Helper function to wrap prompt execution with telemetry logging
+ *
+ * @param promptName - Name of the prompt
+ * @param execution - Async function that executes the prompt
+ * @param userId - Optional user ID
+ * @param requestId - Optional request ID
+ * @returns Execution result with telemetry logged
+ */
+export declare function trackPromptExecution<T>(promptName: string, execution: () => Promise<T>, userId?: string, requestId?: string): Promise<T>;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/prompts/v1/utils/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../../src/prompts/v1/utils/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAK5C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAgBpE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,OAAe,EAC/B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,oBAAoB,CAYtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAkBZ"}

package/dist/prompts/v1/utils/telemetry.js

@@ -0,0 +1,88 @@
+/**
+ * Telemetry logging for v1 prompts
+ *
+ * Provides structured logging of prompt usage metrics when enabled.
+ * Respects PROMPT_TELEMETRY_ENABLED environment variable.
+ */
+import { createScopedLogger } from '../../../utils/logger.js';
+import { isTelemetryEnabled } from '../constants.js';
+const logger = createScopedLogger('prompts.v1', 'telemetry');
+/**
+ * Log a prompt telemetry event
+ *
+ * Only logs if PROMPT_TELEMETRY_ENABLED=true
+ *
+ * @param event - Telemetry event data
+ */
+export function logPromptTelemetry(event) {
+    if (!isTelemetryEnabled()) {
+        return;
+    }
+    logger.info('Prompt executed', {
+        prompt_name: event.prompt_name,
+        estimated_tokens: event.estimated_tokens,
+        message_count: event.message_count,
+        resource_bytes: event.resource_bytes,
+        duration_ms: event.duration_ms,
+        budget_exceeded: event.budget_exceeded,
+        user_id: event.user_id,
+        request_id: event.request_id,
+        timestamp: event.timestamp,
+    });
+}
+/**
+ * Create a telemetry event from execution data
+ *
+ * @param promptName - Name of the prompt
+ * @param tokenMetadata - Token metadata from execution
+ * @param messageCount - Number of messages generated
+ * @param startTime - Execution start time (Date.now())
+ * @param budgetExceeded - Whether budget was exceeded
+ * @param userId - Optional user ID
+ * @param requestId - Optional request ID
+ * @returns Telemetry event
+ */
+export function createTelemetryEvent(promptName, tokenMetadata, messageCount, startTime, budgetExceeded = false, userId, requestId) {
+    return {
+        prompt_name: promptName,
+        estimated_tokens: tokenMetadata.estimated_tokens,
+        message_count: messageCount,
+        resource_bytes: tokenMetadata.resource_bytes,
+        duration_ms: Date.now() - startTime,
+        timestamp: new Date().toISOString(),
+        budget_exceeded: budgetExceeded,
+        user_id: userId,
+        request_id: requestId,
+    };
+}
+/**
+ * Track prompt execution with automatic telemetry
+ *
+ * Helper function to wrap prompt execution with telemetry logging
+ *
+ * @param promptName - Name of the prompt
+ * @param execution - Async function that executes the prompt
+ * @param userId - Optional user ID
+ * @param requestId - Optional request ID
+ * @returns Execution result with telemetry logged
+ */
+export async function trackPromptExecution(promptName, execution, userId, requestId) {
+    const startTime = Date.now();
+    try {
+        const result = await execution();
+        return result;
+    }
+    finally {
+        // Note: This is a simplified version
+        // Full telemetry is logged in the handlers after message generation
+        if (isTelemetryEnabled()) {
+            logger.debug('Prompt execution completed', {
+                prompt_name: promptName,
+                duration_ms: Date.now() - startTime,
+                user_id: userId,
+                request_id: requestId,
+            });
+        }
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/prompts/v1/utils/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../../src/prompts/v1/utils/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,MAAM,MAAM,GAAG,kBAAkB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;AA0B7D;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA2B;IAC5D,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC7B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,aAA4B,EAC5B,YAAoB,EACpB,SAAiB,EACjB,iBAA0B,KAAK,EAC/B,MAAe,EACf,SAAkB;IAElB,OAAO;QACL,WAAW,EAAE,UAAU;QACvB,gBAAgB,EAAE,aAAa,CAAC,gBAAgB;QAChD,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa,CAAC,cAAc;QAC5C,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,eAAe,EAAE,cAAc;QAC/B,OAAO,EAAE,MAAM;QACf,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,SAA2B,EAC3B,MAAe,EACf,SAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,qCAAqC;QACrC,oEAAoE;QACpE,IAAI,kBAAkB,EAAE,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE;gBACzC,WAAW,EAAE,UAAU;gBACvB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACnC,OAAO,EAAE,MAAM;gBACf,UAAU,EAAE,SAAS;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/prompts/v1/utils/token-metadata.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Token metadata calculation utilities for MCP prompts
+ *
+ * Wraps the token counting utility from #775 to provide
+ * prompt-specific token awareness features.
+ */
+import { PromptMessage, TokenMetadata, EmbeddedResource } from '../types.js';
+/**
+ * Calculate token metadata for a set of prompt messages
+ *
+ * @param messages - Array of prompt messages
+ * @param resources - Optional array of embedded resources
+ * @param model - Optional model name for token counting
+ * @returns Token metadata with counts and method info
+ */
+export declare function calculatePromptTokens(messages: PromptMessage[], resources?: EmbeddedResource[], model?: string): TokenMetadata;
+/**
+ * Calculate tokens for a single text string
+ *
+ * Helper function for quick token estimates during prompt building
+ *
+ * @param text - Text to count tokens for
+ * @param model - Optional model name
+ * @returns Token count
+ */
+export declare function estimateTextTokens(text: string, model?: string): number;
+/**
+ * Check if messages exceed a token budget
+ *
+ * @param messages - Prompt messages to check
+ * @param budget - Maximum allowed tokens
+ * @param model - Optional model name
+ * @returns Whether messages are within budget
+ */
+export declare function isWithinTokenBudget(messages: PromptMessage[], budget: number, model?: string): boolean;
+/**
+ * Format token metadata for logging
+ *
+ * @param metadata - Token metadata to format
+ * @returns Formatted string for logs
+ */
+export declare function formatTokenMetadata(metadata: TokenMetadata): string;
+//# sourceMappingURL=token-metadata.d.ts.map

package/dist/prompts/v1/utils/token-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata.d.ts","sourceRoot":"","sources":["../../../../src/prompts/v1/utils/token-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE7E;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,aAAa,EAAE,EACzB,SAAS,CAAC,EAAE,gBAAgB,EAAE,EAC9B,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAyCf;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,aAAa,EAAE,EACzB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAEnE"}