@telora/mcp-products 0.21.28 → 0.22.0

package/dist/handlers/componentHandlers.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type GetCreds } from "../shared.js";
+export declare function registerComponentTools(server: McpServer, getCreds: GetCreds): void;

package/dist/handlers/componentHandlers.js

@@ -0,0 +1,128 @@
+// ---------------------------------------------------------------------------
+// Component architecture MCP tool handlers:
+//   telora_component_scan (scan codebase)
+//   telora_component (list | get)
+//   telora_component_scan_list (list scans)
+//   telora_component_scan_diff (compare two scans)
+// ---------------------------------------------------------------------------
+import { z } from "zod";
+import { callProductApi, successResult, validationError, wrapHandler, } from "../shared.js";
+import { runScan } from "../scanner/index.js";
+export function registerComponentTools(server, getCreds) {
+    // ── Scanner ─────────────────────────────────────────────────────
+    server.tool("telora_component_scan", "Scan a product's source code to extract its component architecture: files, " +
+        "public API (props, functions, types), and import relationships. Creates a " +
+        "snapshot that can be compared with previous scans to track architectural drift. " +
+        "Uses ts-morph AST parsing for accurate extraction.", {
+        productId: z.string().uuid().describe("Product UUID to scan"),
+        repoPath: z.string().optional().describe("Path to git repository (defaults to cwd)"),
+        sourceRoot: z.string().optional().describe("Source root relative to repo (default: 'src/')"),
+        maxScans: z.number().int().min(1).max(100).optional().describe("Max completed scans to retain per product (default: 10). Older scans are pruned after a successful scan."),
+    }, wrapHandler(async (params) => {
+        if (!params.productId)
+            return validationError("productId is required");
+        const repoPath = params.repoPath || process.cwd();
+        const result = await runScan(getCreds(), {
+            productId: params.productId,
+            repoPath,
+            sourceRoot: params.sourceRoot,
+            maxScans: params.maxScans,
+        });
+        return successResult({
+            scanId: result.scanId,
+            commitSha: result.commitSha,
+            componentCount: result.componentCount,
+            memberCount: result.memberCount,
+            relationshipCount: result.relationshipCount,
+        });
+    }));
+    // ── Component List ──────────────────────────────────────────────
+    server.tool("telora_component_list", "List components from the persisted architecture model. Defaults to the latest " +
+        "completed scan. Filter by type, parent directory, or scan. Returns hierarchy-aware " +
+        "results ordered by path.", {
+        productId: z.string().uuid().describe("Product UUID"),
+        scanId: z.string().uuid().optional().describe("Specific scan ID (default: latest completed)"),
+        componentType: z.enum([
+            "page", "component", "hook", "context",
+            "library", "utility", "type_definition", "barrel",
+        ]).optional().describe("Filter by component type"),
+        parentId: z.string().uuid().nullable().optional().describe("List children of this directory (null = root level)"),
+        limit: z.number().int().min(1).max(500).optional().describe("Max results (default 50)"),
+        offset: z.number().int().min(0).optional().describe("Skip N results"),
+    }, wrapHandler(async (params) => {
+        if (!params.productId)
+            return validationError("productId is required");
+        const body = {
+            action: "component_list",
+            productId: params.productId,
+        };
+        if (params.scanId)
+            body.scanId = params.scanId;
+        if (params.componentType)
+            body.componentType = params.componentType;
+        if (params.parentId !== undefined)
+            body.parentId = params.parentId;
+        if (params.limit !== undefined)
+            body.limit = params.limit;
+        if (params.offset !== undefined)
+            body.offset = params.offset;
+        const result = await callProductApi(getCreds(), body);
+        return successResult({ items: result.components, totalCount: result.totalCount });
+    }));
+    // ── Component Get ───────────────────────────────────────────────
+    server.tool("telora_component_get", "Get full details for a single component: its members (props, functions, types), " +
+        "inbound/outbound relationships, parent info, and children. Use after " +
+        "telora_component_list to drill into a specific component.", {
+        componentId: z.string().uuid().describe("Component UUID"),
+    }, wrapHandler(async (params) => {
+        if (!params.componentId)
+            return validationError("componentId is required");
+        const result = await callProductApi(getCreds(), {
+            action: "component_get",
+            componentId: params.componentId,
+        });
+        return successResult(result);
+    }));
+    // ── Scan List ───────────────────────────────────────────────────
+    server.tool("telora_component_scan_list", "List past component scans for a product. Shows commit SHA, scan time, " +
+        "component/relationship counts, and status. Most recent first.", {
+        productId: z.string().uuid().describe("Product UUID"),
+        status: z.enum(["running", "completed", "failed"]).optional().describe("Filter by status"),
+        limit: z.number().int().min(1).max(500).optional().describe("Max results (default 50)"),
+        offset: z.number().int().min(0).optional().describe("Skip N results"),
+    }, wrapHandler(async (params) => {
+        if (!params.productId)
+            return validationError("productId is required");
+        const body = {
+            action: "component_scan_list",
+            productId: params.productId,
+        };
+        if (params.status)
+            body.fields = { status: params.status };
+        if (params.limit !== undefined)
+            body.limit = params.limit;
+        if (params.offset !== undefined)
+            body.offset = params.offset;
+        const result = await callProductApi(getCreds(), body);
+        return successResult({ items: result.scans, totalCount: result.totalCount });
+    }));
+    // ── Scan Diff ───────────────────────────────────────────────────
+    server.tool("telora_component_scan_diff", "Compare two scans to see what changed: added/removed/changed components, " +
+        "new/dropped import relationships, and changed member signatures. Components " +
+        "matched by path (stable identity across scans).", {
+        baseScanId: z.string().uuid().describe("Base scan UUID (older)"),
+        headScanId: z.string().uuid().describe("Head scan UUID (newer)"),
+    }, wrapHandler(async (params) => {
+        if (!params.baseScanId)
+            return validationError("baseScanId is required");
+        if (!params.headScanId)
+            return validationError("headScanId is required");
+        const result = await callProductApi(getCreds(), {
+            action: "component_scan_diff",
+            baseScanId: params.baseScanId,
+            headScanId: params.headScanId,
+        });
+        return successResult(result);
+    }));
+}
+//# sourceMappingURL=componentHandlers.js.map

