@adonis-agora/agent 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @adonis-agora/agent
 
+## 0.25.0
+
+### Minor Changes
+
+- [#74](https://github.com/DavideCarvalho/adonis-agora-agent/pull/74) [`9776fdc`](https://github.com/DavideCarvalho/adonis-agora-agent/commit/9776fdce96ab283f76bb24c6a31610e9ea91e17d) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Fix the published migration, which threw against any database the library had already provisioned.
+
+  `node ace configure @adonis-agora/agent` published `create_agent_tables` as raw DDL —
+  `this.schema.createTable('agent_thread', ...)` with no existence guard. But `autoCreateTables`
+  defaults to `true`, and the first use of any of the three stores that share those tables (the agent
+  store, the pricing store, the governance read-model) provisions them. So in any app that had run the
+  agent even once before migrating, `node ace migration:run` died with `table "agent_thread" already
+exists`. Reported from a real consumer upgrade.
+
+  The stub now delegates to `createAgentTables` / `dropAgentTables` instead of reproducing the DDL, with
+  `disableTransactions = true` (the helper takes its own pooled connection, which would otherwise
+  deadlock against `pool: { max: 1 }`). Drift stops being something to test for and becomes impossible:
+  the migration and the auto-created schema are the same code.
+
+  The separate `create_agent_run_tracking` stub is gone — one schema, one migration. Its `run_id` columns
+  were already inline in the table DDL for a fresh database, and `createAgentTables` now also ALTERs them
+  into a database provisioned before run tracking shipped, so collapsing the two loses no upgrade path.
+  That repair also fixes `autoCreateTables` on such a database, where the missing columns were previously
+  never added at all.
+
+  `create_agent_rag_chunks` had the same unguarded `createTable`; it now provisions through
+  `PgVectorStore.ensureSchema()`.
+
+  `createAgentTables` now resolves to the list of repairs it applied (it returned nothing before). Callers that only `await` it are unaffected.
+
+  **No action needed.** Migrations you have already run stay applied; this only changes what `configure`
+  generates from here on. If your `migration:run` was failing, re-run `node ace configure` and delete the
+  old `create_agent_tables` / `create_agent_run_tracking` files it had published.
+
 ## 0.24.0
 
 ### Minor Changes

package/dist/configure.d.ts

@@ -13,11 +13,10 @@ import type Configure from '@adonisjs/core/commands/configure';
  *    runtime scan when the barrel is absent);
  * 4. publishes `config/agent.ts`;
  * 5. publishes `config/mcp.ts` (the MCP endpoint config; the MCP provider is separate);
- * 6. publishes the Lucid migration for the five agent tables (run `node ace migration:run`; delete it
- *    if you only use the in-memory store);
- * 7. publishes the additive run-tracking migration (`agent_run` table + `run_id` columns) — run it
- *    after the base migration; delete it with the base one if you only use the in-memory store;
- * 8. publishes the pgvector migration for the RAG chunk table (Postgres + pgvector only; delete it
+ * 6. publishes the Lucid migration for the six agent tables (run `node ace migration:run`; delete it
+ *    if you only use the in-memory store). It delegates to `createAgentTables`, so it is idempotent
+ *    and safe to run against a database the library already auto-created;
+ * 7. publishes the pgvector migration for the RAG chunk table (Postgres + pgvector only; delete it
  *    unless you use `retrievers.pgvector({...})`).
  */
 export declare function configure(command: Configure): Promise<void>;

package/dist/configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAejD"}
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAG/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAcjD"}

package/dist/configure.js

@@ -13,11 +13,10 @@ import { stubsRoot } from './stubs/main.js';
  *    runtime scan when the barrel is absent);
  * 4. publishes `config/agent.ts`;
  * 5. publishes `config/mcp.ts` (the MCP endpoint config; the MCP provider is separate);
