@north-light/api 0.3.538 → 0.3.540

package/dist/api/contract.d.ts

@@ -1,5 +1,5 @@
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export declare const CONTRACT_LEVEL = "1.27";
+export declare const CONTRACT_LEVEL = "1.28";
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export declare const REQUIRED_CONTRACT_HEADER = "Crouter-Required-Contract";
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/contract.js

@@ -12,7 +12,7 @@
 //
 // PURITY (spec §3.1): Node built-ins + `src/api/*` only.
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export const CONTRACT_LEVEL = '1.27';
+export const CONTRACT_LEVEL = '1.28';
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export const REQUIRED_CONTRACT_HEADER = 'Crouter-Required-Contract';
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/dto/profiles.d.ts

@@ -112,6 +112,8 @@ export interface ProfileDTO {
     created_at: string;
     /** ISO timestamp of the most recent selection, or null if never selected. */
     last_used_at: string | null;
+    /** The environment the profile's nodes run in: the stored pointer, or the install's machine environment when none is stored. */
+    environment_id?: string;
     /** Absolute path of the profile's directory, `<app space>/profiles/<id>`: its settings root. The profile's documents live in the canvas, not here. */
     profile_path: string;
 }

package/dist/core/canvas/legacy-person.d.ts

@@ -0,0 +1,4 @@
+/** The person principal every install carried before it minted its own: read only by the one-shot that retires it and by the legacy SQLite/layout importers. Pure so CLI-reachable modules can import it. */
+export declare const LEGACY_LOCAL_PERSON = "user:local";
+/** The id of the local terminal grant an install carried before its grant became `terminal:<install id>`; nodes, tokens, crons and queued births may still reference it. */
+export declare const LEGACY_LOCAL_TERMINAL_GRANT = "local:terminal";

package/dist/core/canvas/legacy-person.js

@@ -0,0 +1,4 @@
+/** The person principal every install carried before it minted its own: read only by the one-shot that retires it and by the legacy SQLite/layout importers. Pure so CLI-reachable modules can import it. */
+export const LEGACY_LOCAL_PERSON = 'user:local';
+/** The id of the local terminal grant an install carried before its grant became `terminal:<install id>`; nodes, tokens, crons and queued births may still reference it. */
+export const LEGACY_LOCAL_TERMINAL_GRANT = 'local:terminal';

package/dist/core/scoped-state/db.js

@@ -8,7 +8,7 @@ import { withExclusiveDirectoryLock } from '../exclusive-lock.js';
 import { syncDirectory, syncFile } from '../fs-utils.js';
 import { layoutNeedsMigration } from '../layout.js';
 import { providerStore, projectStore, userStore } from './paths.js';
