forgebadger 0.1.1 → 0.1.2

package/dist/gateway/src/services/skill-discovery.js

@@ -0,0 +1,363 @@
+import { z } from "zod";
+import { CatalogRepository, } from "../db/repositories/catalog-repository.js";
+import { SkillRepository } from "../db/repositories/skill-repository.js";
+import { UserRepository } from "../db/repositories/user-repository.js";
+import { parseGitHubSkillLocator, parseSkillRemoteProvenance, } from "./github-skill-source.js";
+import { MARKETPLACE_SEEDS, refreshGitHubMarketplace, } from "./skill-marketplaces.js";
+import { registryJson, SkillRegistryHttpError } from "./skill-registry-http.js";
+import { skillLocatorSchema, } from "./skill-registry-package.js";
+import { SkillLifecycleError } from "./skill-install-service.js";
+const object = z.record(z.unknown());
+const string = (value) => (typeof value === "string" ? value : "");
+const record = (value) => object.safeParse(value).success ? object.parse(value) : {};
+export class SkillDiscoveryService {
+    db;
+    options;
+    refreshing = new Map();
+    cache = new Map();
+    searching = new Map();
+    backoff = new Map();
+    constructor(db, options = {}) {
+        this.db = db;
+        this.options = options;
+    }
+    sources(userId) {
+        return new CatalogRepository(this.db, userId)
+            .listSources()
+            .filter((source) => source.type === "skill");
+    }
+    bootstrap(userId) {
+        const repo = new CatalogRepository(this.db, userId);
+        for (const seed of MARKETPLACE_SEEDS) {
+            const existing = repo.getSource(`github:${seed}`);
+            if (existing?.status === "disabled")
+                continue;
+            const last = existing?.updatedAt?.getTime() ?? 0;
+            if (!existing || Date.now() - last > 15 * 60_000)
+                void this.refresh(userId, seed).catch(() => undefined);
+        }
+    }
+    async refresh(userId, input) {
+        this.assertActive(userId);
+        const locator = parseGitHubSkillLocator(input);
+        if (locator.subpath || locator.ref)
+            throw new SkillLifecycleError("Use owner/repo for a catalog source", 400);
+        const repoName = `${locator.owner}/${locator.repo}`.toLowerCase();
+        const sourceId = `github:${repoName}`;
+        const key = `${userId}:${sourceId}`;
+        if (this.refreshing.has(key))
+            return this.refreshing.get(key);
+        if (this.refreshing.size >= 8)
+            throw new SkillLifecycleError("Source synchronization is busy; retry shortly", 429);
+        const repository = new CatalogRepository(this.db, userId);
+        if (!repository.getSource(sourceId) && this.sources(userId).length >= 20)
+            throw new SkillLifecycleError("At most 20 Skill sources can be configured");
+        const existing = repository.getSource(sourceId);
+        if (!existing)
+            repository.upsertSource({
+                sourceId,
+                type: "skill",
+                label: repoName,
+                url: `https://github.com/${repoName}`,
+            });
+        repository.setSourceStatus(sourceId, "syncing");
+        const promise = (async () => {
+            try {
+                const result = await refreshGitHubMarketplace({
+                    db: this.db,
+                    userId,
+                    repo: repoName,
+                    ...this.options,
+                    signal: AbortSignal.timeout(60000),
+                });
+                this.assertActive(userId);
+                repository.setSourceStatus(sourceId, result.skipped.length ? `partial:${result.skipped.length}` : "active");
+                return result;
+            }
+            catch (error) {
+                repository.setSourceStatus(sourceId, "error");
+                throw error;
+            }
+            finally {
+                this.refreshing.delete(key);
+            }
+        })();
+        this.refreshing.set(key, promise);
+        return promise;
+    }
+    remove(userId, sourceId) {
+        this.assertActive(userId);
+        const repository = new CatalogRepository(this.db, userId);
+        if (this.refreshing.has(`${userId}:${sourceId}`))
+            throw new SkillLifecycleError("Wait for source synchronization before removing it");
+        const source = repository.getSource(sourceId);
+        if (!source)
+            return;
+        repository.replaceItems(sourceId, [], "skill");
+        repository.setSourceStatus(sourceId, "disabled");
+    }
+    async search(userId, input) {
+        this.assertActive(userId);
+        const catalogCandidates = new CatalogRepository(this.db, userId)
+            .listItems()
+            .filter((item) => item.itemType === "skill")
+            .flatMap((item) => {
+            const candidate = catalogCandidate(item);
+            return candidate ? [candidate] : [];
+        });
+        const items = [];
+        const statuses = [];
+        if (input.provider === "all" || input.provider === "github") {
+            const query = input.q.toLowerCase().split(/\s+/u).filter(Boolean);
+            for (const candidate of catalogCandidates) {
+                if (candidate &&
+                    query.every((term) => `${candidate.name} ${candidate.description} ${candidate.sourceLabel}`
+                        .toLowerCase()
+                        .includes(term)))
+                    items.push(candidate);
+            }
+            const sources = this.sources(userId);
+            const errors = sources.filter((source) => source.status === "error" || source.status.startsWith("partial:")).length;
+            statuses.push({
+                provider: "github",
+                status: sources.some((source) => source.status === "syncing")
+                    ? "syncing"
+                    : errors
+                        ? "error"
+                        : "cached",
+                ...(errors
+                    ? {
+                        message: `${errors} source(s) could not be fully refreshed; cached results retained`,
+                    }
+                    : {}),
+            });
+        }
+        const providers = [];
+        if (input.q.length >= 2 &&
+            (input.provider === "all" || input.provider === "clawhub"))
+            providers.push("clawhub");
+        if (input.q.length >= 2 &&
+            input.includeSkillsSh &&
+            (input.provider === "all" || input.provider === "skills-sh"))
+            providers.push("skills-sh");
+        await Promise.all(providers.map(async (provider) => {
+            const key = `${provider}:${input.q.toLowerCase()}`;
+            const cached = this.cache.get(key);
+            try {
+                if (cached && cached.until > Date.now()) {
+                    items.push(...cached.items);
+                    statuses.push({ provider, status: "cached" });
+                    return;
+                }
+                if ((this.backoff.get(provider) ?? 0) > Date.now())
+                    throw new Error("Source is rate-limited; retry later");
+                let running = this.searching.get(key);
+                if (!running) {
+                    if (this.searching.size >= 8)
+                        throw new Error("Skill search is busy; retry shortly");
+                    running = this.remoteSearch(provider, input.q).finally(() => this.searching.delete(key));
+                    this.searching.set(key, running);
+                }
+                const found = await running;
+                while (this.cache.size >= 100)
+                    this.cache.delete(this.cache.keys().next().value);
+                this.cache.set(key, { until: Date.now() + 60_000, items: found });
+                items.push(...found);
+                statuses.push({ provider, status: "ready" });
+            }
+            catch (error) {
+                if (error instanceof SkillRegistryHttpError && error.status === 429)
+                    this.backoff.set(provider, Date.now() + (error.retryAfter ?? 60) * 1000);
+                if (cached)
+                    items.push(...cached.items);
+                statuses.push({
+                    provider,
+                    status: "error",
+                    message: error instanceof Error ? error.message : "Source unavailable",
+                });
+            }
+        }));
+        this.assertActive(userId);
+        const owned = new SkillRepository(this.db, userId).listOwned();
+        const installed = new Map();
+        const aliases = new Map();
+        const remember = (repo, name, id) => {
+            const key = `${repo.toLowerCase()}/name:${name.toLowerCase()}`;
+            const matches = aliases.get(key) ?? new Set();
+            matches.add(id);
+            aliases.set(key, matches);
+        };
+        // Resolve aliases only from a known path in this user's catalog or installed provenance.
+        for (const candidate of catalogCandidates)
+            if (candidate.locator.kind === "github" && candidate.locator.path) {
+                remember(candidate.locator.repo, candidate.name, candidate.id);
+                const parts = candidate.locator.path.split("/");
+                remember(candidate.locator.repo, parts.at(-2) ?? candidate.locator.repo.split("/")[1], candidate.id);
+            }
+        for (const skill of owned) {
+            const origin = parseSkillRemoteProvenance(skill.remoteProvenance);
+            if (!origin)
+                continue;
+            const path = origin.path.endsWith("SKILL.md")
+                ? origin.path
+                : `${origin.path}/SKILL.md`;
+            const id = origin.canonicalId ?? `github:${origin.repo.toLowerCase()}/${path}`;
+            installed.set(id, skill.id);
+            if (origin.kind === "github" || origin.kind === "marketplace") {
+                remember(origin.repo, skill.name, id);
+                remember(origin.repo, path.split("/").at(-2) ?? origin.repo.split("/")[1], id);
+                if (origin.locator?.kind === "github" && origin.locator.skillName)
+                    remember(origin.repo, origin.locator.skillName, id);
+            }
+        }
+        const seen = new Set();
+        const candidates = [];
+        for (const candidate of items) {
+            const locator = candidate.locator;
+            const matches = locator.kind === "github" && locator.skillName
+                ? aliases.get(`${locator.repo.toLowerCase()}/name:${locator.skillName.toLowerCase()}`)
+                : undefined;
+            const id = matches?.size === 1 ? [...matches][0] : candidate.id;
+            if (seen.has(id))
+                continue;
+            seen.add(id);
+            candidates.push({
+                ...candidate,
+                id,
+                installedSkillId: installed.get(id),
+            });
+        }
+        const offset = input.page * 20;
+        return {
+            items: candidates.slice(offset, offset + 20),
+            total: candidates.length,
+            page: input.page,
+            hasMore: offset + 20 < candidates.length,
+            statuses,
+        };
+    }
+    async remoteSearch(provider, q) {
+        if (provider === "skills-sh") {
+            const data = record(await registryJson(`https://skills.sh/api/search?${new URLSearchParams({ q, limit: "50" })}`, this.options));
+            return z
+                .array(z.unknown())
+                .max(200)
+                .parse(data.skills)
+                .flatMap((value) => {
+                const item = record(value);
+                const repo = string(item.source);
+                const skillName = string(item.skillId) || string(item.name);
+                try {
+                    parseGitHubSkillLocator(repo);
+                    if (repo.split("/").length !== 2 || !skillName)
+                        return [];
+                }
+                catch {
+                    return [];
+                }
+                return [
+                    {
+                        id: `github:${repo}/name:${skillName}`,
+                        name: skillName,
+                        description: "",
+                        provider: "skills-sh",
+                        sourceLabel: repo,
+                        sourceUrl: `https://skills.sh/${repo}/${encodeURIComponent(skillName)}`,
+                        locator: { kind: "github", repo, skillName },
+                    },
+                ];
+            });
+        }
+        const data = record(await registryJson(`https://clawhub.ai/api/v1/search?${new URLSearchParams({ q, limit: "50", nonSuspiciousOnly: "true" })}`, this.options));
+        return z
+            .array(z.unknown())
+            .max(200)
+            .parse(data.results)
+            .flatMap((value) => {
+            const item = record(value);
+            const install = record(item.install);
+            const identity = record(item.sourceIdentity);
+            const owner = string(item.ownerHandle) || string(record(item.owner).handle);
+            const slug = string(item.slug);
+            if (!owner || !slug)
+                return [];
+            const trust = record(item.trust);
+            if (trust.installability && trust.installability !== "installable")
+                return [];
+            if (item.source === "skills-sh" || install.kind === "skills-sh") {
+                const repoName = string(identity.repo);
+                if (!repoName)
+                    return [];
+                const repo = `${owner}/${repoName}`;
+                try {
+                    parseGitHubSkillLocator(repo);
+                }
+                catch {
+                    return [];
+                }
+                return [
+                    {
+                        id: `github:${repo}/name:${slug}`,
+                        name: string(item.displayName) || slug,
+                        description: string(item.summary).slice(0, 4096),
+                        provider: "clawhub",
+                        sourceLabel: repo,
+                        sourceUrl: `https://skills.sh/${repo}/${encodeURIComponent(slug)}`,
+                        locator: { kind: "github", repo, skillName: slug },
+                    },
+                ];
+            }
+            const parsed = skillLocatorSchema.safeParse({
+                kind: "clawhub",
+                owner,
+                slug,
+            });
+            if (!parsed.success)
+                return [];
+            return [
+                {
+                    id: `clawhub:${owner.toLowerCase()}/${slug}`,
+                    name: string(item.displayName) || slug,
+                    description: string(item.summary).slice(0, 4096),
+                    provider: "clawhub",
+                    sourceLabel: `${owner}/${slug}`,
+                    sourceUrl: `https://clawhub.ai/${encodeURIComponent(owner)}/skills/${encodeURIComponent(slug)}`,
+                    locator: parsed.data,
+                },
+            ];
+        });
+    }
+    assertActive(userId) {
+        if (new UserRepository(this.db).findById(userId)?.status !== "active")
+            throw new SkillLifecycleError("User is inactive", 403);
+    }
+}
+function catalogCandidate(item) {
+    try {
+        const data = record(JSON.parse(item.metadata ?? "{}"));
+        const origin = record(data.marketplace);
+        if (typeof origin.repo !== "string" || typeof origin.skillPath !== "string")
+            return;
+        const path = origin.skillPath.endsWith("SKILL.md")
+            ? origin.skillPath
+            : `${origin.skillPath}/SKILL.md`;
+        return {
+            id: `github:${origin.repo}/${path}`,
+            name: item.name,
+            description: item.description ?? "",
+            provider: "github",
+            sourceLabel: origin.repo,
+            sourceUrl: `https://github.com/${origin.repo}`,
+            locator: {
+                kind: "github",
+                repo: origin.repo,
+                path,
+                ...(typeof origin.ref === "string" ? { ref: origin.ref } : {}),
+            },
+        };
+    }
+    catch {
+        return;
+    }
+}
+//# sourceMappingURL=skill-discovery.js.map

