attio-mcp 0.1.2 → 1.1.0

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"}

package/dist/prompts/v1/utils/token-metadata.js

@@ -0,0 +1,90 @@
+/**
+ * Token metadata calculation utilities for MCP prompts
+ *
+ * Wraps the token counting utility from #775 to provide
+ * prompt-specific token awareness features.
+ */
+import { countTokens } from '../../../utils/token-count.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 function calculatePromptTokens(messages, resources, model) {
+    let totalTokens = 0;
+    let totalChars = 0;
+    let totalResourceBytes = 0;
+    // Count tokens and chars for each message
+    for (const message of messages) {
+        if (message.content.type === 'text') {
+            const text = message.content.text;
+            totalChars += text.length;
+            totalTokens += countTokens(text, model);
+        }
+        else if (message.content.type === 'image') {
+            // Images are counted by data length (base64 encoded)
+            const dataSize = message.content.data.length;
+            totalChars += dataSize;
+            // Rough estimate: 1 token per 4 chars for base64
+            totalTokens += Math.ceil(dataSize / 4);
+        }
+        else if (message.content.type === 'resource') {
+            const resourceText = message.content.resource.text || '';
+            totalChars += resourceText.length;
+            totalTokens += countTokens(resourceText, model);
+        }
+    }
+    // Count embedded resource tokens
+    if (resources && resources.length > 0) {
+        for (const resource of resources) {
+            const resourceText = resource.resource.text || '';
+            const resourceBytes = Buffer.byteLength(resourceText, 'utf8');
+            totalResourceBytes += resourceBytes;
+            totalTokens += countTokens(resourceText, model);
+        }
+    }
+    return {
+        estimated_tokens: totalTokens,
+        message_chars: totalChars,
+        resource_bytes: totalResourceBytes,
+        method: 'tiktoken',
+        approx: false, // tiktoken provides deterministic counts
+    };
+}
+/**
+ * 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 function estimateTextTokens(text, model) {
+    return countTokens(text, model);
+}
+/**
+ * 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 function isWithinTokenBudget(messages, budget, model) {
+    const metadata = calculatePromptTokens(messages, undefined, model);
+    return metadata.estimated_tokens <= budget;
+}
+/**
+ * Format token metadata for logging
+ *
+ * @param metadata - Token metadata to format
+ * @returns Formatted string for logs
+ */
+export function formatTokenMetadata(metadata) {
+    return `${metadata.estimated_tokens} tokens (${metadata.message_chars} chars, ${metadata.resource_bytes} resource bytes) via ${metadata.method}`;
+}
+//# sourceMappingURL=token-metadata.js.map

package/dist/prompts/v1/utils/token-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-metadata.js","sourceRoot":"","sources":["../../../../src/prompts/v1/utils/token-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAyB,EACzB,SAA8B,EAC9B,KAAc;IAEd,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,kBAAkB,GAAG,CAAC,CAAC;IAE3B,0CAA0C;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YAClC,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC;YAC1B,WAAW,IAAI,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC5C,qDAAqD;YACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAC7C,UAAU,IAAI,QAAQ,CAAC;YACvB,iDAAiD;YACjD,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC/C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YACzD,UAAU,IAAI,YAAY,CAAC,MAAM,CAAC;YAClC,WAAW,IAAI,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAClD,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC9D,kBAAkB,IAAI,aAAa,CAAC;YACpC,WAAW,IAAI,WAAW,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO;QACL,gBAAgB,EAAE,WAAW;QAC7B,aAAa,EAAE,UAAU;QACzB,cAAc,EAAE,kBAAkB;QAClC,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK,EAAE,yCAAyC;KACzD,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,KAAc;IAC7D,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAyB,EACzB,MAAc,EACd,KAAc;IAEd,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACnE,OAAO,QAAQ,CAAC,gBAAgB,IAAI,MAAM,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAuB;IACzD,OAAO,GAAG,QAAQ,CAAC,gBAAgB,YAAY,QAAQ,CAAC,aAAa,WAAW,QAAQ,CAAC,cAAc,wBAAwB,QAAQ,CAAC,MAAM,EAAE,CAAC;AACnJ,CAAC"}

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

