@peernova/cuneiform-sf 1.0.2 → 1.0.4-beta.8

package/lib/mcp/config/pagination.js

@@ -0,0 +1,108 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * Pagination infrastructure for MCP tool responses.
+ *
+ * Provides cursor-based pagination with server-side page size clamping
+ * to keep responses within LLM context budgets (~5 KB per response).
+ */
+/**
+ * Page size defaults and maximums for each paginated resource type.
+ */
+export const PAGE_SIZE_DEFAULTS = {
+    OBJECT_LIST: { default: 25, max: 50 },
+    FIELD_LIST: { default: 25, max: 50 },
+    RELATIONSHIP_LIST: { default: 10, max: 25 },
+    NAMESPACE_LIST: { default: 10, max: 25 },
+    RECORD_TYPE_LIST: { default: 10, max: 25 },
+};
+/**
+ * Encodes a numeric offset into an opaque base64 cursor string.
+ *
+ * @param offset - The zero-based offset to encode
+ * @returns Opaque cursor string
+ */
+export function encodeCursor(offset) {
+    return Buffer.from(JSON.stringify({ offset })).toString('base64');
+}
+/**
+ * Decodes an opaque cursor string back to a numeric offset.
+ *
+ * Returns 0 for undefined or empty cursors (start from beginning).
+ * Throws for malformed cursors to prevent silent pagination loops.
+ *
+ * @param cursor - Opaque cursor string from a previous response
+ * @returns The decoded offset, or 0 if cursor is undefined/empty
+ * @throws Error if the cursor is present but malformed
+ */
+export function decodeCursor(cursor) {
+    if (!cursor)
+        return 0;
+    try {
+        const decoded = JSON.parse(Buffer.from(cursor, 'base64').toString('utf-8'));
+        const offset = decoded.offset;
+        if (typeof offset === 'number' && offset >= 0) {
+            return offset;
+        }
+        throw new Error(`invalid cursor payload: offset is ${typeof offset}`);
+    }
+    catch (error) {
+        if (error instanceof Error && error.message.startsWith('invalid cursor payload')) {
+            throw error;
+        }
+        throw new Error('Malformed pagination cursor. Pass the exact nextCursor value from a previous response, or omit to start from the beginning.');
+    }
+}
+/**
+ * Clamps a requested page size to within [1, max], defaulting if undefined.
+ *
+ * @param requested - The page size requested by the client (may be undefined)
+ * @param defaultSize - Default page size when not specified
+ * @param maxSize - Maximum allowed page size
+ * @returns Clamped page size
+ */
+export function clampPageSize(requested, defaultSize, maxSize) {
+    if (requested === undefined)
+        return defaultSize;
+    if (requested <= 0)
+        return 1;
+    return Math.min(requested, maxSize);
+}
+/**
+ * Creates pagination metadata for a response envelope.
+ *
+ * @param input - Pagination parameters
+ * @returns Pagination metadata with cursor and status message
+ */
+export function createPaginationMetadata(input) {
+    const { offset, pageSize, totalItems, returnedItems } = input;
+    if (totalItems === 0) {
+        return {
+            returned: 0,
+            total: 0,
+            hasMore: false,
+            pageSize,
+            message: 'No results found.',
+        };
+    }
+    const nextOffset = offset + returnedItems;
+    const hasMore = nextOffset < totalItems;
+    const startItem = offset + 1;
+    const endItem = offset + returnedItems;
+    return {
+        returned: returnedItems,
+        total: totalItems,
+        hasMore,
+        nextCursor: hasMore ? encodeCursor(nextOffset) : undefined,
+        pageSize,
+        message: hasMore
+            ? `Showing ${startItem}-${endItem} of ${totalItems}. Use nextCursor to retrieve more.`
+            : `Showing ${startItem}-${endItem} of ${totalItems}. All results displayed.`,
+    };
+}
+//# sourceMappingURL=pagination.js.map

package/lib/mcp/config/pagination.js.map

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

