macro-agent 0.1.2 → 0.1.4

package/dist/trigger/trigger-system.d.ts

@@ -1,77 +0,0 @@
-/**
- * Trigger System Factory
- *
- * Factory function that creates and wires together all
- * trigger system components.
- *
- * @module trigger/trigger-system
- */
-import type { EventStore } from "../store/event-store.js";
-import type { AgentManager } from "../agent/agent-manager.js";
-import type { MessageRouter } from "../router/message-router.js";
-import { type SystemEventQueue } from "./queue/index.js";
-import { type TriggerRouter, type TriggerRouterConfig } from "./router/index.js";
-import { type TriggerWakeManager, type WakeManagerConfig } from "./wake/index.js";
-import { type CronService, type CronServiceConfig } from "./sources/cron/index.js";
-import { type WebhookHandler, type WebhookHandlerConfig } from "./sources/webhook/index.js";
-/**
- * Trigger system configuration
- */
-export interface TriggerSystemConfig {
-    /** System event queue configuration */
-    queue?: {
-        maxEventsPerAgent?: number;
-    };
-    /** Trigger router configuration */
-    router?: TriggerRouterConfig;
-    /** Wake manager configuration */
-    wake?: WakeManagerConfig;
-    /** Cron service configuration */
-    cron?: CronServiceConfig;
-    /** Webhook handler configuration */
-    webhook?: WebhookHandlerConfig;
-    /** Enable AI routing strategy */
-    enableAIRouter?: boolean;
-}
-/**
- * Dependencies for the trigger system
- */
-export interface TriggerSystemDeps {
-    eventStore: EventStore;
-    agentManager: AgentManager;
-    messageRouter: MessageRouter;
-}
-/**
- * Trigger system interface
- *
- * Provides access to all trigger system components.
- */
-export interface TriggerSystem {
-    /** System event queue */
-    readonly queue: SystemEventQueue;
-    /** Trigger router */
-    readonly router: TriggerRouter;
-    /** Wake manager */
-    readonly wakeManager: TriggerWakeManager;
-    /** Cron service */
-    readonly cronService: CronService;
-    /** Webhook handler */
-    readonly webhookHandler: WebhookHandler;
-    /**
-     * Start the trigger system
-     */
-    start(): Promise<void>;
-    /**
-     * Stop the trigger system
-     */
-    stop(): Promise<void>;
-    /**
-     * Check if system is running
-     */
-    isRunning(): boolean;
-}
-/**
- * Create a trigger system with all components wired together
- */
-export declare function createTriggerSystem(deps: TriggerSystemDeps, config?: TriggerSystemConfig): TriggerSystem;
-//# sourceMappingURL=trigger-system.d.ts.map

package/dist/trigger/trigger-system.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"trigger-system.d.ts","sourceRoot":"","sources":["../../src/trigger/trigger-system.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAE1B,MAAM,4BAA4B,CAAC;AAMpC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,KAAK,CAAC,EAAE;QACN,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,mCAAmC;IACnC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,iCAAiC;IACjC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,iCAAiC;IACjC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,iCAAiC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,UAAU,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;CAC9B;AAMD;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,mBAAmB;IACnB,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,mBAAmB;IACnB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,sBAAsB;IACtB,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;CACtB;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,iBAAiB,EACvB,MAAM,GAAE,mBAAwB,GAC/B,aAAa,CAuFf"}

package/dist/trigger/trigger-system.js

