@makaio/framework 1.0.0-dev-1781117225170 → 1.0.0-dev-1781354548379

package/dist/{index-C1uZLARQ.d.mts → index-DrGLAuZc.d.mts}

@@ -1,16 +1,18 @@
-import { r as ExecutionTarget } from "./schemas-BD-1NGmS.mjs";
-import { d as Turn$1 } from "./index--0CnhN0g.mjs";
-import { a as PipelineStep, o as SessionEditorAction, t as ActionCategory } from "./types-11QnNmpW.mjs";
-import { a as agents, o as sessions } from "./schema-CfuF2cXW.mjs";
+import { r as ExecutionTarget } from "./schemas-B5ToLwIs.mjs";
+import { d as Turn$1 } from "./index-C6BhKRnH.mjs";
+import { a as PipelineStep, o as SessionEditorAction, t as ActionCategory } from "./types-5Gw3iVpK.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
 import { ExtractSubjectPayload, SubjectDefinition } from "@makaio/framework/core";
 import { IMakaioBus } from "@makaio/framework/bus";
-import { AIReasoningLevel, AdapterRuntimeOptions, BranchKind, ContextWindowState, ExtensionContext, ForkOptions, ForkTransforms, IMakaioSession, MakaioSessionAgent, MakaioSessionEvent, Message, MessageBlock, MessageInput, ReasoningLevelMap, SessionContext, SessionExtensionContext, SessionLineage, SessionLineageKind, SessionMessage, SessionMessageBlock, TurnInitiator } from "@makaio/framework/contracts";
+import { AIReasoningLevel, AdapterRuntimeOptions, BranchKind, ContextWindowState, ForkOptions, ForkTransforms, IMakaioSession, MakaioSessionAgent, MakaioSessionEvent, Message, MessageBlock, MessageInput, ReasoningLevelMap, SessionContext, SessionExtensionContext, SessionLineage, SessionLineageKind, SessionMessage, SessionMessageBlock, TurnInitiator } from "@makaio/framework/contracts";
 import { BaseService } from "@makaio/framework/service-base";
-import * as _$drizzle_orm_sqlite_core0 from "drizzle-orm/sqlite-core";
 import * as _$_makaio_storage_core0 from "@makaio/framework/storage";
+import * as _$drizzle_orm_sqlite_core0 from "drizzle-orm/sqlite-core";
+import * as _$drizzle_orm_pg_core0 from "drizzle-orm/pg-core";
+import * as _$_makaio_storage_drizzle0 from "@makaio/framework/storage/drizzle";
 import { MakaioDatabase } from "@makaio/framework/storage/drizzle";
