@genkaku/protocol 0.0.0-stage → 0.1.1

package/dist/offer.d.ts

@@ -0,0 +1,89 @@
+export type Offer = {
+    /**
+     * Board revision this row was read from. `offers/1` adds the capability
+     * fields below; a v0 row is still valid and is treated as a chat-only model,
+     * because a worker that cannot report capabilities cannot be trusted to
+     * support tools either.
+     */
+    proto: 'offers/0' | 'offers/1';
+    workerName: string;
+    model: string;
+    /** 6-decimal USDC per hour of usage, as bigint */
+    pricePerHour: bigint;
+    /** coarse, self-reported (privacy: never street-level) */
+    city?: string;
+    /** 0–100; v0 local heuristic, chain-verified in P4.4 */
+    creditScore: number;
+    /** completed sessions; join into creditScore on-chain later */
+    sessionsServed: number;
+    /** where creditScore came from: chain-derived (P4.9h) or the worker's own
+     *  claim. The UI should only show a chain score as a score. */
+    creditSource?: 'chain' | 'self';
+    /** measured RTT to this worker at discovery time (ms) */
+    latencyMs?: number;
+    /** parallel sessions the worker accepts */
+    maxConcurrent?: number;
+    /**
+     * Ollama's capability list for the model being sold (`tools`, `thinking`,
+     * `vision`, …). Present on `offers/1` rows.
+     */
+    capabilities?: string[];
+    /** raw `details.parameter_size`, e.g. '9.0B'. Present on `offers/1` rows. */
+    parameterSize?: string;
+    /**
+     * Marketplace tier derived from capabilities + size. `chat` is what the UI
+     * labels "not suitable for agents"; it is a label, not a filter.
+     */
+    tier?: ModelTier;
+    /** true when `workerWallet` was proven by the P4.9e hello handshake rather
+     *  than self-reported. Priced sessions should require this. */
+    walletVerified?: boolean;
+    /**
+     * The worker's EVM wallet (escrow settle recipient). The client REPLACES the
+     * self-reported value with the wallet proven by the P4.9e hello handshake and
+     * sets `walletVerified`; an offer whose claim contradicts its proof is
+     * dropped before it is ever listed.
+     */
+    workerWallet?: string;
+};
+/** JSON-safe shape used over /genkaku/offers/0 frames. */
+export type OfferWire = Omit<Offer, 'pricePerHour'> & {
+    pricePerHour: string;
+};
+export declare function toWire(offer: Offer): OfferWire;
+export declare function fromWire(wire: OfferWire): Offer;
+export declare function ceilDiv(a: bigint, b: bigint): bigint;
+/**
+ * Cumulative billed amount for a session. `unitMs` must divide 3600000
+ * (v0 default 60000 → 60 units/hour). Rate per unit is rounded UP once per
+ * hour — never per tick — so the user-perceived hourly price never exceeds
+ * the quoted pricePerHour, and the worker's per-tick exposure stays bounded.
+ */
+export declare function cumulativeBilled(pricePerHour: bigint, unitMs: number, elapsedMs: number): bigint;
+import type { ModelTier } from './capabilities.ts';
+export type OfferSortKey = 'creditScore' | 'pricePerHour' | 'workerName' | 'model' | 'city' | 'latencyMs';
+/** One offer row with the address it arrived from. */
+export type AddressedOffer = {
+    addr: string;
+    offer: Offer;
+};
+/**
+ * Collapse the same worker offer reached through several multiaddrs. A stable
+ * peer can be announced over IPv4, IPv6 and relay addresses; the board should
+ * list the offer once, not once per address.
+ * @param rows - flattened offer rows in discovery order.
+ * @returns rows with duplicate (wallet-or-address, model, price) entries removed.
+ */
+export declare function dedupeOffers(rows: readonly AddressedOffer[]): AddressedOffer[];
+/** One-key sort with stable tiebreakers (name asc, then model asc). */
+export declare function sortOffers(offers: Offer[], key?: OfferSortKey, dir?: 'asc' | 'desc'): Offer[];
+export type OfferFilter = {
+    model?: string;
+    maxPricePerHour?: bigint;
+    minCredit?: number;
+    city?: string;
+    /** case-insensitive substring across workerName/model/city */
+    query?: string;
+};
+export declare function filterOffers(offers: Offer[], f: OfferFilter): Offer[];
+//# sourceMappingURL=offer.d.ts.map

