agent-relay 2.0.29 → 2.0.32

package/packages/wrapper/src/wrapper-types.ts

@@ -0,0 +1,45 @@
+/**
+ * Shared types for PTY wrappers (RelayPtyOrchestrator, PtyWrapper)
+ *
+ * These types are used for event handling across different wrapper implementations.
+ */
+
+import type { ParsedSummary, SessionEndMarker } from './parser.js';
+
+/**
+ * Event emitted when message injection fails after all retries
+ */
+export interface InjectionFailedEvent {
+  messageId: string;
+  from: string;
+  attempts: number;
+}
+
+/**
+ * Event emitted when agent outputs a [[SUMMARY]] block
+ * Cloud services can persist this for session tracking
+ */
+export interface SummaryEvent {
+  agentName: string;
+  summary: ParsedSummary;
+}
+
+/**
+ * Event emitted when agent outputs a [[SESSION_END]] block
+ * Cloud services can handle session closure
+ */
+export interface SessionEndEvent {
+  agentName: string;
+  marker: SessionEndMarker;
+}
+
+/**
+ * Event emitted when auth revocation is detected
+ * Cloud services can handle re-auth flow
+ */
+export interface AuthRevokedEvent {
+  agentName: string;
+  provider: string;
+  message?: string;
+  confidence: 'high' | 'medium' | 'low';
+}

package/packages/wrapper/tsconfig.json

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

package/packages/wrapper/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/scripts/build-cjs.mjs

@@ -0,0 +1,23 @@
+import { build } from 'esbuild';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const entry = join(here, '..', 'dist', 'src', 'index.js');
+const outfile = join(here, '..', 'dist', 'index.cjs');
+
+await build({
+  entryPoints: [entry],
+  outfile,
+  platform: 'node',
+  format: 'cjs',
+  bundle: true,
+  target: 'node18',
+  logLevel: 'info',
+  banner: {
+    js: "const import_meta_url = require('node:url').pathToFileURL(__filename).href;",
+  },
+  define: {
+    'import.meta.url': 'import_meta_url',
+  },
+});

package/scripts/postinstall.js

@@ -10,6 +10,7 @@
  */
 
 import { execSync } from 'node:child_process';
+import { createRequire } from 'node:module';
 import path from 'node:path';
 import fs from 'node:fs';
 import os from 'node:os';
@@ -43,6 +44,109 @@ function warn(msg) {
   console.log(`${colors.yellow}[warn]${colors.reset} ${msg}`);
 }
 