+import * as _$drizzle_orm0 from "drizzle-orm";
 
 //#region services/core/src/session/session-service.d.ts
 /**
@@ -18,7 +20,8 @@ import { MakaioDatabase } from "@makaio/framework/storage/drizzle";
  *
  * Registers the minimal, load-bearing session handlers that the framework SDK
  * requires: `session.create`, `session.get`, `session.list`, `session.close`,
- * `session.agent.added`, and `session.agent.removed`.
+ * `session.turn.await`, `session.restartAgents`, `session.agent.added`, and
+ * `session.agent.removed`.
  *
  * Host-specific handlers (search, update, resume, archive, purge, analytics,
  * context window, branching) are registered by the host session service which
@@ -64,7 +67,7 @@ declare class MakaioSessionService extends BaseService {
   /**
    * Initialize the service.
    *
-   * Registers the six framework-core session bus handlers, then performs
+   * Registers the framework-core session bus handlers, then performs
    * startup reconciliation to close any turns that were left `active` by a
    * prior process crash. Each orphaned turn is closed with status `'error'`
    * and a `'process-restart'` error message, and a `turn.completed` event is
@@ -103,8 +106,9 @@ interface CoreSessionServiceHandlerDeps {
 }
 /**
  * Registers the framework-core session service handlers:
- * `session.create`, `session.get`, `session.list`, `session.close`,
- * `session.update`, `session.archive`, `session.purge`,
+ * `session.create`, `session.get`, `session.list`, `session.turn.await`,
+ * `session.close`, `session.restartAgents`, `session.update`,
+ * `session.archive`, `session.purge`, `session.registerExternal`,
  * `session.agent.added`, and `session.agent.removed`.
  *
  * These handlers cover the minimal, load-bearing session contract for the
@@ -144,8 +148,8 @@ interface ISessionOrchestrator {
  * 1. Get or create session (via `getOrCreateSession`)
  * 2. Start agent if session has no agents — resolves the canonical
  *    `adapterName` from direct selections, uses `adapterId` directly when
- *    provided, otherwise resolves it via `AdapterRegistry`, then calls bare
- *    `AdapterSubjects.startAgent`
+ *    provided, otherwise resolves it via `AdapterRegistry`, resolves
+ *    provider credentials when selected, then calls `AdapterSubjects.startAgent`
  * 3. Resolve target agents (via `resolveTargetAgents`)
  * 4. Verify agent liveness and build recovery context for dead agents
  *    (requestOptional `AdapterSubjects.getAgent` + `buildRecoveryContext`)
@@ -186,7 +190,7 @@ declare class SessionOrchestrator implements ISessionOrchestrator {
    * Core flow:
    * 1. Get or create session
    * 2. Start agent if session has no agents (canonicalize direct selections,
-   *    resolve adapterId, bare startAgent)
+   *    resolve adapterId, resolve provider credentials, startAgent)
    * 3. Resolve target agents
    * 4. Verify agent liveness and build recovery context for dead agents
    * 5. Get or create turn (via SessionTurnManager)
@@ -922,6 +926,7 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -937,8 +942,8 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -964,6 +969,7 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -979,8 +985,8 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -1017,8 +1023,8 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
       adapterName: z.ZodString;
       status: z.ZodOptional<z.ZodEnum<{
         all: "all";
-        active: "active";
         idle: "idle";
+        active: "active";
         dead: "dead";
         disposed: "disposed";
       }>>;
@@ -1032,6 +1038,7 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -1047,8 +1054,8 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -1076,6 +1083,7 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -1091,8 +1099,8 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -1111,8 +1119,8 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
     request: z.ZodObject<{
       agentId: z.ZodString;
       status: z.ZodEnum<{
-        active: "active";
         idle: "idle";
+        active: "active";
         dead: "dead";
         disposed: "disposed";
       }>;
@@ -1145,8 +1153,10 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
   updateRuntime: {
     request: z.ZodObject<{
       agentId: z.ZodString;
+      adapterId: z.ZodOptional<z.ZodString>;
       cwd: z.ZodOptional<z.ZodString>;
       model: z.ZodOptional<z.ZodString>;
+      allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
       providerConfigId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -1292,6 +1302,25 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
         }, {}, {
           length: number | undefined;
         }>;
+        allowedDirectories: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+          name: string;
+          tableName: "agents";
+          dataType: "json";
+          columnType: "SQLiteTextJson";
+          data: string[];
+          driverParam: string;
+          notNull: false;
+          hasDefault: false;
+          isPrimaryKey: false;
+          isAutoincrement: false;
+          hasRuntimeDefault: false;
+          enumValues: undefined;
+          baseColumn: never;
+          identity: undefined;
+          generated: undefined;
+        }, {}, {
+          $type: string[];
+        }>;
         providerConfigId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
           name: "provider_config_id";
           tableName: "agents";
@@ -1430,7 +1459,7 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
           tableName: "agents";
           dataType: "string";
           columnType: "SQLiteText";
-          data: "active" | "idle" | "dead" | "disposed";
+          data: "idle" | "active" | "dead" | "disposed";
           driverParam: string;
           notNull: true;
           hasDefault: false;
@@ -1445,7 +1474,7 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
           length: number | undefined;
         }>;
         createdAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-          name: "created_at";
+          name: string;
           tableName: "agents";
           dataType: "number";
           columnType: "SQLiteInteger";
@@ -1462,7 +1491,7 @@ declare const AgentStorageNamespace: _$_makaio_storage_core0.StorageNamespaceDef
           generated: undefined;
         }, {}, {}>;
         lastActivityAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-          name: "last_activity_at";
+          name: string;
           tableName: "agents";
           dataType: "number";
           columnType: "SQLiteInteger";
@@ -1506,6 +1535,7 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -1521,8 +1551,8 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -1548,6 +1578,7 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -1563,8 +1594,8 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -1601,8 +1632,8 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
       adapterName: z.ZodString;
       status: z.ZodOptional<z.ZodEnum<{
         all: "all";
-        active: "active";
         idle: "idle";
+        active: "active";
         dead: "dead";
         disposed: "disposed";
       }>>;
@@ -1616,6 +1647,7 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -1631,8 +1663,8 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -1660,6 +1692,7 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
         adapterSessionId: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
         cwd: z.ZodOptional<z.ZodString>;
+        allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerConfigId: z.ZodOptional<z.ZodString>;
         personaId: z.ZodOptional<z.ZodString>;
         profileId: z.ZodOptional<z.ZodString>;
@@ -1675,8 +1708,8 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
           member: "member";
         }>;
         status: z.ZodEnum<{
-          active: "active";
           idle: "idle";
+          active: "active";
           dead: "dead";
           disposed: "disposed";
         }>;
@@ -1695,8 +1728,8 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
     request: z.ZodObject<{
       agentId: z.ZodString;
       status: z.ZodEnum<{
-        active: "active";
         idle: "idle";
+        active: "active";
         dead: "dead";
         disposed: "disposed";
       }>;
@@ -1729,8 +1762,10 @@ declare const AgentStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.
   updateRuntime: {
     request: z.ZodObject<{
       agentId: z.ZodString;
+      adapterId: z.ZodOptional<z.ZodString>;
       cwd: z.ZodOptional<z.ZodString>;
       model: z.ZodOptional<z.ZodString>;
+      allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
       providerConfigId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -1763,7 +1798,7 @@ declare function registerMemorySessionStorage(bus: IMakaioBus): () => void;
 /**
  * Register Drizzle-based session storage handlers.
  *
- * Persists sessions to SQLite/libSQL via Drizzle ORM.
+ * Persists sessions via Drizzle ORM.
  * Provides durable storage suitable for production deployments.
  *
  * CONCURRENCY INVARIANT: All handlers must use single-statement operations only.
@@ -1773,8 +1808,7 @@ declare function registerMemorySessionStorage(bus: IMakaioBus): () => void;
  * deadlocks on the same connection. Single statements serialize automatically
  * via SQLite's busy_timeout + WAL mode.
  * @param bus - The bus instance to register handlers on
- * @param db - The Drizzle database instance (any libSQL database)
- * @param _ctx - Extension context (unused; reserved for future use)
+ * @param db - The Drizzle database instance
  * @returns Cleanup function to unsubscribe all handlers
  * @example
  * ```typescript
@@ -1784,13 +1818,13 @@ declare function registerMemorySessionStorage(bus: IMakaioBus): () => void;
  *
  * const client = createClient({ url: 'file:./makaio.db' });
  * const db = drizzle(client);
- * const cleanup = registerDrizzleSessionStorage(bus, db, ctx);
+ * const cleanup = registerDrizzleSessionStorage(bus, db);
  *
  * // Later, when shutting down:
  * cleanup();
  * ```
  */
-declare function registerDrizzleSessionStorage(bus: IMakaioBus, db: MakaioDatabase, _ctx: ExtensionContext): () => void;
+declare function registerDrizzleSessionStorage(bus: IMakaioBus, db: MakaioDatabase): () => void;
 //#endregion
 //#region services/core/src/session/storage/agent-memory-handler.d.ts
 /**
@@ -1802,15 +1836,948 @@ declare function registerDrizzleSessionStorage(bus: IMakaioBus, db: MakaioDataba
  */
 declare function registerMemoryAgentStorage(bus: IMakaioBus): () => void;
 //#endregion
