@frontmcp/sdk 1.8.1 → 1.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/common/metadata/front-mcp.metadata.d.ts +15 -0
  2. package/common/metadata/front-mcp.metadata.d.ts.map +1 -1
  3. package/common/metadata/tool-ui.metadata.d.ts +1 -0
  4. package/common/metadata/tool-ui.metadata.d.ts.map +1 -1
  5. package/completion/flows/complete.flow.d.ts +9 -2
  6. package/completion/flows/complete.flow.d.ts.map +1 -1
  7. package/context/frontmcp-context.d.ts +2 -0
  8. package/context/frontmcp-context.d.ts.map +1 -1
  9. package/esm/index.mjs +445 -250
  10. package/flows/resolved-entries.d.ts +9 -0
  11. package/flows/resolved-entries.d.ts.map +1 -0
  12. package/front-mcp/front-mcp.d.ts.map +1 -1
  13. package/index.d.ts +2 -2
  14. package/index.d.ts.map +1 -1
  15. package/index.js +441 -249
  16. package/package.json +10 -10
  17. package/plugin/plugin.registry.d.ts +2 -0
  18. package/plugin/plugin.registry.d.ts.map +1 -1
  19. package/prompt/flows/get-prompt.flow.d.ts.map +1 -1
  20. package/prompt/prompt.registry.d.ts +1 -0
  21. package/prompt/prompt.registry.d.ts.map +1 -1
  22. package/provider/provider.registry.d.ts +6 -1
  23. package/provider/provider.registry.d.ts.map +1 -1
  24. package/resource/flows/read-resource.flow.d.ts.map +1 -1
  25. package/resource/resource.registry.d.ts +1 -0
  26. package/resource/resource.registry.d.ts.map +1 -1
  27. package/scope/scope.instance.d.ts.map +1 -1
  28. package/skill/flows/http/skills-api.flow.d.ts +0 -6
  29. package/skill/flows/http/skills-api.flow.d.ts.map +1 -1
  30. package/skill/flows/load-skill.flow.d.ts +0 -7
  31. package/skill/flows/load-skill.flow.d.ts.map +1 -1
  32. package/skill/flows/search-skills.flow.d.ts +0 -13
  33. package/skill/flows/search-skills.flow.d.ts.map +1 -1
  34. package/skill/index.d.ts +2 -2
  35. package/skill/index.d.ts.map +1 -1
  36. package/skill/sep-2640/sep-2640.per-skill.d.ts.map +1 -1
  37. package/skill/skill-authorities.helper.d.ts +0 -20
  38. package/skill/skill-authorities.helper.d.ts.map +1 -1
  39. package/skill/skill-entry.resolver.d.ts +27 -0
  40. package/skill/skill-entry.resolver.d.ts.map +1 -0
  41. package/skill/skill-filter.helper.d.ts +15 -6
  42. package/skill/skill-filter.helper.d.ts.map +1 -1
  43. package/skill/skill-instructions.helper.d.ts +30 -0
  44. package/skill/skill-instructions.helper.d.ts.map +1 -1
  45. package/tool/flows/call-tool.flow.d.ts.map +1 -1
  46. package/tool/tool.registry.d.ts +1 -1
  47. package/tool/tool.registry.d.ts.map +1 -1
  48. package/tool/ui/ui-shared.d.ts +12 -1
  49. package/tool/ui/ui-shared.d.ts.map +1 -1
  50. package/transport/adapters/transport.local.adapter.d.ts +0 -9
  51. package/transport/adapters/transport.local.adapter.d.ts.map +1 -1
  52. package/transport/mcp-20260728/dispatcher.d.ts +3 -2
  53. package/transport/mcp-20260728/dispatcher.d.ts.map +1 -1
  54. package/transport/mcp-handlers/mcp-handlers.types.d.ts +9 -9
  55. package/transport/mcp-handlers/mcp-handlers.types.d.ts.map +1 -1
  56. package/transport/mcp-handlers/skills-list-request.handler.d.ts.map +1 -1
  57. package/transport/mcp-handlers/skills-load-request.handler.d.ts.map +1 -1
  58. package/transport/mcp-handlers/skills-search-request.handler.d.ts.map +1 -1
  59. package/utils/lineage.utils.d.ts +11 -0
  60. package/utils/lineage.utils.d.ts.map +1 -1
