@frontmcp/sdk 0.7.2 → 0.8.1

package/skill/session/skill-session.types.d.ts

@@ -0,0 +1,303 @@
+/**
+ * Policy mode for skill tool authorization.
+ * Determines how the system handles tool calls not in the skill's allowlist.
+ */
+export type SkillPolicyMode = 'strict' | 'approval' | 'permissive';
+/**
+ * Information about a single active skill.
+ */
+export interface ActiveSkillInfo {
+    /**
+     * Skill identifier.
+     */
+    id: string;
+    /**
+     * Human-readable skill name.
+     */
+    name: string;
+    /**
+     * Tools allowed by this skill.
+     */
+    allowedTools: Set<string>;
+    /**
+     * Tools required by this skill.
+     */
+    requiredTools: Set<string>;
+    /**
+     * When this skill was activated.
+     */
+    activatedAt: number;
+}
+/**
+ * State of an active skill session.
+ * Tracks which skills are active and what tools they allow.
+ * Multiple skills can be active simultaneously, expanding the allowed toolset.
+ */
+export interface SkillSessionState {
+    /**
+     * Unique session identifier (from MCP session).
+     */
+    sessionId: string;
+    /**
+     * ID of the most recently activated skill, or null if no skill is active.
+     * When multiple skills are active, this is the most recent one.
+     */
+    activeSkillId: string | null;
+    /**
+     * Name of the most recently activated skill, or null if no skill is active.
+     * When multiple skills are active, this is the most recent one.
+     */
+    activeSkillName: string | null;
+    /**
+     * Map of active skills by ID.
+     * Multiple skills can be active at once, expanding the allowed toolset.
+     */
+    activeSkills: Map<string, ActiveSkillInfo>;
+    /**
+     * Set of tool names allowed by all active skills (union).
+     * When skills are loaded, this is the combined allowlist from all active skills.
+     */
+    allowedTools: Set<string>;
+    /**
+     * Set of tool names that are required by any active skill.
+     * Missing required tools may cause skill execution to fail.
+     */
+    requiredTools: Set<string>;
+    /**
+     * Policy mode for this session.
+     * Determines how unapproved tool calls are handled.
+     */
+    policyMode: SkillPolicyMode;
+    /**
+     * Timestamp when the skill was activated.
+     */
+    startedAt: number;
+    /**
+     * Tools that have been dynamically approved during this session.
+     * Used when policyMode is 'approval' and user approves additional tools.
+     */
+    approvedTools: Set<string>;
+    /**
+     * Tools that have been explicitly denied during this session.
+     */
+    deniedTools: Set<string>;
+    /**
+     * Count of tool calls made during this skill session.
+     */
+    toolCallCount: number;
+    /**
+     * Optional metadata for tracking/analytics.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for configuring skill session behavior.
+ */
+export interface SkillSessionOptions {
+    /**
+     * Default policy mode for new skill sessions.
+     * @default 'permissive'
+     */
+    defaultPolicyMode?: SkillPolicyMode;
+    /**
+     * Whether skills must be explicitly activated via loadSkill.
+     * If false, tool calls without an active skill are always allowed.
+     * @default false
+     */
+    requireExplicitActivation?: boolean;
+    /**
+     * Whether to track tool usage statistics.
+     * @default true
+     */
+    trackToolUsage?: boolean;
+    /**
+     * Maximum number of tool calls allowed per skill session.
+     * Set to 0 for unlimited.
+     * @default 0
+     */
+    maxToolCallsPerSession?: number;
+    /**
+     * Maximum duration in milliseconds for a skill session.
+     * Session is automatically deactivated after this time.
+     * Set to 0 for unlimited.
+     * @default 0
+     */
+    maxSessionDuration?: number;
+}
+/**
+ * Result of activating a skill session.
+ */
+export interface SkillActivationResult {
+    /**
+     * The created session state.
+     */
+    session: SkillSessionState;
+    /**
+     * Tools from the skill that are available in the current scope.
+     */
+    availableTools: string[];
+    /**
+     * Tools from the skill that are missing from the current scope.
+     */
+    missingTools: string[];
+    /**
+     * Whether all required tools are available.
+     */
+    isComplete: boolean;
+    /**
+     * Warning message if some tools are missing.
+     */
+    warning?: string;
+}
+/**
+ * Result of checking tool authorization.
+ */
+export interface ToolAuthorizationResult {
+    /**
+     * Whether the tool call is allowed.
+     */
+    allowed: boolean;
+    /**
+     * Reason for the authorization decision.
+     */
+    reason: 'skill_allowlist' | 'dynamically_approved' | 'no_active_skill' | 'not_in_allowlist' | 'denied' | 'rate_limited';
+    /**
+     * Whether human approval should be requested.
+     * Only true when policyMode is 'approval' and tool not in allowlist.
+     */
+    requiresApproval?: boolean;
+    /**
+     * ID of the primary/most recent active skill, if any.
+     * When multiple skills are active, this is the most recently activated one.
+     */
+    skillId?: string;
+    /**
+     * Human-readable name of the primary/most recent active skill, if any.
+     * When multiple skills are active, this is the most recently activated one.
+     */
+    skillName?: string;
+    /**
+     * IDs of all active skills in the session.
+     * When multiple skills are loaded, this contains all of them.
+     */
+    activeSkillIds?: string[];
+    /**
+     * Names of all active skills in the session.
+     * When multiple skills are loaded, this contains all of them.
+     */
+    activeSkillNames?: string[];
+    /**
+     * Name of the tool being checked.
+     */
+    toolName: string;
+    /**
+     * Additional context for the authorization decision.
+     */
+    context?: Record<string, unknown>;
+}
+/**
+ * Event emitted when a skill session changes.
+ */
+export interface SkillSessionEvent {
+    /**
+     * Type of session event.
+     */
+    type: 'activated' | 'deactivated' | 'tool_approved' | 'tool_denied' | 'tool_called';
+    /**
+     * Session ID.
+     */
+    sessionId: string;
+    /**
+     * Skill ID, if applicable.
+     */
+    skillId?: string;
+    /**
+     * Tool name, if applicable.
+     */
+    toolName?: string;
+    /**
+     * Timestamp of the event.
+     */
+    timestamp: number;
+    /**
+     * Additional event data.
+     */
+    data?: Record<string, unknown>;
+}
+/**
+ * Security policy for a specific skill.
+ * Can be defined in skill metadata to override session defaults.
+ */
+export interface SkillSecurityPolicy {
+    /**
+     * Policy mode for this skill.
+     * Overrides session default.
+     */
+    policyMode?: SkillPolicyMode;
+    /**
+     * If true, only explicitly listed tools are allowed.
+     * No dynamic approval possible.
+     * @default false
+     */
+    strictAllowlist?: boolean;
+    /**
+     * Whether tools can be dynamically approved at runtime.
+     * @default true
+     */
+    allowDynamicApproval?: boolean;
+    /**
+     * Audit level for this skill.
+     * @default 'basic'
+     */
+    auditLevel?: 'none' | 'basic' | 'verbose';
+    /**
+     * Maximum tool calls for this skill.
+     * Overrides session default.
+     */
+    maxToolCalls?: number;
+    /**
+     * Maximum session duration for this skill in milliseconds.
+     * Overrides session default.
+     */
+    maxDuration?: number;
+}
+/**
+ * Serialized version of ActiveSkillInfo for storage.
+ */
+export interface SerializedActiveSkillInfo {
+    id: string;
+    name: string;
+    allowedTools: string[];
+    requiredTools: string[];
+    activatedAt: number;
+}
+/**
+ * Serializable version of SkillSessionState for storage.
+ */
+export interface SerializedSkillSessionState {
+    sessionId: string;
+    activeSkillId: string | null;
+    activeSkillName: string | null;
+    activeSkills: SerializedActiveSkillInfo[];
+    allowedTools: string[];
+    requiredTools: string[];
+    policyMode: SkillPolicyMode;
+    startedAt: number;
+    approvedTools: string[];
+    deniedTools: string[];
+    toolCallCount: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Convert SkillSessionState to serializable format.
+ */
+export declare function serializeSessionState(state: SkillSessionState): SerializedSkillSessionState;
+/**
+ * Convert serialized format back to SkillSessionState.
+ */
+export declare function deserializeSessionState(data: SerializedSkillSessionState): SkillSessionState;
+/**
+ * Create a new empty skill session state.
+ */
+export declare function createEmptySessionState(sessionId: string, options?: SkillSessionOptions): SkillSessionState;
+//# sourceMappingURL=skill-session.types.d.ts.map

package/skill/session/skill-session.types.d.ts.map

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

package/skill/skill-http.utils.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Utilities for formatting skills for HTTP endpoints.
+ *
+ * These utilities provide formatted output for:
+ * - /llm.txt - Compact skill summaries
+ * - /llm_full.txt - Full skills with instructions and tool schemas
+ * - /skills API - JSON responses
+ */
+import type { SkillContent, SkillEntry, ToolRegistryInterface } from '../common';
+import type { SkillVisibility } from '../common/metadata/skill.metadata';
+import type { SkillRegistryInterface as SkillRegistryInterfaceType } from './skill.registry';
+/**
+ * Compact skill summary for /llm.txt endpoint.
+ */
+export interface CompactSkillSummary {
+    name: string;
+    description: string;
+    tools?: string[];
+    tags?: string[];
+}
+/**
+ * Format skills for compact /llm.txt output.
+ * Returns a plain text format suitable for LLM consumption.
+ *
+ * @param skills - Array of skill entries to format
+ * @returns Formatted plain text string
+ *
+ * @example Output format
+ * ```
+ * # review-pr
+ * Review a GitHub pull request
+ * Tools: github_get_pr, github_add_comment
+ * Tags: github, code-review
+ *
+ * ---
+ *
+ * # deploy-app
+ * Deploy application to production
+ * Tools: docker_build, k8s_apply
+ * Tags: deployment, kubernetes
+ * ```
+ */
+export declare function formatSkillsForLlmCompact(skills: SkillEntry[]): string;
+/**
+ * Format skills with full instructions AND tool schemas for /llm_full.txt.
+ * Loads full skill content and includes complete tool schemas.
+ *
+ * @param registry - Skill registry to load skills from
+ * @param toolRegistry - Tool registry to get tool schemas
+ * @param visibility - Optional visibility filter ('http' or 'both')
+ * @returns Formatted plain text with full skill details
+ */
+export declare function formatSkillsForLlmFull(registry: SkillRegistryInterfaceType, toolRegistry: ToolRegistryInterface, visibility?: SkillVisibility): Promise<string>;
+/**
+ * Format a skill with FULL tool schemas (input/output) - not just names.
+ * Used by /llm_full.txt and enhanced loadSkill response.
+ *
+ * @param skill - The loaded skill content
+ * @param availableTools - List of available tool names
+ * @param missingTools - List of missing tool names
+ * @param toolRegistry - Tool registry for schema lookup
+ * @returns Formatted markdown string
+ */
+export declare function formatSkillForLLMWithSchemas(skill: SkillContent, availableTools: string[], missingTools: string[], toolRegistry: ToolRegistryInterface): string;
+/**
+ * Skill API response structure.
+ */
+export interface SkillApiResponse {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    tools: string[];
+    parameters?: Array<{
+        name: string;
+        description?: string;
+        required: boolean;
+        type: string;
+    }>;
+    priority: number;
+    visibility: SkillVisibility;
+    availableTools?: string[];
+    missingTools?: string[];
+    isComplete?: boolean;
+}
+/**
+ * Convert a skill entry to a JSON-serializable summary.
+ * Used by the /skills API endpoint.
+ *
+ * @param skill - The skill entry
+ * @param loadResult - Optional load result with tool availability info
+ * @returns JSON-serializable object
+ */
+export declare function skillToApiResponse(skill: SkillEntry, loadResult?: {
+    availableTools: string[];
+    missingTools: string[];
+    isComplete: boolean;
+}): SkillApiResponse;
+/**
+ * Filter skills by visibility for a given context.
+ *
+ * @param skills - Array of skill entries
+ * @param context - The context requesting skills ('mcp' or 'http')
+ * @returns Filtered array of skills visible in the given context
+ */
+export declare function filterSkillsByVisibility(skills: SkillEntry[], context: 'mcp' | 'http'): SkillEntry[];
+//# sourceMappingURL=skill-http.utils.d.ts.map

package/skill/skill-http.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-http.utils.d.ts","sourceRoot":"","sources":["../../src/skill/skill-http.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,qBAAqB,EAAa,MAAM,WAAW,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,sBAAsB,IAAI,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CA4BtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,0BAA0B,EACpC,YAAY,EAAE,qBAAqB,EACnC,UAAU,GAAE,eAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,YAAY,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,EAAE,qBAAqB,GAClC,MAAM,CA6FR;AAaD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,OAAO,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,UAAU,CAAC,EAAE;IACX,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB,GACA,gBAAgB,CAwBlB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,EAAE,CAMpG"}

package/skill/skill-mode.utils.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Utilities for skills-only mode detection.
+ *
+ * Skills-only mode is a special operational mode where:
+ * - The tools list returns empty (no tools exposed)
+ * - Only skill discovery tools are available
+ * - Used for planner agents that need skills but not execution tools
+ *
+ * @module skill/skill-mode.utils
+ */
+/**
+ * Session payload interface for skills-only mode detection.
+ */
+export interface SkillsOnlySessionPayload {
+    skillsOnlyMode?: boolean;
+}
+/**
+ * Detect if skills-only mode is requested from query parameters.
+ *
+ * Skills-only mode returns empty tools list, exposing only skill discovery.
+ * Clients can request this mode by adding `?mode=skills_only` to the connection URL.
+ *
+ * @param query - Query parameters from the request (may be undefined)
+ * @returns true if skills_only mode is requested
+ *
+ * @example
+ * ```typescript
+ * // In transport flow
+ * const query = request.query as Record<string, string | string[]> | undefined;
+ * const skillsOnlyMode = detectSkillsOnlyMode(query);
+ * ```
+ */
+export declare function detectSkillsOnlyMode(query: Record<string, string | string[] | undefined> | undefined): boolean;
+/**
+ * Check if the current session is in skills-only mode.
+ *
+ * This checks the session payload for the skillsOnlyMode flag that was
+ * set during session creation based on the initial query parameters.
+ *
+ * @param sessionPayload - Session payload from authorization (may be undefined)
+ * @returns true if the session is in skills-only mode
+ *
+ * @example
+ * ```typescript
+ * // In tools/list flow
+ * const isSkillsOnly = isSkillsOnlySession(authorization.session?.payload);
+ * if (isSkillsOnly) {
+ *   return { tools: [] }; // Return empty tools list
+ * }
+ * ```
+ */
+export declare function isSkillsOnlySession(sessionPayload: SkillsOnlySessionPayload | undefined): boolean;
+//# sourceMappingURL=skill-mode.utils.d.ts.map

package/skill/skill-mode.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-mode.utils.d.ts","sourceRoot":"","sources":["../../src/skill/skill-mode.utils.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,OAAO,CAgB9G;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,wBAAwB,GAAG,SAAS,GAAG,OAAO,CAEjG"}

package/skill/skill-scope.helper.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Helper for registering skill capabilities in scope.
+ *
+ * This module extracts skill-specific registration logic from scope.instance.ts
+ * to maintain separation of concerns and improve maintainability.
+ *
+ * @module skill/skill-scope.helper
+ */
+import type { FrontMcpLogger } from '../common';
+import type { SkillsConfigOptions } from '../common/types/options/skills-http';
+import type FlowRegistry from '../flows/flow.registry';
+import type ToolRegistry from '../tool/tool.registry';
+import type ProviderRegistry from '../provider/provider.registry';
+import type SkillRegistry from './skill.registry';
+/**
+ * Options for registering skill capabilities.
+ */
+export interface SkillScopeRegistrationOptions {
+    /** Skill registry containing registered skills */
+    skillRegistry: SkillRegistry;
+    /** Flow registry for registering skill flows */
+    flowRegistry: FlowRegistry;
+    /** Tool registry for registering skill tools */
+    toolRegistry: ToolRegistry;
+    /** Provider registry for dependency injection */
+    providers: ProviderRegistry;
+    /** Skills configuration from @FrontMcp metadata */
+    skillsConfig?: SkillsConfigOptions;
+    /** Logger instance for logging */
+    logger: FrontMcpLogger;
+}
+/**
+ * Register skill-related flows and tools in the scope.
+ *
+ * This function handles:
+ * - Registering MCP flows for skill discovery/loading (SearchSkillsFlow, LoadSkillFlow)
+ * - Registering skill MCP tools (searchSkills, loadSkill) unless disabled
+ * - Registering HTTP flows (llm.txt, llm_full.txt, /skills) when skillsConfig is enabled
+ *
+ * @param options - Registration options
+ *
+ * @example
+ * ```typescript
+ * await registerSkillCapabilities({
+ *   skillRegistry: this.scopeSkills,
+ *   flowRegistry: this.scopeFlows,
+ *   toolRegistry: this.scopeTools,
+ *   providers: this.scopeProviders,
+ *   skillsConfig: this.metadata.skillsConfig,
+ *   logger: this.logger,
+ * });
+ * ```
+ */
+export declare function registerSkillCapabilities(options: SkillScopeRegistrationOptions): Promise<void>;
+//# sourceMappingURL=skill-scope.helper.d.ts.map

package/skill/skill-scope.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-scope.helper.d.ts","sourceRoot":"","sources":["../../src/skill/skill-scope.helper.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,YAAY,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,YAAY,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,gBAAgB,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAMlD;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,kDAAkD;IAClD,aAAa,EAAE,aAAa,CAAC;IAC7B,gDAAgD;IAChD,YAAY,EAAE,YAAY,CAAC;IAC3B,gDAAgD;IAChD,YAAY,EAAE,YAAY,CAAC;IAC3B,iDAAiD;IACjD,SAAS,EAAE,gBAAgB,CAAC;IAC5B,mDAAmD;IACnD,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,kCAAkC;IAClC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBrG"}