qlogicagent 0.1.0

package/dist/skills/skill-loader.js

@@ -0,0 +1,304 @@
+// ---------------------------------------------------------------------------
+// Skill discovery & loading — portable, DI-based.
+// Mirrors openclaw/src/agents/skills/workspace.ts logic but decoupled from
+// Node.js fs/path via SkillLoaderDeps.
+// ---------------------------------------------------------------------------
+import { parseFrontmatter, resolveSkillMetadata, resolveSkillInvocationPolicy } from "./skill-frontmatter.js";
+// ---------------------------------------------------------------------------
+// Default limits (match openclaw upstream)
+// ---------------------------------------------------------------------------
+const DEFAULT_LIMITS = {
+    maxCandidatesPerRoot: 300,
+    maxSkillsLoadedPerSource: 200,
+    maxSkillsInPrompt: 150,
+    maxSkillsPromptChars: 30_000,
+    maxSkillFileBytes: 256_000,
+};
+function resolveLimits(input) {
+    return {
+        maxCandidatesPerRoot: input?.maxCandidatesPerRoot ?? DEFAULT_LIMITS.maxCandidatesPerRoot,
+        maxSkillsLoadedPerSource: input?.maxSkillsLoadedPerSource ?? DEFAULT_LIMITS.maxSkillsLoadedPerSource,
+        maxSkillsInPrompt: input?.maxSkillsInPrompt ?? DEFAULT_LIMITS.maxSkillsInPrompt,
+        maxSkillsPromptChars: input?.maxSkillsPromptChars ?? DEFAULT_LIMITS.maxSkillsPromptChars,
+        maxSkillFileBytes: input?.maxSkillFileBytes ?? DEFAULT_LIMITS.maxSkillFileBytes,
+    };
+}
+// ---------------------------------------------------------------------------
+// Path containment guard
+// ---------------------------------------------------------------------------
+function isPathInside(parentRealPath, childRealPath, sep) {
+    const normalizedParent = parentRealPath.endsWith(sep) ? parentRealPath : parentRealPath + sep;
+    return childRealPath === parentRealPath || childRealPath.startsWith(normalizedParent);
+}
+function resolveContainedPath(deps, rootRealPath, candidatePath) {
+    try {
+        const real = deps.fs.realpathSync(candidatePath);
+        return isPathInside(rootRealPath, real, deps.path.sep) ? real : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Directory listing helpers
+// ---------------------------------------------------------------------------
+function listChildDirectories(deps, dir) {
+    try {
+        const entries = deps.fs.readdirSync(dir, { withFileTypes: true });
+        const dirs = [];
+        for (const entry of entries) {
+            if (entry.name.startsWith(".") || entry.name === "node_modules")
+                continue;
+            if (entry.isDirectory()) {
+                dirs.push(entry.name);
+                continue;
+            }
+            if (entry.isSymbolicLink()) {
+                try {
+                    const fullPath = deps.path.join(dir, entry.name);
+                    if (deps.fs.statSync(fullPath).isDirectory()) {
+                        dirs.push(entry.name);
+                    }
+                }
+                catch {
+                    // broken symlink — skip
+                }
+            }
+        }
+        return dirs;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Detect nested `skills/` subfolder. If `dir/skills/<x>/SKILL.md` exists,
+ * treat `dir/skills/` as the real root.
+ */
+function resolveNestedSkillsRoot(deps, dir, maxEntriesToScan) {
+    const nested = deps.path.join(dir, "skills");
+    try {
+        if (!deps.fs.existsSync(nested) || !deps.fs.statSync(nested).isDirectory()) {
+            return dir;
+        }
+    }
+    catch {
+        return dir;
+    }
+    const nestedDirs = listChildDirectories(deps, nested);
+    const toScan = nestedDirs.slice(0, Math.min(nestedDirs.length, maxEntriesToScan));
+    for (const name of toScan) {
+        const skillMd = deps.path.join(nested, name, "SKILL.md");
+        if (deps.fs.existsSync(skillMd)) {
+            return nested;
+        }
+    }
+    return dir;
+}
+// ---------------------------------------------------------------------------
+// Single-source skill loading
+// ---------------------------------------------------------------------------
+function loadSkillsFromSourceDir(deps, dir, source, limits) {
+    const rootDir = deps.path.resolve(dir);
+    let rootRealPath;
+    try {
+        rootRealPath = deps.fs.realpathSync(rootDir);
+    }
+    catch {
+        return [];
+    }
+    const baseDir = resolveNestedSkillsRoot(deps, rootDir, limits.maxCandidatesPerRoot);
+    const baseDirRealPath = resolveContainedPath(deps, rootRealPath, baseDir);
+    if (!baseDirRealPath)
+        return [];
+    // Case 1: root itself is a single skill
+    const rootSkillMd = deps.path.join(baseDir, "SKILL.md");
+    if (deps.fs.existsSync(rootSkillMd)) {
+        if (!resolveContainedPath(deps, baseDirRealPath, rootSkillMd))
+            return [];
+        try {
+            const size = deps.fs.statSync(rootSkillMd).size;
+            if (size > limits.maxSkillFileBytes)
+                return [];
+        }
+        catch {
+            return [];
+        }
+        return [buildWorkspaceSkill(deps, rootSkillMd, baseDir, source)].filter((s) => s !== null);
+    }
+    // Case 2: enumerate child directories for `<child>/SKILL.md`
+    const childDirs = listChildDirectories(deps, baseDir);
+    const maxCandidates = Math.max(0, limits.maxSkillsLoadedPerSource);
+    const limitedChildren = childDirs.slice().sort().slice(0, maxCandidates);
+    const skills = [];
+    for (const name of limitedChildren) {
+        const skillDir = deps.path.join(baseDir, name);
+        if (!resolveContainedPath(deps, baseDirRealPath, skillDir))
+            continue;
+        const skillMd = deps.path.join(skillDir, "SKILL.md");
+        if (!deps.fs.existsSync(skillMd))
+            continue;
+        if (!resolveContainedPath(deps, baseDirRealPath, skillMd))
+            continue;
+        try {
+            const size = deps.fs.statSync(skillMd).size;
+            if (size > limits.maxSkillFileBytes)
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const skill = buildWorkspaceSkill(deps, skillMd, skillDir, source);
+        if (skill)
+            skills.push(skill);
+        if (skills.length >= limits.maxSkillsLoadedPerSource)
+            break;
+    }
+    return skills;
+}
+function buildWorkspaceSkill(deps, filePath, baseDir, source) {
+    try {
+        const content = deps.fs.readFileSync(filePath, "utf-8");
+        const fm = parseFrontmatter(content);
+        const name = fm["name"] ?? deps.path.resolve(baseDir).split(deps.path.sep).pop() ?? "unknown";
+        return {
+            name,
+            description: fm["description"],
+            source,
+            filePath: deps.path.resolve(filePath),
+            baseDir: deps.path.resolve(baseDir),
+            primaryEnv: fm["primaryEnv"] ?? fm["primary-env"],
+            requiredEnv: fm["required-env"]?.split(",").map((s) => s.trim()).filter(Boolean),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Discover all skills from configured search paths, applying precedence merge
+ * and size/count limits. Returns fully parsed `SkillEntry` objects.
+ */
+export function loadSkillEntries(deps) {
+    const limits = resolveLimits(deps.limits);
+    const { searchPaths } = deps;
+    const sources = [];
+    // Order: extra < bundled < managed < personalAgents < projectAgents < workspace
+    if (searchPaths.extra) {
+        for (const dir of searchPaths.extra) {
+            sources.push({ dir, source: "extra" });
+        }
+    }
+    if (searchPaths.bundled) {
+        sources.push({ dir: searchPaths.bundled, source: "bundled" });
+    }
+    if (searchPaths.managed) {
+        sources.push({ dir: searchPaths.managed, source: "managed" });
+    }
+    if (searchPaths.personalAgents) {
+        sources.push({ dir: searchPaths.personalAgents, source: "agents-personal" });
+    }
+    if (searchPaths.projectAgents) {
+        sources.push({ dir: searchPaths.projectAgents, source: "agents-project" });
+    }
+    if (searchPaths.workspace) {
+        sources.push({ dir: searchPaths.workspace, source: "workspace" });
+    }
+    // Merge with later sources overriding earlier ones (by name)
+    const merged = new Map();
+    for (const src of sources) {
+        const skills = loadSkillsFromSourceDir(deps, src.dir, src.source, limits);
+        for (const skill of skills) {
+            merged.set(skill.name, skill);
+        }
+    }
+    // Build entries with parsed metadata
+    const entries = [];
+    for (const skill of merged.values()) {
+        let frontmatter = parseFrontmatter("");
+        try {
+            const raw = deps.fs.readFileSync(skill.filePath, "utf-8");
+            frontmatter = parseFrontmatter(raw);
+        }
+        catch {
+            // ignore malformed
+        }
+        entries.push({
+            skill,
+            frontmatter,
+            metadata: resolveSkillMetadata(frontmatter),
+            invocation: resolveSkillInvocationPolicy(frontmatter),
+        });
+    }
+    return entries;
+}
+/**
+ * Filter skill entries by a name-based filter list.
+ * If filter is undefined or empty, returns all entries.
+ */
+export function filterSkillEntries(entries, skillFilter) {
+    if (!skillFilter || skillFilter.length === 0)
+        return entries;
+    const normalized = new Set(skillFilter.map((s) => s.trim().toLowerCase()).filter(Boolean));
+    if (normalized.size === 0)
+        return [];
+    return entries.filter((e) => normalized.has(e.skill.name.toLowerCase()));
+}
+/**
+ * Build a system-prompt-embeddable skill snapshot.
+ * Applies count and character limits from the provided config.
+ */
+export function buildSkillSnapshot(entries, limits, skillFilter) {
+    const resolved = resolveLimits(limits);
+    const filtered = filterSkillEntries(entries, skillFilter);
+    // Truncate by count first
+    let promptSkills = filtered.slice(0, Math.max(0, resolved.maxSkillsInPrompt));
+    // Format function for prompt
+    const formatForPrompt = (skills) => {
+        if (skills.length === 0)
+            return "";
+        const lines = [];
+        for (const entry of skills) {
+            const s = entry.skill;
+            const meta = entry.metadata;
+            const desc = s.description ? ` — ${s.description}` : "";
+            const env = s.primaryEnv ? ` [${s.primaryEnv}]` : "";
+            const emoji = meta?.emoji ? `${meta.emoji} ` : "";
+            lines.push(`- ${emoji}**${s.name}**${env}${desc}`);
+            // Compact path with ~ prefix
+            lines.push(`  File: ${s.filePath}`);
+        }
+        return lines.join("\n");
+    };
+    // Truncate by character budget via binary search
+    let prompt = formatForPrompt(promptSkills);
+    if (prompt.length > resolved.maxSkillsPromptChars) {
+        let lo = 0;
+        let hi = promptSkills.length;
+        while (lo < hi) {
+            const mid = Math.ceil((lo + hi) / 2);
+            const candidate = formatForPrompt(promptSkills.slice(0, mid));
+            if (candidate.length <= resolved.maxSkillsPromptChars) {
+                lo = mid;
+            }
+            else {
+                hi = mid - 1;
+            }
+        }
+        promptSkills = promptSkills.slice(0, lo);
+        prompt = formatForPrompt(promptSkills);
+    }
+    return {
+        prompt,
+        skills: promptSkills.map((e) => ({
+            name: e.skill.name,
+            primaryEnv: e.skill.primaryEnv,
+            requiredEnv: e.skill.requiredEnv,
+        })),
+        skillFilter,
+    };
+}
+//# sourceMappingURL=skill-loader.js.map

package/dist/skills/skill-loader.js.map

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

package/dist/skills/skill-source.d.ts

@@ -0,0 +1,120 @@
+import type { SkillScanSummary } from "./skill-types.js";
+/**
+ * Trust level for a skill based on its origin.
+ * Higher trust = fewer restrictions.
+ */
+export type TrustLevel = "builtin" | "verified" | "community" | "unknown";
+/**
+ * Result of a skill security scan decision.
+ */
+export type ScanVerdict = "pass" | "quarantine" | "reject";
+/**
+ * A resolved skill source descriptor.
+ */
+export interface SkillSourceDescriptor {
+    /** Source type. */
+    kind: "bundled" | "github" | "npm" | "local" | "tap";
+    /** Human-readable identifier, e.g. "github:user/repo" or "npm:@scope/pkg". */
+    identifier: string;
+    /** Trust level derived from source type + verification status. */
+    trust: TrustLevel;
+    /** Version constraint (semver or tag). */
+    version?: string;
+}
+/**
+ * Result of fetching a skill from a remote source.
+ */
+export interface SkillFetchResult {
+    /** Local directory where fetched content was placed. */
+    quarantineDir: string;
+    /** Manifest metadata if found. */
+    name?: string;
+    version?: string;
+}
+/**
+ * Dependencies for the skill fetch step.
+ * Consumers inject actual HTTP/git/npm implementations.
+ */
+export interface SkillFetchDeps {
+    /**
+     * Download / clone / extract a skill from its source into a quarantine dir.
+     * Must NOT place content in the final install location.
+     */
+    fetch(source: SkillSourceDescriptor, quarantineDir: string): Promise<SkillFetchResult>;
+}
+/**
+ * Dependencies for the skill storage step.
+ * Manages the local skill directory and registry.
+ */
+export interface SkillStorageDeps {
+    /** Root directory for installed skills (e.g. ~/.xiaozhiclaw/skills/). */
+    skillsDir: string;
+    /** Registry subdirectory (e.g. ~/.xiaozhiclaw/skills/.registry/). */
+    registryDir: string;
+    /** Move content from quarantine to final location. */
+    moveToInstallDir(quarantineDir: string, skillName: string): Promise<string>;
+    /** Remove an installed skill directory. */
+    removeSkill(skillName: string): Promise<void>;
+    /** Read the registry lock file. */
+    readLockfile(): Promise<SkillLockfile>;
+    /** Write the registry lock file. */
+    writeLockfile(lockfile: SkillLockfile): Promise<void>;
+}
+/**
+ * Single entry in the skill lockfile.
+ */
+export interface SkillLockEntry {
+    name: string;
+    source: SkillSourceDescriptor;
+    installedAt: string;
+    scanVerdict: ScanVerdict;
+    scanSummary?: SkillScanSummary;
+    /** Integrity hash of the SKILL.md content (sha256). */
+    integrity?: string;
+}
+/**
+ * Complete lockfile for all installed skills.
+ */
+export interface SkillLockfile {
+    version: 1;
+    entries: Record<string, SkillLockEntry>;
+}
+/**
+ * Result of a skill install operation.
+ */
+export interface SkillInstallResult {
+    success: boolean;
+    name: string;
+    installDir?: string;
+    verdict: ScanVerdict;
+    scanSummary?: SkillScanSummary;
+    error?: string;
+}
+/**
+ * Orchestrate the full install pipeline:
+ * Fetch → Quarantine → Scan → Validate → Move → Lock
+ *
+ * This function is pure orchestration — actual I/O is delegated to deps.
+ */
+export declare function installSkill(params: {
+    source: SkillSourceDescriptor;
+    fetchDeps: SkillFetchDeps;
+    storageDeps: SkillStorageDeps;
+    scanSkillDir: (dir: string) => Promise<SkillScanSummary>;
+    quarantineDir: string;
+}): Promise<SkillInstallResult>;
+/**
+ * Uninstall a skill: remove from disk + update lockfile.
+ */
+export declare function uninstallSkill(params: {
+    skillName: string;
+    storageDeps: SkillStorageDeps;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Create an empty lockfile.
+ */
+export declare function createEmptyLockfile(): SkillLockfile;
+//# sourceMappingURL=skill-source.d.ts.map

package/dist/skills/skill-source.d.ts.map

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

package/dist/skills/skill-source.js

@@ -0,0 +1,127 @@
+// ---------------------------------------------------------------------------
+// Skill source abstraction — defines where skills come from and how they
+// are fetched/installed. Consumers implement specific source adapters.
+// ---------------------------------------------------------------------------
+/**
+ * Orchestrate the full install pipeline:
+ * Fetch → Quarantine → Scan → Validate → Move → Lock
+ *
+ * This function is pure orchestration — actual I/O is delegated to deps.
+ */
+export async function installSkill(params) {
+    const { source, fetchDeps, storageDeps, scanSkillDir, quarantineDir } = params;
+    // Step 1: Fetch to quarantine
+    let fetchResult;
+    try {
+        fetchResult = await fetchDeps.fetch(source, quarantineDir);
+    }
+    catch (err) {
+        return {
+            success: false,
+            name: source.identifier,
+            verdict: "reject",
+            error: `Fetch failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    const skillName = fetchResult.name ?? source.identifier.split("/").pop() ?? "unknown";
+    // Step 2: Security scan
+    let scanSummary;
+    try {
+        scanSummary = await scanSkillDir(fetchResult.quarantineDir);
+    }
+    catch (err) {
+        return {
+            success: false,
+            name: skillName,
+            verdict: "reject",
+            error: `Scan failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // Step 3: Verdict
+    let verdict;
+    if (scanSummary.critical > 0) {
+        verdict = source.trust === "builtin" ? "quarantine" : "reject";
+    }
+    else if (scanSummary.warn > 0) {
+        verdict = "quarantine";
+    }
+    else {
+        verdict = "pass";
+    }
+    if (verdict === "reject") {
+        return {
+            success: false,
+            name: skillName,
+            verdict,
+            scanSummary,
+            error: `Security scan rejected: ${scanSummary.critical} critical finding(s)`,
+        };
+    }
+    // Step 4: Move to install location
+    let installDir;
+    try {
+        installDir = await storageDeps.moveToInstallDir(fetchResult.quarantineDir, skillName);
+    }
+    catch (err) {
+        return {
+            success: false,
+            name: skillName,
+            verdict,
+            scanSummary,
+            error: `Install move failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // Step 5: Update lockfile
+    try {
+        const lockfile = await storageDeps.readLockfile();
+        lockfile.entries[skillName] = {
+            name: skillName,
+            source,
+            installedAt: new Date().toISOString(),
+            scanVerdict: verdict,
+            scanSummary,
+        };
+        await storageDeps.writeLockfile(lockfile);
+    }
+    catch {
+        // Non-fatal: skill is installed but lock may be stale
+    }
+    return {
+        success: true,
+        name: skillName,
+        installDir,
+        verdict,
+        scanSummary,
+    };
+}
+/**
+ * Uninstall a skill: remove from disk + update lockfile.
+ */
+export async function uninstallSkill(params) {
+    const { skillName, storageDeps } = params;
+    try {
+        await storageDeps.removeSkill(skillName);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Remove failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        const lockfile = await storageDeps.readLockfile();
+        delete lockfile.entries[skillName];
+        await storageDeps.writeLockfile(lockfile);
+    }
+    catch {
+        // Non-fatal
+    }
+    return { success: true };
+}
+/**
+ * Create an empty lockfile.
+ */
+export function createEmptyLockfile() {
+    return { version: 1, entries: {} };
+}
+//# sourceMappingURL=skill-source.js.map

package/dist/skills/skill-source.js.map

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