@@ -0,0 +1,69 @@
+/**
+ * Validation and budget enforcement utilities for v1 prompts
+ *
+ * Provides argument validation using Zod schemas and token budget enforcement
+ * per the specifications in issue #774.
+ */
+import { PromptArgument, ValidationError, BudgetCheckResult, PromptMessage } from '../types.js';
+/**
+ * Validate arguments against their Zod schemas
+ *
+ * @param args - User-provided arguments
+ * @param argumentDefs - Argument definitions with schemas
+ * @returns Validation result with validated data or errors
+ */
+export declare function validateArguments(args: Record<string, unknown>, argumentDefs: PromptArgument[]): {
+    success: true;
+    data: Record<string, unknown>;
+} | {
+    success: false;
+    errors: ValidationError[];
+};
+/**
+ * Check if prompt messages are within token budget
+ *
+ * @param promptName - Name of the prompt for budget lookup
+ * @param messages - Generated prompt messages
+ * @param model - Optional model name for token counting
+ * @returns Budget check result
+ */
+export declare function checkTokenBudget(promptName: string, messages: PromptMessage[], model?: string): BudgetCheckResult;
+/**
+ * Create a JSON-RPC error response for validation failures
+ *
+ * Per MCP spec, invalid parameters should return error code -32602
+ *
+ * @param errors - Validation errors
+ * @returns JSON-RPC error object
+ */
+export declare function createValidationError(errors: ValidationError[]): {
+    code: number;
+    message: string;
+    data?: {
+        errors: ValidationError[];
+    };
+};
+/**
+ * Create a JSON-RPC error response for budget exceeded
+ *
+ * @param budgetResult - Budget check result
+ * @returns JSON-RPC error object
+ */
+export declare function createBudgetExceededError(budgetResult: BudgetCheckResult): {
+    code: number;
+    message: string;
+    data?: {
+        estimatedTokens: number;
+        budgetLimit: number;
+        exceededBy: number;
+    };
+};
+/**
+ * Apply default values to arguments
+ *
+ * @param args - User-provided arguments
+ * @param argumentDefs - Argument definitions with defaults
+ * @returns Arguments with defaults applied
+ */
+export declare function applyDefaults(args: Record<string, unknown>, argumentDefs: PromptArgument[]): Record<string, unknown>;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../src/prompts/v1/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,EAAE,cAAc,EAAE,GAE5B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAChD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAyDhD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,aAAa,EAAE,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,iBAAiB,CAanB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,eAAe,EAAE,CAAC;KAC3B,CAAC;CACH,CAYA;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,iBAAiB,GAAG;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAUA;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,EAAE,cAAc,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

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

