@synadia-ai/agent-fabric-claude-code 0.2.0 → 0.3.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nats-channel",
-  "version": "0.6.0+fabric.554414d.bbd3128",
+  "version": "0.6.0+fabric.1ed73c1.e770d25",
   "description": "NATS channel plugin for Claude Code — bridges NATS messaging to Claude Code sessions, with the Synadia Agent Fabric add-on and ScratchPad",
   "author": {
     "name": "Synadia"

package/BUILD

@@ -1,4 +1,4 @@
 plugin nats-channel 0.6.0
-synadia-agents 554414d
-agent-fabric-sdk bbd3128
-built 2026-10-11T08:01:50.287Z
+synadia-agents 1ed73c1
+agent-fabric-sdk e770d25
+built 2026-10-26T16:11:31.796Z

package/README.md

@@ -5,7 +5,8 @@ plugin for Claude Code (`nats-channel`), the fabric's tracing and
 ScratchPad's skill. The Claude Code session becomes an agent on the fabric:
 other agents find it and prompt it, its model calls join the prompt's
 thread, and its own prompts to other agents hang under the tool call that
-sent them.
+sent them. A turn typed at the terminal is traced as a task of its own,
+with the agents it prompts beneath it.
 
 ## Install
 
@@ -17,7 +18,7 @@ plugin; a marketplace names it with an npm source:
   "name": "agent-fabric",
   "owner": { "name": "Synadia" },
   "plugins": [
-    { "name": "nats-channel", "source": { "source": "npm", "package": "@synadia-ai/agent-fabric-claude-code", "version": "^0.2.0" } }
+    { "name": "nats-channel", "source": { "source": "npm", "package": "@synadia-ai/agent-fabric-claude-code", "version": "^0.3.0" } }
   ]
 }
 ```
@@ -52,6 +53,7 @@ environment:
 | `SCRATCHPAD_VOLUME`, `SCRATCHPAD_DIR` | optional: the agent's ScratchPad volume and its private workspace |
 
 `NATS_CONTEXT`, a NATS CLI context, wins over `NATS_URL` and `NATS_CREDS`.
+A context in the plugin's own config file counts only when neither is set.
 
 Start it with the channel, which is not on Claude Code's list of channels,
 so it loads as a development channel, with the warning Claude Code shows

package/hooks/hooks.json

@@ -31,6 +31,28 @@
         ]
       }
     ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun \"${CLAUDE_PLUGIN_ROOT}/hooks/session-event.js\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "StopFailure": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun \"${CLAUDE_PLUGIN_ROOT}/hooks/session-event.js\"",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "hooks": [

package/hooks/session-event.js

@@ -1,11 +1,14 @@
 #!/usr/bin/env bun
 // @bun
-import{writeSync as K}from"fs";import{homedir as V}from"os";import{join as Y}from"path";import{existsSync as rn,mkdirSync as g,readdirSync as sn,readFileSync as w,renameSync as J,rmSync as j,writeFileSync as D}from"fs";import{join as f}from"path";var U=/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/,q=/^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/,F=["discover_agents","prompt_agent","wait_agent","answer_agent","cancel_agent","list_agent_calls"];function A(n){return typeof n==="string"&&U.test(n)}function L(n){return typeof n==="string"&&q.test(n)}function c(n){return f(n,"sessions")}function C(n,e){return f(c(n),String(e))}function b(n,e){return f(c(n),`${e}.stop`)}function h(n,e){return f(c(n),`${e}.nudge`)}function x(n,e){return f(c(n),`${e}.turn`)}function z(n,e){return f(c(n),`${e}.open`)}function Z(n,e){return f(c(n),`${e}.tools`)}function l(n,e){let t=`${n}.${process.pid}.tmp`;D(t,e),J(t,n)}var B=new RegExp(`^mcp__.+__(${F.join("|")})$`);function G(n){return B.test(n)}function v(n){if(!("background_tasks"in n)&&!("session_crons"in n))return;return k(n.background_tasks)||k(n.session_crons)}function k(n){if(n===void 0||n===null||n===!1||n===0||n==="")return!1;if(Array.isArray(n))return n.length>0;if(typeof n==="object")return Object.keys(n).length>0;return!0}function R(n,e,t,r=Date.now()){let s=t.hook_event_name,o=A(t.session_id)?t.session_id:void 0;if(s==="SessionStart"){if(o===void 0)return;let i=typeof t.source==="string"?t.source:"unknown";return g(c(n),{recursive:!0}),l(C(n,e),`${JSON.stringify({session_id:o,source:i,at_ms:r})}
-`),"session"}if(s==="Stop"){let i=v(t),u=O(n,e),d=u===void 0||u.length>0?W(n,e)??N(t):void 0;return g(c(n),{recursive:!0}),l(b(n,e),`${JSON.stringify({...o?{session_id:o}:{},...i!==void 0?{background:i}:{},...d!==void 0?{final_text:d}:{},at_ms:r})}
-`),Q(h(n,e)),"stop"}if(s==="PreToolUse"){let{tool_use_id:i,tool_name:u}=t;if(typeof u!=="string"||u.length===0)return;if(g(c(n),{recursive:!0}),H(n,e,t.prompt_id,r),!G(u)||!L(i))return"turn";let d=Z(n,e);return g(d,{recursive:!0}),l(f(d,i),`${JSON.stringify({tool_use_id:i,tool_name:u,tool_input:t.tool_input??null,at_ms:r})}
-`),"tool"}return}function H(n,e,t,r){let s=A(t)?t:void 0,o=m(x(n,e)),i=p(o?.at_ms),u=p(o?.first_ms),d=p(m(b(n,e))?.at_ms),a=o!==void 0&&o.prompt_id===s&&i!==void 0&&u!==void 0&&(d===void 0||i>d);l(x(n,e),`${JSON.stringify({...s!==void 0?{prompt_id:s}:{},first_ms:a?u:r,at_ms:r})}
-`)}function E(n,e,t){if(t.hook_event_name!=="Stop"||t.stop_hook_active===!0)return;if(v(t)!==!1)return;let r=O(n,e);if(r===void 0||r.length===0)return;let s=r.map((o)=>`"${o}"`).join(", ");return`The NATS channel ${r.length===1?"request":"requests"} ${s} ${r.length===1?"is":"are"} still open: the sender has not received an answer, and cannot see this session's own output. Send your answer with the reply tool (load it with ToolSearch if it is deferred), with the request_id and done: true.`}function I(n,e,t,r=Date.now()){let s=N(t);g(c(n),{recursive:!0}),l(h(n,e),`${JSON.stringify({...s!==void 0?{final_text:s}:{},at_ms:r})}
-`)}function W(n,e){let t=m(h(n,e)),r=p(t?.at_ms);if(t===void 0||r===void 0)return;let s=p(m(b(n,e))?.at_ms);if(s!==void 0&&r<=s)return;let o=t.final_text;return typeof o==="string"&&o.length>0?o:void 0}function O(n,e){let t=m(z(n,e));if(!t)return;let{server_pid:r,request_ids:s}=t;if(typeof r!=="number"||!Number.isSafeInteger(r)||r<=0)return;if(!Array.isArray(s)||!s.every((o)=>typeof o==="string"&&/^[A-Za-z0-9_-]{1,64}$/.test(o)))return;if(!X(r))return;return s}function N(n){if("last_assistant_message"in n){let i=n.last_assistant_message;return typeof i==="string"&&i.trim().length>0?i.trim():void 0}let e=n.transcript_path;if(typeof e!=="string"||e.length===0)return;let t;try{t=w(e,"utf8")}catch{return}let r,s=[];for(let i of t.split(`
-`)){if(i.trim().length===0)continue;let u;try{u=JSON.parse(i)}catch{continue}if(typeof u!=="object"||u===null)continue;let{type:d,message:a,uuid:T}=u;if(d!=="assistant"||typeof a!=="object"||a===null)continue;let{id:M,content:_}=a,y=M??T;if(y===void 0||y!==r)r=y,s=[];if(typeof _==="string")s.push(_);else if(Array.isArray(_))for(let P of _){let S=P;if(S?.type==="text"&&typeof S.text==="string")s.push(S.text)}}let o=s.join(`
-`).trim();return o.length>0?o:void 0}function m(n){let e;try{e=w(n,"utf8")}catch{return}try{let t=JSON.parse(e);return typeof t==="object"&&t!==null&&!Array.isArray(t)?t:void 0}catch{return}}function p(n){return typeof n==="number"&&Number.isSafeInteger(n)&&n>=0?n:void 0}function Q(n){try{j(n,{recursive:!0,force:!0})}catch{}}function X(n){try{return process.kill(n,0),!0}catch(e){return e.code==="EPERM"}}var nn=5000;setTimeout(()=>process.exit(0),nn).unref();async function en(){let n=[];for await(let e of process.stdin)n.push(Buffer.from(e));return Buffer.concat(n).toString("utf8")}try{let n=process.env.CLAUDE_PID;if(n!==void 0&&/^\d+$/.test(n)){let e=JSON.parse(await en());if(typeof e==="object"&&e!==null&&!Array.isArray(e)){let t=process.env.NATS_STATE_DIR??Y(V(),".claude","channels","nats"),r=e,s=E(t,n,r);if(s!==void 0){try{I(t,n,r)}catch{}K(1,`${JSON.stringify({decision:"block",reason:s})}
-`)}else R(t,n,r)}}}catch{}process.exit(0);
+import{writeSync as _n}from"fs";import{homedir as yn}from"os";import{join as bn}from"path";import{appendFileSync as Z,existsSync as hn,mkdirSync as y,readdirSync as kn,readFileSync as A,renameSync as z,rmSync as B,writeFileSync as G}from"fs";import{join as a}from"path";var X=/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/,W=/^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/,Q=["discover_agents","prompt_agent","wait_agent","answer_agent","cancel_agent","list_agent_calls"];function l(n){return typeof n==="string"&&X.test(n)}function K(n){return typeof n==="string"&&W.test(n)}function f(n){return a(n,"sessions")}function V(n,t){return a(f(n),String(t))}function w(n,t){return a(f(n),`${t}.stop`)}function E(n,t){return a(f(n),`${t}.nudge`)}function M(n,t){return a(f(n),`${t}.turn`)}function Y(n,t){return a(f(n),`${t}.open`)}function nn(n,t){return a(f(n),`${t}.tools`)}function T(n,t){return a(f(n),`${t}.events`)}function I(n,t){let e=`${n}.${process.pid}.tmp`;G(e,t),z(e,n)}var en=new RegExp(`^mcp__.+__(${Q.join("|")})$`);function tn(n){return en.test(n)}function q(n){if(!("background_tasks"in n)&&!("session_crons"in n))return;return N(n.background_tasks)||N(n.session_crons)}function N(n){if(n===void 0||n===null||n===!1||n===0||n==="")return!1;if(Array.isArray(n))return n.length>0;if(typeof n==="object")return Object.keys(n).length>0;return!0}var P=/^plugin:[^"]+:nats$/,v=/^[A-Za-z0-9_-]{1,64}$/,rn=1024,sn=/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?Z$/,J=64,U=200;function on(n){if(typeof n!=="string"||!n.startsWith("<channel "))return;let t=n.indexOf(">");if(t<0||t>rn)return;let e=n.slice(0,t),r=/\ssource="([^"]*)"/.exec(e)?.[1],o=/\srequest_id="([^"]*)"/.exec(e)?.[1];if(r===void 0||o===void 0)return;if(!P.test(r)||!v.test(o))return;let s=/\sts="([^"]*)"/.exec(e)?.[1];return{requestId:o,source:r,...s!==void 0&&j(s)!==void 0?{ts:s}:{}}}function j(n){if(typeof n!=="string"||!sn.test(n))return;let t=Date.parse(n);return Number.isFinite(t)?t:void 0}function k(n,t){if(typeof n!=="string")return;let e=Array.from(n.replace(/[\u0000-\u001f\u007f]+/g," ").trim()).slice(0,t).join("");return e.length>0?e:void 0}function R(n,t,e){y(f(n),{recursive:!0}),Z(T(n,t),`${JSON.stringify(e)}
+`)}function F(n,t,e,r=Date.now()){let o=e.hook_event_name,s=l(e.session_id)?e.session_id:void 0,i=l(e.prompt_id)?e.prompt_id:void 0;if(o==="UserPromptSubmit"){let d=on(e.prompt);return R(n,t,{event:"submit",...s?{session_id:s}:{},...i?{prompt_id:i}:{},...d?{request_id:d.requestId,source:d.source}:{},...d?.ts!==void 0?{ts:d.ts}:{},at_ms:r}),"submit"}if(o==="StopFailure"){let d=k(e.error,J),u=k(e.error_details,U);return R(n,t,{event:"failure",...s?{session_id:s}:{},...i?{prompt_id:i}:{},...d!==void 0?{error:d}:{},...u!==void 0?{error_details:u}:{},at_ms:r}),"failure"}if(o==="SessionStart"){if(s===void 0)return;let d=typeof e.source==="string"?e.source:"unknown";return y(f(n),{recursive:!0}),I(V(n,t),`${JSON.stringify({session_id:s,source:d,at_ms:r})}
+`),"session"}if(o==="Stop"){let d=q(e),u=D(n,t,e),c=u===void 0||u.length>0?un(n,t)??H(e):void 0,m={...s?{session_id:s}:{},...d!==void 0?{background:d}:{},...c!==void 0?{final_text:c}:{},at_ms:r};return y(f(n),{recursive:!0}),I(w(n,t),`${JSON.stringify(m)}
+`),R(n,t,{event:"stop",...i?{prompt_id:i}:{},...m}),ln(E(n,t)),"stop"}if(o==="PreToolUse"){let{tool_use_id:d,tool_name:u}=e;if(typeof u!=="string"||u.length===0)return;if(y(f(n),{recursive:!0}),dn(n,t,e.prompt_id,r),!tn(u)||!K(d))return"turn";let c=nn(n,t);return y(c,{recursive:!0}),I(a(c,d),`${JSON.stringify({tool_use_id:d,tool_name:u,tool_input:e.tool_input??null,...i?{prompt_id:i}:{},at_ms:r})}
+`),"tool"}return}function dn(n,t,e,r){let o=l(e)?e:void 0,s=x(M(n,t)),i=g(s?.at_ms),d=g(s?.first_ms),u=g(x(w(n,t))?.at_ms),c=s!==void 0&&s.prompt_id===o&&i!==void 0&&d!==void 0&&(u===void 0||i>u);I(M(n,t),`${JSON.stringify({...o!==void 0?{prompt_id:o}:{},first_ms:c?d:r,at_ms:r})}
+`)}function L(n,t,e){if(e.hook_event_name!=="Stop"||e.stop_hook_active===!0)return;if(q(e)!==!1)return;let r=D(n,t,e);if(r===void 0||r.length===0)return;let o=r.map((s)=>`"${s}"`).join(", ");return`The NATS channel ${r.length===1?"request":"requests"} ${o} ${r.length===1?"is":"are"} still open: the sender has not received an answer, and cannot see this session's own output. Send your answer with the reply tool (load it with ToolSearch if it is deferred), with the request_id and done: true.`}function C(n,t,e,r=Date.now()){let o=H(e);y(f(n),{recursive:!0}),I(E(n,t),`${JSON.stringify({...o!==void 0?{final_text:o}:{},at_ms:r})}
+`)}function un(n,t){let e=x(E(n,t)),r=g(e?.at_ms);if(e===void 0||r===void 0)return;let o=g(x(w(n,t))?.at_ms);if(o!==void 0&&r<=o)return;let s=e.final_text;return typeof s==="string"&&s.length>0?s:void 0}function cn(n,t){let e=x(Y(n,t));if(!e)return;let r=e.server_pid,o=O(e.request_ids),s=e.open_ids===void 0?o:O(e.open_ids);if(typeof r!=="number"||!Number.isSafeInteger(r)||r<=0)return;if(o===void 0||s===void 0)return;if(!mn(r))return;let i=g(e.since_ms);return{requestIds:o,openIds:s,...i!==void 0?{sinceMs:i}:{}}}function O(n){return Array.isArray(n)&&n.every((t)=>typeof t==="string"&&v.test(t))?n:void 0}function D(n,t,e){let r=cn(n,t);if(r===void 0)return;let o=l(e.prompt_id)?e.prompt_id:void 0;if(o===void 0)return r.requestIds;let s=gn(n,t);if(!s.some((u)=>u.kind==="submit"&&u.submit.promptId!==void 0))return r.requestIds;let i=new Map,d;for(let u of s){if(u.kind!=="submit"||u.submit.requestId===void 0){d=void 0;continue}let{requestId:c,promptId:m,atMs:b,sentAtMs:_}=u.submit,S=d!==void 0&&b-d.atMs<=fn?d.promptIds:new Set;S.add(m);let p=r.sinceMs;if(p===void 0||b>=p&&(_??p)>=p)i.set(c,S);d={atMs:b,promptIds:S}}return r.openIds.filter((u)=>i.get(u)?.has(o)===!0)}var fn=30000;function H(n){if("last_assistant_message"in n){let i=n.last_assistant_message;return typeof i==="string"&&i.trim().length>0?i.trim():void 0}let t=n.transcript_path;if(typeof t!=="string"||t.length===0)return;let e;try{e=A(t,"utf8")}catch{return}let r,o=[];for(let i of e.split(`
+`)){if(i.trim().length===0)continue;let d;try{d=JSON.parse(i)}catch{continue}if(typeof d!=="object"||d===null)continue;let{type:u,message:c,uuid:m}=d;if(u!=="assistant"||typeof c!=="object"||c===null)continue;let{id:b,content:_}=c,h=b??m;if(h===void 0||h!==r)r=h,o=[];if(typeof _==="string")o.push(_);else if(Array.isArray(_))for(let S of _){let p=S;if(p?.type==="text"&&typeof p.text==="string")o.push(p.text)}}let s=o.join(`
+`).trim();return s.length>0?s:void 0}function x(n){let t;try{t=A(n,"utf8")}catch{return}try{let e=JSON.parse(t);return typeof e==="object"&&e!==null&&!Array.isArray(e)?e:void 0}catch{return}}function g(n){return typeof n==="number"&&Number.isSafeInteger(n)&&n>=0?n:void 0}function an(n){if(!n)return;let t=g(n.at_ms);if(t===void 0)return;return{...l(n.session_id)?{sessionId:n.session_id}:{},...l(n.prompt_id)?{promptId:n.prompt_id}:{},...typeof n.background==="boolean"?{background:n.background}:{},...typeof n.final_text==="string"&&n.final_text.length>0?{finalText:n.final_text}:{},atMs:t}}function pn(n){let t;try{t=JSON.parse(n)}catch{return}if(typeof t!=="object"||t===null||Array.isArray(t))return;let e=t,r=g(e.at_ms);if(r===void 0)return;let o={...l(e.session_id)?{sessionId:e.session_id}:{},...l(e.prompt_id)?{promptId:e.prompt_id}:{}};switch(e.event){case"submit":{let s=typeof e.request_id==="string"&&v.test(e.request_id)&&typeof e.source==="string"&&P.test(e.source)?{requestId:e.request_id,source:e.source}:{},i=s.requestId!==void 0?j(e.ts):void 0;return{kind:"submit",submit:{...o,...s,...i!==void 0?{sentAtMs:i}:{},atMs:r}}}case"stop":{let s=an(e);return s?{kind:"stop",stop:s}:void 0}case"failure":{let s=k(e.error,J),i=k(e.error_details,U);return{kind:"failure",failure:{...o,...s!==void 0?{error:s}:{},...i!==void 0?{errorDetails:i}:{},atMs:r}}}default:return}}function gn(n,t){let e;try{e=A(T(n,t),"utf8")}catch{return[]}let r=[],o=e.lastIndexOf(`
+`);for(let s of e.slice(0,o+1).split(`
+`)){if(s.length===0)continue;let i=pn(s);if(i)r.push(i)}return r}function ln(n){try{B(n,{recursive:!0,force:!0})}catch{}}function mn(n){try{return process.kill(n,0),!0}catch(t){return t.code==="EPERM"}}var Sn=5000;setTimeout(()=>process.exit(0),Sn).unref();async function In(){let n=[];for await(let t of process.stdin)n.push(Buffer.from(t));return Buffer.concat(n).toString("utf8")}try{let n=process.env.CLAUDE_PID;if(n!==void 0&&/^\d+$/.test(n)){let t=JSON.parse(await In());if(typeof t==="object"&&t!==null&&!Array.isArray(t)){let e=process.env.NATS_STATE_DIR??bn(yn(),".claude","channels","nats"),r=t,o=L(e,n,r);if(o!==void 0){try{C(e,n,r)}catch{}_n(1,`${JSON.stringify({decision:"block",reason:o})}
+`)}else F(e,n,r)}}}catch{}process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synadia-ai/agent-fabric-claude-code",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Claude Code on the Synadia Agent Fabric: the NATS channel plugin for Claude Code with the fabric's tracing and ScratchPad, in one plugin",
   "keywords": [
     "claude-code",