macro-agent 0.1.0 → 0.1.2

package/dist/task/backend/opentasks/daemon-manager.d.ts

@@ -0,0 +1,89 @@
+/**
+ * OpenTasks Daemon Manager
+ *
+ * Manages the lifecycle of the central opentasks daemon as part of the
+ * task backend lifecycle. The daemon is auto-started by createTaskBackend()
+ * and stopped via TaskBackendResult.shutdown().
+ *
+ * Architecture:
+ * - Central daemon lives at ~/.multiagent/opentasks/
+ * - If a daemon is already running, we connect to it (ownsDaemon=false)
+ * - If not, we start one and own its lifecycle (ownsDaemon=true)
+ * - On shutdown, we only stop the daemon if we started it
+ *
+ * @module task/backend/opentasks/daemon-manager
+ */
+import type { OpenTasksClient } from "./client.js";
+/**
+ * Configuration for the DaemonManager.
+ */
+export interface DaemonManagerConfig {
+    /** Central daemon location (default: ~/.multiagent/opentasks) */
+    centralPath?: string;
+    /** Whether to auto-connect project .opentasks/ on connectProject() */
+    connectOnSpawn?: boolean;
+}
+/**
+ * Result from ensureDaemon() — the running daemon's connection info.
+ */
+export interface DaemonManagerResult {
+    /** Connected OpenTasks client */
+    client: OpenTasksClient;
+    /** Daemon socket path */
+    socketPath: string;
+    /** Whether we started the daemon (vs connecting to existing) */
+    ownsDaemon: boolean;
+}
+/**
+ * Manages the central opentasks daemon lifecycle.
+ *
+ * Internal to the opentasks backend module — not exposed as a standalone service.
+ */
+export declare class DaemonManager {
+    private readonly centralPath;
+    private readonly connectOnSpawn;
+    private daemon;
+    private client;
+    private ownsDaemon;
+    private connectedProjects;
+    constructor(config?: DaemonManagerConfig);
+    /**
+     * Ensure the central daemon is running and return a connected client.
+     *
+     * 1. Check if a daemon is already running at the central path
+     * 2. If running, connect to it (ownsDaemon=false)
+     * 3. If not running, start one (ownsDaemon=true)
+     * 4. Return connected client + socket path
+     */
+    ensureDaemon(): Promise<DaemonManagerResult>;
+    /**
+     * Connect a project's .opentasks/ directory to the central daemon.
+     *
+     * This is a fire-and-forget operation — connection failures are logged
+     * but do not affect the caller.
+     *
+     * @param projectPath - Path to the project root (will look for .opentasks/ subdirectory)
+     */
+    connectProject(projectPath: string): Promise<void>;
+    /**
+     * Check if a project is already connected to the central daemon.
+     */
+    isProjectConnected(projectPath: string): boolean;
+    /**
+     * Get list of connected project .opentasks/ paths.
+     */
+    getConnectedProjects(): string[];
+    /**
+     * Shut down the daemon manager.
+     *
+     * - Disconnects the client
+     * - Stops the daemon if we started it (ownsDaemon=true)
+     * - Leaves the daemon running if someone else started it
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a DaemonManager instance.
+ */
+export declare function createDaemonManager(config?: DaemonManagerConfig): DaemonManager;
+//# sourceMappingURL=daemon-manager.d.ts.map

package/dist/task/backend/opentasks/daemon-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-manager.d.ts","sourceRoot":"","sources":["../../../../src/task/backend/opentasks/daemon-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAMnD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iEAAiE;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,MAAM,EAAE,eAAe,CAAC;IAExB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAEnB,gEAAgE;IAChE,UAAU,EAAE,OAAO,CAAC;CACrB;AAkBD;;;;GAIG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,iBAAiB,CAAqB;gBAElC,MAAM,CAAC,EAAE,mBAAmB;IAKxC;;;;;;;OAOG;IACG,YAAY,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAsDlD;;;;;;;OAOG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCxD;;OAEG;IACH,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAKhD;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CA2BhC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,mBAAmB,GAC3B,aAAa,CAEf"}

package/dist/task/backend/opentasks/daemon-manager.js

@@ -0,0 +1,195 @@
+/**
+ * OpenTasks Daemon Manager
+ *
+ * Manages the lifecycle of the central opentasks daemon as part of the
+ * task backend lifecycle. The daemon is auto-started by createTaskBackend()
+ * and stopped via TaskBackendResult.shutdown().
+ *
+ * Architecture:
+ * - Central daemon lives at ~/.multiagent/opentasks/
+ * - If a daemon is already running, we connect to it (ownsDaemon=false)
+ * - If not, we start one and own its lifecycle (ownsDaemon=true)
+ * - On shutdown, we only stop the daemon if we started it
+ *
+ * @module task/backend/opentasks/daemon-manager
+ */
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { checkExistingDaemon, createDaemonWithStore } from "opentasks";
+import { IPCOpenTasksClient } from "./client.js";
+// =============================================================================
+// Constants
+// =============================================================================
+const DEFAULT_CENTRAL_PATH = path.join(process.env.MACRO_AGENT_HOME || path.join(os.homedir(), ".multiagent"), "opentasks");
+/** Grace period (ms) between client disconnect and daemon.stop() to let children finish disconnecting */
+const DAEMON_DRAIN_MS = 500;
+// =============================================================================
+// DaemonManager Implementation
+// =============================================================================
+/**
+ * Manages the central opentasks daemon lifecycle.
+ *
+ * Internal to the opentasks backend module — not exposed as a standalone service.
+ */
+export class DaemonManager {
+    centralPath;
+    connectOnSpawn;
+    daemon = null;
+    client = null;
+    ownsDaemon = false;
+    connectedProjects = new Set();
+    constructor(config) {
+        this.centralPath = config?.centralPath ?? DEFAULT_CENTRAL_PATH;
+        this.connectOnSpawn = config?.connectOnSpawn ?? true;
+    }
+    /**
+     * Ensure the central daemon is running and return a connected client.
+     *
+     * 1. Check if a daemon is already running at the central path
+     * 2. If running, connect to it (ownsDaemon=false)
+     * 3. If not running, start one (ownsDaemon=true)
+     * 4. Return connected client + socket path
+     */
+    async ensureDaemon() {
+        // Ensure the central directory exists
+        fs.mkdirSync(this.centralPath, { recursive: true });
+        // Check if a daemon is already running at this location
+        const existing = await checkExistingDaemon(this.centralPath);
+        if (existing.running && existing.socketPath) {
+            // Connect to the existing daemon
+            console.error(`[opentasks] Connecting to existing daemon at ${existing.socketPath} (pid: ${existing.pid})`);
+            const client = new IPCOpenTasksClient({
+                socketPath: existing.socketPath,
+            });
+            await client.connect();
+            this.client = client;
+            this.ownsDaemon = false;
+            return {
+                client,
+                socketPath: existing.socketPath,
+                ownsDaemon: false,
+            };
+        }
+        // No daemon running — start one
+        console.error(`[opentasks] Starting daemon at ${this.centralPath}`);
+        const daemon = await createDaemonWithStore({
+            locationPath: this.centralPath,
+            version: "0.0.3",
+        });
+        await daemon.start();
+        this.daemon = daemon;
+        this.ownsDaemon = true;
+        const socketPath = daemon.socketPath;
+        console.error(`[opentasks] Daemon started (socket: ${socketPath})`);
+        // Connect client to the daemon
+        const client = new IPCOpenTasksClient({ socketPath });
+        await client.connect();
+        this.client = client;
+        return {
+            client,
+            socketPath,
+            ownsDaemon: true,
+        };
+    }
+    /**
+     * Connect a project's .opentasks/ directory to the central daemon.
+     *
+     * This is a fire-and-forget operation — connection failures are logged
+     * but do not affect the caller.
+     *
+     * @param projectPath - Path to the project root (will look for .opentasks/ subdirectory)
+     */
+    async connectProject(projectPath) {
+        if (!this.connectOnSpawn)
+            return;
+        if (!this.client)
+            return;
+        const opentasksDir = path.join(projectPath, ".opentasks");
+        // Check if project has .opentasks/
+        if (!fs.existsSync(opentasksDir))
+            return;
+        // Check if already connected
+        if (this.connectedProjects.has(opentasksDir))
+            return;
+        try {
+            // Read the project's config.json to get its location hash
+            const configPath = path.join(opentasksDir, "config.json");
+            const configContent = fs.readFileSync(configPath, "utf-8");
+            const config = JSON.parse(configContent);
+            const hash = config?.location?.hash;
+            if (!hash) {
+                console.error(`[opentasks] No location hash in ${configPath}, skipping`);
+                return;
+            }
+            // Register the location with the daemon via IPC
+            const client = this.client;
+            if (typeof client.call === "function") {
+                await client.call("location.register", {
+                    hash,
+                    opentasksPath: opentasksDir,
+                });
+            }
+            this.connectedProjects.add(opentasksDir);
+            console.error(`[opentasks] Connected to project: ${opentasksDir}`);
+        }
+        catch (error) {
+            // Non-fatal — log and continue
+            console.error(`[opentasks] Failed to connect project ${opentasksDir}: ${error}`);
+        }
+    }
+    /**
+     * Check if a project is already connected to the central daemon.
+     */
+    isProjectConnected(projectPath) {
+        const opentasksDir = path.join(projectPath, ".opentasks");
+        return this.connectedProjects.has(opentasksDir);
+    }
+    /**
+     * Get list of connected project .opentasks/ paths.
+     */
+    getConnectedProjects() {
+        return Array.from(this.connectedProjects);
+    }
+    /**
+     * Shut down the daemon manager.
+     *
+     * - Disconnects the client
+     * - Stops the daemon if we started it (ownsDaemon=true)
+     * - Leaves the daemon running if someone else started it
+     */
+    async shutdown() {
+        // Disconnect client
+        if (this.client) {
+            try {
+                this.client.disconnect();
+            }
+            catch {
+                // Ignore disconnect errors
+            }
+            this.client = null;
+        }
+        // Stop daemon only if we own it
+        if (this.ownsDaemon && this.daemon) {
+            try {
+                // Grace period to let child agents finish disconnecting from the daemon
+                await new Promise(resolve => setTimeout(resolve, DAEMON_DRAIN_MS));
+                console.error("[opentasks] Stopping daemon");
+                await this.daemon.stop();
+            }
+            catch (error) {
+                console.error(`[opentasks] Error stopping daemon: ${error}`);
+            }
+            this.daemon = null;
+            this.ownsDaemon = false;
+        }
+        this.connectedProjects.clear();
+    }
+}
+/**
+ * Create a DaemonManager instance.
+ */
+export function createDaemonManager(config) {
+    return new DaemonManager(config);
+}
+//# sourceMappingURL=daemon-manager.js.map

package/dist/task/backend/opentasks/daemon-manager.js.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * OpenTasks Task Backend Module
+ *
+ * Integrates macro-agent's task system with OpenTasks, a graph connector
+ * for linking heterogeneous task and issue systems.
+ *
+ * Tasks are stored as OpenTasks issues with bidirectional ID mapping.
+ * Blocking dependencies use OpenTasks 'blocks' edges.
+ * The pull model leverages OpenTasks' ready query and claimed_by field.
+ *
+ * @module task/backend/opentasks
+ */
+export { OpenTasksTaskBackend, OpenTasksBackendError, createOpenTasksTaskBackend, } from "./backend.js";
+export type { OpenTasksBackendConfig } from "./backend.js";
+export { IPCOpenTasksClient, OpenTasksClientError, createOpenTasksClient, } from "./client.js";
+export type { OpenTasksClient, OpenTasksClientConfig, OpenTasksIssue, OpenTasksEdge, OpenTasksNodeSummary, CreateIssueInput, UpdateIssueInput, IssueChangeType, IssueChangeEvent, IssueChangeCallback, ClientUnsubscribe, TaskAction, TaskParams, TaskResult, TaskTransitionData, TaskReadyData, TaskAssignData, TaskValidActionsData, TaskNodeSummary, ProviderSummary, } from "./client.js";
+export { DaemonManager, createDaemonManager, } from "./daemon-manager.js";
+export type { DaemonManagerConfig, DaemonManagerResult, } from "./daemon-manager.js";
+export { mapOpenTasksStatus, mapTaskStatus, isIssueComplete, isIssueBlocked, } from "./mapping.js";
+export type { OpenTasksIssueStatus } from "./mapping.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/task/backend/opentasks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EAEjB,UAAU,EACV,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * OpenTasks Task Backend Module
+ *
+ * Integrates macro-agent's task system with OpenTasks, a graph connector
+ * for linking heterogeneous task and issue systems.
+ *
+ * Tasks are stored as OpenTasks issues with bidirectional ID mapping.
+ * Blocking dependencies use OpenTasks 'blocks' edges.
+ * The pull model leverages OpenTasks' ready query and claimed_by field.
+ *
+ * @module task/backend/opentasks
+ */
+// Backend
+export { OpenTasksTaskBackend, OpenTasksBackendError, createOpenTasksTaskBackend, } from "./backend.js";
+// Client
+export { IPCOpenTasksClient, OpenTasksClientError, createOpenTasksClient, } from "./client.js";
+// Daemon Manager
+export { DaemonManager, createDaemonManager, } from "./daemon-manager.js";
+// Mapping
+export { mapOpenTasksStatus, mapTaskStatus, isIssueComplete, isIssueBlocked, } from "./mapping.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/task/backend/opentasks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,UAAU;AACV,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAGtB,SAAS;AACT,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAyBrB,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAM7B,UAAU;AACV,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC"}

