macro-agent 0.2.4 → 0.2.6

package/src/roles/types.ts

@@ -1,344 +0,0 @@
-/**
- * Role System Type Definitions
- *
- * Implements the composable role system from s-60tc:
- * - Capability-based permissions
- * - Enforcement mechanisms (workspace, tools, lifecycle, protocol, permissions)
- * - Role definition and registry interfaces
- */
-
-// =============================================================================
-// Capabilities (Atomic Permission Units)
-// =============================================================================
-
-/** File operation capabilities */
-export type FileCapability = "file.read" | "file.write" | "file.delete";
-
-/** Git operation capabilities */
-export type GitCapability =
-  | "git.commit"
-  | "git.merge"
-  | "git.push"
-  | "git.branch.create"
-  | "git.branch.delete";
-
-/** Agent management capabilities */
-export type AgentCapability =
-  | "agent.spawn.worker"
-  | "agent.spawn.integrator"
-  | "agent.spawn.monitor"
-  | "agent.spawn.custom"
-  | "agent.terminate";
-
-/** Lifecycle capabilities */
-export type LifecycleCapability =
-  | "lifecycle.done"
-  | "lifecycle.persistent"
-  | "lifecycle.daemon";
-
-/** Task management capabilities (via TaskBackend, see s-8472) */
-export type TaskCapability =
-  | "task.create"
-  | "task.assign"
-  | "task.update"
-  | "task.close"
-  | "task.claim";
-
-/** Execution capabilities */
-export type ExecCapability =
-  | "exec.command"
-  | "exec.build"
-  | "exec.test"
-  | "exec.lint";
-
-/** Communication capabilities */
-export type MsgCapability = "msg.send" | "msg.broadcast" | "msg.subscribe";
-
-/** Workspace capabilities */
-export type WorkspaceCapability =
-  | "workspace.worktree"
-  | "workspace.stream"
-  | "workspace.integrate";
-
-/** All capability types combined, plus wildcard */
-export type Capability =
-  | FileCapability
-  | GitCapability
-  | AgentCapability
-  | LifecycleCapability
-  | TaskCapability
-  | ExecCapability
-  | MsgCapability
-  | WorkspaceCapability
-  | "*"; // Wildcard for all capabilities
-
-// =============================================================================
-// Enforcement Mechanisms
-// =============================================================================
-
-/**
- * Workspace Enforcement
- * Controls filesystem access and isolation.
- */
-export interface WorkspaceEnforcement {
-  /** Workspace type */
-  type: "own" | "shared" | "mount" | "none";
-
-  /** For 'own' type: branch naming pattern */
-  branchPattern?: string;
-
-  /** For 'own' type: cleanup workspace on agent termination */
-  cleanupOnTerminate?: boolean;
-
-  /** For 'own' type: can read child workspace paths (Coordinator) */
-  canViewChildWorkspaces?: boolean;
-
-  /** For 'shared' type: role names to share with */
-  sharedWith?: string[];
-
-  /** For 'mount' type: branch/path to mount */
-  mountTarget?: string;
-
-  /** For 'mount' type: read-only access */
-  readonly?: boolean;
-}
-
-/**
- * Tool Enforcement
- * Controls which MCP tools are available.
- */
-export interface ToolEnforcement {
-  /** Mode for tool filtering */
-  mode: "capability" | "allowlist" | "denylist" | "all";
-
-  /** For allowlist/denylist modes: explicit tool names */
-  tools?: string[];
-}
-
-/**
- * Lifecycle Enforcement
- * Controls agent lifecycle behavior.
- */
-export interface LifecycleEnforcement {
-  /** Lifecycle type */
-  type: "ephemeral" | "persistent" | "daemon" | "event-driven";
-
-  /** For ephemeral: terminate when task completes */
-  taskBound?: boolean;
-
-  /** For ephemeral: timeout in milliseconds (default: 30 min for workers) */
-  maxDurationMs?: number;
-
-  /** For event-driven: terminate when parent terminates */
-  parentBound?: boolean;
-
-  /** For all types: terminate children on done */
-  cascadeTerminate?: boolean;
-
-  /** For all types: clean own workspace on done */
-  selfCleanup?: boolean;
-}
-
-/**
- * Protocol Enforcement
- * Controls message routing and subscriptions.
- */
-export interface ProtocolEnforcement {
-  /** Message patterns to receive */
-  subscriptions: string[];
-
-  /** Message patterns allowed to send */
-  canEmit: string[];
-}
-
-/**
- * Capability restriction for fine-grained control
- */
-export interface CapabilityRestriction {
-  /** Scope restriction (e.g., "own-workspace" vs "any") */
-  scope?: string;
-
-  /** Rate limit (max calls per minute) */
-  rateLimit?: number;
-
-  /** Requires human approval */
-  requireApproval?: boolean;
-}
-
-/**
- * Permission Enforcement
- * Controls capability-level permissions with optional restrictions.
- */
-export interface PermissionEnforcement {
-  /** List of capability IDs */
-  capabilities: Capability[];
-
-  /** Optional restrictions on capabilities */
-  restrictions?: Record<string, CapabilityRestriction>;
-}
-
-// =============================================================================
-// Role Definition
-// =============================================================================
-
-/**
- * Role Definition
- * Combines capabilities with enforcement mechanisms.
- */
-export interface RoleDefinition {
-  // Identity
-  /** Unique role identifier (supports dot-notation like 'worker.resolver') */
-  name: string;
-
-  /** Human-readable name */
-  displayName?: string;
-
-  /** Role purpose description */
-  description?: string;
-
-  // Capabilities
-  /** List of capability IDs */
-  capabilities: Capability[];
-
-  // Enforcement (all optional - defaults applied)
-  /** Workspace enforcement configuration */
-  workspace?: WorkspaceEnforcement;
-
-  /** Tool enforcement configuration */
-  tools?: ToolEnforcement;
-
-  /** Lifecycle enforcement configuration */
-  lifecycle?: LifecycleEnforcement;
-
-  /** Protocol enforcement configuration */
-  protocol?: ProtocolEnforcement;
-
-  /** Permission enforcement configuration */
-  permissions?: PermissionEnforcement;
-
-  // Composition
-  /** Inherit from another role */
-  extends?: string;
-
-  // Instructions (behavioral guidance via prompts)
-  /** Role-specific system prompt */
-  systemPrompt?: string;
-
-  /** Path to prompt template file */
-  promptTemplate?: string;
-}
-
-/**
- * Role Configuration
- * Extends RoleDefinition with override behavior for configuration files.
- */
-export interface RoleConfig extends RoleDefinition {
-  /** Override behavior (only for roles matching built-in names) */
-  override?: "replace" | "merge";
-}
-
-// =============================================================================
-// Agent Spawn Config with Role
-// =============================================================================
-
-/**
- * Capability overrides for per-spawn customization
- */
-export interface CapabilityOverrides {
-  /** Capabilities to add */
-  add?: Capability[];
-
-  /** Capabilities to remove */
-  remove?: Capability[];
-}
-
-/**
- * Agent spawn configuration including role
- */
-export interface AgentSpawnConfig {
-  /** Role name */
-  role: string;
-
-  /** Task ID to bind to */
-  taskId?: string;
-
-  /** Parent agent ID */
-  parentId?: string;
-
-  /** Override role's system prompt */
-  customPrompt?: string;
-
-  /** Per-spawn capability tweaks */
-  capabilityOverrides?: CapabilityOverrides;
-}
-
-// =============================================================================
-// Role Registry
-// =============================================================================
-
-/**
- * Role Registry Interface
- * Manages role definitions with layered resolution.
- */
-export interface RoleRegistry {
-  /** Get a role by name (exact match, no inheritance) */
-  getRole(name: string): RoleDefinition | undefined;
-
-  /** Register a role definition */
-  registerRole(role: RoleDefinition): void;
-
-  /** List all registered roles */
-  listRoles(): RoleDefinition[];
-
-  /** Resolve a role with inheritance and fallback */
-  resolveRole(name: string): RoleDefinition;
-
-  /** Check if a role has a specific capability */
-  hasCapability(roleName: string, capability: Capability): boolean;
-}
-
-// =============================================================================
-// Validation
-// =============================================================================
-
-/**
- * Validation error
- */
-export interface ValidationError {
-  field: string;
-  message: string;
-}
-
-/**
- * Validation warning
- */
-export interface ValidationWarning {
-  field: string;
-  message: string;
-}
-
-/**
- * Role validation result
- */
-export interface RoleValidation {
-  errors: ValidationError[];
-  warnings: ValidationWarning[];
-  isValid: boolean;
-}
-
-// =============================================================================
-// Tool Filtering
-// =============================================================================
-
-/**
- * Tool interface for filtering
- */
-export interface Tool {
-  name: string;
-  description?: string;
-}
-
-/**
- * Capability to tool mapping type
- */
-export type CapabilityToolMap = Record<string, string[]>;