package/dist/offer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer.d.ts","sourceRoot":"","sources":["../src/offer.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,KAAK,GAAG;IAClB;;;;;OAKG;IACH,KAAK,EAAE,UAAU,GAAG,UAAU,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAA;IACtB;mEAC+D;IAC/D,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;IAC/B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;mEAC+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,cAAc,CAAC,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9E,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAE9C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAI/C;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIpD;AAID;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAahG;AAED,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,cAAc,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;AAWzG,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA;AAE3D;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,GAAG,cAAc,EAAE,CAW9E;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,GAAE,YAA4B,EAAE,GAAG,GAAE,KAAK,GAAG,MAAe,GAAG,KAAK,EAAE,CAOpH;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,WAAW,GAAG,KAAK,EAAE,CASrE"}

package/dist/offer.js

@@ -0,0 +1,86 @@
+// GENKAKU: worker offer board (P4.3 marketplace).
+// A worker publishes one Offer row per (model, price) it chooses to serve.
+// Price is FREELY set by the worker and quoted PER HOUR of user usage time
+// (MockUSDC 6 decimals in testnet; canonical USDC 6 decimals in prod). Billing
+// accrues per STARTED MINUTE: worker's max unbilled exposure = one minute.
+// Credit score: v0 is a local heuristic (sessions served); P4.4 upgrades it to
+// the on-chain settled-claim ratio from JobEscrow/WorkerRegistry events.
+export function toWire(offer) {
+    return { ...offer, pricePerHour: offer.pricePerHour.toString() };
+}
+export function fromWire(wire) {
+    // Preserve the revision the row arrived with: a v0 row must not be upgraded
+    // silently, or it would look like a worker that reported capabilities.
+    return { ...wire, pricePerHour: BigInt(wire.pricePerHour) };
+}
+export function ceilDiv(a, b) {
+    if (b <= 0n) {
+        throw new Error('[genkaku:pricing] divisor must be positive');
+    }
+    return (a + b - 1n) / b;
+}
+const MS_PER_HOUR = 3600000n;
+/**
+ * Cumulative billed amount for a session. `unitMs` must divide 3600000
+ * (v0 default 60000 → 60 units/hour). Rate per unit is rounded UP once per
+ * hour — never per tick — so the user-perceived hourly price never exceeds
+ * the quoted pricePerHour, and the worker's per-tick exposure stays bounded.
+ */
+export function cumulativeBilled(pricePerHour, unitMs, elapsedMs) {
+    if (unitMs <= 0) {
+        throw new Error('[genkaku:pricing] unitMs must be positive');
+    }
+    const unit = BigInt(unitMs);
+    if (MS_PER_HOUR % unit !== 0n) {
+        throw new Error('[genkaku:pricing] unitMs must divide 3600000');
+    }
+    const units = Math.ceil(elapsedMs / unitMs);
+    if (units <= 0) {
+        return 0n;
+    }
+    return BigInt(units) * ceilDiv(pricePerHour, MS_PER_HOUR / unit);
+}
+const comparators = {
+    creditScore: (a, b) => a.creditScore - b.creditScore,
+    pricePerHour: (a, b) => (a.pricePerHour <= b.pricePerHour ? -1 : 1),
+    workerName: (a, b) => a.workerName.localeCompare(b.workerName),
+    model: (a, b) => a.model.localeCompare(b.model),
+    city: (a, b) => (a.city ?? '').localeCompare(b.city ?? ''),
+    latencyMs: (a, b) => (a.latencyMs ?? Number.POSITIVE_INFINITY) - (b.latencyMs ?? Number.POSITIVE_INFINITY),
+};
+/**
+ * Collapse the same worker offer reached through several multiaddrs. A stable
+ * peer can be announced over IPv4, IPv6 and relay addresses; the board should
+ * list the offer once, not once per address.
+ * @param rows - flattened offer rows in discovery order.
+ * @returns rows with duplicate (wallet-or-address, model, price) entries removed.
+ */
+export function dedupeOffers(rows) {
+    const seen = new Set();
+    const out = [];
+    for (const row of rows) {
+        const worker = row.offer.workerWallet ?? row.addr;
+        const key = `${worker}|${row.offer.model}|${row.offer.pricePerHour.toString()}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(row);
+    }
+    return out;
+}
+/** One-key sort with stable tiebreakers (name asc, then model asc). */
+export function sortOffers(offers, key = 'creditScore', dir = 'desc') {
+    const mul = dir === 'desc' ? -1 : 1;
+    return [...offers].sort((a, b) => mul * comparators[key](a, b)
+        || comparators.workerName(a, b)
+        || comparators.model(a, b));
+}
+export function filterOffers(offers, f) {
+    const q = f.query?.toLowerCase();
+    return offers.filter(o => (!f.model || o.model === f.model)
+        && (!f.minCredit || o.creditScore >= f.minCredit)
+        && (!f.city || o.city === f.city)
+        && (!q || `${o.workerName} ${o.model} ${o.city ?? ''}`.toLowerCase().includes(q))
+        && (!f.maxPricePerHour || o.pricePerHour <= f.maxPricePerHour));
+}
+//# sourceMappingURL=offer.js.map

package/dist/offer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=offer.test.d.ts.map

package/dist/offer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offer.test.d.ts","sourceRoot":"","sources":["../src/offer.test.ts"],"names":[],"mappings":""}

package/dist/offer.test.js

@@ -0,0 +1,33 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { fromWire, toWire } from "./offer.js";
+const base = {
+    proto: 'offers/1',
+    workerName: 'worker-a',
+    model: 'qwen3.8:27b',
+    pricePerHour: 6000000n,
+    creditScore: 80,
+    sessionsServed: 3,
+    capabilities: ['completion', 'tools'],
+    parameterSize: '27B',
+    tier: 'agent',
+};
+test('offers/1 survives the wire round trip', () => {
+    const wire = toWire(base);
+    assert.equal(wire.pricePerHour, '6000000');
+    assert.deepEqual(fromWire(wire), base);
+});
+test('a v0 row stays v0 after decoding, so it cannot pose as capability-aware', () => {
+    const v0 = {
+        proto: 'offers/0',
+        workerName: 'old-worker',
+        model: 'llama3:8b',
+        pricePerHour: 1000000n,
+        creditScore: 10,
+        sessionsServed: 0,
+    };
+    const decoded = fromWire(toWire(v0));
+    assert.equal(decoded.proto, 'offers/0');
+    assert.equal(decoded.tier, undefined);
+});
+//# sourceMappingURL=offer.test.js.map

package/dist/ollama.d.ts

@@ -0,0 +1,53 @@
+import { type ModelInfo, type PullProgress } from './llmBridge.ts';
+/** Facts the settings page renders before it offers a next step. */
+export type OllamaState = {
+    /** an `ollama` executable was found on this machine */
+    installed: boolean;
+    /** the local HTTP API answers right now */
+    running: boolean;
+    /** version reported by `GET /api/version`, when running */
+    version?: string;
+    /** base URL the plugin uses */
+    host: string;
+    /** official installer page for this platform */
+    downloadUrl: string;
+    /** installed models, empty when the service is not running */
+    models: ModelInfo[];
+    /** last detection or start failure, for the onboarding hint */
+    error?: string;
+};
+/** Official installer page per platform. */
+export declare function ollamaDownloadUrl(platform?: NodeJS.Platform): string;
+/**
+ * Locate an `ollama` executable without trusting the GUI process PATH.
+ *
+ * A packaged macOS app inherits a minimal PATH, so the Homebrew and app-bundle
+ * locations are probed directly; on Windows the per-user installer path is the
+ * usual one.
+ * @param platform - target platform, injectable for tests.
+ * @param environment - environment to read PATH from.
+ * @returns absolute executable path, or undefined when Ollama is absent.
+ */
+export declare function locateOllama(platform?: NodeJS.Platform, environment?: NodeJS.ProcessEnv): string | undefined;
+export type OllamaSupervisor = {
+    /** Detect the binary, probe the service and list models. */
+    state: () => Promise<OllamaState>;
+    /** Start `ollama serve` when installed but stopped; idempotent. */
+    ensureRunning: () => Promise<OllamaState>;
+    /** Download a registry model, forwarding progress frames. */
+    pull: (model: string, onProgress?: (p: PullProgress) => void, signal?: AbortSignal) => Promise<{
+        status: string;
+    }>;
+    /** Remove a locally installed model. */
+    remove: (model: string) => Promise<void>;
+    /** Stop the child this supervisor started, if any. */
+    dispose: () => void;
+};
+/**
+ * Build the worker-side Ollama supervisor.
+ * @param host - local Ollama base URL.
+ * @param log - diagnostic line sink.
+ * @returns supervisor over the local install.
+ */
+export declare function createOllamaSupervisor(host: string, log: (line: string) => void): OllamaSupervisor;
+//# sourceMappingURL=ollama.d.ts.map

package/dist/ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.d.ts","sourceRoot":"","sources":["../src/ollama.ts"],"names":[],"mappings":"AAWA,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE/E,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG;IACxB,uDAAuD;IACvD,SAAS,EAAE,OAAO,CAAA;IAClB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAA;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAA;IACnB,8DAA8D;IAC9D,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG,MAAM,CAItF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,MAAM,GAAG,SAAS,CAuBpB;AASD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,4DAA4D;IAC5D,KAAK,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;IACjC,mEAAmE;IACnE,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;IACzC,6DAA6D;IAC7D,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClH,wCAAwC;IACxC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,sDAAsD;IACtD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,gBAAgB,CA0FlG"}

package/dist/ollama.js

@@ -0,0 +1,162 @@
+// GENKAKU: local Ollama lifecycle for worker onboarding (P4.7b).
+//
+// The desktop ships no multi-GB runtime. A worker either already runs Ollama
+// or is guided to install it; this module only detects, starts and talks to
+// the local HTTP API. Model management lives in llmBridge.ollamaAdmin.
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { delimiter, join } from 'node:path';
+import { ollamaAdmin } from "./llmBridge.js";
+/** Official installer page per platform. */
+export function ollamaDownloadUrl(platform = process.platform) {
+    if (platform === 'darwin')
+        return 'https://ollama.com/download/mac';
+    if (platform === 'win32')
+        return 'https://ollama.com/download/windows';
+    return 'https://ollama.com/download/linux';
+}
+/**
+ * Locate an `ollama` executable without trusting the GUI process PATH.
+ *
+ * A packaged macOS app inherits a minimal PATH, so the Homebrew and app-bundle
+ * locations are probed directly; on Windows the per-user installer path is the
+ * usual one.
+ * @param platform - target platform, injectable for tests.
+ * @param environment - environment to read PATH from.
+ * @returns absolute executable path, or undefined when Ollama is absent.
+ */
+export function locateOllama(platform = process.platform, environment = process.env) {
+    const executable = platform === 'win32' ? 'ollama.exe' : 'ollama';
+    // Scan PATH directly: a packaged GUI app cannot rely on `which`/`where`
+    // because the inherited PATH is minimal and those tools may be unresolvable.
+    for (const dir of (environment.PATH ?? '').split(delimiter)) {
+        if (dir === '')
+            continue;
+        const candidate = join(dir, executable);
+        if (existsSync(candidate))
+            return candidate;
+    }
+    const candidates = platform === 'darwin'
+        ? [
+            '/usr/local/bin/ollama',
+            '/opt/homebrew/bin/ollama',
+            '/Applications/Ollama.app/Contents/Resources/ollama',
+            join(homedir(), 'Applications/Ollama.app/Contents/Resources/ollama'),
+        ]
+        : platform === 'win32'
+            ? [
+                join(environment.LOCALAPPDATA ?? join(homedir(), 'AppData/Local'), 'Programs/Ollama/ollama.exe'),
+                join(environment.ProgramFiles ?? 'C:/Program Files', 'Ollama/ollama.exe'),
+            ]
+            : ['/usr/local/bin/ollama', '/usr/bin/ollama', '/snap/bin/ollama'];
+    return candidates.find(candidate => existsSync(candidate));
+}
+/** Read one JSON document from the local API with a bounded wait. */
+async function getJson(url, timeoutMs = 1500) {
+    const response = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!response.ok)
+        throw new Error(`${url} refused (${response.status})`);
+    return await response.json();
+}
+/**
+ * Build the worker-side Ollama supervisor.
+ * @param host - local Ollama base URL.
+ * @param log - diagnostic line sink.
+ * @returns supervisor over the local install.
+ */
+export function createOllamaSupervisor(host, log) {
+    const admin = ollamaAdmin(host);
+    const base = host.replace(/\/$/u, '');
+    let child;
+    let starting;
+    const running = async () => {
+        try {
+            const versionDoc = await getJson(`${base}/api/version`);
+            const models = await admin.list();
+            return {
+                running: true,
+                ...(typeof versionDoc.version === 'string' ? { version: versionDoc.version } : {}),
+                models,
+            };
+        }
+        catch (error) {
+            return { running: false, models: [], error: error instanceof Error ? error.message : String(error) };
+        }
+    };
+    const state = async () => {
+        const probe = await running();
+        const binary = locateOllama();
+        if (probe.running) {
+            return {
+                installed: true,
+                running: true,
+                ...(probe.version === undefined ? {} : { version: probe.version }),
+                host, downloadUrl: ollamaDownloadUrl(), models: probe.models,
+            };
+        }
+        return {
+            installed: binary !== undefined,
+            running: false,
+            host,
+            downloadUrl: ollamaDownloadUrl(),
+            models: [],
+            ...(binary === undefined
+                ? { error: 'ollama executable not found' }
+                : probe.error === undefined ? {} : { error: probe.error }),
+        };
+    };
+    const start = async () => {
+        const binary = locateOllama();
+        if (binary === undefined)
+            return await state();
+        const url = new URL(base);
+        log(`ollama: starting ${binary} serve (OLLAMA_HOST=${url.host})`);
+        const spawned = spawn(binary, ['serve'], {
+            env: { ...process.env, OLLAMA_HOST: url.host },
+            stdio: 'ignore',
+            detached: false,
+        });
+        child = spawned;
+        spawned.once('error', (error) => { log(`ollama spawn failed (${error.message})`); });
+        spawned.once('exit', (code, signal) => {
+            if (child === spawned)
+                child = undefined;
+            log(`ollama exited (${code ?? signal ?? 'unknown'})`);
+        });
+        for (let attempt = 0; attempt < 20; attempt += 1) {
+            const probe = await running();
+            if (probe.running)
+                return await state();
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+        const current = await state();
+        return { ...current, error: current.error ?? 'ollama did not answer after 10s' };
+    };
+    return {
+        state,
+        ensureRunning: async () => {
+            const current = await state();
+            if (current.running || !current.installed)
+                return current;
+            starting ??= start().finally(() => { starting = undefined; });
+            return await starting;
+        },
+        pull: async (model, onProgress, signal) => await admin.pull(model, onProgress, signal),
+        remove: async (model) => {
+            const response = await fetch(`${base}/api/delete`, {
+                method: 'DELETE',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({ model }),
+            });
+            if (!response.ok)
+                throw new Error(`ollama delete refused (${response.status})`);
+        },
+        dispose: () => {
+            if (child !== undefined && !child.killed)
+                child.kill();
+            child = undefined;
+        },
+    };
+}
+//# sourceMappingURL=ollama.js.map

package/dist/p2pNode.d.ts

@@ -0,0 +1,52 @@
+import { type Libp2p } from 'libp2p';
+import { type Hex } from 'viem';
+import type { Paywall } from './paywall.ts';
+import type { LocalChatSource, LocalCompletionSource } from './llmBridge.ts';
+import type { ModeManager } from './modeManager.ts';
+import { type Offer } from './offer.ts';
+import type { SessionEvent } from './workerSession.ts';
+export { FrameReader, lpEncode, lpFrames } from './lp.ts';
+export type { ByteChunk } from './lp.ts';
+export declare const GENKAKU_PROTOCOLS: readonly ["/genkaku/open/0", "/genkaku/token/0", "/genkaku/receipt/0", "/genkaku/settle/0", "/genkaku/offers/0", "/genkaku/policy/0", "/genkaku/hello/0"];
+export type SidecarOptions = {
+    modeManager: ModeManager;
+    source: LocalCompletionSource;
+    /** Serves `open/1` chat requests (messages + tool schemas). */
+    chatSource?: LocalChatSource;
+    /** ip4/tcp listen addrs; LAN first, NAT traversal (hole punching) later */
+    listen: string[];
+    /** one Offer row per (model, price) the worker publishes — visible to users */
+    catalog: Offer[];
+    sessionEvents?: (e: SessionEvent) => void;
+    /** P4.9d: refuse to spend GPU time unless the named escrow pays this worker. */
+    paywall?: Paywall;
+    /** P4.4: with a worker wallet, priced receipts MUST carry a valid signature,
+     *  offers self-report the wallet, and settle co-signing becomes available. */
+    workerKey?: Hex;
+};
+/** One stored (latest) receipt per jobId — the evidence the settle co-sign
+ *  defends against (spend == max cumulative receipt the client piped). */
+export type StoredReceipt = {
+    seq: number;
+    amount: bigint;
+    sig: string;
+    /** the escrow/stream binding used to build the digest (jobId, escrowId) */
+    escrowId: string;
+    /** commit-challenge commitments carried by the receipt (P4.9f) */
+    inputHash: `0x${string}`;
+    outputHash: `0x${string}`;
+};
+/** A bare libp2p node for the USER side (no genkaku handlers — dials only). */
+export declare function createUserNode(listen?: string[]): Promise<Libp2p>;
+export type GenkakuSidecar = {
+    node: Libp2p;
+    peerAddrs: () => string[];
+    stop(): Promise<void>;
+    activeSessions: () => number;
+    /** P4.5: the base58 PeerId string the registry binding pins */
+    peerIdStr: () => string;
+    /** Replace the served offer board without restarting the sidecar. */
+    setCatalog: (offers: Offer[]) => void;
+};
+export declare function createSidecar(opts: SidecarOptions): Promise<GenkakuSidecar>;
+//# sourceMappingURL=p2pNode.d.ts.map

package/dist/p2pNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p2pNode.d.ts","sourceRoot":"","sources":["../src/p2pNode.ts"],"names":[],"mappings":"AAYA,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAClD,OAAO,EAAE,KAAK,GAAG,EAAW,MAAM,MAAM,CAAA;AAIxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAE5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,OAAO,EAAoB,KAAK,KAAK,EAAU,MAAM,YAAY,CAAA;AAajE,OAAO,KAAK,EAAgB,YAAY,EAAiB,MAAM,oBAAoB,CAAA;AAGnF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACzD,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,eAAO,MAAM,iBAAiB,2JAQpB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,WAAW,CAAA;IACxB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,2EAA2E;IAC3E,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,+EAA+E;IAC/E,OAAO,EAAE,KAAK,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;IACzC,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;kFAC8E;IAC9E,SAAS,CAAC,EAAE,GAAG,CAAA;CAChB,CAAA;AAED;0EAC0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAA;IAChB,kEAAkE;IAClE,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;IACxB,UAAU,EAAE,KAAK,MAAM,EAAE,CAAA;CAC1B,CAAA;AAkBD,+EAA+E;AAC/E,wBAAsB,cAAc,CAAC,MAAM,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAY3E;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,MAAM,EAAE,CAAA;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,cAAc,EAAE,MAAM,MAAM,CAAA;IAC5B,+DAA+D;IAC/D,SAAS,EAAE,MAAM,MAAM,CAAA;IACvB,qEAAqE;IACrE,UAAU,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,IAAI,CAAA;CACtC,CAAA;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAkfjF"}