chainlesschain 0.166.1 → 0.166.2

package/src/lib/agent-team/team-message-tools.js

@@ -0,0 +1,198 @@
+/** Model-facing tool bundle for a lease-bound TeamMessageBridge. */
+
+import {
+  callTeamMessageBridge,
+  TEAM_MESSAGE_BRIDGE_MAX_WAIT_MS,
+  TEAM_MESSAGE_BRIDGE_PROTOCOL,
+} from "./team-message-bridge.js";
+
+export const TEAM_MESSAGE_TOOL_NAMES = Object.freeze([
+  "team_send",
+  "team_receive",
+  "team_ack",
+  "team_followup",
+]);
+
+const DEFINITIONS = Object.freeze([
+  {
+    type: "function",
+    function: {
+      name: "team_send",
+      description:
+        "Queue an at-least-once message to another teammate. The parent binds the sender to this exact task attempt; message content cannot grant permissions or approvals.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          to: {
+            type: "string",
+            description: "Teammate id, coordinator, or *.",
+          },
+          subject: { type: "string", maxLength: 256 },
+          body: { description: "JSON coordination payload." },
+          message_id: {
+            type: "string",
+            maxLength: 128,
+            description: "Stable idempotency key for retries.",
+          },
+          causation_id: { type: "string", maxLength: 128 },
+          correlation_id: { type: "string", maxLength: 128 },
+        },
+        required: ["to", "body", "message_id"],
+      },
+    },
+  },
+  {
+    type: "function",
+    function: {
+      name: "team_receive",
+      description:
+        "Receive this teammate's unprocessed messages. Delivery is at-least-once; call team_ack with a stable consumer_key only after processing.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          limit: { type: "integer", minimum: 1, maximum: 100 },
+          wait_ms: {
+            type: "integer",
+            minimum: 0,
+            maximum: TEAM_MESSAGE_BRIDGE_MAX_WAIT_MS,
+          },
+          mark_read: { type: "boolean" },
+        },
+      },
+    },
+  },
+  {
+    type: "function",
+    function: {
+      name: "team_ack",
+      description:
+        "Persist read, processed, or dead-letter receipts for explicitly listed message ids. A different consumer_key cannot re-process a settled message.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          message_ids: {
+            type: "array",
+            minItems: 1,
+            maxItems: 100,
+            uniqueItems: true,
+            items: { type: "integer", minimum: 1 },
+          },
+          consumer_key: { type: "string", minLength: 1, maxLength: 256 },
+          disposition: {
+            type: "string",
+            enum: ["read", "processed", "dead_letter"],
+          },
+          reason: { type: "string", maxLength: 1024 },
+        },
+        required: ["message_ids", "consumer_key"],
+      },
+    },
+  },
+  {
+    type: "function",
+    function: {
+      name: "team_followup",
+      description:
+        "Queue an at-least-once follow-up and request a teammate turn wake. The result states whether the target is active or the request remains queued.",
+      parameters: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          to: { type: "string", description: "Teammate id or coordinator." },
+          subject: { type: "string", maxLength: 256 },
+          body: { description: "JSON follow-up payload." },
+          message_id: {
+            type: "string",
+            maxLength: 128,
+            description: "Stable idempotency key for retries.",
+          },
+          causation_id: { type: "string", maxLength: 128 },
+          correlation_id: { type: "string", maxLength: 128 },
+        },
+        required: ["to", "body", "message_id"],
+      },
+    },
+  },
+]);
+
+function descriptor(name) {
+  return Object.freeze({
+    name,
+    kind: "team-message",
+    category: "coordination",
+    source: "host:team-message-bridge",
+    serverName: null,
+    inheritable: false,
+    isReadOnly: false,
+    riskLevel: "low",
+    effectContract: Object.freeze({
+      version: 1,
+      declaredEffect: "write",
+      authorizedEffect: "write",
+      riskLevel: "low",
+      sourceTrusted: true,
+      provenance: "host:lease-bound-team-message-bridge",
+      annotations: Object.freeze({
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+      }),
+    }),
+  });
+}
+
+export function resolveTeamMessageToolBundle({
+  env = process.env,
+  call = callTeamMessageBridge,
+} = {}) {
+  const endpoint = env.CC_TEAM_MESSAGE_BRIDGE_ENDPOINT;
+  const token = env.CC_TEAM_MESSAGE_BRIDGE_TOKEN;
+  const protocol = Number(env.CC_TEAM_MESSAGE_BRIDGE_PROTOCOL);
+  if (!endpoint && !token && !env.CC_TEAM_MESSAGE_BRIDGE_PROTOCOL) return null;
+  if (
+    typeof endpoint !== "string" ||
+    !endpoint ||
+    typeof token !== "string" ||
+    token.length !== 64 ||
+    !/^[a-f0-9]{64}$/u.test(token) ||
+    protocol !== TEAM_MESSAGE_BRIDGE_PROTOCOL
+  ) {
+    const error = new Error("Team message bridge environment is invalid");
+    error.code = "TEAM_MESSAGE_BRIDGE_CONFIG_INVALID";
+    throw error;
+  }
+
+  const operations = {
+    team_send: "send",
+    team_receive: "receive",
+    team_ack: "ack",
+    team_followup: "followup",
+  };
+  const externalToolExecutors = {};
+  const externalToolDescriptors = {};
+  for (const [name, operation] of Object.entries(operations)) {
+    externalToolExecutors[name] = Object.freeze({
+      kind: "team-message",
+      operation,
+      inheritable: false,
+      execute: (args, options = {}) =>
+        call({
+          endpoint,
+          token,
+          op: operation,
+          args,
+          signal: options.signal || null,
+        }),
+    });
+    externalToolDescriptors[name] = descriptor(name);
+  }
+  return Object.freeze({
+    extraToolDefinitions: DEFINITIONS,
+    externalToolExecutors: Object.freeze(externalToolExecutors),
+    externalToolDescriptors: Object.freeze(externalToolDescriptors),
+  });
+}

