@plurnk/plurnk-service 0.43.0 → 0.45.0

package/dist/service.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { existsSync, mkdirSync, copyFileSync, writeFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { homedir } from "node:os";
+import { createRequire } from "node:module";
+import SqlRite from "@possumtech/sqlrite";
+import Daemon from "./server/Daemon.js";
+import EnvFlags from "./core/EnvFlags.js";
+import ProviderInstantiate from "./core/ProviderInstantiate.js";
+import { resolveActiveAlias } from "@plurnk/plurnk-providers";
+// The `plurnk-service` executable: launches the daemon (start) or runs migrations.
+// Not the user-facing client — that is the separate `plurnk` project.
+export default class Service {
+    // This file's own directory holds the runtime code + its .sql (src/ in dev, dist/ in a
+    // published install); its parent is the package root (migrations/, requirements.md, .env.example).
+    static #codeDir = dirname(fileURLToPath(import.meta.url));
+    static #projectRoot = resolve(Service.#codeDir, "..");
+    static #ext = import.meta.url.endsWith(".ts") ? ".ts" : ".js";
+    static #homeDir = resolve(homedir(), ".plurnk");
+    // First-run bootstrap — run-time, NOT an install script: seed ~/.plurnk so a global
+    // install has a stable home for config + the DB. Idempotent (only acts when absent).
+    static #ensureHome() {
+        // Seed ONCE, on first run (the home is absent). After that the user owns ~/.plurnk —
+        // edits and deletions stick, no silent re-seed. `~/.plurnk/.env.example` is the cascade
+        // FLOOR (the visible legend); the node_modules copy is the seed + CLI-flag source only.
+        // Wiping the whole dir is a deliberate reset. A deleted floor stays deleted; a missing
+        // required knob then surfaces as a clear `missing PLURNK_X` error, not a crash.
+        if (existsSync(Service.#homeDir))
+            return;
+        mkdirSync(Service.#homeDir, { recursive: true });
+        const shipped = resolve(Service.#projectRoot, ".env.example");
+        if (existsSync(shipped))
+            copyFileSync(shipped, resolve(Service.#homeDir, ".env.example"));
+        writeFileSync(resolve(Service.#homeDir, ".env"), "# plurnk config — overrides the shipped defaults. e.g.\n# PLURNK_MODEL=gemma\n");
+        process.stderr.write(`plurnk-service: created ${Service.#homeDir} — config in ${resolve(Service.#homeDir, ".env")}\n`);
+    }
+    static #expandHome(p) {
+        if (p === "~")
+            return homedir();
+        return p.startsWith("~/") ? resolve(homedir(), p.slice(2)) : p;
+    }
+    // The node_modules holding the service's plugin deps (exec/scheme/mimetype), resolved
+    // package-relative so a global install finds them regardless of run-CWD. Falls back to CWD.
+    static #pluginsNodeModules() {
+        try {
+            const execs = createRequire(import.meta.url).resolve("@plurnk/plurnk-execs/package.json");
+            return resolve(dirname(execs), "..", "..");
+        }
+        catch {
+            return resolve(process.cwd(), "node_modules");
+        }
+    }
+    static #die(code, message) {
+        process.stderr.write(`${message}\n`);
+        process.exit(code);
+    }
+    static #loadEnv(path, required) {
+        if (existsSync(path)) {
+            try {
+                process.loadEnvFile(path);
+            }
+            catch (cause) {
+                Service.#die(64, `failed to load ${path}: ${cause instanceof Error ? cause.message : String(cause)}`);
+            }
+        }
+        else if (required) {
+            Service.#die(64, `${path} does not exist`);
+        }
+    }
+    // node-style env-file flags: --env-file=<path> (required) / --env-file-if-exists=<path>
+    // (skip if missing), repeatable, in command-line order. node only loads pre-script files;
+    // a published `plurnk-service --env-file=…` needs this post-script loader.
+    static #envFileArgs() {
+        return process.argv.flatMap((a) => {
+            if (a.startsWith("--env-file-if-exists="))
+                return [{ path: a.slice(a.indexOf("=") + 1), required: false }];
+            if (a.startsWith("--env-file="))
+                return [{ path: a.slice(a.indexOf("=") + 1), required: true }];
+            return [];
+        });
+    }
+    static #requireEnv(name) {
+        const value = process.env[name];
+        if (value === undefined || value.length === 0)
+            Service.#die(78, `missing required env ${name} (declare it in .env.example)`);
+        return value;
+    }
+    static #sqliteKnob(name) {
+        const raw = process.env[name];
+        if (raw === undefined || raw.trim() === "")
+            return undefined;
+        const n = Number(raw);
+        if (!Number.isInteger(n))
+            Service.#die(78, `${name} must be an integer, got ${JSON.stringify(raw)}`);
+        return n;
+    }
+    static async #openDb(dbPath) {
+        const tuning = {};
+        for (const [env, opt] of [
+            ["PLURNK_SQLITE_TIMEOUT", "timeout"],
+            ["PLURNK_SQLITE_CACHE_SIZE", "cacheSize"],
+            ["PLURNK_SQLITE_MMAP_SIZE", "mmapSize"],
+            ["PLURNK_SQLITE_MAX_PAGE_COUNT", "maxPageCount"],
+        ]) {
+            const v = Service.#sqliteKnob(env);
+            if (v !== undefined)
+                tuning[opt] = v;
+        }
+        mkdirSync(dirname(dbPath), { recursive: true });
+        const db = await SqlRite.open({
+            path: dbPath,
+            dir: [resolve(Service.#projectRoot, "migrations"), Service.#codeDir],
+            functions: [resolve(Service.#codeDir, `schemes/cosine${Service.#ext}`)],
+            ...tuning,
+        });
+        return db;
+    }
+    static async #migrate() {
+        const dbPath = Service.#expandHome(Service.#requireEnv("PLURNK_DB_PATH"));
+        const db = await Service.#openDb(dbPath);
+        try {
+            process.stdout.write(`migrated: ${dbPath}\n`);
+        }
+        finally {
+            await db.close();
+        }
+    }
+    static async #start() {
+        const dbPath = Service.#expandHome(Service.#requireEnv("PLURNK_DB_PATH"));
+        const host = Service.#requireEnv("PLURNK_HOST");
+        const port = Number(Service.#requireEnv("PLURNK_PORT"));
+        const db = await Service.#openDb(dbPath);
+        const alias = resolveActiveAlias();
+        const provider = alias === null ? null : await ProviderInstantiate.loadActiveProvider();
+        const daemon = new Daemon({ db, provider, nodeModulesPath: Service.#pluginsNodeModules() });
+        const addr = await daemon.start({ host, port });
+        if (await daemon.mimetypes.embedderInfo() === null) {
+            process.stderr.write("plurnk-service: embedder inactive — semantic search (FIND) is degraded. Install @plurnk/plurnk-mimetypes-embeddings, or see README.md#semantic-search\n");
+        }
+        if (alias === null) {
+            process.stderr.write(`plurnk-service: no model configured — set PLURNK_MODEL in ${resolve(Service.#homeDir, ".env")} (e.g. PLURNK_MODEL=gemma). Bring your own provider; the hosted default isn't live yet.\n`);
+        }
+        const aliasStr = alias === null ? "no model" : `${alias.alias}=${alias.provider}/${alias.model}`;
+        process.stdout.write(`plurnk-service ws://${addr.host}:${addr.port} db=${dbPath} ${aliasStr}\n`);
+        const shutdown = async () => { await daemon.stop(); await db.close(); process.exit(0); };
+        process.on("SIGINT", shutdown);
+        process.on("SIGTERM", shutdown);
+    }
+    static async main() {
+        if (!process.argv.includes("--help") && !process.argv.includes("-h"))
+            Service.#ensureHome();
+        // Env cascade — first write wins (loadEnvFile is set-if-unset), so load highest first.
+        // Precedence high→low: CLI --flags > shell env > --env-file/--config > ./.env >
+        // ~/.plurnk/.env > ~/.plurnk/.env.example > package .env.example (the floor).
+        for (const { path: envFile, required } of Service.#envFileArgs())
+            Service.#loadEnv(envFile, required);
+        const configFlagIndex = process.argv.findIndex((a) => a === "--config" || a.startsWith("--config="));
+        const configFile = (() => {
+            if (configFlagIndex === -1)
+                return null;
+            const arg = process.argv[configFlagIndex];
+            if (arg.includes("="))
+                return arg.slice(arg.indexOf("=") + 1);
+            return process.argv[configFlagIndex + 1] ?? null;
+        })();
+        if (configFile !== null)
+            Service.#loadEnv(configFile, true);
+        Service.#loadEnv(".env", false);
+        Service.#loadEnv(resolve(Service.#homeDir, ".env"), false);
+        Service.#loadEnv(resolve(Service.#homeDir, ".env.example"), false); // the cascade floor (NOT the node_modules copy)
+        const flagDescriptors = await EnvFlags.parseEnvExample(resolve(Service.#projectRoot, ".env.example"));
+        const flagOptions = {};
+        for (const f of flagDescriptors) {
+            flagOptions[f.flagName.replace(/^--/, "")] = { type: "string" };
+        }
+        const usage = `usage: plurnk-service [options] [migrate]
+
+${EnvFlags.formatFlagsHelp(flagDescriptors)}
+
+  --env-file=<path>            layer env from <path> (repeatable; errors if missing)
+  --env-file-if-exists=<path>  layer env from <path> if present (repeatable)
+  --config=<path>              layer additional env from <path>
+  -h, --help                   show this help
+`;
+        const { positionals, values } = parseArgs({
+            allowPositionals: true,
+            strict: false,
+            options: { help: { type: "boolean", short: "h" }, config: { type: "string" }, ...flagOptions },
+        });
+        for (const f of flagDescriptors) {
+            const key = f.flagName.replace(/^--/, "");
+            const v = values[key];
+            if (typeof v === "string")
+                process.env[f.envName] = v;
+        }
+        if (values.help) {
+            process.stdout.write(usage);
+            process.exit(0);
+        }
+        const dispatch = { migrate: Service.#migrate, start: Service.#start };
+        const subcommand = typeof positionals[0] === "string" ? positionals[0] : "start";
+        const handler = dispatch[subcommand];
+        if (handler === undefined)
+            Service.#die(64, `unknown subcommand: ${subcommand}\n\n${usage}`);
+        if (positionals.length > 1)
+            Service.#die(64, `unexpected arguments: ${positionals.slice(1).join(" ")}`);
+        try {
+            await handler();
+        }
+        catch (cause) {
+            process.stderr.write(`${subcommand}: ${cause instanceof Error ? cause.message : String(cause)}\n`);
+            if (cause instanceof Error && cause.cause)
+                process.stderr.write(`  cause: ${cause.cause instanceof Error ? cause.cause.message : String(cause.cause)}\n`);
+            process.exit(1);
+        }
+    }
+}
+await Service.main();
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAE1C,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,QAAQ,MAAM,oBAAoB,CAAC;AAC1C,OAAO,mBAAmB,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,mFAAmF;AACnF,sEAAsE;AACtE,MAAM,CAAC,OAAO,OAAO,OAAO;IACxB,uFAAuF;IACvF,mGAAmG;IACnG,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;IAC9D,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IAEhD,oFAAoF;IACpF,qFAAqF;IACrF,MAAM,CAAC,WAAW;QACd,qFAAqF;QACrF,wFAAwF;QACxF,wFAAwF;QACxF,uFAAuF;QACvF,gFAAgF;QAChF,IAAI,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO;QACzC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QAC9D,IAAI,UAAU,CAAC,OAAO,CAAC;YAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;QAC1F,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,gFAAgF,CAAC,CAAC;QACnI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,OAAO,CAAC,QAAQ,gBAAgB,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3H,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,CAAS;QACxB,IAAI,CAAC,KAAK,GAAG;YAAE,OAAO,OAAO,EAAE,CAAC;QAChC,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,sFAAsF;IACtF,4FAA4F;IAC5F,MAAM,CAAC,mBAAmB;QACtB,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC;YAC1F,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QAClD,CAAC;IACL,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAY,EAAE,OAAe;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAY,EAAE,QAAiB;QAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC;gBAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;YAClC,OAAO,KAAK,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,kBAAkB,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;QAC5H,CAAC;aAAM,IAAI,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,iBAAiB,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAED,wFAAwF;IACxF,0FAA0F;IAC1F,2EAA2E;IAC3E,MAAM,CAAC,YAAY;QACf,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAA8C,EAAE;YAC1E,IAAI,CAAC,CAAC,UAAU,CAAC,uBAAuB,CAAC;gBAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3G,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;gBAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;YAChG,OAAO,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,wBAAwB,IAAI,+BAA+B,CAAC,CAAC;QAC7H,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,SAAS,CAAC;QAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,4BAA4B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,OAAO,CAAC,CAAC;IACb,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAc;QAC/B,MAAM,MAAM,GAA2B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI;YACrB,CAAC,uBAAuB,EAAE,SAAS,CAAC;YACpC,CAAC,0BAA0B,EAAE,WAAW,CAAC;YACzC,CAAC,yBAAyB,EAAE,UAAU,CAAC;YACvC,CAAC,8BAA8B,EAAE,cAAc,CAAC;SAC1C,EAAE,CAAC;YACT,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,SAAS;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAC1B,IAAI,EAAE,MAAM;YACZ,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC;YACpE,SAAS,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,iBAAiB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACvE,GAAG,MAAM;SACZ,CAAC,CAAC;QACH,OAAO,EAAmB,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,QAAQ;QACjB,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1E,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC;YAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,MAAM,IAAI,CAAC,CAAC;QAAC,CAAC;gBAC9C,CAAC;YAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,MAAM;QACf,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC;QAExD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,kBAAkB,EAAE,CAAC;QACxF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;QAC5F,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,IAAI,MAAM,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yJAAyJ,CAAC,CAAC;QACpL,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,6DAA6D,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,2FAA2F,CAAC,CAAC;QACpN,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QACjG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,OAAO,MAAM,IAAI,QAAQ,IAAI,CAAC,CAAC;QAEjG,MAAM,QAAQ,GAAG,KAAK,IAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxG,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,IAAI;QACb,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5F,uFAAuF;QACvF,gFAAgF;QAChF,8EAA8E;QAC9E,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,OAAO,CAAC,YAAY,EAAE;YAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEtG,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;QACrG,MAAM,UAAU,GAAG,CAAC,GAAkB,EAAE;YACpC,IAAI,eAAe,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACxC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC1C,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9D,OAAO,OAAO,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;QACrD,CAAC,CAAC,EAAE,CAAC;QAEL,IAAI,UAAU,KAAK,IAAI;YAAE,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,KAAK,CAAC,CAAC,CAAG,gDAAgD;QAEtH,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,CAAC;QACtG,MAAM,WAAW,GAAuC,EAAE,CAAC;QAC3D,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;YAC9B,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACpE,CAAC;QAED,MAAM,KAAK,GAAG;;EAEpB,QAAQ,CAAC,eAAe,CAAC,eAAe,CAAC;;;;;;CAM1C,CAAC;QAEM,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;YACtC,gBAAgB,EAAE,IAAI;YACtB,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,GAAG,WAAW,EAAE;SACjG,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC;QAElE,MAAM,QAAQ,GAAwC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QAC3G,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACjF,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,uBAAuB,UAAU,OAAO,KAAK,EAAE,CAAC,CAAC;QAC7F,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,yBAAyB,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAExG,IAAI,CAAC;YAAC,MAAM,OAAO,EAAE,CAAC;QAAC,CAAC;QACxB,OAAO,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,UAAU,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnG,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1J,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;;AAGL,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-service",
-    "version": "0.43.0",
+    "version": "0.45.0",
     "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-grammar contract.",
     "type": "module",
     "license": "MIT",
@@ -15,11 +15,10 @@
         "./package.json": "./package.json"
     },
     "bin": {
-        "plurnk-service": "./bin/plurnk-service.ts"
+        "plurnk-service": "./dist/service.js"
     },
     "files": [
         ".env.example",
-        "bin/plurnk-service.ts",
         "dist/**/*",
         "migrations/**/*.sql",
         "requirements.md",
@@ -30,39 +29,54 @@
         "access": "public"
     },
     "scripts": {
-        "start": "node bin/plurnk-service.ts",
+        "start": "node src/service.ts",
         "test:lint": "tsc --noEmit",
         "test:unit": "node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-timeout=30000 src/**/*.test.ts",
         "test:intg": "npm run test:clean-tmp && PLURNK_MANIFEST_ITEMS=0 node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-timeout=30000 test/intg/*.test.ts",
-        "test:live": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/live/*.test.ts",
-        "test:demo": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/demo/*.test.ts",
+        "test:live": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-force-exit --test-concurrency=1 test/live/*.test.ts",
+        "test:demo": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-force-exit --test-concurrency=1 test/demo/*.test.ts",
         "test:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
         "test:digest": "node bin/digest.ts",
         "test:clean-tmp": "rm -rf test/intg/.tmp",
         "dev:digest": "node bin/digest.ts",
+        "build:clean": "rm -rf dist",
         "build:dist": "tsc -p tsconfig.build.json",
-        "build": "npm run build:dist",
+        "build:sql": "node scripts/copy-sql.mjs",
+        "build": "npm run build:clean && npm run build:dist && npm run build:sql",
+        "build:global:install": "npm run build && npm install -g .",
+        "build:global:uninstall": "npm uninstall -g @plurnk/plurnk-service",
+        "build:local:install": "node scripts/install-sandbox.mjs install",
+        "build:local:uninstall": "node scripts/install-sandbox.mjs uninstall",
+        "test:installation": "node scripts/test-installation.mjs",
         "prepare": "npm run build"
     },
     "dependencies": {
-        "@plurnk/plurnk-execs": "0.4.9",
+        "@plurnk/plurnk-execs": "0.4.11",
         "@plurnk/plurnk-execs-all": "0.1.5",
-        "@plurnk/plurnk-grammar": "0.67.0",
-        "@plurnk/plurnk-mimetypes": "0.15.19",
-        "@plurnk/plurnk-mimetypes-all": "0.5.0",
-        "@plurnk/plurnk-mimetypes-embeddings": "0.2.0",
-        "@plurnk/plurnk-providers": "0.12.0",
+        "@plurnk/plurnk-grammar": "0.73.0",
+        "@plurnk/plurnk-mimetypes": "0.15.21",
+        "@plurnk/plurnk-mimetypes-all": "0.5.1",
+        "@plurnk/plurnk-providers": "0.13.0",
         "@plurnk/plurnk-providers-all": "0.8.0",
-        "@plurnk/plurnk-schemes": "0.21.0",
-        "@plurnk/plurnk-schemes-all": "0.1.5",
+        "@plurnk/plurnk-schemes": "0.28.0",
+        "@plurnk/plurnk-schemes-all": "0.1.11",
         "@possumtech/sqlrite": "5.2.0",
         "diff": "^9.0.0",
         "ws": "^8.20.1"
     },
     "devDependencies": {
+        "@plurnk/plurnk-mimetypes-embeddings": "0.3.0",
         "@types/diff": "^7.0.2",
         "@types/node": "^25.8.0",
         "@types/ws": "^8.18.1",
         "typescript": "^6.0.3"
+    },
+    "peerDependencies": {
+        "@plurnk/plurnk-mimetypes-embeddings": "0.3.0"
+    },
+    "peerDependenciesMeta": {
+        "@plurnk/plurnk-mimetypes-embeddings": {
+            "optional": true
+        }
     }
 }

package/requirements.md

@@ -1,2 +1,3 @@
-YOU MUST use OPEN and FOLD to keep your context budget healthy, optimized, topical, and below the `tokensFree` limit.
+YOU MUST begin the turn with <<PLAN:...:PLAN
+YOU MUST use OPEN and FOLD to keep your context budget healthy, optimized, topical, and below the `TokensFree` limit.
 YOU MUST terminate the turn by SENDing a status code containing the results, answer, or a status update: `<<SEND[{102|200|202|499}]:...:SEND`

package/bin/plurnk-service.ts

@@ -1,176 +0,0 @@
-#!/usr/bin/env node
-
-import { parseArgs } from "node:util";
-import { existsSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, resolve } from "node:path";
-import SqlRite from "@possumtech/sqlrite";
-import type { Db } from "../src/core/Db.ts";
-import Daemon from "../src/server/Daemon.ts";
-import EnvFlags from "../src/core/EnvFlags.ts";
-import ProviderInstantiate from "../src/core/ProviderInstantiate.ts";
-import { resolveActiveAlias } from "@plurnk/plurnk-providers";
-
-export default class Cli {
-    static #projectRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
-
-    static #die(code: number, message: string): never {
-        process.stderr.write(`${message}\n`);
-        process.exit(code);
-    }
-
-    static #loadEnv(path: string, required: boolean): void {
-        if (existsSync(path)) {
-            try { process.loadEnvFile(path); }
-            catch (cause) { Cli.#die(64, `failed to load ${path}: ${cause instanceof Error ? cause.message : String(cause)}`); }
-        } else if (required) {
-            Cli.#die(64, `${path} does not exist`);
-        }
-    }
-
-    // node-style env-file flags: --env-file=<path> (required) / --env-file-if-exists=<path>
-    // (skip if missing), repeatable, in command-line order. They layer extra files ABOVE
-    // the .env cascade but BELOW shell env (loadEnvFile is set-if-unset) and the --<knob>
-    // CLI flags (assigned last). The `=` form only — node's canonical syntax (so it never
-    // leaks a positional). NB: node validates these paths from the full argv (and exits on
-    // a missing *required* one), but only LOADS pre-script files — the post-script loading
-    // a published `plurnk-service --env-file=…` needs is this.
-    static #envFileArgs(): Array<{ path: string; required: boolean }> {
-        return process.argv.flatMap((a): Array<{ path: string; required: boolean }> => {
-            if (a.startsWith("--env-file-if-exists=")) return [{ path: a.slice(a.indexOf("=") + 1), required: false }];
-            if (a.startsWith("--env-file=")) return [{ path: a.slice(a.indexOf("=") + 1), required: true }];
-            return [];
-        });
-    }
-
-    // The .env cascade always populates these from .env.example, so absence is
-    // a broken config, not a runtime branch — fail hard rather than `?? ""`.
-    static #requireEnv(name: string): string {
-        const value = process.env[name];
-        if (value === undefined || value.length === 0) Cli.#die(78, `missing required env ${name} (declare it in .env.example)`);
-        return value;
-    }
-
-    // Optional integer sqlite tuning knob — undefined when unset (so it never clobbers
-    // sqlrite's default by spreading an explicit `undefined`); fail-hard on a non-integer.
-    static #sqliteKnob(name: string): number | undefined {
-        const raw = process.env[name];
-        if (raw === undefined || raw.trim() === "") return undefined;
-        const n = Number(raw);
-        if (!Number.isInteger(n)) Cli.#die(78, `${name} must be an integer, got ${JSON.stringify(raw)}`);
-        return n;
-    }
-
-    static async #openDb(dbPath: string): Promise<Db> {
-        // Curated sqlite tuning (sqlrite 5.2.0, #7) — pass through ONLY the knobs the
-        // operator set, so an unset one keeps sqlrite's default (e.g. busy_timeout=5000).
-        const tuning: Record<string, number> = {};
-        for (const [env, opt] of [
-            ["PLURNK_SQLITE_TIMEOUT", "timeout"],
-            ["PLURNK_SQLITE_CACHE_SIZE", "cacheSize"],
-            ["PLURNK_SQLITE_MMAP_SIZE", "mmapSize"],
-            ["PLURNK_SQLITE_MAX_PAGE_COUNT", "maxPageCount"],
-        ] as const) {
-            const v = Cli.#sqliteKnob(env);
-            if (v !== undefined) tuning[opt] = v;
-        }
-        const db = await SqlRite.open({
-            path: dbPath,
-            dir: [resolve(Cli.#projectRoot, "migrations"), resolve(Cli.#projectRoot, "src")],
-            functions: [resolve(Cli.#projectRoot, "src/schemes/cosine.ts")],
-            ...tuning,
-        });
-        return db as unknown as Db;
-    }
-
-    static async #migrate(): Promise<void> {
-        const dbPath = Cli.#requireEnv("PLURNK_DB_PATH");
-        const db = await Cli.#openDb(dbPath);
-        try { process.stdout.write(`migrated: ${dbPath}\n`); }
-        finally { await db.close(); }
-    }
-
-    static async #start(): Promise<void> {
-        const dbPath = Cli.#requireEnv("PLURNK_DB_PATH");
-        const host = Cli.#requireEnv("PLURNK_HOST");
-        const port = Number(Cli.#requireEnv("PLURNK_PORT"));
-
-        const db = await Cli.#openDb(dbPath);
-        const alias = resolveActiveAlias();
-        const provider = alias === null ? null : await ProviderInstantiate.loadActiveProvider();
-        const daemon = new Daemon({ db, provider });
-        const addr = await daemon.start({ host, port });
-        const aliasStr = alias === null ? "no model" : `${alias.alias}=${alias.provider}/${alias.model}`;
-        process.stdout.write(`plurnk-service ws://${addr.host}:${addr.port} db=${dbPath} ${aliasStr}\n`);
-
-        const shutdown = async (): Promise<void> => { await daemon.stop(); await db.close(); process.exit(0); };
-        process.on("SIGINT", shutdown);
-        process.on("SIGTERM", shutdown);
-    }
-
-    static async main(): Promise<void> {
-        // Env cascade, highest precedence loads FIRST (loadEnvFile is set-if-unset,
-        // first write wins): --env-file(s) < --config < .env < .env.example, all of them
-        // OUTRANKED by pre-set shell env, then by the --<knob> CLI flags (assigned last,
-        // below). So --env-file overrides the .env files but never a shell var or a CLI
-        // arg — node-idiomatic layering.
-        for (const { path: envFile, required } of Cli.#envFileArgs()) Cli.#loadEnv(envFile, required);
-
-        const configFlagIndex = process.argv.findIndex((a) => a === "--config" || a.startsWith("--config="));
-        const configFile = ((): string | null => {
-            if (configFlagIndex === -1) return null;
-            const arg = process.argv[configFlagIndex];
-            if (arg.includes("=")) return arg.slice(arg.indexOf("=") + 1);
-            return process.argv[configFlagIndex + 1] ?? null;
-        })();
-
-        if (configFile !== null) Cli.#loadEnv(configFile, true);
-        Cli.#loadEnv(".env", false);
-        Cli.#loadEnv(resolve(Cli.#projectRoot, ".env.example"), false);
-
-        const flagDescriptors = await EnvFlags.parseEnvExample(resolve(Cli.#projectRoot, ".env.example"));
-        const flagOptions: Record<string, { type: "string" }> = {};
-        for (const f of flagDescriptors) {
-            flagOptions[f.flagName.replace(/^--/, "")] = { type: "string" };
-        }
-
-        const usage = `usage: plurnk-service [options] [migrate]
-
-${EnvFlags.formatFlagsHelp(flagDescriptors)}
-
-  --env-file=<path>            layer env from <path> (repeatable; errors if missing)
-  --env-file-if-exists=<path>  layer env from <path> if present (repeatable)
-  --config=<path>              layer additional env from <path>
-  -h, --help                   show this help
-`;
-
-        const { positionals, values } = parseArgs({
-            allowPositionals: true,
-            strict: false,
-            options: { help: { type: "boolean", short: "h" }, config: { type: "string" }, ...flagOptions },
-        });
-
-        for (const f of flagDescriptors) {
-            const key = f.flagName.replace(/^--/, "");
-            const v = values[key];
-            if (typeof v === "string") process.env[f.envName] = v;
-        }
-
-        if (values.help) { process.stdout.write(usage); process.exit(0); }
-
-        const dispatch: Record<string, () => Promise<void>> = { migrate: Cli.#migrate, start: Cli.#start };
-        const subcommand = typeof positionals[0] === "string" ? positionals[0] : "start";
-        const handler = dispatch[subcommand];
-        if (handler === undefined) Cli.#die(64, `unknown subcommand: ${subcommand}\n\n${usage}`);
-        if (positionals.length > 1) Cli.#die(64, `unexpected arguments: ${positionals.slice(1).join(" ")}`);
-
-        try { await handler(); }
-        catch (cause) {
-            process.stderr.write(`${subcommand}: ${cause instanceof Error ? cause.message : String(cause)}\n`);
-            if (cause instanceof Error && cause.cause) process.stderr.write(`  cause: ${cause.cause instanceof Error ? cause.cause.message : String(cause.cause)}\n`);
-            process.exit(1);
-        }
-    }
-}
-
-await Cli.main();

package/dist/core/ProviderRegistry.d.ts

@@ -1,42 +0,0 @@
-interface ChatMessage {
-    role: "system" | "user" | "assistant";
-    content: string;
-}
-export interface ProviderUsage {
-    readonly prompt: number;
-    readonly completion: number;
-    readonly cached: number;
-    readonly total: number;
-}
-export interface ProviderAssistant {
-    readonly content: string;
-    readonly reasoning: string | null;
-    readonly usage: ProviderUsage;
-    readonly finishReason: string | null;
-    readonly model: string;
-}
-export interface ProviderResponse {
-    readonly assistant: ProviderAssistant;
-    readonly assistantRaw: unknown;
-}
-export interface Provider {
-    generate(args: {
-        messages: ChatMessage[];
-        signal?: AbortSignal;
-    }): Promise<ProviderResponse>;
-    readonly contextSize: number | null;
-    readonly model: string;
-    countTokens(text: string): number;
-    costFor(usage: ProviderUsage): number;
-}
-export interface ProviderAlias {
-    readonly alias: string;
-    readonly provider: string;
-    readonly model: string;
-}
-export declare const parseAliasesFromEnv: (env?: NodeJS.ProcessEnv) => ProviderAlias[];
-export declare const resolveActiveAlias: (env?: NodeJS.ProcessEnv) => ProviderAlias | null;
-export declare const instantiateProvider: (alias: ProviderAlias, env?: NodeJS.ProcessEnv) => Promise<Provider>;
-export declare const loadActiveProvider: (env?: NodeJS.ProcessEnv) => Promise<Provider | null>;
-export {};
-//# sourceMappingURL=ProviderRegistry.d.ts.map

package/dist/core/ProviderRegistry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ProviderRegistry.d.ts","sourceRoot":"","sources":["../../src/core/ProviderRegistry.ts"],"names":[],"mappings":"AAWA,UAAU,WAAW;IAAG,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAYhF,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AACD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAClC;AACD,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAK7F,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAMvB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAKlC,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,mBAAmB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,aAAa,EAgBvF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAK,MAAM,CAAC,UAAwB,KAAG,aAAa,GAAG,IAKzF,CAAC;AAcF,eAAO,MAAM,mBAAmB,GAAU,OAAO,aAAa,EAAE,MAAK,MAAM,CAAC,UAAwB,KAAG,OAAO,CAAC,QAAQ,CAmBtH,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAU,MAAK,MAAM,CAAC,UAAwB,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAItG,CAAC"}

package/dist/core/ProviderRegistry.js

@@ -1,72 +0,0 @@
-// Model alias resolution. Reads PLURNK_MODEL_<alias>=<provider>/<model> env
-// vars; PLURNK_MODEL=<alias> selects which to use at boot. Each alias maps
-// to a provider plugin (`@plurnk/plurnk-providers-<provider>`); the registry
-// imports the matching package and constructs it with provider-specific
-// env conventions.
-//
-// Rummy parallel: RUMMY_MODEL_<alias>="<provider>/<model>" cascade. The
-// first path segment selects the provider plugin; the rest is the
-// provider's own identifier (may contain "/" for tri-level providers like
-// openrouter's publisher/model).
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-export const parseAliasesFromEnv = (env = process.env) => {
-    const out = [];
-    for (const [key, value] of Object.entries(env)) {
-        if (value === undefined || value.length === 0)
-            continue;
-        if (!key.startsWith("PLURNK_MODEL_"))
-            continue;
-        const aliasRaw = key.slice("PLURNK_MODEL_".length);
-        if (aliasRaw.length === 0)
-            continue;
-        const slash = value.indexOf("/");
-        if (slash <= 0)
-            continue;
-        out.push({
-            alias: aliasRaw.toLowerCase(),
-            provider: value.slice(0, slash),
-            model: value.slice(slash + 1),
-        });
-    }
-    return out;
-};
-export const resolveActiveAlias = (env = process.env) => {
-    const selected = env.PLURNK_MODEL;
-    if (selected === undefined || selected.length === 0)
-        return null;
-    const aliases = parseAliasesFromEnv(env);
-    return aliases.find((a) => a.alias === selected.toLowerCase()) ?? null;
-};
-export const instantiateProvider = async (alias, env = process.env) => {
-    const packageName = `@plurnk/plurnk-providers-${alias.provider}`;
-    let mod;
-    try {
-        mod = await import(__rewriteRelativeImportExtension(packageName));
-    }
-    catch (cause) {
-        throw new Error(`provider package ${packageName} not installed (alias '${alias.alias}' requires it): ` +
-            (cause instanceof Error ? cause.message : String(cause)));
-    }
-    const factory = mod.default;
-    if (typeof factory?.fromEnv !== "function") {
-        throw new Error(`${packageName}: default export must have a static \`fromEnv(env, model)\` factory ` +
-            `(plurnk-providers#1)`);
-    }
-    return await factory.fromEnv(env, alias.model);
-};
-// Convenience: resolve + instantiate in one call. Returns null when no
-// PLURNK_MODEL is set (caller decides what 'no provider' means).
-export const loadActiveProvider = async (env = process.env) => {
-    const alias = resolveActiveAlias(env);
-    if (alias === null)
-        return null;
-    return instantiateProvider(alias, env);
-};
-//# sourceMappingURL=ProviderRegistry.js.map

package/dist/core/ProviderRegistry.js.map

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