chainlesschain 0.45.70 → 0.45.75

package/src/runtime/agent-runtime.js

@@ -15,7 +15,7 @@ import { startChatRepl } from "../gateways/repl/chat-repl.js";
 import { ChainlessChainWSServer } from "../gateways/ws/ws-server.js";
 import { WSSessionManager } from "../gateways/ws/ws-session-gateway.js";
 import { createWebUIServer } from "../gateways/ui/web-ui-server.js";
-import { MCPClient, MCPServerConfig } from "../lib/mcp-client.js";
+import { MCPClient, MCPServerConfig } from "../harness/mcp-client.js";
 import sharedManagedToolPolicy from "./coding-agent-managed-tool-policy.cjs";
 import { findProjectRoot, loadProjectConfig } from "../lib/project-detector.js";
 import { loadConfig } from "../lib/config-manager.js";
@@ -228,6 +228,7 @@ export class AgentRuntime {
       );
     }
 
+    const appConfig = this.deps.loadConfig();
     const mcpClient = await this._initializeCodingAgentMcpClient(rawDb, {
       logger: runtimeLogger,
     });
@@ -235,6 +236,7 @@ export class AgentRuntime {
     const sessionManager = this.deps.createSessionManager({
       db,
       defaultProjectRoot: project,
+      config: appConfig,
       mcpClient,
       allowedMcpServerNames: DEFAULT_ALLOWED_MCP_SERVER_NAMES,
       mcpServerRegistry: this.deps.mcpServerRegistry,

package/src/runtime/coding-agent-contract-shared.cjs

@@ -0,0 +1,496 @@
+"use strict";
+
+const sharedCodingAgentPolicy = require("./coding-agent-policy.cjs");
+
+const { TOOL_POLICY_METADATA } = sharedCodingAgentPolicy;
+
+function cloneValue(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+function createFunctionToolContract(tool) {
+  return Object.freeze({
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description || "",
+      parameters: cloneValue(
+        tool.inputSchema || { type: "object", properties: {} },
+      ),
+    },
+  });
+}
+
+const CODING_AGENT_TOOL_CONTRACTS = Object.freeze([
+  {
+    name: "read_file",
+    title: "Read File",
+    kind: "filesystem",
+    tier: "mvp",
+    description: "Read a file's content",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "File path to read" },
+      },
+      required: ["path"],
+    },
+    ...TOOL_POLICY_METADATA.read_file,
+    permissions: {
+      level: "readonly",
+      scopes: ["filesystem:read"],
+    },
+    telemetry: {
+      category: "filesystem",
+      tags: ["tool:read_file", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "write_file",
+    title: "Write File",
+    kind: "filesystem",
+    tier: "mvp",
+    description: "Write content to a file (create or overwrite)",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "File path" },
+        content: { type: "string", description: "File content" },
+      },
+      required: ["path", "content"],
+    },
+    ...TOOL_POLICY_METADATA.write_file,
+    permissions: {
+      level: "elevated",
+      scopes: ["filesystem:write"],
+    },
+    telemetry: {
+      category: "filesystem",
+      tags: ["tool:write_file", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "edit_file",
+    title: "Edit File",
+    kind: "filesystem",
+    tier: "mvp",
+    description: "Replace a specific string in a file with new content",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "File path" },
+        old_string: {
+          type: "string",
+          description: "Exact string to find and replace",
+        },
+        new_string: {
+          type: "string",
+          description: "Replacement string",
+        },
+      },
+      required: ["path", "old_string", "new_string"],
+    },
+    ...TOOL_POLICY_METADATA.edit_file,
+    permissions: {
+      level: "elevated",
+      scopes: ["filesystem:write"],
+    },
+    telemetry: {
+      category: "filesystem",
+      tags: ["tool:edit_file", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "edit_file_hashed",
+    title: "Edit File (Hash-Anchored)",
+    kind: "filesystem",
+    tier: "mvp",
+    description:
+      "Replace a single line in a file, anchored by its content hash. Use this instead of edit_file for robust edits: each line of read_file output (with hashed:true) is tagged with a 6-char hash like 'a3Kp9Z| const x = ...'. Pass the hash as anchor_hash, the current line as expected_line, and the replacement as new_line. Rejects edits if the line drifted (hash mismatch) — retry by re-reading the file with hashed:true.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: { type: "string", description: "File path" },
+        anchor_hash: {
+          type: "string",
+          description:
+            "6-char base64url hash of the line to replace (from read_file with hashed:true)",
+        },
+        expected_line: {
+          type: "string",
+          description:
+            "Current content of the line — used as a second-layer check against hash collisions. Compared after .trim().",
+        },
+        new_line: {
+          type: "string",
+          description:
+            "Replacement line content (without the hash tag prefix). Preserve the original indentation.",
+        },
+      },
+      required: ["path", "anchor_hash", "expected_line", "new_line"],
+    },
+    ...TOOL_POLICY_METADATA.edit_file_hashed,
+    permissions: {
+      level: "elevated",
+      scopes: ["filesystem:write"],
+    },
+    telemetry: {
+      category: "filesystem",
+      tags: ["tool:edit_file_hashed", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "run_shell",
+    title: "Run Shell",
+    kind: "shell",
+    tier: "mvp",
+    description:
+      "Execute a shell command and return the output. Use for running tests, linting, builds, and other non-git workspace commands.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        command: { type: "string", description: "Shell command to execute" },
+        cwd: {
+          type: "string",
+          description: "Working directory (optional)",
+        },
+      },
+      required: ["command"],
+    },
+    ...TOOL_POLICY_METADATA.run_shell,
+    runtimeDescriptor: "shell",
+    permissions: {
+      level: "elevated",
+      scopes: ["process:spawn", "filesystem:workspace"],
+    },
+    telemetry: {
+      category: "shell",
+      tags: ["tool:run_shell", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "git",
+    title: "Git",
+    kind: "git",
+    tier: "mvp",
+    description:
+      "Run a git command inside the workspace. Use this instead of run_shell for git status, diff, log, commit, branch, and related repository operations.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        command: {
+          type: "string",
+          description:
+            'Git subcommand to execute, for example "status", "diff --stat", or "log --oneline -5"',
+        },
+        cwd: {
+          type: "string",
+          description: "Working directory (optional)",
+        },
+      },
+      required: ["command"],
+    },
+    ...TOOL_POLICY_METADATA.git,
+    runtimeDescriptor: "git",
+    permissions: {
+      level: "elevated",
+      scopes: ["process:spawn", "filesystem:workspace", "vcs:git"],
+    },
+    telemetry: {
+      category: "git",
+      tags: ["tool:git", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "search_files",
+    title: "Search Files",
+    kind: "filesystem",
+    tier: "mvp",
+    description: "Search for files by name pattern or content",
+    inputSchema: {
+      type: "object",
+      properties: {
+        pattern: {
+          type: "string",
+          description: "Glob pattern or search string",
+        },
+        directory: {
+          type: "string",
+          description: "Directory to search in (default: cwd)",
+        },
+        content_search: {
+          type: "boolean",
+          description: "If true, search file contents instead of names",
+        },
+      },
+      required: ["pattern"],
+    },
+    ...TOOL_POLICY_METADATA.search_files,
+    permissions: {
+      level: "readonly",
+      scopes: ["filesystem:read", "search:content"],
+    },
+    telemetry: {
+      category: "filesystem",
+      tags: ["tool:search_files", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "list_dir",
+    title: "List Directory",
+    kind: "filesystem",
+    tier: "mvp",
+    description: "List contents of a directory",
+    inputSchema: {
+      type: "object",
+      properties: {
+        path: {
+          type: "string",
+          description: "Directory path (default: cwd)",
+        },
+      },
+    },
+    ...TOOL_POLICY_METADATA.list_dir,
+    permissions: {
+      level: "readonly",
+      scopes: ["filesystem:read"],
+    },
+    telemetry: {
+      category: "filesystem",
+      tags: ["tool:list_dir", "contract:coding-agent", "tier:mvp"],
+    },
+  },
+  {
+    name: "run_skill",
+    title: "Run Skill",
+    kind: "skill",
+    tier: "extension",
+    description:
+      "Run a built-in ChainlessChain skill. Available skills include: code-review, summarize, translate, refactor, unit-test, debug, explain-code, browser-automation, data-analysis, git-history-analyzer, and 130+ more. Use list_skills first to discover available skills.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        skill_name: {
+          type: "string",
+          description:
+            "Name of the skill to run (e.g. code-review, summarize, translate)",
+        },
+        input: {
+          type: "string",
+          description: "Input text or parameters for the skill",
+        },
+      },
+      required: ["skill_name", "input"],
+    },
+    ...TOOL_POLICY_METADATA.run_skill,
+    permissions: {
+      level: "standard",
+      scopes: ["skill:invoke"],
+    },
+    telemetry: {
+      category: "skill",
+      tags: ["tool:run_skill", "contract:coding-agent", "tier:extension"],
+    },
+  },
+  {
+    name: "list_skills",
+    title: "List Skills",
+    kind: "skill",
+    tier: "extension",
+    description:
+      "List available built-in skills, optionally filtered by category or keyword",
+    inputSchema: {
+      type: "object",
+      properties: {
+        category: {
+          type: "string",
+          description: "Filter by category (e.g. development, automation, data)",
+        },
+        query: {
+          type: "string",
+          description: "Search keyword to filter skills",
+        },
+      },
+    },
+    ...TOOL_POLICY_METADATA.list_skills,
+    permissions: {
+      level: "readonly",
+      scopes: ["skill:read"],
+    },
+    telemetry: {
+      category: "skill",
+      tags: ["tool:list_skills", "contract:coding-agent", "tier:extension"],
+    },
+  },
+  {
+    name: "run_code",
+    title: "Run Code",
+    kind: "code",
+    tier: "extension",
+    description:
+      "Write and execute code in Python, Node.js, or Bash. Use this when the user needs data processing, calculations, file batch operations, API calls, or any task best solved with a script. Scripts are saved for reference. Missing Python packages are auto-installed.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        language: {
+          type: "string",
+          enum: ["python", "node", "bash"],
+          description: "Programming language",
+        },
+        code: { type: "string", description: "Code to execute" },
+        timeout: {
+          type: "number",
+          description: "Execution timeout in seconds (default: 60, max: 300)",
+        },
+        persist: {
+          type: "boolean",
+          description:
+            "If true (default), save script in .chainlesschain/agent-scripts/. If false, use temp file and clean up.",
+        },
+      },
+      required: ["language", "code"],
+    },
+    ...TOOL_POLICY_METADATA.run_code,
+    permissions: {
+      level: "elevated",
+      scopes: ["process:spawn", "filesystem:workspace", "runtime:script"],
+    },
+    telemetry: {
+      category: "code",
+      tags: ["tool:run_code", "contract:coding-agent", "tier:extension"],
+    },
+  },
+  {
+    name: "spawn_sub_agent",
+    title: "Spawn Sub Agent",
+    kind: "agent",
+    tier: "extension",
+    description:
+      "Spawn an isolated sub-agent to handle a subtask. The sub-agent has its own context and message history, and only returns a summary result. Use this for tasks that benefit from focused, independent execution (e.g. code review, summarization, translation).",
+    inputSchema: {
+      type: "object",
+      properties: {
+        role: {
+          type: "string",
+          description:
+            "Sub-agent role (e.g. code-review, summarizer, translator, debugger)",
+        },
+        task: {
+          type: "string",
+          description: "Task description for the sub-agent",
+        },
+        context: {
+          type: "string",
+          description:
+            "Optional condensed context from the parent agent to pass to the sub-agent",
+        },
+        tools: {
+          type: "array",
+          items: { type: "string" },
+          description:
+            'Optional tool whitelist for the sub-agent (e.g. ["read_file", "search_files"]). If omitted, all tools are available.',
+        },
+      },
+      required: ["role", "task"],
+    },
+    ...TOOL_POLICY_METADATA.spawn_sub_agent,
+    permissions: {
+      level: "elevated",
+      scopes: ["agent:spawn"],
+    },
+    telemetry: {
+      category: "agent",
+      tags: ["tool:spawn_sub_agent", "contract:coding-agent", "tier:extension"],
+    },
+  },
+]);
+
+const CODING_AGENT_MVP_TOOL_NAMES = Object.freeze(
+  CODING_AGENT_TOOL_CONTRACTS.filter((tool) => tool.tier === "mvp").map(
+    (tool) => tool.name,
+  ),
+);
+
+const CODING_AGENT_EXTENSION_TOOL_NAMES = Object.freeze(
+  CODING_AGENT_TOOL_CONTRACTS.filter((tool) => tool.tier === "extension").map(
+    (tool) => tool.name,
+  ),
+);
+
+const TOOL_CONTRACT_MAP = new Map(
+  CODING_AGENT_TOOL_CONTRACTS.map((tool) => [tool.name, tool]),
+);
+
+function getCodingAgentToolContract(name) {
+  const tool = TOOL_CONTRACT_MAP.get(name);
+  return tool ? cloneValue(tool) : null;
+}
+
+function getCodingAgentToolContracts(options = {}) {
+  const { tier = null } = options;
+  return CODING_AGENT_TOOL_CONTRACTS.filter((tool) => {
+    if (tier && tool.tier !== tier) {
+      return false;
+    }
+    return true;
+  }).map(cloneValue);
+}
+
+function listCodingAgentToolNames(options = {}) {
+  return getCodingAgentToolContracts(options).map((tool) => tool.name);
+}
+
+function isCodingAgentMvpTool(name) {
+  return CODING_AGENT_MVP_TOOL_NAMES.includes(name);
+}
+
+function getCodingAgentToolPolicy(name) {
+  const tool = TOOL_CONTRACT_MAP.get(name);
+  if (!tool) {
+    return null;
+  }
+
+  return {
+    tier: tool.tier,
+    riskLevel: tool.riskLevel,
+    availableInPlanMode: tool.availableInPlanMode,
+    planModeBehavior: tool.planModeBehavior || "standard",
+    requiresPlanApproval: tool.requiresPlanApproval,
+    approvalFlow: tool.approvalFlow,
+    permissions: cloneValue(tool.permissions),
+  };
+}
+
+function getCodingAgentFunctionToolDefinition(name) {
+  const tool = TOOL_CONTRACT_MAP.get(name);
+  return tool ? createFunctionToolContract(tool) : null;
+}
+
+function getCodingAgentFunctionToolDefinitions(options = {}) {
+  const { tier = null, names = null } = options;
+  const allowedNames =
+    Array.isArray(names) && names.length > 0 ? new Set(names) : null;
+
+  return CODING_AGENT_TOOL_CONTRACTS.filter((tool) => {
+    if (tier && tool.tier !== tier) {
+      return false;
+    }
+    if (allowedNames && !allowedNames.has(tool.name)) {
+      return false;
+    }
+    return true;
+  }).map(createFunctionToolContract);
+}
+
+module.exports = {
+  CODING_AGENT_TOOL_CONTRACTS,
+  CODING_AGENT_MVP_TOOL_NAMES,
+  CODING_AGENT_EXTENSION_TOOL_NAMES,
+  getCodingAgentFunctionToolDefinition,
+  getCodingAgentFunctionToolDefinitions,
+  getCodingAgentToolContract,
+  getCodingAgentToolContracts,
+  getCodingAgentToolPolicy,
+  isCodingAgentMvpTool,
+  listCodingAgentToolNames,
+};