modelrig 0.4.0 → 0.6.0

package/dist/run/accept.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Accept-path builders, extracted from run.ts (which sits at the 700-LOC cap so
+ * the Q1 quality-gate seam has to pull its shared shapes out). Two pure builders:
+ *
+ *  - `successAttemptRow` — the AttemptTelemetry token/cost fields for a
+ *    SUCCESSFUL adapter result, shared by the accept path and the Q1
+ *    quality-REJECT path (which records the same billed row with a
+ *    `quality_rejected` failure instead of `null`).
+ *  - `buildSuccessMeta` — the validated `RunMeta` returned on the accept path.
+ *
+ * Behavior is byte-identical to the former inline literals; nothing new is
+ * computed here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.successAttemptRow = successAttemptRow;
+exports.buildSuccessMeta = buildSuccessMeta;
+/** The AttemptTelemetry for a successful adapter result. `failure` is null on the
+ * accept path and the `quality_rejected` failure on the Q1 reject path;
+ * `metaInputs` is the WI-1 attempt-meta envelope; `extraTags` carries the Q1
+ * quality tags (`quality` / `quality_score`). */
+function successAttemptRow(candidate, usage, costUsd, latencyMs, pricingMissing, failure, metaInputs, extraTags) {
+    return {
+        candidate,
+        servedTier: usage.servedTier,
+        tokensIn: usage.tokensIn,
+        tokensOut: usage.tokensOut,
+        tokensCached: usage.tokensCached,
+        tokensCacheWrite: usage.tokensCacheWrite ?? 0,
+        tokensCacheWrite1h: usage.tokensCacheWrite1h ?? 0,
+        costUsd,
+        latencyMs,
+        ...(usage.ttfbMs !== undefined ? { ttfbMs: usage.ttfbMs } : {}),
+        failure,
+        pricingMissing,
+        metaInputs,
+        ...(extraTags !== undefined ? { extraTags } : {}),
+    };
+}
+/** The validated `RunMeta` for the accept path — `repairedBy` is null here (the
+ * repair path builds its own meta), `validated` is always true. */
+function buildSuccessMeta(input) {
+    const { route, candidate, usage } = input;
+    return {
+        inferenceId: input.inferenceId,
+        route: route.route,
+        routeVersion: route.version,
+        provider: candidate.provider,
+        model: candidate.model,
+        requestedTier: route.policy.tier,
+        servedTier: usage.servedTier,
+        tokensIn: usage.tokensIn,
+        tokensOut: usage.tokensOut,
+        tokensCached: usage.tokensCached,
+        costEstimateUsd: input.costUsd,
+        latencyMs: input.latencyMs,
+        validated: true,
+        attemptsByClass: input.attemptsByClass,
+        servedVariant: input.servedVariant,
+        repairedBy: null,
+        callId: input.callId,
+        ...(input.citations !== undefined ? { citations: input.citations } : {}),
+        ...(input.quality !== undefined ? { quality: input.quality } : {}),
+    };
+}

package/dist/run/cost.d.ts

@@ -20,6 +20,19 @@ export interface AttemptCost {
     readonly pricingMissing: boolean;
 }
 export declare function attemptCost(provider: ProviderId, model: string, usage: AdapterUsage, unpricedRatePerTok: number): AttemptCost;
+/** USD cost broken into its components for the attempt envelope
+ * (`AttemptMeta.cost`, WI-1 spec §2). Returns null when the model has no
+ * pricing entry (absent = unknown, never an invented $0 — mirrors
+ * `attemptCost`'s `pricingMissing`). Every component uses the SAME per-token
+ * rates as {@link estimateCostUsd}, so the sum equals the recorded
+ * `cost_estimate_usd` for a priced model. `other` is reserved (0 today). */
+export declare function costComponents(provider: ProviderId, model: string, usage: Pick<AdapterUsage, "tokensIn" | "tokensOut" | "tokensCached" | "tokensCacheWrite" | "tokensCacheWrite1h">): {
+    in: number;
+    out: number;
+    cache_read: number;
+    cache_write: number;
+    other: number;
+} | null;
 /** Pre-dispatch upper-bound estimate for the envelope precheck: prompt
  * length + the full output bound, at real pricing or the conservative rate. */
 export declare function dispatchEstimateUsd(provider: ProviderId, model: string, promptChars: number, unpricedRatePerTok: number): number;