@@ -133,15 +133,6 @@ export declare abstract class LocalTransportAdapter<T extends SupportedTransport
133
133
  * Remote apps have a 'urlType' property and are not standalone.
134
134
  */
135
135
  private isRemoteApp;
136
- /**
137
- * SEP-2640 §Discovery — opt-in `instructions` text listing each
138
- * MCP-visible skill's `skill://` URI. Returns an empty string unless
139
- * `skillsConfig.sep2640InInstructions` is true and the `skill://`
140
- * resources are served (`skillsConfig.mcpResources` is not false). Also
141
- * empty under `injectInstructions: 'replace'` with non-empty server
142
- * instructions, which must then be sent alone.
143
- */
144
- private buildSkillInstructionHints;
145
136
  /**
146
137
  * Build capabilities that should be pre-advertised for remote apps.
147
138
  * Remote apps load their tools/resources/prompts asynchronously after connection,
@@ -1 +1 @@
1
- {"version":3,"file":"transport.local.adapter.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/transport.local.adapter.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"transport.local.adapter.d.ts","sourceRoot":"","sources":["../../../src/transport/adapters/transport.local.adapter.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import { type FrontMcpContext } from '../../context';
2
2
  import { type Scope } from '../../scope';
3
+ import { type McpHandlerOptions } from '../mcp-handlers/mcp-handlers.types';
3
4
  import { type RequestNotificationSink } from './request-notifications';
4
5
  import { type JsonRpcErrorPayload } from './request-validation';
5
6
  export interface DispatchOptions {
@@ -15,8 +16,8 @@ export interface DispatchOptions {
15
16
  /** True when the caller is unauthenticated, which makes results publicly cacheable. */
16
17
  isAnonymous: boolean;
17
18
  signal?: AbortSignal;
18
- /** Lazily composed instructions for `server/discover`. */
19
- composeInstructions?: () => string | undefined;
19
+ /** Lazily composed instructions for `server/discover`, for the calling context. */
20
+ composeInstructions?: McpHandlerOptions['composeInstructions'];
20
21
  /** Collects `notifications/message` + `notifications/progress` for this request. */
21
22
  notificationSink?: RequestNotificationSink;
22
23
  /** OpenTelemetry context echoed back on the result (SEP-414). */