@@ -1,84 +0,0 @@
-/**
- * Trigger System Factory
- *
- * Factory function that creates and wires together all
- * trigger system components.
- *
- * @module trigger/trigger-system
- */
-import { createSystemEventQueue } from "./queue/index.js";
-import { createTriggerRouter, createAIRouterStrategy, } from "./router/index.js";
-import { createWakeManager, } from "./wake/index.js";
-import { createCronService, } from "./sources/cron/index.js";
-import { createWebhookHandler, } from "./sources/webhook/index.js";
-// =============================================================================
-// Trigger System Factory
-// =============================================================================
-/**
- * Create a trigger system with all components wired together
- */
-export function createTriggerSystem(deps, config = {}) {
-    let running = false;
-    // Create system event queue
-    const queue = createSystemEventQueue({
-        maxEventsPerAgent: config.queue?.maxEventsPerAgent,
-    });
-    // Create trigger router
-    const router = createTriggerRouter({
-        eventStore: deps.eventStore,
-        agentManager: deps.agentManager,
-        messageRouter: deps.messageRouter,
-        systemEventQueue: queue,
-    }, config.router);
-    // Create wake manager
-    const wakeManager = createWakeManager({
-        agentManager: deps.agentManager,
-        systemEventQueue: queue,
-    }, config.wake);
-    // Create cron service
-    const cronService = createCronService({
-        triggerRouter: router,
-        wakeManager,
-    }, config.cron);
-    // Create webhook handler
-    const webhookHandler = createWebhookHandler({
-        triggerRouter: router,
-        wakeManager,
-    }, config.webhook);
-    // Register AI router strategy if enabled
-    if (config.enableAIRouter) {
-        const aiRouterStrategy = createAIRouterStrategy({
-            enableLogging: true,
-        });
-        router.registerStrategy(aiRouterStrategy);
-    }
-    return {
-        queue,
-        router,
-        wakeManager,
-        cronService,
-        webhookHandler,
-        async start() {
-            if (running)
-                return;
-            // Start components in order
-            await router.start();
-            wakeManager.start();
-            await cronService.start();
-            running = true;
-        },
-        async stop() {
-            if (!running)
-                return;
-            // Stop components in reverse order
-            await cronService.stop();
-            wakeManager.stop();
-            await router.stop();
-            running = false;
-        },
-        isRunning() {
-            return running;
-        },
-    };
-}
-//# sourceMappingURL=trigger-system.js.map

