@agent-native/core 0.209.2 → 0.209.3-nightly-20261016183441

package/dist/agent/context-xray/plugin.js

@@ -1,14 +1,10 @@
-import { runMigrations } from "../../db/migrations.js";
 import { awaitBootstrap, markDefaultPluginProvided, } from "../../server/framework-request-handler.js";
-import { CONTEXT_XRAY_MIGRATIONS } from "./migrations.js";
+import { contextXrayStore } from "./schema-store.js";
 export function createContextXrayPlugin() {
-    const migrate = runMigrations(CONTEXT_XRAY_MIGRATIONS, {
-        table: "_context_xray_migrations",
-    });
     return async (nitroApp) => {
         markDefaultPluginProvided(nitroApp, "context-xray");
         await awaitBootstrap(nitroApp);
-        await migrate(nitroApp);
+        await contextXrayStore.ready();
     };
 }
 export const defaultContextXrayPlugin = createContextXrayPlugin();

package/dist/agent/context-xray/schema-store.d.ts

@@ -0,0 +1 @@
+export declare const contextXrayStore: import("../../db/store-registry.js").Store;

package/dist/agent/context-xray/schema-store.js

@@ -0,0 +1,7 @@
+import { defineStore } from "../../db/store-registry.js";
+import { fromMigrationEntries } from "../../db/versioned-store-migrations.js";
+import { CONTEXT_XRAY_MIGRATIONS } from "./migrations.js";
+export const contextXrayStore = defineStore({
+    id: "context_xray",
+    migrations: fromMigrationEntries("_context_xray_migrations", CONTEXT_XRAY_MIGRATIONS, { ranAtBoot: true }),
+});

package/dist/agent/harness/store.js

@@ -1,6 +1,8 @@
 import { getDbExec } from "../../db/client.js";
 import { ensureColumnExists, ensureIndexExists, ensureTableExists, } from "../../db/ddl-guard.js";
 import { defineStore } from "../../db/store-registry.js";
