agent-inspect 6.31.8 → 6.31.10

package/packages/core/dist/checks.cjs

@@ -72,6 +72,17 @@ var PROGRAMMATIC_DIAGNOSTIC_SPECS = Object.freeze({
     summary: "Trace contains a parentId cycle.",
     remediation: "Use visibility-first tree linking for legacy fixtures; prefer acyclic capture for new adapter output.",
     relatedCodes: ["structure.cycle"]
+  },
+  AI_TRACE_CONTRACT_INPUT_INVALID: {
+    code: "AI_TRACE_CONTRACT_INPUT_INVALID",
+    summary: "evaluateTraceContract expects ({ read }, contract) or use evaluateTraceContractRead(read, contract).",
+    remediation: "Pass TraceCheckInput as the first argument: evaluateTraceContract({ read }, contract).",
+    relatedCodes: ["AI_CHECK_INVALID_ARGUMENTS"]
+  },
+  AI_INSPECT_RUN_UNSUPPORTED_OPTION: {
+    code: "AI_INSPECT_RUN_UNSUPPORTED_OPTION",
+    summary: 'inspectRun does not accept a "writer" option.',
+    remediation: "Use createInspector({ writer }) then inspector.run(...). inspectRun persists via the global JSONL path (schema 0.1)."
   }
 });
 function formatProgrammaticDiagnostic(code, detail) {
@@ -3221,7 +3232,72 @@ function defineTraceContract(input) {
     ...alternatives ? { alternatives } : {}
   };
 }
+function isTraceReadLike(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  return typeof candidate.format === "string" && Array.isArray(candidate.runs) && Array.isArray(candidate.events);
+}
+function isTraceCheckInputLike(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  return isTraceReadLike(value.read);
+}
+function looksLikeTraceContract(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  if (isTraceReadLike(value) || isTraceCheckInputLike(value)) {
+    return false;
+  }
+  return true;
+}
+function invalidContractInputResult() {
+  return {
+    ok: false,
+    status: "error",
+    format: "unknown",
+    summary: {
+      passed: 0,
+      failed: 0,
+      warnings: 0,
+      errors: 1,
+      rulesEvaluated: 0
+    },
+    findings: [],
+    diagnostics: [
+      {
+        code: "AI_CHECK_INVALID_ARGUMENTS",
+        message: formatProgrammaticDiagnostic("AI_TRACE_CONTRACT_INPUT_INVALID"),
+        severity: "error"
+      }
+    ],
+    ruleExecutions: []
+  };
+}
+function validateEvaluateTraceContractArgs(input, contract) {
+  if (isTraceCheckInputLike(input) && looksLikeTraceContract(contract)) {
+    return void 0;
+  }
+  if (looksLikeTraceContract(input) && (isTraceCheckInputLike(contract) || isTraceReadLike(contract))) {
+    return invalidContractInputResult();
+  }
+  if (isTraceReadLike(input)) {
+    return invalidContractInputResult();
+  }
+  if (!isTraceCheckInputLike(input)) {
+    return invalidContractInputResult();
+  }
+  if (!looksLikeTraceContract(contract)) {
+    return invalidContractInputResult();
+  }
+  return void 0;
+}
 function evaluateTraceContract(input, contract, options = {}) {
+  const inputGuard = validateEvaluateTraceContractArgs(input, contract);
+  if (inputGuard !== void 0) {
+    return inputGuard;
+  }
   const shapeErrors = [
     ...validateAllowedStatusesShape(contract.run?.allowedStatuses),
     ...validateAlternativesShape(contract.alternatives),
@@ -3360,6 +3436,9 @@ function evaluateTraceContract(input, contract, options = {}) {
   );
 }
 function evaluateTraceContractRead(read, contract, options = {}) {
+  if (!isTraceReadLike(read) || !looksLikeTraceContract(contract)) {
+    return invalidContractInputResult();
+  }
   return evaluateTraceContract({ read }, contract, options);
 }
 function lintTraceContract(contract) {