@telora/mcp-products 0.21.1

package/dist/handlers/deliveryHandlers.js

@@ -0,0 +1,122 @@
+// ---------------------------------------------------------------------------
+// Delivery tool handler (consolidated):
+//   telora_product_delivery (list | create | update | operationalize | delete | reorder)
+// ---------------------------------------------------------------------------
+import { z } from "zod";
+import { callProductApi, successResult, validationError, buildFields, wrapHandler, compactEntity, } from "../shared.js";
+export function registerDeliveryTools(server, getCreds) {
+    server.tool("telora_product_delivery", "Work packages: individual shippable increments within a strategy. Each delivery has acceptance criteria, " +
+        "technical context, and tracks progress through issues. " +
+        "Actions: list deliveries (filter by status/strategy), create a delivery (name + productId), " +
+        "update delivery fields (description, criteria, status), operationalize (attach to org tree), delete, reorder priority.", {
+        action: z.enum(["list", "create", "update", "operationalize", "delete", "reorder"]).describe("Action to perform"),
+        productId: z.string().uuid().optional().describe("Product UUID (required for list, create, reorder)"),
+        deliveryId: z.string().uuid().optional().describe("Delivery UUID (required for update, operationalize, delete)"),
+        name: z.string().max(200).optional().describe("Delivery name (required for create)"),
+        description: z.string().max(2000).optional().describe("What this delivery achieves"),
+        targetDate: z.string().optional().describe("Target date (ISO 8601)"),
+        acceptanceCriteria: z.string().max(4000).optional().describe("Definition of done / success criteria"),
+        techContext: z.string().max(4000).optional().describe("Technical context: stack, repos, key files, architecture notes"),
+        strategyId: z.string().uuid().nullable().optional().describe("Strategy UUID to link (create/update), null to unlink (update)"),
+        executionStatus: z.enum(["draft", "planning", "iterating", "queued", "coding", "verify", "in_review", "done", "paused", "cancelled"]).optional().describe("Execution status (update: new status; list: filter)"),
+        parentNodeId: z.string().uuid().optional().describe("Target org unit or stream UUID (operationalize only)"),
+        deliveryIds: z.array(z.string().uuid()).optional().describe("Ordered array of delivery UUIDs for reorder (first = rank 0 = highest priority)"),
+        includeIssueCounts: z.boolean().optional().describe("Include done/total issue counts per delivery (list only)"),
+        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({ status: params.executionStatus });
+                const body = {
+                    action: "delivery_list",
+                    productId: params.productId,
+                    fields: Object.keys(fields).length > 0 ? fields : undefined,
+                };
+                if (params.strategyId !== undefined)
+                    body.strategyId = params.strategyId;
+                if (params.includeIssueCounts !== undefined)
+                    body.includeIssueCounts = params.includeIssueCounts;
+                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.deliveries, totalCount: result.totalCount, context_available: true });
+            }
+            case "create": {
+                if (!params.productId)
+                    return validationError("productId required for create");
+                if (!params.name)
+                    return validationError("name required for create");
+                const fields = buildFields(params, ['name', 'description', 'targetDate', 'acceptanceCriteria', 'techContext']);
+                fields.executionStatus = 'planning';
+                const body = {
+                    action: "delivery_create",
+                    productId: params.productId,
+                    fields,
+                };
+                if (params.strategyId !== undefined)
+                    body.strategyId = params.strategyId;
+                const result = await callProductApi(getCreds(), body);
+                return successResult(compactEntity(result.delivery, Object.keys(fields), params.returnFull));
+            }
+            case "update": {
+                if (!params.deliveryId)
+                    return validationError("deliveryId required for update");
+                const fields = buildFields(params, ['name', 'description', 'targetDate', 'acceptanceCriteria', 'techContext', 'strategyId', 'executionStatus']);
+                if (Object.keys(fields).length === 0) {
+                    return validationError("Provide at least one field to update");
+                }
+                const result = await callProductApi(getCreds(), {
+                    action: "delivery_update",
+                    deliveryId: params.deliveryId,
+                    fields,
+                });
+                return successResult(compactEntity(result.delivery, Object.keys(fields), params.returnFull));
+            }
+            case "operationalize": {
+                if (!params.deliveryId)
+                    return validationError("deliveryId required for operationalize");
+                if (!params.parentNodeId)
+                    return validationError("parentNodeId required for operationalize");
+                const result = await callProductApi(getCreds(), {
+                    action: "delivery_operationalize",
+                    deliveryId: params.deliveryId,
+                    parentNodeId: params.parentNodeId,
+                });
+                return successResult(compactEntity(result.delivery, [], params.returnFull));
+            }
+            case "delete": {
+                if (!params.deliveryId)
+                    return validationError("deliveryId required for delete");
+                const result = await callProductApi(getCreds(), {
+                    action: "delivery_delete",
+                    deliveryId: params.deliveryId,
+                });
+                return successResult(result);
+            }
+            case "reorder": {
+                if (!params.productId)
+                    return validationError("productId required for reorder");
+                if (!params.deliveryIds)
+                    return validationError("deliveryIds required for reorder");
+                const result = await callProductApi(getCreds(), {
+                    action: "delivery_reorder",
+                    productId: params.productId,
+                    deliveryIds: params.deliveryIds,
+                });
+                return successResult(result.deliveries);
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+}
+//# sourceMappingURL=deliveryHandlers.js.map

