@easynet/agent-tool 1.0.18 → 1.0.19

package/dist/{chunk-ETWGKCOP.js → chunk-GGKQQR54.js}

@@ -1,13 +1,14 @@
-import { createRuntimeFromConfig, MCP_KIND } from './chunk-RKN4PT7P.js';
-import { enrichSpecWithCanonicalSchema } from './chunk-FR2CXERF.js';
+import { createRuntimeFromConfig, MCP_KIND } from './chunk-TTYAOTOR.js';
+import { enrichSpecWithCanonicalSchema } from './chunk-46XYOB3H.js';
+import { normalizeToolName } from './chunk-GWBJEGS7.js';
 import { createServer } from 'http';
 
 // src/api/expose/openapi.ts
 function toolNameToSlug(name) {
-  return name.replace(/\//g, "~");
+  return name.replace(/\./g, "~");
 }
 function slugToToolName(slug) {
-  return slug.replace(/~/g, "/");
+  return slug.replace(/~/g, ".");
 }
 function toolSchemaKey(name) {
   return `Tool_${name.replace(/[^a-zA-Z0-9_]/g, "_")}`;
@@ -240,7 +241,7 @@ function createOpenAPIHttpServer(runtime, options = {}) {
         return;
       }
       if (req.method === "GET" && norm === "/tools") {
-        const { enrichSpecWithCanonicalSchema: enrichSpecWithCanonicalSchema2 } = await import('./canonicalCoreSchemas-YLHVHYJZ.js');
+        const { enrichSpecWithCanonicalSchema: enrichSpecWithCanonicalSchema2 } = await import('./canonicalCoreSchemas-DNBAHSUC.js');
         const specs = runtime.getRegistry().snapshot().map(enrichSpecWithCanonicalSchema2);
         const tools = specs.map((s) => ({
           name: s.name,
@@ -353,7 +354,7 @@ var DEFAULT_CTX2 = {
   ]
 };
 function toMcpToolName(registryName) {
-  return registryName.replace(/\//g, "_");
+  return normalizeToolName(registryName);
 }
 async function createMcpServerWithTools(runtime, options) {
   const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
@@ -469,5 +470,5 @@ async function runMCPServerOverStdio(runtime, options = {}) {
 }
 
 export { createHttpService, createMCPServer, createMCPServerStreamableHttp, createMCPStreamableHttpHandler, runMCPServerOverStdio };
-//# sourceMappingURL=chunk-ETWGKCOP.js.map
-//# sourceMappingURL=chunk-ETWGKCOP.js.map
+//# sourceMappingURL=chunk-GGKQQR54.js.map
+//# sourceMappingURL=chunk-GGKQQR54.js.map

package/dist/chunk-GGKQQR54.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/expose/openapi.ts","../src/api/expose/openapiHttp.ts","../src/api/expose/mcpServer.ts"],"names":["enrichSpecWithCanonicalSchema","DEFAULT_CTX"],"mappings":";;;;;;AAmBO,SAAS,eAAe,IAAA,EAAsB;AACnD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAO,GAAG,CAAA;AAChC;AAGO,SAAS,eAAe,IAAA,EAAsB;AACnD,EAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAA;AAC/B;AAGA,SAAS,cAAc,IAAA,EAAsB;AAC3C,EAAA,OAAO,CAAA,KAAA,EAAQ,IAAA,CAAK,OAAA,CAAQ,gBAAA,EAAkB,GAAG,CAAC,CAAA,CAAA;AACpD;AAEA,IAAM,YAAA,GAAe;AAAA,EACnB,IAAA,EAAM,QAAA;AAAA,EACN,UAAA,EAAY;AAAA,IACV,MAAA,EAAQ,EAAE,WAAA,EAAa,mBAAA,EAAqB,sBAAsB,IAAA;AAAK;AAE3E,CAAA;AACA,IAAM,WAAA,GAAc;AAAA,EAClB,IAAA,EAAM,QAAA;AAAA,EACN,UAAA,EAAY;AAAA,IACV,KAAA,EAAO,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,IACxB,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,IACvB,OAAA,EAAS,EAAE,IAAA,EAAM,QAAA,EAAU,sBAAsB,IAAA;AAAK;AAE1D,CAAA;AAMO,SAAS,kBAAA,CACd,QAAA,EACA,OAAA,GAA8B,EAAC,EACN;AACzB,EAAA,MAAM,KAAA,GAAQ,QAAQ,KAAA,IAAS,UAAA;AAC/B,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,OAAA;AACnC,EAAA,MAAM,YAAY,OAAA,CAAQ,QAAA,IAAY,EAAA,EAAI,OAAA,CAAQ,OAAO,EAAE,CAAA;AAC3D,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,QAAA,EAAS,CAAE,IAAI,6BAA6B,CAAA;AAEnE,EAAA,MAAM,eAAA,GAAkB;AAAA,IACtB,IAAA,EAAM,QAAA;AAAA,IACN,QAAA,EAAU,CAAC,OAAO,CAAA;AAAA,IAClB,UAAA,EAAY;AAAA,MACV,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,OAAA;AAAA,QACN,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,UAAA,EAAY;AAAA,YACV,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,YACvB,WAAA,EAAa,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,YAC9B,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA;AAAS;AACzB;AACF;AACF;AACF,GACF;AAEA,EAAA,MAAM,iBAAA,GAAoB;AAAA,IACxB,IAAA,EAAM,QAAA;AAAA,IACN,QAAA,EAAU,CAAC,MAAA,EAAQ,MAAM,CAAA;AAAA,IACzB,UAAA,EAAY;AAAA,MACV,IAAA,EAAM,EAAE,IAAA,EAAM,QAAA,EAAU,aAAa,kCAAA,EAAmC;AAAA,MACxE,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa,uEAAA;AAAA,QACb,oBAAA,EAAsB;AAAA;AACxB;AACF,GACF;AAEA,EAAA,MAAM,MAAA,GAAS,QAAA,GAAW,CAAA,EAAG,QAAQ,CAAA,CAAA,CAAA,GAAM,GAAA;AAC3C,EAAA,MAAM,KAAA,GAAiC;AAAA,IACrC,CAAC,CAAA,EAAG,MAAM,CAAA,KAAA,CAAO,GAAG;AAAA,MAClB,GAAA,EAAK;AAAA,QACH,OAAA,EAAS,YAAA;AAAA,QACT,WAAA,EAAa,qDAAA;AAAA,QACb,WAAA,EAAa,WAAA;AAAA,QACb,SAAA,EAAW;AAAA,UACT,KAAA,EAAO;AAAA,YACL,WAAA,EAAa,eAAA;AAAA,YACb,OAAA,EAAS;AAAA,cACP,kBAAA,EAAoB;AAAA,gBAClB,MAAA,EAAQ;AAAA;AACV;AACF;AACF;AACF;AACF,KACF;AAAA,IACA,CAAC,CAAA,EAAG,MAAM,CAAA,MAAA,CAAQ,GAAG;AAAA,MACnB,IAAA,EAAM;AAAA,QACJ,OAAA,EAAS,yBAAA;AAAA,QACT,WAAA,EAAa,gGAAA;AAAA,QACb,WAAA,EAAa,YAAA;AAAA,QACb,WAAA,EAAa;AAAA,UACX,QAAA,EAAU,IAAA;AAAA,UACV,OAAA,EAAS;AAAA,YACP,kBAAA,EAAoB;AAAA,cAClB,MAAA,EAAQ;AAAA;AACV;AACF,SACF;AAAA,QACA,SAAA,EAAW;AAAA,UACT,KAAA,EAAO;AAAA,YACL,WAAA,EAAa,aAAA;AAAA,YACb,SAAS,EAAE,kBAAA,EAAoB,EAAE,MAAA,EAAQ,cAAa;AAAE,WAC1D;AAAA,UACA,KAAA,EAAO;AAAA,YACL,WAAA,EAAa,aAAA;AAAA,YACb,SAAS,EAAE,kBAAA,EAAoB,EAAE,MAAA,EAAQ,aAAY;AAAE;AACzD;AACF;AACF;AACF,GACF;AAEA,EAAA,MAAM,gBAAoC,EAAC;AAC3C,EAAA,KAAA,MAAW,KAAK,KAAA,EAAO;AACrB,IAAA,MAAM,GAAA,GAAM,aAAA,CAAc,CAAA,CAAE,IAAI,CAAA;AAChC,IAAA,aAAA,CAAc,IAAA,CAAK,CAAC,GAAA,EAAK,CAAA,CAAE,WAAqB,CAAC,CAAA;AACjD,IAAA,MAAM,IAAA,GAAO,cAAA,CAAe,CAAA,CAAE,IAAI,CAAA;AAClC,IAAA,KAAA,CAAM,CAAA,EAAG,MAAM,CAAA,OAAA,EAAU,IAAI,EAAE,CAAA,GAAI;AAAA,MACjC,IAAA,EAAM;AAAA,QACJ,OAAA,EAAS,CAAA,CAAE,WAAA,IAAe,CAAA,CAAE,IAAA;AAAA,QAC5B,WAAA,EAAa,CAAA,cAAA,EAAiB,CAAA,CAAE,IAAI,CAAA,6DAAA,CAAA;AAAA,QACpC,WAAA,EAAa,UAAU,GAAG,CAAA,CAAA;AAAA,QAC1B,WAAA,EAAa;AAAA,UACX,QAAA,EAAU,IAAA;AAAA,UACV,OAAA,EAAS;AAAA,YACP,kBAAA,EAAoB;AAAA,cAClB,MAAA,EAAQ,EAAE,IAAA,EAAM,CAAA,qBAAA,EAAwB,GAAG,CAAA,CAAA;AAAG;AAChD;AACF,SACF;AAAA,QACA,SAAA,EAAW;AAAA,UACT,KAAA,EAAO;AAAA,YACL,WAAA,EAAa,aAAA;AAAA,YACb,SAAS,EAAE,kBAAA,EAAoB,EAAE,MAAA,EAAQ,cAAa;AAAE,WAC1D;AAAA,UACA,KAAA,EAAO;AAAA,YACL,WAAA,EAAa,0CAAA;AAAA,YACb,SAAS,EAAE,kBAAA,EAAoB,EAAE,MAAA,EAAQ,aAAY;AAAE;AACzD;AACF;AACF,KACF;AAAA,EACF;AAEA,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,OAAA;AAAA,IACT,IAAA,EAAM,EAAE,KAAA,EAAO,OAAA,EAAQ;AAAA,IACvB,KAAA;AAAA,IACA,UAAA,EAAY;AAAA,MACV,OAAA,EAAS,MAAA,CAAO,WAAA,CAAY,aAAa;AAAA;AAC3C,GACF;AACF;;;AC3JA,IAAM,WAAA,GAA2B;AAAA,EAC/B,SAAA,EAAW,CAAA,KAAA,EAAQ,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AAAA,EACvE,MAAA,EAAQ,CAAA,KAAA,EAAQ,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA;AAAA,EAC1B,WAAA,EAAa;AAAA,IACX,UAAA;AAAA,IAAY,SAAA;AAAA,IAAW,UAAA;AAAA,IAAY,SAAA;AAAA,IAAW,UAAA;AAAA,IAC9C,SAAA;AAAA,IAAW,UAAA;AAAA,IAAY;AAAA;AAE3B,CAAA;AAEA,SAAS,UAAU,GAAA,EAAwC;AACzD,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,IAAA,MAAM,SAAmB,EAAC;AAC1B,IAAA,GAAA,CAAI,GAAG,MAAA,EAAQ,CAAC,UAAU,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAC5C,IAAA,GAAA,CAAI,EAAA,CAAG,OAAO,MAAM;AAClB,MAAA,MAAM,MAAM,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA,CAAE,SAAS,OAAO,CAAA;AAClD,MAAA,IAAI,CAAC,GAAA,CAAI,IAAA,EAAK,EAAG;AACf,QAAA,OAAA,CAAQ,EAAE,CAAA;AACV,QAAA;AAAA,MACF;AACA,MAAA,IAAI;AACF,QAAA,OAAA,CAAQ,IAAA,CAAK,KAAA,CAAM,GAAG,CAAY,CAAA;AAAA,MACpC,CAAA,CAAA,MAAQ;AACN,QAAA,MAAA,CAAO,IAAI,KAAA,CAAM,mBAAmB,CAAC,CAAA;AAAA,MACvC;AAAA,IACF,CAAC,CAAA;AACD,IAAA,GAAA,CAAI,EAAA,CAAG,SAAS,MAAM,CAAA;AAAA,EACxB,CAAC,CAAA;AACH;AAEA,SAAS,QAAA,CAAS,GAAA,EAAqB,MAAA,EAAgB,IAAA,EAAqB;AAC1E,EAAA,GAAA,CAAI,SAAA,CAAU,MAAA,EAAQ,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AAC5D,EAAA,GAAA,CAAI,GAAA,CAAI,IAAA,CAAK,SAAA,CAAU,IAAI,CAAC,CAAA;AAC9B;AAGA,SAAS,cAAc,OAAA,EAAyB;AAC9C,EAAA,MAAM,cAAA,GAAiB,OAAA,CAAQ,OAAA,CAAQ,IAAA,EAAM,QAAQ,CAAA;AACrD,EAAA,OAAO,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,cAAA,EAeO,cAAc,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,OAAA,CAAA;AAa9B;AASO,SAAS,uBAAA,CACd,OAAA,EACA,OAAA,GAAoC,EAAC,EACT;AAC5B,EAAA,MAAM,YAAY,OAAA,CAAQ,QAAA,IAAY,EAAA,EAAI,OAAA,CAAQ,OAAO,EAAE,CAAA;AAC3D,EAAA,MAAM,aAAa,OAAA,CAAQ,kBAAA,KAAuB,OAAO,EAAE,GAAG,WAAA,EAAY,CAAA,CAAA;AAE1E,EAAA,MAAM,MAAA,GAAS,YAAA,CAAa,OAAO,GAAA,EAAsB,GAAA,KAAwB;AAC/E,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,IAAO,GAAA;AACvB,IAAA,MAAM,OAAO,GAAA,CAAI,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,IAAK,GAAA;AAClC,IAAA,MAAM,IAAA,GAAO,QAAA,GAAY,IAAA,KAAS,QAAA,GAAW,EAAA,GAAK,KAAK,OAAA,CAAQ,QAAA,EAAU,EAAE,CAAA,IAAK,GAAA,GAAO,IAAA;AAEvF,IAAA,IAAI;AACF,MAAA,IAAI,IAAI,MAAA,KAAW,KAAA,KAAU,IAAA,KAAS,GAAA,IAAO,SAAS,UAAA,CAAA,EAAa;AACjE,QAAA,MAAM,QAAA,GAAW,QAAA,GAAW,CAAA,EAAG,QAAQ,CAAA,aAAA,CAAA,GAAkB,eAAA;AACzD,QAAA,MAAM,IAAA,GAAO,cAAc,QAAQ,CAAA;AACnC,QAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,4BAA4B,CAAA;AACjE,QAAA,GAAA,CAAI,IAAI,IAAI,CAAA;AACZ,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,IAAI,MAAA,KAAW,KAAA,KAAU,IAAA,KAAS,eAAA,IAAmB,SAAS,OAAA,CAAA,EAAU;AAC1E,QAAA,MAAM,IAAA,GAAO,kBAAA,CAAmB,OAAA,CAAQ,WAAA,EAAY,EAAG;AAAA,UACrD,KAAA,EAAO,UAAA;AAAA,UACP,OAAA,EAAS,OAAA;AAAA,UACT,UAAU,QAAA,IAAY,KAAA;AAAA,SACvB,CAAA;AACD,QAAA,QAAA,CAAS,GAAA,EAAK,KAAK,IAAI,CAAA;AACvB,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,GAAA,CAAI,MAAA,KAAW,KAAA,IAAS,IAAA,KAAS,QAAA,EAAU;AAC7C,QAAA,MAAM,EAAE,6BAAA,EAAAA,8BAAAA,EAA8B,GAAI,MAAM,OAAO,oCAA0C,CAAA;AACjG,QAAA,MAAM,QAAQ,OAAA,CAAQ,WAAA,GAAc,QAAA,EAAS,CAAE,IAAIA,8BAA6B,CAAA;AAChF,QAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,UAC9B,MAAM,CAAA,CAAE,IAAA;AAAA,UACR,aAAa,CAAA,CAAE,WAAA;AAAA,UACf,MAAM,CAAA,CAAE,IAAA;AAAA,UACR,aAAa,CAAA,CAAE;AAAA,SACjB,CAAE,CAAA;AACF,QAAA,QAAA,CAAS,GAAA,EAAK,GAAA,EAAK,EAAE,KAAA,EAAO,CAAA;AAC5B,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,GAAA,CAAI,MAAA,KAAW,MAAA,IAAU,IAAA,KAAS,SAAA,EAAW;AAC/C,QAAA,MAAM,IAAA,GAAQ,MAAM,SAAA,CAAU,GAAG,CAAA;AACjC,QAAA,MAAM,OAAO,IAAA,EAAM,IAAA;AACnB,QAAA,MAAM,IAAA,GAAO,IAAA,EAAM,IAAA,IAAQ,EAAC;AAC5B,QAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,CAAC,IAAA,CAAK,MAAK,EAAG;AAC5C,UAAA,QAAA,CAAS,KAAK,GAAA,EAAK,EAAE,OAAO,mCAAA,EAAqC,IAAA,EAAM,eAAe,CAAA;AACtF,UAAA;AAAA,QACF;AACA,QAAA,MAAM,GAAA,GAAM,WAAW,GAAG,CAAA;AAC1B,QAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,MAAA;AAAA,UAC3B,EAAE,IAAA,EAAM,IAAA,CAAK,MAAK,EAAG,IAAA,EAAM,SAAS,SAAA,EAAU;AAAA,UAC9C;AAAA,SACF;AACA,QAAA,IAAI,OAAO,EAAA,EAAI;AACb,UAAA,QAAA,CAAS,KAAK,GAAA,EAAK,EAAE,MAAA,EAAQ,MAAA,CAAO,QAAQ,CAAA;AAC5C,UAAA;AAAA,QACF;AACA,QAAA,QAAA,CAAS,KAAK,GAAA,EAAK;AAAA,UACjB,KAAA,EAAO,MAAA,CAAO,KAAA,EAAO,OAAA,IAAW,aAAA;AAAA,UAChC,IAAA,EAAM,OAAO,KAAA,EAAO,IAAA;AAAA,UACpB,OAAA,EAAS,OAAO,KAAA,EAAO;AAAA,SACxB,CAAA;AACD,QAAA;AAAA,MACF;AAEA,MAAA,IAAI,GAAA,CAAI,MAAA,KAAW,MAAA,IAAU,IAAA,CAAK,UAAA,CAAW,UAAU,CAAA,IAAK,IAAA,CAAK,MAAA,GAAS,UAAA,CAAW,MAAA,EAAQ;AAC3F,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,UAAA,CAAW,MAAM,CAAA;AACzC,QAAA,MAAM,QAAA,GAAW,eAAe,IAAI,CAAA;AACpC,QAAA,IAAI,IAAA;AACJ,QAAA,IAAI;AACF,UAAA,IAAA,GAAO,MAAM,UAAU,GAAG,CAAA;AAAA,QAC5B,CAAA,CAAA,MAAQ;AACN,UAAA,QAAA,CAAS,KAAK,GAAA,EAAK,EAAE,OAAO,mBAAA,EAAqB,IAAA,EAAM,eAAe,CAAA;AACtE,UAAA;AAAA,QACF;AACA,QAAA,MAAM,GAAA,GAAM,WAAW,GAAG,CAAA;AAC1B,QAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,MAAA;AAAA,UAC3B,EAAE,MAAM,QAAA,EAAU,IAAA,EAAM,QAAQ,EAAC,EAAG,SAAS,SAAA,EAAU;AAAA,UACvD;AAAA,SACF;AACA,QAAA,IAAI,OAAO,EAAA,EAAI;AACb,UAAA,QAAA,CAAS,KAAK,GAAA,EAAK,EAAE,MAAA,EAAQ,MAAA,CAAO,QAAQ,CAAA;AAC5C,UAAA;AAAA,QACF;AACA,QAAA,QAAA,CAAS,KAAK,GAAA,EAAK;AAAA,UACjB,KAAA,EAAO,MAAA,CAAO,KAAA,EAAO,OAAA,IAAW,aAAA;AAAA,UAChC,IAAA,EAAM,OAAO,KAAA,EAAO,IAAA;AAAA,UACpB,OAAA,EAAS,OAAO,KAAA,EAAO;AAAA,SACxB,CAAA;AACD,QAAA;AAAA,MACF;AAEA,MAAA,GAAA,CAAI,SAAA,CAAU,GAAA,EAAK,EAAE,cAAA,EAAgB,oBAAoB,CAAA;AACzD,MAAA,GAAA,CAAI,GAAA,CAAI,KAAK,SAAA,CAAU,EAAE,OAAO,WAAA,EAAa,IAAA,EAAM,IAAA,EAAM,CAAC,CAAA;AAAA,IAC5D,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,UAAU,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC/D,MAAA,QAAA,CAAS,KAAK,GAAA,EAAK,EAAE,OAAO,OAAA,EAAS,IAAA,EAAM,kBAAkB,CAAA;AAAA,IAC/D;AAAA,EACF,CAAC,CAAA;AAED,EAAA,OAAO,MAAA;AACT;AAMO,SAAS,uBAAA,CACd,MAAA,EACA,OAAA,GAA4C,EAAC,EACJ;AACzC,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,IAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,CAAA;AAC7B,IAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,WAAA;AAC7B,IAAA,MAAA,CAAO,MAAA,CAAO,IAAA,EAAM,IAAA,EAAM,MAAM;AAC9B,MAAA,MAAM,IAAA,GAAO,OAAO,OAAA,EAAQ;AAC5B,MAAA,MAAM,UAAA,GAAa,OAAO,IAAA,KAAS,QAAA,IAAY,MAAM,IAAA,IAAQ,IAAA,GAAO,KAAK,IAAA,GAAO,IAAA;AAChF,MAAA,OAAA,CAAQ,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,CAAA;AAAA,IACpC,CAAC,CAAA;AACD,IAAA,MAAA,CAAO,EAAA,CAAG,SAAS,MAAM,CAAA;AAAA,EAC3B,CAAC,CAAA;AACH;AAmCA,eAAsB,iBAAA,CACpB,eAAA,EACA,OAAA,GAAoC,EAAC,EACT;AAC5B,EAAA,MAAM,OAAA,GACJ,QAAA,IAAY,eAAA,IAAmB,OAAO,eAAA,CAAgB,MAAA,KAAW,UAAA,GAC5D,eAAA,GAAA,CACA,MAAM,uBAAA,CAAwB,eAAuC,CAAA,EAAG,OAAA;AAC/E,EAAA,MAAM,MAAA,GAAS,uBAAA,CAAwB,OAAA,EAAS,OAAO,CAAA;AACvD,EAAA,MAAM,WAAA,GAAc,kBAAA,CAAmB,OAAA,CAAQ,WAAA,EAAY,EAAG;AAAA,IAC5D,KAAA,EAAO,QAAQ,KAAA,IAAS,UAAA;AAAA,IACxB,OAAA,EAAS,QAAQ,OAAA,IAAW,OAAA;AAAA,IAC5B,UAAU,OAAA,CAAQ;AAAA,GACnB,CAAA;AACD,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,WAAA;AAAA,IACA,MAAA,EAAQ,CAAC,UAAA,KAAe,uBAAA,CAAwB,QAAQ,UAAU;AAAA,GACpE;AACF;;;AC9PA,IAAMC,YAAAA,GAA2B;AAAA,EAC/B,SAAA,EAAW,CAAA,IAAA,EAAO,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA,EAAI,IAAA,CAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,KAAA,CAAM,CAAA,EAAG,CAAC,CAAC,CAAA,CAAA;AAAA,EACtE,MAAA,EAAQ,CAAA,KAAA,EAAQ,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA;AAAA,EAC1B,WAAA,EAAa;AAAA,IACX,UAAA;AAAA,IAAY,SAAA;AAAA,IAAW,UAAA;AAAA,IAAY,SAAA;AAAA,IAAW,UAAA;AAAA,IAC9C,SAAA;AAAA,IAAW,UAAA;AAAA,IAAY;AAAA;AAE3B,CAAA;AA6BA,SAAS,cAAc,YAAA,EAA8B;AACnD,EAAA,OAAO,kBAAkB,YAAY,CAAA;AACvC;AAMA,eAAe,wBAAA,CACb,SACA,OAAA,EACmH;AACnH,EAAA,MAAM,EAAE,SAAA,EAAU,GAAI,MAAM,OAAO,yCAAyC,CAAA;AAC5E,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,YAAA;AAC7B,EAAA,MAAM,OAAA,GAAU,QAAQ,OAAA,IAAW,OAAA;AACnC,EAAA,MAAM,aAAa,OAAA,CAAQ,kBAAA,KAAuB,OAAO,EAAE,GAAGA,YAAAA,EAAY,CAAA,CAAA;AAE1E,EAAA,MAAM,SAAS,IAAI,SAAA,CAAU,EAAE,IAAA,EAAM,SAAS,CAAA;AAC9C,EAAA,MAAM,QAAA,GAAW,QAAQ,WAAA,EAAY;AACrC,EAAA,MAAM,KAAA,GAAQ,SAAS,QAAA,EAAS;AAEhC,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,MAAM,OAAA,GAAU,aAAA,CAAc,IAAA,CAAK,IAAI,CAAA;AACvC,IAAA,MAAA,CAAO,YAAA;AAAA,MACL,OAAA;AAAA,MACA;AAAA,QACE,WAAA,EAAa,IAAA,CAAK,WAAA,IAAe,CAAA,MAAA,EAAS,KAAK,IAAI,CAAA,CAAA;AAAA,QACnD,aAAa,IAAA,CAAK,WAAA;AAAA,QAClB,OAAO,IAAA,CAAK;AAAA,OACd;AAAA,MACA,OAAO,IAAA,KAAkB;AACvB,QAAA,MAAM,MAAM,UAAA,EAAW;AACvB,QAAA,MAAM,MAAA,GAAS,MAAM,OAAA,CAAQ,MAAA;AAAA,UAC3B,EAAE,MAAM,IAAA,CAAK,IAAA,EAAM,MAAM,IAAA,IAAQ,EAAC,EAAG,OAAA,EAAS,QAAA,EAAS;AAAA,UACvD;AAAA,SACF;AACA,QAAA,IAAI,OAAO,EAAA,EAAI;AACb,UAAA,OAAO,EAAE,OAAA,EAAS,CAAC,EAAE,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,MAAA,CAAO,MAAM,CAAA,EAAG,CAAA,EAAE;AAAA,QAC5E;AACA,QAAA,MAAM,MAAM,MAAA,CAAO,KAAA;AACnB,QAAA,OAAO;AAAA,UACL,OAAA,EAAS;AAAA,YACP;AAAA,cACE,IAAA,EAAM,MAAA;AAAA,cACN,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,EAAE,KAAA,EAAO,GAAA,EAAK,OAAA,IAAW,aAAA,EAAe,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM;AAAA;AAChF,WACF;AAAA,UACA,OAAA,EAAS;AAAA,SACX;AAAA,MACF;AAAA,KACF;AAAA,EACF;AACA,EAAA,OAAO,EAAE,MAAA,EAAO;AAClB;AAmBA,eAAsB,eAAA,CACpB,eAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,MAAM,OAAA,GACJ,QAAA,IAAY,eAAA,IAAmB,OAAO,eAAA,CAAgB,MAAA,KAAW,UAAA,GAC5D,eAAA,GAAA,CACA,MAAM,uBAAA,CAAwB,eAAuC,CAAA,EAAG,OAAA;AAC/E,EAAA,MAAM,EAAE,oBAAA,EAAqB,GAAI,MAAM,OAAO,2CAA2C,CAAA;AAEzF,EAAA,MAAM,EAAE,MAAA,EAAO,GAAI,MAAM,wBAAA,CAAyB,SAAS,OAAO,CAAA;AAElE,EAAA,OAAO;AAAA,IACL,MAAA;AAAA,IACA,MAAM,YAAA,GAAe;AACnB,MAAA,MAAM,SAAA,GAAY,IAAI,oBAAA,EAAqB;AAC3C,MAAA,MAAM,MAAA,CAAO,QAAQ,SAAS,CAAA;AAAA,IAChC;AAAA,GACF;AACF;AAgBO,SAAS,8BAAA,CACd,eAAA,EACA,OAAA,GAA4B,EAAC,EACiC;AAC9D,EAAA,IAAI,QAAA,IAAY,eAAA,IAAmB,OAAO,eAAA,CAAgB,WAAW,UAAA,EAAY;AAC/E,IAAA,MAAM,OAAA,GAAU,eAAA;AAChB,IAAA,OAAO,eAAe,qBAAA,CACpB,GAAA,EACA,GAAA,EACA,UAAA,EACe;AACf,MAAA,MAAM,EAAE,6BAAA,EAA8B,GAAI,MAAM,OAAO,oDAAoD,CAAA;AAC3G,MAAA,MAAM,EAAE,MAAA,EAAO,GAAI,MAAM,wBAAA,CAAyB,SAAS,OAAO,CAAA;AAClE,MAAA,MAAM,YAAY,IAAI,6BAAA,CAA8B,EAAE,kBAAA,EAAoB,QAAW,CAAA;AACrF,MAAA,MAAM,MAAA,CAAO,QAAQ,SAAS,CAAA;AAC9B,MAAA,MAAM,UAAU,MAAY;AAC1B,QAAA,SAAA,CAAU,KAAA,EAAM,CAAE,KAAA,CAAM,MAAM;AAAA,QAAC,CAAC,CAAA;AAChC,QAAA,MAAA,CAAO,KAAA,EAAM,CAAE,KAAA,CAAM,MAAM;AAAA,QAAC,CAAC,CAAA;AAC7B,QAAA,GAAA,CAAI,cAAA,CAAe,SAAS,OAAO,CAAA;AACnC,QAAA,GAAA,CAAI,cAAA,CAAe,UAAU,OAAO,CAAA;AAAA,MACtC,CAAA;AACA,MAAA,GAAA,CAAI,IAAA,CAAK,SAAS,OAAO,CAAA;AACzB,MAAA,GAAA,CAAI,IAAA,CAAK,UAAU,OAAO,CAAA;AAC1B,MAAA,MAAM,SAAA,CAAU,aAAA;AAAA,QAChB,GAAA;AAAA,QACA,GAAA;AAAA,QACA;AAAA,OACF;AAAA,IACA,CAAA;AAAA,EACF;AACA,EAAA,OAAA,CAAQ,YAA+C;AACrD,IAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,MAAM,wBAAwB,eAAuC,CAAA;AACzF,IAAA,OAAO,8BAAA,CAA+B,SAAS,OAAO,CAAA;AAAA,EACxD,CAAA,GAAG;AACL;AAyBA,eAAsB,6BAAA,CACpB,eAAA,EACA,OAAA,GAAgD,EAAC,EACT;AACxC,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,MAAA;AAC7B,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,WAAA;AAC7B,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,GAAA;AAC7B,EAAA,MAAM,EAAE,mBAAA,EAAoB,GAAI,MAAM,OAAO,6CAA6C,CAAA;AAC1F,EAAA,MAAM,OAAA,GACJ,QAAA,IAAY,eAAA,IAAmB,OAAO,gBAAgB,MAAA,KAAW,UAAA,GAC7D,8BAAA,CAA+B,eAAA,EAA+B,OAAO,CAAA,GACrE,MAAM,8BAAA,CAA+B,iBAAyC,OAAO,CAAA;AAC3F,EAAA,MAAM,GAAA,GAAM,mBAAA,CAAoB,EAAE,IAAA,EAAM,CAAA;AACxC,EAAA,GAAA,CAAI,IAAA,CAAK,MAAM,OAAO,CAAA;AAEtB,EAAA,OAAO;AAAA,IACL,GAAA;AAAA,IACA,IAAA;AAAA,IACA,MAAM,MAAA,CAAO,UAAA,EAAqB,UAAA,EAA6D;AAC7F,MAAA,MAAM,IAAI,UAAA,IAAc,IAAA;AACxB,MAAA,MAAM,IAAI,UAAA,IAAc,IAAA;AACxB,MAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,QAAA,MAAM,MAAA,GAAU,GAAA,CAEb,MAAA,CAAO,CAAA,EAAG,GAAG,MAAM;AACpB,UAAA,MAAM,IAAA,GAAO,OAAO,OAAA,EAAQ;AAC5B,UAAA,MAAM,UAAA,GACJ,OAAO,IAAA,KAAS,QAAA,IAAY,SAAS,IAAA,IAAQ,MAAA,IAAU,IAAA,GAAO,IAAA,CAAK,IAAA,GAAO,CAAA;AAC5E,UAAA,OAAA,CAAQ,EAAE,GAAA,EAAK,CAAA,OAAA,EAAU,CAAC,CAAA,CAAA,EAAI,UAAU,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,IAAA,EAAM,UAAA,EAAY,CAAA;AAAA,QACvE,CAAC,CAAA;AAAA,MACH,CAAC,CAAA;AAAA,IACH;AAAA,GACF;AACF;AAMA,eAAsB,qBAAA,CACpB,OAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,MAAM,MAAA,GAAS,MAAM,eAAA,CAAgB,OAAA,EAAS,OAAO,CAAA;AACrD,EAAA,MAAM,OAAO,YAAA,EAAa;AAC1B,EAAA,OAAO,MAAA;AACT","file":"chunk-GGKQQR54.js","sourcesContent":["/**\n * Expose tools as OpenAPI (Swagger) spec and optional HTTP server.\n * Same tools can be used via LangChain, MCP, or REST.\n */\n\nimport type { ToolRegistry } from \"../../core/registry/ToolRegistry.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport { enrichSpecWithCanonicalSchema } from \"../../tools/util/canonicalCoreSchemas.js\";\n\nexport interface OpenAPISpecOptions {\n  /** API title (default: \"Tool API\") */\n  title?: string;\n  /** API version (default: \"1.0.0\") */\n  version?: string;\n  /** Base path for the API (default: \"\") */\n  basePath?: string;\n}\n\n/** Tool name to URL path segment: \"core.fs.readText\" -> \"core~fs~readText\" (dots to ~ in path) */\nexport function toolNameToSlug(name: string): string {\n  return name.replace(/\\./g, \"~\");\n}\n\n/** URL path segment back to tool name: \"core~fs~readText\" -> \"core.fs.readText\" */\nexport function slugToToolName(slug: string): string {\n  return slug.replace(/~/g, \".\");\n}\n\n/** Safe schema key for components: \"core.fs.readText\" -> \"Tool_core_fs_readText\" */\nfunction toolSchemaKey(name: string): string {\n  return `Tool_${name.replace(/[^a-zA-Z0-9_]/g, \"_\")}`;\n}\n\nconst resultSchema = {\n  type: \"object\" as const,\n  properties: {\n    result: { description: \"Tool return value\", additionalProperties: true },\n  },\n};\nconst errorSchema = {\n  type: \"object\" as const,\n  properties: {\n    error: { type: \"string\" },\n    kind: { type: \"string\" },\n    details: { type: \"object\", additionalProperties: true },\n  },\n};\n\n/**\n * Build OpenAPI 3.0 document from the tool registry.\n * GET /tools, POST /invoke (generic), and one POST /invoke/{toolSlug} per tool with that tool's input schema.\n */\nexport function toolsToOpenAPISpec(\n  registry: ToolRegistry,\n  options: OpenAPISpecOptions = {}\n): Record<string, unknown> {\n  const title = options.title ?? \"Tool API\";\n  const version = options.version ?? \"1.0.0\";\n  const basePath = (options.basePath ?? \"\").replace(/\\/$/, \"\");\n  const specs = registry.snapshot().map(enrichSpecWithCanonicalSchema);\n\n  const toolNamesSchema = {\n    type: \"object\",\n    required: [\"tools\"],\n    properties: {\n      tools: {\n        type: \"array\",\n        items: {\n          type: \"object\",\n          properties: {\n            name: { type: \"string\" },\n            description: { type: \"string\" },\n            kind: { type: \"string\" },\n          },\n        },\n      },\n    },\n  };\n\n  const invokeRequestBody = {\n    type: \"object\",\n    required: [\"tool\", \"args\"],\n    properties: {\n      tool: { type: \"string\", description: \"Tool name (e.g. from GET /tools)\" },\n      args: {\n        type: \"object\",\n        description: \"Tool arguments (schema per tool; use per-tool paths for typed schema)\",\n        additionalProperties: true,\n      },\n    },\n  };\n\n  const prefix = basePath ? `${basePath}/` : \"/\";\n  const paths: Record<string, unknown> = {\n    [`${prefix}tools`]: {\n      get: {\n        summary: \"List tools\",\n        description: \"Returns all registered tool names and descriptions.\",\n        operationId: \"listTools\",\n        responses: {\n          \"200\": {\n            description: \"List of tools\",\n            content: {\n              \"application/json\": {\n                schema: toolNamesSchema,\n              },\n            },\n          },\n        },\n      },\n    },\n    [`${prefix}invoke`]: {\n      post: {\n        summary: \"Invoke a tool (generic)\",\n        description: \"Call any tool by name with body { tool, args }. For typed schemas use POST /invoke/{toolSlug}.\",\n        operationId: \"invokeTool\",\n        requestBody: {\n          required: true,\n          content: {\n            \"application/json\": {\n              schema: invokeRequestBody,\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"Tool result\",\n            content: { \"application/json\": { schema: resultSchema } },\n          },\n          \"400\": {\n            description: \"Bad request\",\n            content: { \"application/json\": { schema: errorSchema } },\n          },\n        },\n      },\n    },\n  };\n\n  const schemaEntries: [string, object][] = [];\n  for (const s of specs) {\n    const key = toolSchemaKey(s.name);\n    schemaEntries.push([key, s.inputSchema as object]);\n    const slug = toolNameToSlug(s.name);\n    paths[`${prefix}invoke/${slug}`] = {\n      post: {\n        summary: s.description ?? s.name,\n        description: `Invoke tool \\`${s.name}\\`. Request body is the tool's arguments (JSON Schema below).`,\n        operationId: `invoke_${key}`,\n        requestBody: {\n          required: true,\n          content: {\n            \"application/json\": {\n              schema: { $ref: `#/components/schemas/${key}` },\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"Tool result\",\n            content: { \"application/json\": { schema: resultSchema } },\n          },\n          \"400\": {\n            description: \"Bad request (invalid args or tool error)\",\n            content: { \"application/json\": { schema: errorSchema } },\n          },\n        },\n      },\n    };\n  }\n\n  return {\n    openapi: \"3.0.3\",\n    info: { title, version },\n    paths,\n    components: {\n      schemas: Object.fromEntries(schemaEntries),\n    },\n  };\n}\n","/**\n * HTTP server that exposes tools via OpenAPI (Swagger): GET / (Swagger UI), GET /openapi.json, GET /tools, POST /invoke.\n * All invokes go through PTCRuntime.invoke(intent, ctx). Uses Node's built-in http.\n */\n\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { CreateRuntimeOptions } from \"../runtimeFromConfig.js\";\nimport { createRuntimeFromConfig } from \"../runtimeFromConfig.js\";\nimport { toolsToOpenAPISpec, slugToToolName } from \"./openapi.js\";\n\nexport interface OpenAPIHttpServerOptions {\n  /** Port (default: 0 = let OS choose) */\n  port?: number;\n  /** Host (default: \"localhost\") */\n  host?: string;\n  /** Base path for routes (default: \"\") */\n  basePath?: string;\n  /** Build ExecContext for each request (default: minimal ctx) */\n  execContextFactory?: (req: IncomingMessage) => ExecContext;\n}\n\nconst DEFAULT_CTX: ExecContext = {\n  requestId: `http-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\", \"read:fs\", \"write:fs\", \"read:db\", \"write:db\",\n    \"network\", \"workflow\", \"danger:destructive\",\n  ],\n};\n\nfunction parseBody(req: IncomingMessage): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk) => chunks.push(chunk));\n    req.on(\"end\", () => {\n      const raw = Buffer.concat(chunks).toString(\"utf-8\");\n      if (!raw.trim()) {\n        resolve({});\n        return;\n      }\n      try {\n        resolve(JSON.parse(raw) as unknown);\n      } catch {\n        reject(new Error(\"Invalid JSON body\"));\n      }\n    });\n    req.on(\"error\", reject);\n  });\n}\n\nfunction sendJson(res: ServerResponse, status: number, data: unknown): void {\n  res.writeHead(status, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(data));\n}\n\n/** Build HTML for Swagger UI (CDN) pointing at the given spec URL. */\nfunction swaggerUiHtml(specUrl: string): string {\n  const specUrlEscaped = specUrl.replace(/\"/g, \"&quot;\");\n  return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Tool API – Swagger UI</title>\n  <link rel=\"stylesheet\" href=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui.css\">\n</head>\n<body>\n  <div id=\"swagger-ui\"></div>\n  <script src=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js\" crossorigin></script>\n  <script src=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui-standalone-preset.js\" crossorigin></script>\n  <script>\n    window.onload = function() {\n      window.ui = SwaggerUIBundle({\n        url: \"${specUrlEscaped}\",\n        dom_id: \"#swagger-ui\",\n        deepLinking: true,\n        presets: [\n          SwaggerUIBundle.presets.apis,\n          SwaggerUIStandalonePreset\n        ],\n        layout: \"StandaloneLayout\"\n      });\n    };\n  </script>\n</body>\n</html>`;\n}\n\n/**\n * Create an HTTP server that exposes tools via OpenAPI-style routes.\n * - GET / or GET /swagger: Swagger UI (interactive docs)\n * - GET /openapi.json (or basePath/openapi.json): OpenAPI 3.0 spec\n * - GET /tools: list tools\n * - POST /invoke: body { tool, args } -> { result } or { error }\n */\nexport function createOpenAPIHttpServer(\n  runtime: PTCRuntime,\n  options: OpenAPIHttpServerOptions = {}\n): import(\"node:http\").Server {\n  const basePath = (options.basePath ?? \"\").replace(/\\/$/, \"\");\n  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX }));\n\n  const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n    const url = req.url ?? \"/\";\n    const path = url.split(\"?\")[0] ?? \"/\";\n    const norm = basePath ? (path === basePath ? \"\" : path.replace(basePath, \"\") || \"/\") : path;\n\n    try {\n      if (req.method === \"GET\" && (norm === \"/\" || norm === \"/swagger\")) {\n        const specPath = basePath ? `${basePath}/openapi.json` : \"/openapi.json\";\n        const html = swaggerUiHtml(specPath);\n        res.writeHead(200, { \"Content-Type\": \"text/html; charset=utf-8\" });\n        res.end(html);\n        return;\n      }\n\n      if (req.method === \"GET\" && (norm === \"/openapi.json\" || norm === \"/spec\")) {\n        const spec = toolsToOpenAPISpec(runtime.getRegistry(), {\n          title: \"Tool API\",\n          version: \"1.0.0\",\n          basePath: basePath || undefined,\n        });\n        sendJson(res, 200, spec);\n        return;\n      }\n\n      if (req.method === \"GET\" && norm === \"/tools\") {\n        const { enrichSpecWithCanonicalSchema } = await import(\"../../tools/util/canonicalCoreSchemas.js\");\n        const specs = runtime.getRegistry().snapshot().map(enrichSpecWithCanonicalSchema);\n        const tools = specs.map((s) => ({\n          name: s.name,\n          description: s.description,\n          kind: s.kind,\n          inputSchema: s.inputSchema,\n        }));\n        sendJson(res, 200, { tools });\n        return;\n      }\n\n      if (req.method === \"POST\" && norm === \"/invoke\") {\n        const body = (await parseBody(req)) as { tool?: string; args?: unknown };\n        const tool = body?.tool;\n        const args = body?.args ?? {};\n        if (typeof tool !== \"string\" || !tool.trim()) {\n          sendJson(res, 400, { error: \"Missing or invalid 'tool' in body\", kind: \"BAD_REQUEST\" });\n          return;\n        }\n        const ctx = ctxFactory(req);\n        const result = await runtime.invoke(\n          { tool: tool.trim(), args, purpose: \"openapi\" },\n          ctx\n        );\n        if (result.ok) {\n          sendJson(res, 200, { result: result.result });\n          return;\n        }\n        sendJson(res, 400, {\n          error: result.error?.message ?? \"Tool failed\",\n          kind: result.error?.kind,\n          details: result.error?.details,\n        });\n        return;\n      }\n\n      if (req.method === \"POST\" && norm.startsWith(\"/invoke/\") && norm.length > \"/invoke/\".length) {\n        const slug = norm.slice(\"/invoke/\".length);\n        const toolName = slugToToolName(slug);\n        let args: unknown;\n        try {\n          args = await parseBody(req);\n        } catch {\n          sendJson(res, 400, { error: \"Invalid JSON body\", kind: \"BAD_REQUEST\" });\n          return;\n        }\n        const ctx = ctxFactory(req);\n        const result = await runtime.invoke(\n          { tool: toolName, args: args ?? {}, purpose: \"openapi\" },\n          ctx\n        );\n        if (result.ok) {\n          sendJson(res, 200, { result: result.result });\n          return;\n        }\n        sendJson(res, 400, {\n          error: result.error?.message ?? \"Tool failed\",\n          kind: result.error?.kind,\n          details: result.error?.details,\n        });\n        return;\n      }\n\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Not found\", path: norm }));\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      sendJson(res, 500, { error: message, kind: \"INTERNAL_ERROR\" });\n    }\n  });\n\n  return server;\n}\n\n/**\n * Start the OpenAPI HTTP server on the given port/host.\n * Call after createOpenAPIHttpServer if you did not pass port in options.\n */\nexport function listenOpenAPIHttpServer(\n  server: import(\"node:http\").Server,\n  options: { port?: number; host?: string } = {}\n): Promise<{ port: number; host: string }> {\n  return new Promise((resolve, reject) => {\n    const port = options.port ?? 0;\n    const host = options.host ?? \"localhost\";\n    server.listen(port, host, () => {\n      const addr = server.address();\n      const actualPort = typeof addr === \"object\" && addr?.port != null ? addr.port : port;\n      resolve({ port: actualPort, host });\n    });\n    server.on(\"error\", reject);\n  });\n}\n\nexport interface HttpServiceResult {\n  /** Node HTTP server (call .close() when done) */\n  server: import(\"node:http\").Server;\n  /** OpenAPI 3.0 spec document (for Swagger UI etc.) */\n  openApiSpec: Record<string, unknown>;\n  /** Start listening; returns { port, host } */\n  listen: (options?: { port?: number; host?: string }) => Promise<{ port: number; host: string }>;\n}\n\nexport interface CreateHttpServiceOptions extends OpenAPIHttpServerOptions {\n  /** API title for OpenAPI spec (default: \"Tool API\") */\n  title?: string;\n  /** API version for OpenAPI spec (default: \"1.0.0\") */\n  version?: string;\n}\n\n/**\n * Create HTTP service that exposes tools via OpenAPI (Swagger).\n * Returns server, OpenAPI spec, and a listen() helper.\n */\nexport function createHttpService(\n  runtime: PTCRuntime,\n  options?: CreateHttpServiceOptions\n): Promise<HttpServiceResult>;\n\n/**\n * Create HTTP service from config (async: loads tools from projectPath when set).\n */\nexport function createHttpService(\n  config: CreateRuntimeOptions,\n  options?: CreateHttpServiceOptions\n): Promise<HttpServiceResult>;\n\nexport async function createHttpService(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: CreateHttpServiceOptions = {}\n): Promise<HttpServiceResult> {\n  const runtime: PTCRuntime =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? (runtimeOrConfig as PTCRuntime)\n      : (await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions)).runtime;\n  const server = createOpenAPIHttpServer(runtime, options);\n  const openApiSpec = toolsToOpenAPISpec(runtime.getRegistry(), {\n    title: options.title ?? \"Tool API\",\n    version: options.version ?? \"1.0.0\",\n    basePath: options.basePath,\n  });\n  return {\n    server,\n    openApiSpec,\n    listen: (listenOpts) => listenOpenAPIHttpServer(server, listenOpts),\n  };\n}\n","/**\n * Expose tools as an MCP server (stdio or Streamable HTTP). All invokes go through PTCRuntime.invoke(intent, ctx).\n * Requires @modelcontextprotocol/sdk.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport { normalizeToolName } from \"../../core/types/ToolSpec.js\";\nimport type { CreateRuntimeOptions } from \"../runtimeFromConfig.js\";\nimport { createRuntimeFromConfig } from \"../runtimeFromConfig.js\";\nimport { MCP_KIND } from \"../../tools/mcp/types.js\";\n\nexport interface MCPServerOptions {\n  /** Server name (default: \"agent-tool\") */\n  name?: string;\n  /** Server version (default: \"1.0.0\") */\n  version?: string;\n  /** Build ExecContext for each tool call (default: minimal ctx) */\n  execContextFactory?: () => ExecContext;\n}\n\nconst DEFAULT_CTX: ExecContext = {\n  requestId: `mcp-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\", \"read:fs\", \"write:fs\", \"read:db\", \"write:db\",\n    \"network\", \"workflow\", \"danger:destructive\",\n  ],\n};\n\nexport interface MCPServerResult {\n  /** The MCP server instance */\n  server: { connect(transport: unknown): Promise<void>; close?(): Promise<void> };\n  /** Call this to start listening on stdio (for in-process MCP service) */\n  connectStdio: () => Promise<void>;\n}\n\n/** Request handler for Streamable HTTP: (req, res, parsedBody?) => Promise<void>. Use with Express app.post(path, handler) and express.json(). */\nexport type MCPStreamableHttpHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n  parsedBody?: unknown\n) => Promise<void>;\n\nexport interface MCPServerStreamableHttpResult {\n  /** Express app with POST /mcp (or path) wired to Streamable HTTP handler */\n  app: { post: (path: string, handler: MCPStreamableHttpHandler) => void };\n  /** Path mounted (e.g. \"/mcp\") */\n  path: string;\n  /** Start HTTP server; returns when listening. Use createMCPStreamableHttpHandler + your own server if you prefer. */\n  listen: (port?: number, host?: string) => Promise<{ url: string; port: number }>;\n}\n\n/**\n * MCP tool names must match SEP-986: A–Z, a–z, 0–9, underscore, dash, dot only.\n * Use normalized tool name (only [a-zA-Z0-9.]).\n */\nfunction toMcpToolName(registryName: string): string {\n  return normalizeToolName(registryName);\n}\n\n/**\n * Create a configured McpServer with all tools from the given runtime (no transport connected).\n * Used by createMCPServer (stdio) and createMCPStreamableHttpHandler (Streamable HTTP).\n */\nasync function createMcpServerWithTools(\n  runtime: PTCRuntime,\n  options: MCPServerOptions\n): Promise<{ server: InstanceType<Awaited<typeof import(\"@modelcontextprotocol/sdk/server/mcp.js\")>[\"McpServer\"]> }> {\n  const { McpServer } = await import(\"@modelcontextprotocol/sdk/server/mcp.js\");\n  const name = options.name ?? \"agent-tool\";\n  const version = options.version ?? \"1.0.0\";\n  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX }));\n\n  const server = new McpServer({ name, version });\n  const registry = runtime.getRegistry();\n  const specs = registry.snapshot();\n\n  for (const spec of specs) {\n    const mcpName = toMcpToolName(spec.name);\n    server.registerTool(\n      mcpName,\n      {\n        description: spec.description ?? `Tool: ${spec.name}`,\n        inputSchema: spec.inputSchema,\n        _meta: spec._meta,\n      } as Parameters<typeof server.registerTool>[1],\n      async (args: unknown) => {\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(\n          { tool: spec.name, args: args ?? {}, purpose: MCP_KIND },\n          ctx\n        );\n        if (result.ok) {\n          return { content: [{ type: \"text\", text: JSON.stringify(result.result) }] };\n        }\n        const err = result.error;\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify({ error: err?.message ?? \"Tool failed\", kind: err?.kind }),\n            },\n          ],\n          isError: true,\n        };\n      }\n    );\n  }\n  return { server };\n}\n\n/**\n * Create an MCP server that serves all tools from the given PTCRuntime.\n * Register tools with the server; then call connectStdio() to listen on stdio (for Cursor/Claude).\n */\nexport function createMCPServer(\n  runtime: PTCRuntime,\n  options?: MCPServerOptions\n): Promise<MCPServerResult>;\n\n/**\n * Create an MCP server from config (async: loads tools from projectPath when set).\n */\nexport function createMCPServer(\n  config: CreateRuntimeOptions,\n  options?: MCPServerOptions\n): Promise<MCPServerResult>;\n\nexport async function createMCPServer(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: MCPServerOptions = {}\n): Promise<MCPServerResult> {\n  const runtime: PTCRuntime =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? (runtimeOrConfig as PTCRuntime)\n      : (await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions)).runtime;\n  const { StdioServerTransport } = await import(\"@modelcontextprotocol/sdk/server/stdio.js\");\n\n  const { server } = await createMcpServerWithTools(runtime, options);\n\n  return {\n    server,\n    async connectStdio() {\n      const transport = new StdioServerTransport();\n      await server.connect(transport);\n    },\n  };\n}\n\n/**\n * Create a request handler for MCP Streamable HTTP (stateless). Use with Express: app.use(express.json()); app.post(\"/mcp\", handler).\n * Each request gets a new server and transport; supports SSE and direct HTTP responses per MCP Streamable HTTP spec.\n */\nexport function createMCPStreamableHttpHandler(\n  runtime: PTCRuntime,\n  options?: MCPServerOptions\n): MCPStreamableHttpHandler;\n\nexport function createMCPStreamableHttpHandler(\n  config: CreateRuntimeOptions,\n  options?: MCPServerOptions\n): Promise<MCPStreamableHttpHandler>;\n\nexport function createMCPStreamableHttpHandler(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: MCPServerOptions = {}\n): MCPStreamableHttpHandler | Promise<MCPStreamableHttpHandler> {\n  if (\"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\") {\n    const runtime = runtimeOrConfig as PTCRuntime;\n    return async function streamableHttpHandler(\n      req: IncomingMessage,\n      res: ServerResponse,\n      parsedBody?: unknown\n    ): Promise<void> {\n      const { StreamableHTTPServerTransport } = await import(\"@modelcontextprotocol/sdk/server/streamableHttp.js\");\n      const { server } = await createMcpServerWithTools(runtime, options);\n      const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });\n      await server.connect(transport);\n      const onClose = (): void => {\n        transport.close().catch(() => {});\n        server.close().catch(() => {});\n        res.removeListener(\"close\", onClose);\n        res.removeListener(\"finish\", onClose);\n      };\n      res.once(\"close\", onClose);\n      res.once(\"finish\", onClose);\n      await transport.handleRequest(\n      req as IncomingMessage & { auth?: import(\"@modelcontextprotocol/sdk/server/auth/types.js\").AuthInfo },\n      res,\n      parsedBody\n    );\n    };\n  }\n  return (async (): Promise<MCPStreamableHttpHandler> => {\n    const { runtime } = await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions);\n    return createMCPStreamableHttpHandler(runtime, options) as MCPStreamableHttpHandler;\n  })();\n}\n\nexport interface CreateMCPServerStreamableHttpOptions extends MCPServerOptions {\n  /** Path for MCP endpoint (default: \"/mcp\") */\n  path?: string;\n  /** Host to bind (default: \"127.0.0.1\") */\n  host?: string;\n  /** Port (default: 3000) */\n  port?: number;\n}\n\n/**\n * Create an Express app with MCP Streamable HTTP handler mounted at path. Requires @modelcontextprotocol/sdk (which uses express).\n * Returns app and listen(port?, host?) to start the HTTP server.\n */\nexport function createMCPServerStreamableHttp(\n  runtime: PTCRuntime,\n  options?: CreateMCPServerStreamableHttpOptions\n): Promise<MCPServerStreamableHttpResult>;\n\nexport function createMCPServerStreamableHttp(\n  config: CreateRuntimeOptions,\n  options?: CreateMCPServerStreamableHttpOptions\n): Promise<MCPServerStreamableHttpResult>;\n\nexport async function createMCPServerStreamableHttp(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: CreateMCPServerStreamableHttpOptions = {}\n): Promise<MCPServerStreamableHttpResult> {\n  const path = options.path ?? \"/mcp\";\n  const host = options.host ?? \"127.0.0.1\";\n  const port = options.port ?? 3000;\n  const { createMcpExpressApp } = await import(\"@modelcontextprotocol/sdk/server/express.js\");\n  const handler =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? createMCPStreamableHttpHandler(runtimeOrConfig as PTCRuntime, options)\n      : await createMCPStreamableHttpHandler(runtimeOrConfig as CreateRuntimeOptions, options);\n  const app = createMcpExpressApp({ host });\n  app.post(path, handler);\n\n  return {\n    app,\n    path,\n    async listen(listenPort?: number, listenHost?: string): Promise<{ url: string; port: number }> {\n      const p = listenPort ?? port;\n      const h = listenHost ?? host;\n      return new Promise((resolve, reject) => {\n        const server = (app as {\n          listen: (port: number, host: string, cb?: () => void) => import(\"node:http\").Server;\n        }).listen(p, h, () => {\n          const addr = server.address();\n          const actualPort =\n            typeof addr === \"object\" && addr !== null && \"port\" in addr ? addr.port : p;\n          resolve({ url: `http://${h}:${actualPort}${path}`, port: actualPort });\n        });\n      });\n    },\n  };\n}\n\n/**\n * Run MCP server over stdio using the given runtime.\n * Call this when your process should act as an MCP server (e.g. for Cursor/Claude to connect).\n */\nexport async function runMCPServerOverStdio(\n  runtime: PTCRuntime,\n  options: MCPServerOptions = {}\n): Promise<MCPServerResult> {\n  const result = await createMCPServer(runtime, options);\n  await result.connectStdio();\n  return result;\n}\n"]}

package/dist/{chunk-5SWSNVMI.js → chunk-GWBJEGS7.js}

@@ -1,4 +1,8 @@
 // src/core/types/ToolSpec.ts
+function normalizeToolName(name) {
+  if (typeof name !== "string" || !name) return name;
+  return name.replace(/[^a-zA-Z0-9]/g, ".").replace(/\.+/g, ".");
+}
 var DEFAULT_INPUT_SCHEMA = {
   type: "object",
   additionalProperties: true
@@ -9,8 +13,9 @@ var DEFAULT_OUTPUT_SCHEMA = {
 };
 function createToolSpec(opts) {
   const sideEffect = opts.sideEffect ?? "none";
+  const name = normalizeToolName(opts.name);
   return {
-    name: opts.name,
+    name,
     version: opts.version ?? "1.0.0",
     kind: opts.kind,
     description: opts.description,
@@ -23,6 +28,6 @@ function createToolSpec(opts) {
   };
 }
 
-export { DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, createToolSpec };
-//# sourceMappingURL=chunk-5SWSNVMI.js.map
-//# sourceMappingURL=chunk-5SWSNVMI.js.map
+export { DEFAULT_INPUT_SCHEMA, DEFAULT_OUTPUT_SCHEMA, createToolSpec, normalizeToolName };
+//# sourceMappingURL=chunk-GWBJEGS7.js.map
+//# sourceMappingURL=chunk-GWBJEGS7.js.map

package/dist/chunk-GWBJEGS7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types/ToolSpec.ts"],"names":[],"mappings":";AAsFO,SAAS,kBAAkB,IAAA,EAAsB;AACtD,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,CAAC,MAAM,OAAO,IAAA;AAC9C,EAAA,OAAO,KACJ,OAAA,CAAQ,eAAA,EAAiB,GAAG,CAAA,CAC5B,OAAA,CAAQ,QAAQ,GAAG,CAAA;AACxB;AAGO,IAAM,oBAAA,GAA+B;AAAA,EAC1C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AAGO,IAAM,qBAAA,GAAgC;AAAA,EAC3C,IAAA,EAAM,QAAA;AAAA,EACN,oBAAA,EAAsB;AACxB;AA2BO,SAAS,eAAe,IAAA,EAAuC;AACpE,EAAA,MAAM,UAAA,GAAa,KAAK,UAAA,IAAc,MAAA;AACtC,EAAA,MAAM,IAAA,GAAO,iBAAA,CAAkB,IAAA,CAAK,IAAI,CAAA;AACxC,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,OAAA,EAAS,KAAK,OAAA,IAAW,OAAA;AAAA,IACzB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,aAAa,IAAA,CAAK,WAAA;AAAA,IAClB,MAAM,IAAA,CAAK,IAAA;AAAA,IACX,WAAA,EAAa,KAAK,WAAA,IAAe,oBAAA;AAAA,IACjC,YAAA,EAAc,KAAK,YAAA,IAAgB,qBAAA;AAAA,IACnC,cAAc,IAAA,CAAK,YAAA;AAAA,IACnB,WAAW,IAAA,CAAK,SAAA;AAAA,IAChB,KAAA,EAAO,EAAE,IAAA,EAAM,EAAE,YAAW;AAAE,GAChC;AACF","file":"chunk-GWBJEGS7.js","sourcesContent":["/**\n * Unified tool kinds supported by the tools package.\n */\nexport type ToolKind = \"mcp\" | \"langchain\" | \"n8n\" | \"comfyui\" | \"skill\" | \"function\" | \"core\" | \"example\";\n\n/**\n * Capability declarations for tools.\n * Used by PolicyEngine for permission gating.\n */\nexport type Capability =\n  | \"read:web\"\n  | \"read:fs\"\n  | \"write:fs\"\n  | \"read:db\"\n  | \"write:db\"\n  | \"network\"\n  | \"gpu\"\n  | \"workflow\"\n  | \"danger:destructive\"\n  | \"exec\";\n\n/**\n * HITL (Human-in-the-Loop) side-effect classification.\n * Used to gate execution: external_write / destructive require human approval when onApprovalRequired is set.\n */\nexport type HitlSideEffect = \"none\" | \"local_write\" | \"external_write\" | \"destructive\";\n\n/**\n * Cost hints for tools, used by Budget and routing.\n */\nexport interface CostHints {\n  latencyMsP50?: number;\n  latencyMsP95?: number;\n  isAsync?: boolean;\n}\n\n/**\n * Unified tool specification.\n * All tool types (MCP, LangChain, n8n, SKILL) are described by this interface.\n *\n * Safety: each tool declares capabilities (permission gating) and _meta.hitl.sideEffect\n * (HITL approval for external_write/destructive). Caller uses these to decide handling.\n */\nexport interface ToolSpec {\n  /** Globally unique name, recommended format: namespace/name */\n  name: string;\n  /** Semver version */\n  version: string;\n  /** Tool kind determines which adapter handles execution */\n  kind: ToolKind;\n\n  description?: string;\n  tags?: string[];\n\n  /** JSON Schema for input validation */\n  inputSchema: object;\n  /** JSON Schema for output validation */\n  outputSchema: object;\n\n  /** Required capabilities for this tool (safety: PolicyEngine gates by ExecContext.permissions) */\n  capabilities: Capability[];\n  costHints?: CostHints;\n\n  /** HITL and adapter-specific metadata. Adapters may use _meta.sourcePath, _meta.exportName, _meta.projectPath (function), etc. */\n  _meta?: {\n    hitl?: { sideEffect?: HitlSideEffect };\n    /** Function kind: path to source file relative to projectPath */\n    sourcePath?: string;\n    /** Function kind: export name of the handler */\n    exportName?: string;\n    /** Function/skill kind: project root for resolving sourcePath */\n    projectPath?: string;\n  };\n\n  /** Adapter-specific: endpoint URL (MCP/n8n) */\n  endpoint?: string;\n  /** Adapter-specific: resource identifier (workflowId, promptId, etc.) */\n  resourceId?: string;\n  /** Adapter-specific: implementation reference (LangChain Tool instance, skill handler) */\n  impl?: unknown;\n}\n\n/**\n * Normalize tool name: only [a-zA-Z0-9] and \".\" allowed; all other characters become \".\".\n * Consecutive dots are collapsed to one. Used for registry lookup and storage.\n */\nexport function normalizeToolName(name: string): string {\n  if (typeof name !== \"string\" || !name) return name;\n  return name\n    .replace(/[^a-zA-Z0-9]/g, \".\")\n    .replace(/\\.+/g, \".\");\n}\n\n/** Default permissive input schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_INPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/** Default permissive output schema when not provided (framework supports auto-derived schema). */\nexport const DEFAULT_OUTPUT_SCHEMA: object = {\n  type: \"object\",\n  additionalProperties: true,\n};\n\n/**\n * Minimal options to build a ToolSpec. Use with @effect in JSDoc for HITL sideEffect.\n * Framework fills _meta.hitl.sideEffect from the sideEffect parameter (matches @effect annotation).\n * inputSchema/outputSchema are optional: when omitted, permissive defaults are used (framework supports auto-derived schema at build time in scan/mcp-build).\n */\nexport interface CreateToolSpecOptions {\n  name: string;\n  version?: string;\n  kind: ToolKind;\n  description?: string;\n  tags?: string[];\n  /** Optional: when omitted, DEFAULT_INPUT_SCHEMA is used. Codegen can derive from handler params. */\n  inputSchema?: object;\n  /** Optional: when omitted, DEFAULT_OUTPUT_SCHEMA is used. Codegen can derive from handler return type. */\n  outputSchema?: object;\n  capabilities: Capability[];\n  costHints?: CostHints;\n  /** HITL: from @effect annotation (none | local_write | external_write | destructive). Default \"none\". */\n  sideEffect?: HitlSideEffect;\n}\n\n/**\n * Build a ToolSpec from minimal options. Use @effect in handler JSDoc as annotation; pass same value as sideEffect.\n * When inputSchema/outputSchema are omitted, permissive defaults are used (schema can be auto-derived at build time).\n */\nexport function createToolSpec(opts: CreateToolSpecOptions): ToolSpec {\n  const sideEffect = opts.sideEffect ?? \"none\";\n  const name = normalizeToolName(opts.name);\n  return {\n    name,\n    version: opts.version ?? \"1.0.0\",\n    kind: opts.kind,\n    description: opts.description,\n    tags: opts.tags,\n    inputSchema: opts.inputSchema ?? DEFAULT_INPUT_SCHEMA,\n    outputSchema: opts.outputSchema ?? DEFAULT_OUTPUT_SCHEMA,\n    capabilities: opts.capabilities,\n    costHints: opts.costHints,\n    _meta: { hitl: { sideEffect } },\n  };\n}\n\n/**\n * Unified adapter interface.\n * Each tool kind has its own invoke path; PTCRuntime looks up adapter by spec.kind and calls adapter.invoke(spec, args, ctx).\n * Implementations: core/example (extensions), mcp (MCPClientAdapter); function/skill/n8n/langchain in-process adapters TBD (see tools/README and ToolTypeHandler).\n */\nexport interface ToolAdapter {\n  kind: ToolKind;\n  /** Optional: supports dynamic tool discovery */\n  listTools?(): Promise<ToolSpec[]>;\n  /** Execute the tool with validated args */\n  invoke(\n    spec: ToolSpec,\n    args: unknown,\n    ctx: import(\"./ToolIntent.js\").ExecContext,\n  ): Promise<{ result: unknown; raw?: unknown }>;\n}\n"]}

package/dist/{chunk-OXTQULXH.cjs → chunk-H2UMNHDE.cjs}

@@ -1,15 +1,16 @@
 'use strict';
 
-var chunkEMI67SPN_cjs = require('./chunk-EMI67SPN.cjs');
-var chunk6F5JHLZ7_cjs = require('./chunk-6F5JHLZ7.cjs');
+var chunkNNOTTUB2_cjs = require('./chunk-NNOTTUB2.cjs');
+var chunkEAI37B5W_cjs = require('./chunk-EAI37B5W.cjs');
+var chunkFGGTT32N_cjs = require('./chunk-FGGTT32N.cjs');
 var http = require('http');
 
 // src/api/expose/openapi.ts
 function toolNameToSlug(name) {
-  return name.replace(/\//g, "~");
+  return name.replace(/\./g, "~");
 }
 function slugToToolName(slug) {
-  return slug.replace(/~/g, "/");
+  return slug.replace(/~/g, ".");
 }
 function toolSchemaKey(name) {
   return `Tool_${name.replace(/[^a-zA-Z0-9_]/g, "_")}`;
@@ -32,7 +33,7 @@ function toolsToOpenAPISpec(registry, options = {}) {
   const title = options.title ?? "Tool API";
   const version = options.version ?? "1.0.0";
   const basePath = (options.basePath ?? "").replace(/\/$/, "");
-  const specs = registry.snapshot().map(chunk6F5JHLZ7_cjs.enrichSpecWithCanonicalSchema);
+  const specs = registry.snapshot().map(chunkEAI37B5W_cjs.enrichSpecWithCanonicalSchema);
   const toolNamesSchema = {
     type: "object",
     required: ["tools"],
@@ -242,7 +243,7 @@ function createOpenAPIHttpServer(runtime, options = {}) {
         return;
       }
       if (req.method === "GET" && norm === "/tools") {
-        const { enrichSpecWithCanonicalSchema: enrichSpecWithCanonicalSchema2 } = await import('./canonicalCoreSchemas-CTW6CCFY.cjs');
+        const { enrichSpecWithCanonicalSchema: enrichSpecWithCanonicalSchema2 } = await import('./canonicalCoreSchemas-IBTSIPJV.cjs');
         const specs = runtime.getRegistry().snapshot().map(enrichSpecWithCanonicalSchema2);
         const tools = specs.map((s) => ({
           name: s.name,
@@ -325,7 +326,7 @@ function listenOpenAPIHttpServer(server, options = {}) {
   });
 }
 async function createHttpService(runtimeOrConfig, options = {}) {
-  const runtime = "invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function" ? runtimeOrConfig : (await chunkEMI67SPN_cjs.createRuntimeFromConfig(runtimeOrConfig)).runtime;
+  const runtime = "invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function" ? runtimeOrConfig : (await chunkNNOTTUB2_cjs.createRuntimeFromConfig(runtimeOrConfig)).runtime;
   const server = createOpenAPIHttpServer(runtime, options);
   const openApiSpec = toolsToOpenAPISpec(runtime.getRegistry(), {
     title: options.title ?? "Tool API",
@@ -355,7 +356,7 @@ var DEFAULT_CTX2 = {
   ]
 };
 function toMcpToolName(registryName) {
-  return registryName.replace(/\//g, "_");
+  return chunkFGGTT32N_cjs.normalizeToolName(registryName);
 }
 async function createMcpServerWithTools(runtime, options) {
   const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
@@ -377,7 +378,7 @@ async function createMcpServerWithTools(runtime, options) {
       async (args) => {
         const ctx = ctxFactory();
         const result = await runtime.invoke(
-          { tool: spec.name, args: args ?? {}, purpose: chunkEMI67SPN_cjs.MCP_KIND },
+          { tool: spec.name, args: args ?? {}, purpose: chunkNNOTTUB2_cjs.MCP_KIND },
           ctx
         );
         if (result.ok) {
@@ -399,7 +400,7 @@ async function createMcpServerWithTools(runtime, options) {
   return { server };
 }
 async function createMCPServer(runtimeOrConfig, options = {}) {
-  const runtime = "invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function" ? runtimeOrConfig : (await chunkEMI67SPN_cjs.createRuntimeFromConfig(runtimeOrConfig)).runtime;
+  const runtime = "invoke" in runtimeOrConfig && typeof runtimeOrConfig.invoke === "function" ? runtimeOrConfig : (await chunkNNOTTUB2_cjs.createRuntimeFromConfig(runtimeOrConfig)).runtime;
   const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
   const { server } = await createMcpServerWithTools(runtime, options);
   return {
@@ -436,7 +437,7 @@ function createMCPStreamableHttpHandler(runtimeOrConfig, options = {}) {
     };
   }
   return (async () => {
-    const { runtime } = await chunkEMI67SPN_cjs.createRuntimeFromConfig(runtimeOrConfig);
+    const { runtime } = await chunkNNOTTUB2_cjs.createRuntimeFromConfig(runtimeOrConfig);
     return createMCPStreamableHttpHandler(runtime, options);
   })();
 }
@@ -475,5 +476,5 @@ exports.createMCPServer = createMCPServer;
 exports.createMCPServerStreamableHttp = createMCPServerStreamableHttp;
 exports.createMCPStreamableHttpHandler = createMCPStreamableHttpHandler;
 exports.runMCPServerOverStdio = runMCPServerOverStdio;
-//# sourceMappingURL=chunk-OXTQULXH.cjs.map
-//# sourceMappingURL=chunk-OXTQULXH.cjs.map
+//# sourceMappingURL=chunk-H2UMNHDE.cjs.map
+//# sourceMappingURL=chunk-H2UMNHDE.cjs.map

package/dist/chunk-H2UMNHDE.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/expose/openapi.ts","../src/api/expose/openapiHttp.ts","../src/api/expose/mcpServer.ts"],"names":["enrichSpecWithCanonicalSchema","createServer","createRuntimeFromConfig","DEFAULT_CTX","normalizeToolName","MCP_KIND"],"mappings":"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","file":"chunk-H2UMNHDE.cjs","sourcesContent":["/**\n * Expose tools as OpenAPI (Swagger) spec and optional HTTP server.\n * Same tools can be used via LangChain, MCP, or REST.\n */\n\nimport type { ToolRegistry } from \"../../core/registry/ToolRegistry.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport { enrichSpecWithCanonicalSchema } from \"../../tools/util/canonicalCoreSchemas.js\";\n\nexport interface OpenAPISpecOptions {\n  /** API title (default: \"Tool API\") */\n  title?: string;\n  /** API version (default: \"1.0.0\") */\n  version?: string;\n  /** Base path for the API (default: \"\") */\n  basePath?: string;\n}\n\n/** Tool name to URL path segment: \"core.fs.readText\" -> \"core~fs~readText\" (dots to ~ in path) */\nexport function toolNameToSlug(name: string): string {\n  return name.replace(/\\./g, \"~\");\n}\n\n/** URL path segment back to tool name: \"core~fs~readText\" -> \"core.fs.readText\" */\nexport function slugToToolName(slug: string): string {\n  return slug.replace(/~/g, \".\");\n}\n\n/** Safe schema key for components: \"core.fs.readText\" -> \"Tool_core_fs_readText\" */\nfunction toolSchemaKey(name: string): string {\n  return `Tool_${name.replace(/[^a-zA-Z0-9_]/g, \"_\")}`;\n}\n\nconst resultSchema = {\n  type: \"object\" as const,\n  properties: {\n    result: { description: \"Tool return value\", additionalProperties: true },\n  },\n};\nconst errorSchema = {\n  type: \"object\" as const,\n  properties: {\n    error: { type: \"string\" },\n    kind: { type: \"string\" },\n    details: { type: \"object\", additionalProperties: true },\n  },\n};\n\n/**\n * Build OpenAPI 3.0 document from the tool registry.\n * GET /tools, POST /invoke (generic), and one POST /invoke/{toolSlug} per tool with that tool's input schema.\n */\nexport function toolsToOpenAPISpec(\n  registry: ToolRegistry,\n  options: OpenAPISpecOptions = {}\n): Record<string, unknown> {\n  const title = options.title ?? \"Tool API\";\n  const version = options.version ?? \"1.0.0\";\n  const basePath = (options.basePath ?? \"\").replace(/\\/$/, \"\");\n  const specs = registry.snapshot().map(enrichSpecWithCanonicalSchema);\n\n  const toolNamesSchema = {\n    type: \"object\",\n    required: [\"tools\"],\n    properties: {\n      tools: {\n        type: \"array\",\n        items: {\n          type: \"object\",\n          properties: {\n            name: { type: \"string\" },\n            description: { type: \"string\" },\n            kind: { type: \"string\" },\n          },\n        },\n      },\n    },\n  };\n\n  const invokeRequestBody = {\n    type: \"object\",\n    required: [\"tool\", \"args\"],\n    properties: {\n      tool: { type: \"string\", description: \"Tool name (e.g. from GET /tools)\" },\n      args: {\n        type: \"object\",\n        description: \"Tool arguments (schema per tool; use per-tool paths for typed schema)\",\n        additionalProperties: true,\n      },\n    },\n  };\n\n  const prefix = basePath ? `${basePath}/` : \"/\";\n  const paths: Record<string, unknown> = {\n    [`${prefix}tools`]: {\n      get: {\n        summary: \"List tools\",\n        description: \"Returns all registered tool names and descriptions.\",\n        operationId: \"listTools\",\n        responses: {\n          \"200\": {\n            description: \"List of tools\",\n            content: {\n              \"application/json\": {\n                schema: toolNamesSchema,\n              },\n            },\n          },\n        },\n      },\n    },\n    [`${prefix}invoke`]: {\n      post: {\n        summary: \"Invoke a tool (generic)\",\n        description: \"Call any tool by name with body { tool, args }. For typed schemas use POST /invoke/{toolSlug}.\",\n        operationId: \"invokeTool\",\n        requestBody: {\n          required: true,\n          content: {\n            \"application/json\": {\n              schema: invokeRequestBody,\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"Tool result\",\n            content: { \"application/json\": { schema: resultSchema } },\n          },\n          \"400\": {\n            description: \"Bad request\",\n            content: { \"application/json\": { schema: errorSchema } },\n          },\n        },\n      },\n    },\n  };\n\n  const schemaEntries: [string, object][] = [];\n  for (const s of specs) {\n    const key = toolSchemaKey(s.name);\n    schemaEntries.push([key, s.inputSchema as object]);\n    const slug = toolNameToSlug(s.name);\n    paths[`${prefix}invoke/${slug}`] = {\n      post: {\n        summary: s.description ?? s.name,\n        description: `Invoke tool \\`${s.name}\\`. Request body is the tool's arguments (JSON Schema below).`,\n        operationId: `invoke_${key}`,\n        requestBody: {\n          required: true,\n          content: {\n            \"application/json\": {\n              schema: { $ref: `#/components/schemas/${key}` },\n            },\n          },\n        },\n        responses: {\n          \"200\": {\n            description: \"Tool result\",\n            content: { \"application/json\": { schema: resultSchema } },\n          },\n          \"400\": {\n            description: \"Bad request (invalid args or tool error)\",\n            content: { \"application/json\": { schema: errorSchema } },\n          },\n        },\n      },\n    };\n  }\n\n  return {\n    openapi: \"3.0.3\",\n    info: { title, version },\n    paths,\n    components: {\n      schemas: Object.fromEntries(schemaEntries),\n    },\n  };\n}\n","/**\n * HTTP server that exposes tools via OpenAPI (Swagger): GET / (Swagger UI), GET /openapi.json, GET /tools, POST /invoke.\n * All invokes go through PTCRuntime.invoke(intent, ctx). Uses Node's built-in http.\n */\n\nimport { createServer, type IncomingMessage, type ServerResponse } from \"node:http\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { CreateRuntimeOptions } from \"../runtimeFromConfig.js\";\nimport { createRuntimeFromConfig } from \"../runtimeFromConfig.js\";\nimport { toolsToOpenAPISpec, slugToToolName } from \"./openapi.js\";\n\nexport interface OpenAPIHttpServerOptions {\n  /** Port (default: 0 = let OS choose) */\n  port?: number;\n  /** Host (default: \"localhost\") */\n  host?: string;\n  /** Base path for routes (default: \"\") */\n  basePath?: string;\n  /** Build ExecContext for each request (default: minimal ctx) */\n  execContextFactory?: (req: IncomingMessage) => ExecContext;\n}\n\nconst DEFAULT_CTX: ExecContext = {\n  requestId: `http-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\", \"read:fs\", \"write:fs\", \"read:db\", \"write:db\",\n    \"network\", \"workflow\", \"danger:destructive\",\n  ],\n};\n\nfunction parseBody(req: IncomingMessage): Promise<unknown> {\n  return new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    req.on(\"data\", (chunk) => chunks.push(chunk));\n    req.on(\"end\", () => {\n      const raw = Buffer.concat(chunks).toString(\"utf-8\");\n      if (!raw.trim()) {\n        resolve({});\n        return;\n      }\n      try {\n        resolve(JSON.parse(raw) as unknown);\n      } catch {\n        reject(new Error(\"Invalid JSON body\"));\n      }\n    });\n    req.on(\"error\", reject);\n  });\n}\n\nfunction sendJson(res: ServerResponse, status: number, data: unknown): void {\n  res.writeHead(status, { \"Content-Type\": \"application/json\" });\n  res.end(JSON.stringify(data));\n}\n\n/** Build HTML for Swagger UI (CDN) pointing at the given spec URL. */\nfunction swaggerUiHtml(specUrl: string): string {\n  const specUrlEscaped = specUrl.replace(/\"/g, \"&quot;\");\n  return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Tool API – Swagger UI</title>\n  <link rel=\"stylesheet\" href=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui.css\">\n</head>\n<body>\n  <div id=\"swagger-ui\"></div>\n  <script src=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui-bundle.js\" crossorigin></script>\n  <script src=\"https://unpkg.com/swagger-ui-dist@5/swagger-ui-standalone-preset.js\" crossorigin></script>\n  <script>\n    window.onload = function() {\n      window.ui = SwaggerUIBundle({\n        url: \"${specUrlEscaped}\",\n        dom_id: \"#swagger-ui\",\n        deepLinking: true,\n        presets: [\n          SwaggerUIBundle.presets.apis,\n          SwaggerUIStandalonePreset\n        ],\n        layout: \"StandaloneLayout\"\n      });\n    };\n  </script>\n</body>\n</html>`;\n}\n\n/**\n * Create an HTTP server that exposes tools via OpenAPI-style routes.\n * - GET / or GET /swagger: Swagger UI (interactive docs)\n * - GET /openapi.json (or basePath/openapi.json): OpenAPI 3.0 spec\n * - GET /tools: list tools\n * - POST /invoke: body { tool, args } -> { result } or { error }\n */\nexport function createOpenAPIHttpServer(\n  runtime: PTCRuntime,\n  options: OpenAPIHttpServerOptions = {}\n): import(\"node:http\").Server {\n  const basePath = (options.basePath ?? \"\").replace(/\\/$/, \"\");\n  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX }));\n\n  const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {\n    const url = req.url ?? \"/\";\n    const path = url.split(\"?\")[0] ?? \"/\";\n    const norm = basePath ? (path === basePath ? \"\" : path.replace(basePath, \"\") || \"/\") : path;\n\n    try {\n      if (req.method === \"GET\" && (norm === \"/\" || norm === \"/swagger\")) {\n        const specPath = basePath ? `${basePath}/openapi.json` : \"/openapi.json\";\n        const html = swaggerUiHtml(specPath);\n        res.writeHead(200, { \"Content-Type\": \"text/html; charset=utf-8\" });\n        res.end(html);\n        return;\n      }\n\n      if (req.method === \"GET\" && (norm === \"/openapi.json\" || norm === \"/spec\")) {\n        const spec = toolsToOpenAPISpec(runtime.getRegistry(), {\n          title: \"Tool API\",\n          version: \"1.0.0\",\n          basePath: basePath || undefined,\n        });\n        sendJson(res, 200, spec);\n        return;\n      }\n\n      if (req.method === \"GET\" && norm === \"/tools\") {\n        const { enrichSpecWithCanonicalSchema } = await import(\"../../tools/util/canonicalCoreSchemas.js\");\n        const specs = runtime.getRegistry().snapshot().map(enrichSpecWithCanonicalSchema);\n        const tools = specs.map((s) => ({\n          name: s.name,\n          description: s.description,\n          kind: s.kind,\n          inputSchema: s.inputSchema,\n        }));\n        sendJson(res, 200, { tools });\n        return;\n      }\n\n      if (req.method === \"POST\" && norm === \"/invoke\") {\n        const body = (await parseBody(req)) as { tool?: string; args?: unknown };\n        const tool = body?.tool;\n        const args = body?.args ?? {};\n        if (typeof tool !== \"string\" || !tool.trim()) {\n          sendJson(res, 400, { error: \"Missing or invalid 'tool' in body\", kind: \"BAD_REQUEST\" });\n          return;\n        }\n        const ctx = ctxFactory(req);\n        const result = await runtime.invoke(\n          { tool: tool.trim(), args, purpose: \"openapi\" },\n          ctx\n        );\n        if (result.ok) {\n          sendJson(res, 200, { result: result.result });\n          return;\n        }\n        sendJson(res, 400, {\n          error: result.error?.message ?? \"Tool failed\",\n          kind: result.error?.kind,\n          details: result.error?.details,\n        });\n        return;\n      }\n\n      if (req.method === \"POST\" && norm.startsWith(\"/invoke/\") && norm.length > \"/invoke/\".length) {\n        const slug = norm.slice(\"/invoke/\".length);\n        const toolName = slugToToolName(slug);\n        let args: unknown;\n        try {\n          args = await parseBody(req);\n        } catch {\n          sendJson(res, 400, { error: \"Invalid JSON body\", kind: \"BAD_REQUEST\" });\n          return;\n        }\n        const ctx = ctxFactory(req);\n        const result = await runtime.invoke(\n          { tool: toolName, args: args ?? {}, purpose: \"openapi\" },\n          ctx\n        );\n        if (result.ok) {\n          sendJson(res, 200, { result: result.result });\n          return;\n        }\n        sendJson(res, 400, {\n          error: result.error?.message ?? \"Tool failed\",\n          kind: result.error?.kind,\n          details: result.error?.details,\n        });\n        return;\n      }\n\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(JSON.stringify({ error: \"Not found\", path: norm }));\n    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      sendJson(res, 500, { error: message, kind: \"INTERNAL_ERROR\" });\n    }\n  });\n\n  return server;\n}\n\n/**\n * Start the OpenAPI HTTP server on the given port/host.\n * Call after createOpenAPIHttpServer if you did not pass port in options.\n */\nexport function listenOpenAPIHttpServer(\n  server: import(\"node:http\").Server,\n  options: { port?: number; host?: string } = {}\n): Promise<{ port: number; host: string }> {\n  return new Promise((resolve, reject) => {\n    const port = options.port ?? 0;\n    const host = options.host ?? \"localhost\";\n    server.listen(port, host, () => {\n      const addr = server.address();\n      const actualPort = typeof addr === \"object\" && addr?.port != null ? addr.port : port;\n      resolve({ port: actualPort, host });\n    });\n    server.on(\"error\", reject);\n  });\n}\n\nexport interface HttpServiceResult {\n  /** Node HTTP server (call .close() when done) */\n  server: import(\"node:http\").Server;\n  /** OpenAPI 3.0 spec document (for Swagger UI etc.) */\n  openApiSpec: Record<string, unknown>;\n  /** Start listening; returns { port, host } */\n  listen: (options?: { port?: number; host?: string }) => Promise<{ port: number; host: string }>;\n}\n\nexport interface CreateHttpServiceOptions extends OpenAPIHttpServerOptions {\n  /** API title for OpenAPI spec (default: \"Tool API\") */\n  title?: string;\n  /** API version for OpenAPI spec (default: \"1.0.0\") */\n  version?: string;\n}\n\n/**\n * Create HTTP service that exposes tools via OpenAPI (Swagger).\n * Returns server, OpenAPI spec, and a listen() helper.\n */\nexport function createHttpService(\n  runtime: PTCRuntime,\n  options?: CreateHttpServiceOptions\n): Promise<HttpServiceResult>;\n\n/**\n * Create HTTP service from config (async: loads tools from projectPath when set).\n */\nexport function createHttpService(\n  config: CreateRuntimeOptions,\n  options?: CreateHttpServiceOptions\n): Promise<HttpServiceResult>;\n\nexport async function createHttpService(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: CreateHttpServiceOptions = {}\n): Promise<HttpServiceResult> {\n  const runtime: PTCRuntime =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? (runtimeOrConfig as PTCRuntime)\n      : (await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions)).runtime;\n  const server = createOpenAPIHttpServer(runtime, options);\n  const openApiSpec = toolsToOpenAPISpec(runtime.getRegistry(), {\n    title: options.title ?? \"Tool API\",\n    version: options.version ?? \"1.0.0\",\n    basePath: options.basePath,\n  });\n  return {\n    server,\n    openApiSpec,\n    listen: (listenOpts) => listenOpenAPIHttpServer(server, listenOpts),\n  };\n}\n","/**\n * Expose tools as an MCP server (stdio or Streamable HTTP). All invokes go through PTCRuntime.invoke(intent, ctx).\n * Requires @modelcontextprotocol/sdk.\n */\n\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport { normalizeToolName } from \"../../core/types/ToolSpec.js\";\nimport type { CreateRuntimeOptions } from \"../runtimeFromConfig.js\";\nimport { createRuntimeFromConfig } from \"../runtimeFromConfig.js\";\nimport { MCP_KIND } from \"../../tools/mcp/types.js\";\n\nexport interface MCPServerOptions {\n  /** Server name (default: \"agent-tool\") */\n  name?: string;\n  /** Server version (default: \"1.0.0\") */\n  version?: string;\n  /** Build ExecContext for each tool call (default: minimal ctx) */\n  execContextFactory?: () => ExecContext;\n}\n\nconst DEFAULT_CTX: ExecContext = {\n  requestId: `mcp-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\", \"read:fs\", \"write:fs\", \"read:db\", \"write:db\",\n    \"network\", \"workflow\", \"danger:destructive\",\n  ],\n};\n\nexport interface MCPServerResult {\n  /** The MCP server instance */\n  server: { connect(transport: unknown): Promise<void>; close?(): Promise<void> };\n  /** Call this to start listening on stdio (for in-process MCP service) */\n  connectStdio: () => Promise<void>;\n}\n\n/** Request handler for Streamable HTTP: (req, res, parsedBody?) => Promise<void>. Use with Express app.post(path, handler) and express.json(). */\nexport type MCPStreamableHttpHandler = (\n  req: IncomingMessage,\n  res: ServerResponse,\n  parsedBody?: unknown\n) => Promise<void>;\n\nexport interface MCPServerStreamableHttpResult {\n  /** Express app with POST /mcp (or path) wired to Streamable HTTP handler */\n  app: { post: (path: string, handler: MCPStreamableHttpHandler) => void };\n  /** Path mounted (e.g. \"/mcp\") */\n  path: string;\n  /** Start HTTP server; returns when listening. Use createMCPStreamableHttpHandler + your own server if you prefer. */\n  listen: (port?: number, host?: string) => Promise<{ url: string; port: number }>;\n}\n\n/**\n * MCP tool names must match SEP-986: A–Z, a–z, 0–9, underscore, dash, dot only.\n * Use normalized tool name (only [a-zA-Z0-9.]).\n */\nfunction toMcpToolName(registryName: string): string {\n  return normalizeToolName(registryName);\n}\n\n/**\n * Create a configured McpServer with all tools from the given runtime (no transport connected).\n * Used by createMCPServer (stdio) and createMCPStreamableHttpHandler (Streamable HTTP).\n */\nasync function createMcpServerWithTools(\n  runtime: PTCRuntime,\n  options: MCPServerOptions\n): Promise<{ server: InstanceType<Awaited<typeof import(\"@modelcontextprotocol/sdk/server/mcp.js\")>[\"McpServer\"]> }> {\n  const { McpServer } = await import(\"@modelcontextprotocol/sdk/server/mcp.js\");\n  const name = options.name ?? \"agent-tool\";\n  const version = options.version ?? \"1.0.0\";\n  const ctxFactory = options.execContextFactory ?? (() => ({ ...DEFAULT_CTX }));\n\n  const server = new McpServer({ name, version });\n  const registry = runtime.getRegistry();\n  const specs = registry.snapshot();\n\n  for (const spec of specs) {\n    const mcpName = toMcpToolName(spec.name);\n    server.registerTool(\n      mcpName,\n      {\n        description: spec.description ?? `Tool: ${spec.name}`,\n        inputSchema: spec.inputSchema,\n        _meta: spec._meta,\n      } as Parameters<typeof server.registerTool>[1],\n      async (args: unknown) => {\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(\n          { tool: spec.name, args: args ?? {}, purpose: MCP_KIND },\n          ctx\n        );\n        if (result.ok) {\n          return { content: [{ type: \"text\", text: JSON.stringify(result.result) }] };\n        }\n        const err = result.error;\n        return {\n          content: [\n            {\n              type: \"text\",\n              text: JSON.stringify({ error: err?.message ?? \"Tool failed\", kind: err?.kind }),\n            },\n          ],\n          isError: true,\n        };\n      }\n    );\n  }\n  return { server };\n}\n\n/**\n * Create an MCP server that serves all tools from the given PTCRuntime.\n * Register tools with the server; then call connectStdio() to listen on stdio (for Cursor/Claude).\n */\nexport function createMCPServer(\n  runtime: PTCRuntime,\n  options?: MCPServerOptions\n): Promise<MCPServerResult>;\n\n/**\n * Create an MCP server from config (async: loads tools from projectPath when set).\n */\nexport function createMCPServer(\n  config: CreateRuntimeOptions,\n  options?: MCPServerOptions\n): Promise<MCPServerResult>;\n\nexport async function createMCPServer(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: MCPServerOptions = {}\n): Promise<MCPServerResult> {\n  const runtime: PTCRuntime =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? (runtimeOrConfig as PTCRuntime)\n      : (await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions)).runtime;\n  const { StdioServerTransport } = await import(\"@modelcontextprotocol/sdk/server/stdio.js\");\n\n  const { server } = await createMcpServerWithTools(runtime, options);\n\n  return {\n    server,\n    async connectStdio() {\n      const transport = new StdioServerTransport();\n      await server.connect(transport);\n    },\n  };\n}\n\n/**\n * Create a request handler for MCP Streamable HTTP (stateless). Use with Express: app.use(express.json()); app.post(\"/mcp\", handler).\n * Each request gets a new server and transport; supports SSE and direct HTTP responses per MCP Streamable HTTP spec.\n */\nexport function createMCPStreamableHttpHandler(\n  runtime: PTCRuntime,\n  options?: MCPServerOptions\n): MCPStreamableHttpHandler;\n\nexport function createMCPStreamableHttpHandler(\n  config: CreateRuntimeOptions,\n  options?: MCPServerOptions\n): Promise<MCPStreamableHttpHandler>;\n\nexport function createMCPStreamableHttpHandler(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: MCPServerOptions = {}\n): MCPStreamableHttpHandler | Promise<MCPStreamableHttpHandler> {\n  if (\"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\") {\n    const runtime = runtimeOrConfig as PTCRuntime;\n    return async function streamableHttpHandler(\n      req: IncomingMessage,\n      res: ServerResponse,\n      parsedBody?: unknown\n    ): Promise<void> {\n      const { StreamableHTTPServerTransport } = await import(\"@modelcontextprotocol/sdk/server/streamableHttp.js\");\n      const { server } = await createMcpServerWithTools(runtime, options);\n      const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });\n      await server.connect(transport);\n      const onClose = (): void => {\n        transport.close().catch(() => {});\n        server.close().catch(() => {});\n        res.removeListener(\"close\", onClose);\n        res.removeListener(\"finish\", onClose);\n      };\n      res.once(\"close\", onClose);\n      res.once(\"finish\", onClose);\n      await transport.handleRequest(\n      req as IncomingMessage & { auth?: import(\"@modelcontextprotocol/sdk/server/auth/types.js\").AuthInfo },\n      res,\n      parsedBody\n    );\n    };\n  }\n  return (async (): Promise<MCPStreamableHttpHandler> => {\n    const { runtime } = await createRuntimeFromConfig(runtimeOrConfig as CreateRuntimeOptions);\n    return createMCPStreamableHttpHandler(runtime, options) as MCPStreamableHttpHandler;\n  })();\n}\n\nexport interface CreateMCPServerStreamableHttpOptions extends MCPServerOptions {\n  /** Path for MCP endpoint (default: \"/mcp\") */\n  path?: string;\n  /** Host to bind (default: \"127.0.0.1\") */\n  host?: string;\n  /** Port (default: 3000) */\n  port?: number;\n}\n\n/**\n * Create an Express app with MCP Streamable HTTP handler mounted at path. Requires @modelcontextprotocol/sdk (which uses express).\n * Returns app and listen(port?, host?) to start the HTTP server.\n */\nexport function createMCPServerStreamableHttp(\n  runtime: PTCRuntime,\n  options?: CreateMCPServerStreamableHttpOptions\n): Promise<MCPServerStreamableHttpResult>;\n\nexport function createMCPServerStreamableHttp(\n  config: CreateRuntimeOptions,\n  options?: CreateMCPServerStreamableHttpOptions\n): Promise<MCPServerStreamableHttpResult>;\n\nexport async function createMCPServerStreamableHttp(\n  runtimeOrConfig: PTCRuntime | CreateRuntimeOptions,\n  options: CreateMCPServerStreamableHttpOptions = {}\n): Promise<MCPServerStreamableHttpResult> {\n  const path = options.path ?? \"/mcp\";\n  const host = options.host ?? \"127.0.0.1\";\n  const port = options.port ?? 3000;\n  const { createMcpExpressApp } = await import(\"@modelcontextprotocol/sdk/server/express.js\");\n  const handler =\n    \"invoke\" in runtimeOrConfig && typeof runtimeOrConfig.invoke === \"function\"\n      ? createMCPStreamableHttpHandler(runtimeOrConfig as PTCRuntime, options)\n      : await createMCPStreamableHttpHandler(runtimeOrConfig as CreateRuntimeOptions, options);\n  const app = createMcpExpressApp({ host });\n  app.post(path, handler);\n\n  return {\n    app,\n    path,\n    async listen(listenPort?: number, listenHost?: string): Promise<{ url: string; port: number }> {\n      const p = listenPort ?? port;\n      const h = listenHost ?? host;\n      return new Promise((resolve, reject) => {\n        const server = (app as {\n          listen: (port: number, host: string, cb?: () => void) => import(\"node:http\").Server;\n        }).listen(p, h, () => {\n          const addr = server.address();\n          const actualPort =\n            typeof addr === \"object\" && addr !== null && \"port\" in addr ? addr.port : p;\n          resolve({ url: `http://${h}:${actualPort}${path}`, port: actualPort });\n        });\n      });\n    },\n  };\n}\n\n/**\n * Run MCP server over stdio using the given runtime.\n * Call this when your process should act as an MCP server (e.g. for Cursor/Claude to connect).\n */\nexport async function runMCPServerOverStdio(\n  runtime: PTCRuntime,\n  options: MCPServerOptions = {}\n): Promise<MCPServerResult> {\n  const result = await createMCPServer(runtime, options);\n  await result.connectStdio();\n  return result;\n}\n"]}

package/dist/{chunk-ZIFQWIN3.cjs → chunk-HISF2FEL.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkEMI67SPN_cjs = require('./chunk-EMI67SPN.cjs');
+var chunkNNOTTUB2_cjs = require('./chunk-NNOTTUB2.cjs');
 var tools = require('@langchain/core/tools');
 
 var DEFAULT_CTX_FACTORY = () => ({
@@ -51,7 +51,7 @@ var LangChainToolsHub = class {
         const intent = {
           tool: spec.name,
           args: args ?? {},
-          purpose: chunkEMI67SPN_cjs.LANGCHAIN_KIND
+          purpose: chunkNNOTTUB2_cjs.LANGCHAIN_KIND
         };
         const ctx = ctxFactory();
         const result = await runtime.invoke(intent, ctx);
@@ -86,10 +86,10 @@ function mergeHostLists(a, b) {
 function runtimeOptionsFromConfig(opts) {
   const coreTools = opts.coreTools ?? { sandboxRoot: process.cwd(), allowedHosts: [] };
   if (opts.configFilePath) {
-    const toolConfig = chunkEMI67SPN_cjs.loadToolConfig(opts.configFilePath);
+    const toolConfig = chunkNNOTTUB2_cjs.loadToolConfig(opts.configFilePath);
     const updates = {};
     if (toolConfig.sandboxedPath && typeof toolConfig.sandboxedPath === "string") {
-      updates.sandboxRoot = chunkEMI67SPN_cjs.resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);
+      updates.sandboxRoot = chunkNNOTTUB2_cjs.resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);
     }
     updates.allowedHosts = mergeHostLists(coreTools.allowedHosts, toolConfig.allowedHosts);
     updates.blockedHosts = mergeHostLists(coreTools.blockedHosts, toolConfig.blockedHosts);
@@ -107,21 +107,21 @@ function runtimeOptionsFromConfig(opts) {
 function createAgentTools(options) {
   const opts = typeof options === "string" ? { configFilePath: options } : options ?? {};
   const runtimeOpts = runtimeOptionsFromConfig(opts);
-  const { runtime } = chunkEMI67SPN_cjs.createRuntimeFromConfigSync(runtimeOpts);
+  const { runtime } = chunkNNOTTUB2_cjs.createRuntimeFromConfigSync(runtimeOpts);
   const hub = new LangChainToolsHub(runtime);
   if (opts.configFilePath) {
-    const toolConfig = chunkEMI67SPN_cjs.loadToolConfig(opts.configFilePath);
+    const toolConfig = chunkNNOTTUB2_cjs.loadToolConfig(opts.configFilePath);
     const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];
     if (names.length > 0) {
       const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);
-      const allBareBuiltin = names.every((n) => chunkEMI67SPN_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
-        const p = chunkEMI67SPN_cjs.parseNpmDescriptor(String(n));
-        return p !== null && chunkEMI67SPN_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
+      const allBareBuiltin = names.every((n) => chunkNNOTTUB2_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
+        const p = chunkNNOTTUB2_cjs.parseNpmDescriptor(String(n));
+        return p !== null && chunkNNOTTUB2_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
       });
       if (allBareBuiltin) {
         return hub.getLangChainTools();
       }
-      const expanded = chunkEMI67SPN_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
+      const expanded = chunkNNOTTUB2_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
       return hub.getLangChainToolsForNames(expanded);
     }
   }
@@ -129,21 +129,21 @@ function createAgentTools(options) {
 }
 async function createLangChainToolsAsync(options = {}) {
   const runtimeOpts = runtimeOptionsFromConfig(options);
-  const { runtime } = await chunkEMI67SPN_cjs.createRuntimeFromConfig(runtimeOpts);
+  const { runtime } = await chunkNNOTTUB2_cjs.createRuntimeFromConfig(runtimeOpts);
   const hub = new LangChainToolsHub(runtime);
   if (options.configFilePath) {
-    const toolConfig = chunkEMI67SPN_cjs.loadToolConfig(options.configFilePath);
+    const toolConfig = chunkNNOTTUB2_cjs.loadToolConfig(options.configFilePath);
     const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];
     if (names.length > 0) {
       const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);
-      const allBareBuiltin = names.every((n) => chunkEMI67SPN_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
-        const p = chunkEMI67SPN_cjs.parseNpmDescriptor(String(n));
-        return p !== null && chunkEMI67SPN_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
+      const allBareBuiltin = names.every((n) => chunkNNOTTUB2_cjs.isBarePackageDescriptor(String(n))) && names.some((n) => {
+        const p = chunkNNOTTUB2_cjs.parseNpmDescriptor(String(n));
+        return p !== null && chunkNNOTTUB2_cjs.BUILTIN_PKG_NAMES.includes(p.packageName);
       });
       if (allBareBuiltin) {
         return hub.getLangChainTools();
       }
-      const expanded = chunkEMI67SPN_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
+      const expanded = chunkNNOTTUB2_cjs.expandToolDescriptorsToRegistryNames(names, registryNames);
       return hub.getLangChainToolsForNames(expanded);
     }
   }
@@ -153,5 +153,5 @@ async function createLangChainToolsAsync(options = {}) {
 exports.LangChainToolsHub = LangChainToolsHub;
 exports.createAgentTools = createAgentTools;
 exports.createLangChainToolsAsync = createLangChainToolsAsync;
-//# sourceMappingURL=chunk-ZIFQWIN3.cjs.map
-//# sourceMappingURL=chunk-ZIFQWIN3.cjs.map
+//# sourceMappingURL=chunk-HISF2FEL.cjs.map
+//# sourceMappingURL=chunk-HISF2FEL.cjs.map

package/dist/{chunk-ZIFQWIN3.cjs.map → chunk-HISF2FEL.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/api/adapters/LangChainToolsHub.ts","../src/api/createAgentTools.ts"],"names":["DynamicStructuredTool","LANGCHAIN_KIND","loadToolConfig","resolveSandboxedPath","createRuntimeFromConfigSync","isBarePackageDescriptor","parseNpmDescriptor","BUILTIN_PKG_NAMES","expandToolDescriptorsToRegistryNames","createRuntimeFromConfig"],"mappings":"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","file":"chunk-ZIFQWIN3.cjs","sourcesContent":["/**\n * Exposes all tools from a ToolRegistry + PTCRuntime as LangChain tools\n * for local agent use (e.g. with createReactAgent, AgentExecutor).\n *\n * For most users, use createAgentTools() which loads from tools.yaml and returns\n * StructuredTool[]. Use LangChainToolsHub when you need a custom runtime or ctxFactory.\n *\n * Use: new LangChainToolsHub(runtime, ctxFactory).getLangChainTools()\n */\n\nimport { DynamicStructuredTool, type StructuredToolInterface } from \"@langchain/core/tools\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { ToolIntent } from \"../../core/types/ToolIntent.js\";\nimport { LANGCHAIN_KIND } from \"../../tools/langchain/types.js\";\n\nexport type ExecContextFactory = () => ExecContext;\n\nconst DEFAULT_CTX_FACTORY: ExecContextFactory = () => ({\n  requestId: `lc-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\",\n    \"read:fs\",\n    \"write:fs\",\n    \"read:db\",\n    \"write:db\",\n    \"network\",\n    \"workflow\",\n    \"danger:destructive\",\n  ],\n});\n\n/**\n * Hub that wraps PTCRuntime and exposes every registered tool as a LangChain\n * StructuredTool (DynamicStructuredTool), so local agents (LangChain AgentExecutor,\n * createReactAgent, etc.) can use the same tools as MCP and OpenAPI.\n */\nexport class LangChainToolsHub {\n  constructor(\n    private readonly runtime: PTCRuntime,\n    private readonly ctxFactory: ExecContextFactory = DEFAULT_CTX_FACTORY,\n  ) {}\n\n  /**\n   * Returns all registered tools as LangChain StructuredTool[].\n   * Each tool invokes the runtime through the full pipeline (policy, HITL, etc.).\n   */\n  getLangChainTools(): StructuredToolInterface[] {\n    const registry = this.runtime.getRegistry();\n    const specs = registry.snapshot();\n\n    return specs.map((spec) => this.specToLangChainTool(spec));\n  }\n\n  /**\n   * Returns LangChain tools for a subset of tools (by name or query).\n   */\n  getLangChainToolsForNames(toolNames: string[]): StructuredToolInterface[] {\n    const registry = this.runtime.getRegistry();\n    const set = new Set(toolNames);\n    const specs = registry.snapshot().filter((s) => set.has(s.name));\n    return specs.map((spec) => this.specToLangChainTool(spec));\n  }\n\n  private specToLangChainTool(spec: ToolSpec): DynamicStructuredTool {\n    const runtime = this.runtime;\n    const ctxFactory = this.ctxFactory;\n\n    return new DynamicStructuredTool({\n      name: spec.name,\n      description: spec.description ?? `Tool: ${spec.name}`,\n      schema: spec.inputSchema as Record<string, unknown>,\n      func: async (args: Record<string, unknown>): Promise<string> => {\n        const intent: ToolIntent = {\n          tool: spec.name,\n          args: args ?? {},\n          purpose: LANGCHAIN_KIND,\n        };\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(intent, ctx);\n\n        if (result.ok) {\n          return typeof result.result === \"string\"\n            ? result.result\n            : JSON.stringify(result.result);\n        }\n\n        const err = result.error;\n        const message = err?.message ?? \"Tool failed\";\n        const details = err?.details;\n        return JSON.stringify(\n          details != null ? { error: message, details } : { error: message },\n        );\n      },\n    });\n  }\n}\n","/**\n * Create LangChain tools from config (sync or async). Uses PTCRuntime + registry\n * and exposes tools via LangChainToolsHub. All invokes go through PTC Intent.\n */\n\nimport { loadToolConfig, resolveSandboxedPath } from \"../tools/util/toolConfig.js\";\nimport {\n  expandToolDescriptorsToRegistryNames,\n  isBarePackageDescriptor,\n} from \"../tools/util/toolDescriptor.js\";\nimport {\n  createRuntimeFromConfigSync,\n  createRuntimeFromConfig,\n  BUILTIN_PKG_NAMES,\n  parseNpmDescriptor,\n} from \"./runtimeFromConfig.js\";\nimport type { CreateRuntimeOptions } from \"./runtimeFromConfig.js\";\nimport { LangChainToolsHub } from \"./adapters/LangChainToolsHub.js\";\nimport type { StructuredToolInterface } from \"@langchain/core/tools\";\n\nexport interface CreateAgentToolsOptions extends CreateRuntimeOptions {\n  /** Path to tool.yaml; when set, only tools listed there are returned; sandboxedPath from it is used as sandboxRoot */\n  configFilePath?: string;\n  /** Project path for async loading (use createLangChainToolsAsync) */\n  projectPath?: string;\n}\n\n/** Merge host lists from multiple sources (e.g. tool.yaml + programmatic). Union, dedup, preserves order. */\nfunction mergeHostLists(a?: string[], b?: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const list of [a ?? [], b ?? []]) {\n    for (const h of list) {\n      if (!seen.has(h)) {\n        seen.add(h);\n        out.push(h);\n      }\n    }\n  }\n  return out;\n}\n\nfunction runtimeOptionsFromConfig(opts: CreateAgentToolsOptions): CreateRuntimeOptions {\n  const coreTools = opts.coreTools ?? { sandboxRoot: process.cwd(), allowedHosts: [] };\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    const updates: {\n      sandboxRoot?: string;\n      allowedHosts?: string[];\n      blockedHosts?: string[];\n      blockedCidrs?: string[];\n    } = {};\n    if (toolConfig.sandboxedPath && typeof toolConfig.sandboxedPath === \"string\") {\n      updates.sandboxRoot = resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);\n    }\n    // Smart merge: union of allowedHosts and blockedHosts from yaml + programmatic (both lists always applied)\n    updates.allowedHosts = mergeHostLists(coreTools.allowedHosts, toolConfig.allowedHosts);\n    updates.blockedHosts = mergeHostLists(coreTools.blockedHosts, toolConfig.blockedHosts);\n    if (Array.isArray(toolConfig.blockedCidrs) && toolConfig.blockedCidrs.length > 0) {\n      updates.blockedCidrs = toolConfig.blockedCidrs;\n    } else if (coreTools.blockedCidrs?.length) {\n      updates.blockedCidrs = coreTools.blockedCidrs;\n    }\n    if (Object.keys(updates).length > 0) {\n      return { ...opts, coreTools: { ...coreTools, ...updates } };\n    }\n  }\n  return { ...opts, coreTools };\n}\n\n/**\n * Create LangChain tools synchronously. When configFilePath is set, returns only\n * tools listed in that file (and that exist in the registry). If tool.yaml has\n * sandboxedPath, fs tools can only access that directory.\n */\nexport function createAgentTools(\n  options?: CreateAgentToolsOptions | string\n): StructuredToolInterface[] {\n  const opts: CreateAgentToolsOptions =\n    typeof options === \"string\" ? { configFilePath: options } : options ?? {};\n  const runtimeOpts = runtimeOptionsFromConfig(opts);\n  const { runtime } = createRuntimeFromConfigSync(runtimeOpts);\n  const hub = new LangChainToolsHub(runtime);\n\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];\n    if (names.length > 0) {\n      const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);\n      const allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\n        return hub.getLangChainTools();\n      }\n      const expanded = expandToolDescriptorsToRegistryNames(names, registryNames);\n      return hub.getLangChainToolsForNames(expanded);\n    }\n  }\n\n  return hub.getLangChainTools();\n}\n\n/**\n * Create LangChain tools asynchronously. Use when projectPath is set to load\n * tools from the project before building the tool list.\n */\nexport async function createLangChainToolsAsync(\n  options: CreateAgentToolsOptions = {}\n): Promise<StructuredToolInterface[]> {\n  const runtimeOpts = runtimeOptionsFromConfig(options);\n  const { runtime } = await createRuntimeFromConfig(runtimeOpts);\n  const hub = new LangChainToolsHub(runtime);\n\n  if (options.configFilePath) {\n    const toolConfig = loadToolConfig(options.configFilePath);\n    const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];\n    if (names.length > 0) {\n      const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);\n      const allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\n        return hub.getLangChainTools();\n      }\n      const expanded = expandToolDescriptorsToRegistryNames(names, registryNames);\n      return hub.getLangChainToolsForNames(expanded);\n    }\n  }\n\n  return hub.getLangChainTools();\n}\n"]}
+{"version":3,"sources":["../src/api/adapters/LangChainToolsHub.ts","../src/api/createAgentTools.ts"],"names":["DynamicStructuredTool","LANGCHAIN_KIND","loadToolConfig","resolveSandboxedPath","createRuntimeFromConfigSync","isBarePackageDescriptor","parseNpmDescriptor","BUILTIN_PKG_NAMES","expandToolDescriptorsToRegistryNames","createRuntimeFromConfig"],"mappings":"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","file":"chunk-HISF2FEL.cjs","sourcesContent":["/**\n * Exposes all tools from a ToolRegistry + PTCRuntime as LangChain tools\n * for local agent use (e.g. with createReactAgent, AgentExecutor).\n *\n * For most users, use createAgentTools() which loads from tools.yaml and returns\n * StructuredTool[]. Use LangChainToolsHub when you need a custom runtime or ctxFactory.\n *\n * Use: new LangChainToolsHub(runtime, ctxFactory).getLangChainTools()\n */\n\nimport { DynamicStructuredTool, type StructuredToolInterface } from \"@langchain/core/tools\";\nimport type { PTCRuntime } from \"../../core/runtime/PTCRuntime.js\";\nimport type { ToolSpec } from \"../../core/types/ToolSpec.js\";\nimport type { ExecContext } from \"../../core/types/ToolIntent.js\";\nimport type { ToolIntent } from \"../../core/types/ToolIntent.js\";\nimport { LANGCHAIN_KIND } from \"../../tools/langchain/types.js\";\n\nexport type ExecContextFactory = () => ExecContext;\n\nconst DEFAULT_CTX_FACTORY: ExecContextFactory = () => ({\n  requestId: `lc-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`,\n  taskId: `task-${Date.now()}`,\n  permissions: [\n    \"read:web\",\n    \"read:fs\",\n    \"write:fs\",\n    \"read:db\",\n    \"write:db\",\n    \"network\",\n    \"workflow\",\n    \"danger:destructive\",\n  ],\n});\n\n/**\n * Hub that wraps PTCRuntime and exposes every registered tool as a LangChain\n * StructuredTool (DynamicStructuredTool), so local agents (LangChain AgentExecutor,\n * createReactAgent, etc.) can use the same tools as MCP and OpenAPI.\n */\nexport class LangChainToolsHub {\n  constructor(\n    private readonly runtime: PTCRuntime,\n    private readonly ctxFactory: ExecContextFactory = DEFAULT_CTX_FACTORY,\n  ) {}\n\n  /**\n   * Returns all registered tools as LangChain StructuredTool[].\n   * Each tool invokes the runtime through the full pipeline (policy, HITL, etc.).\n   */\n  getLangChainTools(): StructuredToolInterface[] {\n    const registry = this.runtime.getRegistry();\n    const specs = registry.snapshot();\n\n    return specs.map((spec) => this.specToLangChainTool(spec));\n  }\n\n  /**\n   * Returns LangChain tools for a subset of tools (by name or query).\n   */\n  getLangChainToolsForNames(toolNames: string[]): StructuredToolInterface[] {\n    const registry = this.runtime.getRegistry();\n    const set = new Set(toolNames);\n    const specs = registry.snapshot().filter((s) => set.has(s.name));\n    return specs.map((spec) => this.specToLangChainTool(spec));\n  }\n\n  private specToLangChainTool(spec: ToolSpec): DynamicStructuredTool {\n    const runtime = this.runtime;\n    const ctxFactory = this.ctxFactory;\n\n    return new DynamicStructuredTool({\n      name: spec.name,\n      description: spec.description ?? `Tool: ${spec.name}`,\n      schema: spec.inputSchema as Record<string, unknown>,\n      func: async (args: Record<string, unknown>): Promise<string> => {\n        const intent: ToolIntent = {\n          tool: spec.name,\n          args: args ?? {},\n          purpose: LANGCHAIN_KIND,\n        };\n        const ctx = ctxFactory();\n        const result = await runtime.invoke(intent, ctx);\n\n        if (result.ok) {\n          return typeof result.result === \"string\"\n            ? result.result\n            : JSON.stringify(result.result);\n        }\n\n        const err = result.error;\n        const message = err?.message ?? \"Tool failed\";\n        const details = err?.details;\n        return JSON.stringify(\n          details != null ? { error: message, details } : { error: message },\n        );\n      },\n    });\n  }\n}\n","/**\n * Create LangChain tools from config (sync or async). Uses PTCRuntime + registry\n * and exposes tools via LangChainToolsHub. All invokes go through PTC Intent.\n */\n\nimport { loadToolConfig, resolveSandboxedPath } from \"../tools/util/toolConfig.js\";\nimport {\n  expandToolDescriptorsToRegistryNames,\n  isBarePackageDescriptor,\n} from \"../tools/util/toolDescriptor.js\";\nimport {\n  createRuntimeFromConfigSync,\n  createRuntimeFromConfig,\n  BUILTIN_PKG_NAMES,\n  parseNpmDescriptor,\n} from \"./runtimeFromConfig.js\";\nimport type { CreateRuntimeOptions } from \"./runtimeFromConfig.js\";\nimport { LangChainToolsHub } from \"./adapters/LangChainToolsHub.js\";\nimport type { StructuredToolInterface } from \"@langchain/core/tools\";\n\nexport interface CreateAgentToolsOptions extends CreateRuntimeOptions {\n  /** Path to tool.yaml; when set, only tools listed there are returned; sandboxedPath from it is used as sandboxRoot */\n  configFilePath?: string;\n  /** Project path for async loading (use createLangChainToolsAsync) */\n  projectPath?: string;\n}\n\n/** Merge host lists from multiple sources (e.g. tool.yaml + programmatic). Union, dedup, preserves order. */\nfunction mergeHostLists(a?: string[], b?: string[]): string[] {\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const list of [a ?? [], b ?? []]) {\n    for (const h of list) {\n      if (!seen.has(h)) {\n        seen.add(h);\n        out.push(h);\n      }\n    }\n  }\n  return out;\n}\n\nfunction runtimeOptionsFromConfig(opts: CreateAgentToolsOptions): CreateRuntimeOptions {\n  const coreTools = opts.coreTools ?? { sandboxRoot: process.cwd(), allowedHosts: [] };\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    const updates: {\n      sandboxRoot?: string;\n      allowedHosts?: string[];\n      blockedHosts?: string[];\n      blockedCidrs?: string[];\n    } = {};\n    if (toolConfig.sandboxedPath && typeof toolConfig.sandboxedPath === \"string\") {\n      updates.sandboxRoot = resolveSandboxedPath(opts.configFilePath, toolConfig.sandboxedPath);\n    }\n    // Smart merge: union of allowedHosts and blockedHosts from yaml + programmatic (both lists always applied)\n    updates.allowedHosts = mergeHostLists(coreTools.allowedHosts, toolConfig.allowedHosts);\n    updates.blockedHosts = mergeHostLists(coreTools.blockedHosts, toolConfig.blockedHosts);\n    if (Array.isArray(toolConfig.blockedCidrs) && toolConfig.blockedCidrs.length > 0) {\n      updates.blockedCidrs = toolConfig.blockedCidrs;\n    } else if (coreTools.blockedCidrs?.length) {\n      updates.blockedCidrs = coreTools.blockedCidrs;\n    }\n    if (Object.keys(updates).length > 0) {\n      return { ...opts, coreTools: { ...coreTools, ...updates } };\n    }\n  }\n  return { ...opts, coreTools };\n}\n\n/**\n * Create LangChain tools synchronously. When configFilePath is set, returns only\n * tools listed in that file (and that exist in the registry). If tool.yaml has\n * sandboxedPath, fs tools can only access that directory.\n */\nexport function createAgentTools(\n  options?: CreateAgentToolsOptions | string\n): StructuredToolInterface[] {\n  const opts: CreateAgentToolsOptions =\n    typeof options === \"string\" ? { configFilePath: options } : options ?? {};\n  const runtimeOpts = runtimeOptionsFromConfig(opts);\n  const { runtime } = createRuntimeFromConfigSync(runtimeOpts);\n  const hub = new LangChainToolsHub(runtime);\n\n  if (opts.configFilePath) {\n    const toolConfig = loadToolConfig(opts.configFilePath);\n    const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];\n    if (names.length > 0) {\n      const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);\n      const allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\n        return hub.getLangChainTools();\n      }\n      const expanded = expandToolDescriptorsToRegistryNames(names, registryNames);\n      return hub.getLangChainToolsForNames(expanded);\n    }\n  }\n\n  return hub.getLangChainTools();\n}\n\n/**\n * Create LangChain tools asynchronously. Use when projectPath is set to load\n * tools from the project before building the tool list.\n */\nexport async function createLangChainToolsAsync(\n  options: CreateAgentToolsOptions = {}\n): Promise<StructuredToolInterface[]> {\n  const runtimeOpts = runtimeOptionsFromConfig(options);\n  const { runtime } = await createRuntimeFromConfig(runtimeOpts);\n  const hub = new LangChainToolsHub(runtime);\n\n  if (options.configFilePath) {\n    const toolConfig = loadToolConfig(options.configFilePath);\n    const names = Array.isArray(toolConfig.tools) ? toolConfig.tools : [];\n    if (names.length > 0) {\n      const registryNames = runtime.getRegistry().snapshot().map((s) => s.name);\n      const allBareBuiltin =\n        names.every((n) => isBarePackageDescriptor(String(n))) &&\n        names.some((n) => {\n          const p = parseNpmDescriptor(String(n));\n          return p !== null && BUILTIN_PKG_NAMES.includes(p.packageName);\n        });\n      if (allBareBuiltin) {\n        return hub.getLangChainTools();\n      }\n      const expanded = expandToolDescriptorsToRegistryNames(names, registryNames);\n      return hub.getLangChainToolsForNames(expanded);\n    }\n  }\n\n  return hub.getLangChainTools();\n}\n"]}