octoflow-core 1.0.0

package/dist/adapters/data/task-store/sqlite-subscriptions.js

@@ -0,0 +1,90 @@
+import { sleep } from "../../../utils/time.js";
+import {
+  cloneTaskResult,
+  encodeTaskEventCursor,
+  isTerminalTaskState
+} from "./shared.js";
+function createPollingSubscription(opts) {
+  const {
+    attachEventId,
+    currentSequence,
+    initialRows,
+    initialTask,
+    pollIntervalMs,
+    readRows
+  } = opts;
+  let sequence = initialRows.length > 0 ? initialRows[initialRows.length - 1].sequence : currentSequence;
+  const isFinalStatusEvent = (event) => event.kind === "status-update" && (event.event.final || isTerminalTaskState(event.event.status.state));
+  const pending = initialRows.map(attachEventId);
+  let closeAfterPendingDrains = isTerminalTaskState(initialTask.status.state) || pending.some(isFinalStatusEvent);
+  return {
+    [Symbol.asyncIterator]() {
+      let closed = false;
+      let first = true;
+      let consecutiveEmpty = 0;
+      return {
+        async next() {
+          if (closed) {
+            return { value: void 0, done: true };
+          }
+          if (first) {
+            first = false;
+            return {
+              value: {
+                kind: "task",
+                id: encodeTaskEventCursor(currentSequence),
+                task: cloneTaskResult(initialTask)
+              },
+              done: false
+            };
+          }
+          while (!closed) {
+            if (pending.length > 0) {
+              consecutiveEmpty = 0;
+              const nextEvent = pending.shift();
+              if (pending.length === 0 && (closeAfterPendingDrains || isFinalStatusEvent(nextEvent))) {
+                closeAfterPendingDrains = true;
+              }
+              return { value: nextEvent, done: false };
+            }
+            if (closeAfterPendingDrains) {
+              closed = true;
+              return { value: void 0, done: true };
+            }
+            const rows = readRows(sequence);
+            if (rows.length > 0) {
+              consecutiveEmpty = 0;
+              sequence = rows[rows.length - 1].sequence;
+              const nextEvents = rows.map(attachEventId);
+              for (const event of nextEvents) {
+                pending.push(event);
+              }
+              if (nextEvents.some(isFinalStatusEvent)) {
+                closeAfterPendingDrains = true;
+              }
+              continue;
+            }
+            consecutiveEmpty++;
+            const backoffMs = Math.min(
+              pollIntervalMs * 2 ** (consecutiveEmpty - 1),
+              500
+            );
+            await sleep(backoffMs);
+          }
+          return { value: void 0, done: true };
+        },
+        return() {
+          closed = true;
+          return Promise.resolve({ value: void 0, done: true });
+        },
+        [Symbol.asyncIterator]() {
+          return this;
+        }
+      };
+    }
+  };
+}
+export {
+  createPollingSubscription
+};
+//# sourceMappingURL=sqlite-subscriptions.js.map

