@holonograph/client 0.8.0 → 0.10.0

package/dist/index.js

@@ -4199,6 +4199,44 @@ var DimensionJudgeIdentitySchema = external_exports.object({
  rubricDefaultReason: external_exports.string().min(1).optional()
 });
 
+var JUDGE_ASSERTION_KINDS = ["tool-not-invoked", "datum-absent"];
+var JudgeAssertionKindSchema = external_exports.enum(JUDGE_ASSERTION_KINDS);
+var DATUM_ABSENCE_DIRECTIONS = ["commission", "omission"];
+var DatumAbsenceDirectionSchema = external_exports.enum(DATUM_ABSENCE_DIRECTIONS);
+var JudgeAssertionSchema = external_exports.discriminatedUnion("kind", [
+ external_exports.object({
+ kind: external_exports.literal("tool-not-invoked"),
+ tool: external_exports.string().min(1)
+ }),
+ external_exports.object({
+ kind: external_exports.literal("datum-absent"),
+ datum: external_exports.string().min(1),
+ reference: external_exports.string().min(1).optional(),
+
+ direction: DatumAbsenceDirectionSchema.optional()
+ })
+]);
+var JudgeClaimReportSchema = external_exports.discriminatedUnion("status", [
+ external_exports.object({
+
+ status: external_exports.literal("emitted"),
+
+ assertions: external_exports.array(JudgeAssertionSchema)
+ }),
+ external_exports.object({
+
+ status: external_exports.literal("malformed"),
+
+ reflectionAttempted: external_exports.boolean(),
+
+ raw: external_exports.string().optional()
+ })
+]);
+var JudgeClaimContractSchema = external_exports.object({
+
+ assertionKinds: external_exports.array(JudgeAssertionKindSchema).min(1)
+}).strict();
+
 var CannedMessageRefSchema = external_exports.string().min(1).max(256);
 var ALL_GATE_FAILURE_ACTIONS = ["retry", "flag", "block"];
 var GateFailureActionSchema = external_exports.enum(ALL_GATE_FAILURE_ACTIONS);
