macro-agent 0.2.5 → 0.2.6

package/src/agent/types.ts

@@ -1,480 +0,0 @@
-/**
- * AgentManager type definitions
- */
-
-import type { Session, AgentHandle, PermissionMode } from "acp-factory";
-import type {
-  AgentId,
-  TaskId,
-  Timestamp,
-  Agent,
-  AgentState,
-} from "../store/types/index.js";
-import type {
-  StreamId,
-  StreamConfig,
-  Workspace,
-} from "../workspace/types.js";
-import type { TaskRef } from "git-cascade/events";
-
-// ─────────────────────────────────────────────────────────────────
-// Spawn Options
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Options for spawning a new agent
- */
-export interface SpawnAgentOptions {
-  /** Task description for the agent */
-  task: string;
-
-  /** Optional task ID (auto-generated if not provided) */
-  task_id?: TaskId;
-
-  /** Parent agent ID (null for head managers) */
-  parent?: AgentId | null;
-
-  /** Working directory for the agent */
-  cwd?: string;
-
-  /** Permission mode for tool calls */
-  permissionMode?: PermissionMode;
-
-  /** Whether parent should subscribe to this agent's subtree */
-  subscribeParent?: boolean;
-
-  /** Additional topics for the agent to subscribe to */
-  topics?: string[];
-
-  /** Custom configuration passed to agent */
-  config?: AgentConfig;
-
-  /** Optional agent type (defaults to "claude-code") */
-  agentType?: string;
-
-  /**
-   * Custom prompt content injected as the role instructions section.
-   * When set, replaces resolvedRole.systemPrompt in prompt assembly.
-   * Used by team templates to provide static role prompts.
-   */
-  customPrompt?: string;
-
-  /**
-   * Interaction pattern sections to append after the role prompt.
-   * Auto-generated by TeamRuntime based on team config (pull mode, etc.).
-   */
-  interactionPatterns?: string[];
-
-  // ─────────────────────────────────────────────────────────────────
-  // Workspace-related fields (Phase 2)
-  // ─────────────────────────────────────────────────────────────────
-
-  /**
-   * Agent role name (e.g., 'worker', 'coordinator', 'integrator', 'monitor').
-   * If not provided, role is inferred from parent presence.
-   */
-  role?: string;
-
-  /** Team instance ID this agent belongs to (set by TeamManager interceptor) */
-  team_instance?: string;
-
-  /**
-   * When true, spawn the worker with `claudeCode.options.settingSources = []`
-   * so it does NOT inherit the host machine's user/project/local Claude
-   * settings. This prevents host-level plugin MCP servers (e.g.
-   * claude-code-swarm, oh-my-claudecode) from auto-mounting and hanging
-   * the worker's session/new at MCP-init time. Mail-inbound dispatch
-   * workers always set this; interactive `multiagent` users typically
-   * don't (they want their plugins).
-   */
-  isolatedSettings?: boolean;
-
-  /**
-   * Per-spawn permission rules — Claude Code permission patterns
-   * (e.g., `Read(**)`, `Bash(rm -rf:*)`).
-   *
-   * Wired through `agentMeta.claudeCode.options.settings.permissions` so
-   * Claude's permission engine consults them on every tool call. `deny`
-   * always wins, even over `permissionMode: "auto-approve"` (verified live).
-   *
-   * `ask` resolution depends on `fullAutonomous`:
-   *   - fullAutonomous: true  → `ask` rules collapse to `allow` (no human
-   *     to answer; opt-in by callers like the mail-inbound consumer)
-   *   - fullAutonomous: false → `ask` rules collapse to `deny` (safe
-   *     default — autonomous workers shouldn't make judgment calls)
-   *
-   * No file I/O — passed inline via SDK options, so concurrent spawns
-   * sharing a CWD never collide on `.claude/settings.json`.
-   */
-  permissions?: {
-    allow?: string[];
-    deny?: string[];
-    ask?: string[];
-  };
-
-  /**
-   * When true, treat `permissions.ask` rules as auto-approve. Use only for
-   * autonomous workers with no user-interactive permission round-trip
-   * available (e.g., mail-inbound dispatch). Default: false.
-   */
-  fullAutonomous?: boolean;
-
-  /**
-   * When true, set `settings.permissions.ask: ['*']` so the SDK consults
-   * `canUseTool` for every tool call, emitting `permission_request` session
-   * updates the host's prompt iterator can intercept. Used for dispatch-
-   * target agents (mail+reuse, ACP+reuse) where the dispatch consumer
-   * applies per-call deny rules via the permission overlay registry.
-   * Default: false (chat agents and parented children stay on static rules).
-   */
-  askForAllTools?: boolean;
-
-  /**
-   * Stream ID to join (for workers and integrators).
-   * Required for workers and integrators when using workspace isolation.
-   */
-  streamId?: StreamId;
-
-  /**
-   * Stream configuration for creating a new integration stream.
-   * Used by coordinators to create their integration branch.
-   */
-  streamConfig?: StreamConfig;
-
-  /**
-   * git-cascade task ID to claim (for workers).
-   * If provided, the worker will claim this task and work on it.
-   */
-  gitCascadeTaskId?: string;
-
-  /**
-   * Resolved capabilities for this agent's role.
-   * Injected by TeamRuntime spawn interceptor for capability-based workspace dispatch.
-   */
-  capabilities?: string[];
-
-  /**
-   * Optional reference to an external task this agent is working on. When
-   * set, the reference is woven into cascade event metadata so OpenHive (or
-   * any other observer) can bind the agent's commits, merges, and streams
-   * to the OpenTasks node. Propagates through:
-   *   - stream creation: `adapter.createStream({ metadata: { task_ref } })`
-   *   - commits: `adapter.commitChanges({ metadata: { task_ref } })` (pass
-   *     per-commit; each commit can carry a distinct sub-task binding)
-   * Can also arrive late via pull-mode `claim_task` — workers that claim a
-   * task mid-session should include the ref on subsequent commits.
-   */
-  taskRef?: TaskRef;
-}
-
-/**
- * Options for continuing a terminated agent
- */
-export interface ContinueAgentOptions {
-  /** Maximum number of conversation turns to include in context (default: 50) */
-  maxMessages?: number;
-
-  /** Override the task description for the continuation */
-  task?: string;
-
-  /** Additional context to prepend to the continuation prompt */
-  additionalContext?: string;
-}
-
-/**
- * Custom agent configuration
- */
-export interface AgentConfig {
-  /** Model to use (if configurable) */
-  model?: string;
-
-  /** Maximum tokens per response */
-  maxTokens?: number;
-
-  /** Temperature for responses */
-  temperature?: number;
-
-  /** Additional environment variables */
-  env?: Record<string, string>;
-
-  /** MCP servers to connect */
-  mcpServers?: MCPServerConfig[];
-}
-
-/**
- * MCP server configuration.
- *
- * A discriminated union over transport. The legacy stdio shape (no `type`,
- * or `type: "stdio"`) is preserved byte-for-byte; new `http`/`sse` variants
- * carry a `url` + optional `headers` instead of a `command`. These map
- * directly onto the ACP wire's `McpServerStdio` / `McpServerHttp` /
- * `McpServerSse` shapes (see acp-factory `createSession({ mcpServers })`).
- */
-export type MCPServerConfig = MCPServerStdioConfig | MCPServerHttpConfig;
-
-/** Stdio transport (legacy default — preserved for M0 compatibility). */
-export interface MCPServerStdioConfig {
-  name: string;
-  /** Optional transport discriminant; absent means stdio. */
-  type?: "stdio";
-  command: string;
-  args?: string[];
-  env?: Record<string, string>;
-}
-
-/** HTTP (streamable-http) or SSE transport for a remote MCP server. */
-export interface MCPServerHttpConfig {
-  name: string;
-  type: "http" | "sse";
-  /** URL to the remote MCP server. */
-  url: string;
-  /** HTTP headers to set on requests to the server. */
-  headers?: Record<string, string>;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Spawned Agent Result
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Result of spawning an agent
- */
-export interface SpawnedAgent {
-  /** Agent ID */
-  id: AgentId;
-
-  /** Session ID from acp-factory */
-  session_id: string;
-
-  /** Agent state from materialized view */
-  agent: Agent;
-
-  /** Active session for interaction */
-  session: Session;
-
-  /** Workspace assigned to the agent (if any) */
-  workspace?: Workspace;
-
-  /** Stream ID the agent belongs to (if any) */
-  streamId?: StreamId;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Query Types
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Filter options for listing agents
- */
-export interface AgentFilter {
-  /** Filter by state */
-  state?: AgentState;
-
-  /** Filter by parent */
-  parent?: AgentId | null;
-
-  /** Filter by task ID */
-  task_id?: TaskId;
-
-  /** Only head managers (no parent) */
-  headManagersOnly?: boolean;
-}
-
-/**
- * Agent hierarchy node
- */
-export interface AgentHierarchyNode {
-  agent: Agent;
-  children: AgentHierarchyNode[];
-}
-
-/**
- * Full agent hierarchy from root
- */
-export interface AgentHierarchy {
-  root: AgentHierarchyNode;
-  depth: number;
-  totalAgents: number;
-}
-
-/**
- * Options for getHierarchy
- */
-export interface HierarchyOptions {
-  /** Maximum depth to traverse (undefined = full tree) */
-  depth?: number;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Session Management
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Active session info tracked in memory
- */
-export interface ActiveSession {
-  /** Agent ID */
-  agentId: AgentId;
-
-  /** acp-factory agent handle (process) */
-  handle: AgentHandle;
-
-  /** acp-factory session */
-  session: Session;
-
-  /** When the session was created */
-  createdAt: Timestamp;
-
-  /** Whether session is currently prompting */
-  isPrompting: boolean;
-}
-
-/**
- * Stop reason for agent termination
- * Named AgentStopReason to avoid conflict with ACP SDK's StopReason
- */
-export type AgentStopReason =
-  | "completed" // Task finished successfully
-  | "failed" // Task failed with error
-  | "cancelled" // Manually cancelled
-  | "timeout" // Exceeded time limit
-  | "parent_stopped" // Parent agent was stopped
-  | "system"; // System shutdown
-
-// ─────────────────────────────────────────────────────────────────
-// Head Manager
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Options for creating a head manager
- */
-export interface HeadManagerOptions {
-  /** Working directory */
-  cwd: string;
-
-  /** Optional custom system prompt */
-  systemPrompt?: string;
-
-  /** Permission mode */
-  permissionMode?: PermissionMode;
-
-  /** Initial topics to subscribe to */
-  topics?: string[];
-
-  /** Resume a specific session by ID */
-  sessionId?: string;
-
-  /** Force creation of a new session, ignoring existing ones */
-  forceNew?: boolean;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// System Prompt
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Context for generating system prompts
- */
-export interface SystemPromptContext {
-  /** Agent ID */
-  agentId: AgentId;
-
-  /** Task description */
-  task: string;
-
-  /** Task ID if assigned */
-  taskId?: TaskId;
-
-  /** Parent agent ID */
-  parentId?: AgentId | null;
-
-  /** Whether this is a head manager */
-  isHeadManager: boolean;
-
-  /** Agent lineage (ancestors) */
-  lineage: AgentId[];
-
-  /** Available MCP tools */
-  mcpTools?: string[];
-
-  // ─────────────────────────────────────────────────────────────────
-  // Workspace-related context (Phase 2)
-  // ─────────────────────────────────────────────────────────────────
-
-  /** Agent role name (e.g., 'worker', 'coordinator') */
-  role?: string;
-
-  /** Workspace assigned to the agent */
-  workspace?: Workspace;
-
-  /** Stream ID the agent belongs to */
-  streamId?: StreamId;
-}
-
-/**
- * System prompt template parts
- */
-export interface SystemPromptTemplate {
-  /** Role description */
-  role: string;
-
-  /** Task context */
-  taskContext: string;
-
-  /** Available tools */
-  toolsSection: string;
-
-  /** Communication instructions */
-  communicationSection: string;
-
-  /** Hierarchy context */
-  hierarchySection: string;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Events
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Agent lifecycle events (for callbacks)
- */
-export type AgentLifecycleEvent =
-  | { type: "spawned"; agent: Agent }
-  | { type: "started"; agent: Agent }
-  | { type: "stopped"; agent: Agent; reason: AgentStopReason }
-  | { type: "status"; agent: Agent; status: string };
-
-/**
- * Callback for agent lifecycle events
- */
-export type AgentLifecycleCallback = (event: AgentLifecycleEvent) => void;
-
-// ─────────────────────────────────────────────────────────────────
-// Error Types
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Agent manager error
- */
-export class AgentManagerError extends Error {
-  constructor(
-    message: string,
-    public readonly code: AgentManagerErrorCode,
-    public readonly agentId?: AgentId
-  ) {
-    super(message);
-    this.name = "AgentManagerError";
-  }
-}
-
-export type AgentManagerErrorCode =
-  | "AGENT_NOT_FOUND"
-  | "SESSION_NOT_FOUND"
-  | "SPAWN_FAILED"
-  | "ALREADY_RUNNING"
-  | "NOT_RUNNING"
-  | "INVALID_STATE"
-  | "PERMISSION_DENIED"
-  | "CAPABILITY_DENIED"
-  | "SHUTDOWN_IN_PROGRESS"
-  | "FORK_NOT_SUPPORTED";