@swissspidy/belay-core 0.1.0 → 0.1.1

package/dist/types.d.ts

@@ -0,0 +1,396 @@
+/**
+ * Public types for @swissspidy/belay-core. See docs/adr/0001-public-api-confidence-and-calibration.md.
+ */
+/** An option of a categorical or ordinal task. Plain strings are shorthand for `{ label }`. */
+export interface OptionSpec {
+    /** Stable identifier returned as the task value. */
+    label: string;
+    /** Optional natural-language hint for the model(s). */
+    description?: string;
+}
+export type OptionInput = string | OptionSpec;
+export interface BinarySchema {
+    type: 'binary';
+    /** The yes/no question, e.g. "Does this comment contain a personal attack?" */
+    prompt: string;
+}
+export interface CategoricalSchema<L extends string = string> {
+    type: 'categorical';
+    options: readonly (L | (OptionSpec & {
+        label: L;
+    }))[];
+    /** Optional question, e.g. "Which department should handle this ticket?" */
+    prompt?: string;
+}
+export interface OrdinalSchema<L extends string = string> {
+    type: 'ordinal';
+    /** Ordered from lowest to highest. */
+    options: readonly (L | (OptionSpec & {
+        label: L;
+    }))[];
+    prompt?: string;
+}
+export type ValidationResult = true | {
+    valid: false;
+    errors: string[];
+};
+export interface StructuredSchema<T = unknown> {
+    type: 'structured';
+    /** JSON Schema handed to the Prompt API (`responseConstraint`) and to the cloud adapter. */
+    jsonSchema: Record<string, unknown>;
+    /**
+     * Validates a parsed candidate. @swissspidy/belay-core has no runtime dependencies and therefore
+     * no JSON Schema validator; plug in your own (Ajv, Zod, a hand-written guard, ...).
+     */
+    validate: (value: unknown) => value is T;
+    prompt?: string;
+}
+export type TaskSchema = BinarySchema | CategoricalSchema | OrdinalSchema | StructuredSchema<any>;
+/** The value type a schema produces. */
+export type ValueOf<S extends TaskSchema> = S extends BinarySchema ? boolean : S extends CategoricalSchema<infer L> ? L : S extends OrdinalSchema<infer L> ? L : S extends StructuredSchema<infer T> ? T : never;
+/** Mirrors the availability states used by Chrome's built-in AI APIs. */
+export type Availability = 'available' | 'downloadable' | 'downloading' | 'unavailable';
+export interface ProbabilityEntry {
+    label: string;
+    probability: number;
+}
+export interface RunnerContext<S extends TaskSchema = TaskSchema> {
+    task: string;
+    schema: S;
+    /** Optional task-level context shared by local and cloud runners. */
+    context?: string;
+    signal?: AbortSignal;
+}
+export interface LocalOutput<V = unknown> {
+    value: V;
+    /**
+     * Confidence in [0, 1]. Classifier runners report the calibrated probability of the
+     * top option. Generation runners may omit it and let the task's `judge` compute it.
+     */
+    confidence?: number;
+    /** Full distribution when the runner has one (classifier tasks). */
+    probabilities?: ProbabilityEntry[];
+    /** Runner-specific diagnostics; never sent to telemetry. */
+    raw?: unknown;
+}
+export interface LocalRunner<S extends TaskSchema = TaskSchema> {
+    /** Short identifier used in telemetry and calibration files, e.g. "classifier-api". */
+    readonly id: string;
+    /** Must never trigger a model download. */
+    availability(ctx: RunnerContext<S>): Promise<Availability>;
+    /**
+     * Called only when `availability()` resolved to "available". Must never trigger a model download.
+     * May throw {@link LocalUnavailableError} if the model became unavailable meanwhile.
+     */
+    run(input: string, ctx: RunnerContext<S>): Promise<LocalOutput<ValueOf<S>>>;
+    /**
+     * Download / warm up the model. Call from a user gesture (click handler).
+     * Optional: runners without a download step may omit it.
+     */
+    prepare?(ctx: RunnerContext<S>, options?: PrepareOptions): Promise<void>;
+    /** Release resources. */
+    destroy?(): void;
+}
+export interface PrepareOptions {
+    /** Download progress in [0, 1]. */
+    onProgress?: (loaded: number) => void;
+    signal?: AbortSignal;
+}
+export interface CloudRequest<S extends TaskSchema = TaskSchema> {
+    task: string;
+    schema: S;
+    /** JSON Schema of the expected output, for providers with structured output. */
+    jsonSchema: Record<string, unknown>;
+    /** A ready-to-use instruction describing the task and the output format. */
+    instruction: string;
+    /** Input after redaction. */
+    input: string;
+    context?: string;
+    /** The local attempt, when there was one. Lets a cloud prompt say "a small model guessed X". */
+    local?: {
+        value: unknown;
+        confidence: number | null;
+    };
+}
+/**
+ * Token usage of one cloud call, as the provider reported it. A call that several models served
+ * (e.g. a refusal fallback) reports one part per model.
+ */
+export interface CloudUsage {
+    /** The model id that served this part, as the provider reports it (keys a `PriceTable`). */
+    model?: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens?: number;
+    cacheWriteInputTokens?: number;
+}
+/** Prices per million tokens. Cache prices default to the input price. */
+export interface TokenPrices {
+    input: number;
+    output: number;
+    cacheRead?: number;
+    cacheWrite?: number;
+}
+/** Token prices keyed by the model id the provider reports. */
+export type PriceTable = Record<string, TokenPrices>;
+export interface CloudOutput<V = unknown> {
+    value: V;
+    /** Optional confidence if the provider exposes one (e.g. from logprobs). */
+    confidence?: number;
+    /** Token usage, when the provider reports it. Used to measure what calls cost. */
+    usage?: CloudUsage | CloudUsage[];
+    raw?: unknown;
+}
+export interface CloudRunner<S extends TaskSchema = TaskSchema> {
+    readonly id: string;
+    /** The returned `value` is validated against the schema by the task (see `parseValue()`). */
+    run(request: CloudRequest<S>, options: {
+        signal?: AbortSignal;
+    }): Promise<CloudOutput>;
+}
+/** Judges a generated output: resolves to P(output is correct and complete) in [0, 1]. */
+export type Judge<V = unknown> = ((args: {
+    input: string;
+    value: V;
+    task: string;
+    signal?: AbortSignal;
+}) => Promise<number>) & {
+    /** Judges backed by an on-device model can report its state and download it (from a user gesture). */
+    availability?(): Promise<Availability>;
+    prepare?(options?: PrepareOptions): Promise<void>;
+    destroy?(): void;
+};
+/**
+ * - `auto`: escalate whenever the cascade decides to (default).
+ * - `never`: never send anything to the cloud runner.
+ * - `consent`: ask the `consent` callback before every escalation.
+ */
+export type EscalationPolicy = 'auto' | 'never' | 'consent';
+export interface ConsentRequest {
+    task: string;
+    reason: EscalationReason;
+    /** The redacted input that would be sent. */
+    input: string;
+    local: {
+        value: unknown;
+        confidence: number | null;
+    } | null;
+}
+export interface PrivacyOptions {
+    escalation?: EscalationPolicy;
+    /** Required when `escalation` is `consent`. */
+    consent?: (request: ConsentRequest) => boolean | Promise<boolean>;
+    /** Applied to the input before any cloud call (and before `consent`). */
+    redact?: (input: string) => string | Promise<string>;
+}
+export type EscalationReason = 
+/** Local confidence was below the threshold. */
+'low-confidence'
+/** The local runner reported the model is not ready (unavailable / not downloaded). */
+ | 'local-unavailable'
+/** The local runner threw. */
+ | 'local-error'
+/** The local runner exceeded `localTimeoutMs`. */
+ | 'local-timeout'
+/** The local output failed schema validation. */
+ | 'invalid-output';
+/**
+ * Why a wanted escalation did not produce the result:
+ * - `policy`: escalation is disabled (`never`, no cloud runner, or the redact hook failed);
+ * - `consent-denied`: the consent callback returned false (or threw);
+ * - `cloud-error`: the cloud runner failed; the local result is returned instead.
+ */
+export type EscalationBlock = 'policy' | 'consent-denied' | 'cloud-error';
+export interface BelayResult<V = unknown> {
+    value: V;
+    /**
+     * Confidence of the returned value: the local confidence when `source` is "local";
+     * the cloud's own confidence (if its adapter reports one) or `null` when `source` is "cloud".
+     */
+    confidence: number | null;
+    source: 'local' | 'cloud';
+    /** Total wall-clock time of `run()`. */
+    latencyMs: number;
+    /** Why the cascade wanted to escalate; `null` if the local result was accepted. */
+    escalationReason: EscalationReason | null;
+    /** Set when the cascade wanted to escalate but returned the local result instead. */
+    escalationBlocked: EscalationBlock | null;
+    /** Threshold in effect for this run. */
+    threshold: number;
+    /** The local attempt, if the local runner produced an output. */
+    local: {
+        value: V;
+        confidence: number;
+        latencyMs: number;
+        probabilities?: ProbabilityEntry[];
+    } | null;
+}
+export interface RunOptions {
+    signal?: AbortSignal;
+    /** Per-run override of the task's escalation policy (can only be stricter: see ADR). */
+    escalation?: EscalationPolicy;
+    /** Per-run context appended to the task context. */
+    context?: string;
+}
+export interface TaskOptions<S extends TaskSchema> {
+    name: string;
+    schema: S;
+    local: LocalRunner<NoInfer<S>>;
+    /** Optional: without a cloud runner the task behaves as `escalation: 'never'`. */
+    cloud?: CloudRunner<NoInfer<S>>;
+    /** Fixed threshold. Also used as the fallback when a calibration fails to load. */
+    threshold?: number;
+    /** A calibration file object, a URL to fetch it from, or a loader. */
+    calibration?: CalibrationFile | string | URL | (() => Promise<CalibrationFile>);
+    /** Context shared by local and cloud runners, e.g. "Support tickets for a SaaS billing product". */
+    context?: string;
+    /** For generation tasks: estimates P(correct). Combined with schema validation. */
+    judge?: Judge<ValueOf<NoInfer<S>>>;
+    privacy?: PrivacyOptions;
+    /** Escalate if the local runner takes longer than this. */
+    localTimeoutMs?: number;
+    onEvent?: (event: BelayEvent) => void;
+}
+export interface Task<S extends TaskSchema> {
+    readonly name: string;
+    readonly schema: S;
+    run(input: string, options?: RunOptions): Promise<BelayResult<ValueOf<S>>>;
+    availability(): Promise<Availability>;
+    /** Downloads the local model. Call from a user gesture. */
+    prepare(options?: PrepareOptions): Promise<void>;
+    /** Resolves the threshold (loading the calibration if needed). */
+    threshold(): Promise<number>;
+    destroy(): void;
+}
+/** Emitted once per run. Never contains the input or the output text of structured tasks. */
+export interface RunEvent {
+    type: 'run';
+    task: string;
+    timestamp: number;
+    source: 'local' | 'cloud';
+    /** Categorical/ordinal/binary label of the returned value (omitted for structured tasks). */
+    label?: string;
+    confidence: number | null;
+    localConfidence: number | null;
+    threshold: number;
+    thresholdSource: 'calibration' | 'manual';
+    /** `createdAt` of the calibration file in use, to correlate metrics with calibrations. */
+    calibratedAt: string | null;
+    escalationReason: EscalationReason | null;
+    escalationBlocked: EscalationBlock | null;
+    latencyMs: number;
+    localLatencyMs: number | null;
+    cloudLatencyMs: number | null;
+    localRunner: string;
+    cloudRunner: string | null;
+    /** Token usage of the cloud call, when its runner reported it (see `savingsMeter()`). */
+    cloudUsage?: CloudUsage[];
+}
+export interface ErrorEvent {
+    type: 'error';
+    task: string;
+    timestamp: number;
+    stage: 'local' | 'cloud' | 'calibration' | 'consent' | 'redact';
+    message: string;
+}
+export type BelayEvent = RunEvent | ErrorEvent;
+export interface CalibrationCurvePoint {
+    threshold: number;
+    /** Accuracy of the whole cascade at this threshold. */
+    accuracy: number;
+    /** Fraction of examples answered locally. */
+    localShare: number;
+    /** Accuracy on the examples answered locally. */
+    localAccuracy: number | null;
+    /** Cloud cost per 1,000 runs (in `cost.currency`), when cost data was supplied. */
+    costPer1k?: number;
+}
+/**
+ * - `fixed`: `value` was given as a number.
+ * - `cloud`: the cascade must be at least as accurate as sending everything to the cloud;
+ *   `value` is the cloud-only accuracy measured on the dataset.
+ * - `max`: the most accurate threshold (ties go to the most local share); `value` is that accuracy.
+ */
+export type TargetMode = 'fixed' | 'cloud' | 'max';
+export interface CalibrationFile {
+    version: 1;
+    task: string;
+    /** Fingerprint of the task schema (see `schemaFingerprint()`); used to detect stale files. */
+    schemaFingerprint: string;
+    createdAt: string;
+    local: {
+        runner: string;
+        model?: string;
+        userAgent?: string;
+    };
+    cloud: {
+        runner: string;
+        model?: string;
+    } | null;
+    dataset: {
+        size: number;
+        fingerprint: string;
+    };
+    target: {
+        metric: 'accuracy';
+        value: number;
+        mode?: TargetMode;
+    };
+    /** Recommended global threshold. */
+    threshold: number;
+    /** Optional per-label overrides, keyed by the local top label. */
+    thresholds?: Record<string, number>;
+    expected: {
+        accuracy: number;
+        localShare: number;
+        localAccuracy: number | null;
+        cloudAccuracy: number | null;
+        /** Cloud cost per 1,000 runs at the recommended threshold(s). */
+        costPer1k?: number;
+        /** Cloud cost per 1,000 runs when every run goes to the cloud. */
+        cloudOnlyCostPer1k?: number;
+        /** `cloudOnlyCostPer1k - costPer1k`. */
+        savingsPer1k?: number;
+        /**
+         * K-fold cross-validated estimate: thresholds fitted on K-1 folds, scored on the held-out
+         * fold. The numbers above are fitted and scored on the same data; these are not.
+         */
+        heldOut?: {
+            folds: number;
+            accuracy: number;
+            localShare: number;
+            cloudAccuracy: number;
+            costPer1k?: number;
+        };
+    };
+    cost?: {
+        currency: string;
+        /** Mean cost of one cloud call: measured from token usage, or the configured estimate. */
+        cloudPerRun: number;
+        /** `measured`: priced from the token usage of every cloud call. `estimate`: a configured flat price. */
+        basis?: 'measured' | 'estimate';
+        /** The prices used for `measured` costs, per million tokens. */
+        prices?: PriceTable;
+        /** Mean tokens per cloud call (`measured` only). */
+        tokensPerRun?: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+        };
+        /** Volume for the savings projection in the report. */
+        runsPerMonth?: number;
+    };
+    curve: CalibrationCurvePoint[];
+    /** Histogram of local confidences over the dataset, for drift detection. */
+    confidenceHistogram: {
+        edges: number[];
+        counts: number[];
+    };
+    confusion?: {
+        labels: string[];
+        /** `matrix[i][j]`: examples with true label i that the local runner predicted as j. */
+        local: number[][];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Public types for @swissspidy/belay-core. See docs/adr/0001-public-api-confidence-and-calibration.md.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swissspidy/belay-core",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Confidence-based escalation from on-device to cloud AI: tasks, cascade logic, confidence, calibration types.",
   "license": "Apache-2.0",
   "author": "Pascal Birchler",
@@ -36,7 +36,8 @@
     "src"
   ],
   "scripts": {
-    "build": "tsc -b"
+    "build": "tsc -b",
+    "prepack": "tsc -b --force"
   },
   "publishConfig": {
     "access": "public"