- * 6. publishes the Lucid migration for the five agent tables (run `node ace migration:run`; delete it
- *    if you only use the in-memory store);
- * 7. publishes the additive run-tracking migration (`agent_run` table + `run_id` columns) — run it
- *    after the base migration; delete it with the base one if you only use the in-memory store;
- * 8. publishes the pgvector migration for the RAG chunk table (Postgres + pgvector only; delete it
+ * 6. publishes the Lucid migration for the six agent tables (run `node ace migration:run`; delete it
+ *    if you only use the in-memory store). It delegates to `createAgentTables`, so it is idempotent
+ *    and safe to run against a database the library already auto-created;
+ * 7. publishes the pgvector migration for the RAG chunk table (Postgres + pgvector only; delete it
  *    unless you use `retrievers.pgvector({...})`).
  */
 export async function configure(command) {
@@ -31,7 +30,6 @@ export async function configure(command) {
     await codemods.makeUsingStub(stubsRoot, 'config/agent.stub', {});
     await codemods.makeUsingStub(stubsRoot, 'config/mcp.stub', {});
     await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_agent_tables.stub', {});
-    await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_agent_run_tracking.stub', {});
     await codemods.makeUsingStub(stubsRoot, 'database/migrations/create_agent_rag_chunks.stub', {});
 }
 //# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -1 +1 @@
-{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC;QACzD,MAAM,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;QAC7D,mGAAmG;QACnG,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,8CAA8C,EAAE,EAAE,CAAC,CAAC;IAC5F,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,oDAAoD,EAAE,EAAE,CAAC,CAAC;IAClG,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,kDAAkD,EAAE,EAAE,CAAC,CAAC;AAClG,CAAC"}
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,oCAAoC,CAAC,CAAC;QACzD,MAAM,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;QAC7D,mGAAmG;QACnG,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IACjE,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,8CAA8C,EAAE,EAAE,CAAC,CAAC;IAC5F,MAAM,QAAQ,CAAC,aAAa,CAAC,SAAS,EAAE,kDAAkD,EAAE,EAAE,CAAC,CAAC;AAClG,CAAC"}

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.24.0";
+export declare const VERSION = "0.25.0";
 export * from './types.js';
 export * from './spi/tool.js';
 export * from './base-tool.js';
@@ -57,7 +57,7 @@ export type { RolesPolicy as ToolAuthorizer } from './spi/roles-policy.js';
 export { InlineAgentRunner } from './runners/inline-agent-runner.js';
 export { LucidAgentStore } from './stores/lucid.js';
 export type { LucidAgentStoreOptions, LucidDatabaseLike, LucidClientLike, LucidQueryBuilderLike, LucidInsertBuilderLike, } from './stores/lucid.js';
-export { createTableStatements, createAgentTables, ensureAgentTables, AGENT_TABLES, } from './stores/lucid-schema.js';
+export { createTableStatements, createAgentTables, dropTableStatements, dropAgentTables, ensureAgentTables, AGENT_TABLES, } from './stores/lucid-schema.js';
 export { LedgerQuotaStore } from './stores/ledger-quota.js';
 export { LucidPricingStore } from './stores/lucid-pricing.js';
 export { LucidGovernanceQueries } from './stores/lucid-governance-queries.js';

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -1,4 +1,4 @@
-export const VERSION = '0.24.0';
+export const VERSION = '0.25.0';
 export * from './types.js';
 export * from './spi/tool.js';
 export * from './base-tool.js';
@@ -43,7 +43,7 @@ export { AgentService } from './agent-service.js';
 export { DefaultToolAuthorizer } from './authorizer.js';
 export { InlineAgentRunner } from './runners/inline-agent-runner.js';
 export { LucidAgentStore } from './stores/lucid.js';
-export { createTableStatements, createAgentTables, ensureAgentTables, AGENT_TABLES, } from './stores/lucid-schema.js';
+export { createTableStatements, createAgentTables, dropTableStatements, dropAgentTables, ensureAgentTables, AGENT_TABLES, } from './stores/lucid-schema.js';
 export { LedgerQuotaStore } from './stores/ledger-quota.js';
 export { LucidPricingStore } from './stores/lucid-pricing.js';
 export { LucidGovernanceQueries } from './stores/lucid-governance-queries.js';

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC;AAEhC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EACL,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAS/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,qCAAqC,EACrC,uCAAuC,GACxC,MAAM,iBAAiB,CAAC;AAMzB,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,gFAAgF;AAChF,OAAO,EACL,YAAY,EACZ,MAAM,EACN,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAgCnD,OAAO,EACL,MAAM,EACN,UAAU,EACV,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,oBAAoB,GAErB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAQpD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E,gFAAgF;AAChF,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,aAAa,GACd,MAAM,iBAAiB,CAAC;AAYzB,uFAAuF;AACvF,qFAAqF;AACrF,sDAAsD;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/src/stores/lucid-schema.d.ts

@@ -30,10 +30,29 @@ export declare const AGENT_TABLES: {
 export declare function createTableStatements(): string[];
 /**
  * Idempotently provision the six agent tables through Lucid's async raw runner (`CREATE TABLE IF
- * NOT EXISTS`). Works on every Lucid dialect. For an AdonisJS app prefer the published migration
- * (`node ace configure @adonis-agora/agent`); this helper is for standalone use, tests and quick-starts.
+ * NOT EXISTS`), then additively repair a database that predates run tracking by ALTERing in the
+ * `run_id` columns its three older tables are missing.
+ *
+ * Both halves matter, and for different populations. A fresh database gets everything from the
+ * `CREATE TABLE` statements and never reaches a repair branch — which is what makes a non-empty
+ * `repairs` result mean "this schema was out of date", not "boot happened". A database created before
+ * run tracking shipped has all three tables already, so every `CREATE TABLE IF NOT EXISTS` no-ops and
+ * only the repair adds the columns the store now writes on every turn.
+ *
+ * Returns the `<table>.<column>` repairs actually issued, so a caller can report them. Works on every
+ * Lucid dialect. For an AdonisJS app prefer the published migration
+ * (`node ace configure @adonis-agora/agent`); this helper is what that migration calls, and what the
+ * stores call themselves when `autoCreateTables` is on.
+ */
+export declare function createAgentTables(db: LucidDatabaseLike): Promise<string[]>;
+/**
+ * `DROP TABLE IF EXISTS` for the six agent tables, in reverse dependency order so a dialect that
+ * enforces the `REFERENCES` clauses never refuses a drop for a child that still exists. The mirror of
+ * {@link createAgentTables}, and what the published migration's `down()` calls.
  */
-export declare function createAgentTables(db: LucidDatabaseLike): Promise<void>;
+export declare function dropTableStatements(): string[];
+/** Drop the six agent tables. Destructive and irreversible — this erases every thread and every ledger row. */
+export declare function dropAgentTables(db: LucidDatabaseLike): Promise<void>;
 /**
  * Idempotently ensure the six agent tables exist, memoized per db client. This is what the stores
  * call on first use when `autoCreateTables` is on (the default) — whichever store touches the

package/dist/src/stores/lucid-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lucid-schema.d.ts","sourceRoot":"","sources":["../../../src/stores/lucid-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAmGhD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5E;AAWD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtE"}
+{"version":3,"file":"lucid-schema.d.ts","sourceRoot":"","sources":["../../../src/stores/lucid-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAmGhD;AAiCD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwBhF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAK9C;AAED,+GAA+G;AAC/G,wBAAsB,eAAe,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI1E;AAWD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAatE"}

package/dist/src/stores/lucid-schema.js

@@ -126,13 +126,88 @@ export function createTableStatements() {
         `CREATE INDEX IF NOT EXISTS "${t.runs}_status_started_idx" ON "${t.runs}" ("status", "started_at")`,
     ];
 }
+/**
+ * The `run_id` correlation columns run tracking added to three pre-existing tables. They are inline in
+ * {@link createTableStatements}, which is all a fresh database needs — but `CREATE TABLE IF NOT EXISTS`
+ * cannot add a column to a table that already exists, so a database provisioned before run tracking
+ * shipped needs them ALTERed in. Deliberately not DB foreign keys (SQLite cannot add a column WITH a
+ * FK constraint), so a row written before run tracking keeps a `null` run_id.
+ */
+const RUN_ID_COLUMNS = [
+    AGENT_TABLES.messages,
+    AGENT_TABLES.toolCalls,
+    AGENT_TABLES.tokenUsage,
+];
+/**
+ * Does `table` already have `column`? Probed with a zero-row `SELECT` rather than `information_schema`
+ * (absent on SQLite) or a `PRAGMA` (SQLite-only): every dialect rejects an unknown column at parse
+ * time, and `WHERE 1 = 0` means no rows are ever read.
+ *
+ * Deliberately NOT "attempt the ALTER and swallow the error": that pattern also swallows a permission
+ * failure, a lock timeout, and a typo, leaving a schema that is still wrong and a migration that
+ * reported success.
+ */
+async function hasColumn(db, table, column) {
+    try {
+        await db.rawQuery(`SELECT "${column}" FROM "${table}" WHERE 1 = 0`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 /**
  * Idempotently provision the six agent tables through Lucid's async raw runner (`CREATE TABLE IF
- * NOT EXISTS`). Works on every Lucid dialect. For an AdonisJS app prefer the published migration
- * (`node ace configure @adonis-agora/agent`); this helper is for standalone use, tests and quick-starts.
+ * NOT EXISTS`), then additively repair a database that predates run tracking by ALTERing in the
+ * `run_id` columns its three older tables are missing.
+ *
+ * Both halves matter, and for different populations. A fresh database gets everything from the
+ * `CREATE TABLE` statements and never reaches a repair branch — which is what makes a non-empty
+ * `repairs` result mean "this schema was out of date", not "boot happened". A database created before
+ * run tracking shipped has all three tables already, so every `CREATE TABLE IF NOT EXISTS` no-ops and
+ * only the repair adds the columns the store now writes on every turn.
+ *
+ * Returns the `<table>.<column>` repairs actually issued, so a caller can report them. Works on every
+ * Lucid dialect. For an AdonisJS app prefer the published migration
+ * (`node ace configure @adonis-agora/agent`); this helper is what that migration calls, and what the
+ * stores call themselves when `autoCreateTables` is on.
  */
 export async function createAgentTables(db) {
-    for (const stmt of createTableStatements()) {
+    const statements = createTableStatements();
+    // Order matters, in three phases rather than one pass. Tables first, then the `run_id` repair, then
+    // indexes — because `createTableStatements` includes `CREATE INDEX ... ON "agent_message" ("run_id")`,
+    // and on a legacy database that index would be issued against a table whose `run_id` the repair has
+    // not added yet. `CREATE INDEX IF NOT EXISTS` does not save it: the guard is on the INDEX existing,
+    // not on the column, so the statement still fails to parse with "no such column: run_id".
+    for (const stmt of statements) {
+        if (stmt.startsWith('CREATE TABLE'))
+            await db.rawQuery(stmt);
+    }
+    const repairs = [];
+    for (const table of RUN_ID_COLUMNS) {
+        if (await hasColumn(db, table, 'run_id'))
+            continue;
+        await db.rawQuery(`ALTER TABLE "${table}" ADD COLUMN "run_id" VARCHAR(255) NULL`);
+        repairs.push(`${table}.run_id`);
+    }
+    for (const stmt of statements) {
+        if (stmt.startsWith('CREATE INDEX'))
+            await db.rawQuery(stmt);
+    }
+    return repairs;
+}
+/**
+ * `DROP TABLE IF EXISTS` for the six agent tables, in reverse dependency order so a dialect that
+ * enforces the `REFERENCES` clauses never refuses a drop for a child that still exists. The mirror of
+ * {@link createAgentTables}, and what the published migration's `down()` calls.
+ */
+export function dropTableStatements() {
+    const t = AGENT_TABLES;
+    return [t.runs, t.tokenUsage, t.toolCalls, t.messages, t.modelPricing, t.threads].map((table) => `DROP TABLE IF EXISTS "${table}"`);
+}
+/** Drop the six agent tables. Destructive and irreversible — this erases every thread and every ledger row. */
+export async function dropAgentTables(db) {
+    for (const stmt of dropTableStatements()) {
         await db.rawQuery(stmt);
     }
 }
@@ -154,7 +229,9 @@ export function ensureAgentTables(db) {
     const key = db;
     let ready = provisioned.get(key);
     if (ready === undefined) {
-        ready = createAgentTables(db).catch((error) => {
+        ready = createAgentTables(db)
+            .then(() => undefined)
+            .catch((error) => {
             provisioned.delete(key);
             throw error;
         });

package/dist/src/stores/lucid-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"lucid-schema.js","sourceRoot":"","sources":["../../../src/stores/lucid-schema.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,mBAAmB;IAC/B,YAAY,EAAE,qBAAqB;IACnC,IAAI,EAAE,WAAW;CACT,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,CAAC,GAAG,YAAY,CAAC;IACvB,OAAO;QACL,+BAA+B,CAAC,CAAC,OAAO;;;;;;;;;;;;;;MActC;QACF,+BAA+B,CAAC,CAAC,OAAO,2BAA2B,CAAC,CAAC,OAAO,+BAA+B;QAC3G,+BAA+B,CAAC,CAAC,QAAQ;;sDAES,CAAC,CAAC,OAAO;;;;;;;;;;;MAWzD;QACF,+BAA+B,CAAC,CAAC,QAAQ,4BAA4B,CAAC,CAAC,QAAQ,+BAA+B;QAC9G,+BAA+B,CAAC,CAAC,QAAQ,iBAAiB,CAAC,CAAC,QAAQ,cAAc;QAClF,+BAA+B,CAAC,CAAC,SAAS;;uDAES,CAAC,CAAC,QAAQ;;;;;;;;;;;;MAY3D;QACF,+BAA+B,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,SAAS,cAAc;QACpF,+BAA+B,CAAC,CAAC,SAAS,4BAA4B,CAAC,CAAC,SAAS,4BAA4B;QAC7G,+BAA+B,CAAC,CAAC,UAAU;;sDAEO,CAAC,CAAC,OAAO;;;;;;;;;;;;MAYzD;QACF,+BAA+B,CAAC,CAAC,UAAU,2BAA2B,CAAC,CAAC,UAAU,+BAA+B;QACjH,+BAA+B,CAAC,CAAC,UAAU,iBAAiB,CAAC,CAAC,UAAU,cAAc;QACtF,+BAA+B,CAAC,CAAC,YAAY;;;;;;;;;MAS3C;QACF,+BAA+B,CAAC,CAAC,IAAI;;sDAEa,CAAC,CAAC,OAAO;;;;;;;;;;;;;MAazD;QACF,+BAA+B,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,IAAI,kBAAkB;QAClF,+BAA+B,CAAC,CAAC,IAAI,2BAA2B,CAAC,CAAC,IAAI,+BAA+B;QACrG,+BAA+B,CAAC,CAAC,IAAI,4BAA4B,CAAC,CAAC,IAAI,4BAA4B;KACpG,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAqB;IAC3D,KAAK,MAAM,IAAI,IAAI,qBAAqB,EAAE,EAAE,CAAC;QAC3C,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,IAAI,OAAO,EAAyB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAqB;IACrD,MAAM,GAAG,GAAG,EAAuB,CAAC;IACpC,IAAI,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YAC5C,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"lucid-schema.js","sourceRoot":"","sources":["../../../src/stores/lucid-schema.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,eAAe;IACzB,SAAS,EAAE,iBAAiB;IAC5B,UAAU,EAAE,mBAAmB;IAC/B,YAAY,EAAE,qBAAqB;IACnC,IAAI,EAAE,WAAW;CACT,CAAC;AAEX;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,CAAC,GAAG,YAAY,CAAC;IACvB,OAAO;QACL,+BAA+B,CAAC,CAAC,OAAO;;;;;;;;;;;;;;MActC;QACF,+BAA+B,CAAC,CAAC,OAAO,2BAA2B,CAAC,CAAC,OAAO,+BAA+B;QAC3G,+BAA+B,CAAC,CAAC,QAAQ;;sDAES,CAAC,CAAC,OAAO;;;;;;;;;;;MAWzD;QACF,+BAA+B,CAAC,CAAC,QAAQ,4BAA4B,CAAC,CAAC,QAAQ,+BAA+B;QAC9G,+BAA+B,CAAC,CAAC,QAAQ,iBAAiB,CAAC,CAAC,QAAQ,cAAc;QAClF,+BAA+B,CAAC,CAAC,SAAS;;uDAES,CAAC,CAAC,QAAQ;;;;;;;;;;;;MAY3D;QACF,+BAA+B,CAAC,CAAC,SAAS,iBAAiB,CAAC,CAAC,SAAS,cAAc;QACpF,+BAA+B,CAAC,CAAC,SAAS,4BAA4B,CAAC,CAAC,SAAS,4BAA4B;QAC7G,+BAA+B,CAAC,CAAC,UAAU;;sDAEO,CAAC,CAAC,OAAO;;;;;;;;;;;;MAYzD;QACF,+BAA+B,CAAC,CAAC,UAAU,2BAA2B,CAAC,CAAC,UAAU,+BAA+B;QACjH,+BAA+B,CAAC,CAAC,UAAU,iBAAiB,CAAC,CAAC,UAAU,cAAc;QACtF,+BAA+B,CAAC,CAAC,YAAY;;;;;;;;;MAS3C;QACF,+BAA+B,CAAC,CAAC,IAAI;;sDAEa,CAAC,CAAC,OAAO;;;;;;;;;;;;;MAazD;QACF,+BAA+B,CAAC,CAAC,IAAI,qBAAqB,CAAC,CAAC,IAAI,kBAAkB;QAClF,+BAA+B,CAAC,CAAC,IAAI,2BAA2B,CAAC,CAAC,IAAI,+BAA+B;QACrG,+BAA+B,CAAC,CAAC,IAAI,4BAA4B,CAAC,CAAC,IAAI,4BAA4B;KACpG,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,cAAc,GAAsB;IACxC,YAAY,CAAC,QAAQ;IACrB,YAAY,CAAC,SAAS;IACtB,YAAY,CAAC,UAAU;CACxB,CAAC;AAEF;;;;;;;;GAQG;AACH,KAAK,UAAU,SAAS,CAAC,EAAqB,EAAE,KAAa,EAAE,MAAc;IAC3E,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,MAAM,WAAW,KAAK,eAAe,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAqB;IAC3D,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAC;IAE3C,oGAAoG;IACpG,uGAAuG;IACvG,oGAAoG;IACpG,oGAAoG;IACpG,0FAA0F;IAC1F,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,MAAM,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC;YAAE,SAAS;QACnD,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,KAAK,yCAAyC,CAAC,CAAC;QAClF,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,CAAC,GAAG,YAAY,CAAC;IACvB,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CACnF,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,KAAK,GAAG,CAC7C,CAAC;AACJ,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAqB;IACzD,KAAK,MAAM,IAAI,IAAI,mBAAmB,EAAE,EAAE,CAAC;QACzC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,IAAI,OAAO,EAAyB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAqB;IACrD,MAAM,GAAG,GAAG,EAAuB,CAAC;IACpC,IAAI,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC;aAC1B,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;aACrB,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACL,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/stubs/database/migrations/create_agent_rag_chunks.stub

@@ -2,37 +2,42 @@
   exports({ to: app.migrationsPath(`${new Date().getTime()}_create_agent_rag_chunks.ts`) })
 }}}
 import { BaseSchema } from '@adonisjs/lucid/schema'
+import db from '@adonisjs/lucid/services/db'
+import { PgVectorStore } from '@adonis-agora/agent'
 
 /**
  * The pgvector chunk table for the @adonis-agora/agent `retrievers.pgvector({...})` store: one row per
  * embedded chunk (id `${documentId}#<n>`), the chunk text, an optional citation source, a `jsonb`
  * metadata column filtered with `@>`, and the `vector(N)` embedding ranked with the `<=>`/`<->`/`<#>`
- * operators. Requires the pgvector extension (`CREATE EXTENSION vector`) — Postgres only.
+ * operators. Requires the pgvector extension — Postgres only. Delete this file if you do not use
+ * pgvector RAG.
  *
- * Set `DIMENSION` to your embedding model's width (e.g. 1536 for text-embedding-3-small) and `OPCLASS`
- * to the index operator class matching the store's metric: `vector_cosine_ops` (default),
- * `vector_l2_ops`, or `vector_ip_ops`.
+ * Like the agent tables migration, this DELEGATES rather than copying DDL: `PgVectorStore` owns the
+ * column names and the index operator class its own queries depend on, and it exposes the same
+ * provisioning the store runs for itself under `ensureSchema: true`. Every statement is
+ * `IF NOT EXISTS`, so this is safe against a database that already has the table.
+ *
+ * SET THESE to match your retriever config in `config/agent.ts` — they must agree, or the store will
+ * query a table shaped differently from the one this created:
+ *   - `DIMENSION` — your embedding model's width (1536 for text-embedding-3-small).
+ *   - `METRIC` — 'cosine' (default), 'l2', or 'inner'. Picks the index operator class.
+ *   - `TABLE` — only if you overrode `table` on the retriever.
  */
 const TABLE = 'agent_rag_chunks'
 const DIMENSION = 1536
-const OPCLASS = 'vector_cosine_ops'
+const METRIC = 'cosine'
 
 export default class extends BaseSchema {
-  async up() {
-    this.schema.raw('CREATE EXTENSION IF NOT EXISTS vector')
+  /** Same reason as the agent tables migration: the DDL runs on the manager's own pooled connection. */
+  static disableTransactions = true
 
-    this.schema.createTable(TABLE, (table) => {
-      table.text('id').primary()
-      table.text('text').notNullable()
-      table.text('source')
-      table.jsonb('metadata')
-      table.specificType('embedding', `vector(${DIMENSION})`).notNullable()
+  async up() {
+    const store = new PgVectorStore(db.connection(this.db.connectionName), {
+      table: TABLE,
+      dimension: DIMENSION,
+      metric: METRIC,
     })
-
-    // Approximate-nearest-neighbour index for the configured metric. Drop it to fall back to an exact scan.
-    this.schema.raw(
-      `CREATE INDEX IF NOT EXISTS ${TABLE}_embedding_idx ON ${TABLE} USING hnsw (embedding ${OPCLASS})`
-    )
+    await store.ensureSchema()
   }
 
   async down() {

package/dist/stubs/database/migrations/create_agent_tables.stub

@@ -2,112 +2,48 @@
   exports({ to: app.migrationsPath(`${new Date().getTime()}_create_agent_tables.ts`) })
 }}}
 import { BaseSchema } from '@adonisjs/lucid/schema'
+import db from '@adonisjs/lucid/services/db'
+import { createAgentTables, dropAgentTables } from '@adonis-agora/agent'
 
 /**
- * The five tables for the @adonis-agora/agent `lucid` store: threads, messages, tool calls, token
- * usage and model pricing. JSON payloads (tool calls/results, follow-ups, usage, tool input/output)
- * are stored as TEXT — the store (de)serializes them — booleans as INTEGER (0/1), and timestamps as
- * epoch-ms integers, so the schema is portable across SQLite / Postgres / MySQL. The `agent_tool_call`
- * primary key is the model-supplied `toolCallId`, not a generated id.
+ * The six tables for the @adonis-agora/agent `lucid` store: threads, messages, tool calls, token
+ * usage, model pricing, and the run lifecycle — plus their indexes.
+ *
+ * This migration DELEGATES to the library instead of reproducing its DDL. The schema belongs to the
+ * library: `LucidAgentStore`, the pricing store and the governance read-model all decide together what
+ * columns they read and write, so a hand-copied snapshot here can only ever be right until the next
+ * release. It was already wrong in two ways. It reproduced `createTable(...)` with no existence guard,
+ * which THROWS on a database where the tables are already there — and they usually are, because
+ * `autoCreateTables` defaults to `true` and any of those three stores provisions the shared schema on
+ * its first use. And it took two files to say what the library says in one: a second additive migration
+ * existed purely to ALTER in the `run_id` columns this one had been written before.
+ *
+ * `createAgentTables` is idempotent (`CREATE TABLE IF NOT EXISTS`) and additive-only: it creates what
+ * is missing and ALTERs the `run_id` columns into a database that predates run tracking. So it is safe
+ * against an empty database, against one the library already auto-created, and against one left over
+ * from an older version — which is exactly the set of states a real app is in.
+ *
+ * `db` (the `Database` manager from `@adonisjs/lucid/services/db`) rather than `this.db`: the manager
+ * checks out its own connection from the pool, which is what keeps the DDL out of the migrator's
+ * transaction (see `disableTransactions` below). `this.db` still supplies the connection NAME, so
+ * `node ace migration:run --connection=x` provisions the tables on connection `x` and not on the default.
  */
 export default class extends BaseSchema {
-  async up() {
-    this.schema.createTable('agent_thread', (table) => {
-      table.string('id').primary()
-      table.string('actor_ref').notNullable()
-      table.string('tenant_ref')
-      table.text('title').notNullable()
-      table.string('persona').notNullable().defaultTo('default')
-      table.integer('transient').notNullable().defaultTo(0)
-      table.bigInteger('pinned_at')
-      table.text('summary')
-      table.integer('summary_message_count').notNullable().defaultTo(0)
-      table.string('active_stream_id')
-      table.bigInteger('created_at').notNullable()
-      table.bigInteger('updated_at').notNullable()
-      table.bigInteger('deleted_at')
-      table.index(['actor_ref', 'updated_at'], 'agent_thread_actor_updated_idx')
-    })
-
-    this.schema.createTable('agent_message', (table) => {
-      table.string('id').primary()
-      table
-        .string('thread_id')
-        .notNullable()
-        .references('id')
-        .inTable('agent_thread')
-        .onDelete('CASCADE')
-      table.string('role').notNullable()
-      table.text('content').notNullable()
-      table.text('tool_calls')
-      table.text('tool_results')
-      table.text('attachments')
-      table.text('follow_ups')
-      table.text('usage')
-      table.string('persona')
-      table.bigInteger('created_at').notNullable()
-      table.index(['thread_id', 'created_at'], 'agent_message_thread_created_idx')
-    })
-
-    this.schema.createTable('agent_tool_call', (table) => {
-      // PK = the model-supplied toolCallId, not a generated id.
-      table.string('id').primary()
-      table
-        .string('message_id')
-        .notNullable()
-        .references('id')
-        .inTable('agent_message')
-        .onDelete('CASCADE')
-      table.string('tool_name').notNullable()
-      table.string('tool_type').notNullable()
-      table.text('input')
-      table.text('output')
-      table.string('status').notNullable()
-      table.string('executed_by_ref')
-      table.integer('execution_ms')
-      table.text('error')
-      table.bigInteger('created_at').notNullable()
-      table.bigInteger('executed_at')
-    })
+  /**
+   * REQUIRED, not a preference. The DDL below runs on a connection the `Database` manager checks out
+   * itself — it is not part of the transaction the migrator would otherwise open for this migration.
+   * With `pool: { max: 1 }` (Adonis's own SQLite guidance) that transaction would hold the only
+   * connection while `createAgentTables` waited for a free one, and the migration would hang until the
+   * acquire timeout. Nothing is lost by opting out: the statements were never inside that transaction
+   * anyway, and re-running an interrupted `createAgentTables` is a no-op.
+   */
+  static disableTransactions = true
 
-    this.schema.createTable('agent_token_usage', (table) => {
-      table.string('id').primary()
-      table
-        .string('thread_id')
-        .notNullable()
-        .references('id')
-        .inTable('agent_thread')
-        .onDelete('CASCADE')
-      table.string('actor_ref').notNullable()
-      table.string('message_id')
-      table.string('model_id').notNullable()
-      table.string('purpose').notNullable()
-      table.integer('input_tokens').notNullable()
-      table.integer('output_tokens').notNullable()
-      table.integer('cache_write_tokens')
-      table.integer('cache_read_tokens')
-      table.double('cost_usd')
-      table.bigInteger('created_at').notNullable()
-      table.index(['actor_ref', 'created_at'], 'agent_token_usage_actor_created_idx')
-    })
-
-    this.schema.createTable('agent_model_pricing', (table) => {
-      table.string('id').primary()
-      table.string('model_id').notNullable()
-      table.double('input_price_per_1m').notNullable()
-      table.double('output_price_per_1m').notNullable()
-      table.double('cache_write_price_per_1m')
-      table.double('cache_read_price_per_1m')
-      table.bigInteger('effective_from').notNullable()
-      table.integer('is_current').notNullable()
-    })
+  async up() {
+    await createAgentTables(db.connection(this.db.connectionName))
   }
 
   async down() {
-    this.schema.dropTableIfExists('agent_model_pricing')
-    this.schema.dropTableIfExists('agent_token_usage')
-    this.schema.dropTableIfExists('agent_tool_call')
-    this.schema.dropTableIfExists('agent_message')
-    this.schema.dropTableIfExists('agent_thread')
+    await dropAgentTables(db.connection(this.db.connectionName))
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adonis-agora/agent",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Governed, durable-backed AI agent (chat + tool-calling + governance) for AdonisJS — part of the Agora ecosystem.",
   "license": "MIT",
   "repository": {

package/dist/stubs/database/migrations/create_agent_run_tracking.stub

@@ -1,80 +0,0 @@
-{{{
-  exports({ to: app.migrationsPath(`${new Date().getTime()}_create_agent_run_tracking.ts`) })
-}}}
-import { BaseSchema } from '@adonisjs/lucid/schema'
-
-/**
- * Additive migration for @adonis-agora/agent RUN tracking. Adds the `agent_run` table (one row per
- * run/turn lifecycle) plus a nullable `run_id` correlation column on `agent_message`,
- * `agent_tool_call` and `agent_token_usage`. `run_id` is deliberately NOT a DB foreign key (like the
- * reference): it can be `ALTER TABLE ADD COLUMN`-ed portably (SQLite can't add a column WITH a FK
- * constraint) and a row written before this shipped keeps a `null` run_id.
- *
- * Timestamps are epoch-ms integers, booleans INTEGER (0/1) and cost a DOUBLE, matching
- * `create_agent_tables` so the schema stays portable across SQLite / Postgres / MySQL. Safe to run on
- * an existing deployment: it only creates a new table and adds nullable columns.
- */
-export default class extends BaseSchema {
-  async up() {
-    this.schema.createTable('agent_run', (table) => {
-      table.string('id').primary()
-      table
-        .string('thread_id')
-        .notNullable()
-        .references('id')
-        .inTable('agent_thread')
-        .onDelete('CASCADE')
-      table.string('agent_name')
-      table.string('actor_ref').notNullable()
-      table.string('tenant_ref')
-      table.string('status').notNullable()
-      table.bigInteger('started_at').notNullable()
-      table.bigInteger('finished_at')
-      table.integer('step_count').notNullable().defaultTo(0)
-      table.integer('input_tokens').notNullable().defaultTo(0)
-      table.integer('output_tokens').notNullable().defaultTo(0)
-      table.double('cost_usd')
-      table.text('error')
-      table.integer('durable').notNullable().defaultTo(0)
-      table.index(['started_at'], 'agent_run_started_idx')
-      table.index(['actor_ref', 'started_at'], 'agent_run_actor_started_idx')
-      table.index(['status', 'started_at'], 'agent_run_status_started_idx')
-    })
-
-    this.schema.alterTable('agent_message', (table) => {
-      table.string('run_id')
-      table.index(['run_id'], 'agent_message_run_idx')
-    })
-
-    this.schema.alterTable('agent_tool_call', (table) => {
-      table.string('run_id')
-      table.index(['run_id'], 'agent_tool_call_run_idx')
-      table.index(['status', 'created_at'], 'agent_tool_call_status_created_idx')
-    })
-
-    this.schema.alterTable('agent_token_usage', (table) => {
-      table.string('run_id')
-      table.index(['run_id'], 'agent_token_usage_run_idx')
-    })
-  }
-
-  async down() {
-    this.schema.alterTable('agent_token_usage', (table) => {
-      table.dropIndex(['run_id'], 'agent_token_usage_run_idx')
-      table.dropColumn('run_id')
-    })
-
-    this.schema.alterTable('agent_tool_call', (table) => {
-      table.dropIndex(['status', 'created_at'], 'agent_tool_call_status_created_idx')
-      table.dropIndex(['run_id'], 'agent_tool_call_run_idx')
-      table.dropColumn('run_id')
-    })
-
-    this.schema.alterTable('agent_message', (table) => {
-      table.dropIndex(['run_id'], 'agent_message_run_idx')
-      table.dropColumn('run_id')
-    })
-
-    this.schema.dropTableIfExists('agent_run')
-  }
-}