@amaster.ai/employee-runtime-connector 0.1.1-beta.31 → 0.1.1-beta.33

package/dist/amaster-runtime-daemon.mjs

@@ -2755,7 +2755,8 @@ function createManagedPiMcpProfileApi(options = {}) {
   const DELEGATED_PROFILE_MARKER = ".amaster-delegated-pi-profile.json";
   const SESSION_ROLLOUT_MARKER2 = ".amaster-pi-session-rollout.json";
   const DEFAULT_SESSION_ROLLOUT_TTL_MS2 = 24 * 60 * 60 * 1e3;
-  const PI_ATTESTATION_TIMEOUT_MS = 1e4;
+  const PI_VERSION_ATTESTATION_TIMEOUT_MS = 1e4;
+  const PI_EFFECTIVE_TOOLS_ATTESTATION_TIMEOUT_MS = 3e4;
   const PI_ATTESTATION_MAX_ATTEMPTS = 2;
   const PI_ATTESTATION_RECENT_LIVE_TTL_MS = Number.isFinite(options.recentLiveTtlMs) && options.recentLiveTtlMs > 0 ? options.recentLiveTtlMs : 30 * 60 * 1e3;
   const recentLivePiVersionProbes = /* @__PURE__ */ new Map();
@@ -3343,7 +3344,7 @@ function createManagedPiMcpProfileApi(options = {}) {
         cwd: env.AMASTER_RUNTIME_EXECUTION_WORKDIR,
         env,
         encoding: "utf8",
-        timeout: PI_ATTESTATION_TIMEOUT_MS,
+        timeout: PI_VERSION_ATTESTATION_TIMEOUT_MS,
         killSignal: "SIGKILL",
         maxBuffer: 1024 * 1024,
         ...spawnIdentity ?? {}
@@ -3407,7 +3408,18 @@ ${result3.stderr ?? ""}`, "Pi", MINIMUM_PI_VERSION);
       liveProbeAgeMs
     };
   }
+  function inspectEffectiveToolsProbeReceipt(receiptPath) {
+    if (!existsSync3(receiptPath)) return { phase: "missing", receipt: null };
+    try {
+      const receipt = JSON.parse(readFileSync3(receiptPath, "utf8"));
+      const phase = receipt?.status === "attested" || receipt?.status === "rejected" ? receipt.status : "present";
+      return { phase, receipt };
+    } catch {
+      return { phase: "invalid", receipt: null };
+    }
+  }
   function attestDirectPiTools(executorCommand, env, input, spawnIdentity = null) {
+    const startedAtMs = currentTimeMs();
     const result3 = spawnSyncImpl(executorCommand, [
       "--no-session",
       "--no-approve",
@@ -3423,25 +3435,28 @@ ${result3.stderr ?? ""}`, "Pi", MINIMUM_PI_VERSION);
       cwd: env.AMASTER_RUNTIME_EXECUTION_WORKDIR,
       env: { ...env, AMASTER_PI_EFFECTIVE_TOOLS_MODE: "probe" },
       encoding: "utf8",
-      timeout: PI_ATTESTATION_TIMEOUT_MS,
+      timeout: PI_EFFECTIVE_TOOLS_ATTESTATION_TIMEOUT_MS,
       killSignal: "SIGKILL",
       maxBuffer: 1024 * 1024,
       ...spawnIdentity ?? {}
     });