+const nodeRequire = createRequire(import.meta.url);
+
+function formatExecError(err) {
+  if (!err) return 'Unknown error';
+
+  const stderr = err.stderr ? String(err.stderr).trim() : '';
+  const stdout = err.stdout ? String(err.stdout).trim() : '';
+  if (stderr) return stderr.split('\n').slice(-8).join('\n');
+  if (stdout) return stdout.split('\n').slice(-8).join('\n');
+  if (err.message) return err.message;
+  return String(err);
+}
+
+function writeStorageStatus(lines) {
+  const statusDir = path.join(getPackageRoot(), '.agent-relay');
+  const statusPath = path.join(statusDir, 'storage-status.txt');
+
+  try {
+    fs.mkdirSync(statusDir, { recursive: true });
+    fs.writeFileSync(statusPath, `${lines.join('\n')}\n`, 'utf-8');
+    return statusPath;
+  } catch (err) {
+    warn(
+      `Failed to write storage status file: ${
+        err instanceof Error ? err.message : String(err)
+      }`
+    );
+    return null;
+  }
+}
+
+function hasBuiltInNodeSqlite() {
+  try {
+    nodeRequire('node:sqlite');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function rebuildBetterSqlite3() {
+  info('Rebuilding better-sqlite3 (SQLite driver)...');
+  try {
+    execSync('npm rebuild better-sqlite3', {
+      cwd: getPackageRoot(),
+      stdio: 'inherit',
+    });
+    success('better-sqlite3 rebuilt successfully');
+    return { ok: true };
+  } catch (err) {
+    const message = formatExecError(err);
+    warn(`better-sqlite3 rebuild failed: ${message}`);
+    return { ok: false, message };
+  }
+}
+
+function ensureSqliteDriver() {
+  const rebuildResult = rebuildBetterSqlite3();
+  const builtInAvailable = hasBuiltInNodeSqlite();
+  const timestamp = new Date().toISOString();
+  const baseStatus = [
+    `node: ${process.version}`,
+    `platform: ${os.platform()}-${os.arch()}`,
+    `timestamp: ${timestamp}`,
+  ];
+
+  if (rebuildResult.ok) {
+    const statusPath = writeStorageStatus([
+      'status: ok',
+      'driver: better-sqlite3',
+      'detail: better-sqlite3 rebuilt successfully',
+      ...baseStatus,
+    ]);
+    return { ok: true, driver: 'better-sqlite3', statusPath };
+  }
+
+  if (builtInAvailable) {
+    const statusPath = writeStorageStatus([
+      'status: degraded',
+      'driver: node:sqlite',
+      `detail: better-sqlite3 rebuild failed (${rebuildResult.message ?? 'unknown error'}), using built-in node:sqlite`,
+      ...baseStatus,
+    ]);
+    return {
+      ok: true,
+      driver: 'node:sqlite',
+      statusPath,
+      error: rebuildResult.message,
+    };
+  }
+
+  const detail = rebuildResult.message ?? 'unknown error';
+  const statusPath = writeStorageStatus([
+    'status: failed',
+    'driver: none',
+    `detail: better-sqlite3 rebuild failed (${detail}); no built-in node:sqlite available`,
+    'fallback: in-memory storage',
+    ...baseStatus,
+  ]);
+
+  return { ok: false, driver: 'none', statusPath, error: detail };
+}
+
 /**
  * Get the platform-specific binary name for relay-pty
  * Returns null if platform is not supported
@@ -258,6 +362,28 @@ function patchAgentTrajectories() {
   success('Patched agent-trajectories to record agent on trail start');
 }
 
+function logPostinstallDiagnostics(hasRelayPty, sqliteStatus) {
+  if (hasRelayPty) {
+    console.log('✓ relay-pty binary installed');
+  } else {
+    console.log('⚠ relay-pty binary not installed - falling back to tmux mode if available');
+  }
+
+  if (sqliteStatus.ok && sqliteStatus.driver === 'better-sqlite3') {
+    console.log('✓ SQLite ready (better-sqlite3)');
+  } else if (sqliteStatus.ok && sqliteStatus.driver === 'node:sqlite') {
+    console.log('⚠ better-sqlite3 rebuild failed - using built-in node:sqlite');
+    console.log('  To fix: npm rebuild better-sqlite3 or upgrade to Node 22+');
+  } else {
+    console.log('⚠ SQLite installation failed - using fallback storage');
+    console.log('  To fix: npm rebuild better-sqlite3 or upgrade to Node 22+');
+  }
+
+  if (sqliteStatus.statusPath) {
+    info(`SQLite status written to ${sqliteStatus.statusPath}`);
+  }
+}
+
 /**
  * Main postinstall routine
  */
@@ -265,12 +391,18 @@ async function main() {
   // Install relay-pty binary for current platform (primary mode)
   const hasRelayPty = installRelayPtyBinary();
 
+  // Ensure SQLite driver is available (better-sqlite3 or node:sqlite)
+  const sqliteStatus = ensureSqliteDriver();
+
   // Ensure trail CLI captures agent info on start
   patchAgentTrajectories();
 
   // Always install dashboard dependencies (needed for build)
   installDashboardDeps();
 
+  // Always print diagnostics (even in CI)
+  logPostinstallDiagnostics(hasRelayPty, sqliteStatus);
+
   // Skip tmux check in CI environments
   if (process.env.CI === 'true') {
     return;

package/.cursor/mcp.json

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "agent-relay": {
-      "command": "npx",
-      "args": [
-        "@agent-relay/mcp",
-        "serve"
-      ]
-    }
-  }
-}

package/.gitattributes

@@ -1,3 +0,0 @@
-
-# Use bd merge for beads JSONL files
-.beads/issues.jsonl merge=beads

package/.gitleaks.toml

@@ -1,26 +0,0 @@
-# Gitleaks configuration
-# See: https://github.com/gitleaks/gitleaks#configuration
-
-title = "Agent Relay Gitleaks Config"
-
-# Allow specific files/paths
-[allowlist]
-  description = "Allow test files and build artifacts"
-  paths = [
-    # Test files with intentional mock/placeholder secrets
-    '''.*\.test\.ts$''',
-    '''.*\.test\.js$''',
-    '''docker-compose\.test\.yml$''',
-    '''scripts/manual-qa\.sh$''',
-    # Build artifacts (shouldn't be committed but may exist in history)
-    '''\.next/.*''',
-    '''dist/.*''',
-    '''node_modules/.*''',
-  ]
-
-# Allow specific patterns that are known false positives
-[[rules]]
-  id = "allow-redacted-placeholders"
-  description = "Allow REDACTED placeholder values in tests"
-  regex = '''REDACTED'''
-  allowlist = { regexes = ['''REDACTED'''] }

package/.mcp.json

@@ -1,11 +0,0 @@
-{
-  "mcpServers": {
-    "agent-relay": {
-      "command": "npx",
-      "args": [
-        "@agent-relay/mcp",
-        "serve"
-      ]
-    }
-  }
-}

package/.nvmrc

@@ -1 +0,0 @@
-22