subagents-sh 0.1.0

package/dist/utils/fetch.js

@@ -0,0 +1,124 @@
+const GITHUB_RAW_BASE = 'https://raw.githubusercontent.com';
+const GITHUB_API_BASE = 'https://api.github.com';
+// Common paths where subagents might be located
+const SEARCH_PATHS = ['.claude/agents', 'agents', '.claude', ''];
+/**
+ * Parse a subagent identifier (owner/repo/name or full GitHub URL)
+ */
+export function parseIdentifier(identifier) {
+    // Handle full GitHub URLs
+    if (identifier.startsWith('https://github.com/')) {
+        const url = new URL(identifier);
+        const parts = url.pathname.split('/').filter(Boolean);
+        if (parts.length >= 2) {
+            const owner = parts[0];
+            const repo = parts[1];
+            // If there's a blob/tree path, extract the file name
+            let name = repo;
+            if (parts.length > 4 && (parts[2] === 'blob' || parts[2] === 'tree')) {
+                // e.g., /owner/repo/blob/main/.claude/agents/agent-name.md
+                const filePath = parts.slice(4).join('/');
+                name = filePath.replace(/\.md$/, '').split('/').pop() || repo;
+            }
+            else if (parts.length > 2) {
+                name = parts[parts.length - 1].replace(/\.md$/, '');
+            }
+            return { owner, repo, name };
+        }
+    }
+    // Handle owner/repo/name format
+    const parts = identifier.split('/');
+    if (parts.length === 3) {
+        return {
+            owner: parts[0],
+            repo: parts[1],
+            name: parts[2].replace(/\.md$/, ''),
+        };
+    }
+    if (parts.length === 2) {
+        // Assume owner/repo, and name is the repo
+        return {
+            owner: parts[0],
+            repo: parts[1],
+            name: parts[1],
+        };
+    }
+    throw new Error(`Invalid identifier format: "${identifier}". Expected owner/repo/name or GitHub URL.`);
+}
+/**
+ * Fetch subagent content from GitHub
+ * Tries multiple paths to find the agent file
+ */
+export async function fetchFromGitHub(owner, repo, name, branch = 'main') {
+    const errors = [];
+    // Try each search path
+    for (const basePath of SEARCH_PATHS) {
+        const filePath = basePath ? `${basePath}/${name}.md` : `${name}.md`;
+        const url = `${GITHUB_RAW_BASE}/${owner}/${repo}/${branch}/${filePath}`;
+        try {
+            const response = await fetch(url);
+            if (response.ok) {
+                const content = await response.text();
+                return {
+                    content,
+                    source: {
+                        owner,
+                        repo,
+                        name,
+                        branch,
+                        path: filePath,
+                    },
+                };
+            }
+            if (response.status !== 404) {
+                errors.push(`${filePath}: HTTP ${response.status}`);
+            }
+        }
+        catch (err) {
+            errors.push(`${filePath}: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        }
+    }
+    // Try with 'master' branch if 'main' didn't work
+    if (branch === 'main') {
+        try {
+            return await fetchFromGitHub(owner, repo, name, 'master');
+        }
+        catch {
+            // Fall through to error
+        }
+    }
+    throw new Error(`Could not find subagent "${name}" in ${owner}/${repo}.\n` +
+        `Searched in: ${SEARCH_PATHS.map((p) => p || '(root)').join(', ')}\n` +
+        `Make sure the file exists at one of these locations.`);
+}
+/**
+ * Check if a GitHub repo exists and is accessible
+ */
+export async function checkRepoExists(owner, repo) {
+    const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}`;
+    try {
+        const response = await fetch(url);
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the default branch for a repository
+ */
+export async function getDefaultBranch(owner, repo) {
+    const url = `${GITHUB_API_BASE}/repos/${owner}/${repo}`;
+    try {
+        const response = await fetch(url);
+        if (response.ok) {
+            const data = (await response.json());
+            return data.default_branch || 'main';
+        }
+    }
+    catch {
+        // Fall through
+    }
+    return 'main';
+}
+//# sourceMappingURL=fetch.js.map

package/dist/utils/fetch.js.map

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

package/dist/utils/fetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fetch.test.d.ts.map

package/dist/utils/fetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.test.d.ts","sourceRoot":"","sources":["../../src/utils/fetch.test.ts"],"names":[],"mappings":""}

package/dist/utils/fetch.test.js

@@ -0,0 +1,246 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { parseIdentifier, fetchFromGitHub, checkRepoExists, getDefaultBranch } from './fetch.js';
+describe('parseIdentifier', () => {
+    it('parses owner/repo/name format', () => {
+        const result = parseIdentifier('owner/repo/agent-name');
+        expect(result).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'agent-name',
+        });
+    });
+    it('parses owner/repo format (name defaults to repo)', () => {
+        const result = parseIdentifier('owner/repo');
+        expect(result).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'repo',
+        });
+    });
+    it('strips .md extension from name', () => {
+        const result = parseIdentifier('owner/repo/agent-name.md');
+        expect(result).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'agent-name',
+        });
+    });
+    it('parses full GitHub URL', () => {
+        const result = parseIdentifier('https://github.com/owner/repo');
+        expect(result).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'repo',
+        });
+    });
+    it('parses GitHub URL with blob path', () => {
+        const result = parseIdentifier('https://github.com/owner/repo/blob/main/.claude/agents/my-agent.md');
+        expect(result).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'my-agent',
+        });
+    });
+    it('parses GitHub URL with tree path', () => {
+        const result = parseIdentifier('https://github.com/owner/repo/tree/main/agents/my-agent.md');
+        expect(result).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'my-agent',
+        });
+    });
+    it('parses GitHub URL with path but no blob/tree', () => {
+        const result = parseIdentifier('https://github.com/owner/repo/my-agent');
+        expect(result).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'my-agent',
+        });
+    });
+    it('throws on invalid format (single part)', () => {
+        expect(() => parseIdentifier('invalid')).toThrow('Invalid identifier format: "invalid"');
+    });
+    it('throws on empty string', () => {
+        expect(() => parseIdentifier('')).toThrow('Invalid identifier format');
+    });
+});
+describe('fetchFromGitHub', () => {
+    let mockFetch;
+    beforeEach(() => {
+        mockFetch = vi.fn();
+        vi.stubGlobal('fetch', mockFetch);
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('tries .claude/agents path first', async () => {
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            text: () => Promise.resolve('# Agent content'),
+        });
+        const result = await fetchFromGitHub('owner', 'repo', 'test-agent', 'main');
+        expect(mockFetch).toHaveBeenCalledTimes(1);
+        expect(mockFetch).toHaveBeenCalledWith('https://raw.githubusercontent.com/owner/repo/main/.claude/agents/test-agent.md');
+        expect(result.content).toBe('# Agent content');
+        expect(result.source).toEqual({
+            owner: 'owner',
+            repo: 'repo',
+            name: 'test-agent',
+            branch: 'main',
+            path: '.claude/agents/test-agent.md',
+        });
+    });
+    it('falls back to agents/ path on 404', async () => {
+        mockFetch
+            .mockResolvedValueOnce({ ok: false, status: 404 }) // .claude/agents
+            .mockResolvedValueOnce({
+            ok: true,
+            text: () => Promise.resolve('# From agents/'),
+        }); // agents/
+        const result = await fetchFromGitHub('owner', 'repo', 'test-agent', 'main');
+        expect(mockFetch).toHaveBeenCalledTimes(2);
+        expect(mockFetch).toHaveBeenNthCalledWith(2, 'https://raw.githubusercontent.com/owner/repo/main/agents/test-agent.md');
+        expect(result.source.path).toBe('agents/test-agent.md');
+    });
+    it('falls back to .claude/ path', async () => {
+        mockFetch
+            .mockResolvedValueOnce({ ok: false, status: 404 }) // .claude/agents
+            .mockResolvedValueOnce({ ok: false, status: 404 }) // agents/
+            .mockResolvedValueOnce({
+            ok: true,
+            text: () => Promise.resolve('# From .claude/'),
+        }); // .claude/
+        const result = await fetchFromGitHub('owner', 'repo', 'test-agent', 'main');
+        expect(mockFetch).toHaveBeenCalledTimes(3);
+        expect(result.source.path).toBe('.claude/test-agent.md');
+    });
+    it('falls back to root path', async () => {
+        mockFetch
+            .mockResolvedValueOnce({ ok: false, status: 404 }) // .claude/agents
+            .mockResolvedValueOnce({ ok: false, status: 404 }) // agents/
+            .mockResolvedValueOnce({ ok: false, status: 404 }) // .claude/
+            .mockResolvedValueOnce({
+            ok: true,
+            text: () => Promise.resolve('# From root'),
+        }); // root
+        const result = await fetchFromGitHub('owner', 'repo', 'test-agent', 'main');
+        expect(mockFetch).toHaveBeenCalledTimes(4);
+        expect(result.source.path).toBe('test-agent.md');
+    });
+    it('tries master branch if main fails', async () => {
+        // All 4 paths fail for main branch
+        mockFetch
+            .mockResolvedValueOnce({ ok: false, status: 404 })
+            .mockResolvedValueOnce({ ok: false, status: 404 })
+            .mockResolvedValueOnce({ ok: false, status: 404 })
+            .mockResolvedValueOnce({ ok: false, status: 404 })
+            // Then succeeds on master
+            .mockResolvedValueOnce({
+            ok: true,
+            text: () => Promise.resolve('# From master'),
+        });
+        const result = await fetchFromGitHub('owner', 'repo', 'test-agent', 'main');
+        expect(mockFetch).toHaveBeenCalledTimes(5);
+        expect(mockFetch).toHaveBeenLastCalledWith('https://raw.githubusercontent.com/owner/repo/master/.claude/agents/test-agent.md');
+        expect(result.source.branch).toBe('master');
+    });
+    it('returns content and source metadata', async () => {
+        const content = '---\nname: Test\n---\n# Content';
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            text: () => Promise.resolve(content),
+        });
+        const result = await fetchFromGitHub('myorg', 'myrepo', 'myagent', 'develop');
+        expect(result).toEqual({
+            content,
+            source: {
+                owner: 'myorg',
+                repo: 'myrepo',
+                name: 'myagent',
+                branch: 'develop',
+                path: '.claude/agents/myagent.md',
+            },
+        });
+    });
+    it('throws descriptive error when not found anywhere', async () => {
+        // Fail all paths for both main and master
+        mockFetch.mockResolvedValue({ ok: false, status: 404 });
+        await expect(fetchFromGitHub('owner', 'repo', 'missing', 'main')).rejects.toThrow('Could not find subagent "missing" in owner/repo');
+    });
+    it('collects non-404 HTTP errors', async () => {
+        mockFetch
+            .mockResolvedValueOnce({ ok: false, status: 500 }) // Server error on first path
+            .mockResolvedValueOnce({ ok: false, status: 404 })
+            .mockResolvedValueOnce({ ok: false, status: 404 })
+            .mockResolvedValueOnce({ ok: false, status: 404 })
+            .mockResolvedValue({ ok: false, status: 404 }); // master fallback
+        await expect(fetchFromGitHub('owner', 'repo', 'agent', 'main')).rejects.toThrow();
+    });
+    it('handles network errors gracefully', async () => {
+        mockFetch.mockRejectedValue(new Error('Network error'));
+        await expect(fetchFromGitHub('owner', 'repo', 'agent', 'main')).rejects.toThrow();
+    });
+});
+describe('checkRepoExists', () => {
+    let mockFetch;
+    beforeEach(() => {
+        mockFetch = vi.fn();
+        vi.stubGlobal('fetch', mockFetch);
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('returns true for existing repo', async () => {
+        mockFetch.mockResolvedValueOnce({ ok: true });
+        const result = await checkRepoExists('owner', 'repo');
+        expect(result).toBe(true);
+        expect(mockFetch).toHaveBeenCalledWith('https://api.github.com/repos/owner/repo');
+    });
+    it('returns false for non-existing repo', async () => {
+        mockFetch.mockResolvedValueOnce({ ok: false, status: 404 });
+        const result = await checkRepoExists('owner', 'nonexistent');
+        expect(result).toBe(false);
+    });
+    it('returns false on network error', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('Network error'));
+        const result = await checkRepoExists('owner', 'repo');
+        expect(result).toBe(false);
+    });
+});
+describe('getDefaultBranch', () => {
+    let mockFetch;
+    beforeEach(() => {
+        mockFetch = vi.fn();
+        vi.stubGlobal('fetch', mockFetch);
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('returns default_branch from API response', async () => {
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({ default_branch: 'develop' }),
+        });
+        const result = await getDefaultBranch('owner', 'repo');
+        expect(result).toBe('develop');
+    });
+    it('returns main when API response has no default_branch', async () => {
+        mockFetch.mockResolvedValueOnce({
+            ok: true,
+            json: () => Promise.resolve({}),
+        });
+        const result = await getDefaultBranch('owner', 'repo');
+        expect(result).toBe('main');
+    });
+    it('returns main on API error', async () => {
+        mockFetch.mockResolvedValueOnce({ ok: false, status: 404 });
+        const result = await getDefaultBranch('owner', 'repo');
+        expect(result).toBe('main');
+    });
+    it('returns main on network error', async () => {
+        mockFetch.mockRejectedValueOnce(new Error('Network error'));
+        const result = await getDefaultBranch('owner', 'repo');
+        expect(result).toBe('main');
+    });
+});
+//# sourceMappingURL=fetch.test.js.map

