chainlesschain 0.45.70 → 0.45.75

package/src/lib/plugin-manager.js

@@ -1,430 +1,31 @@
 /**
- * Plugin Manager — Plugin installation, management, and marketplace for CLI.
- * Manages plugin lifecycle: install, enable, disable, remove, update.
- */
-
-import crypto from "crypto";
-import fs from "fs";
-import path from "path";
-import { getElectronUserDataDir } from "./paths.js";
-
-/**
- * Ensure plugin tables exist.
- */
-export function ensurePluginTables(db) {
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS plugins (
-      id TEXT PRIMARY KEY,
-      name TEXT NOT NULL UNIQUE,
-      version TEXT NOT NULL,
-      description TEXT,
-      author TEXT,
-      homepage TEXT,
-      entry_point TEXT,
-      permissions TEXT,
-      status TEXT DEFAULT 'installed',
-      enabled INTEGER DEFAULT 1,
-      install_path TEXT,
-      installed_at TEXT DEFAULT (datetime('now')),
-      updated_at TEXT DEFAULT (datetime('now'))
-    )
-  `);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS plugin_settings (
-      id TEXT PRIMARY KEY,
-      plugin_id TEXT NOT NULL,
-      key TEXT NOT NULL,
-      value TEXT
-    )
-  `);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS plugin_skills (
-      id TEXT PRIMARY KEY,
-      plugin_name TEXT NOT NULL,
-      skill_name TEXT NOT NULL,
-      skill_path TEXT NOT NULL,
-      installed_at TEXT DEFAULT (datetime('now'))
-    )
-  `);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS plugin_registry (
-      name TEXT PRIMARY KEY,
-      latest_version TEXT,
-      description TEXT,
-      author TEXT,
-      downloads INTEGER DEFAULT 0,
-      rating REAL DEFAULT 0,
-      tags TEXT,
-      updated_at TEXT DEFAULT (datetime('now'))
-    )
-  `);
-}
-
-/**
- * Install a plugin (record in DB).
- */
-export function installPlugin(db, pluginInfo) {
-  ensurePluginTables(db);
-  const {
-    name,
-    version,
-    description,
-    author,
-    homepage,
-    entryPoint,
-    permissions,
-    installPath,
-  } = pluginInfo;
-
-  if (!name || !version) {
-    throw new Error("Plugin name and version are required");
-  }
-
-  // Check if already installed
-  const existing = getPlugin(db, name);
-  if (existing) {
-    throw new Error(`Plugin already installed: ${name}`);
-  }
-
-  const id = `plugin-${crypto.randomBytes(8).toString("hex")}`;
-
-  db.prepare(
-    `INSERT INTO plugins (id, name, version, description, author, homepage, entry_point, permissions, status, enabled, install_path)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-  ).run(
-    id,
-    name,
-    version,
-    description || null,
-    author || null,
-    homepage || null,
-    entryPoint || null,
-    permissions ? JSON.stringify(permissions) : null,
-    "installed",
-    1,
-    installPath || null,
-  );
-
-  return {
-    id,
-    name,
-    version,
-    description,
-    author,
-    status: "installed",
-    enabled: true,
-  };
-}
-
-/**
- * Get a plugin by name.
- */
-export function getPlugin(db, name) {
-  ensurePluginTables(db);
-  return db.prepare("SELECT * FROM plugins WHERE name = ?").get(name);
-}
-
-/**
- * Get a plugin by ID.
- */
-export function getPluginById(db, pluginId) {
-  ensurePluginTables(db);
-  return db.prepare("SELECT * FROM plugins WHERE id = ?").get(pluginId);
-}
-
-/**
- * List all installed plugins.
- */
-export function listPlugins(db, options = {}) {
-  ensurePluginTables(db);
-  const { enabledOnly = false } = options;
-
-  if (enabledOnly) {
-    return db
-      .prepare("SELECT * FROM plugins WHERE enabled = 1 ORDER BY name ASC")
-      .all();
-  }
-  return db.prepare("SELECT * FROM plugins ORDER BY name ASC").all();
-}
-
-/**
- * Enable a plugin.
- */
-export function enablePlugin(db, name) {
-  ensurePluginTables(db);
-  const result = db
-    .prepare("UPDATE plugins SET enabled = ?, status = ? WHERE name = ?")
-    .run(1, "installed", name);
-  return result.changes > 0;
-}
-
-/**
- * Disable a plugin.
- */
-export function disablePlugin(db, name) {
-  ensurePluginTables(db);
-  const result = db
-    .prepare("UPDATE plugins SET enabled = ?, status = ? WHERE name = ?")
-    .run(0, "disabled", name);
-  return result.changes > 0;
-}
-
-/**
- * Remove (uninstall) a plugin.
- */
-export function removePlugin(db, name) {
-  ensurePluginTables(db);
-  // Remove settings first
-  const plugin = getPlugin(db, name);
-  if (!plugin) return false;
-
-  db.prepare("DELETE FROM plugin_settings WHERE plugin_id = ?").run(plugin.id);
-  const result = db.prepare("DELETE FROM plugins WHERE name = ?").run(name);
-  return result.changes > 0;
-}
-
-/**
- * Update a plugin version.
- */
-export function updatePlugin(db, name, newVersion) {
-  ensurePluginTables(db);
-  const result = db
-    .prepare(
-      "UPDATE plugins SET version = ?, updated_at = datetime('now') WHERE name = ?",
-    )
-    .run(newVersion, name);
-  return result.changes > 0;
-}
-
-/**
- * Set a plugin setting.
- */
-export function setPluginSetting(db, pluginName, key, value) {
-  ensurePluginTables(db);
-  const plugin = getPlugin(db, pluginName);
-  if (!plugin) throw new Error(`Plugin not found: ${pluginName}`);
-
-  // Remove existing setting for this key
-  db.prepare("DELETE FROM plugin_settings WHERE plugin_id = ? AND key = ?").run(
-    plugin.id,
-    key,
-  );
-  const settingId = `ps-${crypto.randomBytes(4).toString("hex")}`;
-  db.prepare(
-    `INSERT INTO plugin_settings (id, plugin_id, key, value) VALUES (?, ?, ?, ?)`,
-  ).run(
-    settingId,
-    plugin.id,
-    key,
-    typeof value === "string" ? value : JSON.stringify(value),
-  );
-
-  return true;
-}
-
-/**
- * Get a plugin setting.
- */
-export function getPluginSetting(db, pluginName, key) {
-  ensurePluginTables(db);
-  const plugin = getPlugin(db, pluginName);
-  if (!plugin) return null;
-
-  const row = db
-    .prepare(
-      "SELECT value FROM plugin_settings WHERE plugin_id = ? AND key = ?",
-    )
-    .get(plugin.id, key);
-  return row ? row.value : null;
-}
-
-/**
- * Get all settings for a plugin.
- */
-export function getPluginSettings(db, pluginName) {
-  ensurePluginTables(db);
-  const plugin = getPlugin(db, pluginName);
-  if (!plugin) return {};
-
-  const rows = db
-    .prepare("SELECT key, value FROM plugin_settings WHERE plugin_id = ?")
-    .all(plugin.id);
-  const settings = {};
-  for (const row of rows) {
-    settings[row.key] = row.value;
-  }
-  return settings;
-}
-
-// ─── Registry / Marketplace ─────────────────────────────
-
-/**
- * Add/update a plugin in the registry.
- */
-export function registerInMarketplace(db, pluginInfo) {
-  ensurePluginTables(db);
-  const { name, latestVersion, description, author, tags } = pluginInfo;
-
-  db.prepare(
-    `INSERT OR REPLACE INTO plugin_registry (name, latest_version, description, author, tags)
-     VALUES (?, ?, ?, ?, ?)`,
-  ).run(
-    name,
-    latestVersion,
-    description || null,
-    author || null,
-    tags ? JSON.stringify(tags) : null,
-  );
-
-  return { name, latestVersion, description, author };
-}
-
-/**
- * Search plugins in registry.
- */
-export function searchRegistry(db, query) {
-  ensurePluginTables(db);
-  return db
-    .prepare(
-      "SELECT * FROM plugin_registry WHERE name LIKE ? OR description LIKE ? ORDER BY downloads DESC",
-    )
-    .all(`%${query}%`, `%${query}%`);
-}
-
-/**
- * List all registry plugins.
- */
-export function listRegistry(db) {
-  ensurePluginTables(db);
-  return db
-    .prepare("SELECT * FROM plugin_registry ORDER BY downloads DESC")
-    .all();
-}
-
-/**
- * Get plugin summary.
- */
-export function getPluginSummary(db) {
-  ensurePluginTables(db);
-  const total = db.prepare("SELECT COUNT(*) as c FROM plugins").get();
-  const enabled = db
-    .prepare("SELECT COUNT(*) as c FROM plugins WHERE enabled = ?")
-    .get(1);
-  const registry = db
-    .prepare("SELECT COUNT(*) as c FROM plugin_registry")
-    .get();
-
-  return {
-    installed: total?.c || 0,
-    enabled: enabled?.c || 0,
-    registryCount: registry?.c || 0,
-  };
-}
-
-// ─── Plugin Skills ──────────────────────────────────────
-
-/**
- * Get the marketplace skills directory
- */
-function getMarketplaceSkillsDir() {
-  return path.join(getElectronUserDataDir(), "marketplace", "skills");
-}
-
-/**
- * Install skills from a plugin manifest.
- * Copies skill directories to the marketplace/skills/ layer.
+ * @deprecated — canonical implementation lives in `../harness/plugin-manager.js`
+ * as of the CLI Runtime Convergence roadmap (Phase 4, 2026-04-09).
+ * This file is retained as a re-export shim for backwards compatibility
+ * and will be removed once all external consumers have migrated.
  *
- * @param {object} db - Database instance
- * @param {string} pluginName - Plugin name
- * @param {string} pluginPath - Root path of the plugin package
- * @param {{ name: string, path: string }[]} skills - Skills declared in manifest
- * @returns {{ installed: string[] }} Names of installed skills
- */
-export function installPluginSkills(db, pluginName, pluginPath, skills) {
-  ensurePluginTables(db);
-  if (!skills || skills.length === 0) return { installed: [] };
-
-  const marketplaceDir = getMarketplaceSkillsDir();
-  const installed = [];
-
-  for (const skill of skills) {
-    const srcDir = path.resolve(pluginPath, skill.path);
-    if (!fs.existsSync(srcDir)) continue;
-
-    const destDir = path.join(marketplaceDir, skill.name);
-    fs.mkdirSync(destDir, { recursive: true });
-
-    // Copy skill files
-    _copyDirSync(srcDir, destDir);
-
-    // Record in DB
-    const id = `ps-${crypto.randomBytes(6).toString("hex")}`;
-    db.prepare(
-      `INSERT OR REPLACE INTO plugin_skills (id, plugin_name, skill_name, skill_path)
-       VALUES (?, ?, ?, ?)`,
-    ).run(id, pluginName, skill.name, destDir);
-
-    installed.push(skill.name);
-  }
-
-  return { installed };
-}
-
-/**
- * Remove all skills installed by a plugin.
- *
- * @param {object} db - Database instance
- * @param {string} pluginName - Plugin name
- * @returns {{ removed: string[] }} Names of removed skills
- */
-export function removePluginSkills(db, pluginName) {
-  ensurePluginTables(db);
-  const rows = db
-    .prepare("SELECT * FROM plugin_skills WHERE plugin_name = ?")
-    .all(pluginName);
-
-  const removed = [];
-  for (const row of rows) {
-    // Remove the skill directory
-    if (fs.existsSync(row.skill_path)) {
-      fs.rmSync(row.skill_path, { recursive: true, force: true });
-    }
-    removed.push(row.skill_name);
-  }
-
-  db.prepare("DELETE FROM plugin_skills WHERE plugin_name = ?").run(pluginName);
-  return { removed };
-}
-
-/**
- * List skills installed by a specific plugin.
- *
- * @param {object} db - Database instance
- * @param {string} pluginName - Plugin name
- * @returns {{ skill_name: string, skill_path: string }[]}
- */
-export function getPluginSkills(db, pluginName) {
-  ensurePluginTables(db);
-  return db
-    .prepare(
-      "SELECT skill_name, skill_path FROM plugin_skills WHERE plugin_name = ?",
-    )
-    .all(pluginName);
-}
-
-/**
- * Recursively copy a directory
- */
-function _copyDirSync(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      _copyDirSync(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
+ * Please import plugin manager functions directly from
+ * `packages/cli/src/harness/plugin-manager.js` in new code.
+ */
+
+export {
+  ensurePluginTables,
+  installPlugin,
+  getPlugin,
+  getPluginById,
+  listPlugins,
+  enablePlugin,
+  disablePlugin,
+  removePlugin,
+  updatePlugin,
+  setPluginSetting,
+  getPluginSetting,
+  getPluginSettings,
+  registerInMarketplace,
+  searchRegistry,
+  listRegistry,
+  getPluginSummary,
+  installPluginSkills,
+  removePluginSkills,
+  getPluginSkills,
+} from "../harness/plugin-manager.js";

package/src/lib/prompt-compressor.js

@@ -1,3 +1,14 @@
+/**
+ * @deprecated — canonical implementation lives in
+ * `../harness/prompt-compressor.js` as of the CLI Runtime Convergence
+ * roadmap. This file is retained as a re-export shim for backwards
+ * compatibility and will be removed once all external consumers have
+ * migrated.
+ *
+ * Please import from `packages/cli/src/harness/prompt-compressor.js`
+ * in new code.
+ */
+
 export {
   estimateTokens,
   estimateMessagesTokens,

package/src/lib/session-hooks.js

@@ -0,0 +1,61 @@
+/**
+ * Session-level hook firing helpers — the "三件套" that complements
+ * the tool-level PreToolUse/PostToolUse hooks already wired in
+ * `runtime/agent-core.js`.
+ *
+ * These three events are defined in hook-manager.js but were never
+ * actually fired anywhere in the CLI. This module is the canonical
+ * fire site, consumed by `repl/agent-repl.js`.
+ *
+ *   - SessionStart      — once, after sessionId is established
+ *   - UserPromptSubmit  — per user line, before agentLoop()
+ *   - SessionEnd        — once, on rl.close() before shutdown
+ *
+ * Semantics (matches existing PreToolUse convention):
+ *   - Fire-and-forget: hook failures NEVER break the host flow
+ *   - Observational only: no abort, no rewrite (can be added later)
+ *   - No-op when hookDb is null (REPL without DB)
+ */
+
+import { executeHooks, HookEvents } from "./hook-manager.js";
+
+/**
+ * Events this helper is allowed to fire. Guards against typos that
+ * would otherwise silently no-op inside executeHooks' event filter.
+ */
+export const SESSION_HOOK_EVENTS = Object.freeze([
+  HookEvents.SessionStart,
+  HookEvents.UserPromptSubmit,
+  HookEvents.SessionEnd,
+]);
+
+/**
+ * Fire a session-level hook. Returns the raw results from executeHooks
+ * (array of {hookId, hookName, success, ...}) or an empty array if
+ * hookDb is missing, event is not allowed, or execution throws.
+ *
+ * @param {object|null} hookDb  better-sqlite3 handle, or null to no-op
+ * @param {string}      eventName  one of SESSION_HOOK_EVENTS
+ * @param {object}      [context]  forwarded to hook matcher + handler env
+ * @returns {Promise<Array>}
+ */
+export async function fireSessionHook(hookDb, eventName, context = {}) {
+  if (!hookDb) return [];
+  if (!SESSION_HOOK_EVENTS.includes(eventName)) {
+    throw new Error(
+      `fireSessionHook: event "${eventName}" is not a session hook. ` +
+        `Use one of: ${SESSION_HOOK_EVENTS.join(", ")}`,
+    );
+  }
+
+  try {
+    const enriched = {
+      timestamp: new Date().toISOString(),
+      ...context,
+    };
+    return await executeHooks(hookDb, eventName, enriched);
+  } catch (_err) {
+    // Hook failures must never break the REPL
+    return [];
+  }
+}

package/src/lib/skill-loader.js

@@ -13,6 +13,7 @@ import path from "path";
 import { fileURLToPath } from "url";
 import { getElectronUserDataDir } from "./paths.js";
 import { findProjectRoot } from "./project-detector.js";
+import { parseSkillMcpServers } from "./skill-mcp.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -225,6 +226,9 @@ export class CLISkillLoader {
             dirName: entry.name,
             hasHandler: fs.existsSync(path.join(dir, entry.name, "handler.js")),
             body,
+            // Skill-Embedded MCP: inline server declarations in a
+            // ```mcp-servers fenced code block. Empty array if absent.
+            mcpServers: parseSkillMcpServers(body),
             source: layer,
             skillDir: path.join(dir, entry.name),
           });