agents-can-communicate 0.5.2 → 0.5.4

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

@@ -0,0 +1,30 @@
+// Invoked only after adapter configuration and ownership/consent persistence.
+// A failed service command must not erase the successful adapter operation.
+export async function applyServiceSetup({ adapter, context, operation, results }) {
+  const plan = operation.nativeServiceSetup;
+  if (!plan || operation.livePolicy === "off" || operation.deliveryDecision?.completeSetup !== true) return;
+  let setup = plan;
+  if (["needed", "ready"].includes(plan.state)) {
+    try {
+      setup = await adapter.prepareNativeServiceSetup({ context, plan });
+      if (!setup || !["ready", "failed", "blocked"].includes(setup.state)) throw new Error("invalid setup result");
+    } catch {
+      setup = { state: "failed", started: false, reasonCode: "service_setup_failed",
+        diagnostic: `${adapter.displayName} service preparation failed; check the vendor service and retry acc install` };
+    }
+  }
+  operation.nativeServiceSetup = setup;
+  if (setup.state === "ready") {
+    const stale = new Set([operation.deliverySummary, operation.deliveryDiagnostic, plan.diagnostic]);
+    operation.summary = (operation.summary ?? []).filter(line => !stale.has(line));
+    operation.summary.push(setup.diagnostic);
+    operation.diagnostics = (operation.diagnostics ?? []).filter(line => !stale.has(line));
+    operation.deliverySummary = setup.diagnostic;
+    operation.deliveryDiagnostic = setup.diagnostic;
+  } else {
+    operation.needsAction.push(setup.diagnostic);
+    if (setup.state === "failed") results.failed.push({ adapterId: operation.adapterId,
+      error: setup.diagnostic, reasonCode: setup.reasonCode });
+  }
+  operation.diagnostics.push(setup.diagnostic);
+}

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

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

package/node_modules/@agents-can-communicate/mcp-server/src/tools.mjs

@@ -128,6 +128,7 @@ export const PUBLIC_TOOLS = Object.freeze([
     name: "acc_reply",
     description: `Reply to one addressed message and acknowledge the original in the same `
       + `operation. The reply is attributed and linked with inReplyTo. `
+      + `May follow an acknowledgement or an earlier answer; a distinct reply needs a new retry key. `
       + `Returns message and delivery for the outgoing reply, plus receipt for the original. `
       + `${OUTGOING} ${MUTATION_POLL}`,
     inputSchema: object({
@@ -152,16 +153,18 @@ export const PUBLIC_TOOLS = Object.freeze([
   },
   {
     name: "acc_ack",
-    description: `Answer a message that asked for an acknowledgement, so it stops `
-      + `demanding one. ${MUTATION_POLL}`,
+    description: `Acknowledge receipt without accepting work or writing an answer. `
+      + `An unanswered question/request requires acc_reply; acc_ack refuses without changing its receipt. `
+      + `Acknowledgement does not prevent a later reply. ${MUTATION_POLL}`,
     inputSchema: object({
-      messageId: string("The message being answered."),
+      messageId: string("The message being acknowledged."),
     }, ["messageId"]),
   },
   {
     name: "acc_finish",
     description: `Record a handoff describing what was completed and what remains, and `
-      + `release the claims this session owns. Call it while still working, not after: `
+      + `release the claims this session owns and close its ACC presence. `
+      + `Status describes the original goal, not peer acceptance. Call it while still working, not after: `
       + `nothing else writes the summary for you. ${OUTGOING} ${MUTATION_POLL}`,
     inputSchema: object({
       goal: string("What this stretch of work was for."),
@@ -169,7 +172,7 @@ export const PUBLIC_TOOLS = Object.freeze([
       completed: stringList("What was finished."),
       remaining: stringList("What is left."),
       blockers: stringList("What is in the way."),
-      toParticipantId: string("Participant taking over, if any."),
+      toParticipantId: string("Intended recipient, if any; sending does not establish acceptance."),
       clientMessageId: string("Retry key; supply before sending if needed after a lost response. Omit to generate one returned in message."),
     }, ["goal"]),
   },

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

@@ -1,6 +1,6 @@
 {
   "name": "@agents-can-communicate/protocol",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "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.5.2",
+  "version": "0.5.4",
   "private": true,
   "type": "module",
   "exports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-can-communicate",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "accManagedUpdateProtocol": 2,
   "accStoreVersion": 6,
   "type": "module",