package/lib/mcp/config/system-prompts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * System prompt for Cuneiform MCP Server.
+ *
+ * This prompt is injected into the LLM's context when the MCP server is active,
+ * providing guidance on available tools, incremental processing rules, and
+ * exploration workflows.
+ *
+ * @example
+ * ```typescript
+ * import { CUNEIFORM_SYSTEM_PROMPT } from './config/system-prompts.js';
+ *
+ * server.setRequestHandler(GetPromptRequestSchema, async () => ({
+ *   description: 'Cuneiform CLI system prompt',
+ *   messages: [{ role: 'user', content: { type: 'text', text: CUNEIFORM_SYSTEM_PROMPT } }],
+ * }));
+ * ```
+ */
+export declare const CUNEIFORM_SYSTEM_PROMPT: string;

package/lib/mcp/config/system-prompts.js

@@ -0,0 +1,92 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * System prompt for Cuneiform MCP Server.
+ *
+ * This prompt is injected into the LLM's context when the MCP server is active,
+ * providing guidance on available tools, incremental processing rules, and
+ * exploration workflows.
+ *
+ * @example
+ * ```typescript
+ * import { CUNEIFORM_SYSTEM_PROMPT } from './config/system-prompts.js';
+ *
+ * server.setRequestHandler(GetPromptRequestSchema, async () => ({
+ *   description: 'Cuneiform CLI system prompt',
+ *   messages: [{ role: 'user', content: { type: 'text', text: CUNEIFORM_SYSTEM_PROMPT } }],
+ * }));
+ * ```
+ */
+export const CUNEIFORM_SYSTEM_PROMPT = `
+[CUNEIFORM MCP SERVER ACTIVE]
+
+You are connected to the Cuneiform MCP server — an enterprise-grade Salesforce CLI plugin
+for data profiling, field analysis, and metadata governance.
+
+## Exploration Workflow
+
+Follow this incremental workflow. Do not skip steps.
+
+1. **Verify readiness** — Call cuneiform_user_details to confirm Cuneiform is installed
+   and the current user has the required permissions. Stop here if not ready.
+2. **Get org identity** — Call cuneiform_org_details with section=identity to understand
+   the connected org (edition, API version, installed packages).
+3. **List objects** — Call cuneiform_object_list with filters (e.g., filter=custom,
+   pattern, namespace) to find relevant objects. Do not request all objects at once.
+4. **Describe one object** — Call cuneiform_object_describe with section=summary for
+   a single object. Then request specific sections (fields, relationships) as needed.
+5. **Profile** — Create definitions, execute profiling, and review summaries.
+
+## Incremental Processing Rules
+
+- **One section per call.** Tools like cuneiform_org_details and cuneiform_object_describe
+  return one section at a time. Start with the summary/identity section, then drill down.
+- **Filter before paginating.** Apply type filters, namespace filters, or pattern matches
+  before requesting paginated results.
+- **Do not request all pages at once.** Each response is approximately 3-5 KB. Retrieve
+  the first page, check if more data is needed, then paginate using nextCursor.
+- **Do not loop through all objects.** Only describe objects the user is interested in.
+  Never iterate cuneiform_object_describe over every result from cuneiform_object_list.
+- **Prefer read-only operations first.** Use dry-run mode (dryRun=true, simulation=true)
+  before any write operation (create, update, configure, import).
+
+## Available Tools
+
+### Org & Metadata
+- cuneiform_org_details — Get org configuration by section (identity, cuneiform, features, clouds, namespaces, limits)
+- cuneiform_object_list — List objects with filtering by type, namespace, pattern, and record count
+- cuneiform_object_describe — Describe a single object by section (summary, fields, fieldDistribution, recordTypes, relationships)
+
+### User Management
+- cuneiform_user_details — Check user permissions, prerequisites, and readiness
+- cuneiform_user_configure — Configure user for profiling access (use dryRun=true first)
+
+### Definition Lifecycle
+- cuneiform_definition_list — List profiling definitions with filtering
+- cuneiform_definition_get — Get definition by Salesforce ID
+- cuneiform_definition_get_by_key — Get definitions by human-readable key (e.g., PD-0001)
+- cuneiform_definition_create — Create profiling definitions (use dryRun=true first)
+- cuneiform_definition_update — Update definition metadata attributes (name, category, timeCategory, segmentCategory, description)
+- cuneiform_definition_purge — Delete unused definitions
+
+### Definition I/O
+- cuneiform_definition_export — Export definitions as VCS-friendly files
+- cuneiform_definition_import — Import definitions from export (use simulation=true first)
+
+### Analysis
+- cuneiform_contactpoint_analyze — Detect email, phone, address, and social fields in an object
+
+### Results
+- cuneiform_summary_list — List profiling summaries (field-level statistics) for a definition
+
+### Profiling Execution
+- cuneiform_profile_execute — Execute a profiling definition (triggers Apex analysis)
+- cuneiform_profile_status — Check profiling execution status
+- cuneiform_profile_cancel — Cancel an active profiling execution
+`.trim();
+//# sourceMappingURL=system-prompts.js.map

