a2acalling 0.6.72 → 0.6.73

package/.a2a-manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.6.72",
-  "installed_at": "2026-02-27T03:05:52.375Z",
+  "version": "0.6.73",
+  "installed_at": "2026-02-27T06:20:51.170Z",
   "files": [
     {
       "path": "CLAUDE.md",

package/ARCHITECTURE.md

@@ -55,6 +55,16 @@ A2A Calling enables agent-to-agent communication across OpenClaw instances. Agen
 - **Config**: JSON at `~/.config/openclaw/a2a-config.json`
 - **Disclosure**: JSON at `~/.config/openclaw/a2a-disclosure.json`
 
+## Database Lifecycle Management (A2A-55)
+
+All three data stores have automatic retention cleanup that runs on server startup:
+
+- **Conversations**: `ConversationStore.pruneOld()` compresses messages 7+ days old, deletes concluded/timeout conversations 90+ days old. Active conversations are never deleted.
+- **Logs**: `LogStore.pruneOld()` deletes entries 30+ days old. Auto-prune triggers on every 1000th write (best effort). `pruneAllLoggerStores()` iterates all cached stores.
+- **Tokens**: `TokenStore.cleanupExpired()` removes tokens expired >1 hour (grace for in-flight calls) and revoked tokens >30 days old.
+
+All retention periods are configurable via `a2a-config.json` `retention` section. SQLite VACUUM runs only after >100 rows deleted. All cleanup is best-effort — failures are logged but never prevent server startup.
+
 ## Permission System
 
 Three tiers with escalating capabilities:

package/CONVENTIONS.md

@@ -113,6 +113,19 @@ Tokens have a tier (`public`, `friends`, `family`) and a disclosure level (`publ
 - Admin token comparison uses `timingSafeTokenEqual()` from `src/routes/a2a.js` — do NOT use `!==` for secret comparison
 - Query parameter parsing follows the dashboard.js pattern: `Math.min(max, Math.max(min, Number.parseInt(String(value), 10) || defaultValue))`
 
+## Retention & Cleanup (A2A-55)
+
+All data stores implement retention cleanup following the `dashboard-events.js` auto-prune pattern:
+
+- **Cleanup component**: Use `createLogger({ component: 'a2a.cleanup' })` for all retention logging
+- **Best effort**: Prune failures are caught and logged as warnings — never crash the server
+- **VACUUM threshold**: Only run SQLite VACUUM after >100 rows deleted (costly I/O)
+- **Auto-prune**: Logger store prunes on every 1000th `write()` call (counter-based, like dashboard-events.js)
+- **Recursion safety**: Logger `pruneOld()` uses `_pruning` flag to prevent auto-prune during explicit prune
+- **Server startup**: `src/server.js` calls all three retention mechanisms after `writePidFile()`, before `updateManager.start()`
+- **Config defaults**: `A2AConfig.getRetention()` merges partial config with defaults — never writes defaults to disk
+- **Token grace period**: Expired tokens are kept for 1 hour after expiry (in-flight call protection)
+
 ## Anti-Patterns
 
 - Do NOT use `console.log` — use the structured logger

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "a2acalling",
-  "version": "0.6.72",
+  "version": "0.6.73",
   "description": "Agent-to-agent calling for OpenClaw - A2A agent communication",
   "main": "src/index.js",
   "bin": {

package/src/lib/runtime-adapter.js

@@ -5,8 +5,10 @@
  * - openclaw: uses `openclaw` CLI for turn handling, summaries, notifications
  * - claude: uses `claude` CLI as a real LLM subagent for conversations
  *
+ * - test: minimal runtime for CI/headless — echoes messages or spawns A2A_AGENT_COMMAND
+ *
  * Selection:
- * - A2A_RUNTIME=openclaw|claude|auto (default: auto)
+ * - A2A_RUNTIME=openclaw|claude|test|auto (default: auto)
  * - auto picks openclaw → claude → error (no supported CLI)
  */
 
@@ -43,6 +45,18 @@ function resolveRuntimeMode() {
   const hasOpenClaw = commandExists('openclaw');
   const hasClaude = commandExists('claude');
 
+  // A2A-66: test runtime for CI/headless environments — minimal runTurn with
+  // optional A2A_AGENT_COMMAND bridge support.
+  if (requested === 'test') {
+    return {
+      mode: 'test',
+      requested,
+      hasOpenClaw,
+      hasClaude,
+      reason: 'A2A_RUNTIME=test'
+    };
+  }
+
   if (requested === 'generic') {
     return {
       mode: 'none',
@@ -372,6 +386,39 @@ function createRuntimeAdapter(options = {}) {
       }
     }
 
+    // A2A-66: test runtime — spawn A2A_AGENT_COMMAND if set, otherwise echo.
+    // Uses shell: true so the command string is parsed by the shell (supports
+    // quoted args, paths with spaces, pipes, etc.).
+    if (modeInfo.mode === 'test') {
+      const agentCommand = process.env.A2A_AGENT_COMMAND;
+      if (agentCommand) {
+        const payload = JSON.stringify({ message, caller, context });
+        const result = spawnSync(agentCommand, {
+          input: payload,
+          encoding: 'utf8',
+          shell: true,
+          timeout: (timeoutMs || 65000) + 5000,
+          maxBuffer: 1024 * 1024,
+          cwd: workspaceDir,
+          env: process.env
+        });
+        if (result.error) {
+          throw result.error;
+        }
+        // A2A-66: check exit code — non-zero means the bridge command failed.
+        if (result.status !== 0) {
+          const stderr = String(result.stderr || '').trim();
+          throw new Error(
+            `A2A_AGENT_COMMAND exited with code ${result.status}` +
+            (stderr ? `: ${stderr.slice(0, 200)}` : '')
+          );
+        }
+        return String(result.stdout || '').trim() || '[test-runtime] Empty command output';
+      }
+      const snippet = cleanText(message || prompt || '', 120);
+      return `[test-runtime] Echo: ${snippet}`;
+    }
+
     if (modeInfo.mode !== 'openclaw') {
       throw new Error(
         `No supported A2A runtime available (mode=${modeInfo.mode}). ` +
@@ -457,6 +504,12 @@ function createRuntimeAdapter(options = {}) {
       throw new Error('Claude summary returned empty result');
     }
 
+    // A2A-66: test runtime — return canned summary.
+    if (modeInfo.mode === 'test') {
+      const text = 'Test conversation concluded.';
+      return { summary: text, ownerSummary: text };
+    }
+
     if (modeInfo.mode !== 'openclaw') {
       throw new Error(
         `No supported A2A runtime available for summarization (mode=${modeInfo.mode}). ` +
@@ -526,14 +579,15 @@ function createRuntimeAdapter(options = {}) {
       data: { level }
     });
 
-    if (modeInfo.mode === 'claude') {
-      // Claude mode: notifications are a no-op (no notification transport available)
-      logger.debug('Notification skipped (claude mode has no notification transport)', {
-        event: 'notify_skipped_claude',
+    if (modeInfo.mode === 'claude' || modeInfo.mode === 'test') {
+      // Claude/test mode: notifications are a no-op (no notification transport available)
+      logger.debug('Notification skipped (no notification transport in this mode)', {
+        event: 'notify_skipped',
         traceId,
         requestId,
         conversationId,
-        tokenId: token?.id
+        tokenId: token?.id,
+        data: { mode: modeInfo.mode }
       });
       return;
     }