labre-mcp 0.1.0

package/dist/lib/response-formatter.d.mts

@@ -0,0 +1,115 @@
+/**
+ * Shape accepted by the per-strategy formatters. Callers may pass any of:
+ *  - a capability EvolutionResult ({ evolution, confidence, method, trace? })
+ *  - a SolutionEvolutionResult (adds properties, phaseDistribution, …)
+ *  - an error envelope ({ error: string })
+ *  - any strategy-specific extension bag
+ * The formatter narrows fields at the use site (checks for .error, .properties, …).
+ */
+export interface StrategyResultLike {
+    error?: string;
+    evolution?: number;
+    confidence?: number;
+    method?: string;
+    properties?: Array<{
+        property: string;
+        phase: number;
+        label?: string;
+        reason?: string;
+    }>;
+    phaseDistribution?: Record<number, number>;
+    dominantPhase?: {
+        phase: number;
+        count: number;
+        label: string;
+    };
+    meanPhase?: number;
+    stage?: string;
+    trace?: unknown[];
+    confidenceMetadata?: {
+        coverage?: number;
+        evaluatedCount?: number;
+        totalCount?: number;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+/** Component input shape accepted by formatters — loose superset of ComponentInput/SolutionInput. */
+export interface FormatterComponent {
+    name?: string;
+    description?: string;
+    context?: string;
+    capability?: string;
+    nature?: string;
+    certitude?: number;
+    ubiquity?: number;
+    phaseDistribution?: {
+        bins: Array<{
+            position: number;
+            probability: number;
+        }>;
+    };
+    [key: string]: unknown;
+}
+export interface EvolutionStage {
+    name: string;
+    shortName: string;
+    descriptor: string;
+    rangeMin: number;
+    rangeMax: number;
+}
+/**
+ * Map an evolution value (0–1) to its Wardley stage.
+ *
+ * @param {number} evolution - Evolution value
+ * @returns {EvolutionStage & { position: string }}
+ */
+export declare function evolutionToStage(evolution: number): EvolutionStage & {
+    position: string;
+};
+/**
+ * Format a confidence value as a descriptive label + visual bar.
+ *
+ * @param {number} confidence - Confidence 0–1
+ * @returns {{ label: string, bar: string, percentage: string }}
+ */
+export declare function formatConfidence(confidence: number): {
+    label: string;
+    bar: string;
+    percentage: string;
+};
+/**
+ * Generate a human-readable reasoning sentence for a strategy result.
+ *
+ * @param {string} method - Strategy method identifier
+ * @param {Object} result - EvolutionResult { evolution, confidence, method }
+ * @param {Object} [component] - Original component input (for context)
+ * @returns {string} Reasoning sentence
+ */
+export declare function strategyReasoning(method: string, result: StrategyResultLike, component?: FormatterComponent): string;
+/**
+ * Format a single strategy evaluation result into a markdown block.
+ *
+ * @param {string} method - Strategy method identifier
+ * @param {Object} evalResult - { evolution, confidence, method } or { error }
+ * @param {Object} [component] - Original component input
+ * @returns {string} Markdown block
+ */
+export declare function formatStrategyResult(method: string, evalResult: StrategyResultLike, component?: FormatterComponent): string;
+/**
+ * Format a complete evaluation API response into conversational markdown.
+ *
+ * Accepts the result from:
+ *   - handleEstimateEvolution() (MCP tool)
+ *   - estimateEvolutionOneShot() (one-shot API)
+ *   - estimateEvolutionConversational() (conversational API)
+ *   - handleSkillInvocation() (skill handler, which adds parsedInput/availableStrategies)
+ *
+ * @param {Object} result - API response object
+ * @param {Object} [options] - Formatting options
+ * @param {Object} [options.component] - Original component input for richer reasoning
+ * @param {boolean} [options.compact] - If true, use shorter format
+ * @returns {string} Markdown-formatted conversational output
+ */
+export declare function formatResponse(result: any, options?: any): string;
+//# sourceMappingURL=response-formatter.d.mts.map

package/dist/lib/response-formatter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.d.mts","sourceRoot":"","sources":["../../src/lib/response-formatter.mts"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzF,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,aAAa,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,kBAAkB,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE;QAAE,IAAI,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC/E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0CD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CASzF;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAavG;AAID;;;;;;;GAOG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,GAAE,kBAAuB,GAAG,MAAM,CAgExH;AAgDD;;;;;;;GAOG;AAEH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,SAAS,GAAE,kBAAuB,GAAG,MAAM,CAiD/H;AAID;;;;;;;;;;;;;;GAcG;AAEH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,GAAE,GAAQ,GAAG,MAAM,CA8ErE"}