@postalsys/email-content 0.1.8 → 0.1.10

package/dist/annotate/llm.d.ts

@@ -13,6 +13,8 @@
 import { type Block } from '../segment/types';
 import { type Label } from '../types';
 import { type CompletionClient } from './client';
+import { type LabelProbabilities } from './probabilities';
+import { type SystemOneClient } from './typesafe-client';
 /** Characters of each block sent to the model. Enough for a decision, bounded for cost. */
 export declare const MAX_BLOCK_CHARS = 700;
 /** Blocks per message. Longer messages are truncated with a recorded flag. */
@@ -21,6 +23,8 @@ export interface LlmLabel {
     index: number;
     label: Label;
     confidence: number;
+    /** Full distribution, from annotators that return one. The label is derived from it. */
+    probabilities?: LabelProbabilities;
 }
 export interface AnnotationResult {
     labels: LlmLabel[];
@@ -43,4 +47,17 @@ export declare function annotatableBlocks(blocks: readonly Block[]): Block[];
  * @param isReply whether the message carries threading headers
  */
 export declare function annotateBlocks(client: CompletionClient, blocks: readonly Block[], isReply: boolean): Promise<AnnotationResult>;
+/**
+ * Annotate one message's blocks with TypeSafe: one Choice question per block.
+ *
+ * The stored label is the cost rule applied to the returned distribution at DEFAULT_COST_RATIO, not
+ * the model's top choice, and the raw distribution is kept alongside so other ratios can be applied
+ * later without re-running inference. An answer without a usable distribution is treated as
+ * missing: the cost rule cannot be checked against it, so it must not be allowed to hide anything.
+ *
+ * @param client configured TypeSafe client
+ * @param blocks blocks from the primary representation
+ * @param isReply whether the message carries threading headers
+ */
+export declare function annotateBlocksWithTypeSafe(client: SystemOneClient, blocks: readonly Block[], isReply: boolean): Promise<AnnotationResult>;
 //# sourceMappingURL=llm.d.ts.map

package/dist/annotate/llm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/annotate/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,2FAA2F;AAC3F,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,8EAA8E;AAC9E,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAEnE;AAkBD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgEpI"}
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/annotate/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAwC,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEhG,OAAO,EAAE,KAAK,eAAe,EAAyB,MAAM,mBAAmB,CAAC;AAGhF,2FAA2F;AAC3F,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,8EAA8E;AAC9E,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,KAAK,EAAE,CAEnE;AA8CD;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+BpI;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4B/I"}

package/dist/annotate/llm.js

@@ -15,7 +15,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_BLOCKS = exports.MAX_BLOCK_CHARS = void 0;
 exports.annotatableBlocks = annotatableBlocks;
 exports.annotateBlocks = annotateBlocks;
+exports.annotateBlocksWithTypeSafe = annotateBlocksWithTypeSafe;
+const probabilities_1 = require("./probabilities");
 const prompt_1 = require("./prompt");
+const typesafe_prompt_1 = require("./typesafe-prompt");
 /** Characters of each block sent to the model. Enough for a decision, bounded for cost. */
 exports.MAX_BLOCK_CHARS = 700;
 /** Blocks per message. Longer messages are truncated with a recorded flag. */
@@ -39,6 +42,27 @@ function toPromptBlocks(blocks) {
         };
     });
 }
