tea-rags 0.9.0

package/build/core/types.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Type definitions for code vectorization module
+ */
+/** Config for indexing pipelines (BaseIndexingPipeline, IndexPipeline, ReindexPipeline) */
+export interface IngestCodeConfig {
+    chunkSize: number;
+    chunkOverlap: number;
+    supportedExtensions: string[];
+    ignorePatterns: string[];
+    customIgnorePatterns?: string[];
+    maxChunksPerFile?: number;
+    maxTotalChunks?: number;
+    enableHybridSearch: boolean;
+    enableGitMetadata?: boolean;
+}
+/** Config for IngestFacade trajectory enrichment setup */
+export interface TrajectoryIngestConfig {
+    enableGitMetadata?: boolean;
+    squashAwareSessions?: boolean;
+    sessionGapMinutes?: number;
+    trajectoryGit?: {
+        logMaxAgeMonths: number;
+        logTimeoutMs: number;
+        chunkConcurrency: number;
+        chunkMaxAgeMonths: number;
+        chunkTimeoutMs: number;
+        chunkMaxFileLines: number;
+    };
+}
+export interface ScannerConfig {
+    supportedExtensions: string[];
+    ignorePatterns: string[];
+    customIgnorePatterns?: string[];
+}
+export interface ChunkerConfig {
+    chunkSize: number;
+    chunkOverlap: number;
+    maxChunkSize: number;
+}
+export interface IndexOptions {
+    forceReindex?: boolean;
+    extensions?: string[];
+    ignorePatterns?: string[];
+}
+export interface IndexStats {
+    filesScanned: number;
+    filesIndexed: number;
+    chunksCreated: number;
+    durationMs: number;
+    status: "completed" | "partial" | "failed";
+    errors?: string[];
+    /** Git enrichment status */
+    enrichmentStatus?: "completed" | "partial" | "skipped" | "background";
+    enrichmentDurationMs?: number;
+}
+export interface ChangeStats {
+    filesAdded: number;
+    filesModified: number;
+    filesDeleted: number;
+    chunksAdded: number;
+    chunksDeleted: number;
+    durationMs: number;
+    status: "completed" | "partial" | "failed";
+    /** Git enrichment status */
+    enrichmentStatus?: "completed" | "partial" | "skipped" | "background";
+    enrichmentDurationMs?: number;
+}
+export type IndexingStatus = "not_indexed" | "indexing" | "indexed";
+/** Status of background git enrichment */
+export type EnrichmentStatusValue = "pending" | "in_progress" | "completed" | "partial" | "failed";
+export interface EnrichmentInfo {
+    status: EnrichmentStatusValue;
+    totalFiles?: number;
+    processedFiles?: number;
+    percentage?: number;
+    startedAt?: string;
+    completedAt?: string;
+    durationMs?: number;
+    failedFiles?: number;
+    /** Files that matched in the git log map */
+    matchedFiles?: number;
+    /** Files with no entry in git log (not modified within GIT_LOG_MAX_AGE_MONTHS) */
+    missedFiles?: number;
+    /** Total files present in git log (contextualizes matchedFiles/missedFiles) */
+    gitLogFileCount?: number;
+}
+/** Status of background chunk-level git enrichment */
+export interface ChunkEnrichmentInfo {
+    status: "in_progress" | "completed" | "failed";
+    overlaysApplied?: number;
+    durationMs?: number;
+}
+/** Metrics from streaming git enrichment (parallel with embedding) */
+export interface EnrichmentMetrics {
+    /** Time spent reading git log */
+    prefetchDurationMs: number;
+    /** How much git log overlapped with embedding (ms) */
+    overlapMs: number;
+    /** Overlap as fraction of git log time (0.0-1.0) */
+    overlapRatio: number;
+    /** Batches applied via callback while embedding was still running */
+    streamingApplies: number;
+    /** Batches applied from pending queue after git log resolved */
+    flushApplies: number;
+    /** Time spent on chunk-level churn analysis */
+    chunkChurnDurationMs: number;
+    /** Total enrichment wall time */
+    totalDurationMs: number;
+    /** Files that matched in the git log map */
+    matchedFiles: number;
+    /** Files with no entry in git log (not modified in GIT_LOG_MAX_AGE_MONTHS window) */
+    missedFiles: number;
+    /** First 10 unmatched paths for diagnosing issues */
+    missedPathSamples: string[];
+    /** Total files present in git log output (contextualizes matchedFiles) */
+    gitLogFileCount: number;
+    /** Estimated ms saved by streaming overlap vs sequential execution */
+    estimatedSavedMs: number;
+}
+export interface IndexStatus {
+    /** @deprecated Use `status` instead. True only when status is 'indexed'. */
+    isIndexed: boolean;
+    /** Current indexing status: 'not_indexed', 'indexing', or 'indexed' */
+    status: IndexingStatus;
+    collectionName?: string;
+    filesCount?: number;
+    chunksCount?: number;
+    lastUpdated?: Date;
+    languages?: string[];
+    /** Background git enrichment progress (file-level) */
+    enrichment?: EnrichmentInfo;
+    /** Background chunk-level git enrichment progress */
+    chunkEnrichment?: ChunkEnrichmentInfo;
+}
+export type ProgressCallback = (progress: ProgressUpdate) => void;
+export interface ProgressUpdate {
+    phase: "scanning" | "chunking" | "embedding" | "storing" | "enriching";
+    current: number;
+    total: number;
+    percentage: number;
+    message: string;
+}
+export interface CodeChunk {
+    content: string;
+    startLine: number;
+    endLine: number;
+    metadata: {
+        filePath: string;
+        language: string;
+        chunkIndex: number;
+        chunkType?: "function" | "class" | "interface" | "block";
+        name?: string;
+        parentName?: string;
+        parentType?: string;
+        /** Symbol identifier: "ClassName.methodName" or just "functionName" */
+        symbolId?: string;
+        /** Non-contiguous line ranges (e.g., Ruby body groups with gaps where methods live) */
+        lineRanges?: {
+            start: number;
+            end: number;
+        }[];
+        /**
+         * True for documentation chunks (markdown, etc.)
+         * Used to filter search results: include/exclude documentation
+         */
+        isDocumentation?: boolean;
+        /**
+         * Imports extracted from the file (file-level, inherited by all chunks)
+         * Used for imports structural signal in reranking
+         */
+        imports?: string[];
+        /** Original method/block line count before chunk splitting. Used by decomposition signals. */
+        methodLines?: number;
+    };
+}
+export interface FileChanges {
+    added: string[];
+    modified: string[];
+    deleted: string[];
+}
+/** Maps a chunk to its point ID for Phase 2 git enrichment */
+export interface ChunkLookupEntry {
+    chunkId: string;
+    startLine: number;
+    endLine: number;
+    /** Non-contiguous line ranges for precise overlap detection (e.g., Ruby body groups) */
+    lineRanges?: {
+        start: number;
+        end: number;
+    }[];
+}
+//# sourceMappingURL=types.d.ts.map

