pilotswarm 0.4.1 → 0.5.0

package/mcp/dist/src/tools/agents.js

@@ -77,8 +77,9 @@ export function registerAgentTools(server, ctx) {
         title: "List Registered Agents",
         description: "Read PilotSwarm's catalog of registered agent definitions visible to this MCP server. " +
             "Returns name, description, system flag, and parent constraint per definition. " +
-            "Pure inspection — does not create or spawn anything. Workers in different processes " +
-            "may have a different catalog (configured per-process via --plugin).",
+            "Pure inspection — does not create or spawn anything. In Web API mode this is the deployment's " +
+            "creatable-agent catalog (what createSessionForAgent accepts); in direct mode it is loaded from " +
+            "local --plugin dirs and may diverge from any particular worker's catalog.",
         inputSchema: {
             include_system: z
                 .boolean()

package/mcp/dist/src/tools/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/tools/agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,GAAkB;IACpE,4EAA4E;IAC5E,EAAE;IACF,yEAAyE;IACzE,wEAAwE;IACxE,gEAAgE;IAChE,qEAAqE;IACrE,mEAAmE;IACnE,iBAAiB;IACjB,MAAM,CAAC,YAAY,CACf,aAAa,EACb;QACI,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACP,6HAA6H;YAC7H,gDAAgD;QACpD,WAAW,EAAE;YACT,iBAAiB,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;YACrE,aAAa,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,8DAA8D,CAAC;SAChF;KACJ,EACD,KAAK,EAAE,EAAE,iBAAiB,EAAE,aAAa,EAAE,EAAE,EAAE;QAC3C,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAE/C,6CAA6C;YAC7C,IAAI,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;YAE5D,IAAI,iBAAiB,EAAE,CAAC;gBACpB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,KAAK,iBAAiB,CAAC,CAAC;YAChF,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAChB,MAAM,CAAC,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;gBACtC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;YACtE,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBACjC,gBAAgB,EAAE,CAAC,CAAC,SAAS;gBAC7B,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;gBAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,oBAAoB,EAAE,CAAC,CAAC,mBAAmB,IAAI,IAAI;gBACnD,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;gBAC3B,iBAAiB,EAAE,CAAC,CAAC,eAAe;gBACpC,SAAS,EAAE,CAAC,CAAC,QAAQ,IAAI,KAAK;gBAC9B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,CAAC;gBAC7B,WAAW,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;gBACjC,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,UAAU,EAAE,CAAC,CAAC,SAAS;gBACvB,UAAU,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;aAClC,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EACpC,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,2EAA2E;IAC3E,EAAE;IACF,oEAAoE;IACpE,wEAAwE;IACxE,qEAAqE;IACrE,kEAAkE;IAClE,iEAAiE;IACjE,MAAM,CAAC,YAAY,CACf,wBAAwB,EACxB;QACI,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACP,wFAAwF;YACxF,gFAAgF;YAChF,sFAAsF;YACtF,qEAAqE;QACzE,WAAW,EAAE;YACT,cAAc,EAAE,CAAC;iBACZ,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,4EAA4E,CAAC;SAC9F;KACJ,EACD,KAAK,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;QACzB,IAAI,CAAC;YACD,IAAI,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC;YAClC,IAAI,CAAC,cAAc,EAAE,CAAC;gBAClB,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;gBACtB,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;gBAClC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;gBACzB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,IAAI;aAC3B,CAAC,CAAC,CAAC;YAEJ,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;qBACtE;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,wDAAwD;IACxD,EAAE;IACF,qEAAqE;IACrE,wEAAwE;IACxE,gBAAgB;IAChB,MAAM,CAAC,YAAY,CACf,gBAAgB,EAChB;QACI,KAAK,EAAE,gBAAgB;QACvB,WAAW,EACP,wDAAwD;YACxD,wDAAwD;YACxD,oCAAoC;YACpC,4FAA4F;QAChG,WAAW,EAAE;YACT,eAAe,EAAE,CAAC;iBACb,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACL,6DAA6D;gBAC7D,kGAAkG,CACrG;YACL,SAAS,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,EAAE,CAAC;iBACP,QAAQ,EAAE;iBACV,QAAQ,CAAC,qCAAqC,CAAC;YACpD,cAAc,EAAE,CAAC;iBACZ,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,sDAAsD,CAAC;SACxE;KACJ,EACD,KAAK,EAAE,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE;QACrD,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,SAAS,IAAI,CAAC,CAAC;YAC7B,MAAM,aAAa,GAAG,cAAc,IAAI,IAAI,CAAC;YAC7C,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAE/C,oCAAoC;YACpC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAiB,CAAC;YAClD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAe,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,QAAiB,EAAE,CAAC;gBAChC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;gBAChC,IAAI,CAAC,CAAC,eAAe,EAAE,CAAC;oBACpB,MAAM,GAAG,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;oBAC1D,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBACZ,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;gBACjD,CAAC;YACL,CAAC;YAED,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACjB,KAAK,EAAE,mBAAmB;gCAC1B,eAAe;6BAClB,CAAC;yBACL;qBACJ;oBACD,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;YAClC,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,YAAY,GAAG,CAAC,CAAC;YAErB,MAAM,SAAS,GAAG,CAAC,CAAM,EAAE,KAAa,EAAO,EAAE;gBAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC3B,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;gBACjI,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;gBACzB,UAAU,EAAE,CAAC;gBACb,IAAI,KAAK,GAAG,YAAY;oBAAE,YAAY,GAAG,KAAK,CAAC;gBAE/C,IAAI,UAAU,GAAU,EAAE,CAAC;gBAC3B,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;oBAChB,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;oBACrD,UAAU,GAAG,IAAI;yBACZ,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;yBAC3C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC7C,CAAC;gBAED,OAAO;oBACH,UAAU,EAAE,CAAC,CAAC,SAAS;oBACvB,QAAQ,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;oBAC3B,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;oBACtB,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAC9B,KAAK;oBACL,QAAQ,EAAE,UAAU;iBACvB,CAAC;YACN,CAAC,CAAC;YAEF,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAEhC,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAChB,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,EAC/E,IAAI,EACJ,CAAC,CACJ;qBACJ;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;IAEF,sEAAsE;IACtE,oEAAoE;IACpE,MAAM,CAAC,YAAY,CACf,wBAAwB,EACxB;QACI,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACP,0EAA0E;YAC1E,uFAAuF;YACvF,kBAAkB;QACtB,WAAW,EAAE;YACT,UAAU,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACL,gEAAgE;gBAChE,oEAAoE,CACvE;SACR;KACJ,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACrB,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,OAAO;oBACH,OAAO,EAAE;wBACL;4BACI,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,CAAC;yBACnE;qBACJ;oBACD,OAAO,EAAE,IAAI;iBAChB,CAAC;YACN,CAAC;YAED,MAAM,GAAG,GAAG;gBACR,eAAe,EAAE,KAAK,CAAC,aAAa;gBACpC,IAAI,EAAE;oBACF,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS;oBAChC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI;oBACpC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI;oBAC/B,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI;oBACpD,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI;oBACrD,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB;oBACjD,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB;oBAC9C,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc;oBAC1C,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB;oBACjD,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI;oBACvD,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI;oBACnD,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,IAAI;oBACvD,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;oBACpC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY;oBACtC,iBAAiB,EAAE,KAAK,CAAC,IAAI,CAAC,eAAe;oBAC7C,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB;oBAC/C,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa;oBACzC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI;oBACxC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS;oBAChC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS;iBACnC;gBACD,IAAI,EAAE;oBACF,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY;oBACtC,kBAAkB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB;oBAC/C,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB;oBACjD,uBAAuB,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB;oBACxD,wBAAwB,EAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB;oBAC1D,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa;oBACzC,uBAAuB,EAAE,KAAK,CAAC,IAAI,CAAC,qBAAqB;oBACzD,qBAAqB,EAAE,KAAK,CAAC,IAAI,CAAC,mBAAmB;oBACrD,yBAAyB,EAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB;oBAC5D,yBAAyB,EAAE,KAAK,CAAC,IAAI,CAAC,sBAAsB;iBAC/D;gBACD,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChC,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,aAAa,EAAE,CAAC,CAAC,YAAY;oBAC7B,kBAAkB,EAAE,CAAC,CAAC,gBAAgB;oBACtC,mBAAmB,EAAE,CAAC,CAAC,iBAAiB;oBACxC,uBAAuB,EAAE,CAAC,CAAC,oBAAoB;oBAC/C,wBAAwB,EAAE,CAAC,CAAC,qBAAqB;oBACjD,yBAAyB,EAAE,CAAC,CAAC,sBAAsB;oBACnD,eAAe,EAAE,CAAC,CAAC,aAAa;iBACnC,CAAC,CAAC;aACN,CAAC;YAEF,OAAO;gBACH,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;qBACrC;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACH,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;gBAC/D,OAAO,EAAE,IAAI;aAChB,CAAC;QACN,CAAC;IACL,CAAC,CACJ,CAAC;AACN,CAAC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../../src/tools/agents.ts"],"names":[],"mappings":"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"}

package/mcp/dist/src/tools/artifacts.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+/**
+ * Session artifact tools (proposal G4). Web-mode only — artifacts are served
+ * by the deployment's blob store through the Web API; the MCP server has no
+ * blob-store client in direct mode.
+ *
+ * Binary content stays over HTTP: get_artifact returns the authenticated
+ * download route for binaries rather than base64-inflating MCP responses.
+ */
+export declare function registerArtifactTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=artifacts.d.ts.map

package/mcp/dist/src/tools/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../../src/tools/artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QAmG1E"}

package/mcp/dist/src/tools/artifacts.js

@@ -0,0 +1,92 @@
+import { z } from "zod";
+import { jsonResult, errorResult, withToolErrors } from "../util/respond.js";
+/**
+ * Session artifact tools (proposal G4). Web-mode only — artifacts are served
+ * by the deployment's blob store through the Web API; the MCP server has no
+ * blob-store client in direct mode.
+ *
+ * Binary content stays over HTTP: get_artifact returns the authenticated
+ * download route for binaries rather than base64-inflating MCP responses.
+ */
+export function registerArtifactTools(server, ctx) {
+    const api = ctx.api;
+    if (!api)
+        return;
+    server.registerTool("list_artifacts", {
+        title: "List Artifacts",
+        description: "List the artifacts (files) a PilotSwarm session has produced or been given.",
+        inputSchema: {
+            session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The session whose artifacts to list"),
+        },
+    }, withToolErrors(async ({ session_id }) => {
+        const artifacts = await api.call("listArtifacts", { sessionId: session_id });
+        const list = Array.isArray(artifacts) ? artifacts : (artifacts?.artifacts ?? []);
+        return jsonResult({ count: list.length, artifacts: list });
+    }));
+    server.registerTool("get_artifact", {
+        title: "Get Artifact",
+        description: "Fetch a session artifact. include controls what comes back: 'meta' (metadata), 'text' (content as "
+            + "text — for text artifacts). Binary artifacts: use the download_url returned in meta.",
+        inputSchema: {
+            session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The session owning the artifact"),
+            filename: z.string().min(1).describe("Artifact filename"),
+            include: z.array(z.enum(["meta", "text"])).optional().describe("What to fetch (default ['meta'])"),
+        },
+    }, withToolErrors(async ({ session_id, filename, include }) => {
+        const wants = new Set(include ?? ["meta"]);
+        const result = { session_id, filename };
+        if (wants.has("meta")) {
+            try {
+                result.meta = await api.call("getArtifactMetadata", { sessionId: session_id, filename });
+            }
+            catch (err) {
+                return errorResult(err instanceof Error ? err.message : String(err), { session_id, filename });
+            }
+            // Authenticated binary download route (bespoke, streams).
+            result.download_url = `/api/v1/sessions/${session_id}/artifacts/${encodeURIComponent(filename)}/download`;
+        }
+        if (wants.has("text")) {
+            try {
+                result.text = await api.call("downloadArtifact", { sessionId: session_id, filename });
+            }
+            catch (err) {
+                result.text = null;
+                result.text_error = err instanceof Error ? err.message : String(err);
+            }
+        }
+        return jsonResult(result);
+    }));
+    server.registerTool("upload_artifact", {
+        title: "Upload Artifact",
+        description: "Upload an artifact into a session (visible to the agent). Text content directly, or base64 with "
+            + "content_encoding='base64' for binary. 2 MB JSON envelope limit.",
+        inputSchema: {
+            session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The session to attach the artifact to"),
+            filename: z.string().min(1).describe("Artifact filename"),
+            content: z.string().describe("Content (text, or base64 when content_encoding='base64')"),
+            content_type: z.string().optional().describe("MIME type (e.g. text/markdown, application/pdf)"),
+            content_encoding: z.enum(["utf8", "base64"]).optional().describe("Encoding of `content` (default utf8)"),
+        },
+    }, withToolErrors(async ({ session_id, filename, content, content_type, content_encoding }) => {
+        const meta = await api.call("uploadArtifact", {
+            sessionId: session_id,
+            filename,
+            content,
+            contentType: content_type,
+            contentEncoding: content_encoding,
+        });
+        return jsonResult({ uploaded: true, meta });
+    }));
+    server.registerTool("delete_artifact", {
+        title: "Delete Artifact",
+        description: "Delete an artifact from a session.",
+        inputSchema: {
+            session_id: z.string().uuid({ message: "session_id must be a valid UUID" }).describe("The session owning the artifact"),
+            filename: z.string().min(1).describe("Artifact filename to delete"),
+        },
+    }, withToolErrors(async ({ session_id, filename }) => {
+        await api.call("deleteArtifact", { sessionId: session_id, filename });
+        return jsonResult({ deleted: true, filename });
+    }));
+}
+//# sourceMappingURL=artifacts.js.map

package/mcp/dist/src/tools/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../../src/tools/artifacts.ts"],"names":[],"mappings":"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"}

package/mcp/dist/src/tools/capabilities.d.ts

@@ -0,0 +1,27 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+/**
+ * Capability & identity descriptor (proposal G1).
+ *
+ * Two-layer discovery: conditional tool registration means an absent
+ * capability's tools never appear in tools/list; this descriptor explains the
+ * shape of what IS present, so clients can plan instead of probe. Flags are
+ * frozen at boot (the same per-boot gate used for registration) — a restart
+ * picks up provider changes, matching worker semantics.
+ */
+export declare function buildCapabilities(ctx: ServerContext): {
+    mode: string;
+    admin: boolean;
+    facts: {
+        search: boolean;
+        embedder: boolean;
+    };
+    graph: boolean;
+    graph_namespaces: boolean;
+    graph_stats: boolean;
+    models_configured: boolean;
+    skills_prompts: number;
+    registered_agents: number;
+};
+export declare function registerCapabilityTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=capabilities.d.ts.map

package/mcp/dist/src/tools/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../src/tools/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa;;;;;;;;;;;;;EAiBnD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QA0C5E"}

package/mcp/dist/src/tools/capabilities.js

@@ -0,0 +1,69 @@
+import { jsonResult, withToolErrors } from "../util/respond.js";
+/**
+ * Capability & identity descriptor (proposal G1).
+ *
+ * Two-layer discovery: conditional tool registration means an absent
+ * capability's tools never appear in tools/list; this descriptor explains the
+ * shape of what IS present, so clients can plan instead of probe. Flags are
+ * frozen at boot (the same per-boot gate used for registration) — a restart
+ * picks up provider changes, matching worker semantics.
+ */
+export function buildCapabilities(ctx) {
+    return {
+        mode: ctx.webMode ? "web" : "direct",
+        admin: ctx.admin,
+        facts: {
+            search: Boolean(ctx.enhancedFacts?.capabilities.search),
+            embedder: Boolean(ctx.enhancedFacts?.capabilities.embedder),
+        },
+        graph: Boolean(ctx.graph),
+        // Optional-method probes on the graph provider — presence differs by
+        // provider, not by transport.
+        graph_namespaces: Boolean(ctx.graph && typeof ctx.graph.listGraphNamespaces === "function"),
+        graph_stats: Boolean(ctx.graph && typeof ctx.graph.graphStats === "function"),
+        models_configured: Boolean(ctx.models) || ctx.webMode,
+        skills_prompts: ctx.skills.length,
+        registered_agents: ctx.registeredAgents.length,
+    };
+}
+export function registerCapabilityTools(server, ctx) {
+    server.registerTool("get_capabilities", {
+        title: "Get Capabilities",
+        description: "Describe this PilotSwarm MCP server's capability surface: mode (web/direct), whether the caller's "
+            + "credential carries the admin role, enhanced-facts search/embedder availability, graph availability, "
+            + "and counts of registered agents/skills. Use this before planning multi-step operations — tools for "
+            + "absent capabilities are not registered at all.",
+        inputSchema: {},
+    }, withToolErrors(async () => {
+        // Embedded-worker count — live state, fetched fresh (web only).
+        // IMPORTANT: this counts workers embedded in the PORTAL process.
+        // Deployments running dedicated worker pods report 0 here even
+        // with a healthy worker fleet; the truthful per-session signal is
+        // worker_claimed on the create_session response.
+        let embeddedWorkers = null;
+        if (ctx.api) {
+            try {
+                const w = await ctx.api.call("getWorkerCount");
+                embeddedWorkers = typeof w === "number" ? w : (w?.count ?? w?.workers ?? null);
+            }
+            catch {
+                embeddedWorkers = null;
+            }
+        }
+        let defaultModel = null;
+        try {
+            defaultModel = ctx.models
+                ? (ctx.models.defaultModel ?? null)
+                : ((await ctx.mgmt.getDefaultModel()) ?? null);
+        }
+        catch {
+            defaultModel = null;
+        }
+        return jsonResult({
+            ...buildCapabilities(ctx),
+            embedded_workers: embeddedWorkers,
+            default_model: defaultModel,
+        });
+    }));
+}
+//# sourceMappingURL=capabilities.js.map

package/mcp/dist/src/tools/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../src/tools/capabilities.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAkB;IAChD,OAAO;QACH,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ;QACpC,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,KAAK,EAAE;YACH,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC,MAAM,CAAC;YACvD,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC,QAAQ,CAAC;SAC9D;QACD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QACzB,qEAAqE;QACrE,8BAA8B;QAC9B,gBAAgB,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAQ,GAAG,CAAC,KAAa,CAAC,mBAAmB,KAAK,UAAU,CAAC;QACpG,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAQ,GAAG,CAAC,KAAa,CAAC,UAAU,KAAK,UAAU,CAAC;QACtF,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO;QACrD,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM;QACjC,iBAAiB,EAAE,GAAG,CAAC,gBAAgB,CAAC,MAAM;KACjD,CAAC;AACN,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,GAAkB;IACzE,MAAM,CAAC,YAAY,CACf,kBAAkB,EAClB;QACI,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACP,oGAAoG;cAClG,sGAAsG;cACtG,qGAAqG;cACrG,gDAAgD;QACtD,WAAW,EAAE,EAAE;KAClB,EACD,cAAc,CAAC,KAAK,IAAI,EAAE;QACtB,gEAAgE;QAChE,iEAAiE;QACjE,+DAA+D;QAC/D,kEAAkE;QAClE,iDAAiD;QACjD,IAAI,eAAe,GAAkB,IAAI,CAAC;QAC1C,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;YACV,IAAI,CAAC;gBACD,MAAM,CAAC,GAAQ,MAAM,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;gBACpD,eAAe,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,CAAC;YACnF,CAAC;YAAC,MAAM,CAAC;gBACL,eAAe,GAAG,IAAI,CAAC;YAC3B,CAAC;QACL,CAAC;QACD,IAAI,YAAY,GAAkB,IAAI,CAAC;QACvC,IAAI,CAAC;YACD,YAAY,GAAG,GAAG,CAAC,MAAM;gBACrB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;gBACnC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACL,YAAY,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,OAAO,UAAU,CAAC;YACd,GAAG,iBAAiB,CAAC,GAAG,CAAC;YACzB,gBAAgB,EAAE,eAAe;YACjC,aAAa,EAAE,YAAY;SAC9B,CAAC,CAAC;IACP,CAAC,CAAC,CACL,CAAC;AACN,CAAC"}

package/mcp/dist/src/tools/debug.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+export declare function registerDebugTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=debug.d.ts.map

package/mcp/dist/src/tools/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../src/tools/debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAuCnD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QA+DvE"}

package/mcp/dist/src/tools/debug.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { jsonResult, errorResult, withToolErrors } from "../util/respond.js";
+/**
+ * debug_session — the agent-tuner's diagnostic surface as one MCP tool.
+ *
+ * The agent-tuner system agent investigates "why is this session/agent
+ * misbehaving" with a read-only toolset (read_agent_events, session info,
+ * metric/token/tree summaries, retrieval + graph usage, orchestration stats,
+ * execution history). This tool exposes the same axes to an external MCP
+ * operator in a single include-driven call, so a debugging conversation can
+ * pull exactly the evidence it needs.
+ *
+ * Read-only by construction — every axis maps to a mgmt read. Axis failures
+ * are isolated into errors{} so one unsupported/broken read never sinks the
+ * investigation. (Fleet-level counterparts live in get_fleet_overview;
+ * knowledge reads in read_facts / search_facts.)
+ */
+const DEBUG_AXES = [
+    "info", // CMS session row (read_session_info)
+    "status", // live orchestration + custom status
+    "latest_response", // last turn's LLM payload
+    "events", // recent CMS events (read_agent_events)
+    "summary", // metric summary (read_session_metric_summary)
+    "tokens_by_model", // read_session_tokens_by_model
+    "tree_stats", // read_session_tree_stats
+    "skill_usage", // per-session skill usage
+    "retrieval_usage", // read_session_retrieval_usage (tree-aware)
+    "facts_stats", // per-session facts footprint
+    "orchestration_stats", // read_orchestration_stats (duroxide runtime)
+    "execution_history", // read_execution_history (heavyweight)
+    "child_outcomes", // what sub-agents concluded
+    "graph_node_usage", // read_session_graph_node_usage
+    "graph_edge_search_usage", // read_session_graph_edge_search_usage
+    "graph_searches", // recent graph search events
+];
+const DEFAULT_AXES = ["info", "status", "latest_response", "events", "summary", "orchestration_stats"];
+export function registerDebugTools(server, ctx) {
+    server.registerTool("debug_session", {
+        title: "Debug Session",
+        description: "Tuner-grade, read-only diagnostic bundle for one session — the same evidence surface PilotSwarm's "
+            + "agent-tuner uses to investigate misbehaving sessions/agents. include selects axes "
+            + `(default ${JSON.stringify(DEFAULT_AXES)}); the full set is ${JSON.stringify(DEBUG_AXES)}. `
+            + "Per-axis failures are isolated under errors{}. Heavyweight axes: execution_history. "
+            + "Fleet-level counterparts live in get_fleet_overview; knowledge reads in read_facts/search_facts.",
+        inputSchema: {
+            session_id: z.string().min(1).describe("The session to investigate"),
+            include: z.array(z.enum(DEBUG_AXES)).optional().describe("Diagnostic axes to fetch"),
+            tree: z.boolean().optional().describe("Tree-aware axes (retrieval_usage, skill_usage) aggregate across the spawn tree"),
+            since: z.string().optional().describe("ISO lower bound for usage axes (skill/retrieval/graph)"),
+            events_limit: z.number().int().positive().max(500).optional().describe("Recent-events window (default 50)"),
+            event_types: z.array(z.string()).optional().describe("Server-side event-type filter for the events axis"),
+            execution_id: z.number().int().optional().describe("Specific execution for execution_history (default latest)"),
+        },
+    }, withToolErrors(async ({ session_id, include, tree, since, events_limit, event_types, execution_id }) => {
+        const session = await ctx.mgmt.getSession(session_id);
+        if (!session)
+            return errorResult("session not found", { session_id });
+        const wants = new Set(include ?? DEFAULT_AXES);
+        const sinceDate = since ? new Date(since) : undefined;
+        const sinceOpts = sinceDate ? { since: sinceDate } : undefined;
+        const result = { session_id, tree: Boolean(tree) };
+        const errors = {};
+        const grab = async (key, fn) => {
+            if (!wants.has(key))
+                return;
+            try {
+                result[key] = await fn();
+            }
+            catch (err) {
+                errors[key] = err instanceof Error ? err.message : String(err);
+            }
+        };
+        await grab("info", async () => session);
+        await grab("status", () => ctx.mgmt.getSessionStatus(session_id));
+        await grab("latest_response", () => ctx.mgmt.getLatestResponse(session_id));
+        await grab("events", () => ctx.mgmt.getSessionEvents(session_id, undefined, events_limit ?? 50, event_types));
+        await grab("summary", () => ctx.mgmt.getSessionMetricSummary(session_id));
+        await grab("tokens_by_model", () => ctx.mgmt.getSessionTokensByModel(session_id));
+        await grab("tree_stats", () => ctx.mgmt.getSessionTreeStats(session_id));
+        await grab("skill_usage", () => tree ? ctx.mgmt.getSessionTreeSkillUsage(session_id, sinceOpts) : ctx.mgmt.getSessionSkillUsage(session_id, sinceOpts));
+        await grab("retrieval_usage", () => tree ? ctx.mgmt.getSessionTreeRetrievalUsage(session_id, sinceOpts) : ctx.mgmt.getSessionRetrievalUsage(session_id, sinceOpts));
+        await grab("facts_stats", () => ctx.mgmt.getSessionFactsStats(session_id));
+        await grab("orchestration_stats", () => ctx.mgmt.getOrchestrationStats(session_id));
+        await grab("execution_history", () => ctx.mgmt.getExecutionHistory(session_id, execution_id));
+        await grab("child_outcomes", () => ctx.mgmt.listChildOutcomes(session_id));
+        await grab("graph_node_usage", () => ctx.mgmt.getSessionGraphNodeUsage(session_id, sinceOpts));
+        await grab("graph_edge_search_usage", () => ctx.mgmt.getSessionGraphEdgeSearchUsage(session_id, sinceOpts));
+        await grab("graph_searches", () => ctx.mgmt.getSessionGraphSearches(session_id));
+        if (Object.keys(errors).length > 0)
+            result.errors = errors;
+        return jsonResult(result);
+    }));
+}
+//# sourceMappingURL=debug.js.map

package/mcp/dist/src/tools/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/tools/debug.ts"],"names":[],"mappings":"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"}

package/mcp/dist/src/tools/facts-enhanced.d.ts

@@ -0,0 +1,13 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+/**
+ * Enhanced-facts tools (proposal G2a). Registered ONLY when
+ * `ctx.enhancedFacts` is non-null (narrowed once at boot via
+ * isEnhancedFactStore). Embedder start/stop are [admin] — additionally gated
+ * on ctx.admin.
+ *
+ * Deliberately absent: configureEmbedder — it carries the embedding endpoint
+ * and its secrets; a worker-side concern, never a client surface.
+ */
+export declare function registerEnhancedFactTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=facts-enhanced.d.ts.map

package/mcp/dist/src/tools/facts-enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts-enhanced.d.ts","sourceRoot":"","sources":["../../../src/tools/facts-enhanced.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QA8F9E"}

package/mcp/dist/src/tools/facts-enhanced.js

@@ -0,0 +1,80 @@
+import { z } from "zod";
+import { jsonResult, withToolErrors } from "../util/respond.js";
+/**
+ * Enhanced-facts tools (proposal G2a). Registered ONLY when
+ * `ctx.enhancedFacts` is non-null (narrowed once at boot via
+ * isEnhancedFactStore). Embedder start/stop are [admin] — additionally gated
+ * on ctx.admin.
+ *
+ * Deliberately absent: configureEmbedder — it carries the embedding endpoint
+ * and its secrets; a worker-side concern, never a client surface.
+ */
+export function registerEnhancedFactTools(server, ctx) {
+    const store = ctx.enhancedFacts;
+    if (!store)
+        return;
+    // 1. search_facts — lexical | semantic | hybrid retrieval
+    server.registerTool("search_facts", {
+        title: "Search Facts",
+        description: "Multi-signal retrieval over the PilotSwarm knowledge store: lexical (BM25), semantic (embeddings), "
+            + "or hybrid fusion (default). Returns scored facts with per-signal contributions. "
+            + "TRUST NOTE: like read_facts, scope parameters are caller-supplied and not authenticated against client identity.",
+        inputSchema: {
+            query: z.string().min(1).describe("The search query"),
+            mode: z.enum(["lexical", "semantic", "hybrid"]).optional().describe("Retrieval mode (default hybrid)"),
+            namespace: z.string().optional().describe("Key-prefix filter, matched as '<prefix>/%' at any depth (e.g. 'skills' or 'acme/services')"),
+            tags: z.array(z.string()).optional().describe("Filter by tags"),
+            limit: z.number().int().positive().max(200).optional().describe("Max results (default 20)"),
+            min_semantic_score: z.number().min(0).max(1).optional().describe("Minimum cosine similarity for semantic candidates"),
+        },
+    }, withToolErrors(async ({ query, mode, namespace, tags, limit, min_semantic_score }) => {
+        const result = await store.searchFacts(query, {
+            mode,
+            namespace,
+            tags,
+            limit,
+            minSemanticScore: min_semantic_score,
+        });
+        return jsonResult(result);
+    }));
+    // 2. similar_facts — semantic kNN of a known fact
+    server.registerTool("similar_facts", {
+        title: "Similar Facts",
+        description: "Semantic nearest-neighbours of a known fact (no re-embedding). Anchor is identified by its scope key "
+            + "(e.g. 'shared:skills/foo' or 'session:<id>:notes/bar'). An unknown or inaccessible anchor returns empty.",
+        inputSchema: {
+            scope_key: z.string().min(1).describe("Scope key of the anchor fact"),
+            k: z.number().int().positive().max(100).optional().describe("Top-k neighbours (default 8)"),
+            min_score: z.number().min(0).max(1).optional().describe("Cosine similarity floor"),
+            namespace: z.string().optional().describe("Candidate key-prefix filter"),
+        },
+    }, withToolErrors(async ({ scope_key, k, min_score, namespace }) => {
+        const result = await store.similarFacts(scope_key, { k, minScore: min_score, namespace });
+        return jsonResult(result);
+    }));
+    // 3. embedder_status — durable embedder lifecycle state (read)
+    server.registerTool("embedder_status", {
+        title: "Embedder Status",
+        description: "Current lifecycle state of the durable facts embedder (batch + retry loops).",
+        inputSchema: {},
+    }, withToolErrors(async () => jsonResult(await store.embedderStatus())));
+    // [admin] start/stop — mutate a shared background loop.
+    if (ctx.admin) {
+        server.registerTool("start_embedder", {
+            title: "Start Embedder",
+            description: "Start the durable facts-embedder loops (batch + retry). Idempotent. [admin]",
+            inputSchema: {
+                interval_seconds: z.number().int().positive().optional().describe("Loop interval"),
+                batch: z.number().int().positive().optional().describe("Batch size"),
+            },
+        }, withToolErrors(async ({ interval_seconds, batch }) => jsonResult(await store.startEmbedder({ intervalSeconds: interval_seconds, batch }))));
+        server.registerTool("stop_embedder", {
+            title: "Stop Embedder",
+            description: "Stop the durable facts-embedder loops. No-op if already stopped. [admin]",
+            inputSchema: {
+                reason: z.string().optional().describe("Reason for stopping"),
+            },
+        }, withToolErrors(async ({ reason }) => jsonResult(await store.stopEmbedder(reason))));
+    }
+}
+//# sourceMappingURL=facts-enhanced.js.map

package/mcp/dist/src/tools/facts-enhanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts-enhanced.js","sourceRoot":"","sources":["../../../src/tools/facts-enhanced.ts"],"names":[],"mappings":"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"}

package/mcp/dist/src/tools/graph.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../context.js";
+/**
+ * Knowledge-graph tools (proposal G2b). Registered ONLY when `ctx.graph` is
+ * non-null — a separate injection, never derived from the fact store
+ * (enhancedfactstore 07 D2). Namespace-registry write tools are [admin].
+ *
+ * Deliberately absent: mergeGraphNodes and removeGraphEvidence — in-cluster
+ * harvester machinery, not a client surface (see WebGraphStore docstring).
+ */
+export declare function registerGraphTools(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=graph.d.ts.map

package/mcp/dist/src/tools/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/tools/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,QAqSvE"}