Skip to content

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

Improve session store CI checks (#22)

Bhavesh Patelefc3b2274446
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index d95fc66c2..e8c73e2d8 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -46,13 +46,46 @@ jobs:
- name: Test
run: pnpm test
+ # Gate store suites so they do not start unless session-store paths changed.
+ agent-session-store-changes:
+ name: Detect Session Store Changes
+ runs-on: ubuntu-latest
+ timeout-minutes: 5
+ permissions:
+ contents: read
+ pull-requests: read
+ outputs:
+ store: ${{ steps.filter.outputs.store }}
+
+ steps:
+ - name: Check out repository code
+ uses: actions/checkout@v4
+
+ - name: Detect session-store path changes
+ uses: dorny/paths-filter@v4
+ id: filter
+ with:
+ filters: |
+ store:
+ - 'packages/server/src/db/**'
+ - 'packages/server/tsup.config.ts'
+ - 'packages/server/tests/db/**'
+ - 'packages/server/jest.store.postgres.config.cjs'
+ - 'packages/server/jest.store.sqlite.config.cjs'
+ - 'packages/server/package.json'
+ - 'packages/harness/src/agent-session/**'
+ - 'packages/harness/tests/agent-session/**'
+ - 'pnpm-workspace.yaml'
+ - '.github/workflows/ci.yml'
+
postgres-store-tests:
name: Postgres Session Store Tests
+ needs: agent-session-store-changes
+ if: needs.agent-session-store-changes.outputs.store == 'true'
runs-on: ubuntu-latest
timeout-minutes: 20
permissions:
contents: read
- pull-requests: read
services:
postgres:
@@ -73,97 +106,53 @@ jobs:
- name: Check out repository code
uses: actions/checkout@v4
- - name: Detect session-store path changes
- uses: dorny/paths-filter@v4
- id: filter
- with:
- filters: |
- store:
- - 'packages/server/src/db/**'
- - 'packages/server/tsup.config.ts'
- - 'packages/server/tests/**'
- - 'packages/server/jest.store.postgres.config.cjs'
- - 'packages/harness/src/agent-session/**'
- - 'packages/harness/tests/agent-session/**'
-
- - name: Skip — no session-store changes
- if: steps.filter.outputs.store != 'true'
- run: echo "No session-store paths changed; skipping Postgres store tests."
-
- name: Setup pnpm
- if: steps.filter.outputs.store == 'true'
uses: pnpm/action-setup@v4
- name: Setup Node.js
- if: steps.filter.outputs.store == 'true'
uses: actions/setup-node@v4
with:
node-version: '24'
cache: 'pnpm'
- name: Install dependencies
- if: steps.filter.outputs.store == 'true'
run: pnpm install --frozen-lockfile
- name: Build
- if: steps.filter.outputs.store == 'true'
run: pnpm build
- name: Postgres session store contract tests
- if: steps.filter.outputs.store == 'true'
env:
SESSION_STORE_TEST_PG_URL: postgres://proto:proto@localhost:55432/proto
run: pnpm --dir packages/server test:store:postgres
sqlite-store-tests:
name: SQLite Session Store Tests
+ needs: agent-session-store-changes
+ if: needs.agent-session-store-changes.outputs.store == 'true'
runs-on: ubuntu-latest
timeout-minutes: 20
permissions:
contents: read
- pull-requests: read
steps:
- name: Check out repository code
uses: actions/checkout@v4
- - name: Detect session-store path changes
- uses: dorny/paths-filter@v4
- id: filter
- with:
- filters: |
- store:
- - 'packages/server/src/db/**'
- - 'packages/server/tsup.config.ts'
- - 'packages/server/tests/**'
- - 'packages/server/jest.store.sqlite.config.cjs'
- - 'packages/harness/src/agent-session/**'
- - 'packages/harness/tests/agent-session/**'
- - 'pnpm-workspace.yaml'
-
- - name: Skip — no session-store changes
- if: steps.filter.outputs.store != 'true'
- run: echo "No session-store paths changed; skipping SQLite store tests."
-
- name: Setup pnpm
- if: steps.filter.outputs.store == 'true'
uses: pnpm/action-setup@v4
- name: Setup Node.js
- if: steps.filter.outputs.store == 'true'
uses: actions/setup-node@v4
with:
node-version: '24'
cache: 'pnpm'
- name: Install dependencies
- if: steps.filter.outputs.store == 'true'
run: pnpm install --frozen-lockfile
- name: Build
- if: steps.filter.outputs.store == 'true'
run: pnpm build
- name: SQLite session store contract tests
- if: steps.filter.outputs.store == 'true'
run: pnpm --dir packages/server test:store:sqlite
diff --git a/packages/harness/src/agent-session/store/AGENTS.md b/packages/harness/src/agent-session/store/AGENTS.md
new file mode 100644
index 000000000..44825fc71
--- /dev/null
+++ b/packages/harness/src/agent-session/store/AGENTS.md
@@ -0,0 +1,3 @@
+- `ISessionStore` is the session/turn persistence contract (no streaming/SSE); Postgres, SQLite, and `InMemorySessionStore` MUST implement it, and shared behavior MUST live in `storeContractSuite.ts` (backend wrappers only bind a store).
+- Changing an `ISessionStore` method, input, error, or semantic MUST update the interface, every implementation, and the contract suite in the same change.
+- Path filters for `agent-session-store-changes` in `.github/workflows/ci.yml` MUST stay synchronized when store or contract-test paths are added, moved, or renamed.
diff --git a/packages/harness/src/agent-session/store/CLAUDE.md b/packages/harness/src/agent-session/store/CLAUDE.md
new file mode 100644
index 000000000..43c994c2d
--- /dev/null
+++ b/packages/harness/src/agent-session/store/CLAUDE.md
@@ -0,0 +1 @@