@north-light/api 0.3.415 → 0.3.416

package/dist/shared/env.d.ts

@@ -1,12 +1,13 @@
 /** The current node's id (`CRTR_NODE_ID`), or undefined outside a node. */
 export declare function envNodeId(): string | undefined;
 /** Find the single launch snapshot mounted by the launcher into this process's
- * Linux namespace. Cron bash has no CRTR_NODE_ID, but its creator's mounted
- * launch snapshot supplies config and granted-command projection without
- * claiming the cron is a node. Its broker relay may already have closed when
- * the cron fires; still classify the sandbox so CLI bootstrap never falls back
- * to host stores or person authority. Neither CRTR_NODE_ID, CRTR_ANCHOR, nor
+ * Linux namespace. Cron bash has no CRTR_NODE_ID: its own execution folder
+ * (`cron-<execution_id>`, holding `cron-launch.json` and the execution socket)
+ * supplies config and granted-command projection without claiming the cron is
+ * a node, and never falls back to host stores or person authority. Neither CRTR_NODE_ID, CRTR_ANCHOR, nor
  * the caller-editable CRTR_API_SOCKET selects the launch identity. */
+/** The launch snapshot a mounted run folder carries: a node's `broker-launch.json`, or a cron execution's `cron-launch.json`. */
+export declare function launchSnapshotFile(dir: string): string | undefined;
 export declare function sandboxCliNodeId(): string | undefined;
 /** A Linux app command uses its mounted launch snapshot, not host user stores. */
 export declare function isSandboxedNode(): boolean;

package/dist/shared/env.js

@@ -30,12 +30,20 @@ export function envNodeId() {
     return process.env['CRTR_NODE_ID'];
 }
 /** Find the single launch snapshot mounted by the launcher into this process's
- * Linux namespace. Cron bash has no CRTR_NODE_ID, but its creator's mounted
- * launch snapshot supplies config and granted-command projection without
- * claiming the cron is a node. Its broker relay may already have closed when
- * the cron fires; still classify the sandbox so CLI bootstrap never falls back
- * to host stores or person authority. Neither CRTR_NODE_ID, CRTR_ANCHOR, nor
+ * Linux namespace. Cron bash has no CRTR_NODE_ID: its own execution folder
+ * (`cron-<execution_id>`, holding `cron-launch.json` and the execution socket)
+ * supplies config and granted-command projection without claiming the cron is
+ * a node, and never falls back to host stores or person authority. Neither CRTR_NODE_ID, CRTR_ANCHOR, nor
  * the caller-editable CRTR_API_SOCKET selects the launch identity. */
+/** The launch snapshot a mounted run folder carries: a node's `broker-launch.json`, or a cron execution's `cron-launch.json`. */
+export function launchSnapshotFile(dir) {
+    for (const name of ['broker-launch.json', 'cron-launch.json']) {
+        const path = join(dir, name);
+        if (lstatSync(path, { throwIfNoEntry: false })?.isFile())
+            return path;
+    }
+    return undefined;
+}
 export function sandboxCliNodeId() {
     if (process.platform !== 'linux')
         return undefined;
@@ -45,7 +53,7 @@ export function sandboxCliNodeId() {
         const ids = readdirSync(root, { withFileTypes: true }).filter((entry) => entry.isDirectory() &&
             /^[a-zA-Z0-9][a-zA-Z0-9-]{0,127}$/.test(entry.name) &&
             mounted.has(join(root, entry.name)) &&
-            lstatSync(join(root, entry.name, 'broker-launch.json'), { throwIfNoEntry: false })?.isFile());
+            launchSnapshotFile(join(root, entry.name)) !== undefined);
         return ids.length === 1 ? ids[0].name : undefined;
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/api",
-  "version": "0.3.415",
+  "version": "0.3.416",
   "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",