agent-relay 2.0.28 → 2.0.32

package/packages/spawner/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: false,
+    environment: 'node',
+    include: ['src/**/*.test.ts'],
+  },
+});

package/packages/state/dist/agent-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.d.ts","sourceRoot":"","sources":["../src/agent-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAgC;IAIrD,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAe1C;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAW7B;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU;IAqBnE;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CA8C3C;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAY/E"}

package/packages/state/dist/agent-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-state.js","sourceRoot":"","sources":["../src/agent-state.ts"],"names":[],"mappings":"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"}

package/packages/state/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAC"}

package/packages/state/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GAErB,MAAM,kBAAkB,CAAC"}

package/packages/state/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/state",
-  "version": "2.0.28",
+  "version": "2.0.32",
   "description": "Agent state persistence for non-hook CLIs (Codex, Gemini, etc.)",
   "type": "module",
   "main": "dist/index.js",

package/packages/state/src/agent-state.test.ts

@@ -0,0 +1,335 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { describe, expect, it, afterEach, beforeEach } from 'vitest';
+import {
+  AgentStateManager,
+  parseStateFromOutput,
+  type AgentState,
+} from './agent-state.js';
+
+function makeTempDir(): string {
+  const base = path.join(process.cwd(), '.tmp-state-tests');
+  fs.mkdirSync(base, { recursive: true });
+  const dir = fs.mkdtempSync(path.join(base, 'state-'));
+  return dir;
+}
+
+function cleanup(dir: string): void {
+  if (fs.existsSync(dir)) {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+describe('AgentStateManager', () => {
+  let tempDir: string;
+  let manager: AgentStateManager;
+
+  beforeEach(() => {
+    tempDir = makeTempDir();
+    manager = new AgentStateManager(tempDir);
+  });
+
+  afterEach(() => {
+    if (tempDir) {
+      cleanup(tempDir);
+    }
+  });
+
+  describe('load', () => {
+    it('returns null when state file does not exist', () => {
+      const result = manager.load('NonexistentAgent');
+      expect(result).toBeNull();
+    });
+
+    it('returns null for invalid JSON', () => {
+      const agentDir = path.join(tempDir, 'BadAgent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(path.join(agentDir, 'state.json'), 'not json');
+      expect(manager.load('BadAgent')).toBeNull();
+    });
+
+    it('loads state from file', () => {
+      const state: AgentState = {
+        name: 'TestAgent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: 'Testing',
+        completedTasks: ['task1'],
+        decisions: ['decision1'],
+        context: 'Some context',
+        files: ['file1.ts'],
+      };
+      const agentDir = path.join(tempDir, 'TestAgent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(
+        path.join(agentDir, 'state.json'),
+        JSON.stringify(state)
+      );
+
+      const result = manager.load('TestAgent');
+      expect(result).toEqual(state);
+    });
+  });
+
+  describe('save', () => {
+    it('creates directory if it does not exist', () => {
+      const state: AgentState = {
+        name: 'NewAgent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: '',
+        completedTasks: [],
+        decisions: [],
+        context: '',
+        files: [],
+      };
+
+      manager.save(state);
+
+      const agentDir = path.join(tempDir, 'NewAgent');
+      expect(fs.existsSync(agentDir)).toBe(true);
+      expect(fs.existsSync(path.join(agentDir, 'state.json'))).toBe(true);
+    });
+
+    it('saves state as formatted JSON', () => {
+      const state: AgentState = {
+        name: 'TestAgent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: 'Working',
+        completedTasks: ['done'],
+        decisions: ['chose X'],
+        context: 'ctx',
+        files: ['f.ts'],
+      };
+
+      manager.save(state);
+
+      const content = fs.readFileSync(
+        path.join(tempDir, 'TestAgent', 'state.json'),
+        'utf-8'
+      );
+      const parsed = JSON.parse(content);
+      expect(parsed).toEqual(state);
+      // Check it's formatted (has indentation)
+      expect(content).toContain('\n');
+    });
+  });
+
+  describe('update', () => {
+    it('creates new state if none exists', () => {
+      const result = manager.update('NewAgent', { currentTask: 'New task' });
+
+      expect(result.name).toBe('NewAgent');
+      expect(result.currentTask).toBe('New task');
+      expect(result.completedTasks).toEqual([]);
+      expect(result.lastActive).toBeDefined();
+    });
+
+    it('merges updates with existing state', () => {
+      const existing: AgentState = {
+        name: 'Agent',
+        lastActive: '2025-01-01T00:00:00Z',
+        currentTask: 'Old task',
+        completedTasks: ['task1'],
+        decisions: ['d1'],
+        context: 'old ctx',
+        files: ['old.ts'],
+      };
+      const agentDir = path.join(tempDir, 'Agent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(
+        path.join(agentDir, 'state.json'),
+        JSON.stringify(existing)
+      );
+
+      const result = manager.update('Agent', {
+        currentTask: 'New task',
+        files: ['new.ts'],
+      });
+
+      expect(result.currentTask).toBe('New task');
+      expect(result.files).toEqual(['new.ts']);
+      expect(result.completedTasks).toEqual(['task1']); // Preserved
+      expect(result.decisions).toEqual(['d1']); // Preserved
+      expect(result.lastActive).not.toBe('2025-01-01T00:00:00Z'); // Updated
+    });
+
+    it('always updates lastActive timestamp', () => {
+      const before = new Date().toISOString();
+      const result = manager.update('Agent', {});
+      const after = new Date().toISOString();
+
+      expect(result.lastActive >= before).toBe(true);
+      expect(result.lastActive <= after).toBe(true);
+    });
+  });
+
+  describe('formatAsContext', () => {
+    it('returns default message when no state exists', () => {
+      const result = manager.formatAsContext('NoAgent');
+      expect(result).toBe('No previous session state found. Starting fresh.');
+    });
+
+    it('formats basic state info', () => {
+      const state: AgentState = {
+        name: 'Agent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: '',
+        completedTasks: [],
+        decisions: [],
+        context: '',
+        files: [],
+      };
+      const agentDir = path.join(tempDir, 'Agent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(path.join(agentDir, 'state.json'), JSON.stringify(state));
+
+      const result = manager.formatAsContext('Agent');
+
+      expect(result).toContain('=== PREVIOUS SESSION CONTEXT ===');
+      expect(result).toContain('Last active: 2025-01-01T10:00:00Z');
+      expect(result).toContain('=== END CONTEXT ===');
+    });
+
+    it('includes current task when present', () => {
+      const state: AgentState = {
+        name: 'Agent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: 'Working on feature X',
+        completedTasks: [],
+        decisions: [],
+        context: '',
+        files: [],
+      };
+      const agentDir = path.join(tempDir, 'Agent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(path.join(agentDir, 'state.json'), JSON.stringify(state));
+
+      const result = manager.formatAsContext('Agent');
+
+      expect(result).toContain('Current task: Working on feature X');
+    });
+
+    it('includes completed tasks when present', () => {
+      const state: AgentState = {
+        name: 'Agent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: '',
+        completedTasks: ['Setup project', 'Write tests'],
+        decisions: [],
+        context: '',
+        files: [],
+      };
+      const agentDir = path.join(tempDir, 'Agent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(path.join(agentDir, 'state.json'), JSON.stringify(state));
+
+      const result = manager.formatAsContext('Agent');
+
+      expect(result).toContain('Completed tasks:');
+      expect(result).toContain('  - Setup project');
+      expect(result).toContain('  - Write tests');
+    });
+
+    it('includes decisions when present', () => {
+      const state: AgentState = {
+        name: 'Agent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: '',
+        completedTasks: [],
+        decisions: ['Use TypeScript', 'Chose vitest'],
+        context: '',
+        files: [],
+      };
+      const agentDir = path.join(tempDir, 'Agent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(path.join(agentDir, 'state.json'), JSON.stringify(state));
+
+      const result = manager.formatAsContext('Agent');
+
+      expect(result).toContain('Key decisions made:');
+      expect(result).toContain('  - Use TypeScript');
+      expect(result).toContain('  - Chose vitest');
+    });
+
+    it('includes context when present', () => {
+      const state: AgentState = {
+        name: 'Agent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: '',
+        completedTasks: [],
+        decisions: [],
+        context: 'Working on auth module refactor',
+        files: [],
+      };
+      const agentDir = path.join(tempDir, 'Agent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(path.join(agentDir, 'state.json'), JSON.stringify(state));
+
+      const result = manager.formatAsContext('Agent');
+
+      expect(result).toContain('Context:');
+      expect(result).toContain('Working on auth module refactor');
+    });
+
+    it('includes files when present', () => {
+      const state: AgentState = {
+        name: 'Agent',
+        lastActive: '2025-01-01T10:00:00Z',
+        currentTask: '',
+        completedTasks: [],
+        decisions: [],
+        context: '',
+        files: ['src/auth.ts', 'src/utils.ts'],
+      };
+      const agentDir = path.join(tempDir, 'Agent');
+      fs.mkdirSync(agentDir, { recursive: true });
+      fs.writeFileSync(path.join(agentDir, 'state.json'), JSON.stringify(state));
+
+      const result = manager.formatAsContext('Agent');
+
+      expect(result).toContain('Files being worked on:');
+      expect(result).toContain('  - src/auth.ts');
+      expect(result).toContain('  - src/utils.ts');
+    });
+  });
+});
+
+describe('parseStateFromOutput', () => {
+  it('returns null when no state block found', () => {
+    const output = 'Just some regular output without state';
+    expect(parseStateFromOutput(output)).toBeNull();
+  });
+
+  it('parses state from output with state block', () => {
+    const output = `
+Some output before
+[[STATE]]{"currentTask": "Testing", "context": "Working on tests"}[[/STATE]]
+Some output after
+`;
+    const result = parseStateFromOutput(output);
+    expect(result).toEqual({
+      currentTask: 'Testing',
+      context: 'Working on tests',
+    });
+  });
+
+  it('returns null for invalid JSON in state block', () => {
+    const output = '[[STATE]]not valid json[[/STATE]]';
+    expect(parseStateFromOutput(output)).toBeNull();
+  });
+
+  it('handles multiline state blocks', () => {
+    const output = `
+[[STATE]]
+{
+  "currentTask": "Multi",
+  "completedTasks": ["one", "two"]
+}
+[[/STATE]]
+`;
+    const result = parseStateFromOutput(output);
+    expect(result).toEqual({
+      currentTask: 'Multi',
+      completedTasks: ['one', 'two'],
+    });
+  });
+});

package/packages/state/src/agent-state.ts

@@ -0,0 +1,153 @@
+/**
+ * Agent State Manager
+ * Persists agent context between spawns for non-hook CLIs (Codex, Gemini, etc.)
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+
+export interface AgentState {
+  name: string;
+  lastActive: string;
+  currentTask: string;
+  completedTasks: string[];
+  decisions: string[];  // Key decisions made
+  context: string;      // Summary of recent work
+  files: string[];      // Files being worked on
+}
+
+export class AgentStateManager {
+  private dataDir: string;
+
+  constructor(dataDir: string = '/tmp/agent-relay-team') {
+    this.dataDir = dataDir;
+  }
+
+  private getStatePath(agentName: string): string {
+    return path.join(this.dataDir, agentName, 'state.json');
+  }
+
+  /**
+   * Load agent state from file
+   */
+  load(agentName: string): AgentState | null {
+    const statePath = this.getStatePath(agentName);
+
+    if (!fs.existsSync(statePath)) {
+      return null;
+    }
+
+    try {
+      const content = fs.readFileSync(statePath, 'utf-8');
+      return JSON.parse(content) as AgentState;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Save agent state to file
+   */
+  save(state: AgentState): void {
+    const statePath = this.getStatePath(state.name);
+    const dir = path.dirname(statePath);
+
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2));
+  }
+
+  /**
+   * Update specific fields in state
+   */
+  update(agentName: string, updates: Partial<AgentState>): AgentState {
+    const existing = this.load(agentName) || {
+      name: agentName,
+      lastActive: new Date().toISOString(),
+      currentTask: '',
+      completedTasks: [],
+      decisions: [],
+      context: '',
+      files: [],
+    };
+
+    const updated: AgentState = {
+      ...existing,
+      ...updates,
+      lastActive: new Date().toISOString(),
+    };
+
+    this.save(updated);
+    return updated;
+  }
+
+  /**
+   * Format state as context for agent prompt
+   */
+  formatAsContext(agentName: string): string {
+    const state = this.load(agentName);
+
+    if (!state) {
+      return 'No previous session state found. Starting fresh.';
+    }
+
+    const lines = [
+      '=== PREVIOUS SESSION CONTEXT ===',
+      `Last active: ${state.lastActive}`,
+      '',
+    ];
+
+    if (state.currentTask) {
+      lines.push(`Current task: ${state.currentTask}`);
+    }
+
+    if (state.completedTasks.length > 0) {
+      lines.push('');
+      lines.push('Completed tasks:');
+      state.completedTasks.forEach(t => lines.push(`  - ${t}`));
+    }
+
+    if (state.decisions.length > 0) {
+      lines.push('');
+      lines.push('Key decisions made:');
+      state.decisions.forEach(d => lines.push(`  - ${d}`));
+    }
+
+    if (state.context) {
+      lines.push('');
+      lines.push('Context:');
+      lines.push(state.context);
+    }
+
+    if (state.files.length > 0) {
+      lines.push('');
+      lines.push('Files being worked on:');
+      state.files.forEach(f => lines.push(`  - ${f}`));
+    }
+
+    lines.push('=== END CONTEXT ===');
+    lines.push('');
+
+    return lines.join('\n');
+  }
+}
+
+/**
+ * CLI helper to save state from agent output
+ * Agent outputs: [[STATE]]{"currentTask": "...", "context": "..."}[[/STATE]]
+ */
+export function parseStateFromOutput(output: string): Partial<AgentState> | null {
+  const match = output.match(/\[\[STATE\]\]([\s\S]*?)\[\[\/STATE\]\]/);
+
+  if (!match) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(match[1]) as Partial<AgentState>;
+  } catch {
+    return null;
+  }
+}

package/packages/state/src/index.ts

@@ -0,0 +1,12 @@
+/**
+ * @relay/state
+ *
+ * Agent state persistence for non-hook CLIs (Codex, Gemini, etc.)
+ * Provides state management between agent spawns.
+ */
+
+export {
+  AgentStateManager,
+  parseStateFromOutput,
+  type AgentState,
+} from './agent-state.js';

package/packages/state/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}

package/packages/state/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    include: ['src/**/*.test.ts'],
+  },
+});

package/packages/storage/dist/adapter.d.ts

@@ -1,5 +1,19 @@
 import type { PayloadKind, SendMeta } from '@agent-relay/protocol/types';
 export type MessageStatus = 'unread' | 'read' | 'acked' | 'failed';
+/**
+ * Lightweight storage health report for the daemon/CLI.
+ * - persistent: true when data is durable across restarts
+ * - driver: backing implementation identifier
+ * - canRead/canWrite: simple capability probes
+ * - error: optional guidance or last failure reason
+ */
+export interface StorageHealth {
+    persistent: boolean;
+    driver: 'sqlite' | 'jsonl' | 'memory';
+    canWrite: boolean;
+    canRead: boolean;
+    error?: string;
+}
 export interface StoredMessage {
     id: string;
     ts: number;
@@ -71,6 +85,7 @@ export interface AgentSummary {
 }
 export interface StorageAdapter {
     init(): Promise<void>;
+    healthCheck(): Promise<StorageHealth>;
     saveMessage(message: StoredMessage): Promise<void>;
     getMessages(query?: MessageQuery): Promise<StoredMessage[]>;
     getMessageById?(id: string): Promise<StoredMessage | null>;
@@ -106,7 +121,7 @@ export interface StorageAdapter {
  * Can be set via CLI options or environment variables.
  */
 export interface StorageConfig {
-    /** Storage type: 'sqlite', 'sqlite-batched', 'none', or 'postgres' (future) */
+    /** Storage type: 'sqlite', 'sqlite-batched', 'jsonl', 'none', or 'postgres' (future) */
     type?: string;
     /** Path for SQLite database */
     path?: string;
@@ -126,7 +141,12 @@ export interface StorageConfig {
  */
 export declare class MemoryStorageAdapter implements StorageAdapter {
     private messages;
+    private fallbackReason?;
+    constructor(options?: {
+        reason?: string;
+    });
     init(): Promise<void>;
+    healthCheck(): Promise<StorageHealth>;
     saveMessage(message: StoredMessage): Promise<void>;
     getMessages(query?: MessageQuery): Promise<StoredMessage[]>;
     getMessageById(id: string): Promise<StoredMessage | null>;
@@ -151,8 +171,15 @@ export declare function getStorageConfigFromEnv(): StorageConfig;
  * 2. Environment variables (AGENT_RELAY_STORAGE_TYPE, AGENT_RELAY_STORAGE_PATH, AGENT_RELAY_STORAGE_URL)
  * 3. Default: SQLite at provided dbPath
  *
+ * Fallback strategy:
+ * - Prefer SQLite (or batched SQLite when requested)
+ * - On SQLite failure, try JSONL append-only storage before dropping to in-memory
+ * - If all durable adapters fail, keep daemon running via memory (non-persistent) with guidance
+ *
  * Supported storage types:
  * - 'sqlite' (default): SQLite file-based storage
+ * - 'sqlite-batched': SQLite with buffered writes
+ * - 'jsonl': Append-only JSONL files (durable fallback)
  * - 'none' or 'memory': In-memory storage (no persistence)
  * - 'postgres': PostgreSQL (requires AGENT_RELAY_STORAGE_URL) - future
  */

package/packages/storage/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}