@plurnk/plurnk-service 0.29.0 → 0.35.0

package/dist/server/version-info.js

@@ -0,0 +1,69 @@
+// #235 — version advertising for the client's update notifier. The daemon is the
+// long-lived, already-network-capable process, so it owns the registry poll: a one-shot
+// CLI does zero registry IO and just renders what `discover` hands it. We self-report the
+// installed version and poll npm for `latest` of the service + client packages — CACHED
+// (TTL) and BEST-EFFORT (offline / registry-down omits `latest`; never blocks `discover`).
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve, join } from "node:path";
+const PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+const SERVICE_PKG = "@plurnk/plurnk-service";
+const CLIENT_PKG = "@plurnk/plurnk";
+export default class VersionInfo {
+    static #installed;
+    static #cache = { service: undefined, client: undefined, at: 0 };
+    static #inflight = false;
+    // `discover` rides this. Returns immediately with whatever is cached; a stale/cold
+    // cache triggers a background refresh (never awaited), so the call never blocks on the
+    // network. `installed` is the daemon's honest self-report; `latest` is best-effort.
+    static async get() {
+        const installed = await VersionInfo.#installedVersion();
+        VersionInfo.#maybeRefresh();
+        const { service, client } = VersionInfo.#cache;
+        return {
+            service: service === undefined ? { installed } : { installed, latest: service },
+            client: client === undefined ? {} : { latest: client },
+        };
+    }
+    static async #installedVersion() {
+        if (VersionInfo.#installed === undefined) {
+            const raw = await readFile(join(PACKAGE_ROOT, "package.json"), "utf8");
+            VersionInfo.#installed = JSON.parse(raw).version;
+        }
+        return VersionInfo.#installed;
+    }
+    static #maybeRefresh() {
+        const ttl = VersionInfo.#envMs("PLURNK_VERSION_POLL_TTL", 0);
+        const timeout = VersionInfo.#envMs("PLURNK_FETCH_TIMEOUT", 1);
+        if (VersionInfo.#inflight || Date.now() - VersionInfo.#cache.at < ttl)
+            return;
+        VersionInfo.#inflight = true;
+        void VersionInfo.#refresh(timeout).finally(() => { VersionInfo.#inflight = false; });
+    }
+    // No code fallback hides a magic number — the law-file (.env.example) carries it.
+    static #envMs(name, min) {
+        const raw = process.env[name];
+        const n = raw === undefined ? Number.NaN : Number.parseInt(raw, 10);
+        if (!Number.isFinite(n) || n < min)
+            throw new Error(`${name} must be an integer >= ${min} (ms), got ${JSON.stringify(raw)}`);
+        return n;
+    }
+    static async #refresh(timeout) {
+        const [service, client] = await Promise.all([VersionInfo.#poll(SERVICE_PKG, timeout), VersionInfo.#poll(CLIENT_PKG, timeout)]);
+        // Keep the prior cached value on a failed poll (don't clobber a good `latest` with undefined).
+        VersionInfo.#cache = { service: service ?? VersionInfo.#cache.service, client: client ?? VersionInfo.#cache.client, at: Date.now() };
+    }
+    static async #poll(pkg, timeout) {
+        try {
+            const res = await fetch(`https://registry.npmjs.org/${pkg.replace("/", "%2F")}/latest`, { signal: AbortSignal.timeout(timeout) });
+            if (!res.ok)
+                return undefined;
+            const body = (await res.json());
+            return typeof body.version === "string" ? body.version : undefined;
+        }
+        catch {
+            return undefined; // best-effort: offline / registry-down / abort → omit `latest`
+        }
+    }
+}
+//# sourceMappingURL=version-info.js.map

package/dist/server/version-info.js.map

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