package/dist/handlers/deliveryHandlers.js.map

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

package/dist/handlers/deploymentProfileHandlers.d.ts

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

package/dist/handlers/deploymentProfileHandlers.js

@@ -0,0 +1,104 @@
+// ---------------------------------------------------------------------------
+// Deployment Profile tool handler (consolidated):
+//   telora_deployment_profile (create | list | get | update | link_to_product)
+// ---------------------------------------------------------------------------
+import { z } from "zod";
+import { callProductApi, successResult, validationError, wrapHandler, } from "../shared.js";
+export function registerDeploymentProfileTools(server, getCreds) {
+    server.tool("telora_deployment_profile", "CI/CD configuration: deployment profiles define target environments and deployment guidelines for factory builds. " +
+        "Profiles contain inception prompts (full deploy detail for first cycle) and terse guidelines (ongoing AI context). " +
+        "Actions: create a profile (name required), list, get details, update settings, " +
+        "link_to_product (attach profile to product, null to unlink).", {
+        action: z.enum(["create", "list", "get", "update", "link_to_product"]).describe("Action to perform"),
+        id: z.string().uuid().optional().describe("Deployment profile UUID (required for get, update)"),
+        productId: z.string().uuid().optional().describe("Product UUID (required for link_to_product)"),
+        profileId: z.string().uuid().nullable().optional().describe("Profile UUID to link (link_to_product only, null to unlink)"),
+        name: z.string().max(200).optional().describe("Profile name (required for create)"),
+        description: z.string().max(2000).optional().describe("Short description of this deployment target"),
+        inceptionPrompt: z.string().optional().describe("Full deployment detail for first factory cycle"),
+        guidelines: z.string().optional().describe("Terse constraint summary for ongoing AI context injection"),
+        isDeleted: z.boolean().optional().describe("Archive (true) or restore (false) the profile (update only)"),
+        includeArchived: z.boolean().optional().describe("Include archived profiles in list results (default: false)"),
+        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)"),
+        returnFull: z.boolean().optional().describe("Return full entity (default: compact)"),
+    }, wrapHandler(async (params) => {
+        switch (params.action) {
+            case "create": {
+                if (!params.name)
+                    return validationError("name required for create");
+                const result = await callProductApi(getCreds(), {
+                    action: "deployment_profile_create",
+                    fields: {
+                        name: params.name,
+                        ...(params.description !== undefined && { description: params.description }),
+                        ...(params.inceptionPrompt !== undefined && { inceptionPrompt: params.inceptionPrompt }),
+                        ...(params.guidelines !== undefined && { guidelines: params.guidelines }),
+                        returnFull: params.returnFull,
+                    },
+                });
+                return successResult(result.deploymentProfile);
+            }
+            case "list": {
+                const body = { action: "deployment_profile_list" };
+                if (params.includeArchived !== undefined)
+                    body.fields = { includeArchived: params.includeArchived };
+                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.deploymentProfiles, totalCount: result.totalCount });
+            }
+            case "get": {
+                if (!params.id)
+                    return validationError("id required for get");
+                const result = await callProductApi(getCreds(), {
+                    action: "deployment_profile_get",
+                    deploymentProfileId: params.id,
+                });
+                return successResult(result.deploymentProfile);
+            }
+            case "update": {
+                if (!params.id)
+                    return validationError("id required for update");
+                const fields = {};
+                if (params.name !== undefined)
+                    fields.name = params.name;
+                if (params.description !== undefined)
+                    fields.description = params.description;
+                if (params.inceptionPrompt !== undefined)
+                    fields.inceptionPrompt = params.inceptionPrompt;
+                if (params.guidelines !== undefined)
+                    fields.guidelines = params.guidelines;
+                if (params.isDeleted !== undefined)
+                    fields.isDeleted = params.isDeleted;
+                fields.returnFull = params.returnFull;
+                if (Object.keys(fields).length === 1 && "returnFull" in fields) {
+                    return validationError("Provide at least one field to update");
+                }
+                const result = await callProductApi(getCreds(), {
+                    action: "deployment_profile_update",
+                    deploymentProfileId: params.id,
+                    fields,
+                });
+                return successResult(result.deploymentProfile);
+            }
+            case "link_to_product": {
+                if (!params.productId)
+                    return validationError("productId required for link_to_product");
+                const body = {
+                    action: "deployment_profile_link_to_product",
+                    productId: params.productId,
+                };
+                if (params.profileId !== undefined)
+                    body.deploymentProfileId = params.profileId ?? undefined;
+                const result = await callProductApi(getCreds(), body);
+                return successResult(result);
+            }
+            default:
+                return validationError(`Unknown action: ${params.action}`);
+        }
+    }));
+}
+//# sourceMappingURL=deploymentProfileHandlers.js.map

