@agentplugins/core 0.1.0 → 0.2.0

package/dist/store.d.ts

@@ -0,0 +1,178 @@
+/**
+ * AgentPlugins Universal Store
+ *
+ * Manages the universal plugin store at ~/.agents/plugins/<name>/.
+ * Clones plugins from GitHub, symlinks them into every detected agent harness.
+ * Skills.sh compatible — reads SKILL.md and scans ~/.agents/skills/.
+ */
+export interface AgentPathEntry {
+    name: string;
+    displayName: string;
+    skillPath: string;
+    binary: string;
+    manifestPath: string;
+}
+export interface PluginMeta {
+    /** Canonical plugin name (from manifest) */
+    name: string;
+    /** Source URL (normalized GitHub URL) */
+    source: string;
+    /** Git commit hash at install time */
+    commit: string;
+    /** ISO timestamp of initial install */
+    installedAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+    /** Relative path to manifest within the store dir */
+    manifestPath: string;
+    /** Plugin version from manifest */
+    version: string;
+}
+export interface DetectedAgent {
+    name: string;
+    displayName: string;
+    /** Absolute path to the agent's skill/plugin directory */
+    skillPath: string;
+    /** Binary name to check */
+    binary: string;
+    /** Whether the binary was found on PATH */
+    binaryFound: boolean;
+    /** Whether the skillPath directory exists */
+    skillPathExists: boolean;
+    /** Path to the agent's config/manifest file */
+    manifestPath: string;
+}
+export interface SymlinkInfo {
+    agent: string;
+    agentDisplayName: string;
+    /** Path of the symlink */
+    linkPath: string;
+    /** Resolved target of the symlink */
+    targetPath: string;
+    /** Whether the symlink is valid (points to existing target) */
+    valid: boolean;
+}
+export interface InstalledPlugin {
+    meta: PluginMeta;
+    /** Absolute path in the store */
+    path: string;
+    /** Parsed manifest (best-effort) */
+    manifest: Record<string, unknown> | null;
+    /** Symlinks across detected agents */
+    symlinks: SymlinkInfo[];
+}
+export interface ManifestFindResult {
+    /** Relative path to the manifest file within the dir */
+    path: string;
+    /** Parsed manifest object */
+    manifest: Record<string, unknown>;
+    /** Type of manifest found */
+    type: 'json' | 'skill-md';
+}
+export declare const AGENT_PATHS: readonly AgentPathEntry[];
+/** Expand ~ to the home directory */
+export declare function expandHome(p: string): string;
+/** Universal plugin store path: ~/.agents/plugins */
+export declare function getStorePath(): string;
+/** Skills.sh compatibility path: ~/.agents/skills */
+export declare function getSkillsCompatPath(): string;
+/** Path for a specific plugin in the store */
+export declare function getPluginStorePath(name: string): string;
+/** Path to the meta file for a plugin */
+export declare function getMetaPath(name: string): string;
+export declare function getAgentPaths(): readonly AgentPathEntry[];
+/**
+ * Detect installed agent harnesses.
+ * An agent is "detected" if its binary is on PATH or its skillPath exists.
+ */
+export declare function detectAgents(): DetectedAgent[];
+/** Get only agents that are actually installed (binary or skill path) */
+export declare function getDetectedAgents(): DetectedAgent[];
+/**
+ * Normalize a plugin source URL.
+ * Accepts: https://github.com/u/r, git@github.com:u/r.git, u/r
+ */
+export declare function normalizeSource(source: string): string;
+/** Extract the repo name from a GitHub URL */
+export declare function extractRepoName(source: string): string;
+/** Ensure the store and skills-compat directories exist */
+export declare function initStore(): void;
+/**
+ * Clone a git repository to a destination directory.
+ * Returns the commit hash.
+ * Throws on failure.
+ */
+export declare function cloneRepo(source: string, dest: string): string;
+/** Pull latest changes in a repo directory. Returns new commit hash. */
+export declare function pullRepo(dir: string): string;
+/**
+ * Find and parse a JSON manifest in a directory.
+ * Does NOT handle TypeScript configs (callers should use jiti for those).
+ * Falls back to SKILL.md synthesis for Skills.sh compatibility.
+ */
+export declare function findManifestInDir(dir: string): ManifestFindResult | null;
+/** Read the meta file for a plugin */
+export declare function readMeta(name: string): PluginMeta | null;
+/** Write the meta file for a plugin */
+export declare function writeMeta(meta: PluginMeta): void;
+export interface InstallOptions {
+    /** Source URL */
+    source: string;
+    /** Canonical plugin name (from manifest) */
+    name: string;
+    /** Commit hash */
+    commit: string;
+    /** Relative path to manifest within the plugin dir */
+    manifestPath: string;
+    /** Version from manifest */
+    version: string;
+    /** Whether to symlink into detected agents (default: true) */
+    symlink?: boolean;
+}
+export interface InstallResult {
+    meta: PluginMeta;
+    symlinks: SymlinkInfo[];
+}
+/**
+ * Install a plugin into the store from a cloned directory.
+ * Moves the directory to the store, writes meta, creates symlinks.
+ */
+export declare function installPlugin(cloneDir: string, opts: InstallOptions): InstallResult;
+/**
+ * Full add flow: clone from source, find manifest, install.
+ * Returns null if no manifest is found (caller can try TS loading).
+ */
+export declare function addPluginFromSource(source: string): InstallResult | null;
+/** Remove a plugin: unlink all symlinks, delete from store */
+export declare function removePlugin(name: string): void;
+/** List all installed plugins */
+export declare function listPlugins(): InstalledPlugin[];
+/** Get detailed info about a single plugin */
+export declare function getPluginInfo(name: string): InstalledPlugin | null;
+/** Update a plugin: git pull + update meta + refresh symlinks */
+export declare function updatePlugin(name: string): PluginMeta;
+/**
+ * Create a symlink from agent's skillPath to the plugin store dir.
+ * Returns null if the agent's skillPath doesn't exist.
+ */
+export declare function symlinkPlugin(pluginName: string, agent: DetectedAgent): SymlinkInfo | null;
+/** Remove a plugin's symlink from an agent's skillPath */
+export declare function unlinkPluginSymlink(pluginName: string, agent: DetectedAgent): void;
+/** Get all symlinks for a plugin across agents */
+export declare function getSymlinks(pluginName: string, agents?: DetectedAgent[]): SymlinkInfo[];
+export interface DoctorResult {
+    storePath: string;
+    storeExists: boolean;
+    skillsCompatPath: string;
+    skillsCompatExists: boolean;
+    agents: DetectedAgent[];
+    plugins: InstalledPlugin[];
+    issues: DoctorIssue[];
+}
+export interface DoctorIssue {
+    level: 'error' | 'warning' | 'info';
+    message: string;
+}
+/** Run diagnostics on the store, agents, and symlinks */
+export declare function runDoctor(): DoctorResult;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}