couchloop-eq-mcp 1.1.4 → 1.2.0

package/dist/tools/verify.js

@@ -0,0 +1,308 @@
+/**
+ * MCP Tool: verify
+ *
+ * Pre-delivery verification for AI-generated content.
+ * Catches hallucinations, incorrect packages, bad code, and unsafe responses
+ * BEFORE they reach the user.
+ */
+import { z } from 'zod';
+import { AIErrorPreventer } from '../developer/evaluators/ai-error-preventer.js';
+import { PackageBlocker } from '../developer/blockers/package-blocker.js';
+import { PackageEvaluator } from '../developer/evaluators/package-evaluator.js';
+import { EvaluationEngine, InterventionAction, RiskLevel } from '../governance/evaluationEngine.js';
+import { logger } from '../utils/logger.js';
+const VerifyInputSchema = z.object({
+    type: z.enum(['code', 'packages', 'facts', 'response', 'all']).describe('What to verify'),
+    content: z.string().describe('The AI-generated content to verify'),
+    language: z.string().optional().describe('Programming language for code verification'),
+    registry: z.enum(['npm', 'pypi', 'maven', 'cargo', 'go', 'nuget', 'gem']).optional().default('npm'),
+    context: z.string().optional().describe('Additional context'),
+    session_id: z.string().optional(),
+});
+export const verifyTool = {
+    definition: {
+        name: 'verify',
+        description: `CRITICAL: Pre-delivery verification for AI-generated content. Call BEFORE presenting code, package recommendations, or factual claims to users. Catches: hallucinated packages (24% of AI suggestions don't exist!), hallucinated APIs, incorrect imports, ESM/CJS confusion, deprecated methods, security vulnerabilities, inconsistencies with previous statements. Returns verification result with fixes if needed.`,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: ['code', 'packages', 'facts', 'response', 'all'],
+                    description: "What to verify: 'code' for syntax/APIs, 'packages' for npm/pypi existence, 'facts' for claims/statistics, 'response' for governance/tone, 'all' for comprehensive check",
+                },
+                content: {
+                    type: 'string',
+                    description: 'The AI-generated content to verify before presenting to user',
+                },
+                language: {
+                    type: 'string',
+                    description: 'Programming language for code verification',
+                },
+                registry: {
+                    type: 'string',
+                    enum: ['npm', 'pypi', 'maven', 'cargo', 'go', 'nuget', 'gem'],
+                    description: 'Package registry for package verification (default: npm)',
+                },
+                context: {
+                    type: 'string',
+                    description: "Additional context: user's original question, project type, etc.",
+                },
+            },
+            required: ['type', 'content'],
+        },
+    },
+    handler: handleVerify,
+};
+export async function handleVerify(args) {
+    try {
+        const input = VerifyInputSchema.parse(args);
+        logger.info('Running verification check', { type: input.type });
+        const results = {
+            verified: true,
+            type: input.type,
+            checks_run: [],
+            issues: [],
+            fixes: [],
+            warnings: [],
+            confidence: 1.0,
+        };
+        // Run appropriate checks based on type
+        if (input.type === 'code' || input.type === 'all') {
+            const codeResult = await verifyCode(input.content, input.language || 'typescript');
+            results.checks_run.push('code');
+            if (codeResult.issues.length > 0) {
+                results.verified = false;
+                results.issues.push(...codeResult.issues);
+                results.fixes.push(...codeResult.fixes);
+            }
+            results.warnings.push(...codeResult.warnings);
+            results.code_verification = codeResult;
+        }
+        if (input.type === 'packages' || input.type === 'all') {
+            const packageResult = await verifyPackages(input.content, input.registry || 'npm');
+            results.checks_run.push('packages');
+            if (packageResult.invalid.length > 0) {
+                results.verified = false;
+                results.issues.push(...packageResult.invalid.map(p => `Package does not exist: ${p}`));
+                results.fixes.push(...packageResult.suggestions);
+            }
+            results.package_verification = packageResult;
+        }
+        if (input.type === 'facts' || input.type === 'response' || input.type === 'all') {
+            const governanceResult = await verifyResponse(input.content, input.session_id);
+            results.checks_run.push('governance');
+            if (governanceResult.action !== InterventionAction.APPROVE) {
+                results.verified = false;
+                results.issues.push(...governanceResult.issues);
+                if (governanceResult.modified_content) {
+                    results.fixes.push(`Modified content: ${governanceResult.modified_content}`);
+                }
+            }
+            results.confidence = Math.min(results.confidence, 1 - governanceResult.risk_score);
+            results.governance_verification = governanceResult;
+        }
+        // Calculate overall confidence
+        results.confidence = results.issues.length === 0 ? 1.0 :
+            Math.max(0.1, 1 - (results.issues.length * 0.15));
+        return {
+            success: true,
+            ...results,
+            summary: results.verified
+                ? `✓ Verified. ${results.checks_run.length} checks passed.`
+                : `✗ Issues found. ${results.issues.length} problems detected in ${results.checks_run.join(', ')}.`,
+            recommendation: results.verified
+                ? 'Safe to present to user.'
+                : 'Review issues before presenting. Apply suggested fixes if available.',
+        };
+    }
+    catch (error) {
+        logger.error('Error in verify:', error);
+        return {
+            success: false,
+            verified: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+            recommendation: 'Verification failed. Do not present unverified content.',
+        };
+    }
+}
+async function verifyCode(code, language) {
+    const preventer = new AIErrorPreventer();
+    const result = await preventer.preventErrors(code, language, {
+        autoFix: true,
+        checkBuildContext: true,
+    });
+    const issues = [];
+    const fixes = [];
+    const warnings = result.warnings || [];
+    for (const error of result.errors) {
+        issues.push(`[${error.pattern.impact.toUpperCase()}] ${error.pattern.name}: ${error.pattern.description}`);
+        if (error.suggestion) {
+            fixes.push(error.suggestion);
+        }
+    }
+    return {
+        issues,
+        fixes,
+        warnings,
+        ai_errors_found: result.errors.length,
+        build_context: result.buildContext ? {
+            language: result.buildContext.language,
+            module_system: result.buildContext.moduleSystem,
+            requires_js_extensions: result.buildContext.requiresJsExtensions,
+        } : undefined,
+        fixed_code: result.fixedCode,
+    };
+}
+async function verifyPackages(content, registry) {
+    const blocker = new PackageBlocker(true);
+    const evaluator = new PackageEvaluator();
+    // Extract package names from content
+    const packages = extractPackageNames(content);
+    // Determine language from registry
+    const language = registry === 'npm' ? 'javascript' :
+        registry === 'pypi' ? 'python' :
+            registry === 'maven' ? 'java' : 'unknown';
+    const result = {
+        packages_checked: packages,
+        valid: [],
+        invalid: [],
+        suggestions: [],
+        typosquatting_detected: [],
+        deprecated: [],
+    };
+    // Use interceptCode to validate the content
+    const blockResult = await blocker.interceptCode(content, language);
+    if (!blockResult.allowed) {
+        result.invalid.push(...blockResult.blockedPackages);
+        result.suggestions.push(...blockResult.warnings);
+        // Add suggestions from blocker
+        for (const [pkg, suggs] of Object.entries(blockResult.suggestions)) {
+            if (suggs.length > 0) {
+                result.suggestions.push(`For "${pkg}": ${suggs.join(', ')}`);
+            }
+        }
+    }
+    // Check remaining valid packages for deprecation
+    const validPackages = packages.filter(p => !blockResult.blockedPackages.includes(p));
+    for (const pkg of validPackages) {
+        try {
+            const evalResult = await evaluator.evaluate(pkg, { language: language });
+            if (evalResult.package.deprecated) {
+                result.deprecated.push(pkg);
+                result.suggestions.push(`Package "${pkg}" is deprecated. ${evalResult.warning || ''}`);
+            }
+            else if (!evalResult.blocked) {
+                result.valid.push(pkg);
+            }
+            else {
+                result.invalid.push(pkg);
+                if (evalResult.warning) {
+                    result.suggestions.push(evalResult.warning);
+                }
+            }
+        }
+        catch (e) {
+            // If we can't validate, mark as needs manual check
+            result.suggestions.push(`Could not validate "${pkg}" - manual verification recommended`);
+        }
+    }
+    return result;
+}
+function extractPackageNames(content) {
+    const packages = new Set();
+    // npm install patterns
+    const npmInstall = content.match(/npm\s+i(?:nstall)?\s+([^\n&|;]+)/gi);
+    if (npmInstall) {
+        for (const match of npmInstall) {
+            const pkgs = match.replace(/npm\s+i(?:nstall)?\s+/i, '').split(/\s+/);
+            pkgs.forEach(p => {
+                if (p && !p.startsWith('-')) {
+                    packages.add(p.replace(/@[\d.]+$/, '')); // Remove version
+                }
+            });
+        }
+    }
+    // import/require patterns
+    const imports = content.match(/(?:import|require)\s*\(?['"]([^'"./][^'"]*)['"]\)?/g);
+    if (imports) {
+        for (const match of imports) {
+            const pkg = match.match(/['"]([^'"./][^'"]*)['"]/)?.[1];
+            if (pkg) {
+                // Get base package name (handle scoped packages)
+                const basePkg = pkg.startsWith('@')
+                    ? pkg.split('/').slice(0, 2).join('/')
+                    : pkg.split('/')[0];
+                if (basePkg) {
+                    packages.add(basePkg);
+                }
+            }
+        }
+    }
+    // pip install patterns
+    const pipInstall = content.match(/pip\s+install\s+([^\n&|;]+)/gi);
+    if (pipInstall) {
+        for (const match of pipInstall) {
+            const pkgs = match.replace(/pip\s+install\s+/i, '').split(/\s+/);
+            pkgs.forEach(p => {
+                if (p && !p.startsWith('-')) {
+                    packages.add(p.replace(/[=<>].*$/, '')); // Remove version constraints
+                }
+            });
+        }
+    }
+    return Array.from(packages);
+}
+async function verifyResponse(content, sessionId) {
+    const engine = new EvaluationEngine();
+    const context = {
+        sessionId: sessionId || 'verification-check',
+    };
+    const evaluation = await engine.evaluate(content, context);
+    const issues = [];
+    if (evaluation.hallucination.detected) {
+        issues.push(`Potential hallucination detected (${Math.round(evaluation.hallucination.confidence * 100)}% confidence)`);
+        if (evaluation.hallucination.patterns) {
+            issues.push(...evaluation.hallucination.patterns.map(p => `  - ${p}`));
+        }
+    }
+    if (evaluation.inconsistency.detected) {
+        issues.push(`Inconsistency with previous statements detected (${Math.round(evaluation.inconsistency.confidence * 100)}% confidence)`);
+    }
+    if (evaluation.toneDrift.detected) {
+        issues.push(`Tone drift detected (${Math.round(evaluation.toneDrift.confidence * 100)}% confidence)`);
+        if (evaluation.toneDrift.patterns) {
+            issues.push(...evaluation.toneDrift.patterns.map(p => `  - ${p}`));
+        }
+    }
+    if (evaluation.unsafeReasoning.detected) {
+        issues.push(`Unsafe reasoning pattern detected (${Math.round(evaluation.unsafeReasoning.confidence * 100)}% confidence)`);
+        if (evaluation.unsafeReasoning.patterns) {
+            issues.push(...evaluation.unsafeReasoning.patterns.map(p => `  - ${p}`));
+        }
+    }
+    // Calculate risk score
+    const riskScores = {
+        [RiskLevel.NONE]: 0,
+        [RiskLevel.LOW]: 0.25,
+        [RiskLevel.MEDIUM]: 0.5,
+        [RiskLevel.HIGH]: 0.75,
+        [RiskLevel.CRITICAL]: 1.0,
+    };
+    return {
+        action: evaluation.recommendedAction,
+        risk_level: evaluation.overallRisk,
+        risk_score: riskScores[evaluation.overallRisk],
+        issues,
+        hallucination_detected: evaluation.hallucination.detected,
+        inconsistency_detected: evaluation.inconsistency.detected,
+        tone_drift_detected: evaluation.toneDrift.detected,
+        unsafe_reasoning_detected: evaluation.unsafeReasoning.detected,
+    };
+}
+//# sourceMappingURL=verify.js.map

package/dist/tools/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/tools/verify.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/insight.d.ts

@@ -20,8 +20,8 @@ export declare const SaveInsightSchema: z.ZodObject<{
         conversation_id?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
-    tags: string[];
     content: string;
+    tags: string[];
     session_id?: string | undefined;
     auth?: {
         user_id?: string | undefined;
@@ -31,8 +31,8 @@ export declare const SaveInsightSchema: z.ZodObject<{
     } | undefined;
 }, {
     content: string;
-    tags?: string[] | undefined;
     session_id?: string | undefined;
+    tags?: string[] | undefined;
     auth?: {
         user_id?: string | undefined;
         client_id?: string | undefined;

package/dist/types/journey.d.ts

@@ -20,25 +20,25 @@ export declare const JourneyStepSchema: z.ZodObject<{
     }>;
     optional: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    id: string;
+    type: "prompt" | "checkpoint" | "summary";
     content: {
         prompt?: string | undefined;
         checkpoint_key?: string | undefined;
         instructions?: string | undefined;
     };
-    type: "prompt" | "checkpoint" | "summary";
-    order: number;
+    id: string;
     optional: boolean;
+    order: number;
 }, {
-    id: string;
+    type: "prompt" | "checkpoint" | "summary";
     content: {
         prompt?: string | undefined;
         checkpoint_key?: string | undefined;
         instructions?: string | undefined;
     };
-    type: "prompt" | "checkpoint" | "summary";
-    order: number;
+    id: string;
     optional: boolean;
+    order: number;
 }>;
 export type JourneyStep = z.infer<typeof JourneyStepSchema>;
 export declare const JourneySchema: z.ZodObject<{
@@ -65,25 +65,25 @@ export declare const JourneySchema: z.ZodObject<{
         }>;
         optional: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        id: string;
+        type: "prompt" | "checkpoint" | "summary";
         content: {
             prompt?: string | undefined;
             checkpoint_key?: string | undefined;
             instructions?: string | undefined;
         };
-        type: "prompt" | "checkpoint" | "summary";
-        order: number;
+        id: string;
         optional: boolean;
+        order: number;
     }, {
-        id: string;
+        type: "prompt" | "checkpoint" | "summary";
         content: {
             prompt?: string | undefined;
             checkpoint_key?: string | undefined;
             instructions?: string | undefined;
         };
-        type: "prompt" | "checkpoint" | "summary";
-        order: number;
+        id: string;
         optional: boolean;
+        order: number;
     }>, "many">;
     estimatedMinutes: z.ZodNumber;
     tags: z.ZodArray<z.ZodString, "many">;
@@ -92,15 +92,15 @@ export declare const JourneySchema: z.ZodObject<{
     slug: string;
     description: string;
     steps: {
-        id: string;
+        type: "prompt" | "checkpoint" | "summary";
         content: {
             prompt?: string | undefined;
             checkpoint_key?: string | undefined;
             instructions?: string | undefined;
         };
-        type: "prompt" | "checkpoint" | "summary";
-        order: number;
+        id: string;
         optional: boolean;
+        order: number;
     }[];
     estimatedMinutes: number;
     tags: string[];
@@ -110,15 +110,15 @@ export declare const JourneySchema: z.ZodObject<{
     slug: string;
     description: string;
     steps: {
-        id: string;
+        type: "prompt" | "checkpoint" | "summary";
         content: {
             prompt?: string | undefined;
             checkpoint_key?: string | undefined;
             instructions?: string | undefined;
         };
-        type: "prompt" | "checkpoint" | "summary";
-        order: number;
+        id: string;
         optional: boolean;
+        order: number;
     }[];
     estimatedMinutes: number;
     tags: string[];

package/dist/types/session.d.ts

@@ -21,7 +21,6 @@ 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;
@@ -29,8 +28,8 @@ export declare const CreateSessionSchema: z.ZodObject<{
         token?: string | undefined;
         conversation_id?: string | undefined;
     } | undefined;
-}, {
     journey_slug?: string | undefined;
+}, {
     context?: string | undefined;
     auth?: {
         user_id?: string | undefined;
@@ -38,6 +37,7 @@ export declare const CreateSessionSchema: z.ZodObject<{
         token?: string | undefined;
         conversation_id?: string | undefined;
     } | undefined;
+    journey_slug?: 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"}