amp-acp 0.3.0 → 0.3.7

package/AGENTS.md

@@ -0,0 +1,22 @@
+# AGENTS.md
+
+## Commands
+- `npm start` or `node src/index.js` — Run the ACP adapter
+- `npm run lint` — Lint (currently a no-op)
+- `npm test` — Test (currently a no-op)
+
+## Architecture
+This is an ACP (Agent Client Protocol) adapter that bridges Amp Code to ACP-compatible clients like Zed.
+
+- `src/index.js` — Entry point, redirects console to stderr (stdout reserved for ACP stream)
+- `src/run-acp.js` — Sets up ACP connection using stdin/stdout JSON streams
+- `src/server.js` — `AmpAcpAgent` class: handles sessions, prompts, MCP config, and calls `@sourcegraph/amp-sdk`
+- `src/to-acp.js` — Converts Amp stream events to ACP `sessionUpdate` notifications
+- `src/utils.js` — Node-to-Web stream converters
+
+## Code Style
+- ES modules (`"type": "module"` in package.json), use `.js` extension in imports
+- No TypeScript; plain JavaScript with JSDoc if needed
+- Use `console.error` for logging (stdout is for ACP protocol only)
+- Error handling: throw `RequestError` from `@agentclientprotocol/sdk` for protocol errors
+- Naming: camelCase for variables/functions, PascalCase for classes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amp-acp",
-  "version": "0.3.0",
+  "version": "0.3.7",
   "private": false,
   "type": "module",
   "bin": {
@@ -8,6 +8,10 @@
   },
   "description": "ACP adapter that bridges Amp Code to Agent Client Protocol (Zed external agent)",
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tao12345666333/amp-acp"
+  },
   "scripts": {
     "start": "node src/index.js",
     "lint": "echo 'no lint'",
@@ -18,4 +22,4 @@
     "@sourcegraph/amp": "^0.0.1765685598-g5365e6",
     "@sourcegraph/amp-sdk": "^0.1.0-20251214200908-g3251f72"
   }
-}
+}

package/src/server.js

@@ -50,7 +50,7 @@ export class AmpAcpAgent {
       mcpConfig,
     });
 
-    return {
+    const result = {
       sessionId,
       modes: {
         currentModeId: 'default',
@@ -60,6 +60,27 @@ export class AmpAcpAgent {
         ],
       },
     };
+
+    setImmediate(async () => {
+      try {
+        await this.client.sessionUpdate({
+          sessionId,
+          update: {
+            sessionUpdate: 'available_commands_update',
+            availableCommands: [
+              {
+                name: 'init',
+                description: 'Generate an AGENTS.md file for the project',
+              },
+            ],
+          },
+        });
+      } catch (e) {
+        console.error('[acp] failed to send available_commands_update', e);
+      }
+    });
+
+    return result;
   }
 
   async authenticate(_params) {
@@ -77,7 +98,18 @@ export class AmpAcpAgent {
     for (const chunk of params.prompt) {
       switch (chunk.type) {
         case 'text':
-          textInput += chunk.text;
+          if (chunk.text.trim() === '/init') {
+            textInput += `Please analyze this codebase and create an AGENTS.md file containing:
+1. Build/lint/test commands - especially for running a single test
+2. Architecture and codebase structure information, including important subprojects, internal APIs, databases, etc.
+3. Code style guidelines, including imports, conventions, formatting, types, naming conventions, error handling, etc.
+
+The file you create will be given to agentic coding tools (such as yourself) that operate in this repository. Make it about 20 lines long.
+
+If there are Cursor rules (in .cursor/rules/ or .cursorrules), Claude rules (CLAUDE.md), Windsurf rules (.windsurfrules), Cline rules (.clinerules), Goose rules (.goosehints), or Copilot rules (in .github/copilot-instructions.md), make sure to include them. Also, first check if there is an existing AGENTS.md or AGENT.md file, and if so, update it instead of overwriting it.`;
+          } else {
+            textInput += chunk.text;
+          }
           break;
         case 'resource_link':
           textInput += `\n${chunk.uri}\n`;