@north-light/crouter 0.3.317 → 0.3.319

package/dist/core/canvas/executions.js

@@ -1,68 +1 @@
-import { randomUUID } from 'node:crypto';
-import { openDb, withCanvasWrite } from './db.js';
-import { capturePidIdentities, identitiesMatch, isBootScopedIdentity, isLegacyTicksIdentity } from './pid.js';
-function now() {
-    return new Date().toISOString();
-}
-function hydrate(row) {
-    return {
-        executionId: row['execution_id'],
-        nodeId: row['node_id'],
-        daemonEpoch: row['daemon_epoch'] ?? null,
-        pid: row['pid'] ?? null,
-        processIdentity: row['process_identity'] ?? null,
-        state: row['state'],
-        startedAt: row['started_at'],
-        endedAt: row['ended_at'] ?? null,
-        exitReason: row['exit_reason'] ?? null,
-    };
-}
-export function liveExecutionForNode(nodeId) {
-    const row = openDb().prepare("SELECT * FROM executions WHERE node_id = ? AND state != 'exited'").get(nodeId);
-    return row === undefined ? null : hydrate(row);
-}
-export function beginExecution(nodeId, input) {
-    return withCanvasWrite((db) => {
-        const at = now();
-        db.prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = 'superseded' WHERE node_id = ? AND state != 'exited'").run(at, nodeId);
-        const executionId = randomUUID();
-        db.prepare("INSERT INTO executions (execution_id, node_id, daemon_epoch, pid, process_identity, state, started_at, ended_at, exit_reason) VALUES (?, ?, ?, NULL, NULL, 'launching', ?, NULL, NULL)").run(executionId, nodeId, input.daemonEpoch, at);
-        return executionId;
-    });
-}
-/** Returns shutdown when a late broker references an execution no longer live. */
-export function recordExecutionPid(executionId, nodeId, pid) {
-    const identity = capturePidIdentities([pid])?.get(pid) ?? null;
-    return withCanvasWrite((db) => {
-        const launching = db.prepare("UPDATE executions SET pid = ?, process_identity = ?, state = 'running' WHERE execution_id = ? AND node_id = ? AND state = 'launching'").run(pid, identity, executionId, nodeId);
-        if (launching.changes > 0)
-            return 'recorded';
-        const running = db.prepare("SELECT pid FROM executions WHERE execution_id = ? AND node_id = ? AND state = 'running'").get(executionId, nodeId);
-        return running?.pid === pid ? 'recorded' : 'shutdown';
-    });
-}
-export function endExecution(executionId, input) {
-    return Number(openDb().prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE execution_id = ? AND state != 'exited'").run(now(), input.reason, executionId).changes) === 1;
-}
-export function abortExecution(executionId, input) {
-    return endExecution(executionId, input);
-}
-export function endLiveExecution(nodeId, input) {
-    return Number(openDb().prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE node_id = ? AND state != 'exited'").run(now(), input.reason, nodeId).changes) === 1;
-}
-export function migrateLegacyExecutionIdentities(captureIdentity = (pid) => capturePidIdentities([pid])?.get(pid)) {
-    const db = openDb();
-    const rows = db.prepare("SELECT execution_id, pid, process_identity FROM executions WHERE state = 'running' AND pid IS NOT NULL AND process_identity IS NOT NULL").all();
-    const update = db.prepare("UPDATE executions SET process_identity = ? WHERE execution_id = ? AND pid = ? AND process_identity = ? AND state = 'running'");
-    const migrated = [];
-    for (const row of rows) {
-        if (!isLegacyTicksIdentity(row.process_identity))
-            continue;
-        const current = captureIdentity(row.pid);
-        if (current === undefined || !isBootScopedIdentity(current) || !identitiesMatch(current, row.process_identity))
-            continue;
-        if (update.run(current, row.execution_id, row.pid, row.process_identity).changes > 0)
-            migrated.push(row.execution_id);
-    }
-    return { migrated };
-}
+var x=Object.defineProperty;var n=(e,t)=>x(e,"name",{value:t,configurable:!0});import{randomUUID as E}from"node:crypto";import{openDb as c,withCanvasWrite as a}from"./db.js";import{capturePidIdentities as p,identitiesMatch as _,isBootScopedIdentity as N,isLegacyTicksIdentity as g}from"./pid.js";function u(){return new Date().toISOString()}n(u,"now");function l(e){return{executionId:e.execution_id,nodeId:e.node_id,daemonEpoch:e.daemon_epoch??null,pid:e.pid??null,processIdentity:e.process_identity??null,state:e.state,startedAt:e.started_at,endedAt:e.ended_at??null,exitReason:e.exit_reason??null}}n(l,"hydrate");function h(e){const t=c().prepare("SELECT * FROM executions WHERE node_id = ? AND state != 'exited'").get(e);return t===void 0?null:l(t)}n(h,"liveExecutionForNode");function y(e,t){return a(i=>{const d=u();i.prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = 'superseded' WHERE node_id = ? AND state != 'exited'").run(d,e);const o=E();return i.prepare("INSERT INTO executions (execution_id, node_id, daemon_epoch, pid, process_identity, state, started_at, ended_at, exit_reason) VALUES (?, ?, ?, NULL, NULL, 'launching', ?, NULL, NULL)").run(o,e,t.daemonEpoch,d),o})}n(y,"beginExecution");function m(e,t,i){const d=p([i])?.get(i)??null;return a(o=>o.prepare("UPDATE executions SET pid = ?, process_identity = ?, state = 'running' WHERE execution_id = ? AND node_id = ? AND state = 'launching'").run(i,d,e,t).changes>0||o.prepare("SELECT pid FROM executions WHERE execution_id = ? AND node_id = ? AND state = 'running'").get(e,t)?.pid===i?"recorded":"shutdown")}n(m,"recordExecutionPid");function A(e,t){return Number(c().prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE execution_id = ? AND state != 'exited'").run(u(),t.reason,e).changes)===1}n(A,"endExecution");function S(e,t){return A(e,t)}n(S,"abortExecution");function U(e,t){return Number(c().prepare("UPDATE executions SET state = 'exited', ended_at = ?, exit_reason = ? WHERE node_id = ? AND state != 'exited'").run(u(),t.reason,e).changes)===1}n(U,"endLiveExecution");function R(e=t=>p([t])?.get(t)){const t=c(),i=t.prepare("SELECT execution_id, pid, process_identity FROM executions WHERE state = 'running' AND pid IS NOT NULL AND process_identity IS NOT NULL").all(),d=t.prepare("UPDATE executions SET process_identity = ? WHERE execution_id = ? AND pid = ? AND process_identity = ? AND state = 'running'"),o=[];for(const r of i){if(!g(r.process_identity))continue;const s=e(r.pid);s===void 0||!N(s)||!_(s,r.process_identity)||d.run(s,r.execution_id,r.pid,r.process_identity).changes>0&&o.push(r.execution_id)}return{migrated:o}}n(R,"migrateLegacyExecutionIdentities");export{S as abortExecution,y as beginExecution,A as endExecution,U as endLiveExecution,h as liveExecutionForNode,R as migrateLegacyExecutionIdentities,m as recordExecutionPid};

package/dist/core/canvas/extensions.js

@@ -1,83 +1 @@
-import { extname } from 'node:path';
-// Canvas-extension identity is structural, not basename-based: old runtime roots
-// are recognized only when they carry a complete shipped canvas prefix.
-// canvas-inbox-watcher must load before canvas-stophook: at agent_settled it
-// commits the cursor the stophook then reads to decide idle release.
-export const CANVAS_EXTENSION_NAMES = [
-    'canvas-inbox-watcher', 'canvas-review-boundary', 'canvas-stophook', 'canvas-recap',
-    'canvas-goal-capture', 'canvas-passive-context', 'canvas-context-intro',
-    'canvas-tool-guide', 'canvas-doc-substrate', 'canvas-structured-output',
-    'canvas-bash-valve', 'canvas-preview-result', 'canvas-prompt-scrub', 'canvas-stamp',
-];
-const HISTORICAL_CANVAS_EXTENSION_PREFIXES = [
-    [
-        'canvas-inbox-watcher', 'canvas-review-boundary', 'canvas-stophook', 'canvas-recap',
-        'canvas-goal-capture', 'canvas-passive-context', 'canvas-context-intro',
-        'canvas-tool-guide', 'canvas-doc-substrate', 'canvas-structured-output',
-        'canvas-bash-valve', 'canvas-preview-result', 'canvas-prompt-scrub',
-    ],
-    [
-        'canvas-inbox-watcher', 'canvas-review-boundary', 'canvas-stophook', 'canvas-recap',
-        'canvas-goal-capture', 'canvas-passive-context', 'canvas-context-intro',
-        'canvas-tool-guide', 'canvas-doc-substrate', 'canvas-structured-output',
-        'canvas-bash-valve', 'canvas-preview-result',
-    ],
-    [
-        'canvas-inbox-watcher', 'canvas-review-boundary', 'canvas-stophook', 'canvas-recap',
-        'canvas-goal-capture', 'canvas-passive-context', 'canvas-context-intro',
-        'canvas-tool-guide', 'canvas-doc-substrate', 'canvas-structured-output',
-        'canvas-bash-valve',
-    ],
-    [
-        'canvas-inbox-watcher', 'canvas-stophook', 'canvas-recap',
-        'canvas-goal-capture', 'canvas-passive-context', 'canvas-review-boundary',
-        'canvas-context-intro',
-        'canvas-tool-guide', 'canvas-doc-substrate', 'canvas-structured-output',
-        'canvas-bash-valve',
-    ],
-    [
-        'canvas-inbox-watcher', 'canvas-stophook', 'canvas-recap',
-        'canvas-goal-capture', 'canvas-passive-context', 'canvas-context-intro',
-        'canvas-doc-substrate', 'canvas-structured-output', 'canvas-bash-valve',
-    ],
-    [
-        'canvas-stophook', 'canvas-inbox-watcher', 'canvas-recap',
-        'canvas-goal-capture', 'canvas-passive-context', 'canvas-context-intro',
-        'canvas-doc-substrate', 'canvas-structured-output', 'canvas-bash-valve',
-    ],
-];
-function matchesExtensionPrefix(extensions, names) {
-    if (extensions.length < names.length)
-        return false;
-    const paths = extensions.slice(0, names.length);
-    const first = paths[0].replaceAll('\\', '/');
-    const marker = '/pi-extensions/';
-    const markerIndex = first.lastIndexOf(marker);
-    const suffix = first.endsWith('.js') ? '.js' : first.endsWith('.ts') ? '.ts' : null;
-    if (markerIndex < 1 || suffix === null)
-        return false;
-    const root = first.slice(0, markerIndex + marker.length);
-    return names.every((name, index) => paths[index].replaceAll('\\', '/') === `${root}${name}${suffix}`);
-}
-function extensionPrefixLength(extensions) {
-    const prefixes = [CANVAS_EXTENSION_NAMES, ...HISTORICAL_CANVAS_EXTENSION_PREFIXES];
-    return prefixes.find((names) => matchesExtensionPrefix(extensions, names))?.length ?? 0;
-}
-/** Structural shipped-hook identity: a canvas-hook stem directly under a
- * `pi-extensions` directory. A user's own extension elsewhere may share the
- * stem and is not shipped. */
-export function isShippedCanvasExtension(path) {
-    const normalized = path.replaceAll('\\', '/');
-    const lastSlash = normalized.lastIndexOf('/');
-    const parent = normalized.slice(0, lastSlash).split('/').at(-1);
-    const filename = normalized.slice(lastSlash + 1);
-    const name = filename.slice(0, filename.length - extname(filename).length);
-    return parent === 'pi-extensions' && CANVAS_EXTENSION_NAMES.includes(name);
-}
-/** Remove persisted shipped canvas extensions while retaining genuine
- * caller/kind extras, including a custom extension whose basename happens to
- * resemble a canvas hook outside a pi-extensions directory. */
-export function customExtensionPaths(extensions) {
-    const paths = extensions ?? [];
-    return paths.slice(extensionPrefixLength(paths)).filter((path) => !isShippedCanvasExtension(path));
-}
+var l=Object.defineProperty;var e=(s,a)=>l(s,"name",{value:a,configurable:!0});import{extname as x}from"node:path";const r=["canvas-inbox-watcher","canvas-review-boundary","canvas-stophook","canvas-recap","canvas-goal-capture","canvas-passive-context","canvas-context-intro","canvas-tool-guide","canvas-doc-substrate","canvas-structured-output","canvas-bash-valve","canvas-preview-result","canvas-prompt-scrub","canvas-stamp"],h=[["canvas-inbox-watcher","canvas-review-boundary","canvas-stophook","canvas-recap","canvas-goal-capture","canvas-passive-context","canvas-context-intro","canvas-tool-guide","canvas-doc-substrate","canvas-structured-output","canvas-bash-valve","canvas-preview-result","canvas-prompt-scrub"],["canvas-inbox-watcher","canvas-review-boundary","canvas-stophook","canvas-recap","canvas-goal-capture","canvas-passive-context","canvas-context-intro","canvas-tool-guide","canvas-doc-substrate","canvas-structured-output","canvas-bash-valve","canvas-preview-result"],["canvas-inbox-watcher","canvas-review-boundary","canvas-stophook","canvas-recap","canvas-goal-capture","canvas-passive-context","canvas-context-intro","canvas-tool-guide","canvas-doc-substrate","canvas-structured-output","canvas-bash-valve"],["canvas-inbox-watcher","canvas-stophook","canvas-recap","canvas-goal-capture","canvas-passive-context","canvas-review-boundary","canvas-context-intro","canvas-tool-guide","canvas-doc-substrate","canvas-structured-output","canvas-bash-valve"],["canvas-inbox-watcher","canvas-stophook","canvas-recap","canvas-goal-capture","canvas-passive-context","canvas-context-intro","canvas-doc-substrate","canvas-structured-output","canvas-bash-valve"],["canvas-stophook","canvas-inbox-watcher","canvas-recap","canvas-goal-capture","canvas-passive-context","canvas-context-intro","canvas-doc-substrate","canvas-structured-output","canvas-bash-valve"]];function d(s,a){if(s.length<a.length)return!1;const n=s.slice(0,a.length),t=n[0].replaceAll("\\","/"),c="/pi-extensions/",o=t.lastIndexOf(c),v=t.endsWith(".js")?".js":t.endsWith(".ts")?".ts":null;if(o<1||v===null)return!1;const u=t.slice(0,o+c.length);return a.every((i,p)=>n[p].replaceAll("\\","/")===`${u}${i}${v}`)}e(d,"matchesExtensionPrefix");function b(s){return[r,...h].find(n=>d(s,n))?.length??0}e(b,"extensionPrefixLength");function f(s){const a=s.replaceAll("\\","/"),n=a.lastIndexOf("/"),t=a.slice(0,n).split("/").at(-1),c=a.slice(n+1),o=c.slice(0,c.length-x(c).length);return t==="pi-extensions"&&r.includes(o)}e(f,"isShippedCanvasExtension");function m(s){const a=s??[];return a.slice(b(a)).filter(n=>!f(n))}e(m,"customExtensionPaths");export{r as CANVAS_EXTENSION_NAMES,m as customExtensionPaths,f as isShippedCanvasExtension};

package/dist/core/canvas/focuses.js

@@ -1,77 +1 @@
-// focuses.ts — the FOCUS table data-access layer (canvas.db, migration v6).
-//
-// Part of the canvas data-access layer: Q7 widens canvas.db from "topology" to
-// "topology + focuses", so the focus-row SQL lives here beside the node+edge
-// model, never in the runtime layer. A FOCUS is one durable on-screen viewport
-// bound to one node; the table is PLURAL (many focuses across windows/sessions),
-// the generalization of the old single focus pointer. It is the CANONICAL focus
-// store — there is no focus.ptr file and no dual-write bridge.
-//
-// placement.ts COMPOSES over these atomic setters/reads (the same way it calls
-// setPresence) — it never runs raw focus SQL itself.
-//
-// Each setter is a single atomic statement. UNIQUE(node_id) upholds "a node
-// occupies at most one viewer" (Q5): a second focus row (or an occupant UPDATE)
-// for an already-viewed node throws — that is correct, the vacate-first
-// orchestration is placement.focus()'s job, not these setters'.
-import { openDb } from './db.js';
-function focusFrom(r) {
-    return {
-        focus_id: r['focus_id'],
-        pane: r['pane'] ?? null,
-        session: r['session'] ?? null,
-        node_id: r['node_id'],
-    };
-}
-// Atomic setters — each one a single-statement INSERT/UPDATE/DELETE.
-/** INSERT a viewport. Throws on UNIQUE(node_id) if `node_id` already occupies
- *  another focus (or on PK conflict if `focus_id` exists) — by design. */
-export function openFocusRow(focus_id, pane, session, node_id) {
-    openDb()
-        .prepare('INSERT INTO focuses (focus_id, pane, session, node_id) VALUES (?, ?, ?, ?)')
-        .run(focus_id, pane, session, node_id);
-}
-/** Hot-swap a focus's occupant — single-statement UPDATE. Respects
- *  UNIQUE(node_id): if `node_id` already occupies ANOTHER focus this throws
- *  (correct — vacate-first is placement.focus()'s job, not this setter's). */
-export function setFocusOccupant(focus_id, node_id) {
-    openDb().prepare('UPDATE focuses SET node_id = ? WHERE focus_id = ?').run(node_id, focus_id);
-}
-/** Re-point a viewer row's durable pane + its derived session cache after the
- *  pane moves. Single-statement UPDATE. */
-export function setFocusPane(focus_id, pane, session) {
-    openDb()
-        .prepare('UPDATE focuses SET pane = ?, session = ? WHERE focus_id = ?')
-        .run(pane, session, focus_id);
-}
-/** DELETE a viewport. */
-export function closeFocusRow(focus_id) {
-    openDb().prepare('DELETE FROM focuses WHERE focus_id = ?').run(focus_id);
-}
-// Reads.
-/** The focus a node occupies (≤1, UNIQUE node_id), or null. */
-export function getFocusByNode(node_id) {
-    const r = openDb()
-        .prepare('SELECT * FROM focuses WHERE node_id = ?')
-        .get(node_id);
-    return r ? focusFrom(r) : null;
-}
-/** The focus realized by a given pane (`%id`), or null. */
-export function getFocusByPane(pane) {
-    const r = openDb()
-        .prepare('SELECT * FROM focuses WHERE pane = ?')
-        .get(pane);
-    return r ? focusFrom(r) : null;
-}
-/** A focus by its stable id, or null. Used by placement to read a row back by id
- *  after openFocusRow registers a viewer. */
-export function getFocusById(focus_id) {
-    const r = openDb()
-        .prepare('SELECT * FROM focuses WHERE focus_id = ?')
-        .get(focus_id);
-    return r ? focusFrom(r) : null;
-}
-/** Every focus row, ordered by id. */
-export function listFocuses() {
-    return openDb().prepare('SELECT * FROM focuses ORDER BY focus_id').all().map(focusFrom);
-}
+var t=Object.defineProperty;var n=(e,o)=>t(e,"name",{value:o,configurable:!0});import{openDb as s}from"./db.js";function u(e){return{focus_id:e.focus_id,pane:e.pane??null,session:e.session??null,node_id:e.node_id}}n(u,"focusFrom");function i(e,o,r,c){s().prepare("INSERT INTO focuses (focus_id, pane, session, node_id) VALUES (?, ?, ?, ?)").run(e,o,r,c)}n(i,"openFocusRow");function f(e,o){s().prepare("UPDATE focuses SET node_id = ? WHERE focus_id = ?").run(o,e)}n(f,"setFocusOccupant");function d(e,o,r){s().prepare("UPDATE focuses SET pane = ?, session = ? WHERE focus_id = ?").run(o,r,e)}n(d,"setFocusPane");function a(e){s().prepare("DELETE FROM focuses WHERE focus_id = ?").run(e)}n(a,"closeFocusRow");function R(e){const o=s().prepare("SELECT * FROM focuses WHERE node_id = ?").get(e);return o?u(o):null}n(R,"getFocusByNode");function l(e){const o=s().prepare("SELECT * FROM focuses WHERE pane = ?").get(e);return o?u(o):null}n(l,"getFocusByPane");function F(e){const o=s().prepare("SELECT * FROM focuses WHERE focus_id = ?").get(e);return o?u(o):null}n(F,"getFocusById");function _(){return s().prepare("SELECT * FROM focuses ORDER BY focus_id").all().map(u)}n(_,"listFocuses");export{a as closeFocusRow,F as getFocusById,R as getFocusByNode,l as getFocusByPane,_ as listFocuses,i as openFocusRow,f as setFocusOccupant,d as setFocusPane};