-import { createScopedSchema, ensureProviderModelCooldowns, PROVIDER_SCHEMA_VERSION, SCOPED_SCHEMA_VERSION } from './schema.js';
+import { createScopedSchema, ensureProviderModelCooldowns, PROFILE_ENVIRONMENT_COLUMN, PROVIDER_SCHEMA_VERSION, SCOPED_SCHEMA_VERSION } from './schema.js';
 const handles = new Map();
 export const PROFILE_ID_SHAPE = /^[a-z0-9]+(?:-[a-z0-9]+)*-[0-9a-f]{8}$/;
 export function writeOwnerRoot(db, key, root) {
@@ -27,6 +27,9 @@ function assertVersion(db, store) {
     if (found !== expected)
         throw new Error(`scoped SQL store ${store.path} requires an explicit conversion`);
 }
+function profilesHaveEnvironmentColumn(db) {
+    return db.prepare('PRAGMA table_info(profiles)').all().some(({ name }) => name === PROFILE_ENVIRONMENT_COLUMN);
+}
 function upgradeScopedStore(db, store) {
     if (store.kind === 'provider') {
         if (version(db) === PROVIDER_SCHEMA_VERSION) {
@@ -35,9 +38,12 @@ function upgradeScopedStore(db, store) {
         }
         return;
     }
-    if (version(db) >= SCOPED_SCHEMA_VERSION)
+    if (version(db) > SCOPED_SCHEMA_VERSION)
+        return;
+    db.exec('PRAGMA busy_timeout = 5000');
+    if (version(db) === SCOPED_SCHEMA_VERSION && profilesHaveEnvironmentColumn(db))
         return;
-    db.exec('PRAGMA busy_timeout = 5000; BEGIN IMMEDIATE');
+    db.exec('BEGIN IMMEDIATE');
     try {
         if (version(db) === 1) {
             const columns = db.prepare('PRAGMA table_info(profiles)').all();
@@ -64,6 +70,8 @@ function upgradeScopedStore(db, store) {
             }
             db.exec(`PRAGMA user_version = ${SCOPED_SCHEMA_VERSION}`);
         }
+        if (version(db) === SCOPED_SCHEMA_VERSION && !profilesHaveEnvironmentColumn(db))
+            db.exec(`ALTER TABLE profiles ADD COLUMN ${PROFILE_ENVIRONMENT_COLUMN} TEXT`);
         db.exec('COMMIT');
     }
     catch (error) {

package/dist/core/scoped-state/profiles.js

@@ -2,12 +2,13 @@ import { prepared as cachedStatement } from '../sqlite-statements.js';
 import { canonicalRoot, userStore } from './paths.js';
 import { profileSpace } from '../layout.js';
 import { openScopedStore, withScopedWrite } from './db.js';
+import { LEGACY_LOCAL_PERSON } from '../canvas/legacy-person.js';
 function store(root) { return userStore(root); }
 function rowToProfile(row, projects) {
-    return { profileId: row.id, manifest: { schema_version: 1, name: row.name, projects, paused_at: row.paused_at, ...(row.default_kind === null ? {} : { default_kind: row.default_kind }), ...(row.grantee === null ? {} : { grantee: row.grantee }), ...(row.delivery_limits_json === '{}' ? {} : { delivery_limits: JSON.parse(row.delivery_limits_json) }), ...(Object.keys(JSON.parse(row.metadata_json)).length === 0 ? {} : { metadata: JSON.parse(row.metadata_json) }), created_at: row.created_at, last_used_at: row.last_used_at } };
+    return { profileId: row.id, manifest: { schema_version: 1, name: row.name, projects, paused_at: row.paused_at, ...(row.default_kind === null ? {} : { default_kind: row.default_kind }), ...(row.grantee === null ? {} : { grantee: row.grantee }), ...(row.environment_id === null ? {} : { environment_id: row.environment_id }), ...(row.delivery_limits_json === '{}' ? {} : { delivery_limits: JSON.parse(row.delivery_limits_json) }), ...(Object.keys(JSON.parse(row.metadata_json)).length === 0 ? {} : { metadata: JSON.parse(row.metadata_json) }), created_at: row.created_at, last_used_at: row.last_used_at } };
 }
 function get(db, id) {
-    const row = cachedStatement(db, 'SELECT id, name, created_at, last_used_at, paused_at, default_kind, grantee, metadata_json, delivery_limits_json FROM profiles WHERE id=?').get(id);
+    const row = cachedStatement(db, 'SELECT id, name, created_at, last_used_at, paused_at, default_kind, grantee, metadata_json, delivery_limits_json, environment_id FROM profiles WHERE id=?').get(id);
     if (!row)
         return null;
     const projects = cachedStatement(db, 'SELECT path FROM profile_projects WHERE profile_id=? ORDER BY position').all(id);
@@ -30,7 +31,7 @@ export function pausedProfileIds(root) {
 }
 export function insertStoredProfile(root, profile) {
     withScopedWrite(store(root), (db) => {
-        cachedStatement(db, 'INSERT INTO profiles(id,name,created_at,last_used_at,paused_at,default_kind,grantee,metadata_json,delivery_limits_json) VALUES(?,?,?,?,?,?,?,?,?)').run(profile.profileId, profile.manifest.name, profile.manifest.created_at, profile.manifest.last_used_at, profile.manifest.paused_at, profile.manifest.default_kind ?? null, profile.manifest.grantee ?? null, JSON.stringify(profile.manifest.metadata ?? {}), JSON.stringify(profile.manifest.delivery_limits ?? {}));
+        cachedStatement(db, 'INSERT INTO profiles(id,name,created_at,last_used_at,paused_at,default_kind,grantee,metadata_json,delivery_limits_json,environment_id) VALUES(?,?,?,?,?,?,?,?,?,?)').run(profile.profileId, profile.manifest.name, profile.manifest.created_at, profile.manifest.last_used_at, profile.manifest.paused_at, profile.manifest.default_kind ?? null, profile.manifest.grantee ?? null, JSON.stringify(profile.manifest.metadata ?? {}), JSON.stringify(profile.manifest.delivery_limits ?? {}), profile.manifest.environment_id ?? null);
         cachedStatement(db, 'INSERT INTO scope_owners(owner_key,kind,root,profile_id) VALUES(?,?,?,?)').run(`profile:${profile.profileId}`, 'profile', canonicalRoot(profileSpace(profile.manifest.grantee ?? 'app:terminal', profile.profileId).dir), profile.profileId);
         const insert = cachedStatement(db, 'INSERT INTO profile_projects(profile_id,path,position) VALUES(?,?,?)');
         profile.manifest.projects.forEach((project, position) => insert.run(profile.profileId, project.path, position));
@@ -42,7 +43,7 @@ export function updateStoredProfile(root, id, mutate) {
         if (!current)
             return null;
         const next = mutate(current.manifest);
-        cachedStatement(db, 'UPDATE profiles SET name=?, last_used_at=?, paused_at=?, default_kind=?, grantee=?, metadata_json=?, delivery_limits_json=? WHERE id=?').run(next.name, next.last_used_at, next.paused_at, next.default_kind ?? null, next.grantee ?? null, JSON.stringify(next.metadata ?? {}), JSON.stringify(next.delivery_limits ?? {}), id);
+        cachedStatement(db, 'UPDATE profiles SET name=?, last_used_at=?, paused_at=?, default_kind=?, grantee=?, metadata_json=?, delivery_limits_json=?, environment_id=? WHERE id=?').run(next.name, next.last_used_at, next.paused_at, next.default_kind ?? null, next.grantee ?? null, JSON.stringify(next.metadata ?? {}), JSON.stringify(next.delivery_limits ?? {}), next.environment_id ?? null, id);
         cachedStatement(db, 'DELETE FROM profile_projects WHERE profile_id=?').run(id);
         const insert = cachedStatement(db, 'INSERT INTO profile_projects(profile_id,path,position) VALUES(?,?,?)');
         next.projects.forEach((project, position) => insert.run(id, project.path, position));
@@ -65,7 +66,7 @@ export function deleteStoredProfile(root, id) {
 }
 export function rewriteLocalProfileGrantees(root) {
     withScopedWrite(store(root), (db) => {
-        cachedStatement(db, "UPDATE profiles SET grantee = 'app:terminal' WHERE grantee = 'user:local'").run();
+        cachedStatement(db, "UPDATE profiles SET grantee = 'app:terminal' WHERE grantee = ?").run(LEGACY_LOCAL_PERSON);
     });
 }
 export function readStoredDefaults(root) {

package/dist/core/scoped-state/schema.d.ts

@@ -1,6 +1,10 @@
 import type { DatabaseSync } from 'node:sqlite';
 export declare const SCOPED_SCHEMA_VERSION = 5;
 export declare const PROVIDER_SCHEMA_VERSION = 1;
+/** `profiles.environment_id` (null = the machine environment) is additive to version 5: a store written before it gains the
+ *  column on open (`upgradeScopedStore`), and an older generation sharing the store names its columns and never reads it, so
+ *  the version stays 5 and a runtime rollback keeps opening the store. */
+export declare const PROFILE_ENVIRONMENT_COLUMN = "environment_id";
 /** Adds the model-cooldown table to a provider store that predates it; a no-op (no write) once present. */
 export declare function ensureProviderModelCooldowns(db: DatabaseSync): void;
 export declare function createScopedSchema(db: DatabaseSync, kind: 'user' | 'project' | 'provider'): void;

package/dist/core/scoped-state/schema.js

@@ -1,9 +1,13 @@
 import { prepared as cachedStatement } from '../sqlite-statements.js';
 export const SCOPED_SCHEMA_VERSION = 5;
 export const PROVIDER_SCHEMA_VERSION = 1;
+/** `profiles.environment_id` (null = the machine environment) is additive to version 5: a store written before it gains the
+ *  column on open (`upgradeScopedStore`), and an older generation sharing the store names its columns and never reads it, so
+ *  the version stays 5 and a runtime rollback keeps opening the store. */
+export const PROFILE_ENVIRONMENT_COLUMN = 'environment_id';
 const SCOPE_SCHEMA = `
 CREATE TABLE scope_owners (owner_key TEXT PRIMARY KEY, kind TEXT NOT NULL CHECK(kind IN ('user','profile','project')), root TEXT NOT NULL UNIQUE, profile_id TEXT UNIQUE);
-CREATE TABLE profiles (id TEXT PRIMARY KEY, name TEXT NOT NULL, created_at TEXT NOT NULL, last_used_at TEXT, paused_at TEXT, default_kind TEXT, grantee TEXT, metadata_json TEXT NOT NULL CHECK(json_valid(metadata_json)), delivery_limits_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(delivery_limits_json)));
+CREATE TABLE profiles (id TEXT PRIMARY KEY, name TEXT NOT NULL, created_at TEXT NOT NULL, last_used_at TEXT, paused_at TEXT, default_kind TEXT, grantee TEXT, metadata_json TEXT NOT NULL CHECK(json_valid(metadata_json)), delivery_limits_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(delivery_limits_json)), environment_id TEXT);
 CREATE TABLE profile_projects (profile_id TEXT NOT NULL REFERENCES profiles(id) ON DELETE CASCADE, path TEXT NOT NULL, position INTEGER NOT NULL, PRIMARY KEY(profile_id,path), UNIQUE(profile_id,position));
 -- Pre-canvas per-project memory caps awaiting the canvas import, which turns them into delivery_limits and deletes the rows.
 CREATE TABLE legacy_project_caps (profile_id TEXT NOT NULL, path TEXT NOT NULL, memory TEXT NOT NULL CHECK(memory IN ('none','name','preview')), PRIMARY KEY(profile_id,path));

package/dist/types.d.ts

@@ -553,6 +553,8 @@ export interface ProfileManifest {
     delivery_limits?: DeliveryLimits;
     /** App that owns this profile; older terminal profiles have no grantee. */
     grantee?: string;
+    /** The environment the profile's nodes run in; absent means the install's machine environment. */
+    environment_id?: string;
     created_at: string;
     last_used_at: string | null;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.538",
+  "version": "0.3.540",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, the CrtrClient, and the command-plugin manifest format. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/api/index.js",