+/**
+ * Close the loop on what was sent: every sent block comes back exactly once, in index order.
+ *
+ * A block the model declined to label, or answered unusably, is UNKNOWN with confidence zero, which
+ * stays visible. Silently dropping it would let an omission look like agreement later.
+ */
+function finish(sent, accepted, spurious, meta) {
+    const labels = [...accepted.values()];
+    const missing = [];
+    for (const block of sent) {
+        if (!accepted.has(block.index)) {
+            missing.push(block.index);
+            labels.push({ index: block.index, label: 'UNKNOWN', confidence: 0 });
+        }
+    }
+    labels.sort((a, b) => a.index - b.index);
+    return { ...meta, labels, missing, spurious, blocksSent: sent.length };
+}
+function clampConfidence(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? Math.min(1, Math.max(0, value)) : 0.5;
+}
 /**
  * Annotate one message's blocks.
  *
@@ -49,16 +73,9 @@ function toPromptBlocks(blocks) {
 async function annotateBlocks(client, blocks, isReply) {
     const candidates = annotatableBlocks(blocks);
     const sent = toPromptBlocks(candidates);
+    const meta = { model: client.model, promptVersion: prompt_1.PROMPT_VERSION, blocksTotal: candidates.length };
     if (!sent.length) {
-        return {
-            labels: [],
-            model: client.model,
-            promptVersion: prompt_1.PROMPT_VERSION,
-            missing: [],
-            spurious: [],
-            blocksSent: 0,
-            blocksTotal: candidates.length
-        };
+        return finish(sent, new Map(), [], meta);
     }
     const response = await client.complete({
         system: prompt_1.SYSTEM_PROMPT,
@@ -69,39 +86,54 @@ async function annotateBlocks(client, blocks, isReply) {
     // Validate against the blocks we actually sent. The schema constrains shape and label values,
     // but nothing stops the model returning an index we never asked about, or omitting one.
     const expected = new Set(sent.map(block => block.index));
-    const seen = new Set();
-    const labels = [];
+    const accepted = new Map();
     const spurious = [];
     for (const item of response.labels ?? []) {
-        if (!expected.has(item.index) || seen.has(item.index)) {
+        if (!expected.has(item.index) || accepted.has(item.index)) {
             spurious.push(item.index);
             continue;
         }
-        seen.add(item.index);
-        labels.push({
-            index: item.index,
-            label: item.label,
-            confidence: Number.isFinite(item.confidence) ? Math.min(1, Math.max(0, item.confidence)) : 0.5
-        });
+        accepted.set(item.index, { index: item.index, label: item.label, confidence: clampConfidence(item.confidence) });
     }
-    // A block the model declined to label is UNKNOWN, which stays visible. Silently dropping it
-    // would let an omission look like agreement later.
-    const missing = [];
-    for (const index of expected) {
-        if (!seen.has(index)) {
-            missing.push(index);
-            labels.push({ index, label: 'UNKNOWN', confidence: 0 });
+    return finish(sent, accepted, spurious, meta);
+}
+/**
+ * Annotate one message's blocks with TypeSafe: one Choice question per block.
+ *
+ * The stored label is the cost rule applied to the returned distribution at DEFAULT_COST_RATIO, not
+ * the model's top choice, and the raw distribution is kept alongside so other ratios can be applied
+ * later without re-running inference. An answer without a usable distribution is treated as
+ * missing: the cost rule cannot be checked against it, so it must not be allowed to hide anything.
+ *
+ * @param client configured TypeSafe client
+ * @param blocks blocks from the primary representation
+ * @param isReply whether the message carries threading headers
+ */
+async function annotateBlocksWithTypeSafe(client, blocks, isReply) {
+    const candidates = annotatableBlocks(blocks);
+    const sent = toPromptBlocks(candidates);
+    const requests = (0, typesafe_prompt_1.planRequests)(sent, isReply);
+    // Independent: each request carries the full state and its own share of the questions.
+    const responses = await Promise.all(requests.map(request => client.ask(request)));
+    const accepted = new Map();
+    const spurious = [];
+    responses.forEach((response, i) => {
+        const asked = requests[i].questions;
+        for (const [id, answer] of Object.entries(response.answers)) {
+            // Matched against what this request asked. Anything else is counted and discarded,
+            // exactly like an invented index on the OpenAI path.
+            const index = (0, typesafe_prompt_1.parseQuestionId)(id);
+            if (index === null || !Object.hasOwn(asked, id) || accepted.has(index)) {
+                spurious.push(index ?? -1);
+                continue;
+            }
+            const probabilities = (0, probabilities_1.sanitizeProbabilities)(answer?.probabilities);
+            if (!probabilities) {
+                continue;
+            }
+            accepted.set(index, { index, label: (0, probabilities_1.applyCostRule)(probabilities), confidence: clampConfidence(answer.confidence), probabilities });
         }
-    }
-    labels.sort((a, b) => a.index - b.index);
-    return {
-        labels,
-        model: client.model,
-        promptVersion: prompt_1.PROMPT_VERSION,
-        missing,
-        spurious,
-        blocksSent: sent.length,
-        blocksTotal: candidates.length
-    };
+    });
+    return finish(sent, accepted, spurious, { model: client.model, promptVersion: typesafe_prompt_1.TYPESAFE_PROMPT_VERSION, blocksTotal: candidates.length });
 }
 //# sourceMappingURL=llm.js.map

