@pikiloom/kernel 0.2.20 → 0.3.1

package/dist/workspace/sessions.js

@@ -1,8 +1,5 @@
 import path from 'node:path';
-function splitKey(sessionKey) {
-    const i = sessionKey.indexOf(':');
-    return i < 0 ? { agent: '', sessionId: sessionKey } : { agent: sessionKey.slice(0, i), sessionId: sessionKey.slice(i + 1) };
-}
+import { makeSessionKey, splitSessionKey } from '../protocol/index.js';
 function ts(iso) {
     if (!iso)
         return 0;
@@ -14,7 +11,7 @@ function newer(a, b) {
 }
 function managedToInfo(agent, rec) {
     return {
-        sessionKey: `${agent}:${rec.sessionId}`,
+        sessionKey: makeSessionKey(agent, rec.sessionId),
         agent,
         sessionId: rec.sessionId,
         title: rec.title ?? null,
@@ -31,7 +28,7 @@ function managedToInfo(agent, rec) {
 }
 function nativeToInfo(agent, n) {
     return {
-        sessionKey: `${agent}:${n.sessionId}`,
+        sessionKey: makeSessionKey(agent, n.sessionId),
         agent,
         sessionId: n.sessionId,
         title: n.title,
@@ -72,7 +69,7 @@ export class SessionsManager {
                     if (!rec.workdir || path.resolve(rec.workdir) !== workdir)
                         continue;
                 }
-                byKey.set(`${agent}:${rec.sessionId}`, managedToInfo(agent, rec));
+                byKey.set(makeSessionKey(agent, rec.sessionId), managedToInfo(agent, rec));
             }
         }
         // Native sessions (the agents' own stores) — inherently per-workdir.
@@ -89,7 +86,7 @@ export class SessionsManager {
                     this.deps.log?.(`[sessions] ${agent}.listNativeSessions failed: ${e?.message || e}`);
                 }
                 for (const n of natives) {
-                    const key = `${agent}:${n.sessionId}`;
+                    const key = makeSessionKey(agent, n.sessionId);
                     const existing = byKey.get(key);
                     if (existing) {
                         // Same identity discovered both ways: managed record wins, but adopt the newer
@@ -118,7 +115,7 @@ export class SessionsManager {
         return typeof opts.limit === 'number' ? matched.slice(0, Math.max(0, opts.limit)) : matched;
     }
     async get(sessionKey, opts = {}) {
-        const { agent, sessionId } = splitKey(sessionKey);
+        const { agent, sessionId } = splitSessionKey(sessionKey);
         if (!agent)
             return null;
         const rec = await this.deps.store.get(agent, sessionId).catch(() => null);

package/dist/workspace/skills.d.ts

@@ -21,6 +21,17 @@ export interface SkillsManagerOptions {
     agentSkillDirs?: string[];
     log?: (msg: string) => void;
 }
+export interface SkillMeta {
+    label: string | null;
+    description: string | null;
+    mcpRequires?: string[];
+}
+/**
+ * Parse a SKILL.md's frontmatter (label/name + description + mcp_requires), falling back
+ * to the first `# heading` for the label. Exported so an app scanning additional skill
+ * stores (e.g. an agent's own ~/.claude/skills) reads them with the same rules.
+ */
+export declare function parseSkillMeta(content: string): SkillMeta;
 /** Make `linkPath` a symlink to `targetDir` (idempotent; replaces a stale link/dir). */
 export declare function ensureDirSymlink(linkPath: string, targetDir: string): void;
 export declare class SkillsManager {

package/dist/workspace/skills.js

@@ -1,13 +1,20 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { searchNpmPackages } from './npm-search.js';
 const DEFAULT_AGENT_SKILL_DIRS = ['.claude/skills', '.agents/skills'];
-function parseSkillMeta(content) {
+/**
+ * Parse a SKILL.md's frontmatter (label/name + description + mcp_requires), falling back
+ * to the first `# heading` for the label. Exported so an app scanning additional skill
+ * stores (e.g. an agent's own ~/.claude/skills) reads them with the same rules.
+ */
+export 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);
+        // Both frontmatter dialects: pikiloom's `label:` and the agent-native `name:`.
+        const lm = fm[1].match(/^label:\s*(.+)/m) || fm[1].match(/^name:\s*(.+)/m);
         if (lm)
             label = lm[1].trim();
         const dm = fm[1].match(/^description:\s*(.+)/m);
@@ -145,25 +152,12 @@ export class SkillsManager {
     /** 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);
+            const hits = await searchNpmPackages(`agent skill ${q}`.trim(), Math.max(1, Math.min(50, limit)), fetch);
+            return hits.map(h => ({
+                name: h.name, description: h.description, source: 'npm',
+                author: h.author, homepage: h.homepage, version: h.version,
+            }));
         }
         catch (e) {
             this.log?.(`[skills] search failed: ${e?.message || e}`);

package/llms.txt

@@ -59,6 +59,7 @@ interface UniversalSnapshot {
 }
 ```
 Wire delta helpers: `diffSnapshot(prev,next) => SnapshotPatch` (prefix-append text/reasoning; undefined→null clears) and `applySnapshotPatch(prev,patch)`. `emptySnapshot()`, `PROTOCOL_VERSION`.
+Session keys: a sessionKey is `${agent}:${sessionId}` — compose/parse ONLY via `makeSessionKey(agent, sessionId)` / `splitSessionKey(sessionKey)`.
 
 ## Control verbs (LoomIO, via loom.io)
 
@@ -86,7 +87,8 @@ governs a session index, a skills registry and per-agent symlinks, resolved in t
 - `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`.
+  `search(query) => npm results`. `parseSkillMeta(content)` (exported) reads a SKILL.md's frontmatter
+  (label/name + description + mcp_requires) — reuse it when scanning additional skill stores yourself.
 - `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.
 
@@ -95,12 +97,18 @@ Drivers expose native discovery via the optional `AgentDriver.listNativeSessions
 
 ## Drivers (pass to createLoom({drivers}) or loom.registerDriver)
 
-- ClaudeDriver (id 'claude'): `claude` CLI stream-json, supports --effort; steer ✓, resume ✓, tui ✓
+- ClaudeDriver (id 'claude'): `claude` CLI stream-json, supports --effort; steer ✓, resume ✓, tui ✓.
+  Background-hold/stall/recovery heuristics tunable via PIKILOOM_CLAUDE_* env (see README).
 - CodexDriver (id 'codex'): `codex app-server` JSON-RPC; steer ✓, HITL via askUser, resume ✓, tui ✓
 - GeminiDriver (id 'gemini'): `gemini` stream-json; resume ✓, tui ✓
-- HermesDriver (id 'hermes'): ACP session/update; resume ✓
+- AcpDriver (id from config): generic ACP ndjson JSON-RPC — any ACP CLI via `new AcpDriver({ id, command, args })`; HITL via askUser, resume ✓
+- HermesDriver (id 'hermes'): preset `new AcpDriver({ id:'hermes', command:'hermes', args:['acp'] })`; HITL via askUser, resume ✓
 - EchoDriver (id 'echo'): hermetic in-process test driver; all caps ✓
 
+Multi-account: `accountTokenSupported(agent)` / `accountTokenEnvVar(agent)` / `accountTokenEnv(agent, token)` —
+which env var carries an agent's auth token (claude: CLAUDE_CODE_OAUTH_TOKEN), so an app injects a selected
+account's token per spawn (via ModelResolver env or a Plugin contributeSpawn). Storage/selection stay app-side.
+
 Write a driver: implement `AgentDriver { id; capabilities?; run(input, ctx); tui?(input) }`. In run(), call `ctx.emit(event)`:
 `DriverEvent = {type:'session',sessionId} | {type:'text',delta} | {type:'reasoning',delta} | {type:'tool',call:UniversalToolCall} | {type:'plan',plan} | {type:'subagent',subagent} | {type:'usage',usage} | {type:'artifact',artifact} | {type:'activity',line}`.
 `ctx = { signal: AbortSignal, emit, askUser(interaction)=>Promise<answers>, registerSteer(fn) }`. Return `DriverResult { ok, text, reasoning?, error?, stopReason?, sessionId?, usage? }`. Emit a `tool` event on BOTH start (status 'running') and completion (status 'done'/'failed'); the kernel projects `activity` from these.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikiloom/kernel",
-  "version": "0.2.20",
+  "version": "0.3.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",