macro-agent 0.1.1 → 0.1.3

package/dist/adapters/opentasks-daemon.d.ts

@@ -0,0 +1,32 @@
+/**
+ * OpenTasks Daemon Lifecycle Helper
+ *
+ * Starts/stops the opentasks daemon programmatically using the
+ * opentasks Node API (createDaemonWithStore). Falls back to CLI
+ * spawning if the programmatic API is unavailable.
+ *
+ * @module adapters/opentasks-daemon
+ */
+export interface DaemonHandle {
+    /** Path to the daemon's Unix socket. */
+    socketPath: string;
+    /** Gracefully stop the daemon. */
+    stop(): Promise<void>;
+}
+export interface EnsureDaemonOptions {
+    /** Timeout in ms to wait for the daemon to become reachable (default: 10000). */
+    timeoutMs?: number;
+    /** Custom registry path — useful for test isolation. */
+    registryPath?: string;
+}
+/**
+ * Ensure an opentasks daemon is running for the given repo.
+ *
+ * 1. Checks for an already-running daemon (probes known socket locations).
+ * 2. If none is running, initializes `.opentasks/` and starts a daemon
+ *    using the opentasks programmatic API (`createDaemonWithStore`).
+ * 3. Waits for the socket to become reachable.
+ * 4. Returns a handle with `socketPath` and `stop()`.
+ */
+export declare function ensureOpentasksDaemon(repoPath: string, opts?: EnsureDaemonOptions): Promise<DaemonHandle>;
+//# sourceMappingURL=opentasks-daemon.d.ts.map

package/dist/adapters/opentasks-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opentasks-daemon.d.ts","sourceRoot":"","sources":["../../src/adapters/opentasks-daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA0ID;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,YAAY,CAAC,CAuEvB"}

package/dist/adapters/opentasks-daemon.js

