@frontmcp/sdk 1.3.0 → 1.4.0

package/auth/secure-store/secure-store.providers.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Secure-store DI Providers (#470)
+ *
+ * Registers the per-request {@link SecureStoreAccessor} (`this.secureStore`).
+ * The backend is a GLOBAL singleton owned by LocalPrimaryAuth; the accessor is
+ * CONTEXT-scoped because it must resolve the CURRENT request's namespace (the
+ * authenticated `sub` for `user` scope, the transport `sessionId` for `session`
+ * scope) before calling the backend.
+ */
+import { type SecureStoreBackend, type SecureStoreScope } from '@frontmcp/auth';
+import { type Token } from '@frontmcp/di';
+import { type ProviderType } from '../../common';
+import { type FrontMcpContext } from '../../context/frontmcp-context';
+/**
+ * GLOBAL DI token for the secure-store backend singleton. Provided by
+ * LocalPrimaryAuth once the backing is initialized.
+ */
+export declare const SECURE_STORE_BACKEND: Token<SecureStoreBackend>;
+/**
+ * Resolve the transport session id for the current request, or undefined when
+ * there is no session. Used for `session`-scoped secrets.
+ */
+export declare function resolveRequestSessionId(ctx: FrontMcpContext): string | undefined;
+/**
+ * Build the DI providers that back `this.secureStore`.
+ *
+ * @param backend - the GLOBAL secure-store backend singleton.
+ * @param scope - the configured namespace scope (`user` | `session` | `global`).
+ * @param ttlMs - optional default TTL applied to writes.
+ */
+export declare function createSecureStoreProviders(opts: {
+    backend: SecureStoreBackend;
+    scope: SecureStoreScope;
+    ttlMs?: number;
+}): ProviderType[];
+//# sourceMappingURL=secure-store.providers.d.ts.map

package/auth/secure-store/secure-store.providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secure-store.providers.d.ts","sourceRoot":"","sources":["../../../src/auth/secure-store/secure-store.providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAiB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAItE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAkD,KAAK,CAAC,kBAAkB,CAAC,CAAC;AAE7G;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CAGhF;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,KAAK,EAAE,gBAAgB,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,YAAY,EAAE,CA6BjB"}

package/common/decorators/agent.decorator.d.ts

@@ -112,10 +112,42 @@ type __OutputSchema = __AgentSingleOutputType | __AgentSingleOutputType[];
  * Guard fields (concurrency, rateLimit, timeout) use auto-generated Input types
  * where all fields are optional. Required fields are validated at runtime by Zod.
  * @see schemas.generated.ts in @frontmcp/guard