+//#region services/core/src/session/storage/schema.variants.d.ts
+/** Dialect variants for the session storage tables. */
+declare const sessionStorageSchema: _$_makaio_storage_drizzle0.DialectSchema<{
+  sessions: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
+    name: "sessions";
+    schema: undefined;
+    columns: {
+      sessionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "session_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      createdAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "sessions";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+      lastActivityAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "sessions";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+      status: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "status";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: "closed" | "discovered" | "active" | "archived";
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: ["active", "closed", "archived", "discovered"];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      leadAgentId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "lead_agent_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      parentSessionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "parent_session_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      contextInheritance: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "context_inheritance";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: "none" | "parent-history";
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: ["parent-history", "none"];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      rootSessionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "root_session_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      forkPointMessageId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "fork_point_message_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      branchKind: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "branch_kind";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: "fork" | "subagent" | "compress" | "branch" | "rewrite" | "coordinator" | "aside";
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: ["fork", "branch", "subagent", "compress", "rewrite", "coordinator", "aside"];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      adapterName: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "adapter_name";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      adapterSessionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "adapter_session_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      adapterId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "adapter_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      clientId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "client_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      clientAccountId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "client_account_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      lastClientIdentityObservation: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "last_client_identity_observation";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      isOrchestrated: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "sessions";
+        dataType: "boolean";
+        columnType: "SQLiteBoolean";
+        data: boolean;
+        driverParam: number;
+        notNull: false;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+      title: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "title";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      summary: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "summary";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      summaryUpdatedAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "sessions";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+      isImported: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "sessions";
+        dataType: "boolean";
+        columnType: "SQLiteBoolean";
+        data: boolean;
+        driverParam: number;
+        notNull: false;
+        hasDefault: true;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+      forkTransforms: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "fork_transforms";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      targetWorkingDirectory: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "target_working_directory";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      executionTargetId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "execution_target_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      approvalPolicyOverride: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "approval_policy_override";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: "reject" | "always-ask" | "full-access";
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: ["reject", "always-ask", "full-access"];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      spawningToolCallId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "spawning_tool_call_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      source: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "source";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      parentExternalSessionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "parent_external_session_id";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      logFilePath: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "log_file_path";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      discoveredAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "sessions";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+      importStatus: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "import_status";
+        tableName: "sessions";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: "discovered" | "imported" | "tracking";
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: ["discovered", "imported", "tracking"];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+    };
+    dialect: "sqlite";
+  }>;
+  agents: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
+    name: "agents";
+    schema: undefined;
+    columns: {
+      agentId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "agent_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      adapterId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "adapter_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      adapterName: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "adapter_name";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      sessionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "session_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      adapterSessionId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "adapter_session_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      model: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "model";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      cwd: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "cwd";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      allowedDirectories: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "agents";
+        dataType: "json";
+        columnType: "SQLiteTextJson";
+        data: string[];
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        $type: string[];
+      }>;
+      providerConfigId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "provider_config_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      personaId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "persona_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      profileId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "profile_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      harnessId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "harness_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      clientId: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "client_id";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      compressionMode: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "compression_mode";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: string;
+        driverParam: string;
+        notNull: false;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      role: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "role";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: "lead" | "member";
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: ["lead", "member"];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      status: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: "status";
+        tableName: "agents";
+        dataType: "string";
+        columnType: "SQLiteText";
+        data: "idle" | "active" | "dead" | "disposed";
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: ["idle", "active", "dead", "disposed"];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {
+        length: number | undefined;
+      }>;
+      createdAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "agents";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+      lastActivityAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+        name: string;
+        tableName: "agents";
+        dataType: "number";
+        columnType: "SQLiteInteger";
+        data: number;
+        driverParam: number;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: undefined;
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+      }, {}, {}>;
+    };
+    dialect: "sqlite";
+  }>;
+}>;
+//#endregion
 //#region services/core/src/session/storage/agent-drizzle-handler.d.ts
 /**
  * Register Drizzle-based agent storage handlers.
  *
- * Persists agents to SQLite/libSQL via Drizzle ORM.
+ * Persists agents via Drizzle ORM.
  * Provides durable storage suitable for production deployments.
  * @param bus - The bus instance to register handlers on
  * @param db - The MakaioDatabase instance
- * @param _ctx - Extension context (unused; reserved for future use)
  * @returns Cleanup function to unsubscribe all handlers
  * @example
  * ```typescript
@@ -1820,17 +2787,20 @@ declare function registerMemoryAgentStorage(bus: IMakaioBus): () => void;
  *
  * const client = createClient({ url: 'file:./makaio.db' });
  * const db = drizzle(client);
- * const cleanup = registerDrizzleAgentStorage(bus, db, ctx);
+ * const cleanup = registerDrizzleAgentStorage(bus, db);
  *
  * // Later, when shutting down:
  * cleanup();
  * ```
  */
-declare function registerDrizzleAgentStorage(bus: IMakaioBus, db: MakaioDatabase, _ctx: ExtensionContext): () => void;
+declare function registerDrizzleAgentStorage(bus: IMakaioBus, db: MakaioDatabase): () => void;
 //#endregion
 //#region services/core/src/session/storage/fts-search-handler.d.ts
 /**
  * Registers FTS-backed `storage:session.search` handler.
+ *
+ * Works on both SQLite (FTS5 MATCH) and Postgres (`tsvector @@ websearch_to_tsquery`)
+ * through the engine's FTS strategy, resolved once at registration.
  * @param bus - Bus instance used for handler registration
  * @param db - Drizzle database instance
  * @returns Cleanup function that unregisters the search handler
@@ -1838,6 +2808,8 @@ declare function registerDrizzleAgentStorage(bus: IMakaioBus, db: MakaioDatabase
 declare function registerFtsSearchHandler(bus: IMakaioBus, db: MakaioDatabase): () => void;
 //#endregion
 //#region services/core/src/session/storage/fts-search-utils.d.ts
+/** Canonical column shape of the agents table, resolved through the dialect seam. */
+type AgentsTable = typeof sessionStorageSchema.sqlite.agents;
 /**
  * Row shape returned by FTS session search queries.
  *
@@ -1846,7 +2818,7 @@ declare function registerFtsSearchHandler(bus: IMakaioBus, db: MakaioDatabase):
  * managed by the host-owned junction table after the sealed-sessions
  * refactor.
  */