package/dist/adapters/data/task-store/sqlite-subscriptions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/data/task-store/sqlite-subscriptions.ts"],
+  "sourcesContent": ["import type { BridgeSubscriptionEvent } from '../../../domain/bridge-api.js';\nimport type { Task } from '../../../domain/core-task.js';\nimport { sleep } from '../../../utils/time.js';\nimport {\n  cloneTaskResult,\n  encodeTaskEventCursor,\n  isTerminalTaskState,\n} from './shared.js';\n\ninterface EventRow {\n  payload_json: string;\n  sequence: number;\n}\n\n/**\n * Build an async-iterable subscription backed by polling the SQLite event log.\n * Extracted from SqliteTaskStore to keep the main store file focused on CRUD.\n */\nexport function createPollingSubscription(opts: {\n  attachEventId: (row: EventRow) => BridgeSubscriptionEvent;\n  currentSequence: number;\n  initialRows: EventRow[];\n  initialTask: Task;\n  pollIntervalMs: number;\n  readRows: (afterSequence: number) => EventRow[];\n}): AsyncIterable<BridgeSubscriptionEvent> {\n  const {\n    attachEventId,\n    currentSequence,\n    initialRows,\n    initialTask,\n    pollIntervalMs,\n    readRows,\n  } = opts;\n\n  let sequence =\n    initialRows.length > 0\n      ? initialRows[initialRows.length - 1]!.sequence\n      : currentSequence;\n\n  const isFinalStatusEvent = (event: BridgeSubscriptionEvent) =>\n    event.kind === 'status-update' &&\n    (event.event.final || isTerminalTaskState(event.event.status.state));\n\n  const pending = initialRows.map(attachEventId);\n  let closeAfterPendingDrains =\n    isTerminalTaskState(initialTask.status.state) ||\n    pending.some(isFinalStatusEvent);\n\n  return {\n    [Symbol.asyncIterator](): AsyncIterator<BridgeSubscriptionEvent> {\n      let closed = false;\n      let first = true;\n      let consecutiveEmpty = 0;\n\n      return {\n        async next(): Promise<IteratorResult<BridgeSubscriptionEvent>> {\n          if (closed) {\n            return { value: undefined, done: true };\n          }\n\n          if (first) {\n            first = false;\n            return {\n              value: {\n                kind: 'task',\n                id: encodeTaskEventCursor(currentSequence),\n                task: cloneTaskResult(initialTask),\n              },\n              done: false,\n            };\n          }\n\n          while (!closed) {\n            if (pending.length > 0) {\n              consecutiveEmpty = 0;\n              const nextEvent = pending.shift()!;\n              if (\n                pending.length === 0 &&\n                (closeAfterPendingDrains || isFinalStatusEvent(nextEvent))\n              ) {\n                closeAfterPendingDrains = true;\n              }\n              return { value: nextEvent, done: false };\n            }\n\n            if (closeAfterPendingDrains) {\n              closed = true;\n              return { value: undefined, done: true };\n            }\n\n            const rows = readRows(sequence);\n\n            if (rows.length > 0) {\n              consecutiveEmpty = 0;\n              sequence = rows[rows.length - 1]!.sequence;\n              const nextEvents = rows.map(attachEventId);\n              for (const event of nextEvents) {\n                pending.push(event);\n              }\n              if (nextEvents.some(isFinalStatusEvent)) {\n                closeAfterPendingDrains = true;\n              }\n              continue;\n            }\n\n            consecutiveEmpty++;\n            const backoffMs = Math.min(\n              pollIntervalMs * 2 ** (consecutiveEmpty - 1),\n              500\n            );\n            await sleep(backoffMs);\n          }\n\n          return { value: undefined, done: true };\n        },\n        return(): Promise<IteratorResult<BridgeSubscriptionEvent>> {\n          closed = true;\n          return Promise.resolve({ value: undefined, done: true });\n        },\n        [Symbol.asyncIterator](): AsyncIterator<BridgeSubscriptionEvent> {\n          return this;\n        },\n      } as AsyncIterableIterator<BridgeSubscriptionEvent>;\n    },\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,aAAa;AACtB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAWA,SAAS,0BAA0B,MAOC;AACzC,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,MAAI,WACF,YAAY,SAAS,IACjB,YAAY,YAAY,SAAS,CAAC,EAAG,WACrC;AAEN,QAAM,qBAAqB,CAAC,UAC1B,MAAM,SAAS,oBACd,MAAM,MAAM,SAAS,oBAAoB,MAAM,MAAM,OAAO,KAAK;AAEpE,QAAM,UAAU,YAAY,IAAI,aAAa;AAC7C,MAAI,0BACF,oBAAoB,YAAY,OAAO,KAAK,KAC5C,QAAQ,KAAK,kBAAkB;AAEjC,SAAO;AAAA,IACL,CAAC,OAAO,aAAa,IAA4C;AAC/D,UAAI,SAAS;AACb,UAAI,QAAQ;AACZ,UAAI,mBAAmB;AAEvB,aAAO;AAAA,QACL,MAAM,OAAyD;AAC7D,cAAI,QAAQ;AACV,mBAAO,EAAE,OAAO,QAAW,MAAM,KAAK;AAAA,UACxC;AAEA,cAAI,OAAO;AACT,oBAAQ;AACR,mBAAO;AAAA,cACL,OAAO;AAAA,gBACL,MAAM;AAAA,gBACN,IAAI,sBAAsB,eAAe;AAAA,gBACzC,MAAM,gBAAgB,WAAW;AAAA,cACnC;AAAA,cACA,MAAM;AAAA,YACR;AAAA,UACF;AAEA,iBAAO,CAAC,QAAQ;AACd,gBAAI,QAAQ,SAAS,GAAG;AACtB,iCAAmB;AACnB,oBAAM,YAAY,QAAQ,MAAM;AAChC,kBACE,QAAQ,WAAW,MAClB,2BAA2B,mBAAmB,SAAS,IACxD;AACA,0CAA0B;AAAA,cAC5B;AACA,qBAAO,EAAE,OAAO,WAAW,MAAM,MAAM;AAAA,YACzC;AAEA,gBAAI,yBAAyB;AAC3B,uBAAS;AACT,qBAAO,EAAE,OAAO,QAAW,MAAM,KAAK;AAAA,YACxC;AAEA,kBAAM,OAAO,SAAS,QAAQ;AAE9B,gBAAI,KAAK,SAAS,GAAG;AACnB,iCAAmB;AACnB,yBAAW,KAAK,KAAK,SAAS,CAAC,EAAG;AAClC,oBAAM,aAAa,KAAK,IAAI,aAAa;AACzC,yBAAW,SAAS,YAAY;AAC9B,wBAAQ,KAAK,KAAK;AAAA,cACpB;AACA,kBAAI,WAAW,KAAK,kBAAkB,GAAG;AACvC,0CAA0B;AAAA,cAC5B;AACA;AAAA,YACF;AAEA;AACA,kBAAM,YAAY,KAAK;AAAA,cACrB,iBAAiB,MAAM,mBAAmB;AAAA,cAC1C;AAAA,YACF;AACA,kBAAM,MAAM,SAAS;AAAA,UACvB;AAEA,iBAAO,EAAE,OAAO,QAAW,MAAM,KAAK;AAAA,QACxC;AAAA,QACA,SAA2D;AACzD,mBAAS;AACT,iBAAO,QAAQ,QAAQ,EAAE,OAAO,QAAW,MAAM,KAAK,CAAC;AAAA,QACzD;AAAA,QACA,CAAC,OAAO,aAAa,IAA4C;AAC/D,iBAAO;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/adapters/data/task-store/sqlite.d.ts

@@ -0,0 +1,33 @@
+import type { BridgeConversation, BridgeConversationSnapshotOptions, BridgeListConversationsOptions, BridgeListConversationsResult, BridgeListTasksOptions, BridgeListTasksResult, BridgeSubscriptionEvent, BridgeTaskSnapshotOptions } from '../../../domain/bridge-api.js';
+import type { BridgeMetadata, Message, Task, TaskArtifactUpdateEvent, TaskStatusUpdateEvent } from '../../../domain/core-task.js';
+import type { AppendArtifactInput, CreateTaskInput, ResumeTaskInput, SqliteTaskStoreConfig, TaskStore, TaskSubscriptionOptions, UpdateStatusInput } from './types.js';
+interface SqliteTaskStoreOptions extends SqliteTaskStoreConfig {
+    path?: string;
+}
+export declare class SqliteTaskStore implements TaskStore {
+    private readonly db;
+    private readonly pollIntervalMs;
+    constructor(options?: SqliteTaskStoreOptions);
+    createTask(input: CreateTaskInput): Promise<Task>;
+    claimTask(taskId: string): Promise<Task | undefined>;
+    resumeTask(input: ResumeTaskInput): Promise<Task>;
+    getTask(taskId: string, options?: BridgeTaskSnapshotOptions): Promise<Task | undefined>;
+    hasTask(taskId: string): Promise<boolean>;
+    listTasks(input?: BridgeListTasksOptions): Promise<BridgeListTasksResult>;
+    getConversation(contextId: string, options?: BridgeConversationSnapshotOptions): Promise<BridgeConversation | undefined>;
+    listConversations(input?: BridgeListConversationsOptions): Promise<BridgeListConversationsResult>;
+    updateBridgeMetadata(taskId: string, bridgeMetadata: BridgeMetadata['bridge']): Promise<Task>;
+    updateStatus(input: UpdateStatusInput): Promise<TaskStatusUpdateEvent>;
+    appendArtifact(input: AppendArtifactInput): Promise<TaskArtifactUpdateEvent>;
+    appendHistory(taskId: string, message: Message, historyLength?: number): Promise<Task>;
+    subscribe(taskId: string, options?: TaskSubscriptionOptions): Promise<AsyncIterable<BridgeSubscriptionEvent>>;
+    putCheckpoint(key: string, data: string): Promise<void>;
+    getCheckpoint(key: string): Promise<string | undefined>;
+    deleteCheckpoint(key: string): Promise<void>;
+    listCheckpoints(prefix: string): Promise<string[]>;
+    claimNextTick(tickAtMs: number, schedulerId?: string): Promise<boolean>;
+    close(): Promise<void>;
+    static defaultPath(_workspace?: string): string;
+}
+export {};
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/adapters/data/task-store/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../../src/adapters/data/task-store/sqlite.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,kBAAkB,EAClB,iCAAiC,EACjC,8BAA8B,EAC9B,6BAA6B,EAC7B,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EACV,cAAc,EACd,OAAO,EACP,IAAI,EACJ,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAsBtC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,SAAS,EACT,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAKpB,UAAU,sBAAuB,SAAQ,qBAAqB;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAgB,YAAW,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;gBAE5B,OAAO,GAAE,sBAA2B;IAkEhD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IA2BpD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjD,OAAO,CACL,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;IAO5B,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzC,SAAS,CACP,KAAK,GAAE,sBAA2B,GACjC,OAAO,CAAC,qBAAqB,CAAC;IA0EjC,eAAe,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAY1C,iBAAiB,CACf,KAAK,GAAE,8BAAmC,GACzC,OAAO,CAAC,6BAA6B,CAAC;IAIzC,oBAAoB,CAClB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,GACvC,OAAO,CAAC,IAAI,CAAC;IAOhB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmBtE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmB5E,aAAa,CACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAOhB,SAAS,CACP,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAYlD,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAOvD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOlD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,SAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,CAAC,WAAW,CAAC,UAAU,SAAgB,GAAG,MAAM;CAGvD"}

package/dist/adapters/data/task-store/sqlite.js

@@ -0,0 +1,300 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, isAbsolute, join } from "node:path";
+import BetterSqlite3 from "better-sqlite3";
+import { cloneValue } from "../../../utils/clone.js";
+import { getOctoFlowDbPath } from "../../../utils/octoflow-home.js";
+import {
+  appendArtifactRecord,
+  appendHistoryRecord,
+  buildConversationFromTasks,
+  cloneTaskResult,
+  createTaskRecord,
+  projectTask,
+  resumeTaskRecord,
+  updateBridgeMetadataRecord,
+  updateStatusRecord
+} from "./shared.js";
+import {
+  buildSubscription,
+  listConversationsQuery,
+  readConversationRecords,
+  readRecord,
+  transactTask,
+  writeRecord
+} from "./sqlite-queries.js";
+const DEFAULT_BUSY_TIMEOUT_MS = 5e3;
+const DEFAULT_POLL_INTERVAL_MS = 50;
+class SqliteTaskStore {
+  db;
+  pollIntervalMs;
+  constructor(options = {}) {
+    const dbPath = options.path ?? SqliteTaskStore.defaultPath();
+    if (dbPath !== ":memory:") {
+      const dir = dirname(
+        isAbsolute(dbPath) ? dbPath : join(process.cwd(), dbPath)
+      );
+      if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+    }
+    this.db = new BetterSqlite3(dbPath);
+    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    this.db.pragma("journal_mode = WAL");
+    this.db.pragma("synchronous = NORMAL");
+    this.db.pragma(
+      `busy_timeout = ${options.busyTimeoutMs ?? DEFAULT_BUSY_TIMEOUT_MS}`
+    );
+    this.db.pragma("foreign_keys = ON");
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS tasks (
+        id TEXT PRIMARY KEY,
+        context_id TEXT NOT NULL,
+        tenant TEXT,
+        created_at TEXT NOT NULL DEFAULT '',
+        last_modified TEXT NOT NULL DEFAULT '',
+        status_state TEXT NOT NULL DEFAULT 'submitted',
+        status_timestamp TEXT,
+        updated_at INTEGER NOT NULL DEFAULT 0,
+        task_json TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_tasks_context_id ON tasks(context_id);
+      CREATE INDEX IF NOT EXISTS idx_tasks_status_state ON tasks(status_state);
+      CREATE INDEX IF NOT EXISTS idx_tasks_tenant ON tasks(tenant);
+      CREATE INDEX IF NOT EXISTS idx_tasks_updated_at ON tasks(updated_at);
+
+      CREATE TABLE IF NOT EXISTS task_events (
+        sequence INTEGER PRIMARY KEY AUTOINCREMENT,
+        task_id TEXT NOT NULL,
+        event_kind TEXT NOT NULL,
+        payload_json TEXT NOT NULL,
+        created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        FOREIGN KEY(task_id) REFERENCES tasks(id) ON DELETE CASCADE
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_task_events_task_id ON task_events(task_id);
+      CREATE INDEX IF NOT EXISTS idx_task_events_task_sequence ON task_events(task_id, sequence);
+
+      CREATE TABLE IF NOT EXISTS checkpoints (
+        key TEXT PRIMARY KEY,
+        data TEXT NOT NULL,
+        created_at TEXT NOT NULL DEFAULT (datetime('now')),
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS scheduler_tick_claims (
+        scheduler_id TEXT NOT NULL,
+        tick_at_ms INTEGER NOT NULL,
+        claimed_at INTEGER NOT NULL,
+        PRIMARY KEY (scheduler_id, tick_at_ms)
+      );
+    `);
+  }
+  createTask(input) {
+    const record = createTaskRecord(input);
+    writeRecord(this.db, record);
+    return Promise.resolve(cloneTaskResult(record.task));
+  }
+  claimTask(taskId) {
+    const result = transactTask(this.db, taskId, (record) => {
+      if (record.task.status.state !== "submitted") {
+        return { record, claimed: false };
+      }
+      const next = updateStatusRecord(record, {
+        taskId,
+        status: { state: "working" }
+      });
+      return {
+        record: next.record,
+        event: {
+          kind: "status-update",
+          event: next.event
+        },
+        claimed: true
+      };
+    });
+    if (!result.claimed) {
+      return Promise.resolve(void 0);
+    }
+    return Promise.resolve(cloneTaskResult(result.record.task));
+  }
+  resumeTask(input) {
+    const nextRecord = transactTask(this.db, input.taskId, (record) => ({
+      record: resumeTaskRecord(record, input)
+    }));
+    return Promise.resolve(cloneTaskResult(nextRecord.record.task));
+  }
+  getTask(taskId, options = {}) {
+    const record = readRecord(this.db, taskId);
+    return Promise.resolve(
+      record ? projectTask(record.task, options) : void 0
+    );
+  }
+  hasTask(taskId) {
+    const row = this.db.prepare("SELECT 1 FROM tasks WHERE id = ?").get(taskId);
+    return Promise.resolve(row != null);
+  }
+  listTasks(input = {}) {
+    const states = input.state == null ? [] : Array.isArray(input.state) ? input.state : [input.state];
+    const limit = Math.max(1, input.limit ?? 50);
+    const offset = Math.max(0, Number.parseInt(input.cursor ?? "0", 10) || 0);
+    const whereParts = [];
+    const params = { limit, offset };
+    if (input.contextId) {
+      whereParts.push("context_id = @contextId");
+      params.contextId = input.contextId;
+    }
+    if (input.tenant !== void 0) {
+      whereParts.push("tenant = @tenant");
+      params.tenant = input.tenant;
+    }
+    if (states.length > 0) {
+      const placeholders = states.map((state, index) => {
+        const key = `state${index}`;
+        params[key] = state;
+        return `@${key}`;
+      });
+      whereParts.push(`status_state IN (${placeholders.join(", ")})`);
+    }
+    if (input.statusTimestampAfter) {
+      whereParts.push("status_timestamp >= @statusTimestampAfter");
+      params.statusTimestampAfter = input.statusTimestampAfter;
+    }
+    const whereSql = whereParts.length > 0 ? `WHERE ${whereParts.join(" AND ")}` : "";
+    const countRow = this.db.prepare(`SELECT COUNT(*) AS count FROM tasks ${whereSql}`).get(params);
+    const rows = this.db.prepare(
+      `
+      SELECT task_json, updated_at FROM tasks ${whereSql} ORDER BY updated_at DESC LIMIT @limit OFFSET @offset
+    `
+    ).all(params);
+    let parsed = rows.map((row) => ({
+      task: JSON.parse(row.task_json),
+      updatedAt: row.updated_at
+    }));
+    if (input.packId) {
+      parsed = parsed.filter(
+        (r) => r.task.metadata?.bridge?.packId === input.packId
+      );
+    }
+    if (input.parentTaskId) {
+      parsed = parsed.filter(
+        (r) => r.task.metadata?.bridge?.parentTaskId === input.parentTaskId
+      );
+    }
+    return Promise.resolve({
+      tasks: parsed.map((record) => projectTask(record.task, input)),
+      nextCursor: offset + limit < countRow.count ? String(offset + limit) : null,
+      pageSize: limit,
+      totalSize: parsed.length
+    });
+  }
+  getConversation(contextId, options = {}) {
+    const records = readConversationRecords(this.db, contextId, options.tenant);
+    if (records.length === 0) return Promise.resolve(void 0);
+    return Promise.resolve(
+      buildConversationFromTasks(
+        records.map((r) => r.task),
+        options
+      )
+    );
+  }
+  listConversations(input = {}) {
+    return Promise.resolve(listConversationsQuery(this.db, input));
+  }
+  updateBridgeMetadata(taskId, bridgeMetadata) {
+    const nextRecord = transactTask(this.db, taskId, (record) => ({
+      record: updateBridgeMetadataRecord(record, bridgeMetadata)
+    }));
+    return Promise.resolve(cloneTaskResult(nextRecord.record.task));
+  }
+  updateStatus(input) {
+    const result = transactTask(this.db, input.taskId, (record) => {
+      const next = updateStatusRecord(record, input);
+      return {
+        record: next.record,
+        event: {
+          kind: "status-update",
+          event: next.event
+        }
+      };
+    });
+    const event = result.event;
+    if (event.kind !== "status-update") {
+      throw new Error("Unexpected task store event type");
+    }
+    return Promise.resolve(cloneValue(event.event));
+  }
+  appendArtifact(input) {
+    const result = transactTask(this.db, input.taskId, (record) => {
+      const next = appendArtifactRecord(record, input);
+      return {
+        record: next.record,
+        event: {
+          kind: "artifact-update",
+          event: next.event
+        }
+      };
+    });
+    const event = result.event;
+    if (event.kind !== "artifact-update") {
+      throw new Error("Unexpected task store event type");
+    }
+    return Promise.resolve(cloneValue(event.event));
+  }
+  appendHistory(taskId, message, historyLength) {
+    const nextRecord = transactTask(this.db, taskId, (record) => ({
+      record: appendHistoryRecord(record, message, historyLength)
+    }));
+    return Promise.resolve(cloneTaskResult(nextRecord.record.task));
+  }
+  subscribe(taskId, options = {}) {
+    try {
+      return Promise.resolve(
+        buildSubscription(this.db, taskId, this.pollIntervalMs, options)
+      );
+    } catch (error) {
+      return Promise.reject(
+        error instanceof Error ? error : new Error(String(error))
+      );
+    }
+  }
+  putCheckpoint(key, data) {
+    this.db.prepare(
+      `
+      INSERT INTO checkpoints (key, data, updated_at) VALUES (?, ?, datetime('now'))
+      ON CONFLICT(key) DO UPDATE SET data = excluded.data, updated_at = datetime('now')
+    `
+    ).run(key, data);
+    return Promise.resolve();
+  }
+  getCheckpoint(key) {
+    const row = this.db.prepare("SELECT data FROM checkpoints WHERE key = ?").get(key);
+    return Promise.resolve(row?.data);
+  }
+  deleteCheckpoint(key) {
+    this.db.prepare("DELETE FROM checkpoints WHERE key = ?").run(key);
+    return Promise.resolve();
+  }
+  listCheckpoints(prefix) {
+    const rows = this.db.prepare("SELECT key FROM checkpoints WHERE key LIKE ? ORDER BY key").all(`${prefix}%`);
+    return Promise.resolve(rows.map((r) => r.key));
+  }
+  claimNextTick(tickAtMs, schedulerId = "default") {
+    const result = this.db.prepare(
+      `
+      INSERT OR IGNORE INTO scheduler_tick_claims (scheduler_id, tick_at_ms, claimed_at)
+      VALUES (?, ?, ?)
+    `
+    ).run(schedulerId, tickAtMs, Date.now());
+    return Promise.resolve(result.changes > 0);
+  }
+  close() {
+    this.db.close();
+    return Promise.resolve();
+  }
+  static defaultPath(_workspace = process.cwd()) {
+    return getOctoFlowDbPath("tasks");
+  }
+}
+export {
+  SqliteTaskStore
+};
+//# sourceMappingURL=sqlite.js.map

package/dist/adapters/data/task-store/sqlite.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/data/task-store/sqlite.ts"],
+  "sourcesContent": ["import { existsSync, mkdirSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\n\nimport BetterSqlite3 from 'better-sqlite3';\n\nimport type {\n  BridgeConversation,\n  BridgeConversationSnapshotOptions,\n  BridgeListConversationsOptions,\n  BridgeListConversationsResult,\n  BridgeListTasksOptions,\n  BridgeListTasksResult,\n  BridgeSubscriptionEvent,\n  BridgeTaskSnapshotOptions,\n} from '../../../domain/bridge-api.js';\nimport type {\n  BridgeMetadata,\n  Message,\n  Task,\n  TaskArtifactUpdateEvent,\n  TaskStatusUpdateEvent,\n} from '../../../domain/core-task.js';\nimport { cloneValue } from '../../../utils/clone.js';\nimport { getOctoFlowDbPath } from '../../../utils/octoflow-home.js';\nimport {\n  appendArtifactRecord,\n  appendHistoryRecord,\n  buildConversationFromTasks,\n  cloneTaskResult,\n  createTaskRecord,\n  projectTask,\n  resumeTaskRecord,\n  updateBridgeMetadataRecord,\n  updateStatusRecord,\n} from './shared.js';\nimport {\n  buildSubscription,\n  listConversationsQuery,\n  readConversationRecords,\n  readRecord,\n  transactTask,\n  writeRecord,\n} from './sqlite-queries.js';\nimport type {\n  AppendArtifactInput,\n  CreateTaskInput,\n  ResumeTaskInput,\n  SqliteTaskStoreConfig,\n  TaskStore,\n  TaskSubscriptionOptions,\n  UpdateStatusInput,\n} from './types.js';\n\nconst DEFAULT_BUSY_TIMEOUT_MS = 5_000;\nconst DEFAULT_POLL_INTERVAL_MS = 50;\n\ninterface SqliteTaskStoreOptions extends SqliteTaskStoreConfig {\n  path?: string;\n}\n\nexport class SqliteTaskStore implements TaskStore {\n  private readonly db: BetterSqlite3.Database;\n  private readonly pollIntervalMs: number;\n\n  constructor(options: SqliteTaskStoreOptions = {}) {\n    const dbPath = options.path ?? SqliteTaskStore.defaultPath();\n\n    if (dbPath !== ':memory:') {\n      const dir = dirname(\n        isAbsolute(dbPath) ? dbPath : join(process.cwd(), dbPath)\n      );\n      if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n    }\n\n    this.db = new BetterSqlite3(dbPath);\n    this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n\n    this.db.pragma('journal_mode = WAL');\n    this.db.pragma('synchronous = NORMAL');\n    this.db.pragma(\n      `busy_timeout = ${options.busyTimeoutMs ?? DEFAULT_BUSY_TIMEOUT_MS}`\n    );\n    this.db.pragma('foreign_keys = ON');\n\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS tasks (\n        id TEXT PRIMARY KEY,\n        context_id TEXT NOT NULL,\n        tenant TEXT,\n        created_at TEXT NOT NULL DEFAULT '',\n        last_modified TEXT NOT NULL DEFAULT '',\n        status_state TEXT NOT NULL DEFAULT 'submitted',\n        status_timestamp TEXT,\n        updated_at INTEGER NOT NULL DEFAULT 0,\n        task_json TEXT NOT NULL\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_tasks_context_id ON tasks(context_id);\n      CREATE INDEX IF NOT EXISTS idx_tasks_status_state ON tasks(status_state);\n      CREATE INDEX IF NOT EXISTS idx_tasks_tenant ON tasks(tenant);\n      CREATE INDEX IF NOT EXISTS idx_tasks_updated_at ON tasks(updated_at);\n\n      CREATE TABLE IF NOT EXISTS task_events (\n        sequence INTEGER PRIMARY KEY AUTOINCREMENT,\n        task_id TEXT NOT NULL,\n        event_kind TEXT NOT NULL,\n        payload_json TEXT NOT NULL,\n        created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,\n        FOREIGN KEY(task_id) REFERENCES tasks(id) ON DELETE CASCADE\n      );\n\n      CREATE INDEX IF NOT EXISTS idx_task_events_task_id ON task_events(task_id);\n      CREATE INDEX IF NOT EXISTS idx_task_events_task_sequence ON task_events(task_id, sequence);\n\n      CREATE TABLE IF NOT EXISTS checkpoints (\n        key TEXT PRIMARY KEY,\n        data TEXT NOT NULL,\n        created_at TEXT NOT NULL DEFAULT (datetime('now')),\n        updated_at TEXT NOT NULL DEFAULT (datetime('now'))\n      );\n\n      CREATE TABLE IF NOT EXISTS scheduler_tick_claims (\n        scheduler_id TEXT NOT NULL,\n        tick_at_ms INTEGER NOT NULL,\n        claimed_at INTEGER NOT NULL,\n        PRIMARY KEY (scheduler_id, tick_at_ms)\n      );\n    `);\n  }\n\n  createTask(input: CreateTaskInput): Promise<Task> {\n    const record = createTaskRecord(input);\n    writeRecord(this.db, record);\n    return Promise.resolve(cloneTaskResult(record.task));\n  }\n\n  claimTask(taskId: string): Promise<Task | undefined> {\n    const result = transactTask(this.db, taskId, (record) => {\n      if (record.task.status.state !== 'submitted') {\n        return { record, claimed: false };\n      }\n\n      const next = updateStatusRecord(record, {\n        taskId,\n        status: { state: 'working' },\n      });\n      return {\n        record: next.record,\n        event: {\n          kind: 'status-update',\n          event: next.event,\n        } satisfies BridgeSubscriptionEvent,\n        claimed: true,\n      };\n    });\n\n    if (!result.claimed) {\n      return Promise.resolve(undefined);\n    }\n\n    return Promise.resolve(cloneTaskResult(result.record.task));\n  }\n\n  resumeTask(input: ResumeTaskInput): Promise<Task> {\n    const nextRecord = transactTask(this.db, input.taskId, (record) => ({\n      record: resumeTaskRecord(record, input),\n    }));\n    return Promise.resolve(cloneTaskResult(nextRecord.record.task));\n  }\n\n  getTask(\n    taskId: string,\n    options: BridgeTaskSnapshotOptions = {}\n  ): Promise<Task | undefined> {\n    const record = readRecord(this.db, taskId);\n    return Promise.resolve(\n      record ? projectTask(record.task, options) : undefined\n    );\n  }\n\n  hasTask(taskId: string): Promise<boolean> {\n    const row = this.db.prepare('SELECT 1 FROM tasks WHERE id = ?').get(taskId);\n    return Promise.resolve(row != null);\n  }\n\n  listTasks(\n    input: BridgeListTasksOptions = {}\n  ): Promise<BridgeListTasksResult> {\n    const states =\n      input.state == null\n        ? []\n        : Array.isArray(input.state)\n          ? input.state\n          : [input.state];\n    const limit = Math.max(1, input.limit ?? 50);\n    const offset = Math.max(0, Number.parseInt(input.cursor ?? '0', 10) || 0);\n    const whereParts: string[] = [];\n    const params: Record<string, string | number | null> = { limit, offset };\n\n    if (input.contextId) {\n      whereParts.push('context_id = @contextId');\n      params.contextId = input.contextId;\n    }\n    if (input.tenant !== undefined) {\n      whereParts.push('tenant = @tenant');\n      params.tenant = input.tenant;\n    }\n    if (states.length > 0) {\n      const placeholders = states.map((state, index) => {\n        const key = `state${index}`;\n        params[key] = state;\n        return `@${key}`;\n      });\n      whereParts.push(`status_state IN (${placeholders.join(', ')})`);\n    }\n    if (input.statusTimestampAfter) {\n      whereParts.push('status_timestamp >= @statusTimestampAfter');\n      params.statusTimestampAfter = input.statusTimestampAfter;\n    }\n\n    const whereSql =\n      whereParts.length > 0 ? `WHERE ${whereParts.join(' AND ')}` : '';\n    type CountRow = { count: number };\n    type TaskRow = { task_json: string; updated_at: number };\n    const countRow = this.db\n      .prepare(`SELECT COUNT(*) AS count FROM tasks ${whereSql}`)\n      .get(params) as CountRow;\n    const rows = this.db\n      .prepare(\n        `\n      SELECT task_json, updated_at FROM tasks ${whereSql} ORDER BY updated_at DESC LIMIT @limit OFFSET @offset\n    `\n      )\n      .all(params) as TaskRow[];\n\n    // Client-side filtering for packId/parentTaskId (stored inside JSON metadata blob).\n    // Future optimisation: use json_extract() (Option B) or dedicated columns (Option C).\n    let parsed = rows.map((row) => ({\n      task: JSON.parse(row.task_json) as Task,\n      updatedAt: row.updated_at,\n    }));\n    if (input.packId) {\n      parsed = parsed.filter(\n        (r) => r.task.metadata?.bridge?.packId === input.packId\n      );\n    }\n    if (input.parentTaskId) {\n      parsed = parsed.filter(\n        (r) => r.task.metadata?.bridge?.parentTaskId === input.parentTaskId\n      );\n    }\n\n    return Promise.resolve({\n      tasks: parsed.map((record) => projectTask(record.task, input)),\n      nextCursor:\n        offset + limit < countRow.count ? String(offset + limit) : null,\n      pageSize: limit,\n      totalSize: parsed.length,\n    });\n  }\n\n  getConversation(\n    contextId: string,\n    options: BridgeConversationSnapshotOptions = {}\n  ): Promise<BridgeConversation | undefined> {\n    const records = readConversationRecords(this.db, contextId, options.tenant);\n    if (records.length === 0) return Promise.resolve(undefined);\n\n    return Promise.resolve(\n      buildConversationFromTasks(\n        records.map((r) => r.task),\n        options\n      )\n    );\n  }\n\n  listConversations(\n    input: BridgeListConversationsOptions = {}\n  ): Promise<BridgeListConversationsResult> {\n    return Promise.resolve(listConversationsQuery(this.db, input));\n  }\n\n  updateBridgeMetadata(\n    taskId: string,\n    bridgeMetadata: BridgeMetadata['bridge']\n  ): Promise<Task> {\n    const nextRecord = transactTask(this.db, taskId, (record) => ({\n      record: updateBridgeMetadataRecord(record, bridgeMetadata),\n    }));\n    return Promise.resolve(cloneTaskResult(nextRecord.record.task));\n  }\n\n  updateStatus(input: UpdateStatusInput): Promise<TaskStatusUpdateEvent> {\n    const result = transactTask(this.db, input.taskId, (record) => {\n      const next = updateStatusRecord(record, input);\n      return {\n        record: next.record,\n        event: {\n          kind: 'status-update',\n          event: next.event,\n        } satisfies BridgeSubscriptionEvent,\n      };\n    });\n\n    const event = result.event;\n    if (event.kind !== 'status-update') {\n      throw new Error('Unexpected task store event type');\n    }\n    return Promise.resolve(cloneValue(event.event));\n  }\n\n  appendArtifact(input: AppendArtifactInput): Promise<TaskArtifactUpdateEvent> {\n    const result = transactTask(this.db, input.taskId, (record) => {\n      const next = appendArtifactRecord(record, input);\n      return {\n        record: next.record,\n        event: {\n          kind: 'artifact-update',\n          event: next.event,\n        } satisfies BridgeSubscriptionEvent,\n      };\n    });\n\n    const event = result.event;\n    if (event.kind !== 'artifact-update') {\n      throw new Error('Unexpected task store event type');\n    }\n    return Promise.resolve(cloneValue(event.event));\n  }\n\n  appendHistory(\n    taskId: string,\n    message: Message,\n    historyLength?: number\n  ): Promise<Task> {\n    const nextRecord = transactTask(this.db, taskId, (record) => ({\n      record: appendHistoryRecord(record, message, historyLength),\n    }));\n    return Promise.resolve(cloneTaskResult(nextRecord.record.task));\n  }\n\n  subscribe(\n    taskId: string,\n    options: TaskSubscriptionOptions = {}\n  ): Promise<AsyncIterable<BridgeSubscriptionEvent>> {\n    try {\n      return Promise.resolve(\n        buildSubscription(this.db, taskId, this.pollIntervalMs, options)\n      );\n    } catch (error) {\n      return Promise.reject(\n        error instanceof Error ? error : new Error(String(error))\n      );\n    }\n  }\n\n  putCheckpoint(key: string, data: string): Promise<void> {\n    this.db\n      .prepare(\n        `\n      INSERT INTO checkpoints (key, data, updated_at) VALUES (?, ?, datetime('now'))\n      ON CONFLICT(key) DO UPDATE SET data = excluded.data, updated_at = datetime('now')\n    `\n      )\n      .run(key, data);\n    return Promise.resolve();\n  }\n\n  getCheckpoint(key: string): Promise<string | undefined> {\n    const row = this.db\n      .prepare('SELECT data FROM checkpoints WHERE key = ?')\n      .get(key) as { data: string } | undefined;\n    return Promise.resolve(row?.data);\n  }\n\n  deleteCheckpoint(key: string): Promise<void> {\n    this.db.prepare('DELETE FROM checkpoints WHERE key = ?').run(key);\n    return Promise.resolve();\n  }\n\n  listCheckpoints(prefix: string): Promise<string[]> {\n    const rows = this.db\n      .prepare('SELECT key FROM checkpoints WHERE key LIKE ? ORDER BY key')\n      .all(`${prefix}%`) as Array<{ key: string }>;\n    return Promise.resolve(rows.map((r) => r.key));\n  }\n\n  claimNextTick(tickAtMs: number, schedulerId = 'default'): Promise<boolean> {\n    const result = this.db\n      .prepare(\n        `\n      INSERT OR IGNORE INTO scheduler_tick_claims (scheduler_id, tick_at_ms, claimed_at)\n      VALUES (?, ?, ?)\n    `\n      )\n      .run(schedulerId, tickAtMs, Date.now());\n    return Promise.resolve(result.changes > 0);\n  }\n\n  close(): Promise<void> {\n    this.db.close();\n    return Promise.resolve();\n  }\n\n  static defaultPath(_workspace = process.cwd()): string {\n    return getOctoFlowDbPath('tasks');\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/adapters/data/task-store/types.d.ts

@@ -0,0 +1,109 @@
+import type { OctoFlowConfig } from '../../../config/config.js';
+import type { BridgeConversation, BridgeConversationSnapshotOptions, BridgeListConversationsOptions, BridgeListConversationsResult, BridgeListTasksOptions, BridgeListTasksResult, BridgeSubscriptionEvent, BridgeTaskSnapshotOptions, BridgeTaskSubscriptionOptions } from '../../../domain/bridge-api.js';
+import type { Artifact, BridgeMetadata, Message, Task, TaskArtifactUpdateEvent, TaskStatus, TaskStatusUpdateEvent } from '../../../domain/core-task.js';
+import type { ExternalTaskStoreConfig, TaskStoreConfig } from './config-types.js';
+export interface TaskRecord {
+    task: Task;
+    updatedAt: number;
+}
+export interface CreateTaskInput {
+    createdAt?: string;
+    contextId: string;
+    bridgeMetadata?: BridgeMetadata['bridge'];
+    historyLength?: number;
+    message: Message;
+    metadata?: Record<string, unknown>;
+    taskId?: string;
+    tenant?: string;
+}
+export interface ResumeTaskInput {
+    bridgeMetadata?: BridgeMetadata['bridge'];
+    historyLength?: number;
+    message: Message;
+    metadata?: Record<string, unknown>;
+    taskId: string;
+    tenant?: string;
+}
+export interface UpdateStatusInput {
+    final?: boolean;
+    metadata?: Record<string, unknown>;
+    status: TaskStatus;
+    taskId: string;
+}
+export interface AppendArtifactInput {
+    append?: boolean;
+    artifact: Artifact;
+    lastChunk?: boolean;
+    metadata?: Record<string, unknown>;
+    taskId: string;
+}
+export type TaskSubscriptionOptions = Pick<BridgeTaskSubscriptionOptions, 'after'>;
+export interface TaskStore {
+    appendArtifact(input: AppendArtifactInput): Promise<TaskArtifactUpdateEvent>;
+    appendHistory(taskId: string, message: Message, historyLength?: number): Promise<Task>;
+    claimTask(taskId: string): Promise<Task | undefined>;
+    createTask(input: CreateTaskInput): Promise<Task>;
+    getConversation(contextId: string, options?: BridgeConversationSnapshotOptions): Promise<BridgeConversation | undefined>;
+    getTask(taskId: string, options?: BridgeTaskSnapshotOptions): Promise<Task | undefined>;
+    hasTask(taskId: string): Promise<boolean>;
+    listConversations(input?: BridgeListConversationsOptions): Promise<BridgeListConversationsResult>;
+    listTasks(input?: BridgeListTasksOptions): Promise<BridgeListTasksResult>;
+    resumeTask(input: ResumeTaskInput): Promise<Task>;
+    subscribe(taskId: string, options?: TaskSubscriptionOptions): Promise<AsyncIterable<BridgeSubscriptionEvent>>;
+    updateBridgeMetadata(taskId: string, bridgeMetadata: BridgeMetadata['bridge']): Promise<Task>;
+    updateStatus(input: UpdateStatusInput): Promise<TaskStatusUpdateEvent>;
+    /** Store a checkpoint blob by key. Overwrites if the key already exists. */
+    putCheckpoint(key: string, data: string): Promise<void>;
+    /** Retrieve a checkpoint blob by key. Returns undefined if not found. */
+    getCheckpoint(key: string): Promise<string | undefined>;
+    /** Delete a checkpoint by key. No-op if the key does not exist. */
+    deleteCheckpoint(key: string): Promise<void>;
+    /** List checkpoint keys matching a prefix. */
+    listCheckpoints(prefix: string): Promise<string[]>;
+    /**
+     * Atomic single-claim leader election for a scheduler tick. Returns
+     * `true` if this caller wins the tick; returns `false` if another
+     * process (or an earlier call from the same process) already claimed
+     * it. Idempotent for the same `(schedulerId, tickAtMs)` pair.
+     *
+     * `tickAtMs` should already be tick-aligned by the caller — multi-process
+     * deployments must converge on the same value for the same tick. The
+     * default `schedulerId` is `'default'`; pass an explicit id when running
+     * multiple independent schedulers against one store.
+     *
+     * Used by `octoflow-scheduler` for multi-process leader election.
+     */
+    claimNextTick(tickAtMs: number, schedulerId?: string): Promise<boolean>;
+    close?(): Promise<void>;
+}
+export type { ExternalTaskStoreConfig, InMemoryTaskStoreConfig, SqliteTaskStoreConfig, TaskStoreConfig, } from './config-types.js';
+/**
+ * Marker interface for fully asynchronous TaskStore implementations
+ * (e.g. PostgreSQL, Redis, or worker-thread wrappers around SQLite).
+ *
+ * Pass an `AsyncTaskStoreAdapter` via `await createBridge({ taskStore })` as a
+ * first-class drop-in replacement for the default synchronous SQLite store.
+ */
+export interface AsyncTaskStoreAdapter extends TaskStore {
+    readonly type: 'async';
+}
+export interface TaskStoreConnectorContext {
+    config: ExternalTaskStoreConfig;
+    workspace: string;
+}
+export type TaskStoreConnector = (context: TaskStoreConnectorContext) => TaskStore;
+export type TaskStoreConnectors = Record<string, TaskStoreConnector>;
+export interface CreateTaskStoreOptions {
+    config?: Pick<OctoFlowConfig, 'storage' | 'taskStore'>;
+    storage?: boolean;
+    /** Named connectors used by `{ type: 'external', name }` configs. */
+    taskStoreConnectors?: TaskStoreConnectors;
+    /**
+     * Custom task store instance or config. When a `TaskStore` (or
+     * `AsyncTaskStoreAdapter`) is passed directly, it is used as-is —
+     * this is the escape hatch for custom async implementations.
+     */
+    taskStore?: TaskStore | TaskStoreConfig;
+    workspace?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/data/task-store/types.d.ts.map

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

package/dist/adapters/data/task-store/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/adapters/data/task-store/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/adapters/transport/a2a-client-helpers.d.ts

@@ -0,0 +1,26 @@
+import type { RunOptions } from '../../domain/core-client.js';
+import type { A2AMessage, A2ASendMessageResponse, A2AStreamResponse, A2ATaskState } from './wire-types.js';
+interface SseEvent {
+    id?: string;
+    data: string;
+}
+export declare function consumeSse(response: Response): AsyncGenerator<SseEvent>;
+export type A2AJsonRpcPayload<T> = {
+    error?: Record<string, unknown>;
+    result?: T;
+};
+export type A2ARunOptions = RunOptions & {
+    contextId?: string;
+};
+export declare function delay(ms: number): Promise<void>;
+export declare function buildUserMessage(prompt: string): A2AMessage;
+export declare function extractTextFromSendResponse(result: A2ASendMessageResponse): string;
+export declare function extractContextIdFromSendResponse(result: A2ASendMessageResponse): string | null;
+export declare function isTerminalState(state: A2ATaskState | undefined): boolean;
+export declare function exitCodeForState(state: A2ATaskState | undefined): number;
+export declare function extractTaskIdFromStream(result: A2AStreamResponse): string | undefined;
+export declare function extractContextIdFromStream(result: A2AStreamResponse): string | undefined;
+export declare function extractStateFromStream(result: A2AStreamResponse): A2ATaskState | undefined;
+export declare function extractTextFromStream(result: A2AStreamResponse): string;
+export {};
+//# sourceMappingURL=a2a-client-helpers.d.ts.map

package/dist/adapters/transport/a2a-client-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client-helpers.d.ts","sourceRoot":"","sources":["../../../src/adapters/transport/a2a-client-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,KAAK,EAEV,UAAU,EAEV,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,UAAU,QAAQ;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAuB,UAAU,CAC/B,QAAQ,EAAE,QAAQ,GACjB,cAAc,CAAC,QAAQ,CAAC,CAoC1B;AACD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AACF,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAM3D;AAsBD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,sBAAsB,GAC7B,MAAM,CAIR;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,sBAAsB,GAC7B,MAAM,GAAG,IAAI,CAEf;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAQxE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAExE;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GACxB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,iBAAiB,GACxB,MAAM,GAAG,SAAS,CAOpB;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,GACxB,YAAY,GAAG,SAAS,CAG1B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAOvE"}