agent-relay 2.0.29 → 2.0.32

package/packages/spawner/.trajectories/index.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "lastUpdated": "2026-01-22T08:19:10.040Z",
+  "trajectories": {}
+}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,YAAY,CAAC"}

package/packages/spawner/dist/types.d.ts.map

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

package/packages/spawner/dist/types.js.map

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

package/packages/spawner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/spawner",
-  "version": "2.0.29",
+  "version": "2.0.32",
   "description": "Agent spawning types and utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/spawner/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * @agent-relay/spawner
+ *
+ * Agent spawning types and utilities for Agent Relay.
+ * Phase 2A extraction - pure types with Zod validation.
+ */
+
+export * from './types.js';

package/packages/spawner/src/types.test.ts

@@ -0,0 +1,385 @@
+/**
+ * Spawner Types Tests
+ *
+ * TDD approach - tests written first to define expected behavior.
+ */
+
+import { describe, it, expect } from 'vitest';
+import {
+  SpeakOnTriggerSchema,
+  ShadowRolePresetSchema,
+  PolicyDecisionSchema,
+  SpawnRequestSchema,
+  SpawnResultSchema,
+  WorkerInfoSchema,
+  PrimaryAgentConfigSchema,
+  ShadowAgentConfigSchema,
+  SpawnWithShadowRequestSchema,
+  SpawnWithShadowResultSchema,
+  ProjectConfigSchema,
+  BridgeConfigSchema,
+  LeadInfoSchema,
+} from './types.js';
+
+describe('Spawner Types', () => {
+  describe('SpeakOnTriggerSchema', () => {
+    it('should validate all trigger types', () => {
+      expect(SpeakOnTriggerSchema.parse('SESSION_END')).toBe('SESSION_END');
+      expect(SpeakOnTriggerSchema.parse('CODE_WRITTEN')).toBe('CODE_WRITTEN');
+      expect(SpeakOnTriggerSchema.parse('REVIEW_REQUEST')).toBe('REVIEW_REQUEST');
+      expect(SpeakOnTriggerSchema.parse('EXPLICIT_ASK')).toBe('EXPLICIT_ASK');
+      expect(SpeakOnTriggerSchema.parse('ALL_MESSAGES')).toBe('ALL_MESSAGES');
+    });
+
+    it('should reject invalid triggers', () => {
+      expect(() => SpeakOnTriggerSchema.parse('INVALID')).toThrow();
+      expect(() => SpeakOnTriggerSchema.parse('session_end')).toThrow(); // lowercase
+    });
+  });
+
+  describe('ShadowRolePresetSchema', () => {
+    it('should validate role presets', () => {
+      expect(ShadowRolePresetSchema.parse('reviewer')).toBe('reviewer');
+      expect(ShadowRolePresetSchema.parse('auditor')).toBe('auditor');
+      expect(ShadowRolePresetSchema.parse('active')).toBe('active');
+    });
+
+    it('should reject invalid roles', () => {
+      expect(() => ShadowRolePresetSchema.parse('observer')).toThrow();
+    });
+  });
+
+  describe('PolicyDecisionSchema', () => {
+    it('should validate allowed decision', () => {
+      const decision = {
+        allowed: true,
+        reason: 'Policy permits spawn',
+        policySource: 'repo',
+      };
+      const result = PolicyDecisionSchema.parse(decision);
+      expect(result.allowed).toBe(true);
+      expect(result.policySource).toBe('repo');
+    });
+
+    it('should validate denied decision', () => {
+      const decision = {
+        allowed: false,
+        reason: 'Agent limit exceeded',
+        policySource: 'workspace',
+      };
+      const result = PolicyDecisionSchema.parse(decision);
+      expect(result.allowed).toBe(false);
+      expect(result.reason).toBe('Agent limit exceeded');
+    });
+
+    it('should validate all policy sources', () => {
+      const sources = ['repo', 'local', 'workspace', 'default'];
+      for (const source of sources) {
+        const decision = { allowed: true, reason: 'test', policySource: source };
+        const result = PolicyDecisionSchema.parse(decision);
+        expect(result.policySource).toBe(source);
+      }
+    });
+  });
+
+  describe('SpawnRequestSchema', () => {
+    it('should validate minimal spawn request', () => {
+      const request = {
+        name: 'Worker1',
+        cli: 'claude',
+        task: 'Implement feature X',
+      };
+      const result = SpawnRequestSchema.parse(request);
+      expect(result.name).toBe('Worker1');
+      expect(result.cli).toBe('claude');
+      expect(result.task).toBe('Implement feature X');
+    });
+
+    it('should validate full spawn request', () => {
+      const request = {
+        name: 'ShadowAgent',
+        cli: 'claude:opus',
+        task: 'Review code changes',
+        team: 'backend',
+        cwd: '/workspace/project',
+        spawnerName: 'Lead',
+        interactive: false,
+        shadowMode: 'process',
+        shadowOf: 'Primary',
+        shadowAgent: 'reviewer',
+        shadowTriggers: ['CODE_WRITTEN', 'REVIEW_REQUEST'],
+        shadowSpeakOn: ['EXPLICIT_ASK'],
+        userId: 'user-123',
+      };
+      const result = SpawnRequestSchema.parse(request);
+      expect(result.shadowMode).toBe('process');
+      expect(result.shadowOf).toBe('Primary');
+      expect(result.shadowTriggers).toHaveLength(2);
+    });
+
+    it('should validate shadow modes', () => {
+      const subagent = { name: 'A', cli: 'claude', task: 't', shadowMode: 'subagent' };
+      const process = { name: 'B', cli: 'claude', task: 't', shadowMode: 'process' };
+
+      expect(SpawnRequestSchema.parse(subagent).shadowMode).toBe('subagent');
+      expect(SpawnRequestSchema.parse(process).shadowMode).toBe('process');
+    });
+
+    it('should reject invalid shadow mode', () => {
+      const request = { name: 'A', cli: 'claude', task: 't', shadowMode: 'invalid' };
+      expect(() => SpawnRequestSchema.parse(request)).toThrow();
+    });
+
+    it('should allow various CLI formats', () => {
+      const clis = ['claude', 'claude:opus', 'codex', 'gemini', 'cursor', 'agent'];
+      for (const cli of clis) {
+        const request = { name: 'Agent', cli, task: 'task' };
+        expect(SpawnRequestSchema.parse(request).cli).toBe(cli);
+      }
+    });
+  });
+
+  describe('SpawnResultSchema', () => {
+    it('should validate success result', () => {
+      const result = {
+        success: true,
+        name: 'Worker1',
+        pid: 12345,
+      };
+      const parsed = SpawnResultSchema.parse(result);
+      expect(parsed.success).toBe(true);
+      expect(parsed.pid).toBe(12345);
+    });
+
+    it('should validate failure result', () => {
+      const result = {
+        success: false,
+        name: 'Worker1',
+        error: 'Agent already exists',
+      };
+      const parsed = SpawnResultSchema.parse(result);
+      expect(parsed.success).toBe(false);
+      expect(parsed.error).toBe('Agent already exists');
+    });
+
+    it('should validate policy blocked result', () => {
+      const result = {
+        success: false,
+        name: 'Worker1',
+        error: 'Policy denied',
+        policyDecision: {
+          allowed: false,
+          reason: 'Spawner not authorized',
+          policySource: 'repo',
+        },
+      };
+      const parsed = SpawnResultSchema.parse(result);
+      expect(parsed.policyDecision?.allowed).toBe(false);
+      expect(parsed.policyDecision?.policySource).toBe('repo');
+    });
+  });
+
+  describe('WorkerInfoSchema', () => {
+    it('should validate complete worker info', () => {
+      const info = {
+        name: 'Worker1',
+        cli: 'claude',
+        task: 'Build API endpoints',
+        team: 'backend',
+        spawnedAt: 1705920600000,
+        pid: 12345,
+      };
+      const result = WorkerInfoSchema.parse(info);
+      expect(result.name).toBe('Worker1');
+      expect(result.team).toBe('backend');
+      expect(result.pid).toBe(12345);
+    });
+
+    it('should allow worker without optional fields', () => {
+      const info = {
+        name: 'Worker2',
+        cli: 'codex',
+        task: 'Fix bug',
+        spawnedAt: Date.now(),
+      };
+      const result = WorkerInfoSchema.parse(info);
+      expect(result.team).toBeUndefined();
+      expect(result.pid).toBeUndefined();
+    });
+  });
+
+  describe('PrimaryAgentConfigSchema', () => {
+    it('should validate minimal config', () => {
+      const config = { name: 'Lead' };
+      const result = PrimaryAgentConfigSchema.parse(config);
+      expect(result.name).toBe('Lead');
+    });
+
+    it('should validate full config', () => {
+      const config = {
+        name: 'Lead',
+        command: 'claude:opus',
+        task: 'Coordinate team',
+        team: 'core',
+      };
+      const result = PrimaryAgentConfigSchema.parse(config);
+      expect(result.command).toBe('claude:opus');
+      expect(result.team).toBe('core');
+    });
+  });
+
+  describe('ShadowAgentConfigSchema', () => {
+    it('should validate minimal shadow config', () => {
+      const config = { name: 'ShadowReviewer' };
+      const result = ShadowAgentConfigSchema.parse(config);
+      expect(result.name).toBe('ShadowReviewer');
+    });
+
+    it('should validate full shadow config', () => {
+      const config = {
+        name: 'Auditor',
+        command: 'codex',
+        role: 'auditor',
+        speakOn: ['SESSION_END', 'EXPLICIT_ASK'],
+        prompt: 'Review all code changes for security issues',
+      };
+      const result = ShadowAgentConfigSchema.parse(config);
+      expect(result.role).toBe('auditor');
+      expect(result.speakOn).toHaveLength(2);
+      expect(result.prompt).toContain('security');
+    });
+
+    it('should allow custom role string', () => {
+      const config = { name: 'Custom', role: 'custom-observer' };
+      const result = ShadowAgentConfigSchema.parse(config);
+      expect(result.role).toBe('custom-observer');
+    });
+  });
+
+  describe('SpawnWithShadowRequestSchema', () => {
+    it('should validate spawn with shadow request', () => {
+      const request = {
+        primary: {
+          name: 'Lead',
+          command: 'claude',
+          task: 'Implement feature',
+          team: 'core',
+        },
+        shadow: {
+          name: 'Reviewer',
+          role: 'reviewer',
+          speakOn: ['CODE_WRITTEN'],
+        },
+      };
+      const result = SpawnWithShadowRequestSchema.parse(request);
+      expect(result.primary.name).toBe('Lead');
+      expect(result.shadow.name).toBe('Reviewer');
+    });
+  });
+
+  describe('SpawnWithShadowResultSchema', () => {
+    it('should validate full success result', () => {
+      const result = {
+        success: true,
+        primary: { success: true, name: 'Lead', pid: 1000 },
+        shadow: { success: true, name: 'Reviewer', pid: 1001 },
+      };
+      const parsed = SpawnWithShadowResultSchema.parse(result);
+      expect(parsed.primary?.pid).toBe(1000);
+      expect(parsed.shadow?.pid).toBe(1001);
+    });
+
+    it('should validate partial success (shadow failed)', () => {
+      const result = {
+        success: true,
+        primary: { success: true, name: 'Lead', pid: 1000 },
+        shadow: { success: false, name: 'Reviewer', error: 'No authenticated CLI' },
+        error: 'Shadow spawn failed',
+      };
+      const parsed = SpawnWithShadowResultSchema.parse(result);
+      expect(parsed.success).toBe(true); // Overall success because primary worked
+      expect(parsed.shadow?.success).toBe(false);
+    });
+
+    it('should validate failure result', () => {
+      const result = {
+        success: false,
+        error: 'Primary agent spawn failed',
+      };
+      const parsed = SpawnWithShadowResultSchema.parse(result);
+      expect(parsed.success).toBe(false);
+      expect(parsed.primary).toBeUndefined();
+    });
+  });
+
+  describe('ProjectConfigSchema', () => {
+    it('should validate project config', () => {
+      const config = {
+        path: '/workspace/myproject',
+        id: 'proj-abc123',
+        socketPath: '/tmp/relay-myproject.sock',
+        leadName: 'ProjectLead',
+        cli: 'claude',
+      };
+      const result = ProjectConfigSchema.parse(config);
+      expect(result.path).toBe('/workspace/myproject');
+      expect(result.leadName).toBe('ProjectLead');
+    });
+  });
+
+  describe('BridgeConfigSchema', () => {
+    it('should validate bridge config', () => {
+      const config = {
+        projects: [
+          {
+            path: '/workspace/project1',
+            id: 'proj-1',
+            socketPath: '/tmp/relay-1.sock',
+            leadName: 'Lead1',
+            cli: 'claude',
+          },
+          {
+            path: '/workspace/project2',
+            id: 'proj-2',
+            socketPath: '/tmp/relay-2.sock',
+            leadName: 'Lead2',
+            cli: 'codex',
+          },
+        ],
+        cliOverride: 'claude:opus',
+      };
+      const result = BridgeConfigSchema.parse(config);
+      expect(result.projects).toHaveLength(2);
+      expect(result.cliOverride).toBe('claude:opus');
+    });
+
+    it('should allow bridge config without override', () => {
+      const config = { projects: [] };
+      const result = BridgeConfigSchema.parse(config);
+      expect(result.cliOverride).toBeUndefined();
+    });
+  });
+
+  describe('LeadInfoSchema', () => {
+    it('should validate lead info', () => {
+      const info = {
+        name: 'ProjectLead',
+        projectId: 'proj-123',
+        connected: true,
+      };
+      const result = LeadInfoSchema.parse(info);
+      expect(result.name).toBe('ProjectLead');
+      expect(result.connected).toBe(true);
+    });
+
+    it('should validate disconnected lead', () => {
+      const info = {
+        name: 'OldLead',
+        projectId: 'proj-456',
+        connected: false,
+      };
+      const result = LeadInfoSchema.parse(info);
+      expect(result.connected).toBe(false);
+    });
+  });
+});

