@telora/mcp-products 0.21.1

package/dist/handlers/connectorHandlers.js

@@ -0,0 +1,401 @@
+// ---------------------------------------------------------------------------
+// Daemon connector tool handler: telora_connector_start
+// ---------------------------------------------------------------------------
+import { join } from "node:path";
+import { existsSync, writeFileSync, mkdirSync, readFileSync, openSync } from "node:fs";
+import { spawn, execFileSync } from "node:child_process";
+import { homedir } from "node:os";
+import { z } from "zod";
+import { callProductApi, successResult, wrapHandler, } from "../shared.js";
+// Keys that always come from the fresh config (identity/auth -- may change between restarts).
+// Note: productId is NOT here -- it's been replaced by the products array.
+const IDENTITY_KEYS = ["teloraUrl", "trackerId", "organizationId"];
+/**
+ * Merge a fresh daemon config into an existing one.
+ *
+ * - Identity keys are always overwritten.
+ * - Products array: if the fresh product is already in the array, update its
+ *   repoPath if different; if missing, append the new entry.
+ * - Legacy flat `productId` + `repoPath` are migrated into the products array.
+ * - Engine sections are only added if missing.
+ * - Everything else the user has customized is preserved.
+ *
+ * Returns { config, action } where action indicates what happened:
+ *   'created'  -- first-time config (no existing file)
+ *   'added'    -- new product appended to existing config
+ *   'updated'  -- existing product's repoPath changed
+ *   'no_change' -- product already registered with same repoPath
+ */
+function mergeConfig(existing, freshProduct, fresh) {
+    const merged = { ...existing };
+    // Always overwrite identity keys
+    for (const key of IDENTITY_KEYS) {
+        if (key in fresh) {
+            merged[key] = fresh[key];
+        }
+    }
+    // Migrate legacy flat productId + repoPath into products array
+    let products = Array.isArray(merged.products)
+        ? merged.products
+        : [];
+    if (products.length === 0 && typeof merged.productId === "string" && merged.productId) {
+        // Legacy single-product config -- migrate to products array
+        const legacyRepoPath = typeof merged.repoPath === "string" ? merged.repoPath : process.cwd();
+        products = [{ id: merged.productId, repoPath: legacyRepoPath }];
+    }
+    // Remove legacy flat keys (superseded by products array)
+    delete merged.productId;
+    delete merged.repoPath;
+    // Upsert the fresh product into the array
+    let action;
+    const idx = products.findIndex((p) => p.id === freshProduct.id);
+    if (idx >= 0) {
+        if (products[idx].repoPath !== freshProduct.repoPath) {
+            products[idx] = { ...products[idx], repoPath: freshProduct.repoPath };
+            action = "updated";
+        }
+        else {
+            action = "no_change";
+        }
+    }
+    else {
+        products.push(freshProduct);
+        action = "added";
+    }
+    merged.products = products;
+    // Engines: add missing sections, never overwrite existing ones
+    const freshEngines = fresh.engines;
+    if (freshEngines) {
+        if (!merged.engines) {
+            merged.engines = freshEngines;
+        }
+        else {
+            const existingEngines = merged.engines;
+            for (const engineKey of Object.keys(freshEngines)) {
+                if (!(engineKey in existingEngines)) {
+                    existingEngines[engineKey] = freshEngines[engineKey];
+                }
+            }
+        }
+    }
+    return { config: merged, action };
+}
+/** Read the daemon PID from .telora/daemon.pid. Returns null if missing or invalid. */
+function readPidFile(teloraDir) {
+    const pidPath = join(teloraDir, "daemon.pid");
+    try {
+        const raw = readFileSync(pidPath, "utf-8").trim();
+        const pid = parseInt(raw, 10);
+        return Number.isFinite(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Check if a process is alive (signal 0 existence check). */
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Stop the daemon gracefully: SIGTERM, poll for exit, SIGKILL fallback. */
+async function stopDaemon(teloraDir) {
+    const pid = readPidFile(teloraDir);
+    if (pid === null) {
+        return { stopped: false, message: "No PID file found" };
+    }
+    if (!isProcessAlive(pid)) {
+        return { stopped: false, pid, message: "Process not running" };
+    }
+    // Send SIGTERM
+    try {
+        process.kill(pid, "SIGTERM");
+    }
+    catch {
+        return { stopped: false, pid, message: "Failed to send SIGTERM" };
+    }
+    // Poll every 300ms for up to 10s
+    const deadline = Date.now() + 10_000;
+    while (Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, 300));
+        if (!isProcessAlive(pid)) {
+            return { stopped: true, pid, message: "Stopped with SIGTERM" };
+        }
+    }
+    // SIGKILL fallback
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        // Process may have exited between last check and kill
+        if (!isProcessAlive(pid)) {
+            return { stopped: true, pid, message: "Stopped with SIGTERM (late exit)" };
+        }
+        return { stopped: false, pid, message: "Failed to send SIGKILL" };
+    }
+    // Brief wait after SIGKILL
+    await new Promise((resolve) => setTimeout(resolve, 500));
+    return { stopped: true, pid, message: "Stopped with SIGKILL" };
+}
+export function registerConnectorTools(server, getCreds, profile = 'full') {
+    // -- telora_connector_start -------------------------------------------------
+    server.tool("telora_connector_start", "Daemon automation: generate configuration and launch the Telora daemon for autonomous agent execution. " +
+        "Creates daemon.json with API credentials and engine settings, then starts the background process.", {
+        productId: z.string().uuid().optional().describe("Product UUID to scope this daemon to. Required when the organization has multiple products. Auto-detected when there is only one product."),
+    }, wrapHandler(async ({ productId: explicitProductId }) => {
+        const creds = getCreds();
+        // Call whoami to get org ID and tracker info
+        const whoami = await callProductApi(creds, {
+            action: "whoami",
+        });
+        // Resolve productId — required so the daemon only picks up work for this repo's product
+        const productId = explicitProductId;
+        if (!productId) {
+            const productsResult = await callProductApi(creds, {
+                action: "product_list",
+            });
+            if (productsResult.products.length === 0) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: "No products found in your organization. Create a product first with telora_product_create, then re-run telora_connector_start.",
+                        }],
+                };
+            }
+            const productList = productsResult.products
+                .map((p) => `  - ${p.name}: ${p.id}`)
+                .join("\n");
+            return {
+                content: [{
+                        type: "text",
+                        text: `The daemon must be scoped to a specific product. ` +
+                            `Determine which product this repository belongs to, then call telora_connector_start again with the productId parameter.\n\n` +
+                            `Available products:\n${productList}\n\n` +
+                            `If this repository needs a new product, create one with telora_product_create first.`,
+                    }],
+            };
+        }
+        // Build the fresh config skeleton (no secrets -- safe to commit).
+        // Uses the unified engines section format so both strategy and factory
+        // engines are enabled by default. The products array replaces the flat
+        // productId so one daemon can serve multiple repos.
+        const repoPath = process.cwd();
+        const freshProduct = { id: productId, repoPath };
+        const freshConfig = {
+            teloraUrl: creds.teloraUrl,
+            trackerId: whoami.trackerId,
+            organizationId: whoami.organizationId,
+            products: [freshProduct],
+            sessionTimeoutMs: 3600000,
+            engines: {
+                strategy: {
+                    integrationBranch: "integration",
+                    maxTotalSessions: 5,
+                    tokenLimit: 200000,
+                    costLimit: 10.0,
+                },
+                factory: {
+                    maxConcurrentInstances: 3,
+                },
+            },
+        };
+        // 1. Resolve config path:
+        //    - Prefer global ~/.telora/daemon.json when it already exists
+        //      (multi-product: one daemon config for all repos)
+        //    - Fall back to repo-local .telora/daemon.json for first-time setup
+        const globalTeloraDir = join(homedir(), ".telora");
+        const globalConfigPath = join(globalTeloraDir, "daemon.json");
+        const localTeloraDir = join(repoPath, ".telora");
+        const localConfigPath = join(localTeloraDir, "daemon.json");
+        const useGlobal = existsSync(globalConfigPath);
+        const configPath = useGlobal ? globalConfigPath : localConfigPath;
+        const teloraDir = useGlobal ? globalTeloraDir : localTeloraDir;
+        mkdirSync(teloraDir, { recursive: true });
+        // 2. Merge with existing config to preserve user customizations
+        let finalConfig;
+        let mergeAction;
+        if (existsSync(configPath)) {
+            try {
+                const existing = JSON.parse(readFileSync(configPath, "utf-8"));
+                const result = mergeConfig(existing, freshProduct, freshConfig);
+                finalConfig = result.config;
+                mergeAction = result.action;
+            }
+            catch {
+                // Existing file is corrupt/unparseable -- overwrite with fresh config
+                finalConfig = freshConfig;
+                mergeAction = "created";
+            }
+        }
+        else {
+            finalConfig = freshConfig;
+            mergeAction = "created";
+        }
+        writeFileSync(configPath, JSON.stringify(finalConfig, null, 2) + "\n");
+        const productCount = Array.isArray(finalConfig.products)
+            ? finalConfig.products.length
+            : 1;
+        // 3. Ensure .telora/ is in .gitignore (only for repo-local config)
+        let gitignoreUpdated = false;
+        if (!useGlobal) {
+            const gitignorePath = join(repoPath, ".gitignore");
+            if (existsSync(gitignorePath)) {
+                const content = readFileSync(gitignorePath, "utf-8");
+                if (!content.split("\n").some((line) => line.trim() === ".telora/")) {
+                    writeFileSync(gitignorePath, content.trimEnd() + "\n.telora/\n");
+                    gitignoreUpdated = true;
+                }
+            }
+            else {
+                writeFileSync(gitignorePath, ".telora/\n");
+                gitignoreUpdated = true;
+            }
+        }
+        // 4. If nothing changed, check if daemon is actually running.
+        //    If alive, return early so running agent work is not disrupted.
+        //    If dead (stale PID file), clean up and fall through to start a new one.
+        if (mergeAction === "no_change") {
+            const existingPid = readPidFile(globalTeloraDir) ?? readPidFile(localTeloraDir);
+            if (existingPid && isProcessAlive(existingPid)) {
+                return successResult({
+                    status: "already_running",
+                    configAction: mergeAction,
+                    productCount,
+                    configPath,
+                    pid: existingPid,
+                    gitignoreUpdated,
+                    organizationId: whoami.organizationId,
+                    productId,
+                });
+            }
+            // Stale PID file -- process is dead. Clean up and start fresh.
+        }
+        // 5. Stop any running daemon before starting a new one (restart for config changes).
+        //    Check both global and local .telora dirs for PID file.
+        let stopResult = await stopDaemon(globalTeloraDir);
+        if (!stopResult.stopped) {
+            stopResult = await stopDaemon(localTeloraDir);
+        }
+        const previousPid = stopResult.stopped ? stopResult.pid : undefined;
+        // 6. Start the daemon as a detached background process.
+        //    Prefer the local build so edits take effect after a local build.
+        //    Fall back to the global install if no local build exists.
+        const logPath = join(teloraDir, "daemon.log");
+        const logFd = openSync(logPath, "a");
+        const localDaemonPath = join(process.cwd(), "packages/daemon/dist/index.js");
+        // Find global install via `which` (works regardless of npm prefix)
+        let globalDaemonPath = null;
+        try {
+            globalDaemonPath = execFileSync("which", ["telora-daemon"], { encoding: "utf-8" }).trim() || null;
+        }
+        catch {
+            // Not on PATH — check the common ~/.npm-global location as fallback
+            const fallback = join(homedir(), ".npm-global/bin/telora-daemon");
+            if (existsSync(fallback))
+                globalDaemonPath = fallback;
+        }
+        let daemonCommand;
+        let daemonArgs;
+        let daemonSource;
+        // Pass --config when using global config so the daemon finds it
+        const configArgs = useGlobal ? ["--config", configPath] : [];
+        if (existsSync(localDaemonPath)) {
+            daemonCommand = process.execPath;
+            daemonArgs = [localDaemonPath, "--no-auto-update", ...configArgs];
+            daemonSource = "local";
+        }
+        else if (globalDaemonPath) {
+            daemonCommand = globalDaemonPath;
+            daemonArgs = [...configArgs];
+            daemonSource = "global";
+        }
+        else {
+            return {
+                content: [{
+                        type: "text",
+                        text: "Could not locate telora-daemon. " +
+                            `No local build at ${localDaemonPath} and telora-daemon is not on PATH. ` +
+                            "Install globally with: npm install -g @telora/daemon",
+                    }],
+            };
+        }
+        const daemonProcess = spawn(daemonCommand, daemonArgs, {
+            detached: true,
+            stdio: ["ignore", logFd, logFd],
+            env: { ...process.env, TELORA_TRACKER_ID: whoami.trackerId },
+            cwd: process.cwd(),
+        });
+        const pid = daemonProcess.pid;
+        daemonProcess.unref();
+        // 6. Wait briefly and verify the daemon is still running.
+        //    If it exits immediately (config error, binary not found, etc.),
+        //    read the log tail and return an actionable error instead of false success.
+        await new Promise((resolve) => setTimeout(resolve, 3000));
+        let alive = false;
+        try {
+            process.kill(pid, 0); // signal 0 = existence check only
+            alive = true;
+        }
+        catch {
+            // ESRCH = no such process
+        }
+        if (!alive) {
+            let logTail = "";
+            try {
+                const logContent = readFileSync(logPath, "utf-8");
+                const lines = logContent.trim().split("\n");
+                logTail = lines.slice(-30).join("\n");
+            }
+            catch { /* ignore */ }
+            return {
+                content: [{
+                        type: "text",
+                        text: `Daemon process (PID ${pid}) exited immediately after start.\n\n` +
+                            `Last log output:\n${logTail || "(no log output — check " + logPath + ")"}`,
+                    }],
+            };
+        }
+        return successResult({
+            status: "started",
+            configAction: mergeAction,
+            productCount,
+            configPath,
+            logPath,
+            pid,
+            previousPid,
+            gitignoreUpdated,
+            organizationId: whoami.organizationId,
+            productId,
+            daemonSource,
+        });
+    }));
+    // -- telora_connector_stop --------------------------------------------------
+    if (profile !== 'human') {
+        server.tool("telora_connector_stop", "Daemon lifecycle: stop the running Telora daemon gracefully (SIGTERM with SIGKILL fallback).", {}, wrapHandler(async () => {
+            // Try global config location first, fall back to repo-local
+            const globalTeloraDir = join(homedir(), ".telora");
+            let result = await stopDaemon(globalTeloraDir);
+            if (!result.stopped) {
+                const localTeloraDir = join(process.cwd(), ".telora");
+                result = await stopDaemon(localTeloraDir);
+            }
+            if (result.stopped) {
+                return successResult({
+                    status: "stopped",
+                    pid: result.pid,
+                    message: result.message,
+                });
+            }
+            return successResult({
+                status: "not_running",
+                pid: result.pid,
+                message: result.message,
+            });
+        }));
+    }
+}
+//# sourceMappingURL=connectorHandlers.js.map

package/dist/handlers/connectorHandlers.js.map

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

package/dist/handlers/contextHandlers.d.ts

@@ -0,0 +1,8 @@
+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.
+ */
+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

@@ -0,0 +1,169 @@
+// ---------------------------------------------------------------------------
+// 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)
+// ---------------------------------------------------------------------------
+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.
+ */
+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.", {
+        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)"),
+    }, wrapHandler(async (params) => {
+        if (!params.productId)
+            return validationError("productId is required");
+        const body = {
+            action: "context_assemble",
+            productId: params.productId,
+        };
+        if (params.strategyId)
+            body.strategyId = params.strategyId;
+        if (params.deliveryId)
+            body.deliveryId = params.deliveryId;
+        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

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

package/dist/handlers/deliveryHandlers.d.ts

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