@@ -4285,7 +4323,9 @@ var GradingDimensionSchema = external_exports.object({
 
  valueDomain: ValueDomainSchema.optional(),
 
- rubricDispatch: RubricDispatchSchema.optional()
+ rubricDispatch: RubricDispatchSchema.optional(),
+
+ judgeClaimContract: JudgeClaimContractSchema.optional()
 }).superRefine((dimension, ctx) => {
  const codomain = scoringCodomain(dimension.scoring);
  if (codomain === null) return;
@@ -4301,6 +4341,13 @@ var GradingDimensionSchema = external_exports.object({
  };
  check(dimension.passThreshold, ["passThreshold"]);
  check(dimension.gatePolicy?.passThreshold, ["gatePolicy", "passThreshold"]);
+ if (dimension.judgeClaimContract !== void 0 && dimension.scoring !== "llm-judge") {
+ ctx.addIssue({
+ code: external_exports.ZodIssueCode.custom,
+ path: ["judgeClaimContract"],
+ message: `judgeClaimContract is only valid on an 'llm-judge' dimension (this dimension is '${dimension.scoring}'); only the llm-judge scorer emits a structured judge claim.`
+ });
+ }
  if (dimension.rubricDispatch !== void 0) {
  if (dimension.scoring !== "llm-judge") {
  ctx.addIssue({
@@ -4961,7 +5008,9 @@ var DimensionResultSchema = external_exports.object({
 
  rationale: external_exports.string().optional(),
 
- judge: DimensionJudgeIdentitySchema.optional()
+ judge: DimensionJudgeIdentitySchema.optional(),
+
+ claim: JudgeClaimReportSchema.optional()
 
 }).passthrough();
 var ALL_GATE_ACTIONS_TAKEN = [
@@ -5503,6 +5552,24 @@ ${issues}`
  return parsed.data;
 }
 
+var JudgeClaimCoverageReportSchema = external_exports.object({
+ surfaceId: SurfaceIdSchema,
+ dimensionId: DimensionIdSchema,
+
+ assertionKinds: external_exports.array(JudgeAssertionKindSchema),
+
+ scoredCount: external_exports.number().int().nonnegative(),
+
+ emitted: external_exports.number().int().nonnegative(),
+
+ malformed: external_exports.number().int().nonnegative(),
+
+ absent: external_exports.number().int().nonnegative()
+});
+external_exports.object({
+ reports: external_exports.array(JudgeClaimCoverageReportSchema)
+});
+
 var LensAvailabilityMarkSingleRequestSchema = external_exports.object({
  mode: external_exports.literal("single"),
 
@@ -5804,6 +5871,8 @@ var GroundingClaimCheckSchema = external_exports.object({
  datum: external_exports.string().min(1),
  disposition: GroundingClaimDispositionSchema,
 
+ direction: DatumAbsenceDirectionSchema.optional(),
+
  matchTier: MatchTierSchema.optional(),
 
  charOffset: external_exports.number().int().nonnegative().optional()
@@ -5812,6 +5881,7 @@ var GROUNDING_COVERAGE_DISPOSITIONS = [
  "present-in-scope",
  "truncated-out",
  "not-found",
+ "grounding-sufficient",
  "no-marker-to-check",
  "not-applicable"
 ];
@@ -5861,6 +5931,8 @@ external_exports.object({
 
  flagged: external_exports.array(FlaggedVerdictSchema),
 
+ trustDrivers: external_exports.record(external_exports.string(), external_exports.number().int().nonnegative()),
+
  corpusRates: ReliabilityCorpusRatesSchema
 });
 var ESCALATION_REASONS = ["both-checks-not-applicable"];
@@ -5975,6 +6047,7 @@ external_exports.object({
 var ALL_FINDING_SOURCES = [
  "verdict-reliability",
  "judge-liveness",
+ "judge-malfunction",
  "trajectory",
  "orthogonality-hypothesis",
  "coverage-gap",
@@ -6073,6 +6146,15 @@ var VerdictReliabilityEvidenceSchema = external_exports.object({
 
  sampleEventIds: external_exports.array(external_exports.string().min(1))
 });
+var JudgeMalfunctionEvidenceSchema = external_exports.object({
+ kind: external_exports.literal("judge-malfunction"),
+
+ sampleCorrelationIds: external_exports.array(external_exports.string().min(1)),
+
+ sampleEventIds: external_exports.array(external_exports.string().min(1)),
+
+ reflectionAttempted: external_exports.boolean()
+});
 var OrthogonalityEvidenceSchema = external_exports.object({
  kind: external_exports.literal("orthogonality-hypothesis"),
 
@@ -6151,6 +6233,7 @@ var ReachGapEvidenceSchema = external_exports.object({
 });
 var AttentionEvidenceSchema = external_exports.discriminatedUnion("kind", [
  VerdictReliabilityEvidenceSchema,
+ JudgeMalfunctionEvidenceSchema,
  OrthogonalityEvidenceSchema,
  TrajectoryEvidenceSchema,
  JudgeLivenessEvidenceSchema,
@@ -6207,6 +6290,19 @@ var VerdictReliabilityExemplarSchema = external_exports.object({
 
  groundingClaims: external_exports.array(GroundingClaimCheckSchema)
 });
+var JudgeMalfunctionExemplarSchema = external_exports.object({
+ source: external_exports.literal("judge-malfunction"),
+ eventId: external_exports.string().min(1),
+ correlationId: external_exports.string().min(1).optional(),
+ occurredAt: external_exports.string().min(1),
+ dimensionId: DimensionIdSchema,
+
+ reflectionAttempted: external_exports.boolean(),
+
+ raw: external_exports.string().optional(),
+
+ prompt: external_exports.string().optional()
+});
 var OrthogonalityGroupSchema = external_exports.object({
 
  value: external_exports.string().min(1),
@@ -6440,6 +6536,7 @@ var ReachGapExemplarSchema = external_exports.object({
 });
 var AttentionExemplarSchema = external_exports.discriminatedUnion("source", [
  VerdictReliabilityExemplarSchema,
+ JudgeMalfunctionExemplarSchema,
  OrthogonalityExemplarSchema,
  TrajectoryExemplarSchema,
  JudgeLivenessExemplarSchema,
@@ -6504,9 +6601,10 @@ var FacetDefaultBreakdownSchema = external_exports.object({
 });
 var FacetCoverageReportSchema = external_exports.object({
  surfaceId: SurfaceIdSchema,
- dimensionId: DimensionIdSchema,
 
- facet: external_exports.string().min(1),
+ dimensionId: DimensionIdSchema.optional(),
+
+ facet: external_exports.string().min(1).optional(),
 
  scoredCount: external_exports.number().int().nonnegative(),
 
@@ -7832,6 +7930,7 @@ var HolonographClient = class {
  if (d.score !== void 0) dim.score = d.score;
  if (d.rationale !== void 0) dim.rationale = d.rationale;
  if (d.judge !== void 0) dim.judge = d.judge;
+ if (d.claim !== void 0) dim.claim = d.claim;
  return dim;
  }),
  cohortTags: primaryCohortTags,
@@ -7907,6 +8006,7 @@ var HolonographClient = class {
  if (d.score !== void 0) dim.score = d.score;
  if (d.rationale !== void 0) dim.rationale = d.rationale;
  if (d.judge !== void 0) dim.judge = d.judge;
+ if (d.claim !== void 0) dim.claim = d.claim;
  return dim;
  }),
  cohortTags: observerCohortTags,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holonograph/client",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "TypeScript HTTP client for a Holonograph lens. Send messages through the lens and report scored outcomes back to it.",
   "license": "MIT",
   "type": "module",