package/dist/utils/fetch.test.js.map

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

package/dist/utils/install.d.ts

@@ -0,0 +1,68 @@
+import type { ParsedSubagent, StorageScope } from '../types.js';
+/**
+ * Parse a subagent markdown file content
+ */
+export declare function parseSubagent(content: string): ParsedSubagent;
+export interface InstallOptions {
+    force?: boolean;
+    scope?: StorageScope;
+}
+/**
+ * Install a subagent from an identifier (owner/repo/name or GitHub URL)
+ * @param identifier - The subagent identifier
+ * @param options - Installation options including scope ('global' or 'local')
+ */
+export declare function installSubagent(identifier: string, options?: InstallOptions): Promise<{
+    name: string;
+    path: string;
+    isUpdate: boolean;
+    scope: StorageScope;
+}>;
+export interface UninstallOptions {
+    scope?: StorageScope;
+}
+/**
+ * Uninstall a subagent
+ * @param name - Subagent name
+ * @param options - Uninstall options including scope ('global' or 'local')
+ *                  If scope is not specified, auto-detects the location
+ */
+export declare function uninstallSubagent(name: string, options?: UninstallOptions): {
+    path: string;
+    scope: StorageScope;
+};
+export interface UpdateOptions {
+    scope?: StorageScope;
+}
+/**
+ * Update all installed subagents in a given scope
+ * @param options - Update options including scope ('global' or 'local')
+ * @param onProgress - Progress callback
+ */
+export declare function updateAllSubagents(options?: UpdateOptions, onProgress?: (name: string, status: 'updating' | 'updated' | 'error', error?: string) => void): Promise<{
+    updated: string[];
+    errors: Array<{
+        name: string;
+        error: string;
+    }>;
+}>;
+/**
+ * Update all subagents in both scopes
+ */
+export declare function updateAllScopesSubagents(onProgress?: (name: string, scope: StorageScope, status: 'updating' | 'updated' | 'error', error?: string) => void): Promise<{
+    global: {
+        updated: string[];
+        errors: Array<{
+            name: string;
+            error: string;
+        }>;
+    };
+    local: {
+        updated: string[];
+        errors: Array<{
+            name: string;
+            error: string;
+        }>;
+    };
+}>;
+//# sourceMappingURL=install.d.ts.map

