Skip to content

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

Rename harness and server packages (#223)

Chirag Jainf0c2ef385865
diff --git a/.github/workflows/generate-sdk.yaml b/.github/workflows/generate-sdk.yaml
index 2165bb86a..fac179124 100644
--- a/.github/workflows/generate-sdk.yaml
+++ b/.github/workflows/generate-sdk.yaml
@@ -57,12 +57,12 @@ jobs:
- name: Install dependencies
run: pnpm install --frozen-lockfile
- # The spec script imports @truefoundry/utils-core from its build output.
- - name: Build utils-core
- run: pnpm --filter @truefoundry/utils-core build
+ # The spec script imports @truefoundry/trueforge-core from its build output.
+ - name: Build trueforge-core
+ run: pnpm --filter @truefoundry/trueforge-core build
- name: Write OpenAPI document
- run: pnpm --filter @truefoundry/utils openapi:write
+ run: pnpm --filter @truefoundry/trueforge openapi:write
# Generation and its Docker pull are the slow part, so skip everything below
# when neither the document nor the generator config moved.
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 582cf1527..386ae1fee 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -24,10 +24,10 @@ jobs:
- run: pnpm build
- run: pnpm test
- # Guard: git tag must match @truefoundry/utils-core (library is the version authority).
- # npm publishes what's in package.json, not the tag name. @truefoundry/utils may
+ # Guard: git tag must match @truefoundry/trueforge-core (library is the version authority).
+ # npm publishes what's in package.json, not the tag name. @truefoundry/trueforge may
# use an independent version; bump it in the same release PR when the app changes.
- - name: Verify tag matches utils-core version
+ - name: Verify tag matches trueforge-core version
working-directory: packages/harness
run: |
PKG_VERSION="v$(node -p "require('./package.json').version")"
@@ -36,11 +36,11 @@ jobs:
exit 1
fi
- # Library first: utils pins workspace:* → this concrete version on publish.
+ # Library first: @truefoundry/trueforge pins workspace:* → this concrete version on publish.
# Prereleases (e.g. 0.1.9-rc.1) pass --tag explicitly; first preid → dist-tag (rc).
# --no-git-checks: this job checks out a tag (detached HEAD), so pnpm's default
# "current branch is main/master" check would otherwise always fail here.
- - name: Publish @truefoundry/utils-core
+ - name: Publish @truefoundry/trueforge-core
working-directory: packages/harness
run: |
VERSION="$(node -p "require('./package.json').version")"
@@ -56,7 +56,7 @@ jobs:
# TODO(oss): add --provenance once the repo is public. Do NOT add it now:
# provenance publicly attests the source repo and commit.
- # TODO: Publish @truefoundry/utils
+ # TODO: Publish @truefoundry/trueforge
# # Root build copies FE into packages/server/dist/_frontend; refuse an API-only tarball.
# - name: Verify packaged UI is present
@@ -65,4 +65,4 @@ jobs:
# test -f packages/server/dist/_frontend/index.html
# App + CLI from package root (dist/ includes dist/_frontend/).
- # pnpm publish rewrites workspace:* deps to the utils-core version just published.
+ # pnpm publish rewrites workspace:* deps to the trueforge-core version just published.
diff --git a/AGENTS.md b/AGENTS.md
index 9b4bc8c65..98f5e1dbf 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,5 +1,5 @@
- Workspace tasks MUST use `package.json` scripts; add a script when a missing workflow is repeatable like the existing commands, not ad hoc commands.
-- Release wiring MUST keep dist-free host development, `pnpm smoke`, and packed CJS/ESM consumers of `@truefoundry/utils-core` working without changes.
+- Release wiring MUST keep dist-free host development, `pnpm smoke`, and packed CJS/ESM consumers of `@truefoundry/trueforge-core` working without changes.
- Shared Postgres/Redis settings in `docker-compose.yml` and `docker-compose.dev.yml` (image versions, health checks, `env_file`) MUST stay synchronized; intentional differences (app services, data paths, project `name`, host ports, in-network `POSTGRES_HOST` / `REDIS_URL`) MUST stay explicit. `packages/server/.env` is the host-dev + secrets source; `docker-compose.yml` may read it but MUST override container connectivity so host-dev localhost values are not used inside the smoke-test stack.
- Changes to types or schemas MUST keep `packages/harness`, `packages/frontend`, `packages/server`, and `patches` synchronized; they MUST NOT update only one affected layer.
- TypeScript code MUST NOT use assertion escapes such as `as T`, `as unknown as T`, non-null `!`, or `as never` to silence type errors; implementations MUST use sound contracts, guards, or corrected types.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index c0ba5291a..a62b157c5 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -23,15 +23,15 @@ For security vulnerabilities, do **not** open a public issue — see [SECURITY.m
This is a pnpm workspace:
-| Workspace package | Published as | Path | What it is |
-| --------------------------- | ----------------------------- | -------------------------------------------------------- | -------------------------------------------- |
-| `@truefoundry/utils` | `@truefoundry/trueforge` | [`packages/server`](packages/server) | Agent server + bundled UI |
-| `@truefoundry/utils-core` | `@truefoundry/trueforge-core` | [`packages/harness`](packages/harness) | Library: agent core, sessions, and streaming |
-| `@truefoundry/trueforge-ui` | `@truefoundry/trueforge-ui` | [`packages/trueforge-ui-sdk`](packages/trueforge-ui-sdk) | Embeddable agent chat UI SDK |
-| `trueforge` | `trueforge` | [`packages/sdk`](packages/sdk) | Generated TypeScript API client |
-| `frontend` | — | [`packages/frontend`](packages/frontend) | Chat UI app (bundled into the server) |
+| Workspace package | Published as | Path | What it is |
+| ----------------------------- | ----------------------------- | -------------------------------------------------------- | -------------------------------------------- |
+| `@truefoundry/trueforge` | `@truefoundry/trueforge` | [`packages/server`](packages/server) | Agent server + bundled UI |
+| `@truefoundry/trueforge-core` | `@truefoundry/trueforge-core` | [`packages/harness`](packages/harness) | Library: agent core, sessions, and streaming |
+| `@truefoundry/trueforge-ui` | `@truefoundry/trueforge-ui` | [`packages/trueforge-ui-sdk`](packages/trueforge-ui-sdk) | Embeddable agent chat UI SDK |
+| `@truefoundry/trueforge-sdk` | `@truefoundry/trueforge-sdk` | [`packages/sdk`](packages/sdk) | Generated TypeScript API client |
+| `frontend` | — | [`packages/frontend`](packages/frontend) | Chat UI app (bundled into the server) |
-> Note: some workspace package and folder names (`utils`, `harness`) predate the public release names and will be renamed.
+> Note: some folder names (`packages/harness`, `packages/server`) predate the public package names.
## Setup
@@ -76,7 +76,7 @@ pnpm dev
| Dev | `pnpm standalone:dev` | `pnpm dev` (after infra) |
| Prod-like | `pnpm build` → `pnpm standalone:start` | `pnpm build` → `pnpm start` |
-Local server scripts resolve `@truefoundry/utils-core` from source, so you do not need a utils-core `dist/` build for `pnpm dev` / `standalone:dev`. Frontend scripts build `@truefoundry/trueforge-ui` `dist/` before Vite starts (workspace package exports point at `dist/`).
+Local server scripts resolve `@truefoundry/trueforge-core` from source, so you do not need a trueforge-core `dist/` build for `pnpm dev` / `standalone:dev`. Frontend scripts build `@truefoundry/trueforge-ui` `dist/` before Vite starts (workspace package exports point at `dist/`).
### How the UI is served
@@ -124,7 +124,7 @@ See [`packages/server/.env.example`](packages/server/.env.example) for every env
Migrations run on server startup. To run Postgres migrations without starting HTTP:
```bash
-pnpm --filter @truefoundry/utils migrate
+pnpm --filter @truefoundry/trueforge migrate
```
That script sets `STANDALONE=false` and uses `POSTGRES_*` from `packages/server/.env`. It will not run in standalone mode (SQLite migrations happen on boot instead).
diff --git a/Dockerfile b/Dockerfile
index dffc06f4f..cae74d88b 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -1,9 +1,9 @@
# syntax=docker/dockerfile:1
#
-# Multi-stage build for @truefoundry/utils, which also serves the UI: the only image the stack needs.
+# Multi-stage build for @truefoundry/trueforge, which also serves the UI: the only image the stack needs.
#
# Lives at the repository root because the build needs the whole pnpm workspace
-# as its context: the server depends on the workspace package @truefoundry/utils-core.
+# as its context: the server depends on the workspace package @truefoundry/trueforge-core.
#
# Dependency install uses pnpm fetch (lockfile-only) then install --offline so
# the download layer stays cached when only package.json / scripts change.
@@ -43,14 +43,14 @@ COPY packages/harness/scripts packages/harness/scripts
COPY packages/harness/src/core/sandbox/scripts packages/harness/src/core/sandbox/scripts
# ---------------------------------------------------------------------------
-# builder: install all deps (incl. dev) and build utils-core + server.
+# builder: install all deps (incl. dev) and build trueforge-core + server.
# ---------------------------------------------------------------------------
FROM workspace AS builder
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
- pnpm install --frozen-lockfile --offline --filter @truefoundry/utils...
+ pnpm install --frozen-lockfile --offline --filter @truefoundry/trueforge...
COPY packages/harness packages/harness
COPY packages/server packages/server
-RUN pnpm --filter @truefoundry/utils-core build && pnpm --filter @truefoundry/utils build
+RUN pnpm --filter @truefoundry/trueforge-core build && pnpm --filter @truefoundry/trueforge build
# ---------------------------------------------------------------------------
# frontend-builder: build the UI the server serves (parallel to builder above).
@@ -70,7 +70,7 @@ RUN pnpm --filter frontend build
# ---------------------------------------------------------------------------
FROM workspace AS prod-deps
RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
- pnpm install --frozen-lockfile --offline --prod --filter @truefoundry/utils...
+ pnpm install --frozen-lockfile --offline --prod --filter @truefoundry/trueforge...
# ---------------------------------------------------------------------------
# runner: minimal image with prod node_modules + built artifacts.
@@ -83,7 +83,7 @@ COPY --from=prod-deps /app/node_modules ./node_modules
COPY --from=prod-deps /app/packages/harness/node_modules ./packages/harness/node_modules
COPY --from=prod-deps /app/packages/server/node_modules ./packages/server/node_modules
-# Built workspace dependency (@truefoundry/utils-core).
+# Built workspace dependency (@truefoundry/trueforge-core).
COPY --from=builder /app/packages/harness/package.json ./packages/harness/package.json
COPY --from=builder /app/packages/harness/dist ./packages/harness/dist
diff --git a/RELEASING.md b/RELEASING.md
index 40ce13fb7..d6d431eb6 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -2,25 +2,25 @@
Two public packages ship from this repo:
-| Package | Source | How it publishes |
-| ------------------------- | ------------------ | --------------------------------------------------------------- |
-| `@truefoundry/utils-core` | `packages/harness` | From package root (`dist/`) |
-| `@truefoundry/utils` | `packages/server` | From package root (`dist/`, including `dist/_frontend/` for UI) |
-
-The git tag `v*` must match **`packages/harness` (`@truefoundry/utils-core`) version**.
-`@truefoundry/utils` may use an independent version — bump it in the same release PR
-whenever the app/CLI changes. CI publishes **core first**, then utils (so
+| Package | Source | How it publishes |
+| ----------------------------- | ------------------ | --------------------------------------------------------------- |
+| `@truefoundry/trueforge-core` | `packages/harness` | From package root (`dist/`) |
+| `@truefoundry/trueforge` | `packages/server` | From package root (`dist/`, including `dist/_frontend/` for UI) |
+
+The git tag `v*` must match **`packages/harness` (`@truefoundry/trueforge-core`) version**.
+`@truefoundry/trueforge` may use an independent version — bump it in the same release PR
+whenever the app/CLI changes. CI publishes **core first**, then `@truefoundry/trueforge` (so
`workspace:*` rewrites to the core version that just landed on npm).
-> **Currently only `@truefoundry/utils-core` publishes.** The `@truefoundry/utils`
+> **Currently only `@truefoundry/trueforge-core` publishes.** The `@truefoundry/trueforge`
> publish step in `release.yml` is deferred (`TODO`); CI still builds and tests it.
---
-# Releasing `@truefoundry/utils-core`
+# Releasing `@truefoundry/trueforge-core`
Interim setup for the fast development phase: the library in
-`packages/harness` is published **publicly** to npm as `@truefoundry/utils-core`
+`packages/harness` is published **publicly** to npm as `@truefoundry/trueforge-core`
so the gateway can consume it like any normal dependency. The real
open-source release happens later — every deferred item carries a
`TODO(oss):` comment in code so we can grep for them when that day comes.
@@ -42,7 +42,7 @@ its own `.js` (CJS) + `.mjs` (ESM) + `.d.ts` triple under `dist/`, and
scopes the published tarball to just the compiled output. Consequences:
- Deep imports keep the same specifier as before, e.g.
- `@truefoundry/utils-core/core/llm/LLMTypes` — the package's own `"./*"`
+ `@truefoundry/trueforge-core/core/llm/LLMTypes` — the package's own `"./*"`
export pattern maps that to `./dist/core/llm/LLMTypes.{d.ts,js,mjs}`
internally, so no consumer using exports-aware resolution (`bundler`,
`node16`, `nodenext`) needs to change anything. Only a genuinely legacy
@@ -94,7 +94,7 @@ scopes the published tarball to just the compiled output. Consequences:
3. **CI publishes automatically.** `.github/workflows/release.yml` installs,
builds, tests, verifies the tag matches `packages/harness/package.json`, then
- runs `pnpm publish` from `packages/harness`. (The `@truefoundry/utils`
+ runs `pnpm publish` from `packages/harness`. (The `@truefoundry/trueforge`
publish is deferred — see the note above.)
Auth is trusted publishing (OIDC — no `NPM_TOKEN`). pnpm 11 implements the
@@ -102,23 +102,23 @@ scopes the published tarball to just the compiled output. Consequences:
**Dist-tags:** CI passes an explicit `--tag` for prereleases, derived from the
semver prerelease id (`0.2.0-rc.1` → `--tag rc`). Stable releases publish to
- `latest`. Install with `npx @truefoundry/utils@rc` or `@0.2.0-rc.1`; bare
- `npx @truefoundry/utils` stays on `latest`.
+ `latest`. Install with `npx @truefoundry/trueforge@rc` or `@0.2.0-rc.1`; bare
+ `npx @truefoundry/trueforge` stays on `latest`.
4. **Bump the pinned version in the gateway.** Pin exact versions (no `^`)
during the fast 0.x churn:
```json
- "@truefoundry/utils-core": "0.x.y"
+ "@truefoundry/trueforge-core": "0.x.y"
```
-## Why core must publish before utils
+## Why core must publish before `@truefoundry/trueforge`
-`@truefoundry/utils` depends on `@truefoundry/utils-core: workspace:*`. On
+`@truefoundry/trueforge` depends on `@truefoundry/trueforge-core: workspace:*`. On
publish, pnpm rewrites that to the **version in `packages/harness/package.json`**.
If that core version is missing from npm (or is an older build without exports
-the server imports), `npx @truefoundry/utils` fails at runtime. Always ship
-matching core+utils together when the app uses new core APIs.
+the server imports), `npx @truefoundry/trueforge` fails at runtime. Always ship
+matching core and `@truefoundry/trueforge` together when the app uses new core APIs.
## Local iteration without publishing
@@ -145,7 +145,7 @@ Publish a real version when CI or teammates need it.
match `packages/harness/package.json`. Delete the tag
(`git push origin :refs/tags/vX.Y.Z`), fix the version via PR, re-tag.
- **Missing `dist/_frontend/index.html`**: root `pnpm build` must build
- `frontend` before `@truefoundry/utils`; the release job fails closed if the
+ `frontend` before `@truefoundry/trueforge`; the release job fails closed if the
copy is absent.
- **OIDC/auth error in the publish step**: trusted publishing requires
pnpm >= 11.0.7 (native OIDC token exchange; `pnpm/action-setup@v4` reads the
@@ -200,7 +200,7 @@ The dispatch commit SHA is the image tag. The workflow:
2. Watch the run. The image and chart land in JFrog; the job summary prints the
image URI.
-> Publishing `@truefoundry/utils-core` (via `pnpm publish`) is a separate pipeline
+> Publishing `@truefoundry/trueforge-core` (via `pnpm publish`) is a separate pipeline
> (`release.yml`) triggered by a `vX.Y.Z` GitHub Release tag that must match
> `packages/harness/package.json`. It is independent of this image/chart
> workflow.
diff --git a/package.json b/package.json
index 6ec21db5c..5615c4303 100644
--- a/package.json
+++ b/package.json
@@ -6,7 +6,7 @@
"node": ">=22.13.0"
},
"scripts": {
- "build": "pnpm --filter @truefoundry/utils-core build && pnpm --filter @truefoundry/trueforge-ui build && pnpm --filter frontend build && pnpm --filter @truefoundry/utils build",
+ "build": "pnpm --filter @truefoundry/trueforge-core build && pnpm --filter @truefoundry/trueforge-ui build && pnpm --filter frontend build && pnpm --filter @truefoundry/trueforge build",
"chart:deps": "helm dependency build charts/truefoundry-utils",
"chart:lint": "helm lint charts/truefoundry-utils --values charts/truefoundry-utils/ci/lint-values.yaml",
"chart:package": "helm package charts/truefoundry-utils --destination dist",
@@ -14,31 +14,31 @@
"clean:all": "node scripts/clean.mjs --dependencies",
"clean": "node scripts/clean.mjs",
"dev:infra": "docker compose -f docker-compose.dev.yml up",
- "dev:no-watch": "STANDALONE=false NODE_ENV=development pnpm --parallel --filter @truefoundry/utils --filter frontend dev:no-watch",
- "dev:server:ui": "pnpm --filter frontend build && pnpm --filter @truefoundry/utils build:frontend-assets && STANDALONE=false NODE_ENV=development pnpm --parallel --filter @truefoundry/utils-core --filter @truefoundry/utils dev",
- "dev": "STANDALONE=false NODE_ENV=development pnpm --parallel --filter @truefoundry/utils-core --filter @truefoundry/utils --filter frontend dev",
+ "dev:no-watch": "STANDALONE=false NODE_ENV=development pnpm --parallel --filter @truefoundry/trueforge --filter frontend dev:no-watch",
+ "dev:server:ui": "pnpm --filter frontend build && pnpm --filter @truefoundry/trueforge build:frontend-assets && STANDALONE=false NODE_ENV=development pnpm --parallel --filter @truefoundry/trueforge-core --filter @truefoundry/trueforge dev",
+ "dev": "STANDALONE=false NODE_ENV=development pnpm --parallel --filter @truefoundry/trueforge-core --filter @truefoundry/trueforge --filter frontend dev",
"format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,md}\" --cache --error-on-unmatched-pattern --config .prettierrc",
"format:fix": "prettier --write \"**/*.{js,jsx,ts,tsx,json,md}\" --cache --config .prettierrc",
"format": "prettier --write . --cache --config .prettierrc",
"lint:ci": "eslint . --cache --cache-location .eslintcache",
"lint": "eslint . --fix --cache --cache-location .eslintcache",
- "openapi:write": "pnpm --filter @truefoundry/utils openapi:write",
- "pack:dry": "pnpm --filter @truefoundry/utils-core pack:dry && pnpm --filter @truefoundry/utils pack:dry",
- "postinstall": "pnpm --filter @truefoundry/utils-core build:gen",
+ "openapi:write": "pnpm --filter @truefoundry/trueforge openapi:write",
+ "pack:dry": "pnpm --filter @truefoundry/trueforge-core pack:dry && pnpm --filter @truefoundry/trueforge pack:dry",
+ "postinstall": "pnpm --filter @truefoundry/trueforge-core build:gen",
"prepare": "husky || true",
"sdk:generate": "bash scripts/generate-sdk.sh",
"smoke:down": "docker compose down",
"smoke": "docker compose up --build --wait && node -e \"Promise.all([fetch('http://127.0.0.1:8791/healthz'), fetch('http://127.0.0.1:8791/')]).then(async ([health, ui]) => { if (!health.ok) throw new Error('healthz returned ' + health.status); const html = await ui.text(); if (!ui.ok || !html.includes('id=\\\"root\\\"')) throw new Error('UI did not return its app shell'); console.log('healthz and UI OK'); })\"",
- "prestandalone:dev:no-watch": "pnpm --filter @truefoundry/utils migrate:legacy-sqlite-path",
- "prestandalone:dev": "pnpm --filter @truefoundry/utils migrate:legacy-sqlite-path",
- "standalone:dev:no-watch": "STANDALONE=true NODE_ENV=development pnpm --parallel --filter @truefoundry/utils --filter frontend dev:no-watch",
- "standalone:dev": "STANDALONE=true NODE_ENV=development pnpm --parallel --filter @truefoundry/utils-core --filter @truefoundry/utils --filter frontend dev",
- "standalone:start": "STANDALONE=true NODE_ENV=production pnpm --filter @truefoundry/utils start",
- "start": "STANDALONE=false NODE_ENV=production pnpm --filter @truefoundry/utils start",
- "push-sandbox-image-to-daytona": "pnpm --filter @truefoundry/utils push-sandbox-image-to-daytona",
+ "prestandalone:dev:no-watch": "pnpm --filter @truefoundry/trueforge migrate:legacy-sqlite-path",
+ "prestandalone:dev": "pnpm --filter @truefoundry/trueforge migrate:legacy-sqlite-path",
+ "standalone:dev:no-watch": "STANDALONE=true NODE_ENV=development pnpm --parallel --filter @truefoundry/trueforge --filter frontend dev:no-watch",
+ "standalone:dev": "STANDALONE=true NODE_ENV=development pnpm --parallel --filter @truefoundry/trueforge-core --filter @truefoundry/trueforge --filter frontend dev",
+ "standalone:start": "STANDALONE=true NODE_ENV=production pnpm --filter @truefoundry/trueforge start",
+ "start": "STANDALONE=false NODE_ENV=production pnpm --filter @truefoundry/trueforge start",
+ "push-sandbox-image-to-daytona": "pnpm --filter @truefoundry/trueforge push-sandbox-image-to-daytona",
"test:store:local": "bash scripts/test-store-local.sh",
- "test": "pnpm --filter @truefoundry/utils-core test && pnpm --filter @truefoundry/trueforge-ui test && pnpm --filter @truefoundry/utils test && pnpm --filter frontend test",
- "typecheck": "pnpm --filter @truefoundry/utils-core typecheck && pnpm --filter @truefoundry/trueforge-ui typecheck && pnpm --filter @truefoundry/utils typecheck && pnpm --filter frontend typecheck"
+ "test": "pnpm --filter @truefoundry/trueforge-core test && pnpm --filter @truefoundry/trueforge-ui test && pnpm --filter @truefoundry/trueforge test && pnpm --filter frontend test",
+ "typecheck": "pnpm --filter @truefoundry/trueforge-core typecheck && pnpm --filter @truefoundry/trueforge-ui typecheck && pnpm --filter @truefoundry/trueforge typecheck && pnpm --filter frontend typecheck"
},
"devDependencies": {
"@eslint-react/eslint-plugin": "^5.18.0",
diff --git a/packages/harness/package.json b/packages/harness/package.json
index e028611de..1b4942499 100644
--- a/packages/harness/package.json
+++ b/packages/harness/package.json
@@ -1,7 +1,7 @@
{
- "name": "@truefoundry/utils-core",
+ "name": "@truefoundry/trueforge-core",
"version": "0.1.10-rc.1",
- "description": "TrueFoundry Utils Core",
+ "description": "TrueForge core library",
"author": "TrueFoundry",
"license": "MIT",
"private": false,
diff --git a/packages/harness/src/index.ts b/packages/harness/src/index.ts
index 2041f56e5..cfff2eeb5 100644
--- a/packages/harness/src/index.ts
+++ b/packages/harness/src/index.ts
@@ -1,5 +1,5 @@
/**
- * Root barrel for @truefoundry/utils-core.
+ * Root barrel for @truefoundry/trueforge-core.
* Namespaced to avoid colliding event-schema exports between layers.
*/
export * as agentSession from './agent-session';
diff --git a/packages/server/jest.eventsub.config.cjs b/packages/server/jest.eventsub.config.cjs
index 33931ce75..2ae1fa9ac 100644
--- a/packages/server/jest.eventsub.config.cjs
+++ b/packages/server/jest.eventsub.config.cjs
@@ -15,8 +15,8 @@ module.exports = {
},
moduleNameMapper: {
'^(\\.{1,2}/.*)\\.js$': '$1',
- '^@truefoundry/utils-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
- '^@truefoundry/utils-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
+ '^@truefoundry/trueforge-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
+ '^@truefoundry/trueforge-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
},
testTimeout: 30_000,
maxWorkers: '50%',
diff --git a/packages/server/jest.store.postgres.config.cjs b/packages/server/jest.store.postgres.config.cjs
index 6a6183a5a..4e0335775 100644
--- a/packages/server/jest.store.postgres.config.cjs
+++ b/packages/server/jest.store.postgres.config.cjs
@@ -16,8 +16,8 @@ module.exports = {
},
moduleNameMapper: {
'^(\\.{1,2}/.*)\\.js$': '$1',
- '^@truefoundry/utils-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
- '^@truefoundry/utils-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
+ '^@truefoundry/trueforge-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
+ '^@truefoundry/trueforge-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
},
transformIgnorePatterns: ['/node_modules/(?!.*kysely)'],
testTimeout: 120_000,
diff --git a/packages/server/jest.store.sqlite.config.cjs b/packages/server/jest.store.sqlite.config.cjs
index 0502a8d9b..aa525e802 100644
--- a/packages/server/jest.store.sqlite.config.cjs
+++ b/packages/server/jest.store.sqlite.config.cjs
@@ -15,8 +15,8 @@ module.exports = {
},
moduleNameMapper: {
'^(\\.{1,2}/.*)\\.js$': '$1',
- '^@truefoundry/utils-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
- '^@truefoundry/utils-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
+ '^@truefoundry/trueforge-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
+ '^@truefoundry/trueforge-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
},
transformIgnorePatterns: ['/node_modules/(?!.*kysely)'],
testTimeout: 120_000,
diff --git a/packages/server/jest.unit.config.cjs b/packages/server/jest.unit.config.cjs
index 9dfa9a0dd..9acf46820 100644
--- a/packages/server/jest.unit.config.cjs
+++ b/packages/server/jest.unit.config.cjs
@@ -28,12 +28,12 @@ module.exports = {
transformIgnorePatterns: [],
moduleNameMapper: {
'^(\\.{1,2}/.*)\\.js$': '$1',
- '^@truefoundry/utils-core/agent-session$': '<rootDir>/../harness/src/agent-session/index.ts',
- '^@truefoundry/utils-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
- '^@truefoundry/utils-core/request-reply$': '<rootDir>/../harness/src/request-reply/index.ts',
- '^@truefoundry/utils-core/request-reply/(.*)$': '<rootDir>/../harness/src/request-reply/$1',
- '^@truefoundry/utils-core/core$': '<rootDir>/../harness/src/core/index.ts',
- '^@truefoundry/utils-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
+ '^@truefoundry/trueforge-core/agent-session$': '<rootDir>/../harness/src/agent-session/index.ts',
+ '^@truefoundry/trueforge-core/agent-session/(.*)$': '<rootDir>/../harness/src/agent-session/$1',
+ '^@truefoundry/trueforge-core/request-reply$': '<rootDir>/../harness/src/request-reply/index.ts',
+ '^@truefoundry/trueforge-core/request-reply/(.*)$': '<rootDir>/../harness/src/request-reply/$1',
+ '^@truefoundry/trueforge-core/core$': '<rootDir>/../harness/src/core/index.ts',
+ '^@truefoundry/trueforge-core/core/(.*)$': '<rootDir>/../harness/src/core/$1',
},
testTimeout: 30_000,
maxWorkers: '50%',
diff --git a/packages/server/package.json b/packages/server/package.json
index 89a53cc2a..a04697603 100644
--- a/packages/server/package.json
+++ b/packages/server/package.json
@@ -1,7 +1,7 @@
{
- "name": "@truefoundry/utils",
+ "name": "@truefoundry/trueforge",
"version": "0.2.0-rc.2",
- "description": "TrueFoundry agent server + UI (npx @truefoundry/utils)",
+ "description": "TrueFoundry agent server + UI (npx @truefoundry/trueforge)",
"author": "Truefoundry",
"license": "MIT",
"private": false,
@@ -25,8 +25,8 @@
"openapi:write": "pnpm run build:gen && NODE_OPTIONS='--conditions=trueforge-dev' tsx --env-file=.env.test scripts/write-openapi.ts",
"pack:dry": "pnpm pack --dry-run",
"migrate:legacy-sqlite-path": "node scripts/migrate-legacy-sqlite-path.mjs",
- "predev:no-watch": "pnpm --filter @truefoundry/utils-core build:gen && pnpm run build:gen",
- "predev": "pnpm --filter @truefoundry/utils-core build:gen && pnpm run build:gen",
+ "predev:no-watch": "pnpm --filter @truefoundry/trueforge-core build:gen && pnpm run build:gen",
+ "predev": "pnpm --filter @truefoundry/trueforge-core build:gen && pnpm run build:gen",
"test:eventsub": "jest --config jest.eventsub.config.cjs",
"test:store:postgres": "jest --config jest.store.postgres.config.cjs",
"test:store:sqlite": "jest --config jest.store.sqlite.config.cjs",
@@ -39,7 +39,7 @@
"@hono/swagger-ui": "^0.2.1",
"@hono/zod-openapi": "^1.5.1",
"@modelcontextprotocol/sdk": "^1.29.0",
- "@truefoundry/utils-core": "workspace:*",
+ "@truefoundry/trueforge-core": "workspace:*",
"better-sqlite3": "^13.0.2",
"env-paths": "^4.0.0",
"hono": "^4.12.34",
diff --git a/packages/server/scripts/copy-frontend.mjs b/packages/server/scripts/copy-frontend.mjs
index 4453dad1c..ae99dee1f 100644
--- a/packages/server/scripts/copy-frontend.mjs
+++ b/packages/server/scripts/copy-frontend.mjs
@@ -1,6 +1,6 @@
/**
* Copies the monorepo frontend build into `dist/_frontend` so the published
- * `@truefoundry/utils` tarball (and local `node dist/main.js` / `pnpm start`) can serve the UI
+ * `@truefoundry/trueforge` tarball (and local `node dist/main.js` / `pnpm start`) can serve the UI
* from next to the server bundle. Cleared by `pnpm clean` with the rest of dist/.
*
* Root `pnpm build` builds frontend before this package; a missing source only
diff --git a/packages/server/scripts/write-openapi.ts b/packages/server/scripts/write-openapi.ts
index ce6b89101..a7bfcb4cb 100644
--- a/packages/server/scripts/write-openapi.ts
+++ b/packages/server/scripts/write-openapi.ts
@@ -5,9 +5,9 @@
* spec cannot drift from what the server serves. Nothing listens or dials out:
* `.env.test` supplies dummy connection strings.
*/
-import type { TurnStreamingEvent } from '@truefoundry/utils-core/agent-session';
-import { InMemorySessionStore, Sessions } from '@truefoundry/utils-core/agent-session';
-import { RequestReplyRouter } from '@truefoundry/utils-core/request-reply';
+import type { TurnStreamingEvent } from '@truefoundry/trueforge-core/agent-session';
+import { InMemorySessionStore, Sessions } from '@truefoundry/trueforge-core/agent-session';
+import { RequestReplyRouter } from '@truefoundry/trueforge-core/request-reply';
import { mkdirSync, writeFileSync } from 'node:fs';
import path from 'node:path';
import winston from 'winston';
diff --git a/packages/server/src/apis/agents.ts b/packages/server/src/apis/agents.ts
index 52c4aa9df..2e9957441 100644
--- a/packages/server/src/apis/agents.ts
+++ b/packages/server/src/apis/agents.ts
@@ -2,7 +2,7 @@
* DB-backed agent registry API (mounted at /api/v1/agents).
*/
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
-import type { AgentSpec } from '@truefoundry/utils-core/agent-session';
+import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
import { AgentNameConflictError, type AgentRecord, type IAgentStore } from '../db/agentStore';
import type { IMcpServerStore } from '../db/mcpServerStore';
import type { IModelProviderStore } from '../db/modelProviderStore';
diff --git a/packages/server/src/apis/auth.ts b/packages/server/src/apis/auth.ts
index d82857fb5..b6e0ab881 100644
--- a/packages/server/src/apis/auth.ts
+++ b/packages/server/src/apis/auth.ts
@@ -1,5 +1,5 @@
import { OpenAPIHono } from '@hono/zod-openapi';
-import { extractErrorLogFields } from '@truefoundry/utils-core/core';
+import { extractErrorLogFields } from '@truefoundry/trueforge-core/core';
import type { Configuration } from 'openid-client';
import type { Logger } from 'winston';
import { clearAuthCookie, ID_TOKEN_COOKIE, OAUTH_STATE_COOKIE, readOAuthStateCookie } from '../auth/cookies';
diff --git a/packages/server/src/apis/catalog.ts b/packages/server/src/apis/catalog.ts
index 07698fc80..3a2bb2c65 100644
--- a/packages/server/src/apis/catalog.ts
+++ b/packages/server/src/apis/catalog.ts
@@ -1,5 +1,5 @@
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
-import { SUPPORTED_REASONING_EFFORTS } from '@truefoundry/utils-core/core';
+import { SUPPORTED_REASONING_EFFORTS } from '@truefoundry/trueforge-core/core';
import type { McpCatalog } from '../catalog/McpCatalog';
import type { ModelCatalog } from '../catalog/ModelCatalog';
import type { SandboxCatalog } from '../catalog/SandboxCatalog';
diff --git a/packages/server/src/apis/mcpOAuth.ts b/packages/server/src/apis/mcpOAuth.ts
index 154175069..62afd6617 100644
--- a/packages/server/src/apis/mcpOAuth.ts
+++ b/packages/server/src/apis/mcpOAuth.ts
@@ -1,5 +1,5 @@
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
-import { extractErrorLogFields, McpConnectionError } from '@truefoundry/utils-core/core';
+import { extractErrorLogFields, McpConnectionError } from '@truefoundry/trueforge-core/core';
import type { Logger } from 'winston';
import type { WithTransaction } from '../db/transaction';
import { completeMcpAuthorization } from '../mcp/auth/mcpDcr';
diff --git a/packages/server/src/apis/mcpServers.ts b/packages/server/src/apis/mcpServers.ts
index 2b1498cdb..8fee16d88 100644
--- a/packages/server/src/apis/mcpServers.ts
+++ b/packages/server/src/apis/mcpServers.ts
@@ -1,5 +1,5 @@
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
-import { extractErrorLogFields, isAuthRequired, McpConnectionError, RemoteMCP } from '@truefoundry/utils-core/core';
+import { extractErrorLogFields, isAuthRequired, McpConnectionError, RemoteMCP } from '@truefoundry/trueforge-core/core';
import type { Logger } from 'winston';
import type { ResolveUserContext } from '../auth/identity';
import configuration from '../config';
diff --git a/packages/server/src/apis/sessions.ts b/packages/server/src/apis/sessions.ts
index e93858cfc..5078af7f0 100644
--- a/packages/server/src/apis/sessions.ts
+++ b/packages/server/src/apis/sessions.ts
@@ -2,18 +2,18 @@
* DB-backed sessions API (mounted at /api/v1/sessions).
*/
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
-import type { ISessionStore, SessionRecord, Sessions } from '@truefoundry/utils-core/agent-session';
+import type { ISessionStore, SessionRecord, Sessions } from '@truefoundry/trueforge-core/agent-session';
import {
CancellationReason,
SessionStoreConflictError,
SessionStoreInvariantError,
SessionStoreNotFoundError,
-} from '@truefoundry/utils-core/agent-session';
+} from '@truefoundry/trueforge-core/agent-session';
import type {
RouteHandler as RequestReplyRouteHandler,
RequestReplyRouter,
-} from '@truefoundry/utils-core/request-reply';
-import { NoResponderError, redisRequest, RequestTimeoutError } from '@truefoundry/utils-core/request-reply';
+} from '@truefoundry/trueforge-core/request-reply';
+import { NoResponderError, redisRequest, RequestTimeoutError } from '@truefoundry/trueforge-core/request-reply';
import { HTTPException } from 'hono/http-exception';
import type { RedisClientType } from 'redis';
import { ulid } from 'ulid';
diff --git a/packages/server/src/apis/turns.ts b/packages/server/src/apis/turns.ts
index cd9c42519..47876fdf0 100644
--- a/packages/server/src/apis/turns.ts
+++ b/packages/server/src/apis/turns.ts
@@ -2,7 +2,7 @@
* DB-backed turns API (mounted at /api/v1/sessions).
*/
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
-import type { ISessionStore, Sessions, Turn, TurnStreamingEvent } from '@truefoundry/utils-core/agent-session';
+import type { ISessionStore, Sessions, Turn, TurnStreamingEvent } from '@truefoundry/trueforge-core/agent-session';
import {
CancellationReason,
EventType,
@@ -11,7 +11,7 @@ import {
TurnResourceResolver,
type TurnInputItem,
type TurnRecordWithoutSnapshot,
-} from '@truefoundry/utils-core/agent-session';
+} from '@truefoundry/trueforge-core/agent-session';
import {
AgentHarnessError,
extractErrorLogFields,
@@ -21,7 +21,7 @@ import {
SandboxError,
validateSandboxOwnedByTenant,
VercelAILLM,
-} from '@truefoundry/utils-core/core';
+} from '@truefoundry/trueforge-core/core';
import type { Context } from 'hono';
import { HTTPException } from 'hono/http-exception';
import { streamSSE } from 'hono/streaming';
diff --git a/packages/server/src/app.ts b/packages/server/src/app.ts
index baf1d6981..429f0dd10 100644
--- a/packages/server/src/app.ts
+++ b/packages/server/src/app.ts
@@ -1,9 +1,9 @@
/** The API: resource routers, the OpenAPI document and Swagger UI, all under /api/v1. */
import { swaggerUI } from '@hono/swagger-ui';
import { OpenAPIHono, z } from '@hono/zod-openapi';
-import type { ISessionStore, Sessions, TurnStreamingEvent } from '@truefoundry/utils-core/agent-session';
-import { extractErrorLogFields } from '@truefoundry/utils-core/core';
-import type { RequestReplyRouter } from '@truefoundry/utils-core/request-reply';
+import type { ISessionStore, Sessions, TurnStreamingEvent } from '@truefoundry/trueforge-core/agent-session';
+import { extractErrorLogFields } from '@truefoundry/trueforge-core/core';
+import type { RequestReplyRouter } from '@truefoundry/trueforge-core/request-reply';
import type { Context, ErrorHandler } from 'hono';
import { HTTPException } from 'hono/http-exception';
import type { Configuration } from 'openid-client';
diff --git a/packages/server/src/cli.ts b/packages/server/src/cli.ts
index 8e2ffe0ac..a107792da 100644
--- a/packages/server/src/cli.ts
+++ b/packages/server/src/cli.ts
@@ -1,8 +1,8 @@
/**
- * CLI entry for `@truefoundry/utils` (`package.json` `bin` → `dist/cli.js`).
+ * CLI entry for `@truefoundry/trueforge` (`package.json` `bin` → `dist/cli.js`).
*
* Kept separate from `main.ts` so Docker / `pnpm start` can boot with env only
- * (`node dist/main.js`), while `npx @truefoundry/utils` gets a shebang, `--help`,
+ * (`node dist/main.js`), while `npx @truefoundry/trueforge` gets a shebang, `--help`,
* and `--port`. Flags must be applied before importing `./main` because config
* reads `process.env` at module load.
*
@@ -13,8 +13,8 @@ import { parseArgs } from 'node:util';
function printUsage(): void {
console.log(`Usage:
- npx @truefoundry/utils
- npx @truefoundry/utils --port <n>
+ npx @truefoundry/trueforge
+ npx @truefoundry/trueforge --port <n>
Start the agent server. Defaults to standalone mode (SQLite, no Redis).
Set STANDALONE=false with Postgres and Redis for multi-replica peering.
diff --git a/packages/server/src/db/agentStore.ts b/packages/server/src/db/agentStore.ts
index a711a2eec..13ac9b803 100644
--- a/packages/server/src/db/agentStore.ts
+++ b/packages/server/src/db/agentStore.ts
@@ -4,7 +4,7 @@
* `AgentSpec` jsonb document.
* Implementations: PostgresAgentStore and SqliteAgentStore.
*/
-import { AgentSpecSchema, type AgentSpec } from '@truefoundry/utils-core/agent-session';
+import { AgentSpecSchema, type AgentSpec } from '@truefoundry/trueforge-core/agent-session';
import type { ResourceName } from '../schemas/common';
export interface AgentRecord {
diff --git a/packages/server/src/db/postgres/session-store/PostgresSessionStore.ts b/packages/server/src/db/postgres/session-store/PostgresSessionStore.ts
index fee179d5e..486594e9b 100644
--- a/packages/server/src/db/postgres/session-store/PostgresSessionStore.ts
+++ b/packages/server/src/db/postgres/session-store/PostgresSessionStore.ts
@@ -1,7 +1,7 @@
-import type { SessionRecord } from '@truefoundry/utils-core/agent-session/models/SessionRecord';
-import type { TurnRecord } from '@truefoundry/utils-core/agent-session/models/TurnRecord';
-import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/utils-core/agent-session/schemas/events';
-import type { TokenPagination } from '@truefoundry/utils-core/agent-session/schemas/pagination';
+import type { SessionRecord } from '@truefoundry/trueforge-core/agent-session/models/SessionRecord';
+import type { TurnRecord } from '@truefoundry/trueforge-core/agent-session/models/TurnRecord';
+import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/trueforge-core/agent-session/schemas/events';
+import type { TokenPagination } from '@truefoundry/trueforge-core/agent-session/schemas/pagination';
import type {
AddThreadsInput,
AppendToEventsInput,
@@ -25,11 +25,11 @@ import type {
TurnRecordWithoutSnapshot,
UpdateSessionInput,
UpdateTurnStateInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import {
decodeOffsetPageToken,
encodeOffsetPageToken,
-} from '@truefoundry/utils-core/agent-session/store/OffsetPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/OffsetPageToken';
import type { Kysely } from 'kysely';
import type { Database } from '../types';
import { patchThreadCapabilityState as patchThreadCapabilityStateQuery } from './queries/capabilities';
diff --git a/packages/server/src/db/postgres/session-store/queries/capabilities.ts b/packages/server/src/db/postgres/session-store/queries/capabilities.ts
index f9acca365..362d34ffc 100644
--- a/packages/server/src/db/postgres/session-store/queries/capabilities.ts
+++ b/packages/server/src/db/postgres/session-store/queries/capabilities.ts
@@ -1,4 +1,4 @@
-import type { PatchThreadCapabilityStateInput } from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+import type { PatchThreadCapabilityStateInput } from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import { sql, type Kysely } from 'kysely';
import { json } from '../../sqlExpressions';
import type { Database } from '../../types';
diff --git a/packages/server/src/db/postgres/session-store/queries/events.ts b/packages/server/src/db/postgres/session-store/queries/events.ts
index 246b70d58..ca21bc666 100644
--- a/packages/server/src/db/postgres/session-store/queries/events.ts
+++ b/packages/server/src/db/postgres/session-store/queries/events.ts
@@ -1,20 +1,23 @@
-import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/utils-core/agent-session/schemas/events';
-import type { TokenPagination } from '@truefoundry/utils-core/agent-session/schemas/pagination';
+import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/trueforge-core/agent-session/schemas/events';
+import type { TokenPagination } from '@truefoundry/trueforge-core/agent-session/schemas/pagination';
import type {
AppendToEventsInput,
ListSessionEventsInput,
ListTurnEventsInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
-import { decodeOffsetPageToken, paginateOffsetRows } from '@truefoundry/utils-core/agent-session/store/OffsetPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
+import {
+ decodeOffsetPageToken,
+ paginateOffsetRows,
+} from '@truefoundry/trueforge-core/agent-session/store/OffsetPageToken';
import {
decodeSessionEventPageToken,
paginateSessionEventRows,
type SessionEventPageCursor,
-} from '@truefoundry/utils-core/agent-session/store/SessionEventPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionEventPageToken';
import {
SessionNotFoundError,
TurnNotFoundError,
-} from '@truefoundry/utils-core/agent-session/store/SessionStoreErrors';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
import type { Kysely } from 'kysely';
import { sql } from 'kysely';
import { json } from '../../sqlExpressions';
diff --git a/packages/server/src/db/postgres/session-store/queries/sessions.ts b/packages/server/src/db/postgres/session-store/queries/sessions.ts
index 3d2d15525..62894605b 100644
--- a/packages/server/src/db/postgres/session-store/queries/sessions.ts
+++ b/packages/server/src/db/postgres/session-store/queries/sessions.ts
@@ -1,21 +1,21 @@
-import type { AgentSpec } from '@truefoundry/utils-core/agent-session';
-import type { SessionRecord } from '@truefoundry/utils-core/agent-session/models/SessionRecord';
+import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
+import type { SessionRecord } from '@truefoundry/trueforge-core/agent-session/models/SessionRecord';
import type {
CreateSessionInput,
DeleteSessionInput,
GetSessionInput,
ListSessionsInput,
UpdateSessionInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import {
decodeSessionListPageToken,
paginateSessionListRows,
-} from '@truefoundry/utils-core/agent-session/store/SessionListPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionListPageToken';
import {
SessionAlreadyExistsError,
SessionNotFoundError,
SessionStoreInvariantError,
-} from '@truefoundry/utils-core/agent-session/store/SessionStoreErrors';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
import { sql, type Kysely } from 'kysely';
import { sessionAgentFromColumns, sessionAgentToColumns } from '../../../sessionAgentColumns';
import { json } from '../../sqlExpressions';
diff --git a/packages/server/src/db/postgres/session-store/queries/threads.ts b/packages/server/src/db/postgres/session-store/queries/threads.ts
index bc7e1cf99..1b247a400 100644
--- a/packages/server/src/db/postgres/session-store/queries/threads.ts
+++ b/packages/server/src/db/postgres/session-store/queries/threads.ts
@@ -5,11 +5,14 @@ import type {
PatchMCPServersInput,
PatchSandboxInfoInput,
RemoveThreadsInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
-import type { JsonValue } from '@truefoundry/utils-core/core/capabilities/AgentCapability';
-import type { AgentInfo } from '@truefoundry/utils-core/core/events/schema';
-import type { ContextMessage, SubAgentCompletionMarker } from '@truefoundry/utils-core/core/runtime/AgentThread.types';
-import type { CurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
+import type { JsonValue } from '@truefoundry/trueforge-core/core/capabilities/AgentCapability';
+import type { AgentInfo } from '@truefoundry/trueforge-core/core/events/schema';
+import type {
+ ContextMessage,
+ SubAgentCompletionMarker,
+} from '@truefoundry/trueforge-core/core/runtime/AgentThread.types';
+import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
import { sql, type Kysely, type RawBuilder, type Transaction } from 'kysely';
import { json, jsonbSet } from '../../sqlExpressions';
import type { Database, TurnThreadCheckpoint } from '../../types';
diff --git a/packages/server/src/db/postgres/session-store/queries/turns.ts b/packages/server/src/db/postgres/session-store/queries/turns.ts
index 5eeb73526..dceaa8323 100644
--- a/packages/server/src/db/postgres/session-store/queries/turns.ts
+++ b/packages/server/src/db/postgres/session-store/queries/turns.ts
@@ -1,16 +1,16 @@
-import type { TurnRecord, TurnSnapshot } from '@truefoundry/utils-core/agent-session/models/TurnRecord';
+import type { TurnRecord, TurnSnapshot } from '@truefoundry/trueforge-core/agent-session/models/TurnRecord';
import {
CancellationReason,
type TerminalTurnState,
type TurnInputItem,
type TurnState,
-} from '@truefoundry/utils-core/agent-session/schemas/turn';
-import { assertCreateTurnThreadDelta } from '@truefoundry/utils-core/agent-session/store/assertCreateTurnThreadDelta';
+} from '@truefoundry/trueforge-core/agent-session/schemas/turn';
+import { assertCreateTurnThreadDelta } from '@truefoundry/trueforge-core/agent-session/store/assertCreateTurnThreadDelta';
import type {
FreezeAndGetTurnInput,
TurnRecordWithoutSnapshot,
UpdateTurnStateInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import {
PreviousTurnRunningError,
SessionNotFoundError,
@@ -20,13 +20,13 @@ import {
TurnAlreadyExistsError,
TurnNotFoundError,
TurnNotRunningError,
-} from '@truefoundry/utils-core/agent-session/store/SessionStoreErrors';
-import type { CapabilityState, JsonValue } from '@truefoundry/utils-core/core/capabilities/AgentCapability';
-import type { AgentInfo, AgentParent, MCPServerInitInfo } from '@truefoundry/utils-core/core/events/schema';
-import type { AgentThreadSnapshot, ContextMessage } from '@truefoundry/utils-core/core/runtime/AgentThread.types';
-import type { CurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
-import { getEmptyCurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
-import type { SandboxInfo } from '@truefoundry/utils-core/core/sandbox/Sandbox';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
+import type { CapabilityState, JsonValue } from '@truefoundry/trueforge-core/core/capabilities/AgentCapability';
+import type { AgentInfo, AgentParent, MCPServerInitInfo } from '@truefoundry/trueforge-core/core/events/schema';
+import type { AgentThreadSnapshot, ContextMessage } from '@truefoundry/trueforge-core/core/runtime/AgentThread.types';
+import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
+import { getEmptyCurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
+import type { SandboxInfo } from '@truefoundry/trueforge-core/core/sandbox/Sandbox';
import { sql, type Kysely, type QueryCreator, type RawBuilder, type Transaction } from 'kysely';
import { isUniqueViolation } from '../../client';
import { json } from '../../sqlExpressions';
diff --git a/packages/server/src/db/postgres/types.ts b/packages/server/src/db/postgres/types.ts
index 322430085..b004587f8 100644
--- a/packages/server/src/db/postgres/types.ts
+++ b/packages/server/src/db/postgres/types.ts
@@ -2,7 +2,12 @@
* Live app schema for the runtime Kysely client / Postgres-backed session store.
* Migrations must not use this type — use `Kysely<unknown>` instead.
*/
-import type { AgentSpec, PersistedTurnEvent, TurnInputItem, TurnState } from '@truefoundry/utils-core/agent-session';
+import type {
+ AgentSpec,
+ PersistedTurnEvent,
+ TurnInputItem,
+ TurnState,
+} from '@truefoundry/trueforge-core/agent-session';
import type {
AgentInfo,
AgentParent,
@@ -11,8 +16,8 @@ import type {
MCPServerInitInfo,
SandboxInfo,
SubAgentCompletionMarker,
-} from '@truefoundry/utils-core/core';
-import type { CurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
+} from '@truefoundry/trueforge-core/core';
+import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
import type { ColumnType, Generated, JSONColumnType } from 'kysely';
import type { McpServerManifest } from '../../schemas/mcpServer';
import type { ModelProvider } from '../../schemas/modelProvider';
diff --git a/packages/server/src/db/sessionAgentColumns.ts b/packages/server/src/db/sessionAgentColumns.ts
index d957d987e..dc5355708 100644
--- a/packages/server/src/db/sessionAgentColumns.ts
+++ b/packages/server/src/db/sessionAgentColumns.ts
@@ -1,4 +1,4 @@
-import { AgentSpecSchema, type AgentSpec, type SessionAgent } from '@truefoundry/utils-core/agent-session';
+import { AgentSpecSchema, type AgentSpec, type SessionAgent } from '@truefoundry/trueforge-core/agent-session';
/** Flatten domain agent for SQL session columns (XOR agent_id / agent_spec; optional name snapshot). */
export function sessionAgentToColumns(agent: SessionAgent): {
diff --git a/packages/server/src/db/sqlite/agent-store/SqliteAgentStore.ts b/packages/server/src/db/sqlite/agent-store/SqliteAgentStore.ts
index 2785bfe8c..2c18ab67a 100644
--- a/packages/server/src/db/sqlite/agent-store/SqliteAgentStore.ts
+++ b/packages/server/src/db/sqlite/agent-store/SqliteAgentStore.ts
@@ -1,4 +1,4 @@
-import type { AgentSpec } from '@truefoundry/utils-core/agent-session';
+import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
import type { ExpressionBuilder, Kysely, Transaction } from 'kysely';
import { ulid } from 'ulid';
import {
diff --git a/packages/server/src/db/sqlite/session-store/SqliteSessionStore.ts b/packages/server/src/db/sqlite/session-store/SqliteSessionStore.ts
index eb85c9556..3166ee5a9 100644
--- a/packages/server/src/db/sqlite/session-store/SqliteSessionStore.ts
+++ b/packages/server/src/db/sqlite/session-store/SqliteSessionStore.ts
@@ -1,7 +1,7 @@
-import type { SessionRecord } from '@truefoundry/utils-core/agent-session/models/SessionRecord';
-import type { TurnRecord } from '@truefoundry/utils-core/agent-session/models/TurnRecord';
-import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/utils-core/agent-session/schemas/events';
-import type { TokenPagination } from '@truefoundry/utils-core/agent-session/schemas/pagination';
+import type { SessionRecord } from '@truefoundry/trueforge-core/agent-session/models/SessionRecord';
+import type { TurnRecord } from '@truefoundry/trueforge-core/agent-session/models/TurnRecord';
+import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/trueforge-core/agent-session/schemas/events';
+import type { TokenPagination } from '@truefoundry/trueforge-core/agent-session/schemas/pagination';
import type {
AddThreadsInput,
AppendToEventsInput,
@@ -25,11 +25,11 @@ import type {
TurnRecordWithoutSnapshot,
UpdateSessionInput,
UpdateTurnStateInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import {
decodeOffsetPageToken,
encodeOffsetPageToken,
-} from '@truefoundry/utils-core/agent-session/store/OffsetPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/OffsetPageToken';
import type { Kysely } from 'kysely';
import type { Database } from '../types';
import { patchThreadCapabilityState as patchThreadCapabilityStateQuery } from './queries/capabilities';
diff --git a/packages/server/src/db/sqlite/session-store/queries/capabilities.ts b/packages/server/src/db/sqlite/session-store/queries/capabilities.ts
index 4a99b7f51..791726bf9 100644
--- a/packages/server/src/db/sqlite/session-store/queries/capabilities.ts
+++ b/packages/server/src/db/sqlite/session-store/queries/capabilities.ts
@@ -1,4 +1,4 @@
-import type { PatchThreadCapabilityStateInput } from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+import type { PatchThreadCapabilityStateInput } from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import { sql, type Kysely } from 'kysely';
import { jsonbBind, nowIso } from '../../sqlExpressions';
import type { Database } from '../../types';
diff --git a/packages/server/src/db/sqlite/session-store/queries/events.ts b/packages/server/src/db/sqlite/session-store/queries/events.ts
index 424d363a3..e4e6e5f12 100644
--- a/packages/server/src/db/sqlite/session-store/queries/events.ts
+++ b/packages/server/src/db/sqlite/session-store/queries/events.ts
@@ -1,20 +1,23 @@
-import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/utils-core/agent-session/schemas/events';
-import type { TokenPagination } from '@truefoundry/utils-core/agent-session/schemas/pagination';
+import type { PersistedTurnEvent, SessionEventItem } from '@truefoundry/trueforge-core/agent-session/schemas/events';
+import type { TokenPagination } from '@truefoundry/trueforge-core/agent-session/schemas/pagination';
import type {
AppendToEventsInput,
ListSessionEventsInput,
ListTurnEventsInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
-import { decodeOffsetPageToken, paginateOffsetRows } from '@truefoundry/utils-core/agent-session/store/OffsetPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
+import {
+ decodeOffsetPageToken,
+ paginateOffsetRows,
+} from '@truefoundry/trueforge-core/agent-session/store/OffsetPageToken';
import {
decodeSessionEventPageToken,
paginateSessionEventRows,
type SessionEventPageCursor,
-} from '@truefoundry/utils-core/agent-session/store/SessionEventPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionEventPageToken';
import {
SessionNotFoundError,
TurnNotFoundError,
-} from '@truefoundry/utils-core/agent-session/store/SessionStoreErrors';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
import { sql, type Kysely } from 'kysely';
import { jsonbBind, jsonText } from '../../sqlExpressions';
import type { Database } from '../../types';
diff --git a/packages/server/src/db/sqlite/session-store/queries/sessions.ts b/packages/server/src/db/sqlite/session-store/queries/sessions.ts
index 571ec8844..beaf1414e 100644
--- a/packages/server/src/db/sqlite/session-store/queries/sessions.ts
+++ b/packages/server/src/db/sqlite/session-store/queries/sessions.ts
@@ -1,21 +1,21 @@
-import type { AgentSpec } from '@truefoundry/utils-core/agent-session';
-import type { SessionRecord } from '@truefoundry/utils-core/agent-session/models/SessionRecord';
+import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
+import type { SessionRecord } from '@truefoundry/trueforge-core/agent-session/models/SessionRecord';
import type {
CreateSessionInput,
DeleteSessionInput,
GetSessionInput,
ListSessionsInput,
UpdateSessionInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import {
decodeSessionListPageToken,
paginateSessionListRows,
-} from '@truefoundry/utils-core/agent-session/store/SessionListPageToken';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionListPageToken';
import {
SessionAlreadyExistsError,
SessionNotFoundError,
SessionStoreInvariantError,
-} from '@truefoundry/utils-core/agent-session/store/SessionStoreErrors';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
import { sql, type Kysely } from 'kysely';
import { sessionAgentFromColumns, sessionAgentToColumns } from '../../../sessionAgentColumns';
import { isUniqueViolation } from '../../client';
diff --git a/packages/server/src/db/sqlite/session-store/queries/threads.ts b/packages/server/src/db/sqlite/session-store/queries/threads.ts
index a3f220215..811af4b1d 100644
--- a/packages/server/src/db/sqlite/session-store/queries/threads.ts
+++ b/packages/server/src/db/sqlite/session-store/queries/threads.ts
@@ -5,9 +5,12 @@ import type {
PatchMCPServersInput,
PatchSandboxInfoInput,
RemoveThreadsInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
-import type { ContextMessage, SubAgentCompletionMarker } from '@truefoundry/utils-core/core/runtime/AgentThread.types';
-import type { CurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
+import type {
+ ContextMessage,
+ SubAgentCompletionMarker,
+} from '@truefoundry/trueforge-core/core/runtime/AgentThread.types';
+import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
import { sql, type Kysely, type RawBuilder, type Transaction } from 'kysely';
import { jsonbBind, jsonbSet, nowIso } from '../../sqlExpressions';
import type { Database, TurnThreadCheckpoint } from '../../types';
diff --git a/packages/server/src/db/sqlite/session-store/queries/turns.ts b/packages/server/src/db/sqlite/session-store/queries/turns.ts
index 53856d554..e2b050928 100644
--- a/packages/server/src/db/sqlite/session-store/queries/turns.ts
+++ b/packages/server/src/db/sqlite/session-store/queries/turns.ts
@@ -1,16 +1,16 @@
-import type { TurnRecord, TurnSnapshot } from '@truefoundry/utils-core/agent-session/models/TurnRecord';
+import type { TurnRecord, TurnSnapshot } from '@truefoundry/trueforge-core/agent-session/models/TurnRecord';
import {
CancellationReason,
type TerminalTurnState,
type TurnInputItem,
type TurnState,
-} from '@truefoundry/utils-core/agent-session/schemas/turn';
-import { assertCreateTurnThreadDelta } from '@truefoundry/utils-core/agent-session/store/assertCreateTurnThreadDelta';
+} from '@truefoundry/trueforge-core/agent-session/schemas/turn';
+import { assertCreateTurnThreadDelta } from '@truefoundry/trueforge-core/agent-session/store/assertCreateTurnThreadDelta';
import type {
FreezeAndGetTurnInput,
TurnRecordWithoutSnapshot,
UpdateTurnStateInput,
-} from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+} from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import {
PreviousTurnRunningError,
SessionNotFoundError,
@@ -20,13 +20,13 @@ import {
TurnAlreadyExistsError,
TurnNotFoundError,
TurnNotRunningError,
-} from '@truefoundry/utils-core/agent-session/store/SessionStoreErrors';
-import type { CapabilityState, JsonValue } from '@truefoundry/utils-core/core/capabilities/AgentCapability';
-import type { AgentInfo, AgentParent, MCPServerInitInfo } from '@truefoundry/utils-core/core/events/schema';
-import type { AgentThreadSnapshot, ContextMessage } from '@truefoundry/utils-core/core/runtime/AgentThread.types';
-import type { CurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
-import { getEmptyCurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
-import type { SandboxInfo } from '@truefoundry/utils-core/core/sandbox/Sandbox';
+} from '@truefoundry/trueforge-core/agent-session/store/SessionStoreErrors';
+import type { CapabilityState, JsonValue } from '@truefoundry/trueforge-core/core/capabilities/AgentCapability';
+import type { AgentInfo, AgentParent, MCPServerInitInfo } from '@truefoundry/trueforge-core/core/events/schema';
+import type { AgentThreadSnapshot, ContextMessage } from '@truefoundry/trueforge-core/core/runtime/AgentThread.types';
+import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
+import { getEmptyCurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
+import type { SandboxInfo } from '@truefoundry/trueforge-core/core/sandbox/Sandbox';
import { sql, type Kysely, type RawBuilder, type Transaction } from 'kysely';
import { isUniqueViolation } from '../../client';
import { jsonbBind, jsonText, nowIso } from '../../sqlExpressions';
diff --git a/packages/server/src/db/sqlite/types.ts b/packages/server/src/db/sqlite/types.ts
index 854b0ca44..ff66e6b60 100644
--- a/packages/server/src/db/sqlite/types.ts
+++ b/packages/server/src/db/sqlite/types.ts
@@ -5,7 +5,12 @@
* JSON payload columns are BLOB JSONB on disk. Reads must project `json(column)`;
* `ParseJSONResultsPlugin` (configured in createSqliteDb) parses those top-level columns only.
*/
-import type { AgentSpec, PersistedTurnEvent, TurnInputItem, TurnState } from '@truefoundry/utils-core/agent-session';
+import type {
+ AgentSpec,
+ PersistedTurnEvent,
+ TurnInputItem,
+ TurnState,
+} from '@truefoundry/trueforge-core/agent-session';
import type {
AgentInfo,
AgentParent,
@@ -14,8 +19,8 @@ import type {
MCPServerInitInfo,
SandboxInfo,
SubAgentCompletionMarker,
-} from '@truefoundry/utils-core/core';
-import type { CurrentContextUsage } from '@truefoundry/utils-core/core/runtime/contextUsage';
+} from '@truefoundry/trueforge-core/core';
+import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
import type { ColumnType, Generated, JSONColumnType } from 'kysely';
import type { McpServerManifest } from '../../schemas/mcpServer';
import type { ModelProvider } from '../../schemas/modelProvider';
diff --git a/packages/server/src/main.ts b/packages/server/src/main.ts
index 2eaf02f9a..0b5ff94d5 100644
--- a/packages/server/src/main.ts
+++ b/packages/server/src/main.ts
@@ -9,7 +9,7 @@
* (migrate, Redis, listen) are caught below and exit non-zero. SQLite vs
* Postgres store modules stay dynamic so only the active engine is loaded.
*/
-import { extractErrorLogFields } from '@truefoundry/utils-core/core';
+import { extractErrorLogFields } from '@truefoundry/trueforge-core/core';
import { mkdir } from 'node:fs/promises';
import path from 'node:path';
@@ -32,8 +32,8 @@ import {
Sessions,
type ISessionStore,
type TurnStreamingEvent,
-} from '@truefoundry/utils-core/agent-session';
-import { RequestReplyExecutor, RequestReplyRouter } from '@truefoundry/utils-core/request-reply';
+} from '@truefoundry/trueforge-core/agent-session';
+import { RequestReplyExecutor, RequestReplyRouter } from '@truefoundry/trueforge-core/request-reply';
import type { Transaction } from 'kysely';
import type { RedisClientType } from 'redis';
import winston, { type Logger } from 'winston';
diff --git a/packages/server/src/mcp/auth/mcpDcr.ts b/packages/server/src/mcp/auth/mcpDcr.ts
index a69291340..5324f3cf5 100644
--- a/packages/server/src/mcp/auth/mcpDcr.ts
+++ b/packages/server/src/mcp/auth/mcpDcr.ts
@@ -13,7 +13,7 @@ import type {
OAuthTokens,
} from '@modelcontextprotocol/sdk/shared/auth.js';
import type { FetchLike } from '@modelcontextprotocol/sdk/shared/transport.js';
-import { McpConnectionError, McpDcrConfigurationError } from '@truefoundry/utils-core/core';
+import { McpConnectionError, McpDcrConfigurationError } from '@truefoundry/trueforge-core/core';
import { randomBytes } from 'node:crypto';
import type { WithTransaction } from '../../db/transaction';
import {
diff --git a/packages/server/src/mcp/auth/mcpOAuthHelpers.ts b/packages/server/src/mcp/auth/mcpOAuthHelpers.ts
index 84932b329..a259155b7 100644
--- a/packages/server/src/mcp/auth/mcpOAuthHelpers.ts
+++ b/packages/server/src/mcp/auth/mcpOAuthHelpers.ts
@@ -3,7 +3,7 @@ import type {
OAuthClientInformationMixed,
OAuthTokens,
} from '@modelcontextprotocol/sdk/shared/auth.js';
-import { McpConnectionError } from '@truefoundry/utils-core/core';
+import { McpConnectionError } from '@truefoundry/trueforge-core/core';
import { getPublicBaseUrl } from '../../config';
import type { OAuthClientCredentials, OAuthServerMetadata, OAuthToken } from './types';
diff --git a/packages/server/src/runtime/activeTurns.ts b/packages/server/src/runtime/activeTurns.ts
index e847ca1d4..a8fa87d6e 100644
--- a/packages/server/src/runtime/activeTurns.ts
+++ b/packages/server/src/runtime/activeTurns.ts
@@ -4,7 +4,7 @@
* TurnHandle.stream() writes the terminal state when the signal fires.
* `track()` owns registration and cleanup around the stream lifecycle.
*/
-import { CancellationReason } from '@truefoundry/utils-core/agent-session';
+import { CancellationReason } from '@truefoundry/trueforge-core/agent-session';
interface ActiveTurnRun {
abortController: AbortController;
diff --git a/packages/server/src/runtime/redis.ts b/packages/server/src/runtime/redis.ts
index 8dbf95c06..df61a6820 100644
--- a/packages/server/src/runtime/redis.ts
+++ b/packages/server/src/runtime/redis.ts
@@ -3,7 +3,7 @@
* boot, closed last during shutdown. Injected into the request-reply
* transport (which duplicates it only for its subscriber).
*/
-import { extractErrorLogFields } from '@truefoundry/utils-core/core';
+import { extractErrorLogFields } from '@truefoundry/trueforge-core/core';
import { createClient, type RedisClientType } from 'redis';
import type { Logger } from 'winston';
diff --git a/packages/server/src/runtime/sandboxFilePath.ts b/packages/server/src/runtime/sandboxFilePath.ts
index d4c55168b..5db75bc61 100644
--- a/packages/server/src/runtime/sandboxFilePath.ts
+++ b/packages/server/src/runtime/sandboxFilePath.ts
@@ -2,7 +2,7 @@
* Validation for caller-supplied sandbox download paths. This is an HTTP concern — the harness
* library only guards its own file operations — so it lives with the route that accepts the path.
*/
-import { SandboxError, validateNoPathTraversal } from '@truefoundry/utils-core/core';
+import { SandboxError, validateNoPathTraversal } from '@truefoundry/trueforge-core/core';
class SandboxInvalidPathError extends SandboxError {
readonly statusCode = 400;
diff --git a/packages/server/src/runtime/sessionResources.ts b/packages/server/src/runtime/sessionResources.ts
index 6696e0acb..25d925c5c 100644
--- a/packages/server/src/runtime/sessionResources.ts
+++ b/packages/server/src/runtime/sessionResources.ts
@@ -2,7 +2,7 @@
* Store-backed model/MCP/skill/sandbox resolution for session admit and turns.
*/
import { Daytona } from '@daytona/sdk';
-import type { AgentSpec } from '@truefoundry/utils-core/agent-session';
+import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
import {
DaytonaSandboxProvider,
Sandbox,
@@ -13,7 +13,7 @@ import {
type RemoteMcpHeaders,
type SandboxProvider,
type VercelAIProviderConfig,
-} from '@truefoundry/utils-core/core';
+} from '@truefoundry/trueforge-core/core';
import { HTTPException } from 'hono/http-exception';
import type { Logger } from 'winston';
import configuration from '../config';
diff --git a/packages/server/src/schemas/agent.ts b/packages/server/src/schemas/agent.ts
index c4129c7be..39137a595 100644
--- a/packages/server/src/schemas/agent.ts
+++ b/packages/server/src/schemas/agent.ts
@@ -4,7 +4,7 @@
* registry identity (`id`, `name`).
*/
import { z } from '@hono/zod-openapi';
-import { AgentSpecSchema, type AgentSpec } from '@truefoundry/utils-core/agent-session';
+import { AgentSpecSchema, type AgentSpec } from '@truefoundry/trueforge-core/agent-session';
import { NameSchema } from './common';
/** Create body: unique immutable `name` plus full AgentSpec. `id` is never client-supplied. */
diff --git a/packages/server/src/schemas/events.ts b/packages/server/src/schemas/events.ts
index 7d14f2a35..867ac548b 100644
--- a/packages/server/src/schemas/events.ts
+++ b/packages/server/src/schemas/events.ts
@@ -9,7 +9,7 @@ import {
TokenPaginationSchema,
TurnCreatedEventSchema,
TurnDoneEventSchema,
-} from '@truefoundry/utils-core/agent-session';
+} from '@truefoundry/trueforge-core/agent-session';
import {
MCPAuthRequiredEventSchema,
MCPInitializeEventSchema,
@@ -21,9 +21,9 @@ import {
ToolApprovalRequiredEventSchema,
ToolResponseEventSchema,
ToolResponseRequiredEventSchema,
-} from '@truefoundry/utils-core/core';
+} from '@truefoundry/trueforge-core/core';
-export type { TurnCreatedEvent } from '@truefoundry/utils-core/agent-session';
+export type { TurnCreatedEvent } from '@truefoundry/trueforge-core/agent-session';
export { EventType };
/** Live SSE stream for session turns — content events, deltas and lifecycle. */
diff --git a/packages/server/src/schemas/modelProvider.ts b/packages/server/src/schemas/modelProvider.ts
index ecb7f2672..261c98407 100644
--- a/packages/server/src/schemas/modelProvider.ts
+++ b/packages/server/src/schemas/modelProvider.ts
@@ -4,7 +4,7 @@
* live on ModelCatalog.
*/
import { z } from '@hono/zod-openapi';
-import { SUPPORTED_REASONING_EFFORTS, VERCEL_AI_PROVIDER_NAMES } from '@truefoundry/utils-core/core';
+import { SUPPORTED_REASONING_EFFORTS, VERCEL_AI_PROVIDER_NAMES } from '@truefoundry/trueforge-core/core';
import { NameSchema, uniqueNames, type ResourceName } from './common';
/** Every type the harness has an adapter for; a test asserts each one has a schema below. */
diff --git a/packages/server/src/schemas/sandboxProvider.ts b/packages/server/src/schemas/sandboxProvider.ts
index 223649a96..4efbd76fa 100644
--- a/packages/server/src/schemas/sandboxProvider.ts
+++ b/packages/server/src/schemas/sandboxProvider.ts
@@ -6,7 +6,7 @@
* Singleton per tenant — no identity `name` (unlike model providers / skills).
*/
import { z } from '@hono/zod-openapi';
-import type { DaytonaSandboxProviderOptions } from '@truefoundry/utils-core/core';
+import type { DaytonaSandboxProviderOptions } from '@truefoundry/trueforge-core/core';
const DaytonaSandboxProviderAuthSchema = z
.object({
diff --git a/packages/server/src/schemas/session.ts b/packages/server/src/schemas/session.ts
index 1c262c21b..438f25708 100644
--- a/packages/server/src/schemas/session.ts
+++ b/packages/server/src/schemas/session.ts
@@ -1,6 +1,6 @@
/** Server session wire schemas. Core Session lives in agentSession. */
import { z } from '@hono/zod-openapi';
-import { AgentSpecSchema, SessionSchema, TokenPaginationSchema } from '@truefoundry/utils-core/agent-session';
+import { AgentSpecSchema, SessionSchema, TokenPaginationSchema } from '@truefoundry/trueforge-core/agent-session';
import { NameSchema } from './common';
/** Create arm: bind by unique registry agent name. */
@@ -41,7 +41,7 @@ export const UpdateSessionRequestSchema = z
.strict()
.openapi('UpdateSessionRequest');
-export type { Session } from '@truefoundry/utils-core/agent-session';
+export type { Session } from '@truefoundry/trueforge-core/agent-session';
export const DEFAULT_SESSIONS_LIMIT = 10;
export const SESSIONS_MAX_LIMIT = 100;
diff --git a/packages/server/src/schemas/turn.ts b/packages/server/src/schemas/turn.ts
index 94810ed88..9f8125b31 100644
--- a/packages/server/src/schemas/turn.ts
+++ b/packages/server/src/schemas/turn.ts
@@ -1,9 +1,9 @@
/** Server-only turn wire schemas (SSE resume / cancel / list). Core turn schemas live in agent-session. */
import { z } from '@hono/zod-openapi';
-import { SessionEventSchema, TokenPaginationSchema, TurnSchema } from '@truefoundry/utils-core/agent-session';
+import { SessionEventSchema, TokenPaginationSchema, TurnSchema } from '@truefoundry/trueforge-core/agent-session';
-export { CreateTurnRequestSchema, TurnSchema } from '@truefoundry/utils-core/agent-session';
-export type { Turn } from '@truefoundry/utils-core/agent-session';
+export { CreateTurnRequestSchema, TurnSchema } from '@truefoundry/trueforge-core/agent-session';
+export type { Turn } from '@truefoundry/trueforge-core/agent-session';
export const SubscribeTurnQuerySchema = z
.object({
diff --git a/packages/server/tests/db/agentStoreContractSuite.ts b/packages/server/tests/db/agentStoreContractSuite.ts
index afc9c7a23..9baceea7c 100644
--- a/packages/server/tests/db/agentStoreContractSuite.ts
+++ b/packages/server/tests/db/agentStoreContractSuite.ts
@@ -2,7 +2,7 @@
* Backend-agnostic behavioural contract for IAgentStore.
* Runs under jest against a fresh store per test (see backend test files).
*/
-import { AgentSpecSchema, type AgentSpec } from '@truefoundry/utils-core/agent-session';
+import { AgentSpecSchema, type AgentSpec } from '@truefoundry/trueforge-core/agent-session';
import { AgentNameConflictError, type IAgentStore } from '../../src/db/agentStore';
const TENANT = 'default';
diff --git a/packages/server/tests/db/postgres/session-store/contract.test.ts b/packages/server/tests/db/postgres/session-store/contract.test.ts
index 6d895854a..cf6ddf1ba 100644
--- a/packages/server/tests/db/postgres/session-store/contract.test.ts
+++ b/packages/server/tests/db/postgres/session-store/contract.test.ts
@@ -1,4 +1,4 @@
-import type { ISessionStore } from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+import type { ISessionStore } from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import { sql } from 'kysely';
import { runStoreContractSuite } from '../../../../../harness/tests/agent-session/store/storeContractSuite';
diff --git a/packages/server/tests/db/sqlite/session-store/contract.test.ts b/packages/server/tests/db/sqlite/session-store/contract.test.ts
index 766500f40..367031f16 100644
--- a/packages/server/tests/db/sqlite/session-store/contract.test.ts
+++ b/packages/server/tests/db/sqlite/session-store/contract.test.ts
@@ -1,4 +1,4 @@
-import type { ISessionStore } from '@truefoundry/utils-core/agent-session/store/ISessionStore';
+import type { ISessionStore } from '@truefoundry/trueforge-core/agent-session/store/ISessionStore';
import { runStoreContractSuite } from '../../../../../harness/tests/agent-session/store/storeContractSuite';
import { SqliteSessionStore } from '../../../../src/db/sqlite/session-store/SqliteSessionStore';
diff --git a/packages/server/tests/unit/apis/deletedSessionCrud.test.ts b/packages/server/tests/unit/apis/deletedSessionCrud.test.ts
index e01a2efdf..c931be0ad 100644
--- a/packages/server/tests/unit/apis/deletedSessionCrud.test.ts
+++ b/packages/server/tests/unit/apis/deletedSessionCrud.test.ts
@@ -1,6 +1,6 @@
import { OpenAPIHono } from '@hono/zod-openapi';
-import { AgentSpecSchema, Sessions } from '@truefoundry/utils-core/agent-session';
-import { RequestReplyRouter } from '@truefoundry/utils-core/request-reply';
+import { AgentSpecSchema, Sessions } from '@truefoundry/trueforge-core/agent-session';
+import { RequestReplyRouter } from '@truefoundry/trueforge-core/request-reply';
import { createClient } from 'redis';
import { createLogger } from 'winston';
import { createSessionsRouter, TENANT_ID } from '../../../src/apis/sessions';
diff --git a/packages/server/tests/unit/apis/sandboxFileDownload.test.ts b/packages/server/tests/unit/apis/sandboxFileDownload.test.ts
index 6eaa6880e..f6c181759 100644
--- a/packages/server/tests/unit/apis/sandboxFileDownload.test.ts
+++ b/packages/server/tests/unit/apis/sandboxFileDownload.test.ts
@@ -1,6 +1,6 @@
import { OpenAPIHono } from '@hono/zod-openapi';
-import type { AgentSpec } from '@truefoundry/utils-core/agent-session';
-import { AgentSpecSchema, Sessions } from '@truefoundry/utils-core/agent-session';
+import type { AgentSpec } from '@truefoundry/trueforge-core/agent-session';
+import { AgentSpecSchema, Sessions } from '@truefoundry/trueforge-core/agent-session';
import { createLogger } from 'winston';
import { TENANT_ID } from '../../../src/apis/sessions';
import { createTurnsRouter, toContentDisposition } from '../../../src/apis/turns';
diff --git a/packages/server/tests/unit/apis/sessionHttp.test.ts b/packages/server/tests/unit/apis/sessionHttp.test.ts
index a18a010c8..5b44fd816 100644
--- a/packages/server/tests/unit/apis/sessionHttp.test.ts
+++ b/packages/server/tests/unit/apis/sessionHttp.test.ts
@@ -1,6 +1,6 @@
import { OpenAPIHono } from '@hono/zod-openapi';
-import { AgentSpecSchema, Sessions } from '@truefoundry/utils-core/agent-session';
-import { RequestReplyRouter } from '@truefoundry/utils-core/request-reply';
+import { AgentSpecSchema, Sessions } from '@truefoundry/trueforge-core/agent-session';
+import { RequestReplyRouter } from '@truefoundry/trueforge-core/request-reply';
import { createClient } from 'redis';
import { createSessionsRouter, TENANT_ID } from '../../../src/apis/sessions';
import { LOCAL_USER_CONTEXT } from '../../../src/auth/identity';
diff --git a/packages/server/tests/unit/apis/sessions.test.ts b/packages/server/tests/unit/apis/sessions.test.ts
index ce57cee69..72bba1551 100644
--- a/packages/server/tests/unit/apis/sessions.test.ts
+++ b/packages/server/tests/unit/apis/sessions.test.ts
@@ -1,5 +1,5 @@
-import type { ISessionStore, TurnRecord, TurnState } from '@truefoundry/utils-core/agent-session';
-import { CancellationReason } from '@truefoundry/utils-core/agent-session';
+import type { ISessionStore, TurnRecord, TurnState } from '@truefoundry/trueforge-core/agent-session';
+import { CancellationReason } from '@truefoundry/trueforge-core/agent-session';
import { HTTPException } from 'hono/http-exception';
import { createClient, type RedisClientType } from 'redis';
import { cancelSessionTurn } from '../../../src/apis/sessions';
diff --git a/packages/server/tests/unit/apis/turnHarnessErrorStatus.test.ts b/packages/server/tests/unit/apis/turnHarnessErrorStatus.test.ts
index fef41ddc5..57eda0e70 100644
--- a/packages/server/tests/unit/apis/turnHarnessErrorStatus.test.ts
+++ b/packages/server/tests/unit/apis/turnHarnessErrorStatus.test.ts
@@ -1,6 +1,6 @@
import { OpenAPIHono } from '@hono/zod-openapi';
-import type { Sessions } from '@truefoundry/utils-core/agent-session';
-import { AgentHarnessError } from '@truefoundry/utils-core/core';
+import type { Sessions } from '@truefoundry/trueforge-core/agent-session';
+import { AgentHarnessError } from '@truefoundry/trueforge-core/core';
import { createLogger } from 'winston';
import { createTurnsRouter } from '../../../src/apis/turns';
import { LOCAL_USER_CONTEXT } from '../../../src/auth/identity';
diff --git a/packages/server/tests/unit/apis/turns.test.ts b/packages/server/tests/unit/apis/turns.test.ts
index e48f1c97a..5a0cd7137 100644
--- a/packages/server/tests/unit/apis/turns.test.ts
+++ b/packages/server/tests/unit/apis/turns.test.ts
@@ -4,7 +4,7 @@ import {
Sessions,
TurnNotFoundError,
type TurnStreamingEvent,
-} from '@truefoundry/utils-core/agent-session';
+} from '@truefoundry/trueforge-core/agent-session';
import { createLogger } from 'winston';
import { TENANT_ID } from '../../../src/apis/sessions';
import { createTurnsRouter, turnStreamId } from '../../../src/apis/turns';
diff --git a/packages/server/tests/unit/mcp/auth/mcpOAuth.test.ts b/packages/server/tests/unit/mcp/auth/mcpOAuth.test.ts
index 7c0be740d..56c792a23 100644
--- a/packages/server/tests/unit/mcp/auth/mcpOAuth.test.ts
+++ b/packages/server/tests/unit/mcp/auth/mcpOAuth.test.ts
@@ -3,7 +3,7 @@
* Global fetch is stubbed; production code uses real fetch only.
*/
import { resourceUrlFromServerUrl } from '@modelcontextprotocol/sdk/shared/auth-utils.js';
-import { McpConnectionError } from '@truefoundry/utils-core/core';
+import { McpConnectionError } from '@truefoundry/trueforge-core/core';
import { InMemoryOAuthClientStore, InMemoryOAuthTokenStore } from '../../../../src/mcp/auth/inMemoryStores';
import {
buildMcpAuthorizationUrl,
diff --git a/packages/server/tests/unit/runtime/activeTurns.test.ts b/packages/server/tests/unit/runtime/activeTurns.test.ts
index 322fb0911..6754ea907 100644
--- a/packages/server/tests/unit/runtime/activeTurns.test.ts
+++ b/packages/server/tests/unit/runtime/activeTurns.test.ts
@@ -1,4 +1,4 @@
-import { CancellationReason } from '@truefoundry/utils-core/agent-session';
+import { CancellationReason } from '@truefoundry/trueforge-core/agent-session';
import { ActiveTurnRegistry } from '../../../src/runtime/activeTurns';
async function* values<T>(items: T[]): AsyncGenerator<T> {
diff --git a/packages/server/tests/unit/runtime/sessionResources.test.ts b/packages/server/tests/unit/runtime/sessionResources.test.ts
index f19541194..4bd889c4a 100644
--- a/packages/server/tests/unit/runtime/sessionResources.test.ts
+++ b/packages/server/tests/unit/runtime/sessionResources.test.ts
@@ -1,4 +1,4 @@
-import { AgentSpecSchema } from '@truefoundry/utils-core/agent-session';
+import { AgentSpecSchema } from '@truefoundry/trueforge-core/agent-session';
import { HTTPException } from 'hono/http-exception';
import { TENANT_ID } from '../../../src/apis/sessions';
import { migrateSqliteToLatest } from '../../../src/db/migrateSqlite';
diff --git a/packages/server/tests/unit/schemas/modelProvider.test.ts b/packages/server/tests/unit/schemas/modelProvider.test.ts
index 268e2c2e4..207730dd7 100644
--- a/packages/server/tests/unit/schemas/modelProvider.test.ts
+++ b/packages/server/tests/unit/schemas/modelProvider.test.ts
@@ -1,4 +1,4 @@
-import { VERCEL_AI_PROVIDER_NAMES } from '@truefoundry/utils-core/core';
+import { VERCEL_AI_PROVIDER_NAMES } from '@truefoundry/trueforge-core/core';
import { ModelProviderSchema, modelProviderName } from '../../../src/schemas/modelProvider';
const models = [{ model_id: 'a-model', name: 'a-model', properties: {} }];
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 1199ce5f0..184ffb89a 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -242,7 +242,7 @@ importers:
'@modelcontextprotocol/sdk':
specifier: ^1.29.0
- '@truefoundry/utils-core':
+ '@truefoundry/trueforge-core':
specifier: workspace:*
version: link:../harness
better-sqlite3:
diff --git a/scripts/generate-sdk.sh b/scripts/generate-sdk.sh
index 035544f52..427262e7a 100755
--- a/scripts/generate-sdk.sh
+++ b/scripts/generate-sdk.sh
@@ -17,7 +17,7 @@ fern() {
# a version changesets (or a human) already set.
current_version="$(node -p "require('./packages/sdk/package.json').version")"
-pnpm --filter @truefoundry/utils-core build
+pnpm --filter @truefoundry/trueforge-core build
pnpm openapi:write
fern check
# --force skips the overwrite prompt when packages/sdk already exists (needed non-interactively / in CI).