package/dist/task/backend/opentasks/mapping.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Status Mapping Utilities for OpenTasks Integration
+ *
+ * Maps between OpenTasks issue statuses and macro-agent task statuses.
+ *
+ * @module task/backend/opentasks/mapping
+ */
+import type { TaskStatus } from "../../../store/types/index.js";
+/**
+ * OpenTasks issue status values.
+ * These are the canonical statuses used by OpenTasks issues.
+ */
+export type OpenTasksIssueStatus = "open" | "in_progress" | "blocked" | "closed";
+/**
+ * Map OpenTasks issue status to macro-agent task status.
+ *
+ * OpenTasks statuses:
+ * - open: Not started
+ * - in_progress: Currently being worked on
+ * - blocked: Blocked by dependencies (handled via isBlocked flag)
+ * - closed: Completed
+ *
+ * Macro-agent statuses:
+ * - pending: Not started
+ * - assigned: Assigned to an agent but not started
+ * - in_progress: Currently executing
+ * - completed: Finished successfully
+ * - failed: Finished with error
+ */
+export declare function mapOpenTasksStatus(openTasksStatus: string): TaskStatus;
+/**
+ * Map macro-agent task status to OpenTasks issue status.
+ *
+ * Note: Some task statuses don't have direct OpenTasks equivalents:
+ * - assigned: No direct equivalent (maps to open, assignee set separately)
+ * - failed: No direct equivalent (maps to closed with error in metadata)
+ */
+export declare function mapTaskStatus(taskStatus: TaskStatus): OpenTasksIssueStatus;
+/**
+ * Check if an OpenTasks issue status indicates completion.
+ */
+export declare function isIssueComplete(status: string): boolean;
+/**
+ * Check if an OpenTasks issue has an explicit blocked status.
+ * Note: This is the explicit 'blocked' status, not dependency-based blocking.
+ */
+export declare function isIssueBlocked(status: string): boolean;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/task/backend/opentasks/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../../src/task/backend/opentasks/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC5B,MAAM,GACN,aAAa,GACb,SAAS,GACT,QAAQ,CAAC;AAEb;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,GACtB,UAAU,CAcZ;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,oBAAoB,CAiB1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/dist/task/backend/opentasks/mapping.js