package/dist/trigger/trigger-system.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"trigger-system.js","sourceRoot":"","sources":["../../src/trigger/trigger-system.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,sBAAsB,EAAyB,MAAM,kBAAkB,CAAC;AACjF,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GAGvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,GAGlB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,GAIlB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,oBAAoB,GAIrB,MAAM,4BAA4B,CAAC;AAwEpC,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAuB,EACvB,SAA8B,EAAE;IAEhC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,4BAA4B;IAC5B,MAAM,KAAK,GAAG,sBAAsB,CAAC;QACnC,iBAAiB,EAAE,MAAM,CAAC,KAAK,EAAE,iBAAiB;KACnD,CAAC,CAAC;IAEH,wBAAwB;IACxB,MAAM,MAAM,GAAG,mBAAmB,CAChC;QACE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,gBAAgB,EAAE,KAAK;KACxB,EACD,MAAM,CAAC,MAAM,CACd,CAAC;IAEF,sBAAsB;IACtB,MAAM,WAAW,GAAG,iBAAiB,CACnC;QACE,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,gBAAgB,EAAE,KAAK;KACxB,EACD,MAAM,CAAC,IAAI,CACZ,CAAC;IAEF,sBAAsB;IACtB,MAAM,WAAW,GAAG,iBAAiB,CACnC;QACE,aAAa,EAAE,MAAM;QACrB,WAAW;KACZ,EACD,MAAM,CAAC,IAAI,CACZ,CAAC;IAEF,yBAAyB;IACzB,MAAM,cAAc,GAAG,oBAAoB,CACzC;QACE,aAAa,EAAE,MAAM;QACrB,WAAW;KACZ,EACD,MAAM,CAAC,OAAO,CACf,CAAC;IAEF,yCAAyC;IACzC,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;YAC9C,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QACH,MAAM,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO;QACL,KAAK;QACL,MAAM;QACN,WAAW;QACX,WAAW;QACX,cAAc;QAEd,KAAK,CAAC,KAAK;YACT,IAAI,OAAO;gBAAE,OAAO;YAEpB,4BAA4B;YAC5B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,WAAW,CAAC,KAAK,EAAE,CAAC;YACpB,MAAM,WAAW,CAAC,KAAK,EAAE,CAAC;YAE1B,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI;YACR,IAAI,CAAC,OAAO;gBAAE,OAAO;YAErB,mCAAmC;YACnC,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAEpB,OAAO,GAAG,KAAK,CAAC;QAClB,CAAC;QAED,SAAS;YACP,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/references/acp-factory-ref/CHANGELOG.md

@@ -1,33 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [0.1.0] - 2024-XX-XX
-
-### Added
-
-- Initial release
-- `AgentFactory` for registering and spawning agents
-- `AgentHandle` for managing agent processes
-- `Session` for interacting with agent sessions
-- Pre-registered `claude-code` agent
-- Streaming responses via async iterators
-- Permission handling modes: `auto-approve`, `auto-deny`, `callback`, `interactive`
-- Interactive permission requests as session updates
-- `session.interruptWith()` for interrupting and redirecting agents
-- `session.fork()` for creating independent session copies (experimental)
-- `agentHandle.forkSession()` for forking by session ID (experimental)
-- `session.addContext()` stub for future mid-execution messaging
-- Custom file read/write handlers
-- Terminal operation handlers
-- MCP server support
-- Full TypeScript type exports
-
-### Dependencies
-
-- `@agentclientprotocol/sdk` ^0.10.0

package/references/acp-factory-ref/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Sudocode AI
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/references/acp-factory-ref/README.md

@@ -1,341 +0,0 @@
-# acp-factory
-
-A TypeScript library for spawning and managing AI agents through the [Agent Client Protocol (ACP)](https://agentclientprotocol.com/).
-
-## Installation
-
-```bash
-npm install acp-factory
-```
-
-## Prerequisites
-
-- Node.js 18+
-- [Claude Code](https://claude.ai/claude-code) installed and authenticated (run `claude` once to set up)
-- Or set `ANTHROPIC_API_KEY` environment variable
-
-## Quick Start
-
-```typescript
-import { AgentFactory } from "acp-factory";
-
-// Spawn a Claude Code agent
-const agent = await AgentFactory.spawn("claude-code", {
-  permissionMode: "auto-approve",
-});
-
-// Create a session
-const session = await agent.createSession(process.cwd());
-
-// Send a prompt and stream responses
-for await (const update of session.prompt("What files are in this directory?")) {
-  if (update.sessionUpdate === "agent_message_chunk") {
-    if (update.content.type === "text") {
-      process.stdout.write(update.content.text);
-    }
-  }
-}
-
-// Clean up
-await agent.close();
-```
-
-## API Reference
-
-### AgentFactory
-
-Static class for managing agent types and spawning agents.
-
-```typescript
-// List available agents
-AgentFactory.listAgents(); // ["claude-code"]
-
-// Register a custom agent
-AgentFactory.register("my-agent", {
-  command: "npx",
-  args: ["my-agent-acp"],
-  env: { MY_VAR: "value" },
-});
-
-// Spawn an agent
-const agent = await AgentFactory.spawn("claude-code", options);
-```
-
-### AgentHandle
-
-Represents a running agent process.
-
-```typescript
-// Agent capabilities
-agent.capabilities; // { loadSession: true, ... }
-
-// Create a new session
-const session = await agent.createSession("/path/to/cwd", {
-  mode: "code",           // Optional: initial mode
-  mcpServers: [],         // Optional: MCP servers to connect
-});
-
-// Load an existing session
-const session = await agent.loadSession(sessionId, "/path/to/cwd");
-
-// Fork an existing session (experimental)
-const forkedSession = await agent.forkSession(sessionId);
-
-// Close the agent
-await agent.close();
-
-// Check if running
-agent.isRunning(); // true/false
-```
-
-### Session
-
-High-level interface for interacting with an agent session.
-
-```typescript
-// Session properties
-session.id;      // Session ID
-session.modes;   // Available modes ["code", "ask", ...]
-session.models;  // Available models ["claude-sonnet-4-...", ...]
-
-// Send a prompt (returns async iterable)
-for await (const update of session.prompt("Hello!")) {
-  // Handle updates
-}
-
-// Cancel the current prompt
-await session.cancel();
-
-// Set the session mode
-await session.setMode("ask");
-
-// Interrupt and redirect with new context
-for await (const update of session.interruptWith("Focus on tests only")) {
-  // Handle updates from new prompt
-}
-
-// Fork the session (experimental)
-const forkedSession = await session.fork();
-```
-
-## Session Updates
-
-The `prompt()` method yields `SessionUpdate` objects:
-
-```typescript
-for await (const update of session.prompt("Hello")) {
-  switch (update.sessionUpdate) {
-    case "agent_message_chunk":
-      // Text or image content from the agent
-      if (update.content.type === "text") {
-        process.stdout.write(update.content.text);
-      }
-      break;
-
-    case "tool_call":
-      // Agent is calling a tool
-      console.log(`Tool: ${update.title}`);
-      break;
-
-    case "tool_call_update":
-      // Tool call status changed
-      if (update.status === "completed") {
-        console.log("Tool completed");
-      }
-      break;
-
-    case "agent_thought_chunk":
-      // Agent's thinking (if enabled)
-      break;
-  }
-}
-```
-
-## Permission Modes
-
-Control how permission requests are handled:
-
-```typescript
-// Auto-approve all requests (default)
-await AgentFactory.spawn("claude-code", {
-  permissionMode: "auto-approve",
-});
-
-// Auto-deny all requests
-await AgentFactory.spawn("claude-code", {
-  permissionMode: "auto-deny",
-});
-
-// Use a callback handler
-await AgentFactory.spawn("claude-code", {
-  permissionMode: "callback",
-  onPermissionRequest: async (request) => {
-    // Return permission response
-    return {
-      outcome: { outcome: "selected", optionId: "allow" },
-    };
-  },
-});
-
-// Interactive mode - permissions emitted as session updates
-await AgentFactory.spawn("claude-code", {
-  permissionMode: "interactive",
-});
-```
-
-### Interactive Permissions
-
-With `permissionMode: "interactive"`, permission requests appear as session updates:
-
-```typescript
-import { type ExtendedSessionUpdate } from "acp-factory";
-
-for await (const update of session.prompt("Write a file")) {
-  if (update.sessionUpdate === "permission_request") {
-    // Show options to user
-    console.log(`Permission needed: ${update.toolCall.title}`);
-    update.options.forEach((opt, i) => {
-      console.log(`${i + 1}. ${opt.name}`);
-    });
-
-    // Respond to the request
-    session.respondToPermission(update.requestId, update.options[0].optionId);
-    // Or cancel it
-    // session.cancelPermission(update.requestId);
-  }
-}
-```
-
-## Interrupting and Redirecting
-
-Interrupt an agent mid-execution and redirect with new context:
-
-```typescript
-const promptIterator = session.prompt("Analyze this codebase")[Symbol.asyncIterator]();
-
-while (true) {
-  const { done, value } = await promptIterator.next();
-  if (done) break;
-
-  handleUpdate(value);
-
-  if (userWantsToRedirect) {
-    // Interrupt and provide new direction
-    for await (const update of session.interruptWith("Focus only on the tests")) {
-      handleUpdate(update);
-    }
-    break;
-  }
-}
-```
-
-## Forking Sessions
-
-Fork a session to create an independent copy with shared history:
-
-```typescript
-// Original session continues normally
-const session = await agent.createSession(process.cwd());
-await consumePrompt(session.prompt("Analyze the codebase"));
-
-// Fork to generate summary without affecting original
-const summarySession = await session.fork();
-for await (const update of summarySession.prompt("Summarize our conversation")) {
-  // This doesn't affect the original session
-}
-
-// Original session can continue independently
-for await (const update of session.prompt("Now implement the feature")) {
-  // Continues from original context
-}
-```
-
-## Custom File and Terminal Handlers
-
-Override default file operations or provide terminal support:
-
-```typescript
-const agent = await AgentFactory.spawn("claude-code", {
-  // Custom file handling
-  onFileRead: async (path) => {
-    return await myCustomRead(path);
-  },
-  onFileWrite: async (path, content) => {
-    await myCustomWrite(path, content);
-  },
-
-  // Terminal support (all handlers required)
-  onTerminalCreate: async (params) => {
-    const id = createTerminal(params.command, params.args);
-    return { terminalId: id };
-  },
-  onTerminalOutput: async (terminalId) => {
-    return getTerminalOutput(terminalId);
-  },
-  onTerminalKill: async (terminalId) => {
-    killTerminal(terminalId);
-  },
-  onTerminalRelease: async (terminalId) => {
-    releaseTerminal(terminalId);
-  },
-  onTerminalWaitForExit: async (terminalId) => {
-    return await waitForExit(terminalId);
-  },
-});
-```
-
-## Examples
-
-See the [examples](./examples) directory:
-
-- [`basic-usage.ts`](./examples/basic-usage.ts) - Simple prompt and response
-- [`interactive-permissions.ts`](./examples/interactive-permissions.ts) - Handle permissions in UI
-- [`interrupt-context.ts`](./examples/interrupt-context.ts) - Interrupt and redirect agent
-
-Run examples with:
-
-```bash
-npx tsx examples/basic-usage.ts
-```
-
-## Type Exports
-
-The library exports all necessary types:
-
-```typescript
-import {
-  // Core classes
-  AgentFactory,
-  AgentHandle,
-  Session,
-
-  // Configuration types
-  type AgentConfig,
-  type SpawnOptions,
-  type SessionOptions,
-  type PermissionMode,
-
-  // Session update types
-  type SessionUpdate,
-  type ExtendedSessionUpdate,
-  type PermissionRequestUpdate,
-
-  // Content types
-  type ContentBlock,
-  type TextContent,
-  type ImageContent,
-
-  // Tool types
-  type ToolCall,
-  type ToolCallUpdate,
-
-  // Permission types
-  type PermissionOption,
-  type RequestPermissionRequest,
-  type RequestPermissionResponse,
-} from "acp-factory";
-```
-
-## License
-
-MIT