coding-agent-adapters 0.2.17 → 0.2.18

package/dist/index.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var promises = require('fs/promises');
+var path = require('path');
 var ptyManager = require('pty-manager');
 
 // src/base-coding-adapter.ts
@@ -8,6 +10,17 @@ var BaseCodingAdapter = class extends ptyManager.BaseCLIAdapter {
    * Coding agent CLIs use TUI menus that require arrow-key navigation.
    */
   usesTuiMenus = true;
+  /**
+   * The primary memory file for this CLI (the one it reads for project instructions).
+   * Returns the relativePath of the first 'memory' type file from getWorkspaceFiles().
+   */
+  get memoryFilePath() {
+    const memoryFile = this.getWorkspaceFiles().find((f) => f.type === "memory");
+    if (!memoryFile) {
+      throw new Error(`${this.displayName} adapter has no memory file defined`);
+    }
+    return memoryFile.relativePath;
+  }
   /**
    * Get credentials from config
    */
@@ -101,6 +114,26 @@ Docs: ${this.installation.docsUrl}`
     content = content.trim();
     return content;
   }
+  /**
+   * Write content to this agent's memory file in a workspace.
+   * Creates parent directories as needed.
+   *
+   * @param workspacePath - Absolute path to the workspace root
+   * @param content - The memory/instructions content to write
+   * @param options - Optional: custom fileName, append mode
+   * @returns The absolute path of the written file
+   */
+  async writeMemoryFile(workspacePath, content, options) {
+    const relativePath = options?.fileName ?? this.memoryFilePath;
+    const fullPath = path.join(workspacePath, relativePath);
+    await promises.mkdir(path.dirname(fullPath), { recursive: true });
+    if (options?.append) {
+      await promises.appendFile(fullPath, content, "utf-8");
+    } else {
+      await promises.writeFile(fullPath, content, "utf-8");
+    }
+    return fullPath;
+  }
 };
 
 // src/claude-adapter.ts
@@ -173,6 +206,31 @@ var ClaudeAdapter = class extends BaseCodingAdapter {
       safe: true
     }
   ];
+  getWorkspaceFiles() {
+    return [
+      {
+        relativePath: "CLAUDE.md",
+        description: "Project-level instructions read automatically on startup",
+        autoLoaded: true,
+        type: "memory",
+        format: "markdown"
+      },
+      {
+        relativePath: ".claude/settings.json",
+        description: "Project-scoped settings (allowed tools, permissions)",
+        autoLoaded: true,
+        type: "config",
+        format: "json"
+      },
+      {
+        relativePath: ".claude/commands",
+        description: "Custom slash commands directory",
+        autoLoaded: false,
+        type: "config",
+        format: "markdown"
+      }
+    ];
+  }
   getRecommendedModels(_credentials) {
     return {
       powerful: "claude-sonnet-4-20250514",
@@ -379,6 +437,31 @@ var GeminiAdapter = class extends BaseCodingAdapter {
       once: true
     }
   ];
+  getWorkspaceFiles() {
+    return [
+      {
+        relativePath: "GEMINI.md",
+        description: "Project-level instructions read automatically on startup",
+        autoLoaded: true,
+        type: "memory",
+        format: "markdown"
+      },
+      {
+        relativePath: ".gemini/settings.json",
+        description: "Project-scoped settings (tool permissions, sandbox config)",
+        autoLoaded: true,
+        type: "config",
+        format: "json"
+      },
+      {
+        relativePath: ".gemini/styles",
+        description: "Custom style/persona definitions directory",
+        autoLoaded: false,
+        type: "config",
+        format: "markdown"
+      }
+    ];
+  }
   getRecommendedModels(_credentials) {
     return {
       powerful: "gemini-3-pro",
@@ -659,6 +742,31 @@ var CodexAdapter = class extends BaseCodingAdapter {
       safe: true
     }
   ];
+  getWorkspaceFiles() {
+    return [
+      {
+        relativePath: "AGENTS.md",
+        description: "Project-level instructions read automatically on startup",
+        autoLoaded: true,
+        type: "memory",
+        format: "markdown"
+      },
+      {
+        relativePath: "codex.md",
+        description: "Additional project context file",
+        autoLoaded: true,
+        type: "memory",
+        format: "markdown"
+      },
+      {
+        relativePath: ".codex/config.json",
+        description: "Project-scoped Codex configuration",
+        autoLoaded: true,
+        type: "config",
+        format: "json"
+      }
+    ];
+  }
   getRecommendedModels(_credentials) {
     return {
       powerful: "o3",
@@ -1032,6 +1140,31 @@ var AiderAdapter = class extends BaseCodingAdapter {
       safe: true
     }
   ];
+  getWorkspaceFiles() {
+    return [
+      {
+        relativePath: ".aider.conventions.md",
+        description: "Project conventions and instructions read on startup (--read flag)",
+        autoLoaded: true,
+        type: "memory",
+        format: "markdown"
+      },
+      {
+        relativePath: ".aider.conf.yml",
+        description: "Project-scoped Aider configuration (model, flags, options)",
+        autoLoaded: true,
+        type: "config",
+        format: "yaml"
+      },
+      {
+        relativePath: ".aiderignore",
+        description: "Gitignore-style file listing paths Aider should not edit",
+        autoLoaded: true,
+        type: "rules",
+        format: "text"
+      }
+    ];
+  }
   getRecommendedModels(credentials) {
     if (credentials?.anthropicKey) {
       return {