-interface SearchSessionRow {
+type SearchSessionRow = {
   session_id: string;
   created_at: number;
   last_activity_at: number;
@@ -1866,7 +2838,7 @@ interface SearchSessionRow {
   summary_updated_at: number | null;
   fork_transforms: string | null;
   target_working_directory: string | null;
-}
+};
 /**
  * Filter parameters accepted by FTS search queries.
  *
@@ -1884,9 +2856,12 @@ interface SearchFilters {
  * @param sessionIds - Matched session IDs
  * @returns Agent rows keyed by session ID
  */
-declare function fetchAgentsBySession(db: MakaioDatabase, sessionIds: string[]): Promise<Map<string, Array<typeof agents.$inferSelect>>>;
+declare function fetchAgentsBySession(db: MakaioDatabase, sessionIds: string[]): Promise<Map<string, Array<AgentsTable['$inferSelect']>>>;
 /**
  * Resolves first-user-message previews for matched sessions.
+ *
+ * The same-timestamp tie-break is engine-owned (`StorageEngine.fts`): rowid
+ * insertion order on SQLite, lexicographic message_id order on Postgres.
  * @param db - Drizzle database instance
  * @param sessionIds - Matched session IDs
  * @returns First user message text keyed by session ID
@@ -1917,7 +2892,7 @@ declare function parseForkTransforms(raw: string | null): ForkTransforms | undef
  * @param countBySession - Message count map
  * @returns Session payload with preview block
  */
-declare function mapRowToSession(row: SearchSessionRow, sessionAgents: Array<typeof agents.$inferSelect>, previewBySession: Map<string, string | null>, countBySession: Map<string, number>): IMakaioSession & {
+declare function mapRowToSession(row: SearchSessionRow, sessionAgents: Array<AgentsTable['$inferSelect']>, previewBySession: Map<string, string | null>, countBySession: Map<string, number>): IMakaioSession & {
   preview: {
     messageCount: number;
     firstUserMessage: string | null;
@@ -1925,8 +2900,8 @@ declare function mapRowToSession(row: SearchSessionRow, sessionAgents: Array<typ
 };
 //#endregion
 //#region services/core/src/session/storage/drizzle-utils.d.ts
-type SessionRow = typeof sessions.$inferSelect;
-type AgentRow = typeof agents.$inferSelect;
+type SessionRow = (typeof sessionStorageSchema.sqlite.sessions)['$inferSelect'];
+type AgentRow = (typeof sessionStorageSchema.sqlite.agents)['$inferSelect'];
 /**
  * Preview maps for session list response hydration.
  */
@@ -1962,6 +2937,22 @@ declare function mapAgentsBySession(agentRows: AgentRow[]): Map<string, AgentRow
  */
 declare function fetchSessionPreviewMaps(db: MakaioDatabase, sessionIds: string[], includePreview: boolean): Promise<SessionPreviewMaps>;
 //#endregion
+//#region services/core/src/session/storage/ancestor-query.d.ts
+/**
+ * Get the ancestor chain for a session (self, parent, grandparent, ..., root).
+ * Uses recursive CTE for arbitrary depth.
+ * @param db - The Drizzle database instance
+ * @param sessionId - The session ID to get ancestors for
+ * @returns Array of session IDs from the given session to root
+ * @example
+ * ```typescript
+ * // For a chain: root -> fork1 -> fork2
+ * const chain = await getSessionAncestorChain(db, 'fork2');
+ * // Returns: ['fork2', 'fork1', 'root']
+ * ```
+ */
+declare function getSessionAncestorChain(db: MakaioDatabase, sessionId: string): Promise<string[]>;
+//#endregion
 //#region services/core/src/session/session-events/schema.d.ts
 /**
  * Session events table schema.
@@ -1982,13 +2973,88 @@ declare function fetchSessionPreviewMaps(db: MakaioDatabase, sessionIds: string[
  *
  * SEAM: The `sessionId` FK enables cascade delete when sessions are purged.
  * Future embeddings table can reference `eventId` for vector search.
+ *
+ * The `messages` table stays a hand-written twin (it carries a Postgres-only
+ * `content_tsv` generated column), so the `messageId` FK target comes from the
+ * twin's `messageIdColumnPair` thunk rather than a `columnPair` on a dual table.
  */
+declare const sessionEventsDual: _$_makaio_storage_drizzle0.DualTable<"session_events", {
+  /**
+   * Auto-increment ID for stable cursor-based pagination.
+   * Opaque to consumers — use eventId for external references.
+   */
+  id: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.HasDefault<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>>>, _$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm0.IsIdentity<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>, "always">>>>;
+  /**
+   * Makaio session ID (FK to sessions table).
+   * All events for a session are deleted when session is purged.
+   */
+  sessionId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"session_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"session_id", [string, ...string[]]>>>;
+  /**
+   * Unique event identifier (UUID).
+   * Used for deduplication and external references.
+   */
+  eventId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"event_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"event_id", [string, ...string[]]>>>;
+  /**
+   * Event timestamp (Unix ms).
+   * Used for ordering and time-based queries.
+   */
+  timestamp: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>>;
+  /**
+   * Event type discriminator.
+   *
+   * - 'message': Reference to messages table (conversation content)
+   * - 'agent.added': Agent joined session
+   * - 'turn.started': Turn began
+   * - 'turn.completed': Turn finished
+   * - 'user_message.sent/acknowledged/completed': User message lifecycle
+   */
+  type: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"type", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"type", [string, ...string[]]>>>;
+  /**
+   * Agent ID (nullable).
+   * Populated for agent.added events.
+   */
+  agentId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"agent_id", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"agent_id", [string, ...string[]]>>;
+  /**
+   * Adapter ID (nullable).
+   * Populated for agent.added events.
+   */
+  adapterId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"adapter_id", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"adapter_id", [string, ...string[]]>>;
+  /**
+   * Originating message ID for correlation.
+   * References the user message that triggered this event.
+   * NOT a FK to messages table - purely for correlation/grouping.
+   */
+  originatingMessageId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"originating_message_id", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"originating_message_id", [string, ...string[]]>>;
+  /**
+   * Reference to messages table.
+   * Populated for type='message' events.
+   * FK enables cascade delete when message is removed.
+   */
+  messageId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"message_id", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"message_id", [string, ...string[]]>>;
+  /**
+   * Turn ID for grouping.
+   * Groups all events within a single turn (user message → agent responses).
+   */
+  turnId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"turn_id", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"turn_id", [string, ...string[]]>>;
+  /**
+   * Extracted text content for search/embeddings.
+   * Populated for text-bearing events (messages, reasoning).
+   * NULL for structural events (tool.use, complete).
+   */
+  contentText: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"content_text", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"content_text", [string, ...string[]]>>;
+  /**
+   * Full event payload as JSON string.
+   * Contains complete data for exact API reconstruction.
+   */
+  payload: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"payload", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"payload", [string, ...string[]]>>>;
+}>;
+/** SQLite face of the `session_events` table (canonical schema). */
 declare const sessionEvents: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
   name: "session_events";
   schema: undefined;
   columns: {
     id: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "id";
+      name: string;
       tableName: "session_events";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -2043,7 +3109,7 @@ declare const sessionEvents: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
       length: number | undefined;
     }>;
     timestamp: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "timestamp";
+      name: string;
       tableName: "session_events";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -2216,6 +3282,10 @@ declare const sessionEvents: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
 }>;
 /**
  * Type for inserting a new session event.
+ *
+ * Derived from the SQLite face: SQLite keeps the auto-increment `id` optional,
+ * while the Postgres `GENERATED ALWAYS AS IDENTITY` face omits it. The insert
+ * path never supplies `id`, so the SQLite face is the canonical insert shape.
  */
 type InsertSessionEvent = typeof sessionEvents.$inferInsert;
 /**
@@ -2255,11 +3325,10 @@ declare function registerMemorySessionEventStorage(bus: IMakaioBus): () => void;
 /**
  * Register Drizzle-based session event storage handlers.
  *
- * Persists events to SQLite/libSQL via Drizzle ORM with cursor-based
- * pagination and content extraction for future FTS/embedding support.
+ * Persists events via Drizzle ORM with cursor-based pagination and content
+ * extraction for future FTS/embedding support.
  * @param bus - The bus instance to register handlers on
- * @param db - The Drizzle database instance (any libSQL database)
- * @param _ctx - Extension context (unused; reserved for future use)
+ * @param db - The Drizzle database instance
  * @returns Cleanup function to unsubscribe all handlers
  * @example
  * ```typescript
@@ -2269,13 +3338,13 @@ declare function registerMemorySessionEventStorage(bus: IMakaioBus): () => void;
  *
  * const client = createClient({ url: 'file:./makaio.db' });
  * const db = drizzle(client);
- * const cleanup = registerDrizzleSessionEventStorage(bus, db, ctx);
+ * const cleanup = registerDrizzleSessionEventStorage(bus, db);
  *
  * // Later, when shutting down:
  * cleanup();
  * ```
  */
-declare function registerDrizzleSessionEventStorage(bus: IMakaioBus, db: MakaioDatabase, _ctx: ExtensionContext): () => void;
+declare function registerDrizzleSessionEventStorage(bus: IMakaioBus, db: MakaioDatabase): () => void;
 //#endregion
 //#region services/core/src/session/session-logger.d.ts
 /**
@@ -2383,6 +3452,33 @@ declare class SessionLogger {
  * Tracks byte offsets for incremental log file import.
  * Enables resuming import from the last processed position after restarts.
  */
+declare const importCursorsDual: _$_makaio_storage_drizzle0.DualTable<"import_cursors", {
+  /**
+   * Absolute path to the log file (primary key).
+   * Example: ~/.claude/projects/-Users-foo-project/abc123.jsonl
+   */
+  filePath: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"file_path", [string, ...string[]], number | undefined>>>, _$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"file_path", [string, ...string[]]>>>>;
+  /**
+   * Number of bytes successfully read and processed.
+   * Import resumes from this offset on next run.
+   * SQLite INTEGER is int8-capable; the Postgres face mirrors this with
+   * `bigint` ('number' mode) so large log files keep their resume cursor on
+   * both dialects. `'number'` mode bounds values at 2^53, the same bound the
+   * JS write path (`stat.size`) has.
+   */
+  bytesRead: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>>;
+  /**
+   * ISO 8601 timestamp of file's last modification when cursor was saved.
+   * Used to detect file rotation (file shrunk = rotation occurred).
+   */
+  lastModified: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"last_modified", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"last_modified", [string, ...string[]]>>>;
+  /**
+   * Timestamp when this cursor was last updated.
+   * Stored as Unix timestamp in milliseconds.
+   */
+  updatedAt: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>>;
+}>;
+/** SQLite face of the `import_cursors` table (canonical schema). */
 declare const importCursors: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
   name: "import_cursors";
   schema: undefined;
@@ -2407,7 +3503,7 @@ declare const importCursors: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
       length: number | undefined;
     }>;
     bytesRead: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "bytes_read";
+      name: string;
       tableName: "import_cursors";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -2443,7 +3539,7 @@ declare const importCursors: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
       length: number | undefined;
     }>;
     updatedAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "updated_at";
+      name: string;
       tableName: "import_cursors";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -2471,25 +3567,167 @@ declare const importCursors: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
  * On restart, import continues from the last processed byte offset.
  * @param bus - The bus instance to register handlers on
  * @param db - Drizzle database instance
- * @param _ctx - Extension context (unused; reserved for future use)
  * @returns Cleanup function to unsubscribe all handlers
  * @example
  * ```typescript
  * import { registerDrizzleImportCursorStorage } from '@makaio/framework/services/session';
  *
- * const cleanup = registerDrizzleImportCursorStorage(bus, db, ctx);
+ * const cleanup = registerDrizzleImportCursorStorage(bus, db);
  *
  * // Later, when shutting down:
  * cleanup();
  * ```
  */
-declare function registerDrizzleImportCursorStorage(bus: IMakaioBus, db: MakaioDatabase, _ctx: ExtensionContext): () => void;
+declare function registerDrizzleImportCursorStorage(bus: IMakaioBus, db: MakaioDatabase): () => void;
+//#endregion
+//#region services/core/src/session/embeddings/index-manager.d.ts
+/**
+ * Manages dynamic embedding index tables per model.
+ *
+ * Each embedding model gets its own indexed table for efficient
+ * vector similarity search. Tables are created on-demand when
+ * a new model is used.
+ *
+ * ## Table Structure
+ *
+ * Each table (`embeddings_idx_<model_slug>`) contains:
+ * - `entity_type`: Type of entity (e.g., 'session', 'message')
+ * - `entity_id`: ID of the entity
+ * - `embedding`: Vector data in the engine's binary column type
+ *   (`BLOB` on SQLite — F32_BLOB in libsql production — `bytea` on Postgres)
+ *
+ * Everything dialect-specific (binary column type, catalog existence probes)
+ * is delegated to the storage engine serving the handle's dialect.
+ *
+ * ## Design Rationale
+ *
+ * Per-model tables enable:
+ * 1. Efficient vector indexing (one index per embedding dimension)
+ * 2. Model-specific optimizations
+ * 3. Easy cleanup when models are deprecated
+ * 4. Ensemble search across multiple models
+ * @example
+ * ```typescript
+ * const manager = new EmbeddingIndexManager(db);
+ *
+ * // Create/ensure table for a model
+ * await manager.ensureIndexTable('text-embedding-3-small', 1536);
+ *
+ * // Insert embedding
+ * await manager.upsertIndexed(
+ *   'text-embedding-3-small',
+ *   1536,
+ *   'session',
+ *   'session-123',
+ *   embedding
+ * );
+ *
+ * // Search similar
+ * const results = await manager.searchSimilar(
+ *   'text-embedding-3-small',
+ *   queryEmbedding,
+ *   10
+ * );
+ * ```
+ */
+declare class EmbeddingIndexManager {
+  /** Raw SQL executor for all dynamic (non-schema) table operations. */
+  private readonly rawSql;
+  /** Engine serving the handle's dialect — binary column type and catalog probes. */
+  private readonly engine;
+  /**
+   * Cache of known tables to avoid redundant CREATE TABLE checks.
+   */
+  private readonly knownTables;
+  /**
+   * @param db - Drizzle database instance for all dynamic table operations.
+   */
+  constructor(db: MakaioDatabase);
+  /**
+   * Slugify model name for use as table suffix.
+   *
+   * Converts model names to valid SQLite identifiers by replacing
+   * non-alphanumeric characters with underscores and lowercasing.
+   * @param model - The model name (e.g., 'text-embedding-3-small')
+   * @returns Slugified name (e.g., 'text_embedding_3_small')
+   * @example
+   * slugify('text-embedding-3-small') // 'text_embedding_3_small'
+   * slugify('nomic-embed-text')       // 'nomic_embed_text'
+   * slugify('all-MiniLM-L6-v2')       // 'all_minilm_l6_v2'
+   */
+  private slugify;
+  /**
+   * Create a stable hash suffix to avoid slug collisions.
+   * @param model - The model name
+   * @returns Short lowercase hash string
+   */
+  private hashModel;
+  /**
+   * Get table name for a model.
+   * @param model - The model name
+   * @returns Full table name with prefix
+   */
+  getTableName(model: string): string;
+  /**
+   * Ensure index table exists for a model.
+   *
+   * Creates the table with a binary column for vector storage if not exists
+   * (`BLOB` on SQLite, `bytea` on Postgres).
+   * Uses in-memory cache to avoid redundant CREATE TABLE statements.
+   *
+   * Note: In production with libsql, F32_BLOB would be used for native
+   * vector operations. Standard SQLite uses BLOB as fallback.
+   * @param model - The model name
+   * @param _dimensions - Number of dimensions (reserved for F32_BLOB validation)
+   * @returns The table name
+   */
+  ensureIndexTable(model: string, _dimensions: number): Promise<string>;
+  /**
+   * Insert or update embedding in index table.
+   * @param model - The model name
+   * @param dimensions - Number of dimensions
+   * @param entityType - Type of entity (e.g., 'session', 'message')
+   * @param entityId - ID of the entity
+   * @param embedding - The embedding vector
+   */
+  upsertIndexed(model: string, dimensions: number, entityType: string, entityId: string, embedding: Float32Array): Promise<void>;
+  /**
+   * Search for similar embeddings using Euclidean distance.
+   *
+   * Note: In production with libsql vector extensions, this would use
+   * native vector distance operators. This implementation provides a
+   * basic fallback using manual distance calculation.
+   * @param model - The model name
+   * @param queryEmbedding - The query embedding vector
+   * @param limit - Maximum number of results (default: 10)
+   * @returns Array of results with entity info and distance
+   */
+  searchSimilar(model: string, queryEmbedding: Float32Array, limit?: number): Promise<Array<{
+    entityType: string;
+    entityId: string;
+    distance: number;
+  }>>;
+  /**
+   * Delete embedding by entity.
+   * @param model - The model name
+   * @param entityType - Type of entity
+   * @param entityId - ID of the entity
+   */
+  deleteByEntity(model: string, entityType: string, entityId: string): Promise<void>;
+  /**
+   * Calculate Euclidean distance between two vectors.
+   * @param a - First vector
+   * @param b - Second vector
+   * @returns The Euclidean distance
+   */
+  private euclideanDistance;
+}
 //#endregion
 //#region services/core/src/session/turns/drizzle-handler.d.ts
 /**
  * Register Drizzle-based turn storage handlers.
  *
- * Manages turn lifecycle in SQLite/libSQL via Drizzle ORM.
+ * Manages turn lifecycle via Drizzle ORM.
  *
  * CONCURRENCY INVARIANT: All handlers must use single-statement operations only.
  * Storage handlers share a single DB connection. Fire-and-forget bus events
@@ -2499,10 +3737,9 @@ declare function registerDrizzleImportCursorStorage(bus: IMakaioBus, db: MakaioD
  * via SQLite's busy_timeout + WAL mode.
  * @param bus - The bus instance to register handlers on
  * @param db - The Drizzle database instance
- * @param _ctx - Extension context (unused; reserved for future use)
  * @returns Cleanup function to unsubscribe all handlers
  */
-declare function registerDrizzleTurnStorage(bus: IMakaioBus, db: MakaioDatabase, _ctx: ExtensionContext): () => void;
+declare function registerDrizzleTurnStorage(bus: IMakaioBus, db: MakaioDatabase): () => void;
 //#endregion
 //#region services/core/src/session/turns/memory-handler.d.ts
 /**
@@ -2526,6 +3763,57 @@ declare function registerMemoryTurnStorage(bus: IMakaioBus): () => void;
  * - Links to session via FK for cascade delete
  * - Status tracks completion state for UI progress indication
  */
+declare const turnsDual: _$_makaio_storage_drizzle0.DualTable<"turns", {
+  /**
+   * Unique turn identifier (UUID).
+   */
+  turnId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"turn_id", [string, ...string[]], number | undefined>>>, _$drizzle_orm0.IsPrimaryKey<_$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"turn_id", [string, ...string[]]>>>>;
+  /**
+   * Foreign key to the parent session.
+   * Cascade deletes when session is removed.
+   */
+  sessionId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"session_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"session_id", [string, ...string[]]>>>;
+  /**
+   * Monotonic per-session ordinal (1-based).
+   * Assigned atomically at creation to preserve insertion order.
+   * Plain integer counter — stays integer on both dialects.
+   */
+  turnNumber: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgIntegerBuilderInitial<string>>>;
+  /**
+   * Turn start timestamp (Unix ms).
+   * When the user message was received.
+   */
+  startedAt: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>>;
+  /**
+   * Turn completion timestamp (Unix ms).
+   * When all agents have responded. NULL while in progress.
+   */
+  completedAt: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>, _$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>;
+  /**
+   * Turn status.
+   * - 'active': Turn in progress, agents responding
+   * - 'completed': All agents have responded
+   * - 'error': Turn failed with error
+   */
+  status: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"status", ["active", "completed", "error"], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"status", ["active", "completed", "error"]>>>;
+  /**
+   * Error message if status is 'error'.
+   * NULL for successful turns.
+   */
+  error: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"error", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"error", [string, ...string[]]>>;
+  /**
+   * Aggregated usage/cost for this turn.
+   * Populated on turn completion. Stored as JSON string.
+   * @see TurnUsageSchema in libs/contracts for structure definition
+   */
+  usage: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"usage", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"usage", [string, ...string[]]>>;
+  /**
+   * Turn origin metadata for loop prevention and audit.
+   * Stored as hand-stringified JSON because turn.create uses a raw SQL CTE.
+   */
+  initiator: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"initiator", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"initiator", [string, ...string[]]>>;
+}>;
+/** SQLite face of the `turns` table (canonical schema). */
 declare const turns: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
   name: "turns";
   schema: undefined;
@@ -2569,7 +3857,7 @@ declare const turns: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
       length: number | undefined;
     }>;
     turnNumber: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "turn_number";
