pi-radar 0.6.0 → 0.9.0

package/extension/radar-publication.ts

@@ -269,6 +269,7 @@ export function createPublicationStore(root: string): PublicationStore {
  */
 export type RadarProcessSlot = {
 	incarnation?: string;
+	launchRegistrationId?: string;
 	publications: Map<string, RadarPublication>;
 };
 
@@ -280,7 +281,13 @@ export function radarProcessSlot(): RadarProcessSlot {
 	const host = globalThis as typeof globalThis & {
 		[PROCESS_SLOT]?: RadarProcessSlot;
 	};
-	return (host[PROCESS_SLOT] ??= createRadarProcessSlot());
+	if (!host[PROCESS_SLOT]) {
+		const slot = createRadarProcessSlot();
+		slot.launchRegistrationId = process.env.PI_RADAR_REGISTRATION_ID;
+		delete process.env.PI_RADAR_REGISTRATION_ID;
+		host[PROCESS_SLOT] = slot;
+	}
+	return host[PROCESS_SLOT];
 }
 
 /** The process incarnation, created on first use and kept for the process. */
@@ -975,7 +982,6 @@ function createPresenceReporter(input: PresenceReporterInput): RadarPresenceRepo
 	type State = {
 		version: 2;
 		claim_id: string;
-	initial_load?: boolean;
 		session: string;
 		registration_id?: string;
 		subject_id?: string;
@@ -1033,13 +1039,6 @@ function createPresenceReporter(input: PresenceReporterInput): RadarPresenceRepo
 			await releasePending();
 			const registration = await input.registration();
 			if (!registration?.process || state !== claim || stopped) return undefined;
-			// The first load spends the pre-minted launch claim. Reloads get a fresh
-			// claim; they must not reuse the released launch credential.
-			if (claim.initial_load) {
-				if (registration.spawn_token) claim.claim_id = registration.spawn_token;
-				claim.initial_load = false;
-				if (!save()) return undefined;
-			}
 			const answer = await client.presence({
 				...registration, process: registration.process,
 				session_id: claim.session, claim_id: claim.claim_id,
@@ -1079,7 +1078,7 @@ function createPresenceReporter(input: PresenceReporterInput): RadarPresenceRepo
 				releases.push({ registration_id: state.registration_id, claim_id: state.claim_id });
 			}
 			standing = undefined;
-			state = { version: 2, session, claim_id: randomUUID(), initial_load: state === undefined, releases };
+			state = { version: 2, session, claim_id: randomUUID(), releases };
 			save(); stopped = false;
 			void ensure();
 		},
@@ -1159,7 +1158,7 @@ export type RadarPublicationOptions = {
 	/** Set on a managed child: the sidecar its owner correlates the subject with. */
 	binding?: { key: string; run: string; owner: string; label: string };
 	/** A daemon-spawned child's one-use launch token; sent privately, never stored in the process record. */
-	spawnToken?: string;
+	launchRegistrationId?: string;
 	leaseMs?: number;
 	heartbeatMs?: number;
 };
@@ -1234,8 +1233,8 @@ function createRadarPublicationInner(
 	const store = options.store ?? createPublicationStore(dataRoot);
 	const scheduler = options.scheduler ?? systemScheduler;
 	const client = options.client;
-	const spawnToken = options.spawnToken;
 	const slot = options.slot ?? radarProcessSlot();
+	const launchRegistrationId = options.launchRegistrationId ?? slot.launchRegistrationId;
 	const incarnation = options.incarnation ?? radarProcessIncarnation(slot);
 
 	const cacheKey = `${
@@ -1424,7 +1423,7 @@ function createRadarPublicationInner(
 			const { location: _initialLocation, ...identity } = record.registration;
 			return { ...identity,
 				...(location?.state === "resolved" ? { location: location.location } : {}),
-				...(spawnToken ? { spawn_token: spawnToken } : {}),
+				...(launchRegistrationId ? { registration_id: launchRegistrationId } : {}),
 			};
 		},
 		heartbeatMs: options.heartbeatMs ?? RADAR_HEARTBEAT_MS,

package/extension/radar-runtime.ts

@@ -1,10 +1,11 @@
 import type { RadarExecutionAdapter } from "./radar-execution.ts";
+import type { RadarChildren } from "./radar-children.ts";
 import type { RadarHandoffPort } from "./radar-communication.ts";
 import type { RadarPublication } from "./radar-publication.ts";
 
 /** The event channel through which Pi extensions obtain the baseline runtime. */
 export const RADAR_RUNTIME_REQUEST = "pi-radar/runtime-request";
-export const RADAR_RUNTIME_VERSION = 2 as const;
+export const RADAR_RUNTIME_VERSION = 3 as const;
 
 /** The sole baseline publisher's session-scoped runtime, shared with consumers. */
 export type RadarRuntimeServices = {
@@ -12,6 +13,8 @@ export type RadarRuntimeServices = {
 	publication: RadarPublication;
 	/** Durable handoffs bound to this process's registration and managed parent. */
 	communication: RadarHandoffPort;
+	/** This process's own children, addressed by subject. */
+	children: RadarChildren;
 	execution: RadarExecutionAdapter;
 };
 

package/index.ts

@@ -1,3 +1,4 @@
+export * as children from "./extension/radar-children.ts";
 export * as client from "./extension/radar-client.ts";
 export * as communication from "./extension/radar-communication.ts";
 export * as execution from "./extension/radar-execution.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-radar",
-  "version": "0.6.0",
+  "version": "0.9.0",
   "type": "module",
   "description": "Radar daemon client, communication, publication, execution, location, launch and inspection surface for Pi extensions.",
   "license": "Apache-2.0",
@@ -23,6 +23,10 @@
       "types": "./index.ts",
       "import": "./dist/index.js"
     },
+    "./children": {
+      "types": "./extension/radar-children.ts",
+      "import": "./dist/extension/radar-children.js"
+    },
     "./client": {
       "types": "./extension/radar-client.ts",
       "import": "./dist/extension/radar-client.js"
@@ -72,6 +76,7 @@
     "README.md",
     "schema/public/v1/**",
     "extension/generated-contracts.ts",
+    "extension/radar-children.ts",
     "extension/radar-client.ts",
     "extension/radar-communication.ts",
     "extension/radar-execution.ts",
@@ -83,10 +88,10 @@
     "extension/baseline.ts"
   ],
   "scripts": {
-    "build": "esbuild index.ts extension/generated-contracts.ts extension/radar-client.ts extension/radar-communication.ts extension/radar-execution.ts extension/radar-inspection.ts extension/radar-launch.ts extension/radar-location.ts extension/radar-publication.ts extension/radar-runtime.ts extension/baseline.ts --outbase=. --outdir=dist --bundle --platform=node --format=esm --target=node22",
+    "build": "esbuild index.ts extension/generated-contracts.ts extension/radar-children.ts extension/radar-client.ts extension/radar-communication.ts extension/radar-execution.ts extension/radar-inspection.ts extension/radar-launch.ts extension/radar-location.ts extension/radar-publication.ts extension/radar-runtime.ts extension/baseline.ts --outbase=. --outdir=dist --bundle --platform=node --format=esm --target=node22",
     "generate:contracts": "node tools/generate-contracts.mjs",
     "check:contracts": "node tools/generate-contracts.mjs --check",
-    "typecheck:contracts": "tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext --moduleResolution NodeNext --allowImportingTsExtensions --types node index.ts extension/baseline.ts extension/generated-contracts.ts extension/generated-contracts.typecheck.ts extension/radar-client.ts extension/radar-communication.ts extension/radar-execution.ts extension/radar-launch.test.ts extension/radar-publication.ts extension/radar-runtime.ts extension/radar-runtime.test.ts",
+    "typecheck:contracts": "tsc --noEmit --strict --skipLibCheck --target ES2022 --module NodeNext --moduleResolution NodeNext --allowImportingTsExtensions --types node index.ts extension/baseline.ts extension/generated-contracts.ts extension/generated-contracts.typecheck.ts extension/radar-children.ts extension/radar-client.ts extension/radar-communication.ts extension/radar-execution.ts extension/radar-launch.test.ts extension/radar-publication.ts extension/radar-runtime.ts extension/radar-runtime.test.ts",
     "prepack": "npm run build",
     "test": "npm run check:contracts && npm run typecheck:contracts && node --experimental-strip-types --test extension/*.test.ts"
   },

package/schema/public/v1/observation-get-response.deserialize.schema.json

@@ -2098,6 +2098,13 @@
         },
         "registration": {
           "$ref": "#/$defs/PublicRegistration"
+        },
+        "scoped": {
+          "description": "Whether this process runs inside a Radar-established execution scope. A\nprocess started outside the managed launch path has none and is observed.",
+          "type": [
+            "boolean",
+            "null"
+          ]
         }
       },
       "required": [
@@ -2424,6 +2431,7 @@
     },
     "Standing": {
       "enum": [
+        "reserved",
         "pending",
         "granted",
         "duplicate",
@@ -2440,7 +2448,7 @@
         },
         {
           "const": "captured",
-          "description": "The bootstrap's process is captured and released to exec.",
+          "description": "The launch's process is captured and has been given its program.",
           "type": "string"
         },
         {

package/schema/public/v1/observation-get-response.serialize.schema.json

@@ -2201,6 +2201,13 @@
         },
         "registration": {
           "$ref": "#/$defs/PublicRegistration"
+        },
+        "scoped": {
+          "description": "Whether this process runs inside a Radar-established execution scope. A\nprocess started outside the managed launch path has none and is observed.",
+          "type": [
+            "boolean",
+            "null"
+          ]
         }
       },
       "required": [
@@ -2543,6 +2550,7 @@
     },
     "Standing": {
       "enum": [
+        "reserved",
         "pending",
         "granted",
         "duplicate",
@@ -2559,7 +2567,7 @@
         },
         {
           "const": "captured",
-          "description": "The bootstrap's process is captured and released to exec.",
+          "description": "The launch's process is captured and has been given its program.",
           "type": "string"
         },
         {

package/schema/public/v1/observation-snapshot.deserialize.schema.json

@@ -1963,6 +1963,13 @@
         },
         "registration": {
           "$ref": "#/$defs/PublicRegistration"
+        },
+        "scoped": {
+          "description": "Whether this process runs inside a Radar-established execution scope. A\nprocess started outside the managed launch path has none and is observed.",
+          "type": [
+            "boolean",
+            "null"
+          ]
         }
       },
       "required": [
@@ -2289,6 +2296,7 @@
     },
     "Standing": {
       "enum": [
+        "reserved",
         "pending",
         "granted",
         "duplicate",
@@ -2305,7 +2313,7 @@
         },
         {
           "const": "captured",
-          "description": "The bootstrap's process is captured and released to exec.",
+          "description": "The launch's process is captured and has been given its program.",
           "type": "string"
         },
         {

package/schema/public/v1/observation-snapshot.serialize.schema.json

@@ -2057,6 +2057,13 @@
         },
         "registration": {
           "$ref": "#/$defs/PublicRegistration"
+        },
+        "scoped": {
+          "description": "Whether this process runs inside a Radar-established execution scope. A\nprocess started outside the managed launch path has none and is observed.",
+          "type": [
+            "boolean",
+            "null"
+          ]
         }
       },
       "required": [
@@ -2399,6 +2406,7 @@
     },
     "Standing": {
       "enum": [
+        "reserved",
         "pending",
         "granted",
         "duplicate",
@@ -2415,7 +2423,7 @@
         },
         {
           "const": "captured",
-          "description": "The bootstrap's process is captured and released to exec.",
+          "description": "The launch's process is captured and has been given its program.",
           "type": "string"
         },
         {

package/schema/public/v1/presence-answer.deserialize.schema.json

@@ -2,6 +2,7 @@
   "$defs": {
     "Standing": {
       "enum": [
+        "reserved",
         "pending",
         "granted",
         "duplicate",

package/schema/public/v1/presence-answer.serialize.schema.json

@@ -2,6 +2,7 @@
   "$defs": {
     "Standing": {
       "enum": [
+        "reserved",
         "pending",
         "granted",
         "duplicate",

package/schema/public/v1/presence-report.deserialize.schema.json

@@ -122,13 +122,6 @@
     "source": {
       "type": "string"
     },
-    "spawn_token": {
-      "default": null,
-      "type": [
-        "string",
-        "null"
-      ]
-    },
     "subject_id": {
       "default": null,
       "type": [

package/schema/public/v1/presence-report.serialize.schema.json

@@ -123,13 +123,6 @@
     "source": {
       "type": "string"
     },
-    "spawn_token": {
-      "default": null,
-      "type": [
-        "string",
-        "null"
-      ]
-    },
     "subject_id": {
       "default": null,
       "type": [
@@ -147,7 +140,6 @@
     "registration_id",
     "subject_id",
     "location",
-    "spawn_token",
     "owner",
     "run",
     "label"

package/schema/public/v1/spawn-list-page.deserialize.schema.json

@@ -20,6 +20,13 @@
         },
         "source": {
           "type": "string"
+        },
+        "subject_id": {
+          "description": "The durable agent the bound child attaches as. Absent for an edge without\na tracked launch and in records written before it was recorded.",
+          "type": [
+            "string",
+            "null"
+          ]
         }
       },
       "required": [

package/schema/public/v1/spawn-list-page.serialize.schema.json

@@ -20,6 +20,13 @@
         },
         "source": {
           "type": "string"
+        },
+        "subject_id": {
+          "description": "The durable agent the bound child attaches as. Absent for an edge without\na tracked launch and in records written before it was recorded.",
+          "type": [
+            "string",
+            "null"
+          ]
         }
       },
       "required": [