mcp-adr-analysis-server 2.0.9 → 2.0.10

package/dist/src/types/knowledge-graph-schemas.d.ts

@@ -0,0 +1,481 @@
+import { z } from 'zod';
+export declare const ToolExecutionSnapshotSchema: z.ZodObject<{
+    toolName: z.ZodString;
+    parameters: z.ZodRecord<z.ZodString, z.ZodAny>;
+    result: z.ZodRecord<z.ZodString, z.ZodAny>;
+    todoTasksCreated: z.ZodArray<z.ZodString, "many">;
+    todoTasksModified: z.ZodArray<z.ZodString, "many">;
+    executionTime: z.ZodString;
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    result: Record<string, any>;
+    executionTime: string;
+    toolName: string;
+    parameters: Record<string, any>;
+    todoTasksCreated: string[];
+    todoTasksModified: string[];
+    error?: string | undefined;
+}, {
+    success: boolean;
+    result: Record<string, any>;
+    executionTime: string;
+    toolName: string;
+    parameters: Record<string, any>;
+    todoTasksCreated: string[];
+    todoTasksModified: string[];
+    error?: string | undefined;
+}>;
+export declare const IntentSnapshotSchema: z.ZodObject<{
+    intentId: z.ZodString;
+    humanRequest: z.ZodString;
+    parsedGoals: z.ZodArray<z.ZodString, "many">;
+    priority: z.ZodEnum<["high", "medium", "low"]>;
+    timestamp: z.ZodString;
+    toolChain: z.ZodArray<z.ZodObject<{
+        toolName: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodAny>;
+        result: z.ZodRecord<z.ZodString, z.ZodAny>;
+        todoTasksCreated: z.ZodArray<z.ZodString, "many">;
+        todoTasksModified: z.ZodArray<z.ZodString, "many">;
+        executionTime: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        result: Record<string, any>;
+        executionTime: string;
+        toolName: string;
+        parameters: Record<string, any>;
+        todoTasksCreated: string[];
+        todoTasksModified: string[];
+        error?: string | undefined;
+    }, {
+        success: boolean;
+        result: Record<string, any>;
+        executionTime: string;
+        toolName: string;
+        parameters: Record<string, any>;
+        todoTasksCreated: string[];
+        todoTasksModified: string[];
+        error?: string | undefined;
+    }>, "many">;
+    currentStatus: z.ZodEnum<["planning", "executing", "completed", "failed"]>;
+    todoMdSnapshot: z.ZodString;
+    parentIntentId: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    priority: "medium" | "low" | "high";
+    intentId: string;
+    humanRequest: string;
+    parsedGoals: string[];
+    toolChain: {
+        success: boolean;
+        result: Record<string, any>;
+        executionTime: string;
+        toolName: string;
+        parameters: Record<string, any>;
+        todoTasksCreated: string[];
+        todoTasksModified: string[];
+        error?: string | undefined;
+    }[];
+    currentStatus: "completed" | "failed" | "planning" | "executing";
+    todoMdSnapshot: string;
+    tags?: string[] | undefined;
+    parentIntentId?: string | undefined;
+}, {
+    timestamp: string;
+    priority: "medium" | "low" | "high";
+    intentId: string;
+    humanRequest: string;
+    parsedGoals: string[];
+    toolChain: {
+        success: boolean;
+        result: Record<string, any>;
+        executionTime: string;
+        toolName: string;
+        parameters: Record<string, any>;
+        todoTasksCreated: string[];
+        todoTasksModified: string[];
+        error?: string | undefined;
+    }[];
+    currentStatus: "completed" | "failed" | "planning" | "executing";
+    todoMdSnapshot: string;
+    tags?: string[] | undefined;
+    parentIntentId?: string | undefined;
+}>;
+export declare const TodoSyncStateSchema: z.ZodObject<{
+    lastSyncTimestamp: z.ZodString;
+    todoMdHash: z.ZodString;
+    knowledgeGraphHash: z.ZodString;
+    syncStatus: z.ZodEnum<["synced", "pending", "conflict", "error"]>;
+    conflictDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        conflict: z.ZodString;
+        todoVersion: z.ZodString;
+        kgVersion: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        conflict: string;
+        taskId: string;
+        todoVersion: string;
+        kgVersion: string;
+    }, {
+        conflict: string;
+        taskId: string;
+        todoVersion: string;
+        kgVersion: string;
+    }>, "many">>;
+    lastModifiedBy: z.ZodEnum<["human", "tool", "sync"]>;
+    version: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    lastSyncTimestamp: string;
+    todoMdHash: string;
+    knowledgeGraphHash: string;
+    syncStatus: "error" | "pending" | "synced" | "conflict";
+    lastModifiedBy: "tool" | "human" | "sync";
+    conflictDetails?: {
+        conflict: string;
+        taskId: string;
+        todoVersion: string;
+        kgVersion: string;
+    }[] | undefined;
+}, {
+    version: number;
+    lastSyncTimestamp: string;
+    todoMdHash: string;
+    knowledgeGraphHash: string;
+    syncStatus: "error" | "pending" | "synced" | "conflict";
+    lastModifiedBy: "tool" | "human" | "sync";
+    conflictDetails?: {
+        conflict: string;
+        taskId: string;
+        todoVersion: string;
+        kgVersion: string;
+    }[] | undefined;
+}>;
+export declare const KnowledgeGraphSnapshotSchema: z.ZodObject<{
+    version: z.ZodString;
+    timestamp: z.ZodString;
+    intents: z.ZodArray<z.ZodObject<{
+        intentId: z.ZodString;
+        humanRequest: z.ZodString;
+        parsedGoals: z.ZodArray<z.ZodString, "many">;
+        priority: z.ZodEnum<["high", "medium", "low"]>;
+        timestamp: z.ZodString;
+        toolChain: z.ZodArray<z.ZodObject<{
+            toolName: z.ZodString;
+            parameters: z.ZodRecord<z.ZodString, z.ZodAny>;
+            result: z.ZodRecord<z.ZodString, z.ZodAny>;
+            todoTasksCreated: z.ZodArray<z.ZodString, "many">;
+            todoTasksModified: z.ZodArray<z.ZodString, "many">;
+            executionTime: z.ZodString;
+            success: z.ZodBoolean;
+            error: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            success: boolean;
+            result: Record<string, any>;
+            executionTime: string;
+            toolName: string;
+            parameters: Record<string, any>;
+            todoTasksCreated: string[];
+            todoTasksModified: string[];
+            error?: string | undefined;
+        }, {
+            success: boolean;
+            result: Record<string, any>;
+            executionTime: string;
+            toolName: string;
+            parameters: Record<string, any>;
+            todoTasksCreated: string[];
+            todoTasksModified: string[];
+            error?: string | undefined;
+        }>, "many">;
+        currentStatus: z.ZodEnum<["planning", "executing", "completed", "failed"]>;
+        todoMdSnapshot: z.ZodString;
+        parentIntentId: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        timestamp: string;
+        priority: "medium" | "low" | "high";
+        intentId: string;
+        humanRequest: string;
+        parsedGoals: string[];
+        toolChain: {
+            success: boolean;
+            result: Record<string, any>;
+            executionTime: string;
+            toolName: string;
+            parameters: Record<string, any>;
+            todoTasksCreated: string[];
+            todoTasksModified: string[];
+            error?: string | undefined;
+        }[];
+        currentStatus: "completed" | "failed" | "planning" | "executing";
+        todoMdSnapshot: string;
+        tags?: string[] | undefined;
+        parentIntentId?: string | undefined;
+    }, {
+        timestamp: string;
+        priority: "medium" | "low" | "high";
+        intentId: string;
+        humanRequest: string;
+        parsedGoals: string[];
+        toolChain: {
+            success: boolean;
+            result: Record<string, any>;
+            executionTime: string;
+            toolName: string;
+            parameters: Record<string, any>;
+            todoTasksCreated: string[];
+            todoTasksModified: string[];
+            error?: string | undefined;
+        }[];
+        currentStatus: "completed" | "failed" | "planning" | "executing";
+        todoMdSnapshot: string;
+        tags?: string[] | undefined;
+        parentIntentId?: string | undefined;
+    }>, "many">;
+    todoSyncState: z.ZodObject<{
+        lastSyncTimestamp: z.ZodString;
+        todoMdHash: z.ZodString;
+        knowledgeGraphHash: z.ZodString;
+        syncStatus: z.ZodEnum<["synced", "pending", "conflict", "error"]>;
+        conflictDetails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            taskId: z.ZodString;
+            conflict: z.ZodString;
+            todoVersion: z.ZodString;
+            kgVersion: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            conflict: string;
+            taskId: string;
+            todoVersion: string;
+            kgVersion: string;
+        }, {
+            conflict: string;
+            taskId: string;
+            todoVersion: string;
+            kgVersion: string;
+        }>, "many">>;
+        lastModifiedBy: z.ZodEnum<["human", "tool", "sync"]>;
+        version: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        version: number;
+        lastSyncTimestamp: string;
+        todoMdHash: string;
+        knowledgeGraphHash: string;
+        syncStatus: "error" | "pending" | "synced" | "conflict";
+        lastModifiedBy: "tool" | "human" | "sync";
+        conflictDetails?: {
+            conflict: string;
+            taskId: string;
+            todoVersion: string;
+            kgVersion: string;
+        }[] | undefined;
+    }, {
+        version: number;
+        lastSyncTimestamp: string;
+        todoMdHash: string;
+        knowledgeGraphHash: string;
+        syncStatus: "error" | "pending" | "synced" | "conflict";
+        lastModifiedBy: "tool" | "human" | "sync";
+        conflictDetails?: {
+            conflict: string;
+            taskId: string;
+            todoVersion: string;
+            kgVersion: string;
+        }[] | undefined;
+    }>;
+    analytics: z.ZodObject<{
+        totalIntents: z.ZodNumber;
+        completedIntents: z.ZodNumber;
+        activeIntents: z.ZodNumber;
+        averageGoalCompletion: z.ZodNumber;
+        mostUsedTools: z.ZodArray<z.ZodObject<{
+            toolName: z.ZodString;
+            usageCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            toolName: string;
+            usageCount: number;
+        }, {
+            toolName: string;
+            usageCount: number;
+        }>, "many">;
+        successfulPatterns: z.ZodArray<z.ZodObject<{
+            pattern: z.ZodString;
+            successRate: z.ZodNumber;
+            examples: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            successRate: number;
+            pattern: string;
+            examples: string[];
+        }, {
+            successRate: number;
+            pattern: string;
+            examples: string[];
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        totalIntents: number;
+        completedIntents: number;
+        activeIntents: number;
+        averageGoalCompletion: number;
+        mostUsedTools: {
+            toolName: string;
+            usageCount: number;
+        }[];
+        successfulPatterns: {
+            successRate: number;
+            pattern: string;
+            examples: string[];
+        }[];
+    }, {
+        totalIntents: number;
+        completedIntents: number;
+        activeIntents: number;
+        averageGoalCompletion: number;
+        mostUsedTools: {
+            toolName: string;
+            usageCount: number;
+        }[];
+        successfulPatterns: {
+            successRate: number;
+            pattern: string;
+            examples: string[];
+        }[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    timestamp: string;
+    version: string;
+    intents: {
+        timestamp: string;
+        priority: "medium" | "low" | "high";
+        intentId: string;
+        humanRequest: string;
+        parsedGoals: string[];
+        toolChain: {
+            success: boolean;
+            result: Record<string, any>;
+            executionTime: string;
+            toolName: string;
+            parameters: Record<string, any>;
+            todoTasksCreated: string[];
+            todoTasksModified: string[];
+            error?: string | undefined;
+        }[];
+        currentStatus: "completed" | "failed" | "planning" | "executing";
+        todoMdSnapshot: string;
+        tags?: string[] | undefined;
+        parentIntentId?: string | undefined;
+    }[];
+    todoSyncState: {
+        version: number;
+        lastSyncTimestamp: string;
+        todoMdHash: string;
+        knowledgeGraphHash: string;
+        syncStatus: "error" | "pending" | "synced" | "conflict";
+        lastModifiedBy: "tool" | "human" | "sync";
+        conflictDetails?: {
+            conflict: string;
+            taskId: string;
+            todoVersion: string;
+            kgVersion: string;
+        }[] | undefined;
+    };
+    analytics: {
+        totalIntents: number;
+        completedIntents: number;
+        activeIntents: number;
+        averageGoalCompletion: number;
+        mostUsedTools: {
+            toolName: string;
+            usageCount: number;
+        }[];
+        successfulPatterns: {
+            successRate: number;
+            pattern: string;
+            examples: string[];
+        }[];
+    };
+}, {
+    timestamp: string;
+    version: string;
+    intents: {
+        timestamp: string;
+        priority: "medium" | "low" | "high";
+        intentId: string;
+        humanRequest: string;
+        parsedGoals: string[];
+        toolChain: {
+            success: boolean;
+            result: Record<string, any>;
+            executionTime: string;
+            toolName: string;
+            parameters: Record<string, any>;
+            todoTasksCreated: string[];
+            todoTasksModified: string[];
+            error?: string | undefined;
+        }[];
+        currentStatus: "completed" | "failed" | "planning" | "executing";
+        todoMdSnapshot: string;
+        tags?: string[] | undefined;
+        parentIntentId?: string | undefined;
+    }[];
+    todoSyncState: {
+        version: number;
+        lastSyncTimestamp: string;
+        todoMdHash: string;
+        knowledgeGraphHash: string;
+        syncStatus: "error" | "pending" | "synced" | "conflict";
+        lastModifiedBy: "tool" | "human" | "sync";
+        conflictDetails?: {
+            conflict: string;
+            taskId: string;
+            todoVersion: string;
+            kgVersion: string;
+        }[] | undefined;
+    };
+    analytics: {
+        totalIntents: number;
+        completedIntents: number;
+        activeIntents: number;
+        averageGoalCompletion: number;
+        mostUsedTools: {
+            toolName: string;
+            usageCount: number;
+        }[];
+        successfulPatterns: {
+            successRate: number;
+            pattern: string;
+            examples: string[];
+        }[];
+    };
+}>;
+export type ToolExecutionSnapshot = z.infer<typeof ToolExecutionSnapshotSchema>;
+export type IntentSnapshot = z.infer<typeof IntentSnapshotSchema>;
+export type TodoSyncState = z.infer<typeof TodoSyncStateSchema>;
+export type KnowledgeGraphSnapshot = z.infer<typeof KnowledgeGraphSnapshotSchema>;
+export interface IntentGoal {
+    id: string;
+    description: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+    completionPercentage: number;
+    linkedTasks: string[];
+    linkedAdrs: string[];
+}
+export interface ToolChainPattern {
+    id: string;
+    name: string;
+    tools: string[];
+    successRate: number;
+    averageExecutionTime: number;
+    commonGoalTypes: string[];
+    lastUsed: string;
+}
+export interface ConflictResolutionStrategy {
+    type: 'timestamp' | 'manual' | 'merge' | 'preserve_human';
+    description: string;
+    autoResolve: boolean;
+}
+//# sourceMappingURL=knowledge-graph-schemas.d.ts.map

package/dist/src/types/knowledge-graph-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-schemas.d.ts","sourceRoot":"","sources":["../../../src/types/knowledge-graph-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;EAStC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW/B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAa9B,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoBvC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,gBAAgB,CAAC;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACtB"}

package/dist/src/types/knowledge-graph-schemas.js

@@ -0,0 +1,59 @@
+import { z } from 'zod';
+export const ToolExecutionSnapshotSchema = z.object({
+    toolName: z.string(),
+    parameters: z.record(z.any()),
+    result: z.record(z.any()),
+    todoTasksCreated: z.array(z.string()),
+    todoTasksModified: z.array(z.string()),
+    executionTime: z.string(),
+    success: z.boolean(),
+    error: z.string().optional()
+});
+export const IntentSnapshotSchema = z.object({
+    intentId: z.string(),
+    humanRequest: z.string(),
+    parsedGoals: z.array(z.string()),
+    priority: z.enum(['high', 'medium', 'low']),
+    timestamp: z.string(),
+    toolChain: z.array(ToolExecutionSnapshotSchema),
+    currentStatus: z.enum(['planning', 'executing', 'completed', 'failed']),
+    todoMdSnapshot: z.string(),
+    parentIntentId: z.string().optional(),
+    tags: z.array(z.string()).optional()
+});
+export const TodoSyncStateSchema = z.object({
+    lastSyncTimestamp: z.string(),
+    todoMdHash: z.string(),
+    knowledgeGraphHash: z.string(),
+    syncStatus: z.enum(['synced', 'pending', 'conflict', 'error']),
+    conflictDetails: z.array(z.object({
+        taskId: z.string(),
+        conflict: z.string(),
+        todoVersion: z.string(),
+        kgVersion: z.string()
+    })).optional(),
+    lastModifiedBy: z.enum(['human', 'tool', 'sync']),
+    version: z.number()
+});
+export const KnowledgeGraphSnapshotSchema = z.object({
+    version: z.string(),
+    timestamp: z.string(),
+    intents: z.array(IntentSnapshotSchema),
+    todoSyncState: TodoSyncStateSchema,
+    analytics: z.object({
+        totalIntents: z.number(),
+        completedIntents: z.number(),
+        activeIntents: z.number(),
+        averageGoalCompletion: z.number(),
+        mostUsedTools: z.array(z.object({
+            toolName: z.string(),
+            usageCount: z.number()
+        })),
+        successfulPatterns: z.array(z.object({
+            pattern: z.string(),
+            successRate: z.number(),
+            examples: z.array(z.string())
+        }))
+    })
+});
+//# sourceMappingURL=knowledge-graph-schemas.js.map

package/dist/src/types/knowledge-graph-schemas.js.map

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

package/dist/src/utils/json-safe.d.ts

@@ -0,0 +1,38 @@
+/**
+ * JSON-Safe String Utilities
+ *
+ * Utilities for safely escaping strings in JSON-RPC 2.0 responses
+ * to prevent parse errors in MCP communication
+ */
+/**
+ * Escape a string to be JSON-safe for MCP responses
+ * Only escapes actual control characters and problematic JSON chars
+ */
+export declare function jsonSafe(str: string | undefined | null): string;
+/**
+ * Escape an array of strings to be JSON-safe
+ */
+export declare function jsonSafeArray(arr: (string | undefined | null)[]): string[];
+/**
+ * Safely join an array of strings with JSON-safe escaping
+ */
+export declare function jsonSafeJoin(arr: (string | undefined | null)[], separator?: string): string;
+/**
+ * Create a JSON-safe markdown list from an array of items
+ */
+export declare function jsonSafeMarkdownList(items: (string | undefined | null)[], prefix?: string): string;
+/**
+ * Safely escape file paths for JSON output - minimal escaping for display
+ * Only normalizes path separators and escapes quotes
+ */
+export declare function jsonSafeFilePath(filePath: string | undefined | null): string;
+/**
+ * Safely escape user input content that might contain dangerous characters
+ * Use this for content that comes from external sources or user input
+ */
+export declare function jsonSafeUserInput(str: string | undefined | null): string;
+/**
+ * Safely escape error messages that might contain quotes or special chars
+ */
+export declare function jsonSafeError(error: unknown): string;
+//# sourceMappingURL=json-safe.d.ts.map

package/dist/src/utils/json-safe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-safe.d.ts","sourceRoot":"","sources":["../../../src/utils/json-safe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAwB/D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,CAE1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,SAAS,GAAE,MAAa,GAAG,MAAM,CAEjG;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE,MAAM,GAAE,MAAa,GAAG,MAAM,CAKxG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAS5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOpD"}

package/dist/src/utils/json-safe.js

@@ -0,0 +1,86 @@
+/**
+ * JSON-Safe String Utilities
+ *
+ * Utilities for safely escaping strings in JSON-RPC 2.0 responses
+ * to prevent parse errors in MCP communication
+ */
+/**
+ * Escape a string to be JSON-safe for MCP responses
+ * Only escapes actual control characters and problematic JSON chars
+ */
+export function jsonSafe(str) {
+    if (str == null) {
+        return '';
+    }
+    return String(str)
+        // Escape backslashes first (before escaping quotes)
+        .replace(/\\/g, '\\\\')
+        // Escape double quotes
+        .replace(/"/g, '\\"')
+        // Only escape actual control characters (not regex \b)
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        // Escape other potentially problematic control characters (but not \b word boundary)
+        .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F]/g, (char) => {
+        const code = char.charCodeAt(0);
+        switch (code) {
+            case 0x08: return '\\b'; // actual backspace character
+            case 0x0C: return '\\f'; // form feed
+            default:
+                return '\\u' + ('0000' + code.toString(16)).slice(-4);
+        }
+    });
+}
+/**
+ * Escape an array of strings to be JSON-safe
+ */
+export function jsonSafeArray(arr) {
+    return arr.map(jsonSafe);
+}
+/**
+ * Safely join an array of strings with JSON-safe escaping
+ */
+export function jsonSafeJoin(arr, separator = '\n') {
+    return jsonSafeArray(arr).join(separator);
+}
+/**
+ * Create a JSON-safe markdown list from an array of items
+ */
+export function jsonSafeMarkdownList(items, prefix = '- ') {
+    return jsonSafeArray(items)
+        .filter(item => item.length > 0)
+        .map(item => `${prefix}${item}`)
+        .join('\n');
+}
+/**
+ * Safely escape file paths for JSON output - minimal escaping for display
+ * Only normalizes path separators and escapes quotes
+ */
+export function jsonSafeFilePath(filePath) {
+    if (!filePath) {
+        return '';
+    }
+    // For file paths, only escape quotes and backslashes, normalize separators
+    return String(filePath)
+        .replace(/\\/g, '/') // Normalize Windows paths
+        .replace(/"/g, '\\"'); // Only escape quotes for JSON safety
+}
+/**
+ * Safely escape user input content that might contain dangerous characters
+ * Use this for content that comes from external sources or user input
+ */
+export function jsonSafeUserInput(str) {
+    return jsonSafe(str);
+}
+/**
+ * Safely escape error messages that might contain quotes or special chars
+ */
+export function jsonSafeError(error) {
+    if (!error) {
+        return 'Unknown error';
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    return jsonSafe(message);
+}
+//# sourceMappingURL=json-safe.js.map

package/dist/src/utils/json-safe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-safe.js","sourceRoot":"","sources":["../../../src/utils/json-safe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAA8B;IACrD,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC;QAChB,oDAAoD;SACnD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,uBAAuB;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;QACrB,uDAAuD;SACtD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;QACtB,qFAAqF;SACpF,OAAO,CAAC,wDAAwD,EAAE,CAAC,IAAI,EAAE,EAAE;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,6BAA6B;YACtD,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,YAAY;YACrC;gBACE,OAAO,KAAK,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAkC;IAC9D,OAAO,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAkC,EAAE,YAAoB,IAAI;IACvF,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAoC,EAAE,SAAiB,IAAI;IAC9F,OAAO,aAAa,CAAC,KAAK,CAAC;SACxB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;SAC/B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAmC;IAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,2EAA2E;IAC3E,OAAO,MAAM,CAAC,QAAQ,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,0BAA0B;SAC9C,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,qCAAqC;AAChE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAA8B;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC"}