gensokyo-dev
e50a271c72
Add shared, typed input-contract and timeout-state recovery guidance. Normalize SDK input failures within the actual MCP wire budget, preserve full diagnostics and protocol metadata, and retain original Evidence when normalized delivery would exceed the budget. Fixes #5431.
115 lines
3.4 KiB
TypeScript
115 lines
3.4 KiB
TypeScript
import { z } from "zod";
|
|
|
|
import { analysisErrorRecoverySchema } from "../domain/analysisErrorRecovery.js";
|
|
import { jsonValueSchema } from "../domain/jsonValue.js";
|
|
import type { AnalysisErrorProjection } from "../domain/analysisErrorProjection.js";
|
|
|
|
const categorySchema = z.enum([
|
|
"invalid_input",
|
|
"unsupported_provider",
|
|
"unsupported_target",
|
|
"integrity_mismatch",
|
|
"truncated",
|
|
"cancelled",
|
|
"timeout",
|
|
"resource_constraint",
|
|
"unavailable",
|
|
"execution_failure",
|
|
]);
|
|
const remediationSchema = z
|
|
.object({
|
|
action: z.string().min(1),
|
|
})
|
|
.strict();
|
|
const common = {
|
|
category: categorySchema,
|
|
message: z.string().min(1),
|
|
retryable: z.boolean(),
|
|
remediation: remediationSchema,
|
|
recovery: analysisErrorRecoverySchema.optional(),
|
|
};
|
|
const genericDetails = z.record(z.string(), jsonValueSchema).optional();
|
|
const generic = <Code extends string>(code: Code) =>
|
|
z
|
|
.object({ code: z.literal(code), ...common, details: genericDetails })
|
|
.strict();
|
|
|
|
/** Stable discriminated schema shared by every CLI and MCP error surface. */
|
|
export const analysisErrorProjectionSchema = z.discriminatedUnion("code", [
|
|
generic("invalid_request"),
|
|
generic("access_denied"),
|
|
generic("artifact_changed"),
|
|
generic("unreadable_output"),
|
|
generic("capability_unavailable"),
|
|
generic("unsupported_target"),
|
|
generic("provider_unavailable"),
|
|
generic("provider_timeout"),
|
|
generic("resource_constraint"),
|
|
generic("cancelled"),
|
|
z
|
|
.object({
|
|
code: z.literal("artifact_integrity_mismatch"),
|
|
...common,
|
|
details: z.union([
|
|
z.strictObject({
|
|
logical_path: z.string(),
|
|
declared_sha256: z.string().nullable(),
|
|
calculated_sha256: z.string().nullable(),
|
|
unpacked: z.boolean(),
|
|
}),
|
|
z.strictObject({
|
|
logical_path: z.string(),
|
|
algorithm: z.literal("md5"),
|
|
declared_md5: z.string().regex(/^[a-f0-9]{32}$/u),
|
|
calculated_md5: z
|
|
.string()
|
|
.regex(/^[a-f0-9]{32}$/u)
|
|
.nullable(),
|
|
unpacked: z.boolean(),
|
|
}),
|
|
]),
|
|
})
|
|
.strict(),
|
|
generic("artifact_operation_failed"),
|
|
generic("evidence_integrity_mismatch"),
|
|
generic("truncated"),
|
|
generic("process_capture_failed"),
|
|
generic("cleanup_incomplete"),
|
|
generic("revision_conflict"),
|
|
generic("configuration_invalid"),
|
|
generic("target_unavailable"),
|
|
generic("execution_failure"),
|
|
]) as unknown as z.ZodType<AnalysisErrorProjection>;
|
|
|
|
/** CLI label and input diagnostics surrounding the strict canonical error projection. */
|
|
export const analysisCliErrorEnvelopeSchema = z
|
|
.object({
|
|
error: z.string().min(1),
|
|
input_path: z.string().optional(),
|
|
input_reason: z
|
|
.enum(["invalid-json", "read-failed", "too-large"])
|
|
.optional(),
|
|
})
|
|
.passthrough()
|
|
.superRefine((value, context) => {
|
|
const {
|
|
error: _label,
|
|
input_path: _inputPath,
|
|
input_reason: _inputReason,
|
|
...projection
|
|
} = value;
|
|
const parsed = analysisErrorProjectionSchema.safeParse(projection);
|
|
if (!parsed.success) {
|
|
context.addIssue({
|
|
code: "custom",
|
|
message:
|
|
"CLI error envelope must contain a canonical analysis error projection",
|
|
});
|
|
}
|
|
});
|
|
|
|
/** JSON Schema document used by generated API documentation and clients. */
|
|
export const analysisErrorJsonSchema = z.toJSONSchema(
|
|
analysisErrorProjectionSchema,
|
|
);
|