@agentforge/skills 0.16.41 → 0.16.43

package/dist/index.d.ts

@@ -378,257 +378,31 @@ declare function createReadSkillResourceTool(registry: SkillRegistry): Tool<z.in
  */
 declare function createSkillActivationTools(registry: SkillRegistry): [Tool<z.infer<typeof activateSkillSchema>, string>, Tool<z.infer<typeof readSkillResourceSchema>, string>];
 
-/**
- * Skill Registry
- *
- * Central registry for discovering, storing, and querying Agent Skills.
- * Mirrors ToolRegistry but uses folder-based auto-discovery instead
- * of programmatic registration.
- *
- * @see https://agentskills.io/specification
- *
- * @example
- * ```ts
- * const registry = new SkillRegistry({
- *   skillRoots: ['.agentskills', '~/.agentskills'],
- * });
- *
- * // Query discovered skills
- * const skill = registry.get('code-review');
- * const allSkills = registry.getAll();
- *
- * // Listen for events
- * registry.on(SkillRegistryEvent.SKILL_DISCOVERED, (skill) => {
- *   console.log('Found skill:', skill.metadata.name);
- * });
- * ```
- */
-
-/**
- * Skill Registry — auto-discovers skills from configured folder paths.
- *
- * Parallel to ToolRegistry:
- * | ToolRegistry             | SkillRegistry                            |
- * |--------------------------|------------------------------------------|
- * | registry.register(tool)  | new SkillRegistry({ skillRoots })        |
- * | registry.get('name')     | skillRegistry.get('name')                |
- * | registry.getAll()        | skillRegistry.getAll()                   |
- * | registry.has('name')     | skillRegistry.has('name')                |
- * | registry.size()          | skillRegistry.size()                     |
- * | registry.generatePrompt()| skillRegistry.generatePrompt()           |
- * | registry.toLangChainTools()| skillRegistry.toActivationTools()       |
- */
 declare class SkillRegistry {
     private skills;
     private eventHandlers;
     private readonly config;
     private scanErrors;
-    /** Maps resolved root paths → trust levels for skill trust assignment */
     private rootTrustMap;
-    /**
-     * Create a SkillRegistry and immediately scan configured roots for skills.
-     *
-     * @param config - Registry configuration with skill root paths
-     *
-     * @example
-     * ```ts
-     * const registry = new SkillRegistry({
-     *   skillRoots: ['.agentskills', '~/.agentskills', './project-skills'],
-     * });
-     * console.log(`Discovered ${registry.size()} skills`);
-     * ```
-     */
     constructor(config: SkillRegistryConfig);
-    /**
-     * Scan all configured roots and populate the registry.
-     *
-     * Called automatically during construction. Can be called again
-     * to re-scan (clears existing skills first).
-     */
     discover(): void;
-    /**
-     * Get a skill by name.
-     *
-     * @param name - The skill name
-     * @returns The skill, or undefined if not found
-     *
-     * @example
-     * ```ts
-     * const skill = registry.get('code-review');
-     * if (skill) {
-     *   console.log(skill.metadata.description);
-     * }
-     * ```
-     */
     get(name: string): Skill | undefined;
-    /**
-     * Get all discovered skills.
-     *
-     * @returns Array of all skills
-     *
-     * @example
-     * ```ts
-     * const allSkills = registry.getAll();
-     * console.log(`Total skills: ${allSkills.length}`);
-     * ```
-     */
     getAll(): Skill[];
-    /**
-     * Check if a skill exists in the registry.
-     *
-     * @param name - The skill name
-     * @returns True if the skill exists
-     *
-     * @example
-     * ```ts
-     * if (registry.has('code-review')) {
-     *   console.log('Skill available!');
-     * }
-     * ```
-     */
     has(name: string): boolean;
-    /**
-     * Get the number of discovered skills.
-     *
-     * @returns Number of skills in the registry
-     *
-     * @example
-     * ```ts
-     * console.log(`Registry has ${registry.size()} skills`);
-     * ```
-     */
     size(): number;
-    /**
-     * Get all skill names.
-     *
-     * @returns Array of skill names
-     */
     getNames(): string[];
-    /**
-     * Get errors/warnings from the last scan.
-     *
-     * Useful for diagnostics and observability.
-     *
-     * @returns Array of scan errors with paths
-     */
     getScanErrors(): ReadonlyArray<{
         path: string;
         error: string;
     }>;
-    /**
-     * Check whether untrusted script access is allowed via config override.
-     *
-     * Used by activation tools to pass the override flag to trust policy checks.
-     *
-     * @returns True if `allowUntrustedScripts` is set in config
-     */
     getAllowUntrustedScripts(): boolean;
-    /**
-     * Get the `allowed-tools` list for a skill.
-     *
-     * Returns the `allowedTools` array from the skill's frontmatter metadata,
-     * enabling agents to filter their tool set based on what the skill expects.
-     *
-     * @param name - The skill name
-     * @returns Array of allowed tool names, or undefined if skill not found or field not set
-     *
-     * @example
-     * ```ts
-     * const allowed = registry.getAllowedTools('code-review');
-     * if (allowed) {
-     *   const filteredTools = allTools.filter(t => allowed.includes(t.name));
-     * }
-     * ```
-     */
     getAllowedTools(name: string): string[] | undefined;
-    /**
-     * Generate an `<available_skills>` XML block for system prompt injection.
-     *
-     * Returns an empty string when:
-     * - `config.enabled` is `false` (default) — agents operate with unmodified prompts
-     * - No skills match the filter criteria
-     *
-     * The output composes naturally with `toolRegistry.generatePrompt()` —
-     * simply concatenate both into the system prompt.
-     *
-     * @param options - Optional filtering (subset of skill names)
-     * @returns XML string or empty string
-     *
-     * @example
-     * ```ts
-     * // All skills
-     * const xml = registry.generatePrompt();
-     *
-     * // Subset for a focused agent
-     * const xml = registry.generatePrompt({ skills: ['code-review', 'testing'] });
-     *
-     * // Compose with tool prompt
-     * const systemPrompt = [
-     *   toolRegistry.generatePrompt(),
-     *   skillRegistry.generatePrompt(),
-     * ].filter(Boolean).join('\n\n');
-     * ```
-     */
     generatePrompt(options?: SkillPromptOptions): string;
-    /**
-     * Register an event handler.
-     *
-     * @param event - The event to listen for
-     * @param handler - The handler function
-     *
-     * @example
-     * ```ts
-     * registry.on(SkillRegistryEvent.SKILL_DISCOVERED, (skill) => {
-     *   console.log('Found skill:', skill.metadata.name);
-     * });
-     * ```
-     */
     on(event: SkillRegistryEvent, handler: SkillEventHandler): void;
-    /**
-     * Unregister an event handler.
-     *
-     * @param event - The event to stop listening for
-     * @param handler - The handler function to remove
-     */
     off(event: SkillRegistryEvent, handler: SkillEventHandler): void;
-    /**
-     * Emit an event to all registered handlers.
-     *
-     * @param event - The event to emit
-     * @param data - The event data
-     * @private
-     */
-    private emit;
-    /**
-     * Emit an event (public API for activation tools).
-     *
-     * Used by skill activation tools to emit `skill:activated` and
-     * `skill:resource-loaded` events through the registry's event system.
-     *
-     * @param event - The event to emit
-     * @param data - The event data
-     */
     emitEvent(event: SkillRegistryEvent, data: unknown): void;
-    /**
-     * Create activation tools pre-wired to this registry instance.
-     *
-     * Returns `activate-skill` and `read-skill-resource` tools that
-     * agents can use to load skill instructions and resources on demand.
-     *
-     * @returns Array of [activate-skill, read-skill-resource] tools
-     *
-     * @example
-     * ```ts
-     * const agent = createReActAgent({
-     *   model: llm,
-     *   tools: [
-     *     ...toolRegistry.toLangChainTools(),
-     *     ...skillRegistry.toActivationTools(),
-     *   ],
-     * });
-     * ```
-     */
     toActivationTools(): ReturnType<typeof createSkillActivationTools>;
+    private emit;
 }
 
 /**