package/dist/run/cost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/run/cost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAElE,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;yEAEyE;AACzE,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EACnB,kBAAkB,EAAE,MAAM,GACzB,WAAW,CAkBb;AAED;+EAC+E;AAC/E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAOR"}
+{"version":3,"file":"cost.d.ts","sourceRoot":"","sources":["../../src/run/cost.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAElE,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;yEAEyE;AACzE,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,YAAY,EACnB,kBAAkB,EAAE,MAAM,GACzB,WAAW,CAkBb;AAED;;;;;4EAK4E;AAC5E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,IAAI,CACT,YAAY,EACZ,UAAU,GAAG,WAAW,GAAG,cAAc,GAAG,kBAAkB,GAAG,oBAAoB,CACtF,GACA;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB5F;AAED;+EAC+E;AAC/E,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,GACzB,MAAM,CAOR"}

package/dist/run/cost.js

@@ -9,6 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DEFAULT_UNPRICED_RATE_USD_PER_MTOK = exports.ESTIMATE_MAX_OUTPUT_TOKENS = exports.ESTIMATE_CHARS_PER_TOKEN = void 0;
 exports.attemptCost = attemptCost;
+exports.costComponents = costComponents;
 exports.dispatchEstimateUsd = dispatchEstimateUsd;
 const pricing_1 = require("../registry/pricing");
 exports.ESTIMATE_CHARS_PER_TOKEN = 4;
@@ -29,6 +30,32 @@ function attemptCost(provider, model, usage, unpricedRatePerTok) {
     const costUsd = (0, pricing_1.estimateCostUsd)(pricing, usage.tokensIn, usage.tokensOut, usage.tokensCached, usage.tokensCacheWrite ?? 0, usage.tokensCacheWrite1h ?? 0);
     return { costUsd, envelopeChargeUsd: costUsd, pricingMissing: false };
 }
+/** USD cost broken into its components for the attempt envelope
+ * (`AttemptMeta.cost`, WI-1 spec §2). Returns null when the model has no
+ * pricing entry (absent = unknown, never an invented $0 — mirrors
+ * `attemptCost`'s `pricingMissing`). Every component uses the SAME per-token
+ * rates as {@link estimateCostUsd}, so the sum equals the recorded
+ * `cost_estimate_usd` for a priced model. `other` is reserved (0 today). */
+function costComponents(provider, model, usage) {
+    const pricing = (0, pricing_1.getPricing)(provider, model);
+    if (pricing === null)
+        return null;
+    const tokensIn = Math.max(usage.tokensIn, 0);
+    const cached = Math.min(Math.max(usage.tokensCached, 0), tokensIn);
+    const write = Math.max(usage.tokensCacheWrite ?? 0, 0);
+    const write1h = Math.min(Math.max(usage.tokensCacheWrite1h ?? 0, 0), write);
+    const uncachedIn = Math.max(tokensIn - cached - write, 0);
+    const cachedRate = pricing.cachedInputUsdPerTok ?? pricing.inputUsdPerTok;
+    const writeRate = pricing.cacheWriteUsdPerTok ?? pricing.inputUsdPerTok;
+    const write1hRate = pricing.cacheWrite1hUsdPerTok ?? writeRate;
+    return {
+        in: uncachedIn * pricing.inputUsdPerTok,
+        out: Math.max(usage.tokensOut, 0) * pricing.outputUsdPerTok,
+        cache_read: cached * cachedRate,
+        cache_write: (write - write1h) * writeRate + write1h * write1hRate,
+        other: 0,
+    };
+}
 /** Pre-dispatch upper-bound estimate for the envelope precheck: prompt
  * length + the full output bound, at real pricing or the conservative rate. */
 function dispatchEstimateUsd(provider, model, promptChars, unpricedRatePerTok) {

package/dist/run/dispatch.d.ts

@@ -8,10 +8,11 @@
  * Tool *execution* is never ours (spec §4.4); these helpers normalize the
  * protocol and surface it — nothing here runs a tool.
  */
-import type { AdapterRequest, AdapterResult, CandidateRef, ProviderAdapter } from "../types/provider";
+import type { AdapterRequest, AdapterResult, CandidateRef, ProviderAdapter, ToolDefinition } from "../types/provider";
 import type { RigFailure } from "../types/failures";
 import type { RouteBundle, RunMeta, RunOptions, RunResult, RunTags } from "../types/route";
 import type { TelemetryRung, TelemetryStore } from "../types/telemetry";
+import type { AttemptMetaSource } from "../telemetry/attempt-meta";
 import type { LadderKeyMinter } from "./ladder-key";
 /** One telemetry attempt row's inputs — shared with run.ts's recordAttempt so
  * the tool-call helper here can record through the same closure. */
@@ -39,7 +40,27 @@ export interface AttemptTelemetry {
      * (`tool_call`); every other rung is derived in the recorder from the
      * repaired_by / pre-dispatch / primary-vs-retry signals. */
     readonly rung?: TelemetryRung;
+    /** WI-1 (spec §2): the adapter's native meta + rendered request / output /
+     * declared tool names. The recorder (record-attempt.ts) hands it to
+     * `summarizeAttemptMeta` with this row's provider/model/usage. Absent ⇒ the
+     * recorder builds a minimal envelope from usage + cost alone (never null-only). */
+    readonly metaInputs?: AttemptMetaSource;
+    /** SDK-owned extra telemetry tags merged onto the row (Q1 quality gate stamps
+     * `quality` / `quality_score` here). Never carries `rung` — the recorder
+     * stamps that last so a caller cannot override it. */
+    readonly extraTags?: Record<string, string>;
 }
+/** Assemble the recorder's `metaInputs` from a completed dispatch (WI-1) — the
+ * adapter's native meta plus the rendered request (system+user+schema, hashed)
+ * and the output text (hashed). One helper so the routed lane's several record
+ * sites stay one-liners and run.ts holds under the LOC cap. */
+export declare function attemptMetaInputs(args: {
+    readonly systemPrompt: string;
+    readonly userDirective: string;
+    readonly outputSchema: object | null;
+    readonly result: AdapterResult;
+    readonly tools?: readonly ToolDefinition[];
+}): AttemptMetaSource;
 /** run.ts's recordAttempt, threaded in so the tool-call path records through
  * the same ledger/tenancy closure the rest of the loop uses. */
 export type RecordAttempt = (attempt: AttemptTelemetry) => string;
@@ -98,6 +119,8 @@ export interface ToolCallResultParts {
     /** The call's ladder-key id (spec §2.1 R0) — surfaced on the tool-call meta so
      * it matches the recorded row's `call_id`. */
     readonly callId: string;
+    /** WI-1: the attempt-envelope inputs for the recorded row (spec §2). */
+    readonly metaInputs?: AttemptMetaSource;
 }
 /**
  * Record a tool-call turn and build its RunResult (spec §4.4). A tool call is

package/dist/run/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/run/dispatch.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/run/dispatch.ts"],"names":[],"mappings":"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"}

package/dist/run/dispatch.js

@@ -10,6 +10,7 @@
  * protocol and surface it — nothing here runs a tool.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.attemptMetaInputs = attemptMetaInputs;
 exports.recordSearchCostRow = recordSearchCostRow;
 exports.jsonModeCoaching = jsonModeCoaching;
 exports.buildAdapterRequest = buildAdapterRequest;
@@ -17,8 +18,25 @@ exports.buildRepairAdapterRequest = buildRepairAdapterRequest;
 exports.dispatchCandidate = dispatchCandidate;
 exports.emitToolCallResult = emitToolCallResult;
 const node_crypto_1 = require("node:crypto");
+const attempt_meta_1 = require("../telemetry/attempt-meta");
 const cache_stamp_1 = require("./cache-stamp");
 const cache_handle_1 = require("./cache-handle");
+/** Assemble the recorder's `metaInputs` from a completed dispatch (WI-1) — the
+ * adapter's native meta plus the rendered request (system+user+schema, hashed)
+ * and the output text (hashed). One helper so the routed lane's several record
+ * sites stay one-liners and run.ts holds under the LOC cap. */
+function attemptMetaInputs(args) {
+    return {
+        ...(args.result.meta !== undefined ? { adapterMeta: args.result.meta } : {}),
+        renderedRequest: (0, attempt_meta_1.renderRequestForHash)({
+            system: args.systemPrompt,
+            user: args.userDirective,
+            schema: args.outputSchema,
+        }),
+        outputText: args.result.ok ? args.result.text : null,
+        ...(args.tools !== undefined ? { declaredToolNames: args.tools.map((t) => t.function.name) } : {}),
+    };
+}
 /** Record the grounding-inject search's own telemetry row (WS3): a $-only line
  * under the synthetic "search" provider. Extracted from run.ts to keep it under
  * the LOC cap; behaviour is byte-identical to the prior inline recorder. */
@@ -193,6 +211,7 @@ function emitToolCallResult(record, parts) {
         // is stamped explicitly. The rollup counts it as a tool-call turn, never a
         // dispatch or a serve (its cost still counts).
         rung: "tool_call",
+        ...(parts.metaInputs !== undefined ? { metaInputs: parts.metaInputs } : {}),
     });
     return {
         output: null,

package/dist/run/ladder-key.d.ts

@@ -31,6 +31,10 @@ export interface LadderKeyMinter {
     /** Stamp the next row: bump `attempt_seq` (1-based, monotonic) and read the
      * current `candidate_index`. */
     stamp(): LadderKey;
+    /** The `attempt_seq` the NEXT `stamp()` will assign — read WITHOUT consuming
+     * it, so the quality gate (Q1) can name the seq its judged candidate's row
+     * will carry before that row is recorded. */
+    peekNextSeq(): number;
 }
 /**
  * Build a ladder-key minter. `callId` defaults to a fresh uuid; the raw lane and

package/dist/run/ladder-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ladder-key.d.ts","sourceRoot":"","sources":["../../src/run/ladder-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;6EACyE;IACzE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9C;oCACgC;IAChC,KAAK,IAAI,SAAS,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,MAAqB,GAAG,eAAe,CAapF"}
+{"version":3,"file":"ladder-key.d.ts","sourceRoot":"","sources":["../../src/run/ladder-key.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;6EACyE;IACzE,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9C;oCACgC;IAChC,KAAK,IAAI,SAAS,CAAC;IACnB;;iDAE6C;IAC7C,WAAW,IAAI,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,GAAE,MAAqB,GAAG,eAAe,CAgBpF"}

package/dist/run/ladder-key.js

@@ -35,5 +35,8 @@ function createLadderKeyMinter(callId = (0, node_crypto_1.randomUUID)()) {
             attemptSeq += 1;
             return { callId, attemptSeq, candidateIndex };
         },
+        peekNextSeq() {
+            return attemptSeq + 1;
+        },
     };
 }

package/dist/run/quality-gate.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The quality-gate seam (Q1, quality-gate spec §4.1). Extracted from run.ts —
+ * which sits at the 700-LOC cap — so the run loop gets ONE compact call site
+ * between `outcome.valid` and the accept branch.
+ *
+ * The gate evaluates a builder predicate on a schema-VALID output. It handles the
+ * awkward bits so the loop does not: awaiting an async verdict, normalizing an
+ * optional score/reason, and rejecting fail-closed when the predicate THROWS
+ * (spec §4.1 step 4, flag F2 — reject + warn ONCE per process). The loop keeps
+ * the control flow: a passing verdict takes the existing accept path (tagged),
+ * a failing one records `quality_rejected` and falls through on its own budget,
+ * never touching the repair rung.
+ */
+import type { QualityGate, QualityGateMeta } from "../types/quality";
+/** The gate's answer, normalized for the run loop. `score`/`reason` are null
+ * rather than undefined so the row/meta stamping is total. */
+export interface QualityGateOutcome {
+    /** True = accept (verdict.ok, or the predicate threw? no — a throw is a reject). */
+    readonly pass: boolean;
+    readonly score: number | null;
+    readonly reason: string | null;
+}
+/** Test-only: reset the once-per-process throw-warning latch so a test can
+ * assert the single-warning behavior deterministically. */
+export declare function resetQualityGateWarningForTest(): void;
+/**
+ * Evaluate a quality gate on a schema-valid output. Awaits an async verdict; a
+ * throwing predicate rejects fail-closed with a `qualityGate threw: …` reason
+ * and warns exactly once per process.
+ */
+export declare function evaluateQualityGate(gate: QualityGate, output: unknown, meta: QualityGateMeta): Promise<QualityGateOutcome>;
+/** SDK-owned telemetry tags for the attempt row (spec §2): `quality` = pass|fail
+ * and, when a score exists, `quality_score` as a decimal string. Never carries
+ * `rung` — the recorder owns that and stamps it last. */
+export declare function qualityTags(outcome: QualityGateOutcome): Record<string, string>;
+/** The `quality_rejected` failure message — carries the reason and score so a
+ * stuck engineer (and the exhausted-ladder error) sees WHY it was rejected. */
+export declare function qualityRejectedMessage(outcome: QualityGateOutcome): string;
+//# sourceMappingURL=quality-gate.d.ts.map

package/dist/run/quality-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../src/run/quality-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErE;8DAC8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,oFAAoF;IACpF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAMD;2DAC2D;AAC3D,wBAAgB,8BAA8B,IAAI,IAAI,CAErD;AAMD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAe7B;AAOD;;yDAEyD;AACzD,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI/E;AAED;+EAC+E;AAC/E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAI1E"}

package/dist/run/quality-gate.js

@@ -0,0 +1,70 @@
+"use strict";
+/**
+ * The quality-gate seam (Q1, quality-gate spec §4.1). Extracted from run.ts —
+ * which sits at the 700-LOC cap — so the run loop gets ONE compact call site
+ * between `outcome.valid` and the accept branch.
+ *
+ * The gate evaluates a builder predicate on a schema-VALID output. It handles the
+ * awkward bits so the loop does not: awaiting an async verdict, normalizing an
+ * optional score/reason, and rejecting fail-closed when the predicate THROWS
+ * (spec §4.1 step 4, flag F2 — reject + warn ONCE per process). The loop keeps
+ * the control flow: a passing verdict takes the existing accept path (tagged),
+ * a failing one records `quality_rejected` and falls through on its own budget,
+ * never touching the repair rung.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetQualityGateWarningForTest = resetQualityGateWarningForTest;
+exports.evaluateQualityGate = evaluateQualityGate;
+exports.qualityTags = qualityTags;
+exports.qualityRejectedMessage = qualityRejectedMessage;
+/** One warning per process when a predicate throws (F2). Module-level so it
+ * latches across runs; `resetQualityGateWarningForTest` clears it under test. */
+let warnedOnThrow = false;
+/** Test-only: reset the once-per-process throw-warning latch so a test can
+ * assert the single-warning behavior deterministically. */
+function resetQualityGateWarningForTest() {
+    warnedOnThrow = false;
+}
+function finiteOrNull(n) {
+    return typeof n === "number" && Number.isFinite(n) ? n : null;
+}
+/**
+ * Evaluate a quality gate on a schema-valid output. Awaits an async verdict; a
+ * throwing predicate rejects fail-closed with a `qualityGate threw: …` reason
+ * and warns exactly once per process.
+ */
+async function evaluateQualityGate(gate, output, meta) {
+    try {
+        const verdict = await gate(output, meta);
+        return { pass: verdict.ok === true, score: finiteOrNull(verdict.score), reason: verdict.reason ?? null };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (!warnedOnThrow) {
+            warnedOnThrow = true;
+            console.warn(`[modelrig] qualityGate threw — treating the output as REJECTED (fail-closed): ${message}. ` +
+                "A predicate must return { ok } rather than throw; this warning fires once per process.");
+        }
+        return { pass: false, score: null, reason: `qualityGate threw: ${message}` };
+    }
+}
+/** Render a score for a tag / message — a plain decimal string, or "" when null. */
+function scoreText(score) {
+    return score === null ? "" : String(score);
+}
+/** SDK-owned telemetry tags for the attempt row (spec §2): `quality` = pass|fail
+ * and, when a score exists, `quality_score` as a decimal string. Never carries
+ * `rung` — the recorder owns that and stamps it last. */
+function qualityTags(outcome) {
+    const tags = { quality: outcome.pass ? "pass" : "fail" };
+    if (outcome.score !== null)
+        tags.quality_score = scoreText(outcome.score);
+    return tags;
+}
+/** The `quality_rejected` failure message — carries the reason and score so a
+ * stuck engineer (and the exhausted-ladder error) sees WHY it was rejected. */
+function qualityRejectedMessage(outcome) {
+    const scorePart = outcome.score === null ? "" : ` (score ${scoreText(outcome.score)})`;
+    const reasonPart = outcome.reason === null ? "" : `: ${outcome.reason}`;
+    return `output met the schema but not the quality bar${scorePart}${reasonPart}`;
+}

package/dist/run/raw-defaults.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Raw-lane defaults (#245, spec R1–R3) — the SINGLE source of truth for what
+ * `rig.runRaw` sends when the caller omits a knob, and the generator behind the
+ * published defaults table.
+ *
+ * WHY ITS OWN FILE: `raw.ts` sits near the 700-LOC invariant cap, and this table
+ * is the CE-9/`raw-support.ts` pattern — a code constant the runtime reads AND
+ * the docs generator renders, so the published table can never drift from the
+ * behaviour. `raw.ts` imports `RAW_TIMEOUT_DEFAULT_MS` and resolves the effective
+ * timeout from it; the docs builder injects `renderRawDefaults()` at the
+ * `<!-- RAW_DEFAULTS -->` marker in `route-bundles.md` and into llms.txt. The
+ * drift test asserts the rendered `timeoutMs` default is read from THIS constant
+ * (never retyped), so the table and the dispatch agree by construction.
+ */
+import type { ServiceTier } from "../types/provider";
+/**
+ * R1 — the tier-aware raw-lane timeout default (ms). A raw passthrough should not
+ * be shorter-fused than the tier it advertises: `standard`/`priority` target up
+ * to 5 min (grounded + large prompts routinely exceed the old 120 s even at
+ * standard), `flex` targets the 15-minute budget ModelRig advertises. An explicit
+ * `RawRunInput.timeoutMs` always wins; this is only the fallback, and a `timeout`
+ * failure on the raw lane teaches the tier + budget in its `fixHint`.
+ */
+export declare const RAW_TIMEOUT_DEFAULT_MS: Record<ServiceTier, number>;
+/** One row of the generated defaults table (R2/R3). */
+export interface RawDefaultRow {
+    /** The `RawRunInput` field this row documents. */
+    readonly knob: string;
+    /** The value sent when the caller omits the knob — DERIVED from the constant
+     * the runtime uses where one exists (timeoutMs), so it cannot drift. */
+    readonly default: string;
+    /** The teaching note rendered in the table cell. */
+    readonly note: string;
+}
+/**
+ * The defaults table (R2/R3) — every behavioural `RawRunInput` knob and what the
+ * raw lane does when the caller omits it. `provider`/`model`/`apiKey`/
+ * `systemPrompt`/`userPrompt` are the call itself, not defaultable knobs, so they
+ * are not listed. Exhaustive over the optional knobs the raw lane exposes; a new
+ * knob added to `RawRunInput` should gain a row here (and the `route-bundles`
+ * coverage test guards the important ones).
+ */
+export declare const RAW_DEFAULTS: readonly RawDefaultRow[];
+/**
+ * Render the defaults table as a Markdown table, FROM `RAW_DEFAULTS` (never a
+ * hand-written twin — R2/R3). Consumed by the docs generator
+ * (scripts/build-docs-site.ts) at the `<!-- RAW_DEFAULTS -->` marker and in
+ * llms.txt, so the published table and the runtime defaults derive from one
+ * source.
+ */
+export declare function renderRawDefaults(): string;
+//# sourceMappingURL=raw-defaults.d.ts.map

package/dist/run/raw-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw-defaults.d.ts","sourceRoot":"","sources":["../../src/run/raw-defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAI9D,CAAC;AAEF,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;4EACwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAeD;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,aAAa,EA6DhD,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C"}

package/dist/run/raw-defaults.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Raw-lane defaults (#245, spec R1–R3) — the SINGLE source of truth for what
+ * `rig.runRaw` sends when the caller omits a knob, and the generator behind the
+ * published defaults table.
+ *
+ * WHY ITS OWN FILE: `raw.ts` sits near the 700-LOC invariant cap, and this table
+ * is the CE-9/`raw-support.ts` pattern — a code constant the runtime reads AND
+ * the docs generator renders, so the published table can never drift from the
+ * behaviour. `raw.ts` imports `RAW_TIMEOUT_DEFAULT_MS` and resolves the effective
+ * timeout from it; the docs builder injects `renderRawDefaults()` at the
+ * `<!-- RAW_DEFAULTS -->` marker in `route-bundles.md` and into llms.txt. The
+ * drift test asserts the rendered `timeoutMs` default is read from THIS constant
+ * (never retyped), so the table and the dispatch agree by construction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAW_DEFAULTS = exports.RAW_TIMEOUT_DEFAULT_MS = void 0;
+exports.renderRawDefaults = renderRawDefaults;
+/**
+ * R1 — the tier-aware raw-lane timeout default (ms). A raw passthrough should not
+ * be shorter-fused than the tier it advertises: `standard`/`priority` target up
+ * to 5 min (grounded + large prompts routinely exceed the old 120 s even at
+ * standard), `flex` targets the 15-minute budget ModelRig advertises. An explicit
+ * `RawRunInput.timeoutMs` always wins; this is only the fallback, and a `timeout`
+ * failure on the raw lane teaches the tier + budget in its `fixHint`.
+ */
+exports.RAW_TIMEOUT_DEFAULT_MS = {
+    standard: 300000,
+    priority: 300000,
+    flex: 900000,
+};
+/** Render `${ms} ms` as whole seconds (both defaults are whole-second values). */
+function secs(ms) {
+    return `${ms / 1000} s`;
+}
+/** The tier-aware `timeoutMs` default, rendered FROM `RAW_TIMEOUT_DEFAULT_MS`
+ * (never a retyped literal — the drift test locks this to the constant). */
+function timeoutDefaultCell() {
+    return `${secs(exports.RAW_TIMEOUT_DEFAULT_MS.standard)} (standard, priority) · ${secs(exports.RAW_TIMEOUT_DEFAULT_MS.flex)} (flex)`;
+}
+/**
+ * The defaults table (R2/R3) — every behavioural `RawRunInput` knob and what the
+ * raw lane does when the caller omits it. `provider`/`model`/`apiKey`/
+ * `systemPrompt`/`userPrompt` are the call itself, not defaultable knobs, so they
+ * are not listed. Exhaustive over the optional knobs the raw lane exposes; a new
+ * knob added to `RawRunInput` should gain a row here (and the `route-bundles`
+ * coverage test guards the important ones).
+ */
+exports.RAW_DEFAULTS = [
+    {
+        knob: "timeoutMs",
+        default: timeoutDefaultCell(),
+        note: "tier-aware wall-clock deadline; an explicit `timeoutMs` always wins, and a `timeout` failure carries a `fixHint` naming the tier + budget",
+    },
+    {
+        knob: "serviceTier",
+        default: "standard",
+        note: "forwarded to the adapter; `meta.servedTier` reports what actually served. On `flex`, set `timeoutMs` in minutes (default 900 s)",
+    },
+    {
+        knob: "temperature",
+        default: "adapter default — not sent",
+        note: "absent ⇒ no `temperature` on the request (byte-identical dispatch)",
+    },
+    {
+        knob: "topP",
+        default: "adapter default — not sent",
+        note: "absent ⇒ no `topP` on the request (byte-identical dispatch)",
+    },
+    {
+        knob: "maxOutputTokens",
+        default: "adapter default — not sent",
+        note: "absent ⇒ no output-token cap on the request (byte-identical dispatch)",
+    },
+    {
+        knob: "grounding",
+        default: "absent ⇒ byte-identical",
+        note: "native provider grounding; provider support per the raw-lane knob matrix",
+    },
+    {
+        knob: "reasoning",
+        default: "absent ⇒ byte-identical",
+        note: "reasoning/thinking effort; provider support per the raw-lane knob matrix",
+    },
+    {
+        knob: "responseFormat",
+        default: "absent ⇒ byte-identical",
+        note: "syntactic-JSON forcing (mime-shaping only); provider support per the raw-lane knob matrix",
+    },
+    {
+        knob: "cache",
+        default: "none",
+        note: "customer cache handle passed through verbatim when supplied; ModelRig never creates, refreshes, or deletes the resource",
+    },
+    {
+        knob: "tags",
+        default: "none",
+        note: "`lane=raw` and `rung=primary` are stamped by the SDK and cannot be overridden by a caller tag",
+    },
+    {
+        knob: "tools / toolChoice",
+        default: "none",
+        note: "absent ⇒ no tools declared; on the raw lane a grounding-originated `functionCall` part is NOT a tool-call turn",
+    },
+    {
+        knob: "stepKey",
+        default: "auto — `tags.step`, else `<provider>/<model>#<n>` inside a run context",
+        note: "names the ground-truth step a run context records for this call (G1); explicit key wins; no run context ⇒ no step",
+    },
+];
+/**
+ * Render the defaults table as a Markdown table, FROM `RAW_DEFAULTS` (never a
+ * hand-written twin — R2/R3). Consumed by the docs generator
+ * (scripts/build-docs-site.ts) at the `<!-- RAW_DEFAULTS -->` marker and in
+ * llms.txt, so the published table and the runtime defaults derive from one
+ * source.
+ */
+function renderRawDefaults() {
+    const header = "| Knob | Default | Note |";
+    const sep = "|---|---|---|";
+    const rows = exports.RAW_DEFAULTS.map((r) => `| \`${r.knob}\` | ${r.default} | ${r.note} |`);
+    return [header, sep, ...rows].join("\n");
+}

package/dist/run/raw.d.ts

@@ -41,6 +41,7 @@
  *    is ONE table (`run/raw-support.ts`) the guard AND the published docs matrix
  *    both read — they can never disagree (R5).
  */
+import { type RigManifest } from "../routes/manifest";
 import type { AdapterRequest, CandidateRef, ProviderId, ReasoningParams, ServiceTier, ToolChoice, ToolDefinition } from "../types/provider";
 import type { RunResult, RunTags } from "../types/route";
 import type { RunStreamHandle } from "./stream";
@@ -58,6 +59,13 @@ export interface RawRunInput {
     readonly systemPrompt: string;
     readonly userPrompt: string;
     readonly tags?: RunTags;
+    /** G1 (spec §3): names the ground-truth step this raw call records inside an
+     * active `run.start` context — the SAME field the routed lane exposes, so a
+     * raw call, a routed call, and an `artifact.save` can be composed into ONE
+     * step group. Resolution: `stepKey ?? tags.step ?? provider/model#n` (auto).
+     * Validated `[A-Za-z0-9_.:#-]{1,128}`; an invalid value is warned and dropped
+     * to the auto key. Outside a run context ⇒ ignored (no step is recorded). */
+    readonly stepKey?: string;
     readonly maxOutputTokens?: number;
     /** CE-6 sampling on the raw lane (spec §2). `temperature`/`topP` are the raw
      * lane's exposure of the same knobs `RoutePolicy.sampling` gives the routed
@@ -120,6 +128,10 @@ export interface RawRunDeps {
      * Used only to keep `attemptCost` honest — the raw lane has no envelope, so
      * it never charges the unpriced fallback; a missing price records `$0`. */
     readonly unpricedRateUsdPerMTok?: number;
+    /** G1 (spec §4): the rig manifest, so the raw lane runs the SAME
+     * required-dimension hygiene warning the routed lane does. Null/absent (e.g. a
+     * `routesDir: null` runRaw-only rig) ⇒ the warning is a no-op. */
+    readonly manifest?: RigManifest | null;
 }
 /**
  * CE-2/CE-9 fail-closed guard (spec §3 F1/F3, CE-9 R1/R2/R4). A DECLARED

package/dist/run/raw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/run/raw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAiBH,OAAO,KAAK,EACV,cAAc,EAGd,YAAY,EAGZ,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAW,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtF;;;sCAGsC;AACtC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;iFAC6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;6EAGyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC;;;;;;;0BAOsB;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE;;;;;;;iDAO6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IACjD;;;;mFAI+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;qFAIiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC;;;;;;;;sEAQkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC;;+EAE2E;IAC3E,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;CAC1C;AA0CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAiDhE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc,CAqC3F;AAsKD;wDACwD;AACxD,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CASrF;AAcD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,eAAe,CA6ClF"}
+{"version":3,"file":"raw.d.ts","sourceRoot":"","sources":["../../src/run/raw.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAuBH,OAAO,EAAiC,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACrF,OAAO,KAAK,EACV,cAAc,EAGd,YAAY,EAGZ,UAAU,EACV,eAAe,EACf,WAAW,EACX,UAAU,EACV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAW,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,KAAK,EAA+B,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEtF;;;sCAGsC;AACtC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;iFAC6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB;;;;;iFAK6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;6EAGyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC;;;;;;;0BAOsB;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE;;;;;;;iDAO6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IACjD;;;;mFAI+E;IAC/E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;;qFAIiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC;;;;;;;;sEAQkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC;CACzC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC;;+EAE2E;IAC3E,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IACzC;;sEAEkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;CACxC;AAiED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAiDhE;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc,CAsC3F;AAyPD;wDACwD;AACxD,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAYrF;AAcD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,GAAG,eAAe,CAiDlF"}