@@ -0,0 +1,77 @@
+/**
+ * Status Mapping Utilities for OpenTasks Integration
+ *
+ * Maps between OpenTasks issue statuses and macro-agent task statuses.
+ *
+ * @module task/backend/opentasks/mapping
+ */
+/**
+ * Map OpenTasks issue status to macro-agent task status.
+ *
+ * OpenTasks statuses:
+ * - open: Not started
+ * - in_progress: Currently being worked on
+ * - blocked: Blocked by dependencies (handled via isBlocked flag)
+ * - closed: Completed
+ *
+ * Macro-agent statuses:
+ * - pending: Not started
+ * - assigned: Assigned to an agent but not started
+ * - in_progress: Currently executing
+ * - completed: Finished successfully
+ * - failed: Finished with error
+ */
+export function mapOpenTasksStatus(openTasksStatus) {
+    switch (openTasksStatus) {
+        case "open":
+            return "pending";
+        case "in_progress":
+            return "in_progress";
+        case "blocked":
+            // Blocked issues map to pending - the isBlocked flag handles blocking
+            return "pending";
+        case "closed":
+            return "completed";
+        default:
+            return "pending";
+    }
+}
+/**
+ * Map macro-agent task status to OpenTasks issue status.
+ *
+ * Note: Some task statuses don't have direct OpenTasks equivalents:
+ * - assigned: No direct equivalent (maps to open, assignee set separately)
+ * - failed: No direct equivalent (maps to closed with error in metadata)
+ */
+export function mapTaskStatus(taskStatus) {
+    switch (taskStatus) {
+        case "pending":
+            return "open";
+        case "assigned":
+            // Assigned tasks remain open in OpenTasks; assignee field handles assignment
+            return "open";
+        case "in_progress":
+            return "in_progress";
+        case "completed":
+            return "closed";
+        case "failed":
+            // Failed tasks are closed in OpenTasks (failure tracked in metadata)
+            return "closed";
+        default:
+            return "open";
+    }
+}
+/**
+ * Check if an OpenTasks issue status indicates completion.
+ */
+export function isIssueComplete(status) {
+    return status === "closed";
+}
+/**
+ * Check if an OpenTasks issue has an explicit blocked status.
+ * Note: This is the explicit 'blocked' status, not dependency-based blocking.
+ */
+export function isIssueBlocked(status) {
+    return status === "blocked";
+}
+//# sourceMappingURL=mapping.js.map