+      name: string;
       tableName: "turns";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -2586,7 +3874,7 @@ declare const turns: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
       generated: undefined;
     }, {}, {}>;
     startedAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "started_at";
+      name: string;
       tableName: "turns";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -2603,7 +3891,7 @@ declare const turns: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
       generated: undefined;
     }, {}, {}>;
     completedAt: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "completed_at";
+      name: string;
       tableName: "turns";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -2676,6 +3964,25 @@ declare const turns: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
     }, {}, {
       length: number | undefined;
     }>;
+    initiator: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
+      name: "initiator";
+      tableName: "turns";
+      dataType: "string";
+      columnType: "SQLiteText";
+      data: string;
+      driverParam: string;
+      notNull: false;
+      hasDefault: false;
+      isPrimaryKey: false;
+      isAutoincrement: false;
+      hasRuntimeDefault: false;
+      enumValues: [string, ...string[]];
+      baseColumn: never;
+      identity: undefined;
+      generated: undefined;
+    }, {}, {
+      length: number | undefined;
+    }>;
   };
   dialect: "sqlite";
 }>;
@@ -2692,13 +3999,12 @@ type SelectTurn = typeof turns.$inferSelect;
 /**
  * Register Drizzle-based message storage handlers.
  *
- * Manages message persistence in SQLite/libSQL via Drizzle ORM.
+ * Manages message persistence via Drizzle ORM.
  * @param bus - The bus instance to register handlers on
  * @param db - The Drizzle database instance
- * @param _ctx - Extension context (unused; reserved for future use)
  * @returns Cleanup function to unsubscribe all handlers
  */
