@project-ava-supernova/core 0.2.71

package/dist/recipes/index.js

@@ -0,0 +1,232 @@
+// ─── Pantry — recipe types, the store contract, and the shopping-list check ──
+//
+// The recipe desk's central lie is the recipe that reads perfectly and cannot
+// be cooked: a method that names garlic the shopping list never mentioned, so
+// the reader only finds out at the hob. As in the newsroom, the guarantee is
+// ENFORCED IN CODE, not requested in a prompt — write_recipe refuses a version
+// whose method names something its ingredients do not have, the way
+// write_article refuses an unevidenced quote.
+//
+// The split, mirroring news/index.ts:
+//   · The deterministic comparison (findPhantomIngredients) lives HERE, pure,
+//     with no model or network dependency — the recipe equivalent of
+//     verifyQuote.
+//   · The model work (reading a method to list what it names) and persistence
+//     (writing to the database) are the SURFACE's job, injected as a
+//     RecipeStore, because that is where the provider and the schema live.
+// ─── The shopping-list check (pure) ──────────────────────────────────────────
+//
+// Given the ingredients a method NAMES (extracted by the host's model) and the
+// ingredients the cook was told to BUY, which named items are missing? This is
+// the deterministic heart, kept free of model or network so it is testable and
+// identical wherever it runs.
+/** Preparation and form words — they qualify a food, they are not one. */
+const MODIFIERS = new Set([
+    'fresh', 'dried', 'ground', 'whole', 'large', 'small', 'medium', 'chopped',
+    'sliced', 'minced', 'grated', 'finely', 'roughly', 'ripe', 'raw', 'cooked',
+    'unsalted', 'salted', 'plain', 'extra', 'virgin', 'light', 'dark', 'hot',
+    'cold', 'warm', 'boiling', 'chilled', 'room', 'temperature', 'good', 'quality',
+    'free', 'range', 'organic', 'toasted', 'roasted', 'smoked', 'frozen', 'canned',
+    'jarred', 'tinned', 'neutral', 'fine', 'coarse', 'thick', 'thin', 'mild',
+    'sweet', 'sour', 'bitter', 'strong', 'weak', 'best',
+    'leaf', 'leaves', 'clove', 'cloves', 'seed', 'seeds', 'pod', 'pods', 'stick',
+    'sticks', 'sprig', 'sprigs', 'piece', 'pieces', 'bunch', 'head', 'stalk',
+    'stalks', 'slice', 'slices', 'pinch', 'handful', 'knob', 'strip', 'strips',
+]);
+/** So common that naming one proves nothing — every kitchen has them. */
+const PANTRY_STAPLES = new Set([
+    'water', 'ice', 'salt', 'pepper', 'oil', 'sugar', 'flour', 'stock', 'broth',
+    'sauce', 'paste', 'juice', 'zest', 'powder', 'spice', 'herb', 'seasoning',
+    'garnish', 'dressing', 'batter', 'dough', 'mixture', 'liquid',
+]);
+/** Collective nouns — "toast the whole spices" refers to what's already listed. */
+const COLLECTIVE_NOUNS = new Set([
+    'spice', 'spices', 'herb', 'herbs', 'vegetable', 'vegetables', 'aromatic',
+    'aromatics', 'seasoning', 'seasonings', 'ingredient', 'ingredients',
+    'topping', 'toppings', 'filling', 'garnish', 'garnishes', 'marinade',
+    'mixture', 'remainder', 'rest', 'solids', 'liquids', 'greens', 'produce',
+    // Found by repairing 250 recipes: the gate kept demanding these be added to
+    // shopping lists, and every time it was asked for a quantity the answer was
+    // "that is not a thing you buy". A method saying "balance with acid" or
+    // "add the spice blend" is pointing at what is already listed.
+    'acid', 'acidity', 'fat', 'starch', 'starches', 'protein', 'proteins',
+    'seafood', 'shellfish', 'meat', 'meats', 'seasoning packet', 'spice blend',
+    'spice mix', 'spice paste', 'blend', 'nuts', 'pulses', 'legumes', 'grains',
+    'sweetener', 'thickener', 'condiment', 'condiments', 'accompaniment',
+    'accompaniments', 'leftovers', 'trimmings', 'scraps', 'base', 'components',
+    // "Rehydrated fungi" is the dried mushrooms already on the list, soaked.
+    // "Alliums" is the onion and garlic. "Joints" is the chicken. A method
+    // reaching for the general word is pointing at the particular ones.
+    'dairy', 'allium', 'alliums', 'joint', 'joints', 'fungi', 'fungus',
+    'coagulant', 'culture', 'starter', 'packet', 'sachet', 'cube',
+]);
+/** Composed sub-preparations — made in-recipe from listed components, not bought.
+ *  A béchamel is butter, flour and milk; a ragù is the meat and tomato already
+ *  listed. Accepts a small false-negative risk (a genuinely missing base sauce
+ *  won't flag) which is obvious to a cook anyway. */
+const COMPOSED_PREPARATIONS = new Set([
+    'bechamel', 'béchamel', 'roux', 'ragu', 'ragù', 'ragout', 'caramel', 'custard',
+    'ganache', 'praline', 'dough', 'batter', 'slurry', 'brine', 'stock', 'sauce',
+    'paste', 'marinade', 'dressing', 'glaze', 'reduction', 'sofrito', 'mirepoix',
+    'gremolata',
+    // Made DURING cooking, from things already bought. Aglio e olio failed its
+    // check for not listing "pasta water" — you cannot buy the water the pasta
+    // was boiled in, and a cook who needed telling would be lost long before.
+    'pasta water', 'cooking water', 'cooking liquid', 'poaching liquid',
+    'blanching water', 'starchy water', 'vinaigrette', 'emulsion', 'crumb',
+    'breadcrumb', 'breadcrumbs', 'zest', 'juice', 'puree', 'purée', 'coulis',
+    'stock cube', 'pan juices', 'drippings', 'fond', 'syrup', 'compote',
+]);
+/** Kit, not food. */
+const EQUIPMENT_WORDS = new Set([
+    'pan', 'pot', 'skillet', 'wok', 'saucepan', 'stockpot', 'casserole', 'dish',
+    'tray', 'sheet', 'rack', 'bowl', 'mortar', 'pestle', 'skewer', 'string',
+    'whisk', 'spoon', 'spatula', 'knife', 'board', 'grater', 'strainer', 'sieve',
+    'colander', 'ricer', 'blender', 'processor', 'mixer', 'thermometer', 'tin',
+    'mould', 'mold', 'paper', 'foil', 'cloth', 'towel', 'jar', 'lid', 'oven',
+    'griddle', 'steamer', 'basket', 'ladle', 'tongs', 'peeler', 'roller', 'pin',
+    // Kit a method names but nobody eats. Charcoal is for the dhungar smoking
+    // trick in a dal; pimento wood is what jerk is smoked over; a corn husk
+    // wraps a tamale and is thrown away.
+    'parchment', 'cheesecloth', 'muslin', 'twine', 'charcoal', 'wood', 'husk',
+    'husks', 'toothpick', 'skewers', 'weight', 'weights', 'wrap', 'film',
+]);
+const SYNONYMS = [
+    ['scallion', 'spring onion', 'green onion'],
+    ['coriander', 'cilantro'],
+    ['aubergine', 'eggplant'],
+    ['courgette', 'zucchini'],
+    ['chickpea', 'garbanzo'],
+    ['prawn', 'shrimp'],
+    ['beetroot', 'beet'],
+    ['rocket', 'arugula'],
+    ['cornflour', 'cornstarch'],
+    // Common name vs the formal/DOP name a list often uses (parmesan vs the
+    // listed "Parmigiano-Reggiano"). Head token only — phrases split on
+    // spaces/hyphens before folding.
+    ['parmesan', 'parmigiano'],
+    // Single words only. synGroup indexes each entry verbatim and contentWords
+    // looks up word by word, so a multi-word entry like 'spring onion' can only
+    // ever match through its single-word siblings.
+    ['lentil', 'dal', 'dhal', 'daal'],
+    // Ghee IS clarified butter — a recipe that lists butter and then says ghee
+    // is not missing anything.
+    ['ghee', 'butter'],
+    // beyaz peynir, queso, fromage: the word for cheese in the cuisine's own
+    // language, against a list that wrote it in English.
+    ['peynir', 'cheese', 'queso'],
+];
+const synGroup = new Map();
+SYNONYMS.forEach((grp, i) => grp.forEach((w) => synGroup.set(w, i)));
+function stem(w) {
+    if (w.endsWith('ies') && w.length > 4)
+        return `${w.slice(0, -3)}y`;
+    if (w.endsWith('ves') && w.length > 4)
+        return `${w.slice(0, -3)}f`;
+    if (w.endsWith('oes') && w.length > 4)
+        return w.slice(0, -2);
+    // Only after a sibilant, where English actually adds "es" (dishes→dish);
+    // elsewhere only the "s" is plural (chives→chive, NOT chiv).
+    if (w.endsWith('es') && w.length > 4 && /(s|x|z|ch|sh)es$/.test(w))
+        return w.slice(0, -2);
+    if (w.endsWith('s') && !w.endsWith('ss') && w.length > 3)
+        return w.slice(0, -1);
+    return w;
+}
+/** Fold accents to ASCII so "ragù"→"ragu", "béchamel"→"bechamel",
+ *  "jalapeño"→"jalapeno" — otherwise the [^a-z] strip below shreds an accented
+ *  letter into a word break and the term stops matching its own set entry. */
+const fold = (s) => s.normalize('NFD').replace(/[̀-ͯ]/g, '');
+/** Content words of a phrase IN ORDER: stemmed, synonym-folded, modifiers out. */
+function contentWords(phrase) {
+    return fold(phrase ?? '')
+        .toLowerCase()
+        .replace(/[^a-z\s-]/g, ' ')
+        .split(/[\s-]+/)
+        .filter((w) => w.length > 2 && !MODIFIERS.has(w))
+        .map((w) => {
+        const s = stem(w);
+        const g = synGroup.get(s);
+        return g === undefined ? s : `syn${g}`;
+    });
+}
+const headNoun = (item) => {
+    const words = fold(item).toLowerCase().replace(/[^a-z\s]/g, ' ').trim().split(/\s+/);
+    return words[words.length - 1] ?? '';
+};
+/** True when a named item is not really a bought ingredient — kit, a collective,
+ *  a composed preparation, or nothing distinctive once staples are stripped. */
+function isNonIngredient(item) {
+    // Test the WHOLE phrase as well as the head noun, and stem the head before
+    // looking it up. Neither was true before, and it quietly disabled a third of
+    // these lists: "pasta water" was checked as "water", "pan juices" as
+    // "juices" (never matching the entry "juice"), and every multi-word entry —
+    // "seasoning packet", "cooking liquid" — could not match anything at all.
+    // Adding more words to a list that is not consulted is not a fix.
+    const phrase = fold(item ?? '').toLowerCase().replace(/[^a-z\s]/g, ' ').trim().replace(/\s+/g, ' ');
+    const head = headNoun(item);
+    const inAnyList = (k) => !!k && (EQUIPMENT_WORDS.has(k) || COLLECTIVE_NOUNS.has(k) || COMPOSED_PREPARATIONS.has(k));
+    if (inAnyList(phrase) || inAnyList(head) || inAnyList(stem(head)))
+        return true;
+    const words = contentWords(item);
+    return words.length > 0 && words.every((w) => PANTRY_STAPLES.has(w));
+}
+/**
+ * The shopping-list check, pure.
+ *
+ * @param named       ingredients the method NAMES (the host's model extracted these)
+ * @param available   ingredients the cook was told to buy for this version
+ *                    (shared + this level's own)
+ * @param dishName    the dish's own name — a method refers to what it makes
+ *                    ("the salsa", "the bread"), which is not a missing ingredient
+ * @returns the named items that appear nowhere in `available`
+ */
+export function findPhantomIngredients(named, available, dishName = '') {
+    const covered = new Set();
+    for (const ing of available)
+        for (const w of contentWords(ing))
+            covered.add(w);
+    for (const w of contentWords(dishName))
+        covered.add(w);
+    const phantoms = [];
+    const seen = new Set();
+    for (const item of named) {
+        if (isNonIngredient(item))
+            continue;
+        const words = contentWords(item);
+        if (!words.length)
+            continue;
+        // Covered if ANY content word matches something bought — "lemon" is
+        // satisfied by "lemon juice", "cumin" by "ground cumin".
+        if (words.some((w) => covered.has(w)))
+            continue;
+        const sig = words.slice().sort().join('+');
+        if (seen.has(sig))
+            continue;
+        seen.add(sig);
+        phantoms.push(item);
+    }
+    return phantoms;
+}
+/**
+ * Run the shopping-list check across every version and assemble the verdict.
+ * The host has already extracted what each version's method names; this does
+ * the pure comparison and shapes the result.
+ */
+export function checkRecipeShoppingList(recipe, namedByLevel, now) {
+    const shared = recipe.ingredients.filter((i) => !i.level);
+    const findings = [];
+    for (const level of Object.keys(namedByLevel)) {
+        const named = namedByLevel[level] ?? [];
+        const available = [...shared, ...recipe.ingredients.filter((i) => i.level === level)].map((i) => i.name);
+        for (const term of findPhantomIngredients(named, available, recipe.name)) {
+            findings.push({
+                level,
+                term,
+                message: `The ${level} method uses "${term}" but it is not in the ingredients for that version.`,
+            });
+        }
+    }
+    return { status: findings.length ? 'fail' : 'pass', checked_at: now, findings };
+}
+//# sourceMappingURL=index.js.map