@@ -1 +1 @@
1
- {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-20260728/dispatcher.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAOzC,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAWhE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,8EAA8E;IAC9E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,0DAA0D;IAC1D,mBAAmB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC/C,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,0DAA2D,CAAC;AAE7F;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAWtF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,WAAW,UAAQ,GAAG,MAAM,CAS/G;AAqGD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CA4B7F;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAqKxF"}
1
+ {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-20260728/dispatcher.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAG5E,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAWhE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,kEAAkE;IAClE,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,8EAA8E;IAC9E,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,uFAAuF;IACvF,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,mFAAmF;IACnF,mBAAmB,CAAC,EAAE,iBAAiB,CAAC,qBAAqB,CAAC,CAAC;IAC/D,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,0DAA2D,CAAC;AAE7F;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAWtF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,WAAW,UAAQ,GAAG,MAAM,CAS/G;AAqGD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,CA4B7F;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAuKxF"}
@@ -18,17 +18,17 @@ export type McpHandlerOptions = {
18
18
  scope: Scope;
19
19
  serverOptions: McpServerOptions;
20
20
  /**
21
- * Lazily compose the `initialize` response's `instructions` field.
21
+ * Lazily compose the `initialize` response's `instructions` field for the caller.
22
22
  *
23
- * When provided, the `initialize` handler invokes this on every request so
24
- * the catalog reflects skills registered AFTER server boot (e.g. dynamic
25
- * `registerSkillContent` calls). When omitted, the handler falls back to
26
- * the static `serverOptions.instructions` baked at construction time.
27
- *
28
- * Must remain synchronous — the MCP `initialize` request must respond
29
- * promptly without round-tripping to slow stores.
23
+ * When provided, the `initialize` handler invokes this on every request with
24
+ * the request's handler context, so the catalog reflects skills registered
25
+ * AFTER server boot (e.g. dynamic `registerSkillContent` calls) and only names
26
+ * skills that caller may see. When omitted, or when it yields `undefined`, the
27
+ * handler falls back to the static `serverOptions.instructions`.
30
28
  */
31
- composeInstructions?: () => string | undefined;
29
+ composeInstructions?: (caller?: {
30
+ authInfo?: unknown;
31
+ }) => string | undefined | Promise<string | undefined>;
32
32
  };
33
33
  export type McpRequestHandler<SendRequestT extends Request, SendNotificationT extends Notification> = RequestHandlerExtra<SendRequestT, SendNotificationT> & {
34
34
  authInfo?: AuthInfo & {
@@ -1 +1 @@
1
- {"version":3,"file":"mcp-handlers.types.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/mcp-handlers.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,mBAAmB,EACnB,MAAM,EACP,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AACvE,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GACjC,CAAC,GACD,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACjB,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACpB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACf,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC7B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAC3B,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9B,GACD,CAAC,CAAC;AACd,KAAK,KAAK,CAAC,MAAM,SAAS,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,UAAU,CACzB,cAAc,SAAS,OAAO,GAAG,OAAO,EACxC,aAAa,SAAS,MAAM,GAAG,MAAM,EACrC,EAAE,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAC9C,GAAG,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAC/C,mBAAmB,SAAS,YAAY,GAAG,YAAY;IAEvD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IACvC,aAAa,EAAE,EAAE,CAAC;IAClB,cAAc,CAAC,EAAE,GAAG,CAAC;IAErB,OAAO,EAAE,CACP,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,iBAAiB,CAAC,cAAc,EAAE,mBAAmB,CAAC,KACxD,OAAO,CAAC,aAAa,CAAC,GAAG,aAAa,CAAC;CAC7C;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,gBAAgB,CAAC;IAChC;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,YAAY,SAAS,OAAO,EAC5B,iBAAiB,SAAS,YAAY,IACpC,mBAAmB,CAAC,YAAY,EAAE,iBAAiB,CAAC,GAAG;IACzD,QAAQ,CAAC,EAAE,QAAQ,GAAG;QACpB,KAAK,CAAC,EAAE;YACN,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;YACvB,SAAS,EAAE,gBAAgB,CAAC;YAC5B,WAAW,EAAE,aAAa,CAAC;SAC5B,CAAC;KACH,CAAC;CACH,CAAC"}
1
+ {"version":3,"file":"mcp-handlers.types.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/mcp-handlers.types.ts"],"names":[],"mappings":"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"}
@@ -1 +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"}
1
+ {"version":3,"file":"skills-list-request.handler.d.ts","sourceRoot":"","sources":["../../../src/transport/mcp-handlers/skills-list-request.handler.ts"],"names":[],"mappings":"AAEA,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,CAwDrE"}
@@ -1 +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"}
1
+ {"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;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,CAkJrE"}
@@ -1 +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"}
1
+ {"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;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,CA2EzE"}
@@ -56,6 +56,17 @@ export declare function hookOwnerIdOf(lineage: EntryLineage, owner?: EntryOwnerR
56
56
  * => undefined
57
57
  */
58
58
  export declare function appOwnerIdOf(lineage: EntryLineage, owner?: EntryOwnerRef): string | undefined;
59
+ /** Owner lineage per entry instance, rebuilt with a registry's rows so `lineageOf` is O(1). */
60
+ export declare class EntryLineageIndex<Entry> {
61
+ private readonly lineages;
62
+ /** Replace the index with these rows; an entry held by several rows keeps the first row's lineage. */
63
+ rebuild(rows: Iterable<{
64
+ instance: Entry;
65
+ lineage: EntryLineage;
66
+ }>): void;
67
+ /** Owner lineage (root → leaf) of an entry, or undefined when no row holds it. */
68
+ lineageOf(entry: Entry): EntryLineage | undefined;
69
+ }
59
70
  /**
60
71
  * Check if lineage `a` is an ancestor of lineage `b`.
61
72
  */
@@ -1 +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"}
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,+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"}