macro-agent 0.2.5 → 0.2.6

package/dist/task/backend/types.d.ts

@@ -0,0 +1,297 @@
+/**
+ * Task Backend Interface Types
+ *
+ * Defines the pluggable task backend interface that allows macro-agent's
+ * internal task system to be backed by external task management systems.
+ *
+ * @module task/backend
+ */
+import type { AgentId, TaskId, Timestamp, Task, TaskStatus, ArtifactRef, AgentHistoryEntry } from "../../store/types/index.js";
+export type { Task, TaskStatus, ArtifactRef, AgentHistoryEntry };
+/**
+ * Extended Task type with computed fields and external binding.
+ * Extends the base Task type with additional fields for backend integration.
+ */
+export interface ExtendedTask extends Task {
+    /** True if blocked by dependencies (computed, not stored) */
+    isBlocked?: boolean;
+    /** Binding to external system (e.g., OpenTasks issue ID "i-xxxx") */
+    external_id?: string;
+    /** Source project location (e.g., opentasks path or URI) for federated tasks */
+    source_location?: string;
+}
+/**
+ * Options for creating a new task
+ */
+export interface CreateTaskOptions {
+    /** Task description */
+    description: string;
+    /** Agent creating the task */
+    created_by: AgentId;
+    /** Optional parent task for subtask hierarchy */
+    parent_task?: TaskId;
+    /** Optional binding to external system (e.g., OpenTasks issue ID) */
+    external_id?: string;
+    /** Optional tags for classification and filtering (pull model) */
+    tags?: string[];
+}
+/**
+ * Options for updating task metadata
+ */
+export interface UpdateTaskOptions {
+    /** Update task outputs */
+    outputs?: Record<string, unknown>;
+    /** Add artifacts to task */
+    artifacts?: ArtifactRef[];
+    /** Update description */
+    description?: string;
+    /** Update status */
+    status?: TaskStatus;
+}
+/**
+ * Task outputs on completion
+ */
+export interface TaskOutputs {
+    /** Summary of work done */
+    summary?: string;
+    /** Output data */
+    data?: Record<string, unknown>;
+    /** Artifacts produced */
+    artifacts?: ArtifactRef[];
+}
+/**
+ * Task error on failure
+ */
+export interface TaskError {
+    /** Error message */
+    message: string;
+    /** Error code/type */
+    code?: string;
+    /** Stack trace or additional details */
+    details?: unknown;
+}
+/**
+ * Filter options for listing tasks
+ */
+export interface TaskFilter {
+    /** Filter by status (single or multiple) */
+    status?: TaskStatus | TaskStatus[];
+    /** Filter by assigned agent */
+    assigned_agent?: AgentId;
+    /** Filter by parent task */
+    parent_task?: TaskId;
+    /** Filter by creator */
+    created_by?: AgentId;
+    /** Only root tasks (no parent) */
+    rootTasksOnly?: boolean;
+    /** Include blocked tasks (default: false) */
+    includeBlocked?: boolean;
+    /** Filter tasks assigned before this timestamp (for stale assignment detection) */
+    assignedBefore?: Timestamp;
+    /** Filter by tags (task must have at least one matching tag) */
+    tags?: string[];
+}
+/**
+ * Aggregate status of subtasks
+ */
+export interface SubtaskStatus {
+    total: number;
+    pending: number;
+    assigned: number;
+    in_progress: number;
+    completed: number;
+    failed: number;
+    allCompleted: boolean;
+    anyFailed: boolean;
+}
+/**
+ * Options for assigning a task to an agent
+ */
+export interface AssignOptions {
+    /** Optional role of the agent */
+    role?: string;
+    /** Optional lease timeout in milliseconds (default: none) */
+    leaseMs?: number;
+}
+/**
+ * Filter options for claiming tasks.
+ * Used by the pull model to find eligible tasks for an agent.
+ */
+export interface ClaimFilter {
+    /** Only claim tasks with at least one matching tag */
+    tags?: string[];
+    /** Only claim root tasks (no parent) */
+    rootTasksOnly?: boolean;
+    /** Only claim tasks created by a specific agent */
+    created_by?: AgentId;
+}
+/**
+ * Task change event types
+ */
+export type TaskChangeType = "created" | "updated" | "status_changed" | "assigned" | "unassigned" | "completed" | "failed" | "deleted";
+/**
+ * Task change event
+ */
+export interface TaskChangeEvent {
+    /** Event type */
+    type: TaskChangeType;
+    /** Task ID */
+    taskId: TaskId;
+    /** Current task state */
+    task: ExtendedTask;
+    /** Previous task state (for updates) */
+    previousTask?: ExtendedTask;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Callback for task change events
+ */
+export type TaskChangeCallback = (event: TaskChangeEvent) => void;
+/**
+ * Unsubscribe function
+ */
+export type Unsubscribe = () => void;
+/**
+ * Task Backend Interface
+ *
+ * Abstraction over task storage allowing different implementations:
+ * - InMemoryTaskBackend - Current behavior (default)
+ * - OpenTasksTaskBackend - Backed by OpenTasks graph
+ */
+export interface TaskBackend {
+    /** Gracefully close the backend. After close(), write operations may throw. */
+    close?(): Promise<void>;
+    /** Create a new task */
+    create(options: CreateTaskOptions): Promise<ExtendedTask>;
+    /** Get a task by ID */
+    get(id: TaskId): Promise<ExtendedTask | null>;
+    /** Update task metadata */
+    update(id: TaskId, updates: UpdateTaskOptions): Promise<ExtendedTask>;
+    /** Delete a task */
+    delete(id: TaskId): Promise<void>;
+    /** Assign task to an agent */
+    assign(id: TaskId, agentId: AgentId, options?: AssignOptions): Promise<void>;
+    /** Unassign task from its current agent */
+    unassign(id: TaskId): Promise<void>;
+    /** Start task execution */
+    start(id: TaskId): Promise<void>;
+    /** Complete task with optional outputs */
+    complete(id: TaskId, outputs?: TaskOutputs): Promise<void>;
+    /** Mark task as failed */
+    fail(id: TaskId, error: TaskError): Promise<void>;
+    /** List tasks with optional filter */
+    list(filter?: TaskFilter): Promise<ExtendedTask[]>;
+    /** List tasks that are ready to work on (no blocking dependencies) */
+    listReady(filter?: TaskFilter): Promise<ExtendedTask[]>;
+    /** Get child tasks of a parent */
+    getChildren(parentId: TaskId): Promise<ExtendedTask[]>;
+    /** Get aggregate subtask status */
+    getSubtaskStatus(parentId: TaskId): Promise<SubtaskStatus>;
+    /** Create a subtask under a parent */
+    createSubtask(parentId: TaskId, options: CreateTaskOptions): Promise<ExtendedTask>;
+    /** Add a blocking dependency */
+    addBlocker(taskId: TaskId, blockerId: TaskId): Promise<void>;
+    /** Remove a blocking dependency */
+    removeBlocker(taskId: TaskId, blockerId: TaskId): Promise<void>;
+    /** Get tasks that block this task */
+    getBlockers(taskId: TaskId): Promise<ExtendedTask[]>;
+    /** Get tasks that this task blocks */
+    getBlocking(taskId: TaskId): Promise<ExtendedTask[]>;
+    /**
+     * Claim the next available task matching the filter.
+     * Atomically assigns the task to the agent. Returns null if no matching task
+     * is available or if another agent claimed it first (contention).
+     */
+    claim?(agentId: AgentId, filter?: ClaimFilter): Promise<ExtendedTask | null>;
+    /**
+     * Release a claimed task back to pending status.
+     */
+    unclaim?(taskId: TaskId): Promise<void>;
+    /**
+     * List tasks available for claiming (pending, not blocked, not assigned).
+     */
+    listClaimable?(filter?: ClaimFilter): Promise<ExtendedTask[]>;
+    /** Get agent assignment history for a task */
+    getAgentHistory(taskId: TaskId): Promise<AgentHistoryEntry[]>;
+    /**
+     * Sync a task transition that happened externally (e.g., via opentasks daemon).
+     * Updates the internal store without re-syncing to the external system.
+     * @param externalId - The external system's task ID (e.g., opentasks issue ID)
+     * @param action - The transition action (e.g., "complete", "start", "close")
+     * @param agentId - The agent that performed the transition
+     */
+    syncExternalTransition?(externalId: string, action: string, agentId?: string): Promise<void>;
+    /** Subscribe to all task changes */
+    onTaskChange(callback: TaskChangeCallback): Unsubscribe;
+    /** Subscribe to changes for a specific task */
+    onTaskChange(taskId: TaskId, callback: TaskChangeCallback): Unsubscribe;
+}
+/**
+ * MCP tool definition for task operations
+ */
+export interface MCPToolDefinition {
+    /** Tool name */
+    name: string;
+    /** Tool description */
+    description: string;
+    /** JSON Schema for parameters */
+    schema: Record<string, unknown>;
+    /** Tool handler function */
+    handler: (params: unknown) => Promise<unknown>;
+}
+/**
+ * Task Tool Provider Interface
+ *
+ * Allows backends to define which MCP tools are exposed for task operations.
+ */
+export interface TaskToolProvider {
+    /** Get the MCP tools to expose for task operations */
+    getTools(): MCPToolDefinition[];
+    /** Tools that should NOT be exposed when this provider is active */
+    getExcludedTools?(): string[];
+}
+/**
+ * In-memory backend configuration
+ */
+export interface InMemoryBackendConfig {
+    type: "memory";
+}
+/**
+ * OpenTasks backend configuration
+ */
+export interface OpenTasksBackendConfig {
+    type: "opentasks";
+    /** Path to the OpenTasks daemon socket (auto-discovered if not set) */
+    socketPath?: string;
+    /** Whether to sync status changes to OpenTasks (default: true) */
+    syncStatus?: boolean;
+    /** Source label for issues created by this backend (default: "macro-agent") */
+    sourceLabel?: string;
+    /** Auto-start the central opentasks daemon (default: true) */
+    autoStart?: boolean;
+    /** Central daemon location (default: ~/.multiagent/opentasks) */
+    centralPath?: string;
+    /** Auto-connect project .opentasks/ dirs on agent spawn (default: true) */
+    connectOnSpawn?: boolean;
+}
+/**
+ * Task backend configuration
+ */
+export type TaskBackendConfig = InMemoryBackendConfig | OpenTasksBackendConfig;
+/**
+ * Macro-agent task configuration
+ */
+export interface TaskConfig {
+    /** Task backend configuration */
+    backend: TaskBackendConfig;
+}
+/**
+ * Default task configuration
+ */
+export declare const DEFAULT_TASK_CONFIG: TaskConfig;
+/**
+ * Default OpenTasks backend configuration
+ */
+export declare const DEFAULT_OPENTASKS_CONFIG: Omit<OpenTasksBackendConfig, "type">;
+//# sourceMappingURL=types.d.ts.map

package/dist/task/backend/types.d.ts.map

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

package/dist/task/backend/types.js

@@ -0,0 +1,27 @@
+/**
+ * Task Backend Interface Types
+ *
+ * Defines the pluggable task backend interface that allows macro-agent's
+ * internal task system to be backed by external task management systems.
+ *
+ * @module task/backend
+ */
+// =============================================================================
+// Default Configuration
+// =============================================================================
+/**
+ * Default task configuration
+ */
+export const DEFAULT_TASK_CONFIG = {
+    backend: { type: "opentasks" },
+};
+/**
+ * Default OpenTasks backend configuration
+ */
+export const DEFAULT_OPENTASKS_CONFIG = {
+    syncStatus: true,
+    sourceLabel: "macro-agent",
+    autoStart: true,
+    connectOnSpawn: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/task/backend/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/task/backend/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+aH,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAyC;IAC5E,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,aAAa;IAC1B,SAAS,EAAE,IAAI;IACf,cAAc,EAAE,IAAI;CACrB,CAAC"}

package/dist/task/backend/unified-tool-provider.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Unified Task Tool Provider
+ *
+ * Single tool provider for all task backends. Provides:
+ * - Core CRUD tools (always available): create_task, get_task, list_tasks, assign_task
+ * - OpenTasks graph tools (when client available): task, link, annotate
+ *
+ * Replaces the separate InMemoryTaskToolProvider and OpenTasksTaskToolProvider.
+ *
+ * @module task/backend/unified-tool-provider
+ */
+import type { AgentId } from "../../store/types/index.js";
+import type { TaskBackend, TaskToolProvider, MCPToolDefinition } from "./types.js";
+import type { OpenTasksClient } from "./opentasks/client.js";
+/**
+ * Context needed for tool execution
+ */
+export interface ToolContext {
+    /** The agent making the tool call */
+    agent_id: AgentId;
+}
+/**
+ * Factory function type for getting context
+ */
+export type GetToolContext = () => ToolContext;
+/**
+ * UnifiedTaskToolProvider
+ *
+ * Provides MCP tools for task operations, backed by:
+ * - TaskBackend for core CRUD (create_task, get_task, list_tasks, assign_task)
+ * - OpenTasksClient (optional) for graph operations (task, link, annotate)
+ */
+export declare class UnifiedTaskToolProvider implements TaskToolProvider {
+    private readonly backend;
+    private readonly getContext;
+    private readonly openTasksClient?;
+    constructor(backend: TaskBackend, getContext: GetToolContext, openTasksClient?: OpenTasksClient | undefined);
+    getTools(): MCPToolDefinition[];
+    /**
+     * Exclude the built-in create_task and get_task from mcp-server.ts
+     * since this provider replaces them.
+     */
+    getExcludedTools(): string[];
+    private createTaskTool;
+    private getTaskTool;
+    private listTasksTool;
+    private assignTaskTool;
+    private taskTool;
+    private linkTool;
+    private annotateTool;
+    private listProvidersTool;
+}
+/**
+ * Create a UnifiedTaskToolProvider
+ */
+export declare function createUnifiedToolProvider(backend: TaskBackend, getContext: GetToolContext, openTasksClient?: OpenTasksClient): UnifiedTaskToolProvider;
+//# sourceMappingURL=unified-tool-provider.d.ts.map

package/dist/task/backend/unified-tool-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-tool-provider.d.ts","sourceRoot":"","sources":["../../../src/task/backend/unified-tool-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,CAAC;AAM/C;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,gBAAgB;IAE5D,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBAFhB,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,eAAe,YAAA;IAGpD,QAAQ,IAAI,iBAAiB,EAAE;IAoB/B;;;OAGG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAQ5B,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,WAAW;IA0CnB,OAAO,CAAC,aAAa;IAkHrB,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,QAAQ;IAqLhB,OAAO,CAAC,QAAQ;IA8EhB,OAAO,CAAC,YAAY;IAmIpB,OAAO,CAAC,iBAAiB;CAkC1B;AAMD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,eAAe,GAChC,uBAAuB,CAEzB"}