+ *
+ * These fields are `Omit`-ed from {@link AgentMetadata} and re-declared with the
+ * permissive `*Input` types. The re-declarations carry their own JSDoc so editor
+ * hover docs work on them (the base field docs do not survive `Omit`) — #452.
  */
 export type AgentMetadataOptions<I extends __Shape, O extends __OutputSchema> = Omit<AgentMetadata<I, O>, 'concurrency' | 'rateLimit' | 'timeout'> & {
+    /**
+     * Concurrency control for this agent — caps the number of simultaneous executions.
+     *
+     * @example
+     * ```typescript
+     * @Agent({ name: 'researcher', inputSchema: { topic: z.string() }, concurrency: { maxConcurrent: 2 } })
+     * ```
+     */
     concurrency?: ConcurrencyConfigInput;
+    /**
+     * Rate limiting for this agent — how many invocations are allowed within a time window.
+     *
+     * @example
+     * ```typescript
+     * @Agent({
+     *   name: 'researcher',
+     *   inputSchema: { topic: z.string() },
+     *   rateLimit: { maxRequests: 20, windowMs: 60_000 },
+     * })
+     * ```
+     */
     rateLimit?: RateLimitConfigInput;
+    /**
+     * Timeout for this agent's execution — wraps the execute stage with a deadline.
+     *
+     * @example
+     * ```typescript
+     * @Agent({ name: 'researcher', inputSchema: { topic: z.string() }, timeout: { executeMs: 120_000 } })
+     * ```
+     */
     timeout?: TimeoutConfigInput;
 };
 declare module '@frontmcp/sdk' {

package/common/decorators/agent.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/agent.decorator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/agent.decorator.ts"],"names":[],"mappings":"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"}

package/common/decorators/app.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/app.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,WAAW,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,cAAc,CAsCvE;AAwFD;;GAEG;AACH,KAAK,YAAY,GAAG;IAClB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC;IAC7C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC;IACnE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,iBAAiB,CAAC;CACvE,CAAC;AAEF,QAAA,MAAM,GAAG,EAA6B,YAAY,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC"}
+{"version":3,"file":"app.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/app.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,aAAa,CAAC;AAQrB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,WAAW,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,cAAc,CA6CvE;AAwFD;;GAEG;AACH,KAAK,YAAY,GAAG;IAClB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC;IAC7C,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAAC;IACnE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,iBAAiB,CAAC;CACvE,CAAC;AAEF,QAAA,MAAM,GAAG,EAA6B,YAAY,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC"}

package/common/decorators/front-mcp.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/front-mcp.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAM1B,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAa5E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAOhF;AAmCD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,cAAc,CA2E3E"}
+{"version":3,"file":"front-mcp.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/front-mcp.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAM1B,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiB5E;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAOhF;AAmCD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,GAAG,cAAc,CAqG3E"}

package/common/decorators/skill.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/skill.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAK1B,OAAO,EAAuB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAI5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,iBAAS,aAAa,CAAC,gBAAgB,EAAE,aAAa,GAAG,cAAc,CA0BtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,iBAAS,aAAa,CAAC,gBAAgB,EAAE,aAAa,GAAG,gBAAgB,CAiBxE;AAoFD,iBAAS,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,oBAAoB,CAelH;AAED,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAgB/G;AAOD,KAAK,cAAc,GAAG;IACpB,CAAC,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC;IAC1C,GAAG,EAAE,OAAO,QAAQ,CAAC;IACrB,MAAM,EAAE,OAAO,WAAW,CAAC;CAC5B,CAAC;AAEF,QAAA,MAAM,KAAK,EAA+B,cAAc,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,IAAI,KAAK,EAAE,CAAC;AAEvE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAuB1E"}
+{"version":3,"file":"skill.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/skill.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAuB,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAK9D,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAQ5F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,iBAAS,aAAa,CAAC,gBAAgB,EAAE,aAAa,GAAG,cAAc,CA0BtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,iBAAS,aAAa,CAAC,gBAAgB,EAAE,aAAa,GAAG,gBAAgB,CAiBxE;AAYD,iBAAS,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,oBAAoB,CAelH;AAED,iBAAS,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAgB/G;AAOD,KAAK,cAAc,GAAG;IACpB,CAAC,QAAQ,EAAE,aAAa,GAAG,cAAc,CAAC;IAC1C,GAAG,EAAE,OAAO,QAAQ,CAAC;IACrB,MAAM,EAAE,OAAO,WAAW,CAAC;CAC5B,CAAC;AAEF,QAAA,MAAM,KAAK,EAA+B,cAAc,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,IAAI,KAAK,EAAE,CAAC;AAEvE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAuB1E"}

package/common/decorators/tool.decorator.d.ts

@@ -75,11 +75,55 @@ O>;
  * Guard fields (concurrency, rateLimit, timeout) use auto-generated Input types
  * where all fields are optional. Required fields are validated at runtime by Zod.
  * @see schemas.generated.ts in @frontmcp/guard
+ *
+ * These four fields are `Omit`-ed from {@link ToolMetadata} and re-declared with
+ * the permissive `*Input` types. The re-declarations carry their own JSDoc so
+ * editor hover docs work on them (the base field docs do not survive `Omit`) —
+ * #452.
  */
 export type ToolMetadataOptions<I extends __Shape, O extends __OutputSchema> = Omit<__ToolMetadataBase<I, O>, 'concurrency' | 'rateLimit' | 'timeout' | 'ui'> & {
+    /**
+     * Concurrency control for this tool — caps the number of simultaneous executions.
+     *
+     * @example
+     * ```typescript
+     * @Tool({ name: 'deploy', inputSchema: { env: z.string() }, concurrency: { maxConcurrent: 1 } })
+     * ```
+     */
     concurrency?: ConcurrencyConfigInput;
+    /**
+     * Rate limiting for this tool — how many requests are allowed within a time window.
+     *
+     * @example
+     * ```typescript
+     * @Tool({
+     *   name: 'search',
+     *   inputSchema: { query: z.string() },
+     *   rateLimit: { maxRequests: 100, windowMs: 60_000, partitionBy: 'userId' },
+     * })
+     * ```
+     */
     rateLimit?: RateLimitConfigInput;
+    /**
+     * Timeout for this tool's execution — wraps the execute stage with a deadline.
+     *
+     * @example
+     * ```typescript
+     * @Tool({ name: 'long-task', inputSchema: { query: z.string() }, timeout: { executeMs: 30_000 } })
+     * ```
+     */
     timeout?: TimeoutConfigInput;
+    /**
+     * Interactive widget UI for this tool's result (MCP-UI / ext-apps).
+     *
+     * Prefer the file-based form — point at a `.tsx`/`.html` widget and the build
+     * bundles it; the input/output types are inferred from this tool's schemas.
+     *
+     * @example
+     * ```typescript
+     * @Tool({ name: 'chart', inputSchema: { points: z.array(z.number()) }, ui: { file: './chart.widget.tsx' } })
+     * ```
+     */
     ui?: ToolUIConfig<ToolInputOf<{
         inputSchema: I;
     }>, ToolOutputOf<{

package/common/decorators/tool.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/tool.decorator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool.decorator.d.ts","sourceRoot":"","sources":["../../../src/common/decorators/tool.decorator.ts"],"names":[],"mappings":"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"}

package/common/entries/scope.entry.d.ts

@@ -3,6 +3,7 @@ import type { Token, Type } from '@frontmcp/di';
 import type { GuardManager } from '@frontmcp/guard';
 import type AgentRegistry from '../../agent/agent.registry';
 import type AppRegistry from '../../app/app.registry';
+import type { AuthUiRegistry } from '../../auth/auth-ui';
 import type { AuthRegistry } from '../../auth/auth.registry';
 import type { ElicitationStore } from '../../elicitation/store/elicitation.store';
 import type { HaManager } from '../../ha';
@@ -38,6 +39,12 @@ export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, unknown,
     abstract get notifications(): NotificationService;
     abstract get agents(): AgentRegistry;
     abstract get toolUI(): ToolUIRegistry | undefined;
+    /**
+     * Registry of custom `@AuthUi` slot renderers + `@AuthExtra` validators (#469).
+     * `undefined` in CLI mode or when no custom auth UI is configured — the OAuth
+     * flows then serve the built-in HTML pages unchanged.
+     */
+    abstract get authUi(): AuthUiRegistry | undefined;
     abstract get transportService(): TransportService | undefined;
     haManager?: HaManager;
     abstract get rateLimitManager(): GuardManager | undefined;

package/common/entries/scope.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scope.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/scope.entry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scope.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/scope.entry.ts"],"names":[],"mappings":"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"}

package/common/entries/skill.entry.d.ts

@@ -1,5 +1,5 @@
 import { type SkillContent, type SkillContext } from '../interfaces';
-import { type SkillMetadata, type SkillResources, type SkillToolRef } from '../metadata';
+import { type SkillMetadata, type SkillReferencedOperation, type SkillResources, type SkillToolRef } from '../metadata';
 import { type SkillRecord } from '../records';
 import { BaseEntry, type EntryOwnerRef } from './base.entry';
 /**
@@ -87,6 +87,27 @@ export declare abstract class SkillEntry extends BaseEntry<SkillRecord, SkillCon
      * Check if the skill should be hidden from discovery.
      */
     isHidden(): boolean;
+    /**
+     * Check if this skill is always loaded — bindings derived from this skill
+     * are merged into every codecall:execute call regardless of the skills the
+     * agent passed. See SkillMetadata.alwaysLoad for guidance on when to set this.
+     */
+    isAlwaysLoaded(): boolean;
+    /**
+     * Get the OpenAPI operations this skill references in its markdown. Empty
+     * array for skills that haven't been through the harvester or that
+     * declare capabilities only via decorator `tools`.
+     */
+    getReferencedOperations(): SkillReferencedOperation[];
+    /**
+     * Whether this skill is "executable" — has at least one declared tool
+     * OR at least one referenced openapi operation. Skills with neither are
+     * pure-knowledge: discoverable via searchKnowledge, callable via execute()
+     * but with no tool bindings (the agentscript can only do pure computation).
+     */
+    isExecutable(): boolean;
+    /** Convenience inverse of {@link isExecutable}. */
+    isKnowledgeOnly(): boolean;
     /**
      * Get the skill's priority for search ranking.
      */

package/common/entries/skill.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/skill.entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnG;;;;;GAKG;AACH,8BAAsB,UAAW,SAAQ,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC;IAC1F;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,MAAM;IAEjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IAEtC;;;OAGG;IACH,WAAW,IAAI,YAAY,EAAE;IAM7B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAIrD;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC;;OAEG;IACH,YAAY,IAAI,cAAc,GAAG,SAAS;IAI1C;;;;;OAKG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAMhC;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB"}
+{"version":3,"file":"skill.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/skill.entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC;IAEpB;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEnG;;;;;GAKG;AACH,8BAAsB,UAAW,SAAQ,SAAS,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC;IAC1F;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,MAAM;IAEjC;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAE5C;;;OAGG;IACH,QAAQ,CAAC,IAAI,IAAI,OAAO,CAAC,YAAY,CAAC;IAEtC;;;OAGG;IACH,WAAW,IAAI,YAAY,EAAE;IAM7B;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,OAAO,IAAI,MAAM,EAAE;IAInB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;;;OAIG;IACH,cAAc,IAAI,OAAO;IAIzB;;;;OAIG;IACH,uBAAuB,IAAI,wBAAwB,EAAE;IAIrD;;;;;OAKG;IACH,YAAY,IAAI,OAAO;IAMvB,mDAAmD;IACnD,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC;;OAEG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC;;OAEG;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS;IAIrD;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,SAAS;IAIrC;;OAEG;IACH,YAAY,IAAI,cAAc,GAAG,SAAS;IAI1C;;;;;OAKG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAMhC;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB"}

package/common/entries/tool.entry.d.ts

@@ -80,6 +80,23 @@ export declare abstract class ToolEntry<InSchema extends ToolInputType = ToolInp
      */
     getInputJsonSchema(): Record<string, unknown> | null;
     private computeInputJsonSchema;
+    /** Cached output JSON Schema result (undefined = not yet computed, null = none) */
+    private _cachedOutputJsonSchema?;
+    /**
+     * Get the tool's output schema as JSON Schema (cached after first call).
+     *
+     * Prefers an explicit `rawOutputSchema` (the JSON Schema set by the OpenAPI adapter /
+     * remote tools); otherwise converts a Zod-shape or `z.object()` `outputSchema` to JSON
+     * Schema — symmetric with {@link getInputJsonSchema}. Returns `null` for output forms
+     * that have no object-typed schema to advertise: primitive / media string literals
+     * (`'string'`, `'image'`, …), multi-content arrays (`['string', 'image']`), and any
+     * schema that does not serialize to a top-level `type: 'object'` (e.g. a union) — those
+     * flow through `content`, not `structuredContent`, per the MCP spec.
+     *
+     * @returns JSON Schema object, or null if there is no advertisable output schema.
+     */
+    getOutputJsonSchema(): Record<string, unknown> | null;
+    private computeOutputJsonSchema;
     /**
      * Create a tool context (class or function wrapper).
      */

package/common/entries/tool.entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/tool.entry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool.entry.d.ts","sourceRoot":"","sources":["../../../src/common/entries/tool.entry.ts"],"names":[],"mappings":"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"}

package/common/interfaces/internal/primary-auth-provider.interface.d.ts

@@ -1,3 +1,4 @@
+import { type VerifyResult } from '@frontmcp/auth';
 import { type AuthOptions } from '../../types';
 import { type ServerRequest } from '../server.interface';
 /**
@@ -26,6 +27,23 @@ export declare abstract class FrontMcpAuth<Options extends AuthOptions = AuthOpt
     abstract fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
     abstract validate(request: ServerRequest): Promise<void>;
     abstract get issuer(): string;
+    /**
+     * Cryptographically verify a gateway-issued access token (public/local/remote
+     * "gateway" modes — i.e. NOT transparent). Gateway tokens are signed by this
+     * instance, so the instance is the only place that holds the verification key.
+     *
+     * The base implementation rejects everything: only auth instances that
+     * actually mint gateway tokens (i.e. {@link LocalPrimaryAuth}) override this
+     * with a real signature + expiration check. Transparent mode never calls this
+     * — it verifies against the upstream provider's JWKS instead.
+     *
+     * @param _token          The raw bearer token (already confirmed to be a JWT).
+     * @param _expectedIssuer The request-derived base URL. Provided for context /
+     *                        logging; issuer equality is intentionally NOT enforced
+     *                        (proxy/tunnel setups legitimately present `iss` ≠
+     *                        baseUrl). Signature + expiration are the security core.
+     */
+    verifyGatewayToken(_token: string, _expectedIssuer: string): Promise<VerifyResult>;
 }
 export { FrontMcpAuth as Auth };
 //# sourceMappingURL=primary-auth-provider.interface.d.ts.map

package/common/interfaces/internal/primary-auth-provider.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primary-auth-provider.interface.d.ts","sourceRoot":"","sources":["../../../../src/common/interfaces/internal/primary-auth-provider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAezD;;;;;;;;;;;GAWG;AACH,8BAAsB,YAAY,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW;IAC1E,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,OAAO;IAK5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAoBhB,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAE/E,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAExD,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC;CAC/B;AAED,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,CAAC"}
+{"version":3,"file":"primary-auth-provider.interface.d.ts","sourceRoot":"","sources":["../../../../src/common/interfaces/internal/primary-auth-provider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAezD;;;;;;;;;;;GAWG;AACH,8BAAsB,YAAY,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW;IAC1E,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,OAAO;IAK5B;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAoBhB,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAE/E,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAExD,QAAQ,KAAK,MAAM,IAAI,MAAM,CAAC;IAE9B;;;;;;;;;;;;;;;OAeG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAMnF;AAED,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,CAAC"}

package/common/interfaces/tool.interface.d.ts

@@ -100,6 +100,32 @@ export declare abstract class ToolContext<InSchema extends ToolInputType = ToolI
      * ```
      */
     protected progress(progress: number, total?: number, message?: string): Promise<boolean>;
+    /**
+     * Notify subscribed clients that a resource's contents changed.
+     *
+     * Sends `notifications/resources/updated` to every session subscribed to `uri`
+     * (via `resources/subscribe`); a no-op for sessions that aren't subscribed. Call
+     * this when a tool mutates state that backs a `@Resource` so subscribers re-fetch.
+     *
+     * @param uri - The URI of the resource whose contents changed.
+     *
+     * @example
+     * ```typescript
+     * async execute(input: Input): Promise<Output> {
+     *   await this.saveNote(input);
+     *   this.notifyResourceUpdated(`notes://${input.id}`);
+     *   return { ok: true };
+     * }
+     * ```
+     */
+    protected notifyResourceUpdated(uri: string): void;
+    /**
+     * Notify all connected clients that the set of available resources changed.
+     *
+     * Broadcasts `notifications/resources/list_changed` so clients re-run
+     * `resources/list`. Call this when a tool adds or removes resources at runtime.
+     */
+    protected notifyResourceListChanged(): void;
     /**
      * Request interactive input from the user during tool execution.
      *

package/common/interfaces/tool.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/tool.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzF,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,KAAK,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAGpG,MAAM,MAAM,QAAQ,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AAEnE,KAAK,YAAY,CAAC,CAAC,IAAI;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,EAAE,IAAI,wBAAwB,GAAG;IACxD,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,EAAE,CAAC;IACV,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,8BAAsB,WAAW,CAC/B,QAAQ,SAAS,aAAa,GAAG,aAAa,EAC9C,SAAS,SAAS,cAAc,GAAG,cAAc,EACjD,EAAE,GAAG,WAAW,CAAC;IAAE,WAAW,EAAE,QAAQ,CAAA;CAAE,CAAC,EAC3C,GAAG,GAAG,YAAY,CAAC;IAAE,YAAY,EAAE,SAAS,CAAA;CAAE,CAAC,CAC/C,SAAQ,oBAAoB,CAAC,GAAG,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAClC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAShC,OAAO,CAAC,SAAS,CAAC,CAAoB;IACtC,OAAO,CAAC,MAAM,CAAC,CAAK;IAGpB,OAAO,CAAC,YAAY,CAAC,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAC,CAAM;IAGtB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAG1D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAkB;IAElD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;gBAElB,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;IAelC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAEzC,IAAW,KAAK,IAAI,EAAE,CAErB;IAED,IAAW,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,SAAS,EAOjC;IAED,IAAW,YAAY,IAAI,aAAa,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAEzD;IAED,IAAW,MAAM,IAAI,GAAG,GAAG,SAAS,CAEnC;IAED,IAAW,MAAM,CAAC,CAAC,EAAE,GAAG,GAAG,SAAS,EAGnC;IAED,IAAW,aAAa,IAAI,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAE3D;IAED,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK;IAU1B;;;;;;;;;;;;;;;;;;OAkBG;cACa,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,GAAE,eAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IAWpH;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;cACa,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmB9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;cACa,MAAM,CAAC,CAAC,SAAS,OAAO,EACtC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,CAAC,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAoBlE;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,QAAQ,IAAI,cAAc,CAa7B;IAED;;;;;;;;;;;;;OAaG;IACH,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAMvC;CACF"}
+{"version":3,"file":"tool.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/tool.interface.ts"],"names":[],"mappings":"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"}