package/dist/server/yolo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"yolo.d.ts","sourceRoot":"","sources":["../../src/server/yolo.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI;CAWnD"}
+{"version":3,"file":"yolo.d.ts","sourceRoot":"","sources":["../../src/server/yolo.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,IAAI;CAoBnD"}

package/dist/server/yolo.js

@@ -34,10 +34,19 @@
 // lets clients suppress review-UI rendering for those entries.
 export default class Yolo {
     static attachYolo(engine, _db) {
+        // §dual-yolo-server-yolo-auto-accept
         engine.onProposalPending((event) => {
             if (!event.flags.yolo)
                 return;
             try {
+                if (event.staleClobberRisk) {
+                    // #note10 — the target diverged on disk this turn; the model's EDIT is
+                    // based on a stale read. Reject rather than silently clobber the ambient
+                    // change. The model sees an ordinary reject (outcome is forensics-only)
+                    // and can re-READ the entry + retry against the current content.
+                    engine.resolveProposal(event.logEntryId, { decision: "reject", outcome: "stale_read_clobber" });
+                    return;
+                }
                 engine.resolveProposal(event.logEntryId, { decision: "accept" });
             }
             catch {

package/dist/server/yolo.js.map

@@ -1 +1 @@
-{"version":3,"file":"yolo.js","sourceRoot":"","sources":["../../src/server/yolo.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,EAAE;AACF,0CAA0C;AAC1C,EAAE;AACF,uEAAuE;AACvE,sBAAsB;AACtB,EAAE;AACF,iCAAiC;AACjC,yDAAyD;AACzD,qDAAqD;AACrD,0EAA0E;AAC1E,2EAA2E;AAC3E,oEAAoE;AACpE,yEAAyE;AACzE,wBAAwB;AACxB,2EAA2E;AAC3E,qEAAqE;AACrE,EAAE;AACF,2DAA2D;AAC3D,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,2BAA2B;AAC3B,sEAAsE;AACtE,6EAA6E;AAC7E,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,+DAA+D;AAM/D,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,UAAU,CAAC,MAAc,EAAE,GAAO;QACrC,MAAM,CAAC,iBAAiB,CAAC,CAAC,KAA2B,EAAE,EAAE;YACrD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;gBAAE,OAAO;YAC9B,IAAI,CAAC;gBACD,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACL,wDAAwD;gBACxD,uDAAuD;YAC3D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}
+{"version":3,"file":"yolo.js","sourceRoot":"","sources":["../../src/server/yolo.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,EAAE;AACF,0CAA0C;AAC1C,EAAE;AACF,uEAAuE;AACvE,sBAAsB;AACtB,EAAE;AACF,iCAAiC;AACjC,yDAAyD;AACzD,qDAAqD;AACrD,0EAA0E;AAC1E,2EAA2E;AAC3E,oEAAoE;AACpE,yEAAyE;AACzE,wBAAwB;AACxB,2EAA2E;AAC3E,qEAAqE;AACrE,EAAE;AACF,2DAA2D;AAC3D,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,2BAA2B;AAC3B,sEAAsE;AACtE,6EAA6E;AAC7E,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,+DAA+D;AAM/D,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,UAAU,CAAC,MAAc,EAAE,GAAO;QACrC,qCAAqC;QACrC,MAAM,CAAC,iBAAiB,CAAC,CAAC,KAA2B,EAAE,EAAE;YACrD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;gBAAE,OAAO;YAC9B,IAAI,CAAC;gBACD,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;oBACzB,uEAAuE;oBACvE,yEAAyE;oBACzE,wEAAwE;oBACxE,iEAAiE;oBACjE,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC;oBAChG,OAAO;gBACX,CAAC;gBACD,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YACrE,CAAC;YAAC,MAAM,CAAC;gBACL,wDAAwD;gBACxD,uDAAuD;YAC3D,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/migrations/0000-00-00.01_schema.sql

@@ -2,8 +2,6 @@
 -- project_root: workspace pointer. NULL = headless (no disk side-effects);
 -- non-null = absolute path to the client's source tree, supplied at
 -- session.create or session.set_root.
--- persona: head of the persona cascade (loops.persona > runs.persona >
--- sessions.persona > PATHS.defaultPersona). Nullable; null falls through.
 CREATE TABLE IF NOT EXISTS sessions (
     id                        INTEGER NOT NULL PRIMARY KEY,
     version                   INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
@@ -12,23 +10,23 @@ CREATE TABLE IF NOT EXISTS sessions (
     cost_pico                 INTEGER NOT NULL DEFAULT 0 CHECK (cost_pico >= 0),
     scheme_registry_additions TEXT    NOT NULL DEFAULT '[]' CHECK (json_valid(scheme_registry_additions)),
     project_root              TEXT,
-    persona                   TEXT
+    -- #231 client-chosen session-open context: { manifestItems?, mdDocs? }, read at turn-0
+    -- with precedence over env (manifestItems replaces PLURNK_MANIFEST_ITEMS; mdDocs unions PLURNK_MD_*).
+    settings                  TEXT    NOT NULL DEFAULT '{}' CHECK (json_valid(settings))
 ) STRICT;
 
 CREATE INDEX IF NOT EXISTS sessions_created_at ON sessions (created_at);
 
 -- INIT: runs
--- persona: middle of the persona cascade (loops > runs > sessions > default).
--- Nullable; null falls through to the session level.
 CREATE TABLE IF NOT EXISTS runs (
     id            INTEGER NOT NULL PRIMARY KEY,
     version       INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
     session_id    INTEGER NOT NULL,
     name          TEXT    NOT NULL CHECK (length(name) > 0),
     created_at    TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    -- runs fork via parent_run_id; sessions carry no parent — §machine-processes-no-fork-session
     parent_run_id INTEGER          CHECK (parent_run_id IS NULL OR parent_run_id != id),
     cost_pico     INTEGER NOT NULL DEFAULT 0 CHECK (cost_pico >= 0),
-    persona       TEXT,
     origin        TEXT    NOT NULL DEFAULT 'client' CHECK (origin IN ('model', 'client', 'plurnk')),
     FOREIGN KEY (session_id)    REFERENCES sessions(id) ON DELETE CASCADE,
     FOREIGN KEY (parent_run_id) REFERENCES runs(id)     ON DELETE CASCADE
@@ -43,7 +41,6 @@ CREATE UNIQUE INDEX IF NOT EXISTS runs_session_name          ON runs (session_id
 -- mode). JSON column, merged over DEFAULT_LOOP_FLAGS in code so missing
 -- keys read as their defaults. SchemeRegistry.resolveForLoop gates schemes
 -- by manifest affinity (proposes / excludedInAsk / requiresWeb / etc).
--- persona: head of the cascade (loops > runs > sessions > default).
 CREATE TABLE IF NOT EXISTS loops (
     id       INTEGER NOT NULL PRIMARY KEY,
     version  INTEGER NOT NULL DEFAULT 0   CHECK (version >= 0),
@@ -52,12 +49,28 @@ CREATE TABLE IF NOT EXISTS loops (
     status   INTEGER NOT NULL DEFAULT 102 CHECK (status IN (100, 102, 200, 499)),
     prompt   TEXT    NOT NULL,
     flags    TEXT    NOT NULL DEFAULT '{}' CHECK (json_valid(flags)),
-    persona  TEXT,
+    -- §run-scheme loop-termination delta: terminated_at is stamped by the trigger
+    -- below when status crosses into terminal (every death-path, uniformly);
+    -- terminal_message is the deliverable — the SEND[200] body or the abandonment
+    -- reason — set by the terminating PREP (engine_loop_set_status / _cancel).
+    terminated_at    TEXT,
+    terminal_message TEXT,
     FOREIGN KEY (run_id) REFERENCES runs(id) ON DELETE CASCADE
 ) STRICT;
 
 CREATE UNIQUE INDEX IF NOT EXISTS loops_run_id_sequence ON loops (run_id, sequence);
 
+-- §run-scheme: a loop crossing into a terminal status (200/499) stamps terminated_at,
+-- so sibling runs pull the termination as a folded ambient delta — the time is caught
+-- uniformly across every death-path (SEND, grinder, KILL). The stamp updates
+-- terminated_at, never status, so it cannot re-fire this trigger.
+CREATE TRIGGER IF NOT EXISTS loops_stamp_terminated_at
+AFTER UPDATE OF status ON loops
+WHEN NEW.status IN (200, 499) AND OLD.status NOT IN (200, 499)
+BEGIN
+    UPDATE loops SET terminated_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now') WHERE id = NEW.id;
+END;
+
 -- INIT: turns
 -- finish_reason / model: provider-call metadata (plurnk-grammar Turn.json).
 -- Properties of the call, not of the model's emission payload — kept on
@@ -114,6 +127,10 @@ CREATE TABLE IF NOT EXISTS entries (
     -- sync stat()s every member but re-reads/re-tokenizes/rewrites only one whose
     -- signature changed; an unchanged member is a no-op. NULL = never synced.
     synced_sig TEXT,
+    -- User Note 5 — manifest cache-friendliness. Last-modified stamp, bumped on every
+    -- channel write by entries_touch_on_channel_write; engine_list_session_entries orders
+    -- the catalog by it ASC so dormant entries hold the stable prompt-cache prefix.
+    updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
     CHECK ((scope = 'agent'   AND session_id IS NULL)
         OR (scope = 'session' AND session_id IS NOT NULL)),
     FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
@@ -122,7 +139,7 @@ CREATE TABLE IF NOT EXISTS entries (
 CREATE UNIQUE INDEX IF NOT EXISTS entries_agent_identity   ON entries (scheme, pathname)             WHERE scope = 'agent';
 CREATE UNIQUE INDEX IF NOT EXISTS entries_session_identity ON entries (session_id, scheme, pathname) WHERE scope = 'session';
 
--- The ONE engine-imposed constraint (SPEC §stream-constraints): 100 MiB char-length cap
+-- The ONE engine-imposed constraint (SPEC §stream-constraints, §stream-constraints-engine-one-cap): 100 MiB char-length cap
 -- per channel content body. All other limits are extrinsic.
 CREATE TABLE IF NOT EXISTS entry_channels (
     entry_id INTEGER NOT NULL,
@@ -135,6 +152,15 @@ CREATE TABLE IF NOT EXISTS entry_channels (
     FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
 ) STRICT, WITHOUT ROWID;
 
+-- User Note 5 — bump the entry's updated_at on any channel write so the catalog
+-- (ordered by updated_at ASC) keeps recently-touched entries at the tail and holds
+-- the prompt-cache prefix stable across turns.
+CREATE TRIGGER IF NOT EXISTS entries_touch_on_channel_write
+AFTER INSERT ON entry_channels
+BEGIN
+    UPDATE entries SET updated_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now') WHERE id = NEW.entry_id;
+END;
+
 CREATE TABLE IF NOT EXISTS entry_tags (
     entry_id INTEGER NOT NULL,
     tag      TEXT    NOT NULL CHECK (length(tag) > 0),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-service",
-    "version": "0.29.0",
+    "version": "0.35.0",
     "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-grammar contract.",
     "type": "module",
     "license": "MIT",
@@ -21,7 +21,6 @@
         "bin/plurnk-service.ts",
         "dist/**/*",
         "migrations/**/*.sql",
-        "persona.md",
         "requirements.md",
         "README.md",
         "SPEC.md"
@@ -33,7 +32,7 @@
         "start": "node bin/plurnk-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 && 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: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:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
@@ -45,15 +44,15 @@
         "prepare": "npm run build"
     },
     "dependencies": {
-        "@plurnk/plurnk-execs": "0.4.6",
+        "@plurnk/plurnk-execs": "0.4.8",
         "@plurnk/plurnk-execs-all": "0.1.5",
-        "@plurnk/plurnk-grammar": "0.44.0",
-        "@plurnk/plurnk-mimetypes": "0.15.15",
+        "@plurnk/plurnk-grammar": "0.54.0",
+        "@plurnk/plurnk-mimetypes": "0.15.17",
         "@plurnk/plurnk-mimetypes-embeddings": "0.2.0",
-        "@plurnk/plurnk-providers": "0.4.0",
-        "@plurnk/plurnk-providers-all": "^0.2.0",
-        "@plurnk/plurnk-schemes": "0.7.0",
-        "@plurnk/plurnk-schemes-http": "0.2.0",
+        "@plurnk/plurnk-providers": "0.7.0",
+        "@plurnk/plurnk-providers-all": "0.5.0",
+        "@plurnk/plurnk-schemes": "0.11.0",
+        "@plurnk/plurnk-schemes-http": "0.3.0",
         "@possumtech/sqlrite": "5.1.1",
         "diff": "^9.0.0",
         "ws": "^8.20.1"

package/requirements.md

@@ -1,10 +1,10 @@
 Syntax: <<OPsuffix[signal]?(target)?<Line/Result>?:body?:OPsuffix
 
-YOU MUST NOT use EXEC commands for actions that can be performed with Extended HEREDOC Plurnk Operations.
+YOU MUST ONLY use EXEC commands for actions that can't be performed with Extended HEREDOC Plurnk Operations.
 YOU MUST ONLY communicate with SEND, not with free text between operations.
 YOU MUST document all relevant questions and uncertainties into taxonomized, tagged, and topical unknown entries.
 YOU MUST ONLY populate known entries with source entry information, never with model training.
 YOU SHOULD manage your own context to maximize signal, as irrelevant tokens degrade reasoning.
 YOU SHOULD leverage folksonomic path names, tags, and bulk pattern operations to optimize for context relevance.
 YOU MUST use OPEN and FOLD to keep your context budget healthy, optimized, and topical, below the `tokensFree` limit.
-YOU MUST terminate the turn with either a continuing (102) or loop terminating (200) `<<SEND[102]:status update:SEND`
+YOU MUST terminate the turn with either a loop continuing (102) or loop terminating (200) user message or brief status update `<<SEND[N]:...:SEND`

package/persona.md

@@ -1 +0,0 @@
-You are an assistant. Resolve the most recent user prompt.