package/dist/recipes/index.js.map

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

package/dist/remote/client.d.ts

@@ -0,0 +1,67 @@
+import type { RemoteMessage, RemoteMessageType, ApprovalRequest, ApprovalResponse } from './schema.js';
+export interface ChannelTransport {
+    /** Send a message to all channel subscribers. */
+    broadcast(message: RemoteMessage): Promise<void>;
+    /** Subscribe to incoming messages; returns an unsubscribe function. */
+    subscribe(handler: (message: RemoteMessage) => void): () => void;
+    /** Current connection status — used for reconnect decisions. */
+    isConnected(): boolean;
+}
+export interface RemoteClientOptions {
+    transport: ChannelTransport;
+    /** Our surface — determines which message types we send */
+    surface: 'desktop' | 'companion';
+    /** Stable session identifier (for desktop) or device fingerprint (companion) */
+    identity: string;
+    /** Called when a message we didn't originate arrives */
+    onMessage?: (message: RemoteMessage) => void;
+    /** Called if the session times out (no heartbeat for SESSION_TIMEOUT_MS) */
+    onSessionTimeout?: () => void;
+}
+export declare class RemoteClient {
+    private transport;
+    private surface;
+    private identity;
+    private onMessage;
+    private onSessionTimeout;
+    private heartbeatTimer;
+    private sessionTimeoutTimer;
+    private pendingApprovals;
+    private unsubscribe;
+    private queuedOutbox;
+    constructor(opts: RemoteClientOptions);
+    /** Start listening + (if desktop) sending heartbeats. */
+    start(): void;
+    /** Stop listening, cancel all timers, reject pending approvals. */
+    stop(): void;
+    /**
+     * Send a message. If the transport is disconnected, the message queues
+     * and flushes on reconnect — unless the queue grows beyond 50 messages,
+     * at which point older ones drop (trajectory streaming is lossy by
+     * design; important messages like approvals retry separately).
+     */
+    send(message: RemoteMessage): Promise<void>;
+    /**
+     * Send an approval request and wait for the driver's response.
+     * Times out after APPROVAL_FALLBACK_TIMEOUT_MS — caller handles the
+     * fallback (route to desktop user locally).
+     */
+    requestApproval(request: Omit<ApprovalRequest, 'type' | 'from' | 'ts' | 'nonce' | 'timeoutMs'>): Promise<ApprovalResponse>;
+    /** Respond to an approval request (companion surface only, usually). */
+    respondToApproval(nonce: string, approved: boolean, reason?: string, editedParams?: Record<string, unknown>): Promise<void>;
+    private handleIncoming;
+    private startHeartbeat;
+    private armSessionTimeout;
+    private flushOutbox;
+}
+export declare function makeMessage<T extends RemoteMessage>(partial: Omit<T, 'ts'> & {
+    ts?: string;
+}): T;
+/** Type-narrowing dispatcher — pass an incoming RemoteMessage and one handler per type you care about. */
+export type MessageHandlers = Partial<{
+    [K in RemoteMessageType]: (msg: Extract<RemoteMessage, {
+        type: K;
+    }>) => void | Promise<void>;
+}>;
+export declare function dispatch(msg: RemoteMessage, handlers: MessageHandlers): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/remote/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/remote/client.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAWrB,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,uEAAuE;IACvE,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACjE,gEAAgE;IAChE,WAAW,IAAI,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,2DAA2D;IAC3D,OAAO,EAAE,SAAS,GAAG,WAAW,CAAC;IACjC,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;IAC7C,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAaD,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,gBAAgB,CAAa;IAErC,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,mBAAmB,CAA8C;IACzE,OAAO,CAAC,gBAAgB,CAAsC;IAC9D,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,YAAY,CAAuB;gBAE/B,IAAI,EAAE,mBAAmB;IAQrC,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAWb,mEAAmE;IACnE,IAAI,IAAI,IAAI;IAWZ;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBjD;;;;OAIG;IACG,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BhI,wEAAwE;IAClE,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAejI,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,WAAW;CAQpB;AAMD,wBAAgB,WAAW,CAAC,CAAC,SAAS,aAAa,EACjD,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,CAAC,CAEH;AAED,0GAA0G;AAC1G,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC;KACnC,CAAC,IAAI,iBAAiB,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,aAAa,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAC7F,CAAC,CAAC;AAEH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3F"}