package/dist/handlers/deploymentProfileHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploymentProfileHandlers.js","sourceRoot":"","sources":["../../src/handlers/deploymentProfileHandlers.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kDAAkD;AAClD,+EAA+E;AAC/E,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,8BAA8B,CAC5C,MAAiB,EACjB,QAAkB;IAElB,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,oHAAoH;QACpH,qHAAqH;QACrH,iFAAiF;QACjF,8DAA8D,EAC9D;QACE,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACpG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;QAC/F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC/F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;QAC1H,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QACnF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACpG,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;QACjG,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2DAA2D,CAAC;QACvG,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;QACzG,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;QAC9G,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC9F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;QAC5F,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACrF,EACD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QAC3B,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,IAAI;oBAAE,OAAO,eAAe,CAAC,0BAA0B,CAAC,CAAC;gBACrE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE;oBAC9C,MAAM,EAAE,2BAA2B;oBACnC,MAAM,EAAE;wBACN,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,GAAG,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;wBAC5E,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;wBACxF,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;wBACzE,UAAU,EAAE,MAAM,CAAC,UAAU;qBAC9B;iBACF,CAAmD,CAAC;gBACrD,OAAO,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,IAAI,GAA4B,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;gBAC5E,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS;oBAAE,IAAI,CAAC,MAAM,GAAG,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC;gBACpG,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;oBAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;gBAC1D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;oBAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBAC7D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE,IAAI,CAGnD,CAAC;gBACF,OAAO,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,kBAAkB,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;YAC5F,CAAC;YACD,KAAK,KAAK,CAAC,CAAC,CAAC;gBACX,IAAI,CAAC,MAAM,CAAC,EAAE;oBAAE,OAAO,eAAe,CAAC,qBAAqB,CAAC,CAAC;gBAC9D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE;oBAC9C,MAAM,EAAE,wBAAwB;oBAChC,mBAAmB,EAAE,MAAM,CAAC,EAAE;iBAC/B,CAAmD,CAAC;gBACrD,OAAO,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,IAAI,CAAC,MAAM,CAAC,EAAE;oBAAE,OAAO,eAAe,CAAC,wBAAwB,CAAC,CAAC;gBACjE,MAAM,MAAM,GAA4B,EAAE,CAAC;gBAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;gBACzD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;oBAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;gBAC9E,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS;oBAAE,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;gBAC1F,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;oBAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;gBAC3E,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;oBAAE,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;gBACxE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;gBACtC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;oBAC/D,OAAO,eAAe,CAAC,sCAAsC,CAAC,CAAC;gBACjE,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE;oBAC9C,MAAM,EAAE,2BAA2B;oBACnC,mBAAmB,EAAE,MAAM,CAAC,EAAE;oBAC9B,MAAM;iBACP,CAAmD,CAAC;gBACrD,OAAO,aAAa,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,IAAI,CAAC,MAAM,CAAC,SAAS;oBAAE,OAAO,eAAe,CAAC,wCAAwC,CAAC,CAAC;gBACxF,MAAM,IAAI,GAA4B;oBACpC,MAAM,EAAE,oCAAoC;oBAC5C,SAAS,EAAE,MAAM,CAAC,SAAS;iBAC5B,CAAC;gBACF,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;oBAAE,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,SAAS,IAAI,SAAS,CAAC;gBAC7F,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,EAAE,IAAI,CAGnD,CAAC;gBACF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;YACD;gBACE,OAAO,eAAe,CAAC,mBAAmB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/handlers/discoverHandler.d.ts

