llm-output-guard 0.5.0 → 1.0.0

package/README.md

@@ -526,7 +526,9 @@ output starts to reach.
 
 ## Stability
 
-What semver means for this package specifically.
+What semver means for this package specifically. These rules bind from **1.0.0**
+onward; under `0.x` they described an intent, and the surface was frozen — export
+by export — in the 1.0.0 release.
 
 **The public API is:** everything exported from `llm-output-guard`, plus
 `outputGuard` / `OutputGuardOptions` / `DegenerateAction` from `./ai-sdk` and
@@ -534,7 +536,8 @@ What semver means for this package specifically.
 Each subpath is its own contract; the two adapters share an internal base type
 today and are free to diverge, so an option added to one is not a promise about
 the other. Anything not exported from those three entry points is internal, has
-no stability guarantee, and may move in any release.
+no stability guarantee, and may move in any release. The list is asserted in
+`test/surface.test.ts`, so an export cannot join it by accident.
 
 **Threshold and preset values are behaviour, not implementation.** This is the
 interesting case, so it gets a rule of its own:

package/dist/index.cjs

@@ -579,12 +579,10 @@ exports.compressibilityScore = compressibilityScore;
 exports.compressionRatio = compressionRatio;
 exports.createStreamGuard = createStreamGuard;
 exports.emptinessScore = emptinessScore;
-exports.findGap = findGap;
 exports.guardStream = guardStream;
 exports.jsonScore = jsonScore;
 exports.languageMismatchScore = languageMismatchScore;
 exports.languageProfile = languageProfile;
-exports.percentile = percentile;
 exports.presets = presets;
 exports.repetitionScore = repetitionScore;
 exports.shortnessScore = shortnessScore;

package/dist/index.d.cts

@@ -102,19 +102,6 @@ interface Summary {
     /** Everything that would make the number above untrustworthy. */
     caveats: string[];
 }
-/** Linear-interpolated percentile. `sorted` must be ascending. */
-declare function percentile(sorted: number[], p: number): number;
-/**
- * The widest empty stretch in the upper tail, if there is one.
- *
- * A genuinely bimodal detector -- healthy output clustered near zero, a
- * handful of failures far above it -- leaves a visible hole between the two.
- * That hole is worth far more than a percentile, because it is evidence about
- * *this* detector on *your* traffic rather than an assumption about rarity.
- * Searching only above the median keeps the ordinary spread of healthy scores
- * from being mistaken for a separation.
- */
-declare function findGap(sorted: number[], minWidth?: number): Gap | null;
 /**
  * Summarise one detector's scores.
  *
@@ -412,4 +399,4 @@ declare function languageProfile(text: string): Record<string, number>;
 declare function languageMismatchScore(text: string, expected: string, options?: LanguageOptions): number;
 declare const supportedLanguages: string[];
 
-export { type Calibration, type CalibrationOptions, CheckOptions, type CompressibilityOptions, DegenerateOutputError, type Distribution, type Gap, type JsonOptions, type JsonResult, type LanguageOptions, ReasonCode, type RepetitionOptions, type ScoreSample, type Summary, type TailLoopOptions, type TailLoopResult, TokenMode, type TruncationOptions, Verdict, assertOutput, calibrate, checkOutput, compressibilityScore, compressionRatio, emptinessScore, findGap, jsonScore, languageMismatchScore, languageProfile, percentile, presets, repetitionScore, shortnessScore, stripFence, summarise, supportedLanguages, tailLoopDetail, tailLoopScore, truncationScore };
+export { type Calibration, type CalibrationOptions, CheckOptions, type CompressibilityOptions, DegenerateOutputError, type Distribution, type Gap, type JsonOptions, type JsonResult, type LanguageOptions, ReasonCode, type RepetitionOptions, type ScoreSample, type Summary, type TailLoopOptions, type TailLoopResult, TokenMode, type TruncationOptions, Verdict, assertOutput, calibrate, checkOutput, compressibilityScore, compressionRatio, emptinessScore, jsonScore, languageMismatchScore, languageProfile, presets, repetitionScore, shortnessScore, stripFence, summarise, supportedLanguages, tailLoopDetail, tailLoopScore, truncationScore };

package/dist/index.d.ts

@@ -102,19 +102,6 @@ interface Summary {
     /** Everything that would make the number above untrustworthy. */
     caveats: string[];
 }
-/** Linear-interpolated percentile. `sorted` must be ascending. */
-declare function percentile(sorted: number[], p: number): number;
-/**
- * The widest empty stretch in the upper tail, if there is one.
- *
- * A genuinely bimodal detector -- healthy output clustered near zero, a
- * handful of failures far above it -- leaves a visible hole between the two.
- * That hole is worth far more than a percentile, because it is evidence about
- * *this* detector on *your* traffic rather than an assumption about rarity.
- * Searching only above the median keeps the ordinary spread of healthy scores
- * from being mistaken for a separation.
- */
-declare function findGap(sorted: number[], minWidth?: number): Gap | null;
 /**
  * Summarise one detector's scores.
  *
@@ -412,4 +399,4 @@ declare function languageProfile(text: string): Record<string, number>;
 declare function languageMismatchScore(text: string, expected: string, options?: LanguageOptions): number;
 declare const supportedLanguages: string[];
 
-export { type Calibration, type CalibrationOptions, CheckOptions, type CompressibilityOptions, DegenerateOutputError, type Distribution, type Gap, type JsonOptions, type JsonResult, type LanguageOptions, ReasonCode, type RepetitionOptions, type ScoreSample, type Summary, type TailLoopOptions, type TailLoopResult, TokenMode, type TruncationOptions, Verdict, assertOutput, calibrate, checkOutput, compressibilityScore, compressionRatio, emptinessScore, findGap, jsonScore, languageMismatchScore, languageProfile, percentile, presets, repetitionScore, shortnessScore, stripFence, summarise, supportedLanguages, tailLoopDetail, tailLoopScore, truncationScore };
+export { type Calibration, type CalibrationOptions, CheckOptions, type CompressibilityOptions, DegenerateOutputError, type Distribution, type Gap, type JsonOptions, type JsonResult, type LanguageOptions, ReasonCode, type RepetitionOptions, type ScoreSample, type Summary, type TailLoopOptions, type TailLoopResult, TokenMode, type TruncationOptions, Verdict, assertOutput, calibrate, checkOutput, compressibilityScore, compressionRatio, emptinessScore, jsonScore, languageMismatchScore, languageProfile, presets, repetitionScore, shortnessScore, stripFence, summarise, supportedLanguages, tailLoopDetail, tailLoopScore, truncationScore };

package/dist/index.js

@@ -143,6 +143,6 @@ var presets = {
   }
 };
 
-export { calibrate, findGap, percentile, presets, summarise };
+export { calibrate, presets, summarise };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-output-guard",
-  "version": "0.5.0",
+  "version": "1.0.0",
   "description": "Detect degenerate LLM output that arrives with a 200 OK. Zero dependencies, deterministic, composes with any retry or fallback layer.",
   "keywords": [
     "llm",