@jjh32456/dsh-longlive 1.6.7 → 1.8.0

package/test/fixtures/baseline-0.8.0-registration.json

@@ -1,556 +0,0 @@
-{
-  "provenance": {
-    "source": "merged 1.4.0-rc.3 tree (0.8.0 registration contract + D3 session_original)",
-    "version": "1.4.0-rc.3",
-    "node": "v24.21.0",
-    "note": "Regenerated by _work2/gen-baseline.mjs after D3 added the 22nd tool; all flags off, metrics off, routerRuntime off. Do not hand-edit."
-  },
-  "returned": {},
-  "toolCount": 22,
-  "tools": [
-    {
-      "name": "session_health",
-      "description": "Inspect a DSH session log (session.v4.jsonl.zstd): size, event count, last event type, visible-message count and sha256, age, backups, last truncation. Read-only. Pass sessionPath, sessionId, or session:\"latest\"/\"current\".",
-      "parameters": {
-        "sessionPath": {
-          "type": "string",
-          "description": "Absolute path to a session.v4.jsonl.zstd file (highest priority)."
-        },
-        "sessionId": {
-          "type": "string",
-          "description": "Session id (the folder name under <DSH_HOME>/sessions/<scope>/)."
-        },
-        "session": {
-          "type": "string",
-          "description": "Shortcut instead of an id: \"latest\" (most recently modified log) or \"current\"."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_original",
-      "description": "D3 \"fetch the original\": return the text of ONE turn from a session log, including tool output that was compressed out of the context. Read-only and privacy-gated: the FULL selection is scanned before slicing, so maxBytes/offset cannot page around a match. turn is required and 1-based (a user message belongs to its preceding turn/start). kind defaults to \"tool\" (tool results); use \"message\" for user/assistant text, \"call\" for tool arguments, or \"all\". Narrow a turn with toolCallId, or with messageIndex (0-based among the turn's user/assistant messages). The response is capped at maxBytes UTF-8 bytes (default 65536, config originalFetchMaxBytes): when truncated, content stops on a code-point boundary and nextOffset is the byte offset for the next call. Find a turn first with session_search or memory_recall. The result also reports the D2 archive path <memoryRoot>/.longlive/tool-output/<turn>/<id>.txt but NEVER writes it. Pass sessionPath, sessionId, or session:\"latest\"/\"current\".",
-      "parameters": {
-        "sessionPath": {
-          "type": "string",
-          "description": "Absolute path to a session.v4.jsonl.zstd file (highest priority)."
-        },
-        "sessionId": {
-          "type": "string",
-          "description": "Session id (the folder name under <DSH_HOME>/sessions/<scope>/)."
-        },
-        "session": {
-          "type": "string",
-          "description": "Shortcut instead of an id: \"latest\" (most recently modified log) or \"current\"."
-        },
-        "turn": {
-          "type": "integer",
-          "description": "Required. 1-based turn number (the value in turn/start events)."
-        },
-        "kind": {
-          "type": "string",
-          "enum": [
-            "tool",
-            "message",
-            "call",
-            "all"
-          ],
-          "description": "Default \"tool\" (tool results). \"message\" = user/assistant text, \"call\" = tool arguments, \"all\" = every item in the turn."
-        },
-        "toolCallId": {
-          "type": "string",
-          "description": "Select one tool call/result by call id (the toolCallId on the result event)."
-        },
-        "messageIndex": {
-          "type": "integer",
-          "description": "Select one message by its 0-based index among the turn's user/assistant messages."
-        },
-        "offset": {
-          "type": "integer",
-          "description": "Byte offset into the full selection for paging (default 0). Use nextOffset from a truncated response."
-        },
-        "maxBytes": {
-          "type": "integer",
-          "description": "Byte cap for this call (default config originalFetchMaxBytes = 65536; clamped to 1024..4194304)."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_backup",
-      "description": "Plan or create a byte-identical backup of a session log next to it (session.v4.jsonl.zstd.bak-YYYYMMDD, sha256 verified). dryRun=true writes nothing. Pass sessionPath, sessionId, or session:\"latest\"/\"current\".",
-      "parameters": {
-        "sessionPath": {
-          "type": "string",
-          "description": "Absolute path to a session.v4.jsonl.zstd file (highest priority)."
-        },
-        "sessionId": {
-          "type": "string",
-          "description": "Session id (the folder name under <DSH_HOME>/sessions/<scope>/)."
-        },
-        "session": {
-          "type": "string",
-          "description": "Shortcut instead of an id: \"latest\" (most recently modified log) or \"current\"."
-        },
-        "dryRun": {
-          "type": "boolean",
-          "description": "Default true: only report the planned backup."
-        },
-        "confirm": {
-          "type": "string",
-          "description": "Pass \"BACKUP\" to actually create the backup."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_truncate",
-      "description": "Safely drop the oldest events of a session log while keeping the visible conversation byte-identical (verified by a deriveMessages digest), with backup, tmp verify and rollback. dryRun=true writes nothing; writing requires confirm:\"TRUNCATE\". Refuses the session this app has loaded (VISIBLE_TARGET_IS_LIVE_SESSION; unknown caller id: VISIBLE_CURRENT_ID_UNKNOWN): stop the app first. Pass sessionPath, sessionId, or session:\"latest\"/\"current\".",
-      "parameters": {
-        "sessionPath": {
-          "type": "string",
-          "description": "Absolute path to a session.v4.jsonl.zstd file (highest priority)."
-        },
-        "sessionId": {
-          "type": "string",
-          "description": "Session id (the folder name under <DSH_HOME>/sessions/<scope>/)."
-        },
-        "session": {
-          "type": "string",
-          "description": "Shortcut instead of an id: \"latest\" (most recently modified log) or \"current\"."
-        },
-        "keepEvents": {
-          "type": "integer",
-          "description": "How many trailing events to keep (integer >= 1, default 20000)."
-        },
-        "dryRun": {
-          "type": "boolean",
-          "description": "Default true: plan and verify without writing."
-        },
-        "confirm": {
-          "type": "string",
-          "description": "Pass \"TRUNCATE\" to actually rewrite the log."
-        },
-        "allowLive": {
-          "type": "boolean",
-          "description": "Diagnostics only. Bypass the live-session refusal; also requires confirm:\"I-KNOW-THIS-CORRUPTS\". Never use it on the session this app has loaded."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_truncate_visible",
-      "description": "Drop whole turns from the FRONT of the visible conversation so the model actually receives less context. The cut is always on a turn boundary; the first user-authored message survives (copied into the retained head when its turn is dropped); a protected system/message is kept; a synthetic user/message archive card records what was removed. The removed prefix is archived under <session>.archive/<ts>.jsonl.zstd; seq is renumbered 0..n-1; the write is tmp + fsync + atomic rename with read-back verification and an inflight rollback record. dryRun=true writes nothing; writing requires confirm:\"TRUNCATE-VISIBLE\". Refuses the session this app has loaded (VISIBLE_TARGET_IS_LIVE_SESSION; unknown caller id: VISIBLE_CURRENT_ID_UNKNOWN): truncate it only while the app is stopped. Defaults: keepTurns=12, keepTokens=80000 (the later boundary wins). When the first user message is dropped it is carried as a bounded prefix (firstUserCapChars, default 4000) that names the archive instead of copying megabytes; the post-cut token budget counts that card, the archive card and the protected head. An unstable boundary is retried by dropping one more turn (boundaryRetries, default 3); if no cut fits, the result is feasible=false with the attempted cuts, never a silent success. Pass sessionPath, sessionId, or session:\"latest\"/\"current\".",
-      "parameters": {
-        "sessionPath": {
-          "type": "string",
-          "description": "Absolute path to a session.v4.jsonl.zstd file (highest priority)."
-        },
-        "sessionId": {
-          "type": "string",
-          "description": "Session id (the folder name under <DSH_HOME>/sessions/<scope>/)."
-        },
-        "session": {
-          "type": "string",
-          "description": "Shortcut instead of an id: \"latest\" (most recently modified log) or \"current\"."
-        },
-        "keepTurns": {
-          "type": "integer",
-          "description": "Keep at least this many trailing turns (integer >= 1, default 12)."
-        },
-        "keepTokens": {
-          "type": "integer",
-          "description": "Keep at least this many estimated trailing message tokens (integer >= 1, default 80000)."
-        },
-        "firstUserCapChars": {
-          "type": "integer",
-          "description": "Cap the carried first user message at this many characters (integer >= 1, default 4000); the full text stays in the archive."
-        },
-        "boundaryRetries": {
-          "type": "integer",
-          "description": "When the cut boundary cannot be stabilized, retry with one more dropped turn this many times (integer >= 0, default 3)."
-        },
-        "dryRun": {
-          "type": "boolean",
-          "description": "Default true: plan and report without writing."
-        },
-        "confirm": {
-          "type": "string",
-          "description": "Pass \"TRUNCATE-VISIBLE\" to actually rewrite the log."
-        },
-        "carryFirstUserMessage": {
-          "type": "boolean",
-          "description": "Copy the first user-authored message into the retained head when its turn is dropped (default true)."
-        },
-        "insertArchiveCard": {
-          "type": "boolean",
-          "description": "Insert the synthetic [已归档 ...] user/message card (default true). Set false if the host rejects it."
-        },
-        "allowLive": {
-          "type": "boolean",
-          "description": "Diagnostics only. Bypass the live-session refusal; also requires confirm:\"I-KNOW-THIS-CORRUPTS\". Never use it on the session this app has loaded."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_compact",
-      "description": "Trigger one native harness compaction so the summary is written into the session log (compaction/summary + compact-checkpoint) instead of living in process memory. This is the only way to make a long session shorter without losing what it knows; run it BEFORE session_truncate, because truncation can only delete history a compaction already shadowed. dryRun=true only reports availability. When called inside a running turn the request is queued until the agent goes idle.",
-      "parameters": {
-        "dryRun": {
-          "type": "boolean",
-          "description": "Default true: only report whether compaction is available."
-        },
-        "sourceCommandId": {
-          "type": "string",
-          "description": "Optional command identity recorded on the compaction."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_wake",
-      "description": "Read a bounded wake-up slice of the memory store (default <DSH home>/longlive-memory; override with plugin config memoryRoot / memRoot or $DSH_LONGLIVE_MEMORY_ROOT, legacy $DSH_MEM): the STATE.md sections 我在哪 / 在等什么 / 最近三件 (400 chars each), flow/current.md (800 chars max), the last three \"##\" headings of the newest journal/*.md (newest by year/month, not by string sort), and up to 20 INDEX.md lines shorter than 60 chars. Read-only. Missing files are skipped with a note instead of failing; an absent memory root reports unavailable. The text is capped at 2500 characters; truncated is true whenever a section or the whole text was cut.",
-      "parameters": {
-        "session": {
-          "type": "string",
-          "description": "Optional session label for the caller. It never selects or replaces memory content; newlines and \"#\" are stripped before it can appear in the text."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "lease_acquire",
-      "description": "Atomically take the memory-store write lease (<memoryRoot>/.lease, default <DSH home>/longlive-memory/.lease; override with memoryRoot / memRoot, $DSH_LONGLIVE_MEMORY_ROOT, or legacy $DSH_MEM). Concurrency-safe across processes (O_EXCL create): exactly one caller gets ok:true. An existing, unexpired lease returns ok:false with its holder and acquiredAt (reason \"held by another writer\"); an expired or unparseable lease is replaced, retried exactly once.",
-      "parameters": {
-        "holder": {
-          "type": "string",
-          "description": "Who wants the lease (a process/session name). Required."
-        },
-        "ttlSec": {
-          "type": "integer",
-          "description": "Lease lifetime in whole seconds (integer 1..86400, default 300). A day is the ceiling: a longer lease is a typo, not a plan."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "lease_release",
-      "description": "Release the memory-store write lease, but only for the holder recorded inside it. No file reports ok:false reason \"no lease\"; a different holder reports ok:false reason \"not the holder\" and the lease is left in place.",
-      "parameters": {
-        "holder": {
-          "type": "string",
-          "description": "Who is releasing; must match the recorded holder. Required."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "worker_spawn",
-      "description": "Dispatch one background child session (worker) through the host subagents service and return immediately with its workerId. The child runs in its own context and reports back through the host; read its state with worker_status and stop it with worker_kill. Pass prompt (required: the task text), an optional label, and timeoutSec (default 600).",
-      "parameters": {
-        "prompt": {
-          "type": "string",
-          "description": "The task to hand to the child session. Required."
-        },
-        "label": {
-          "type": "string",
-          "description": "Optional short label for the child (defaults to the prompt head)."
-        },
-        "timeoutSec": {
-          "type": "integer",
-          "description": "How long the dispatch itself may take, in whole seconds (integer >= 1, default 600)."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "worker_status",
-      "description": "Report where a worker stands: live status from the Agent registry, else the parent child catalog, else its persisted session log (events count, last message time, status). Pass workerId (required), the id worker_spawn returned.",
-      "parameters": {
-        "workerId": {
-          "type": "string",
-          "description": "The worker id returned by worker_spawn. Required."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "worker_kill",
-      "description": "Stop one running worker through the host subagents service (interrupt, fire-and-return). A worker that is not running reports unavailable instead of a fake success. Pass workerId (required) and an optional reason.",
-      "parameters": {
-        "workerId": {
-          "type": "string",
-          "description": "The worker id returned by worker_spawn. Required."
-        },
-        "reason": {
-          "type": "string",
-          "description": "Optional short reason recorded in the report."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "memory_index",
-      "description": "Rebuild the generated section of <memoryRoot>/INDEX.md from every card under topics/, journal/ and procedures/. Only the region between <!-- BEGIN GENERATED --> and <!-- END GENERATED --> is replaced; hand-written content outside is preserved byte-for-byte. Cards without frontmatter are legacy cards and still get a row. Procedures get their own 「程序性」 table (name / trigger / path / strength / version) so they are counted without appearing twice; a broken procedure card is listed as an invalid row instead of failing the run. Default is dry-run (returns the section and the resulting file, writes nothing); pass apply:true to write. Memory root: plugin config memoryRoot (alias memRoot), else $DSH_LONGLIVE_MEMORY_ROOT, else legacy $DSH_MEM, else <DSH home>/longlive-memory (created on demand).",
-      "parameters": {
-        "apply": {
-          "type": "boolean",
-          "description": "Default false (dry-run). true rewrites only the generated section, after backing INDEX.md up."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "memory_consolidate",
-      "description": "Read journal/*.md entries dated after the last consolidation (or an explicit since) and produce a proposal report: which paragraph belongs in which card, why, a 120-char excerpt, and a suggested salience. Journal paragraphs may carry `<!-- affect: N | reason -->` (N 1..5); the marker wins over the regex fallback, and malformed markers are listed under badAffect without failing the run. Every proposal gets a stable id (sha1(source paragraph text)[:12]); ids already in state.seenProposals are never proposed again. Report only — it never edits a card. It writes exactly one file under <memoryRoot>/.longlive/reports/ and records new proposal ids in memory-state.json; lastConsolidated advances only after every proposal for the newest scanned day is resolved (accepted/rejected/superseded). There is no apply flag by design.",
-      "parameters": {
-        "since": {
-          "type": "string",
-          "description": "Optional YYYY-MM-DD override for the incremental start; defaults to memory-state.json lastConsolidated."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "memory_reinforce",
-      "description": "Record one real use of a card: strength = min(9, strength+1), last_used = today, revisions += 1, plus one <!-- rev: ... --> line with the reason. The prose body must stay byte-identical; the original is backed up to <memoryRoot>/.longlive/backups/ before writing, and any post-write mismatch rolls the card back. Pass path (required, relative to memoryRoot or absolute inside it).",
-      "parameters": {
-        "path": {
-          "type": "string",
-          "description": "The card to reinforce, relative to memoryRoot or an absolute path inside it. Required."
-        },
-        "reason": {
-          "type": "string",
-          "description": "Optional short reason stored in the rev comment (default \"被真实使用\")."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "memory_forget",
-      "description": "Propose forgetting by decay rules: last_used > 90 days and strength <= 2 demotes to epochs/, last_used > 365 days tombstones. Cards with salience >= 5 are never proposed. Default is dry-run and writes nothing: it only reports proposals and whether epochs/, archive/tombstones/ and .longlive/backups exist. Execution requires confirm:\"FORGET\": it creates those paths, backs up each card into .longlive/backups/ first, rewrites tombstones.md atomically with a three-question epitaph per card (reason / affects / stillUseful) BEFORE moving the card to archive/tombstones/ (or epochs/), appends exactly one line to .longlive/audit.log, and never deletes a file.",
-      "parameters": {
-        "confirm": {
-          "type": "string",
-          "description": "Default absent = dry-run. Pass \"FORGET\" to execute the proposals."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "memory_procedure",
-      "description": "Procedural memory: how a task is done, not what happened. One card per procedure at <memoryRoot>/procedures/<slug>.md. Frontmatter is required: name / trigger / salience / strength / last_used (plus revisions). Body sections: 何时用 / 怎么做 (a numbered list) / 失败模式 / 例子. action:\"save\" creates or merges by slug (same slug -> revisions+1, the old version is backed up under .longlive/backups/, and fields you omit keep their old value); a NEW card needs name plus when and at least one step. action:\"list\" filters by trigger keyword (space or comma separated, case-insensitive, OR over keywords); action:\"get\" returns one card including its raw text; action:\"report\" records one real use: success -> strength+1, failure -> strength-1 (clamped to 0..9), last_used = today, plus one <!-- rev: ... --> line. report leaves revisions alone: revisions counts content versions, strength counts how often it worked. A card whose frontmatter is broken or misses a required field is reported with E_PROCEDURE_INVALID and is never silently overwritten.",
-      "parameters": {
-        "action": {
-          "type": "string",
-          "enum": [
-            "save",
-            "list",
-            "get",
-            "report"
-          ],
-          "description": "Required. save | list | get | report."
-        },
-        "name": {
-          "type": "string",
-          "description": "Card title (frontmatter name). save derives the slug from it when slug is absent; get/report accept it instead of slug."
-        },
-        "slug": {
-          "type": "string",
-          "description": "File stem under procedures/. save/get/report may pass it explicitly (no path separators, no ..)."
-        },
-        "trigger": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "When this procedure applies (frontmatter trigger). save replaces the whole list; list uses the keywords as an OR filter."
-        },
-        "salience": {
-          "type": "integer",
-          "description": "Importance 1..5 (default 3 on a new card, kept on merge unless given)."
-        },
-        "strength": {
-          "type": "integer",
-          "description": "How often it worked 0..9 (default 3 on a new card; report changes it, save sets it explicitly)."
-        },
-        "when": {
-          "type": "string",
-          "description": "Body section 「何时用」: the situation that calls for this procedure. Required for a new card."
-        },
-        "steps": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Body section 「怎么做」: ordered steps, written as a numbered list. Required (at least one) for a new card. A single string with newlines is accepted too."
-        },
-        "failureModes": {
-          "type": "string",
-          "description": "Optional body section 「失败模式」: how this procedure goes wrong."
-        },
-        "example": {
-          "type": "string",
-          "description": "Optional body section 「例子」: one concrete run."
-        },
-        "outcome": {
-          "type": "string",
-          "enum": [
-            "success",
-            "failure"
-          ],
-          "description": "report only, required: success raises strength by 1, failure lowers it by 1."
-        },
-        "reason": {
-          "type": "string",
-          "description": "report only: short reason stored in the rev comment."
-        },
-        "limit": {
-          "type": "integer",
-          "description": "list only: page size (default 50, max 500). total/count/truncated are always reported."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "memory_recall",
-      "description": "Search memory cards by meaning-ish keywords and get the best few back. Mixed, reproducible score: title hits *5 + tags *3 + body frequency (capped 3) + whole-query phrase bonus + character-bigram Dice similarity. Returns {path, title, score, excerpt} sorted by score desc then path asc; the same tree and query always produce byte-identical results. Defaults: topK 3 (1..20), room any, status active+locked — already-locked cards are searchable. Pass status:\"archived\" or \"any\" to widen, room:\"topics\" to narrow. READ-ONLY: it never writes a card, never builds INDEX.md and never creates .longlive/. An empty query throws E_RECALL_EMPTY_QUERY; no hit is not an error — it returns an empty results list with code E_RECALL_NO_MATCH and a hint.",
-      "parameters": {
-        "query": {
-          "type": "string",
-          "description": "Required. Natural language or keywords, e.g. \"听觉 训练\"."
-        },
-        "topK": {
-          "type": "integer",
-          "description": "How many cards to return (default 3, clamped to 1..20)."
-        },
-        "room": {
-          "type": "string",
-          "description": "Optional relative directory filter: topics, journal, or a subdirectory of either."
-        },
-        "status": {
-          "type": "string",
-          "enum": [
-            "active",
-            "locked",
-            "archived",
-            "any"
-          ],
-          "description": "Card status filter. Default active+locked; \"any\" includes archived."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_live_update",
-      "description": "Write or patch this session's row in the live registry (<memoryRoot>/.longlive/live/<sessionId>.json). state is required: idle | running | waiting | blocked | stale. Omitted optional fields keep their previous value, except blocked_on, which is cleared whenever state is not \"blocked\". pid and host are always the calling process and machine; startedAt is preserved. goal is cut to 80 characters, queued to 200 items of 300 characters each, and last_action.detail to 500 characters; the result reports every cut (goalTruncated / queuedTruncated / lastActionDetailTruncated). The file is written tmp -> rename with a read-back, so a crash never leaves half a JSON. If a directory or symlink occupies the row path, the write is refused up front with E_LIVE_ROW_BLOCKED instead of failing late in rename. Pass sessionId only to write another session's row; by default the host's current session is used.",
-      "parameters": {
-        "sessionId": {
-          "type": "string",
-          "description": "Optional session id; defaults to the host's current session id."
-        },
-        "state": {
-          "type": "string",
-          "enum": [
-            "idle",
-            "running",
-            "waiting",
-            "blocked",
-            "stale"
-          ],
-          "description": "Required writer-declared state. dead/corrupt are computed by readers and cannot be written."
-        },
-        "turn": {
-          "type": "integer",
-          "description": "Current turn number (integer >= 0, default keeps the previous value or 0)."
-        },
-        "goal": {
-          "type": "string",
-          "description": "What this session is doing; stored at most 80 characters (longer input is truncated and flagged)."
-        },
-        "blocked_on": {
-          "type": "string",
-          "description": "What the session is waiting on. Only kept while state is \"blocked\"."
-        },
-        "queued": {
-          "type": "array",
-          "items": {
-            "type": "string"
-          },
-          "description": "Queued work items (strings); replaces the previous queue."
-        },
-        "ttlMs": {
-          "type": "integer",
-          "description": "Heartbeat lifetime in ms (integer 1000..86400000, default 60000). Older than 2x this is stale."
-        },
-        "last_action": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "at": {
-              "type": "string",
-              "description": "ISO timestamp; defaults to now."
-            },
-            "kind": {
-              "type": "string",
-              "description": "Short action kind, e.g. \"edit\" or \"tool\"."
-            },
-            "detail": {
-              "type": "string",
-              "description": "Short human-readable detail."
-            }
-          },
-          "description": "Last action {at, kind, detail}; defaults to now/create or now/update."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_live_list",
-      "description": "List the live registry (<memoryRoot>/.longlive/live) with a computed effectiveState for every row. Liveness is heartbeat-first: a heartbeat within one ttlMs is running regardless of pid (pid is the writer's, not the session's); older than 2x ttlMs is stale; older than 4x ttlMs, or same-host with a pid that definitively no longer exists, is dead; a file that cannot be parsed or has the wrong shape is corrupt (listed, never thrown). Other hosts' pids are never probed, so remote rows age purely by heartbeat and can be stale or dead but are never treated as dead by pid. dead rows are hidden unless includeDead:true; the result always reports hiddenDead and per-state counts. Orphan tmp files are ignored by the list.",
-      "parameters": {
-        "includeDead": {
-          "type": "boolean",
-          "description": "Default false: hide rows whose same-host pid no longer exists."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_live_get",
-      "description": "Read one row of the live registry by sessionId, with the same computed effectiveState as session_live_list (dead / stale / corrupt included). sessionId must already be canonical (lowercase): a case or whitespace alias throws E_SESSION_ID_NOT_CANONICAL with the canonical id in error.canonical, because NTFS maps aliases to one file and a silent lookup cannot say which session was read. A symlinked row is refused rather than followed. A missing row returns ok:false status:\"absent\" instead of failing; a row that cannot be parsed throws E_LIVE_CORRUPT.",
-      "parameters": {
-        "sessionId": {
-          "type": "string",
-          "description": "Session id whose row to read. Required."
-        }
-      },
-      "hasExecute": true
-    },
-    {
-      "name": "session_live_prune",
-      "description": "Clean the live registry. Row candidates are dead rows from this host (heartbeat older than 4x ttlMs, or same-host pid definitively gone), or corrupt rows without another host's stamp. Before unlinking, each candidate is re-read and re-judged: it is deleted only if it is STILL dead/corrupt AND its bytes did not change; otherwise it is returned under skipped. A row carrying blocked_on is never auto-deleted (skipped), and every deleted/skipped row keeps blocked_on, queued and startedAt in the result. Remote rows are never deleted: a merely dead remote row is left alone, and a corrupt row whose bytes still name a remote host is skipped too (host unknown is the only corrupt case prune may remove). Also reports (and with confirm removes) orphan *.tmp-* files older than one hour and empty directory placeholders; non-empty directories and symlinks are reported only. Default is dry-run (candidates, wouldDelete, skipped; deletes nothing); a real delete requires confirm:\"PRUNE\". dryRun:false without the confirm word throws E_CONFIRM_REQUIRED.",
-      "parameters": {
-        "dryRun": {
-          "type": "boolean",
-          "description": "Default true (preview only). false with confirm:\"PRUNE\" really deletes."
-        },
-        "confirm": {
-          "type": "string",
-          "description": "Pass \"PRUNE\" to actually delete the previewed candidates."
-        }
-      },
-      "hasExecute": true
-    }
-  ],
-  "hooks": [
-    {
-      "name": "session/event",
-      "prepend": false,
-      "priority": null
-    }
-  ],
-  "warnings": [],
-  "infos": []
-}