@amaster.ai/employee-runtime-connector 0.1.1-beta.82 → 0.1.1-beta.84

package/README.md

@@ -13,7 +13,7 @@ For production images, install an exact version and invoke the package bin:
 ```sh
 npm install --omit=dev --prefix /opt/pi-cli-runtime @amaster.ai/employee-runtime-connector@0.1.0
 /opt/pi-cli-runtime/node_modules/.bin/amaster-runtime setup https://employee.example.com \
-  --capabilities remote_registration,heartbeat,executor_discovery,workspace_binding,run_wakeup,model_call,model_call_output_contract_v1,run_cancel,run_terminate,logs_cost_workspace_status
+  --capabilities remote_registration,heartbeat,executor_discovery,workspace_binding,run_wakeup,runtime_actions_v2,run_exit_live_path_closure_v1,model_call,model_call_output_contract_v1,run_cancel,run_terminate,logs_cost_workspace_status
 /opt/pi-cli-runtime/node_modules/.bin/amaster-runtime daemon start --foreground
 ```
 

package/dist/amaster-runtime-daemon.mjs

@@ -5453,7 +5453,15 @@ function normalizeRunTurnUsage(turn) {
   const source = record4(turn);
   const nestedUsage = record4(source.usage);
   const usage = Object.keys(nestedUsage).length > 0 ? nestedUsage : source;
-  const turnKind = source.turn === "closure" ? "closure" : source.turn === "terminal_text_repair" ? "terminal_text_repair" : "primary";
+  const allowedTurnKinds = /* @__PURE__ */ new Set([
+    "primary",
+    "terminal_text_repair",
+    "closure",
+    "work_disposition_closure",
+    "live_path_closure",
+    "terminal_disposition_closure"
+  ]);
+  const turnKind = allowedTurnKinds.has(source.turn) ? source.turn : "primary";
   return {
     turn: turnKind,
     attempt: turnKind === "primary" ? 0 : 1,
@@ -5496,6 +5504,11 @@ function createRunCompletionState(input) {
     connectorId,
     phase: "usage_snapshot_persisted",
     closureAttempt: 0,
+    closureAttempts: {
+      workDisposition: 0,
+      livePath: 0,
+      terminalDisposition: 0
+    },
     command,
     executor: record4(input.executor),
     completionRequest: record4(input.completionRequest),
@@ -5518,11 +5531,18 @@ function appendRunCompletionUsageTurn(state, input) {
   const current = assertValidRunCompletionState(state);
   const turn = normalizeRunTurnUsage(input);
   const priorTurns = current.usageRecord.turns.filter((entry) => entry.turn !== turn.turn);
-  const turnOrder = { primary: 0, terminal_text_repair: 1, closure: 2 };
+  const turnOrder = {
+    primary: 0,
+    terminal_text_repair: 1,
+    closure: 2,
+    work_disposition_closure: 2,
+    live_path_closure: 3,
+    terminal_disposition_closure: 4
+  };
   const turns = [...priorTurns, turn].sort((left, right) => turnOrder[left.turn] - turnOrder[right.turn]);
   return {
     ...current,
-    closureAttempt: turn.turn === "closure" ? 1 : current.closureAttempt,
+    closureAttempt: turn.turn.endsWith("closure") ? 1 : current.closureAttempt,
     phase: "usage_snapshot_persisted",
     usageRecord: {
       ...current.usageRecord,
@@ -5580,7 +5600,7 @@ function assertValidRunCompletionState(value) {
     throw new Error("run_completion_state_invalid:usage_idempotency_key");
   }
   const turns = Array.isArray(usageRecord.turns) ? usageRecord.turns.map(normalizeRunTurnUsage) : [];
-  if (turns.length < 1 || turns.length > 3) throw new Error("run_completion_state_invalid:usage_turns");
+  if (turns.length < 1 || turns.length > 5) throw new Error("run_completion_state_invalid:usage_turns");
   const kinds = new Set(turns.map((turn) => turn.turn));
   if (kinds.size !== turns.length || !kinds.has("primary")) {
     throw new Error("run_completion_state_invalid:usage_turn_identity");
@@ -5588,7 +5608,10 @@ function assertValidRunCompletionState(value) {
   const expectedTurnOrder = [
     "primary",
     ...kinds.has("terminal_text_repair") ? ["terminal_text_repair"] : [],
-    ...kinds.has("closure") ? ["closure"] : []
+    ...kinds.has("closure") ? ["closure"] : [],
+    ...kinds.has("work_disposition_closure") ? ["work_disposition_closure"] : [],
+    ...kinds.has("live_path_closure") ? ["live_path_closure"] : [],
+    ...kinds.has("terminal_disposition_closure") ? ["terminal_disposition_closure"] : []
   ];
   if (turns.some((turn, index) => turn.turn !== expectedTurnOrder[index])) {
     throw new Error("run_completion_state_invalid:usage_turn_order");
@@ -6437,11 +6460,23 @@ function resolvedDependencySections(context, input, contextScope, snapshotFreshn
       `  \u2026mandatory required reads are capped at ${MAX_RESOLVED_DEPENDENCY_REQUIRED_READS}; the remaining ${overflowRefs.length} predecessor document(s) are listed under On-demand Context References.`
     );
   }
-  const requiredLines = tuples.length > 0 ? [
-    "Accepted predecessor outputs are binding inputs unless this issue explicitly requests reconsideration.",
-    "Before any downstream document/artifact write, review request, status mutation, or completion, perform every Required read.",
-    "Current-issue documents, parent-issue documents, summaries, and workspace files are not substitutes for these predecessor documents.",
-    "Compare each returned latestRevisionId with the expected value. On revision mismatch, do not perform downstream writes; report it.",
+  const completionContext = asRecord(context.completionContext);
+  const requiredChildIssueIds = Array.isArray(completionContext.requiredChildIssueIds) ? completionContext.requiredChildIssueIds.map(readString).filter(Boolean) : [];
+  const multiAcceptanceParentClosure = completionContext.acceptanceRefreshRequired === true && !readString(completionContext.finalAggregationIssueId) && requiredChildIssueIds.length > 0;
+  const multiAcceptanceLines = multiAcceptanceParentClosure ? [
+    "Multi-acceptance parent closure contract:",
+    "- A parent-only summary or parent-only Delivery Manifest is not sufficient, even when every child is already done and accepted.",
+    "- The refreshed parent Delivery Manifest must include at least one exact current deliverable from every required child as a supporting exact_ref. Use the Required reads below when they identify a current document revision. For a required child without a document tuple, read that child's current Delivery Manifest and copy an exact current ref; never invent one. Keep the parent aggregation deliverable as primary when applicable.",
+    "- Re-read current parent delivery readiness immediately before publishing the replacement Manifest. Do not attempt terminal status while any required child is absent from the Manifest."
+  ] : [];
+  const requiredLines = tuples.length > 0 || multiAcceptanceLines.length > 0 ? [
+    ...tuples.length > 0 ? [
+      "Accepted predecessor outputs are binding inputs unless this issue explicitly requests reconsideration.",
+      "Before any downstream document/artifact write, review request, status mutation, or completion, perform every Required read.",
+      "Current-issue documents, parent-issue documents, summaries, and workspace files are not substitutes for these predecessor documents.",
+      "Compare each returned latestRevisionId with the expected value. On revision mismatch, do not perform downstream writes; report it."
+    ] : [],
+    ...multiAcceptanceLines,
     ...tuples.flatMap((tuple, index) => {
       const readArguments = { issueId: tuple.blockerSelector, key: tuple.key };
       const directToolName = managedDirectToolName(input, "amaster.read_issue_document");
@@ -8094,6 +8129,7 @@ var CAPABILITIES = [
   "workspace_binding",
   "run_wakeup",
   "runtime_actions_v2",
+  "run_exit_live_path_closure_v1",
   "model_call",
   "model_call_output_contract_v1",
   "run_cancel",
@@ -11650,7 +11686,7 @@ var source_acquisition_compatibility_default = {
 };
 
 // src/amaster-runtime-daemon.mjs
-var CONNECTOR_VERSION = "0.1.1-beta.82";
+var CONNECTOR_VERSION = "0.1.1-beta.84";
 var CONNECTOR_CONTRACT_VERSION = "2026-06-04.v1";
 var SOURCE_ACQUISITION_CAPABILITY = source_acquisition_compatibility_default.profileVersion;
 var daemonRequire = createRequire(import.meta.url);
@@ -14567,14 +14603,21 @@ function runCompletionCheckRequest(state) {
   const turns = Array.isArray(asRecord(state.usageRecord).turns) ? asRecord(state.usageRecord).turns.map(asRecord) : [];
   const terminalTextRepairAttempt = turns.some((turn) => turn.turn === "terminal_text_repair") ? 1 : 0;
   const closureAttempt = state.closureAttempt === 1 ? 1 : 0;
+  const closureAttempts = {
+    workDisposition: readNumber(asRecord(state.closureAttempts).workDisposition, 0) === 1 ? 1 : 0,
+    livePath: readNumber(asRecord(state.closureAttempts).livePath, 0) === 1 ? 1 : 0,
+    terminalDisposition: readNumber(asRecord(state.closureAttempts).terminalDisposition, 0) === 1 ? 1 : 0
+  };
+  const v2 = prior.contractVersion === "amaster.runtime-connector.completion-check.v2";
+  const closureTurnCount = v2 ? closureAttempts.workDisposition + closureAttempts.livePath + closureAttempts.terminalDisposition : closureAttempt;
   return {
-    contractVersion: "amaster.runtime-connector.completion-check.v1",
+    contractVersion: v2 ? "amaster.runtime-connector.completion-check.v2" : "amaster.runtime-connector.completion-check.v1",
     ...readString(asRecord(state.command).leaseId) ? { leaseId: readString(asRecord(state.command).leaseId) } : {},
     proposedStatus: state.candidateStatus,
     resultSignals: {
       productiveSuccessfulRun: prior.resultSignals?.productiveSuccessfulRun === true,
-      executorTurnCount: 1 + terminalTextRepairAttempt + closureAttempt,
-      closureAttempt,
+      executorTurnCount: 1 + terminalTextRepairAttempt + closureTurnCount,
+      ...v2 ? { closureAttempts } : { closureAttempt },
       ...terminalTextRepairAttempt === 1 ? { terminalTextRepairAttempt } : {}
     }
   };
@@ -14654,7 +14697,10 @@ async function requestRunCompletionCheck(config, inputState) {
   for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
     try {
       const response = asRecord(await postJson(config, path, runCompletionCheckRequest(state)));
-      if (response.contractVersion !== "amaster.runtime-connector.completion-check.v1" || !["ready_to_terminalize", "disposition_required"].includes(response.outcome) || !["observe", "enforce"].includes(response.enforcementMode)) {
+      if (![
+        "amaster.runtime-connector.completion-check.v1",
+        "amaster.runtime-connector.completion-check.v2"
+      ].includes(response.contractVersion) || response.contractVersion !== runCompletionCheckRequest(state).contractVersion || !["ready_to_terminalize", "disposition_required"].includes(response.outcome) || !["observe", "enforce"].includes(response.enforcementMode)) {
         const error = new Error("runtime_completion_check_response_invalid");
         error.code = "runtime_completion_check_response_invalid";
         throw error;
@@ -14750,6 +14796,8 @@ function runExitClosurePrompt(state, options = {}) {
   const issueId = commandIssueId(command) ?? "unknown";
   const runId = commandRunId(command) ?? "unknown";
   const closureStrategy = readString(response.closureStrategy) ?? "select_issue_disposition";
+  const closurePhase = readString(response.closurePhase) ?? "disposition_closure";
+  const workDispositionClosure = closureStrategy === "record_work_disposition" || closurePhase === "work_disposition_closure";
   const describeRequired = options.describeRequired !== false;
   const allowedActions = Array.isArray(response.allowedActions) ? response.allowedActions.filter((value) => typeof value === "string") : [];
   return [
@@ -14759,11 +14807,11 @@ function runExitClosurePrompt(state, options = {}) {
     `Completion reason: ${readString(response.reasonCode) ?? "successful_run_missing_state"}`,
     summary ? `Primary turn summary: ${summary}` : null,
     "Do not perform more business work, edit files, create artifacts/documents/children/plans, or mutate company/profile/milestone state.",
-    closureStrategy === "record_work_disposition" ? "Effective closure action for this turn: record_work_disposition only." : `Server-allowed closure actions: ${allowedActions.join(", ") || "none"}.`,
-    describeRequired ? closureStrategy === "record_work_disposition" ? "Call runtime_action.describe exactly once for record_work_disposition, then use exactly one runtime_action.submit mutation with that described shape." : "Choose one Server-allowed action, call runtime_action.describe exactly once for that action type, then use exactly one runtime_action.submit mutation with that described shape." : "Use exactly one runtime_action.submit mutation with the already-issued phase-specific schema.",
-    closureStrategy === "record_work_disposition" ? "The Server selected record_work_disposition as the only closure strategy. For this already-productive source run, record execute_inline with truthful source-run evidence; do not also mutate issue status or create an interaction. After command terminalization, the Server writes the Business Outcome and owns the matching Board review or terminal-state transition." : "The Server selected an Issue disposition closure. Choose update_parent, create_interaction (not suggest_tasks), or add_comment only when a comment is truly the intended exit path. A comment alone does not establish completion.",
-    closureStrategy === "record_work_disposition" ? `Use evidenceRefs ["run:${runId}", "command:${state.commandId}"], structure.deliverableType "runtime_command_result", structure.deliverableKey "runtime-command-${state.commandId}", and structure.acceptanceMethodCode "governed_business_outcome". Supply a concise truthful reason based only on the primary turn summary.` : null,
-    `The idempotencyKey must be runtime-command-closure:${state.commandId}.`,
+    closurePhase === "live_path_closure" ? "Effective closure action for this turn: choose exactly one typed external wait, scheduled monitor, or choose_task_disposition interaction." : closurePhase === "terminal_disposition_closure" ? "Effective closure action for this turn: establish the authorized terminal disposition or one Board decision interaction." : workDispositionClosure ? "Effective closure action for this turn: record_work_disposition only." : `Server-allowed closure actions: ${allowedActions.join(", ") || "none"}.`,
+    describeRequired ? workDispositionClosure ? "Call runtime_action.describe exactly once for record_work_disposition, then use exactly one runtime_action.submit mutation with that described shape." : "Choose one Server-allowed action, call runtime_action.describe exactly once for that action type, then use exactly one runtime_action.submit mutation with that described shape." : "Use exactly one runtime_action.submit mutation with the already-issued phase-specific schema.",
+    workDispositionClosure ? "The Server selected record_work_disposition as the only closure strategy. For this already-productive source run, record execute_inline with truthful source-run evidence; do not also mutate issue status or create an interaction. After command terminalization, the Server writes the Business Outcome and owns the matching Board review or terminal-state transition." : closurePhase === "live_path_closure" ? "The Server selected Durable Live Path closure. Establish exactly one typed external wait, scheduled monitor, or Board disposition interaction; a comment or Work Disposition does not satisfy this gate." : closurePhase === "terminal_disposition_closure" ? "The Server selected terminal disposition closure. Establish the authorized terminal state or one Board decision interaction; do not create a new live wait merely to avoid terminalization." : "The Server selected an Issue disposition closure. Choose update_parent, create_interaction (not suggest_tasks), or add_comment only when a comment is truly the intended exit path. A comment alone does not establish completion.",
+    workDispositionClosure ? `Use evidenceRefs ["run:${runId}", "command:${state.commandId}"], structure.deliverableType "runtime_command_result", structure.deliverableKey "runtime-command-${state.commandId}", and structure.acceptanceMethodCode "governed_business_outcome". Supply a concise truthful reason based only on the primary turn summary.` : null,
+    `The idempotencyKey must be runtime-command-closure:${state.commandId}${closurePhase === "work_disposition_closure" ? ":work-disposition" : closurePhase === "live_path_closure" ? ":live-path" : closurePhase === "terminal_disposition_closure" ? ":terminal-disposition" : ""}.`,
     describeRequired ? "Do not call runtime_action.plan or runtime_action.commit. Do not call runtime_action.describe more than once. Stop immediately after the one allowed mutation returns." : "Do not call runtime_action.describe, runtime_action.plan, or runtime_action.commit. Stop immediately after the one allowed mutation returns."
   ].filter(Boolean).join("\n\n");
 }
@@ -15369,16 +15417,23 @@ async function coordinateRunCompletion(config, inputState, options = {}) {
     };
   }
   if (checked.pending) return { pending: true, resultDelivered: false, state };
-  if (state.phase === "disposition_required") {
-    const closureAlreadyRecorded = state.closureTurnRecorded === true;
+  while (state.phase === "disposition_required") {
+    const completionResponse = asRecord(state.completionResponse);
+    const closurePhase = readString(completionResponse.closurePhase) ?? "disposition_closure";
+    const closureAttemptKey = closurePhase === "work_disposition_closure" ? "workDisposition" : closurePhase === "live_path_closure" ? "livePath" : closurePhase === "terminal_disposition_closure" ? "terminalDisposition" : null;
+    const v2 = readString(completionResponse.contractVersion) === "amaster.runtime-connector.completion-check.v2";
+    const closureTurns = asRecord(state.closureTurns);
+    const closureAlreadyRecorded = closureAttemptKey ? Boolean(closureTurns[closureAttemptKey]) : state.closureTurnRecorded === true;
     const recoveryCount = readNumber(state.closureRecoveryCount, 0);
     const mayResumeUncertainClosure = recoveringClosure && !closureAlreadyRecorded && recoveryCount < 1;
-    if (state.closureAttempt === 0 || mayResumeUncertainClosure) {
+    const priorAttempt = closureAttemptKey ? readNumber(asRecord(state.closureAttempts)[closureAttemptKey], 0) : readNumber(state.closureAttempt, 0);
+    if (priorAttempt === 0 || mayResumeUncertainClosure) {
+      const nextClosureAttempts = closureAttemptKey ? { ...asRecord(state.closureAttempts), [closureAttemptKey]: 1 } : asRecord(state.closureAttempts);
       state = persistPendingRunCompletion(config, transitionRunCompletionState(
         state,
         "closure_started",
         {
-          closureAttempt: 1,
+          ...v2 ? { closureAttempts: nextClosureAttempts } : { closureAttempt: 1 },
           ...mayResumeUncertainClosure ? { closureRecoveryCount: recoveryCount + 1 } : {}
         }
       ));
@@ -15398,15 +15453,17 @@ async function coordinateRunCompletion(config, inputState, options = {}) {
           }
         };
       }
+      const candidateResult = asRecord(state.candidateResult);
       state = appendRunCompletionUsageTurn({
         ...state,
-        closureTurnRecorded: true,
+        ...closureAttemptKey ? { closureTurns: { ...closureTurns, [closureAttemptKey]: closure.audit } } : { closureTurnRecorded: true },
         candidateResult: {
-          ...asRecord(state.candidateResult),
-          closureTurn: closure.audit
+          ...candidateResult,
+          closureTurn: closure.audit,
+          ...closureAttemptKey ? { closureTurns: { ...asRecord(candidateResult.closureTurns), [closureAttemptKey]: closure.audit } } : {}
         }
       }, {
-        turn: "closure",
+        turn: closureAttemptKey === "workDisposition" ? "work_disposition_closure" : closureAttemptKey === "livePath" ? "live_path_closure" : closureAttemptKey === "terminalDisposition" ? "terminal_disposition_closure" : "closure",
         usage: closure.usage,
         recordedAt: (/* @__PURE__ */ new Date()).toISOString()
       });
@@ -15428,7 +15485,9 @@ async function coordinateRunCompletion(config, inputState, options = {}) {
         };
       }
       if (checked.pending) return { pending: true, resultDelivered: false, state };
+      continue;
     }
+    break;
   }
   if (state.phase === "disposition_required") {
     const command = asRecord(state.command);
@@ -17048,13 +17107,19 @@ async function executeRunCommand(config, command) {
           }
         },
         completionRequest: {
-          contractVersion: "amaster.runtime-connector.completion-check.v1",
+          contractVersion: config.capabilities.includes("run_exit_live_path_closure_v1") ? "amaster.runtime-connector.completion-check.v2" : "amaster.runtime-connector.completion-check.v1",
           leaseId: command.leaseId,
           proposedStatus: "succeeded",
           resultSignals: {
             productiveSuccessfulRun,
             executorTurnCount: terminalTextRepairUsageBreakdown ? 2 : 1,
-            closureAttempt: 0,
+            ...config.capabilities.includes("run_exit_live_path_closure_v1") ? {
+              closureAttempts: {
+                workDisposition: 0,
+                livePath: 0,
+                terminalDisposition: 0
+              }
+            } : { closureAttempt: 0 },
             ...terminalTextRepairUsageBreakdown ? { terminalTextRepairAttempt: 1 } : {}
           }
         },

package/dist/amaster-runtime.mjs

@@ -6,7 +6,7 @@ import { basename, dirname, join, resolve } from "node:path";
 import { homedir, hostname } from "node:os";
 import { fileURLToPath } from "node:url";
 
-const CONNECTOR_VERSION = "0.1.1-beta.82";
+const CONNECTOR_VERSION = "0.1.1-beta.84";
 
 const CAPABILITIES = [
   "remote_registration",
@@ -15,6 +15,7 @@ const CAPABILITIES = [
   "workspace_binding",
   "run_wakeup",
   "runtime_actions_v2",
+  "run_exit_live_path_closure_v1",
   "model_call",
   "model_call_output_contract_v1",
   "run_cancel",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amaster.ai/employee-runtime-connector",
-  "version": "0.1.1-beta.82",
+  "version": "0.1.1-beta.84",
   "description": "MirrorX runtime connector CLI and daemon",
   "license": "MIT",
   "type": "module",