package/src/store/index.ts

@@ -1,8 +0,0 @@
-/**
- * Store module exports (V2)
- *
- * Only types are retained. The V1 EventStore implementation has been removed.
- */
-
-export * from './types/index.js';
-export { CURRENT_EVENT_VERSION } from './types/events.js';

package/src/store/types/agents.ts

@@ -1,69 +0,0 @@
-/**
- * Agent-related type definitions
- */
-
-import type { AgentId, SessionId, TaskId, Timestamp } from "./primitives.js";
-
-// Agent states
-export type AgentState = "spawning" | "running" | "stopped" | "failed";
-
-export type StopReason =
-  | "completed"
-  | "failed"
-  | "stopped"
-  | "timeout"
-  | "cancelled";
-
-// Agent configuration
-export interface AgentConfig {
-  model?: string;
-  timeout?: number;
-  resource_limits?: {
-    max_tokens?: number;
-    max_children?: number;
-    [key: string]: unknown;
-  };
-}
-
-// Agent record in materialized view
-export interface Agent {
-  id: AgentId;
-  /** Optional display name (set via rename, not derived from events) */
-  name?: string;
-  session_id: SessionId;
-  /** Session ID from the underlying agent provider (e.g., Claude Code UUID for --resume) */
-  provider_session_id?: string;
-  parent: AgentId | null;
-  lineage: AgentId[];
-  state: AgentState;
-  stop_reason?: StopReason;
-  task: string;
-  task_id?: TaskId;
-  role?: string;
-  /** Team instance ID this agent belongs to (set by TeamManager) */
-  team_instance?: string;
-  config: AgentConfig;
-  cwd: string;
-  plan: Array<{ content: string; priority: string; status: string }>;
-  /** Arbitrary metadata (persisted out-of-band, not derived from events) */
-  metadata?: Record<string, unknown>;
-  created_at: Timestamp;
-  started_at?: Timestamp;
-  stopped_at?: Timestamp;
-  /** Last time this agent emitted an event (for health monitoring) */
-  last_activity_at?: Timestamp;
-}
-
-/**
- * Partial update for agent metadata fields.
- * All fields are optional — only provided fields are updated.
- * `metadata` is merged (shallow) with existing metadata.
- */
-export interface AgentMetadataUpdate {
-  name?: string;
-  plan?: Array<{ content: string; priority: string; status: string }>;
-  metadata?: Record<string, unknown>;
-  team_instance?: string;
-  /** Override the agent's working directory (e.g., to workspace worktree path) */
-  cwd?: string;
-}

