@genkaku/protocol 0.1.13 → 0.1.15

package/dist/bridge.d.ts

@@ -32,6 +32,12 @@ export type BridgeOptions = {
     status?: (base: BridgeStatus) => Record<string, unknown> | Promise<Record<string, unknown>>;
     /** optional live mode switch from POST /genkaku/mode */
     onMode?: (mode: RoleMode) => void | Promise<void>;
+    /** Persist the panel's settings edits (workers / payments) into the plugin's
+     *  settings document. The runtime applies them by restarting the bridge. */
+    onSettings?: (patch: {
+        workers?: string[];
+        settle?: boolean;
+    }) => void | Promise<void>;
     /** P4.9h: derived credit per worker wallet (escrow events, not self-report).
      *  Absent = offers keep whatever the worker claimed. */
     credit?: (wallets: string[]) => Map<string, {

package/dist/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAc/B,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAgB,MAAM,EAAc,MAAM,YAAY,CAAA;AAI7D,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;IACjE,GAAG,EAAE,MAAM,CAAA;IACX,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAA;CAChD,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,cAAc,CAAA;IACnB,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,OAAO,EAAE,MAAM,GAAG,CAAA;IAClB,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAA;IACf,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,wFAAwF;IACxF,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3F,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;4DACwD;IACxD,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,MAAM,EAAE,KACd,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAClH,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;AAuJD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA6flF"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACpC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,MAAM,CAAA;AAc/B,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAgB,MAAM,EAAc,MAAM,YAAY,CAAA;AAI7D,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC,OAAO,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;IACjE,GAAG,EAAE,MAAM,CAAA;IACX,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAA;CAChD,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,cAAc,CAAA;IACnB,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9B,OAAO,EAAE,MAAM,GAAG,CAAA;IAClB,yEAAyE;IACzE,MAAM,EAAE,OAAO,CAAA;IACf,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,wFAAwF;IACxF,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3F,wDAAwD;IACxD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD;gFAC4E;IAC5E,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtF;4DACwD;IACxD,MAAM,CAAC,EAAE,CACP,OAAO,EAAE,MAAM,EAAE,KACd,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;CAClH,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;AAuJD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAkjBlF"}

package/dist/bridge.js

@@ -564,6 +564,53 @@ export async function startOpenAiBridge(opts) {
                     json(res, 200, { ok: true });
                     return;
                 }
+                if (req.method === 'POST' && (path === '/genkaku/settings' || path === '/genkaku/settings/')) {
+                    let body;
+                    try {
+                        body = await readJson(req);
+                    }
+                    catch {
+                        failure(res, 400, 'invalid JSON body');
+                        return;
+                    }
+                    if (body.refresh === true) {
+                        // Drop the 10s offer cache so the next status/model read re-dials
+                        // every discovered worker right now.
+                        cache.clear();
+                    }
+                    const patch = {};
+                    if (body.workers !== undefined) {
+                        if (!Array.isArray(body.workers)) {
+                            failure(res, 400, 'workers must be an array of multiaddrs');
+                            return;
+                        }
+                        const workers = body.workers
+                            .filter((w) => typeof w === 'string')
+                            .map(w => w.trim())
+                            .filter(w => w.startsWith('/'));
+                        if (workers.length !== body.workers.length || workers.length > 16 || workers.some(w => w.length > 512)) {
+                            failure(res, 400, 'each worker must be a multiaddr (max 16)');
+                            return;
+                        }
+                        patch.workers = workers;
+                    }
+                    if (body.settle !== undefined) {
+                        if (typeof body.settle !== 'boolean') {
+                            failure(res, 400, 'settle must be a boolean');
+                            return;
+                        }
+                        patch.settle = body.settle;
+                    }
+                    if (Object.keys(patch).length > 0) {
+                        if (opts.onSettings == null) {
+                            failure(res, 501, 'settings are not writable in this profile');
+                            return;
+                        }
+                        await opts.onSettings(patch);
+                    }
+                    json(res, 200, { ok: true, applied: Object.keys(patch), refreshed: body.refresh === true });
+                    return;
+                }
                 if (req.method === 'GET' && (path === '/genkaku/status' || path === '/genkaku/status/')) {
                     await status(res);
                     return;

package/dist/index.d.ts

@@ -23,6 +23,7 @@ export * from './ollama.ts';
 export * from './p2pNode.ts';
 export * from './paywall.ts';
 export * from './publishOptIn.ts';
+export * from './settleOptIn.ts';
 export * from './receipts.ts';
 export * from './registry.ts';
 export * from './rpc.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA;AACvB,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,oBAAoB,CAAA"}

package/dist/index.js

@@ -23,6 +23,7 @@ export * from "./ollama.js";
 export * from "./p2pNode.js";
 export * from "./paywall.js";
 export * from "./publishOptIn.js";
+export * from "./settleOptIn.js";
 export * from "./receipts.js";
 export * from "./registry.js";
 export * from "./rpc.js";

package/dist/settleOptIn.d.ts

@@ -0,0 +1,15 @@
+/** File name under the GenKaKu key directory. */
+export declare const SETTLE_OPT_IN_FILE = "settle.json";
+/**
+ * Read the user's settlement opt-in.
+ * @param keyDir - GenKaKu state directory.
+ * @returns true/false when the user chose, or null to keep the profile default.
+ */
+export declare function readSettleOptIn(keyDir: string): boolean | null;
+/**
+ * Persist the user's settlement opt-in.
+ * @param keyDir - GenKaKu state directory.
+ * @param settle - whether sessions should open and settle escrows.
+ */
+export declare function writeSettleOptIn(keyDir: string, settle: boolean): void;
+//# sourceMappingURL=settleOptIn.d.ts.map

package/dist/settleOptIn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settleOptIn.d.ts","sourceRoot":"","sources":["../src/settleOptIn.ts"],"names":[],"mappings":"AAYA,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,gBAAgB,CAAA;AAE/C;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQ9D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAGtE"}

package/dist/settleOptIn.js

@@ -0,0 +1,37 @@
+// GENKAKU: user-side settlement opt-in.
+//
+// `config.settle` is the deployment default and is NOT a volatile settings
+// field: writing it into the profile patch is rejected by dsh ("is not
+// volatile") and, because the write was fire-and-forget, it took the whole app
+// down. The panel's Payments switch therefore persists here instead, next to
+// the worker's publish opt-in, and the runtime reads it when it builds the
+// bridge.
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** File name under the GenKaKu key directory. */
+export const SETTLE_OPT_IN_FILE = 'settle.json';
+/**
+ * Read the user's settlement opt-in.
+ * @param keyDir - GenKaKu state directory.
+ * @returns true/false when the user chose, or null to keep the profile default.
+ */
+export function readSettleOptIn(keyDir) {
+    try {
+        const value = JSON.parse(readFileSync(join(keyDir, SETTLE_OPT_IN_FILE), 'utf8'));
+        const settle = value.settle;
+        return typeof settle === 'boolean' ? settle : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Persist the user's settlement opt-in.
+ * @param keyDir - GenKaKu state directory.
+ * @param settle - whether sessions should open and settle escrows.
+ */
+export function writeSettleOptIn(keyDir, settle) {
+    mkdirSync(keyDir, { recursive: true, mode: 0o700 });
+    writeFileSync(join(keyDir, SETTLE_OPT_IN_FILE), `${JSON.stringify({ settle }, undefined, 2)}\n`, { mode: 0o600 });
+}
+//# sourceMappingURL=settleOptIn.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genkaku/protocol",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "GenKaKu protocol core: on-chain worker directory, USDC escrow billing, libp2p transport, Ollama lifecycle",
   "license": "MIT",
   "type": "module",