package/dist/annotate/llm.js.map

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

package/dist/annotate/probabilities.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Label probability distributions from a probabilistic annotator, and the decision rule applied to
+ * them.
+ *
+ * The OpenAI annotator is asked, in its prompt, to treat hiding authored text as ten times worse
+ * than leaving history visible. An annotator that returns a full distribution does not need to be
+ * asked to be biased: the raw distribution is stored unbiased and the asymmetry is applied here, in
+ * code, where it can be tuned and re-applied without re-running inference.
+ */
+import { type Label } from '../types';
+export type LabelProbabilities = Partial<Record<Label, number>>;
+/**
+ * Hiding authored text is treated as this many times worse than leaving history visible. Part of
+ * the `annotate-ts-v1` convention: stored labels always use it, so changing it means a new prompt
+ * version. Other ratios are applied at read time, from the stored distribution.
+ */
+export declare const DEFAULT_COST_RATIO = 10;
+/**
+ * Labels whose content was written for this message and must stay visible. Hiding one of these is
+ * the expensive error every cost rule, gate and disagreement filter is built around.
+ */
+export declare const AUTHORED_LABELS: ReadonlySet<Label>;
+/**
+ * Keep only known labels with finite values, clamped into [0, 1]. Returns null when nothing usable
+ * is left, so a malformed answer is recorded as missing rather than as a confident zero.
+ */
+export declare function sanitizeProbabilities(raw: unknown): LabelProbabilities | null;
+/** Most probable label. Ties go to the earlier label in LABELS, which puts NEW_CONTENT first. */
+export declare function topLabel(probabilities: LabelProbabilities): Label;
+/**
+ * Apply the cost asymmetry to a distribution.
+ *
+ * Hiding a block wrongly costs `ratio` times the probability that it was authored, summed over
+ * AUTHORED_LABELS since hiding is wrong if it is any of them. Leaving it visible wrongly costs the
+ * probability that it was history. So REPLY_HISTORY survives only when
+ * P(REPLY_HISTORY) > ratio * (P(NEW_CONTENT) + P(INLINE_QUOTE)); otherwise the block falls back to
+ * whichever authored label is more likely. Every other label is taken as is, since none of them
+ * hides anything.
+ */
+export declare function applyCostRule(probabilities: LabelProbabilities, ratio?: number): Label;
+/**
+ * Gap between the two most probable labels. Small means genuinely ambiguous, which is what review
+ * triage should sort by instead of a model's self reported confidence.
+ */
+export declare function probabilityMargin(probabilities: LabelProbabilities): number;
+/** Parse the JSON stored in `annotations.probabilities`. Null for rows written without one. */
+export declare function parseStoredProbabilities(json: string | null | undefined): LabelProbabilities | null;
+//# sourceMappingURL=probabilities.d.ts.map

package/dist/annotate/probabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probabilities.d.ts","sourceRoot":"","sources":["../../src/annotate/probabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAU,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,KAAK,CAAmD,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAc7E;AAED,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,aAAa,EAAE,kBAAkB,GAAG,KAAK,CAWjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,aAAa,EAAE,kBAAkB,EAAE,KAAK,GAAE,MAA2B,GAAG,KAAK,CAe1G;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,kBAAkB,GAAG,MAAM,CAa3E;AAED,+FAA+F;AAC/F,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,kBAAkB,GAAG,IAAI,CASnG"}