package/src/store/types/events.ts

@@ -1,91 +0,0 @@
-/**
- * Event-related type definitions
- *
- * Core event types used by workspace module and index exports.
- * Message-specific helpers removed in V2 (agent-inbox handles messaging).
- */
-
-import type { AgentId, TaskId, EventId, Timestamp } from "./primitives.js";
-
-// Current event schema version
-export const CURRENT_EVENT_VERSION = 1;
-
-// Event types
-export type EventType =
-  | "spawn"
-  | "stop"
-  | "status"
-  | "message"
-  | "task"
-  | "subscription"
-  | "peer_message"
-  | "peer_request"
-  | "conversation"
-  | "turn"
-  | "thread"
-  | "session";
-
-// Status types for status events
-export type StatusType =
-  | "started"
-  | "checkpoint"
-  | "blocked"
-  | "discovery"
-  | "completed"
-  | "failed";
-
-// Event source
-export interface EventSource {
-  agent_id?: AgentId;
-  task_id?: TaskId;
-  lineage?: AgentId[];
-  peer?: string;
-}
-
-// Event target
-export interface EventTarget {
-  agent_id?: AgentId;
-  task_id?: TaskId;
-  topic?: string;
-  scope?: "subtree" | "branch" | "all";
-  delivered?: AgentId[];
-}
-
-// Event metadata
-export interface EventMetadata {
-  correlation_id?: string;
-  ttl?: number;
-  requires_ack?: boolean;
-  [key: string]: unknown;
-}
-
-// Base event structure
-export interface Event {
-  id: EventId;
-  version: number;
-  timestamp: Timestamp;
-  type: EventType;
-  source: EventSource;
-  target?: EventTarget;
-  payload: Record<string, unknown>;
-  metadata?: EventMetadata;
-}
-
-// Event input (without auto-generated fields)
-export interface EventInput {
-  type: EventType;
-  source: EventSource;
-  target?: EventTarget;
-  payload: Record<string, unknown>;
-  metadata?: EventMetadata;
-}
-
-// Event query filter
-export interface EventFilter {
-  type?: EventType;
-  source_agent_id?: AgentId;
-  target_agent_id?: AgentId;
-  after?: Timestamp;
-  before?: Timestamp;
-  limit?: number;
-}

