@pikiloom/kernel 0.1.5 → 0.2.1

package/dist/workspace/skills.js

@@ -0,0 +1,173 @@
+import fs from 'node:fs';
+import path from 'node:path';
+const DEFAULT_AGENT_SKILL_DIRS = ['.claude/skills', '.agents/skills'];
+function parseSkillMeta(content) {
+    let label = null;
+    let description = null;
+    let mcpRequires;
+    const fm = content.match(/^---\s*\n([\s\S]*?)\n---/);
+    if (fm) {
+        const lm = fm[1].match(/^label:\s*(.+)/m);
+        if (lm)
+            label = lm[1].trim();
+        const dm = fm[1].match(/^description:\s*(.+)/m);
+        if (dm)
+            description = dm[1].trim();
+        const mr = fm[1].match(/^mcp_requires:\s*\n((?:\s+-\s+.+\n?)+)/m);
+        if (mr) {
+            mcpRequires = mr[1].split('\n').map(l => l.replace(/^\s*-\s*/, '').replace(/["']/g, '').trim()).filter(Boolean);
+        }
+    }
+    if (!label) {
+        const hm = content.match(/^#\s+(.+)$/m);
+        if (hm)
+            label = hm[1].trim();
+    }
+    return { label, description, mcpRequires };
+}
+function realPathOrNull(p) {
+    try {
+        return fs.realpathSync(p);
+    }
+    catch {
+        return null;
+    }
+}
+/** Make `linkPath` a symlink to `targetDir` (idempotent; replaces a stale link/dir). */
+export function ensureDirSymlink(linkPath, targetDir) {
+    const desiredTarget = path.relative(path.dirname(linkPath), targetDir) || '.';
+    try {
+        const stat = fs.lstatSync(linkPath);
+        if (stat.isSymbolicLink()) {
+            const currentTarget = fs.readlinkSync(linkPath);
+            const currentReal = realPathOrNull(path.resolve(path.dirname(linkPath), currentTarget));
+            const desiredReal = realPathOrNull(targetDir);
+            if (currentTarget === desiredTarget || (currentReal && desiredReal && currentReal === desiredReal))
+                return;
+            fs.unlinkSync(linkPath);
+        }
+        else {
+            fs.rmSync(linkPath, { recursive: true, force: true });
+        }
+    }
+    catch { /* nothing there yet */ }
+    fs.mkdirSync(path.dirname(linkPath), { recursive: true });
+    try {
+        fs.symlinkSync(desiredTarget, linkPath, process.platform === 'win32' ? 'junction' : 'dir');
+    }
+    catch (err) {
+        if (err?.code !== 'EEXIST' || fs.readlinkSync(linkPath) !== desiredTarget)
+            throw err;
+    }
+}
+function discoverSkillsFromDir(dir, scope, seen) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir).sort((a, b) => a.localeCompare(b, 'en', { sensitivity: 'base' }));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of entries) {
+        if (!name || seen.has(name))
+            continue;
+        const skillDir = path.join(dir, name);
+        const skillFile = path.join(skillDir, 'SKILL.md');
+        try {
+            if (!fs.statSync(skillDir).isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        try {
+            if (!fs.statSync(skillFile).isFile())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        let meta = { label: null, description: null };
+        try {
+            meta = parseSkillMeta(fs.readFileSync(skillFile, 'utf8'));
+        }
+        catch { /* keep defaults */ }
+        out.push({ name, label: meta.label, description: meta.description, scope, path: skillDir, mcpRequires: meta.mcpRequires });
+        seen.add(name);
+    }
+    return out;
+}
+export class SkillsManager {
+    paths;
+    agentSkillDirs;
+    log;
+    constructor(opts) {
+        this.paths = opts.paths;
+        this.agentSkillDirs = opts.agentSkillDirs?.length ? opts.agentSkillDirs : DEFAULT_AGENT_SKILL_DIRS;
+        this.log = opts.log;
+    }
+    /** The canonical skills dir for a scope, e.g. <workdir>/.pikiloom/skills or ~/.pikiloom/skills. */
+    canonicalDir(scope, workdir) {
+        return this.paths.skillsDir(scope, workdir);
+    }
+    /** Absolute paths of the per-agent skill dirs that link to the canonical dir for a scope. */
+    agentLinkPaths(scope, workdir) {
+        const base = this.paths.agentHome(scope, workdir);
+        return this.agentSkillDirs.map(rel => path.join(base, rel));
+    }
+    /** Ensure the canonical dir exists and each agent skills dir symlinks to it. */
+    ensureLinks(scope, workdir) {
+        const canonical = this.canonicalDir(scope, workdir);
+        fs.mkdirSync(canonical, { recursive: true });
+        for (const link of this.agentLinkPaths(scope, workdir)) {
+            try {
+                ensureDirSymlink(link, canonical);
+            }
+            catch (e) {
+                this.log?.(`[skills] link ${link} -> ${canonical} failed: ${e?.message || e}`);
+            }
+        }
+    }
+    /** List skills. scope 'all' (default) = workspace (if workdir) then global, project wins on name clash. */
+    list(opts = {}) {
+        const scope = opts.scope ?? 'all';
+        const seen = new Set();
+        const out = [];
+        if ((scope === 'workspace' || scope === 'all') && opts.workdir) {
+            out.push(...discoverSkillsFromDir(this.paths.skillsDir('workspace', opts.workdir), 'workspace', seen));
+        }
+        if (scope === 'global' || scope === 'all') {
+            out.push(...discoverSkillsFromDir(this.paths.skillsDir('global'), 'global', seen));
+        }
+        return out;
+    }
+    /** Search installable skills on the npm registry (best-effort; [] on failure). */
+    async search(query, limit = 20) {
+        const q = (query || '').trim();
+        const text = encodeURIComponent(`agent skill ${q}`.trim());
+        const url = `https://registry.npmjs.org/-/v1/search?text=${text}&size=${Math.max(1, Math.min(50, limit))}`;
+        try {
+            const res = await fetch(url, { headers: { accept: 'application/json' } });
+            if (!res.ok)
+                return [];
+            const data = await res.json();
+            const objects = Array.isArray(data?.objects) ? data.objects : [];
+            return objects.map((o) => {
+                const pkg = o?.package ?? {};
+                return {
+                    name: String(pkg.name ?? ''),
+                    description: pkg.description ?? null,
+                    source: 'npm',
+                    author: pkg.publisher?.username ?? pkg.author?.name ?? null,
+                    homepage: pkg.links?.homepage ?? pkg.links?.npm ?? null,
+                    version: pkg.version ?? null,
+                };
+            }).filter(s => s.name);
+        }
+        catch (e) {
+            this.log?.(`[skills] search failed: ${e?.message || e}`);
+            return [];
+        }
+    }
+}

package/llms.txt

@@ -35,7 +35,7 @@ await loom.start();
 const { sessionKey, taskId } = await loom.io.prompt({ prompt: 'hi', agent: 'claude' });
 const unsub = loom.io.subscribe((key, snapshot, patch, seq) => render(snapshot));
 ```
-Every port has a default (zero config). Override any: sessionStore, modelResolver, toolProvider, systemPromptBuilder, catalog, interactionHandler, plugins, serialPerSession, appNamespace, workdir, defaultAgent, log.
+Every port has a default (zero config). Override any: sessionStore, modelResolver, toolProvider, systemPromptBuilder, catalog, interactionHandler, plugins, serialPerSession, stateDirName, appNamespace, agentSkillDirs, workdir, defaultAgent, log.
 
 3) RAW TUI passthrough — `loom.runTui({ agent, workdir })` (full stdio passthrough) or `loom.openTui(...) => PtyBridge` (onData/write/resize/onExit). Needs optional `node-pty`; `ptyAvailable()` reports it.
 
@@ -71,6 +71,28 @@ Wire delta helpers: `diffSnapshot(prev,next) => SnapshotPatch` (prefix-append te
 - discovery: `listModels(agent)`, `listEffort(agent, model?)`, `listTools(agent, workdir?)`, `listSkills(agent, workdir?)`
 Concurrent prompts to one session queue by default (serialPerSession=true).
 
+## Workspace: unified top-level directory + session/skill/mcp management (loom.paths/sessions/skills/mcp)
+
+One explicitly-configurable top-level dir (`createLoom({ stateDirName })`, default `'pikiloom'` → `.pikiloom`)
+governs a session index, a skills registry and per-agent symlinks, resolved in two scopes: global
+(`~/.pikiloom`) and per-workspace (`<workdir>/.pikiloom`). Exposed off the Loom:
+
+- `loom.paths: LoomPaths` — `resolveLoomPaths({stateDirName})`. `globalRoot`, `workspaceRoot(wd)`,
+  `sessionsDir/skillsDir/mcpConfigPath(scope, wd?)`, `agentHome(scope, wd?)`. (`scope: 'global'|'workspace'`.)
+- `loom.sessions: SessionsManager` — the unified, searchable session read-model. Merges MANAGED sessions
+  (the SessionStore, scoped per workspace by the cwd they ran in) with each agent's NATIVE sessions
+  (driver.listNativeSessions — claude/codex/gemini read their own on-disk transcripts). `list({scope:'workspace'|'global'|'all', workdir?, agent?, includeNative?, limit?}) => ManagedSessionInfo[]`,
+  `search({query, ...}) `, `get(sessionKey)`. This is "全局 + 每个工作区的会话列表，含 claude/codex 自己的会话 + 搜索".
+- `loom.skills: SkillsManager` — the canonical skills registry. `canonicalDir(scope,wd?)` = `<root>/skills`;
+  `ensureLinks(scope, wd?)` symlinks it into each agent's dir (default `.claude/skills`, `.agents/skills`,
+  overridable via `agentSkillDirs`) so a skill registered once is visible to every agent. `list({workdir?,scope?})`,
+  `search(query) => npm results`.
+- `loom.mcp: McpRegistry` — `recommended(): McpCatalogEntry[]` (curated), `search(query)` (MCP registry → npm),
+  `toServerSpec(entry, env?) => McpServerSpec`. Enabling/injecting a server stays on the Plugin.tools()/ToolProvider seam.
+
+Drivers expose native discovery via the optional `AgentDriver.listNativeSessions?({workdir, limit}) => NativeSessionInfo[]`
+(implemented by Claude/Codex/Gemini; pure node-builtins, also exported as `discover{Claude,Codex,Gemini}NativeSessions`).
+
 ## Drivers (pass to createLoom({drivers}) or loom.registerDriver)
 
 - ClaudeDriver (id 'claude'): `claude` CLI stream-json, supports --effort; steer ✓, resume ✓, tui ✓

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikiloom/kernel",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "Heterogeneous coding agents (Claude / Codex / Gemini / ACP) -> an interaction-friendly, accumulating session snapshot + control handle, over pluggable surfaces (IM, Web, tunnel, TUI). The reusable core pikiloom itself is built on.",
   "type": "module",
   "license": "MIT",