@telora/mcp-products 0.21.1

package/dist/handlers/infrastructureHandlers.js

@@ -0,0 +1,335 @@
+// ---------------------------------------------------------------------------
+// Infrastructure asset management MCP tool handlers (consolidated):
+//   telora_infra_environment (list | create | update | delete)
+//   telora_infra_asset (list | create | update | delete)
+//   telora_infra_relationship (list | create | delete)
+//   telora_infra_secret (list | create | get | delete)
+// ---------------------------------------------------------------------------
+import { z } from "zod";
+import { callProductApi, successResult, validationError, wrapHandler, } from "../shared.js";
+export function registerInfrastructureTools(server, getCreds) {
+    // ── Environments ─────────────────────────────────────────────────
+    server.tool("telora_infra_environment", "Infrastructure environments: named deployment targets (production, staging, dev) within a product. " +
+        "Each environment groups infrastructure assets and has a status (active, provisioning, decommissioned). " +
+        "Actions: list (by product), create (name required, unique per product), update, delete.", {
+        action: z.enum(["list", "create", "update", "delete"]).describe("Action to perform"),
+        productId: z.string().uuid().optional().describe("Product UUID (required for list, create)"),
+        environmentId: z.string().uuid().optional().describe("Environment UUID (required for update, delete)"),
+        name: z.string().max(200).optional().describe("Environment name (required for create, unique per product)"),
+        description: z.string().max(2000).nullable().optional().describe("Description of this environment"),
+        status: z.enum(["active", "provisioning", "decommissioned"]).optional().describe("Environment status"),
+        metadata: z.record(z.string(), z.unknown()).optional().describe("Arbitrary metadata JSON"),
+        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 (default 0)"),
+    }, wrapHandler(async (params) => {
+        switch (params.action) {
+            case "list": {
+                if (!params.productId)
+                    return validationError("productId required for list");
+                const body = {
+                    action: "environment_list",
+                    productId: params.productId,
+                };
+                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.environments, totalCount: result.totalCount });
+            }
+            case "create": {
+                if (!params.productId)
+                    return validationError("productId required for create");
+                if (!params.name)
+                    return validationError("name required for create");
+                const fields = { name: params.name };
+                if (params.description !== undefined)
+                    fields.description = params.description;
+                if (params.status !== undefined)
+                    fields.status = params.status;
+                if (params.metadata !== undefined)
+                    fields.metadata = params.metadata;
+                const result = await callProductApi(getCreds(), {
+                    action: "environment_create",
+                    productId: params.productId,
+                    fields,
+                });
+                return successResult(result.environment);
+            }
+            case "update": {
+                if (!params.environmentId)
+                    return validationError("environmentId required for update");
+                const fields = {};
+                if (params.name !== undefined)
+                    fields.name = params.name;
+                if (params.description !== undefined)
+                    fields.description = params.description;
+                if (params.status !== undefined)
+                    fields.status = params.status;
+                if (params.metadata !== undefined)
+                    fields.metadata = params.metadata;
+                if (Object.keys(fields).length === 0)
+                    return validationError("Provide at least one field to update");
+                const result = await callProductApi(getCreds(), {
+                    action: "environment_update",
+                    environmentId: params.environmentId,
+                    fields,
+                });
+                return successResult(result.environment);
+            }
+            case "delete": {
+                if (!params.environmentId)
+                    return validationError("environmentId required for delete");
+                await callProductApi(getCreds(), {
+                    action: "environment_delete",
+                    environmentId: params.environmentId,
+                });
+                return successResult({ deleted: true });
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+    // ── Assets ───────────────────────────────────────────────────────
+    server.tool("telora_infra_asset", "Infrastructure assets: typed resources (database, container, service, dashboard, storage, proxy, dns, monitoring, ci_cd) " +
+        "within a product. Assets can optionally belong to an environment and store connection details (url, ip, port). " +
+        "Actions: list (by product, optional environment/type filter), create, update, delete.", {
+        action: z.enum(["list", "create", "update", "delete"]).describe("Action to perform"),
+        productId: z.string().uuid().optional().describe("Product UUID (required for list, create)"),
+        assetId: z.string().uuid().optional().describe("Asset UUID (required for update, delete)"),
+        environmentId: z.string().uuid().nullable().optional().describe("Environment UUID (filter for list, assignment for create/update)"),
+        name: z.string().max(200).optional().describe("Asset name (required for create)"),
+        assetType: z.enum([
+            "database", "container", "service", "dashboard",
+            "storage", "proxy", "dns", "monitoring", "ci_cd",
+        ]).optional().describe("Asset type (required for create, filter for list)"),
+        description: z.string().max(2000).nullable().optional().describe("Asset description"),
+        url: z.string().max(2000).nullable().optional().describe("URL or endpoint"),
+        ip: z.string().max(200).nullable().optional().describe("IP address"),
+        port: z.number().int().min(1).max(65535).nullable().optional().describe("Port number"),
+        metadata: z.record(z.string(), z.unknown()).optional().describe("Arbitrary metadata JSON"),
+        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 (default 0)"),
+    }, wrapHandler(async (params) => {
+        switch (params.action) {
+            case "list": {
+                if (!params.productId)
+                    return validationError("productId required for list");
+                const body = {
+                    action: "asset_list",
+                    productId: params.productId,
+                };
+                if (params.environmentId !== undefined)
+                    body.environmentId = params.environmentId;
+                if (params.assetType !== undefined)
+                    body.fields = { assetType: params.assetType };
+                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.assets, totalCount: result.totalCount });
+            }
+            case "create": {
+                if (!params.productId)
+                    return validationError("productId required for create");
+                if (!params.name)
+                    return validationError("name required for create");
+                if (!params.assetType)
+                    return validationError("assetType required for create");
+                const fields = {
+                    name: params.name,
+                    assetType: params.assetType,
+                };
+                if (params.description !== undefined)
+                    fields.description = params.description;
+                if (params.url !== undefined)
+                    fields.url = params.url;
+                if (params.ip !== undefined)
+                    fields.ip = params.ip;
+                if (params.port !== undefined)
+                    fields.port = params.port;
+                if (params.metadata !== undefined)
+                    fields.metadata = params.metadata;
+                const body = {
+                    action: "asset_create",
+                    productId: params.productId,
+                    fields,
+                };
+                if (params.environmentId !== undefined)
+                    body.environmentId = params.environmentId;
+                const result = await callProductApi(getCreds(), body);
+                return successResult(result.asset);
+            }
+            case "update": {
+                if (!params.assetId)
+                    return validationError("assetId required for update");
+                const fields = {};
+                if (params.name !== undefined)
+                    fields.name = params.name;
+                if (params.assetType !== undefined)
+                    fields.assetType = params.assetType;
+                if (params.description !== undefined)
+                    fields.description = params.description;
+                if (params.url !== undefined)
+                    fields.url = params.url;
+                if (params.ip !== undefined)
+                    fields.ip = params.ip;
+                if (params.port !== undefined)
+                    fields.port = params.port;
+                if (params.metadata !== undefined)
+                    fields.metadata = params.metadata;
+                if (Object.keys(fields).length === 0 && params.environmentId === undefined) {
+                    return validationError("Provide at least one field to update");
+                }
+                const body = {
+                    action: "asset_update",
+                    assetId: params.assetId,
+                    fields,
+                };
+                if (params.environmentId !== undefined)
+                    body.environmentId = params.environmentId;
+                const result = await callProductApi(getCreds(), body);
+                return successResult(result.asset);
+            }
+            case "delete": {
+                if (!params.assetId)
+                    return validationError("assetId required for delete");
+                await callProductApi(getCreds(), {
+                    action: "asset_delete",
+                    assetId: params.assetId,
+                });
+                return successResult({ deleted: true });
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+    // ── Relationships ────────────────────────────────────────────────
+    server.tool("telora_infra_relationship", "Asset relationships: directed links between infrastructure assets within the same product. " +
+        "Types: connects_to, deploys_to, proxies, depends_on, hosts. " +
+        "Actions: list (by product), create (source + target + type), delete.", {
+        action: z.enum(["list", "create", "delete"]).describe("Action to perform"),
+        productId: z.string().uuid().optional().describe("Product UUID (required for list)"),
+        relationshipId: z.string().uuid().optional().describe("Relationship UUID (required for delete)"),
+        sourceAssetId: z.string().uuid().optional().describe("Source asset UUID (required for create)"),
+        targetAssetId: z.string().uuid().optional().describe("Target asset UUID (required for create)"),
+        relationshipType: z.enum([
+            "connects_to", "deploys_to", "proxies", "depends_on", "hosts",
+        ]).optional().describe("Relationship type (required for create)"),
+        description: z.string().max(2000).nullable().optional().describe("Relationship description"),
+        metadata: z.record(z.string(), z.unknown()).optional().describe("Arbitrary metadata JSON"),
+        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 (default 0)"),
+    }, wrapHandler(async (params) => {
+        switch (params.action) {
+            case "list": {
+                if (!params.productId)
+                    return validationError("productId required for list");
+                const body = {
+                    action: "asset_relationship_list",
+                    productId: params.productId,
+                };
+                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.relationships, totalCount: result.totalCount });
+            }
+            case "create": {
+                if (!params.sourceAssetId)
+                    return validationError("sourceAssetId required for create");
+                if (!params.targetAssetId)
+                    return validationError("targetAssetId required for create");
+                if (!params.relationshipType)
+                    return validationError("relationshipType required for create");
+                const fields = {
+                    sourceAssetId: params.sourceAssetId,
+                    targetAssetId: params.targetAssetId,
+                    relationshipType: params.relationshipType,
+                };
+                if (params.description !== undefined)
+                    fields.description = params.description;
+                if (params.metadata !== undefined)
+                    fields.metadata = params.metadata;
+                const result = await callProductApi(getCreds(), {
+                    action: "asset_relationship_create",
+                    fields,
+                });
+                return successResult(result.relationship);
+            }
+            case "delete": {
+                if (!params.relationshipId)
+                    return validationError("relationshipId required for delete");
+                await callProductApi(getCreds(), {
+                    action: "asset_relationship_delete",
+                    relationshipId: params.relationshipId,
+                });
+                return successResult({ deleted: true });
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+    // ── Secrets ──────────────────────────────────────────────────────
+    server.tool("telora_infra_secret", "Infrastructure secrets: encrypted key-value pairs stored per asset using Vault. " +
+        "List and create show names only (no values). Use get to decrypt and reveal a secret value on demand. " +
+        "Actions: list (by asset), create (name + value), get (decrypts), delete.", {
+        action: z.enum(["list", "create", "get", "delete"]).describe("Action to perform"),
+        assetId: z.string().uuid().optional().describe("Asset UUID (required for list, create)"),
+        secretId: z.string().uuid().optional().describe("Secret UUID (required for get, delete)"),
+        name: z.string().max(200).optional().describe("Secret name (required for create, unique per asset)"),
+        secretValue: z.string().optional().describe("Secret value to encrypt and store (required for create)"),
+    }, wrapHandler(async (params) => {
+        switch (params.action) {
+            case "list": {
+                if (!params.assetId)
+                    return validationError("assetId required for list");
+                const result = await callProductApi(getCreds(), {
+                    action: "secret_list",
+                    assetId: params.assetId,
+                });
+                return successResult({ items: result.secrets });
+            }
+            case "create": {
+                if (!params.assetId)
+                    return validationError("assetId required for create");
+                if (!params.name)
+                    return validationError("name required for create");
+                if (!params.secretValue)
+                    return validationError("secretValue required for create");
+                const result = await callProductApi(getCreds(), {
+                    action: "secret_create",
+                    assetId: params.assetId,
+                    fields: {
+                        name: params.name,
+                        secretValue: params.secretValue,
+                    },
+                });
+                return successResult(result.secret);
+            }
+            case "get": {
+                if (!params.secretId)
+                    return validationError("secretId required for get");
+                const result = await callProductApi(getCreds(), {
+                    action: "secret_get",
+                    secretId: params.secretId,
+                });
+                return successResult(result.secret);
+            }
+            case "delete": {
+                if (!params.secretId)
+                    return validationError("secretId required for delete");
+                await callProductApi(getCreds(), {
+                    action: "secret_delete",
+                    secretId: params.secretId,
+                });
+                return successResult({ deleted: true });
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+}
+//# sourceMappingURL=infrastructureHandlers.js.map

package/dist/handlers/infrastructureHandlers.js.map

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

package/dist/handlers/issueHandlers.d.ts

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

package/dist/handlers/issueHandlers.js

@@ -0,0 +1,94 @@
+// ---------------------------------------------------------------------------
+// Issue tool handler (consolidated):
+//   telora_product_issue (list | create | update | delete)
+// ---------------------------------------------------------------------------
+import { z } from "zod";
+import { callProductApi, successResult, validationError, buildFields, wrapHandler, compactEntity, } from "../shared.js";
+export function registerIssueTools(server, getCreds) {
+    server.tool("telora_product_issue", "Task tracking: manage issues (tasks, bugs, context groups) within deliveries. " +
+        "Issues flow through To Do -> In Progress -> Done. Context groups organize related tasks with shared files and AI context. " +
+        "Actions: list issues (by delivery or product-wide), create an issue (title + deliveryId), " +
+        "update issue fields (status, priority, description), delete an issue.", {
+        action: z.enum(["list", "create", "update", "delete"]).describe("Action to perform"),
+        issueId: z.string().uuid().optional().describe("Issue UUID (required for update, delete)"),
+        deliveryId: z.string().uuid().optional().describe("Delivery UUID (required for create; optional filter for list)"),
+        productId: z.string().uuid().optional().describe("Product UUID (list: fetch issues across all deliveries)"),
+        title: z.string().max(500).optional().describe("Issue title (required for create)"),
+        issueType: z.enum(["Context Group", "Task", "Bug"]).optional().describe("Issue type (default: Task)"),
+        description: z.string().max(5000).optional().describe("Issue description"),
+        status: z.enum(["To Do", "In Progress", "In Review", "Blocked", "Done"]).optional().describe("Issue status (create default: 'To Do'; list: filter)"),
+        parentIssueId: z.string().uuid().optional().describe("Parent issue UUID (for nesting under context groups)"),
+        priority: z.enum(["P0", "P1", "P2", "P3"]).optional().describe("Priority label"),
+        context: z.string().max(10000).optional().describe("Rich text/markdown context for AI agents (Context Group only)"),
+        relevantFiles: z.string().max(5000).optional().describe("File paths/glob patterns, one per line (Context Group only)"),
+        dependsOn: z.array(z.string().uuid()).optional().describe("Issue UUIDs this context group depends on (CG-level DAG)"),
+        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.deliveryId && !params.productId) {
+                    return validationError("Either deliveryId or productId is required for list");
+                }
+                const fields = buildFields({ issueType: params.issueType, status: params.status, priority: params.priority });
+                const body = {
+                    action: "issue_list",
+                    fields: Object.keys(fields).length > 0 ? fields : undefined,
+                };
+                if (params.deliveryId !== undefined)
+                    body.deliveryId = params.deliveryId;
+                if (params.productId !== undefined)
+                    body.productId = params.productId;
+                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.issues, totalCount: result.totalCount });
+            }
+            case "create": {
+                if (!params.deliveryId)
+                    return validationError("deliveryId required for create");
+                if (!params.title)
+                    return validationError("title required for create");
+                const fields = buildFields(params, ['title', 'issueType', 'description', 'status', 'parentIssueId', 'priority', 'context', 'relevantFiles', 'dependsOn']);
+                const result = await callProductApi(getCreds(), {
+                    action: "issue_create",
+                    deliveryId: params.deliveryId,
+                    fields,
+                });
+                return successResult(compactEntity(result.issue, Object.keys(fields), params.returnFull));
+            }
+            case "update": {
+                if (!params.issueId)
+                    return validationError("issueId required for update");
+                const fields = buildFields(params, ['title', 'description', 'status', 'issueType', 'parentIssueId', 'priority', 'context', 'relevantFiles', 'dependsOn', 'deliveryId']);
+                if (Object.keys(fields).length === 0) {
+                    return validationError("Provide at least one field to update");
+                }
+                const result = await callProductApi(getCreds(), {
+                    action: "issue_update",
+                    issueId: params.issueId,
+                    fields,
+                });
+                return successResult(compactEntity(result.issue, Object.keys(fields), params.returnFull));
+            }
+            case "delete": {
+                if (!params.issueId)
+                    return validationError("issueId required for delete");
+                const result = await callProductApi(getCreds(), {
+                    action: "issue_delete",
+                    issueId: params.issueId,
+                });
+                return successResult(`Deleted issue ${result.deleted}`);
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+}
+//# sourceMappingURL=issueHandlers.js.map

package/dist/handlers/issueHandlers.js.map

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

package/dist/handlers/okrHandlers.d.ts

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