npm - chainlesschain - Versions diffs - 0.45.74 → 0.45.76 - Mend

chainlesschain 0.45.74 → 0.45.76

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (41) hide show

package/README.md +52 -15
package/package.json +1 -1
package/src/assets/web-panel/.build-hash +1 -1
package/src/assets/web-panel/assets/{AppLayout-BhJ3YFWt.js → AppLayout-2RCrdXxl.js} +1 -1
package/src/assets/web-panel/assets/AppLayout-D9pBLPC3.css +1 -0
package/src/assets/web-panel/assets/{Chat-DaxTP3x8.js → Chat-B2nB8o_F.js} +1 -1
package/src/assets/web-panel/assets/{Dashboard-CjlX4CrX.js → Dashboard-DanoHPSI.js} +1 -1
package/src/assets/web-panel/assets/{Skills-BCvgBkD3.js → Skills-CLlblJcG.js} +1 -1
package/src/assets/web-panel/assets/chat-DWBA4-cl.js +1 -0
package/src/assets/web-panel/assets/{index-DrmEk9S3.js → index-CyGtHm63.js} +2 -2
package/src/assets/web-panel/index.html +1 -1
package/src/commands/learning.js +273 -0
package/src/commands/lowcode.js +23 -8
package/src/gateways/discord/discord-formatter.js +89 -0
package/src/gateways/gateway-base.js +189 -0
package/src/gateways/telegram/telegram-formatter.js +93 -0
package/src/index.js +2 -0
package/src/lib/app-builder.js +136 -8
package/src/lib/autonomous-agent.js +8 -1
package/src/lib/cli-context-engineering.js +15 -0
package/src/lib/execution-backend.js +239 -0
package/src/lib/hook-manager.js +2 -0
package/src/lib/iteration-budget.js +175 -0
package/src/lib/learning/learning-hooks.js +117 -0
package/src/lib/learning/learning-tables.js +66 -0
package/src/lib/learning/outcome-feedback.js +243 -0
package/src/lib/learning/reflection-engine.js +323 -0
package/src/lib/learning/skill-improver.js +536 -0
package/src/lib/learning/skill-synthesizer.js +315 -0
package/src/lib/learning/trajectory-store.js +409 -0
package/src/lib/plugin-autodiscovery.js +224 -0
package/src/lib/session-search.js +193 -0
package/src/lib/sub-agent-context.js +7 -2
package/src/lib/user-profile.js +172 -0
package/src/lib/web-ui-server.js +1 -1
package/src/repl/agent-repl.js +109 -0
package/src/runtime/agent-core.js +75 -4
package/src/runtime/coding-agent-contract-shared.cjs +35 -0
package/src/runtime/coding-agent-policy.cjs +10 -0
package/src/assets/web-panel/assets/AppLayout-Cr2lWhF-.css +0 -1
package/src/assets/web-panel/assets/chat-BmwHBi9M.js +0 -1

package/src/lib/app-builder.js CHANGED Viewed

@@ -4,6 +4,8 @@
  */
 import crypto from "crypto";
+import fs from "fs";
+import path from "path";
 /** @type {Map<string, object>} In-memory app cache */
 const _apps = new Map();
@@ -220,14 +222,12 @@ export function saveDesign(db, appId, design) {
   ).run(versionId, appId, newVersion, JSON.stringify(design));
   if (!_versions.has(appId)) _versions.set(appId, []);
-  _versions
-    .get(appId)
-    .push({
-      id: versionId,
-      app_id: appId,
-      version: newVersion,
-      snapshot: design,
-    });
+  _versions.get(appId).push({
+    id: versionId,
+    app_id: appId,
+    version: newVersion,
+    snapshot: design,
+  });
   if (_apps.has(appId)) {
     _apps.get(appId).design = design;
@@ -375,3 +375,131 @@ export function listApps(db) {
     updated_at: r.updated_at,
   }));
 }