package/dist/annotate/probabilities.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Label probability distributions from a probabilistic annotator, and the decision rule applied to
+ * them.
+ *
+ * The OpenAI annotator is asked, in its prompt, to treat hiding authored text as ten times worse
+ * than leaving history visible. An annotator that returns a full distribution does not need to be
+ * asked to be biased: the raw distribution is stored unbiased and the asymmetry is applied here, in
+ * code, where it can be tuned and re-applied without re-running inference.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AUTHORED_LABELS = exports.DEFAULT_COST_RATIO = void 0;
+exports.sanitizeProbabilities = sanitizeProbabilities;
+exports.topLabel = topLabel;
+exports.applyCostRule = applyCostRule;
+exports.probabilityMargin = probabilityMargin;
+exports.parseStoredProbabilities = parseStoredProbabilities;
+const types_1 = require("../types");
+/**
+ * Hiding authored text is treated as this many times worse than leaving history visible. Part of
+ * the `annotate-ts-v1` convention: stored labels always use it, so changing it means a new prompt
+ * version. Other ratios are applied at read time, from the stored distribution.
+ */
+exports.DEFAULT_COST_RATIO = 10;
+/**
+ * Labels whose content was written for this message and must stay visible. Hiding one of these is
+ * the expensive error every cost rule, gate and disagreement filter is built around.
+ */
+exports.AUTHORED_LABELS = new Set(['NEW_CONTENT', 'INLINE_QUOTE']);
+/**
+ * Keep only known labels with finite values, clamped into [0, 1]. Returns null when nothing usable
+ * is left, so a malformed answer is recorded as missing rather than as a confident zero.
+ */
+function sanitizeProbabilities(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return null;
+    }
+    const out = {};
+    let any = false;
+    for (const label of types_1.LABELS) {
+        const value = raw[label];
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            out[label] = Math.min(1, Math.max(0, value));
+            any = true;
+        }
+    }
+    return any ? out : null;
+}
+/** Most probable label. Ties go to the earlier label in LABELS, which puts NEW_CONTENT first. */
+function topLabel(probabilities) {
+    let best = 'UNKNOWN';
+    let bestValue = -1;
+    for (const label of types_1.LABELS) {
+        const value = probabilities[label] ?? 0;
+        if (value > bestValue) {
+            best = label;
+            bestValue = value;
+        }
+    }
+    return best;
+}
+/**
+ * Apply the cost asymmetry to a distribution.
+ *
+ * Hiding a block wrongly costs `ratio` times the probability that it was authored, summed over
+ * AUTHORED_LABELS since hiding is wrong if it is any of them. Leaving it visible wrongly costs the
+ * probability that it was history. So REPLY_HISTORY survives only when
+ * P(REPLY_HISTORY) > ratio * (P(NEW_CONTENT) + P(INLINE_QUOTE)); otherwise the block falls back to
+ * whichever authored label is more likely. Every other label is taken as is, since none of them
+ * hides anything.
+ */
+function applyCostRule(probabilities, ratio = exports.DEFAULT_COST_RATIO) {
+    const top = topLabel(probabilities);
+    if (top !== 'REPLY_HISTORY') {
+        return top;
+    }
+    let authoredMass = 0;
+    let fallback = 'NEW_CONTENT';
+    for (const label of exports.AUTHORED_LABELS) {
+        const value = probabilities[label] ?? 0;
+        authoredMass += value;
+        if (value > (probabilities[fallback] ?? 0)) {
+            fallback = label;
+        }
+    }
+    return (probabilities.REPLY_HISTORY ?? 0) > ratio * authoredMass ? 'REPLY_HISTORY' : fallback;
+}
+/**
+ * Gap between the two most probable labels. Small means genuinely ambiguous, which is what review
+ * triage should sort by instead of a model's self reported confidence.
+ */
+function probabilityMargin(probabilities) {
+    let first = 0;
+    let second = 0;
+    for (const label of types_1.LABELS) {
+        const value = probabilities[label] ?? 0;
+        if (value > first) {
+            second = first;
+            first = value;
+        }
+        else if (value > second) {
+            second = value;
+        }
+    }
+    return first - second;
+}
+/** Parse the JSON stored in `annotations.probabilities`. Null for rows written without one. */
+function parseStoredProbabilities(json) {
+    if (!json) {
+        return null;
+    }
+    try {
+        return sanitizeProbabilities(JSON.parse(json));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=probabilities.js.map

package/dist/annotate/probabilities.js.map

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

package/dist/annotate/providers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Annotation providers behind one interface.
+ *
+ * Each provider owns its client, default model, prompt version and response validation. Commands
+ * only pick one by name, so adding a provider never means editing a command's control flow.
+ */
+import { type Usage } from './http';
+import { type AnnotationResult } from './llm';
+import { type Block } from '../segment/types';
+export interface Annotator {
+    readonly model: string;
+    readonly promptVersion: string;
+    readonly usage: Usage;
+    annotate(blocks: readonly Block[], isReply: boolean): Promise<AnnotationResult>;
+}
+interface ProviderSpec {
+    defaultModel: string;
+    promptVersion: string;
+    /** Throws, before anything is sent, when the provider's key is not configured. */
+    create(model: string): Annotator;
+}
+export declare const PROVIDERS: Readonly<Record<string, ProviderSpec>>;
+/** The provider registered under `name`, or null. Own properties only, so `constructor` is not one. */
+export declare function provider(name: string): ProviderSpec | null;
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/annotate/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/annotate/providers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAA8C,KAAK,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAI1F,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACnF;AAED,UAAU,YAAY;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAED,eAAO,MAAM,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAsB5D,CAAC;AAEF,uGAAuG;AACvG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAE1D"}

package/dist/annotate/providers.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Annotation providers behind one interface.
+ *
+ * Each provider owns its client, default model, prompt version and response validation. Commands
+ * only pick one by name, so adding a provider never means editing a command's control flow.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROVIDERS = void 0;
+exports.provider = provider;
+const client_1 = require("./client");
+const llm_1 = require("./llm");
+const prompt_1 = require("./prompt");
+const typesafe_client_1 = require("./typesafe-client");
+const typesafe_prompt_1 = require("./typesafe-prompt");
+exports.PROVIDERS = {
+    openai: {
+        defaultModel: 'gpt-5.6-sol',
+        promptVersion: prompt_1.PROMPT_VERSION,
+        create(model) {
+            const client = new client_1.OpenAIClient((0, client_1.configFromEnv)(model));
+            return { model, promptVersion: prompt_1.PROMPT_VERSION, usage: client.usage, annotate: (blocks, isReply) => (0, llm_1.annotateBlocks)(client, blocks, isReply) };
+        }
+    },
+    typesafe: {
+        defaultModel: typesafe_client_1.TYPESAFE_DEFAULT_MODEL,
+        promptVersion: typesafe_prompt_1.TYPESAFE_PROMPT_VERSION,
+        create(model) {
+            const client = new typesafe_client_1.TypeSafeClient((0, typesafe_client_1.typeSafeConfigFromEnv)(model));
+            return {
+                model,
+                promptVersion: typesafe_prompt_1.TYPESAFE_PROMPT_VERSION,
+                usage: client.usage,
+                annotate: (blocks, isReply) => (0, llm_1.annotateBlocksWithTypeSafe)(client, blocks, isReply)
+            };
+        }
+    }
+};
+/** The provider registered under `name`, or null. Own properties only, so `constructor` is not one. */
+function provider(name) {
+    return Object.hasOwn(exports.PROVIDERS, name) ? exports.PROVIDERS[name] : null;
+}
+//# sourceMappingURL=providers.js.map

package/dist/annotate/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/annotate/providers.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAiDH,4BAEC;AAjDD,qCAAuD;AAEvD,+BAA0F;AAC1F,qCAA0C;AAC1C,uDAAkG;AAClG,uDAA4D;AAiB/C,QAAA,SAAS,GAA2C;IAC7D,MAAM,EAAE;QACJ,YAAY,EAAE,aAAa;QAC3B,aAAa,EAAE,uBAAc;QAC7B,MAAM,CAAC,KAAK;YACR,MAAM,MAAM,GAAG,IAAI,qBAAY,CAAC,IAAA,sBAAa,EAAC,KAAK,CAAC,CAAC,CAAC;YACtD,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,uBAAc,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,IAAA,oBAAc,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;QACjJ,CAAC;KACJ;IACD,QAAQ,EAAE;QACN,YAAY,EAAE,wCAAsB;QACpC,aAAa,EAAE,yCAAuB;QACtC,MAAM,CAAC,KAAK;YACR,MAAM,MAAM,GAAG,IAAI,gCAAc,CAAC,IAAA,uCAAqB,EAAC,KAAK,CAAC,CAAC,CAAC;YAChE,OAAO;gBACH,KAAK;gBACL,aAAa,EAAE,yCAAuB;gBACtC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,IAAA,gCAA0B,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;aACrF,CAAC;QACN,CAAC;KACJ;CACJ,CAAC;AAEF,uGAAuG;AACvG,SAAgB,QAAQ,CAAC,IAAY;IACjC,OAAO,MAAM,CAAC,MAAM,CAAC,iBAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAE,iBAAS,CAAC,IAAI,CAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;AACrF,CAAC"}

package/dist/annotate/store.d.ts

@@ -8,6 +8,7 @@
  */
 import { type CorpusStore } from '../corpus/store';
 import { type Label, type Reason } from '../types';
+import { type LabelProbabilities } from './probabilities';
 export interface AnnotationRow {
     path: string;
     representation: 'text' | 'html';
@@ -22,6 +23,8 @@ export interface AnnotationRow {
     baselineLabel: Label | null;
     baselineConfidence: number | null;
     baselineReasons: readonly Reason[];
+    /** Full label distribution, when the annotator returns one. */
+    probabilities?: LabelProbabilities | null;
 }
 export interface AnnotationRunInfo {
     source: string;

package/dist/annotate/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/annotate/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAqB,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAYtF;AAED,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC/G,IAAI,CAaN;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CA6BxG;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,GAAE,MAAM,GAAG,IAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBzI"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/annotate/store.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAqB,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAYtF;AAED,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAC/G,IAAI,CAaN;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CA+BxG;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,aAAa,GAAE,MAAM,GAAG,IAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAgBzI"}

package/dist/annotate/store.js

@@ -13,6 +13,7 @@ exports.finishAnnotationRun = finishAnnotationRun;
 exports.writeAnnotations = writeAnnotations;
 exports.annotatedPaths = annotatedPaths;
 const types_1 = require("../types");
+const probabilities_1 = require("./probabilities");
 function startAnnotationRun(store, info) {
     const result = store.run(`INSERT INTO annotation_runs (source, model, prompt_version, extractor_version, started_at, notes)
          VALUES (?, ?, ?, ?, ?, ?)`, info.source, info.model, info.promptVersion, types_1.EXTRACTOR_VERSION, Date.now(), info.notes ?? null);
@@ -31,8 +32,8 @@ function writeAnnotations(store, runId, rows) {
         for (const row of rows) {
             store.run(`INSERT INTO annotations (
                     run_id, path, representation, block_index, mime_part, block_start, block_end, char_count,
-                    source, label, confidence, baseline_label, baseline_conf, baseline_reasons, agrees
-                 ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, runId, row.path, row.representation, row.blockIndex, row.mimePart, row.blockStart, row.blockEnd, row.charCount, row.source, row.label, row.confidence, row.baselineLabel, row.baselineConfidence, row.baselineReasons.join(','), row.baselineLabel === row.label ? 1 : 0);
+                    source, label, confidence, baseline_label, baseline_conf, baseline_reasons, agrees, probabilities, margin
+                 ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, runId, row.path, row.representation, row.blockIndex, row.mimePart, row.blockStart, row.blockEnd, row.charCount, row.source, row.label, row.confidence, row.baselineLabel, row.baselineConfidence, row.baselineReasons.join(','), row.baselineLabel === row.label ? 1 : 0, row.probabilities ? JSON.stringify(row.probabilities) : null, row.probabilities ? (0, probabilities_1.probabilityMargin)(row.probabilities) : null);
         }
     });
 }

package/dist/annotate/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/annotate/store.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AA4BH,gDAYC;AAED,kDAiBC;AAED,4CA6BC;AASD,wCAgBC;AAhHD,oCAAsE;AAyBtE,SAAgB,kBAAkB,CAAC,KAAkB,EAAE,IAAuB;IAC1E,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CACpB;mCAC2B,EAC3B,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,aAAa,EAClB,yBAAiB,EACjB,IAAI,CAAC,GAAG,EAAE,EACV,IAAI,CAAC,KAAK,IAAI,IAAI,CACrB,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,mBAAmB,CAC/B,KAAkB,EAClB,KAAa,EACb,MAA8G;IAE9G,KAAK,CAAC,GAAG,CACL;;sBAEc,EACd,IAAI,CAAC,GAAG,EAAE,EACV,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,gBAAgB,EACvB,KAAK,CACR,CAAC;AACN,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAkB,EAAE,KAAa,EAAE,IAA8B;IAC9F,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACf,OAAO;IACX,CAAC;IACD,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE;QACnB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,GAAG,CACL;;;wEAGwD,EACxD,KAAK,EACL,GAAG,CAAC,IAAI,EACR,GAAG,CAAC,cAAc,EAClB,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,QAAQ,EACZ,GAAG,CAAC,SAAS,EACb,GAAG,CAAC,MAAM,EACV,GAAG,CAAC,KAAK,EACT,GAAG,CAAC,UAAU,EACd,GAAG,CAAC,aAAa,EACjB,GAAG,CAAC,kBAAkB,EACtB,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAC7B,GAAG,CAAC,aAAa,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC1C,CAAC;QACN,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,cAAc,CAAC,KAAkB,EAAE,MAAc,EAAE,KAAoB,EAAE,gBAA+B,IAAI;IACxH,MAAM,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC;IACjC,MAAM,MAAM,GAAa,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,aAAa,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CACpB,qGAAqG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,EAC5H,GAAG,MAAM,CACZ,CAAC;IACF,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/annotate/store.ts"],"names":[],"mappings":"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"}

package/dist/annotate/typesafe-client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Minimal TypeSafe System One client.
+ *
+ * No SDK dependency, for the same reason as the OpenAI client: the package ships three runtime
+ * dependencies and none of them opens a socket. `@typesafe-ai/sdk` could only be a dev dependency,
+ * and `dist/cli` is part of the published tarball, so an installed `email-content annotate` would
+ * fail to load it. The surface used here is one POST.
+ *
+ * This is the second place in the codebase that sends message content off the machine, under the
+ * same terms as the first: only reachable from `email-content annotate`, opt in, fails closed
+ * without a key. See docs/threat-model.md, "Configured exception: LLM annotation".
+ */
+import { ApiError, type ApiConfig, type Usage } from './http';
+/**
+ * Pinned rather than `jev-latest`: labels are stored with the model that produced them, and an
+ * alias that silently moves would put two models' output under one name.
+ */
+export declare const TYPESAFE_DEFAULT_MODEL = "jev-1.13.0";
+export type TypeSafeConfig = ApiConfig;
+export interface ChoiceQuestion {
+    type: 'choice';
+    instructions: string | Record<string, unknown>;
+    criteria: Record<string, string | Record<string, unknown> | null>;
+}
+export interface SystemOneRequest {
+    state: unknown;
+    questions: Record<string, ChoiceQuestion>;
+}
+/** One answer as returned. Fields are unvalidated until the annotator checks them. */
+export interface ChoiceAnswer {
+    choice?: unknown;
+    probabilities?: unknown;
+    confidence?: unknown;
+}
+export interface SystemOneResponse {
+    answers: Record<string, ChoiceAnswer>;
+}
+/** The narrow surface the annotator depends on, so its validation can be tested without a network. */
+export interface SystemOneClient {
+    readonly model: string;
+    ask(request: SystemOneRequest): Promise<SystemOneResponse>;
+}
+export declare class TypeSafeError extends ApiError {
+    constructor(message: string, status: number, retryable: boolean);
+}
+/** Load configuration from the environment, after process.loadEnvFile(). */
+export declare function typeSafeConfigFromEnv(model: string, overrides?: Partial<TypeSafeConfig>): TypeSafeConfig;
+export declare class TypeSafeClient implements SystemOneClient {
+    private readonly config;
+    /** Input tokens are reported as prompt tokens, output tokens as completion tokens. */
+    readonly usage: Usage;
+    constructor(config: TypeSafeConfig);
+    get model(): string;
+    /**
+     * Ask a set of questions about one state.
+     *
+     * Retries on rate limits (429), overload (529) and other server errors. Anything else, a 422
+     * validation failure in particular, is a bug in the request and is not retried. Error messages
+     * carry the status only, never the response body: a validation error may echo the state back,
+     * and the state is private mail.
+     */
+    ask(request: SystemOneRequest): Promise<SystemOneResponse>;
+}
+//# sourceMappingURL=typesafe-client.d.ts.map

package/dist/annotate/typesafe-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typesafe-client.d.ts","sourceRoot":"","sources":["../../src/annotate/typesafe-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAA8B,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE1F;;;GAGG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC7C;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED,sGAAsG;AACtG,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO;CAIlE;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,cAAc,CAE5G;AAED,qBAAa,cAAe,YAAW,eAAe;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAyE;gBAElF,MAAM,EAAE,cAAc;IAIlC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;;;;;OAOG;IACG,GAAG,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwBnE"}