@warmdrift/kgauto-compiler 2.0.0-alpha.81 → 2.0.0-alpha.83
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{chunk-OZNAGO4U.mjs → chunk-QEFIAAE7.mjs} +1 -1
- package/dist/glassbox/index.d.mts +3 -3
- package/dist/glassbox/index.d.ts +3 -3
- package/dist/glassbox-routes/format.d.mts +2 -2
- package/dist/glassbox-routes/format.d.ts +2 -2
- package/dist/glassbox-routes/index.d.mts +4 -4
- package/dist/glassbox-routes/index.d.ts +4 -4
- package/dist/glassbox-routes/react/index.d.mts +2 -2
- package/dist/glassbox-routes/react/index.d.ts +2 -2
- package/dist/index.d.mts +183 -14
- package/dist/index.d.ts +183 -14
- package/dist/index.js +176 -32
- package/dist/index.mjs +164 -32
- package/dist/{ir-DZKS1tI7.d.ts → ir-Cx9hJj0B.d.ts} +1 -1
- package/dist/{ir-BFwWhj2s.d.mts → ir-D4S9R816.d.mts} +1 -1
- package/dist/key-health.js +1 -1
- package/dist/key-health.mjs +1 -1
- package/dist/profiles.d.mts +1 -1
- package/dist/profiles.d.ts +1 -1
- package/dist/{types-B4kz3Vs0.d.ts → types-CAs9-0S4.d.ts} +1 -1
- package/dist/{types-DpcAMmk-.d.mts → types-CRXaR7nJ.d.mts} +1 -1
- package/dist/{types-D_fLt_Xv.d.ts → types-Cvd6kRNv.d.ts} +1 -1
- package/dist/{types-hjzSWxtv.d.mts → types-DHi4FcUu.d.mts} +1 -1
- package/package.json +2 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { G as GlassboxEvent } from '../types-
|
|
2
|
-
export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-
|
|
3
|
-
import '../ir-
|
|
1
|
+
import { G as GlassboxEvent } from '../types-CRXaR7nJ.mjs';
|
|
2
|
+
export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-CRXaR7nJ.mjs';
|
|
3
|
+
import '../ir-D4S9R816.mjs';
|
|
4
4
|
import '../dialect.mjs';
|
|
5
5
|
|
|
6
6
|
/**
|
package/dist/glassbox/index.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { G as GlassboxEvent } from '../types-
|
|
2
|
-
export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-
|
|
3
|
-
import '../ir-
|
|
1
|
+
import { G as GlassboxEvent } from '../types-CAs9-0S4.js';
|
|
2
|
+
export { A as AdvisoryFiredData, C as CompileDoneData, a as CompileStartData, E as ExecuteAttemptData, b as ExecuteSuccessData, F as FallbackWalkedData, c as GLASSBOX_STREAM_TTL_MS, d as GlassboxEventKind, e as GlassboxPubSub } from '../types-CAs9-0S4.js';
|
|
3
|
+
import '../ir-Cx9hJj0B.js';
|
|
4
4
|
import '../dialect.js';
|
|
5
5
|
|
|
6
6
|
/**
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { G as GlassboxEvent } from '../types-
|
|
2
|
-
import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-
|
|
3
|
-
export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-
|
|
4
|
-
import '../ir-
|
|
1
|
+
import { G as GlassboxEvent } from '../types-CRXaR7nJ.mjs';
|
|
2
|
+
import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-DHi4FcUu.mjs';
|
|
3
|
+
export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-DHi4FcUu.mjs';
|
|
4
|
+
import '../ir-D4S9R816.mjs';
|
|
5
5
|
import '../dialect.mjs';
|
|
6
6
|
|
|
7
7
|
/**
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
import { G as GlassboxEvent } from '../types-
|
|
2
|
-
import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-
|
|
3
|
-
export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-
|
|
4
|
-
import '../ir-
|
|
1
|
+
import { G as GlassboxEvent } from '../types-CAs9-0S4.js';
|
|
2
|
+
import { a as TraceDetail, b as TraceSummary, c as TraceCounterfactual } from '../types-Cvd6kRNv.js';
|
|
3
|
+
export { A as AdvisoryRecord, T as TraceHealth, d as TraceSectionRewrite } from '../types-Cvd6kRNv.js';
|
|
4
|
+
import '../ir-Cx9hJj0B.js';
|
|
5
5
|
import '../dialect.js';
|
|
6
6
|
|
|
7
7
|
/**
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import * as react_jsx_runtime from 'react/jsx-runtime';
|
|
2
|
-
import { a as TraceDetail } from '../../types-
|
|
3
|
-
import '../../ir-
|
|
2
|
+
import { a as TraceDetail } from '../../types-DHi4FcUu.mjs';
|
|
3
|
+
import '../../ir-D4S9R816.mjs';
|
|
4
4
|
import '../../dialect.mjs';
|
|
5
5
|
|
|
6
6
|
/**
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import * as react_jsx_runtime from 'react/jsx-runtime';
|
|
2
|
-
import { a as TraceDetail } from '../../types-
|
|
3
|
-
import '../../ir-
|
|
2
|
+
import { a as TraceDetail } from '../../types-Cvd6kRNv.js';
|
|
3
|
+
import '../../ir-Cx9hJj0B.js';
|
|
4
4
|
import '../../dialect.js';
|
|
5
5
|
|
|
6
6
|
/**
|
package/dist/index.d.mts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, F as FallbackReason, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-
|
|
2
|
-
export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as hasMutation, K as mutationId, L as parseGoldenCaptureRate, Q as resolveGoldenCaptureRate, U as shouldCaptureGolden } from './ir-
|
|
1
|
+
import { C as CompilePolicy, N as NormalizedResponse, A as ApiKeys, P as ProviderOverrides, a as CompiledRequest, b as PromptIR, c as CallOptions, d as CallResult, S as SystemModelMessage, e as CompileResult, B as BestPracticeAdvisory, F as FallbackReason, f as SectionRewrite, R as RecordInput, g as RecordOutcomeInput, O as OutcomeResult, h as OracleScore, i as Adapter, j as PerAxisMetrics, k as Provider, l as ChainEntry, G as Grounding } from './ir-D4S9R816.mjs';
|
|
2
|
+
export { m as CallAttempt, n as CallError, o as ChainModelEntry, p as ChainWithGrounding, q as Constraints, E as EffortLevel, r as GoldenCaptureOptions, H as HistoryCachePolicy, I as IntentDeclaration, M as Message, s as MutationApplied, t as NormalizedTokens, u as OutcomeKind, v as PerAxisMetricsByModel, w as PromptSection, x as SectionKind, y as ShadowProbeConfig, T as ToolCall, z as ToolDefinition, D as captureGoldenIr, J as hasMutation, K as mutationId, L as parseGoldenCaptureRate, Q as resolveGoldenCaptureRate, U as shouldCaptureGolden } from './ir-D4S9R816.mjs';
|
|
3
3
|
import { ModelProfile, ArchetypeConvention } from './profiles.mjs';
|
|
4
4
|
export { ALIASES, CacheStrategy, CliffRule, LATENCY_TIER_MS, LatencyTier, LoweringSpec, RecoveryRule, StructuredOutputCapability, SystemPromptMode, allProfiles, getProfile, latencyTierOf, profilesByProvider, tryGetProfile } from './profiles.mjs';
|
|
5
5
|
export { BrainForwardConfig, BrainForwardRoutes, createBrainForwardRoutes } from './brain-proxy.mjs';
|
|
@@ -965,7 +965,11 @@ type GoldenEvalAxis = 'model' | 'strategy';
|
|
|
965
965
|
* measurable against its exact frozen bytes. The `-alt` wording is
|
|
966
966
|
* EVAL-ONLY: it exists to attribute a v1 loss to wording vs mechanism
|
|
967
967
|
* (§6) and never ships in a production compile. */
|
|
968
|
-
type GoldenEvalStrategyId = 'discipline-gates-v1' | 'discipline-gates-v1-alt';
|
|
968
|
+
type GoldenEvalStrategyId = 'discipline-gates-v1' | 'discipline-gates-v1-alt' | 'discipline-gates-v1-alt-blind';
|
|
969
|
+
/** Both re-wordings of v1. Dispatch keys on this, never on a string prefix,
|
|
970
|
+
* so adding a fourth arm is one edit rather than a grep. */
|
|
971
|
+
declare const ALT_STRATEGY_IDS: readonly GoldenEvalStrategyId[];
|
|
972
|
+
declare function isAltStrategy(id: GoldenEvalStrategyId | undefined): boolean;
|
|
969
973
|
interface GoldenEvalOptions {
|
|
970
974
|
appId: string;
|
|
971
975
|
archetype: string;
|
|
@@ -1085,6 +1089,45 @@ declare function altGatesBlockFor(args: {
|
|
|
1085
1089
|
outputMode: 'text' | 'json' | 'tool_call';
|
|
1086
1090
|
hasTools: boolean;
|
|
1087
1091
|
}): string;
|
|
1092
|
+
declare const ALT_BLIND_TOKEN_BUDGET_BREACH: {
|
|
1093
|
+
readonly ceilingTokens: 264;
|
|
1094
|
+
readonly measuredTokensTextWithTools: 285;
|
|
1095
|
+
readonly note: string;
|
|
1096
|
+
};
|
|
1097
|
+
declare const DISCIPLINE_GATES_V1_ALT_BLIND_HEADER = "Before stating any conclusion, run this check:";
|
|
1098
|
+
/**
|
|
1099
|
+
* The variant matrix — and this is the ONE place this seat's judgment enters
|
|
1100
|
+
* the blind arm, so it is stated rather than buried.
|
|
1101
|
+
*
|
|
1102
|
+
* cc's instruction: adapt MECHANICALLY where the injection format demands it,
|
|
1103
|
+
* note the diff, never edit semantics. Choosing which gates to drop per
|
|
1104
|
+
* surface is a selection, not an edit — the bytes of every retained gate are
|
|
1105
|
+
* untouched — but the selection is still mine, so:
|
|
1106
|
+
*
|
|
1107
|
+
* NO TOOLS drops `toolPredict`. Forced, not chosen: the string opens
|
|
1108
|
+
* "When using tools" and is literally inapplicable without them.
|
|
1109
|
+
* Mirrors v1 dropping its compressed-item bullet.
|
|
1110
|
+
* STRUCTURED drops `markAssumed` ONLY. It is the sole gate whose entire
|
|
1111
|
+
* function is text in the final answer ('mark anything unchecked
|
|
1112
|
+
* as "assumed"'), which a JSON/tool_call schema has no field for
|
|
1113
|
+
* and which would corrupt the parse.
|
|
1114
|
+
*
|
|
1115
|
+
* The judgment call worth flagging: v1 drops TWO bullets on structured
|
|
1116
|
+
* surfaces, and a stricter reading would also drop `falsify` ("state in one
|
|
1117
|
+
* line") and `deviation` ("say so explicitly"), since both demand output
|
|
1118
|
+
* text. I kept them. Their output demand is incidental (and conditional, for
|
|
1119
|
+
* `deviation`) while their primary effect is on reasoning before the answer
|
|
1120
|
+
* exists — whereas v1's dropped pair (`label`, `gap`) are purely
|
|
1121
|
+
* output-shaping. Dropping three of five would leave a two-gate arm that no
|
|
1122
|
+
* longer tests the same mechanism, and an arm crippled by my formatting
|
|
1123
|
+
* choice would read as a wording loss that was actually a scoping loss.
|
|
1124
|
+
* If the structured surface shows anomalous results, this is the first
|
|
1125
|
+
* thing to re-examine.
|
|
1126
|
+
*/
|
|
1127
|
+
declare function altBlindGatesBlockFor(args: {
|
|
1128
|
+
outputMode: 'text' | 'json' | 'tool_call';
|
|
1129
|
+
hasTools: boolean;
|
|
1130
|
+
}): string;
|
|
1088
1131
|
/**
|
|
1089
1132
|
* The alt arm injects its block DIRECTLY as an untagged section — it must
|
|
1090
1133
|
* not carry `kind: 'discipline_contract'`, or the translator would prepend
|
|
@@ -1094,6 +1137,14 @@ declare function altGatesBlockFor(args: {
|
|
|
1094
1137
|
* no-ops — the attribution is about WORDING, and everything else is held.
|
|
1095
1138
|
*/
|
|
1096
1139
|
declare function withAltDisciplineContract(ir: PromptIR): PromptIR;
|
|
1140
|
+
/**
|
|
1141
|
+
* Same injection contract as `withAltDisciplineContract` — untagged section,
|
|
1142
|
+
* so the translator never prepends the v1 bytes on top and the arm measures
|
|
1143
|
+
* exactly one wording. Same variant inputs, so the blind arm no-ops nowhere
|
|
1144
|
+
* v1 fires and fires nowhere v1 no-ops; the comparison is about WORDING and
|
|
1145
|
+
* everything else is held.
|
|
1146
|
+
*/
|
|
1147
|
+
declare function withAltBlindDisciplineContract(ir: PromptIR): PromptIR;
|
|
1097
1148
|
declare function runGoldenEval(opts: GoldenEvalOptions): Promise<GoldenEvalRunResult>;
|
|
1098
1149
|
/**
|
|
1099
1150
|
* Aggregate outcome of one strategy run, in gates-on terms. 'loses' is the
|
|
@@ -1107,25 +1158,54 @@ declare function classifyStrategyOutcome(r: GoldenEvalRunResult): StrategyOutcom
|
|
|
1107
1158
|
* recorded as a mechanism failure would let Factor B permanently disable a
|
|
1108
1159
|
* real capability on evidence about one author's prose.
|
|
1109
1160
|
*
|
|
1110
|
-
*
|
|
1111
|
-
*
|
|
1112
|
-
*
|
|
1113
|
-
*
|
|
1114
|
-
*
|
|
1115
|
-
*
|
|
1116
|
-
*
|
|
1161
|
+
* THREE arms since 2026-07-29. Both re-wordings run on a v1 loss, and a win
|
|
1162
|
+
* by EITHER is enough to acquit the mechanism — the question "does some
|
|
1163
|
+
* wording of this work?" is answered by one existence proof, so there is no
|
|
1164
|
+
* reason to require agreement between the alts.
|
|
1165
|
+
*
|
|
1166
|
+
* v1 vs off | alt / alt-blind vs off | attribution
|
|
1167
|
+
* ----------+------------------------+------------------------------------
|
|
1168
|
+
* wins | (not run) | mechanism-works — ship
|
|
1169
|
+
* ties | (not run) | no-lift — inconclusive at n, re-eval
|
|
1170
|
+
* loses | either wins | wording-failure — do NOT disable
|
|
1171
|
+
* loses | BOTH lose | mechanism-failure — Factor B may disable
|
|
1172
|
+
* loses | neither wins, not both lose | wording-inconclusive — no disable
|
|
1173
|
+
*
|
|
1174
|
+
* The `mechanism-failure` cell is the one that changed character. It used to
|
|
1175
|
+
* rest on two wordings by one author, so a shared blind spot (the principles
|
|
1176
|
+
* being the wrong principles) was invisible and the verdict was hedged. The
|
|
1177
|
+
* blind arm was authored by a context-free subagent with no knowledge of this
|
|
1178
|
+
* repo, the experiment, or who was asking — so a both-lose verdict now spans
|
|
1179
|
+
* independent authorship and is strong on its own terms. That is exactly the
|
|
1180
|
+
* gap `STRATEGY_AUTHORSHIP_LIMITATION` was written to confess, which is why
|
|
1181
|
+
* the limitation text is now conditional on whether the blind arm ran.
|
|
1117
1182
|
*/
|
|
1118
1183
|
type StrategyAttribution = 'mechanism-works' | 'no-lift' | 'wording-failure' | 'mechanism-failure' | 'wording-inconclusive' | 'inconclusive';
|
|
1119
1184
|
interface StrategyAttributionResult {
|
|
1120
1185
|
attribution: StrategyAttribution;
|
|
1121
1186
|
primary: GoldenEvalRunResult;
|
|
1122
|
-
/** Present ONLY when the primary lost (the loss-triggered
|
|
1187
|
+
/** Present ONLY when the primary lost (the loss-triggered arms). */
|
|
1123
1188
|
alt?: GoldenEvalRunResult;
|
|
1189
|
+
/** The independently-authored arm. Present ONLY when the primary lost. */
|
|
1190
|
+
altBlind?: GoldenEvalRunResult;
|
|
1124
1191
|
/** The authorship limitation, restated on every result so no downstream
|
|
1125
|
-
* reader can cite an attribution without it.
|
|
1192
|
+
* reader can cite an attribution without it. Which string this carries
|
|
1193
|
+
* depends on whether the blind arm actually ran — see below. */
|
|
1126
1194
|
limitation: string;
|
|
1127
1195
|
}
|
|
1196
|
+
/**
|
|
1197
|
+
* Carried when the blind arm did NOT run — i.e. v1 won or tied, so no
|
|
1198
|
+
* re-wording was measured at all and any claim about wording is unevidenced.
|
|
1199
|
+
*/
|
|
1128
1200
|
declare const STRATEGY_AUTHORSHIP_LIMITATION: string;
|
|
1201
|
+
/**
|
|
1202
|
+
* Carried when both re-wording arms ran. The shared-author caveat is GONE by
|
|
1203
|
+
* construction, and saying so is the point: the previous version of this
|
|
1204
|
+
* string confessed a gap that has since been closed, and a stale confession
|
|
1205
|
+
* is its own kind of false statement — a reader would discount a verdict
|
|
1206
|
+
* that no longer deserves discounting.
|
|
1207
|
+
*/
|
|
1208
|
+
declare const STRATEGY_AUTHORSHIP_INDEPENDENT: string;
|
|
1129
1209
|
/**
|
|
1130
1210
|
* Run the strategy eval with loss-triggered wording attribution: v1 first;
|
|
1131
1211
|
* the alt arm replays ONLY on a v1 loss (mirrors the engine's retry
|
|
@@ -1146,7 +1226,7 @@ declare function runStrategyEvalWithAttribution(opts: Omit<GoldenEvalOptions, 'a
|
|
|
1146
1226
|
* guard in `tests/version.test.ts` fails the suite (and therefore
|
|
1147
1227
|
* `prepublishOnly`) when they diverge — a stale constant cannot reach npm.
|
|
1148
1228
|
*/
|
|
1149
|
-
declare const LIBRARY_VERSION = "2.0.0-alpha.
|
|
1229
|
+
declare const LIBRARY_VERSION = "2.0.0-alpha.83";
|
|
1150
1230
|
|
|
1151
1231
|
/**
|
|
1152
1232
|
* Oracle contract — how an app tells the brain whether a response was good.
|
|
@@ -1795,6 +1875,77 @@ interface AdvisorySuggestedFix {
|
|
|
1795
1875
|
* view's snake_case columns to camelCase. See `feedback_typed_boundary_transformers.md`
|
|
1796
1876
|
* (L-118) for the rationale.
|
|
1797
1877
|
*/
|
|
1878
|
+
/**
|
|
1879
|
+
* The window of evidence a finding was computed from — migration 054.
|
|
1880
|
+
*
|
|
1881
|
+
* READ THE DISTINCTION BEFORE USING THIS. It is NOT `openedAt` /
|
|
1882
|
+
* `lastObservedAt` / `observationCount`, which describe the ADVISORY (how
|
|
1883
|
+
* long it has been firing, how many times the watcher ran and still saw the
|
|
1884
|
+
* condition). This describes what the generator LOOKED AT.
|
|
1885
|
+
*
|
|
1886
|
+
* A daily cron that keeps firing on a single 29-second burst reports
|
|
1887
|
+
* `observationCount: 11` spanning 11 days — the most standing-looking of
|
|
1888
|
+
* standing conditions — while its evidence is one event from 11 days ago.
|
|
1889
|
+
* Separating the two is the entire point.
|
|
1890
|
+
*
|
|
1891
|
+
* `null` when the generator did not state its window. Honest unknown; it
|
|
1892
|
+
* must never be read as "not a burst". Compile-time library rules carry
|
|
1893
|
+
* null legitimately — they fire on ONE call, so their evidence is the call
|
|
1894
|
+
* in hand and there is no window to state.
|
|
1895
|
+
*/
|
|
1896
|
+
interface AdvisoryEvidenceWindow {
|
|
1897
|
+
firstAt: string;
|
|
1898
|
+
lastAt: string;
|
|
1899
|
+
n: number;
|
|
1900
|
+
/** `lastAt - firstAt`, precomputed so no caller re-derives it wrong. */
|
|
1901
|
+
spanMs: number;
|
|
1902
|
+
/**
|
|
1903
|
+
* `true` when the evidence is clustered tightly enough to be ONE EVENT
|
|
1904
|
+
* rather than a standing rate. See `classifyEvidenceWindow`.
|
|
1905
|
+
*/
|
|
1906
|
+
isBurst: boolean;
|
|
1907
|
+
}
|
|
1908
|
+
/**
|
|
1909
|
+
* Burst-vs-rate, computed rather than judged.
|
|
1910
|
+
*
|
|
1911
|
+
* Origin: tt-intel s118. A cost query showed `claude-sonnet-5` at 30% of
|
|
1912
|
+
* their `ask` traffic and 80% of ask spend. Every number true, every
|
|
1913
|
+
* mechanism check correct, and every correct check made them more certain
|
|
1914
|
+
* the spend gate had regressed. All eleven calls sat in a 29-second window —
|
|
1915
|
+
* their own prior experiment, fixed six minutes after the last one. Their
|
|
1916
|
+
* formulation: **a cluster is an event, not a rate.**
|
|
1917
|
+
*
|
|
1918
|
+
* The rule, deliberately crude because a subtle one would need tuning per
|
|
1919
|
+
* rule and would then be wrong per rule: evidence is a burst when it spans
|
|
1920
|
+
* less than `BURST_SPAN_MS` (5 minutes). Multiple observations inside five
|
|
1921
|
+
* minutes are one incident — a deploy, a retry storm, a test run, a
|
|
1922
|
+
* benchmark — not a pattern of behavior over time.
|
|
1923
|
+
*
|
|
1924
|
+
* Two deliberate non-features:
|
|
1925
|
+
*
|
|
1926
|
+
* - **n is not in the test.** Two rows 4 minutes apart are as much a single
|
|
1927
|
+
* event as eleven are. Requiring a minimum n would let the smallest, least
|
|
1928
|
+
* evidenced findings skip the check.
|
|
1929
|
+
* - **It does not try to detect fossils.** A burst is not necessarily stale;
|
|
1930
|
+
* it is merely not a rate. Only the consumer's own deploy log can turn
|
|
1931
|
+
* "one event" into "an event we already fixed", and this library cannot
|
|
1932
|
+
* see that. Claiming otherwise would be the same over-reach the rule
|
|
1933
|
+
* exists to correct.
|
|
1934
|
+
*/
|
|
1935
|
+
declare const BURST_SPAN_MS: number;
|
|
1936
|
+
declare function classifyEvidenceWindow(row: {
|
|
1937
|
+
evidence_first_at?: string | null;
|
|
1938
|
+
evidence_last_at?: string | null;
|
|
1939
|
+
evidence_n?: number | null;
|
|
1940
|
+
}): AdvisoryEvidenceWindow | null;
|
|
1941
|
+
/** Human-readable span for advisory text. Terse by design — it sits inline. */
|
|
1942
|
+
declare function formatEvidenceSpan(spanMs: number): string;
|
|
1943
|
+
/**
|
|
1944
|
+
* The sentence that travels with a burst-shaped finding. Written to be
|
|
1945
|
+
* usable verbatim in advisory text, and to say what the library CAN claim
|
|
1946
|
+
* (one event) rather than what it cannot (that the event is stale).
|
|
1947
|
+
*/
|
|
1948
|
+
declare function burstCaveat(w: AdvisoryEvidenceWindow): string;
|
|
1798
1949
|
interface ActionableAdvisory {
|
|
1799
1950
|
id: string;
|
|
1800
1951
|
rule: string;
|
|
@@ -1802,6 +1953,18 @@ interface ActionableAdvisory {
|
|
|
1802
1953
|
openedAt: string;
|
|
1803
1954
|
lastObservedAt: string;
|
|
1804
1955
|
observationCount: number;
|
|
1956
|
+
/**
|
|
1957
|
+
* Migration 054. `null` when the generator did not state a window — an
|
|
1958
|
+
* honest unknown, NOT an assertion that the evidence is well-spread.
|
|
1959
|
+
*/
|
|
1960
|
+
evidenceWindow: AdvisoryEvidenceWindow | null;
|
|
1961
|
+
/**
|
|
1962
|
+
* The severity the rule ASKED for, present only when this advisory's
|
|
1963
|
+
* effective `severity` was downgraded because its evidence is burst-shaped.
|
|
1964
|
+
* Kept so a consumer can see the downgrade happened rather than silently
|
|
1965
|
+
* receiving a quieter advisory than the generator wrote.
|
|
1966
|
+
*/
|
|
1967
|
+
severityBeforeBurstDowngrade?: AdvisorySeverity;
|
|
1805
1968
|
appliesTo: {
|
|
1806
1969
|
archetype?: IntentArchetypeName;
|
|
1807
1970
|
model?: string;
|
|
@@ -1853,6 +2016,12 @@ interface MarkAdvisoryResolvedOptions {
|
|
|
1853
2016
|
brainAnonKey?: string;
|
|
1854
2017
|
fetch?: typeof fetch;
|
|
1855
2018
|
}
|
|
2019
|
+
/**
|
|
2020
|
+
* Map a single `actionable_advisories_v` row (snake_case, Postgres
|
|
2021
|
+
* native) to the public `ActionableAdvisory` shape (camelCase). Single
|
|
2022
|
+
* canonical mapping site for this boundary (L-118).
|
|
2023
|
+
*/
|
|
2024
|
+
declare function rowToAdvisory(row: Record<string, unknown>): ActionableAdvisory;
|
|
1856
2025
|
/**
|
|
1857
2026
|
* Query the open advisory set for an app. Pulls from
|
|
1858
2027
|
* `actionable_advisories_v` (per-(app_id, code) rollup with stable ids
|
|
@@ -3760,4 +3929,4 @@ declare function planDecomposition(args: PlanDecompositionArgs): DecompositionPl
|
|
|
3760
3929
|
*/
|
|
3761
3930
|
declare function compile(ir: PromptIR, opts?: CompileOptions): CompileResult;
|
|
3762
3931
|
|
|
3763
|
-
export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, call, chainProviderSpread, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltDisciplineContract, withDisciplineContract };
|
|
3932
|
+
export { ABSOLUTE_FLOOR, type AISDKConvertedMessage, ALT_BLIND_TOKEN_BUDGET_BREACH, ALT_STRATEGY_IDS, ARCHETYPE_FAMILY_FITS, ARCHETYPE_FLOOR_DEFAULT, type ActionableAdvisory, Adapter, type AdvisoryEvidenceWindow, type AdvisoryResolutionSource, type AdvisorySeverity, type AdvisoryStatus, type AdvisorySuggestedFix, ApiKeys, type AppOracle, type ApplySectionRewritesArgs, type ApplySectionRewritesResult, ArchetypeConvention, type ArchetypeFamilyFit, type ArchetypePerfMap, type ArchetypePerfNMap, type ArchetypePerfScoreResult, type AttachCacheControlResult, BRAIN_READ_ENV_NAMES, BURST_SPAN_MS, BestPracticeAdvisory, type BrainConfig, type BrainDeadLetterEntry, type BrainHealthSnapshot, type BrainQueryConfig, type BrainReadEnv, COACH_CFG, COST_RANKING_REFERENCE_SHAPE, CallOptions, CallResult, ChainEntry, type CompatibilityIntent, type CompileForAISDKv6Result, type CompileOptions, CompilePolicy, CompileResult, CompiledRequest, type CreateDelegateOpts, DECOMPOSITION_TEMPLATES, DECOMPOSITION_TEMPLATES_VERSION, DEFAULT_FINDINGS_ENDPOINT, DEFAULT_MEASURED_FAILURE_ENDPOINT, DEFAULT_PROMOTIONS_ENDPOINT, DELEGATE_TOOL_DEFINITION, DISCIPLINE_GATES_V1_ALT_BLIND_HEADER, DISCIPLINE_GATES_V1_ALT_HEADER, type DecompositionPlan, type DecompositionStep, type DecompositionTemplate, type DelegateHandle, type DelegateRefusalReason, type DelegateResult, type DelegateToolArgs, type ExclusionFindingRow, type ExclusionResolutionSource, type ExecuteErr, type ExecuteOk, type ExecuteOptions, type ExecuteResult, type ExecutorCandidate, type FallbackPosture, FallbackReason, FamilyResolutionError, type GetActionableAdvisoriesOptions, type GetApplicablePromotionOpts, type GetDefaultFallbackChainOpts, type GetMeasuredFailureOpts, type GetPerAxisMetricsOpts, type GetRecommendedPrimaryOptions, type GoldenEvalAxis, type GoldenEvalCase, type GoldenEvalOptions, type GoldenEvalRunResult, type GoldenEvalStrategyId, type GoldenIrRecordInput, Grounding, IntentArchetypeName, JUDGE_RUBRICS, LIBRARY_VERSION, type LLMJudgeOptions, MEASURED_FAILURE_CFG, MEASURED_GROUNDING_MIN_N, type MarkAdvisoryResolvedOptions, type MarkExclusionFindingHandledOptions, type MarkPromoteReadyHandledOptions, type MeasuredFailureRuntime, type MeasuredFailureVerdict, type ModelBrainRow, type ModelCompatibility, ModelProfile, NormalizedResponse, type OracleContext, OracleScore, type OutcomePayload, OutcomeResult, OutputMode, PRODUCER_OWNED_RULE_CODES, PROVIDER_ENV_KEYS, PerAxisMetrics, type PlannedStep, type PricingRow, type ProbeShadowOptions, type ProbeShadowServed, type ProfileToRowOptions, type PromoteReadyFindingRow, type PromoteReadyResolution, type PromotionRow, type PromotionsRuntime, PromptIR, Provider, ProviderOverrides, type ProviderReachability, ROLLBACK_SUPPRESSION_WINDOW_DAYS, RULE_DISCIPLINE_GATES_V1, RULE_DISCIPLINE_GATES_V1_STRUCTURED, RULE_SEQUENTIAL_TOOL_CLIFF, type ReachabilityOpts, RecordInput, RecordOutcomeInput, type RunAdvisorPhase2Context, STRATEGY_AUTHORSHIP_INDEPENDENT, STRATEGY_AUTHORSHIP_LIMITATION, SectionRewrite, type ShadowProbeRecordInput, type StrategyAttribution, type StrategyAttributionResult, type StrategyOutcome, type SupportedProvider, type SurfaceFailureRow, type SurfaceStats, SystemModelMessage, TRANSLATOR_FLOOR, _testResetMeasuredFailure, _testResetPromotions, _testWaitForMeasuredFailureRefresh, _testWaitForPromotionsRefresh, altBlindGatesBlockFor, altGatesBlockFor, applyArchetypeConvention, applySectionRewrites, attachCacheControlToStreamTextInput, awaitMeasuredFailureReady, brainHealth, buildGoldenIrRow, buildLLMJudge, buildPairwiseJudgePrompt, buildShadowProbeRow, burstCaveat, call, chainProviderSpread, classifyEvidenceWindow, classifyStrategyOutcome, clearBrain, combineOrderSwappedVerdicts, compile, compileForAISDKv6, configureBrain, configureMeasuredFailureBrain, configurePromotionsBrain, countTokens, createDelegate, deriveFamilyFromModelId, deriveOwnership, estimateChainCostUsd, estimateModelCostUsd, execute, findBetterFit, flushBrainDeadLetter, formatEvidenceSpan, getActionableAdvisories, getAllStarterChains, getAllStarterChainsWithGrounding, getApplicablePromotion, getArchetypePerfScore, getDefaultFallbackChain, getDefaultFallbackChainWithGrounding, getMeasuredFailureVerdict, getModelCompatibility, getPerAxisMetrics, getReachabilityDiagnostic, getRecentRollback, getRecommendedPrimary, getSequentialStarterChain, getSequentialStarterChainWithGrounding, getStaleExclusionFindings, getStarterChain, getStarterChainWithGrounding, isAltStrategy, isAutoPromoteEnabledFromEnv, isBrainQueryActiveFor, isBrainSync, isDelegateEnabledFromEnv, isExclusionFindingsBrainActive, isMeasuredFailureBrainActive, isMeasuredFailureGateEnabledFromEnv, isModelReachable, isPromotionsBrainActive, isProviderReachable, judgeMeasuredFailure, loadAliasesFromBrain, loadArchetypePerfFromBrain, loadArchetypePerfNFromBrain, loadChainsFromBrain, loadModelsFromBrain, loadPricingFromBrain, mapMeasuredFailureRows, markAdvisoryResolved, markExclusionFindingHandled, markPromoteReadyHandled, parseJudgeVerdict, peekBrainDeadLetter, planDecomposition, prefetchMeasuredFailure, probeShadow, profileToRow, readBrainReadEnv, record, recordGoldenIr, recordOutcome, recordShadowProbe, renderIrForJudge, resetTokenizer, resolveConventionsForProfile, resolvePricingAt, resolveProviderKey, rowToAdvisory, rubricFor, runAdvisor, runGoldenEval, runStrategyEvalWithAttribution, setTokenizer, wilsonLowerBound, withAltBlindDisciplineContract, withAltDisciplineContract, withDisciplineContract };
|