chore: periodic maintenance (#80)

## Summary

- sync `openapi/openapi.json` from upstream and update SDK surface docs
for agent import examples plus paginated capability listing
- add SDK support and tests across Rust, Python, and TypeScript for
`from-example` agent imports and capability list search/pagination
- repair maintenance tooling by making `just generate` runnable in a
clean checkout and refresh generated Python/TypeScript schema artifacts;
update Rust/TypeScript dependency locks to clear audit findings

## Test Plan

- [x] Tests pass locally (`just pre-pr`)
- [ ] Coverage ≥80%
- [x] Linting passes
- [x] `just check-cookbook`
- [x] `just lint-cookbook`
- [x] `cargo audit`
- [x] `uvx pip-audit`
- [x] `npm audit --audit-level=high`

## Checklist

- [x] Follows SDK API consistency guidelines
- [x] Updated relevant specs (if applicable)
- [x] Added/updated tests
- [ ] Updated documentation (if applicable)

Author: chaliy

.github/workflows/ci.yml

@@ -169,13 +169,13 @@ jobs:
         run: cd cookbook/rust && cargo run --bin dad-jokes
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
       - name: Run Rust cookbook (weather-tools)
         timeout-minutes: 3
         run: cd cookbook/rust && cargo run --bin weather-tools
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
 
       # Run Python cookbook
       - name: Install Python cookbook deps
@@ -185,13 +185,13 @@ jobs:
         run: cd cookbook/python && uv run python src/main.py
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
       - name: Run Python cookbook (weather-tools)
         timeout-minutes: 3
         run: cd cookbook/python && uv run python src/weather_tools.py
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
 
       # Run TypeScript cookbook
       - name: Build TypeScript SDK
@@ -203,13 +203,13 @@ jobs:
         run: cd cookbook/typescript && npx tsx src/main.ts
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
       - name: Run TypeScript cookbook (weather-tools)
         timeout-minutes: 3
         run: cd cookbook/typescript && npx tsx src/weather_tools.ts
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
 
   run-examples:
     runs-on: ubuntu-latest
@@ -258,13 +258,13 @@ jobs:
         run: cd rust && cargo run --example basic
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
       - name: Run Rust initial_files example
         timeout-minutes: 3
         run: cd rust && cargo run --example initial_files
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
 
       - name: Install Python SDK deps
         run: cd python && uv sync --all-extras
@@ -273,13 +273,13 @@ jobs:
         run: cd python && uv run python examples/basic.py
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
       - name: Run Python initial_files example
         timeout-minutes: 3
         run: cd python && uv run python examples/initial_files.py
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
 
       - name: Install TypeScript SDK deps
         run: cd typescript && npm ci
@@ -288,10 +288,10 @@ jobs:
         run: cd typescript && npx tsx examples/basic.ts
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api
       - name: Run TypeScript initial-files example
         timeout-minutes: 3
         run: cd typescript && npx tsx examples/initial-files.ts
         env:
           EVERRUNS_API_KEY: fake-key
-          EVERRUNS_API_URL: http://localhost:9000
+          EVERRUNS_API_URL: http://localhost:9000/api

cookbook/python/uv.lock

@@ -66,7 +66,9 @@ fmt:
 # Generate types from OpenAPI spec
 generate:
     cd rust && cargo build
-    cd python && datamodel-codegen --input ../openapi/openapi.json --output everruns_sdk/_generated/models.py
+    mkdir -p python/everruns_sdk/_generated
+    cd python && uvx --from datamodel-code-generator datamodel-codegen --input ../openapi/openapi.json --output everruns_sdk/_generated/models.py
+    mkdir -p typescript/src/generated
     cd typescript && npx openapi-typescript ../openapi/openapi.json -o src/generated/schema.d.ts
 
 # Run coverage for all SDKs