@frontmcp/sdk 1.8.1 → 1.8.3

package/transport/mcp-handlers/mcp-surface.d.ts

@@ -0,0 +1,22 @@
+import { type CallSurface } from '../../common/availability';
+/**
+ * The surface an MCP request arrives on, for `availableWhen.surface`.
+ *
+ * `'cli'` for the in-process client of a CLI build: its scope is created by
+ * `FrontMcpInstance.createForCli`, which only the generated CLI (and its schema extractor) uses.
+ * `'mcp'` for every other MCP client: a transport (HTTP, SSE, stdio, a CLI daemon's socket), the
+ * 2026-07-28 dispatcher, or `connect()`.
+ */
+export declare function mcpRequestSurface(scope: {
+    readonly metadata: object;
+} | undefined): CallSurface;
+/**
+ * The request context an MCP handler passes to its flow, tagged with the surface the request
+ * arrived on, so the flow applies `availableWhen.surface` to what the request names or lists.
+ */
+export declare function withMcpSurface<Ctx extends object>(scope: {
+    readonly metadata: object;
+} | undefined, ctx: Ctx): Ctx & {
+    surface: CallSurface;
+};
+//# sourceMappingURL=mcp-surface.d.ts.map

package/transport/mcp-handlers/mcp-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-surface.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/mcp-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,WAAW,CAE/F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,SAAS,MAAM,EAC/C,KAAK,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAChD,GAAG,EAAE,GAAG,GACP,GAAG,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,CAEhC"}

package/transport/mcp-handlers/read-resource-request.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-resource-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/read-resource-request.handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIlH,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,EACjD,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CA2BzE"}
+{"version":3,"file":"read-resource-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/read-resource-request.handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAIlH,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,EACjD,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CA8BzE"}

package/transport/mcp-handlers/skills-list-request.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-list-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/skills-list-request.handler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAC/C,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAyDrE"}
+{"version":3,"file":"skills-list-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/skills-list-request.handler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AA8B5B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAC/C,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAmDrE"}

package/transport/mcp-handlers/skills-load-request.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-load-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/skills-load-request.handler.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAc5B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAC/C,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAuJrE"}
+{"version":3,"file":"skills-load-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/skills-load-request.handler.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAc5B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAC/C,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAkJrE"}

package/transport/mcp-handlers/skills-search-request.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-search-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/skills-search-request.handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,EACjD,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CA+EzE"}
+{"version":3,"file":"skills-search-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/skills-search-request.handler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,0BAA0B,CAAC,EACjD,KAAK,GACN,EAAE,iBAAiB,GAAG,UAAU,CAAC,mBAAmB,EAAE,kBAAkB,CAAC,CA2EzE"}

package/transport/mcp-handlers/subscribe-request.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscribe-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/subscribe-request.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAErG,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAAE,KAAK,EAAE,EAAE,iBAAiB;;;;;;;;;;;;;uBAG/C,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;WAAQ,OAAO,CAAC,WAAW,CAAC;EAuBxE"}
+{"version":3,"file":"subscribe-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/subscribe-request.handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAOrG,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG/E;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAAE,KAAK,EAAE,EAAE,iBAAiB;;;;;;;;;;;;;uBAG/C,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;WAAQ,OAAO,CAAC,WAAW,CAAC;EA4BxE"}

package/transport/web-response.renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web-response.renderer.d.ts","sourceRoot":"","sources":["../../src/transport/web-response.renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAyDvE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAmDtF"}
+{"version":3,"file":"web-response.renderer.d.ts","sourceRoot":"","sources":["../../src/transport/web-response.renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,sCAAsC,CAAC;AA6D7G,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,SAAS,CAmDtF"}

package/utils/lineage.utils.d.ts

@@ -56,6 +56,17 @@ export declare function hookOwnerIdOf(lineage: EntryLineage, owner?: EntryOwnerR
  * => undefined
  */
 export declare function appOwnerIdOf(lineage: EntryLineage, owner?: EntryOwnerRef): string | undefined;
+/** Owner lineage per entry instance, rebuilt with a registry's rows so `lineageOf` is O(1). */
+export declare class EntryLineageIndex<Entry> {
+    private readonly lineages;
+    /** Replace the index with these rows; an entry held by several rows keeps the first row's lineage. */
+    rebuild(rows: Iterable<{
+        instance: Entry;
+        lineage: EntryLineage;
+    }>): void;
+    /** Owner lineage (root → leaf) of an entry, or undefined when no row holds it. */
+    lineageOf(entry: Entry): EntryLineage | undefined;
+}
 /**
  * Check if lineage `a` is an ancestor of lineage `b`.
  */

package/utils/lineage.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lineage.utils.d.ts","sourceRoot":"","sources":["../../src/utils/lineage.utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsBxG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAGvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAG7F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,GAAG,OAAO,CAG3F"}
+{"version":3,"file":"lineage.utils.d.ts","sourceRoot":"","sources":["../../src/utils/lineage.utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAsBxG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CAGvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAG9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAG7F;AAED,+FAA+F;AAC/F,qBAAa,iBAAiB,CAAC,KAAK;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAE3D,sGAAsG;IACtG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,GAAG,IAAI;IAOzE,kFAAkF;IAClF,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS;CAGlD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,GAAG,OAAO,CAG3F"}