-declare function registerDrizzleMessageStorage(bus: IMakaioBus, db: MakaioDatabase, _ctx: ExtensionContext): () => void;
+declare function registerDrizzleMessageStorage(bus: IMakaioBus, db: MakaioDatabase): () => void;
 //#endregion
 //#region services/core/src/session/messages/memory-handler.d.ts
 /**
@@ -2901,7 +4207,7 @@ declare const messages: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
       length: number | undefined;
     }>;
     timestamp: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "timestamp";
+      name: string;
       tableName: "messages";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -3116,7 +4422,7 @@ declare const MessageRoutingNamespace: _$_makaio_storage_core0.StorageNamespaceD
           length: number | undefined;
         }>;
         timestamp: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-          name: "timestamp";
+          name: string;
           tableName: "message_routing";
           dataType: "number";
           columnType: "SQLiteInteger";
@@ -3243,13 +4549,12 @@ declare const MessageRoutingSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core
 /**
  * Register Drizzle-based message routing storage handlers.
  *
- * Manages message delivery tracking in SQLite/libSQL via Drizzle ORM.
+ * Manages message delivery tracking via Drizzle ORM.
  * @param bus - The bus instance to register handlers on
  * @param db - The Drizzle database instance
- * @param _ctx - Extension context (unused; reserved for future use)
  * @returns Cleanup function to unsubscribe all handlers
  */
