@vibecodetown/mcp-server 1.3.1

package/build/mcp/contracts.d.ts

@@ -0,0 +1,609 @@
+import { z } from "zod";
+import { SelectionValidationResultSchema } from "./generated/selection_validation_result.js";
+import { ToolErrorOutputSchema, type ToolErrorOutput as ToolErrorOutputSSOT } from "./generated/tool_error_output.js";
+export { SelectionValidationResultSchema };
+export { ToolErrorOutputSchema };
+export declare const SignalLevelSchema: z.ZodEnum<["LEVEL_1", "LEVEL_2", "LEVEL_3"]>;
+export type SignalLevel = z.infer<typeof SignalLevelSchema>;
+export declare const DetailsSchema: z.ZodObject<{
+    what_happened: z.ZodString;
+    why_it_happened: z.ZodString;
+    linked_decision: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    what_happened: string;
+    why_it_happened: string;
+    linked_decision: string;
+}, {
+    what_happened: string;
+    why_it_happened: string;
+    linked_decision: string;
+}>;
+export type Details = z.infer<typeof DetailsSchema>;
+export declare const NextActionSchema: z.ZodObject<{
+    label: z.ZodString;
+    action: z.ZodEnum<["CONTINUE", "RETRY", "ADJUST", "REVISIT_SELECTION", "RESTART", "FORCE_OVERRIDE"]>;
+    payload: z.ZodOptional<z.ZodObject<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, "strip", z.ZodAny, z.objectOutputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">, z.objectInputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">>>;
+}, "strip", z.ZodAny, z.objectOutputType<{
+    label: z.ZodString;
+    action: z.ZodEnum<["CONTINUE", "RETRY", "ADJUST", "REVISIT_SELECTION", "RESTART", "FORCE_OVERRIDE"]>;
+    payload: z.ZodOptional<z.ZodObject<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, "strip", z.ZodAny, z.objectOutputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">, z.objectInputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">>>;
+}, z.ZodAny, "strip">, z.objectInputType<{
+    label: z.ZodString;
+    action: z.ZodEnum<["CONTINUE", "RETRY", "ADJUST", "REVISIT_SELECTION", "RESTART", "FORCE_OVERRIDE"]>;
+    payload: z.ZodOptional<z.ZodObject<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, "strip", z.ZodAny, z.objectOutputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">, z.objectInputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">>>;
+}, z.ZodAny, "strip">>;
+export type NextAction = z.infer<typeof NextActionSchema>;
+export declare const NextActionObjectSchema: z.ZodObject<{
+    label: z.ZodString;
+    action: z.ZodEnum<["CONTINUE", "RETRY", "ADJUST", "REVISIT_SELECTION", "RESTART", "FORCE_OVERRIDE"]>;
+    payload: z.ZodOptional<z.ZodObject<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, "strip", z.ZodAny, z.objectOutputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">, z.objectInputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">>>;
+}, "strip", z.ZodAny, z.objectOutputType<{
+    label: z.ZodString;
+    action: z.ZodEnum<["CONTINUE", "RETRY", "ADJUST", "REVISIT_SELECTION", "RESTART", "FORCE_OVERRIDE"]>;
+    payload: z.ZodOptional<z.ZodObject<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, "strip", z.ZodAny, z.objectOutputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">, z.objectInputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">>>;
+}, z.ZodAny, "strip">, z.objectInputType<{
+    label: z.ZodString;
+    action: z.ZodEnum<["CONTINUE", "RETRY", "ADJUST", "REVISIT_SELECTION", "RESTART", "FORCE_OVERRIDE"]>;
+    payload: z.ZodOptional<z.ZodObject<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, "strip", z.ZodAny, z.objectOutputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">, z.objectInputType<{
+        reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        reason: z.ZodOptional<z.ZodString>;
+        block_reason: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            title: z.ZodString;
+            explanation: z.ZodString;
+            suggested_decision_point: z.ZodOptional<z.ZodString>;
+            recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            failure_fingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }, {
+            code: string;
+            title: string;
+            explanation: string;
+            suggested_decision_point?: string | undefined;
+            recovery_hints?: string[] | undefined;
+            failure_fingerprint?: string | undefined;
+        }>>;
+    }, z.ZodAny, "strip">>>;
+}, z.ZodAny, "strip">>;
+export type NextActionObject = NextAction;
+export declare const PathsSchema: z.ZodOptional<z.ZodObject<{
+    bridge_path: z.ZodOptional<z.ZodString>;
+    result_path: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    bridge_path?: string | undefined;
+    result_path?: string | undefined;
+}, {
+    bridge_path?: string | undefined;
+    result_path?: string | undefined;
+}>>;
+export type Paths = z.infer<typeof PathsSchema>;
+export type SelectionValidationResult = z.infer<typeof SelectionValidationResultSchema>;
+export declare function parseSelectionValidationResult(input: unknown): SelectionValidationResult;
+export declare function safeParseSelectionValidationResult(input: unknown): z.SafeParseReturnType<{
+    type: "SELECTION_VALIDATION_RESULT";
+    details: {
+        what_happened: string;
+        why_it_happened: string;
+        linked_decision: string;
+    };
+    next_action: {
+        action: "CONTINUE" | "RETRY" | "ADJUST" | "REVISIT_SELECTION" | "RESTART" | "FORCE_OVERRIDE";
+        label: string;
+        payload?: z.objectInputType<{
+            reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            reason: z.ZodOptional<z.ZodString>;
+            block_reason: z.ZodOptional<z.ZodObject<{
+                code: z.ZodString;
+                title: z.ZodString;
+                explanation: z.ZodString;
+                suggested_decision_point: z.ZodOptional<z.ZodString>;
+                recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                failure_fingerprint: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                title: string;
+                explanation: string;
+                suggested_decision_point?: string | undefined;
+                recovery_hints?: string[] | undefined;
+                failure_fingerprint?: string | undefined;
+            }, {
+                code: string;
+                title: string;
+                explanation: string;
+                suggested_decision_point?: string | undefined;
+                recovery_hints?: string[] | undefined;
+                failure_fingerprint?: string | undefined;
+            }>>;
+        }, z.ZodAny, "strip"> | undefined;
+    } & {
+        [k: string]: any;
+    };
+    signal_level: "LEVEL_1" | "LEVEL_2" | "LEVEL_3";
+    headline: string;
+    paths?: {
+        bridge_path?: string | undefined;
+        result_path?: string | undefined;
+    } | undefined;
+}, {
+    type: "SELECTION_VALIDATION_RESULT";
+    details: {
+        what_happened: string;
+        why_it_happened: string;
+        linked_decision: string;
+    };
+    next_action: {
+        action: "CONTINUE" | "RETRY" | "ADJUST" | "REVISIT_SELECTION" | "RESTART" | "FORCE_OVERRIDE";
+        label: string;
+        payload?: z.objectOutputType<{
+            reopen_decision_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            reason: z.ZodOptional<z.ZodString>;
+            block_reason: z.ZodOptional<z.ZodObject<{
+                code: z.ZodString;
+                title: z.ZodString;
+                explanation: z.ZodString;
+                suggested_decision_point: z.ZodOptional<z.ZodString>;
+                recovery_hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                failure_fingerprint: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                title: string;
+                explanation: string;
+                suggested_decision_point?: string | undefined;
+                recovery_hints?: string[] | undefined;
+                failure_fingerprint?: string | undefined;
+            }, {
+                code: string;
+                title: string;
+                explanation: string;
+                suggested_decision_point?: string | undefined;
+                recovery_hints?: string[] | undefined;
+                failure_fingerprint?: string | undefined;
+            }>>;
+        }, z.ZodAny, "strip"> | undefined;
+    } & {
+        [k: string]: any;
+    };
+    signal_level: "LEVEL_1" | "LEVEL_2" | "LEVEL_3";
+    headline: string;
+    paths?: {
+        bridge_path?: string | undefined;
+        result_path?: string | undefined;
+    } | undefined;
+}>;
+export type ToolErrorOutput = ToolErrorOutputSSOT;
+/**
+ * Backwards-compatible alias for older modules that imported `ToolError`.
+ * Use `ToolErrorOutput` / `ToolErrorOutputSchema` going forward.
+ */
+export type ToolError = ToolErrorOutputSSOT;

package/build/mcp/contracts.js

@@ -0,0 +1,22 @@
+// contracts.ts
+// Central contract types for MCP adapter
+// SelectionValidationResult is generated from JSON Schema SSOT
+import { SelectionValidationResultSchema } from "./generated/selection_validation_result.js";
+import { ToolErrorOutputSchema } from "./generated/tool_error_output.js";
+// ============================================================
+// Generated Types (from JSON Schema SSOT)
+// ============================================================
+export { SelectionValidationResultSchema };
+export { ToolErrorOutputSchema };
+export const SignalLevelSchema = SelectionValidationResultSchema.shape.signal_level;
+export const DetailsSchema = SelectionValidationResultSchema.shape.details;
+export const NextActionSchema = SelectionValidationResultSchema.shape.next_action;
+// Backwards-compat alias (older docs / consumers)
+export const NextActionObjectSchema = NextActionSchema;
+export const PathsSchema = SelectionValidationResultSchema.shape.paths;
+export function parseSelectionValidationResult(input) {
+    return SelectionValidationResultSchema.parse(input);
+}
+export function safeParseSelectionValidationResult(input) {
+    return SelectionValidationResultSchema.safeParse(input);
+}