@skillkit/core 1.4.0 → 1.5.0

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.
package/dist/index.d.ts CHANGED
@@ -161,6 +161,9 @@ declare const SkillkitConfig: z.ZodObject<{
161
161
  enabledSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
162
162
  disabledSkills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
163
163
  autoSync: z.ZodDefault<z.ZodBoolean>;
164
+ cacheDir: z.ZodOptional<z.ZodString>;
165
+ marketplaceSources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
166
+ defaultTimeout: z.ZodOptional<z.ZodNumber>;
164
167
  }, "strip", z.ZodTypeAny, {
165
168
  version: 1;
166
169
  agent: "claude-code" | "codex" | "cursor" | "antigravity" | "opencode" | "gemini-cli" | "amp" | "clawdbot" | "droid" | "github-copilot" | "goose" | "kilo" | "kiro-cli" | "roo" | "trae" | "windsurf" | "universal";
@@ -168,6 +171,9 @@ declare const SkillkitConfig: z.ZodObject<{
168
171
  skillsDir?: string | undefined;
169
172
  enabledSkills?: string[] | undefined;
170
173
  disabledSkills?: string[] | undefined;
174
+ cacheDir?: string | undefined;
175
+ marketplaceSources?: string[] | undefined;
176
+ defaultTimeout?: number | undefined;
171
177
  }, {
172
178
  version: 1;
173
179
  agent?: "claude-code" | "codex" | "cursor" | "antigravity" | "opencode" | "gemini-cli" | "amp" | "clawdbot" | "droid" | "github-copilot" | "goose" | "kilo" | "kiro-cli" | "roo" | "trae" | "windsurf" | "universal" | undefined;
@@ -175,6 +181,9 @@ declare const SkillkitConfig: z.ZodObject<{
175
181
  enabledSkills?: string[] | undefined;
176
182
  disabledSkills?: string[] | undefined;
177
183
  autoSync?: boolean | undefined;
184
+ cacheDir?: string | undefined;
185
+ marketplaceSources?: string[] | undefined;
186
+ defaultTimeout?: number | undefined;
178
187
  }>;
179
188
  type SkillkitConfig = z.infer<typeof SkillkitConfig>;
180
189
  interface InstallOptions {
@@ -247,7 +256,7 @@ declare function isPathInside(child: string, parent: string): boolean;
247
256
 
248
257
  declare function getProjectConfigPath(): string;
249
258
  declare function getGlobalConfigPath(): string;
250
- declare function loadConfig(): SkillkitConfig;
259
+ declare function loadConfig(global?: boolean): SkillkitConfig;
251
260
  declare function saveConfig(config: SkillkitConfig, global?: boolean): void;
252
261
  declare function getSearchDirs(adapter: AgentAdapterInfo): string[];
253
262
  declare function getInstallDir(adapter: AgentAdapterInfo, global?: boolean): string;
@@ -3171,6 +3180,56 @@ declare function getExecutionStrategy(agentType: AgentType): ExecutionStrategy;
3171
3180
  */
3172
3181
  declare function getManualExecutionInstructions(agentType: AgentType, skillPath: string): string;
3173
3182
 
3183
+ /**
3184
+ * Skill Executor for Workflows
3185
+ *
3186
+ * Provides a real skill executor that finds skills by name
3187
+ * and executes them using available agent CLIs.
3188
+ */
3189
+
3190
+ /**
3191
+ * Options for creating a skill executor
3192
+ */
3193
+ interface SkillExecutorOptions {
3194
+ /** Project path to search for skills */
3195
+ projectPath?: string;
3196
+ /** Preferred agent to use for execution */
3197
+ preferredAgent?: AgentType;
3198
+ /** Timeout for skill execution (ms) */
3199
+ timeout?: number;
3200
+ /** Whether to fall back to other agents if preferred is unavailable */
3201
+ fallbackToAvailable?: boolean;
3202
+ /** Callback for execution events */
3203
+ onExecutionEvent?: (event: SkillExecutionEvent) => void;
3204
+ }
3205
+ /**
3206
+ * Skill execution event
3207
+ */
3208
+ interface SkillExecutionEvent {
3209
+ type: 'skill_found' | 'skill_not_found' | 'agent_selected' | 'execution_start' | 'execution_complete';
3210
+ skillName: string;
3211
+ agent?: AgentType;
3212
+ message?: string;
3213
+ success?: boolean;
3214
+ error?: string;
3215
+ }
3216
+ /**
3217
+ * Create a skill executor for workflow orchestration
3218
+ *
3219
+ * This returns a function compatible with the WorkflowOrchestrator's SkillExecutor type.
3220
+ */
3221
+ declare function createSkillExecutor(options?: SkillExecutorOptions): SkillExecutor;
3222
+ /**
3223
+ * Create a simulated skill executor for testing/dry-run
3224
+ *
3225
+ * This executor doesn't actually run skills but simulates execution.
3226
+ */
3227
+ declare function createSimulatedSkillExecutor(options?: {
3228
+ delay?: number;
3229
+ shouldFail?: (skillName: string) => boolean;
3230
+ onExecute?: (skillName: string) => void;
3231
+ }): SkillExecutor;
3232
+
3174
3233
  /**
3175
3234
  * Skill Testing Framework Types
3176
3235
  *
@@ -4403,4 +4462,534 @@ declare class MemoryInjector {
4403
4462
  */
4404
4463
  declare function createMemoryInjector(projectPath: string, projectName?: string, projectContext?: ProjectContext): MemoryInjector;
4405
4464
 
4406
- export { AGENT_CLI_CONFIGS, AGENT_FORMAT_MAP, APIBasedCompressor, type APICompressionConfig, type AgentAdapterInfo, type AgentCLIConfig, AgentConfig, type AgentExecutionResult, AgentType, type AssertionResult, BitbucketProvider, CIRCLECI_CONFIG_TEMPLATE, CONTEXT_DIR, CONTEXT_FILE, type CanonicalSkill, type CheckpointHandler, type CheckpointResponse, type CloneOptions, type CloneResult, type CommandResult, type CompressedLearning, type CompressionEngine, type CompressionOptions, type CompressionResult, type ContextCategory, type ContextExportOptions, type ContextImportOptions, type ContextLoadOptions, ContextLoader, ContextManager, ContextSync, type ContextSyncOptions, CopilotTranslator, type CurrentExecution, CursorTranslator, DEFAULT_CACHE_TTL, DEFAULT_CONTEXT_CATEGORIES, DEFAULT_MEMORY_CONFIG, DEFAULT_SCORING_WEIGHTS, DEFAULT_SKILL_SOURCES, DependencyInfo, Detection, type DetectionSource, type DiscoveredSkill, type ExecutableSkill, type ExecutableTask, type ExecutableTaskType, type ExecutionHistory, type ExecutionOptions, type ExecutionProgressCallback, type ExecutionProgressEvent, type ExecutionStrategy, type ExecutionTaskStatus, type FormatCategory, type FormatTranslator, type FreshnessResult, GITHUB_ACTION_TEMPLATE, GITLAB_CI_TEMPLATE, GitHubProvider, GitLabProvider, GitProvider, type GitProviderAdapter, INDEX_CACHE_HOURS, INDEX_PATH, type IndexSource, type InjectedMemory, type InjectionOptions, type InjectionResult, type InstallOptions, KNOWN_SKILL_REPOS, type Learning, LearningConsolidator, LearningStore, type LearningStoreData, type LoadedContext, LocalProvider, MARKETPLACE_CACHE_FILE, MarketplaceAggregator, type MarketplaceConfig, type MarketplaceIndex, type MarketplaceSearchOptions, type MarketplaceSearchResult, type MarketplaceSkill, type MatchCategory, type MatchReason, MemoryCompressor, type MemoryConfig, MemoryEnabledEngine, type MemoryEnabledEngineOptions, type MemoryFull, type MemoryIndex, MemoryIndexStore, MemoryInjector, MemoryObserver, type MemoryObserverConfig, type MemoryPaths, type MemoryPreview, type MemorySearchOptions, type MemorySearchResult, type MemoryStatus, type MemorySummary, type ObservableEvent, type ObservableEventType, type Observation, type ObservationContent, ObservationStore, type ObservationStoreData, type ObservationType, PRE_COMMIT_CONFIG_TEMPLATE, PRE_COMMIT_HOOK_TEMPLATE, PROJECT_TYPE_HINTS, ProjectContext, ProjectDetector, ProjectPatterns, type ProjectProfile, ProjectStack, type RecommendOptions, RecommendationEngine, type RecommendationResult, type RegistrySkill, RuleBasedCompressor, SESSION_FILE, SKILL_DISCOVERY_PATHS, type ScoredSkill, type ScoringWeights, type SearchOptions, type SearchResult, type SessionDecision, SessionManager, type SessionState, type SessionTask, Skill, SkillExecutionEngine, type SkillExecutionResult, type SkillExecutor, SkillFrontmatter, type SkillIndex, SkillLocation, SkillMdTranslator, SkillMetadata, SkillPreferences, type SkillSource, SkillSummary, type SkillTestCase, type SkillTestSuite, SkillkitConfig, type SyncOptions, type SyncReport, type SyncResult, TAG_TO_TECH, type TaskExecutionResult, type TaskStatus, type TestAssertion, type TestAssertionType, type TestCaseResult, type TestProgressEvent, type TestRunnerOptions, type TestSuiteResult, TranslatableSkillFrontmatter, type TranslationOptions, type TranslationPath, type TranslationResult, TranslatorRegistry, type UpdateOptions, type VerificationRule, WORKFLOWS_DIR, WORKFLOW_EXTENSION, type WaveExecutionStatus, WindsurfTranslator, type Workflow, type WorkflowExecution, type WorkflowExecutionStatus, WorkflowOrchestrator, type WorkflowProgressCallback, type WorkflowSkill, type WorkflowWave, analyzeProject, buildSkillIndex, canTranslate, copilotTranslator, createAPIBasedCompressor, createContextLoader, createContextManager, createContextSync, createExecutionEngine, createMarketplaceAggregator, createMemoryCompressor, createMemoryEnabledEngine, createMemoryInjector, createMemoryObserver, createRecommendationEngine, createRuleBasedCompressor, createSessionManager, createTestSuiteFromFrontmatter, createWorkflowOrchestrator, createWorkflowTemplate, cursorTranslator, detectProvider, detectSkillFormat, discoverSkills, estimateTokens, executeWithAgent, extractField, extractFrontmatter, fetchSkillsFromRepo, findAllSkills, findSkill, formatSkillAsPrompt, getAgentCLIConfig, getAgentConfigPath, getAllProviders, getAvailableCLIAgents, getCICDTemplate, getExecutionStrategy, getGlobalConfigPath, getIndexStatus, getInstallDir, getManualExecutionInstructions, getMemoryPaths, getMemoryStatus, getProjectConfigPath, getProvider, getSearchDirs, getStackTags, getSupportedTranslationAgents, getTechTags, globalMemoryDirectoryExists, initContext, initProject, initializeMemoryDirectory, isAgentCLIAvailable, isGitUrl, isIndexStale, isLocalPath, isPathInside, listCICDTemplates, listWorkflows, loadConfig, loadContext, loadIndex, loadMetadata, loadSkillMetadata, loadWorkflow, loadWorkflowByName, memoryDirectoryExists, parseShorthand, parseSkill, parseSkillContent, parseSource, parseWorkflow, readSkillContent, runTestSuite, saveConfig, saveIndex, saveSkillMetadata, saveWorkflow, serializeWorkflow, setSkillEnabled, skillMdTranslator, syncToAgent, syncToAllAgents, translateSkill, translateSkillFile, translatorRegistry, validateSkill, validateWorkflow, windsurfTranslator, wrapProgressCallbackWithMemory };
4465
+ /**
4466
+ * Team Collaboration Types
4467
+ */
4468
+
4469
+ /**
4470
+ * Team member information
4471
+ */
4472
+ interface TeamMember {
4473
+ id: string;
4474
+ name: string;
4475
+ email?: string;
4476
+ role: 'admin' | 'contributor' | 'viewer';
4477
+ joinedAt: string;
4478
+ }
4479
+ /**
4480
+ * Shared skill metadata
4481
+ */
4482
+ interface SharedSkill {
4483
+ name: string;
4484
+ version: string;
4485
+ description?: string;
4486
+ author: string;
4487
+ sharedAt: string;
4488
+ updatedAt: string;
4489
+ source: string;
4490
+ tags?: string[];
4491
+ agents: AgentType[];
4492
+ downloads?: number;
4493
+ rating?: number;
4494
+ }
4495
+ /**
4496
+ * Team configuration
4497
+ */
4498
+ interface TeamConfig {
4499
+ /** Team identifier */
4500
+ teamId: string;
4501
+ /** Team name */
4502
+ teamName: string;
4503
+ /** Team registry URL (git repo or registry endpoint) */
4504
+ registryUrl: string;
4505
+ /** Authentication method */
4506
+ auth?: {
4507
+ type: 'token' | 'ssh' | 'none';
4508
+ token?: string;
4509
+ keyPath?: string;
4510
+ };
4511
+ /** Auto-sync interval in minutes (0 = disabled) */
4512
+ autoSyncInterval?: number;
4513
+ /** Members list (for admin features) */
4514
+ members?: TeamMember[];
4515
+ }
4516
+ /**
4517
+ * Team registry containing shared skills
4518
+ */
4519
+ interface TeamRegistry {
4520
+ version: number;
4521
+ teamId: string;
4522
+ teamName: string;
4523
+ skills: SharedSkill[];
4524
+ updatedAt: string;
4525
+ createdAt: string;
4526
+ }
4527
+ /**
4528
+ * Bundle manifest for exporting skills
4529
+ */
4530
+ interface BundleManifest {
4531
+ version: number;
4532
+ name: string;
4533
+ description?: string;
4534
+ author: string;
4535
+ createdAt: string;
4536
+ skills: {
4537
+ name: string;
4538
+ path: string;
4539
+ agents: AgentType[];
4540
+ }[];
4541
+ totalSize: number;
4542
+ }
4543
+ /**
4544
+ * Options for sharing a skill
4545
+ */
4546
+ interface ShareOptions {
4547
+ /** Skill name to share */
4548
+ skillName: string;
4549
+ /** Description override */
4550
+ description?: string;
4551
+ /** Tags to add */
4552
+ tags?: string[];
4553
+ /** Target agents (default: all compatible) */
4554
+ agents?: AgentType[];
4555
+ /** Visibility level */
4556
+ visibility?: 'team' | 'public';
4557
+ }
4558
+ /**
4559
+ * Options for importing skills
4560
+ */
4561
+ interface ImportOptions {
4562
+ /** Overwrite existing skills */
4563
+ overwrite?: boolean;
4564
+ /** Target agents to install for */
4565
+ agents?: AgentType[];
4566
+ /** Dry run mode */
4567
+ dryRun?: boolean;
4568
+ }
4569
+
4570
+ /**
4571
+ * Team Manager
4572
+ *
4573
+ * Manages team skill sharing and collaboration
4574
+ */
4575
+
4576
+ /**
4577
+ * Team Manager for collaboration features
4578
+ */
4579
+ declare class TeamManager {
4580
+ private projectPath;
4581
+ private config;
4582
+ private registry;
4583
+ constructor(projectPath: string);
4584
+ /**
4585
+ * Initialize team configuration
4586
+ */
4587
+ init(config: Omit<TeamConfig, 'teamId'>): Promise<TeamConfig>;
4588
+ /**
4589
+ * Load existing team configuration
4590
+ */
4591
+ load(): TeamConfig | null;
4592
+ /**
4593
+ * Get current config
4594
+ */
4595
+ getConfig(): TeamConfig | null;
4596
+ /**
4597
+ * Get current registry
4598
+ */
4599
+ getRegistry(): TeamRegistry | null;
4600
+ /**
4601
+ * Share a skill to the team registry
4602
+ */
4603
+ shareSkill(options: ShareOptions): Promise<SharedSkill>;
4604
+ /**
4605
+ * List all shared skills in the team registry
4606
+ */
4607
+ listSharedSkills(): SharedSkill[];
4608
+ /**
4609
+ * Search shared skills
4610
+ */
4611
+ searchSkills(query: string): SharedSkill[];
4612
+ /**
4613
+ * Import a shared skill from the team registry
4614
+ */
4615
+ importSkill(skillName: string, options?: ImportOptions): Promise<{
4616
+ success: boolean;
4617
+ path?: string;
4618
+ error?: string;
4619
+ }>;
4620
+ /**
4621
+ * Sync with remote registry
4622
+ */
4623
+ sync(): Promise<{
4624
+ added: string[];
4625
+ updated: string[];
4626
+ removed: string[];
4627
+ }>;
4628
+ /**
4629
+ * Remove a skill from the team registry
4630
+ */
4631
+ removeSkill(skillName: string): boolean;
4632
+ private generateTeamId;
4633
+ private saveConfig;
4634
+ private loadRegistry;
4635
+ private saveRegistry;
4636
+ private findLocalSkill;
4637
+ private getAuthor;
4638
+ private detectCompatibleAgents;
4639
+ private extractFrontmatter;
4640
+ private parseYaml;
4641
+ private toYaml;
4642
+ }
4643
+ /**
4644
+ * Create a team manager instance
4645
+ */
4646
+ declare function createTeamManager(projectPath: string): TeamManager;
4647
+
4648
+ /**
4649
+ * Skill Bundle
4650
+ *
4651
+ * Package multiple skills into a shareable bundle
4652
+ */
4653
+
4654
+ /**
4655
+ * Skill Bundle class for creating and managing skill bundles
4656
+ */
4657
+ declare class SkillBundle {
4658
+ private manifest;
4659
+ private skills;
4660
+ constructor(name: string, author: string, description?: string);
4661
+ /**
4662
+ * Add a skill to the bundle
4663
+ */
4664
+ addSkill(skillPath: string, agents?: AgentType[]): void;
4665
+ /**
4666
+ * Remove a skill from the bundle
4667
+ */
4668
+ removeSkill(skillName: string): boolean;
4669
+ /**
4670
+ * Get bundle manifest
4671
+ */
4672
+ getManifest(): BundleManifest;
4673
+ /**
4674
+ * Get all skill names in bundle
4675
+ */
4676
+ getSkillNames(): string[];
4677
+ /**
4678
+ * Get skill content by name
4679
+ */
4680
+ getSkillContent(skillName: string): string | undefined;
4681
+ /**
4682
+ * Calculate bundle checksum
4683
+ */
4684
+ getChecksum(): string;
4685
+ private readSkillContent;
4686
+ private detectAgents;
4687
+ }
4688
+ /**
4689
+ * Create a new skill bundle
4690
+ */
4691
+ declare function createSkillBundle(name: string, author: string, description?: string): SkillBundle;
4692
+ /**
4693
+ * Export a bundle to a file
4694
+ */
4695
+ declare function exportBundle(bundle: SkillBundle, outputPath: string): {
4696
+ success: boolean;
4697
+ path?: string;
4698
+ error?: string;
4699
+ };
4700
+ /**
4701
+ * Import a bundle from a file
4702
+ */
4703
+ declare function importBundle(bundlePath: string, targetDir: string, options?: {
4704
+ overwrite?: boolean;
4705
+ }): {
4706
+ success: boolean;
4707
+ imported: string[];
4708
+ errors: string[];
4709
+ };
4710
+
4711
+ /**
4712
+ * Plugin System Types
4713
+ */
4714
+
4715
+ /**
4716
+ * Plugin metadata
4717
+ */
4718
+ interface PluginMetadata {
4719
+ /** Unique plugin identifier */
4720
+ name: string;
4721
+ /** Plugin version (semver) */
4722
+ version: string;
4723
+ /** Human-readable description */
4724
+ description?: string;
4725
+ /** Plugin author */
4726
+ author?: string;
4727
+ /** Plugin homepage or repository URL */
4728
+ homepage?: string;
4729
+ /** Required SkillKit version */
4730
+ skillkitVersion?: string;
4731
+ /** Plugin dependencies */
4732
+ dependencies?: string[];
4733
+ /** Plugin keywords for discovery */
4734
+ keywords?: string[];
4735
+ }
4736
+ /**
4737
+ * Plugin lifecycle hooks
4738
+ */
4739
+ interface PluginHooks {
4740
+ /** Called when a skill is installed */
4741
+ onSkillInstall?: (skill: CanonicalSkill, agent: AgentType) => Promise<void>;
4742
+ /** Called when a skill is removed */
4743
+ onSkillRemove?: (skillName: string, agent: AgentType) => Promise<void>;
4744
+ /** Called when skills are synced */
4745
+ onSync?: (agents: AgentType[]) => Promise<void>;
4746
+ /** Called before translation */
4747
+ beforeTranslate?: (skill: CanonicalSkill, targetAgent: AgentType) => Promise<CanonicalSkill>;
4748
+ /** Called after translation */
4749
+ afterTranslate?: (content: string, targetAgent: AgentType) => Promise<string>;
4750
+ /** Called when plugin is loaded */
4751
+ onLoad?: (context: PluginContext) => Promise<void>;
4752
+ /** Called when plugin is unloaded */
4753
+ onUnload?: () => Promise<void>;
4754
+ }
4755
+ /**
4756
+ * Translator plugin - adds support for new agent formats
4757
+ */
4758
+ interface TranslatorPlugin {
4759
+ type: 'translator';
4760
+ /** Agent type this translator handles */
4761
+ agentType: AgentType | string;
4762
+ /** The translator implementation */
4763
+ translator: FormatTranslator;
4764
+ }
4765
+ /**
4766
+ * Provider plugin - adds support for new skill sources
4767
+ */
4768
+ interface ProviderPlugin {
4769
+ type: 'provider';
4770
+ /** Provider name (e.g., 'bitbucket', 's3') */
4771
+ providerName: string;
4772
+ /** The provider implementation */
4773
+ provider: GitProviderAdapter;
4774
+ }
4775
+ /**
4776
+ * Command plugin - adds new CLI commands
4777
+ */
4778
+ interface CommandPlugin {
4779
+ type: 'command';
4780
+ /** Command name */
4781
+ name: string;
4782
+ /** Command aliases */
4783
+ aliases?: string[];
4784
+ /** Command description */
4785
+ description: string;
4786
+ /** Command options */
4787
+ options?: Array<{
4788
+ name: string;
4789
+ description: string;
4790
+ type: 'string' | 'boolean' | 'number';
4791
+ required?: boolean;
4792
+ default?: unknown;
4793
+ }>;
4794
+ /** Command handler */
4795
+ handler: (args: Record<string, unknown>, context: PluginContext) => Promise<number>;
4796
+ }
4797
+ /**
4798
+ * Plugin context passed to plugins
4799
+ */
4800
+ interface PluginContext {
4801
+ /** Project path */
4802
+ projectPath: string;
4803
+ /** SkillKit version */
4804
+ skillkitVersion: string;
4805
+ /** Plugin configuration */
4806
+ config: PluginConfig;
4807
+ /** Logger instance */
4808
+ log: {
4809
+ info: (message: string) => void;
4810
+ warn: (message: string) => void;
4811
+ error: (message: string) => void;
4812
+ debug: (message: string) => void;
4813
+ };
4814
+ /** Get a registered translator by agent type */
4815
+ getTranslator: (agentType: AgentType) => FormatTranslator | undefined;
4816
+ /** Get a registered provider by name */
4817
+ getProvider: (name: string) => GitProviderAdapter | undefined;
4818
+ }
4819
+ /**
4820
+ * Plugin configuration
4821
+ */
4822
+ interface PluginConfig {
4823
+ /** Plugin-specific settings */
4824
+ settings?: Record<string, unknown>;
4825
+ /** Whether plugin is enabled */
4826
+ enabled?: boolean;
4827
+ }
4828
+ /**
4829
+ * Main plugin interface
4830
+ */
4831
+ interface Plugin {
4832
+ /** Plugin metadata */
4833
+ metadata: PluginMetadata;
4834
+ /** Plugin hooks */
4835
+ hooks?: PluginHooks;
4836
+ /** Translator extensions */
4837
+ translators?: TranslatorPlugin[];
4838
+ /** Provider extensions */
4839
+ providers?: ProviderPlugin[];
4840
+ /** Command extensions */
4841
+ commands?: CommandPlugin[];
4842
+ /** Plugin initialization */
4843
+ init?: (context: PluginContext) => Promise<void>;
4844
+ /** Plugin cleanup */
4845
+ destroy?: () => Promise<void>;
4846
+ }
4847
+
4848
+ /**
4849
+ * Plugin Manager
4850
+ *
4851
+ * Manages plugin registration, lifecycle, and execution
4852
+ */
4853
+
4854
+ /**
4855
+ * Plugin Manager class
4856
+ */
4857
+ declare class PluginManager {
4858
+ private projectPath;
4859
+ private plugins;
4860
+ private translators;
4861
+ private providers;
4862
+ private commands;
4863
+ private hooks;
4864
+ private state;
4865
+ private context;
4866
+ constructor(projectPath: string);
4867
+ /**
4868
+ * Register a plugin
4869
+ */
4870
+ register(plugin: Plugin): Promise<void>;
4871
+ /**
4872
+ * Unregister a plugin
4873
+ */
4874
+ unregister(name: string): Promise<void>;
4875
+ /**
4876
+ * Get a registered plugin
4877
+ */
4878
+ getPlugin(name: string): Plugin | undefined;
4879
+ /**
4880
+ * Get all registered plugins
4881
+ */
4882
+ getAllPlugins(): Plugin[];
4883
+ /**
4884
+ * Get plugin metadata for all plugins
4885
+ */
4886
+ listPlugins(): PluginMetadata[];
4887
+ /**
4888
+ * Get a translator by agent type
4889
+ */
4890
+ getTranslator(agentType: AgentType | string): FormatTranslator | undefined;
4891
+ /**
4892
+ * Get all registered translators
4893
+ */
4894
+ getAllTranslators(): Map<string, FormatTranslator>;
4895
+ /**
4896
+ * Get a provider by name
4897
+ */
4898
+ getProvider(name: string): GitProviderAdapter | undefined;
4899
+ /**
4900
+ * Get all registered providers
4901
+ */
4902
+ getAllProviders(): Map<string, GitProviderAdapter>;
4903
+ /**
4904
+ * Get a command by name
4905
+ */
4906
+ getCommand(name: string): CommandPlugin | undefined;
4907
+ /**
4908
+ * Get all registered commands
4909
+ */
4910
+ getAllCommands(): CommandPlugin[];
4911
+ /**
4912
+ * Execute hooks for an event
4913
+ */
4914
+ executeHook<K extends keyof PluginHooks>(hookName: K, ...args: Parameters<NonNullable<PluginHooks[K]>>): Promise<void>;
4915
+ /**
4916
+ * Execute beforeTranslate hooks (returns transformed skill)
4917
+ */
4918
+ executeBeforeTranslate(skill: CanonicalSkill, targetAgent: AgentType): Promise<CanonicalSkill>;
4919
+ /**
4920
+ * Execute afterTranslate hooks (returns transformed content)
4921
+ */
4922
+ executeAfterTranslate(content: string, targetAgent: AgentType): Promise<string>;
4923
+ /**
4924
+ * Set plugin configuration
4925
+ */
4926
+ setPluginConfig(name: string, config: PluginConfig): void;
4927
+ /**
4928
+ * Get plugin configuration
4929
+ */
4930
+ getPluginConfig(name: string): PluginConfig | undefined;
4931
+ /**
4932
+ * Enable a plugin
4933
+ */
4934
+ enablePlugin(name: string): void;
4935
+ /**
4936
+ * Disable a plugin
4937
+ */
4938
+ disablePlugin(name: string): void;
4939
+ /**
4940
+ * Check if plugin is enabled
4941
+ */
4942
+ isPluginEnabled(name: string): boolean;
4943
+ private loadState;
4944
+ private saveState;
4945
+ private createContext;
4946
+ }
4947
+ /**
4948
+ * Create a plugin manager instance
4949
+ */
4950
+ declare function createPluginManager(projectPath: string): PluginManager;
4951
+
4952
+ /**
4953
+ * Plugin Loader
4954
+ *
4955
+ * Loads plugins from various sources:
4956
+ * - Local files
4957
+ * - npm packages
4958
+ * - Git repositories
4959
+ */
4960
+
4961
+ /**
4962
+ * Plugin Loader class
4963
+ */
4964
+ declare class PluginLoader {
4965
+ /**
4966
+ * Load a plugin from a file path
4967
+ */
4968
+ loadFromFile(filePath: string): Promise<Plugin>;
4969
+ /**
4970
+ * Load a plugin from an npm package
4971
+ */
4972
+ loadFromPackage(packageName: string): Promise<Plugin>;
4973
+ /**
4974
+ * Load a plugin from a JSON definition (for simple plugins)
4975
+ */
4976
+ loadFromJson(jsonPath: string): Plugin;
4977
+ /**
4978
+ * Scan a directory for plugins
4979
+ */
4980
+ scanDirectory(dirPath: string): Promise<PluginMetadata[]>;
4981
+ /**
4982
+ * Validate a plugin structure
4983
+ */
4984
+ private validatePlugin;
4985
+ }
4986
+ /**
4987
+ * Load a plugin from a file
4988
+ */
4989
+ declare function loadPlugin(source: string): Promise<Plugin>;
4990
+ /**
4991
+ * Load all plugins from a directory
4992
+ */
4993
+ declare function loadPluginsFromDirectory(dirPath: string): Promise<Plugin[]>;
4994
+
4995
+ export { AGENT_CLI_CONFIGS, AGENT_FORMAT_MAP, APIBasedCompressor, type APICompressionConfig, type AgentAdapterInfo, type AgentCLIConfig, AgentConfig, type AgentExecutionResult, AgentType, type AssertionResult, BitbucketProvider, type BundleManifest, CIRCLECI_CONFIG_TEMPLATE, CONTEXT_DIR, CONTEXT_FILE, type CanonicalSkill, type CheckpointHandler, type CheckpointResponse, type CloneOptions, type CloneResult, type CommandPlugin, type CommandResult, type CompressedLearning, type CompressionEngine, type CompressionOptions, type CompressionResult, type ContextCategory, type ContextExportOptions, type ContextImportOptions, type ContextLoadOptions, ContextLoader, ContextManager, ContextSync, type ContextSyncOptions, CopilotTranslator, type CurrentExecution, CursorTranslator, DEFAULT_CACHE_TTL, DEFAULT_CONTEXT_CATEGORIES, DEFAULT_MEMORY_CONFIG, DEFAULT_SCORING_WEIGHTS, DEFAULT_SKILL_SOURCES, DependencyInfo, Detection, type DetectionSource, type DiscoveredSkill, type ExecutableSkill, type ExecutableTask, type ExecutableTaskType, type ExecutionHistory, type ExecutionOptions, type ExecutionProgressCallback, type ExecutionProgressEvent, type ExecutionStrategy, type ExecutionTaskStatus, type FormatCategory, type FormatTranslator, type FreshnessResult, GITHUB_ACTION_TEMPLATE, GITLAB_CI_TEMPLATE, GitHubProvider, GitLabProvider, GitProvider, type GitProviderAdapter, INDEX_CACHE_HOURS, INDEX_PATH, type ImportOptions, type IndexSource, type InjectedMemory, type InjectionOptions, type InjectionResult, type InstallOptions, KNOWN_SKILL_REPOS, type Learning, LearningConsolidator, LearningStore, type LearningStoreData, type LoadedContext, LocalProvider, MARKETPLACE_CACHE_FILE, MarketplaceAggregator, type MarketplaceConfig, type MarketplaceIndex, type MarketplaceSearchOptions, type MarketplaceSearchResult, type MarketplaceSkill, type MatchCategory, type MatchReason, MemoryCompressor, type MemoryConfig, MemoryEnabledEngine, type MemoryEnabledEngineOptions, type MemoryFull, type MemoryIndex, MemoryIndexStore, MemoryInjector, MemoryObserver, type MemoryObserverConfig, type MemoryPaths, type MemoryPreview, type MemorySearchOptions, type MemorySearchResult, type MemoryStatus, type MemorySummary, type ObservableEvent, type ObservableEventType, type Observation, type ObservationContent, ObservationStore, type ObservationStoreData, type ObservationType, PRE_COMMIT_CONFIG_TEMPLATE, PRE_COMMIT_HOOK_TEMPLATE, PROJECT_TYPE_HINTS, type Plugin, type PluginConfig, type PluginContext, type PluginHooks, PluginLoader, PluginManager, type PluginMetadata, ProjectContext, ProjectDetector, ProjectPatterns, type ProjectProfile, ProjectStack, type ProviderPlugin, type RecommendOptions, RecommendationEngine, type RecommendationResult, type RegistrySkill, RuleBasedCompressor, SESSION_FILE, SKILL_DISCOVERY_PATHS, type ScoredSkill, type ScoringWeights, type SearchOptions, type SearchResult, type SessionDecision, SessionManager, type SessionState, type SessionTask, type ShareOptions, type SharedSkill, Skill, SkillBundle, SkillExecutionEngine, type SkillExecutionEvent, type SkillExecutionResult, type SkillExecutor, type SkillExecutorOptions, SkillFrontmatter, type SkillIndex, SkillLocation, SkillMdTranslator, SkillMetadata, SkillPreferences, type SkillSource, SkillSummary, type SkillTestCase, type SkillTestSuite, SkillkitConfig, type SyncOptions, type SyncReport, type SyncResult, TAG_TO_TECH, type TaskExecutionResult, type TaskStatus, type TeamConfig, TeamManager, type TeamMember, type TeamRegistry, type TestAssertion, type TestAssertionType, type TestCaseResult, type TestProgressEvent, type TestRunnerOptions, type TestSuiteResult, TranslatableSkillFrontmatter, type TranslationOptions, type TranslationPath, type TranslationResult, type TranslatorPlugin, TranslatorRegistry, type UpdateOptions, type VerificationRule, WORKFLOWS_DIR, WORKFLOW_EXTENSION, type WaveExecutionStatus, WindsurfTranslator, type Workflow, type WorkflowExecution, type WorkflowExecutionStatus, WorkflowOrchestrator, type WorkflowProgressCallback, type WorkflowSkill, type WorkflowWave, analyzeProject, buildSkillIndex, canTranslate, copilotTranslator, createAPIBasedCompressor, createContextLoader, createContextManager, createContextSync, createExecutionEngine, createMarketplaceAggregator, createMemoryCompressor, createMemoryEnabledEngine, createMemoryInjector, createMemoryObserver, createPluginManager, createRecommendationEngine, createRuleBasedCompressor, createSessionManager, createSimulatedSkillExecutor, createSkillBundle, createSkillExecutor, createTeamManager, createTestSuiteFromFrontmatter, createWorkflowOrchestrator, createWorkflowTemplate, cursorTranslator, detectProvider, detectSkillFormat, discoverSkills, estimateTokens, executeWithAgent, exportBundle, extractField, extractFrontmatter, fetchSkillsFromRepo, findAllSkills, findSkill, formatSkillAsPrompt, getAgentCLIConfig, getAgentConfigPath, getAllProviders, getAvailableCLIAgents, getCICDTemplate, getExecutionStrategy, getGlobalConfigPath, getIndexStatus, getInstallDir, getManualExecutionInstructions, getMemoryPaths, getMemoryStatus, getProjectConfigPath, getProvider, getSearchDirs, getStackTags, getSupportedTranslationAgents, getTechTags, globalMemoryDirectoryExists, importBundle, initContext, initProject, initializeMemoryDirectory, isAgentCLIAvailable, isGitUrl, isIndexStale, isLocalPath, isPathInside, listCICDTemplates, listWorkflows, loadConfig, loadContext, loadIndex, loadMetadata, loadPlugin, loadPluginsFromDirectory, loadSkillMetadata, loadWorkflow, loadWorkflowByName, memoryDirectoryExists, parseShorthand, parseSkill, parseSkillContent, parseSource, parseWorkflow, readSkillContent, runTestSuite, saveConfig, saveIndex, saveSkillMetadata, saveWorkflow, serializeWorkflow, setSkillEnabled, skillMdTranslator, syncToAgent, syncToAllAgents, translateSkill, translateSkillFile, translatorRegistry, validateSkill, validateWorkflow, windsurfTranslator, wrapProgressCallbackWithMemory };