@easbot/skills 0.3.11 → 0.3.13

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-import { AgentResult } from '@vercel/detect-agent';
 import { Lang } from '@easbot/utils';
 import { IGlobal, IInstance, ISubAgentRunner } from '@easbot/types';
 
@@ -17,9 +16,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 +43,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 +55,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?: {
@@ -71,7 +67,10 @@ interface DiscoverSkillsOptions {
 }
 declare function isSubpathSafe(basePath: string, subpath: string): boolean;
 declare function discoverSkills(basePath: string, subpath?: string, options?: DiscoverSkillsOptions): Promise<Skill[]>;
-declare function getSkillDisplayName(skill: Skill): string;
+declare function getSkillDisplayName(skill: {
+    name: string;
+    path?: string;
+}): string;
 declare function filterSkills(skills: Skill[], inputNames: string[]): Skill[];
 
 type InstallState = 'absent' | 'symlinked' | 'copied' | 'orphan' | 'divergent';
@@ -188,8 +187,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 +221,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 +251,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 +285,7 @@ interface InstallResult {
     mode: InstallMode;
     symlinkFailed?: boolean;
     skipped?: boolean;
+    skippedReason?: 'overwrite' | 'up-to-date';
     error?: string;
 }
 declare function sanitizeName(name: string): string;
@@ -323,7 +347,7 @@ interface InstalledSkill {
     agents: AgentType[];
 }
 declare function listInstalledSkills(options?: {
-    global?: boolean;
+    scope?: 'project' | 'global' | 'both';
     cwd?: string;
     agentFilter?: AgentType[];
 }): Promise<InstalledSkill[]>;
@@ -348,6 +372,7 @@ interface AddOptions {
     fullDepth?: boolean;
     copy?: boolean;
     subagent?: string[];
+    json?: boolean;
 }
 declare function runAdd(args: string[], options?: AddOptions): Promise<void>;
 declare function parseAddOptions(args: string[]): {
@@ -385,7 +410,110 @@ 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 | Buffer;
+}
+interface SkillDownloadResponse {
+    files: SkillSnapshotFile[];
+    hash: string;
+}
+interface BlobSkill extends Skill {
+    files: SkillSnapshotFile[];
+    snapshotHash: string;
+    repoPath: string;
+    repoSubpath?: 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, options?: {
+    subpath?: string;
+    maxDepth?: number;
+    limit?: number;
+}): string[];
+interface BlobInstallResult {
+    skills: BlobSkill[];
+    tree: RepoTree;
+    subpath?: string;
+    snapshotHash?: string;
+}
+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;
@@ -393,6 +521,7 @@ interface RemoveOptions {
     skill?: string[];
     yes?: boolean;
     all?: boolean;
+    json?: boolean;
 }
 declare function removeCommand(skillNames: string[], options: RemoveOptions): Promise<void>;
 declare function parseRemoveOptions(args: string[]): {
@@ -403,13 +532,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 +548,6 @@ interface SkillLockFile {
     version: number;
     skills: Record<string, SkillLockEntry>;
     dismissed?: DismissedPrompts;
-    lastSelectedAgents?: string[];
 }
 declare function getSkillLockPath(): string;
 declare function readSkillLock(): Promise<SkillLockFile>;
@@ -437,8 +566,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 +573,11 @@ interface LocalSkillLockEntry {
     sourceType: string;
     skillPath?: string;
     computedHash: string;
+    installedAt: string;
+    updatedAt: string;
+    marketId: string;
+    pluginId: string;
+    marketplaceId?: string;
     subagents?: string[];
 }
 interface LocalSkillLockFile {
@@ -455,36 +587,49 @@ interface LocalSkillLockFile {
 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;
+    json?: 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;
@@ -492,6 +637,7 @@ interface UseOptions {
     fullDepth?: boolean;
     dangerouslyAcceptOpenclawRisks?: boolean;
     help?: boolean;
+    json?: boolean;
 }
 interface ParseUseOptionsResult {
     source: string[];
@@ -505,7 +651,7 @@ type UseSkill = {
     rawContent: string;
     files: Array<{
         path: string;
-        contents: string;
+        contents: string | Buffer;
     }>;
 } | {
     kind: 'disk';
@@ -542,67 +688,11 @@ 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 {
+declare function computeFromDir(skillDir: string): Promise<string>;
+declare function computeSnapshotHash(files: ReadonlyArray<{
     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>;
+    contents: string | Buffer;
+}>): string;
 
 interface InstallTelemetryData {
     event: 'install';
@@ -635,12 +725,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 +738,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 {
@@ -672,6 +781,32 @@ declare function flushTelemetry(timeoutMs?: number): Promise<void>;
 declare function stripTerminalEscapes(str: string): string;
 declare function sanitizeMetadata(str: string): string;
 
+declare const EASBOT: "easbot";
+declare const CURSOR: "cursor";
+declare const CURSOR_CLI: "cursor-cli";
+declare const CLAUDE: "claude";
+declare const COWORK: "cowork";
+declare const DEVIN: "devin";
+declare const REPLIT: "replit";
+declare const GEMINI: "gemini";
+declare const CODEX: "codex";
+declare const ANTIGRAVITY: "antigravity";
+declare const AUGMENT_CLI: "augment-cli";
+declare const OPENCODE: "opencode";
+declare const GITHUB_COPILOT: "github-copilot";
+declare const V0: "v0";
+type KnownAgentNames = typeof EASBOT | typeof CURSOR | typeof CURSOR_CLI | typeof CLAUDE | typeof COWORK | typeof DEVIN | typeof REPLIT | typeof GEMINI | typeof CODEX | typeof ANTIGRAVITY | typeof AUGMENT_CLI | typeof OPENCODE | typeof GITHUB_COPILOT | typeof V0;
+interface KnownAgentDetails {
+    name: KnownAgentNames;
+}
+type AgentResult = {
+    isAgent: true;
+    agent: KnownAgentDetails;
+} | {
+    isAgent: false;
+    agent: undefined;
+};
+
 declare function detectAgent(): Promise<AgentResult>;
 declare function isRunningInAgent(): Promise<boolean>;
 declare function getAgentName(): Promise<string | null>;
@@ -712,37 +847,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 +875,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, computeFromDir, computeSnapshotHash, 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 };