@plurnk/plurnk-service 0.28.0 → 0.34.0

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),
@@ -11,24 +9,21 @@ CREATE TABLE IF NOT EXISTS sessions (
     created_at                TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
     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
+    project_root              TEXT
 ) 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 +38,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,7 +46,6 @@ 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,
     FOREIGN KEY (run_id) REFERENCES runs(id) ON DELETE CASCADE
 ) STRICT;
 
@@ -114,6 +107,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 +119,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 +132,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.28.0",
+    "version": "0.34.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.16",
         "@plurnk/plurnk-mimetypes-embeddings": "0.2.0",
-        "@plurnk/plurnk-providers": "0.3.0",
-        "@plurnk/plurnk-providers-all": "0.1.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.