coding agent intent APIs: Coding Agents That Only Emit Intents

# intents/schema.py
from pydantic import BaseModel, Field
from typing import Literal, Any

class Intent(BaseModel):
    kind: Literal["rename_symbol", "add_import", "wrap_call", "codemod"]
    path: str
    params: dict[str, Any] = Field(default_factory=dict)
    rationale: str

{
  "kind": "rename_symbol",
  "path": "src/billing/invoice.ts",
  "params": {"from": "calcTotal", "to": "calculateInvoiceTotal"},
  "rationale": "Match domain language in ADR-17"
}

// apply/rename.ts
import { Project } from "ts-morph";

export function applyRename(path: string, from: string, to: string) {
  const project = new Project();
  const sf = project.addSourceFileAtPath(path);
  sf.getDescendantsOfKind(/* Identifier */).forEach((id) => {
    if (id.getText() === from) id.replaceWithText(to); // ✅ AST-aware
  });
  sf.saveSync();
}

# apply/dispatch.py
HANDLERS = {
  "rename_symbol": apply_rename,
  "add_import": apply_add_import,
  "codemod": apply_named_codemod,
}

def apply_intent(intent: Intent):
    fn = HANDLERS.get(intent.kind)
    if not fn:
        raise ValueError(f"unknown_intent:{intent.kind}")
    return fn(intent.path, **intent.params)