@swissspidy/belay-web 0.0.0-stage → 0.1.1

package/dist/judge.js.map

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

package/dist/prompt-types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Types for the Prompt API (`LanguageModel`), after the explainer at
+ * https://github.com/webmachinelearning/prompt-api (Sep 2026). Only the members Belay uses.
+ */
+import type { Availability } from '@swissspidy/belay-core';
+export interface LanguageModelMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LanguageModelExpected {
+    type: 'text' | 'image' | 'audio';
+    languages?: string[];
+}
+export interface LanguageModelCreateOptions {
+    initialPrompts?: LanguageModelMessage[];
+    expectedInputs?: LanguageModelExpected[];
+    expectedOutputs?: LanguageModelExpected[];
+    monitor?: (monitor: EventTarget) => void;
+    signal?: AbortSignal;
+}
+export interface LanguageModelPromptOptions {
+    responseConstraint?: Record<string, unknown> | RegExp;
+    omitResponseConstraintInput?: boolean;
+    signal?: AbortSignal;
+}
+export interface LanguageModelSession {
+    prompt(input: string, options?: LanguageModelPromptOptions): Promise<string>;
+    clone?(options?: {
+        signal?: AbortSignal;
+    }): Promise<LanguageModelSession>;
+    destroy(): void;
+}
+export interface LanguageModelStatic {
+    availability(options?: Omit<LanguageModelCreateOptions, 'monitor' | 'signal' | 'initialPrompts'>): Promise<Availability>;
+    create(options?: LanguageModelCreateOptions): Promise<LanguageModelSession>;
+}
+//# sourceMappingURL=prompt-types.d.ts.map

package/dist/prompt-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-types.d.ts","sourceRoot":"","sources":["../src/prompt-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACxC,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACzC,eAAe,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC1C,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IACtD,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7E,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,0BAA0B,EAAE,SAAS,GAAG,QAAQ,GAAG,gBAAgB,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzH,MAAM,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC7E"}

package/dist/prompt-types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for the Prompt API (`LanguageModel`), after the explainer at
+ * https://github.com/webmachinelearning/prompt-api (Sep 2026). Only the members Belay uses.
+ */
+export {};
+//# sourceMappingURL=prompt-types.js.map

package/dist/prompt-types.js.map

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

package/dist/prompt.d.ts

@@ -0,0 +1,25 @@
+import type { LocalRunner, RunnerContext, TaskSchema } from '@swissspidy/belay-core';
+import type { LanguageModelExpected, LanguageModelStatic } from './prompt-types.js';
+export interface PromptApiOptions {
+    /** System prompt. Defaults to the task instruction from `buildInstruction(schema, context)`. */
+    systemPrompt?: string | ((ctx: RunnerContext<TaskSchema>) => string);
+    /** Defaults to English text in and out. */
+    expectedInputs?: LanguageModelExpected[];
+    expectedOutputs?: LanguageModelExpected[];
+    /** Keep the JSON Schema out of the model's context window (the system prompt already describes the format). */
+    omitResponseConstraintInput?: boolean;
+    /** The `LanguageModel` implementation. Defaults to `globalThis.LanguageModel`. */
+    languageModel?: LanguageModelStatic;
+    /** Max number of cached base sessions (one per distinct system prompt). Defaults to 4. */
+    maxSessions?: number;
+}
+/**
+ * Local runner backed by the Prompt API with structured output (`responseConstraint`). It reports
+ * no confidence of its own: pair it with a task `judge` (e.g. `classifierJudge()`), and the output
+ * is validated against the schema before the judge sees it.
+ *
+ * Every run prompts a clone of a base session, so runs never see each other's history. Like
+ * `classifierApi()`, `run()` never triggers a model download; call `task.prepare()` from a click.
+ */
+export declare function promptApi(options?: PromptApiOptions): LocalRunner<any>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA6B,WAAW,EAAkB,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAChI,OAAO,KAAK,EAA8B,qBAAqB,EAAwB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEtI,MAAM,WAAW,gBAAgB;IAC/B,gGAAgG;IAChG,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,MAAM,CAAC,CAAC;IACrE,2CAA2C;IAC3C,cAAc,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACzC,eAAe,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAC1C,+GAA+G;IAC/G,2BAA2B,CAAC,EAAE,OAAO,CAAC;IACtC,kFAAkF;IAClF,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAAC,GAAG,CAAC,CA2G1E"}

