@iflow-mcp/attio-mcp 1.3.6

package/dist/prompts/v1/pipeline-health.v1.js

@@ -0,0 +1,131 @@
+/**
+ * Pipeline Health v1 Prompt
+ *
+ * Weekly pipeline recap: owner/segment-scoped snapshot (created/won/slipped)
+ * with risk flags and recommended actions.
+ */
+import { z } from 'zod';
+import { UniversalReadArgs } from './types.js';
+import { SEARCH_DEFAULTS } from './constants.js';
+/**
+ * Argument schema for pipeline_health.v1
+ */
+export const PipelineHealthArgs = z.object({
+    owner: z
+        .string()
+        .optional()
+        .default(SEARCH_DEFAULTS.ownerDefault)
+        .describe('Owner filter (default @me)'),
+    timeframe: z
+        .string()
+        .optional()
+        .default(SEARCH_DEFAULTS.timeframeDefault)
+        .describe('Timeframe for analysis (default 30d)'),
+    segment: z.string().optional().describe('Optional segment/pipeline filter'),
+    ...UniversalReadArgs,
+});
+/**
+ * Argument definitions for registration
+ */
+export const pipelineHealthArguments = [
+    {
+        name: 'owner',
+        description: 'Owner filter (default @me)',
+        required: false,
+        schema: z.string(),
+        default: SEARCH_DEFAULTS.ownerDefault,
+    },
+    {
+        name: 'timeframe',
+        description: 'Timeframe (default 30d)',
+        required: false,
+        schema: z.string(),
+        default: SEARCH_DEFAULTS.timeframeDefault,
+    },
+    {
+        name: 'segment',
+        description: 'Optional segment/pipeline filter',
+        required: false,
+        schema: z.string(),
+    },
+    {
+        name: 'format',
+        description: 'table | json (default table)',
+        required: false,
+        schema: z.enum(['table', 'json']),
+        default: 'table',
+    },
+    {
+        name: 'fields_preset',
+        description: 'sales_short | full (default sales_short)',
+        required: false,
+        schema: z.enum(['sales_short', 'full']),
+        default: 'sales_short',
+    },
+    {
+        name: 'verbosity',
+        description: 'brief | normal (default brief)',
+        required: false,
+        schema: z.enum(['brief', 'normal']),
+        default: 'brief',
+    },
+];
+/**
+ * Build prompt messages for pipeline health
+ */
+export function buildPipelineHealthMessages(args) {
+    const validated = PipelineHealthArgs.parse(args);
+    const segmentFilter = validated.segment
+        ? ` and segment="${validated.segment}"`
+        : '';
+    const instructions = `Goal: Create a pipeline health snapshot for owner="${validated.owner}" over the last ${validated.timeframe}${segmentFilter}.
+
+Steps:
+1. Call \`deals.list\` or \`records_query\` for deals matching: owner="${validated.owner}", modified_date within ${validated.timeframe}${segmentFilter}
+
+2. Analyze and categorize deals:
+   - Created: New deals in timeframe
+   - Won: Deals moved to "Closed Won"
+   - Slipped: Deals past close_date still open
+   - At Risk: Deals with no activity in >14 days
+
+3. Output format=${validated.format}:
+   - If table: Markdown sections: "Summary Metrics", "Risk Flags", "Top Priorities", "Recommended Actions"
+   - If json: Structured object with same sections
+
+Fields preset=${validated.fields_preset}:
+- sales_short: Counts and key deals only (token-efficient)
+- full: Include all deal details
+
+Verbosity=${validated.verbosity}:
+- brief: Metrics + bullet points
+- normal: Narrative analysis + metrics
+
+Include "Recommended Actions" with 3-5 specific next steps based on risk flags.`;
+    return [
+        {
+            role: 'user',
+            content: {
+                type: 'text',
+                text: instructions,
+            },
+        },
+    ];
+}
+/**
+ * Complete prompt definition
+ */
+export const pipelineHealthPrompt = {
+    metadata: {
+        name: 'pipeline_health.v1',
+        title: 'Weekly pipeline recap',
+        description: 'Owner/segment-scoped snapshot (created/won/slipped; risk flags) with recommended actions.',
+        category: 'analysis',
+        version: 'v1',
+    },
+    arguments: pipelineHealthArguments,
+    buildMessages: buildPipelineHealthMessages,
+    tokenBudget: 700, // Per spec
+};
+export default pipelineHealthPrompt;
+//# sourceMappingURL=pipeline-health.v1.js.map

package/dist/prompts/v1/pipeline-health.v1.js.map

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

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":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACtE,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,4CAA4C;IAC5C,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,iEAAiE;IACjE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,aAAa,EAAE,CAAC;IAClE,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,6CAA6C;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;CAsB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,2CAIkD,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

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