Scribe writing companion + Parakeet STT (core seams + engine)

.github/workflows/release.yml

@@ -129,6 +129,15 @@ jobs:
           mkdir -p resources/bin
           cp scripts/dictation-hotkey/dictation-hotkey resources/bin/dictation-hotkey
           chmod +x resources/bin/dictation-hotkey
+      # Stage the Parakeet STT runtime (sherpa-onnx CLI + ONNX model) into
+      # resources/bin/parakeet. Additive: with SHERPA_ONNX_URL / PARAKEET_MODEL_URL
+      # unset this is a no-op and transcription stays on whisper, so it can't break a
+      # release. Set those vars once the exact sherpa-onnx build + Parakeet export are pinned.
+      - name: Stage Parakeet STT runtime (optional)
+        env:
+          SHERPA_ONNX_URL: ${{ vars.SHERPA_ONNX_URL }}
+          PARAKEET_MODEL_URL: ${{ vars.PARAKEET_MODEL_URL }}
+        run: bash scripts/fetch-parakeet.sh
       # Private pro source into pro/ → __OFFGRID_PRO__ true. The checkout action
       # injects the token as an http.extraheader (never in a clone URL) and scrubs
       # it afterwards — safer than embedding ${TOKEN} in a git URL.

.gitignore

@@ -26,6 +26,9 @@ electron/accessibility/ocr
 # them. Only the heavy optional runtimes we don't ship are excluded.
 resources/bin/coreml-sd/
 resources/bin/mflux/
+# Parakeet STT runtime — CI-staged via scripts/fetch-parakeet.sh (like mflux/coreml-sd),
+# not committed. Devs stage it locally with the same script.
+resources/bin/parakeet/
 # Gateway probe scratch output
 .gateway-probe/
 # TS build cache
@@ -50,3 +53,6 @@ scripts/dictation-hotkey/dictation-hotkey
 
 # Local demo profile — synthetic-data run target for `npm run demo` (never real userData)
 .demo-profile/
+
+# local PR-campaign target list (not for commit)
+pr-targets.local.md

packages/models/dist/adapters/node.d.mts

@@ -1,6 +1,5 @@
-import { D as DownloadBridge } from '../types-C3JiELTS.mjs';
-
-declare class NodeDownloadBridge implements DownloadBridge {
+import type { DownloadBridge } from '../types';
+export declare class NodeDownloadBridge implements DownloadBridge {
     private readonly modelsDir;
     constructor(modelsDir: string);
     pathFor(fileName: string): string;
@@ -10,5 +9,3 @@ declare class NodeDownloadBridge implements DownloadBridge {
         signal?: AbortSignal;
     }): Promise<number>;
 }
-
-export { NodeDownloadBridge };

packages/models/dist/adapters/node.d.ts

@@ -1,6 +1,5 @@
-import { D as DownloadBridge } from '../types-C3JiELTS.js';
-
-declare class NodeDownloadBridge implements DownloadBridge {
+import type { DownloadBridge } from '../types';
+export declare class NodeDownloadBridge implements DownloadBridge {
     private readonly modelsDir;
     constructor(modelsDir: string);
     pathFor(fileName: string): string;
@@ -10,5 +9,3 @@ declare class NodeDownloadBridge implements DownloadBridge {
         signal?: AbortSignal;
     }): Promise<number>;
 }
-
-export { NodeDownloadBridge };

packages/models/dist/adapters/node.js

@@ -39,7 +39,6 @@ var NodeDownloadBridge = class {
     this.modelsDir = modelsDir;
     import_fs.default.mkdirSync(modelsDir, { recursive: true });
   }
-  modelsDir;
   pathFor(fileName) {
     return import_path.default.join(this.modelsDir, fileName);
   }