package/src/store/types/index.ts

@@ -1,9 +0,0 @@
-/**
- * Type definitions index - re-exports all types
- */
-
-export * from "./primitives.js";
-export * from "./events.js";
-export * from "./agents.js";
-export * from "./tasks.js";
-export * from "./messages.js";

package/src/store/types/messages.ts

@@ -1,32 +0,0 @@
-/**
- * Message-related type definitions
- */
-
-import type { EventId, Timestamp } from "./primitives.js";
-import type { EventSource } from "./events.js";
-
-// Message in queue
-export interface QueuedMessage {
-  id: EventId;
-  from: EventSource;
-  content: string;
-  timestamp: Timestamp;
-  truncated: boolean;
-  correlation_id?: string;
-}
-
-// Subscription types
-export type SubscriptionType =
-  | "agent"
-  | "task"
-  | "lineage"
-  | "subtree"
-  | "topic"
-  | "broadcast"
-  | "role";
-
-// Subscription record
-export interface Subscription {
-  type: SubscriptionType;
-  target: string;
-}

package/src/store/types/primitives.ts

@@ -1,9 +0,0 @@
-/**
- * Primitive type definitions
- */
-
-export type AgentId = string;
-export type SessionId = string;
-export type TaskId = string;
-export type EventId = string;
-export type Timestamp = number;

package/src/store/types/tasks.ts

@@ -1,124 +0,0 @@
-/**
- * Task-related type definitions
- */
-
-import type { AgentId, TaskId, Timestamp } from "./primitives.js";
-
-// Task statuses
-export type TaskStatus =
-  | "pending"
-  | "assigned"
-  | "in_progress"
-  | "completed"
-  | "failed";
-
-// Task actions
-export type TaskAction =
-  | "created"
-  | "assigned"
-  | "unassigned"
-  | "status_change"
-  | "completed"
-  | "failed"
-  | "blocker_added"
-  | "blocker_removed";
-
-// Artifact reference
-export interface ArtifactRef {
-  type: "file" | "commit" | "url";
-  ref: string;
-  description?: string;
-}
-
-// =============================================================================
-// Retry Policy Types
-// =============================================================================
-
-/**
- * Configuration for task retry behavior
- */
-export interface RetryPolicy {
-  /**
-   * Maximum number of retry attempts
-   * Default: 0 (no retry)
-   */
-  maxRetries: number;
-
-  /**
-   * Which conditions trigger a retry
-   * - 'failed': Task explicitly failed
-   * - 'stalled': Agent became unresponsive
-   */
-  retryOn: ("failed" | "stalled")[];
-
-  /**
-   * Initial backoff delay in milliseconds
-   * Default: 1000 (1 second)
-   */
-  backoffMs: number;
-
-  /**
-   * Multiplier for exponential backoff
-   * Default: 2
-   */
-  backoffMultiplier: number;
-
-  /**
-   * Maximum backoff delay in milliseconds
-   * Default: 60000 (1 minute)
-   */
-  maxBackoffMs: number;
-}
-
-/**
- * Current state of retry attempts for a task
- */
-export interface RetryState {
-  /** Number of retry attempts made */
-  attemptCount: number;
-
-  /** When the last attempt was made */
-  lastAttemptAt: Timestamp;
-
-  /** Error from the last failed attempt */
-  lastError?: string;
-
-  /** When the next retry is scheduled (if waiting) */
-  nextRetryAt?: Timestamp;
-}
-
-// Agent assignment history entry
-export interface AgentHistoryEntry {
-  agent_id: AgentId;
-  role?: string;
-  assigned_at: Timestamp;
-  ended_at?: Timestamp;
-}
-
-// Task record in materialized view
-export interface Task {
-  id: TaskId;
-  description: string;
-  status: TaskStatus;
-  assigned_agent?: AgentId;
-  parent_task?: TaskId;
-  subtasks?: TaskId[];
-  blockers?: TaskId[];
-  created_at: Timestamp;
-  started_at?: Timestamp;
-  completed_at?: Timestamp;
-  created_by: AgentId;
-  inputs?: Record<string, unknown>;
-  outputs?: Record<string, unknown>;
-  artifacts?: ArtifactRef[];
-  agent_history?: AgentHistoryEntry[];
-
-  /** Retry policy for this task */
-  retryPolicy?: RetryPolicy;
-
-  /** Current retry state */
-  retryState?: RetryState;
-
-  /** Tags for task classification and filtering (used by pull model) */
-  tags?: string[];
-}