package/dist/remote/client.js

@@ -0,0 +1,202 @@
+// ─── C5: Remote Protocol Client ───────────────────────────────────────────
+//
+// Runtime protocol handler for the remote pairing channel. Sits on top of
+// the A2 schema (message types) and a transport-agnostic ChannelTransport
+// interface. Each surface (IDE, companion) provides its own transport
+// implementation backed by Supabase Realtime — keeping core dependency-free.
+//
+// Responsibilities:
+//   - Send/receive typed RemoteMessage values
+//   - Heartbeat timer (20s per spec)
+//   - Session timeout detection (60s no heartbeat → session ended)
+//   - Approval request correlation + timeout (15s fallback to desktop)
+//   - Reconnect queueing (short <30s replay, long >30s drop + notify)
+import { HEARTBEAT_INTERVAL_MS, SESSION_TIMEOUT_MS, APPROVAL_FALLBACK_TIMEOUT_MS, } from './schema.js';
+// ── Client ────────────────────────────────────────────────────────────────
+export class RemoteClient {
+    transport;
+    surface;
+    identity;
+    onMessage;
+    onSessionTimeout;
+    heartbeatTimer = null;
+    sessionTimeoutTimer = null;
+    pendingApprovals = new Map();
+    unsubscribe = null;
+    queuedOutbox = [];
+    constructor(opts) {
+        this.transport = opts.transport;
+        this.surface = opts.surface;
+        this.identity = opts.identity;
+        this.onMessage = opts.onMessage ?? (() => { });
+        this.onSessionTimeout = opts.onSessionTimeout ?? (() => { });
+    }
+    /** Start listening + (if desktop) sending heartbeats. */
+    start() {
+        this.unsubscribe = this.transport.subscribe((msg) => this.handleIncoming(msg));
+        if (this.surface === 'desktop') {
+            this.startHeartbeat();
+        }
+        else {
+            this.armSessionTimeout();
+        }
+        // Flush anything queued while disconnected
+        this.flushOutbox();
+    }
+    /** Stop listening, cancel all timers, reject pending approvals. */
+    stop() {
+        if (this.unsubscribe) {
+            this.unsubscribe();
+            this.unsubscribe = null;
+        }
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.sessionTimeoutTimer) {
+            clearTimeout(this.sessionTimeoutTimer);
+            this.sessionTimeoutTimer = null;
+        }
+        for (const pending of this.pendingApprovals.values()) {
+            clearTimeout(pending.timer);
+            pending.reject(new Error('Client stopped'));
+        }
+        this.pendingApprovals.clear();
+    }
+    /**
+     * Send a message. If the transport is disconnected, the message queues
+     * and flushes on reconnect — unless the queue grows beyond 50 messages,
+     * at which point older ones drop (trajectory streaming is lossy by
+     * design; important messages like approvals retry separately).
+     */
+    async send(message) {
+        if (!this.transport.isConnected()) {
+            this.queuedOutbox.push(message);
+            if (this.queuedOutbox.length > 50) {
+                this.queuedOutbox.shift();
+            }
+            return;
+        }
+        try {
+            await this.transport.broadcast(message);
+        }
+        catch (e) {
+            // If broadcast fails, queue for retry on next flush
+            this.queuedOutbox.push(message);
+            throw e;
+        }
+    }
+    /**
+     * Send an approval request and wait for the driver's response.
+     * Times out after APPROVAL_FALLBACK_TIMEOUT_MS — caller handles the
+     * fallback (route to desktop user locally).
+     */
+    async requestApproval(request) {
+        if (this.surface !== 'desktop') {
+            throw new Error('Only the desktop surface can initiate approval requests');
+        }
+        const nonce = crypto.randomUUID();
+        const full = {
+            type: 'approval.request',
+            from: 'desktop',
+            ts: new Date().toISOString(),
+            nonce,
+            timeoutMs: APPROVAL_FALLBACK_TIMEOUT_MS,
+            ...request,
+        };
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pendingApprovals.delete(nonce);
+                reject(new Error(`Approval timeout after ${APPROVAL_FALLBACK_TIMEOUT_MS}ms`));
+            }, APPROVAL_FALLBACK_TIMEOUT_MS);
+            this.pendingApprovals.set(nonce, { nonce, resolve, reject, timer });
+            this.send(full).catch((err) => {
+                clearTimeout(timer);
+                this.pendingApprovals.delete(nonce);
+                reject(err);
+            });
+        });
+    }
+    /** Respond to an approval request (companion surface only, usually). */
+    async respondToApproval(nonce, approved, reason, editedParams) {
+        const response = {
+            type: 'approval.response',
+            from: this.surface,
+            ts: new Date().toISOString(),
+            nonce,
+            approved,
+            reason,
+            editedParams,
+        };
+        await this.send(response);
+    }
+    // ── Internal ──────────────────────────────────────────────────────
+    handleIncoming(msg) {
+        // Ignore our own broadcasts (Supabase echoes back)
+        if (msg.from === this.surface)
+            return;
+        // Correlate approval responses with pending requests
+        if (msg.type === 'approval.response') {
+            const pending = this.pendingApprovals.get(msg.nonce);
+            if (pending) {
+                clearTimeout(pending.timer);
+                this.pendingApprovals.delete(msg.nonce);
+                pending.resolve(msg);
+                return; // consumed
+            }
+        }
+        // Reset session timeout on any desktop → companion heartbeat
+        if (this.surface === 'companion' && msg.type === 'session.heartbeat') {
+            this.armSessionTimeout();
+        }
+        // Pass through to user handler
+        this.onMessage(msg);
+    }
+    startHeartbeat() {
+        // Desktop sends a heartbeat every 20s so companion knows we're alive.
+        // The first one fires immediately after start.
+        const fire = () => {
+            const msg = {
+                type: 'session.heartbeat',
+                from: 'desktop',
+                ts: new Date().toISOString(),
+                sessionId: this.identity,
+                state: 'idle', // caller can override via an accessor if they track this
+            };
+            this.send(msg).catch(() => { });
+        };
+        fire();
+        this.heartbeatTimer = setInterval(fire, HEARTBEAT_INTERVAL_MS);
+    }
+    armSessionTimeout() {
+        // Companion-side: if we don't hear from desktop in SESSION_TIMEOUT_MS,
+        // the session is dead. Reset every time a heartbeat arrives.
+        if (this.sessionTimeoutTimer)
+            clearTimeout(this.sessionTimeoutTimer);
+        this.sessionTimeoutTimer = setTimeout(() => {
+            this.onSessionTimeout();
+        }, SESSION_TIMEOUT_MS);
+    }
+    flushOutbox() {
+        if (this.queuedOutbox.length === 0)
+            return;
+        if (!this.transport.isConnected())
+            return;
+        const toSend = this.queuedOutbox.splice(0, this.queuedOutbox.length);
+        for (const msg of toSend) {
+            this.transport.broadcast(msg).catch(() => { this.queuedOutbox.push(msg); });
+        }
+    }
+}
+// ── Typed message helpers ─────────────────────────────────────────────────
+// Constructor functions that fill in common fields so callers just supply
+// the payload — less ceremony at call sites.
+export function makeMessage(partial) {
+    return { ts: new Date().toISOString(), ...partial };
+}
+export async function dispatch(msg, handlers) {
+    const handler = handlers[msg.type];
+    if (handler)
+        await handler(msg);
+}
+//# sourceMappingURL=client.js.map

