agents-can-communicate 0.4.0 → 0.4.2

package/node_modules/@agents-can-communicate/installer/src/detect.mjs

@@ -6,6 +6,8 @@ import { effectiveCapabilities, evaluateNativeEligibility, validateNativeActivat
 
 import { resolveExecutable, shellOf, shimDirFor } from "./native-activation.mjs";
 
+import { describeDeliveryFallback, describeNativeReason } from "./delivery-diagnostics.mjs";
+
 const run = promisify(execFile);
 
 // Reasons the client itself will not change within an install: unsupported,
@@ -79,8 +81,14 @@ async function detectNative(adapter, entry, { context, platform, probeTimeoutMs,
     }
     if (facts.eligibility.eligible !== true) {
       const reasonCode = facts.eligibility.reasonCode ?? "feature_probe_failed";
+      // A stored policy can be consented to before a service/session exists.
+      // No activation is planned until the full probe passes; bootstrap-based
+      // clients still need their verified plan to disclose launch changes.
+      const consentAvailable = adapter.nativeDelivery.policySource === "installation-record"
+        && ["native_endpoint_unavailable", "native_session_unavailable"].includes(reasonCode);
       return STATIC_REASONS.has(reasonCode)
-        ? { ...unsupported(reasonCode), ...facts } : degraded(reasonCode, facts);
+        ? { ...unsupported(reasonCode), ...facts }
+        : { ...degraded(reasonCode, facts), consentAvailable };
     }
     let activationPlan;
     try {
@@ -151,15 +159,20 @@ export async function detectInstallation({ adapters, context, probe = spawnProbe
       } catch (error) {
         entry.error = entry.error ?? error.message;
       }
-      if (entry.nativeDelivery.state !== "eligible"
-        && typeof adapter.deliveryFallback?.diagnostic === "string") {
-        const nextTurnDowngraded = adapter.capabilities?.delivery?.nextTurn === true
-          && entry.capabilities?.delivery?.nextTurn !== true;
-        entry.deliveryDiagnostic = nextTurnDowngraded
-          ? `${adapter.displayName} ${entry.version ?? "unknown version"} has no certified `
-            + `next-turn delivery on ${platform}; ${adapter.deliveryFallback.diagnostic}`
-          : adapter.deliveryFallback.diagnostic;
-        entry.diagnostics.push(entry.deliveryDiagnostic);
+      if (entry.nativeDelivery.state !== "eligible") {
+        if (adapter.nativeDelivery !== undefined) {
+          entry.deliveryDiagnostic = `${adapter.displayName} native delivery: `
+            + `${describeNativeReason(entry.nativeDelivery.reasonCode, { clientVersion: entry.version,
+              minimumVersion: entry.nativeDelivery.eligibility?.minimumVersion })}; `
+            + `fallback: ${describeDeliveryFallback(entry)}`;
+        } else if (typeof adapter.deliveryFallback?.diagnostic === "string") {
+          const downgraded = adapter.capabilities?.delivery?.nextTurn === true
+            && entry.capabilities?.delivery?.nextTurn !== true;
+          entry.deliveryDiagnostic = (downgraded
+            ? `${adapter.displayName} ${entry.version ?? "unknown version"} has no certified `
+              + `next-turn delivery on ${platform}; ` : "") + adapter.deliveryFallback.diagnostic;
+        }
+        if (entry.deliveryDiagnostic !== null) entry.diagnostics.push(entry.deliveryDiagnostic);
       }
       return entry;
     }));

package/node_modules/@agents-can-communicate/installer/src/index.mjs

@@ -12,4 +12,6 @@ export { BLOCK_BEGIN, BLOCK_END, SHIM_MARKER, SHIM_POLICIES, SUPPORTED_SHELLS,
   shellLiteral, uninstallShellBootstrap, validateShimEntry } from "./shell-bootstrap.mjs";
 export { LIVE_POLICIES, describeActivation, describeDeactivation, livePolicyOf, rcFileFor,
   resolveExecutable, shellOf, shimDirFor } from "./native-activation.mjs";
-export { readInstalledLivePolicy } from "./live-policy.mjs";
+export { readInstalledLivePolicy, readInstalledLivePolicyState } from "./live-policy.mjs";
+export { describeDeliveryFallback, describeInstallDelivery, describeNativeReason }
+  from "./delivery-diagnostics.mjs";

package/node_modules/@agents-can-communicate/installer/src/live-policy.mjs

@@ -10,12 +10,19 @@ export const livePolicyOf = install => {
     ? install.nativeActivation.livePolicy : "off";
 };
 
-export async function readInstalledLivePolicy({ dataHome, adapterId }) {
+export async function readInstalledLivePolicy(input) {
+  return (await readInstalledLivePolicyState(input)).policy;
+}
+
+export async function readInstalledLivePolicyState({ dataHome, adapterId }) {
   try {
     const record = await loadOwnership({ dataHome });
     const install = record.installs.find(entry => entry.adapterId === adapterId);
-    return livePolicyOf(install);
+    const raw = Object.hasOwn(install ?? {}, "deliveryPolicy")
+      ? install.deliveryPolicy : install?.nativeActivation?.livePolicy;
+    return { policy: livePolicyOf(install), policyStatus: raw === undefined ? "missing"
+      : !LIVE_POLICIES.includes(raw) ? "invalid" : raw === "off" ? "off" : "enabled" };
   } catch {
-    return "off";
+    return { policy: "off", policyStatus: "unavailable" };
   }
 }

package/node_modules/@agents-can-communicate/installer/src/plan.mjs

@@ -1,3 +1,5 @@
+import { describeInstallDelivery } from "./delivery-diagnostics.mjs";
+
 import { AccError, EXIT } from "@agents-can-communicate/protocol";
 
 import { LIVE_POLICIES, describeActivation, describeDeactivation, planActivationRetirements, rcFileFor, shimDirFor }
@@ -112,6 +114,8 @@ export function planInstallation({ adapters, detected, context, action = "instal
         ?? `${adapter.displayName ?? adapter.id} cannot receive native delivery `
           + `(${native?.reasonCode ?? "native_delivery_unsupported"}); durable fallback remains active`
       : null;
+    const deliverySummary = action === "install"
+      ? describeInstallDelivery(entry, delivery, effectiveLivePolicy) : null;
     const installContext = { ...context, requestedLivePolicy: delivery,
       livePolicy: effectiveLivePolicy };
     // A consented activation that this run keeps, activates, or takes back.
@@ -143,6 +147,7 @@ export function planInstallation({ adapters, detected, context, action = "instal
       livePolicy: delivery,
       effectiveLivePolicy,
       ...(deliveryDiagnostic === null ? {} : { deliveryDiagnostic }),
+      ...(deliverySummary === null ? {} : { deliverySummary }),
       ...(nativeActivation === null ? {} : { nativeActivation }),
       ...(deactivation === null ? {} : { deactivation }),
       artifacts,
@@ -151,7 +156,7 @@ export function planInstallation({ adapters, detected, context, action = "instal
       summary: [
         ...(entry.present ? [] : [`${adapter.displayName ?? adapter.id} is no longer on `
           + "this machine; removing what ACC recorded writing"]),
-        ...(deliveryDiagnostic === null ? [] : [deliveryDiagnostic]),
+        ...(deliverySummary === null ? [] : [deliverySummary]),
         ...artifacts.filter(a => a.kind === "tree")
           .map(a => `${action === "install" ? "create" : "remove"} ${a.path}`),
         ...artifacts.filter(a => a.kind === "merge")

package/node_modules/@agents-can-communicate/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-can-communicate/mcp-server",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "private": true,
   "type": "module",
   "exports": {

package/node_modules/@agents-can-communicate/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-can-communicate/protocol",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "private": true,
   "type": "module",
   "exports": {

package/node_modules/@agents-can-communicate/storage-filesystem/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-can-communicate/storage-filesystem",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "private": true,
   "type": "module",
   "exports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-can-communicate",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "description": "Local-first coordination for independently opened AI agent sessions.",
   "keywords": [