pi-radar 0.3.0 → 0.4.0

package/dist/extension/radar-client.js

@@ -109,6 +109,25 @@ function recordAt(value, field) {
 function isUuid(value) {
   return typeof value === "string" && UUID.test(value);
 }
+function decodePresenceAnswer(value) {
+  const registrationId = recordAt(value, "registration_id");
+  const claimId = recordAt(value, "claim_id");
+  const standing = recordAt(value, "standing");
+  const subjectId = recordAt(value, "subject_id");
+  if (!isUuid(registrationId) || !isUuid(claimId) || !["pending", "granted", "duplicate", "released"].includes(String(standing)) || subjectId !== void 0 && !isUuid(subjectId) || standing === "granted" && !isUuid(subjectId))
+    return protocol("presence reply carries no valid claim standing");
+  return { ok: true, value };
+}
+function managementAt(value) {
+  const field = recordAt(value, "management");
+  const state = stringAt(field, "state");
+  if (state === "managed") {
+    const subjectId = stringAt(field, "subject_id");
+    return subjectId === void 0 ? void 0 : { state, subject_id: subjectId };
+  }
+  if (state === "duplicate" || state === "pending" || state === "unmanaged") return { state };
+  return void 0;
+}
 function stringAt(value, field) {
   if (typeof value !== "object" || value === null) return void 0;
   const found = value[field];
@@ -129,7 +148,7 @@ function handoffAt(value) {
   const content = stringAt(value, "content");
   const published = numberAt(value, "published_at_unix_ms");
   const correlation = typeof value === "object" && value !== null ? value.correlation_id : void 0;
-  if (version !== 1 || !isUuid(id) || !isUuid(stringAt(sender, "agent_id")) || !isUuid(stringAt(sender, "session_id")) || !isUuid(stringAt(sender, "subject_id")) || !isUuid(stringAt(sender, "execution_id")) || !Number.isSafeInteger(senderGeneration) || (senderGeneration ?? 0) < 1 || !isUuid(target) || summary === void 0 || content === void 0 || published === void 0 || !Number.isSafeInteger(published) || published < 0 || correlation !== void 0 && correlation !== null && (typeof correlation !== "string" || correlation.length === 0 || Buffer.byteLength(correlation, "utf8") > 256 || new RegExp("\\p{Cc}", "u").test(correlation))) return void 0;
+  if (version !== 1 || !isUuid(id) || !isUuid(stringAt(sender, "registration_id")) || !isUuid(stringAt(sender, "session_id")) || !isUuid(stringAt(sender, "subject_id")) || !isUuid(stringAt(sender, "execution_id")) || !Number.isSafeInteger(senderGeneration) || (senderGeneration ?? 0) < 1 || !isUuid(target) || summary === void 0 || content === void 0 || published === void 0 || !Number.isSafeInteger(published) || published < 0 || correlation !== void 0 && correlation !== null && (typeof correlation !== "string" || correlation.length === 0 || Buffer.byteLength(correlation, "utf8") > 256 || new RegExp("\\p{Cc}", "u").test(correlation))) return void 0;
   return value;
 }
 function handoffReceiptAt(value) {
@@ -138,7 +157,7 @@ function handoffReceiptAt(value) {
   const recipient = recordAt(value, "recipient");
   const generation = numberAt(recipient, "execution_generation");
   const received = numberAt(value, "received_at_unix_ms");
-  if (version !== 1 || !isUuid(handoffId) || !isUuid(stringAt(recipient, "agent_id")) || !isUuid(stringAt(recipient, "session_id")) || !isUuid(stringAt(recipient, "subject_id")) || !isUuid(stringAt(recipient, "execution_id")) || !Number.isSafeInteger(generation) || (generation ?? 0) < 1 || received === void 0 || !Number.isSafeInteger(received) || received < 0) return void 0;
+  if (version !== 1 || !isUuid(handoffId) || !isUuid(stringAt(recipient, "registration_id")) || !isUuid(stringAt(recipient, "session_id")) || !isUuid(stringAt(recipient, "subject_id")) || !isUuid(stringAt(recipient, "execution_id")) || !Number.isSafeInteger(generation) || (generation ?? 0) < 1 || received === void 0 || !Number.isSafeInteger(received) || received < 0) return void 0;
   return value;
 }
 function writerBinding(value) {
@@ -296,7 +315,7 @@ function spawnEdge(value) {
   const bound = recordAt(value, "bound");
   const source = stringAt(bound, "source");
   const incarnation = stringAt(bound, "incarnation");
-  const agentId = stringAt(bound, "agent_id");
+  const agentId = stringAt(bound, "registration_id");
   const exit = exitAt(recordAt(value, "exit_observation"));
   return {
     ok: true,
@@ -310,7 +329,7 @@ function spawnEdge(value) {
         bound: {
           source,
           incarnation,
-          ...isUuid(agentId) ? { agent_id: agentId } : {}
+          ...isUuid(agentId) ? { registration_id: agentId } : {}
         }
       } : {},
       ...exit !== void 0 ? { exit_observation: exit } : {}
@@ -708,6 +727,22 @@ function createRadarClient(options = {}) {
   return {
     socketPath,
     ping,
+    async presence(request) {
+      return withRegistry(async () => {
+        const answer = await call("agent.presence", { ...request });
+        if (!answer.ok) return answer;
+        return decodePresenceAnswer(answer.value);
+      });
+    },
+    async releasePresence(request) {
+      return withRegistry(async () => {
+        const answer = await call("agent.release", { ...request });
+        if (!answer.ok) return answer;
+        const decoded = decodePresenceAnswer(answer.value);
+        if (!decoded.ok) return decoded;
+        return decoded.value.standing === "released" ? decoded : protocol("release reply did not confirm the claim release");
+      });
+    },
     async register(registration) {
       return withRegistry(async () => {
         const answer = await call("agent.register", {
@@ -723,15 +758,15 @@ function createRadarClient(options = {}) {
         });
         if (answer.ok === false) return answer;
         const record = answer.value.registration;
-        const agentId = stringAt(record, "agent_id");
-        if (!isUuid(agentId)) return protocol("registration reply carries no agent_id");
-        return { ok: true, value: { agent_id: agentId } };
+        const agentId = stringAt(record, "registration_id");
+        if (!isUuid(agentId)) return protocol("registration reply carries no registration_id");
+        return { ok: true, value: { registration_id: agentId } };
       });
     },
     async acquire(request) {
       return withRegistryChannel(request.channel, async () => {
         const answer = await call("agent.acquire", {
-          agent_id: request.agent_id,
+          registration_id: request.registration_id,
           channel: request.channel,
           publisher: request.publisher,
           ...request.replace !== void 0 ? { replace: request.replace } : {}
@@ -760,7 +795,7 @@ function createRadarClient(options = {}) {
       }
       return withRegistryChannel(request.channel, async () => {
         const answer = await call("agent.publish", {
-          agent_id: request.agent_id,
+          registration_id: request.registration_id,
           channel: request.channel,
           writer_handle: request.writer_handle,
           sequence: request.sequence,
@@ -779,7 +814,7 @@ function createRadarClient(options = {}) {
     async context(request) {
       return withRegistry(async () => {
         const answer = await call("agent.context", {
-          agent_id: request.agent_id,
+          registration_id: request.registration_id,
           publisher: request.publisher,
           ...request.writer_handle !== void 0 ? { writer_handle: request.writer_handle } : {},
           ...request.replace !== void 0 ? { replace: request.replace } : {},
@@ -795,9 +830,14 @@ function createRadarClient(options = {}) {
         if (writer === void 0)
           return protocol("context reply carries no writer binding");
         const warning = stringAt(answer.value, "warning");
+        const management = managementAt(answer.value);
         return {
           ok: true,
-          value: { writer, ...warning !== void 0 ? { warning } : {} }
+          value: {
+            writer,
+            ...warning !== void 0 ? { warning } : {},
+            ...management !== void 0 ? { management } : {}
+          }
         };
       });
     },
@@ -874,7 +914,7 @@ function createRadarClient(options = {}) {
           message: "agent.get requires a canonical agent UUID"
         };
       return withRegistry(async () => {
-        const answer = await call("agent.get", { agent_id: agentId });
+        const answer = await call("agent.get", { registration_id: agentId });
         if (answer.ok === false) return answer;
         return agentProcessAt(recordAt(answer.value, "agent"));
       });
@@ -928,7 +968,7 @@ function createRadarClient(options = {}) {
     async communicationPublish(request) {
       return withContract(RADAR_COMMUNICATION_CONTRACT, async () => {
         const answer = await call("communication.publish", {
-          sender_agent_id: request.sender_agent_id,
+          sender_registration_id: request.sender_registration_id,
           recipient_subject_id: request.recipient_subject_id,
           ...request.correlation_id !== void 0 ? { correlation_id: request.correlation_id } : {},
           summary: request.summary,

package/dist/extension/radar-communication.js

@@ -2,7 +2,7 @@
 function createRadarHandoffPort(client, publication, parentSubjectId = () => process.env.PI_RADAR_MANAGED_PARENT_SUBJECT_ID) {
   async function agentId() {
     const subject = await publication.subject();
-    return subject === void 0 ? { ok: false, code: "absent", message: "this process has no current Radar registration" } : { ok: true, value: subject.agent_id };
+    return subject === void 0 ? { ok: false, code: "absent", message: "this process has no current Radar registration" } : { ok: true, value: subject.registration_id };
   }
   return {
     async publish(request) {
@@ -13,24 +13,24 @@ function createRadarHandoffPort(client, publication, parentSubjectId = () => pro
         return { ok: false, code: "absent", message: "this managed execution has no Radar parent subject" };
       return client.communicationPublish({
         ...request,
-        sender_agent_id: identity.value,
+        sender_registration_id: identity.value,
         recipient_subject_id: parent
       });
     },
     async inbox() {
       const identity = await agentId();
       if (identity.ok === false) return identity;
-      return client.communicationInbox({ agent_id: identity.value });
+      return client.communicationInbox({ registration_id: identity.value });
     },
     async get(handoff_id) {
       const identity = await agentId();
       if (identity.ok === false) return identity;
-      return client.communicationGet({ agent_id: identity.value, handoff_id });
+      return client.communicationGet({ registration_id: identity.value, handoff_id });
     },
     async ack(handoff_id) {
       const identity = await agentId();
       if (identity.ok === false) return identity;
-      return client.communicationAck({ agent_id: identity.value, handoff_id });
+      return client.communicationAck({ registration_id: identity.value, handoff_id });
     }
   };
 }