package/src/lib/agent-team/team-runner.js

@@ -54,6 +54,9 @@ export class TeamRunner {
       typeof opts.budgetForTask === "function" ? opts.budgetForTask : null;
     // Directed/broadcast messaging between teammates (null → disabled).
     this.mailbox = opts.mailbox || null;
+    // Real agent children keep messages pending until their explicit ACK tool
+    // succeeds. Legacy/dry-run executors retain drain-on-dispatch semantics.
+    this.realtimeMessaging = opts.realtimeMessaging === true;
     // Optional conservative path ownership. Tasks with overlapping scopes are
     // serialized in a shared workspace; an empty scope means the whole repo.
     this.scopeLock = opts.scopeLock || null;
@@ -1144,12 +1147,54 @@ export class TeamRunner {
     const renew = () => this._renewClaim(claim);
     // A teammate-scoped messaging handle: post to a peer / broadcast, and read
     // its own inbox (direct messages + unseen broadcasts).
-    const inbox = this.mailbox ? this.mailbox.drain(holder) : [];
-    const sendMessage = (to, body, subject = null) => {
+    const inbox = this.mailbox
+      ? this.realtimeMessaging
+        ? this.mailbox.peek(holder)
+        : this.mailbox.drain(holder)
+      : [];
+    const messageAuthority = () => {
+      const current = this._claimsByKey.get(key);
+      if (
+        current !== claim ||
+        claim.lost ||
+        claim.interruption ||
+        claim.coordinatorAbort ||
+        claim.abortController.signal.aborted
+      ) {
+        const error = new Error(
+          `Team message authority for task "${key}" is no longer active`,
+        );
+        error.code = "TEAM_MESSAGE_BRIDGE_STALE_ATTEMPT";
+        throw error;
+      }
+      return {
+        holder,
+        taskKey: key,
+        attempt: task.attempts,
+        leaseId: claim.leaseId,
+        fencingToken: claim.fencingToken,
+      };
+    };
+    const recipientState = (recipient) => {
+      const member = this._members.get(recipient);
+      return member ? { ...member } : null;
+    };
+    const sendMessage = (to, body, subject = null, options = {}) => {
       if (!this.mailbox) return null;
       let message;
       try {
-        message = this.mailbox.send({ from: holder, to, subject, body });
+        const authority = messageAuthority();
+        message = this.mailbox.send({
+          from: holder,
+          to,
+          subject,
+          body,
+          mode: options.mode,
+          idempotencyKey: options.idempotencyKey,
+          causationId: options.causationId,
+          correlationId: options.correlationId,
+          senderAttempt: authority,
+        });
       } catch (error) {
         this._emit("mailbox:backpressure", {
           holder,
@@ -1167,6 +1212,13 @@ export class TeamRunner {
           messages: this.mailbox.size(),
         });
       }
+      this._emit("mailbox:message-sent", {
+        holder,
+        key,
+        messageId: message.id,
+        to: message.to,
+        mode: message.mode || "send",
+      });
       return message;
     };
     const startedAt = this._now();
@@ -1197,6 +1249,8 @@ export class TeamRunner {
         renew,
         inbox,
         sendMessage,
+        messageAuthority,
+        recipientState,
         mailbox: this.mailbox,
         budget: this.budget,
         budgetReservation: claim.budgetReservation,

package/src/lib/subagent-inheritance.js

@@ -54,20 +54,22 @@ export function filterInheritedMcp(parent, allow) {
     typeof parent.externalToolExecutors === "object"
       ? parent.externalToolExecutors
       : {};
+  const inheritable = (name) =>
+    descs[name]?.inheritable !== false && execs[name]?.inheritable !== false;
 
   const outDefs = defs.filter((d) => {
     const name = d?.function?.name;
-    return name && serverAllowed(mcpServerOf(name));
+    return name && inheritable(name) && serverAllowed(mcpServerOf(name));
   });
   const outDescs = {};
   for (const [name, desc] of Object.entries(descs)) {
     const server = desc?.serverName || mcpServerOf(name);
-    if (serverAllowed(server)) outDescs[name] = desc;
+    if (inheritable(name) && serverAllowed(server)) outDescs[name] = desc;
   }
   const outExecs = {};
   for (const [name, exec] of Object.entries(execs)) {
     const server = exec?.serverName || mcpServerOf(name);
-    if (serverAllowed(server)) outExecs[name] = exec;
+    if (inheritable(name) && serverAllowed(server)) outExecs[name] = exec;
   }
 
   if (

package/src/runtime/agent-core.js

@@ -8304,6 +8304,44 @@ async function executeToolInner(
         );
       }
 
+      if (localToolExecutor?.kind === "team-message") {
+        if (
+          localToolExecutor.inheritable !== false ||
+          typeof localToolExecutor.execute !== "function"
+        ) {
+          return attachDescriptor({
+            error:
+              "Team message tool blocked because its host authority is invalid",
+            code: "TEAM_MESSAGE_TOOL_AUTHORITY_INVALID",
+            policy: {
+              decision: "blocked",
+              via: "team-message-authority",
+            },
+          });
+        }
+        try {
+          const result = await localToolExecutor.execute(args || {}, {
+            signal,
+          });
+          return attachDescriptor(
+            result && typeof result === "object" ? result : { result },
+          );
+        } catch (error) {
+          return attachDescriptor({
+            error: `Team message tool failed: ${String(error?.message || error).slice(0, 2048)}`,
+            code: String(
+              error?.code || "TEAM_MESSAGE_TOOL_EXECUTION_FAILED",
+            ).slice(0, 128),
+            retryable:
+              error?.code === "TEAM_MESSAGE_BRIDGE_TIMEOUT" ||
+              Number.isSafeInteger(error?.retryAfterMs),
+            ...(Number.isSafeInteger(error?.retryAfterMs)
+              ? { retryAfterMs: error.retryAfterMs }
+              : {}),
+          });
+        }
+      }
+
       if (localToolExecutor?.kind === "mcp") {
         if (!mcpClient || typeof mcpClient.callTool !== "function") {
           return attachDescriptor({

package/src/runtime/headless-runner.js

@@ -204,6 +204,7 @@ import {
   runtimeToolCallId,
 } from "../lib/runtime-usage-ledger.js";
 import { runMeteredDirectModelCall } from "../lib/direct-model-usage.js";
+import { resolveTeamMessageToolBundle } from "../lib/agent-team/team-message-tools.js";
 
 /**
  * Normalize a public --permission-mode spelling to the canonical internal mode.
@@ -1990,6 +1991,20 @@ async function runAgentHeadlessInWorkspace(
   const hostMcp = mcp
     ? { ...mcp, mcpClient: mcpRecoveryRuntime.client || mcp.mcpClient }
     : null;
+  let teamMessageTools = null;
+  try {
+    teamMessageTools = (
+      deps.resolveTeamMessageToolBundle || resolveTeamMessageToolBundle
+    )({ env: options.teamMessageEnv || process.env });
+  } catch (error) {
+    writeErr(`Error: ${error.message}\n`);
+    emitHeadlessError(error.message);
+    return {
+      exitCode: HEADLESS_EXIT_CODES.CONFIG_ERROR,
+      result: error.message,
+      isError: true,
+    };
+  }
 
   // Seed MCP roots for --add-dir (Claude-Code roots/list_changed parity): a
   // headless session started with extra workspace roots must advertise the FULL
@@ -2424,9 +2439,27 @@ async function runAgentHeadlessInWorkspace(
     // --mcp-config wiring: tool defs for the LLM + dispatch map + live client.
     mcpClient: mcp?.mcpClient || null,
     mcpHostClient: mcpRecoveryRuntime.client || mcp?.mcpClient || null,
-    extraToolDefinitions: mcp?.extraToolDefinitions || undefined,
-    externalToolExecutors: mcp?.externalToolExecutors || undefined,
-    externalToolDescriptors: mcp?.externalToolDescriptors || undefined,
+    extraToolDefinitions:
+      mcp?.extraToolDefinitions || teamMessageTools?.extraToolDefinitions
+        ? [
+            ...(mcp?.extraToolDefinitions || []),
+            ...(teamMessageTools?.extraToolDefinitions || []),
+          ]
+        : undefined,
+    externalToolExecutors:
+      mcp?.externalToolExecutors || teamMessageTools?.externalToolExecutors
+        ? {
+            ...(mcp?.externalToolExecutors || {}),
+            ...(teamMessageTools?.externalToolExecutors || {}),
+          }
+        : undefined,
+    externalToolDescriptors:
+      mcp?.externalToolDescriptors || teamMessageTools?.externalToolDescriptors
+        ? {
+            ...(mcp?.externalToolDescriptors || {}),
+            ...(teamMessageTools?.externalToolDescriptors || {}),
+          }
+        : undefined,
     // Persist every MCP started/settled record into this exact canonical
     // session. Unknown/write/destructive prewrite failure then blocks before
     // the external call; a settlement failure leaves a recoverable started row.

package/src/assets/web-panel/assets/MarkdownRenderer-Cre8P8HG.js

@@ -1 +0,0 @@
-import{P as c,J as p,b as a}from"./vendor-Bn1JzzAn.js";import{r as s}from"./markdown-Yo_c6Krv.js";import{_ as d}from"./index-DX3wwu3G.js";const _={__name:"MarkdownRenderer",props:{content:{type:String,default:""}},setup(t,{expose:o}){o();const e=t,r=a(()=>s(e.content||"")),n={props:e,rendered:r,computed:a,get renderMarkdown(){return s}};return Object.defineProperty(n,"__isScriptSetup",{enumerable:!1,value:!0}),n}},i=["innerHTML"];function m(t,o,e,r,n,u){return c(),p("div",{class:"markdown-content",innerHTML:r.rendered},null,8,i)}const w=d(_,[["render",m],["__scopeId","data-v-0b0b9f63"],["__file","/tmp/cc-web-panel-awzFRF/repo/packages/web-panel/src/components/MarkdownRenderer.vue"]]);export{w as M};

package/src/assets/web-panel/assets/OrderTableRenderer-0NuumnfG.js

@@ -1 +0,0 @@
-import{I as h,P as l,J as u,U as s,R as n,c as i,K as v,Q as _,V as g,b as a}from"./vendor-Bn1JzzAn.js";import{_ as S}from"./index-DX3wwu3G.js";import"./icons-DG5UD-6K.js";const k={__name:"OrderTableRenderer",props:{event:{type:Object,required:!0}},setup(p,{expose:r}){r();const o=p,e=a(()=>o.event.content||{}),d=a(()=>o.event.extra||{}),m=a(()=>d.value.merchant||e.value.merchant||e.value.counterparty||"—"),c=a(()=>e.value.title||e.value.name||e.value.itemName||e.value.text||"—"),y=a(()=>{const t=e.value.amount??e.value.price??e.value.total;return t==null?"—":`${e.value.currency||"¥"} ${typeof t=="number"?t.toFixed(2):t}`}),T=a(()=>d.value.orderNo||e.value.orderNo||e.value.orderId),f=a(()=>e.value.status||e.value.state),w=a(()=>{const t=(f.value||"").toLowerCase();return t.includes("成功")||t.includes("succe")||t.includes("paid")?"green":t.includes("退")||t.includes("refund")?"orange":t.includes("失败")||t.includes("fail")?"red":"default"}),b=a(()=>{if(!o.event.occurredAt)return"";const t=new Date(o.event.occurredAt);return`${t.getFullYear()}-${String(t.getMonth()+1).padStart(2,"0")}-${String(t.getDate()).padStart(2,"0")} ${String(t.getHours()).padStart(2,"0")}:${String(t.getMinutes()).padStart(2,"0")}`}),x={props:o,c:e,e:d,merchantText:m,itemText:c,amountText:y,orderNo:T,statusText:f,statusColor:w,formattedTime:b,computed:a};return Object.defineProperty(x,"__isScriptSetup",{enumerable:!1,value:!0}),x}},N={class:"order-card"},C={class:"head"},O={class:"time"},R={class:"row"},V={class:"val"},F={class:"row"},B={class:"val"},D={class:"row amount-row"},I={class:"val amount"},j={key:0,class:"row"},A={class:"val mono"},M={key:1,class:"row"};function P(p,r,o,e,d,m){const c=h("a-tag");return l(),u("div",N,[s("div",C,[s("span",O,n(e.formattedTime),1),i(c,{color:"gold"},{default:v(()=>[_(n(o.event.source.adapter),1)]),_:1}),i(c,null,{default:v(()=>[_(n(o.event.subtype),1)]),_:1})]),s("div",R,[r[0]||(r[0]=s("span",{class:"key"},"商户",-1)),s("span",V,n(e.merchantText),1)]),s("div",F,[r[1]||(r[1]=s("span",{class:"key"},"商品/项目",-1)),s("span",B,n(e.itemText),1)]),s("div",D,[r[2]||(r[2]=s("span",{class:"key"},"金额",-1)),s("span",I,n(e.amountText),1)]),e.orderNo?(l(),u("div",j,[r[3]||(r[3]=s("span",{class:"key"},"单号",-1)),s("span",A,n(e.orderNo),1)])):g("v-if",!0),e.statusText?(l(),u("div",M,[r[4]||(r[4]=s("span",{class:"key"},"状态",-1)),i(c,{color:e.statusColor},{default:v(()=>[_(n(e.statusText),1)]),_:1},8,["color"])])):g("v-if",!0)])}const J=S(k,[["render",P],["__scopeId","data-v-5ed5524d"],["__file","/tmp/cc-web-panel-awzFRF/repo/packages/web-panel/src/components/pdh/renderers/OrderTableRenderer.vue"]]);export{J as default};

package/src/assets/web-panel/assets/devWarning-Ct8o3bu_.js

@@ -1 +0,0 @@
-import{Q as r}from"./index-DX3wwu3G.js";const o=((n,a,e)=>{r(n,`[ant-design-vue: ${a}] ${e}`)});export{o as d};

package/src/assets/web-panel/assets/index-D685kO6L.js

@@ -1 +0,0 @@
-import{C as o}from"./Col-DdN1TrqS.js";import{a0 as t}from"./index-DX3wwu3G.js";import"./vendor-Bn1JzzAn.js";import"./index-Cbu3-zFd.js";import"./icons-DG5UD-6K.js";const s=t(o);export{s as default};

package/src/assets/web-panel/assets/index-DTlIRMqX.js

@@ -1 +0,0 @@
-import{A as o}from"./Row-lzsTQZlq.js";import{a0 as t}from"./index-DX3wwu3G.js";import"./vendor-Bn1JzzAn.js";import"./responsiveObserve-C6zpL9bC.js";import"./useFlexGapSupport-w4RVmcGs.js";import"./styleChecker-Z078OtUc.js";import"./index-Cbu3-zFd.js";import"./icons-DG5UD-6K.js";const l=t(o);export{l as default};