@groeponline/pi-missions 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-08-22
+
+## [0.2.1] - 2026-08-22
+
 ## [0.2.0] - 2026-08-22
 
 ### Added

package/dist/index.d.ts

@@ -2,4 +2,27 @@ import { ExtensionAPI } from '@earendil-works/pi-coding-agent';
 
 declare function piMissions(pi: ExtensionAPI): void;
 
-export { piMissions as default };
+declare const ORCHESTRA_EXECUTION_CONTRACT_VERSION: 1;
+interface MissionOrchestraExecutionIdentity {
+    missionId: string;
+    taskId: string;
+    attemptId: string;
+}
+interface MissionOrchestraExecutionCorrelation extends MissionOrchestraExecutionIdentity {
+    caller: "pi-missions";
+    idempotencyKey: string;
+}
+/**
+ * Must stay byte-for-byte compatible with
+ * @groeponline/pi-agent-orchestrator's CHE-142 v1 contract.
+ */
+declare function buildOrchestraExecutionIdempotencyKey(identity: MissionOrchestraExecutionIdentity): string;
+/** Build the correlation envelope for one logical mission execution attempt. */
+declare function buildMissionOrchestraExecutionCorrelation(identity: MissionOrchestraExecutionIdentity): MissionOrchestraExecutionCorrelation;
+/**
+ * Propagate correlation through a child Pi process without making environment
+ * variables the canonical durable state. They are transport metadata only.
+ */
+declare function orchestraCorrelationEnv(correlation: MissionOrchestraExecutionCorrelation): Record<string, string>;
+
+export { type MissionOrchestraExecutionCorrelation, type MissionOrchestraExecutionIdentity, ORCHESTRA_EXECUTION_CONTRACT_VERSION, buildMissionOrchestraExecutionCorrelation, buildOrchestraExecutionIdempotencyKey, piMissions as default, orchestraCorrelationEnv };

package/dist/index.js

@@ -2003,6 +2003,37 @@ async function processAgentEndForAutopilot(pi, ctx, event, runtime) {
 
 // src/engines/worker.ts
 import { spawn } from "child_process";
+
+// src/integrations/orchestra-execution.ts
+var ORCHESTRA_EXECUTION_CONTRACT_VERSION = 1;
+function keyPart(value) {
+  if (value.length === 0) {
+    throw new Error("Orchestra execution identity parts must be non-empty");
+  }
+  return encodeURIComponent(value);
+}
+function buildOrchestraExecutionIdempotencyKey(identity) {
+  return `orchestra:v${ORCHESTRA_EXECUTION_CONTRACT_VERSION}:mission:${keyPart(identity.missionId)}:task:${keyPart(identity.taskId)}:attempt:${keyPart(identity.attemptId)}`;
+}
+function buildMissionOrchestraExecutionCorrelation(identity) {
+  return {
+    caller: "pi-missions",
+    ...identity,
+    idempotencyKey: buildOrchestraExecutionIdempotencyKey(identity)
+  };
+}
+function orchestraCorrelationEnv(correlation) {
+  return {
+    PI_ORCHESTRA_CONTRACT_VERSION: String(ORCHESTRA_EXECUTION_CONTRACT_VERSION),
+    PI_ORCHESTRA_CALLER: correlation.caller,
+    PI_MISSION_ID: correlation.missionId,
+    PI_MISSION_TASK_ID: correlation.taskId,
+    PI_MISSION_ATTEMPT_ID: correlation.attemptId,
+    PI_ORCHESTRA_IDEMPOTENCY_KEY: correlation.idempotencyKey
+  };
+}
+
+// src/engines/worker.ts
 var activeWorker = null;
 function getActiveWorker() {
   return activeWorker;
@@ -2062,9 +2093,21 @@ function spawnWorker(mission, config) {
     args.push("-e", extPath);
   }
   args.push(prompt);
+  const correlationEnv = config.orchestraCorrelation ? orchestraCorrelationEnv(config.orchestraCorrelation) : {};
   const child = spawn(piPath, args, {
     stdio: ["ignore", "pipe", "pipe"],
-    env: { ...process.env, PI_NO_COLOR: "1" }
+    env: (() => {
+      const childEnv = { ...process.env, ...correlationEnv, PI_NO_COLOR: "1" };
+      if (!config.orchestraCorrelation) {
+        delete childEnv.PI_ORCHESTRA_CONTRACT_VERSION;
+        delete childEnv.PI_ORCHESTRA_CALLER;
+        delete childEnv.PI_MISSION_ID;
+        delete childEnv.PI_MISSION_TASK_ID;
+        delete childEnv.PI_MISSION_ATTEMPT_ID;
+        delete childEnv.PI_ORCHESTRA_IDEMPOTENCY_KEY;
+      }
+      return childEnv;
+    })()
   });
   let stdout = "";
   let stderr = "";
@@ -2084,7 +2127,8 @@ function spawnWorker(mission, config) {
     process: child,
     featureId: config.featureId,
     startedAt,
-    status: "running"
+    status: "running",
+    orchestraCorrelation: config.orchestraCorrelation
   };
   const timeout = setTimeout(() => {
     killed = true;
@@ -2105,7 +2149,8 @@ function spawnWorker(mission, config) {
         stdout,
         stderr,
         durationMs,
-        killed
+        killed,
+        orchestraCorrelation: config.orchestraCorrelation
       };
       if (activeWorker) {
         activeWorker.result = result;
@@ -2125,7 +2170,8 @@ function spawnWorker(mission, config) {
             missionId,
             stdoutLen: stdout.length,
             stderrLen: stderr.length,
-            model
+            model,
+            orchestraCorrelation: config.orchestraCorrelation
           }
         });
         saveMissionSafe(mission).catch(() => {
@@ -3965,6 +4011,10 @@ ${detection.signals.map((s) => `- ${s.type}: ${s.evidence}`).join("\n")}`,
   });
 }
 export {
-  piMissions as default
+  ORCHESTRA_EXECUTION_CONTRACT_VERSION,
+  buildMissionOrchestraExecutionCorrelation,
+  buildOrchestraExecutionIdempotencyKey,
+  piMissions as default,
+  orchestraCorrelationEnv
 };
 //# sourceMappingURL=index.js.map