package/dist/gateway/src/services/skill-discovery.js.map

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

package/dist/gateway/src/services/skill-fs-install.d.ts

@@ -0,0 +1,24 @@
+import type { SkillRemoteProvenance } from "./github-skill-source.js";
+export interface ManagedSkillMarker {
+    managedBy: "forgebadger";
+    markerVersion: number;
+    name: string;
+    installedAt: string;
+    provenance: SkillRemoteProvenance;
+}
+export interface InstallSkillToAgentsHomeInput {
+    name: string;
+    content: string;
+    provenance: SkillRemoteProvenance;
+}
+export interface ManagedSkillInstallResult {
+    dir: string;
+    skillPath: string;
+    markerPath: string;
+    name: string;
+}
+export declare function installSkillToAgentsHome(input: InstallSkillToAgentsHomeInput, env?: NodeJS.ProcessEnv): ManagedSkillInstallResult;
+export declare function updateManagedSkillFile(name: string, content: string, provenance: SkillRemoteProvenance, env?: NodeJS.ProcessEnv): boolean;
+export declare function removeManagedSkill(name: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function isManagedSkill(name: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function defaultAgentsSkillsRoot(env?: NodeJS.ProcessEnv): string;

package/dist/gateway/src/services/skill-fs-install.js

@@ -0,0 +1,150 @@
+import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+import { normalizeName } from "./local-skills.js";
+/**
+ * Filesystem installation of remote Skills into `${AGENTS_HOME}/skills`.
+ * Every managed install carries a `.forgebadger-managed.json` marker; update
+ * and removal refuse to touch directories without that marker so a user's own
+ * Skill directory is never deleted by ForgeBadger. All writes are atomic
+ * (temp file + rename) and validated to stay inside the skills root.
+ */
+const managedMarkerFile = ".forgebadger-managed.json";
+const managedMarkerVersion = 1;
+export function installSkillToAgentsHome(input, env = process.env) {
+    const slug = normalizeName(input.name);
+    if (!slug) {
+        throw new Error("Skill name is invalid for filesystem install");
+    }
+    const layout = resolveManagedLayout(slug, env, { createRoot: true });
+    mkdirSync(layout.dir, { recursive: true });
+    atomicWrite(path.join(layout.dir, "SKILL.md"), input.content);
+    writeManagedMarker(layout, slug, input.provenance);
+    return {
+        dir: layout.dir,
+        skillPath: path.join(layout.dir, "SKILL.md"),
+        markerPath: layout.markerPath,
+        name: slug
+    };
+}
+export function updateManagedSkillFile(name, content, provenance, env = process.env) {
+    const slug = normalizeName(name);
+    if (!slug)
+        return false;
+    const layout = resolveManagedLayout(slug, env, { createRoot: false });
+    const marker = readManagedMarker(layout.markerPath);
+    if (!marker)
+        return false;
+    atomicWrite(path.join(layout.dir, "SKILL.md"), content);
+    writeManagedMarker(layout, slug, provenance);
+    return true;
+}
+export function removeManagedSkill(name, env = process.env) {
+    const slug = normalizeName(name);
+    if (!slug)
+        return false;
+    const layout = resolveManagedLayout(slug, env, { createRoot: false });
+    const marker = readManagedMarker(layout.markerPath);
+    if (!marker)
+        return false;
+    // Re-validate after marker check: the directory may have been swapped for a
+    // symlink since layout resolution.
+    const realDir = safeRealpath(layout.dir);
+    if (!realDir || realDir !== layout.expectedDir || !isInsideRoot(realDir, layout.realRoot)) {
+        return false;
+    }
+    rmSync(layout.dir, { recursive: true, force: true });
+    return true;
+}
+export function isManagedSkill(name, env = process.env) {
+    const slug = normalizeName(name);
+    if (!slug)
+        return false;
+    const layout = resolveManagedLayout(slug, env, { createRoot: false });
+    return readManagedMarker(layout.markerPath) !== undefined;
+}
+export function defaultAgentsSkillsRoot(env = process.env) {
+    const agentsHome = env.AGENTS_HOME?.trim() || path.join(homedir(), ".agents");
+    return path.join(agentsHome, "skills");
+}
+function resolveManagedLayout(slug, env, options) {
+    if (path.isAbsolute(slug) || slug.includes("/") || slug.includes("\\") || slug === ".." || slug === ".") {
+        throw new Error("Skill name is invalid for filesystem install");
+    }
+    const root = defaultAgentsSkillsRoot(env);
+    if (options.createRoot) {
+        mkdirSync(root, { recursive: true });
+    }
+    const realRoot = safeRealpath(root);
+    if (!realRoot) {
+        throw new Error(`Skills directory does not exist: ${root}`);
+    }
+    const dir = path.join(root, slug);
+    if (existsSync(dir)) {
+        const realDir = safeRealpath(dir);
+        if (!realDir || !isInsideRoot(realDir, realRoot)) {
+            throw new Error(`Skill directory escapes the skills root: ${slug}`);
+        }
+    }
+    return {
+        root,
+        realRoot,
+        dir,
+        expectedDir: path.join(realRoot, slug),
+        markerPath: path.join(dir, managedMarkerFile)
+    };
+}
+function writeManagedMarker(layout, name, provenance) {
+    const marker = {
+        managedBy: "forgebadger",
+        markerVersion: managedMarkerVersion,
+        name,
+        installedAt: new Date().toISOString(),
+        provenance
+    };
+    atomicWrite(layout.markerPath, `${JSON.stringify(marker, null, 2)}\n`);
+}
+function readManagedMarker(markerPath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(markerPath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    if (!parsed || typeof parsed !== "object")
+        return undefined;
+    const record = parsed;
+    if (record.managedBy !== "forgebadger" || typeof record.name !== "string" || !record.provenance) {
+        return undefined;
+    }
+    return parsed;
+}
+function atomicWrite(filePath, content) {
+    const tempPath = `${filePath}.tmp-${process.pid}-${Math.random().toString(36).slice(2)}`;
+    try {
+        writeFileSync(tempPath, content, { encoding: "utf8", mode: 0o600 });
+        renameSync(tempPath, filePath);
+    }
+    catch (error) {
+        try {
+            rmSync(tempPath, { force: true });
+        }
+        catch {
+            // Best-effort temp cleanup; the original error matters more.
+        }
+        throw error;
+    }
+}
+function safeRealpath(value) {
+    try {
+        return realpathSync(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function isInsideRoot(target, root) {
+    return target === root || target.startsWith(root + path.sep);
+}
+//# sourceMappingURL=skill-fs-install.js.map

package/dist/gateway/src/services/skill-fs-install.js.map

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

package/dist/gateway/src/services/skill-install-service.d.ts

@@ -0,0 +1,72 @@
+import { type Skill } from "../db/repositories/skill-repository.js";
+import type { Database } from "../db/types.js";
+import { type GitHubRequestOptions } from "./github-skill-source.js";
+import { type SkillPackageFile } from "./skill-package.js";
+import { type RegistryPackage, type SkillLocator } from "./skill-registry-package.js";
+export declare class SkillLifecycleError extends Error {
+    readonly status: number;
+    constructor(message: string, status?: number);
+}
+export interface SkillFileChange {
+    path: string;
+    kind: "added" | "removed" | "modified";
+    before?: string | undefined;
+    after?: string | undefined;
+}
+export interface SkillInstallPreview extends RegistryPackage {
+    token: string;
+    expiresAt: string;
+    operation: "install" | "update" | "rollback";
+    skillId?: string | undefined;
+    changes: SkillFileChange[];
+}
+export declare class SkillInstallService {
+    private readonly db;
+    private readonly options;
+    private readonly now;
+    private readonly pending;
+    private readonly inflight;
+    constructor(db: Database, options?: GitHubRequestOptions, now?: () => number);
+    preview(userId: string, input: {
+        locator?: SkillLocator | undefined;
+        skillId?: string | undefined;
+        revisionId?: string | undefined;
+    }): Promise<SkillInstallPreview>;
+    consume(userId: string, token: string, options?: {
+        skillId?: string | undefined;
+        projectId?: string | undefined;
+        operation?: "install" | "update" | "rollback" | undefined;
+    }): {
+        skill: Skill;
+        projectId?: string | undefined;
+    };
+    checkUpdate(userId: string, skillId: string): Promise<{
+        skillId: string;
+        name: string;
+        kind: "raw" | "github" | "clawhub" | "marketplace";
+        currentSha: string;
+        latestSha: string;
+        updateAvailable: boolean;
+        checkedAt: string;
+    }>;
+    private checkUpdatePackage;
+    history(userId: string, skillId: string): {
+        id: string;
+        userId: string;
+        createdAt: number;
+        skillId: string;
+        action: string;
+        packageHash: string;
+    }[];
+    private assertActive;
+    private ownedSkill;
+    private locator;
+    private assertUnmodified;
+    private baseHash;
+    private snapshot;
+    private revisionPackage;
+    private provenance;
+    private prune;
+}
+export declare function diffFiles(before: SkillPackageFile[], after: SkillPackageFile[]): SkillFileChange[];
+export declare function skillInstallService(db: Database, options?: GitHubRequestOptions): SkillInstallService;