@plurnk/plurnk-service 0.2.0 → 0.3.0

package/migrations/001_schema.sql

@@ -0,0 +1,324 @@
+-- INIT: sessions
+-- 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),
+    name                      TEXT    NOT NULL UNIQUE CHECK (length(name) > 0),
+    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
+) 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')),
+    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,
+    FOREIGN KEY (session_id)    REFERENCES sessions(id) ON DELETE CASCADE,
+    FOREIGN KEY (parent_run_id) REFERENCES runs(id)     ON DELETE CASCADE
+) STRICT;
+
+CREATE        INDEX IF NOT EXISTS runs_session_id_created_at ON runs (session_id, created_at);
+CREATE        INDEX IF NOT EXISTS runs_parent_run_id         ON runs (parent_run_id);
+CREATE UNIQUE INDEX IF NOT EXISTS runs_session_name          ON runs (session_id, name);
+
+-- INIT: loops
+-- flags: per-loop runtime flags (yolo, noProposals, noWeb, noInteraction,
+-- 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),
+    run_id   INTEGER NOT NULL,
+    sequence INTEGER NOT NULL             CHECK (sequence >= 1),
+    status   INTEGER NOT NULL DEFAULT 102 CHECK (status IN (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;
+
+CREATE UNIQUE INDEX IF NOT EXISTS loops_run_id_sequence ON loops (run_id, sequence);
+
+-- 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
+-- the Turn row alongside usage rather than nested into packet.assistant.
+CREATE TABLE IF NOT EXISTS turns (
+    id               INTEGER NOT NULL PRIMARY KEY,
+    version          INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+    loop_id          INTEGER NOT NULL,
+    sequence         INTEGER NOT NULL           CHECK (sequence >= 1),
+    timestamp        TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    status           INTEGER NOT NULL           CHECK (status BETWEEN 100 AND 599),
+    usage_prompt     INTEGER NOT NULL DEFAULT 0 CHECK (usage_prompt >= 0),
+    usage_completion INTEGER NOT NULL DEFAULT 0 CHECK (usage_completion >= 0),
+    usage_cached     INTEGER NOT NULL DEFAULT 0 CHECK (usage_cached >= 0),
+    usage_cost_pico  INTEGER NOT NULL DEFAULT 0 CHECK (usage_cost_pico >= 0),
+    packet           TEXT    NOT NULL           CHECK (json_valid(packet)),
+    finish_reason    TEXT,
+    model            TEXT    NOT NULL DEFAULT 'unknown' CHECK (length(model) >= 1),
+    FOREIGN KEY (loop_id) REFERENCES loops(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS turns_loop_id_sequence ON turns (loop_id, sequence);
+CREATE        INDEX IF NOT EXISTS turns_timestamp        ON turns (timestamp);
+
+-- INIT: entries
+-- The canonical addressable store. (scope, scheme, pathname) is the
+-- identity tuple. scheme is nullable: the `file` scheme is a routing
+-- internal only, never stored here; bare/file paths land with scheme=NULL.
+CREATE TABLE IF NOT EXISTS entries (
+    id         INTEGER NOT NULL PRIMARY KEY,
+    version    INTEGER NOT NULL DEFAULT 0   CHECK (version >= 0),
+    scope      TEXT    NOT NULL             CHECK (scope IN ('agent', 'session')),
+    session_id INTEGER,
+    scheme     TEXT                         CHECK (scheme IS NULL OR length(scheme) > 0),
+    username   TEXT,
+    password   TEXT,
+    hostname   TEXT,
+    port       INTEGER                      CHECK (port IS NULL OR (port BETWEEN 0 AND 65535)),
+    pathname   TEXT    NOT NULL,
+    params     TEXT                         CHECK (params IS NULL OR json_valid(params)),
+    attributes TEXT    NOT NULL DEFAULT '{}' CHECK (json_valid(attributes)),
+    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
+) STRICT;
+
+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 §7.8): 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,
+    name     TEXT    NOT NULL             CHECK (length(name) > 0),
+    content  TEXT    NOT NULL             CHECK (length(content) <= 104857600),
+    mimetype TEXT    NOT NULL             CHECK (length(mimetype) > 0),
+    tokens   INTEGER NOT NULL DEFAULT 0   CHECK (tokens >= 0),
+    state    TEXT    NOT NULL DEFAULT 'static' CHECK (state IN ('static', 'active', 'closed', 'errored')),
+    PRIMARY KEY (entry_id, name),
+    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
+) STRICT, WITHOUT ROWID;
+
+CREATE TABLE IF NOT EXISTS entry_tags (
+    entry_id INTEGER NOT NULL,
+    tag      TEXT    NOT NULL CHECK (length(tag) > 0),
+    PRIMARY KEY (entry_id, tag),
+    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
+) STRICT, WITHOUT ROWID;
+
+CREATE INDEX IF NOT EXISTS entry_tags_tag ON entry_tags (tag);
+
+-- INIT: log_entries
+-- Chronological event store. sequence is 1-based, scoped to the turn —
+-- resets at each new turn. URI-bit columns are unprefixed (scheme,
+-- pathname, …). state/outcome/attrs carry the proposal lifecycle —
+-- status⊥state: status is the HTTP outcome, state is where in the
+-- lifecycle the entry sits. Most rows write 'resolved' directly;
+-- proposing schemes transition 'proposed' → resolved/failed/cancelled.
+-- indexed: per-row visibility for SHOW/HIDE via the log:// scheme.
+CREATE TABLE IF NOT EXISTS log_entries (
+    id              INTEGER NOT NULL PRIMARY KEY,
+    version         INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+
+    run_id          INTEGER NOT NULL,
+    loop_id         INTEGER NOT NULL,
+    turn_id         INTEGER NOT NULL,
+    sequence        INTEGER NOT NULL           CHECK (sequence >= 1),
+    at              TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    origin          TEXT    NOT NULL           CHECK (origin IN ('model', 'client', 'system', 'plugin')),
+
+    op              TEXT    NOT NULL           CHECK (op IN ('FIND', 'READ', 'EDIT', 'COPY', 'MOVE', 'SHOW', 'HIDE', 'SEND', 'EXEC')),
+    suffix          TEXT    NOT NULL DEFAULT '',
+    signal          TEXT                       CHECK (signal IS NULL OR json_valid(signal)),
+
+    scheme          TEXT                       CHECK (scheme IS NULL OR length(scheme) > 0),
+    username        TEXT,
+    password        TEXT,
+    hostname        TEXT,
+    port            INTEGER                    CHECK (port IS NULL OR (port BETWEEN 0 AND 65535)),
+    pathname        TEXT,
+    params          TEXT                       CHECK (params IS NULL OR json_valid(params)),
+    fragment        TEXT,
+
+    lineMarker      TEXT                       CHECK (lineMarker IS NULL OR json_valid(lineMarker)),
+
+    tx              TEXT    NOT NULL,
+    mimetype_tx     TEXT    NOT NULL           CHECK (length(mimetype_tx) > 0),
+
+    rx              TEXT    NOT NULL,
+    mimetype_rx     TEXT    NOT NULL           CHECK (length(mimetype_rx) > 0),
+    status_rx       INTEGER NOT NULL           CHECK (status_rx BETWEEN 100 AND 599),
+
+    tokens          INTEGER NOT NULL DEFAULT 0 CHECK (tokens >= 0),
+
+    state           TEXT    NOT NULL DEFAULT 'resolved'
+                    CHECK (state IN ('proposed', 'resolved', 'failed', 'cancelled')),
+    outcome         TEXT,
+    attrs           TEXT    NOT NULL DEFAULT '{}' CHECK (json_valid(attrs)),
+
+    indexed         INTEGER NOT NULL DEFAULT 1 CHECK (indexed IN (0, 1)),
+
+    FOREIGN KEY (run_id)  REFERENCES runs(id)  ON DELETE CASCADE,
+    FOREIGN KEY (loop_id) REFERENCES loops(id) ON DELETE CASCADE,
+    FOREIGN KEY (turn_id) REFERENCES turns(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS log_entries_turn_id_sequence ON log_entries (turn_id, sequence);
+CREATE        INDEX IF NOT EXISTS log_entries_run_id           ON log_entries (run_id);
+CREATE        INDEX IF NOT EXISTS log_entries_loop_id          ON log_entries (loop_id);
+CREATE        INDEX IF NOT EXISTS log_entries_at               ON log_entries (at);
+
+-- Column-scoped immutability: the original action's identity and target
+-- never change; the proposal lifecycle is allowed to mutate state,
+-- outcome, status_rx, rx, indexed.
+CREATE TRIGGER IF NOT EXISTS log_entries_immutable_core
+BEFORE UPDATE OF
+    run_id, loop_id, turn_id, sequence, at, origin,
+    op, suffix, signal,
+    scheme, username, password, hostname,
+    port, pathname, params, fragment,
+    lineMarker, tx, mimetype_tx, mimetype_rx, attrs
+ON log_entries
+BEGIN
+    SELECT RAISE(ABORT, 'log_entries core fields are immutable; only state/outcome/status_rx/rx/indexed may change');
+END;
+
+-- INIT: visibility
+-- Per-(run, entry, channel) visibility for the index. SHOW/HIDE toggle
+-- the indexed bit; render-time queries filter where indexed=1.
+CREATE TABLE IF NOT EXISTS visibility (
+    run_id   INTEGER NOT NULL,
+    entry_id INTEGER NOT NULL,
+    channel  TEXT    NOT NULL           CHECK (length(channel) > 0),
+    indexed  INTEGER NOT NULL DEFAULT 1 CHECK (indexed IN (0, 1)),
+    PRIMARY KEY (run_id, entry_id, channel),
+    FOREIGN KEY (run_id)   REFERENCES runs(id)    ON DELETE CASCADE,
+    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
+) STRICT, WITHOUT ROWID;
+
+-- INIT: schemes_providers
+-- Scheme/provider catalog. Schemes are static (registered at boot);
+-- providers carry per-model metadata for cost accounting and selection.
+CREATE TABLE IF NOT EXISTS schemes (
+    name                 TEXT    NOT NULL PRIMARY KEY CHECK (length(name) > 0),
+    model_visible        INTEGER NOT NULL             CHECK (model_visible IN (0, 1)),
+    category             TEXT    NOT NULL             CHECK (length(category) > 0),
+    default_scope        TEXT    NOT NULL             CHECK (default_scope IN ('agent', 'session')),
+    default_channel      TEXT    NOT NULL             CHECK (length(default_channel) > 0),
+    channel_orientations TEXT                         CHECK (channel_orientations IS NULL OR json_valid(channel_orientations)),
+    writable_by          TEXT    NOT NULL             CHECK (json_valid(writable_by)),
+    volatile             INTEGER NOT NULL             CHECK (volatile IN (0, 1)),
+    handler              TEXT
+) STRICT, WITHOUT ROWID;
+
+CREATE TABLE IF NOT EXISTS providers (
+    id          INTEGER NOT NULL PRIMARY KEY,
+    version     INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+    provider    TEXT    NOT NULL           CHECK (length(provider) > 0),
+    family      TEXT    NOT NULL           CHECK (length(family) > 0),
+    model       TEXT    NOT NULL           CHECK (length(model) > 0),
+    contextSize INTEGER NOT NULL           CHECK (contextSize >= 1),
+    currency    TEXT    NOT NULL           CHECK (length(currency) = 3),
+    created_at  TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+) STRICT;
+
+CREATE INDEX IF NOT EXISTS providers_created_at ON providers (created_at);
+
+-- INIT: cost_rollups
+-- Triggers maintaining denormalized cost_pico totals on runs and sessions
+-- as turns insert/update. Pure denormalization (textbook trigger use);
+-- no branching state-machine logic lives here.
+CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_insert_run
+AFTER INSERT ON turns
+BEGIN
+    UPDATE runs
+       SET cost_pico = cost_pico + NEW.usage_cost_pico
+     WHERE id = (SELECT run_id FROM loops WHERE id = NEW.loop_id);
+END;
+
+CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_insert_session
+AFTER INSERT ON turns
+BEGIN
+    UPDATE sessions
+       SET cost_pico = cost_pico + NEW.usage_cost_pico
+     WHERE id = (
+         SELECT r.session_id
+           FROM runs r
+           JOIN loops l ON l.run_id = r.id
+          WHERE l.id = NEW.loop_id
+     );
+END;
+
+CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_update_run
+AFTER UPDATE OF usage_cost_pico ON turns
+WHEN NEW.usage_cost_pico != OLD.usage_cost_pico
+BEGIN
+    UPDATE runs
+       SET cost_pico = cost_pico + NEW.usage_cost_pico - OLD.usage_cost_pico
+     WHERE id = (SELECT run_id FROM loops WHERE id = NEW.loop_id);
+END;
+
+CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_update_session
+AFTER UPDATE OF usage_cost_pico ON turns
+WHEN NEW.usage_cost_pico != OLD.usage_cost_pico
+BEGIN
+    UPDATE sessions
+       SET cost_pico = cost_pico + NEW.usage_cost_pico - OLD.usage_cost_pico
+     WHERE id = (
+         SELECT r.session_id
+           FROM runs r
+           JOIN loops l ON l.run_id = r.id
+          WHERE l.id = NEW.loop_id
+     );
+END;
+
+-- INIT: subscriptions
+-- Subscription registry per SPEC §7.1. Exists ONLY for cancellation
+-- routing (SEND[499] → lookup → scheme teardown). Closed rows persist
+-- for forensics; partial unique index enforces one active subscription
+-- per (run, entry).
+CREATE TABLE IF NOT EXISTS subscriptions (
+    id           INTEGER NOT NULL PRIMARY KEY,
+    version      INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+    run_id       INTEGER NOT NULL,
+    entry_id     INTEGER NOT NULL,
+    scheme       TEXT    NOT NULL CHECK (length(scheme) > 0),
+    handle       TEXT    NOT NULL CHECK (length(handle) > 0),
+    opened_at    TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    closed_at    TEXT,
+    close_status INTEGER          CHECK (close_status IS NULL OR (close_status BETWEEN 100 AND 599)),
+    CHECK ((closed_at IS NULL AND close_status IS NULL)
+        OR (closed_at IS NOT NULL AND close_status IS NOT NULL)),
+    FOREIGN KEY (run_id)   REFERENCES runs(id)    ON DELETE CASCADE,
+    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS subscriptions_active_one_per_entry
+    ON subscriptions (run_id, entry_id)
+    WHERE closed_at IS NULL;
+
+CREATE INDEX IF NOT EXISTS subscriptions_scheme_active
+    ON subscriptions (scheme)
+    WHERE closed_at IS NULL;
+
+CREATE INDEX IF NOT EXISTS subscriptions_opened_at ON subscriptions (opened_at);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-service",
-    "version": "0.2.0",
+    "version": "0.3.0",
     "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-grammar contract.",
     "type": "module",
     "license": "MIT",
@@ -30,10 +30,10 @@
     },
     "scripts": {
         "test:lint": "tsc --noEmit",
-        "test:unit": "node --test src/**/*.test.ts",
-        "test:intg": "node --env-file-if-exists=.env --test test/intg/*.test.ts",
-        "test:live": "node --env-file-if-exists=.env --test test/live/*.test.ts",
-        "test:demo": "node --env-file-if-exists=.env --test test/demo/*.test.ts",
+        "test:unit": "node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test src/**/*.test.ts",
+        "test:intg": "node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test test/intg/*.test.ts",
+        "test:live": "node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test test/live/*.test.ts",
+        "test:demo": "node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test 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.js",
         "dev:digest": "node bin/digest.js",
@@ -42,17 +42,23 @@
         "prepare": "npm run build"
     },
     "dependencies": {
-        "@plurnk/plurnk-grammar": "^0.7.1",
+        "@plurnk/plurnk-grammar": "^0.9.0",
         "@plurnk/plurnk-mimetypes": "^0.3.1",
         "@plurnk/plurnk-mimetypes-application-json": "^0.2.0",
+        "@plurnk/plurnk-mimetypes-application-pdf": "^0.3.0",
+        "@plurnk/plurnk-mimetypes-application-toml": "^0.1.0",
+        "@plurnk/plurnk-mimetypes-application-yaml": "^0.1.0",
+        "@plurnk/plurnk-mimetypes-text-csv": "^0.1.0",
+        "@plurnk/plurnk-mimetypes-text-html": "^0.1.0",
         "@plurnk/plurnk-mimetypes-text-markdown": "^0.2.0",
         "@plurnk/plurnk-mimetypes-text-plain": "^0.2.0",
-        "@plurnk/plurnk-providers-cloudflare": "github:plurnk/plurnk-providers-cloudflare",
-        "@plurnk/plurnk-providers-google": "github:plurnk/plurnk-providers-google",
-        "@plurnk/plurnk-providers-ollama": "github:plurnk/plurnk-providers-ollama",
-        "@plurnk/plurnk-providers-openai": "github:plurnk/plurnk-providers-openai",
-        "@plurnk/plurnk-providers-openrouter": "github:plurnk/plurnk-providers-openrouter",
-        "@plurnk/plurnk-providers-xai": "github:plurnk/plurnk-providers-xai",
+        "@plurnk/plurnk-mimetypes-text-typescript": "^0.1.0",
+        "@plurnk/plurnk-providers-cloudflare": "^0.2.0",
+        "@plurnk/plurnk-providers-google": "^0.2.0",
+        "@plurnk/plurnk-providers-ollama": "^0.2.0",
+        "@plurnk/plurnk-providers-openai": "^0.2.0",
+        "@plurnk/plurnk-providers-openrouter": "^0.2.0",
+        "@plurnk/plurnk-providers-xai": "^0.2.0",
         "@possumtech/sqlrite": "^3.1.0",
         "diff": "^7.0.0",
         "ws": "^8.20.1"

package/migrations/001_sessions.sql

@@ -1,11 +0,0 @@
--- INIT: sessions
-CREATE TABLE IF NOT EXISTS sessions (
-    id                        INTEGER NOT NULL PRIMARY KEY,
-    version                   INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
-    name                      TEXT    NOT NULL UNIQUE CHECK (length(name) > 0),
-    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))
-) STRICT;
-
-CREATE INDEX IF NOT EXISTS sessions_created_at ON sessions (created_at);

package/migrations/002_runs.sql

@@ -1,16 +0,0 @@
--- INIT: runs
-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')),
-    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),
-    FOREIGN KEY (session_id)    REFERENCES sessions(id) ON DELETE CASCADE,
-    FOREIGN KEY (parent_run_id) REFERENCES runs(id)     ON DELETE CASCADE
-) STRICT;
-
-CREATE        INDEX IF NOT EXISTS runs_session_id_created_at ON runs (session_id, created_at);
-CREATE        INDEX IF NOT EXISTS runs_parent_run_id         ON runs (parent_run_id);
-CREATE UNIQUE INDEX IF NOT EXISTS runs_session_name          ON runs (session_id, name);

package/migrations/003_loops.sql

@@ -1,12 +0,0 @@
--- INIT: loops
-CREATE TABLE IF NOT EXISTS loops (
-    id       INTEGER NOT NULL PRIMARY KEY,
-    version  INTEGER NOT NULL DEFAULT 0   CHECK (version >= 0),
-    run_id   INTEGER NOT NULL,
-    sequence INTEGER NOT NULL             CHECK (sequence >= 1),
-    status   INTEGER NOT NULL DEFAULT 102 CHECK (status IN (102, 200, 499)),
-    prompt   TEXT    NOT NULL,
-    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);

package/migrations/004_turns.sql

@@ -1,18 +0,0 @@
--- INIT: turns
-CREATE TABLE IF NOT EXISTS turns (
-    id               INTEGER NOT NULL PRIMARY KEY,
-    version          INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
-    loop_id          INTEGER NOT NULL,
-    sequence         INTEGER NOT NULL           CHECK (sequence >= 1),
-    timestamp        TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    status           INTEGER NOT NULL           CHECK (status BETWEEN 100 AND 599),
-    usage_prompt     INTEGER NOT NULL DEFAULT 0 CHECK (usage_prompt >= 0),
-    usage_completion INTEGER NOT NULL DEFAULT 0 CHECK (usage_completion >= 0),
-    usage_cached     INTEGER NOT NULL DEFAULT 0 CHECK (usage_cached >= 0),
-    usage_cost_pico  INTEGER NOT NULL DEFAULT 0 CHECK (usage_cost_pico >= 0),
-    packet           TEXT    NOT NULL           CHECK (json_valid(packet)),
-    FOREIGN KEY (loop_id) REFERENCES loops(id) ON DELETE CASCADE
-) STRICT;
-
-CREATE UNIQUE INDEX IF NOT EXISTS turns_loop_id_sequence ON turns (loop_id, sequence);
-CREATE INDEX        IF NOT EXISTS turns_timestamp        ON turns (timestamp);

package/migrations/005_entries.sql

@@ -1,44 +0,0 @@
--- INIT: entries
-CREATE TABLE IF NOT EXISTS entries (
-    id         INTEGER NOT NULL PRIMARY KEY,
-    version    INTEGER NOT NULL DEFAULT 0   CHECK (version >= 0),
-    scope      TEXT    NOT NULL             CHECK (scope IN ('agent', 'session')),
-    session_id INTEGER,
-    scheme     TEXT                         CHECK (scheme IS NULL OR length(scheme) > 0),
-    username   TEXT,
-    password   TEXT,
-    hostname   TEXT,
-    port       INTEGER                      CHECK (port IS NULL OR (port BETWEEN 0 AND 65535)),
-    pathname   TEXT    NOT NULL,
-    params     TEXT                         CHECK (params IS NULL OR json_valid(params)),
-    attributes TEXT    NOT NULL DEFAULT '{}' CHECK (json_valid(attributes)),
-    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
-) STRICT;
-
-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';
-
--- SPEC §7.8: the ONE engine-imposed constraint — 100 MiB char-length cap per
--- channel content body. All other limits (rate, burst, per-call budget, etc.)
--- are extrinsic — providers, schemes, and mimetypes own their own constraints.
-CREATE TABLE IF NOT EXISTS entry_channels (
-    entry_id INTEGER NOT NULL,
-    name     TEXT    NOT NULL             CHECK (length(name) > 0),
-    content  TEXT    NOT NULL             CHECK (length(content) <= 104857600),
-    mimetype TEXT    NOT NULL             CHECK (length(mimetype) > 0),
-    tokens   INTEGER NOT NULL DEFAULT 0   CHECK (tokens >= 0),
-    state    TEXT    NOT NULL DEFAULT 'static' CHECK (state IN ('static', 'active', 'closed', 'errored')),
-    PRIMARY KEY (entry_id, name),
-    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
-) STRICT, WITHOUT ROWID;
-
-CREATE TABLE IF NOT EXISTS entry_tags (
-    entry_id INTEGER NOT NULL,
-    tag      TEXT    NOT NULL CHECK (length(tag) > 0),
-    PRIMARY KEY (entry_id, tag),
-    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
-) STRICT, WITHOUT ROWID;
-
-CREATE INDEX IF NOT EXISTS entry_tags_tag ON entry_tags (tag);

package/migrations/006_log_entries.sql

@@ -1,51 +0,0 @@
--- INIT: log_entries
-CREATE TABLE IF NOT EXISTS log_entries (
-    id              INTEGER NOT NULL PRIMARY KEY,
-    version         INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
-
-    run_id          INTEGER NOT NULL,
-    loop_id         INTEGER NOT NULL,
-    turn_id         INTEGER NOT NULL,
-    action_index    INTEGER NOT NULL           CHECK (action_index >= 0),
-    at              TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    origin          TEXT    NOT NULL           CHECK (origin IN ('model', 'client', 'system', 'plugin')),
-
-    op              TEXT    NOT NULL           CHECK (op IN ('FIND', 'READ', 'EDIT', 'COPY', 'MOVE', 'SHOW', 'HIDE', 'SEND', 'EXEC')),
-    suffix          TEXT    NOT NULL DEFAULT '',
-    signal          TEXT                       CHECK (signal IS NULL OR json_valid(signal)),
-
-    target_scheme   TEXT                       CHECK (target_scheme IS NULL OR length(target_scheme) > 0),
-    target_username TEXT,
-    target_password TEXT,
-    target_hostname TEXT,
-    target_port     INTEGER                    CHECK (target_port IS NULL OR (target_port BETWEEN 0 AND 65535)),
-    target_pathname TEXT,
-    target_params   TEXT                       CHECK (target_params IS NULL OR json_valid(target_params)),
-    target_fragment TEXT,
-
-    lineMarker      TEXT                       CHECK (lineMarker IS NULL OR json_valid(lineMarker)),
-
-    tx              TEXT    NOT NULL,
-    mimetype_tx     TEXT    NOT NULL           CHECK (length(mimetype_tx) > 0),
-
-    rx              TEXT    NOT NULL,
-    mimetype_rx     TEXT    NOT NULL           CHECK (length(mimetype_rx) > 0),
-    status_rx       INTEGER NOT NULL           CHECK (status_rx BETWEEN 100 AND 599),
-
-    tokens          INTEGER NOT NULL DEFAULT 0 CHECK (tokens >= 0),
-
-    FOREIGN KEY (run_id)  REFERENCES runs(id)  ON DELETE CASCADE,
-    FOREIGN KEY (loop_id) REFERENCES loops(id) ON DELETE CASCADE,
-    FOREIGN KEY (turn_id) REFERENCES turns(id) ON DELETE CASCADE
-) STRICT;
-
-CREATE UNIQUE INDEX IF NOT EXISTS log_entries_turn_id_action_index ON log_entries (turn_id, action_index);
-CREATE INDEX        IF NOT EXISTS log_entries_run_id               ON log_entries (run_id);
-CREATE INDEX        IF NOT EXISTS log_entries_loop_id              ON log_entries (loop_id);
-CREATE INDEX        IF NOT EXISTS log_entries_at                   ON log_entries (at);
-
-CREATE TRIGGER IF NOT EXISTS log_entries_immutable
-BEFORE UPDATE ON log_entries
-BEGIN
-    SELECT RAISE(ABORT, 'log_entries are append-only; INSERT new rows instead of UPDATE');
-END;

package/migrations/007_visibility.sql

@@ -1,10 +0,0 @@
--- INIT: visibility
-CREATE TABLE IF NOT EXISTS visibility (
-    run_id   INTEGER NOT NULL,
-    entry_id INTEGER NOT NULL,
-    channel  TEXT    NOT NULL           CHECK (length(channel) > 0),
-    indexed  INTEGER NOT NULL DEFAULT 1 CHECK (indexed IN (0, 1)),
-    PRIMARY KEY (run_id, entry_id, channel),
-    FOREIGN KEY (run_id)   REFERENCES runs(id)    ON DELETE CASCADE,
-    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
-) STRICT, WITHOUT ROWID;

package/migrations/008_schemes_providers.sql

@@ -1,25 +0,0 @@
--- INIT: schemes_providers
-CREATE TABLE IF NOT EXISTS schemes (
-    name                 TEXT    NOT NULL PRIMARY KEY CHECK (length(name) > 0),
-    model_visible        INTEGER NOT NULL             CHECK (model_visible IN (0, 1)),
-    category             TEXT    NOT NULL             CHECK (length(category) > 0),
-    default_scope        TEXT    NOT NULL             CHECK (default_scope IN ('agent', 'session')),
-    default_channel      TEXT    NOT NULL             CHECK (length(default_channel) > 0),
-    channel_orientations TEXT                         CHECK (channel_orientations IS NULL OR json_valid(channel_orientations)),
-    writable_by          TEXT    NOT NULL             CHECK (json_valid(writable_by)),
-    volatile             INTEGER NOT NULL             CHECK (volatile IN (0, 1)),
-    handler              TEXT
-) STRICT, WITHOUT ROWID;
-
-CREATE TABLE IF NOT EXISTS providers (
-    id          INTEGER NOT NULL PRIMARY KEY,
-    version     INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
-    provider    TEXT    NOT NULL           CHECK (length(provider) > 0),
-    family      TEXT    NOT NULL           CHECK (length(family) > 0),
-    model       TEXT    NOT NULL           CHECK (length(model) > 0),
-    contextSize INTEGER NOT NULL           CHECK (contextSize >= 1),
-    currency    TEXT    NOT NULL           CHECK (length(currency) = 3),
-    created_at  TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
-) STRICT;
-
-CREATE INDEX IF NOT EXISTS providers_created_at ON providers (created_at);

package/migrations/009_cost_rollups.sql

@@ -1,44 +0,0 @@
--- INIT: cost_rollups
-CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_insert_run
-AFTER INSERT ON turns
-BEGIN
-    UPDATE runs
-       SET cost_pico = cost_pico + NEW.usage_cost_pico
-     WHERE id = (SELECT run_id FROM loops WHERE id = NEW.loop_id);
-END;
-
-CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_insert_session
-AFTER INSERT ON turns
-BEGIN
-    UPDATE sessions
-       SET cost_pico = cost_pico + NEW.usage_cost_pico
-     WHERE id = (
-         SELECT r.session_id
-           FROM runs r
-           JOIN loops l ON l.run_id = r.id
-          WHERE l.id = NEW.loop_id
-     );
-END;
-
-CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_update_run
-AFTER UPDATE OF usage_cost_pico ON turns
-WHEN NEW.usage_cost_pico != OLD.usage_cost_pico
-BEGIN
-    UPDATE runs
-       SET cost_pico = cost_pico + NEW.usage_cost_pico - OLD.usage_cost_pico
-     WHERE id = (SELECT run_id FROM loops WHERE id = NEW.loop_id);
-END;
-
-CREATE TRIGGER IF NOT EXISTS turns_cost_rollup_update_session
-AFTER UPDATE OF usage_cost_pico ON turns
-WHEN NEW.usage_cost_pico != OLD.usage_cost_pico
-BEGIN
-    UPDATE sessions
-       SET cost_pico = cost_pico + NEW.usage_cost_pico - OLD.usage_cost_pico
-     WHERE id = (
-         SELECT r.session_id
-           FROM runs r
-           JOIN loops l ON l.run_id = r.id
-          WHERE l.id = NEW.loop_id
-     );
-END;

package/migrations/010_subscriptions.sql

@@ -1,36 +0,0 @@
--- Subscription registry per SPEC §7.1.
--- Exists ONLY for cancellation routing: SEND[499](path) → lookup → scheme teardown.
--- Not for lifecycle tracking (log_entries carry that) or state coordination
--- (channel state column carries that).
--- Closed rows persist for forensics. Partial unique index enforces one active
--- subscription per (run, entry).
-
--- INIT: subscriptions
-CREATE TABLE IF NOT EXISTS subscriptions (
-    id           INTEGER NOT NULL PRIMARY KEY,
-    version      INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
-    run_id       INTEGER NOT NULL,
-    entry_id     INTEGER NOT NULL,
-    scheme       TEXT    NOT NULL CHECK (length(scheme) > 0),
-    handle       TEXT    NOT NULL CHECK (length(handle) > 0),
-    opened_at    TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    closed_at    TEXT,
-    close_status INTEGER          CHECK (close_status IS NULL OR (close_status BETWEEN 100 AND 599)),
-    CHECK ((closed_at IS NULL AND close_status IS NULL)
-        OR (closed_at IS NOT NULL AND close_status IS NOT NULL)),
-    FOREIGN KEY (run_id)   REFERENCES runs(id)    ON DELETE CASCADE,
-    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
-) STRICT;
-
--- One active subscription per (run_id, entry_id) — closed records don't block re-subscription.
-CREATE UNIQUE INDEX IF NOT EXISTS subscriptions_active_one_per_entry
-    ON subscriptions (run_id, entry_id)
-    WHERE closed_at IS NULL;
-
--- Scheme-keyed lookup for "which scheme owns active subscriptions?" queries.
-CREATE INDEX IF NOT EXISTS subscriptions_scheme_active
-    ON subscriptions (scheme)
-    WHERE closed_at IS NULL;
-
--- Forensic / time-window queries on opened_at.
-CREATE INDEX IF NOT EXISTS subscriptions_opened_at ON subscriptions (opened_at);