Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Move server DB under postgres and namespace shipped migrations.

debajyoti-truefoundryd8069ad12fff
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d806aa848..78af1ade2 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -79,14 +79,11 @@ jobs:
with:
filters: |
store:
- - 'packages/server/src/db/session-store/**'
+ - 'packages/server/src/db/**'
+ - 'packages/server/tsup.config.ts'
- 'packages/server/tests/**'
- 'packages/harness/src/agent-session/**'
- 'packages/harness/tests/agent-session/**'
- - 'packages/server/src/db/migrations/**'
- - 'packages/server/src/db/migrate.ts'
- - 'packages/server/src/db/types.ts'
- - 'packages/server/src/db/client.ts'
- name: Skip — no session-store changes
if: steps.filter.outputs.store != 'true'
diff --git a/packages/server/package.json b/packages/server/package.json
index e1d22d740..1a47021de 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -9,7 +9,7 @@
"scripts": {
"build": "tsc --noEmit && tsup",
"dev": "tsx --env-file=.env src/main.ts",
- "migrate": "tsx --env-file=.env src/db/migrate-cli.ts",
+ "migrate": "tsx --env-file=.env src/db/postgres/migrate-cli.ts",
"typecheck": "tsc --noEmit",
"openapi:write": "tsx --env-file=.env.test scripts/write-openapi.ts",
"test": "tsx --env-file=.env.test --test src/**/*.test.ts",
diff --git a/packages/server/src/db/migrate.ts b/packages/server/src/db/migratePostgres.ts
similarity index 65%
rename from packages/server/src/db/migrate.ts
rename to packages/server/src/db/migratePostgres.ts
index e1c2df1b0..cceb5b8bc 100644
--- a/packages/server/src/db/migrate.ts
+++ b/packages/server/src/db/migratePostgres.ts
@@ -4,11 +4,13 @@ import path from 'node:path';
import type { Kysely } from 'kysely';
import { FileMigrationProvider, Migrator } from 'kysely/migration';
-import type { Database } from './types';
+import type { Database } from './postgres/types';
/**
- * Runs all pending migrations. On Postgres this executes inside one
- * transaction (Kysely default) unless `disableTransactions` is set — never set that.
+ * Runs all pending Postgres migrations.
+ *
+ * This module lives at `src/db/` (bundled into `dist/main.js`) so the folder is
+ * always `…/postgres/migrations` — source or production.
*/
export async function migrateToLatest(db: Kysely<Database>): Promise<void> {
const migrator = new Migrator({
@@ -16,10 +18,7 @@ export async function migrateToLatest(db: Kysely<Database>): Promise<void> {
provider: new FileMigrationProvider({
fs,
path,
- // Absolute path required.
- // Dev (tsx): this file lives in src/db → src/db/migrations
- // Prod (bundled into dist/main.js): import.meta.dirname is dist → dist/migrations
- migrationFolder: path.join(import.meta.dirname, 'migrations'),
+ migrationFolder: path.join(import.meta.dirname, 'postgres', 'migrations'),
}),
});
diff --git a/packages/server/src/db/AGENTS.md b/packages/server/src/db/postgres/AGENTS.md
similarity index 100%
rename from packages/server/src/db/AGENTS.md
rename to packages/server/src/db/postgres/AGENTS.md
diff --git a/packages/server/src/db/CLAUDE.md b/packages/server/src/db/postgres/CLAUDE.md
similarity index 100%
rename from packages/server/src/db/CLAUDE.md
rename to packages/server/src/db/postgres/CLAUDE.md
diff --git a/packages/server/src/db/client.ts b/packages/server/src/db/postgres/client.ts
similarity index 100%
rename from packages/server/src/db/client.ts
rename to packages/server/src/db/postgres/client.ts
diff --git a/packages/server/src/db/migrate-cli.ts b/packages/server/src/db/postgres/migrate-cli.ts
similarity index 74%
rename from packages/server/src/db/migrate-cli.ts
rename to packages/server/src/db/postgres/migrate-cli.ts
index ec36bfca0..b80b7fea3 100644
--- a/packages/server/src/db/migrate-cli.ts
+++ b/packages/server/src/db/postgres/migrate-cli.ts
@@ -1,9 +1,9 @@
/**
* Run pending migrations and exit. Usage: `pnpm migrate` from packages/server.
*/
-import configuration from '../config';
+import configuration from '../../config';
+import { migrateToLatest } from '../migratePostgres';
import { createDb } from './client';
-import { migrateToLatest } from './migrate';
const db = createDb(configuration.DATABASE_URL, configuration.DATABASE_POOL_MAX);
diff --git a/packages/server/src/db/migrations/20260727_000001_init.ts b/packages/server/src/db/postgres/migrations/20260727_000001_init.ts
similarity index 100%
rename from packages/server/src/db/migrations/20260727_000001_init.ts
rename to packages/server/src/db/postgres/migrations/20260727_000001_init.ts
diff --git a/packages/server/src/db/migrations/20260728_000001_session_store.ts b/packages/server/src/db/postgres/migrations/20260728_000001_session_store.ts
similarity index 100%
rename from packages/server/src/db/migrations/20260728_000001_session_store.ts
rename to packages/server/src/db/postgres/migrations/20260728_000001_session_store.ts
diff --git a/packages/server/src/db/session-store/PostgresSessionStore.ts b/packages/server/src/db/postgres/session-store/PostgresSessionStore.ts
similarity index 100%
rename from packages/server/src/db/session-store/PostgresSessionStore.ts
rename to packages/server/src/db/postgres/session-store/PostgresSessionStore.ts
diff --git a/packages/server/src/db/session-store/queries/capabilities.ts b/packages/server/src/db/postgres/session-store/queries/capabilities.ts
similarity index 100%
rename from packages/server/src/db/session-store/queries/capabilities.ts
rename to packages/server/src/db/postgres/session-store/queries/capabilities.ts
diff --git a/packages/server/src/db/session-store/queries/events.ts b/packages/server/src/db/postgres/session-store/queries/events.ts
similarity index 100%
rename from packages/server/src/db/session-store/queries/events.ts
rename to packages/server/src/db/postgres/session-store/queries/events.ts
diff --git a/packages/server/src/db/session-store/queries/sessions.ts b/packages/server/src/db/postgres/session-store/queries/sessions.ts
similarity index 100%
rename from packages/server/src/db/session-store/queries/sessions.ts
rename to packages/server/src/db/postgres/session-store/queries/sessions.ts
diff --git a/packages/server/src/db/session-store/queries/threads.ts b/packages/server/src/db/postgres/session-store/queries/threads.ts
similarity index 100%
rename from packages/server/src/db/session-store/queries/threads.ts
rename to packages/server/src/db/postgres/session-store/queries/threads.ts
diff --git a/packages/server/src/db/session-store/queries/turns.ts b/packages/server/src/db/postgres/session-store/queries/turns.ts
similarity index 100%
rename from packages/server/src/db/session-store/queries/turns.ts
rename to packages/server/src/db/postgres/session-store/queries/turns.ts
diff --git a/packages/server/src/db/session-store/sqlExpressions.ts b/packages/server/src/db/postgres/session-store/sqlExpressions.ts
similarity index 100%
rename from packages/server/src/db/session-store/sqlExpressions.ts
rename to packages/server/src/db/postgres/session-store/sqlExpressions.ts
diff --git a/packages/server/src/db/types.ts b/packages/server/src/db/postgres/types.ts
similarity index 100%
rename from packages/server/src/db/types.ts
rename to packages/server/src/db/postgres/types.ts
diff --git a/packages/server/src/main.ts b/packages/server/src/main.ts
index f6dc1de1c..f135c2ebe 100644
--- a/packages/server/src/main.ts
+++ b/packages/server/src/main.ts
@@ -24,8 +24,8 @@ try {
] = await Promise.all([
import('./app'),
import('./config'),
- import('./db/client'),
- import('./db/migrate'),
+ import('./db/postgres/client'),
+ import('./db/migratePostgres'),
import('./store/ModelStore'),
import('./store/McpStore'),
import('./store/SkillStore'),
@@ -34,7 +34,7 @@ try {
import('./runtime/sandboxFactory'),
import('./runtime/redis'),
import('@truefoundry/utils/request-reply'),
- import('./db/session-store/PostgresSessionStore'),
+ import('./db/postgres/session-store/PostgresSessionStore'),
]);
// Console logger shared by the server runtime (harness components require one).
diff --git a/packages/server/tests/db/session-store/helpers.ts b/packages/server/tests/db/session-store/helpers.ts
index f9887f153..0d250a6cb 100644
--- a/packages/server/tests/db/session-store/helpers.ts
+++ b/packages/server/tests/db/session-store/helpers.ts
@@ -2,10 +2,10 @@ import { sql, type Kysely } from 'kysely';
import { Pool } from 'pg';
import { ulid } from 'ulid';
-import { createDb } from '../../../src/db/client';
-import { migrateToLatest } from '../../../src/db/migrate';
-import { PostgresSessionStore } from '../../../src/db/session-store/PostgresSessionStore';
-import type { Database } from '../../../src/db/types';
+import { migrateToLatest } from '../../../src/db/migratePostgres';
+import { createDb } from '../../../src/db/postgres/client';
+import { PostgresSessionStore } from '../../../src/db/postgres/session-store/PostgresSessionStore';
+import type { Database } from '../../../src/db/postgres/types';
const ADMIN_URL_ENV = 'PG_STORE_TESTS_ADMIN_URL';
diff --git a/packages/server/tsup.config.ts b/packages/server/tsup.config.ts
index 6193686e8..4f8dda119 100644
--- a/packages/server/tsup.config.ts
+++ b/packages/server/tsup.config.ts
@@ -4,13 +4,13 @@ import { fileURLToPath } from 'node:url';
import { defineConfig } from 'tsup';
-const migrationsDir = path.join(path.dirname(fileURLToPath(import.meta.url)), 'src/db/migrations');
+const migrationsDir = path.join(path.dirname(fileURLToPath(import.meta.url)), 'src/db/postgres/migrations');
const migrationEntries = Object.fromEntries(
readdirSync(migrationsDir)
.filter(name => name.endsWith('.ts'))
.map(name => {
const base = name.replace(/\.ts$/, '');
- return [`migrations/${base}`, path.join(migrationsDir, name)] as const;
+ return [`postgres/migrations/${base}`, path.join(migrationsDir, name)] as const;
}),
);