+/**
+ * Get a single application by ID from the database.
+ *
+ * @param {object} db
+ * @param {string} appId
+ * @returns {object|null}
+ */
+export function getApp(db, appId) {
+  const row = db.prepare(`SELECT * FROM lowcode_apps WHERE id = ?`).get(appId);
+  if (!row) return null;
+  return {
+    id: row.id,
+    name: row.name,
+    description: row.description,
+    design: row.design
+      ? JSON.parse(row.design)
+      : { components: [], layout: {} },
+    status: row.status,
+    version: row.version,
+    platform: row.platform,
+  };
+}
+/**
+ * Generate a static HTML bundle string for an app's design.
+ *
+ * @param {object} app - App object with design
+ * @returns {{ "index.html": string, "app.js": string, "style.css": string }}
+ */
+function generateStaticBundle(app) {
+  const design = app.design || { components: [], layout: {} };
+  const components = design.components || [];
+  const componentHtml = components
+    .map(
+      (c, i) =>
+        `    <div class="lc-component lc-${(c.type || c.name || "widget").toLowerCase()}" id="comp-${i}">${c.label || c.type || c.name || "Component"}</div>`,
+    )
+    .join("\n");
+  const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${app.name || "Low-Code App"}</title>
+  <link rel="stylesheet" href="style.css">
+</head>
+<body>
+  <div id="app">
+    <h1>${app.name || "Low-Code App"}</h1>
+    <p>${app.description || ""}</p>
+    <div class="lc-container">
+${componentHtml || "      <p>No components defined</p>"}
+    </div>
+  </div>
+  <script src="app.js"><\/script>
+</body>
+</html>`;
+  const css = `/* Generated by ChainlessChain Low-Code Platform */
+* { margin: 0; padding: 0; box-sizing: border-box; }
+body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; padding: 24px; background: #f5f5f5; }
+#app { max-width: 1200px; margin: 0 auto; }
+h1 { margin-bottom: 8px; color: #1a1a1a; }
+p { margin-bottom: 16px; color: #666; }
+.lc-container { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 16px; }
+.lc-component { background: #fff; border: 1px solid #e0e0e0; border-radius: 8px; padding: 16px; }
+`;
+  const js = `// Generated by ChainlessChain Low-Code Platform
+// App: ${app.name || "Untitled"} v${app.version || 1}
+(function() {
+  console.log("Low-Code App initialized: ${app.name || "Untitled"}");
+  var config = ${JSON.stringify({ id: app.id, name: app.name, version: app.version, platform: app.platform })};
+  document.querySelectorAll(".lc-component").forEach(function(el) {
+    el.addEventListener("click", function() { el.classList.toggle("active"); });
+  });
+})();
+`;
+  return { "index.html": html, "app.js": js, "style.css": css };
+}
+/**
+ * Deploy an application by generating a static bundle and writing it to disk.
+ *
+ * @param {object} db
+ * @param {string} appId
+ * @param {{ outputDir?: string }} options
+ * @returns {{ appId: string, outputDir: string, files: string[], deployedAt: string }}
+ */
+export function deployApp(db, appId, options = {}) {
+  const app = getApp(db, appId);
+  if (!app) {
+    throw new Error(`App '${appId}' not found`);
+  }
+  if (app.status !== "published") {
+    throw new Error(
+      `App '${appId}' must be published before deploying (current status: ${app.status})`,
+    );
+  }
+  const outputDir =
+    options.outputDir ||
+    path.join(process.cwd(), ".chainlesschain", "deploys", appId);
+  fs.mkdirSync(outputDir, { recursive: true });
+  const bundle = generateStaticBundle(app);
+  const fileNames = [];
+  for (const [fileName, content] of Object.entries(bundle)) {
+    fs.writeFileSync(path.join(outputDir, fileName), content, "utf-8");
+    fileNames.push(fileName);
+  }
+  // Update app status to deployed
+  db.prepare(
+    `UPDATE lowcode_apps SET status = ?, updated_at = datetime('now') WHERE id = ?`,
+  ).run("deployed", appId);
+  if (_apps.has(appId)) {
+    _apps.get(appId).status = "deployed";
+  }
+  const deployedAt = new Date().toISOString();
+  return { appId, outputDir, files: fileNames, deployedAt };
+}

package/src/lib/autonomous-agent.js CHANGED Viewed

@@ -52,11 +52,18 @@ export class CLIAutonomousAgent extends EventEmitter {
   /**
    * Initialize with required dependencies.
    */
-  initialize({ llmChat, toolExecutor, hookManager, maxIterations } = {}) {
+  initialize({
+    llmChat,
+    toolExecutor,
+    hookManager,
+    maxIterations,
+    iterationBudget,
+  } = {}) {
     this._llmChat = llmChat || null;
     this._toolExecutor = toolExecutor || null;
     this._hookManager = hookManager || null;
     if (maxIterations) this._maxIterations = maxIterations;
+    this._iterationBudget = iterationBudget || null; // shared budget from caller
     this._initialized = true;
   }

package/src/lib/cli-context-engineering.js CHANGED Viewed

@@ -12,6 +12,7 @@ import { generateInstinctPrompt } from "./instinct-manager.js";
 import { recallMemory } from "./hierarchical-memory.js";
 import { BM25Search } from "./bm25-search.js";
 import { createHash } from "crypto";
+import { readUserProfile } from "./user-profile.js";
 // Exported for test injection
 export const _deps = {
@@ -19,6 +20,7 @@ export const _deps = {
   recallMemory,
   BM25Search,
   createHash,
+  readUserProfile,
 };
 // ─── System prompt cleaning regexes (match desktop KV-Cache optimization) ───
@@ -105,6 +107,19 @@ export class CLIContextEngineering {
       }
     }
+    // 2b. User profile injection (USER.md)
+    try {
+      const profile = _deps.readUserProfile();
+      if (profile) {
+        result.push({
+          role: "system",
+          content: `## User Profile\n${profile}`,
+        });
+      }
+    } catch (_err) {
+      // User profile injection failed — skip silently
+    }
     // 3. Memory injection (scoped: higher threshold, namespace-aware)
     if (this.db && userQuery) {
       try {

package/src/lib/execution-backend.js ADDED Viewed

@@ -0,0 +1,239 @@
+/**
+ * Execution Backend — abstraction for command execution environments.
+ *
+ * Provides LocalBackend (default), DockerBackend, and SSHBackend.
+ * The agent's run_shell and run_code tools delegate to the active backend.
+ *
+ * Config: .chainlesschain/config.json → agent.executionBackend
+ * Feature flag: EXECUTION_BACKENDS (off by default)
+ *
+ * @module execution-backend
+ */
+import { execSync } from "node:child_process";
+// ─── Exported for test injection ────────────────────────────────────
+export const _deps = {
+  execSync,
+};
+// ─── Base class ─────────────────────────────────────────────────────
+export class ExecutionBackend {
+  constructor(options = {}) {
+    this.type = "base";
+    this.options = options;
+  }
+  /**
+   * Execute a command.
+   * @param {string} command - The command to run
+   * @param {object} [opts]
+   * @param {string} [opts.cwd] - Working directory
+   * @param {number} [opts.timeout] - Timeout in ms
+   * @param {number} [opts.maxBuffer] - Max output buffer size
+   * @returns {{ stdout: string, stderr: string, exitCode: number }}
+   */
+  execute(command, opts = {}) {
+    throw new Error("execute() must be implemented by subclass");
+  }
+  /** @returns {string} Backend description for logging */
+  describe() {
+    return `${this.type} backend`;
+  }
+}
+// ─── Local Backend ──────────────────────────────────────────────────
+export class LocalBackend extends ExecutionBackend {
+  constructor(options = {}) {
+    super(options);
+    this.type = "local";
+  }
+  execute(command, opts = {}) {
+    const cwd = opts.cwd || process.cwd();
+    const timeout = opts.timeout || 60000;
+    const maxBuffer = opts.maxBuffer || 1024 * 1024;
+    try {
+      const stdout = _deps.execSync(command, {
+        cwd,
+        encoding: "utf8",
+        timeout,
+        maxBuffer,
+      });
+      return { stdout: stdout || "", stderr: "", exitCode: 0 };
+    } catch (err) {
+      return {
+        stdout: (err.stdout || "").toString(),
+        stderr: (err.stderr || err.message || "").toString(),
+        exitCode: err.status || 1,
+      };
+    }
+  }
+  describe() {
+    return "local (direct execution)";
+  }
+}
+// ─── Docker Backend ─────────────────────────────────────────────────
+export class DockerBackend extends ExecutionBackend {
+  /**
+   * @param {object} options
+   * @param {string} options.container - Container name or ID (for exec mode)
+   * @param {string} [options.image] - Image name (for run mode — ephemeral containers)
+   * @param {string} [options.workdir] - Working directory inside container
+   * @param {string[]} [options.volumes] - Volume mounts (host:container format)
+   * @param {string} [options.shell] - Shell to use (default: sh)
+   */
+  constructor(options = {}) {
+    super(options);
+    this.type = "docker";
+    this.container = options.container || null;
+    this.image = options.image || null;
+    this.workdir = options.workdir || "/workspace";
+    this.volumes = options.volumes || [];
+    this.shell = options.shell || "sh";
+  }
+  execute(command, opts = {}) {
+    const timeout = opts.timeout || 60000;
+    const maxBuffer = opts.maxBuffer || 1024 * 1024;
+    const cwd = opts.cwd || this.workdir;
+    let dockerCmd;
+    if (this.container) {
+      // Exec into existing container
+      dockerCmd = `docker exec -w "${cwd}" ${this.container} ${this.shell} -c "${this._escapeCommand(command)}"`;
+    } else if (this.image) {
+      // Run ephemeral container
+      const volumeArgs = this.volumes.map((v) => `-v "${v}"`).join(" ");
+      dockerCmd = `docker run --rm -w "${cwd}" ${volumeArgs} ${this.image} ${this.shell} -c "${this._escapeCommand(command)}"`;
+    } else {
+      return {
+        stdout: "",
+        stderr: "Docker backend: neither container nor image specified",
+        exitCode: 1,
+      };
+    }
+    try {
+      const stdout = _deps.execSync(dockerCmd, {
+        encoding: "utf8",
+        timeout,
+        maxBuffer,
+      });
+      return { stdout: stdout || "", stderr: "", exitCode: 0 };
+    } catch (err) {
+      return {
+        stdout: (err.stdout || "").toString(),
+        stderr: (err.stderr || err.message || "").toString(),
+        exitCode: err.status || 1,
+      };
+    }
+  }
+  _escapeCommand(cmd) {
+    return cmd.replace(/"/g, '\\"');
+  }
+  describe() {
+    if (this.container) return `docker exec (container: ${this.container})`;
+    return `docker run (image: ${this.image})`;
+  }
+}
+// ─── SSH Backend ────────────────────────────────────────────────────
+export class SSHBackend extends ExecutionBackend {
+  /**
+   * @param {object} options
+   * @param {string} options.host - Remote host
+   * @param {string} [options.user] - SSH user
+   * @param {string} [options.key] - Path to SSH private key
+   * @param {number} [options.port] - SSH port (default: 22)
+   * @param {string} [options.workdir] - Remote working directory
+   */
+  constructor(options = {}) {
+    super(options);
+    this.type = "ssh";
+    this.host = options.host;
+    this.user = options.user || "";
+    this.key = options.key || "";
+    this.port = options.port || 22;
+    this.workdir = options.workdir || "~";
+  }
+  execute(command, opts = {}) {
+    const timeout = opts.timeout || 60000;
+    const maxBuffer = opts.maxBuffer || 1024 * 1024;
+    const cwd = opts.cwd || this.workdir;
+    if (!this.host) {
+      return {
+        stdout: "",
+        stderr: "SSH backend: host not specified",
+        exitCode: 1,
+      };
+    }
+    const userHost = this.user ? `${this.user}@${this.host}` : this.host;
+    const keyArg = this.key ? `-i "${this.key}"` : "";
+    const portArg = this.port !== 22 ? `-p ${this.port}` : "";
+    const remoteCmd = `cd "${cwd}" && ${command}`;
+    const sshCmd = `ssh ${keyArg} ${portArg} -o StrictHostKeyChecking=no -o ConnectTimeout=10 ${userHost} "${this._escapeCommand(remoteCmd)}"`;
+    try {
+      const stdout = _deps.execSync(sshCmd, {
+        encoding: "utf8",
+        timeout,
+        maxBuffer,
+      });
+      return { stdout: stdout || "", stderr: "", exitCode: 0 };
+    } catch (err) {
+      return {
+        stdout: (err.stdout || "").toString(),
+        stderr: (err.stderr || err.message || "").toString(),
+        exitCode: err.status || 1,
+      };
+    }
+  }
+  _escapeCommand(cmd) {
+    return cmd.replace(/"/g, '\\"');
+  }
+  describe() {
+    const userHost = this.user ? `${this.user}@${this.host}` : this.host;
+    return `ssh (${userHost}:${this.port})`;
+  }
+}
+// ─── Factory ────────────────────────────────────────────────────────
+/**
+ * Create an execution backend from config.
+ * @param {object} [config] - Backend config from config.json
+ * @param {string} [config.type] - "local" | "docker" | "ssh"
+ * @param {object} [config.options] - Backend-specific options
+ * @returns {ExecutionBackend}
+ */
+export function createBackend(config = {}) {
+  const type = (config.type || "local").toLowerCase();
+  switch (type) {
+    case "docker":
+      return new DockerBackend(config.options || {});
+    case "ssh":
+      return new SSHBackend(config.options || {});
+    case "local":
+    default:
+      return new LocalBackend(config.options || {});
+  }
+}

package/src/lib/hook-manager.js CHANGED Viewed

@@ -58,6 +58,8 @@ export const HookEvents = {
   PostGitCommit: "PostGitCommit",
   PreGitPush: "PreGitPush",
   CIFailure: "CIFailure",
+  IterationWarning: "IterationWarning",
+  IterationBudgetExhausted: "IterationBudgetExhausted",
 };
 /**

package/src/lib/iteration-budget.js ADDED Viewed

@@ -0,0 +1,175 @@
+/**
+ * Iteration Budget — shared, configurable iteration limit for agent loops.
+ *
+ * Replaces the hardcoded MAX_ITERATIONS constant with a first-class budget
+ * object that is shared across parent and child agents, supports progressive
+ * warnings, and can be configured via config.json or environment variable.
+ *
+ * Inspired by Hermes Agent's shared iteration budget system.
+ *
+ * @module iteration-budget
+ */
+// ─── Constants ──────────────────────────────────────────────────────────────
+const DEFAULT_BUDGET = 50;
+const WARNING_THRESHOLD = 0.7; // 70%
+const WRAPPING_UP_THRESHOLD = 0.9; // 90%
+/**
+ * Warning level enum.
+ */
+export const WarningLevel = {
+  NONE: "none",
+  WARNING: "warning", // 70-89%
+  WRAPPING_UP: "wrapping-up", // 90-99%
+  EXHAUSTED: "exhausted", // 100%
+};
+// ─── IterationBudget ────────────────────────────────────────────────────────
+export class IterationBudget {
+  /**
+   * @param {object} [options]
+   * @param {number} [options.limit] - Maximum iterations (default: 50)
+   * @param {string} [options.owner] - Identifier for the budget creator (e.g. session ID)
+   */
+  constructor(options = {}) {
+    this._limit = options.limit || IterationBudget.resolveLimit();
+    this._consumed = 0;
+    this._owner = options.owner || null;
+    this._warnings = []; // timestamps of emitted warnings
+  }
+  /**
+   * Resolve the budget limit from config/env/default.
+   * Priority: CC_ITERATION_BUDGET env > default
+   */
+  static resolveLimit() {
+    const env = process.env.CC_ITERATION_BUDGET;
+    if (env) {
+      const parsed = parseInt(env, 10);
+      if (!isNaN(parsed) && parsed > 0) return parsed;
+    }
+    return DEFAULT_BUDGET;
+  }
+  /** Total iteration limit. */
+  get limit() {
+    return this._limit;
+  }
+  /** Number of iterations consumed so far. */
+  get consumed() {
+    return this._consumed;
+  }
+  /**
+   * Consume one iteration. Returns the current warning level after consumption.
+   * @returns {string} WarningLevel value
+   */
+  consume() {
+    this._consumed++;
+    return this.warningLevel();
+  }
+  /**
+   * Number of iterations remaining.
+   * @returns {number}
+   */
+  remaining() {
+    return Math.max(0, this._limit - this._consumed);
+  }
+  /**
+   * Percentage of budget consumed (0.0 – 1.0+).
+   * @returns {number}
+   */
+  percentage() {
+    if (this._limit === 0) return 1;
+    return this._consumed / this._limit;
+  }
+  /**
+   * Whether the budget is exhausted.
+   * @returns {boolean}
+   */
+  isExhausted() {
+    return this._consumed >= this._limit;
+  }
+  /**
+   * Whether there is still budget remaining.
+   * @returns {boolean}
+   */
+  hasRemaining() {
+    return this._consumed < this._limit;
+  }
+  /**
+   * Current warning level based on consumption percentage.
+   * @returns {string} WarningLevel value
+   */
+  warningLevel() {
+    const pct = this.percentage();
+    if (pct >= 1) return WarningLevel.EXHAUSTED;
+    if (pct >= WRAPPING_UP_THRESHOLD) return WarningLevel.WRAPPING_UP;
+    if (pct >= WARNING_THRESHOLD) return WarningLevel.WARNING;
+    return WarningLevel.NONE;
+  }
+  /**
+   * Record that a warning was emitted (for dedup in the agent loop).
+   * @param {string} level - WarningLevel value
+   */
+  recordWarning(level) {
+    this._warnings.push({ level, at: this._consumed });
+  }
+  /**
+   * Whether a warning at this level has already been recorded.
+   * @param {string} level
+   * @returns {boolean}
+   */
+  hasWarned(level) {
+    return this._warnings.some((w) => w.level === level);
+  }
+  /**
+   * Generate a human-readable summary of budget usage.
+   * Useful when the budget is exhausted and the agent needs to report status.
+   * @returns {string}
+   */
+  toSummary() {
+    const pct = Math.round(this.percentage() * 100);
+    return (
+      `Iteration budget: ${this._consumed}/${this._limit} (${pct}%). ` +
+      `${this.remaining()} iterations remaining.`
+    );
+  }
+  /**
+   * Create a warning message suitable for appending to tool results.
+   * @returns {string|null} Warning message or null if no warning needed
+   */
+  toWarningMessage() {
+    const level = this.warningLevel();
+    const remaining = this.remaining();
+    switch (level) {
+      case WarningLevel.WARNING:
+        return `[Budget Warning] ${remaining} iterations remaining out of ${this._limit}. Start wrapping up your work.`;
+      case WarningLevel.WRAPPING_UP:
+        return `[Budget Critical] Only ${remaining} iterations remaining! Finish immediately and return your results.`;
+      case WarningLevel.EXHAUSTED:
+        return `[Budget Exhausted] No iterations remaining. Returning work summary.`;
+      default:
+        return null;
+    }
+  }
+}
+// ─── Defaults ───────────────────────────────────────────────────────────────
+export const DEFAULT_ITERATION_BUDGET = DEFAULT_BUDGET;
+export const BUDGET_WARNING_THRESHOLD = WARNING_THRESHOLD;
+export const BUDGET_WRAPPING_UP_THRESHOLD = WRAPPING_UP_THRESHOLD;