@@ -0,0 +1,140 @@
+/**
+ * Validation and budget enforcement utilities for v1 prompts
+ *
+ * Provides argument validation using Zod schemas and token budget enforcement
+ * per the specifications in issue #774.
+ */
+import { calculatePromptTokens } from './token-metadata.js';
+import { getPromptTokenBudget } from '../constants.js';
+/**
+ * Validate arguments against their Zod schemas
+ *
+ * @param args - User-provided arguments
+ * @param argumentDefs - Argument definitions with schemas
+ * @returns Validation result with validated data or errors
+ */
+export function validateArguments(args, argumentDefs) {
+    const errors = [];
+    const validatedData = {};
+    // Check required arguments
+    for (const argDef of argumentDefs) {
+        const value = args[argDef.name];
+        // Check if required argument is missing
+        if (argDef.required && (value === undefined || value === null)) {
+            errors.push({
+                field: argDef.name,
+                message: `Missing required argument: ${argDef.name}`,
+                code: 'REQUIRED_ARG_MISSING',
+            });
+            continue;
+        }
+        // Apply default if value is missing and default exists
+        const valueToValidate = value ?? argDef.default;
+        // Skip validation if value is still undefined/null after default
+        if (valueToValidate === undefined || valueToValidate === null) {
+            continue;
+        }
+        // Validate using Zod schema
+        const result = argDef.schema.safeParse(valueToValidate);
+        if (!result.success) {
+            errors.push({
+                field: argDef.name,
+                message: result.error.errors[0]?.message || 'Invalid value',
+                code: 'VALIDATION_FAILED',
+            });
+        }
+        else {
+            validatedData[argDef.name] = result.data;
+        }
+    }
+    // Check for unknown arguments (optional warning, not error)
+    const knownArgNames = new Set(argumentDefs.map((a) => a.name));
+    for (const key of Object.keys(args)) {
+        if (!knownArgNames.has(key)) {
+            errors.push({
+                field: key,
+                message: `Unknown argument: ${key}`,
+                code: 'UNKNOWN_ARG',
+            });
+        }
+    }
+    if (errors.length > 0) {
+        return { success: false, errors };
+    }
+    return { success: true, data: validatedData };
+}
+/**
+ * Check if prompt messages are within token budget
+ *
+ * @param promptName - Name of the prompt for budget lookup
+ * @param messages - Generated prompt messages
+ * @param model - Optional model name for token counting
+ * @returns Budget check result
+ */
+export function checkTokenBudget(promptName, messages, model) {
+    const budgetLimit = getPromptTokenBudget(promptName);
+    const metadata = calculatePromptTokens(messages, undefined, model);
+    const estimatedTokens = metadata.estimated_tokens;
+    const withinBudget = estimatedTokens <= budgetLimit;
+    return {
+        withinBudget,
+        estimatedTokens,
+        budgetLimit,
+        exceededBy: withinBudget ? undefined : estimatedTokens - budgetLimit,
+    };
+}
+/**
+ * Create a JSON-RPC error response for validation failures
+ *
+ * Per MCP spec, invalid parameters should return error code -32602
+ *
+ * @param errors - Validation errors
+ * @returns JSON-RPC error object
+ */
+export function createValidationError(errors) {
+    const errorMessages = errors
+        .map((e) => `${e.field}: ${e.message}`)
+        .join(', ');
+    return {
+        code: -32602, // Invalid params per JSON-RPC 2.0 spec
+        message: `Invalid parameters: ${errorMessages}`,
+        data: {
+            errors,
+        },
+    };
+}
+/**
+ * Create a JSON-RPC error response for budget exceeded
+ *
+ * @param budgetResult - Budget check result
+ * @returns JSON-RPC error object
+ */
+export function createBudgetExceededError(budgetResult) {
+    return {
+        code: -32602, // Invalid params (prompt too large)
+        message: `Prompt exceeds token budget: ${budgetResult.estimatedTokens} tokens (limit: ${budgetResult.budgetLimit})`,
+        data: {
+            estimatedTokens: budgetResult.estimatedTokens,
+            budgetLimit: budgetResult.budgetLimit,
+            exceededBy: budgetResult.exceededBy || 0,
+        },
+    };
+}
+/**
+ * Apply default values to arguments
+ *
+ * @param args - User-provided arguments
+ * @param argumentDefs - Argument definitions with defaults
+ * @returns Arguments with defaults applied
+ */
+export function applyDefaults(args, argumentDefs) {
+    const result = { ...args };
+    for (const argDef of argumentDefs) {
+        if ((result[argDef.name] === undefined || result[argDef.name] === null) &&
+            argDef.default !== undefined) {
+            result[argDef.name] = argDef.default;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=validation.js.map

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

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

package/dist/server/createServer.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Factory function to create and configure an MCP server instance
+ * This centralizes all server setup logic to be reused by different transports
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { z } from 'zod';
+/**
+ * Context interface for passing configuration to the server
+ */
+export interface ServerContext {
+    getApiKey?: () => string | undefined;
+    getWorkspaceId?: () => string | undefined;
+    [key: string]: unknown;
+}
+/**
+ * Configuration schema for Smithery/Playground auto-discovery
+ * This allows scanners to build a test configuration without guessing.
+ */
+export declare const configSchema: z.ZodObject<{
+    ATTIO_API_KEY: z.ZodOptional<z.ZodString>;
+    ATTIO_WORKSPACE_ID: z.ZodOptional<z.ZodString>;
+    ALLOWED_ORIGINS: z.ZodOptional<z.ZodString>;
+    debug: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    debug: boolean;
+    ATTIO_API_KEY?: string | undefined;
+    ATTIO_WORKSPACE_ID?: string | undefined;
+    ALLOWED_ORIGINS?: string | undefined;
+}, {
+    ATTIO_API_KEY?: string | undefined;
+    debug?: boolean | undefined;
+    ATTIO_WORKSPACE_ID?: string | undefined;
+    ALLOWED_ORIGINS?: string | undefined;
+}>;
+/**
+ * Creates an MCP server instance
+ *
+ * @param context - Optional context for configuration (used by Smithery)
+ * @returns Configured MCP server instance
+ */
+export declare function createServer(context?: ServerContext): Promise<Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+}>>;
+//# sourceMappingURL=createServer.d.ts.map

package/dist/server/createServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createServer.d.ts","sourceRoot":"","sources":["../../src/server/createServer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;EAYvB,CAAC;AAEH;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,CAAC,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;IAgDzD"}