package/dist/handlers/componentHandlers.js.map

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

package/dist/handlers/contextHandlers.d.ts

@@ -1,8 +1,3 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { type GetCreds, type ToolProfile } from "../shared.js";
-/**
- * Register only the telora_context_assemble tool (for human profile core startup).
- * This avoids loading all context CRUD tools at startup.
- */
+import { type GetCreds } from "../shared.js";
 export declare function registerContextAssembleTool(server: McpServer, getCreds: GetCreds): void;
-export declare function registerContextTools(server: McpServer, getCreds: GetCreds, profile?: ToolProfile): void;

package/dist/handlers/contextHandlers.js

@@ -1,23 +1,22 @@
 // ---------------------------------------------------------------------------
-// Context document tool handlers (consolidated):
-//   telora_product_context (list | create | update | delete | reorder)
-//   telora_product_context_link (link | unlink)
-//   telora_context_assemble (layered context assembly)
+// Context assembly MCP tool: telora_context_assemble.
+//
+// The legacy context document CRUD tools (telora_product_context,
+// telora_product_context_link) were retired with the wiki schema cut.
+// Use the telora_wiki_* tools for wiki content management.
 // ---------------------------------------------------------------------------
 import { z } from "zod";
-import { callProductApi, successResult, validationError, buildFields, wrapHandler, compactEntity, } from "../shared.js";
-/**
- * Register only the telora_context_assemble tool (for human profile core startup).
- * This avoids loading all context CRUD tools at startup.
- */
+import { callProductApi, successResult, validationError, wrapHandler, } from "../shared.js";
 export function registerContextAssembleTool(server, getCreds) {
     server.tool("telora_context_assemble", "Assemble layered context for a product, strategy, or delivery. " +
-        "Returns pre-formatted markdown with product philosophy, context documents, strategy goals, " +
-        "delivery details, and issue hierarchy. Use at session start for architectural/design work. " +
-        "Each scope level includes the previous: product -> strategy -> delivery.", {
+        "Returns pre-formatted markdown with product overview, strategy/delivery " +
+        "scaffolding, and a wiki section drawn from wiki_search using scope-derived " +
+        "queries (or your own `queries` override). Use at session start for " +
+        "architectural/design work.", {
         productId: z.string().uuid().describe("Product UUID (required)"),
         strategyId: z.string().uuid().optional().describe("Strategy UUID (adds strategy + delivery summaries)"),
         deliveryId: z.string().uuid().optional().describe("Delivery UUID (adds tech context + acceptance criteria + issues)"),
+        queries: z.array(z.string()).optional().describe("Override the scope-derived wiki retrieval queries"),
     }, wrapHandler(async (params) => {
         if (!params.productId)
             return validationError("productId is required");
@@ -29,141 +28,10 @@ export function registerContextAssembleTool(server, getCreds) {
             body.strategyId = params.strategyId;
         if (params.deliveryId)
             body.deliveryId = params.deliveryId;
+        if (params.queries)
+            body.queries = params.queries;
         const result = await callProductApi(getCreds(), body);
         return successResult(result);
     }));
 }
-export function registerContextTools(server, getCreds, profile = 'full') {
-    // -- telora_product_context (consolidated) ------------------------------------
-    const contextActions = (profile === 'full' || profile === 'human')
-        ? ["list", "create", "update", "delete", "reorder"]
-        : ["list"];
-    server.tool("telora_product_context", `Knowledge base: product context documents provide background knowledge for AI agents and strategy planning. ` +
-        `Documents can be scoped as always-included, linked to specific strategies/deliveries, or draft. ` +
-        `Actions: ${contextActions.join(", ")}. ` +
-        `list: productId required. create: productId + title + content. update: documentId + fields. ` +
-        `delete: documentId. reorder: productId + documentIds.`, {
-        action: z.enum(contextActions).describe("Action to perform"),
-        productId: z.string().uuid().optional().describe("Product UUID (required for list, create, reorder)"),
-        documentId: z.string().uuid().optional().describe("Document UUID (required for update, delete)"),
-        strategyId: z.string().uuid().optional().describe("Strategy UUID - list returns always + linked docs, excluding drafts"),
-        deliveryId: z.string().uuid().optional().describe("Delivery UUID - list returns always + linked docs, excluding drafts"),
-        title: z.string().max(500).optional().describe("Document title (required for create)"),
-        content: z.string().optional().describe("Markdown content (required for create)"),
-        includeMode: z.enum(["draft", "always", "linked"]).optional().describe("Include mode (list: filter; create: defaults to draft)"),
-        documentIds: z.array(z.string().uuid()).optional().describe("Ordered array of document UUIDs for reorder (first = sort_order 0)"),
-        limit: z.number().int().min(1).max(500).optional().describe("Max results (1-500, default 50)"),
-        offset: z.number().int().min(0).optional().describe("Number of results to skip (default 0)"),
-        detail: z.enum(["titles", "summary", "full"]).optional().describe("Response detail level"),
-        returnFull: z.boolean().optional().describe("Return full entity (default: compact)"),
-    }, wrapHandler(async (params) => {
-        switch (params.action) {
-            case "list": {
-                if (!params.productId)
-                    return validationError("productId required for list");
-                const fields = buildFields({ includeMode: params.includeMode });
-                const body = {
-                    action: "context_list",
-                    productId: params.productId,
-                    fields: Object.keys(fields).length > 0 ? fields : undefined,
-                };
-                if (params.strategyId !== undefined)
-                    body.strategyId = params.strategyId;
-                if (params.deliveryId !== undefined)
-                    body.deliveryId = params.deliveryId;
-                if (params.limit !== undefined)
-                    body.limit = params.limit;
-                if (params.offset !== undefined)
-                    body.offset = params.offset;
-                if (params.detail !== undefined)
-                    body.detail = params.detail;
-                const result = await callProductApi(getCreds(), body);
-                return successResult({ items: result.documents, totalCount: result.totalCount });
-            }
-            case "create": {
-                if (!params.productId)
-                    return validationError("productId required for create");
-                if (!params.title)
-                    return validationError("title required for create");
-                if (!params.content)
-                    return validationError("content required for create");
-                const fields = buildFields({ title: params.title, content: params.content, includeMode: params.includeMode });
-                const result = await callProductApi(getCreds(), {
-                    action: "context_create",
-                    productId: params.productId,
-                    fields,
-                });
-                return successResult(compactEntity(result.document, Object.keys(fields), params.returnFull));
-            }
-            case "update": {
-                if (!params.documentId)
-                    return validationError("documentId required for update");
-                const fields = buildFields({ title: params.title, content: params.content, includeMode: params.includeMode });
-                if (Object.keys(fields).length === 0) {
-                    return validationError("Provide at least one field to update");
-                }
-                const result = await callProductApi(getCreds(), {
-                    action: "context_update",
-                    documentId: params.documentId,
-                    fields,
-                });
-                return successResult(compactEntity(result.document, Object.keys(fields), params.returnFull));
-            }
-            case "delete": {
-                if (!params.documentId)
-                    return validationError("documentId required for delete");
-                const result = await callProductApi(getCreds(), {
-                    action: "context_delete",
-                    documentId: params.documentId,
-                });
-                return successResult(result);
-            }
-            case "reorder": {
-                if (!params.productId)
-                    return validationError("productId required for reorder");
-                if (!params.documentIds)
-                    return validationError("documentIds required for reorder");
-                const result = await callProductApi(getCreds(), {
-                    action: "context_reorder",
-                    productId: params.productId,
-                    documentIds: params.documentIds,
-                });
-                return successResult(result.documents);
-            }
-            default:
-                return validationError(`Unknown action: ${params.action}`);
-        }
-    }));
-    // -- telora_product_context_link (consolidated) -------------------------------
-    if (profile === 'full' || profile === 'human') {
-        server.tool("telora_product_context_link", "Document linking: attach or detach context documents to strategies or deliveries. " +
-            "Linked documents are included in the AI agent's context when working on that entity. Actions: link, unlink.", {
-            action: z.enum(["link", "unlink"]).describe("Action to perform"),
-            documentId: z.string().uuid().describe("Document UUID"),
-            entityType: z.enum(["strategy", "delivery"]).describe("Entity type to link/unlink"),
-            entityId: z.string().uuid().describe("Entity UUID to link/unlink"),
-        }, wrapHandler(async ({ action, documentId, entityType, entityId }) => {
-            if (action === "link") {
-                const result = await callProductApi(getCreds(), {
-                    action: "context_link",
-                    documentId,
-                    fields: { entityType, entityId },
-                });
-                return successResult(result.link);
-            }
-            else {
-                const result = await callProductApi(getCreds(), {
-                    action: "context_unlink",
-                    documentId,
-                    fields: { entityType, entityId },
-                });
-                return successResult(result);
-            }
-        }));
-    }
-    // -- telora_context_assemble (non-human profiles only; human uses registerContextAssembleTool) --
-    if (profile === 'full') {
-        registerContextAssembleTool(server, getCreds);
-    }
-}
 //# sourceMappingURL=contextHandlers.js.map

package/dist/handlers/contextHandlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"contextHandlers.js","sourceRoot":"","sources":["../../src/handlers/contextHandlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"contextHandlers.js","sourceRoot":"","sources":["../../src/handlers/contextHandlers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sDAAsD;AACtD,EAAE;AACF,kEAAkE;AAClE,sEAAsE;AACtE,2DAA2D;AAC3D,8EAA8E;AAE9E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,WAAW,GAEZ,MAAM,cAAc,CAAC;AAEtB,MAAM,UAAU,2BAA2B,CACzC,MAAiB,EACjB,QAAkB;IAElB,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,iEAAiE;QACjE,0EAA0E;QAC1E,6EAA6E;QAC7E,qEAAqE;QACrE,4BAA4B,EAC5B;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAChE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QACvG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;QACrH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KACtG,EACD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3B,IAAI,CAAC,MAAM,CAAC,SAAS;YAAE,OAAO,eAAe,CAAC,uBAAuB,CAAC,CAAC;QACvE,MAAM,IAAI,GAA4B;YACpC,MAAM,EAAE,kBAAkB;YAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC;QACF,IAAI,MAAM,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAC3D,IAAI,MAAM,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAC3D,IAAI,MAAM,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAClD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE,IAAI,CAA4B,CAAC;QACjF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/handlers/contractHandlers.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { type GetCreds } from "../shared.js";
+export declare function registerContractTools(server: McpServer, getCreds: GetCreds): void;

package/dist/handlers/contractHandlers.js

@@ -0,0 +1,150 @@
+// ---------------------------------------------------------------------------
+// Contract tool handlers:
+//   telora_contract          (list | create | get | update)
+//   telora_contract_version  (add | list | get | diff)
+// ---------------------------------------------------------------------------
+import { z } from "zod";
+import { callProductApi, successResult, validationError, wrapHandler, compactEntity, } from "../shared.js";
+const contractStatusEnum = z.enum(["draft", "active", "completed", "terminated"]);
+export function registerContractTools(server, getCreds) {
+    // -- telora_contract --------------------------------------------------------
+    server.tool("telora_contract", "Contracts: named agreements linked to a product. " +
+        "Each contract has a name, counterparty, effective date, and status (draft/active/completed/terminated). " +
+        "Contract text is stored as versioned markdown in contract_versions. " +
+        "Actions: list (productId, optional status filter), create (productId + name), " +
+        "get (contractId -- returns contract with version metadata), update (contractId + fields).", {
+        action: z.enum(["list", "create", "get", "update"]).describe("Action to perform"),
+        productId: z.string().uuid().optional().describe("Product UUID (required for list, create)"),
+        contractId: z.string().uuid().optional().describe("Contract UUID (required for get, update)"),
+        name: z.string().max(200).optional().describe("Contract name (required for create)"),
+        counterparty: z.string().max(500).optional().describe("Counterparty name"),
+        effectiveDate: z.string().optional().describe("Effective date (ISO 8601 date)"),
+        status: contractStatusEnum.optional().describe("Contract status"),
+        returnFull: z.boolean().optional().describe("Return full entity (default: compact)"),
+    }, wrapHandler(async (params) => {
+        switch (params.action) {
+            case "list": {
+                if (!params.productId)
+                    return validationError("productId required for list");
+                const body = {
+                    action: "contract_list",
+                    productId: params.productId,
+                };
+                if (params.status !== undefined)
+                    body.status = params.status;
+                const result = await callProductApi(getCreds(), body);
+                return successResult(result);
+            }
+            case "create": {
+                if (!params.productId || !params.name)
+                    return validationError("productId and name required for create");
+                const body = {
+                    action: "contract_create",
+                    productId: params.productId,
+                    name: params.name,
+                };
+                if (params.counterparty !== undefined)
+                    body.counterparty = params.counterparty;
+                if (params.effectiveDate !== undefined)
+                    body.effectiveDate = params.effectiveDate;
+                if (params.status !== undefined)
+                    body.status = params.status;
+                const result = await callProductApi(getCreds(), body);
+                const contract = result.contract;
+                return successResult({ contract: params.returnFull ? contract : compactEntity(contract, ["name", "status", "counterparty"]) });
+            }
+            case "get": {
+                if (!params.contractId)
+                    return validationError("contractId required for get");
+                const result = await callProductApi(getCreds(), {
+                    action: "contract_get",
+                    contractId: params.contractId,
+                });
+                return successResult(result);
+            }
+            case "update": {
+                if (!params.contractId)
+                    return validationError("contractId required for update");
+                const body = {
+                    action: "contract_update",
+                    contractId: params.contractId,
+                };
+                if (params.name !== undefined)
+                    body.name = params.name;
+                if (params.counterparty !== undefined)
+                    body.counterparty = params.counterparty;
+                if (params.effectiveDate !== undefined)
+                    body.effectiveDate = params.effectiveDate;
+                if (params.status !== undefined)
+                    body.status = params.status;
+                const result = await callProductApi(getCreds(), body);
+                const contract = result.contract;
+                return successResult({ contract: params.returnFull ? contract : compactEntity(contract, ["name", "status", "counterparty"]) });
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+    // -- telora_contract_version ------------------------------------------------
+    server.tool("telora_contract_version", "Contract versions: versioned markdown text for contracts. " +
+        "Each version is immutable once created. Version numbers auto-increment per contract. " +
+        "Actions: add (contractId + content -- creates next version), " +
+        "list (contractId -- version metadata without content), " +
+        "get (contractId + versionNumber -- returns full content), " +
+        "diff (contractId + fromVersion + toVersion -- line-level diff).", {
+        action: z.enum(["add", "list", "get", "diff"]).describe("Action to perform"),
+        contractId: z.string().uuid().describe("Contract UUID"),
+        content: z.string().optional().describe("Markdown content (required for add)"),
+        versionNumber: z.number().int().positive().optional()
+            .describe("Version number (required for get)"),
+        fromVersion: z.number().int().positive().optional()
+            .describe("From version number (required for diff)"),
+        toVersion: z.number().int().positive().optional()
+            .describe("To version number (required for diff)"),
+    }, wrapHandler(async (params) => {
+        switch (params.action) {
+            case "add": {
+                if (!params.content)
+                    return validationError("content required for add");
+                const result = await callProductApi(getCreds(), {
+                    action: "contract_version_add",
+                    contractId: params.contractId,
+                    content: params.content,
+                });
+                return successResult(result);
+            }
+            case "list": {
+                const result = await callProductApi(getCreds(), {
+                    action: "contract_version_list",
+                    contractId: params.contractId,
+                });
+                return successResult(result);
+            }
+            case "get": {
+                if (params.versionNumber === undefined)
+                    return validationError("versionNumber required for get");
+                const result = await callProductApi(getCreds(), {
+                    action: "contract_version_get",
+                    contractId: params.contractId,
+                    versionNumber: params.versionNumber,
+                });
+                return successResult(result);
+            }
+            case "diff": {
+                if (params.fromVersion === undefined || params.toVersion === undefined) {
+                    return validationError("fromVersion and toVersion required for diff");
+                }
+                const result = await callProductApi(getCreds(), {
+                    action: "contract_version_diff",
+                    contractId: params.contractId,
+                    fromVersion: params.fromVersion,
+                    toVersion: params.toVersion,
+                });
+                return successResult(result);
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+}
+//# sourceMappingURL=contractHandlers.js.map

package/dist/handlers/contractHandlers.js.map

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