package/lib/mcp/config/system-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompts.js","sourceRoot":"","sources":["../../../src/mcp/config/system-prompts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkEtC,CAAC,IAAI,EAAE,CAAC"}

package/lib/mcp/errors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Error codes for MCP server operations.
+ *
+ * Range: E6000-E6099 (MCP Layer)
+ */
+export declare const McpErrorCodes: {
+    /** MCP server initialization failed */
+    readonly SERVER_INIT_FAILED: "E6000";
+    /** MCP tool invocation failed */
+    readonly TOOL_INVOCATION_FAILED: "E6001";
+    /** Invalid tool input */
+    readonly INVALID_TOOL_INPUT: "E6002";
+    /** Tool not found */
+    readonly TOOL_NOT_FOUND: "E6003";
+    /** Salesforce org connection failed */
+    readonly ORG_CONNECTION_FAILED: "E6004";
+    /** Service call failed */
+    readonly SERVICE_CALL_FAILED: "E6005";
+};
+/**
+ * Type representing all MCP error codes.
+ */
+export type McpErrorCode = (typeof McpErrorCodes)[keyof typeof McpErrorCodes];

package/lib/mcp/errors.js

@@ -0,0 +1,27 @@
+/*
+ * Copyright (c) 2026, PeerNova, Inc. All Rights Reserved.
+ * PROPRIETARY AND CONFIDENTIAL. Unauthorized copying, modification,
+ * or distribution is strictly prohibited. Use is governed by the
+ * Master Subscription Agreement (MSA) between PeerNova, Inc. and the
+ * licensee. See LICENSE file in the repo root.
+ */
+/**
+ * Error codes for MCP server operations.
+ *
+ * Range: E6000-E6099 (MCP Layer)
+ */
+export const McpErrorCodes = {
+    /** MCP server initialization failed */
+    SERVER_INIT_FAILED: 'E6000',
+    /** MCP tool invocation failed */
+    TOOL_INVOCATION_FAILED: 'E6001',
+    /** Invalid tool input */
+    INVALID_TOOL_INPUT: 'E6002',
+    /** Tool not found */
+    TOOL_NOT_FOUND: 'E6003',
+    /** Salesforce org connection failed */
+    ORG_CONNECTION_FAILED: 'E6004',
+    /** Service call failed */
+    SERVICE_CALL_FAILED: 'E6005',
+};
+//# sourceMappingURL=errors.js.map

package/lib/mcp/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/mcp/errors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,uCAAuC;IACvC,kBAAkB,EAAE,OAAO;IAE3B,iCAAiC;IACjC,sBAAsB,EAAE,OAAO;IAE/B,yBAAyB;IACzB,kBAAkB,EAAE,OAAO;IAE3B,qBAAqB;IACrB,cAAc,EAAE,OAAO;IAEvB,uCAAuC;IACvC,qBAAqB,EAAE,OAAO;IAE9B,0BAA0B;IAC1B,mBAAmB,EAAE,OAAO;CACpB,CAAC"}

package/lib/mcp/schemas/input-schemas.d.ts

