macro-agent 0.2.4 → 0.2.6

package/src/mcp/types.ts

@@ -1,432 +0,0 @@
-/**
- * MCP Server type definitions for multi-agent tools
- */
-
-import type { AgentId, TaskId } from "../store/types/index.js";
-
-// ─────────────────────────────────────────────────────────────────
-// Tool Context
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * Context injected into every tool handler.
- * Identifies the calling agent and their session.
- */
-export interface ToolContext {
-  /** ID of the agent making the tool call */
-  agent_id: AgentId;
-
-  /** Session ID from acp-factory */
-  session_id: string;
-
-  /** Task ID the agent is working on */
-  task_id?: TaskId;
-
-  /** Agent's lineage (ancestors) for authorization checks */
-  lineage: AgentId[];
-
-  /** Working directory for the agent */
-  cwd: string;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Tool Input Types
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * spawn_agent tool input
- */
-export interface SpawnAgentInput {
-  /** Task description for the child agent */
-  task: string;
-
-  /** Whether parent subscribes to child's subtree (default: true) */
-  subscribe_parent?: boolean;
-
-  /** Additional topics for child to subscribe to */
-  topics?: string[];
-
-  /** Custom config for the child agent */
-  config?: {
-    model?: string;
-    maxTokens?: number;
-    temperature?: number;
-  };
-
-  /** Working directory for the spawned agent (defaults to parent's cwd) */
-  cwd?: string;
-}
-
-/**
- * emit_status tool input
- */
-export interface EmitStatusInput {
-  /** Type of status update */
-  status_type: "started" | "checkpoint" | "completed" | "failed" | "blocked";
-
-  /** Human-readable summary */
-  summary: string;
-
-  /** Additional structured details */
-  details?: Record<string, unknown>;
-
-  /** If true and status_type is 'completed', also mark task as completed */
-  complete_task?: boolean;
-}
-
-/**
- * send_message tool input
- */
-export interface SendMessageInput {
-  /** Message target */
-  to: {
-    agent_id?: AgentId;
-    task_id?: TaskId;
-    topic?: string;
-  };
-
-  /** Message content */
-  content: string;
-
-  /** Optional correlation ID for threading */
-  correlation_id?: string;
-
-  /** Message priority */
-  priority?: "normal" | "high" | "low";
-}
-
-/**
- * check_messages tool input
- */
-export interface CheckMessagesInput {
-  /** Maximum number of messages to return (default: 10) */
-  limit?: number;
-
-  /** Include acknowledged messages */
-  include_acknowledged?: boolean;
-}
-
-/**
- * query_index tool input
- */
-export interface QueryIndexInput {
-  /** Type of entities to search */
-  type: "agents" | "tasks" | "all";
-
-  /** Filter criteria */
-  filter?: {
-    /** For agents: filter by state */
-    state?: "running" | "stopped" | "spawning";
-
-    /** For tasks: filter by status */
-    status?: "pending" | "assigned" | "in_progress" | "completed" | "failed";
-
-    /** For agents: filter by parent */
-    parent?: AgentId | null;
-  };
-
-  /** Text search query */
-  search?: string;
-
-  /** Maximum results (default: 20) */
-  limit?: number;
-
-  /** Offset for pagination */
-  offset?: number;
-}
-
-/**
- * get_hierarchy tool input
- */
-export interface GetHierarchyInput {
-  /** Root agent ID (defaults to caller's hierarchy root) */
-  root?: AgentId;
-
-  /** Maximum depth to traverse (default: unlimited) */
-  depth?: number;
-}
-
-/**
- * get_agent_summary tool input
- */
-export interface GetAgentSummaryInput {
-  /** Agent ID to look up */
-  agent_id: AgentId;
-}
-
-/**
- * stop_agent tool input
- */
-export interface StopAgentInput {
-  /** Agent ID to stop (must be in caller's subtree) */
-  agent_id: AgentId;
-
-  /** Reason for stopping */
-  reason?: "completed" | "failed" | "cancelled";
-}
-
-/**
- * create_task tool input
- */
-export interface CreateTaskInput {
-  /** Task description */
-  description: string;
-
-  /** Parent task ID for subtasks */
-  parent_task?: TaskId;
-
-  /** Initial inputs for the task */
-  inputs?: Record<string, unknown>;
-}
-
-/**
- * get_task tool input
- */
-export interface GetTaskInput {
-  /** Task ID to look up */
-  task_id: TaskId;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Tool Output Types
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * spawn_agent tool output
- */
-export interface SpawnAgentOutput {
-  agent_id: AgentId;
-  name?: string;
-  task_id: TaskId;
-  session_id: string;
-}
-
-/**
- * emit_status tool output
- */
-export interface EmitStatusOutput {
-  event_id: string;
-  task_updated?: boolean;
-}
-
-/**
- * send_message tool output
- */
-export interface SendMessageOutput {
-  message_id: string;
-  delivered_to: number;
-}
-
-/**
- * check_messages tool output
- */
-export interface CheckMessagesOutput {
-  messages: Array<{
-    id: string;
-    from: AgentId;
-    from_name?: string;
-    content: string;
-    timestamp: number;
-    truncated: boolean;
-    correlation_id?: string;
-    priority?: string;
-  }>;
-  total_pending: number;
-}
-
-/**
- * query_index tool output
- */
-export interface QueryIndexOutput {
-  entries: Array<{
-    type: "agent" | "task";
-    id: string;
-    name?: string;
-    summary: string;
-    state?: string;
-    status?: string;
-  }>;
-  total: number;
-  has_more: boolean;
-}
-
-/**
- * get_hierarchy tool output
- */
-export interface GetHierarchyOutput {
-  tree: HierarchyNode;
-  depth: number;
-  total_agents: number;
-}
-
-export interface HierarchyNode {
-  agent_id: AgentId;
-  name?: string;
-  task: string;
-  state: string;
-  children: HierarchyNode[];
-}
-
-/**
- * get_agent_summary tool output
- */
-export interface GetAgentSummaryOutput {
-  id: AgentId;
-  name?: string;
-  session_id: string;
-  task: string;
-  state: string;
-  parent: AgentId | null;
-  children_count: number;
-  last_activity: number;
-  recent_status?: {
-    type: string;
-    summary: string;
-    timestamp: number;
-  };
-}
-
-/**
- * stop_agent tool output
- */
-export interface StopAgentOutput {
-  success: boolean;
-  stopped_agents: Array<{ agent_id: AgentId; name?: string }>;
-}
-
-/**
- * create_task tool output
- */
-export interface CreateTaskOutput {
-  task_id: TaskId;
-}
-
-/**
- * get_task tool output
- */
-export interface GetTaskOutput {
-  id: TaskId;
-  description: string;
-  status: string;
-  assigned_agent?: AgentId;
-  parent_task?: TaskId;
-  subtasks: TaskId[];
-  inputs?: Record<string, unknown>;
-  outputs?: Record<string, unknown>;
-  artifacts?: Array<{ name: string; path: string }>;
-  created_at: number;
-  updated_at: number;
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Error Types
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * MCP tool error
- */
-export class MCPToolError extends Error {
-  constructor(
-    message: string,
-    public readonly code: MCPToolErrorCode,
-    public readonly details?: Record<string, unknown>
-  ) {
-    super(message);
-    this.name = "MCPToolError";
-  }
-}
-
-export type MCPToolErrorCode =
-  | "AGENT_NOT_FOUND"
-  | "TASK_NOT_FOUND"
-  | "PERMISSION_DENIED"
-  | "INVALID_INPUT"
-  | "SPAWN_FAILED"
-  | "ROUTING_FAILED"
-  | "NOT_IN_SUBTREE"
-  | "NO_PEER_TRANSPORT"
-  | "PEER_REQUEST_NOT_FOUND"
-  | "WAIT_FAILED";
-
-// ─────────────────────────────────────────────────────────────────
-// Peer Communication Tool Types
-// ─────────────────────────────────────────────────────────────────
-
-/**
- * send_peer_message tool input
- */
-export interface SendPeerMessageInput {
-  /** Target peer address ("peerId" or "peerId/agentId") */
-  to: string;
-
-  /** Message type for routing */
-  type: string;
-
-  /** Message payload */
-  payload: unknown;
-
-  /** Optional correlation ID for relating messages */
-  correlation_id?: string;
-}
-
-/**
- * send_peer_message tool output
- */
-export interface SendPeerMessageOutput {
-  success: boolean;
-  timestamp: number;
-}
-
-/**
- * send_peer_request tool input
- */
-export interface SendPeerRequestInput {
-  /** Target peer address ("peerId" or "peerId/agentId") */
-  to: string;
-
-  /** Request method name */
-  method: string;
-
-  /** Request parameters */
-  params?: unknown;
-
-  /** Timeout hint in milliseconds */
-  timeout?: number;
-}
-
-/**
- * send_peer_request tool output
- */
-export interface SendPeerRequestOutput {
-  result?: unknown;
-  error?: {
-    code: number;
-    message: string;
-    data?: unknown;
-  };
-}
-
-/**
- * respond_to_peer_request tool input
- */
-export interface RespondToPeerRequestInput {
-  /** Request ID to respond to */
-  request_id: string;
-
-  /** Success result (mutually exclusive with error) */
-  result?: unknown;
-
-  /** Error response (mutually exclusive with result) */
-  error?: {
-    code: number;
-    message: string;
-    data?: unknown;
-  };
-}
-
-/**
- * respond_to_peer_request tool output
- */
-export interface RespondToPeerRequestOutput {
-  success: boolean;
-}

package/src/metrics/__tests__/metrics.test.ts

@@ -1,205 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-import { collectMetrics } from "../metrics.js";
-import type { MacroAgentSystemV2 } from "../../boot-v2.js";
-import type { AgentRecord } from "../../agent/agent-store.js";
-
-// ─────────────────────────────────────────────────────────────────
-// Helpers
-// ─────────────────────────────────────────────────────────────────
-
-function makeAgent(
-  overrides: Partial<AgentRecord> & { id: string; role: string; state: string }
-): AgentRecord {
-  return {
-    parent_id: null,
-    lineage: [],
-    scope: "default",
-    task: "test",
-    cwd: "/tmp",
-    capabilities: [],
-    created_at: Date.now(),
-    ...overrides,
-  } as AgentRecord;
-}
-
-function createMockSystem(
-  overrides: {
-    agents?: AgentRecord[];
-    unhealthy?: Array<{ agentId: string; lastSeen: number; pid: number }>;
-    tasksConnected?: boolean;
-    tasks?: Array<{ id: string; status: string }>;
-    readyTasks?: Array<{ id: string; status: string }>;
-    agentsWithEvents?: string[];
-    cronJobs?: unknown[];
-  } = {}
-): MacroAgentSystemV2 {
-  const {
-    agents = [],
-    unhealthy = [],
-    tasksConnected = false,
-    tasks = [],
-    readyTasks = [],
-    agentsWithEvents = [],
-    cronJobs = [],
-  } = overrides;
-
-  return {
-    agentManager: {} as any,
-    agentStore: {
-      listAgents: vi.fn().mockReturnValue(agents),
-    } as any,
-    inboxAdapter: {} as any,
-    tasksAdapter: {
-      connected: tasksConnected,
-      listTasks: vi.fn().mockResolvedValue(tasks),
-      queryReady: vi.fn().mockResolvedValue(readyTasks),
-    } as any,
-    triggerSystem: {
-      queue: {
-        getAgentsWithEvents: vi.fn().mockReturnValue(agentsWithEvents),
-      },
-      cronService: {
-        list: vi.fn().mockResolvedValue(cronJobs),
-      },
-    } as any,
-    controlServer: {
-      getUnhealthyAgents: vi.fn().mockReturnValue(unhealthy),
-    } as any,
-    roleRegistry: {} as any,
-    controlSocketPath: "/tmp/control.sock",
-    shutdown: vi.fn(),
-  };
-}
-
-// ─────────────────────────────────────────────────────────────────
-// Tests
-// ─────────────────────────────────────────────────────────────────
-
-describe("collectMetrics", () => {
-  const START_TIME = Date.now() - 10_000; // 10s ago
-
-  it("returns correct agent counts by state", async () => {
-    const system = createMockSystem({
-      agents: [
-        makeAgent({ id: "a1", role: "worker", state: "running" }),
-        makeAgent({ id: "a2", role: "worker", state: "running" }),
-        makeAgent({ id: "a3", role: "worker", state: "running" }),
-        makeAgent({ id: "a4", role: "coordinator", state: "stopped" }),
-        makeAgent({ id: "a5", role: "coordinator", state: "stopped" }),
-      ],
-    });
-
-    const snapshot = await collectMetrics(system, START_TIME);
-
-    expect(snapshot.agents.total).toBe(5);
-    expect(snapshot.agents.byState).toEqual({
-      running: 3,
-      stopped: 2,
-    });
-  });
-
-  it("returns correct agent counts by role", async () => {
-    const system = createMockSystem({
-      agents: [
-        makeAgent({ id: "a1", role: "worker", state: "running" }),
-        makeAgent({ id: "a2", role: "worker", state: "running" }),
-        makeAgent({ id: "a3", role: "coordinator", state: "running" }),
-      ],
-    });
-
-    const snapshot = await collectMetrics(system, START_TIME);
-
-    expect(snapshot.agents.byRole).toEqual({
-      worker: 2,
-      coordinator: 1,
-    });
-  });
-
-  it("returns correct agent counts by team", async () => {
-    const system = createMockSystem({
-      agents: [
-        makeAgent({ id: "a1", role: "worker", state: "running", team: "alpha" }),
-        makeAgent({ id: "a2", role: "worker", state: "running", team: "alpha" }),
-        makeAgent({ id: "a3", role: "worker", state: "running", team: "beta" }),
-        makeAgent({ id: "a4", role: "coordinator", state: "running" }), // no team
-      ],
-    });
-
-    const snapshot = await collectMetrics(system, START_TIME);
-
-    expect(snapshot.agents.byTeam).toEqual({
-      alpha: 2,
-      beta: 1,
-    });
-  });
-
-  it("returns unhealthy count from control server", async () => {
-    const system = createMockSystem({
-      agents: [
-        makeAgent({ id: "a1", role: "worker", state: "running" }),
-      ],
-      unhealthy: [
-        { agentId: "a1", lastSeen: Date.now() - 120_000, pid: 1234 },
-        { agentId: "a2", lastSeen: Date.now() - 90_000, pid: 5678 },
-      ],
-    });
-
-    const snapshot = await collectMetrics(system, START_TIME);
-
-    expect(snapshot.agents.unhealthy).toBe(2);
-  });
-
-  it("returns task metrics when opentasks is available", async () => {
-    const system = createMockSystem({
-      tasksConnected: true,
-      tasks: [
-        { id: "t1", status: "open" },
-        { id: "t2", status: "open" },
-        { id: "t3", status: "in_progress" },
-        { id: "t4", status: "blocked" },
-        { id: "t5", status: "closed" },
-      ],
-      readyTasks: [
-        { id: "t1", status: "open" },
-        { id: "t2", status: "open" },
-      ],
-    });
-
-    const snapshot = await collectMetrics(system, START_TIME);
-
-    expect(snapshot.tasks).not.toBeNull();
-    expect(snapshot.tasks!.byStatus).toEqual({
-      open: 2,
-      in_progress: 1,
-      blocked: 1,
-      closed: 1,
-    });
-    expect(snapshot.tasks!.ready).toBe(2);
-    expect(snapshot.tasks!.blocked).toBe(1);
-  });
-
-  it("returns tasks: null when opentasks is unavailable", async () => {
-    const system = createMockSystem({
-      tasksConnected: false,
-    });
-
-    const snapshot = await collectMetrics(system, START_TIME);
-
-    expect(snapshot.tasks).toBeNull();
-  });
-
-  it("returns system uptime and queue depth", async () => {
-    const system = createMockSystem({
-      agentsWithEvents: ["a1", "a2", "a3"],
-      cronJobs: [{}, {}, {}], // 3 cron jobs
-    });
-
-    const snapshot = await collectMetrics(system, START_TIME);
-
-    // Uptime should be approximately 10_000ms (with some tolerance)
-    expect(snapshot.system.uptime).toBeGreaterThanOrEqual(9_900);
-    expect(snapshot.system.uptime).toBeLessThan(15_000);
-    expect(snapshot.system.triggerQueueDepth).toBe(3);
-    expect(snapshot.system.cronJobCount).toBe(3);
-  });
-});

package/src/metrics/index.ts

@@ -1,13 +0,0 @@
-/**
- * Metrics module — observability for macro-agent.
- *
- * @module metrics
- */
-
-export { collectMetrics } from "./metrics.js";
-export type {
-  AgentMetrics,
-  TaskMetrics,
-  SystemMetrics,
-  MetricsSnapshot,
-} from "./types.js";