@agent-relay/spawner 0.1.0

package/dist/types.js

@@ -0,0 +1,193 @@
+/**
+ * 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',
+]);
+/**
+ * Shadow role preset names
+ */
+export const ShadowRolePresetSchema = z.enum(['reviewer', 'auditor', 'active']);
+/**
+ * Shadow execution mode
+ */
+export const ShadowModeSchema = z.enum(['subagent', 'process']);
+/**
+ * Policy source types
+ */
+export const PolicySourceSchema = z.enum(['repo', 'local', 'workspace', 'default']);
+// =============================================================================
+// Policy Types
+// =============================================================================
+/**
+ * Policy decision result
+ */
+export const PolicyDecisionSchema = z.object({
+    allowed: z.boolean(),
+    reason: z.string(),
+    policySource: PolicySourceSchema,
+});
+// =============================================================================
+// 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(),
+});
+/**
+ * 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(),
+});
+/**
+ * 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(),
+});
+// =============================================================================
+// 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(),
+});
+/**
+ * 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(),
+});
+/**
+ * Request for spawning a primary agent with its shadow
+ */
+export const SpawnWithShadowRequestSchema = z.object({
+    /** Primary agent configuration */
+    primary: PrimaryAgentConfigSchema,
+    /** Shadow agent configuration */
+    shadow: ShadowAgentConfigSchema,
+});
+/**
+ * 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(),
+});
+// =============================================================================
+// 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(),
+});
+/**
+ * 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(),
+});
+/**
+ * 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(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@agent-relay/spawner",
+  "version": "0.1.0",
+  "description": "Agent spawning types and utilities for Agent Relay",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "agent-relay",
+    "spawner",
+    "agent-lifecycle"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/spawner"
+  },
+  "license": "MIT"
+}

package/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/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);
+    });
+  });
+});