refactor(agent): name delivery methods by intent

scripts/gen-cordis-api.ts

@@ -30,49 +30,8 @@ function quote(value: string): string {
 }
 
 /**
- * Reduce an exported class to its type shape: drop method/constructor bodies
- * and property initializers so the catalog serves member signatures, not
- * implementation. An abstract class (e.g. `Agent`) is a public type consumers
- * program against, so it belongs in the type closure alongside interfaces.
- */
-function classShape(node: ts.ClassDeclaration): ts.ClassDeclaration {
-  const isNonPublic = (member: ts.ClassElement): boolean =>
-    (ts.canHaveModifiers(member) ? ts.getModifiers(member) : undefined)?.some(m =>
-      m.kind === ts.SyntaxKind.PrivateKeyword || m.kind === ts.SyntaxKind.ProtectedKeyword) ?? false
-  const members = node.members.flatMap((member): ts.ClassElement[] => {
-    // A model-facing type shape carries only the public surface — drop private,
-    // protected, and #private members, and strip every kept member's body.
-    if (isNonPublic(member) || (ts.isPropertyDeclaration(member) && ts.isPrivateIdentifier(member.name))) return []
-    if (ts.isMethodDeclaration(member)) {
-      return [ts.factory.updateMethodDeclaration(
-        member, member.modifiers, member.asteriskToken, member.name, member.questionToken,
-        member.typeParameters, member.parameters, member.type, undefined)]
-    }
-    if (ts.isConstructorDeclaration(member)) {
-      return [ts.factory.updateConstructorDeclaration(member, member.modifiers, member.parameters, undefined)]
-    }
-    if (ts.isGetAccessorDeclaration(member)) {
-      return [ts.factory.updateGetAccessorDeclaration(
-        member, member.modifiers, member.name, member.parameters, member.type, undefined)]
-    }
-    if (ts.isSetAccessorDeclaration(member)) {
-      return [ts.factory.updateSetAccessorDeclaration(
-        member, member.modifiers, member.name, member.parameters, undefined)]
-    }
-    if (ts.isPropertyDeclaration(member)) {
-      return [ts.factory.updatePropertyDeclaration(
-        member, member.modifiers, member.name, member.questionToken ?? member.exclamationToken, member.type, undefined)]
-    }
-    return [member]
-  })
-  return ts.factory.updateClassDeclaration(
-    node, node.modifiers, node.name, node.typeParameters, node.heritageClauses, members)
-}
-
-/**
- * Collect exported interface, type-alias, and (body-stripped) class shapes;
- * omit names declared in multiple packages rather than risk serving the wrong
- * package's shape.
+ * Collect exported interface and type shapes; omit names declared in multiple
+ * packages rather than risk serving the wrong package's shape.
  */
 function collectTypeDecls(scanRoot: string = root): Map<string, string> {
   const printer = ts.createPrinter({ removeComments: true })
@@ -82,16 +41,14 @@ function collectTypeDecls(scanRoot: string = root): Map<string, string> {
     const abs = resolve(scanRoot, rel)
     const sf = ts.createSourceFile(abs, readFileSync(abs, 'utf8'), ts.ScriptTarget.Latest, true)
     for (const stmt of sf.statements) {
-      const named = ts.isInterfaceDeclaration(stmt) || ts.isTypeAliasDeclaration(stmt) || ts.isClassDeclaration(stmt)
-      if (!named || stmt.name === undefined) continue
+      if (!ts.isInterfaceDeclaration(stmt) && !ts.isTypeAliasDeclaration(stmt)) continue
       if (!(stmt.modifiers?.some(m => m.kind === ts.SyntaxKind.ExportKeyword) ?? false)) continue
       const name = stmt.name.text
       if (decls.has(name)) {
         ambiguous.add(name)
         continue
       }
-      const emit = ts.isClassDeclaration(stmt) ? classShape(stmt) : stmt
-      const printed = printer.printNode(ts.EmitHint.Unspecified, emit, sf).replace(/\r/g, '')
+      const printed = printer.printNode(ts.EmitHint.Unspecified, stmt, sf).replace(/\r/g, '')
       decls.set(name, printed.length > MAX_DECL_CHARS
         ? `${printed.slice(0, MAX_DECL_CHARS)} /* …truncated — full shape in source */`
         : printed)

scripts/type-equiv.manifest.json

@@ -66,11 +66,6 @@
       "symbol": "SessionEvent",
       "source": "packages/core/session/src/types.ts"
     },
-    {
-      "doc": "docs/core-data-structures/core.md",
-      "symbol": "SendTarget",
-      "source": "packages/core/agent/src/types.ts"
-    },
     {
       "doc": "docs/core-data-structures/core.md",
       "symbol": "SendOptions",
@@ -78,7 +73,7 @@
     },
     {
       "doc": "docs/core-data-structures/core.md",
-      "symbol": "AliasSendOptions",
+      "symbol": "InjectOptions",
       "source": "packages/core/agent/src/types.ts"
     },
     {