chainlesschain 0.45.67 → 0.45.74

package/src/runtime/coding-agent-contract.js

@@ -1,193 +1,18 @@
 import { ToolRegistry, createDefaultToolRegistry } from "../tools/registry.js";
-import sharedCodingAgentPolicy from "./coding-agent-policy.cjs";
+import sharedContract from "./coding-agent-contract-shared.cjs";
+
+const {
+  CODING_AGENT_EXTENSION_TOOL_NAMES,
+  CODING_AGENT_MVP_TOOL_NAMES,
+  getCodingAgentFunctionToolDefinition,
+  getCodingAgentFunctionToolDefinitions,
+  getCodingAgentToolContract,
+  getCodingAgentToolContracts,
+  getCodingAgentToolPolicy,
+  isCodingAgentMvpTool,
+  listCodingAgentToolNames,
+} = sharedContract;
 
-const { TOOL_POLICY_METADATA } = sharedCodingAgentPolicy;
-
-const CODING_AGENT_TOOL_CONTRACTS = Object.freeze([
-  {
-    name: "read_file",
-    title: "Read File",
-    kind: "filesystem",
-    tier: "mvp",
-    ...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",
-    ...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",
-    ...TOOL_POLICY_METADATA.edit_file,
-    permissions: {
-      level: "elevated",
-      scopes: ["filesystem:write"],
-    },
-    telemetry: {
-      category: "filesystem",
-      tags: ["tool:edit_file", "contract:coding-agent", "tier:mvp"],
-    },
-  },
-  {
-    name: "run_shell",
-    title: "Run Shell",
-    kind: "shell",
-    tier: "mvp",
-    ...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",
-    ...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",
-    ...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",
-    ...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",
-    ...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",
-    ...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",
-    ...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",
-    ...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"],
-    },
-  },
-]);
-
-export const CODING_AGENT_MVP_TOOL_NAMES = Object.freeze(
-  CODING_AGENT_TOOL_CONTRACTS.filter((tool) => tool.tier === "mvp").map(
-    (tool) => tool.name,
-  ),
-);
-
-export 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]),
-);
 const runtimeRegistry = createDefaultToolRegistry();
 
 function cloneValue(value) {
@@ -216,44 +41,17 @@ function getFallbackToolContract(name) {
   };
 }
 