package/dist/remote/client.js.map

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

package/dist/remote/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Remote pairing protocol — Supabase Realtime message schema for
+ * desktop ↔ companion communication during desktop automation mode.
+ */
+export { channelName, HEARTBEAT_INTERVAL_MS, SESSION_TIMEOUT_MS, APPROVAL_FALLBACK_TIMEOUT_MS, RECONNECT_SHORT_MS, } from './schema.js';
+export { RemoteClient, makeMessage, dispatch } from './client.js';
+export type { ChannelTransport, RemoteClientOptions, MessageHandlers } from './client.js';
+export type { DesktopCapability, SessionRegister, SessionHeartbeat, SessionEnd, PairRequest, PairGrant, PairDeny, PairTakeback, TrajStep, TrajIntent, ApprovalRequest, ApprovalResponse, KillMessage, NotifyMessage, RemoteMessage, RemoteMessageType, } from './schema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/remote/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/remote/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE1F,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/remote/index.js

@@ -0,0 +1,7 @@
+/**
+ * Remote pairing protocol — Supabase Realtime message schema for
+ * desktop ↔ companion communication during desktop automation mode.
+ */
+export { channelName, HEARTBEAT_INTERVAL_MS, SESSION_TIMEOUT_MS, APPROVAL_FALLBACK_TIMEOUT_MS, RECONNECT_SHORT_MS, } from './schema.js';
+export { RemoteClient, makeMessage, dispatch } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/remote/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/remote/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,EAC5B,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}