-declare function registerDrizzleMessageRoutingStorage(bus: IMakaioBus, db: MakaioDatabase, _ctx: ExtensionContext): () => void;
+declare function registerDrizzleMessageRoutingStorage(bus: IMakaioBus, db: MakaioDatabase): () => void;
 //#endregion
 //#region services/core/src/session/message-routing/schema.d.ts
 /**
@@ -3264,7 +4569,39 @@ declare function registerDrizzleMessageRoutingStorage(bus: IMakaioBus, db: Makai
  * - Composite primary key allows multiple status entries per message-agent pair
  * - Enables tracking of delivery lifecycle for each target agent
  * - Supports querying "which agents have completed for this message?"
+ *
+ * The `messages` table stays a hand-written twin (it carries a Postgres-only
+ * `content_tsv` generated column), so the FK target comes from the twin's
+ * `messageIdColumnPair` thunk rather than a `columnPair` on a dual table.
  */
+declare const messageRoutingDual: _$_makaio_storage_drizzle0.DualTable<"message_routing", {
+  /**
+   * Foreign key to the message being routed.
+   * Cascade deletes when message is removed.
+   */
+  messageId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"message_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"message_id", [string, ...string[]]>>>;
+  /**
+   * Target agent ID.
+   */
+  agentId: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"agent_id", [string, ...string[]], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"agent_id", [string, ...string[]]>>>;
+  /**
+   * Routing status.
+   * - 'sent': Message dispatched to agent's queue
+   * - 'acknowledged': Agent received and started processing
+   * - 'completed': Agent finished responding
+   */
+  status: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"status", ["sent", "acknowledged", "completed"], number | undefined>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgTextBuilderInitial<"status", ["sent", "acknowledged", "completed"]>>>;
+  /**
+   * Status change timestamp (Unix ms).
+   */
+  timestamp: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm0.NotNull<_$drizzle_orm_sqlite_core0.SQLiteIntegerBuilderInitial<string>>, _$drizzle_orm0.NotNull<_$drizzle_orm_pg_core0.PgBigInt53BuilderInitial<string>>>;
+  /**
+   * Error message if routing failed.
+   * NULL for successful routing.
+   */
+  error: _$_makaio_storage_drizzle0.DualBuilder<_$drizzle_orm_sqlite_core0.SQLiteTextBuilderInitial<"error", [string, ...string[]], number | undefined>, _$drizzle_orm_pg_core0.PgTextBuilderInitial<"error", [string, ...string[]]>>;
+}>;
+/** SQLite face of the `message_routing` table (canonical schema). */
 declare const messageRouting: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<{
   name: "message_routing";
   schema: undefined;
@@ -3327,7 +4664,7 @@ declare const messageRouting: _$drizzle_orm_sqlite_core0.SQLiteTableWithColumns<
       length: number | undefined;
     }>;
     timestamp: _$drizzle_orm_sqlite_core0.SQLiteColumn<{
-      name: "timestamp";
+      name: string;
       tableName: "message_routing";
       dataType: "number";
       columnType: "SQLiteInteger";
@@ -3637,4 +4974,4 @@ declare function buildSessionContext(bus: IMakaioBus, options: BuildContextOptio
  */
 declare function getFullConversation(bus: IMakaioBus, sessionId: string): Promise<ContextAssemblyResult>;
 //#endregion
-export { registerMemoryAgentStorage as $, registerDrizzleImportCursorStorage as A, buildRecoveryContext as At, SessionPreviewMaps as B, AdapterRegistry as Bt, registerMemoryMessageStorage as C, buildTurnInitiator as Ct, turns as D, ensureAgentModel as Dt, SelectTurn as E, ensureAgentCwd as Et, registerDrizzleSessionEventStorage as F, getOrCreateSession as Ft, SearchSessionRow as G, mapAgentsBySession as H, SessionOrchestrator as Ht, registerMemorySessionEventStorage as I, resolveTargetAgents as It, fetchPreviewBySession as J, fetchAgentsBySession as K, InsertSessionEvent as L, extractTextContent as Lt, EventTransform as M, resolveExecutionTarget as Mt, SessionLogger as N, resolveModelCapabilities as Nt, registerMemoryTurnStorage as O, recoverAgent as Ot, SessionLoggerOptions as P, findTurnByAgent as Pt, registerDrizzleAgentStorage as Q, SelectSessionEvent as R, normalizeToBlocks as Rt, messages as S, SessionContextWindowState as St, InsertTurn as T, buildRecoveryContextWithPipeline as Tt, mapToSession as U, registerCoreSessionServiceHandlers as Ut, fetchSessionPreviewMaps as V, ISessionOrchestrator as Vt, SearchFilters as W, MakaioSessionService as Wt, parseForkTransforms as X, mapRowToSession as Y, registerFtsSearchHandler as Z, registerDrizzleMessageRoutingStorage as _, registerGetStatusCountsHandler as _t, kindToBranchKind as a, createSessionExtensionContext as at, InsertMessage as b, AgentContextState as bt, registerSpawningToolCallResolver as c, FallbackRuntimeOptions as ct, MakaioSession as d, normalizeSelectionString as dt, registerDrizzleSessionStorage as et, MakaioSessionConfig as f, resolveAdapterNameById as ft, messageRouting as g, actionRegistry as gt, SelectMessageRouting as h, resetBuiltInActionsRegistration as ht, ContextAssemblyResult as i, SessionExtensionContextImpl as it, importCursors as j, resolveAdapterId as jt, registerDrizzleTurnStorage as k, verifyAndRecoverAgents as kt, registerCompressLineageResolver as l, pickFallbackRuntimeOptions as lt, InsertMessageRouting as m, registerBuiltInActions as mt, buildSessionContext as n, AgentStorageNamespace as nt, toSessionLineage as o, SessionBridge as ot, StartTurnOptions as p, registerListActionsHandler as pt, fetchMessageCountsBySession as q, BuildContextOptions as r, AgentStorageSubjects as rt, registerSessionDiscoveredHandler as s, assembleForkContext as st, getFullConversation as t, registerMemorySessionStorage as tt, registerParentResolver as u, CONNECTOR_SWAP_DEFAULT_PIPELINE as ut, MessageRoutingNamespace as v, registerResumeHandler as vt, registerDrizzleMessageStorage as w, RecoveryConfig as wt, SelectMessage as x, ContextWindowTrackerConfig as xt, MessageRoutingSubjects as y, ContextWindowTracker as yt, sessionEvents as z, TurnContextEnricher as zt };
+export { fetchMessageCountsBySession as $, registerMemoryTurnStorage as A, RecoveryConfig as At, registerMemorySessionEventStorage as B, findTurnByAgent as Bt, messages as C, registerGetStatusCountsHandler as Ct, SelectTurn as D, ContextWindowTrackerConfig as Dt, InsertTurn as E, AgentContextState as Et, importCursorsDual as F, verifyAndRecoverAgents as Ft, getSessionAncestorChain as G, TurnContextEnricher as Gt, SelectSessionEvent as H, resolveTargetAgents as Ht, EventTransform as I, buildRecoveryContext as It, mapAgentsBySession as J, SessionOrchestrator as Jt, SessionPreviewMaps as K, AdapterRegistry as Kt, SessionLogger as L, resolveAdapterId as Lt, EmbeddingIndexManager as M, ensureAgentCwd as Mt, registerDrizzleImportCursorStorage as N, ensureAgentModel as Nt, turns as O, SessionContextWindowState as Ot, importCursors as P, recoverAgent as Pt, fetchAgentsBySession as Q, SessionLoggerOptions as R, resolveExecutionTarget as Rt, SelectMessage as S, actionRegistry as St, registerDrizzleMessageStorage as T, ContextWindowTracker as Tt, sessionEvents as U, extractTextContent as Ut, InsertSessionEvent as V, getOrCreateSession as Vt, sessionEventsDual as W, normalizeToBlocks as Wt, SearchFilters as X, MakaioSessionService as Xt, mapToSession as Y, registerCoreSessionServiceHandlers as Yt, SearchSessionRow as Z, messageRoutingDual as _, normalizeSelectionString as _t, kindToBranchKind as a, registerMemoryAgentStorage as at, MessageRoutingSubjects as b, registerBuiltInActions as bt, registerSpawningToolCallResolver as c, AgentStorageNamespace as ct, MakaioSession as d, createSessionExtensionContext as dt, fetchPreviewBySession as et, MakaioSessionConfig as f, SessionBridge as ft, messageRouting as g, CONNECTOR_SWAP_DEFAULT_PIPELINE as gt, SelectMessageRouting as h, pickFallbackRuntimeOptions as ht, ContextAssemblyResult as i, registerDrizzleAgentStorage as it, registerDrizzleTurnStorage as j, buildRecoveryContextWithPipeline as jt, turnsDual as k, buildTurnInitiator as kt, registerCompressLineageResolver as l, AgentStorageSubjects as lt, InsertMessageRouting as m, FallbackRuntimeOptions as mt, buildSessionContext as n, parseForkTransforms as nt, toSessionLineage as o, registerDrizzleSessionStorage as ot, StartTurnOptions as p, assembleForkContext as pt, fetchSessionPreviewMaps as q, ISessionOrchestrator as qt, BuildContextOptions as r, registerFtsSearchHandler as rt, registerSessionDiscoveredHandler as s, registerMemorySessionStorage as st, getFullConversation as t, mapRowToSession as tt, registerParentResolver as u, SessionExtensionContextImpl as ut, registerDrizzleMessageRoutingStorage as v, resolveAdapterNameById as vt, registerMemoryMessageStorage as w, registerResumeHandler as wt, InsertMessage as x, resetBuiltInActionsRegistration as xt, MessageRoutingNamespace as y, registerListActionsHandler as yt, registerDrizzleSessionEventStorage as z, resolveModelCapabilities as zt };