+    const elapsedMs = Math.max(0, currentTimeMs() - startedAtMs);
     if (result3.error) {
       const code = typeof result3.error.code === "string" ? result3.error.code : "UNKNOWN";
-      throw new Error(`pi_managed_mcp_effective_tools_failed: probe error=${code}`);
+      const receiptDiagnostic = inspectEffectiveToolsProbeReceipt(input.receiptPath);
+      throw new Error(
+        `pi_managed_mcp_effective_tools_failed: probe error=${code} elapsedMs=${elapsedMs} timeoutMs=${PI_EFFECTIVE_TOOLS_ATTESTATION_TIMEOUT_MS} receiptPhase=${receiptDiagnostic.phase}`
+      );
     }
     if (result3.status !== 0) {
+      const receiptDiagnostic = inspectEffectiveToolsProbeReceipt(input.receiptPath);
       let receiptError = "receipt unavailable";
-      try {
-        const rejectedReceipt = JSON.parse(readFileSync3(input.receiptPath, "utf8"));
-        if (typeof rejectedReceipt.error === "string" && rejectedReceipt.error.length > 0) {
-          receiptError = rejectedReceipt.error.slice(0, 512);
-        }
-      } catch {
+      if (typeof receiptDiagnostic.receipt?.error === "string" && receiptDiagnostic.receipt.error.length > 0) {
+        receiptError = receiptDiagnostic.receipt.error.slice(0, 512);
       }
-      throw new Error(`pi_managed_mcp_effective_tools_failed: probe exit=${result3.status ?? "unknown"} reason=${receiptError}`);
+      throw new Error(
+        `pi_managed_mcp_effective_tools_failed: probe exit=${result3.status ?? "unknown"} elapsedMs=${elapsedMs} timeoutMs=${PI_EFFECTIVE_TOOLS_ATTESTATION_TIMEOUT_MS} receiptPhase=${receiptDiagnostic.phase} reason=${receiptError}`
+      );
     }
     let receipt;
     try {
@@ -3465,6 +3480,8 @@ ${result3.stderr ?? ""}`, "Pi", MINIMUM_PI_VERSION);
       effectiveToolSetHash: receipt.effectiveSetHash,
       effectiveToolProbeDigest: sha2562(stablePiJson(receipt)),
       effectiveToolProbeAt: receipt.attestedAt,
+      effectiveToolProbeElapsedMs: elapsedMs,
+      effectiveToolProbeTimeoutMs: PI_EFFECTIVE_TOOLS_ATTESTATION_TIMEOUT_MS,
       effectiveToolBindings: receipt.effectiveToolBindings
     };
   }
@@ -4662,6 +4679,86 @@ function governedReadSection(context) {
     }))
   };
 }
+function governedBusinessDetailRead(input, issueId) {
+  const canonicalTool = "amaster.read_governed_business_state";
+  const exactIssueId = readString(issueId);
+  if (!exactIssueId) {
+    return { mode: "unavailable", canonical_tool: canonicalTool, reason: "issue_scope_unavailable" };
+  }
+  if (!input.hasGovernedMcp) {
+    return { mode: "unavailable", canonical_tool: canonicalTool, reason: "governed_mcp_unavailable" };
+  }
+  const argumentsValue = { issueId: exactIssueId };
+  const exposedTool = managedDirectToolName(input, canonicalTool);
+  if (exposedTool) {
+    return { mode: "direct_typed", tool: exposedTool, arguments: argumentsValue };
+  }
+  if (input.managedMcpToolMode === "direct_typed") {
+    return { mode: "unavailable", canonical_tool: canonicalTool, reason: "not_in_run_catalog" };
+  }
+  if (input.executorKind === "pi" && managedPiMcpProxyAvailable(input)) {
+    return {
+      mode: "mcp_proxy",
+      server: "amaster",
+      tool: canonicalTool,
+      args: JSON.stringify(argumentsValue)
+    };
+  }
+  return { mode: "canonical", tool: canonicalTool, arguments: argumentsValue };
+}
+function governedBusinessDecisionProjection(state, detailRead) {
+  const record6 = asRecord(state);
+  const snapshot = asRecord(record6.governed_state_snapshot);
+  const enrollment = asRecord(snapshot.business_task_enrollment);
+  const authoritativeObjectRefs = Array.isArray(record6.authoritative_object_refs) ? record6.authoritative_object_refs : [];
+  const enrollmentRef = authoritativeObjectRefs.find((entry) => readString(asRecord(entry).object_kind) === "business_task_enrollment");
+  const snapshotId = readString(snapshot.snapshot_id);
+  const generatedAt = readString(snapshot.generated_at);
+  const projection = {
+    availability: record6.availability,
+    capabilities: Array.isArray(record6.capabilities) ? record6.capabilities : [],
+    missing_objects: Array.isArray(record6.missing_objects) ? record6.missing_objects : [],
+    authoritative_object_refs: authoritativeObjectRefs,
+    snapshot: {
+      ref: snapshotId ? `governed_state:${snapshotId}` : null,
+      observed_at: generatedAt ?? null
+    },
+    detail_read: detailRead
+  };
+  if (Object.keys(enrollment).length > 0) {
+    projection.business_task_enrollment = {
+      state: readString(enrollment.state) ?? null,
+      authoritative_ref: readString(asRecord(enrollmentRef).ref) ?? null,
+      finding: enrollment.finding ?? null
+    };
+  }
+  const continuationId = readString(record6.continuation_id);
+  if (continuationId) projection.continuation_id = continuationId;
+  if (Number.isInteger(record6.outcome_revision)) projection.outcome_revision = record6.outcome_revision;
+  const freeTextReason = readString(record6.free_text_reason);
+  if (freeTextReason) projection.free_text_reason = freeTextReason;
+  return projection;
+}
+function governedBusinessModelView(state, input) {
+  const record6 = asRecord(state);
+  const snapshot = asRecord(record6.governed_state_snapshot);
+  const detailRead = governedBusinessDetailRead(
+    input,
+    readString(snapshot.issue_id) ?? readString(input.issueId)
+  );
+  if (detailRead.mode === "unavailable") {
+    return {
+      mode: "full_snapshot",
+      content: record6,
+      unavailableReason: detailRead.reason
+    };
+  }
+  return {
+    mode: "decision_projection",
+    content: governedBusinessDecisionProjection(record6, detailRead),
+    unavailableReason: null
+  };
+}
 function governedBusinessStateSection(context, input) {
   const current = asRecord(context.governedBusinessState);
   const resume = asRecord(context.governedBusinessResume);
@@ -4676,6 +4773,9 @@ function governedBusinessStateSection(context, input) {
       throw new Error(`governed_business_state_scope_mismatch:${label}`);
     }
   }
+  const currentView = Object.keys(current).length > 0 ? governedBusinessModelView(current, input) : null;
+  const resumeView = Object.keys(resume).length > 0 ? governedBusinessModelView(resume, input) : null;
+  const retainsFullSnapshot = [currentView, resumeView].some((view) => view?.mode === "full_snapshot");
   const rules = [
     "This is bounded Server-owned read-side truth. It does not grant mutation authority and it is not a Delivery Manifest claim.",
     "Recommendation, First Business Activation, and Business Task Enrollment may be described as created/submitted/activated/enrolled only when authoritative_object_refs contains the exact matching Server ref. Issue and Document are not Business Task Enrollment.",
@@ -4684,13 +4784,16 @@ function governedBusinessStateSection(context, input) {
     "A read capability marked unavailable does not prove an instance is absent. A write capability marked unavailable does not prove the object kind is unsupported.",
     "When availability.status or a required read capability is unavailable, unrelated work may continue, but formal-object completion claims must remain fail-closed until a managed read succeeds.",
     "When a required formal object is missing or the current Runtime lacks its legal producer, keep the task incomplete and name missing_objects.reason_code plus next_owner. Board review remains independent final acceptance.",
-    "free_text_reason is explanatory only and is not authority; resolve any conflict in favor of the structured Server-owned state."
+    "free_text_reason is explanatory only and is not authority; resolve any conflict in favor of the structured Server-owned state.",
+    retainsFullSnapshot ? "No executable managed detail read is available for at least one state below, so its bounded full snapshot remains inline. Do not guess a tool name or claim that omitted state can be fetched." : "The default body is a decision projection, not the complete process ledger. Use detail_read only when the current task needs omitted diagnosis, recommendation, activation, enrollment, or dispatch details."
   ].join("\n");
   const bodies = [
-    Object.keys(current).length > 0 ? `Current dispatch snapshot:
-${stringifyBoundedJson(current, 24e3)}` : "",
-    Object.keys(resume).length > 0 ? `Changes-requested resume binding:
-${stringifyBoundedJson(resume, 24e3)}` : ""
+    currentView ? currentView.mode === "decision_projection" ? `Current dispatch decision projection:
+${stringifyBoundedJson(currentView.content, 24e3)}` : `Current dispatch bounded full snapshot (managed detail read unavailable: ${currentView.unavailableReason}):
+${stringifyBoundedJson(currentView.content, 24e3)}` : "",
+    resumeView ? resumeView.mode === "decision_projection" ? `Changes-requested resume decision projection:
+${stringifyBoundedJson(resumeView.content, 24e3)}` : `Changes-requested resume bounded full snapshot (managed detail read unavailable: ${resumeView.unavailableReason}):
+${stringifyBoundedJson(resumeView.content, 24e3)}` : ""
   ].filter(Boolean).join("\n\n");
   return {
     content: `${rules}
@@ -9425,7 +9528,7 @@ function assertSourceAcquisitionRuntimeAuthority({
 }
 
 // src/amaster-runtime-daemon.mjs
-var CONNECTOR_VERSION = "0.1.1-beta.31";
+var CONNECTOR_VERSION = "0.1.1-beta.33";
 var CONNECTOR_CONTRACT_VERSION = "2026-06-04.v1";
 var SOURCE_ACQUISITION_CAPABILITY = "source_acquisition_v1";
 var SOURCE_ACQUISITION_PROFILE_VERSION = "source_acquisition_v1";
@@ -13907,7 +14010,7 @@ async function executeRunCommand(config, command) {
     }
     if (executor.kind === "pi") {
       piResolvedProviderConfig = executorEnv;
-      for (const envName of ["AMASTER_API_KEY", "AMASTER_PLATFORM_OAUTH_TOKEN"]) {
+      for (const envName of ["AMASTER_API_KEY", "AMASTER_PLATFORM_OAUTH_TOKEN", "PLATFORM_ACCESS_TOKEN"]) {
         const protectedValue = readString(piResolvedProviderConfig[envName]);
         if (protectedValue && !providerProtectedValues.includes(protectedValue)) {
           providerProtectedValues.push(protectedValue);

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.31";
+const CONNECTOR_VERSION = "0.1.1-beta.33";
 
 const CAPABILITIES = [
   "remote_registration",

package/package.json

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