pi-herdsman 0.22.2 → 0.23.0

package/dist/index.js

@@ -15,7 +15,7 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 // package.json
 var package_default = {
   name: "pi-herdsman",
-  version: "0.22.2",
+  version: "0.23.0",
   type: "module",
   description: "Asynchronous Pi subagents and agent fleet orchestration for parallel coding agents with nested delegation, background work, and supervision in herdr.",
   license: "Apache-2.0",
@@ -90,12 +90,14 @@ var package_default = {
     "@earendil-works/pi-ai": "*",
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*",
+    "@howaboua/pi-codex-conversion": "^3.0.45",
     typebox: "*"
   },
   devDependencies: {
     "@earendil-works/pi-ai": "1.1.0",
     "@earendil-works/pi-coding-agent": "1.1.0",
     "@earendil-works/pi-tui": "1.1.0",
+    "@howaboua/pi-codex-conversion": "3.0.45",
     esbuild: "^0.28.2",
     typebox: "^1.3.7"
   },
@@ -112,6 +114,11 @@ var package_default = {
   ],
   publishConfig: {
     registry: "https://registry.npmjs.org/"
+  },
+  peerDependenciesMeta: {
+    "@howaboua/pi-codex-conversion": {
+      optional: true
+    }
   }
 };
 
@@ -553,6 +560,8 @@ function releaseProcessLock(claimDir, ownerPath, claim, name) {
 }
 
 // extension/mailbox.ts
+var MANAGED_AGENT_BOOTSTRAP_LIMIT_BYTES = 64 * 1024;
+var BOOTSTRAP_ID = /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/;
 var UUID2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 var PREFIX = "__PI_HERDSMAN_AGENT_V5__:";
 var MAILBOX_PROTOCOL_LIMIT_BYTES = 1024 * 1024;
