@easbot/skills 0.3.11 → 0.3.12

package/dist/index.d.cts

@@ -17,9 +17,6 @@ interface AgentConfig {
     skillsDir: string;
     globalSkillsDir: string | undefined;
     detectInstalled: () => Promise<boolean>;
-    showInUniversalList?: boolean;
-    showInUniversalPrompt?: boolean;
-    isUniversalShared?: boolean;
 }
 interface ParsedSource {
     type: 'github' | 'gitlab' | 'git' | 'local' | 'well-known';
@@ -47,8 +44,8 @@ declare const EVE_SUBAGENTS_DIR: string;
 declare function getEveSubagents(cwd?: string): string[];
 type UniversalScope = 'project' | 'global';
 declare function matchesUniversalScope(type: AgentType, scope: UniversalScope): boolean;
-declare function getUniversalAgents(): AgentType[];
-declare function getNonUniversalAgents(): AgentType[];
+declare function getUniversalAgents(scope: 'project' | 'global'): AgentType[];
+declare function getNonUniversalAgents(scope: 'project' | 'global'): AgentType[];
 declare const PROJECT_SKILLS_DIR_PATTERN: RegExp;
 declare function getAgentProjectSkillDirs(): string[];
 declare function getAgentGlobalSkillDirs(): string[];
@@ -59,7 +56,7 @@ interface AgentSkillDirsResult {
 }
 declare function getAgentSkillDirs(): AgentSkillDirsResult;
 declare function getAgentProjectSkillContainerPrefixes(): string[];
-declare function isUniversalAgent(type: AgentType): boolean;
+declare function isUniversalAgent(type: AgentType, scope: 'project' | 'global'): boolean;
 
 declare function shouldInstallInternalSkills(): boolean;
 declare function parseSkillMd(skillMdPath: string, options?: {
@@ -188,8 +185,23 @@ interface WellKnownSkillEntryV2 {
     url: string;
     digest: string;
 }
-type WellKnownIndex = WellKnownIndexV1 | WellKnownIndexV2;
-type WellKnownSkillEntry = WellKnownSkillEntryV1 | WellKnownSkillEntryV2;
+interface WellKnownSkillEntryEasbotV1 {
+    name: string;
+    description: string;
+    sourceUrl: string;
+    installName?: string;
+    category?: string;
+    version?: string;
+    tags?: string[];
+    metadata?: Record<string, unknown>;
+    skillPath?: string;
+}
+interface WellKnownIndexEasbotV1 {
+    $schema: string;
+    skills: WellKnownSkillEntryEasbotV1[];
+}
+type WellKnownIndex = WellKnownIndexV1 | WellKnownIndexV2 | WellKnownIndexEasbotV1;
+type WellKnownSkillEntry = WellKnownSkillEntryV1 | WellKnownSkillEntryV2 | WellKnownSkillEntryEasbotV1;
 type WellKnownFileContent = string | Uint8Array;
 type NormalizedWellKnownEntry = {
     version: '0.1.0';
@@ -207,6 +219,13 @@ type NormalizedWellKnownEntry = {
     artifactUrl: string;
     digest: string;
     indexEntry: WellKnownSkillEntryV2;
+} | {
+    version: 'easbot-v1';
+    name: string;
+    description: string;
+    skillMdUrl: string;
+    installName?: string;
+    indexEntry: WellKnownSkillEntryEasbotV1;
 };
 interface WellKnownSkill extends RemoteSkill {
     files: Map<string, WellKnownFileContent>;
@@ -230,10 +249,12 @@ declare class WellKnownProvider implements HostProvider {
     private getLegacySkillBaseUrl;
     private isValidSkillName;
     private isSafeLegacyFilePath;
+    private isValidSkillEntryEasbotV1;
     private isValidSkillEntryV1;
     private isValidSkillEntryV2;
     fetchSkill(url: string): Promise<RemoteSkill | null>;
     fetchSkillByEntry(baseUrlOrEntry: string | NormalizedWellKnownEntry, legacyEntry?: WellKnownSkillEntryV1, legacyWellKnownPath?: string): Promise<WellKnownSkill | null>;
+    private fetchEasbotV1SkillByEntry;
     private fetchLegacySkillByEntry;
     private fetchArtifactSkillByEntry;
     private createSkill;
@@ -262,6 +283,7 @@ interface InstallResult {
     mode: InstallMode;
     symlinkFailed?: boolean;
     skipped?: boolean;
+    skippedReason?: 'overwrite' | 'up-to-date';
     error?: string;
 }
 declare function sanitizeName(name: string): string;
@@ -323,7 +345,7 @@ interface InstalledSkill {
     agents: AgentType[];
 }
 declare function listInstalledSkills(options?: {
-    global?: boolean;
+    scope?: 'project' | 'global' | 'both';
     cwd?: string;
     agentFilter?: AgentType[];
 }): Promise<InstalledSkill[]>;
@@ -385,7 +407,103 @@ interface ListOptions {
     yes?: boolean;
 }
 declare function parseListOptions(args: string[]): ListOptions;
-declare function runList(args: string[]): Promise<void>;
+declare function runList(args: string[], callOptions?: {
+    cwd?: string;
+}): Promise<void>;
+
+declare const DEFAULT_CLONE_TIMEOUT = 300000;
+interface GitHubRepoInfo {
+    owner: string;
+    repo: string;
+    slug: string;
+    sshUrl: string;
+}
+declare class GitCloneError extends Error {
+    readonly url: string;
+    readonly isTimeout: boolean;
+    readonly isAuthError: boolean;
+    constructor(message: string, url: string, isTimeout?: boolean, isAuthError?: boolean);
+}
+declare function parseGitHubRepoUrl(url: string): GitHubRepoInfo | null;
+declare function isGitHubHttpsCloneUrl(url: string): boolean;
+declare function isGitHubSsoAuthError(message: string): boolean;
+declare function cloneRepo(url: string, ref?: string, targetDir?: string): Promise<string>;
+declare function cleanupTempDir(dir: string): Promise<void>;
+
+interface SkillSnapshotFile {
+    path: string;
+    contents: string;
+}
+interface SkillDownloadResponse {
+    files: SkillSnapshotFile[];
+    hash: string;
+}
+interface BlobSkill extends Skill {
+    files: SkillSnapshotFile[];
+    snapshotHash: string;
+    repoPath: string;
+}
+declare const BLOB_ALLOWED_REPOS: Record<string, {
+    downloadUrl: (slug: string) => string;
+}>;
+declare function toSkillSlug(name: string): string;
+interface TreeEntry {
+    path: string;
+    type: 'blob' | 'tree';
+    sha: string;
+    size?: number;
+}
+interface RepoTree {
+    sha: string;
+    branch: string;
+    tree: TreeEntry[];
+}
+declare function resetRepoTreeAuthState(): void;
+declare function fetchRepoTree(ownerRepo: string, ref?: string, getToken?: () => string | null): Promise<RepoTree | null>;
+declare function getSkillFolderHashFromTree(tree: RepoTree, skillPath: string): string | null;
+declare function findSkillMdPaths(tree: RepoTree, subpath?: string): string[];
+interface BlobInstallResult {
+    skills: BlobSkill[];
+    tree: RepoTree;
+}
+declare function tryBlobInstall(ownerRepo: string, options?: {
+    subpath?: string;
+    ref?: string;
+    getToken?: () => string | null;
+    includeInternal?: boolean;
+}): Promise<BlobInstallResult | null>;
+
+type InstallScope = 'project' | 'global';
+type AcquireMode = 'install' | 'update';
+interface AcquireInput extends ParsedSource {
+    mode?: AcquireMode;
+    skillNames?: string[];
+    scope?: InstallScope;
+}
+interface AcquireResult {
+    tempDir: string;
+    cacheHit: boolean;
+    source: 'local-cp' | 'cache-clone' | 'cache-pull' | 'well-known-fetch' | 'blob-fetch';
+    cloneError?: GitCloneError | null;
+}
+declare function getSourceDir({ scope }: {
+    scope: InstallScope;
+}): string;
+declare function getCacheRoot(): string;
+declare function getCacheRepoDir(parsed: ParsedSource): string;
+declare function acquireSourceClone(input: AcquireInput): Promise<AcquireResult>;
+declare function ensureCachedSource(source: {
+    url: string;
+    ref?: string;
+    sourceId: string;
+}): Promise<string>;
+declare function installFromCache({ cachePath, skillName, scope, }: {
+    cachePath: string;
+    skillName: string;
+    scope: InstallScope;
+}): Promise<string>;
+declare function cleanCachedRepo(parsed: ParsedSource): Promise<void>;
+declare function cleanCache(): Promise<void>;
 
 interface RemoveOptions {
     global?: boolean;
@@ -403,13 +521,14 @@ declare function parseRemoveOptions(args: string[]): {
 interface SkillLockEntry {
     source: string;
     sourceType: string;
-    sourceUrl: string;
     ref?: string;
     skillPath?: string;
-    skillFolderHash: string;
+    computedHash: string;
     installedAt: string;
     updatedAt: string;
-    pluginName?: string;
+    marketId: string;
+    pluginId: string;
+    marketplaceId?: string;
 }
 interface DismissedPrompts {
     findSkillsPrompt?: boolean;
@@ -418,7 +537,6 @@ interface SkillLockFile {
     version: number;
     skills: Record<string, SkillLockEntry>;
     dismissed?: DismissedPrompts;
-    lastSelectedAgents?: string[];
 }
 declare function getSkillLockPath(): string;
 declare function readSkillLock(): Promise<SkillLockFile>;
@@ -437,8 +555,6 @@ declare function getSkillsBySource(): Promise<Map<string, {
 }>>;
 declare function isPromptDismissed(promptKey: keyof DismissedPrompts): Promise<boolean>;
 declare function dismissPrompt(promptKey: keyof DismissedPrompts): Promise<void>;
-declare function getLastSelectedAgents(): Promise<string[] | undefined>;
-declare function saveSelectedAgents(agents: string[]): Promise<void>;
 
 interface LocalSkillLockEntry {
     source: string;
@@ -446,6 +562,11 @@ interface LocalSkillLockEntry {
     sourceType: string;
     skillPath?: string;
     computedHash: string;
+    installedAt: string;
+    updatedAt: string;
+    marketId: string;
+    pluginId: string;
+    marketplaceId?: string;
     subagents?: string[];
 }
 interface LocalSkillLockFile {
@@ -456,35 +577,48 @@ declare function getLocalLockPath(cwd?: string): string;
 declare function readLocalLock(cwd?: string): Promise<LocalSkillLockFile>;
 declare function writeLocalLock(lock: LocalSkillLockFile, cwd?: string): Promise<void>;
 declare function computeSkillFolderHash(skillDir: string): Promise<string>;
-declare function addSkillToLocalLock(skillName: string, entry: LocalSkillLockEntry, cwd?: string): Promise<void>;
+declare function addSkillToLocalLock(skillName: string, entry: Omit<LocalSkillLockEntry, 'installedAt' | 'updatedAt'>, cwd?: string): Promise<void>;
 declare function removeSkillFromLocalLock(skillName: string, cwd?: string): Promise<boolean>;
 
 type UpdateScope = 'project' | 'global' | 'both';
 interface UpdateCheckOptions {
+    cwd?: string;
     global?: boolean;
     project?: boolean;
     yes?: boolean;
     all?: boolean;
+    agent?: string[];
     force?: boolean;
     skills?: string[];
 }
-declare function parseUpdateOptions(args: string[]): UpdateCheckOptions;
+declare function parseUpdateOptions(args: string[], callOptions?: {
+    cwd?: string;
+}): UpdateCheckOptions;
 declare function hasProjectSkills(cwd?: string): boolean;
 declare function resolveUpdateScope(options: UpdateCheckOptions): Promise<UpdateScope>;
 declare function matchesSkillFilter(name: string, filter?: string[]): boolean;
-declare function runUpdate(args?: string[]): Promise<void>;
+declare function runUpdate(args?: string[], callOptions?: {
+    cwd?: string;
+}): Promise<void>;
 
-declare function runInstallFromLock(args: string[]): Promise<void>;
+declare function runDoctor(args: string[], callOptions?: {
+    cwd?: string;
+}): Promise<void>;
 
-interface SyncOptions {
-    agent?: string[];
-    yes?: boolean;
+interface StoreOptions {
     force?: boolean;
+    yes?: boolean;
+    json?: boolean;
 }
-declare function runSync(args: string[], options?: SyncOptions): Promise<void>;
-declare function parseSyncOptions(args: string[]): {
-    options: SyncOptions;
+declare function parseStoreOptions(args: string[]): {
+    subcommand: string;
+    restArgs: string[];
 };
+declare function runStore(args: string[], options?: StoreOptions): Promise<number>;
+declare function runStoreList(keyword: string | undefined, options?: StoreOptions): Promise<number>;
+declare function runStoreClean(options?: StoreOptions): Promise<number>;
+declare function runStoreUpdate(keyword: string | undefined, options?: StoreOptions): Promise<number>;
+declare function runStoreRemove(restArgs: string[], options?: StoreOptions): Promise<number>;
 
 interface UseOptions {
     skill?: string;
@@ -542,68 +676,6 @@ declare function materializeUseSkill(skill: UseSkill): Promise<MaterializedUseSk
 declare function runUse(sourceArgs: string[], options?: UseOptions, parseErrors?: string[]): Promise<void>;
 declare function launchAgentInteractively(agent: AgentType, prompt: string, spawnImpl?: AgentSpawn): Promise<number>;
 
-declare const DEFAULT_CLONE_TIMEOUT = 300000;
-interface GitHubRepoInfo {
-    owner: string;
-    repo: string;
-    slug: string;
-    sshUrl: string;
-}
-declare class GitCloneError extends Error {
-    readonly url: string;
-    readonly isTimeout: boolean;
-    readonly isAuthError: boolean;
-    constructor(message: string, url: string, isTimeout?: boolean, isAuthError?: boolean);
-}
-declare function parseGitHubRepoUrl(url: string): GitHubRepoInfo | null;
-declare function isGitHubHttpsCloneUrl(url: string): boolean;
-declare function isGitHubSsoAuthError(message: string): boolean;
-declare function cloneRepo(url: string, ref?: string): Promise<string>;
-declare function cleanupTempDir(dir: string): Promise<void>;
-
-interface SkillSnapshotFile {
-    path: string;
-    contents: string;
-}
-interface SkillDownloadResponse {
-    files: SkillSnapshotFile[];
-    hash: string;
-}
-interface BlobSkill extends Skill {
-    files: SkillSnapshotFile[];
-    snapshotHash: string;
-    repoPath: string;
-}
-declare const BLOB_ALLOWED_REPOS: Record<string, {
-    downloadUrl: (slug: string) => string;
-}>;
-declare function toSkillSlug(name: string): string;
-interface TreeEntry {
-    path: string;
-    type: 'blob' | 'tree';
-    sha: string;
-    size?: number;
-}
-interface RepoTree {
-    sha: string;
-    branch: string;
-    tree: TreeEntry[];
-}
-declare function resetRepoTreeAuthState(): void;
-declare function fetchRepoTree(ownerRepo: string, ref?: string, getToken?: () => string | null): Promise<RepoTree | null>;
-declare function getSkillFolderHashFromTree(tree: RepoTree, skillPath: string): string | null;
-declare function findSkillMdPaths(tree: RepoTree, subpath?: string): string[];
-interface BlobInstallResult {
-    skills: BlobSkill[];
-    tree: RepoTree;
-}
-declare function tryBlobInstall(ownerRepo: string, options?: {
-    subpath?: string;
-    ref?: string;
-    getToken?: () => string | null;
-    includeInternal?: boolean;
-}): Promise<BlobInstallResult | null>;
-
 interface InstallTelemetryData {
     event: 'install';
     source: string;
@@ -635,12 +707,6 @@ interface FindTelemetryData {
     interactive?: '1';
     mode?: 'local' | 'remote';
 }
-interface SyncTelemetryData {
-    event: 'experimental_sync';
-    skillCount: string;
-    successCount: string;
-    agents: string;
-}
 interface CacheCleanAllTelemetryData {
     event: 'cache_clean_all';
     cacheRoot?: string;
@@ -654,7 +720,32 @@ interface CacheRemoveSourceTelemetryData {
     source: string;
     removedSkills?: string;
 }
-type TelemetryData = InstallTelemetryData | RemoveTelemetryData | UpdateTelemetryData | FindTelemetryData | SyncTelemetryData | CacheCleanAllTelemetryData | CacheCleanSourceTelemetryData | CacheRemoveSourceTelemetryData;
+interface StoreCleanTelemetryData {
+    event: 'store_clean';
+}
+interface StoreCleanForceTelemetryData {
+    event: 'store_clean_force';
+}
+interface StoreUpdateTelemetryData {
+    event: 'store_update';
+    keyword?: string;
+    sourceCount?: string;
+    successCount?: string;
+    failCount?: string;
+}
+interface StoreRemoveTelemetryData {
+    event: 'store_remove';
+    source: string;
+    sourceType: string;
+    removedSkills?: string;
+}
+interface StoreRemoveForceTelemetryData {
+    event: 'store_remove_force';
+    source: string;
+    sourceType: string;
+    removedSkills?: string;
+}
+type TelemetryData = InstallTelemetryData | RemoveTelemetryData | UpdateTelemetryData | FindTelemetryData | CacheCleanAllTelemetryData | CacheCleanSourceTelemetryData | CacheRemoveSourceTelemetryData | StoreCleanTelemetryData | StoreCleanForceTelemetryData | StoreUpdateTelemetryData | StoreRemoveTelemetryData | StoreRemoveForceTelemetryData;
 declare function setDetectedAgent(agentName: string | null): void;
 declare function setVersion(version: string): void;
 interface PartnerAudit {
@@ -712,37 +803,6 @@ declare function renderBanner(deps?: SkillsCliDeps): void;
 declare function renderHelp(deps?: SkillsCliDeps): void;
 declare function handleSkillsCli(args: string[], deps?: SkillsCliDeps): Promise<SkillsCliResult>;
 
-type InstallScope = 'project' | 'global';
-type AcquireMode = 'install' | 'update';
-interface AcquireInput extends ParsedSource {
-    mode?: AcquireMode;
-    skillNames?: string[];
-    scope?: InstallScope;
-}
-interface AcquireResult {
-    storeDir: string;
-    cacheHit: boolean;
-    source: 'local-cp' | 'cache-clone' | 'cache-pull' | 'well-known-fetch' | 'blob-fetch';
-}
-declare function getSourceDir({ scope }: {
-    scope: InstallScope;
-}): string;
-declare function getCacheRoot(): string;
-declare function getCacheRepoDir(parsed: ParsedSource): string;
-declare function acquireSourceClone(input: AcquireInput): Promise<AcquireResult>;
-declare function ensureCachedSource(source: {
-    url: string;
-    ref?: string;
-    sourceId: string;
-}): Promise<string>;
-declare function installFromCache({ cachePath, skillName, scope, }: {
-    cachePath: string;
-    skillName: string;
-    scope: InstallScope;
-}): Promise<string>;
-declare function cleanCachedRepo(parsed: ParsedSource): Promise<void>;
-declare function cleanCache(): Promise<void>;
-
 interface SkillsAgentAdapter {
     global: IGlobal;
     instance: IInstance;
@@ -771,4 +831,59 @@ declare function getXdgState(): string;
 declare function getXdgCache(): string;
 declare function getProjectDirectory(): string;
 
-export { AGENTS_DIR, type AddOptions, type AgentConfig, type AgentInstallMatrix, type AgentProcess, type AgentSkillDirsResult, type AgentSpawn, type AgentType, type AuditResponse, BLOB_ALLOWED_REPOS, type BlobInstallResult, type BlobSkill, type CellAction, type CellScope, DEFAULT_CLONE_TIMEOUT, type DiscoverSkillsOptions, type DismissedPrompts, EVE_SUBAGENTS_DIR, type FindOptions, GitCloneError, type HostProvider, type InstallCell, type InstallMode, type InstallScope, type InstallState, type InstalledSkill, type LocalSkillLockEntry, type LocalSkillLockFile, type MaterializedUseSkill, PROJECT_SKILLS_DIR_PATTERN, type ParseFindOptionsResult, type ParseUseOptionsResult, type ParsedSource, type PartnerAudit, type PostInstallInput, type PostInstallResult, type ProviderMatch, type ProviderRegistry, type RemoteSkill as ProviderRemoteSkill, type RemoteSkill$1 as RemoteSkill, type RemoveOptions, type RepoTree, SKILLS_SUBDIR, type SearchSkill, type Skill, type SkillAuditData, type SkillDownloadResponse, type SkillLockEntry, type SkillLockFile, type SkillSnapshotFile, type SkillsAgentAdapter, type SkillsCliDeps, type SkillsCliResult, type SyncOptions, type TreeEntry, UNIVERSAL_SKILLS_DIR, type UniversalScope, type UpdateCheckOptions, type UpdateScope, type UseOptions, type UseSkill, type WellKnownFileContent, type WellKnownIndex, type WellKnownIndexV1, type WellKnownIndexV2, WellKnownProvider, type WellKnownSkill, type WellKnownSkillEntry, type WellKnownSkillEntryV1, type WellKnownSkillEntryV2, acquireSourceClone, addSkillToLocalLock, addSkillToLock, agents, applyActions, buildMatrix, buildUsePrompt, cleanCache, cleanCachedRepo, cleanupTempDir, cloneRepo, computeContentHash, computeSkillFolderHash, detectAgent, detectInstalledAgents, discoverSkills, dismissPrompt, ensureCachedSource, fetchAuditData, fetchRepoTree, fetchSkillFolderHash, filterSkills, findProvider, findSkillMdPaths, flushTelemetry, getAgentAdapter, getAgentBaseDir, getAgentConfig, getAgentGlobalSkillDirs, getAgentName, getAgentProjectSkillContainerPrefixes, getAgentProjectSkillDirs, getAgentSkillDirs, getAgentType, getAllLockedSkills, getCacheRepoDir, getCacheRoot, getCanonicalPath, getCanonicalSkillsDir, getEveSubagentSkillsDir, getEveSubagents, getGitHubToken, getGlobal, getHomeDir, getInstallPath, getInstance, getLastSelectedAgents, getLocalLockPath, getNonUniversalAgents, getOpenClawGlobalSkillsDir, getOwnerRepo, getProjectDirectory, getProviders, getSkillDisplayName, getSkillFolderHashFromTree, getSkillFromLock, getSkillLockPath, getSkillsBySource, getSourceDir, getUniversalAgents, getXdgCache, getXdgConfig, getXdgData, getXdgState, handleSkillsCli, hasAgentAdapter, hasProjectSkills, initTelemetry, installBlobSkillForAgent, installFromCache, installRemoteSkillForAgent, installSkillForAgent, installWellKnownSkillForAgent, isGitHubHttpsCloneUrl, isGitHubSsoAuthError, isPromptDismissed, isRepoPrivate, isRunningInAgent, isSkillInstalled, isSubpathSafe, isUniversalAgent, launchAgentInteractively, listInstalledSkills, matchesSkillFilter, matchesUniversalScope, materializeUseSkill, parseAddOptions, parseFindOptions, parseFrontmatter, parseGitHubRepoUrl, parseListOptions, parseOwnerRepo, parseRemoveOptions, parseSkillMd, parseSource, parseSyncOptions, parseUpdateOptions, parseUseOptions, planActions, probeCell, readLocalLock, readSkillLock, registerProvider, registry, removeCommand, removeSkillFromLocalLock, removeSkillFromLock, renderBanner, renderHelp, requireAgentAdapter, resetGhAuthWarning, resetGlobalAdapter, resetInstanceAdapter, resetRepoTreeAuthState, resolveUpdateScope, runAdd, runFind, runInstallFromLock, runList, runPostInstallReconcile, runSync, runUpdate, runUse, sanitizeMetadata, sanitizeName, sanitizeSubpath, saveSelectedAgents, searchSkillsAPI, setAgentAdapter, setDetectedAgent, setGlobalAdapter, setInstanceAdapter, setVersion, shouldInstallInternalSkills, stripTerminalEscapes, toSkillSlug, track, tryBlobInstall, wellKnownProvider, writeLocalLock, writeSkillLock };
+interface SkillDefinition {
+    name: string;
+    description: string;
+    scope?: 'general' | 'coder' | 'all';
+}
+type PluginSourceCategory = 'builtin' | 'project' | 'global' | 'marketplace' | 'well-known' | 'git' | 'file' | 'local';
+interface PluginSourceEntry {
+    id: string;
+    name: string;
+    description?: string;
+    location: string;
+    category: PluginSourceCategory;
+    metadata?: Record<string, unknown>;
+}
+interface PluginSourceLoadResult {
+    skills: SkillDefinition[];
+    version?: string;
+    author?: {
+        name: string;
+        email?: string;
+    };
+}
+interface PluginSource {
+    readonly id: string;
+    readonly category: PluginSourceCategory;
+    fetch(): Promise<PluginSourceEntry[]>;
+    load(entry: PluginSourceEntry): Promise<PluginSourceLoadResult>;
+}
+
+interface WellKnownSourceOptions {
+    url: string;
+    id?: string;
+    displayName?: string;
+}
+declare function createWellKnownSource(opts: WellKnownSourceOptions): PluginSource;
+
+interface LocalPluginSourceOptions {
+    basePath: string;
+    id?: string;
+    displayName?: string;
+}
+declare function createLocalPluginSource(opts: LocalPluginSourceOptions): PluginSource;
+
+declare function registerSource(source: PluginSource): void;
+declare function listSources(): PluginSource[];
+declare function findSource(id: string): PluginSource | null;
+declare function findSourcesByCategory(category: PluginSourceCategory): PluginSource[];
+declare function listAllEntries(): Promise<Array<{
+    sourceId: string;
+    entries: PluginSourceEntry[];
+} | {
+    sourceId: string;
+    error: Error;
+}>>;
+
+export { AGENTS_DIR, type AddOptions, type AgentConfig, type AgentInstallMatrix, type AgentProcess, type AgentSkillDirsResult, type AgentSpawn, type AgentType, type AuditResponse, BLOB_ALLOWED_REPOS, type BlobInstallResult, type BlobSkill, type CellAction, type CellScope, DEFAULT_CLONE_TIMEOUT, type DiscoverSkillsOptions, type DismissedPrompts, EVE_SUBAGENTS_DIR, type FindOptions, GitCloneError, type HostProvider, type InstallCell, type InstallMode, type InstallScope, type InstallState, type InstalledSkill, type LocalPluginSourceOptions, type LocalSkillLockEntry, type LocalSkillLockFile, type MaterializedUseSkill, PROJECT_SKILLS_DIR_PATTERN, type ParseFindOptionsResult, type ParseUseOptionsResult, type ParsedSource, type PartnerAudit, type PluginSource, type PluginSourceCategory, type PluginSourceEntry, type PluginSourceLoadResult, type PostInstallInput, type PostInstallResult, type ProviderMatch, type ProviderRegistry, type RemoteSkill as ProviderRemoteSkill, type RemoteSkill$1 as RemoteSkill, type RemoveOptions, type RepoTree, SKILLS_SUBDIR, type SearchSkill, type Skill, type SkillAuditData, type SkillDownloadResponse, type SkillLockEntry, type SkillLockFile, type SkillSnapshotFile, type SkillsAgentAdapter, type SkillsCliDeps, type SkillsCliResult, type StoreOptions, type TreeEntry, UNIVERSAL_SKILLS_DIR, type UniversalScope, type UpdateCheckOptions, type UpdateScope, type UseOptions, type UseSkill, type WellKnownFileContent, type WellKnownIndex, type WellKnownIndexV1, type WellKnownIndexV2, WellKnownProvider, type WellKnownSkill, type WellKnownSkillEntry, type WellKnownSkillEntryV1, type WellKnownSkillEntryV2, type WellKnownSourceOptions, acquireSourceClone, addSkillToLocalLock, addSkillToLock, agents, applyActions, buildMatrix, buildUsePrompt, cleanCache, cleanCachedRepo, cleanupTempDir, cloneRepo, computeContentHash, computeSkillFolderHash, createLocalPluginSource, createWellKnownSource, detectAgent, detectInstalledAgents, discoverSkills, dismissPrompt, ensureCachedSource, fetchAuditData, fetchRepoTree, fetchSkillFolderHash, filterSkills, findProvider, findSkillMdPaths, findSource, findSourcesByCategory, flushTelemetry, getAgentAdapter, getAgentBaseDir, getAgentConfig, getAgentGlobalSkillDirs, getAgentName, getAgentProjectSkillContainerPrefixes, getAgentProjectSkillDirs, getAgentSkillDirs, getAgentType, getAllLockedSkills, getCacheRepoDir, getCacheRoot, getCanonicalPath, getCanonicalSkillsDir, getEveSubagentSkillsDir, getEveSubagents, getGitHubToken, getGlobal, getHomeDir, getInstallPath, getInstance, getLocalLockPath, getNonUniversalAgents, getOpenClawGlobalSkillsDir, getOwnerRepo, getProjectDirectory, getProviders, getSkillDisplayName, getSkillFolderHashFromTree, getSkillFromLock, getSkillLockPath, getSkillsBySource, getSourceDir, getUniversalAgents, getXdgCache, getXdgConfig, getXdgData, getXdgState, handleSkillsCli, hasAgentAdapter, hasProjectSkills, initTelemetry, installBlobSkillForAgent, installFromCache, installRemoteSkillForAgent, installSkillForAgent, installWellKnownSkillForAgent, isGitHubHttpsCloneUrl, isGitHubSsoAuthError, isPromptDismissed, isRepoPrivate, isRunningInAgent, isSkillInstalled, isSubpathSafe, isUniversalAgent, launchAgentInteractively, listAllEntries, listInstalledSkills, listSources, matchesSkillFilter, matchesUniversalScope, materializeUseSkill, parseAddOptions, parseFindOptions, parseFrontmatter, parseGitHubRepoUrl, parseListOptions, parseOwnerRepo, parseRemoveOptions, parseSkillMd, parseSource, parseStoreOptions, parseUpdateOptions, parseUseOptions, planActions, probeCell, readLocalLock, readSkillLock, registerProvider, registerSource, registry, removeCommand, removeSkillFromLocalLock, removeSkillFromLock, renderBanner, renderHelp, requireAgentAdapter, resetGhAuthWarning, resetGlobalAdapter, resetInstanceAdapter, resetRepoTreeAuthState, resolveUpdateScope, runAdd, runDoctor, runFind, runList, runPostInstallReconcile, runStore, runStoreClean, runStoreList, runStoreRemove, runStoreUpdate, runUpdate, runUse, sanitizeMetadata, sanitizeName, sanitizeSubpath, searchSkillsAPI, setAgentAdapter, setDetectedAgent, setGlobalAdapter, setInstanceAdapter, setVersion, shouldInstallInternalSkills, stripTerminalEscapes, toSkillSlug, track, tryBlobInstall, wellKnownProvider, writeLocalLock, writeSkillLock };