clinkx 0.2.0 → 0.2.1

package/clinkx-workflows/dist/workflow-receipt.js

@@ -0,0 +1,177 @@
+export const RECEIPT_SEPARATOR = "--- workflow receipt ---";
+export const RECEIPT_MAX_CHARS = 1200;
+const STAGE_NAME_WIDTH = 16;
+const STAGE_STATE_WIDTH = 3;
+const STAGE_CALLS_WIDTH = 5;
+const ANSI_PATTERN = /\u001B(?:[@-Z\\-_]|\[[0-?]*[ -/]*[@-~])/g;
+export function renderWorkflowReceipt(summary) {
+    const prefixLines = [
+        RECEIPT_SEPARATOR,
+        renderHeader(summary),
+        "",
+        ...summary.stages.map(renderStageLine),
+    ];
+    const cardSection = renderCardSection(summary.card);
+    const failureSection = renderFailureSection(summary);
+    const composed = joinReceiptLines(prefixLines, cardSection.requiredLines, fitOptionalLines(prefixLines, cardSection.requiredLines, cardSection.optionalLines, failureSection.requiredLines), failureSection.requiredLines);
+    if (composed.length <= RECEIPT_MAX_CHARS) {
+        return composed;
+    }
+    const codePoints = Array.from(composed);
+    return codePoints.slice(0, RECEIPT_MAX_CHARS - 3).join("") + "...";
+}
+function renderHeader(summary) {
+    const totalCalls = summary.stages.reduce((sum, stage) => sum + stage.completedCalls, 0);
+    const wallSeconds = formatSeconds(diffSeconds(summary.attemptStartedAt, summary.attemptCompletedAt));
+    return [
+        normalizeInlineText(summary.workflow.name),
+        normalizeInlineText(summary.runId),
+        `${summary.stages.length} stages`,
+        `${totalCalls} calls`,
+        `wall ${wallSeconds}`,
+    ].join(" · ");
+}
+function renderStageLine(stage) {
+    const base = [
+        normalizeInlineText(stage.label).padEnd(STAGE_NAME_WIDTH, " "),
+        normalizeInlineText(stage.state).padEnd(STAGE_STATE_WIDTH, " "),
+        `${stage.completedCalls}/${stage.totalCalls}`.padEnd(STAGE_CALLS_WIDTH, " "),
+        formatSeconds(Math.round(stage.wallDurationMs / 1000)),
+    ].join(" ");
+    if (stage.retryEvents <= 0) {
+        return base;
+    }
+    return `${base}   retry x${stage.retryEvents}`;
+}
+function renderCardSection(card) {
+    switch (card.kind) {
+        case "council-default": {
+            const headerLine = joinParts([
+                card.confidence != null ? `confidence ${card.confidence}` : undefined,
+                card.selectedApproach != null ? `selected ${normalizeInlineText(card.selectedApproach)}` : undefined,
+            ]);
+            return {
+                requiredLines: compactLines([
+                    headerLine,
+                    `agreements: ${card.agreements} · disagreements: ${card.disagreements}`,
+                ]),
+                optionalLines: [],
+            };
+        }
+        case "council-code-review":
+            return {
+                requiredLines: [
+                    joinParts([
+                        normalizeInlineText(card.status),
+                        card.confidence != null ? `confidence ${card.confidence}` : undefined,
+                    ]),
+                    `blocking: ${card.blockingCount} · non-blocking: ${card.nonBlockingCount} · tests: ${card.testsCount}`,
+                ],
+                optionalLines: renderNumberedLines(card.topBlockingIssues),
+            };
+        case "council-debug":
+            return {
+                requiredLines: compactLines([
+                    joinParts([
+                        card.confidence != null ? `confidence ${card.confidence}` : undefined,
+                        card.riskLevel != null ? `risk ${normalizeInlineText(card.riskLevel)}` : undefined,
+                    ]),
+                    "hypotheses:",
+                ]),
+                optionalLines: renderNumberedLines(card.topHypotheses),
+            };
+        case "council-discover":
+            return {
+                requiredLines: compactLines([
+                    joinParts([
+                        card.confidence != null ? `confidence ${card.confidence}` : undefined,
+                        `open questions: ${card.openQuestionCount}`,
+                    ]),
+                    "findings:",
+                ]),
+                optionalLines: renderNumberedLines(card.topFindings),
+            };
+        case "council-answer":
+            return {
+                requiredLines: compactLines([
+                    joinParts([
+                        card.confidence != null ? `confidence ${card.confidence}` : undefined,
+                        `caveats: ${card.caveatCount}`,
+                    ]),
+                ]),
+                optionalLines: renderNumberedLines(card.topCaveats),
+            };
+        case "generic":
+            return { requiredLines: [], optionalLines: [] };
+    }
+}
+function renderFailureSection(summary) {
+    if (summary.failure == null) {
+        return { requiredLines: [], optionalLines: [] };
+    }
+    return {
+        requiredLines: [
+            `FAILED at ${normalizeInlineText(summary.failure.location)} · ${normalizeInlineText(summary.failure.failureClass)}`,
+            `  ${normalizeInlineText(summary.failure.message)}`,
+            `resumable: ${summary.resumable ? "yes" : "no"}`,
+        ],
+        optionalLines: [],
+    };
+}
+function fitOptionalLines(prefixLines, cardRequiredLines, cardOptionalLines, failureRequiredLines) {
+    const chosen = [];
+    for (const line of cardOptionalLines) {
+        const candidate = joinReceiptLines(prefixLines, cardRequiredLines, [...chosen, line], failureRequiredLines);
+        if (candidate.length > RECEIPT_MAX_CHARS) {
+            break;
+        }
+        chosen.push(line);
+    }
+    return chosen;
+}
+function joinReceiptLines(prefixLines, cardRequiredLines, cardOptionalLines, failureRequiredLines) {
+    const lines = [...prefixLines];
+    if (cardRequiredLines.length > 0 || cardOptionalLines.length > 0) {
+        lines.push("");
+        lines.push(...cardRequiredLines);
+        lines.push(...cardOptionalLines);
+    }
+    if (failureRequiredLines.length > 0) {
+        lines.push("");
+        lines.push(...failureRequiredLines);
+    }
+    return lines.join("\n");
+}
+function renderNumberedLines(items) {
+    return items
+        .map((item, index) => {
+        const text = normalizeInlineText(item);
+        return text.length > 0 ? `  ${index + 1}. ${text}` : "";
+    })
+        .filter((line) => line.length > 0);
+}
+function normalizeInlineText(value) {
+    return value
+        .replace(ANSI_PATTERN, "")
+        .replace(/\r?\n+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function joinParts(parts) {
+    return parts.filter((part) => part != null && part.length > 0).join(" · ");
+}
+function compactLines(lines) {
+    return lines.filter((line) => line != null && line.length > 0);
+}
+function diffSeconds(startedAt, completedAt) {
+    const started = Date.parse(startedAt);
+    const completed = Date.parse(completedAt);
+    if (!Number.isFinite(started) || !Number.isFinite(completed)) {
+        return 0;
+    }
+    return Math.max(0, Math.round((completed - started) / 1000));
+}
+function formatSeconds(seconds) {
+    return `${Math.max(0, seconds)}s`;
+}
+//# sourceMappingURL=workflow-receipt.js.map

package/clinkx-workflows/dist/workflow-receipt.js.map

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

package/clinkx-workflows/dist/workflow-tools.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Reusable workflow tool registration for any MCP Server instance.
+ *
+ * Extracted from server.ts to allow both:
+ * - Standalone STDIO server (ClinkSession child process backend)
+ * - In-process integration (LocalClinkBackend via root ClinkX)
+ *
+ * The `registerWorkflowTools()` function registers three tools on a Server:
+ * - run_workflow: start a new workflow execution
+ * - resume_workflow: resume a failed/cancelled run
+ * - list_workflows: list available workflow definitions
+ *
+ * The caller provides a `createBackend` factory that determines how clink
+ * calls are dispatched — either via child process or in-process.
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { ClinkBackend } from "./backend.js";
+export interface WorkflowToolsOptions {
+    /**
+     * Factory that creates a ClinkBackend for a given run.
+     * For standalone server: `(runId) => new ClinkSession({ runId })`
+     * For in-process: `(runId) => new LocalClinkBackend(...)`
+     */
+    readonly createBackend: (runId: string) => ClinkBackend;
+    /** Override templates root path (default: from config). */
+    readonly templatesRoot?: string | undefined;
+    /** Override workflows search path. */
+    readonly workflowsPath?: string | undefined;
+}
+/**
+ * Humanize a stage ID: replace underscores with spaces, capitalize first letter only.
+ * e.g. "cross_review" → "Cross review", "ranking_analysis" → "Ranking analysis"
+ */
+export declare function humanizeStageId(id: string): string;
+/** MCP tool definition shape (matches SDK's Tool type). */
+export interface WorkflowToolDefinition {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly annotations?: Record<string, unknown> | undefined;
+}
+/**
+ * Return the three workflow tool definitions for tools/list.
+ *
+ * Dynamically discovers available workflows to include in the
+ * run_workflow description. Safe to call repeatedly — no side effects.
+ */
+export declare function getWorkflowToolDefinitions(): WorkflowToolDefinition[];
+/** Names of the workflow tools (for dispatch matching). */
+export declare const WORKFLOW_TOOL_NAMES: Set<string>;
+/**
+ * Dispatch a workflow tool call.
+ *
+ * Returns the tool result, or null if the tool name is not recognized
+ * as a workflow tool (caller should handle it as an unknown tool).
+ */
+export declare function handleWorkflowToolCall(server: Server, options: WorkflowToolsOptions, name: string, args: Record<string, unknown>, signal: AbortSignal, progressToken: string | number | undefined): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+} | null>;
+/**
+ * Register workflow tools on an MCP Server instance.
+ *
+ * This is the reusable core extracted from createWorkflowServer().
+ * It registers three tools: run_workflow, resume_workflow, list_workflows.
+ *
+ * The `options.createBackend` factory determines how clink calls are
+ * dispatched — callers provide either a child-process or in-process backend.
+ *
+ * NOTE: This calls setRequestHandler which REPLACES any existing handlers.
+ * For combined servers (root + workflows), use getWorkflowToolDefinitions()
+ * and handleWorkflowToolCall() instead and build a unified handler.
+ */
+export declare function registerWorkflowTools(server: Server, options: WorkflowToolsOptions): void;