@@ -563,6 +572,7 @@ var MailboxClaimOccupiedError = class extends Error {
   code = "MAILBOX_CLAIM_OCCUPIED";
 };
 var LIMITS = {
+  bootstrap: MANAGED_AGENT_BOOTSTRAP_LIMIT_BYTES,
   state: 64 * 1024,
   request: MAILBOX_PROTOCOL_LIMIT_BYTES,
   ask: MAILBOX_PROTOCOL_LIMIT_BYTES,
@@ -699,6 +709,41 @@ function validate(value2, kind) {
   if (Buffer.byteLength(text, "utf8") > LIMITS[kind])
     throw new Error("Mailbox record is too large");
   const v = value2;
+  if (kind === "bootstrap") {
+    const allowed2 = [
+      "version",
+      "build",
+      "runId",
+      "ownerSessionId",
+      "workspaceId",
+      "agentLabel",
+      "participants"
+    ];
+    if (Object.keys(v).some((key) => !allowed2.includes(key)))
+      throw new Error("Unknown mailbox field");
+    if (!isRuntimeBuild(v.build))
+      throw new Error("Invalid runtime build identity");
+    for (const field of [
+      "runId",
+      "ownerSessionId",
+      "workspaceId",
+      "agentLabel"
+    ])
+      if (typeof v[field] !== "string" || !v[field].trim())
+        throw new Error(`Invalid mailbox field: ${field}`);
+    if (!UUID2.test(v.runId)) throw new Error("Invalid mailbox UUID");
+    if (!Array.isArray(v.participants) || !v.participants.length)
+      throw new Error("Invalid bootstrap participants");
+    const ids = /* @__PURE__ */ new Set();
+    for (const participant of v.participants) {
+      if (!participant || typeof participant !== "object" || Object.keys(participant).some(
+        (key) => !["id", "payload"].includes(key)
+      ) || typeof participant.id !== "string" || !BOOTSTRAP_ID.test(participant.id) || ids.has(participant.id) || typeof participant.payload !== "string")
+        throw new Error("Invalid or duplicate bootstrap participant");
+      ids.add(participant.id);
+    }
+    return;
+  }
   const allowed = kind === "state" ? [
     "version",
     "build",
@@ -975,6 +1020,7 @@ function resetAgentMailbox(path) {
   for (const name of [
     "state.json",
     "ask.json",
+    "bootstrap.json",
     ...readdirSync3(path).filter(
       (x) => /^(request|result)-.*\.json$/.test(x)
     )
@@ -986,6 +1032,24 @@ function resetAgentMailbox(path) {
     }
   }
 }
+function writeAgentBootstrap(path, record) {
+  atomic(file(path, "bootstrap.json"), record, "bootstrap");
+}
+function readAgentBootstrap(path) {
+  const value2 = read(
+    file(path, "bootstrap.json"),
+    "bootstrap"
+  );
+  if (value2) validate(value2, "bootstrap");
+  return value2;
+}
+function removeAgentBootstrap(path) {
+  try {
+    unlinkSync2(file(path, "bootstrap.json"));
+  } catch (error2) {
+    if (error2.code !== "ENOENT") throw error2;
+  }
+}
 function removeAgentMailbox(path) {
   let names2;
   try {
@@ -1189,6 +1253,7 @@ function currentTurnIsSoleToolCall(ctx, name) {
   const calls = turn.content.filter((part) => part?.type === "toolCall");
   return calls.length === 1 && calls[0]?.name === name;
 }
+var MANAGED_AGENT_BOOTSTRAP_EVENT = "pi-herdsman:managed-agent-bootstrap";
 var FILE_HANDOFF_GUIDANCE = "Pass every user-supplied or already-available artifact relevant to the recipient's assignment, decisions, integration, validation, or onward handoff through `files`; do not assume the recipient inherits the sender's conversation or attachments. Preserve exact supplied result refs when forwarding them and omit unrelated evidence. `files` carries evidence, not runtime capability.";
 function failUnknownResultRef(input, operation) {
   fail(
@@ -12144,6 +12209,7 @@ function createAgentController(pi, options) {
       let promptWriteFailed = false;
       let started;
       let accepted = false;
+      const preparedBootstrap = [];
       try {
         try {
           promptPaths = writePrivatePromptSnapshots([
@@ -12171,6 +12237,69 @@ function createAgentController(pi, options) {
             );
           ownerDisplay = displayIdentity(definition2, parentLabel);
         }
+        if (p.action === "delegate") {
+          const registrations = /* @__PURE__ */ new Map();
+          let open = true;
+          let registrationError;
+          pi.events.emit(MANAGED_AGENT_BOOTSTRAP_EVENT, {
+            protocol: 1,
+            phase: "prepare",
+            context: ctx,
+            agent: label,
+            register(id, prepare) {
+              if (!open)
+                throw new Error(
+                  "Managed-agent bootstrap registration is closed"
+                );
+              if (!/^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$/.test(id)) {
+                registrationError ??= new Error(
+                  "Invalid managed-agent bootstrap participant ID"
+                );
+                return;
+              }
+              if (registrations.has(id)) {
+                registrationError ??= new Error(
+                  `Duplicate managed-agent bootstrap participant ID: ${id}`
+                );
+                return;
+              }
+              if (typeof prepare !== "function") {
+                registrationError ??= new Error(
+                  "Invalid managed-agent bootstrap prepare callback"
+                );
+                return;
+              }
+              registrations.set(id, prepare);
+            }
+          });
+          open = false;
+          if (registrationError) throw registrationError;
+          const participants = [];
+          for (const [id, prepare] of registrations) {
+            const result = await prepare();
+            if (result !== void 0) {
+              if (!result || typeof result.payload !== "string" || result.commit !== void 0 && typeof result.commit !== "function")
+                throw new Error(
+                  `Invalid preparation from managed-agent bootstrap participant "${id}"`
+                );
+              participants.push({ id, payload: result.payload });
+              preparedBootstrap.push({
+                id,
+                ...result.commit ? { commit: result.commit } : {}
+              });
+            }
+          }
+          if (participants.length)
+            writeAgentBootstrap(mailbox, {
+              version: 5,
+              build: options.build,
+              runId,
+              ownerSessionId: owner,
+              workspaceId,
+              agentLabel: label,
+              participants
+            });
+        }
         const env = [
           `PI_HERDSMAN_MAILBOX=${mailbox}`,
           `PI_HERDSMAN_RUN_ID=${runId}`,
@@ -12360,6 +12489,8 @@ ${result.stderr ?? ""}`.trim(),
           signal,
           waitForSession: true
         });
+        for (const participant of preparedBootstrap)
+          await participant.commit?.();
         runtimes.set(label, runtime);
         options.onChanged();
         const requestId = await submit(
@@ -15644,8 +15775,53 @@ function registerManagedAgentSessionStartHandler(pi, execution, options) {
           }
         }
       }
-      if (!existing)
+      if (!existing) {
         validateManagedAgentDefinition(await options.getAgentDefinitions(ctx));
+        const bootstrap = readAgentBootstrap(mailbox);
+        if (bootstrap) {
+          if (bootstrap.runId !== candidate.runId || bootstrap.ownerSessionId !== candidate.ownerSessionId || bootstrap.workspaceId !== candidate.workspaceId || bootstrap.agentLabel !== candidate.agentLabel)
+            throw new Error("Managed-agent bootstrap identity mismatch");
+          if (!sameRuntimeBuild(options.build, bootstrap.build))
+            throw new Error("Managed-agent bootstrap Herdsman build mismatch");
+          for (const participant of bootstrap.participants) {
+            let initializer;
+            let acceptCount = 0;
+            let invalidInitializer = false;
+            pi.events.emit(MANAGED_AGENT_BOOTSTRAP_EVENT, {
+              protocol: 1,
+              phase: "initialize",
+              context: ctx,
+              agent: candidate.agentLabel,
+              participant: { id: participant.id, payload: participant.payload },
+              accept(callback) {
+                acceptCount++;
+                if (typeof callback !== "function") {
+                  invalidInitializer = true;
+                  return;
+                }
+                if (acceptCount === 1) initializer = callback;
+              }
+            });
+            if (acceptCount === 0 || invalidInitializer)
+              throw new Error(
+                `Managed-agent bootstrap participant "${participant.id}" is unavailable or invalid`
+              );
+            if (acceptCount > 1)
+              throw new Error(
+                `Managed-agent bootstrap participant "${participant.id}" has multiple initializers`
+              );
+            try {
+              await initializer();
+            } catch (error2) {
+              throw new Error(
+                `Managed-agent bootstrap participant "${participant.id}" failed: ${String(error2)}`,
+                { cause: error2 }
+              );
+            }
+          }
+          removeAgentBootstrap(mailbox);
+        }
+      }
       const release = options.claimAssignmentLock(mailbox, "session_start", {
         label: execution.assignment.agentLabel,
         paneId: execution.assignment.paneId
@@ -22570,7 +22746,7 @@ async function workspacePresentationProvenance(pi, ctx, workspaceIds, workspaceC
   );
   return new Map(entries);
 }
-function index_default(pi) {
+function extension_default(pi) {
   let leadRuntimes;
   let leadStatusRuntime;
   let leadHerdRunRuntime;
@@ -23799,6 +23975,6 @@ ${summary}`,
   });
 }
 export {
-  index_default as default
+  extension_default as default
 };
 //# sourceMappingURL=index.js.map