package/packages/spawner/src/types.ts

@@ -0,0 +1,228 @@
+/**
+ * Spawner Types
+ *
+ * Zod schemas for agent spawning and lifecycle management types.
+ * These types are used across the spawner, daemon, and dashboard.
+ */
+
+import { z } from 'zod';
+
+// =============================================================================
+// Enums and Basic Types
+// =============================================================================
+
+/**
+ * When shadow agents should activate
+ */
+export const SpeakOnTriggerSchema = z.enum([
+  'SESSION_END',
+  'CODE_WRITTEN',
+  'REVIEW_REQUEST',
+  'EXPLICIT_ASK',
+  'ALL_MESSAGES',
+]);
+export type SpeakOnTrigger = z.infer<typeof SpeakOnTriggerSchema>;
+
+/**
+ * Shadow role preset names
+ */
+export const ShadowRolePresetSchema = z.enum(['reviewer', 'auditor', 'active']);
+export type ShadowRolePreset = z.infer<typeof ShadowRolePresetSchema>;
+
+/**
+ * Shadow execution mode
+ */
+export const ShadowModeSchema = z.enum(['subagent', 'process']);
+export type ShadowMode = z.infer<typeof ShadowModeSchema>;
+
+/**
+ * Policy source types
+ */
+export const PolicySourceSchema = z.enum(['repo', 'local', 'workspace', 'default']);
+export type PolicySource = z.infer<typeof PolicySourceSchema>;
+
+// =============================================================================
+// Policy Types
+// =============================================================================
+
+/**
+ * Policy decision result
+ */
+export const PolicyDecisionSchema = z.object({
+  allowed: z.boolean(),
+  reason: z.string(),
+  policySource: PolicySourceSchema,
+});
+export type PolicyDecision = z.infer<typeof PolicyDecisionSchema>;
+
+// =============================================================================
+// Spawn Request/Result Types
+// =============================================================================
+
+/**
+ * Request to spawn a new agent
+ */
+export const SpawnRequestSchema = z.object({
+  /** Worker agent name (must be unique) */
+  name: z.string(),
+  /** CLI tool (e.g., 'claude', 'claude:opus', 'codex', 'gemini') */
+  cli: z.string(),
+  /** Initial task to inject after spawn */
+  task: z.string(),
+  /** Optional team name for organization */
+  team: z.string().optional(),
+  /** Working directory (defaults to project root) */
+  cwd: z.string().optional(),
+  /** Name of requesting agent (for policy enforcement) */
+  spawnerName: z.string().optional(),
+  /** Interactive mode - disables auto-accept of permission prompts */
+  interactive: z.boolean().optional(),
+  /** Shadow execution mode (subagent = no extra process) */
+  shadowMode: ShadowModeSchema.optional(),
+  /** Primary agent to shadow (if this agent is a shadow) */
+  shadowOf: z.string().optional(),
+  /** Shadow agent profile to use (for subagent mode) */
+  shadowAgent: z.string().optional(),
+  /** When to trigger the shadow (for subagent mode) */
+  shadowTriggers: z.array(SpeakOnTriggerSchema).optional(),
+  /** When the shadow should speak (default: ['EXPLICIT_ASK']) */
+  shadowSpeakOn: z.array(SpeakOnTriggerSchema).optional(),
+  /** User ID for per-user credential storage in shared workspaces */
+  userId: z.string().optional(),
+});
+export type SpawnRequest = z.infer<typeof SpawnRequestSchema>;
+
+/**
+ * Result of a spawn operation
+ */
+export const SpawnResultSchema = z.object({
+  success: z.boolean(),
+  name: z.string(),
+  /** PID of the spawned process (for pty-based workers) */
+  pid: z.number().optional(),
+  error: z.string().optional(),
+  /** Policy decision details if spawn was blocked by policy */
+  policyDecision: PolicyDecisionSchema.optional(),
+});
+export type SpawnResult = z.infer<typeof SpawnResultSchema>;
+
+/**
+ * Information about an active worker
+ */
+export const WorkerInfoSchema = z.object({
+  name: z.string(),
+  cli: z.string(),
+  task: z.string(),
+  /** Optional team name this agent belongs to */
+  team: z.string().optional(),
+  spawnedAt: z.number(),
+  /** PID of the pty process */
+  pid: z.number().optional(),
+});
+export type WorkerInfo = z.infer<typeof WorkerInfoSchema>;
+
+// =============================================================================
+// Shadow Agent Types
+// =============================================================================
+
+/**
+ * Primary agent configuration for spawnWithShadow
+ */
+export const PrimaryAgentConfigSchema = z.object({
+  /** Agent name */
+  name: z.string(),
+  /** CLI command (default: 'claude') */
+  command: z.string().optional(),
+  /** Initial task to send to the agent */
+  task: z.string().optional(),
+  /** Team name to organize under */
+  team: z.string().optional(),
+});
+export type PrimaryAgentConfig = z.infer<typeof PrimaryAgentConfigSchema>;
+
+/**
+ * Shadow agent configuration for spawnWithShadow
+ */
+export const ShadowAgentConfigSchema = z.object({
+  /** Shadow agent name */
+  name: z.string(),
+  /** CLI command (default: same as primary) */
+  command: z.string().optional(),
+  /** Role preset (reviewer, auditor, active) or custom prompt */
+  role: z.string().optional(),
+  /** Custom speakOn triggers (overrides role preset) */
+  speakOn: z.array(SpeakOnTriggerSchema).optional(),
+  /** Custom prompt for the shadow agent */
+  prompt: z.string().optional(),
+});
+export type ShadowAgentConfig = z.infer<typeof ShadowAgentConfigSchema>;
+
+/**
+ * Request for spawning a primary agent with its shadow
+ */
+export const SpawnWithShadowRequestSchema = z.object({
+  /** Primary agent configuration */
+  primary: PrimaryAgentConfigSchema,
+  /** Shadow agent configuration */
+  shadow: ShadowAgentConfigSchema,
+});
+export type SpawnWithShadowRequest = z.infer<typeof SpawnWithShadowRequestSchema>;
+
+/**
+ * Result from spawnWithShadow
+ */
+export const SpawnWithShadowResultSchema = z.object({
+  success: z.boolean(),
+  /** Primary agent spawn result */
+  primary: SpawnResultSchema.optional(),
+  /** Shadow agent spawn result */
+  shadow: SpawnResultSchema.optional(),
+  /** Error message if overall operation failed */
+  error: z.string().optional(),
+});
+export type SpawnWithShadowResult = z.infer<typeof SpawnWithShadowResultSchema>;
+
+// =============================================================================
+// Bridge/Multi-Project Types
+// =============================================================================
+
+/**
+ * Project configuration for multi-project orchestration
+ */
+export const ProjectConfigSchema = z.object({
+  /** Absolute path to project root */
+  path: z.string(),
+  /** Project identifier (derived from path hash) */
+  id: z.string(),
+  /** Socket path for this project's daemon */
+  socketPath: z.string(),
+  /** Lead agent name (auto-generated from dirname if not specified) */
+  leadName: z.string(),
+  /** CLI tool to use (default: claude) */
+  cli: z.string(),
+});
+export type ProjectConfig = z.infer<typeof ProjectConfigSchema>;
+
+/**
+ * Bridge configuration for multi-project coordination
+ */
+export const BridgeConfigSchema = z.object({
+  /** Projects to bridge */
+  projects: z.array(ProjectConfigSchema),
+  /** CLI override for all projects */
+  cliOverride: z.string().optional(),
+});
+export type BridgeConfig = z.infer<typeof BridgeConfigSchema>;
+
+/**
+ * Lead agent information
+ */
+export const LeadInfoSchema = z.object({
+  /** Lead agent name */
+  name: z.string(),
+  /** Project this lead manages */
+  projectId: z.string(),
+  /** Whether lead is currently connected */
+  connected: z.boolean(),
+});
+export type LeadInfo = z.infer<typeof LeadInfoSchema>;

package/packages/spawner/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "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
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}