-export function getCodingAgentToolContract(name) {
-  const tool = TOOL_CONTRACT_MAP.get(name);
-  return tool ? cloneValue(tool) : null;
-}
-
-export function getCodingAgentToolContracts({ tier = null } = {}) {
-  return CODING_AGENT_TOOL_CONTRACTS.filter((tool) => {
-    if (tier && tool.tier !== tier) {
-      return false;
-    }
-    return true;
-  }).map(cloneValue);
-}
-
-export function listCodingAgentToolNames({ tier = null } = {}) {
-  return getCodingAgentToolContracts({ tier }).map((tool) => tool.name);
-}
-
-export function isCodingAgentMvpTool(name) {
-  return CODING_AGENT_MVP_TOOL_NAMES.includes(name);
-}
-
-export 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),
-  };
-}
+export {
+  CODING_AGENT_EXTENSION_TOOL_NAMES,
+  CODING_AGENT_MVP_TOOL_NAMES,
+  getCodingAgentFunctionToolDefinition,
+  getCodingAgentFunctionToolDefinitions,
+  getCodingAgentToolContract,
+  getCodingAgentToolContracts,
+  getCodingAgentToolPolicy,
+  isCodingAgentMvpTool,
+  listCodingAgentToolNames,
+};
 
 export function mapCodingAgentToolDefinition(definition = {}, options = {}) {
   const fn = definition.function || {};
@@ -269,8 +67,14 @@ export function mapCodingAgentToolDefinition(definition = {}, options = {}) {
     name,
     title: contract.title || name,
     kind: contract.kind,
-    description: fn.description || "",
-    schema: fn.parameters || { type: "object", properties: {} },
+    description: fn.description || contract.description || "",
+    schema: fn.parameters ||
+      (contract.inputSchema
+        ? cloneValue(contract.inputSchema)
+        : {
+            type: "object",
+            properties: {},
+          }),
     permissions: cloneValue(contract.permissions),
     telemetry: cloneValue(contract.telemetry),
     source: options.source || "agent-core",
@@ -286,9 +90,25 @@ export function createCodingAgentToolRegistry(definitions = [], options = {}) {
 }
 
 export function getCodingAgentRuntimeDescriptor(toolName) {
-  const descriptorName = TOOL_CONTRACT_MAP.get(toolName)?.runtimeDescriptor;
+  const descriptorName = getCodingAgentToolContract(toolName)?.runtimeDescriptor;
   if (!descriptorName) {
     return null;
   }
   return runtimeRegistry.get(descriptorName) || null;
 }
+
+export function getCodingAgentRuntimeDescriptorByCommand(command) {
+  const trimmed = String(command || "").trim();
+  if (!trimmed) {
+    return null;
+  }
+
+  const parts = trimmed.split(/\s+/);
+  if (parts[0] === "git") {
+    return runtimeRegistry.get("git") || null;
+  }
+  if (parts[0] === "mcp" || parts.includes("mcp")) {
+    return runtimeRegistry.get("mcp") || null;
+  }
+  return runtimeRegistry.get("shell") || null;
+}

package/src/runtime/coding-agent-events.cjs

@@ -108,6 +108,20 @@ const CODING_AGENT_EVENT_TYPES = Object.freeze({
   PATCH_APPLIED: "patch.applied",
   PATCH_REJECTED: "patch.rejected",
   PATCH_SUMMARY: "patch.summary",
+
+  // Persistent task graph + orchestrator — a session-scoped DAG of tasks
+  // with dependencies. The runtime serializes the graph to session metadata
+  // so it survives CLI restarts; the orchestrator advances the graph by
+  // marking ready nodes as `running` when their dependencies complete.
+  TASK_GRAPH_CREATED: "task-graph.created",
+  TASK_GRAPH_UPDATED: "task-graph.updated",
+  TASK_GRAPH_NODE_ADDED: "task-graph.node.added",
+  TASK_GRAPH_NODE_UPDATED: "task-graph.node.updated",
+  TASK_GRAPH_NODE_COMPLETED: "task-graph.node.completed",
+  TASK_GRAPH_NODE_FAILED: "task-graph.node.failed",
+  TASK_GRAPH_ADVANCED: "task-graph.advanced",
+  TASK_GRAPH_COMPLETED: "task-graph.completed",
+  TASK_GRAPH_STATE: "task-graph.state",
 });
 
 const VALID_TYPE_SET = new Set(Object.values(CODING_AGENT_EVENT_TYPES));

package/src/runtime/coding-agent-policy.cjs

@@ -74,6 +74,16 @@ const TOOL_POLICY_METADATA = Object.freeze({
     approvalFlow: "plan",
     isReadOnly: false,
   },
+  edit_file_hashed: {
+    riskLevel: RISK_LEVELS.MEDIUM,
+    category: TOOL_CATEGORIES.WRITE,
+    availableInPlanMode: false,
+    planModeBehavior: "blocked",
+    requiresPlanApproval: true,
+    requiresConfirmation: false,
+    approvalFlow: "plan",
+    isReadOnly: false,
+  },
   write_file: {
     riskLevel: RISK_LEVELS.MEDIUM,
     category: TOOL_CATEGORIES.WRITE,
@@ -193,14 +203,53 @@ function resolveToolPolicy(toolName, descriptor = null) {
     base.riskLevel = normalizeRiskLevel(descriptor.riskLevel, base.riskLevel);
   }
 
+  if (descriptor?.category) {
+    base.category = descriptor.category;
+  }
+
+  if (typeof descriptor?.availableInPlanMode === "boolean") {
+    base.availableInPlanMode = descriptor.availableInPlanMode;
+  }
+
+  if (descriptor?.planModeBehavior) {
+    base.planModeBehavior = descriptor.planModeBehavior;
+  }
+
+  if (typeof descriptor?.requiresPlanApproval === "boolean") {
+    base.requiresPlanApproval = descriptor.requiresPlanApproval;
+  }
+
+  if (typeof descriptor?.requiresConfirmation === "boolean") {
+    base.requiresConfirmation = descriptor.requiresConfirmation;
+  }
+
+  if (descriptor?.approvalFlow) {
+    base.approvalFlow = descriptor.approvalFlow;
+  }
+
+  if (Array.isArray(descriptor?.readOnlySubcommands)) {
+    base.readOnlySubcommands = [...descriptor.readOnlySubcommands];
+  }
+
   if (descriptor?.isReadOnly === true) {
     base.isReadOnly = true;
     base.riskLevel = RISK_LEVELS.LOW;
-    base.availableInPlanMode = true;
-    base.planModeBehavior = "allow";
-    base.requiresPlanApproval = false;
-    base.requiresConfirmation = false;
-    base.approvalFlow = "auto";
+    base.category = descriptor?.category || TOOL_CATEGORIES.READ;
+    if (typeof descriptor?.availableInPlanMode !== "boolean") {
+      base.availableInPlanMode = true;
+    }
+    if (!descriptor?.planModeBehavior) {
+      base.planModeBehavior = "allow";
+    }
+    if (typeof descriptor?.requiresPlanApproval !== "boolean") {
+      base.requiresPlanApproval = false;
+    }
+    if (typeof descriptor?.requiresConfirmation !== "boolean") {
+      base.requiresConfirmation = false;
+    }
+    if (!descriptor?.approvalFlow) {
+      base.approvalFlow = "auto";
+    }
   }
 
   return base;