+import { fromMigrationEntries } from "../../db/versioned-store-migrations.js";
+import { AGENT_HARNESS_SESSION_MIGRATIONS, AGENT_HARNESS_SESSION_MIGRATIONS_TABLE, } from "./migrations.js";
 export class AgentHarnessSessionConflictError extends Error {
     constructor(sessionId) {
         super(`Harness session ${sessionId} changed concurrently; retry the operation.`);
@@ -58,6 +60,7 @@ export const agentHarnessSessionsStore = defineStore({
                 await ensureIndexExists("idx_agent_harness_sessions_owner", `CREATE INDEX IF NOT EXISTS idx_agent_harness_sessions_owner ON agent_harness_sessions(owner_email, updated_at)`);
             },
         },
+        ...fromMigrationEntries(AGENT_HARNESS_SESSION_MIGRATIONS_TABLE, AGENT_HARNESS_SESSION_MIGRATIONS),
     ],
 });
 export function ensureAgentHarnessSessionTables() {

package/dist/agent/observational-memory/plugin.js

@@ -1,14 +1,10 @@
-import { runMigrations } from "../../db/migrations.js";
 import { awaitBootstrap, markDefaultPluginProvided, } from "../../server/framework-request-handler.js";
-import { OBSERVATIONAL_MEMORY_MIGRATIONS } from "./migrations.js";
+import { observationalMemoryStore } from "./store.js";
 export function createObservationalMemoryPlugin() {
-    const migrate = runMigrations(OBSERVATIONAL_MEMORY_MIGRATIONS, {
-        table: "_observational_memory_migrations",
-    });
     return async (nitroApp) => {
         markDefaultPluginProvided(nitroApp, "observational-memory");
         await awaitBootstrap(nitroApp);
-        await migrate(nitroApp);
+        await observationalMemoryStore.ready();
     };
 }
 export const defaultObservationalMemoryPlugin = createObservationalMemoryPlugin();

package/dist/agent/observational-memory/store.js

@@ -14,7 +14,9 @@
 import { getDbExec } from "../../db/client.js";
 import { ensureTableExists, ensureIndexExists } from "../../db/ddl-guard.js";
 import { defineStore } from "../../db/store-registry.js";
+import { fromMigrationEntries } from "../../db/versioned-store-migrations.js";
 import { widenIntColumnsToBigInt } from "../../db/widen-columns.js";
+import { OBSERVATIONAL_MEMORY_MIGRATIONS } from "./migrations.js";
 export const observationalMemoryStore = defineStore({
     id: "observational_memory",
     migrations: [
@@ -53,6 +55,7 @@ export const observationalMemoryStore = defineStore({
                 ]);
             },
         },
+        ...fromMigrationEntries("_observational_memory_migrations", OBSERVATIONAL_MEMORY_MIGRATIONS, { ranAtBoot: true }),
     ],
 });
 export function ensureTable() {

package/dist/agent/run-store.js

@@ -3,6 +3,7 @@ import { isArtifactReceipt, } from "../artifacts/detect.js";
 import { getDbExec } from "../db/client.js";
 import { ensureColumnExists, ensureTableExists } from "../db/ddl-guard.js";
 import { defineStore } from "../db/store-registry.js";
+import { fromMigrationEntries } from "../db/versioned-store-migrations.js";
 import { widenIntColumnsToBigInt } from "../db/widen-columns.js";
 import { automationRecoveryMessagesForLocale } from "../localization/automation-recovery-messages.js";
 import { lockAndAssertServicePrincipalMayStartRun, prepareServicePrincipalRunStart, recordServicePrincipalDenial, } from "../org/service-principal-guard.js";
@@ -13,6 +14,7 @@ import { approvalKeyForHistory } from "./approval-key.js";
 import { admitAutoContinue, admitManualContinue, } from "./auto-continue.js";
 import { AGENT_CHAT_RECOVERY_OF_RUN_FIELD } from "./durable-background.js";
 import { LLM_MISSING_CREDENTIALS_ERROR_CODE, LLM_MISSING_CREDENTIALS_MESSAGE, } from "./engine/credential-errors.js";
+import { AGENT_RUN_MIGRATIONS, AGENT_RUN_MIGRATIONS_TABLE, } from "./run-migrations.js";
 import { isConsistentToolCallInputFingerprint, isUnavailableToolCallInput, toolCallInputFingerprint, } from "./tool-call-journal.js";
 import { CONTINUATION_REASONS, isContinuationTerminalReason } from "./types.js";
 export const RUN_STALE_MS = 15_000;
@@ -266,6 +268,7 @@ export const agentRunsStore = defineStore({
                 await widenIntColumnsToBigInt("agent_tool_ledger", ["completed_at"]);
             },
         },
+        ...fromMigrationEntries(AGENT_RUN_MIGRATIONS_TABLE, AGENT_RUN_MIGRATIONS),
     ],
 });
 export function ensureRunTables() {

package/dist/agent/tool-approval-store.js

@@ -2,7 +2,9 @@ import { createHash, randomUUID } from "node:crypto";
 import { getDbExec } from "../db/client.js";
 import { ensureColumnExists, ensureIndexExists, ensureTableExists, } from "../db/ddl-guard.js";
 import { defineStore } from "../db/store-registry.js";
+import { fromMigrationEntries } from "../db/versioned-store-migrations.js";
 import { hashAgentToolApprovalKey } from "./approval-key.js";
+import { AGENT_TOOL_APPROVAL_MIGRATIONS, AGENT_TOOL_APPROVAL_MIGRATIONS_TABLE, } from "./tool-approval-migrations.js";
 import { AGENT_TOOL_APPROVAL_INDEX_SQL, AGENT_TOOL_APPROVAL_LOGICAL_INDEX_SQL, AGENT_TOOL_APPROVAL_POLICY_INDEX_SQL, AGENT_TOOL_APPROVAL_POLICY_REVISION_COLUMN_SQL, AGENT_TOOL_APPROVAL_POLICY_TABLE_SQL, AGENT_TOOL_APPROVAL_RECOVERY_INDEX_SQL, AGENT_TOOL_APPROVAL_REVISION_COLUMN_SQL, AGENT_TOOL_APPROVAL_TABLE_SQL, } from "./tool-approval-migrations.js";
 export { hashAgentToolApprovalKey } from "./approval-key.js";
 const APPROVAL_TTL_MS = 60 * 60_000;
@@ -25,6 +27,7 @@ export const agentToolApprovalsStore = defineStore({
                 await ensureColumnExists("agent_tool_approvals", "tool_revision", AGENT_TOOL_APPROVAL_REVISION_COLUMN_SQL);
             },
         },
+        ...fromMigrationEntries(AGENT_TOOL_APPROVAL_MIGRATIONS_TABLE, AGENT_TOOL_APPROVAL_MIGRATIONS.filter((entry) => entry.version <= 3)),
     ],
 });
 export function ensureAgentToolApprovalTable() {
@@ -46,6 +49,7 @@ export const agentToolApprovalPoliciesStore = defineStore({
                 await ensureColumnExists("agent_tool_approval_policies", "tool_revision", AGENT_TOOL_APPROVAL_POLICY_REVISION_COLUMN_SQL);
             },
         },
+        ...fromMigrationEntries(AGENT_TOOL_APPROVAL_MIGRATIONS_TABLE, AGENT_TOOL_APPROVAL_MIGRATIONS.filter((entry) => entry.version === 4)),
     ],
 });
 export function ensureAgentToolApprovalPolicyTable() {

package/dist/automation/index.d.ts

@@ -139,8 +139,8 @@ export declare function createAutomationCallbackHandler(runtime: AutomationRunti
     duplicate?: undefined;
     eventId?: undefined;
 } | {
+    error?: undefined;
     accepted: boolean;
     duplicate: boolean;
     eventId: string;
-    error?: undefined;
 }>;

package/dist/chat-threads/store.js

@@ -7,6 +7,7 @@ import { getDbExec } from "../db/client.js";
 import { createGetDb } from "../db/create-get-db.js";
 import { ensureColumnExists, ensureIndexExists, ensureTableExists, } from "../db/ddl-guard.js";
 import { defineStore } from "../db/store-registry.js";
+import { fromMigrationEntries } from "../db/versioned-store-migrations.js";
 import { widenIntColumnsToBigInt } from "../db/widen-columns.js";
 import { getRequestOrgId } from "../server/request-context.js";
 import { assertNoInlineImageBytes, stripInlineBytes, } from "../shared/inline-bytes.js";
@@ -14,6 +15,7 @@ import { resolveAccess } from "../sharing/access.js";
 import { registerShareableResource } from "../sharing/registry.js";
 import { roleSatisfies } from "../sharing/schema.js";
 import { emitChatThreadChange } from "./emitter.js";
+import { CHAT_THREAD_SCHEMA_MIGRATIONS, CHAT_THREAD_SCHEMA_MIGRATIONS_TABLE, } from "./schema-migrations.js";
 import { chatThreads, chatThreadShares, CHAT_THREAD_SHARES_CREATE_SQL, CHAT_THREAD_SHARES_RESOURCE_INDEX_SQL, } from "./schema.js";
 /**
  * Per-thread async mutex. Read-modify-write on the `thread_data` JSON blob
@@ -155,6 +157,7 @@ export const chatThreadsStore = defineStore({
                 await ensureIndexExists("chat_thread_shares_resource_idx", CHAT_THREAD_SHARES_RESOURCE_INDEX_SQL);
             },
         },
+        ...fromMigrationEntries(CHAT_THREAD_SCHEMA_MIGRATIONS_TABLE, CHAT_THREAD_SCHEMA_MIGRATIONS, { data: [3] }),
     ],
 });
 function ensureTable() {

package/dist/db/migrations.d.ts

@@ -3,6 +3,7 @@ type NitroPluginDef = (nitroApp: any) => void | Promise<void>;
 export declare function isDuplicateColumnError(err: unknown): boolean;
 /** True when the connected Postgres role cannot apply the migration. */
 export declare function isPermissionError(err: unknown): boolean;
+export declare function splitSqlStatements(sql: string): string[];
 export interface RunMigrationsOptions {
     runInServerlessRequest?: boolean;
     table: string;

package/dist/db/migrations.js

@@ -80,7 +80,7 @@ function isMissingRelationError(err) {
     const e = err;
     return (e?.code === "42P01" || /relation .* does not exist/i.test(e?.message ?? ""));
 }
-function splitSqlStatements(sql) {
+export function splitSqlStatements(sql) {
     const out = [];
     let buf = "";
     let i = 0;

package/dist/db/runtime-facts.d.ts

@@ -9,3 +9,10 @@ export declare function retryOnDdlRace<T>(fn: () => Promise<T>): Promise<T>;
  * client, so modules that mock `./client.js` keep working.
  */
 export declare function dbClientGeneration(): number;
+/**
+ * True while a store migration runs that the ledger will record once it
+ * resolves. Helpers that swallow failures elsewhere must rethrow here, or the
+ * ledger records a step that never happened and never retries it.
+ */
+export declare function isRecordingStoreMigration(): boolean;
+export declare function runRecordingStoreMigration<T>(run: () => Promise<T>): Promise<T>;

package/dist/db/runtime-facts.js

@@ -1,3 +1,4 @@
+import { getAsyncLocalStorageCtor } from "../shared/optional-node-builtins.js";
 /**
  * Dependency-free database runtime facts. Kept out of `./client.js` so the
  * store runner does not require every `vi.mock("../db/client.js")` to stub them.
@@ -39,3 +40,20 @@ export function dbClientGeneration() {
     const proc = globalThis.process;
     return proc?.__agentNativePgliteClientGeneration ?? 0;
 }
+const AsyncLocalStorageCtor = getAsyncLocalStorageCtor();
+const recordingStoreMigration = AsyncLocalStorageCtor
+    ? new AsyncLocalStorageCtor()
+    : undefined;
+/**
+ * True while a store migration runs that the ledger will record once it
+ * resolves. Helpers that swallow failures elsewhere must rethrow here, or the
+ * ledger records a step that never happened and never retries it.
+ */
+export function isRecordingStoreMigration() {
+    return recordingStoreMigration?.getStore() === true;
+}
+export function runRecordingStoreMigration(run) {
+    return recordingStoreMigration
+        ? recordingStoreMigration.run(true, run)
+        : run();
+}

package/dist/db/schema-catalog.js

@@ -6,7 +6,7 @@
  * has no `pg_dump`.
  */
 /** Tables whose rows are migration bookkeeping, dumped with their data. */
-const BOOKKEEPING_TABLE = /(?:^_.*migrations?$|_migrations$|^_an_store_migrations$)/;
+const BOOKKEEPING_TABLE = /^_[a-z0-9_]*migrations(?:_named)?$/;
 async function rows(exec, sql) {
     return (await exec.execute(sql)).rows;
 }
@@ -21,6 +21,9 @@ function literal(value) {
     }
     if (typeof value === "boolean")
         return value ? "TRUE" : "FALSE";
+    // Locale-formatted dates do not parse back; ISO 8601 does, in any time zone.
+    if (value instanceof Date)
+        return `'${value.toISOString()}'`;
     return `'${String(value).replace(/'/g, "''")}'`;
 }
 const COLUMNS_SQL = `

package/dist/db/store-ledger.test-helpers.d.ts

@@ -0,0 +1,5 @@
+export declare function isStoreLedgerStatement(sql: string): boolean;
+export declare function storeLedgerResult(sql: string): {
+    rows: Array<Record<string, unknown>>;
+    rowsAffected: number;
+} | undefined;

package/dist/db/store-ledger.test-helpers.js

@@ -0,0 +1,19 @@
+/**
+ * For specs that mock `getDbExec()` with a hand-written executor. Outside
+ * hosted runtimes a store records its migrations in `_an_store_migrations`
+ * (see `store-registry.ts`), so a strict mock sees those statements too.
+ * Answer them as an empty ledger: every store then applies its migrations
+ * against the mock once per executor, as it did before the ledger.
+ */
+const STORE_LEDGER_STATEMENT = /\b_an_store_migration(?:s|_lock)\b/;
+export function isStoreLedgerStatement(sql) {
+    return STORE_LEDGER_STATEMENT.test(sql);
+}
+export function storeLedgerResult(sql) {
+    if (!isStoreLedgerStatement(sql))
+        return undefined;
+    return {
+        rows: [],
+        rowsAffected: /^\s*(?:INSERT|UPDATE|DELETE)\b/i.test(sql) ? 1 : 0,
+    };
+}

package/dist/db/store-registry.d.ts

@@ -13,6 +13,7 @@
  * kept only for that.
  */
 import { type DbExec } from "./client.js";
+import { type MigrationEntry } from "./migrations.js";
 export declare const STORE_MIGRATIONS_TABLE = "_an_store_migrations";
 export interface StoreMigration {
     /** Stable, never renamed: the ledger records it. */
@@ -24,9 +25,37 @@ export interface StoreMigration {
     readonly kind?: "schema" | "data";
     readonly sql?: string | readonly string[];
     readonly run?: (exec: DbExec) => Promise<void>;
+    /**
+     * The versioned `runMigrations` entry this migration replaces. A database
+     * whose old bookkeeping table already records that entry gets a ledger row
+     * (`source = 'legacy'`) instead of running it again.
+     */
+    readonly legacy?: LegacyMigrationRef;
+}
+export interface LegacyMigrationRef {
+    /** The `runMigrations` table, e.g. `_chat_thread_schema_migrations`. */
+    readonly table: string;
+    readonly version: number;
+    /** Set for named entries, which were gated by name, not version. */
+    readonly name?: string;
+    /**
+     * Where the list ran on main. A release-only list (the default) keeps
+     * running only in the release step. A list that also ran at plugin boot
+     * runs everywhere: local runtimes import its history once, and hosted apps
+     * without release migrations keep running it through `runMigrations` and
+     * its old table, exactly as before.
+     */
+    readonly ranAtBoot?: boolean;
+    /** The original entry, for that hosted `runMigrations` path. */
+    readonly entry?: MigrationEntry;
 }
 export interface StoreDefinition {
     readonly id: string;
+    /**
+     * Stores whose migrations must run first at release, for a migration that
+     * reads or alters another store's tables. Registry order is otherwise by id.
+     */
+    readonly after?: readonly string[];
     /**
      * Never provision from a request, even for hosted apps that do not migrate
      * at release: the release step (or a versioned list) is the only creator.
@@ -58,6 +87,11 @@ export declare class SchemaNotMigratedError extends Error {
 export declare function schemaIsReleaseOwned(): boolean;
 /** Stable across bundlers; `run` bodies are not hashed because minifiers rewrite them. */
 export declare function migrationChecksum(migration: StoreMigration): string | null;
+/**
+ * Registry order with each store's `after` dependencies first. Fails on an
+ * unknown id or a cycle rather than guessing an order.
+ */
+export declare function orderStoresForRelease<T extends StoreDefinition>(stores: readonly T[]): T[];
 /**
  * Every registered store's migrations that the ledger does not list. The
  * release step calls this after applying, so a deploy whose ledger disagrees

package/dist/db/store-registry.generated.js

@@ -48,6 +48,10 @@ export const FRAMEWORK_STORES = [
         "automation_run_history",
         () => import("../jobs/run-history.js").then((m) => m.automationRunHistoryStore),
     ],
+    [
+        "automation_trigger_events",
+        () => import("../triggers/event-queue.js").then((m) => m.automationTriggerEventsStore),
+    ],
     [
         "automation_webhook_tokens",
         () => import("../triggers/webhook-store.js").then((m) => m.automationWebhookTokensStore),
@@ -80,6 +84,10 @@ export const FRAMEWORK_STORES = [
         "computer_approvals",
         () => import("../integrations/computer-supervision-store.js").then((m) => m.computerApprovalsStore),
     ],
+    [
+        "context_xray",
+        () => import("../agent/context-xray/schema-store.js").then((m) => m.contextXrayStore),
+    ],
     [
         "conversation_scopes",
         () => import("../integrations/scope-store.js").then((m) => m.conversationScopesStore),
@@ -164,6 +172,7 @@ export const FRAMEWORK_STORES = [
         "observational_memory",
         () => import("../agent/observational-memory/store.js").then((m) => m.observationalMemoryStore),
     ],
+    ["org", () => import("../org/schema-store.js").then((m) => m.orgStore)],
     [
         "pending_tasks",
         () => import("../integrations/pending-tasks-store.js").then((m) => m.pendingTasksStore),