package/dist/task/backend/opentasks/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../../../src/task/backend/opentasks/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAChC,eAAuB;IAEvB,QAAQ,eAAe,EAAE,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,SAAS,CAAC;QACnB,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,SAAS;YACZ,sEAAsE;YACtE,OAAO,SAAS,CAAC;QACnB,KAAK,QAAQ;YACX,OAAO,WAAW,CAAC;QACrB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,UAAsB;IAClD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,SAAS;YACZ,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU;YACb,6EAA6E;YAC7E,OAAO,MAAM,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,aAAa,CAAC;QACvB,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC;QAClB,KAAK,QAAQ;YACX,qEAAqE;YACrE,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,MAAM,KAAK,QAAQ,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,KAAK,SAAS,CAAC;AAC9B,CAAC"}

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

@@ -5,7 +5,6 @@
  * internal task system to be backed by external task management systems.
  *
  * @module task/backend
- * @see s-8472 Pluggable Task Backend Integration with Sudocode
  */
 import type { AgentId, TaskId, Timestamp, Task, TaskStatus, ArtifactRef, AgentHistoryEntry } from "../../store/types/index.js";
 export type { Task, TaskStatus, ArtifactRef, AgentHistoryEntry };
@@ -16,8 +15,10 @@ export type { Task, TaskStatus, ArtifactRef, AgentHistoryEntry };
 export interface ExtendedTask extends Task {
     /** True if blocked by dependencies (computed, not stored) */
     isBlocked?: boolean;
-    /** Binding to external system (e.g., sudocode issue ID "i-xxxx") */
+    /** 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
@@ -29,7 +30,7 @@ export interface CreateTaskOptions {
     created_by: AgentId;
     /** Optional parent task for subtask hierarchy */
     parent_task?: TaskId;
-    /** Optional binding to external system (e.g., sudocode issue ID) */
+    /** Optional binding to external system (e.g., OpenTasks issue ID) */
     external_id?: string;
     /** Optional tags for classification and filtering (pull model) */
     tags?: string[];
@@ -156,10 +157,11 @@ export type Unsubscribe = () => void;
  *
  * Abstraction over task storage allowing different implementations:
  * - InMemoryTaskBackend - Current behavior (default)
- * - SudocodeTaskBackend - Backed by sudocode issues
- * - Future: LinearTaskBackend, JiraTaskBackend, etc.
+ * - 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 */
@@ -212,6 +214,14 @@ export interface TaskBackend {
     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 */
@@ -230,10 +240,6 @@ export interface MCPToolDefinition {
     /** Tool handler function */
     handler: (params: unknown) => Promise<unknown>;
 }
-/**
- * Task tool mode
- */
-export type TaskToolMode = "abstract" | "native" | "both" | "auto";
 /**
  * Task Tool Provider Interface
  *
@@ -252,66 +258,40 @@ export interface InMemoryBackendConfig {
     type: "memory";
 }
 /**
- * Execution tracking configuration
- */
-export type ExecutionTrackingConfig = {
-    mode: "none";
-} | {
-    mode: "bound-only";
-} | {
-    mode: "all";
-} | {
-    mode: "filter";
-    filter: ExecutionFilter;
-};
-/**
- * Execution filter options
- */
-export interface ExecutionFilter {
-    /** Only create executions for these agent roles */
-    roles?: string[];
-    /** Only when task has external binding */
-    requireExternalBinding?: boolean;
-    /** Exclude coordination-only agents (no code changes) */
-    excludeCoordinationOnly?: boolean;
-}
-/**
- * Sudocode backend configuration
+ * OpenTasks backend configuration
  */
-export interface SudocodeBackendConfig {
-    type: "sudocode";
-    /** Path to sudocode project root (contains .sudocode/) */
-    projectPath: string;
-    /** ID strategy (default: 'dual') */
-    idStrategy?: "dual";
-    /** Sync mode for event subscriptions */
-    syncMode?: "realtime" | "batch";
-    /** Execution tracking configuration */
-    executionTracking?: ExecutionTrackingConfig;
-    /** Auto-link tasks to specs when created from spec context */
-    autoLinkSpecs?: boolean;
-    /** Tool mode for this backend (overrides global if set) */
-    toolMode?: "native" | "mapped" | "both";
+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 | SudocodeBackendConfig;
+export type TaskBackendConfig = InMemoryBackendConfig | OpenTasksBackendConfig;
 /**
  * Macro-agent task configuration
  */
 export interface TaskConfig {
     /** Task backend configuration */
     backend: TaskBackendConfig;
-    /** Task tool mode (default: 'auto') */
-    toolMode?: TaskToolMode;
 }
 /**
  * Default task configuration
  */
 export declare const DEFAULT_TASK_CONFIG: TaskConfig;
 /**
- * Default sudocode backend configuration
+ * Default OpenTasks backend configuration
  */
-export declare const DEFAULT_SUDOCODE_CONFIG: Omit<SudocodeBackendConfig, "type">;
+export declare const DEFAULT_OPENTASKS_CONFIG: Omit<OpenTasksBackendConfig, "type">;
 //# sourceMappingURL=types.d.ts.map