package/dist/utils/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/utils/install.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAA0C,YAAY,EAAE,MAAM,aAAa,CAAC;AAExG;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAa7D;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC,CA2DjF;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,gBAAqB,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA6BvC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,aAAkB,EAC3B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,GAC5F,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAsBhF;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,GACjH,OAAO,CAAC;IACT,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC9E,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;CAC9E,CAAC,CAeD"}

package/dist/utils/install.js

@@ -0,0 +1,140 @@
+import * as fs from 'node:fs';
+import matter from 'gray-matter';
+import { getSubagentPath, subagentExists, findSubagentScope } from './paths.js';
+import { addToManifest, getFromManifest, removeFromManifest, listManifestSubagents } from './manifest.js';
+import { fetchFromGitHub, parseIdentifier, getDefaultBranch } from './fetch.js';
+import { sendTelemetry } from './telemetry.js';
+/**
+ * Parse a subagent markdown file content
+ */
+export function parseSubagent(content) {
+    const { data, content: body } = matter(content);
+    const frontmatter = data;
+    if (!frontmatter.name) {
+        throw new Error('Subagent is missing required "name" field in frontmatter');
+    }
+    return {
+        frontmatter,
+        content: body.trim(),
+        raw: content,
+    };
+}
+/**
+ * Install a subagent from an identifier (owner/repo/name or GitHub URL)
+ * @param identifier - The subagent identifier
+ * @param options - Installation options including scope ('global' or 'local')
+ */
+export async function installSubagent(identifier, options = {}) {
+    const { owner, repo, name } = parseIdentifier(identifier);
+    const scope = options.scope ?? 'global';
+    // Check if already installed in the target scope
+    const existing = getFromManifest(name, scope);
+    const fileExists = subagentExists(name, scope);
+    if ((existing || fileExists) && !options.force) {
+        throw new Error(`Subagent "${name}" is already installed in ${scope} scope. Use --force to overwrite.`);
+    }
+    const isUpdate = !!existing;
+    // Get default branch
+    const branch = await getDefaultBranch(owner, repo);
+    // Fetch the subagent content
+    const result = await fetchFromGitHub(owner, repo, name, branch);
+    // Parse and validate the content
+    const parsed = parseSubagent(result.content);
+    // Write the file
+    const filePath = getSubagentPath(name, scope);
+    fs.writeFileSync(filePath, result.content);
+    // Update manifest
+    const now = new Date().toISOString();
+    const subagentInfo = {
+        name: parsed.frontmatter.name,
+        path: filePath,
+        source: `${owner}/${repo}/${name}`,
+        description: parsed.frontmatter.description,
+        tools: parsed.frontmatter.tools,
+        installedAt: existing?.installedAt || now,
+        updatedAt: now,
+    };
+    addToManifest(name, subagentInfo, scope);
+    // Send telemetry (fire and forget)
+    const subagentId = `${owner}/${repo}/${name}`;
+    sendTelemetry(subagentId, 'download', {
+        owner,
+        repo,
+        name,
+        isUpdate,
+        scope,
+    });
+    return {
+        name,
+        path: filePath,
+        isUpdate,
+        scope,
+    };
+}
+/**
+ * Uninstall a subagent
+ * @param name - Subagent name
+ * @param options - Uninstall options including scope ('global' or 'local')
+ *                  If scope is not specified, auto-detects the location
+ */
+export function uninstallSubagent(name, options = {}) {
+    // Auto-detect scope if not specified
+    let scope = options.scope;
+    if (!scope) {
+        const foundScope = findSubagentScope(name);
+        if (!foundScope) {
+            throw new Error(`Subagent "${name}" is not installed.`);
+        }
+        scope = foundScope;
+    }
+    const filePath = getSubagentPath(name, scope);
+    const existing = getFromManifest(name, scope);
+    const fileExists = subagentExists(name, scope);
+    if (!existing && !fileExists) {
+        throw new Error(`Subagent "${name}" is not installed in ${scope} scope.`);
+    }
+    // Remove file if it exists
+    if (fileExists) {
+        fs.unlinkSync(filePath);
+    }
+    // Remove from manifest
+    removeFromManifest(name, scope);
+    return { path: filePath, scope };
+}
+/**
+ * Update all installed subagents in a given scope
+ * @param options - Update options including scope ('global' or 'local')
+ * @param onProgress - Progress callback
+ */
+export async function updateAllSubagents(options = {}, onProgress) {
+    const scope = options.scope ?? 'global';
+    const installed = listManifestSubagents(scope);
+    const updated = [];
+    const errors = [];
+    for (const subagent of installed) {
+        onProgress?.(subagent.name, 'updating');
+        try {
+            await installSubagent(subagent.source, { force: true, scope });
+            updated.push(subagent.name);
+            onProgress?.(subagent.name, 'updated');
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : 'Unknown error';
+            errors.push({ name: subagent.name, error: errorMessage });
+            onProgress?.(subagent.name, 'error', errorMessage);
+        }
+    }
+    return { updated, errors };
+}
+/**
+ * Update all subagents in both scopes
+ */
+export async function updateAllScopesSubagents(onProgress) {
+    const globalResult = await updateAllSubagents({ scope: 'global' }, onProgress ? (name, status, error) => onProgress(name, 'global', status, error) : undefined);
+    const localResult = await updateAllSubagents({ scope: 'local' }, onProgress ? (name, status, error) => onProgress(name, 'local', status, error) : undefined);
+    return {
+        global: globalResult,
+        local: localResult,
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/utils/install.js.map

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

package/dist/utils/install.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=install.test.d.ts.map

package/dist/utils/install.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.test.d.ts","sourceRoot":"","sources":["../../src/utils/install.test.ts"],"names":[],"mappings":""}