@skillkit/core 1.6.1 → 1.6.3

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
@@ -7648,4 +7648,433 @@ declare class AuditLogger {
7648
7648
  private toText;
7649
7649
  }
7650
7650
 
7651
- export { AGENT_CLI_CONFIGS, AGENT_FORMAT_MAP, type AIConfig, type AIGenerateOptions, AIManager, type AIProvider, AISearch, type AISearchOptions, type AISearchResult, AISkillGenerator, APIBasedCompressor, type APICompressionConfig, type ActivatedSkill, type AgentAdapterInfo, type AgentCLIConfig, type AgentCommandFormat, AgentConfig, type AgentExecutionResult, type AgentHookFormat, type AgentInstance, type AgentStatus, AgentType, type AssertionResult, type AuditEvent, type AuditEventType, type AuditExportOptions, AuditLogger, type AuditQuery, type AuditStats, BaseAIProvider, BitbucketProvider, type BundleManifest, CIRCLECI_CONFIG_TEMPLATE, CONTEXT_DIR, CONTEXT_FILE, type CanonicalSkill, type CheckpointHandler, type CheckpointResponse, type CloneOptions, type CloneResult, type CommandArg, type CommandBundle, type CommandContext, type CommandEvent, type CommandEventListener, CommandGenerator, type CommandGeneratorOptions, type CommandHandler, type CommandPlugin, CommandRegistry, type CommandRegistryOptions, type CommandResult, type CommandSearchOptions, type CommandValidationResult, 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, type GenerateOptions, type GeneratedSkill, GitHubProvider, GitLabProvider, GitProvider, type GitProviderAdapter, type HookConfig, type HookContext, type HookError, type HookEvent, type HookEventListener, HookManager, type HookManagerOptions, type HookTriggerResult, INDEX_CACHE_HOURS, INDEX_PATH, type ImportOptions, type IndexSource, type InjectedMemory, type InjectionMode, type InjectionOptions, type InjectionResult, type InstallOptions, type InstallResult, type InstalledPackInfo, type InstalledSkillInfo, type IssueSeverity, 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, type MatcherFunction, 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 MessageHandler, type MessageType, MethodologyLoader, MethodologyManager, type MethodologyManagerOptions, type MethodologyPack, type MethodologySearchQuery, type MethodologySearchResult, type MethodologySkill, type MethodologySkillMetadata, type MethodologyState, type MethodologySyncResult, MockAIProvider, type ObservableEvent, type ObservableEventType, type Observation, type ObservationContent, ObservationStore, type ObservationStoreData, type ObservationType, type OrchestratorOptions, type OrchestratorTaskStatus, type OrchestratorTeamConfig, PRE_COMMIT_CONFIG_TEMPLATE, PRE_COMMIT_HOOK_TEMPLATE, PROJECT_TYPE_HINTS, type ParseOptions, type PlanEvent, type PlanEventListener, type PlanExecutionOptions, type PlanExecutionResult, PlanExecutor, PlanGenerator, PlanParser, type PlanResult, type PlanStatus, type PlanStep, type PlanTask, type PlanTaskFiles, type PlanTaskResult, type PlanValidationResult, PlanValidator, 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 RegisteredCommand, type RegistrySkill, type ReviewIssue, type ReviewResult, type ReviewStage, type ReviewStageName, RuleBasedCompressor, SESSION_FILE, SKILL_DISCOVERY_PATHS, type ScoredSkill, type ScoringWeights, type SearchOptions, type SearchResult, type SearchableSkill, type SessionDecision, SessionManager, type SessionState, type SessionTask, type ShareOptions, type SharedSkill, Skill, SkillBundle, type SkillExample, SkillExecutionEngine, type SkillExecutionEvent, type SkillExecutionResult, type SkillExecutor, type SkillExecutorOptions, SkillFrontmatter, type SkillHook, type SkillIndex, SkillLocation, SkillMdTranslator, SkillMetadata, SkillPreferences, type SkillSource, SkillSummary, type SkillTestCase, type SkillTestSuite, SkillTriggerEngine, SkillkitConfig, type SlashCommand, type SlashCommandResult, type StepExecutor, type StepType, type StructuredPlan, type SyncOptions, type SyncReport, type SyncResult, TAG_TO_TECH, TASK_TEMPLATES, type Task, type TaskEvent, type TaskEventListener, type TaskExecutionResult, type TaskFiles, type TaskFilter, TaskManager, type TaskPlan, type TaskResult, type TaskStatus, type TaskStep, type TaskTemplate, type Team, type TeamConfig, type TeamEvent, type TeamEventListener, TeamManager, type TeamMember, type TeamMessage, TeamMessageBus, TeamOrchestrator, type TeamRegistry, type TeamStatus, type TestAssertion, type TestAssertionType, type TestCaseResult, type TestProgressEvent, type TestResult, type TestRunnerOptions, type TestSuiteResult, TranslatableSkillFrontmatter, type TranslationOptions, type TranslationPath, type TranslationResult, type TranslatorPlugin, TranslatorRegistry, type TriggerEngineOptions, type UpdateOptions, type ValidationError, type ValidationIssue, type ValidationResult, type ValidationWarning, type ValidatorOptions, 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, createCommandGenerator, createCommandRegistry, createContextLoader, createContextManager, createContextSync, createExecutionEngine, createHookManager, createMarketplaceAggregator, createMemoryCompressor, createMemoryEnabledEngine, createMemoryInjector, createMemoryObserver, createMessageBus, createMethodologyLoader, createMethodologyManager, createPlanExecutor, createPlanGenerator, createPlanParser, createPlanValidator, createPluginManager, createRecommendationEngine, createRuleBasedCompressor, createSessionManager, createSimulatedSkillExecutor, createSkillBundle, createSkillExecutor, createTaskManager, createTeamManager, createTeamOrchestrator, createTestSuiteFromFrontmatter, createTriggerEngine, createWorkflowOrchestrator, createWorkflowTemplate, cursorTranslator, detectProvider, detectSkillFormat, discoverSkills, dryRunExecutor, estimateTokens, executeWithAgent, exportBundle, extractField, extractFrontmatter, extractSkillMetadata, fetchSkillsFromRepo, findAllSkills, findSkill, formatSkillAsPrompt, getAgentCLIConfig, getAgentConfigPath, getAgentFormat, getAllProviders, getAvailableCLIAgents, getBuiltinPacksDir, 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, shellExecutor, skillMdTranslator, supportsSlashCommands, syncToAgent, syncToAllAgents, translateSkill, translateSkillFile, translatorRegistry, validateBuiltinPacks, validatePackDirectory, validatePackManifest, validatePlan, validateSkill, validateSkillContent, validateWorkflow, windsurfTranslator, wrapProgressCallbackWithMemory };
7651
+ /**
7652
+ * Agent Types
7653
+ *
7654
+ * Types for custom AI sub-agents (e.g., .claude/agents/*.md)
7655
+ * Based on Claude Code's agent specification.
7656
+ */
7657
+
7658
+ /**
7659
+ * Agent permission modes
7660
+ */
7661
+ declare const AgentPermissionMode: z.ZodEnum<["default", "plan", "auto-edit", "full-auto", "bypassPermissions"]>;
7662
+ type AgentPermissionMode = z.infer<typeof AgentPermissionMode>;
7663
+ /**
7664
+ * Agent hook definition
7665
+ */
7666
+ declare const AgentHook: z.ZodObject<{
7667
+ /** Hook event type */
7668
+ type: z.ZodEnum<["PreToolUse", "PostToolUse", "Stop", "SubagentStop", "SessionStart", "SessionEnd"]>;
7669
+ /** Command to run */
7670
+ command: z.ZodString;
7671
+ /** Timeout in milliseconds */
7672
+ timeout: z.ZodOptional<z.ZodNumber>;
7673
+ /** Run only once */
7674
+ once: z.ZodOptional<z.ZodBoolean>;
7675
+ /** Tool matcher (for PreToolUse/PostToolUse) */
7676
+ matcher: z.ZodOptional<z.ZodString>;
7677
+ }, "strip", z.ZodTypeAny, {
7678
+ type: "SessionStart" | "SessionEnd" | "PreToolUse" | "PostToolUse" | "Stop" | "SubagentStop";
7679
+ command: string;
7680
+ timeout?: number | undefined;
7681
+ matcher?: string | undefined;
7682
+ once?: boolean | undefined;
7683
+ }, {
7684
+ type: "SessionStart" | "SessionEnd" | "PreToolUse" | "PostToolUse" | "Stop" | "SubagentStop";
7685
+ command: string;
7686
+ timeout?: number | undefined;
7687
+ matcher?: string | undefined;
7688
+ once?: boolean | undefined;
7689
+ }>;
7690
+ type AgentHook = z.infer<typeof AgentHook>;
7691
+ /**
7692
+ * Agent frontmatter schema
7693
+ */
7694
+ declare const AgentFrontmatter: z.ZodObject<{
7695
+ /** Agent name (kebab-case) */
7696
+ name: z.ZodString;
7697
+ /** Description of what this agent does */
7698
+ description: z.ZodString;
7699
+ /** Model to use (e.g., 'opus', 'sonnet', 'haiku') */
7700
+ model: z.ZodOptional<z.ZodString>;
7701
+ /** Permission mode for this agent */
7702
+ permissionMode: z.ZodOptional<z.ZodEnum<["default", "plan", "auto-edit", "full-auto", "bypassPermissions"]>>;
7703
+ /** Tools this agent cannot use */
7704
+ disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7705
+ /** Allowed tools for this agent */
7706
+ allowedTools: z.ZodOptional<z.ZodUnion<[z.ZodArray<z.ZodString, "many">, z.ZodString]>>;
7707
+ /** Agent-scoped hooks */
7708
+ hooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
7709
+ /** Hook event type */
7710
+ type: z.ZodEnum<["PreToolUse", "PostToolUse", "Stop", "SubagentStop", "SessionStart", "SessionEnd"]>;
7711
+ /** Command to run */
7712
+ command: z.ZodString;
7713
+ /** Timeout in milliseconds */
7714
+ timeout: z.ZodOptional<z.ZodNumber>;
7715
+ /** Run only once */
7716
+ once: z.ZodOptional<z.ZodBoolean>;
7717
+ /** Tool matcher (for PreToolUse/PostToolUse) */
7718
+ matcher: z.ZodOptional<z.ZodString>;
7719
+ }, "strip", z.ZodTypeAny, {
7720
+ type: "SessionStart" | "SessionEnd" | "PreToolUse" | "PostToolUse" | "Stop" | "SubagentStop";
7721
+ command: string;
7722
+ timeout?: number | undefined;
7723
+ matcher?: string | undefined;
7724
+ once?: boolean | undefined;
7725
+ }, {
7726
+ type: "SessionStart" | "SessionEnd" | "PreToolUse" | "PostToolUse" | "Stop" | "SubagentStop";
7727
+ command: string;
7728
+ timeout?: number | undefined;
7729
+ matcher?: string | undefined;
7730
+ once?: boolean | undefined;
7731
+ }>, "many">>;
7732
+ /** Skills to auto-load for this agent */
7733
+ skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7734
+ /** Run in forked sub-agent context */
7735
+ context: z.ZodOptional<z.ZodEnum<["fork", "inline"]>>;
7736
+ /** Version */
7737
+ version: z.ZodOptional<z.ZodString>;
7738
+ /** Author */
7739
+ author: z.ZodOptional<z.ZodString>;
7740
+ /** Tags for categorization */
7741
+ tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
7742
+ /** Whether agent is user-invocable via @mention */
7743
+ 'user-invocable': z.ZodOptional<z.ZodBoolean>;
7744
+ /** Argument hint for agent invocation */
7745
+ 'argument-hint': z.ZodOptional<z.ZodString>;
7746
+ }, "strip", z.ZodTypeAny, {
7747
+ name: string;
7748
+ description: string;
7749
+ version?: string | undefined;
7750
+ author?: string | undefined;
7751
+ tags?: string[] | undefined;
7752
+ skills?: string[] | undefined;
7753
+ context?: "fork" | "inline" | undefined;
7754
+ hooks?: {
7755
+ type: "SessionStart" | "SessionEnd" | "PreToolUse" | "PostToolUse" | "Stop" | "SubagentStop";
7756
+ command: string;
7757
+ timeout?: number | undefined;
7758
+ matcher?: string | undefined;
7759
+ once?: boolean | undefined;
7760
+ }[] | undefined;
7761
+ model?: string | undefined;
7762
+ permissionMode?: "default" | "plan" | "auto-edit" | "full-auto" | "bypassPermissions" | undefined;
7763
+ disallowedTools?: string[] | undefined;
7764
+ allowedTools?: string | string[] | undefined;
7765
+ 'user-invocable'?: boolean | undefined;
7766
+ 'argument-hint'?: string | undefined;
7767
+ }, {
7768
+ name: string;
7769
+ description: string;
7770
+ version?: string | undefined;
7771
+ author?: string | undefined;
7772
+ tags?: string[] | undefined;
7773
+ skills?: string[] | undefined;
7774
+ context?: "fork" | "inline" | undefined;
7775
+ hooks?: {
7776
+ type: "SessionStart" | "SessionEnd" | "PreToolUse" | "PostToolUse" | "Stop" | "SubagentStop";
7777
+ command: string;
7778
+ timeout?: number | undefined;
7779
+ matcher?: string | undefined;
7780
+ once?: boolean | undefined;
7781
+ }[] | undefined;
7782
+ model?: string | undefined;
7783
+ permissionMode?: "default" | "plan" | "auto-edit" | "full-auto" | "bypassPermissions" | undefined;
7784
+ disallowedTools?: string[] | undefined;
7785
+ allowedTools?: string | string[] | undefined;
7786
+ 'user-invocable'?: boolean | undefined;
7787
+ 'argument-hint'?: string | undefined;
7788
+ }>;
7789
+ type AgentFrontmatter = z.infer<typeof AgentFrontmatter>;
7790
+ /**
7791
+ * Agent location (project or global)
7792
+ */
7793
+ declare const AgentLocation: z.ZodEnum<["project", "global"]>;
7794
+ type AgentLocation = z.infer<typeof AgentLocation>;
7795
+ /**
7796
+ * Agent metadata (stored in .skillkit-agent.json)
7797
+ */
7798
+ declare const AgentMetadata: z.ZodObject<{
7799
+ name: z.ZodString;
7800
+ description: z.ZodString;
7801
+ source: z.ZodString;
7802
+ sourceType: z.ZodEnum<["github", "gitlab", "bitbucket", "local"]>;
7803
+ subpath: z.ZodOptional<z.ZodString>;
7804
+ installedAt: z.ZodString;
7805
+ updatedAt: z.ZodOptional<z.ZodString>;
7806
+ enabled: z.ZodDefault<z.ZodBoolean>;
7807
+ version: z.ZodOptional<z.ZodString>;
7808
+ checksum: z.ZodOptional<z.ZodString>;
7809
+ }, "strip", z.ZodTypeAny, {
7810
+ name: string;
7811
+ description: string;
7812
+ source: string;
7813
+ sourceType: "github" | "gitlab" | "bitbucket" | "local";
7814
+ installedAt: string;
7815
+ enabled: boolean;
7816
+ version?: string | undefined;
7817
+ subpath?: string | undefined;
7818
+ updatedAt?: string | undefined;
7819
+ checksum?: string | undefined;
7820
+ }, {
7821
+ name: string;
7822
+ description: string;
7823
+ source: string;
7824
+ sourceType: "github" | "gitlab" | "bitbucket" | "local";
7825
+ installedAt: string;
7826
+ version?: string | undefined;
7827
+ subpath?: string | undefined;
7828
+ updatedAt?: string | undefined;
7829
+ enabled?: boolean | undefined;
7830
+ checksum?: string | undefined;
7831
+ }>;
7832
+ type AgentMetadata = z.infer<typeof AgentMetadata>;
7833
+ /**
7834
+ * Parsed agent definition
7835
+ */
7836
+ interface CustomAgent {
7837
+ /** Agent name */
7838
+ name: string;
7839
+ /** Description */
7840
+ description: string;
7841
+ /** Path to agent directory or file */
7842
+ path: string;
7843
+ /** Project or global location */
7844
+ location: AgentLocation;
7845
+ /** Full frontmatter */
7846
+ frontmatter: AgentFrontmatter;
7847
+ /** Agent content (system prompt) */
7848
+ content: string;
7849
+ /** Metadata if installed via skillkit */
7850
+ metadata?: AgentMetadata;
7851
+ /** Whether agent is enabled */
7852
+ enabled: boolean;
7853
+ }
7854
+ /**
7855
+ * Canonical agent for translation
7856
+ */
7857
+ interface CanonicalAgent {
7858
+ /** Agent name */
7859
+ name: string;
7860
+ /** Description */
7861
+ description: string;
7862
+ /** Model to use */
7863
+ model?: string;
7864
+ /** Permission mode */
7865
+ permissionMode?: AgentPermissionMode;
7866
+ /** Disallowed tools */
7867
+ disallowedTools?: string[];
7868
+ /** Allowed tools */
7869
+ allowedTools?: string[];
7870
+ /** Agent-scoped hooks */
7871
+ hooks?: AgentHook[];
7872
+ /** Skills to load */
7873
+ skills?: string[];
7874
+ /** Execution context */
7875
+ context?: 'fork' | 'inline';
7876
+ /** Version */
7877
+ version?: string;
7878
+ /** Author */
7879
+ author?: string;
7880
+ /** Tags */
7881
+ tags?: string[];
7882
+ /** User invocable */
7883
+ userInvocable?: boolean;
7884
+ /** Argument hint */
7885
+ argumentHint?: string;
7886
+ /** Main content (system prompt) */
7887
+ content: string;
7888
+ /** Source format */
7889
+ sourceFormat: AgentFormatCategory;
7890
+ /** Source agent type */
7891
+ sourceAgent?: AgentType;
7892
+ }
7893
+ /**
7894
+ * Agent format categories
7895
+ */
7896
+ type AgentFormatCategory = 'claude-agent' | 'cursor-agent' | 'universal';
7897
+ /**
7898
+ * Agent translation result
7899
+ */
7900
+ interface AgentTranslationResult {
7901
+ /** Whether translation succeeded */
7902
+ success: boolean;
7903
+ /** Translated content */
7904
+ content: string;
7905
+ /** Output filename */
7906
+ filename: string;
7907
+ /** Warnings during translation */
7908
+ warnings: string[];
7909
+ /** Features that couldn't be translated */
7910
+ incompatible: string[];
7911
+ /** Target format */
7912
+ targetFormat: AgentFormatCategory;
7913
+ /** Target agent type */
7914
+ targetAgent: AgentType;
7915
+ }
7916
+ /**
7917
+ * Agent translation options
7918
+ */
7919
+ interface AgentTranslationOptions {
7920
+ /** Preserve original comments */
7921
+ preserveComments?: boolean;
7922
+ /** Add translation metadata */
7923
+ addMetadata?: boolean;
7924
+ /** Custom output filename */
7925
+ outputFilename?: string;
7926
+ }
7927
+ /**
7928
+ * Agent discovery paths per AI coding agent
7929
+ */
7930
+ declare const AGENT_DISCOVERY_PATHS: Record<AgentType, string[]>;
7931
+ /**
7932
+ * All agent discovery paths (union of all agent paths)
7933
+ */
7934
+ declare const ALL_AGENT_DISCOVERY_PATHS: string[];
7935
+ /**
7936
+ * Agent format mapping (which agents use which format)
7937
+ */
7938
+ declare const CUSTOM_AGENT_FORMAT_MAP: Record<AgentType, AgentFormatCategory>;
7939
+
7940
+ /**
7941
+ * Agent Parser
7942
+ *
7943
+ * Parses agent definition files (e.g., .claude/agents/*.md)
7944
+ */
7945
+
7946
+ /**
7947
+ * Extract YAML frontmatter from markdown content
7948
+ */
7949
+ declare function extractAgentFrontmatter(content: string): Record<string, unknown> | null;
7950
+ /**
7951
+ * Extract content after frontmatter
7952
+ */
7953
+ declare function extractAgentContent(content: string): string;
7954
+ /**
7955
+ * Parse an agent file (.md)
7956
+ */
7957
+ declare function parseAgentFile(filePath: string, location?: AgentLocation): CustomAgent | null;
7958
+ /**
7959
+ * Parse an agent from a directory (containing AGENT.md)
7960
+ */
7961
+ declare function parseAgentDir(dirPath: string, location?: AgentLocation): CustomAgent | null;
7962
+ /**
7963
+ * Load agent metadata from JSON file
7964
+ */
7965
+ declare function loadAgentMetadata(metadataPath: string): AgentMetadata | null;
7966
+ /**
7967
+ * Convert parsed agent to canonical format for translation
7968
+ */
7969
+ declare function toCanonicalAgent(agent: CustomAgent, sourceAgent?: AgentType): CanonicalAgent;
7970
+ /**
7971
+ * Generate agent markdown from canonical format
7972
+ */
7973
+ declare function fromCanonicalAgent(canonical: CanonicalAgent, _targetFormat?: AgentFormatCategory): string;
7974
+ /**
7975
+ * Read raw agent content
7976
+ */
7977
+ declare function readAgentContent(agentPath: string): string | null;
7978
+ /**
7979
+ * Validate an agent file
7980
+ */
7981
+ declare function validateAgent(agentPath: string): {
7982
+ valid: boolean;
7983
+ errors: string[];
7984
+ warnings: string[];
7985
+ };
7986
+
7987
+ /**
7988
+ * Agent Discovery
7989
+ *
7990
+ * Discovers custom agent definitions across all supported locations.
7991
+ */
7992
+
7993
+ /**
7994
+ * Discover all agents in a project directory
7995
+ */
7996
+ declare function discoverAgents(rootDir: string): CustomAgent[];
7997
+ /**
7998
+ * Discover agents for a specific AI coding agent
7999
+ */
8000
+ declare function discoverAgentsForAgent(rootDir: string, agentType: AgentType): CustomAgent[];
8001
+ /**
8002
+ * Discover global agents (in ~/.claude/agents, etc.)
8003
+ */
8004
+ declare function discoverGlobalAgents(): CustomAgent[];
8005
+ /**
8006
+ * Find all agents (project + global)
8007
+ */
8008
+ declare function findAllAgents(searchDirs: string[]): CustomAgent[];
8009
+ /**
8010
+ * Find a specific agent by name
8011
+ */
8012
+ declare function findAgent(name: string, searchDirs: string[]): CustomAgent | null;
8013
+ /**
8014
+ * Get the agents directory for a specific AI coding agent
8015
+ */
8016
+ declare function getAgentsDirectory(rootDir: string, agentType: AgentType): string;
8017
+ /**
8018
+ * Check if an agent exists
8019
+ */
8020
+ declare function agentExists(name: string, searchDirs: string[]): boolean;
8021
+ /**
8022
+ * Get agent count statistics
8023
+ */
8024
+ declare function getAgentStats(searchDirs: string[]): {
8025
+ total: number;
8026
+ project: number;
8027
+ global: number;
8028
+ enabled: number;
8029
+ disabled: number;
8030
+ };
8031
+ /**
8032
+ * Recursively discover all agents in a directory tree
8033
+ * This finds agents at any depth, useful for batch translation
8034
+ */
8035
+ declare function discoverAgentsRecursive(rootDir: string, location?: AgentLocation): CustomAgent[];
8036
+ /**
8037
+ * Discover agents from a custom source path
8038
+ * Handles both file paths and directories
8039
+ */
8040
+ declare function discoverAgentsFromPath(sourcePath: string, recursive?: boolean, location?: AgentLocation): CustomAgent[];
8041
+
8042
+ /**
8043
+ * Agent Translator
8044
+ *
8045
+ * Translates agent definitions between different AI coding agent formats.
8046
+ */
8047
+
8048
+ /**
8049
+ * Translate an agent to a target AI coding agent format
8050
+ */
8051
+ declare function translateAgent(agent: CustomAgent, targetAgent: AgentType, options?: AgentTranslationOptions): AgentTranslationResult;
8052
+ /**
8053
+ * Translate a canonical agent to a target format
8054
+ */
8055
+ declare function translateCanonicalAgent(canonical: CanonicalAgent, targetAgent: AgentType, options?: AgentTranslationOptions): AgentTranslationResult;
8056
+ /**
8057
+ * Translate agent content directly
8058
+ */
8059
+ declare function translateAgentContent(content: string, _sourceAgent: AgentType, targetAgent: AgentType, options?: AgentTranslationOptions): AgentTranslationResult;
8060
+ /**
8061
+ * Get the expected filename for an agent
8062
+ */
8063
+ declare function getAgentFilename(agentName: string, targetAgent: AgentType): string;
8064
+ /**
8065
+ * Get the target directory for an agent
8066
+ */
8067
+ declare function getAgentTargetDirectory(rootDir: string, targetAgent: AgentType): string;
8068
+ /**
8069
+ * Translate multiple agents
8070
+ */
8071
+ declare function translateAgents(agents: CustomAgent[], targetAgent: AgentType, options?: AgentTranslationOptions): AgentTranslationResult[];
8072
+ /**
8073
+ * Check if agent format is compatible with target
8074
+ */
8075
+ declare function isAgentCompatible(sourceFormat: AgentFormatCategory, targetFormat: AgentFormatCategory): {
8076
+ compatible: boolean;
8077
+ warnings: string[];
8078
+ };
8079
+
8080
+ export { AGENT_CLI_CONFIGS, AGENT_DISCOVERY_PATHS, AGENT_FORMAT_MAP, type AIConfig, type AIGenerateOptions, AIManager, type AIProvider, AISearch, type AISearchOptions, type AISearchResult, AISkillGenerator, ALL_AGENT_DISCOVERY_PATHS, APIBasedCompressor, type APICompressionConfig, type ActivatedSkill, type AgentAdapterInfo, type AgentCLIConfig, type AgentCommandFormat, AgentConfig, type AgentExecutionResult, type AgentFormatCategory, AgentFrontmatter, AgentHook, type AgentHookFormat, type AgentInstance, AgentLocation, AgentMetadata, AgentPermissionMode, type AgentStatus, type AgentTranslationOptions, type AgentTranslationResult, AgentType, type AssertionResult, type AuditEvent, type AuditEventType, type AuditExportOptions, AuditLogger, type AuditQuery, type AuditStats, BaseAIProvider, BitbucketProvider, type BundleManifest, CIRCLECI_CONFIG_TEMPLATE, CONTEXT_DIR, CONTEXT_FILE, CUSTOM_AGENT_FORMAT_MAP, type CanonicalAgent, type CanonicalSkill, type CheckpointHandler, type CheckpointResponse, type CloneOptions, type CloneResult, type CommandArg, type CommandBundle, type CommandContext, type CommandEvent, type CommandEventListener, CommandGenerator, type CommandGeneratorOptions, type CommandHandler, type CommandPlugin, CommandRegistry, type CommandRegistryOptions, type CommandResult, type CommandSearchOptions, type CommandValidationResult, 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, type CustomAgent, 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, type GenerateOptions, type GeneratedSkill, GitHubProvider, GitLabProvider, GitProvider, type GitProviderAdapter, type HookConfig, type HookContext, type HookError, type HookEvent, type HookEventListener, HookManager, type HookManagerOptions, type HookTriggerResult, INDEX_CACHE_HOURS, INDEX_PATH, type ImportOptions, type IndexSource, type InjectedMemory, type InjectionMode, type InjectionOptions, type InjectionResult, type InstallOptions, type InstallResult, type InstalledPackInfo, type InstalledSkillInfo, type IssueSeverity, 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, type MatcherFunction, 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 MessageHandler, type MessageType, MethodologyLoader, MethodologyManager, type MethodologyManagerOptions, type MethodologyPack, type MethodologySearchQuery, type MethodologySearchResult, type MethodologySkill, type MethodologySkillMetadata, type MethodologyState, type MethodologySyncResult, MockAIProvider, type ObservableEvent, type ObservableEventType, type Observation, type ObservationContent, ObservationStore, type ObservationStoreData, type ObservationType, type OrchestratorOptions, type OrchestratorTaskStatus, type OrchestratorTeamConfig, PRE_COMMIT_CONFIG_TEMPLATE, PRE_COMMIT_HOOK_TEMPLATE, PROJECT_TYPE_HINTS, type ParseOptions, type PlanEvent, type PlanEventListener, type PlanExecutionOptions, type PlanExecutionResult, PlanExecutor, PlanGenerator, PlanParser, type PlanResult, type PlanStatus, type PlanStep, type PlanTask, type PlanTaskFiles, type PlanTaskResult, type PlanValidationResult, PlanValidator, 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 RegisteredCommand, type RegistrySkill, type ReviewIssue, type ReviewResult, type ReviewStage, type ReviewStageName, RuleBasedCompressor, SESSION_FILE, SKILL_DISCOVERY_PATHS, type ScoredSkill, type ScoringWeights, type SearchOptions, type SearchResult, type SearchableSkill, type SessionDecision, SessionManager, type SessionState, type SessionTask, type ShareOptions, type SharedSkill, Skill, SkillBundle, type SkillExample, SkillExecutionEngine, type SkillExecutionEvent, type SkillExecutionResult, type SkillExecutor, type SkillExecutorOptions, SkillFrontmatter, type SkillHook, type SkillIndex, SkillLocation, SkillMdTranslator, SkillMetadata, SkillPreferences, type SkillSource, SkillSummary, type SkillTestCase, type SkillTestSuite, SkillTriggerEngine, SkillkitConfig, type SlashCommand, type SlashCommandResult, type StepExecutor, type StepType, type StructuredPlan, type SyncOptions, type SyncReport, type SyncResult, TAG_TO_TECH, TASK_TEMPLATES, type Task, type TaskEvent, type TaskEventListener, type TaskExecutionResult, type TaskFiles, type TaskFilter, TaskManager, type TaskPlan, type TaskResult, type TaskStatus, type TaskStep, type TaskTemplate, type Team, type TeamConfig, type TeamEvent, type TeamEventListener, TeamManager, type TeamMember, type TeamMessage, TeamMessageBus, TeamOrchestrator, type TeamRegistry, type TeamStatus, type TestAssertion, type TestAssertionType, type TestCaseResult, type TestProgressEvent, type TestResult, type TestRunnerOptions, type TestSuiteResult, TranslatableSkillFrontmatter, type TranslationOptions, type TranslationPath, type TranslationResult, type TranslatorPlugin, TranslatorRegistry, type TriggerEngineOptions, type UpdateOptions, type ValidationError, type ValidationIssue, type ValidationResult, type ValidationWarning, type ValidatorOptions, type VerificationRule, WORKFLOWS_DIR, WORKFLOW_EXTENSION, type WaveExecutionStatus, WindsurfTranslator, type Workflow, type WorkflowExecution, type WorkflowExecutionStatus, WorkflowOrchestrator, type WorkflowProgressCallback, type WorkflowSkill, type WorkflowWave, agentExists, analyzeProject, buildSkillIndex, canTranslate, copilotTranslator, createAPIBasedCompressor, createCommandGenerator, createCommandRegistry, createContextLoader, createContextManager, createContextSync, createExecutionEngine, createHookManager, createMarketplaceAggregator, createMemoryCompressor, createMemoryEnabledEngine, createMemoryInjector, createMemoryObserver, createMessageBus, createMethodologyLoader, createMethodologyManager, createPlanExecutor, createPlanGenerator, createPlanParser, createPlanValidator, createPluginManager, createRecommendationEngine, createRuleBasedCompressor, createSessionManager, createSimulatedSkillExecutor, createSkillBundle, createSkillExecutor, createTaskManager, createTeamManager, createTeamOrchestrator, createTestSuiteFromFrontmatter, createTriggerEngine, createWorkflowOrchestrator, createWorkflowTemplate, cursorTranslator, detectProvider, detectSkillFormat, discoverAgents, discoverAgentsForAgent, discoverAgentsFromPath, discoverAgentsRecursive, discoverGlobalAgents, discoverSkills, dryRunExecutor, estimateTokens, executeWithAgent, exportBundle, extractAgentContent, extractAgentFrontmatter, extractField, extractFrontmatter, extractSkillMetadata, fetchSkillsFromRepo, findAgent, findAllAgents, findAllSkills, findSkill, formatSkillAsPrompt, fromCanonicalAgent, getAgentCLIConfig, getAgentConfigPath, getAgentFilename, getAgentFormat, getAgentStats, getAgentTargetDirectory, getAgentsDirectory, getAllProviders, getAvailableCLIAgents, getBuiltinPacksDir, getCICDTemplate, getExecutionStrategy, getGlobalConfigPath, getIndexStatus, getInstallDir, getManualExecutionInstructions, getMemoryPaths, getMemoryStatus, getProjectConfigPath, getProvider, getSearchDirs, getStackTags, getSupportedTranslationAgents, getTechTags, globalMemoryDirectoryExists, importBundle, initContext, initProject, initializeMemoryDirectory, isAgentCLIAvailable, isAgentCompatible, isGitUrl, isIndexStale, isLocalPath, isPathInside, listCICDTemplates, listWorkflows, loadAgentMetadata, loadConfig, loadContext, loadIndex, loadMetadata, loadPlugin, loadPluginsFromDirectory, loadSkillMetadata, loadWorkflow, loadWorkflowByName, memoryDirectoryExists, parseAgentDir, parseAgentFile, parseShorthand, parseSkill, parseSkillContent, parseSource, parseWorkflow, readAgentContent, readSkillContent, runTestSuite, saveConfig, saveIndex, saveSkillMetadata, saveWorkflow, serializeWorkflow, setSkillEnabled, shellExecutor, skillMdTranslator, supportsSlashCommands, syncToAgent, syncToAllAgents, toCanonicalAgent, translateAgent, translateAgentContent, translateAgents, translateCanonicalAgent, translateSkill, translateSkillFile, translatorRegistry, validateAgent, validateBuiltinPacks, validatePackDirectory, validatePackManifest, validatePlan, validateSkill, validateSkillContent, validateWorkflow, windsurfTranslator, wrapProgressCallbackWithMemory };