opencode-dynamic-skills 1.0.2 → 1.2.0

package/dist/lib/SkillFs.d.ts

@@ -18,6 +18,7 @@ export declare const readSkillFile: (path: string) => Promise<string>;
  * @returns Array of absolute file paths
  */
 export declare const listSkillFiles: (skillPath: string, subdirectory: string) => string[];
+export declare const listAllSkillFiles: (skillPath: string) => string[];
 export declare const findSkillPaths: (basePath: string) => Promise<string[]>;
 export declare const doesPathExist: (path: string) => boolean;
 /**

package/dist/lib/formatLoadedSkill.d.ts

@@ -0,0 +1,6 @@
+import type { Skill } from '../types';
+export declare function formatLoadedSkill(args: {
+    skill: Skill;
+    invocationName?: string;
+    userMessage?: string;
+}): string;

package/dist/services/Notifier.d.ts

@@ -0,0 +1,13 @@
+import type { NotificationConfig, PluginLogger } from '../types';
+type NotificationRunner = (command: string, args: string[]) => Promise<unknown>;
+export declare function createNotifier(args: {
+    config: NotificationConfig;
+    logger: PluginLogger;
+    shell?: NotificationRunner;
+    platform?: NodeJS.Platform;
+}): {
+    skillLoaded(skillNames: string[]): Promise<void>;
+    resourceLoaded(skillName: string, relativePath: string): Promise<void>;
+    error(title: string, message: string): Promise<void>;
+};
+export {};

package/dist/services/Notifier.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/Skill.d.ts

@@ -0,0 +1,3 @@
+import { type ToolDefinition } from '@opencode-ai/plugin';
+import type { SkillRegistry } from '../types';
+export declare function createSkillTool(registry: SkillRegistry): ToolDefinition;

package/dist/tools/Skill.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/SkillRecommender.d.ts

@@ -1,5 +1,26 @@
-import type { SkillRegistry } from '../types';
-export declare function createSkillRecommender(provider: SkillRegistry): (args: {
+import type { PluginInput } from '@opencode-ai/plugin';
+import type { SkillRecommendConfig, SkillRegistry } from '../types';
+type RecommendationResult = {
+    name: string;
+    description: string;
+    score: number;
+    reason: string;
+};
+type RecommenderOptions = {
+    client?: PluginInput['client'];
+    config: SkillRecommendConfig;
+};
+type ModelRecommendation = {
+    name: string;
+    reason?: string;
+};
+type ParsedModelSelection = {
+    providerID: string;
+    modelID: string;
+};
+export declare function parseModelRecommendations(text: string): ModelRecommendation[];
+export declare function parseConfiguredModel(model: string): ParsedModelSelection;
+export declare function createSkillRecommender(provider: SkillRegistry, options: RecommenderOptions): (args: {
     task: string;
     limit?: number;
 }) => Promise<{
@@ -9,12 +30,7 @@ export declare function createSkillRecommender(provider: SkillRegistry): (args:
         name: string;
         description: string;
     }[];
-    recommendations: {
-        name: string;
-        description: string;
-        score: number;
-        reason: string;
-    }[];
+    recommendations: RecommendationResult[];
     guidance: string;
     summary: {
         total: number;
@@ -23,3 +39,4 @@ export declare function createSkillRecommender(provider: SkillRegistry): (args:
     };
     debug: import("../types").SkillRegistryDebugInfo | undefined;
 }>;
+export {};

package/dist/types.d.ts

@@ -3,20 +3,7 @@
  */
 import { ReadyStateMachine } from './lib/ReadyStateMachine';
 /**
- * PromptRenderer Interface - Provider Pattern for Prompt Injection Formatting
- *
- * WHY: Different LLM models have different strengths and preferences for structured data:
- * - Claude models: trained extensively on XML, prefer structured XML injection
- * - GPT models: strong JSON parsing, prefer JSON-formatted data
- * - Other models: may benefit from markdown readability for better context
- *
- * The provider pattern allows selecting the appropriate renderer at runtime based on:
- * - Model preference (configured in modelRenderers)
- * - Global default (promptRenderer)
- * - Model detection via client.session.message()
- *
- * This abstraction decouples rendering format from tool execution logic,
- * enabling easy format additions without changing plugin code.
+ * PromptRenderer Interface for injected XML skill content.
  */
 type SkillInjectionResult = {
     skill_name: string;
@@ -65,10 +52,9 @@ export interface PromptRenderer {
      */
     render(args: Args): string;
     /**
-     * The format identifier for this renderer
-     * Used for logging, debugging, and format selection
+     * The format identifier for this renderer.
      */
-    readonly format: 'json' | 'xml' | 'md';
+    readonly format: 'xml';
 }
 /**
  * Skill resource map type for indexing skill resources
@@ -121,6 +107,7 @@ export type Skill = {
     license?: string;
     content: string;
     path: string;
+    files: SkillResourceMap;
     scripts: SkillResourceMap;
     references: SkillResourceMap;
     assets: SkillResourceMap;
@@ -167,10 +154,21 @@ export type SkillRank = {
 export type PluginConfig = {
     debug: boolean;
     basePaths: string[];
-    promptRenderer: 'json' | 'xml' | 'md';
-    modelRenderers?: Record<string, 'json' | 'xml' | 'md'>;
     slashCommandName: string;
     enableSkillAliases: boolean;
+    reservedSlashCommands: string[];
+    notifications: NotificationConfig;
+    skillRecommend: SkillRecommendConfig;
+};
+export type NotificationConfig = {
+    enabled: boolean;
+    success: boolean;
+    errors: boolean;
+};
+export type SkillRecommendConfig = {
+    strategy: 'heuristic' | 'model';
+    model: string;
+    systemPrompt: string;
 };
 export type LogType = 'log' | 'debug' | 'error' | 'warn';
 export type PluginLogger = Record<LogType, (...message: unknown[]) => void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-dynamic-skills",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "OpenCode plugin for dynamic skill loading, slash skill commands, and skill-root-relative resources",
   "homepage": "https://github.com/Wu-H-Y/opencode-dynamic-skills#readme",
   "bugs": {

package/dist/lib/createPromptRenderer.d.ts

@@ -1,52 +0,0 @@
-/**
- * Prompt Renderer Factory
- *
- * WHY: Factory pattern centralizes renderer instantiation and makes it easy to:
- * - Add new renderer types in the future
- * - Test with different renderers
- * - Handle invalid formats gracefully
- */
-/**
- * Create a prompt renderer for the specified format
- *
- * @param format The desired format: 'json' | 'xml' | 'md'
- * @returns A PromptRenderer instance for the specified format
- * @throws Error if format is not recognized
- */
-export declare function createPromptRenderer(): {
-    getFormatter: (format: "json" | "xml" | "md") => (args: {
-        data: import("../types").Skill;
-        type: "Skill";
-    } | {
-        data: {
-            skill_name: string;
-            resource_path: string;
-            resource_mimetype: string;
-            content: string;
-        };
-        type: "SkillResource";
-    } | {
-        data: {
-            mode?: "search" | "recommend";
-            query: string | string[];
-            skills: Array<{
-                name: string;
-                description: string;
-            }>;
-            summary: {
-                total: number;
-                matches: number;
-                feedback: string;
-            };
-            recommendations?: Array<{
-                name: string;
-                description: string;
-                score: number;
-                reason: string;
-            }>;
-            guidance?: string;
-            debug?: import("../types").SkillRegistryDebugInfo;
-        };
-        type: "SkillSearchResults";
-    }) => string;
-};

package/dist/lib/createPromptRenderer.test.d.ts

@@ -1,9 +0,0 @@
-/**
- * createPromptRenderer Factory Tests
- *
- * Test coverage:
- * - Correct renderer instantiation for each format
- * - Invalid format error handling
- * - Format identifier verification
- */
-export {};

package/dist/lib/getModelFormat.d.ts

@@ -1,35 +0,0 @@
-/**
- * Model Format Resolver - Select renderer based on active LLM model
- *
- * WHY: Different LLM models have different preferences and strengths:
- * - Claude models: optimized for XML, prefer structured XML injection
- * - GPT models: strong JSON parsing, prefer JSON-formatted data
- * - Other models: may benefit from markdown readability
- *
- * This function detects the active model and selects the configured
- * format preference for that model, falling back to progressively more
- * generic model patterns.
- *
- * HOW IT WORKS:
- * 1. Query the current session via client.session.message()
- * 2. Extract the modelID from the response (e.g., "anthropic-claude-3-5-sonnet")
- * 3. Try matching in order:
- *    - Full model ID (e.g., "anthropic-claude-3-5-sonnet")
- *    - Generic model pattern (e.g., "claude-3-5-sonnet")
- * 4. If no match, fall back to promptRenderer default
- */
-import type { PluginConfig } from '../types';
-/**
- * Resolve the appropriate prompt format for the current model
- *
- * @param args An object containing:
- *   - modelId?: The identifier of the active model (e.g., "claude-3-5-sonnet")
- *   - providerId?: The identifier of the model provider (e.g., "anthropic")
- *   - config: The plugin configuration (has promptRenderer and modelRenderers)
- * @returns The format to use: 'json' | 'xml' | 'md'
- */
-export declare function getModelFormat(args: {
-    modelId?: string;
-    providerId?: string;
-    config: PluginConfig;
-}): 'json' | 'xml' | 'md';

package/dist/lib/renderers/JsonPromptRenderer.d.ts

@@ -1,8 +0,0 @@
-/**
- * JsonPromptRenderer - Format objects as JSON
- *
- * WHY: Some LLM models (especially GPT family) have strong JSON parsing
- * and prefer structured JSON data over XML for reliability and clarity.
- */
-import type { PromptRenderer } from '../../types';
-export declare const createJsonPromptRenderer: () => PromptRenderer;

package/dist/lib/renderers/JsonPromptRenderer.test.d.ts

@@ -1,10 +0,0 @@
-/**
- * JsonPromptRenderer Tests
- *
- * Test coverage for real use cases:
- * - Rendering Skill objects for prompt injection
- * - Rendering SkillResource objects (file content)
- * - Rendering SkillSearchResults objects (search results)
- * - Proper JSON formatting with indentation
- */
-export {};

package/dist/lib/renderers/MdPromptRenderer.d.ts

@@ -1,18 +0,0 @@
-/**
- * MdPromptRenderer - Format objects as human-readable Markdown
- *
- * WHY: Markdown provides human-readable formatting that works well for:
- * - Models that benefit from visual structure and readability
- * - Debugging and development (easier to read in logs)
- * - Accessibility and presentation
- *
- * STRUCTURE:
- * - Top-level keys → H3 headings (### key)
- * - Nested objects → H4 headings (#### key) with increased indentation
- * - Leaf nodes → nested bullet list items with emphasis: - **key**: *value*
- * - Arrays → nested bullets under parent key
- * - Special characters → HTML-escaped (<, >, &)
- * - Skill content → appended after --- separator with ### Content heading
- */
-import type { PromptRenderer } from '../../types';
-export declare const createMdPromptRenderer: () => PromptRenderer;

package/dist/lib/renderers/MdPromptRenderer.test.d.ts

@@ -1,11 +0,0 @@
-/**
- * MdPromptRenderer Tests
- *
- * Test coverage for real use cases:
- * - Rendering Skill objects with metadata, references, scripts, assets
- * - Rendering SkillResource objects (file content)
- * - Rendering SkillSearchResults objects
- * - HTML character escaping for security
- * - Special values handling (null, undefined)
- */
-export {};

package/dist/services/MessageModelIdAccountant.d.ts

@@ -1,22 +0,0 @@
-declare function createMessageModelIdAccountant(): {
-    reset: () => void;
-    track: (info: {
-        sessionID: string;
-        messageID: string;
-        modelID: string;
-        providerID: string;
-    }) => void;
-    untrackMessage: (args: {
-        messageID: string;
-        sessionID: string;
-    }) => void;
-    untrackSession: (sessionID: string) => void;
-    getModelInfo: (args: {
-        messageID: string;
-        sessionID: string;
-    }) => {
-        modelID: string;
-        providerID: string;
-    } | undefined;
-};
-export { createMessageModelIdAccountant };