@@ -0,0 +1,23 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Per-tool metadata for the toolIndex */
+export interface ToolIndexEntry {
+    name: string;
+    summary: string;
+    actions: string[];
+    keywords: string[];
+}
+/** Domain definitions: name -> description + registration thunk + tool index */
+export interface DomainDef {
+    description: string;
+    keywords: string[];
+    toolIndex: ToolIndexEntry[];
+    register: () => void;
+}
+export type DomainRegistry = Record<string, DomainDef>;
+/** Startup domains that are always loaded (shown in list for completeness) */
+export interface StartupDomain {
+    description: string;
+    keywords: string[];
+    toolIndex: ToolIndexEntry[];
+}
+export declare function registerDiscoverTool(server: McpServer, domains: DomainRegistry, startupDomains?: Record<string, StartupDomain>): void;

package/dist/handlers/discoverHandler.js

@@ -0,0 +1,83 @@
+// ---------------------------------------------------------------------------
+// telora_discover -- dynamic tool loading for the human profile
+//
+// In the human profile, only core tools (product, strategy, delivery, issue)
+// are registered at startup. All other tool domains are deferred and loaded
+// on demand via this meta-tool, which calls the relevant registerXxxTools()
+// and then notifies the client via sendToolListChanged().
+// ---------------------------------------------------------------------------
+import { z } from "zod";
+import { successResult, validationError, wrapHandler } from "../shared.js";
+export function registerDiscoverTool(server, domains, startupDomains) {
+    const loaded = new Set();
+    const domainNames = Object.keys(domains);
+    const startupNames = Object.keys(startupDomains ?? {});
+    // Build domain catalog for the tool description
+    const domainCatalog = domainNames
+        .map((d) => `  ${d}: ${domains[d].description}`)
+        .join("\n");
+    // Collect all keywords for discover tool description (helps ToolSearch find this tool)
+    const allKeywords = new Set();
+    for (const d of domainNames) {
+        for (const kw of domains[d].keywords)
+            allKeywords.add(kw);
+    }
+    server.tool("telora_discover", "Load additional Telora tool domains on demand. At startup only core tools " +
+        "(product, strategy, delivery, issue) are available. Use this to load domains for: " +
+        [...allKeywords].join(", ") + ".\n\n" +
+        "Available domains:\n" + domainCatalog + "\n\n" +
+        "Use action 'list' to see all domains with their tool indexes (what tools and actions each domain provides). " +
+        "Use action 'load' with a domain name or 'all' to load tools.", {
+        action: z.enum(["list", "load"]).describe("'list' shows domain status with tool indexes; 'load' registers tools for a domain"),
+        domain: z.string().optional()
+            .describe("Domain to load (required for 'load' action). Use 'all' to load everything."),
+    }, wrapHandler(async (params) => {
+        if (params.action === "list") {
+            const alwaysLoaded = startupNames.map((d) => ({
+                domain: d,
+                loaded: true,
+                alwaysLoaded: true,
+                description: startupDomains[d].description,
+                keywords: startupDomains[d].keywords,
+                toolIndex: startupDomains[d].toolIndex,
+            }));
+            const onDemand = domainNames.map((d) => ({
+                domain: d,
+                loaded: loaded.has(d),
+                alwaysLoaded: false,
+                description: domains[d].description,
+                keywords: domains[d].keywords,
+                toolIndex: domains[d].toolIndex,
+            }));
+            return successResult({ domains: [...alwaysLoaded, ...onDemand] });
+        }
+        // action === "load"
+        if (!params.domain) {
+            return validationError("domain is required for load action");
+        }
+        if (params.domain !== "all" && !domainNames.includes(params.domain)) {
+            return validationError(`Unknown domain '${params.domain}'. Available: ${domainNames.join(", ")}, all`);
+        }
+        const toLoad = params.domain === "all"
+            ? domainNames.filter((d) => !loaded.has(d))
+            : loaded.has(params.domain)
+                ? []
+                : [params.domain];
+        if (toLoad.length === 0) {
+            const msg = params.domain === "all"
+                ? "All domains already loaded."
+                : `Domain '${params.domain}' is already loaded.`;
+            return successResult({ message: msg, loaded: [...loaded] });
+        }
+        for (const d of toLoad) {
+            domains[d].register();
+            loaded.add(d);
+        }
+        server.sendToolListChanged();
+        return successResult({
+            message: `Loaded ${toLoad.length} domain(s): ${toLoad.join(", ")}`,
+            loaded: [...loaded],
+        });
+    }));
+}
+//# sourceMappingURL=discoverHandler.js.map

package/dist/handlers/discoverHandler.js.map

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

package/dist/handlers/factoryHandlers.d.ts

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