@@ -52,7 +51,6 @@ var NodeDownloadBridge = class {
     }
   }
   async download(url, destPath, opts) {
-    var _a;
     const tmp = `${destPath}.part`;
     let start = 0;
     try {
@@ -78,7 +76,7 @@ var NodeDownloadBridge = class {
         if (done) break;
         out.write(Buffer.from(value));
         written += value.length;
-        (_a = opts.onProgress) == null ? void 0 : _a.call(opts, written, total || written);
+        opts.onProgress?.(written, total || written);
       }
     } finally {
       out.end();

packages/models/dist/adapters/node.mjs

@@ -6,7 +6,6 @@ var NodeDownloadBridge = class {
     this.modelsDir = modelsDir;
     fs.mkdirSync(modelsDir, { recursive: true });
   }
-  modelsDir;
   pathFor(fileName) {
     return path.join(this.modelsDir, fileName);
   }
@@ -19,7 +18,6 @@ var NodeDownloadBridge = class {
     }
   }
   async download(url, destPath, opts) {
-    var _a;
     const tmp = `${destPath}.part`;
     let start = 0;
     try {
@@ -45,7 +43,7 @@ var NodeDownloadBridge = class {
         if (done) break;
         out.write(Buffer.from(value));
         written += value.length;
-        (_a = opts.onProgress) == null ? void 0 : _a.call(opts, written, total || written);
+        opts.onProgress?.(written, total || written);
       }
     } finally {
       out.end();

packages/models/dist/catalog.d.mts

@@ -0,0 +1,6 @@
+import type { ModelEntry, ModelKind, ModelRecommendationTier } from './types';
+export declare const RECOMMENDATION_TIERS: ModelRecommendationTier[];
+export declare function recommendForRam(ramGb: number): ModelRecommendationTier;
+export declare const CATALOG: ModelEntry[];
+export declare function modelsByKind(kind: ModelKind): ModelEntry[];
+export declare const MODEL_KINDS: ModelKind[];

packages/models/dist/catalog.d.ts

@@ -0,0 +1,6 @@
+import type { ModelEntry, ModelKind, ModelRecommendationTier } from './types';
+export declare const RECOMMENDATION_TIERS: ModelRecommendationTier[];
+export declare function recommendForRam(ramGb: number): ModelRecommendationTier;
+export declare const CATALOG: ModelEntry[];
+export declare function modelsByKind(kind: ModelKind): ModelEntry[];
+export declare const MODEL_KINDS: ModelKind[];

packages/models/dist/credibility.d.mts

@@ -0,0 +1,11 @@
+export type Credibility = 'offgrid' | 'official' | 'verified-quantizer' | 'community';
+export declare const OFFGRID_AUTHORS: string[];
+export declare const OFFICIAL_MODEL_AUTHORS: Record<string, string>;
+export declare const VERIFIED_QUANTIZERS: Record<string, string>;
+export declare const CREDIBILITY_LABELS: Record<Credibility, {
+    label: string;
+    description: string;
+    color: string;
+}>;
+/** Classify a HF author into a credibility tier. */
+export declare function determineCredibility(author: string): Credibility;

packages/models/dist/credibility.d.ts

@@ -0,0 +1,11 @@
+export type Credibility = 'offgrid' | 'official' | 'verified-quantizer' | 'community';
+export declare const OFFGRID_AUTHORS: string[];
+export declare const OFFICIAL_MODEL_AUTHORS: Record<string, string>;
+export declare const VERIFIED_QUANTIZERS: Record<string, string>;
+export declare const CREDIBILITY_LABELS: Record<Credibility, {
+    label: string;
+    description: string;
+    color: string;
+}>;
+/** Classify a HF author into a credibility tier. */
+export declare function determineCredibility(author: string): Credibility;

packages/models/dist/download.d.mts

@@ -0,0 +1,13 @@
+import type { DownloadBridge, DownloadProgress, ModelEntry, ModelStore } from './types';
+export declare class ModelDownloader {
+    private readonly bridge;
+    private readonly store;
+    private aborts;
+    private listeners;
+    constructor(bridge: DownloadBridge, store: ModelStore);
+    onProgress(cb: (p: DownloadProgress) => void): () => void;
+    isInstalled(modelId: string): boolean;
+    cancel(modelId: string): void;
+    private emit;
+    download(entry: ModelEntry): Promise<boolean>;
+}

packages/models/dist/download.d.ts

@@ -0,0 +1,13 @@
+import type { DownloadBridge, DownloadProgress, ModelEntry, ModelStore } from './types';
+export declare class ModelDownloader {
+    private readonly bridge;
+    private readonly store;
+    private aborts;
+    private listeners;
+    constructor(bridge: DownloadBridge, store: ModelStore);
+    onProgress(cb: (p: DownloadProgress) => void): () => void;
+    isInstalled(modelId: string): boolean;
+    cancel(modelId: string): void;
+    private emit;
+    download(entry: ModelEntry): Promise<boolean>;
+}

packages/models/dist/filters.d.mts

@@ -0,0 +1,106 @@
+import type { Credibility } from './credibility';
+export type ModelTypeFilter = 'all' | 'text' | 'vision' | 'code' | 'image-gen';
+export type CredibilityFilter = 'all' | Credibility;
+export type SizeFilter = 'all' | 'tiny' | 'small' | 'medium' | 'large';
+export type SortOption = 'recommended' | 'bestfit' | 'size' | 'downloads' | 'recency';
+export interface FilterState {
+    orgs: string[];
+    type: ModelTypeFilter;
+    source: CredibilityFilter;
+    size: SizeFilter;
+    quant: string;
+    sort: SortOption;
+}
+export declare const initialFilterState: FilterState;
+/** Normalized model the filters/sorts operate on (map HF results into this). */
+export interface FilterableModel {
+    id: string;
+    name: string;
+    org: string;
+    credibility?: Credibility;
+    params?: number | null;
+    tags?: string[];
+    downloads?: number;
+    likes?: number;
+    lastModified?: string;
+    minRamGb?: number;
+    files?: {
+        sizeBytes?: number;
+        quant?: string;
+    }[];
+}
+export declare const SIZE_OPTIONS: readonly [{
+    readonly key: "tiny";
+    readonly label: "Tiny (<2B)";
+    readonly min: 0;
+    readonly max: 2;
+}, {
+    readonly key: "small";
+    readonly label: "Small (2-5B)";
+    readonly min: 2;
+    readonly max: 5;
+}, {
+    readonly key: "medium";
+    readonly label: "Medium (5-15B)";
+    readonly min: 5;
+    readonly max: 15;
+}, {
+    readonly key: "large";
+    readonly label: "Large (15B+)";
+    readonly min: 15;
+    readonly max: number;
+}];
+export declare const MODEL_TYPE_OPTIONS: readonly [{
+    readonly key: "text";
+    readonly label: "Text";
+}, {
+    readonly key: "vision";
+    readonly label: "Vision";
+}, {
+    readonly key: "code";
+    readonly label: "Code";
+}, {
+    readonly key: "image-gen";
+    readonly label: "Image";
+}];
+export declare const CREDIBILITY_OPTIONS: readonly [{
+    readonly key: "offgrid";
+    readonly label: "Off Grid";
+}, {
+    readonly key: "official";
+    readonly label: "Official";
+}, {
+    readonly key: "verified-quantizer";
+    readonly label: "Verified";
+}, {
+    readonly key: "community";
+    readonly label: "Community";
+}];
+export declare const SORT_OPTIONS: readonly [{
+    readonly key: "recommended";
+    readonly label: "Recommended";
+}, {
+    readonly key: "bestfit";
+    readonly label: "Best fit";
+}, {
+    readonly key: "downloads";
+    readonly label: "Downloads";
+}, {
+    readonly key: "size";
+    readonly label: "Size";
+}, {
+    readonly key: "recency";
+    readonly label: "Recent";
+}];
+/** Parse a billions-of-parameters count from a model name/id, in billions
+ *  ("Qwen3.5-2B" -> 2, "SmolVLM2-500M" -> 0.5). Returns null if none found. */
+export declare function parseParamCount(nameOrId: string): number | null;
+/** Detect a model's type from its name + tags. */
+export declare function getModelType(name: string, tags?: string[]): ModelTypeFilter;
+/** Lower is better. Ideal model uses ~40% of RAM; penalize >75% (too slow). */
+export declare function bestFitScore(m: FilterableModel, ramGb: number): number;
+export declare function hasActiveFilters(state: FilterState): boolean;
+export declare function applyFilters<T extends FilterableModel>(models: T[], state: FilterState): T[];
+export declare function applySort<T extends FilterableModel>(models: T[], sort: SortOption, ramGb?: number): T[];
+/** Apply filters then sort in one pass. */
+export declare function filterAndSort<T extends FilterableModel>(models: T[], state: FilterState, ramGb?: number): T[];

packages/models/dist/filters.d.ts

@@ -0,0 +1,106 @@
+import type { Credibility } from './credibility';
+export type ModelTypeFilter = 'all' | 'text' | 'vision' | 'code' | 'image-gen';
+export type CredibilityFilter = 'all' | Credibility;
+export type SizeFilter = 'all' | 'tiny' | 'small' | 'medium' | 'large';
+export type SortOption = 'recommended' | 'bestfit' | 'size' | 'downloads' | 'recency';
+export interface FilterState {
+    orgs: string[];
+    type: ModelTypeFilter;
+    source: CredibilityFilter;
+    size: SizeFilter;
+    quant: string;
+    sort: SortOption;
+}
+export declare const initialFilterState: FilterState;
+/** Normalized model the filters/sorts operate on (map HF results into this). */
+export interface FilterableModel {
+    id: string;
+    name: string;
+    org: string;
+    credibility?: Credibility;
+    params?: number | null;
+    tags?: string[];
+    downloads?: number;
+    likes?: number;
+    lastModified?: string;
+    minRamGb?: number;
+    files?: {
+        sizeBytes?: number;
+        quant?: string;
+    }[];
+}
+export declare const SIZE_OPTIONS: readonly [{
+    readonly key: "tiny";
+    readonly label: "Tiny (<2B)";
+    readonly min: 0;
+    readonly max: 2;
+}, {
+    readonly key: "small";
+    readonly label: "Small (2-5B)";
+    readonly min: 2;
+    readonly max: 5;
+}, {
+    readonly key: "medium";
+    readonly label: "Medium (5-15B)";
+    readonly min: 5;
+    readonly max: 15;
+}, {
+    readonly key: "large";
+    readonly label: "Large (15B+)";
+    readonly min: 15;
+    readonly max: number;
+}];
+export declare const MODEL_TYPE_OPTIONS: readonly [{
+    readonly key: "text";
+    readonly label: "Text";
+}, {
+    readonly key: "vision";
+    readonly label: "Vision";
+}, {
+    readonly key: "code";
+    readonly label: "Code";
+}, {
+    readonly key: "image-gen";
+    readonly label: "Image";
+}];
+export declare const CREDIBILITY_OPTIONS: readonly [{
+    readonly key: "offgrid";
+    readonly label: "Off Grid";
+}, {
+    readonly key: "official";
+    readonly label: "Official";
+}, {
+    readonly key: "verified-quantizer";
+    readonly label: "Verified";
+}, {
+    readonly key: "community";
+    readonly label: "Community";
+}];
+export declare const SORT_OPTIONS: readonly [{
+    readonly key: "recommended";
+    readonly label: "Recommended";
+}, {
+    readonly key: "bestfit";
+    readonly label: "Best fit";
+}, {
+    readonly key: "downloads";
+    readonly label: "Downloads";
+}, {
+    readonly key: "size";
+    readonly label: "Size";
+}, {
+    readonly key: "recency";
+    readonly label: "Recent";
+}];
+/** Parse a billions-of-parameters count from a model name/id, in billions
+ *  ("Qwen3.5-2B" -> 2, "SmolVLM2-500M" -> 0.5). Returns null if none found. */
+export declare function parseParamCount(nameOrId: string): number | null;
+/** Detect a model's type from its name + tags. */
+export declare function getModelType(name: string, tags?: string[]): ModelTypeFilter;
+/** Lower is better. Ideal model uses ~40% of RAM; penalize >75% (too slow). */
+export declare function bestFitScore(m: FilterableModel, ramGb: number): number;
+export declare function hasActiveFilters(state: FilterState): boolean;
+export declare function applyFilters<T extends FilterableModel>(models: T[], state: FilterState): T[];
+export declare function applySort<T extends FilterableModel>(models: T[], sort: SortOption, ramGb?: number): T[];
+/** Apply filters then sort in one pass. */
+export declare function filterAndSort<T extends FilterableModel>(models: T[], state: FilterState, ramGb?: number): T[];