package/dist/prompt.js

@@ -0,0 +1,117 @@
+import { LocalUnavailableError, buildInstruction, toJsonSchema } from '@swissspidy/belay-core';
+/**
+ * Local runner backed by the Prompt API with structured output (`responseConstraint`). It reports
+ * no confidence of its own: pair it with a task `judge` (e.g. `classifierJudge()`), and the output
+ * is validated against the schema before the judge sees it.
+ *
+ * Every run prompts a clone of a base session, so runs never see each other's history. Like
+ * `classifierApi()`, `run()` never triggers a model download; call `task.prepare()` from a click.
+ */
+export function promptApi(options = {}) {
+    const maxSessions = Math.max(1, options.maxSessions ?? 4);
+    const sessions = new Map();
+    const expected = {
+        expectedInputs: options.expectedInputs ?? [{ type: 'text', languages: ['en'] }],
+        expectedOutputs: options.expectedOutputs ?? [{ type: 'text', languages: ['en'] }],
+    };
+    const api = () => options.languageModel ?? globalThis.LanguageModel;
+    const systemPromptFor = (ctx) => typeof options.systemPrompt === 'function'
+        ? options.systemPrompt(ctx)
+        : (options.systemPrompt ?? buildInstruction(ctx.schema, ctx.context));
+    function session(ctx, prepare) {
+        const LanguageModel = api();
+        if (!LanguageModel)
+            return Promise.reject(new LocalUnavailableError('Prompt API is not available'));
+        const key = systemPromptFor(ctx);
+        const cached = sessions.get(key);
+        if (cached) {
+            sessions.delete(key);
+            sessions.set(key, cached);
+            return cached;
+        }
+        // Only prepare()'s signal: the session is cached and shared, so a per-run abort must not destroy it.
+        const signal = prepare?.signal;
+        const createOptions = {
+            ...expected,
+            initialPrompts: [{ role: 'system', content: key }],
+            ...(signal ? { signal } : {}),
+            ...(prepare?.onProgress
+                ? {
+                    monitor: (m) => m.addEventListener('downloadprogress', (e) => prepare.onProgress(e.loaded)),
+                }
+                : {}),
+        };
+        const created = LanguageModel.create(createOptions);
+        sessions.set(key, created);
+        created.catch(() => {
+            if (sessions.get(key) === created)
+                sessions.delete(key);
+        });
+        while (sessions.size > maxSessions) {
+            const [oldestKey, oldest] = sessions.entries().next().value;
+            sessions.delete(oldestKey);
+            oldest.then((s) => s.destroy(), () => { });
+        }
+        return created;
+    }
+    async function availability(ctx) {
+        const LanguageModel = api();
+        if (!LanguageModel)
+            return 'unavailable';
+        if (sessions.has(systemPromptFor(ctx)))
+            return 'available';
+        try {
+            return await LanguageModel.availability(expected);
+        }
+        catch {
+            return 'unavailable';
+        }
+    }
+    return {
+        id: 'prompt-api',
+        availability,
+        async run(input, ctx) {
+            if (!sessions.has(systemPromptFor(ctx))) {
+                const state = await availability(ctx);
+                if (state !== 'available')
+                    throw new LocalUnavailableError(`Prompt API model is ${state}`);
+            }
+            const base = await session(ctx);
+            // A fresh clone per run keeps runs independent. Without clone(), fall back to a new session.
+            const LanguageModel = api();
+            const turn = base.clone
+                ? await base.clone(ctx.signal ? { signal: ctx.signal } : {})
+                : await LanguageModel.create({ ...expected, initialPrompts: [{ role: 'system', content: systemPromptFor(ctx) }], ...(ctx.signal ? { signal: ctx.signal } : {}) });
+            try {
+                const text = await turn.prompt(input, {
+                    responseConstraint: toJsonSchema(ctx.schema),
+                    ...(options.omitResponseConstraintInput ? { omitResponseConstraintInput: true } : {}),
+                    ...(ctx.signal ? { signal: ctx.signal } : {}),
+                });
+                let value = text;
+                try {
+                    value = JSON.parse(text);
+                }
+                catch {
+                    // Leave the raw text: the task's schema validation reports it as invalid output.
+                }
+                return { value, raw: text };
+            }
+            finally {
+                turn.destroy();
+            }
+        },
+        async prepare(ctx, prepareOptions) {
+            const state = await availability(ctx);
+            if (state === 'unavailable')
+                throw new LocalUnavailableError('Prompt API model is unavailable on this device');
+            await session(ctx, prepareOptions);
+        },
+        destroy() {
+            for (const s of sessions.values())
+                s.then((c) => c.destroy(), () => { });
+            sessions.clear();
+        },
+    };
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAoB/F;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,OAAO,GAAqB,EAAE;IACtD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyC,CAAC;IAClE,MAAM,QAAQ,GAAG;QACf,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxF,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;KAC3F,CAAC;IAEF,MAAM,GAAG,GAAG,GAAoC,EAAE,CAChD,OAAO,CAAC,aAAa,IAAK,UAAsD,CAAC,aAAa,CAAC;IAEjG,MAAM,eAAe,GAAG,CAAC,GAAQ,EAAU,EAAE,CAC3C,OAAO,OAAO,CAAC,YAAY,KAAK,UAAU;QACxC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC;QAC3B,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IAE1E,SAAS,OAAO,CAAC,GAAQ,EAAE,OAAwB;QACjD,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,qBAAqB,CAAC,6BAA6B,CAAC,CAAC,CAAC;QACpG,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC1B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,qGAAqG;QACrG,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAC/B,MAAM,aAAa,GAA+B;YAChD,GAAG,QAAQ;YACX,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;YAClD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,OAAO,EAAE,UAAU;gBACrB,CAAC,CAAC;oBACE,OAAO,EAAE,CAAC,CAAc,EAAE,EAAE,CAC1B,CAAC,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,UAAW,CAAE,CAAgC,CAAC,MAAM,CAAC,CAAC;iBAC/G;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACpD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE;YACjB,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;gBAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;YACnC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAgD,CAAC;YACvG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,UAAU,YAAY,CAAC,GAAQ;QAClC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa;YAAE,OAAO,aAAa,CAAC;QACzC,IAAI,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAAE,OAAO,WAAW,CAAC;QAC3D,IAAI,CAAC;YACH,OAAO,MAAM,aAAa,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,aAAa,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,YAAY;QAEZ,KAAK,CAAC,GAAG,CAAC,KAAa,EAAE,GAAQ;YAC/B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;gBACtC,IAAI,KAAK,KAAK,WAAW;oBAAE,MAAM,IAAI,qBAAqB,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,6FAA6F;YAC7F,MAAM,aAAa,GAAG,GAAG,EAAG,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK;gBACrB,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,CAAC,CAAC,MAAM,aAAa,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,EAAE,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpK,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;oBACpC,kBAAkB,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC;oBAC5C,GAAG,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,2BAA2B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrF,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC9C,CAAC,CAAC;gBACH,IAAI,KAAK,GAAY,IAAI,CAAC;gBAC1B,IAAI,CAAC;oBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,iFAAiF;gBACnF,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;YAC9B,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,GAAQ,EAAE,cAA+B;YACrD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,KAAK,KAAK,aAAa;gBAAE,MAAM,IAAI,qBAAqB,CAAC,gDAAgD,CAAC,CAAC;YAC/G,MAAM,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACrC,CAAC;QAED,OAAO;YACL,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE;gBAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACxE,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,48 @@
 {
   "name": "@swissspidy/belay-web",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Belay local runners for browser built-in AI (Classifier API, Prompt API).",
+  "license": "Apache-2.0",
+  "author": "Pascal Birchler",
+  "homepage": "https://github.com/swissspidy/belay/tree/main/packages/web#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swissspidy/belay.git",
+    "directory": "packages/web"
+  },
+  "bugs": {
+    "url": "https://github.com/swissspidy/belay/issues"
+  },
+  "keywords": [
+    "ai",
+    "on-device",
+    "built-in-ai",
+    "classifier-api",
+    "prompt-api",
+    "chrome",
+    "gemini-nano",
+    "cascade"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "peerDependencies": {
+    "@swissspidy/belay-core": "^0.1.1"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "prepack": "tsc -b --force"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/classifier-types.ts

@@ -0,0 +1,75 @@
+/**
+ * Types for the proposed Classifier API (`window.Classifier`), as described in the explainer
+ * (https://github.com/michaelwasserman/classifier-api, the current revision of
+ * explainers-by-googlers/classifier-api) and implemented by Chrome behind `#classifier-api` and by
+ * the WebAI Studio extension polyfill (https://web-ai.studio/docs/classifier). The proposal is in
+ * flux: only the members Belay relies on are typed, and result fields are checked at runtime.
+ */
+
+import type { Availability } from '@swissspidy/belay-core';
+
+export type ClassifierQuestionType = 'binary' | 'categorical' | 'ordinal';
+
+export interface ClassifierOption {
+  label: string;
+  description?: string;
+}
+
+export interface ClassifierQuestion {
+  id: string;
+  type: ClassifierQuestionType;
+  prompt: string;
+  options?: ClassifierOption[];
+}
+
+export interface ClassifierExpectedInput {
+  type: 'text';
+  languages?: string[];
+}
+
+export interface ClassifierSchema {
+  context?: string;
+  questions: ClassifierQuestion[];
+  expectedInputs?: ClassifierExpectedInput[];
+}
+
+export interface ClassifierCreateOptions extends ClassifierSchema {
+  /** Same pattern as the other built-in AI APIs: `downloadprogress` events carry `loaded` in [0, 1]. */
+  monitor?: (monitor: EventTarget) => void;
+  signal?: AbortSignal;
+}
+
+export interface ClassifierClassifyOptions {
+  signal?: AbortSignal;
+  context?: string;
+}
+
+export interface ClassifierProbability {
+  label: string;
+  probability: number;
+}
+
+export interface ClassifierDecision {
+  id: string;
+  label: string;
+  /** Calibrated confidence in [0, 1]. */
+  confidence: number;
+  /** Binary questions only: calibrated P(true). */
+  probability?: number;
+  /** Ordinal questions only: E[S]. */
+  expectedScore?: number;
+  probabilities?: ClassifierProbability[];
+}
+
+/** Keyed by question `id`. */
+export type ClassifierResult = Record<string, ClassifierDecision>;
+
+export interface ClassifierInstance {
+  classify(input: string, options?: ClassifierClassifyOptions): Promise<ClassifierResult>;
+  destroy(): void;
+}
+
+export interface ClassifierStatic {
+  availability(options?: ClassifierSchema): Promise<Availability>;
+  create(options: ClassifierCreateOptions): Promise<ClassifierInstance>;
+}

package/src/classifier.ts

@@ -0,0 +1,229 @@
+import {
+  BelayError,
+  LocalUnavailableError,
+  clamp01,
+  normalizeOptions,
+  topProbability,
+} from '@swissspidy/belay-core';
+import type {
+  Availability,
+  BinarySchema,
+  CategoricalSchema,
+  LocalOutput,
+  LocalRunner,
+  OrdinalSchema,
+  PrepareOptions,
+  ProbabilityEntry,
+  RunnerContext,
+  TaskSchema,
+} from '@swissspidy/belay-core';
+import type {
+  ClassifierDecision,
+  ClassifierExpectedInput,
+  ClassifierInstance,
+  ClassifierSchema,
+  ClassifierStatic,
+} from './classifier-types.js';
+
+export type ClassifierTaskSchema = BinarySchema | CategoricalSchema | OrdinalSchema;
+
+export interface ClassifierApiOptions {
+  /**
+   * Which number becomes the task confidence:
+   * - `label-probability` (default): the calibrated probability of the returned label
+   *   (the top option). For binary questions this is max(P(true), P(false)).
+   * - `model`: the decision's own `confidence` field.
+   * See ADR 0001 for why the default is the probability.
+   */
+  confidence?: 'label-probability' | 'model';
+  /** Defaults to `[{ type: 'text', languages: ['en'] }]`. */
+  expectedInputs?: ClassifierExpectedInput[];
+  /** Question id used in the Classifier schema. Defaults to "answer". */
+  questionId?: string;
+  /**
+   * The `Classifier` implementation. Defaults to `globalThis.Classifier` (Chrome's built-in API or
+   * the WebAI Studio extension polyfill). Injectable for tests and custom polyfills.
+   */
+  classifier?: ClassifierStatic;
+  /** Max number of cached sessions (one per distinct context). Defaults to 4. */
+  maxSessions?: number;
+}
+
+type Ctx = RunnerContext<TaskSchema>;
+
+const DEFAULT_PROMPTS = {
+  categorical: 'Which option best describes the input?',
+  ordinal: 'Which level best describes the input?',
+} as const;
+
+/** Maps a Belay schema to a Classifier API schema with a single question. */
+export function toClassifierSchema(
+  schema: TaskSchema,
+  options: { questionId?: string; context?: string; expectedInputs?: ClassifierExpectedInput[] } = {},
+): ClassifierSchema {
+  const id = options.questionId ?? 'answer';
+  const base = {
+    ...(options.context ? { context: options.context } : {}),
+    expectedInputs: options.expectedInputs ?? [{ type: 'text' as const, languages: ['en'] }],
+  };
+  switch (schema.type) {
+    case 'binary':
+      return { ...base, questions: [{ id, type: 'binary', prompt: schema.prompt }] };
+    case 'categorical':
+    case 'ordinal':
+      return {
+        ...base,
+        questions: [
+          {
+            id,
+            type: schema.type,
+            prompt: schema.prompt ?? DEFAULT_PROMPTS[schema.type],
+            options: normalizeOptions(schema.options),
+          },
+        ],
+      };
+    default:
+      throw new BelayError(
+        'invalid-task',
+        `the Classifier API runner supports binary, categorical and ordinal tasks, not "${schema.type}"`,
+      );
+  }
+}
+
+/** Extracts value, confidence and distribution from a Classifier decision. */
+export function readDecision(
+  schema: ClassifierTaskSchema,
+  decision: ClassifierDecision | undefined,
+  mode: 'label-probability' | 'model' = 'label-probability',
+): LocalOutput<string | boolean> {
+  if (!decision || typeof decision !== 'object') {
+    throw new Error('Classifier result is missing the decision');
+  }
+
+  let probabilities: ProbabilityEntry[] | undefined = Array.isArray(decision.probabilities)
+    ? decision.probabilities.filter((p) => typeof p?.label === 'string' && typeof p.probability === 'number')
+    : undefined;
+  if (schema.type === 'binary' && typeof decision.probability === 'number') {
+    const pTrue = clamp01(decision.probability);
+    probabilities = [
+      { label: 'true', probability: pTrue },
+      { label: 'false', probability: 1 - pTrue },
+    ];
+  }
+
+  let label = typeof decision.label === 'string' ? decision.label : undefined;
+  if (label === undefined && probabilities?.length) {
+    label = probabilities.reduce((a, b) => (b.probability > a.probability ? b : a)).label;
+  }
+  if (label === undefined) throw new Error('Classifier decision has no label');
+
+  let confidence: number | undefined;
+  if (mode === 'label-probability' && probabilities?.length) {
+    const own = probabilities.find((p) => p.label === label);
+    confidence = own ? clamp01(own.probability) : topProbability(probabilities);
+  }
+  if (confidence === undefined && typeof decision.confidence === 'number') confidence = clamp01(decision.confidence);
+  if (confidence === undefined) throw new Error('Classifier decision has neither probabilities nor confidence');
+
+  const value = schema.type === 'binary' ? label.trim().toLowerCase() === 'true' : label;
+  return { value, confidence, ...(probabilities ? { probabilities } : {}), raw: decision };
+}
+
+/**
+ * Local runner backed by the Classifier API. It never triggers a model download from `run()`:
+ * while the model is "downloadable" or "downloading" the task escalates with reason
+ * `local-unavailable`. Call `task.prepare()` from a user gesture to download the model.
+ */
+export function classifierApi(options: ClassifierApiOptions = {}): LocalRunner<any> {
+  const mode = options.confidence ?? 'label-probability';
+  const maxSessions = Math.max(1, options.maxSessions ?? 4);
+  const sessions = new Map<string, Promise<ClassifierInstance>>();
+
+  const api = (): ClassifierStatic | undefined =>
+    options.classifier ?? (globalThis as { Classifier?: ClassifierStatic }).Classifier;
+
+  const schemaFor = (ctx: Ctx): ClassifierSchema =>
+    toClassifierSchema(ctx.schema, {
+      ...(options.questionId ? { questionId: options.questionId } : {}),
+      ...(ctx.context ? { context: ctx.context } : {}),
+      ...(options.expectedInputs ? { expectedInputs: options.expectedInputs } : {}),
+    });
+
+  const keyFor = (schema: ClassifierSchema): string => JSON.stringify(schema);
+
+  function session(ctx: Ctx, prepare?: PrepareOptions): Promise<ClassifierInstance> {
+    const Classifier = api();
+    if (!Classifier) return Promise.reject(new LocalUnavailableError('Classifier API is not available'));
+    const schema = schemaFor(ctx);
+    const key = keyFor(schema);
+    const cached = sessions.get(key);
+    if (cached) {
+      sessions.delete(key); // refresh LRU position
+      sessions.set(key, cached);
+      return cached;
+    }
+    // Only prepare()'s signal: the session is cached and shared, so a per-run abort must not destroy it.
+    const signal = prepare?.signal;
+    const created = Classifier.create({
+      ...schema,
+      ...(signal ? { signal } : {}),
+      ...(prepare?.onProgress
+        ? {
+            monitor: (m: EventTarget) =>
+              m.addEventListener('downloadprogress', (e) => prepare.onProgress!((e as Event & { loaded: number }).loaded)),
+          }
+        : {}),
+    });
+    sessions.set(key, created);
+    created.catch(() => {
+      if (sessions.get(key) === created) sessions.delete(key);
+    });
+    while (sessions.size > maxSessions) {
+      const [oldestKey, oldest] = sessions.entries().next().value as [string, Promise<ClassifierInstance>];
+      sessions.delete(oldestKey);
+      oldest.then((s) => s.destroy(), () => {});
+    }
+    return created;
+  }
+
+  async function availability(ctx: Ctx): Promise<Availability> {
+    const Classifier = api();
+    if (!Classifier) return 'unavailable';
+    const schema = schemaFor(ctx); // throws for unsupported schemas
+    if (sessions.has(keyFor(schema))) return 'available';
+    try {
+      return await Classifier.availability(schema);
+    } catch {
+      return 'unavailable';
+    }
+  }
+
+  return {
+    id: 'classifier-api',
+    availability,
+
+    async run(input: string, ctx: Ctx) {
+      const schema = schemaFor(ctx);
+      if (!sessions.has(keyFor(schema))) {
+        // Creating a session while the model is not downloaded would start a download.
+        const state = await availability(ctx);
+        if (state !== 'available') throw new LocalUnavailableError(`Classifier model is ${state}`);
+      }
+      const classifier = await session(ctx);
+      const result = await classifier.classify(input, ctx.signal ? { signal: ctx.signal } : {});
+      const questionId = schema.questions[0]!.id;
+      return readDecision(ctx.schema as ClassifierTaskSchema, result?.[questionId], mode);
+    },
+
+    async prepare(ctx: Ctx, prepareOptions?: PrepareOptions) {
+      const state = await availability(ctx);
+      if (state === 'unavailable') throw new LocalUnavailableError('Classifier model is unavailable on this device');
+      await session(ctx, prepareOptions);
+    },
+
+    destroy() {
+      for (const s of sessions.values()) s.then((c) => c.destroy(), () => {});
+      sessions.clear();
+    },
+  };
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+export { classifierApi, readDecision, toClassifierSchema } from './classifier.js';
+export type { ClassifierApiOptions, ClassifierTaskSchema } from './classifier.js';
+export { promptApi } from './prompt.js';
+export type { PromptApiOptions } from './prompt.js';
+export { classifierJudge, DEFAULT_JUDGE_QUESTION } from './judge.js';
+export type { ClassifierJudgeOptions } from './judge.js';
+export type * from './classifier-types.js';
+export type * from './prompt-types.js';

package/src/judge.ts

@@ -0,0 +1,60 @@
+import type { Judge, PrepareOptions, RunnerContext } from '@swissspidy/belay-core';
+import { classifierApi } from './classifier.js';
+import type { ClassifierExpectedInput, ClassifierStatic } from './classifier-types.js';
+
+export interface ClassifierJudgeOptions {
+  /** The yes/no question the Classifier answers about the (input, output) pair. */
+  question?: string;
+  /** Shared context for the judge, e.g. what a good answer looks like for this task. */
+  context?: string;
+  /** Serializes the pair for the Classifier. Defaults to "Input: … / Proposed answer: …". */
+  format?: (input: string, value: unknown) => string;
+  /** Truncation limits, because on-device classifiers have small windows (e.g. 256 tokens). */
+  maxInputChars?: number;
+  maxValueChars?: number;
+  classifier?: ClassifierStatic;
+  expectedInputs?: ClassifierExpectedInput[];
+}
+
+export const DEFAULT_JUDGE_QUESTION =
+  'Is the proposed answer a correct and complete response to the input, with no invented facts?';
+
+const truncate = (s: string, max: number) => (s.length > max ? `${s.slice(0, max - 1)}…` : s);
+
+/**
+ * A judge for generation tasks built on the Classifier API: one binary question over the input and
+ * the generated output. Its calibrated P(true) becomes the confidence (combined with schema
+ * validation by the task; see ADR 0001). Costs one classifier forward pass, not a second LLM call.
+ */
+export function classifierJudge(options: ClassifierJudgeOptions = {}): Judge<unknown> {
+  const runner = classifierApi({
+    ...(options.classifier ? { classifier: options.classifier } : {}),
+    ...(options.expectedInputs ? { expectedInputs: options.expectedInputs } : {}),
+    questionId: 'judgement',
+  });
+  const schema = { type: 'binary' as const, prompt: options.question ?? DEFAULT_JUDGE_QUESTION };
+  const maxInput = options.maxInputChars ?? 600;
+  const maxValue = options.maxValueChars ?? 400;
+  const format =
+    options.format ??
+    ((input: string, value: unknown) =>
+      `Input:\n${truncate(input, maxInput)}\n\nProposed answer:\n${truncate(typeof value === 'string' ? value : JSON.stringify(value), maxValue)}`);
+  const ctx = (signal?: AbortSignal): RunnerContext<typeof schema> => ({
+    task: 'belay-judge',
+    schema,
+    ...(options.context ? { context: options.context } : {}),
+    ...(signal ? { signal } : {}),
+  });
+
+  const judge = (async ({ input, value, signal }) => {
+    const out = await runner.run(format(input, value), ctx(signal));
+    const pTrue = out.probabilities?.find((p) => p.label === 'true')?.probability;
+    if (typeof pTrue === 'number') return pTrue;
+    // Fall back to the returned label's probability.
+    return out.value === true ? out.confidence! : 1 - out.confidence!;
+  }) as Judge<unknown>;
+  judge.availability = () => runner.availability(ctx());
+  judge.prepare = (prepareOptions?: PrepareOptions) => runner.prepare!(ctx(), prepareOptions);
+  judge.destroy = () => runner.destroy?.();
+  return judge;
+}