@@ -0,0 +1,327 @@
+import { z } from 'zod';
+/**
+ * Available sections for the org details tool.
+ */
+export declare const ORG_DETAILS_SECTIONS: readonly ["identity", "cuneiform", "features", "clouds", "namespaces", "limits"];
+/**
+ * Input schema for cuneiform_org_details tool.
+ */
+export declare const OrgDetailsInputSchema: z.ZodObject<{
+    section: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        identity: "identity";
+        cuneiform: "cuneiform";
+        features: "features";
+        clouds: "clouds";
+        namespaces: "namespaces";
+        limits: "limits";
+    }>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for org_details tool.
+ */
+export type OrgDetailsInput = z.infer<typeof OrgDetailsInputSchema>;
+/**
+ * Input schema for cuneiform_object_list tool.
+ */
+export declare const ObjectListInputSchema: z.ZodObject<{
+    filter: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        custom: "custom";
+        all: "all";
+    }>>>;
+    namespace: z.ZodOptional<z.ZodString>;
+    pattern: z.ZodOptional<z.ZodString>;
+    withRecords: z.ZodOptional<z.ZodBoolean>;
+    withoutRecords: z.ZodOptional<z.ZodBoolean>;
+    contactPoints: z.ZodOptional<z.ZodBoolean>;
+    minRecords: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        name: "name";
+        recordCount: "recordCount";
+        label: "label";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for object_list tool.
+ */
+export type ObjectListInput = z.infer<typeof ObjectListInputSchema>;
+/**
+ * Input schema for cuneiform_user_details tool.
+ */
+export declare const UserDetailsInputSchema: z.ZodObject<{}, z.core.$strip>;
+/**
+ * Type representing validated input for user_details tool.
+ */
+export type UserDetailsInput = z.infer<typeof UserDetailsInputSchema>;
+/**
+ * Available sections for the object describe tool.
+ */
+export declare const OBJECT_DESCRIBE_SECTIONS: readonly ["summary", "fields", "fieldDistribution", "recordTypes", "relationships"];
+/**
+ * Input schema for cuneiform_object_describe tool.
+ */
+export declare const ObjectDescribeInputSchema: z.ZodObject<{
+    objectName: z.ZodString;
+    section: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        summary: "summary";
+        recordTypes: "recordTypes";
+        relationships: "relationships";
+        fields: "fields";
+        fieldDistribution: "fieldDistribution";
+    }>>>;
+    fieldType: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        picklist: "picklist";
+        date: "date";
+        id: "id";
+        address: "address";
+        lookup: "lookup";
+        text: "text";
+        formula: "formula";
+        checkbox: "checkbox";
+    }>>;
+    fieldPattern: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        name: "name";
+        label: "label";
+        type: "type";
+    }>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for object_describe tool.
+ */
+export type ObjectDescribeInput = z.infer<typeof ObjectDescribeInputSchema>;
+/**
+ * Input schema for cuneiform_user_configure tool.
+ */
+export declare const UserConfigureInputSchema: z.ZodObject<{
+    dryRun: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for user_configure tool.
+ */
+export type UserConfigureInput = z.infer<typeof UserConfigureInputSchema>;
+/**
+ * Input schema for cuneiform_definition_list tool.
+ */
+export declare const DefinitionListInputSchema: z.ZodObject<{
+    objectName: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        ERROR: "ERROR";
+        "NOT PROFILED": "NOT PROFILED";
+        "IN PROGRESS": "IN PROGRESS";
+        SUCCESS: "SUCCESS";
+    }>>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_list tool.
+ */
+export type DefinitionListInput = z.infer<typeof DefinitionListInputSchema>;
+/**
+ * Input schema for cuneiform_definition_get tool.
+ */
+export declare const DefinitionGetInputSchema: z.ZodObject<{
+    definitionId: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_get tool.
+ */
+export type DefinitionGetInput = z.infer<typeof DefinitionGetInputSchema>;
+/**
+ * Input schema for cuneiform_definition_get_by_key tool.
+ * Mirrors the CLI command sf cuneiform definition get.
+ */
+export declare const DefinitionGetByKeyInputSchema: z.ZodObject<{
+    keys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_get_by_key tool.
+ */
+export type DefinitionGetByKeyInput = z.infer<typeof DefinitionGetByKeyInputSchema>;
+/**
+ * Input schema for cuneiform_definition_update tool.
+ */
+export declare const DefinitionUpdateInputSchema: z.ZodObject<{
+    definitionId: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    timeCategory: z.ZodOptional<z.ZodString>;
+    segmentCategory: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_update tool.
+ */
+export type DefinitionUpdateInput = z.infer<typeof DefinitionUpdateInputSchema>;
+/**
+ * Input schema for cuneiform_definition_export tool.
+ */
+export declare const DefinitionExportInputSchema: z.ZodObject<{
+    excludeIds: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_export tool.
+ */
+export type DefinitionExportInput = z.infer<typeof DefinitionExportInputSchema>;
+/**
+ * Input schema for cuneiform_definition_import tool.
+ */
+export declare const DefinitionImportInputSchema: z.ZodObject<{
+    fileContents: z.ZodRecord<z.ZodString, z.ZodString>;
+    operation: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        Insert: "Insert";
+        Upsert: "Upsert";
+    }>>>;
+    simulation: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_import tool.
+ */
+export type DefinitionImportInput = z.infer<typeof DefinitionImportInputSchema>;
+/**
+ * Input schema for cuneiform_contactpoint_analyze tool.
+ */
+export declare const ContactPointAnalyzeInputSchema: z.ZodObject<{
+    objectName: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for contactpoint_analyze tool.
+ */
+export type ContactPointAnalyzeInput = z.infer<typeof ContactPointAnalyzeInputSchema>;
+/**
+ * Input schema for cuneiform_definition_create tool.
+ * Mirrors the CLI command sf cuneiform definition create.
+ */
+export declare const DefinitionCreateInputSchema: z.ZodObject<{
+    type: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        standard: "standard";
+        custom: "custom";
+        all: "all";
+    }>>>;
+    namespace: z.ZodOptional<z.ZodString>;
+    classification: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        customer: "customer";
+        internal: "internal";
+    }>>>;
+    withRecords: z.ZodOptional<z.ZodBoolean>;
+    withoutRecords: z.ZodOptional<z.ZodBoolean>;
+    objects: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_create tool.
+ */
+export type DefinitionCreateInput = z.infer<typeof DefinitionCreateInputSchema>;
+/**
+ * Input schema for cuneiform_definition_purge tool.
+ * Mirrors the CLI command sf cuneiform definition purge.
+ */
+export declare const DefinitionPurgeInputSchema: z.ZodObject<{
+    objectName: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    isActive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for definition_purge tool.
+ */
+export type DefinitionPurgeInput = z.infer<typeof DefinitionPurgeInputSchema>;
+/**
+ * Input schema for cuneiform_summary_list tool.
+ */
+export declare const SummaryListInputSchema: z.ZodObject<{
+    definitionId: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for summary_list tool.
+ */
+export type SummaryListInput = z.infer<typeof SummaryListInputSchema>;
+/**
+ * Input schema for cuneiform_request_list tool.
+ */
+export declare const RequestListInputSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        Queued: "Queued";
+        Canceled: "Canceled";
+        Completed: "Completed";
+        Rejected: "Rejected";
+    }>, z.ZodArray<z.ZodEnum<{
+        Queued: "Queued";
+        Canceled: "Canceled";
+        Completed: "Completed";
+        Rejected: "Rejected";
+    }>>]>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for request_list tool.
+ */
+export type RequestListInput = z.infer<typeof RequestListInputSchema>;
+/**
+ * Input schema for cuneiform_profile_execute tool.
+ */
+export declare const ProfileExecuteInputSchema: z.ZodObject<{
+    definitionId: z.ZodString;
+    wait: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for profile_execute tool.
+ */
+export type ProfileExecuteInput = z.infer<typeof ProfileExecuteInputSchema>;
+/**
+ * Input schema for cuneiform_profile_status tool.
+ *
+ * Accepts one or more request IDs for batch status checks.
+ * Pass a single ID in the array for single-request status (backwards-compatible).
+ */
+export declare const ProfileStatusInputSchema: z.ZodObject<{
+    requestIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for profile_status tool.
+ */
+export type ProfileStatusInput = z.infer<typeof ProfileStatusInputSchema>;
+/**
+ * Input schema for cuneiform_profile_cancel tool.
+ *
+ * Supports two mutually exclusive modes:
+ * - requestId: Cancel a single profiling request
+ * - definitionId: Cancel all active requests for a definition
+ *
+ * Exactly one of requestId or definitionId must be provided.
+ */
+export declare const ProfileCancelInputSchema: z.ZodObject<{
+    requestId: z.ZodOptional<z.ZodString>;
+    definitionId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for profile_cancel tool.
+ */
+export type ProfileCancelInput = z.infer<typeof ProfileCancelInputSchema>;
+/**
+ * Input schema for cuneiform_profile_delete tool.
+ *
+ * Only Canceled requests can be deleted — the service enforces this constraint.
+ * Maximum of 200 IDs per call matches the service-layer bulk limit.
+ */
+export declare const ProfileDeleteInputSchema: z.ZodObject<{
+    requestIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Type representing validated input for profile_delete tool.
+ */
+export type ProfileDeleteInput = z.infer<typeof ProfileDeleteInputSchema>;