package/build/core/types.d.ts.map

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

package/build/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for code vectorization module
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { getZodConfig, parseAppConfig } from "./bootstrap/config/index.js";
+import { createAppContext, createConfiguredServer, loadPrompts } from "./bootstrap/factory.js";
+import { migrateHomeDir } from "./bootstrap/migrate.js";
+import { checkOllamaAvailability } from "./bootstrap/ollama.js";
+import { startHttpServer } from "./bootstrap/transport/http.js";
+import { startStdioServer } from "./bootstrap/transport/stdio.js";
+async function main() {
+    migrateHomeDir();
+    const config = parseAppConfig();
+    const zodConfig = getZodConfig();
+    await checkOllamaAvailability(zodConfig.embedding.provider, zodConfig.embedding.baseUrl, zodConfig.embedding.model);
+    const ctx = await createAppContext(config);
+    const promptsConfig = loadPrompts(config);
+    // Log deprecation warnings
+    const { deprecations } = zodConfig;
+    if (deprecations.length > 0) {
+        const lines = deprecations.map((d) => `  ${d.oldName} -> use ${d.newName}`).join("\n");
+        console.error(`[tea-rags] Deprecated env vars:\n${lines}`);
+    }
+    // Graceful shutdown: disconnect embedding provider (daemon refcount--)
+    if (ctx.cleanup) {
+        process.on("SIGTERM", ctx.cleanup);
+        process.on("SIGINT", ctx.cleanup);
+        process.on("beforeExit", ctx.cleanup);
+    }
+    if (config.transportMode === "http") {
+        await startHttpServer({ config, ctx, promptsConfig });
+    }
+    else {
+        const server = createConfiguredServer(ctx, promptsConfig);
+        await startStdioServer(server);
+        // Send deprecation warnings via MCP logging (visible to client)
+        if (deprecations.length > 0) {
+            const lines = deprecations.map((d) => `${d.oldName} -> use ${d.newName}`).join(", ");
+            await server.sendLoggingMessage({ level: "warning", data: `Deprecated env vars: ${lines}` });
+        }
+    }
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,KAAK,UAAU,IAAI;IACjB,cAAc,EAAE,CAAC;IACjB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,uBAAuB,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEpH,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAE1C,2BAA2B;IAC3B,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACnC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,OAAO,CAAC,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,uEAAuE;IACvE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,KAAK,MAAM,EAAE,CAAC;QACpC,MAAM,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;QAC1D,MAAM,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAE/B,gEAAgE;QAChE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrF,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,wBAAwB,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/mcp/format.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared MCP response formatters.
+ * All MCP tool handlers use these to format responses.
+ */
+export interface McpToolResult {
+    [key: string]: unknown;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+}
+export declare function formatMcpResponse(data: unknown): McpToolResult;
+export declare function formatMcpText(text: string): McpToolResult;
+export declare function formatMcpError(message: string): McpToolResult;
+/**
+ * Sanitize rerank param from Zod schema (custom values may be undefined) to App-compatible type.
+ */
+export declare function sanitizeRerank(rerank: string | {
+    custom: Record<string, number | undefined>;
+} | undefined): string | {
+    custom: Record<string, number>;
+} | undefined;
+export declare function appendDriftWarning(result: McpToolResult, warning: string | null): McpToolResult;
+//# sourceMappingURL=format.d.ts.map

package/build/mcp/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/mcp/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,CAE9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAEzD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE7D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;CAAE,GAAG,SAAS,GAC1E,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,SAAS,CAOzD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,CAK/F"}

package/build/mcp/format.js

@@ -0,0 +1,34 @@
+/**
+ * Shared MCP response formatters.
+ * All MCP tool handlers use these to format responses.
+ */
+export function formatMcpResponse(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+export function formatMcpText(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function formatMcpError(message) {
+    return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+}
+/**
+ * Sanitize rerank param from Zod schema (custom values may be undefined) to App-compatible type.
+ */
+export function sanitizeRerank(rerank) {
+    if (!rerank || typeof rerank === "string")
+        return rerank;
+    const cleaned = {};
+    for (const [k, v] of Object.entries(rerank.custom)) {
+        if (typeof v === "number")
+            cleaned[k] = v;
+    }
+    return { custom: cleaned };
+}
+export function appendDriftWarning(result, warning) {
+    if (!warning || result.content.length === 0)
+        return result;
+    const last = result.content[result.content.length - 1];
+    last.text += `\n\n${warning}`;
+    return result;
+}
+//# sourceMappingURL=format.js.map

package/build/mcp/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/mcp/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA2E;IAE3E,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACzD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAqB,EAAE,OAAsB;IAC9E,IAAI,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,IAAI,IAAI,OAAO,OAAO,EAAE,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/mcp/prompts/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prompts module exports
+ */
+export * from "./loader.js";
+export * from "./template.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/build/mcp/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,mBAAmB,YAAY,CAAC"}

package/build/mcp/prompts/index.js

@@ -0,0 +1,6 @@
+/**
+ * Prompts module exports
+ */
+export * from "./loader.js";
+export * from "./template.js";
+//# sourceMappingURL=index.js.map

package/build/mcp/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/prompts/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/build/mcp/prompts/loader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Prompt configuration loader
+ */
+import type { PromptDefinition, PromptsConfig } from "./types.js";
+/**
+ * Load and parse prompts configuration from a JSON file
+ * @param filePath Path to the prompts configuration file
+ * @returns Parsed prompts configuration
+ * @throws Error if file cannot be read or parsed
+ */
+export declare function loadPromptsConfig(filePath: string): PromptsConfig;
+/**
+ * Get a specific prompt by name
+ * @param config Prompts configuration
+ * @param name Prompt name
+ * @returns Prompt definition or undefined if not found
+ */
+export declare function getPrompt(config: PromptsConfig, name: string): PromptDefinition | undefined;
+/**
+ * List all available prompts
+ * @param config Prompts configuration
+ * @returns Array of prompt definitions
+ */
+export declare function listPrompts(config: PromptsConfig): PromptDefinition[];
+//# sourceMappingURL=loader.d.ts.map

package/build/mcp/prompts/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AA0BlE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAgCjE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAErE"}

package/build/mcp/prompts/loader.js

@@ -0,0 +1,81 @@
+/**
+ * Prompt configuration loader
+ */
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+// Zod schema for validation
+const PromptArgumentSchema = z.object({
+    name: z.string().min(1, "Argument name is required"),
+    description: z.string().min(1, "Argument description is required"),
+    required: z.boolean(),
+    default: z.string().optional(),
+});
+const PromptDefinitionSchema = z.object({
+    name: z
+        .string()
+        .min(1, "Prompt name is required")
+        .regex(/^[a-z_][a-z0-9_]*$/, {
+        message: "Prompt name must be lowercase letters, numbers, and underscores only",
+    }),
+    description: z.string().min(1, "Prompt description is required"),
+    arguments: z.array(PromptArgumentSchema),
+    template: z.string().min(1, "Prompt template is required"),
+});
+const PromptsConfigSchema = z.object({
+    prompts: z.array(PromptDefinitionSchema),
+});
+/**
+ * Load and parse prompts configuration from a JSON file
+ * @param filePath Path to the prompts configuration file
+ * @returns Parsed prompts configuration
+ * @throws Error if file cannot be read or parsed
+ */
+export function loadPromptsConfig(filePath) {
+    try {
+        const content = readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        const validated = PromptsConfigSchema.parse(parsed);
+        // Validate unique prompt names
+        const names = new Set();
+        for (const prompt of validated.prompts) {
+            if (names.has(prompt.name)) {
+                throw new Error(`Duplicate prompt name: ${prompt.name}`);
+            }
+            names.add(prompt.name);
+            // Validate unique argument names within each prompt
+            const argNames = new Set();
+            for (const arg of prompt.arguments) {
+                if (argNames.has(arg.name)) {
+                    throw new Error(`Duplicate argument name in prompt "${prompt.name}": ${arg.name}`);
+                }
+                argNames.add(arg.name);
+            }
+        }
+        return validated;
+    }
+    catch (error) {
+        if (error instanceof z.ZodError) {
+            const issues = error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`);
+            throw new Error(`Invalid prompts configuration:\n${issues.join("\n")}`);
+        }
+        throw error;
+    }
+}
+/**
+ * Get a specific prompt by name
+ * @param config Prompts configuration
+ * @param name Prompt name
+ * @returns Prompt definition or undefined if not found
+ */
+export function getPrompt(config, name) {
+    return config.prompts.find((p) => p.name === name);
+}
+/**
+ * List all available prompts
+ * @param config Prompts configuration
+ * @returns Array of prompt definitions
+ */
+export function listPrompts(config) {
+    return config.prompts;
+}
+//# sourceMappingURL=loader.js.map

package/build/mcp/prompts/loader.js.map

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

package/build/mcp/prompts/register.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Prompt registration module for McpServer
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { PromptsConfig } from "./types.js";
+/**
+ * Register all prompts from configuration on the server
+ */
+export declare function registerAllPrompts(server: McpServer, config: PromptsConfig | null): void;
+//# sourceMappingURL=register.d.ts.map

package/build/mcp/prompts/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts/register.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAgBhE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAqCxF"}

package/build/mcp/prompts/register.js

@@ -0,0 +1,50 @@
+/**
+ * Prompt registration module for McpServer
+ */
+import { z } from "zod";
+import { renderTemplate, validateArguments } from "./template.js";
+/**
+ * Build a Zod schema object for prompt arguments
+ */
+function buildArgsSchema(args) {
+    const schema = {};
+    for (const arg of args) {
+        const fieldSchema = z.string().describe(arg.description);
+        schema[arg.name] = arg.required ? fieldSchema : fieldSchema.optional();
+    }
+    return schema;
+}
+/**
+ * Register all prompts from configuration on the server
+ */
+export function registerAllPrompts(server, config) {
+    if (!config) {
+        return; // No prompts = no prompts capability
+    }
+    for (const prompt of config.prompts) {
+        const argsSchema = buildArgsSchema(prompt.arguments);
+        server.registerPrompt(prompt.name, {
+            title: prompt.name,
+            description: prompt.description,
+            argsSchema,
+        }, (args) => {
+            // Validate arguments
+            const argsRecord = (args || {});
+            validateArguments(argsRecord, prompt.arguments);
+            // Render template
+            const rendered = renderTemplate(prompt.template, argsRecord, prompt.arguments);
+            return {
+                messages: [
+                    {
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: rendered.text,
+                        },
+                    },
+                ],
+            };
+        });
+    }
+}
+//# sourceMappingURL=register.js.map

package/build/mcp/prompts/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/mcp/prompts/register.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlE;;GAEG;AACH,SAAS,eAAe,CAAC,IAAsB;IAC7C,MAAM,MAAM,GAAiC,EAAE,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAA4B;IAChF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,qCAAqC;IAC/C,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAErD,MAAM,CAAC,cAAc,CACnB,MAAM,CAAC,IAAI,EACX;YACE,KAAK,EAAE,MAAM,CAAC,IAAI;YAClB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU;SACX,EACD,CAAC,IAAI,EAAE,EAAE;YACP,qBAAqB;YACrB,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,EAAE,CAA2B,CAAC;YAC1D,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAEhD,kBAAkB;YAClB,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;YAE/E,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,QAAQ,CAAC,IAAI;yBACpB;qBACF;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/mcp/prompts/template.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Simple template rendering engine for prompts
+ */
+import type { PromptArgument, RenderedPrompt } from "./types.js";
+/**
+ * Render a template string by replacing {{variable}} placeholders with actual values
+ * @param template Template string with {{variable}} placeholders
+ * @param args Record of argument values
+ * @param definitions Argument definitions with defaults
+ * @returns Rendered template
+ */
+export declare function renderTemplate(template: string, args?: Record<string, string>, definitions?: PromptArgument[]): RenderedPrompt;
+/**
+ * Validate that all required arguments are provided
+ * @param args Provided arguments
+ * @param definitions Argument definitions
+ * @throws Error if required arguments are missing
+ */
+export declare function validateArguments(args: Record<string, string>, definitions: PromptArgument[]): void;
+//# sourceMappingURL=template.d.ts.map

package/build/mcp/prompts/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../../src/mcp/prompts/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EACjC,WAAW,GAAE,cAAc,EAAO,GACjC,cAAc,CA8BhB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,IAAI,CAYnG"}

package/build/mcp/prompts/template.js

@@ -0,0 +1,54 @@
+/**
+ * Simple template rendering engine for prompts
+ */
+/**
+ * Render a template string by replacing {{variable}} placeholders with actual values
+ * @param template Template string with {{variable}} placeholders
+ * @param args Record of argument values
+ * @param definitions Argument definitions with defaults
+ * @returns Rendered template
+ */
+export function renderTemplate(template, args = {}, definitions = []) {
+    let rendered = template;
+    // Create a map of defaults
+    const defaults = new Map();
+    for (const def of definitions) {
+        if (def.default !== undefined) {
+            defaults.set(def.name, def.default);
+        }
+    }
+    // Replace all {{variable}} placeholders
+    rendered = rendered.replace(/\{\{(\w+)\}\}/g, (match, varName) => {
+        // Check if value is provided in args
+        const argValue = args[varName];
+        if (argValue !== undefined) {
+            return argValue;
+        }
+        // Check if there's a default value
+        const defaultValue = defaults.get(varName);
+        if (defaultValue !== undefined) {
+            return defaultValue;
+        }
+        // If no value and no default, keep the placeholder
+        return match;
+    });
+    return { text: rendered };
+}
+/**
+ * Validate that all required arguments are provided
+ * @param args Provided arguments
+ * @param definitions Argument definitions
+ * @throws Error if required arguments are missing
+ */
+export function validateArguments(args, definitions) {
+    const missing = [];
+    for (const def of definitions) {
+        if (def.required && (args[def.name] === undefined || args[def.name] === "")) {
+            missing.push(def.name);
+        }
+    }
+    if (missing.length > 0) {
+        throw new Error(`Missing required arguments: ${missing.join(", ")}`);
+    }
+}
+//# sourceMappingURL=template.js.map

package/build/mcp/prompts/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../../src/mcp/prompts/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,OAA+B,EAAE,EACjC,cAAgC,EAAE;IAElC,IAAI,QAAQ,GAAG,QAAQ,CAAC;IAExB,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC9B,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QACvE,qCAAqC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,mCAAmC;QACnC,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,mDAAmD;QACnD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA4B,EAAE,WAA6B;IAC3F,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;YAC5E,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}