@@ -0,0 +1,190 @@
+/**
+ * OpenTasks Daemon Lifecycle Helper
+ *
+ * Starts/stops the opentasks daemon programmatically using the
+ * opentasks Node API (createDaemonWithStore). Falls back to CLI
+ * spawning if the programmatic API is unavailable.
+ *
+ * @module adapters/opentasks-daemon
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as net from "node:net";
+// ─────────────────────────────────────────────────────────────────
+// Socket Probing
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Try to connect to a Unix socket.  Resolves true if the connection
+ * succeeds (i.e., something is listening), false otherwise.
+ */
+function probeSocket(socketPath, timeoutMs = 2000) {
+    return new Promise((resolve) => {
+        const sock = net.createConnection({ path: socketPath });
+        const timer = setTimeout(() => {
+            sock.destroy();
+            resolve(false);
+        }, timeoutMs);
+        sock.on("connect", () => {
+            clearTimeout(timer);
+            sock.destroy();
+            resolve(true);
+        });
+        sock.on("error", () => {
+            clearTimeout(timer);
+            resolve(false);
+        });
+    });
+}
+// ─────────────────────────────────────────────────────────────────
+// Socket Discovery
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Candidate socket locations, in priority order:
+ *   1. .git/opentasks/daemon.sock   (multi-location mode)
+ *   2. .opentasks/daemon.sock       (single-location mode)
+ */
+function candidateSocketPaths(repoPath) {
+    return [
+        path.join(repoPath, ".git", "opentasks", "daemon.sock"),
+        path.join(repoPath, ".opentasks", "daemon.sock"),
+    ];
+}
+/**
+ * Find an existing, reachable daemon socket for the given repo.
+ */
+async function findRunningDaemon(repoPath) {
+    for (const candidate of candidateSocketPaths(repoPath)) {
+        if (fs.existsSync(candidate) && (await probeSocket(candidate))) {
+            return candidate;
+        }
+    }
+    return null;
+}
+// ─────────────────────────────────────────────────────────────────
+// Poll helper
+// ─────────────────────────────────────────────────────────────────
+async function waitForSocket(socketPath, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    const interval = 200;
+    while (Date.now() < deadline) {
+        if (fs.existsSync(socketPath) && (await probeSocket(socketPath, 1000))) {
+            return;
+        }
+        await new Promise((r) => setTimeout(r, interval));
+    }
+    throw new Error(`Timed out waiting for opentasks daemon socket at ${socketPath} (${timeoutMs}ms)`);
+}
+// ─────────────────────────────────────────────────────────────────
+// Initialization
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Ensure the .opentasks directory exists with a minimal config.
+ * Returns the path to the .opentasks directory.
+ */
+function ensureOpentasksDir(repoPath) {
+    const opentasksDir = path.join(repoPath, ".opentasks");
+    if (!fs.existsSync(opentasksDir)) {
+        fs.mkdirSync(opentasksDir, { recursive: true });
+    }
+    const configPath = path.join(opentasksDir, "config.json");
+    if (!fs.existsSync(configPath)) {
+        const config = {
+            storage: {
+                graphPath: "graph.jsonl",
+                sqlitePath: "cache.db",
+            },
+            daemon: {
+                socketPath: "daemon.sock",
+            },
+            providers: {
+                // Disable external providers for a minimal setup
+                beads: { enabled: false },
+                claudeTasks: { enabled: false },
+                sudocode: { enabled: false },
+                global: { enabled: false },
+            },
+        };
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+    return opentasksDir;
+}
+// ─────────────────────────────────────────────────────────────────
+// Diagnostics
+// ─────────────────────────────────────────────────────────────────
+function safeReaddir(dir) {
+    try {
+        return fs.readdirSync(dir).join(", ");
+    }
+    catch {
+        return `(unreadable: ${dir})`;
+    }
+}
+// ─────────────────────────────────────────────────────────────────
+// Public API
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Ensure an opentasks daemon is running for the given repo.
+ *
+ * 1. Checks for an already-running daemon (probes known socket locations).
+ * 2. If none is running, initializes `.opentasks/` and starts a daemon
+ *    using the opentasks programmatic API (`createDaemonWithStore`).
+ * 3. Waits for the socket to become reachable.
+ * 4. Returns a handle with `socketPath` and `stop()`.
+ */
+export async function ensureOpentasksDaemon(repoPath, opts = {}) {
+    const { timeoutMs = 10_000, registryPath } = opts;
+    // ── 1. Check for existing daemon ───────────────────────────────
+    const existingSocket = await findRunningDaemon(repoPath);
+    if (existingSocket) {
+        return {
+            socketPath: existingSocket,
+            async stop() {
+                // We didn't start it, so don't stop it.
+            },
+        };
+    }
+    // ── 2. Ensure .opentasks/ dir + config ─────────────────────────
+    const locationPath = ensureOpentasksDir(repoPath);
+    // ── 3. Start daemon via programmatic API ───────────────────────
+    let daemon;
+    try {
+        const { createDaemonWithStore } = await import("opentasks");
+        const daemonConfig = {
+            locationPath,
+            version: "0.0.1",
+        };
+        if (registryPath) {
+            daemonConfig.registryPath = registryPath;
+        }
+        daemon = await createDaemonWithStore(daemonConfig);
+    }
+    catch (err) {
+        throw new Error(`Failed to create opentasks daemon: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        await daemon.start();
+    }
+    catch (err) {
+        throw new Error(`Failed to start opentasks daemon: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // ── 4. Verify socket is reachable ──────────────────────────────
+    // daemon.start() already ensures the IPC server is listening.
+    const socketPath = daemon.socketPath;
+    if (!fs.existsSync(socketPath)) {
+        throw new Error(`Daemon started but socket file not found at ${socketPath}. ` +
+            `Location dir contents: ${safeReaddir(path.dirname(socketPath))}`);
+    }
+    // ── 5. Return handle ───────────────────────────────────────────
+    return {
+        socketPath,
+        async stop() {
+            try {
+                await daemon.stop();
+            }
+            catch {
+                // Best-effort shutdown — socket may already be gone.
+            }
+        },
+    };
+}
+//# sourceMappingURL=opentasks-daemon.js.map

package/dist/adapters/opentasks-daemon.js.map

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

package/dist/adapters/tasks-adapter.d.ts

@@ -0,0 +1,49 @@
+/**
+ * TasksAdapter — Wraps opentasks client for macro-agent's task management.
+ *
+ * Connects to the opentasks daemon via IPC. Uses autoConnect to
+ * auto-start the daemon if it's not running.
+ *
+ * Translates between macro-agent's domain types and opentasks'
+ * graph model (nodes, edges, semantic actions).
+ *
+ * @module adapters/tasks-adapter
+ */
+import type { TasksAdapter as ITasksAdapter, CreateTaskOptions, TaskAction, TaskRecord, TaskQueryOptions } from "./types.js";
+export interface TasksAdapterConfig {
+    /** Path to opentasks daemon socket (auto-discovered if not set). */
+    socketPath?: string;
+    /** Request timeout in milliseconds (default: 30000). */
+    timeout?: number;
+}
+export declare class DefaultTasksAdapter implements ITasksAdapter {
+    private client;
+    private readonly config;
+    private _connected;
+    constructor(config?: TasksAdapterConfig);
+    get connected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): void;
+    createTask(opts: CreateTaskOptions): Promise<string>;
+    assignTask(taskId: string, agentId: string): Promise<void>;
+    transitionTask(taskId: string, action: TaskAction): Promise<void>;
+    getTask(taskId: string): Promise<TaskRecord>;
+    queryReady(opts?: {
+        tags?: string[];
+        limit?: number;
+    }): Promise<TaskRecord[]>;
+    listTasks(filter?: TaskQueryOptions): Promise<TaskRecord[]>;
+    addBlocker(taskId: string, blockerId: string): Promise<void>;
+    removeBlocker(taskId: string, blockerId: string): Promise<void>;
+    claimTask(agentId: string, filter?: {
+        tags?: string[];
+    }): Promise<TaskRecord | null>;
+    unclaimTask(taskId: string): Promise<void>;
+    listClaimable(filter?: {
+        tags?: string[];
+        limit?: number;
+    }): Promise<TaskRecord[]>;
+    private requireClient;
+    private nodeToTaskRecord;
+}
+//# sourceMappingURL=tasks-adapter.d.ts.map

package/dist/adapters/tasks-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/tasks-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,YAAY,IAAI,aAAa,EAC7B,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,kBAAuB;IAI3C,IAAI,SAAS,IAAI,OAAO,CAEvB;IAIK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B,UAAU,IAAI,IAAI;IAUZ,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBpD,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1D,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAW5C,UAAU,CACd,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACzC,OAAO,CAAC,UAAU,EAAE,CAAC;IAclB,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmB3D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5D,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/D,SAAS,CACb,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAC3B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA4BvB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C,aAAa,CACjB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,UAAU,EAAE,CAAC;IAMxB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/adapters/tasks-adapter.js

@@ -0,0 +1,209 @@
+/**
+ * TasksAdapter — Wraps opentasks client for macro-agent's task management.
+ *
+ * Connects to the opentasks daemon via IPC. Uses autoConnect to
+ * auto-start the daemon if it's not running.
+ *
+ * Translates between macro-agent's domain types and opentasks'
+ * graph model (nodes, edges, semantic actions).
+ *
+ * @module adapters/tasks-adapter
+ */
+// ─────────────────────────────────────────────────────────────────
+// Implementation
+// ─────────────────────────────────────────────────────────────────
+export class DefaultTasksAdapter {
+    client = null;
+    config;
+    _connected = false;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    get connected() {
+        return this._connected;
+    }
+    // ── Connection Lifecycle ─────────────────────────────────────
+    async connect() {
+        if (this._connected)
+            return;
+        // Dynamically import opentasks to avoid hard compile-time dep issues
+        const { OpenTasksClient } = await import("opentasks");
+        this.client = new OpenTasksClient({
+            socketPath: this.config.socketPath,
+            autoConnect: true,
+            timeout: this.config.timeout ?? 30000,
+        });
+        await this.client.connect();
+        this._connected = true;
+    }
+    disconnect() {
+        if (this.client) {
+            this.client.disconnect();
+            this.client = null;
+            this._connected = false;
+        }
+    }
+    // ── Task Lifecycle ───────────────────────────────────────────
+    async createTask(opts) {
+        const client = this.requireClient();
+        // Create via graph CRUD (createNode) — the task tool does not
+        // have a "create" operation; it only handles transitions, ready
+        // queries, assignments, and valid-action introspection.
+        const node = await client.createNode({
+            type: "task",
+            title: opts.title,
+            content: opts.content,
+            status: "open",
+            assignee: opts.assignee,
+            parent_id: opts.parent,
+            tags: opts.tags,
+            priority: opts.priority,
+        });
+        return node?.id ?? "";
+    }
+    async assignTask(taskId, agentId) {
+        const client = this.requireClient();
+        await client.task({
+            assign: { id: taskId, assignee: agentId },
+        });
+    }
+    async transitionTask(taskId, action) {
+        const client = this.requireClient();
+        await client.task({
+            transition: { id: taskId, action },
+        });
+    }
+    // ── Queries ──────────────────────────────────────────────────
+    async getTask(taskId) {
+        const client = this.requireClient();
+        const node = await client.getNode(taskId);
+        if (!node) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        return this.nodeToTaskRecord(node);
+    }
+    async queryReady(opts) {
+        const client = this.requireClient();
+        const result = await client.query({
+            ready: {
+                limit: opts?.limit,
+                tags: opts?.tags,
+            },
+        });
+        return (result.items ?? []).map((n) => this.nodeToTaskRecord(n));
+    }
+    async listTasks(filter) {
+        const client = this.requireClient();
+        const result = await client.query({
+            nodes: {
+                type: "task",
+                status: filter?.status,
+                assignee: filter?.assignee,
+                tags: filter?.tags,
+                limit: filter?.limit,
+            },
+        });
+        return (result.items ?? []).map((n) => this.nodeToTaskRecord(n));
+    }
+    // ── Dependencies ─────────────────────────────────────────────
+    async addBlocker(taskId, blockerId) {
+        const client = this.requireClient();
+        await client.link({
+            fromId: blockerId,
+            toId: taskId,
+            type: "blocks",
+        });
+    }
+    async removeBlocker(taskId, blockerId) {
+        const client = this.requireClient();
+        await client.link({
+            fromId: blockerId,
+            toId: taskId,
+            type: "blocks",
+            remove: true,
+        });
+    }
+    // ── Pull Mode ────────────────────────────────────────────────
+    async claimTask(agentId, filter) {
+        const client = this.requireClient();
+        // Query ready tasks, then claim the first one
+        const result = await client.query({
+            ready: {
+                limit: 1,
+                tags: filter?.tags,
+            },
+        });
+        const items = result.items ?? [];
+        if (items.length === 0)
+            return null;
+        const task = items[0];
+        const taskId = task.id;
+        // Assign + transition to claim
+        await client.task({
+            assign: { id: taskId, assignee: agentId },
+        });
+        await client.task({
+            transition: { id: taskId, action: "start" },
+        });
+        return this.nodeToTaskRecord({ ...task, status: "in_progress", assignee: agentId });
+    }
+    async unclaimTask(taskId) {
+        const client = this.requireClient();
+        // To unclaim a task that's in_progress, transition through
+        // blocked -> open: in_progress --(block)--> blocked --(reopen)--> open.
+        // "reopen" is only valid from blocked/closed, not from in_progress.
+        await client.task({
+            transition: { id: taskId, action: "block" },
+        });
+        await client.task({
+            transition: { id: taskId, action: "reopen" },
+        });
+    }
+    async listClaimable(filter) {
+        return this.queryReady(filter);
+    }
+    // ── Private ──────────────────────────────────────────────────
+    requireClient() {
+        if (!this.client || !this._connected) {
+            throw new Error("TasksAdapter not connected. Call connect() first.");
+        }
+        return this.client;
+    }
+    nodeToTaskRecord(node) {
+        return {
+            id: node.id ?? "",
+            title: node.title ?? "",
+            content: node.content,
+            status: mapOpenTasksStatus(node.status),
+            assignee: node.assignee,
+            parent: node.parent_id,
+            tags: node.tags,
+            priority: node.priority,
+            claimed_by: node.claimed_by ?? node.assignee,
+            created_at: node.created_at,
+            closed_at: node.closed_at,
+            metadata: node.metadata,
+        };
+    }
+}
+// ─────────────────────────────────────────────────────────────────
+// Helpers
+// ─────────────────────────────────────────────────────────────────
+/**
+ * Map opentasks canonical status to our TaskStatus type.
+ */
+function mapOpenTasksStatus(status) {
+    switch (status) {
+        case "open":
+            return "open";
+        case "in_progress":
+            return "in_progress";
+        case "blocked":
+            return "blocked";
+        case "closed":
+            return "closed";
+        default:
+            return "open";
+    }
+}
+//# sourceMappingURL=tasks-adapter.js.map

package/dist/adapters/tasks-adapter.js.map

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