couchloop-eq-mcp 1.1.4 → 1.1.6

package/dist/tools/smart-context.js

@@ -0,0 +1,167 @@
+/**
+ * MCP Tool: smart_context
+ *
+ * Intelligent context management that bundles:
+ * - Save checkpoint (progress capture)
+ * - Save insight (meaningful realizations)
+ * - Preserve context (project knowledge)
+ * - Build context detection (understand project setup)
+ *
+ * One call to capture everything important from a conversation.
+ */
+import { z } from 'zod';
+import { saveCheckpoint } from './checkpoint.js';
+import { saveInsight } from './insight.js';
+import { storeContext } from './preserve-context.js';
+import { handleDetectBuildContext } from './detect-build-context.js';
+import { logger } from '../utils/logger.js';
+const SmartContextInputSchema = z.object({
+    // What to capture
+    content: z.string().describe('The content to capture'),
+    key: z.string().optional().describe('Key/label for the content'),
+    // Context type - determines what gets saved where
+    type: z.enum([
+        'checkpoint', // Progress in a journey
+        'insight', // User realization/learning
+        'decision', // Architectural decision
+        'requirement', // Project requirement
+        'constraint', // Technical constraint
+        'pattern', // Code pattern to remember
+        'conversation', // General conversation context
+    ]).describe('Type of context being saved'),
+    // Optional enrichment
+    tags: z.array(z.string()).optional().describe('Tags for categorization'),
+    session_id: z.string().uuid().optional().describe('Session to associate with'),
+    detect_project: z.boolean().default(false).describe('Also detect and store build context'),
+    // Auth
+    auth: z.any().optional(),
+});
+export const smartContextTool = {
+    name: 'smart_context',
+    description: 'Intelligently capture and preserve context from conversations. Automatically routes to the right storage: checkpoints for progress, insights for realizations, context for technical decisions. One tool to remember everything important.',
+    annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        openWorldHint: false,
+    },
+    inputSchema: {
+        type: 'object',
+        properties: {
+            content: {
+                type: 'string',
+                description: 'The content to capture',
+            },
+            key: {
+                type: 'string',
+                description: 'Key/label for the content',
+            },
+            type: {
+                type: 'string',
+                enum: ['checkpoint', 'insight', 'decision', 'requirement', 'constraint', 'pattern', 'conversation'],
+                description: 'Type of context being saved',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Tags for categorization',
+            },
+            session_id: {
+                type: 'string',
+                description: 'Session to associate with',
+            },
+            detect_project: {
+                type: 'boolean',
+                description: 'Also detect and store build context (default: false)',
+            },
+        },
+        required: ['content', 'type'],
+    },
+};
+export async function handleSmartContext(args) {
+    try {
+        const input = SmartContextInputSchema.parse(args);
+        const key = input.key || input.type;
+        logger.info(`Smart context capture: ${input.type}`);
+        const results = {};
+        // Route based on type
+        switch (input.type) {
+            case 'checkpoint':
+                // Save as checkpoint
+                results.checkpoint = await saveCheckpoint({
+                    key,
+                    value: { content: input.content, tags: input.tags },
+                    session_id: input.session_id,
+                    save_as_insight: false,
+                    preserve_context: false,
+                    auth: input.auth,
+                });
+                break;
+            case 'insight':
+                // Save as insight
+                results.insight = await saveInsight({
+                    content: input.content,
+                    session_id: input.session_id,
+                    tags: input.tags || ['insight'],
+                    auth: input.auth,
+                });
+                break;
+            case 'decision':
+            case 'requirement':
+            case 'constraint':
+            case 'pattern': {
+                // Map to context categories
+                const categoryMap = {
+                    decision: 'decisions',
+                    requirement: 'requirements',
+                    constraint: 'constraints',
+                    pattern: 'technical-patterns',
+                };
+                const category = categoryMap[input.type] || 'decisions';
+                await storeContext(category, `[${key}] ${input.content}`);
+                results.context = { category, stored: true };
+                // Also save as insight for searchability
+                results.insight = await saveInsight({
+                    content: input.content,
+                    session_id: input.session_id,
+                    tags: [input.type, ...(input.tags || [])],
+                    auth: input.auth,
+                });
+                break;
+            }
+            case 'conversation':
+                // Save to both checkpoint and context
+                if (input.session_id) {
+                    results.checkpoint = await saveCheckpoint({
+                        key: key || 'conversation',
+                        value: { content: input.content, tags: input.tags },
+                        session_id: input.session_id,
+                        auth: input.auth,
+                    });
+                }
+                // Also preserve as context
+                await storeContext('project-metadata', `[conversation] ${input.content}`);
+                results.context = { category: 'project-metadata', stored: true };
+                break;
+        }
+        // Optionally detect build context
+        if (input.detect_project) {
+            results.build_context = await handleDetectBuildContext({});
+        }
+        // Log full results server-side
+        logger.debug('[SmartContext] Full results:', results);
+        // Return sanitized response
+        return {
+            success: true,
+            type: input.type,
+            message: `Context captured as ${input.type}`,
+        };
+    }
+    catch (error) {
+        logger.error('Error in smart_context:', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+//# sourceMappingURL=smart-context.js.map

package/dist/tools/smart-context.js.map

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

package/dist/types/checkpoint.d.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+declare const ContextCategoryEnum: z.ZodEnum<["architecture", "requirements", "constraints", "decisions", "technical-patterns", "project-metadata"]>;
 export declare const SaveCheckpointSchema: z.ZodObject<{
     session_id: z.ZodOptional<z.ZodString>;
     key: z.ZodString;
@@ -20,9 +21,17 @@ export declare const SaveCheckpointSchema: z.ZodObject<{
         token?: string | undefined;
         conversation_id?: string | undefined;
     }>>;
+    save_as_insight: z.ZodDefault<z.ZodBoolean>;
+    insight_tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    preserve_context: z.ZodDefault<z.ZodBoolean>;
+    context_category: z.ZodOptional<z.ZodEnum<["architecture", "requirements", "constraints", "decisions", "technical-patterns", "project-metadata"]>>;
+    governance_check: z.ZodDefault<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     key: string;
     advance_step: boolean;
+    save_as_insight: boolean;
+    preserve_context: boolean;
+    governance_check: boolean;
     session_id?: string | undefined;
     value?: any;
     auth?: {
@@ -31,6 +40,8 @@ export declare const SaveCheckpointSchema: z.ZodObject<{
         token?: string | undefined;
         conversation_id?: string | undefined;
     } | undefined;
+    insight_tags?: string[] | undefined;
+    context_category?: "architecture" | "requirements" | "constraints" | "decisions" | "technical-patterns" | "project-metadata" | undefined;
 }, {
     key: string;
     session_id?: string | undefined;
@@ -42,14 +53,28 @@ export declare const SaveCheckpointSchema: z.ZodObject<{
         conversation_id?: string | undefined;
     } | undefined;
     advance_step?: boolean | undefined;
+    save_as_insight?: boolean | undefined;
+    insight_tags?: string[] | undefined;
+    preserve_context?: boolean | undefined;
+    context_category?: "architecture" | "requirements" | "constraints" | "decisions" | "technical-patterns" | "project-metadata" | undefined;
+    governance_check?: boolean | undefined;
 }>;
 export type SaveCheckpointInput = z.infer<typeof SaveCheckpointSchema>;
+export type ContextCategory = z.infer<typeof ContextCategoryEnum>;
 export interface CheckpointResponse {
     checkpoint_id: string;
     session_id: string;
     session_created: boolean;
-    next_step: any | null;
+    next_step: unknown | null;
     journey_complete: boolean;
     message: string;
+    insight_id?: string;
+    context_stored?: boolean;
+    governance_result?: {
+        allowed: boolean;
+        issues: string[];
+        confidence: number;
+    };
 }
+export {};
 //# sourceMappingURL=checkpoint.d.ts.map

package/dist/types/checkpoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/types/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,GAAG,GAAG,IAAI,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../src/types/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,QAAA,MAAM,mBAAmB,mHAOvB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiB/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/types/checkpoint.js

@@ -1,10 +1,27 @@
 import { z } from 'zod';
 import { AuthContextSchema } from './auth.js';
+// Context categories for preserve_context integration
+const ContextCategoryEnum = z.enum([
+    'architecture',
+    'requirements',
+    'constraints',
+    'decisions',
+    'technical-patterns',
+    'project-metadata'
+]);
 export const SaveCheckpointSchema = z.object({
     session_id: z.string().uuid().optional().describe('Active session ID (auto-created if not provided)'),
     key: z.string().describe('What is being captured (e.g., "mood", "reflection", "gratitude")'),
     value: z.any().describe('The captured content'),
     advance_step: z.boolean().default(true).describe('Whether to advance to next journey step'),
     auth: AuthContextSchema.optional().describe('Authentication context for user identification'),
+    // === Consolidated from save_insight ===
+    save_as_insight: z.boolean().default(false).describe('Also save this as a user insight'),
+    insight_tags: z.array(z.string()).optional().describe('Tags for the insight if saving as insight'),
+    // === Consolidated from preserve_context ===
+    preserve_context: z.boolean().default(false).describe('Also store as persistent project context'),
+    context_category: ContextCategoryEnum.optional().describe('Category for context preservation'),
+    // === Governance metadata ===
+    governance_check: z.boolean().default(true).describe('Run governance validation on the value'),
 });
 //# sourceMappingURL=checkpoint.js.map

package/dist/types/checkpoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/types/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACrG,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC/C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC3F,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;CAC9F,CAAC,CAAC"}
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/types/checkpoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,sDAAsD;AACtD,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC;IACjC,cAAc;IACd,cAAc;IACd,aAAa;IACb,WAAW;IACX,oBAAoB;IACpB,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACrG,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kEAAkE,CAAC;IAC5F,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC/C,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC3F,IAAI,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAE7F,yCAAyC;IACzC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IACxF,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAElG,6CAA6C;IAC7C,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IACjG,gBAAgB,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAE9F,8BAA8B;IAC9B,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CAC/F,CAAC,CAAC"}

package/dist/types/journey.d.ts

@@ -27,8 +27,8 @@ export declare const JourneyStepSchema: z.ZodObject<{
         instructions?: string | undefined;
     };
     type: "prompt" | "checkpoint" | "summary";
-    order: number;
     optional: boolean;
+    order: number;
 }, {
     id: string;
     content: {
@@ -37,8 +37,8 @@ export declare const JourneyStepSchema: z.ZodObject<{
         instructions?: string | undefined;
     };
     type: "prompt" | "checkpoint" | "summary";
-    order: number;
     optional: boolean;
+    order: number;
 }>;
 export type JourneyStep = z.infer<typeof JourneyStepSchema>;
 export declare const JourneySchema: z.ZodObject<{
@@ -72,8 +72,8 @@ export declare const JourneySchema: z.ZodObject<{
             instructions?: string | undefined;
         };
         type: "prompt" | "checkpoint" | "summary";
-        order: number;
         optional: boolean;
+        order: number;
     }, {
         id: string;
         content: {
@@ -82,8 +82,8 @@ export declare const JourneySchema: z.ZodObject<{
             instructions?: string | undefined;
         };
         type: "prompt" | "checkpoint" | "summary";
-        order: number;
         optional: boolean;
+        order: number;
     }>, "many">;
     estimatedMinutes: z.ZodNumber;
     tags: z.ZodArray<z.ZodString, "many">;
@@ -99,8 +99,8 @@ export declare const JourneySchema: z.ZodObject<{
             instructions?: string | undefined;
         };
         type: "prompt" | "checkpoint" | "summary";
-        order: number;
         optional: boolean;
+        order: number;
     }[];
     estimatedMinutes: number;
     tags: string[];
@@ -117,8 +117,8 @@ export declare const JourneySchema: z.ZodObject<{
             instructions?: string | undefined;
         };
         type: "prompt" | "checkpoint" | "summary";
-        order: number;
         optional: boolean;
+        order: number;
     }[];
     estimatedMinutes: number;
     tags: string[];

package/dist/types/session.d.ts

@@ -21,23 +21,23 @@ export declare const CreateSessionSchema: z.ZodObject<{
         conversation_id?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    journey_slug?: string | undefined;
-    context?: string | undefined;
     auth?: {
         user_id?: string | undefined;
         client_id?: string | undefined;
         token?: string | undefined;
         conversation_id?: string | undefined;
     } | undefined;
-}, {
     journey_slug?: string | undefined;
     context?: string | undefined;
+}, {
     auth?: {
         user_id?: string | undefined;
         client_id?: string | undefined;
         token?: string | undefined;
         conversation_id?: string | undefined;
     } | undefined;
+    journey_slug?: string | undefined;
+    context?: string | undefined;
 }>;
 export type CreateSessionInput = z.infer<typeof CreateSessionSchema>;
 export declare const ResumeSessionSchema: z.ZodObject<{

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Response Sanitization Utilities
+ *
+ * Strips sensitive internal metadata from responses before returning to users.
+ * Full data is logged server-side for debugging.
+ */
+/**
+ * Sanitize a response object by removing sensitive fields
+ */
+export declare function sanitizeResponse<T extends Record<string, unknown>>(response: T, options?: {
+    logLevel?: 'debug' | 'info' | 'none';
+    allowFields?: string[];
+}): Record<string, unknown>;
+/**
+ * Sanitize an array of objects
+ */
+export declare function sanitizeArray<T extends Record<string, unknown>>(items: T[], options?: {
+    allowFields?: string[];
+}): Record<string, unknown>[];
+/**
+ * Check if a response contains any sensitive fields
+ */
+export declare function hasSensitiveData(obj: Record<string, unknown>): boolean;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmDH;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,QAAQ,EAAE,CAAC,EACX,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyCzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7D,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAE3B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAatE"}

package/dist/utils/sanitize.js

@@ -0,0 +1,117 @@
+/**
+ * Response Sanitization Utilities
+ *
+ * Strips sensitive internal metadata from responses before returning to users.
+ * Full data is logged server-side for debugging.
+ */
+import { logger } from './logger.js';
+/**
+ * Fields that should NEVER be exposed to end users
+ */
+const SENSITIVE_FIELDS = [
+    'sessionId',
+    'session_id',
+    'threadId',
+    'thread_id',
+    'messageId',
+    'message_id',
+    'userId',
+    'user_id',
+    'insightId',
+    'insight_id',
+    'checkpointId',
+    'checkpoint_id',
+    'crisisLevel',
+    'crisis_level',
+    'crisisConfidence',
+    'crisis_confidence',
+    'crisisIndicators',
+    'crisis_indicators',
+    'selfCorrected',
+    'self_corrected',
+    'currentStep',
+    'current_step',
+    'internalId',
+    'internal_id',
+    'auth',
+    'token',
+    'apiKey',
+    'api_key',
+];
+/**
+ * Fields that ARE safe to expose
+ */
+const SAFE_FIELDS = [
+    'success',
+    'content',
+    'message',
+    'timestamp',
+    'type',
+    'error',
+    'crisis_resources', // Only if crisis detected
+];
+/**
+ * Sanitize a response object by removing sensitive fields
+ */
+export function sanitizeResponse(response, options) {
+    const { logLevel = 'debug', allowFields = [] } = options || {};
+    // Log full response server-side before sanitizing
+    if (logLevel === 'debug') {
+        logger.debug('[Sanitize] Full response (internal):', response);
+    }
+    else if (logLevel === 'info') {
+        logger.info('[Sanitize] Full response (internal):', response);
+    }
+    const safeFields = [...SAFE_FIELDS, ...allowFields];
+    const sanitized = {};
+    for (const [key, value] of Object.entries(response)) {
+        // Skip sensitive fields
+        if (SENSITIVE_FIELDS.includes(key)) {
+            continue;
+        }
+        // Skip nested metadata objects (they often contain sensitive data)
+        if (key === 'metadata' && typeof value === 'object' && value !== null) {
+            // Only extract crisis detection status for safety messaging
+            const meta = value;
+            if (meta.crisisDetected === true) {
+                sanitized.crisis_resources = '988 Suicide & Crisis Lifeline • Crisis Text Line: text HOME to 741741';
+            }
+            continue;
+        }
+        // Include safe fields
+        if (safeFields.includes(key) || !SENSITIVE_FIELDS.some(s => key.toLowerCase().includes(s.toLowerCase()))) {
+            // Recursively sanitize nested objects
+            if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                sanitized[key] = sanitizeResponse(value, { logLevel: 'none' });
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+    }
+    return sanitized;
+}
+/**
+ * Sanitize an array of objects
+ */
+export function sanitizeArray(items, options) {
+    return items.map(item => sanitizeResponse(item, { ...options, logLevel: 'none' }));
+}
+/**
+ * Check if a response contains any sensitive fields
+ */
+export function hasSensitiveData(obj) {
+    for (const key of Object.keys(obj)) {
+        if (SENSITIVE_FIELDS.includes(key)) {
+            return true;
+        }
+        const value = obj[key];
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            if (hasSensitiveData(value)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/utils/sanitize.js.map

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

package/dist/workflows/index.d.ts

@@ -15,8 +15,8 @@ export declare const journeysBySlug: Map<string, {
             instructions?: string | undefined;
         };
         type: "prompt" | "checkpoint" | "summary";
-        order: number;
         optional: boolean;
+        order: number;
     }[];
     estimatedMinutes: number;
     tags: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "couchloop-eq-mcp",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Behavioral governance layer for LLMs - monitors for hallucination, inconsistency, tone drift, and unsafe reasoning while managing stateful AI sessions",
   "main": "dist/index.js",
   "type": "module",