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.ymlindex d95fc66c2..e8c73e2d8 100644--- a/.github/workflows/ci.yml+++ b/.github/workflows/ci.yml@@ -46,13 +46,46 @@ jobs:- name: Testrun: 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-latesttimeout-minutes: 20permissions:contents: read- pull-requests: readservices:postgres:@@ -73,97 +106,53 @@ jobs:- name: Check out repository codeuses: 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@v4with: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/protorun: pnpm --dir packages/server test:store:postgressqlite-store-tests:name: SQLite Session Store Tests+ needs: agent-session-store-changes+ if: needs.agent-session-store-changes.outputs.store == 'true'runs-on: ubuntu-latesttimeout-minutes: 20permissions:contents: read- pull-requests: readsteps:- name: Check out repository codeuses: 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@v4with: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:sqlitediff --git a/packages/harness/src/agent-session/store/AGENTS.md b/packages/harness/src/agent-session/store/AGENTS.mdnew file mode 100644index 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.mdnew file mode 100644index 000000000..43c994c2d--- /dev/null+++ b/packages/harness/src/agent-session/store/CLAUDE.md@@ -0,0 +1 @@