macro-agent 0.2.4 → 0.2.6

package/dist/store/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/store/types/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/store/types/conversations.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Conversation-related type definitions for mail integration.
+ *
+ * These types define the materialized views for conversations, turns,
+ * and threads stored in the EventStore.
+ */
+import type { AgentId, Timestamp } from "./primitives.js";
+export type ConversationType = "session" | "task" | "peer";
+export type ConversationStatus = "active" | "completed" | "failed" | "archived";
+export type ParticipantRole = "initiator" | "assistant" | "worker" | "observer";
+export type TurnSourceType = "explicit" | "intercepted";
+/**
+ * A conversation groups related interactions between participants.
+ * Materialized from `conversation` events.
+ */
+export interface Conversation {
+    id: string;
+    type: ConversationType;
+    status: ConversationStatus;
+    subject?: string;
+    parentConversationId?: string;
+    createdBy: string;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    closedAt?: Timestamp;
+    closedBy?: string;
+    closeReason?: string;
+    participantCount: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A turn is a single message or event recorded within a conversation.
+ * Materialized from `turn` events.
+ */
+export interface ConversationTurn {
+    id: string;
+    conversationId: string;
+    participant: string;
+    timestamp: Timestamp;
+    contentType: string;
+    content: unknown;
+    threadId?: string;
+    inReplyTo?: string;
+    sourceType: TurnSourceType;
+    sourceMessageId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A thread is a sub-conversation within a conversation, rooted at a specific turn.
+ * Materialized from `thread` events.
+ */
+export interface ConversationThread {
+    id: string;
+    conversationId: string;
+    rootTurnId: string;
+    subject?: string;
+    parentThreadId?: string;
+    createdBy: string;
+    createdAt: Timestamp;
+    turnCount: number;
+}
+/**
+ * A participant is a member of a conversation with a role and join/leave tracking.
+ * Materialized from conversation `participant_joined` / `participant_left` events.
+ */
+export interface ConversationParticipant {
+    id: string;
+    conversationId: string;
+    type: "user" | "agent" | "system";
+    role: ParticipantRole;
+    joinedAt: Timestamp;
+    leftAt?: Timestamp;
+    agentId?: AgentId;
+}
+export interface ConversationFilter {
+    type?: ConversationType;
+    status?: ConversationStatus;
+    participantId?: string;
+    parentConversationId?: string;
+}
+export interface TurnFilter {
+    conversationId: string;
+    threadId?: string;
+    contentType?: string;
+    participantId?: string;
+    limit?: number;
+    order?: "asc" | "desc";
+}
+export type ConversationChangeCallback = (conversationId: string, conversation: Conversation | null) => void;
+export type TurnChangeCallback = (conversationId: string, turn: ConversationTurn) => void;
+//# sourceMappingURL=conversations.d.ts.map

package/dist/store/types/conversations.d.ts.map

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

package/dist/store/types/conversations.js

@@ -0,0 +1,8 @@
+/**
+ * Conversation-related type definitions for mail integration.
+ *
+ * These types define the materialized views for conversations, turns,
+ * and threads stored in the EventStore.
+ */
+export {};
+//# sourceMappingURL=conversations.js.map

package/dist/store/types/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../../src/store/types/conversations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/store/types/sessions.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Session-related type definitions
+ *
+ * Sessions track the mapping between ACP protocol sessions and
+ * macro-agent agents. Unlike the in-memory SessionMapper, these
+ * records are persisted in the EventStore for recovery after restart.
+ */
+import type { AgentId, Timestamp } from "./primitives.js";
+/**
+ * Session state enum — tracks the lifecycle of an ACP session.
+ *
+ * State transitions:
+ *   active → mounted → active (via unmount)
+ *   active → closed
+ *   mounted → closed
+ */
+export type SessionState = "active" | "mounted" | "closed";
+/**
+ * Persistent session record in the EventStore materialized view.
+ *
+ * Maps an ACP session ID to its head manager agent, current agent
+ * target (which may differ when mounted), and lifecycle state.
+ */
+export interface Session {
+    /** ACP session ID (primary key) */
+    id: string;
+    /** Head manager agent ID — the original agent for this session */
+    head_manager_id: AgentId;
+    /** Currently targeted agent ID (may differ from head_manager_id when mounted) */
+    current_agent_id: AgentId;
+    /** Current session state */
+    state: SessionState;
+    /** When the session was created */
+    created_at: Timestamp;
+    /** When the session state last changed */
+    updated_at: Timestamp;
+    /** When the session was closed (if applicable) */
+    closed_at?: Timestamp;
+}
+/**
+ * Session event actions used in the event payload.
+ */
+export type SessionAction = "created" | "mounted" | "unmounted" | "closed";
+//# sourceMappingURL=sessions.d.ts.map

package/dist/store/types/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../../src/store/types/sessions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IAEX,kEAAkE;IAClE,eAAe,EAAE,OAAO,CAAC;IAEzB,iFAAiF;IACjF,gBAAgB,EAAE,OAAO,CAAC;IAE1B,4BAA4B;IAC5B,KAAK,EAAE,YAAY,CAAC;IAEpB,mCAAmC;IACnC,UAAU,EAAE,SAAS,CAAC;IAEtB,0CAA0C;IAC1C,UAAU,EAAE,SAAS,CAAC;IAEtB,kDAAkD;IAClD,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC"}

package/dist/store/types/sessions.js

@@ -0,0 +1,9 @@
+/**
+ * Session-related type definitions
+ *
+ * Sessions track the mapping between ACP protocol sessions and
+ * macro-agent agents. Unlike the in-memory SessionMapper, these
+ * records are persisted in the EventStore for recovery after restart.
+ */
+export {};
+//# sourceMappingURL=sessions.js.map

package/dist/store/types/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../../src/store/types/sessions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/store/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Core type definitions for the multi-agent event store
+ */
+export type AgentId = string;
+export type SessionId = string;
+export type TaskId = string;
+export type EventId = string;
+export type Timestamp = number;
+export type EventType = 'spawn' | 'terminate' | 'status' | 'message' | 'task' | 'subscription';
+export type AgentState = 'spawning' | 'running' | 'stopped';
+export type StopReason = 'completed' | 'failed' | 'stopped' | 'timeout' | 'cancelled';
+export type TaskStatus = 'pending' | 'assigned' | 'in_progress' | 'completed' | 'failed';
+export type StatusType = 'started' | 'checkpoint' | 'blocked' | 'discovery' | 'completed' | 'failed';
+export type TaskAction = 'created' | 'assigned' | 'unassigned' | 'status_change' | 'completed' | 'failed';
+export type SubscriptionType = 'agent' | 'task' | 'lineage' | 'subtree' | 'topic' | 'broadcast';
+export interface EventSource {
+    agent_id?: AgentId;
+    task_id?: TaskId;
+    lineage?: AgentId[];
+}
+export interface EventTarget {
+    agent_id?: AgentId;
+    task_id?: TaskId;
+    topic?: string;
+    scope?: 'subtree' | 'branch' | 'all';
+}
+export interface EventMetadata {
+    correlation_id?: string;
+    ttl?: number;
+    requires_ack?: boolean;
+    [key: string]: unknown;
+}
+export interface Event {
+    id: EventId;
+    timestamp: Timestamp;
+    type: EventType;
+    source: EventSource;
+    target?: EventTarget;
+    payload: Record<string, unknown>;
+    metadata?: EventMetadata;
+}
+export interface EventInput {
+    type: EventType;
+    source: EventSource;
+    target?: EventTarget;
+    payload: Record<string, unknown>;
+    metadata?: EventMetadata;
+}
+export interface AgentConfig {
+    model?: string;
+    timeout?: number;
+    resource_limits?: {
+        max_tokens?: number;
+        max_children?: number;
+        [key: string]: unknown;
+    };
+}
+export interface Agent {
+    id: AgentId;
+    session_id: SessionId;
+    parent: AgentId | null;
+    lineage: AgentId[];
+    state: AgentState;
+    stop_reason?: StopReason;
+    task: string;
+    task_id?: TaskId;
+    config: AgentConfig;
+    created_at: Timestamp;
+    started_at?: Timestamp;
+    stopped_at?: Timestamp;
+}
+export interface Task {
+    id: TaskId;
+    description: string;
+    status: TaskStatus;
+    assigned_agent?: AgentId;
+    parent_task?: TaskId;
+    created_at: Timestamp;
+    started_at?: Timestamp;
+    completed_at?: Timestamp;
+    created_by: AgentId;
+    inputs?: Record<string, unknown>;
+    outputs?: Record<string, unknown>;
+    artifacts?: ArtifactRef[];
+}
+export interface ArtifactRef {
+    type: 'file' | 'commit' | 'url';
+    ref: string;
+    description?: string;
+}
+export interface QueuedMessage {
+    id: EventId;
+    from: EventSource;
+    content: string;
+    timestamp: Timestamp;
+    truncated: boolean;
+    correlation_id?: string;
+}
+export interface Subscription {
+    type: SubscriptionType;
+    target: string;
+}
+export interface EventFilter {
+    type?: EventType;
+    source_agent_id?: AgentId;
+    target_agent_id?: AgentId;
+    after?: Timestamp;
+    before?: Timestamp;
+    limit?: number;
+}
+export interface StoreConfig {
+    path?: string;
+    inMemory?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/store/types.d.ts.map

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

package/dist/store/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core type definitions for the multi-agent event store
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/store/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

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

@@ -0,0 +1,93 @@
+/**
+ * Task Backend Module
+ *
+ * Exports task backend interface types and implementations.
+ *
+ * @module task/backend
+ */
+export type { ExtendedTask, CreateTaskOptions, UpdateTaskOptions, TaskOutputs, TaskError, TaskFilter, SubtaskStatus, AssignOptions, TaskChangeType, TaskChangeEvent, TaskChangeCallback, Unsubscribe, TaskBackend, MCPToolDefinition, TaskToolProvider, InMemoryBackendConfig, OpenTasksBackendConfig, TaskBackendConfig, TaskConfig, } from "./types.js";
+export type { Task, TaskStatus, ArtifactRef, AgentHistoryEntry, } from "./types.js";
+export { InMemoryTaskBackend, createInMemoryTaskBackend, TaskBackendError, } from "./memory.js";
+export { UnifiedTaskToolProvider, createUnifiedToolProvider, } from "./unified-tool-provider.js";
+export type { ToolContext, GetToolContext } from "./unified-tool-provider.js";
+export { OpenTasksTaskBackend, OpenTasksBackendError, createOpenTasksTaskBackend, IPCOpenTasksClient, OpenTasksClientError, createOpenTasksClient, } from "./opentasks/index.js";
+export type { OpenTasksClient, OpenTasksClientConfig, OpenTasksIssue, OpenTasksEdge, OpenTasksNodeSummary, } from "./opentasks/index.js";
+import type { EventStore } from "../../store/event-store.js";
+import type { TaskBackend, TaskConfig } from "./types.js";
+import type { OpenTasksClient } from "./opentasks/client.js";
+import { DEFAULT_TASK_CONFIG, DEFAULT_OPENTASKS_CONFIG } from "./types.js";
+/**
+ * Result of creating a task backend
+ */
+export interface TaskBackendResult {
+    /** The task backend instance */
+    backend: TaskBackend;
+    /** OpenTasks client (if opentasks backend is used) */
+    openTasksClient?: OpenTasksClient;
+    /** Runtime socket path of the daemon (for propagating to child agents) */
+    socketPath?: string;
+    /** Shutdown function — stops daemon if we started it, disconnects client */
+    shutdown?: () => Promise<void>;
+    /** Connect a project's .opentasks/ directory to the central daemon (Phase 2) */
+    connectProject?: (projectPath: string) => Promise<void>;
+    /** Get list of connected project .opentasks/ paths */
+    getConnectedProjects?: () => string[];
+}
+/**
+ * Create a task backend based on configuration
+ *
+ * @param config - Task configuration
+ * @param eventStore - Event store for state management
+ * @returns Backend result with backend instance and optional OpenTasks client
+ *
+ * @example
+ * ```typescript
+ * // Create in-memory backend (default)
+ * const { backend } = await createTaskBackend(
+ *   { backend: { type: 'memory' } },
+ *   eventStore
+ * );
+ *
+ * // Create opentasks backend
+ * const { backend, openTasksClient } = await createTaskBackend(
+ *   { backend: { type: 'opentasks' } },
+ *   eventStore
+ * );
+ * ```
+ */
+export declare function createTaskBackend(config: TaskConfig, eventStore: EventStore): Promise<TaskBackendResult>;
+/**
+ * Load task configuration from environment variables
+ *
+ * Environment variables:
+ * - MACRO_TASK_BACKEND: 'memory' | 'opentasks' (default: 'opentasks')
+ * - OPENTASKS_SOCKET_PATH: Path to OpenTasks daemon socket (auto-discovered if not set)
+ *
+ * @returns Task configuration
+ */
+export declare function loadTaskConfigFromEnv(): TaskConfig;
+/**
+ * Load task configuration from a merged MultiagentConfig.
+ *
+ * Use this instead of loadTaskConfigFromEnv() when you have
+ * a merged config from the layered config system.
+ *
+ * @param config - Merged config with task settings already resolved
+ * @returns Task configuration
+ */
+export declare function loadTaskConfigFromMerged(config: {
+    task?: {
+        backend?: string;
+        opentasks?: {
+            socket_path?: string;
+            auto_start?: boolean;
+            central_path?: string;
+            connect_on_spawn?: boolean;
+        };
+    };
+}): TaskConfig;
+/**
+ * Default task configuration (in-memory backend)
+ */
+export { DEFAULT_TASK_CONFIG, DEFAULT_OPENTASKS_CONFIG };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/task/backend/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,YAAY,EAEV,YAAY,EAGZ,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,UAAU,EACV,aAAa,EACb,aAAa,EAGb,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,WAAW,EAGX,WAAW,EAGX,iBAAiB,EACjB,gBAAgB,EAGhB,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,IAAI,EACJ,UAAU,EACV,WAAW,EACX,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAEpC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAM9E,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,oBAAoB,GACrB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAqB,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAM3E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,gCAAgC;IAChC,OAAO,EAAE,WAAW,CAAC;IAErB,sDAAsD;IACtD,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,gFAAgF;IAChF,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,sDAAsD;IACtD,oBAAoB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,UAAU,EAClB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAqF5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CAiBlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,IAAI,CAAC,EAAE;QACL,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE;YACV,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,OAAO,CAAC;YACrB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;SAC5B,CAAC;KACH,CAAC;CACH,GAAG,UAAU,CAkBb;AAED;;GAEG;AACH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/task/backend/index.js

@@ -0,0 +1,178 @@
+/**
+ * Task Backend Module
+ *
+ * Exports task backend interface types and implementations.
+ *
+ * @module task/backend
+ */
+// =============================================================================
+// Implementations
+// =============================================================================
+export { InMemoryTaskBackend, createInMemoryTaskBackend, TaskBackendError, } from "./memory.js";
+export { UnifiedTaskToolProvider, createUnifiedToolProvider, } from "./unified-tool-provider.js";
+// =============================================================================
+// OpenTasks Backend (re-export)
+// =============================================================================
+export { OpenTasksTaskBackend, OpenTasksBackendError, createOpenTasksTaskBackend, IPCOpenTasksClient, OpenTasksClientError, createOpenTasksClient, } from "./opentasks/index.js";
+import { DEFAULT_TASK_CONFIG, DEFAULT_OPENTASKS_CONFIG } from "./types.js";
+import { InMemoryTaskBackend } from "./memory.js";
+import { OpenTasksTaskBackend } from "./opentasks/backend.js";
+import { createOpenTasksClient } from "./opentasks/client.js";
+import { DaemonManager } from "./opentasks/daemon-manager.js";
+/**
+ * Create a task backend based on configuration
+ *
+ * @param config - Task configuration
+ * @param eventStore - Event store for state management
+ * @returns Backend result with backend instance and optional OpenTasks client
+ *
+ * @example
+ * ```typescript
+ * // Create in-memory backend (default)
+ * const { backend } = await createTaskBackend(
+ *   { backend: { type: 'memory' } },
+ *   eventStore
+ * );
+ *
+ * // Create opentasks backend
+ * const { backend, openTasksClient } = await createTaskBackend(
+ *   { backend: { type: 'opentasks' } },
+ *   eventStore
+ * );
+ * ```
+ */
+export async function createTaskBackend(config, eventStore) {
+    const { backend: backendConfig } = config;
+    if (backendConfig.type === "memory") {
+        const backend = new InMemoryTaskBackend(eventStore);
+        return { backend };
+    }
+    if (backendConfig.type === "opentasks") {
+        // Merge with defaults
+        const openTasksConfig = {
+            ...DEFAULT_OPENTASKS_CONFIG,
+            ...backendConfig,
+        };
+        // Determine how to get the OpenTasks client:
+        // 1. If socketPath is explicitly provided, connect directly (legacy / child agent mode)
+        // 2. If autoStart is enabled (default), use DaemonManager to auto-start central daemon
+        // 3. Otherwise, try to connect without auto-start
+        let openTasksClient;
+        let resolvedSocketPath;
+        let shutdownFn;
+        let daemonManager;
+        if (openTasksConfig.socketPath) {
+            // Direct connection to a known socket (e.g., child agent with inherited socket path)
+            openTasksClient = await createOpenTasksClient({
+                socketPath: openTasksConfig.socketPath,
+            });
+            resolvedSocketPath = openTasksConfig.socketPath;
+            shutdownFn = async () => {
+                openTasksClient.disconnect();
+            };
+        }
+        else if (openTasksConfig.autoStart !== false) {
+            // Auto-start daemon via DaemonManager (default behavior)
+            daemonManager = new DaemonManager({
+                centralPath: openTasksConfig.centralPath,
+                connectOnSpawn: openTasksConfig.connectOnSpawn,
+            });
+            const result = await daemonManager.ensureDaemon();
+            openTasksClient = result.client;
+            resolvedSocketPath = result.socketPath;
+            shutdownFn = () => daemonManager.shutdown();
+        }
+        else {
+            // Auto-start disabled, no socket path — try default socket discovery
+            openTasksClient = await createOpenTasksClient();
+            shutdownFn = async () => {
+                openTasksClient.disconnect();
+            };
+        }
+        // Create backend
+        const backend = new OpenTasksTaskBackend(eventStore, openTasksClient, {
+            socketPath: openTasksConfig.socketPath,
+            syncStatus: openTasksConfig.syncStatus,
+            sourceLabel: openTasksConfig.sourceLabel,
+        });
+        // Wrap shutdown to close the backend before disconnecting the client/daemon
+        const finalShutdown = async () => {
+            if (backend.close) {
+                try {
+                    await backend.close();
+                }
+                catch { /* ignore */ }
+            }
+            if (shutdownFn)
+                await shutdownFn();
+        };
+        return {
+            backend,
+            openTasksClient,
+            socketPath: resolvedSocketPath,
+            shutdown: finalShutdown,
+            connectProject: daemonManager
+                ? (projectPath) => daemonManager.connectProject(projectPath)
+                : undefined,
+            getConnectedProjects: daemonManager
+                ? () => daemonManager.getConnectedProjects()
+                : undefined,
+        };
+    }
+    throw new Error(`Unknown backend type: ${backendConfig.type}`);
+}
+/**
+ * Load task configuration from environment variables
+ *
+ * Environment variables:
+ * - MACRO_TASK_BACKEND: 'memory' | 'opentasks' (default: 'opentasks')
+ * - OPENTASKS_SOCKET_PATH: Path to OpenTasks daemon socket (auto-discovered if not set)
+ *
+ * @returns Task configuration
+ */
+export function loadTaskConfigFromEnv() {
+    const backendType = process.env.MACRO_TASK_BACKEND ?? "opentasks";
+    if (backendType === "opentasks") {
+        const socketPath = process.env.OPENTASKS_SOCKET_PATH;
+        return {
+            backend: {
+                type: "opentasks",
+                socketPath,
+            },
+        };
+    }
+    return {
+        backend: { type: "memory" },
+    };
+}
+/**
+ * Load task configuration from a merged MultiagentConfig.
+ *
+ * Use this instead of loadTaskConfigFromEnv() when you have
+ * a merged config from the layered config system.
+ *
+ * @param config - Merged config with task settings already resolved
+ * @returns Task configuration
+ */
+export function loadTaskConfigFromMerged(config) {
+    const backendType = config.task?.backend ?? "opentasks";
+    if (backendType === "opentasks") {
+        return {
+            backend: {
+                type: "opentasks",
+                socketPath: config.task?.opentasks?.socket_path,
+                autoStart: config.task?.opentasks?.auto_start,
+                centralPath: config.task?.opentasks?.central_path,
+                connectOnSpawn: config.task?.opentasks?.connect_on_spawn,
+            },
+        };
+    }
+    return {
+        backend: { type: "memory" },
+    };
+}
+/**
+ * Default task configuration (in-memory backend)
+ */
+export { DEFAULT_TASK_CONFIG, DEFAULT_OPENTASKS_CONFIG };
+//# sourceMappingURL=index.js.map

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

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