chore: fmt

# Conflicts:
#	src/tools/mcp/factory.rs
#	src/tunnel/mod.rs

.gitignore

@@ -17,6 +17,8 @@ target/
 # Python
 __pycache__/
 *.pyc
+*.pyo
+*.pyd
 
 # Benchmark results (local runs, not committed)
 bench-results/
@@ -34,8 +36,5 @@ trace_*.json
 .claude/settings.local.json
 .worktrees/
 
-# Python cache
-__pycache__/
-*.pyc
-*.pyo
-*.pyd
+# JetBrains IDE
+.idea

Cargo.lock

@@ -3482,7 +3482,6 @@ dependencies = [
  "wasmparser 0.220.1",
  "wasmtime",
  "wasmtime-wasi",
- "webpki-roots 0.26.11",
  "zbus",
  "zip",
 ]
@@ -6992,7 +6991,6 @@ dependencies = [
  "futures-util",
  "http 1.4.0",
  "http-body 1.0.1",
- "http-body-util",
  "iri-string",
  "pin-project-lite",
  "tower 0.5.3",

Cargo.toml

@@ -57,7 +57,6 @@ refinery = { version = "0.8", features = ["tokio-postgres"], optional = true }
 tokio-postgres-rustls = { version = "0.13", optional = true }
 rustls = { version = "0.23", optional = true, default-features = false }
 rustls-native-certs = { version = "0.8", optional = true }
-webpki-roots = { version = "0.26", optional = true }
 
 # Database - libSQL/Turso (optional embedded database)
 libsql = { version = "0.6", optional = true, default-features = false, features = ["core", "replication", "remote", "tls"] }
@@ -96,7 +95,7 @@ termimad = "0.34"
 # Channel integrations
 axum = { version = "0.8", features = ["ws"] }
 tower = "0.5"
-tower-http = { version = "0.6", features = ["trace", "cors", "set-header", "catch-panic"] }
+tower-http = { version = "0.6", features = ["trace", "cors", "set-header"] }
 
 # Cron scheduling for routines
 cron = "0.13"
@@ -220,7 +219,6 @@ postgres = [
     "dep:tokio-postgres-rustls",
     "dep:rustls",
     "dep:rustls-native-certs",
-    "dep:webpki-roots",
     "dep:postgres-types",
     "dep:refinery",
     "dep:pgvector",
@@ -232,7 +230,6 @@ libsql = ["dep:libsql"]
 integration = []
 html-to-markdown = ["dep:html-to-markdown-rs", "dep:readabilityrs"]
 bedrock = ["dep:aws-config", "dep:aws-sdk-bedrockruntime", "dep:aws-smithy-types"]
-demo = []
 import = ["dep:json5", "libsql"]
 
 [[test]]

Dockerfile

@@ -1,78 +1,49 @@
 # Multi-stage Dockerfile for the IronClaw agent (cloud deployment).
 #
-# Uses cargo-chef for dependency caching — only rebuilds deps when
-# Cargo.toml/Cargo.lock change, not on every source edit.
-#
 # Build:
 #   docker build --platform linux/amd64 -t ironclaw:latest .
 #
 # Run:
 #   docker run --env-file .env -p 3000:3000 ironclaw:latest
 
-# Stage 1: Install cargo-chef
-FROM rust:1.92-slim-bookworm AS chef
+# Stage 1: Build
+FROM rust:1.92-slim-bookworm AS builder
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
     pkg-config libssl-dev cmake gcc g++ \
     && rm -rf /var/lib/apt/lists/* \
     && rustup target add wasm32-wasip2 \
-    && cargo install cargo-chef wasm-tools
+    && cargo install wasm-tools
 
 WORKDIR /app
 
-# Stage 2: Generate the dependency recipe (changes only when Cargo.toml/lock change)
-FROM chef AS planner
-
+# Copy manifests first for layer caching
 COPY Cargo.toml Cargo.lock ./
 COPY crates/ crates/
+
+# Copy source, build script, tests, and supporting directories
 COPY build.rs build.rs
 COPY src/ src/
 COPY tests/ tests/
-COPY benches/ benches/
 COPY migrations/ migrations/
 COPY registry/ registry/
 COPY channels-src/ channels-src/
 COPY wit/ wit/
 COPY providers.json providers.json
-
-RUN cargo chef prepare --recipe-path recipe.json
-
-# Stage 3: Build dependencies (cached unless Cargo.toml/lock change)
-FROM chef AS deps
-
-COPY --from=planner /app/recipe.json recipe.json
-RUN cargo chef cook --release --recipe-path recipe.json
-
-# Stage 4: Build the actual binary (only recompiles ironclaw source)
-FROM deps AS builder
-
-COPY Cargo.toml Cargo.lock ./
-COPY crates/ crates/
-COPY build.rs build.rs
-COPY src/ src/
-COPY tests/ tests/
+# [[bench]] entries in Cargo.toml require bench sources to exist for cargo to parse the manifest
 COPY benches/ benches/
-COPY migrations/ migrations/
-COPY registry/ registry/
-COPY channels-src/ channels-src/
-COPY wit/ wit/
-COPY providers.json providers.json
 
-COPY skills/ skills/
+RUN cargo build --release --bin ironclaw
 
-RUN cargo build --release --features demo --bin ironclaw
-
-# Stage 5: Runtime
+# Stage 2: Runtime
 FROM debian:bookworm-slim
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
     ca-certificates libssl3 \
-    && update-ca-certificates \
     && rm -rf /var/lib/apt/lists/*
 
 COPY --from=builder /app/target/release/ironclaw /usr/local/bin/ironclaw
 COPY --from=builder /app/migrations /app/migrations
-COPY --from=builder /app/skills /app/skills
 
 # Non-root user
 RUN useradd -m -u 1000 -s /bin/bash ironclaw
@@ -81,6 +52,5 @@ USER ironclaw
 EXPOSE 3000
 
 ENV RUST_LOG=ironclaw=info
-ENV SKILLS_DIR=/app/skills
 
 ENTRYPOINT ["ironclaw"]

channels-src/whatsapp/Cargo.lock

@@ -269,7 +269,7 @@ dependencies = [
 
 [[package]]
 name = "whatsapp-channel"
-version = "0.1.0"
+version = "0.2.0"
 dependencies = [
  "serde",
  "serde_json",

docs/USER_MANAGEMENT_API.md

@@ -1,571 +0,0 @@
-# User Management API
-
-DB-backed user management for multi-tenant IronClaw deployments. Covers admin user CRUD, per-user secrets provisioning, self-service profile, API token management, and usage reporting.
-
-## Authentication
-
-All endpoints require `Authorization: Bearer <token>`. Tokens are either:
-- **Env-var tokens** — configured via `GATEWAY_AUTH_TOKEN` (single-user) at startup
-- **DB-backed tokens** — created via `POST /api/tokens` or `POST /api/admin/users`
-
-DB tokens are SHA-256 hashed at rest; plaintext is returned exactly once at creation time.
-
-Auth is cached in a bounded LRU (1024 entries, 60s TTL). Suspending a user or revoking a token may take up to 60s to take effect.
-
-## Roles
-
-| Role | Scope |
-|------|-------|
-| `admin` | Full access to all endpoints |
-| `member` | Self-service profile + own token management only |
-
-Endpoints marked **Admin** return `403 Forbidden` for `member` role.
-
----
-
-## Admin: Users
-
-### POST /api/admin/users
-
-Create a new user. Returns the user record and a one-time plaintext API token.
-
-**Auth:** Admin
-
-**Request body:**
-
-```json
-{
-  "display_name": "Alice Smith",
-  "email": "[email protected]",
-  "role": "member"
-}
-```
-
-| Field | Type | Required | Default | Notes |
-|-------|------|----------|---------|-------|
-| `display_name` | string | yes | | |
-| `email` | string | no | `null` | Must be unique if provided |
-| `role` | string | no | `"member"` | `"admin"` or `"member"` |
-
-**Response:** `200 OK`
-
-```json
-{
-  "id": "550e8400-e29b-41d4-a716-446655440000",
-  "email": "[email protected]",
-  "display_name": "Alice Smith",
-  "status": "active",
-  "role": "member",
-  "token": "a1b2c3d4e5f6...64-char hex...",
-  "created_at": "2026-03-25T12:00:00+00:00",
-  "created_by": "admin-user-id"
-}
-```
-
-The `token` field is the plaintext API token. It is shown **only once** — store it securely.
-
-**Errors:** `400` (missing display_name, invalid role), `403` (not admin), `503` (no database)
-
----
-
-### GET /api/admin/users
-
-List all users.
-
-**Auth:** Admin
-
-**Response:** `200 OK`
-
-```json
-{
-  "users": [
-    {
-      "id": "550e8400-...",
-      "email": "[email protected]",
-      "display_name": "Alice Smith",
-      "status": "active",
-      "role": "member",
-      "created_at": "2026-03-25T12:00:00+00:00",
-      "updated_at": "2026-03-25T12:00:00+00:00",
-      "last_login_at": "2026-03-25T14:30:00+00:00",
-      "created_by": "admin-user-id"
-    }
-  ]
-}
-```
-
----
-
-### GET /api/admin/users/{id}
-
-Get a single user by ID.
-
-**Auth:** Admin
-
-**Response:** `200 OK`
-
-```json
-{
-  "id": "550e8400-...",
-  "email": "[email protected]",
-  "display_name": "Alice Smith",
-  "status": "active",
-  "role": "member",
-  "created_at": "2026-03-25T12:00:00+00:00",
-  "updated_at": "2026-03-25T12:00:00+00:00",
-  "last_login_at": "2026-03-25T14:30:00+00:00",
-  "created_by": "admin-user-id",
-  "metadata": {}
-}
-```
-
-**Errors:** `404` (user not found), `403` (not admin)
-
----
-
-### PATCH /api/admin/users/{id}
-
-Update a user's display name and/or metadata. Omitted fields are left unchanged.
-
-**Auth:** Admin
-
-**Request body:**
-
-```json
-{
-  "display_name": "Alice Johnson",
-  "metadata": {"department": "engineering"}
-}
-```
-
-| Field | Type | Required | Notes |
-|-------|------|----------|-------|
-| `display_name` | string | no | |
-| `metadata` | object | no | Replaces entire metadata object (merge patch) |
-
-**Response:** `200 OK` — returns the full updated user record (same shape as GET detail, without `last_login_at`/`created_by`).
-
-**Errors:** `404` (user not found), `403` (not admin)
-
----
-
-### POST /api/admin/users/{id}/suspend
-
-Suspend a user. Suspended users cannot authenticate (DB auth checks user status).
-
-**Auth:** Admin
-
-**Response:** `200 OK`
-
-```json
-{
-  "id": "550e8400-...",
-  "status": "suspended"
-}
-```
-
-**Errors:** `404` (user not found), `403` (not admin)
-
----
-
-### POST /api/admin/users/{id}/activate
-
-Re-activate a suspended user.
-
-**Auth:** Admin
-
-**Response:** `200 OK`
-
-```json
-{
-  "id": "550e8400-...",
-  "status": "active"
-}
-```
-
-**Errors:** `404` (user not found), `403` (not admin)
-
----
-
-### DELETE /api/admin/users/{id}
-
-Permanently delete a user and all associated data (tokens, jobs, conversations, memory, routines, settings, secrets).
-
-**Auth:** Admin
-
-**Response:** `200 OK`
-
-```json
-{
-  "id": "550e8400-...",
-  "deleted": true
-}
-```
-
-**Errors:** `404` (user not found), `403` (not admin)
-
-**Cascade:** Deletes from `api_tokens`, `agent_jobs`, `conversations`, `memory_documents`, `routines`, `secrets`, `settings`, `wasm_tools`, and related tables. On PostgreSQL this uses FK cascades; on libSQL it uses explicit deletes.
-
----
-
-## Admin: Per-User Secrets
-
-Provision secrets on behalf of individual users. The primary use case is an application backend (acting as admin) that configures per-user credentials so each user's IronClaw agent can call back to external services.
-
-Secrets are encrypted at rest with AES-256-GCM using a per-secret HKDF-derived key. Plaintext values are **never returned** by any endpoint — they can only be used by the agent's tool system at runtime.
-
-### PUT /api/admin/users/{user_id}/secrets/{name}
-
-Create or update a secret for the specified user. If a secret with the same name already exists, it is overwritten.
-
-**Auth:** Admin
-
-**Path parameters:**
-
-| Param | Type | Notes |
-|-------|------|-------|
-| `user_id` | string | The user's ID |
-| `name` | string | Secret name (normalized to lowercase) |
-
-**Request body:**
-
-```json
-{
-  "value": "sk-live-abc123...",
-  "provider": "my-app-backend",
-  "expires_in_days": 90
-}
-```
-
-| Field | Type | Required | Notes |
-|-------|------|----------|-------|
-| `value` | string | yes | The secret value (encrypted at rest, never returned) |
-| `provider` | string | no | Tag for grouping (e.g. `"stripe"`, `"my-app"`) |
-| `expires_in_days` | integer | no | Auto-expire after N days; `null` = never |
-
-**Response:** `200 OK`
-
-```json
-{
-  "user_id": "550e8400-...",
-  "name": "my_app_callback_token",
-  "status": "created"
-}
-```
-
-**Errors:** `400` (missing value), `403` (not admin), `503` (secrets store not available)
-
-**Example — application backend provisioning a callback token:**
-
-```bash
-# Admin creates a user
-curl -X POST https://ironclaw.example.com/api/admin/users \
-  -H "Authorization: Bearer $ADMIN_TOKEN" \
-  -d '{"display_name": "Alice", "role": "member"}'
-# Response includes: {"id": "alice-uuid", "token": "alice-bearer-token", ...}
-
-# Admin provisions a per-user callback secret
-curl -X PUT https://ironclaw.example.com/api/admin/users/alice-uuid/secrets/app_callback_token \
-  -H "Authorization: Bearer $ADMIN_TOKEN" \
-  -d '{"value": "per-user-jwt-for-alice", "provider": "my-app"}'
-
-# Now Alice's IronClaw agent can use the "app_callback_token" secret
-# when calling tools that need to authenticate back to the app backend.
-```
-
----
-
-### GET /api/admin/users/{user_id}/secrets
-
-List a user's secrets. Returns names and providers only — **never values or hashes**.
-
-**Auth:** Admin
-
-**Response:** `200 OK`
-
-```json
-{
-  "user_id": "550e8400-...",
-  "secrets": [
-    {"name": "app_callback_token", "provider": "my-app"},
-    {"name": "openai_api_key", "provider": "openai"}
-  ]
-}
-```
-
----
-
-### DELETE /api/admin/users/{user_id}/secrets/{name}
-
-Delete a specific secret for a user.
-
-**Auth:** Admin
-
-**Response:** `200 OK`
-
-```json
-{
-  "user_id": "550e8400-...",
-  "name": "app_callback_token",
-  "deleted": true
-}
-```
-
-**Errors:** `404` (secret not found), `403` (not admin), `503` (secrets store not available)
-
----
-
-## Admin: Usage
-
-### GET /api/admin/usage
-
-Per-user LLM usage statistics aggregated from `llm_calls` via `agent_jobs.user_id`.
-
-**Auth:** Admin
-
-**Query parameters:**
-
-| Param | Type | Default | Notes |
-|-------|------|---------|-------|
-| `user_id` | string | all users | Filter to a single user |
-| `period` | string | `"day"` | `"day"` (24h), `"week"` (7d), or `"month"` (30d) |
-
-**Response:** `200 OK`
-
-```json
-{
-  "period": "week",
-  "since": "2026-03-18T12:00:00+00:00",
-  "usage": [
-    {
-      "user_id": "alice-id",
-      "model": "claude-sonnet-4-5-20250514",
-      "call_count": 42,
-      "input_tokens": 150000,
-      "output_tokens": 30000,
-      "total_cost": "1.23"
-    }
-  ]
-}
-```
-
----
-
-## Self-Service: Profile
-
-### GET /api/profile
-
-Get the authenticated user's own profile.
-
-**Auth:** Any authenticated user
-
-**Response:** `200 OK`
-
-```json
-{
-  "id": "550e8400-...",
-  "email": "[email protected]",
-  "display_name": "Alice Smith",
-  "status": "active",
-  "role": "member",
-  "created_at": "2026-03-25T12:00:00+00:00",
-  "last_login_at": "2026-03-25T14:30:00+00:00"
-}
-```
-
----
-
-### PATCH /api/profile
-
-Update the authenticated user's own display name and/or metadata.
-
-**Auth:** Any authenticated user
-
-**Request body:**
-
-```json
-{
-  "display_name": "Alice Johnson",
-  "metadata": {"theme": "dark"}
-}
-```
-
-**Response:** `200 OK`
-
-```json
-{
-  "id": "550e8400-...",
-  "display_name": "Alice Johnson",
-  "updated": true
-}
-```
-
----
-
-## Self-Service: Tokens
-
-### POST /api/tokens
-
-Create a new API token for the authenticated user. Admins can optionally create tokens for other users by including `user_id`.
-
-**Auth:** Any authenticated user
-
-**Request body:**
-
-```json
-{
-  "name": "CI pipeline",
-  "expires_in_days": 90,
-  "user_id": "other-user-id"
-}
-```
-
-| Field | Type | Required | Notes |
-|-------|------|----------|-------|
-| `name` | string | yes | Human-readable label |
-| `expires_in_days` | integer | no | `null` = never expires |
-| `user_id` | string | no | Admin-only; create token for another user |
-
-**Response:** `200 OK`
-
-```json
-{
-  "token": "a1b2c3d4...64-char hex...",
-  "id": "token-uuid",
-  "name": "CI pipeline",
-  "token_prefix": "a1b2c3d4",
-  "expires_at": "2026-06-23T12:00:00+00:00",
-  "created_at": "2026-03-25T12:00:00+00:00"
-}
-```
-
-The `token` field is shown **only once**.
-
----
-
-### GET /api/tokens
-
-List the authenticated user's tokens. Token hashes are never returned.
-
-**Auth:** Any authenticated user
-
-**Response:** `200 OK`
-
-```json
-{
-  "tokens": [
-    {
-      "id": "token-uuid",
-      "name": "CI pipeline",
-      "token_prefix": "a1b2c3d4",
-      "expires_at": "2026-06-23T12:00:00+00:00",
-      "last_used_at": "2026-03-25T14:00:00+00:00",
-      "created_at": "2026-03-25T12:00:00+00:00",
-      "revoked_at": null
-    }
-  ]
-}
-```
-
----
-
-### DELETE /api/tokens/{id}
-
-Revoke one of the authenticated user's tokens. Users can only revoke their own tokens.
-
-**Auth:** Any authenticated user
-
-**Path:** `id` — UUID of the token to revoke
-
-**Response:** `200 OK`
-
-```json
-{
-  "status": "revoked",
-  "id": "token-uuid"
-}
-```
-
-**Errors:** `400` (invalid UUID), `404` (token not found or belongs to another user)
-
----
-
-## Error Format
-
-All error responses return a plain text body with the error message and the corresponding HTTP status code:
-
-| Code | Meaning |
-|------|---------|
-| `400` | Bad request (missing fields, invalid input) |
-| `401` | Missing or invalid bearer token |
-| `403` | Authenticated but insufficient role (member accessing admin endpoint) |
-| `404` | Resource not found |
-| `503` | Database or secrets store not available |
-| `500` | Internal server error |
-
----
-
-## Security Model
-
-### Secrets Encryption
-
-- **Algorithm:** AES-256-GCM with per-secret HKDF-SHA256 derived keys
-- **Master key:** 32+ bytes, resolved from `SECRETS_MASTER_KEY` env var or OS keychain
-- **Storage format:** `nonce (12B) || ciphertext || tag (16B)` in `encrypted_value` column
-- **Per-secret salt:** 32 random bytes stored alongside the ciphertext
-- **Zero-exposure:** Plaintext never appears in logs, debug output, API responses, or LLM conversations
-
-### Auth Cache
-
-- Bounded LRU cache (1024 entries max)
-- 60-second TTL per entry
-- Suspending a user or revoking a token takes up to 60s to propagate
-
----
-
-## Database Schema
-
-### users
-
-| Column | Type (PG / libSQL) | Notes |
-|--------|--------------------|-------|
-| `id` | `UUID` / `TEXT` | Primary key, UUID v4 |
-| `email` | `TEXT UNIQUE` | Nullable |
-| `display_name` | `TEXT NOT NULL` | |
-| `status` | `TEXT NOT NULL` | `"active"` or `"suspended"` |
-| `role` | `TEXT NOT NULL` | `"admin"` or `"member"` |
-| `created_at` | `TIMESTAMPTZ` / `TEXT` | |
-| `updated_at` | `TIMESTAMPTZ` / `TEXT` | |
-| `last_login_at` | `TIMESTAMPTZ` / `TEXT` | Nullable |
-| `created_by` | `TEXT` | Nullable, references `users.id` |
-| `metadata` | `JSONB` / `TEXT` | Default `{}` |
-
-### api_tokens
-
-| Column | Type (PG / libSQL) | Notes |
-|--------|--------------------|-------|
-| `id` | `UUID` / `TEXT` | Primary key |
-| `user_id` | `TEXT NOT NULL` | FK to `users.id` (PG cascades; libSQL explicit cleanup) |
-| `token_hash` | `BYTEA` / `BLOB` | SHA-256 of hex-encoded plaintext |
-| `token_prefix` | `TEXT NOT NULL` | First 8 chars for identification |
-| `name` | `TEXT NOT NULL` | Human-readable label |
-| `expires_at` | `TIMESTAMPTZ` / `TEXT` | Nullable |
-| `last_used_at` | `TIMESTAMPTZ` / `TEXT` | Nullable |
-| `created_at` | `TIMESTAMPTZ` / `TEXT` | |
-| `revoked_at` | `TIMESTAMPTZ` / `TEXT` | Nullable; set on revocation |
-
-### secrets
-
-| Column | Type (PG / libSQL) | Notes |
-|--------|--------------------|-------|
-| `id` | `UUID` / `TEXT` | Primary key |
-| `user_id` | `TEXT NOT NULL` | Scoped to user |
-| `name` | `TEXT NOT NULL` | Unique per user (lowercase normalized) |
-| `encrypted_value` | `BYTEA` / `BLOB` | AES-256-GCM (nonce + ciphertext + tag) |
-| `key_salt` | `BYTEA` / `BLOB` | Per-secret HKDF salt |
-| `provider` | `TEXT` | Optional grouping tag |
-| `expires_at` | `TIMESTAMPTZ` / `TEXT` | Nullable |
-| `last_used_at` | `TIMESTAMPTZ` / `TEXT` | Audit: last injection time |
-| `usage_count` | `BIGINT` / `INTEGER` | Audit: total injections |
-| `created_at` | `TIMESTAMPTZ` / `TEXT` | |
-| `updated_at` | `TIMESTAMPTZ` / `TEXT` | |

migrations/V14__users.sql

@@ -1,31 +0,0 @@
--- User management tables for multi-tenant deployments.
---
--- Replaces the static GATEWAY_USER_TOKENS env var with DB-backed
--- user registration, API token management, and invitation flow.
-
-CREATE TABLE users (
-    id TEXT PRIMARY KEY,                        -- matches existing user_id pattern (string, not UUID)
-    email TEXT UNIQUE,                          -- nullable for token-only users
-    display_name TEXT NOT NULL,
-    status TEXT NOT NULL DEFAULT 'active',       -- active | suspended | deactivated
-    role TEXT NOT NULL DEFAULT 'member',          -- admin | member
-    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-    last_login_at TIMESTAMPTZ,
-    created_by TEXT REFERENCES users(id),       -- who invited this user (nullable for bootstrap)
-    metadata JSONB NOT NULL DEFAULT '{}'        -- extensible profile data
-);
-
-CREATE TABLE api_tokens (
-    id UUID PRIMARY KEY,
-    user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
-    token_hash BYTEA NOT NULL,                  -- SHA-256 hash (never store plaintext)
-    token_prefix TEXT NOT NULL,                 -- first 8 hex chars for display
-    name TEXT NOT NULL,                         -- human label ("my-laptop", "ci-bot")
-    expires_at TIMESTAMPTZ,                     -- nullable = never expires
-    last_used_at TIMESTAMPTZ,
-    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
-    revoked_at TIMESTAMPTZ                      -- soft-revoke: set this instead of deleting
-);
-CREATE INDEX idx_api_tokens_user ON api_tokens(user_id);
-CREATE INDEX idx_api_tokens_hash ON api_tokens(token_hash);

skills/abound-remittance/SKILL.md

@@ -1,94 +0,0 @@
----
-name: abound-remittance
-version: 0.1.0
-description: Smart remittance assistant for Abound — helps users send money to India with intelligent forex timing and transfer management.
-activation:
-  keywords:
-    - send money
-    - transfer
-    - remittance
-    - exchange rate
-    - forex
-    - INR
-    - India
-    - wire
-    - schedule trade
-    - trade tomorrow
-    - convert currency
-    - send dollars
-    - rupees
-    - beneficiary
-    - funding source
-    - payment
-    - how much
-    - rate today
-    - best time
-    - family maintenance
-  patterns:
-    - "send \\$?\\d+"
-    - "schedule.*(trade|transfer|send|wire)"
-    - "how much.*(INR|rupees|India)"
-    - "best time to (send|transfer|convert)"
-    - "(rate|forex).*(good|bad|high|low|today|now)"
-    - "transfer.*tomorrow|tomorrow.*transfer"
-  tags:
-    - fintech
-    - remittance
-    - forex
-  max_context_tokens: 2500
----
-
-# Abound Remittance Assistant
-
-You are a smart remittance assistant for Abound, helping users send money from USD to INR (India) with intelligent timing advice.
-
-## Available Tools
-
-You have these Abound-specific tools:
-
-- **abound_get_account_info** — Get the user's account: limits, recipients, funding sources, payment reasons
-- **abound_get_exchange_rate** — Get current USD/INR exchange rate (current + effective after fees)
-- **abound_get_forex_score** — Get a 0-100 forex timing score with a signal (convert_now / split_transfer / wait)
-- **abound_send_wire** — Execute a wire transfer (requires: funding_source_id, beneficiary_ref_id, amount, payment_reason_key)
-- **abound_create_notification** — Send a notification to the user's Abound app
-
-You also have **routine_create** for scheduling future/recurring transfers.
-
-## Workflow: "Send $X" or "Transfer money"
-
-1. **Always check the rate first.** Call `abound_get_exchange_rate` to get the current rate.
-2. **Check the forex score.** Call `abound_get_forex_score` to assess timing.
-3. **Get account info.** Call `abound_get_account_info` to know the user's limits, recipients, and funding sources.
-4. **Advise based on the score:**
-   - **Score >= 60 (convert_now):** Tell the user it's a good time. Show the rate, the INR equivalent of their amount, and recommend proceeding.
-   - **Score 40-59 (split_transfer):** Suggest splitting — send half now at the current rate, schedule the rest for later when the rate may improve.
-   - **Score < 40 (wait):** Unless the transfer is urgent, recommend waiting. Explain why (rate below average, unfavorable season).
-5. **Execute if user confirms.** Use `abound_send_wire` with the correct funding_source_id, beneficiary_ref_id, amount, and payment_reason_key from the account info.
-6. **Notify.** After a successful wire, call `abound_create_notification` with relevant metadata.
-
-## Workflow: "Schedule a trade" or "Send tomorrow morning"
-
-1. Gather the same info (rate, score, account).
-2. Use **routine_create** to schedule the transfer:
-   - For "tomorrow morning": use cron `"0 9 * * *"` with the user's timezone, set to fire once
-   - For "every week": use cron `"0 9 * * MON"` (or the user's preferred day)
-   - The routine prompt should instruct the agent to check the rate and execute the wire
-3. Confirm the schedule with the user, showing when it will fire.
-
-## Presentation Rules
-
-- Always show amounts in **both USD and INR**: "$1,000 (~INR 85,420 at today's rate of 85.42)"
-- Show the **effective rate** (after fees), not just the market rate
-- When showing the forex score, explain it simply: "The forex timing score is 72/100 — this is a good time to send."
-- If the user's amount exceeds their limit ($5,000), tell them and suggest splitting into multiple transfers
-- Always mention the **estimated delivery time** (1-3 business days) after a wire
-
-## Payment Reasons
-
-When asking about the purpose, offer these options:
-- Family Maintenance
-- Gift
-- Education Support
-- Medical Support
-
-If the user doesn't specify, ask which applies.

src/agent/dispatcher.rs

@@ -47,6 +47,15 @@ impl Agent {
         thread_id: Uuid,
         initial_messages: Vec<ChatMessage>,
     ) -> Result<AgenticLoopResult, Error> {
+        if let Some(ext_mgr) = self.deps.extension_manager.as_ref()
+            && let Err(e) = ext_mgr.ensure_nearai_companion_active_if_ready().await
+        {
+            tracing::debug!(
+                "Failed to auto-activate NEAR AI companion MCP before turn: {}",
+                e
+            );
+        }
+
         // Detect group chat from channel metadata (needed before loading system prompt)
         let is_group_chat = message
             .metadata
@@ -400,21 +409,16 @@ impl<'a> LoopDelegate for ChatDelegate<'a> {
         };
 
         // Record cost and track token usage (global + per-user).
-        // Use the provider's effective_model_name so cost attribution matches
-        // the model that actually served the request. When the override is
-        // honoured (e.g. NearAI), this returns the override name; when the
-        // provider ignores overrides (e.g. Rig-based), it returns the active
-        // model, keeping attribution accurate in both cases.
-        let model_name = self
-            .agent
-            .llm()
-            .effective_model_name(reason_ctx.model_override.as_deref());
-        let cost_per_token = if reason_ctx.model_override.is_some() {
-            // Override may use different pricing; let CostGuard fall back to
-            // costs::model_cost() for the effective model.
-            None
+        // When a model override is active, use the override name for attribution
+        // and let CostGuard look up pricing via costs::model_cost() instead of
+        // using the default provider's cost_per_token (which reflects the wrong model).
+        let (model_name, cost_per_token) = if let Some(ref ovr) = reason_ctx.model_override {
+            (ovr.clone(), None)
         } else {
-            Some(self.agent.llm().cost_per_token())
+            (
+                self.agent.llm().active_model_name(),
+                Some(self.agent.llm().cost_per_token()),
+            )
         };
         let read_discount = self.agent.llm().cache_read_discount();
         let write_multiplier = self.agent.llm().cache_write_multiplier();
@@ -1359,7 +1363,6 @@ mod tests {
                 max_tool_iterations: 50,
                 auto_approve_tools: false,
                 default_timezone: "UTC".to_string(),
-                max_jobs_per_user: None,
                 max_tokens_per_job: 0,
                 multi_tenant: false,
                 max_llm_concurrent_per_user: None,
@@ -2241,7 +2244,6 @@ mod tests {
                 max_tool_iterations,
                 auto_approve_tools: true,
                 default_timezone: "UTC".to_string(),
-                max_jobs_per_user: None,
                 max_tokens_per_job: 0,
                 multi_tenant: false,
                 max_llm_concurrent_per_user: None,
@@ -2369,7 +2371,6 @@ mod tests {
                     max_tool_iterations: max_iter,
                     auto_approve_tools: true,
                     default_timezone: "UTC".to_string(),
-                    max_jobs_per_user: None,
                     max_tokens_per_job: 0,
                     multi_tenant: false,
                     max_llm_concurrent_per_user: None,

src/agent/heartbeat.rs

@@ -400,7 +400,7 @@ impl HeartbeatRunner {
     }
 
     /// Send a notification about heartbeat findings.
-    async fn send_notification(&self, message: &str) {
+    pub(crate) async fn send_notification(&self, message: &str) {
         let Some(ref tx) = self.response_tx else {
             tracing::debug!("No response channel configured for heartbeat notifications");
             return;
@@ -512,8 +512,8 @@ pub fn spawn_heartbeat(
     })
 }
 
-/// Spawn a multi-user heartbeat runner that cycles through all users who
-/// have routines (enabled or not). Each tick, it queries the DB for distinct
+/// Spawn a multi-user heartbeat runner that cycles through all users that
+/// own routines (enabled or not). Each tick, it queries the DB for distinct
 /// user_ids, creates a per-user workspace, and runs a heartbeat check for
 /// each user concurrently. Per-user failure counts are tracked independently.
 pub fn spawn_multi_user_heartbeat(
@@ -574,10 +574,8 @@ pub fn spawn_multi_user_heartbeat(
                 }
             };
 
-            // Run user heartbeats (and hygiene) concurrently so one slow LLM
-            // call doesn't block others. Cap concurrency to avoid flooding the
-            // LLM provider. Hygiene runs inside the same JoinSet so it is
-            // tracked and bounded by the same concurrency cap.
+            // Run user heartbeats concurrently so one slow LLM call doesn't
+            // block others. Cap concurrency to avoid flooding the LLM provider.
             const MAX_CONCURRENT_HEARTBEATS: usize = 8;
             let mut join_set = tokio::task::JoinSet::new();
 
@@ -590,6 +588,23 @@ pub fn spawn_multi_user_heartbeat(
 
                 let workspace = Arc::new(Workspace::new_with_db(user_id, Arc::clone(store.db())));
 
+                // Run memory hygiene per user (same as single-user heartbeat).
+                let hygiene_ws = Arc::clone(&workspace);
+                let hygiene_cfg = hygiene_config.clone();
+                let hygiene_user = user_id.clone();
+                tokio::spawn(async move {
+                    let report =
+                        crate::workspace::hygiene::run_if_due(&hygiene_ws, &hygiene_cfg).await;
+                    if report.had_work() {
+                        tracing::info!(
+                            user_id = hygiene_user,
+                            daily_logs_deleted = report.daily_logs_deleted,
+                            conversation_docs_deleted = report.conversation_docs_deleted,
+                            "multi-user heartbeat: memory hygiene deleted stale documents"
+                        );
+                    }
+                });
+
                 // Drain completed tasks to stay within the concurrency cap.
                 while join_set.len() >= MAX_CONCURRENT_HEARTBEATS {
                     if let Some(join_result) = join_set.join_next().await {
@@ -598,30 +613,13 @@ pub fn spawn_multi_user_heartbeat(
                 }
 
                 let uid = user_id.clone();
-                // In multi-tenant mode, clear notify_user_id so that
-                // HeartbeatRunner::send_notification falls back to
-                // workspace.user_id() — each user's heartbeat should persist
-                // and notify that user, not the shared config target.
-                let mut cfg = config.clone();
-                cfg.notify_user_id = None;
+                let cfg = config.clone();
                 let hyg = hygiene_config.clone();
                 let llm_clone = llm.clone();
                 let tx = response_tx.clone();
                 let admin = store.clone();
 
                 join_set.spawn(async move {
-                    // Run memory hygiene per user (same as single-user heartbeat)
-                    // inside the tracked task so concurrency is bounded.
-                    let report = crate::workspace::hygiene::run_if_due(&workspace, &hyg).await;
-                    if report.had_work() {
-                        tracing::info!(
-                            user_id = uid,
-                            daily_logs_deleted = report.daily_logs_deleted,
-                            conversation_docs_deleted = report.conversation_docs_deleted,
-                            "multi-user heartbeat: memory hygiene deleted stale documents"
-                        );
-                    }
-
                     let mut runner = HeartbeatRunner::new(cfg, hyg, workspace, llm_clone);
                     if let Some(tx) = tx {
                         runner = runner.with_response_channel(tx);

src/agent/scheduler.rs

@@ -267,20 +267,6 @@ impl Scheduler {
                 });
             }
 
-            // Per-user concurrency check
-            if let Some(max_per_user) = self.config.max_jobs_per_user
-                && let Ok(ctx) = self.context_manager.get_context(job_id).await
-            {
-                let user_active = self
-                    .context_manager
-                    .active_jobs_for(&ctx.user_id)
-                    .await
-                    .len();
-                if user_active >= max_per_user {
-                    return Err(JobError::MaxJobsExceeded { max: max_per_user });
-                }
-            }
-
             // Transition job to in_progress
             self.context_manager
                 .update_context(job_id, |ctx| {
@@ -798,7 +784,6 @@ mod tests {
             max_tool_iterations: 10,
             auto_approve_tools: true,
             default_timezone: "UTC".to_string(),
-            max_jobs_per_user: None,
             max_tokens_per_job,
             multi_tenant: false,
             max_llm_concurrent_per_user: None,

src/app.rs

@@ -336,12 +336,17 @@ impl AppBuilder {
             ws = ws.with_memory_layers(self.config.workspace.memory_layers.clone());
             let ws = Arc::new(ws);
 
-            // Detect multi-tenant mode: when the database has registered users,
+            // Detect multi-tenant mode: when GATEWAY_USER_TOKENS is configured,
             // each authenticated user needs their own workspace scope. Use
             // WorkspacePool (which implements WorkspaceResolver) to create
             // per-user workspaces on demand instead of sharing the startup
             // workspace across all users.
-            let is_multi_tenant = db.has_any_users().await.unwrap_or(false);
+            let is_multi_tenant = self
+                .config
+                .channels
+                .gateway
+                .as_ref()
+                .is_some_and(|gw| gw.user_tokens.is_some());
 
             if is_multi_tenant {
                 let pool = Arc::new(crate::channels::web::server::WorkspacePool::new(
@@ -444,6 +449,8 @@ impl AppBuilder {
 
         let mcp_session_manager = Arc::new(McpSessionManager::new());
         let mcp_process_manager = Arc::new(McpProcessManager::new());
+        let companion_mcp_server =
+            crate::tools::mcp::config::derive_nearai_companion_mcp_server(&self.config);
 
         // Create WASM tool runtime eagerly so extensions installed after startup
         // (e.g. via the web UI) can still be activated. The tools directory is only
@@ -521,6 +528,7 @@ impl AppBuilder {
             let mcp_sm = Arc::clone(&mcp_session_manager);
             let pm = Arc::clone(&mcp_process_manager);
             let owner_id = self.config.owner_id.clone();
+            let companion_mcp_server = companion_mcp_server.clone();
             async move {
                 let servers_result = if let Some(ref d) = db {
                     load_mcp_servers_from_db(d.as_ref(), &owner_id).await
@@ -528,7 +536,16 @@ impl AppBuilder {
                     crate::tools::mcp::config::load_mcp_servers().await
                 };
                 match servers_result {
-                    Ok(servers) => {
+                    Ok(mut servers) => {
+                        if let Some(companion) = companion_mcp_server {
+                            let companion_name = companion.name.clone();
+                            if !servers.insert_if_absent(companion) {
+                                tracing::debug!(
+                                    "Skipping derived MCP companion '{}': an existing config with that name is already present",
+                                    companion_name
+                                );
+                            }
+                        }
                         let enabled: Vec<_> = servers.enabled_servers().cloned().collect();
                         if !enabled.is_empty() {
                             tracing::debug!(
@@ -540,6 +557,8 @@ impl AppBuilder {
                         let mut join_set = tokio::task::JoinSet::new();
                         for server in enabled {
                             let mcp_sm = Arc::clone(&mcp_sm);
+                            let nearai_session = Arc::clone(&self.session);
+                            let nearai_api_key = self.config.llm.nearai.api_key.clone();
                             let secrets = secrets_store.clone();
                             let tools = Arc::clone(&tools);
                             let pm = Arc::clone(&pm);
@@ -551,6 +570,8 @@ impl AppBuilder {
                                 let client = match crate::tools::mcp::create_client_from_config(
                                     server,
                                     &mcp_sm,
+                                    Some(nearai_session),
+                                    nearai_api_key,
                                     &pm,
                                     secrets,
                                     &owner_id,
@@ -707,6 +728,8 @@ impl AppBuilder {
             let manager = Arc::new(ExtensionManager::new(
                 Arc::clone(&mcp_session_manager),
                 Arc::clone(&mcp_process_manager),
+                Some(Arc::clone(&self.session)),
+                self.config.llm.nearai.api_key.clone(),
                 ext_secrets,
                 Arc::clone(tools),
                 Some(Arc::clone(hooks)),
@@ -716,6 +739,7 @@ impl AppBuilder {
                 self.config.tunnel.public_url.clone(),
                 self.config.owner_id.clone(),
                 self.db.clone(),
+                companion_mcp_server,
                 catalog_entries.clone(),
             ));
             tools.register_extension_tools(Arc::clone(&manager));

src/channels/relay/client.rs

@@ -122,18 +122,32 @@ impl RelayClient {
     /// instance_url in chat-api. IronClaw only passes an optional CSRF nonce
     /// for validating the callback — no URLs.
     pub async fn initiate_oauth(&self, state_nonce: Option<&str>) -> Result<String, RelayError> {
+        let url = format!("{}/oauth/slack/auth", self.base_url);
+        tracing::debug!(relay_url = %url, "RelayClient::initiate_oauth: sending request");
         let mut query: Vec<(&str, &str)> = vec![];
         if let Some(nonce) = state_nonce {
             query.push(("state_nonce", nonce));
         }
         let resp = self
             .http
-            .get(format!("{}/oauth/slack/auth", self.base_url))
+            .get(&url)
             .bearer_auth(self.api_key.expose_secret())
             .query(&query)
             .send()
             .await
-            .map_err(|e| RelayError::Network(e.to_string()))?;
+            .map_err(|e| {
+                tracing::warn!(
+                    relay_url = %url,
+                    error = %e,
+                    "RelayClient::initiate_oauth: network request failed"
+                );
+                RelayError::Network(e.to_string())
+            })?;
+        tracing::debug!(
+            relay_url = %url,
+            status = %resp.status(),
+            "RelayClient::initiate_oauth: received response"
+        );
 
         let status = resp.status();
         if status.is_redirection() {
@@ -224,20 +238,39 @@ impl RelayClient {
         method: &str,
         body: serde_json::Value,
     ) -> Result<serde_json::Value, RelayError> {
+        let url = format!("{}/proxy/{}/{}", self.base_url, provider, method);
+        tracing::debug!(
+            relay_url = %url,
+            provider = %provider,
+            method = %method,
+            "RelayClient::proxy_provider: sending request"
+        );
         let query: Vec<(&str, &str)> = vec![("team_id", team_id)];
         let resp = self
             .http
-            .post(format!("{}/proxy/{}/{}", self.base_url, provider, method))
+            .post(&url)
             .bearer_auth(self.api_key.expose_secret())
             .query(&query)
             .json(&body)
             .send()
             .await
-            .map_err(|e| RelayError::Network(e.to_string()))?;
+            .map_err(|e| {
+                tracing::warn!(
+                    relay_url = %url,
+                    error = %e,
+                    "RelayClient::proxy_provider: network request failed"
+                );
+                RelayError::Network(e.to_string())
+            })?;
 
         if !resp.status().is_success() {
             let status = resp.status().as_u16();
             let body = resp.text().await.unwrap_or_default();
+            tracing::warn!(
+                relay_url = %url,
+                status = status,
+                "RelayClient::proxy_provider: channel-relay returned error"
+            );
             return Err(RelayError::Api {
                 status,
                 message: body,
@@ -255,23 +288,45 @@ impl RelayClient {
     /// 32-byte secret. Called once at activation time; the result is cached in the
     /// extension manager so subsequent calls to `relay_signing_secret()` use it.
     pub async fn get_signing_secret(&self, team_id: &str) -> Result<Vec<u8>, RelayError> {
+        let url = format!("{}/relay/signing-secret", self.base_url);
+        tracing::debug!(
+            relay_url = %url,
+            "RelayClient::get_signing_secret: fetching signing secret"
+        );
         let resp = self
             .http
-            .get(format!("{}/relay/signing-secret", self.base_url))
+            .get(&url)
             .bearer_auth(self.api_key.expose_secret())
             .query(&[("team_id", team_id)])
             .send()
             .await
-            .map_err(|e| RelayError::Network(e.to_string()))?;
+            .map_err(|e| {
+                tracing::warn!(
+                    relay_url = %url,
+                    error = %e,
+                    "RelayClient::get_signing_secret: network request failed"
+                );
+                RelayError::Network(e.to_string())
+            })?;
 
         if !resp.status().is_success() {
             let status = resp.status().as_u16();
             let body = resp.text().await.unwrap_or_default();
+            tracing::warn!(
+                relay_url = %url,
+                status = status,
+                body = %body,
+                "RelayClient::get_signing_secret: channel-relay returned error"
+            );
             return Err(RelayError::Api {
                 status,
                 message: body,
             });
         }
+        tracing::debug!(
+            relay_url = %url,
+            "RelayClient::get_signing_secret: received successful response"
+        );
 
         let body: serde_json::Value = resp
             .json()

src/channels/web/CLAUDE.md

@@ -91,34 +91,6 @@ Browser-facing HTTP API and SSE/WebSocket real-time streaming. Axum-based, singl
 | DELETE | `/api/routines/{id}` | Delete a routine |
 | GET | `/api/routines/{id}/runs` | List runs for a specific routine |
 
-### User Management (admin — requires `admin` role, see `docs/USER_MANAGEMENT_API.md`)
-| Method | Path | Description |
-|--------|------|-------------|
-| POST | `/api/admin/users` | Create a new user (returns one-time token) |
-| GET | `/api/admin/users` | List all users |
-| GET | `/api/admin/users/{id}` | Get a single user |
-| PATCH | `/api/admin/users/{id}` | Update user profile/metadata |
-| DELETE | `/api/admin/users/{id}` | Delete user and all data |
-| POST | `/api/admin/users/{id}/suspend` | Suspend a user |
-| POST | `/api/admin/users/{id}/activate` | Re-activate a user |
-| GET | `/api/admin/usage` | Per-user LLM usage stats |
-| GET | `/api/admin/users/{id}/secrets` | List a user's secrets (names only) |
-| PUT | `/api/admin/users/{id}/secrets/{name}` | Create or update a user's secret |
-| DELETE | `/api/admin/users/{id}/secrets/{name}` | Delete a user's secret |
-
-### Profile (self-service)
-| Method | Path | Description |
-|--------|------|-------------|
-| GET | `/api/profile` | Get own profile |
-| PATCH | `/api/profile` | Update own display name/metadata |
-
-### Tokens (self-service)
-| Method | Path | Description |
-|--------|------|-------------|
-| POST | `/api/tokens` | Create API token (returns plaintext once) |
-| GET | `/api/tokens` | List own tokens |
-| DELETE | `/api/tokens/{id}` | Revoke a token |
-
 ### Settings
 | Method | Path | Description |
 |--------|------|-------------|

src/channels/web/auth.rs

@@ -5,7 +5,6 @@
 //! handlers can extract it via `AuthenticatedUser`.
 
 use std::collections::HashMap;
-use std::num::NonZeroUsize;
 
 use axum::{
     extract::{FromRequestParts, Request, State},
@@ -14,25 +13,18 @@ use axum::{
     response::{IntoResponse, Response},
 };
 use sha2::{Digest, Sha256};
-use std::sync::Arc;
-use std::time::Instant;
 use subtle::ConstantTimeEq;
-use tokio::sync::RwLock;
-
-use crate::db::Database;
 
 /// Identity resolved from a bearer token.
 #[derive(Debug, Clone)]
 pub struct UserIdentity {
     pub user_id: String,
-    /// `admin` or `member`.
-    pub role: String,
     /// Additional user scopes this identity can read from.
     pub workspace_read_scopes: Vec<String>,
 }
 
 /// Hash a token with SHA-256 for constant-size, timing-safe storage.
-pub fn hash_token(token: &str) -> [u8; 32] {
+fn hash_token(token: &str) -> [u8; 32] {
     let mut hasher = Sha256::new();
     hasher.update(token.as_bytes());
     hasher.finalize().into()
@@ -64,7 +56,6 @@ impl MultiAuthState {
                 hash,
                 UserIdentity {
                     user_id,
-                    role: "admin".to_string(),
                     workspace_read_scopes: Vec::new(),
                 },
             )],
@@ -73,11 +64,6 @@ impl MultiAuthState {
     }
 
     /// Create a multi-user auth state from a map of tokens to identities.
-    ///
-    /// **Test-only** — production multi-user auth is DB-backed via
-    /// `DbAuthenticator`. This constructor is kept public (not `#[cfg(test)]`)
-    /// because integration tests in `tests/` compile the crate as a library
-    /// where `cfg(test)` is not set.
     pub fn multi(tokens: HashMap<String, UserIdentity>) -> Self {
         let hashed_tokens: Vec<([u8; 32], UserIdentity)> = tokens
             .into_iter()
@@ -122,112 +108,6 @@ impl MultiAuthState {
     }
 }
 
-/// DB-backed token authenticator with a bounded LRU cache.
-///
-/// Checks an LRU cache first (TTL 60s), then falls back to a DB query.
-/// The cache is bounded to `MAX_CACHE_ENTRIES` — when full, the least
-/// recently used entry is evicted regardless of TTL.
-///
-/// Revoking a token or suspending a user has at most 60s of stale
-/// authentication before the cache entry expires.
-#[derive(Clone)]
-#[allow(clippy::type_complexity)]
-pub struct DbAuthenticator {
-    store: Arc<dyn Database>,
-    /// Bounded LRU cache: token_hash → (identity, inserted_at).
-    cache: Arc<RwLock<lru::LruCache<[u8; 32], (UserIdentity, Instant)>>>,
-}
-
-impl DbAuthenticator {
-    /// Cache TTL — how long a successful auth is cached before re-querying the DB.
-    const CACHE_TTL_SECS: u64 = 60;
-    /// Maximum cache entries to prevent unbounded growth.
-    // SAFETY: 1024 is non-zero, so the unwrap in `new()` is infallible.
-    const MAX_CACHE_ENTRIES: NonZeroUsize = match NonZeroUsize::new(1024) {
-        Some(v) => v,
-        None => unreachable!(),
-    };
-
-    pub fn new(store: Arc<dyn Database>) -> Self {
-        Self {
-            store,
-            cache: Arc::new(RwLock::new(lru::LruCache::new(Self::MAX_CACHE_ENTRIES))),
-        }
-    }
-
-    /// Authenticate a token against the database, using cache when possible.
-    ///
-    /// Returns `Ok(Some(identity))` on success, `Ok(None)` if the token is
-    /// not found, or `Err(())` if the database is unreachable (so the caller
-    /// can return 503 instead of 401).
-    pub async fn authenticate(&self, candidate: &str) -> Result<Option<UserIdentity>, ()> {
-        let hash = hash_token(candidate);
-
-        // Check cache first (promotes to most-recent on hit)
-        {
-            let mut cache = self.cache.write().await;
-            if let Some((identity, inserted_at)) = cache.get(&hash) {
-                if inserted_at.elapsed().as_secs() < Self::CACHE_TTL_SECS {
-                    return Ok(Some(identity.clone()));
-                }
-                // Expired — remove stale entry
-                cache.pop(&hash);
-            }
-        }
-
-        // Cache miss or expired — query DB
-        let (token_record, user_record) = match self.store.authenticate_token(&hash).await {
-            Ok(Some(pair)) => pair,
-            Ok(None) => return Ok(None),
-            Err(e) => {
-                tracing::error!(error = %e, "DB auth lookup failed, returning 503");
-                return Err(());
-            }
-        };
-
-        let identity = UserIdentity {
-            user_id: user_record.id.clone(),
-            role: user_record.role.clone(),
-            workspace_read_scopes: Vec::new(),
-        };
-
-        // Record token usage (best-effort, don't block auth)
-        let store = self.store.clone();
-        let token_id = token_record.id;
-        let user_id = user_record.id;
-        tokio::spawn(async move {
-            let _ = store.record_token_usage(token_id).await;
-            let _ = store.record_login(&user_id).await;
-        });
-
-        // Insert into bounded LRU — if full, least-recently-used entry is evicted
-        {
-            let mut cache = self.cache.write().await;
-            cache.put(hash, (identity.clone(), Instant::now()));
-        }
-
-        Ok(Some(identity))
-    }
-}
-
-/// Combined auth state: tries env-var tokens first, then DB-backed tokens.
-#[derive(Clone)]
-pub struct CombinedAuthState {
-    /// In-memory tokens from GATEWAY_AUTH_TOKEN.
-    pub env_auth: MultiAuthState,
-    /// DB-backed token authenticator (optional — only when a database is available).
-    pub db_auth: Option<DbAuthenticator>,
-}
-
-impl From<MultiAuthState> for CombinedAuthState {
-    fn from(env_auth: MultiAuthState) -> Self {
-        Self {
-            env_auth,
-            db_auth: None,
-        }
-    }
-}
-
 /// Axum extractor that provides the authenticated user identity.
 ///
 /// Only available on routes behind `auth_middleware`. Extracts the
@@ -250,31 +130,6 @@ where
     }
 }
 
-/// Axum extractor that requires the authenticated user to have the `admin` role.
-///
-/// Use instead of `AuthenticatedUser` on endpoints that modify system-wide
-/// state (user management, model selection, extension/skill installation).
-pub struct AdminUser(pub UserIdentity);
-
-impl<S> FromRequestParts<S> for AdminUser
-where
-    S: Send + Sync,
-{
-    type Rejection = (StatusCode, &'static str);
-
-    async fn from_request_parts(parts: &mut Parts, _state: &S) -> Result<Self, Self::Rejection> {
-        let identity = parts
-            .extensions
-            .get::<UserIdentity>()
-            .cloned()
-            .ok_or((StatusCode::UNAUTHORIZED, "Not authenticated"))?;
-        if identity.role != "admin" {
-            return Err((StatusCode::FORBIDDEN, "Admin role required"));
-        }
-        Ok(AdminUser(identity))
-    }
-}
-
 /// Whether query-string token auth is allowed for this request.
 ///
 /// Only GET requests to streaming endpoints may use `?token=xxx`. This
@@ -311,65 +166,39 @@ fn query_token(request: &Request) -> Option<String> {
 
 /// Auth middleware that validates bearer token from header or query param.
 ///
-/// Tries env-var tokens first (constant-time, in-memory), then falls back
-/// to DB-backed token lookup if configured. SSE connections can't set
-/// headers from `EventSource`, so we also accept `?token=xxx` as a query
-/// parameter, but only on SSE/WS endpoints.
+/// SSE connections can't set headers from `EventSource`, so we also accept
+/// `?token=xxx` as a query parameter, but only on SSE/WS endpoints.
 ///
 /// On successful authentication, inserts the matching `UserIdentity` into
 /// request extensions for downstream extraction via `AuthenticatedUser`.
 pub async fn auth_middleware(
-    State(auth): State<CombinedAuthState>,
+    State(auth): State<MultiAuthState>,
     headers: HeaderMap,
     mut request: Request,
     next: Next,
 ) -> Response {
-    // Extract the candidate token from header or query param.
-    let token = extract_token(&headers, &request);
-
-    if let Some(ref tok) = token {
-        // 1. Try env-var tokens first (fast, constant-time, in-memory).
-        if let Some(identity) = auth.env_auth.authenticate(tok) {
-            request.extensions_mut().insert(identity.clone());
-            return next.run(request).await;
-        }
-
-        // 2. Fall back to DB-backed token lookup.
-        if let Some(ref db_auth) = auth.db_auth {
-            match db_auth.authenticate(tok).await {
-                Ok(Some(identity)) => {
-                    request.extensions_mut().insert(identity);
-                    return next.run(request).await;
-                }
-                Err(()) => {
-                    return (StatusCode::SERVICE_UNAVAILABLE, "Database unavailable")
-                        .into_response();
-                }
-                Ok(None) => {}
-            }
-        }
-    }
-
-    (StatusCode::UNAUTHORIZED, "Invalid or missing auth token").into_response()
-}
-
-/// Extract a bearer token from the Authorization header or query parameter.
-fn extract_token(headers: &HeaderMap, request: &Request) -> Option<String> {
-    // Try Authorization header first (RFC 6750).
+    // Try Authorization header first.
+    // RFC 6750 Section 2.1: auth-scheme comparison is case-insensitive.
     if let Some(auth_header) = headers.get("authorization")
         && let Ok(value) = auth_header.to_str()
         && value.len() > 7
         && value[..7].eq_ignore_ascii_case("Bearer ")
+        && let Some(identity) = auth.authenticate(&value[7..])
     {
-        return Some(value[7..].to_string());
+        request.extensions_mut().insert(identity.clone());
+        return next.run(request).await;
     }
 
-    // Fall back to query parameter for SSE/WS endpoints.
-    if allows_query_token_auth(request) {
-        return query_token(request);
+    // Fall back to query parameter, but only for SSE/WS endpoints.
+    if allows_query_token_auth(&request)
+        && let Some(token) = query_token(&request)
+        && let Some(identity) = auth.authenticate(&token)
+    {
+        request.extensions_mut().insert(identity.clone());
+        return next.run(request).await;
     }
 
-    None
+    (StatusCode::UNAUTHORIZED, "Invalid or missing auth token").into_response()
 }
 
 #[cfg(test)]
@@ -398,7 +227,6 @@ mod tests {
             "tok-alice".to_string(),
             UserIdentity {
                 user_id: "alice".to_string(),
-                role: "admin".to_string(),
                 workspace_read_scopes: Vec::new(),
             },
         );
@@ -406,7 +234,6 @@ mod tests {
             "tok-bob".to_string(),
             UserIdentity {
                 user_id: "bob".to_string(),
-                role: "admin".to_string(),
                 workspace_read_scopes: Vec::new(),
             },
         );
@@ -447,10 +274,7 @@ mod tests {
     /// Router with streaming endpoints (query auth allowed) and regular
     /// endpoints (query auth rejected).
     fn test_app(token: &str) -> Router {
-        let state = CombinedAuthState::from(MultiAuthState::single(
-            token.to_string(),
-            "test-user".to_string(),
-        ));
+        let state = MultiAuthState::single(token.to_string(), "test-user".to_string());
         Router::new()
             .route("/api/chat/events", get(dummy_handler))
             .route("/api/logs/events", get(dummy_handler))
@@ -662,7 +486,7 @@ mod tests {
 
     /// Build a multi-user router where each token maps to a distinct identity.
     fn multi_user_app(tokens: HashMap<String, UserIdentity>) -> Router {
-        let state = CombinedAuthState::from(MultiAuthState::multi(tokens));
+        let state = MultiAuthState::multi(tokens);
         Router::new()
             .route("/api/chat/events", get(identity_handler))
             .route("/api/chat/send", post(identity_handler))
@@ -676,7 +500,6 @@ mod tests {
             "tok-alice".to_string(),
             UserIdentity {
                 user_id: "alice".to_string(),
-                role: "admin".to_string(),
                 workspace_read_scopes: vec!["shared".to_string()],
             },
         );
@@ -684,7 +507,6 @@ mod tests {
             "tok-bob".to_string(),
             UserIdentity {
                 user_id: "bob".to_string(),
-                role: "admin".to_string(),
                 workspace_read_scopes: vec!["shared".to_string(), "alice".to_string()],
             },
         );
@@ -821,10 +643,7 @@ mod tests {
     #[tokio::test]
     async fn test_multi_user_empty_scopes_for_single_user() {
         // Single-user mode creates identity with empty workspace_read_scopes.
-        let state = CombinedAuthState::from(MultiAuthState::single(
-            "tok-only".to_string(),
-            "solo".to_string(),
-        ));
+        let state = MultiAuthState::single("tok-only".to_string(), "solo".to_string());
         let app = Router::new()
             .route("/api/scopes", get(scopes_handler))
             .layer(middleware::from_fn_with_state(state, auth_middleware));

src/channels/web/handlers/extensions.rs

@@ -70,6 +70,7 @@ pub async fn extensions_list_handler(
                 tools: ext.tools,
                 needs_setup: ext.needs_setup,
                 has_auth: ext.has_auth,
+                derived: ext.derived,
                 activation_status,
                 activation_error: ext.activation_error,
                 version: ext.version,

src/channels/web/handlers/mod.rs

@@ -5,10 +5,7 @@
 pub mod jobs;
 pub mod memory;
 pub mod routines;
-pub mod secrets;
 pub mod skills;
-pub mod tokens;
-pub mod users;
 
 // Modules not yet wired into server.rs router -- suppress dead_code until
 // they replace their inline counterparts.

src/channels/web/handlers/secrets.rs

@@ -1,134 +0,0 @@
-//! Admin secrets provisioning handlers.
-//!
-//! Allows an admin (typically an application backend) to create, list, and
-//! delete secrets on behalf of individual users so their IronClaw agent can
-//! call back to external services with per-user credentials.
-
-use std::sync::Arc;
-
-use axum::{
-    Json,
-    extract::{Path, State},
-    http::StatusCode,
-};
-
-use crate::channels::web::auth::AdminUser;
-use crate::channels::web::server::GatewayState;
-use crate::secrets::CreateSecretParams;
-
-/// PUT /api/admin/users/{user_id}/secrets/{name} — create or update a secret.
-///
-/// Upserts: if a secret with the same (user_id, name) already exists it is
-/// overwritten. The plaintext value is encrypted at rest (AES-256-GCM) and
-/// never returned by any endpoint.
-pub async fn secrets_put_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_admin): AdminUser,
-    Path((user_id, name)): Path<(String, String)>,
-    Json(body): Json<serde_json::Value>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let secrets = state.secrets_store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Secrets store not available".to_string(),
-    ))?;
-
-    let value = body
-        .get("value")
-        .and_then(|v| v.as_str())
-        .ok_or((
-            StatusCode::BAD_REQUEST,
-            "Missing required field 'value'".to_string(),
-        ))?
-        .to_string();
-
-    let provider = body
-        .get("provider")
-        .and_then(|v| v.as_str())
-        .map(String::from);
-
-    let expires_at = body
-        .get("expires_in_days")
-        .and_then(|v| v.as_u64())
-        .map(|d| d.min(36500))
-        .map(|days| chrono::Utc::now() + chrono::Duration::days(days as i64));
-
-    let mut params = CreateSecretParams::new(name.clone(), value);
-    if let Some(p) = provider {
-        params = params.with_provider(p);
-    }
-    if let Some(exp) = expires_at {
-        params = params.with_expiry(exp);
-    }
-
-    secrets
-        .create(&user_id, params)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "user_id": user_id,
-        "name": name.to_lowercase(),
-        "status": "created",
-    })))
-}
-
-/// GET /api/admin/users/{user_id}/secrets — list a user's secrets (names only).
-///
-/// Never returns secret values or hashes.
-pub async fn secrets_list_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_admin): AdminUser,
-    Path(user_id): Path<String>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let secrets = state.secrets_store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Secrets store not available".to_string(),
-    ))?;
-
-    let refs = secrets
-        .list(&user_id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    let secrets_json: Vec<serde_json::Value> = refs
-        .into_iter()
-        .map(|r| {
-            serde_json::json!({
-                "name": r.name,
-                "provider": r.provider,
-            })
-        })
-        .collect();
-
-    Ok(Json(serde_json::json!({
-        "user_id": user_id,
-        "secrets": secrets_json,
-    })))
-}
-
-/// DELETE /api/admin/users/{user_id}/secrets/{name} — delete a user's secret.
-pub async fn secrets_delete_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_admin): AdminUser,
-    Path((user_id, name)): Path<(String, String)>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let secrets = state.secrets_store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Secrets store not available".to_string(),
-    ))?;
-
-    let deleted = secrets
-        .delete(&user_id, &name)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    if !deleted {
-        return Err((StatusCode::NOT_FOUND, "Secret not found".to_string()));
-    }
-
-    Ok(Json(serde_json::json!({
-        "user_id": user_id,
-        "name": name,
-        "deleted": true,
-    })))
-}

src/channels/web/handlers/tokens.rs

@@ -1,150 +0,0 @@
-//! API token management handlers.
-
-use std::sync::Arc;
-
-use axum::{
-    Json,
-    extract::{Path, State},
-    http::StatusCode,
-};
-use rand::RngCore;
-use rand::rngs::OsRng;
-use uuid::Uuid;
-
-use crate::channels::web::auth::AuthenticatedUser;
-use crate::channels::web::server::GatewayState;
-
-/// POST /api/tokens — create a new API token (returns plaintext ONCE).
-pub async fn tokens_create_handler(
-    State(state): State<Arc<GatewayState>>,
-    AuthenticatedUser(user): AuthenticatedUser,
-    Json(body): Json<serde_json::Value>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let name = body
-        .get("name")
-        .and_then(|v| v.as_str())
-        .ok_or((
-            StatusCode::BAD_REQUEST,
-            "Missing required field 'name'".to_string(),
-        ))?
-        .to_string();
-
-    let expires_in_days: Option<i64> = body
-        .get("expires_in_days")
-        .and_then(|v| v.as_u64())
-        .map(|d| d.min(36500) as i64);
-
-    let expires_at = expires_in_days.map(|days| chrono::Utc::now() + chrono::Duration::days(days));
-
-    // Generate 32 random bytes for the token.
-    // Hash the hex-encoded plaintext (what the user sends as Bearer token),
-    // NOT the raw bytes — must match hash_token() in auth.rs.
-    let mut token_bytes = [0u8; 32];
-    OsRng.fill_bytes(&mut token_bytes);
-    let plaintext_token = hex::encode(token_bytes);
-    let hash = crate::channels::web::auth::hash_token(&plaintext_token);
-
-    // First 8 chars of the hex token as a prefix for identification.
-    let token_prefix = &plaintext_token[..8];
-
-    // Admin users can create tokens for other users via optional "user_id" field.
-    let target_user = body
-        .get("user_id")
-        .and_then(|v| v.as_str())
-        .filter(|_| user.role == "admin")
-        .unwrap_or(&user.user_id);
-
-    // Verify the target user exists to prevent orphan tokens.
-    if target_user != user.user_id {
-        store
-            .get_user(target_user)
-            .await
-            .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-            .ok_or((
-                StatusCode::BAD_REQUEST,
-                format!("Target user '{target_user}' not found"),
-            ))?;
-    }
-
-    let record = store
-        .create_api_token(target_user, &name, &hash, token_prefix, expires_at)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    // Return the plaintext token — this is the ONLY time it is shown.
-    Ok(Json(serde_json::json!({
-        "token": plaintext_token,
-        "id": record.id.to_string(),
-        "name": record.name,
-        "token_prefix": record.token_prefix,
-        "expires_at": record.expires_at.map(|dt| dt.to_rfc3339()),
-        "created_at": record.created_at.to_rfc3339(),
-    })))
-}
-
-/// GET /api/tokens — list the current user's tokens (no hashes).
-pub async fn tokens_list_handler(
-    State(state): State<Arc<GatewayState>>,
-    AuthenticatedUser(user): AuthenticatedUser,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let tokens = store
-        .list_api_tokens(&user.user_id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    let tokens_json: Vec<serde_json::Value> = tokens
-        .into_iter()
-        .map(|t| {
-            serde_json::json!({
-                "id": t.id.to_string(),
-                "name": t.name,
-                "token_prefix": t.token_prefix,
-                "expires_at": t.expires_at.map(|dt| dt.to_rfc3339()),
-                "last_used_at": t.last_used_at.map(|dt| dt.to_rfc3339()),
-                "created_at": t.created_at.to_rfc3339(),
-                "revoked_at": t.revoked_at.map(|dt| dt.to_rfc3339()),
-            })
-        })
-        .collect();
-
-    Ok(Json(serde_json::json!({ "tokens": tokens_json })))
-}
-
-/// DELETE /api/tokens/{id} — revoke a token.
-pub async fn tokens_revoke_handler(
-    State(state): State<Arc<GatewayState>>,
-    AuthenticatedUser(user): AuthenticatedUser,
-    Path(id): Path<String>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let token_id = Uuid::parse_str(&id)
-        .map_err(|_| (StatusCode::BAD_REQUEST, "Invalid token ID".to_string()))?;
-
-    let revoked = store
-        .revoke_api_token(token_id, &user.user_id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    if !revoked {
-        return Err((StatusCode::NOT_FOUND, "Token not found".to_string()));
-    }
-
-    Ok(Json(serde_json::json!({
-        "status": "revoked",
-        "id": token_id.to_string(),
-    })))
-}

src/channels/web/handlers/users.rs

@@ -1,406 +0,0 @@
-//! User management API handlers (admin).
-
-use std::sync::Arc;
-
-use axum::{
-    Json,
-    extract::{Path, State},
-    http::StatusCode,
-};
-use rand::RngCore;
-use rand::rngs::OsRng;
-use uuid::Uuid;
-
-use crate::channels::web::auth::{AdminUser, AuthenticatedUser};
-use crate::channels::web::server::GatewayState;
-use crate::db::UserRecord;
-
-/// POST /api/admin/users — create a new user.
-pub async fn users_create_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(user): AdminUser,
-    Json(body): Json<serde_json::Value>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let display_name = body
-        .get("display_name")
-        .and_then(|v| v.as_str())
-        .ok_or((
-            StatusCode::BAD_REQUEST,
-            "Missing required field 'display_name'".to_string(),
-        ))?
-        .to_string();
-
-    let email = body.get("email").and_then(|v| v.as_str()).map(String::from);
-    let role = body
-        .get("role")
-        .and_then(|v| v.as_str())
-        .unwrap_or("member")
-        .to_string();
-    if role != "admin" && role != "member" {
-        return Err((
-            StatusCode::BAD_REQUEST,
-            "role must be 'admin' or 'member'".to_string(),
-        ));
-    }
-
-    let user_id = Uuid::new_v4().to_string();
-
-    let now = chrono::Utc::now();
-    let user_record = UserRecord {
-        id: user_id.clone(),
-        email,
-        display_name: display_name.clone(),
-        status: "active".to_string(),
-        role,
-        created_at: now,
-        updated_at: now,
-        last_login_at: None,
-        created_by: match store.get_user(&user.user_id).await {
-            Ok(Some(_)) => Some(user.user_id.clone()),
-            _ => None,
-        },
-        metadata: serde_json::json!({}),
-    };
-
-    store
-        .create_user(&user_record)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    // Generate a first API token so the new user can authenticate immediately.
-    // Hash the hex-encoded plaintext (what the user sends as Bearer token),
-    // NOT the raw bytes — must match hash_token() in auth.rs.
-    let mut token_bytes = [0u8; 32];
-    OsRng.fill_bytes(&mut token_bytes);
-    let plaintext_token = hex::encode(token_bytes);
-    let token_hash = crate::channels::web::auth::hash_token(&plaintext_token);
-    let token_prefix = &plaintext_token[..8];
-
-    let _token_record = store
-        .create_api_token(&user_id, "initial", &token_hash, token_prefix, None)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "id": user_record.id,
-        "email": user_record.email,
-        "display_name": user_record.display_name,
-        "status": user_record.status,
-        "role": user_record.role,
-        "token": plaintext_token,
-        "created_at": user_record.created_at.to_rfc3339(),
-        "created_by": user_record.created_by,
-    })))
-}
-
-/// GET /api/admin/users — list all users.
-pub async fn users_list_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_user): AdminUser,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let users = store
-        .list_users(None)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    let users_json: Vec<serde_json::Value> = users
-        .into_iter()
-        .map(|u| {
-            serde_json::json!({
-                "id": u.id,
-                "email": u.email,
-                "display_name": u.display_name,
-                "status": u.status,
-                "role": u.role,
-                "created_at": u.created_at.to_rfc3339(),
-                "updated_at": u.updated_at.to_rfc3339(),
-                "last_login_at": u.last_login_at.map(|dt| dt.to_rfc3339()),
-                "created_by": u.created_by,
-            })
-        })
-        .collect();
-
-    Ok(Json(serde_json::json!({ "users": users_json })))
-}
-
-/// GET /api/admin/users/{id} — get a single user.
-pub async fn users_detail_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_user): AdminUser,
-    Path(id): Path<String>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let user_record = store
-        .get_user(&id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-        .ok_or((StatusCode::NOT_FOUND, "User not found".to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "id": user_record.id,
-        "email": user_record.email,
-        "display_name": user_record.display_name,
-        "status": user_record.status,
-        "role": user_record.role,
-        "created_at": user_record.created_at.to_rfc3339(),
-        "updated_at": user_record.updated_at.to_rfc3339(),
-        "last_login_at": user_record.last_login_at.map(|dt| dt.to_rfc3339()),
-        "created_by": user_record.created_by,
-        "metadata": user_record.metadata,
-    })))
-}
-
-/// PATCH /api/admin/users/{id} — update a user's profile.
-pub async fn users_update_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_user): AdminUser,
-    Path(id): Path<String>,
-    Json(body): Json<serde_json::Value>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    // Verify the user exists.
-    let existing = store
-        .get_user(&id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-        .ok_or((StatusCode::NOT_FOUND, "User not found".to_string()))?;
-
-    let display_name = body
-        .get("display_name")
-        .and_then(|v| v.as_str())
-        .unwrap_or(&existing.display_name);
-
-    let metadata = body.get("metadata").unwrap_or(&existing.metadata);
-
-    store
-        .update_user_profile(&id, display_name, metadata)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    // Re-fetch the updated record to return consistent data.
-    let updated = store
-        .get_user(&id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-        .ok_or((StatusCode::NOT_FOUND, "User not found".to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "id": updated.id,
-        "email": updated.email,
-        "display_name": updated.display_name,
-        "status": updated.status,
-        "role": updated.role,
-        "created_at": updated.created_at.to_rfc3339(),
-        "updated_at": updated.updated_at.to_rfc3339(),
-        "metadata": updated.metadata,
-    })))
-}
-
-/// POST /api/admin/users/{id}/suspend — suspend a user.
-pub async fn users_suspend_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_user): AdminUser,
-    Path(id): Path<String>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    // Verify the user exists.
-    store
-        .get_user(&id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-        .ok_or((StatusCode::NOT_FOUND, "User not found".to_string()))?;
-
-    store
-        .update_user_status(&id, "suspended")
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "id": id,
-        "status": "suspended",
-    })))
-}
-
-/// POST /api/admin/users/{id}/activate — activate a user.
-pub async fn users_activate_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_user): AdminUser,
-    Path(id): Path<String>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    // Verify the user exists.
-    store
-        .get_user(&id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-        .ok_or((StatusCode::NOT_FOUND, "User not found".to_string()))?;
-
-    store
-        .update_user_status(&id, "active")
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "id": id,
-        "status": "active",
-    })))
-}
-
-/// DELETE /api/admin/users/{id} — delete a user and all their data.
-pub async fn users_delete_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_user): AdminUser,
-    Path(id): Path<String>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let deleted = store
-        .delete_user(&id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    if !deleted {
-        return Err((StatusCode::NOT_FOUND, "User not found".to_string()));
-    }
-
-    Ok(Json(serde_json::json!({
-        "id": id,
-        "deleted": true,
-    })))
-}
-
-/// GET /api/profile — get the authenticated user's own profile.
-pub async fn profile_get_handler(
-    State(state): State<Arc<GatewayState>>,
-    AuthenticatedUser(user): AuthenticatedUser,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let record = store
-        .get_user(&user.user_id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-        .ok_or((StatusCode::NOT_FOUND, "User not found".to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "id": record.id,
-        "email": record.email,
-        "display_name": record.display_name,
-        "status": record.status,
-        "role": record.role,
-        "created_at": record.created_at.to_rfc3339(),
-        "last_login_at": record.last_login_at.map(|dt| dt.to_rfc3339()),
-    })))
-}
-
-/// PATCH /api/profile — update the authenticated user's own profile.
-pub async fn profile_update_handler(
-    State(state): State<Arc<GatewayState>>,
-    AuthenticatedUser(user): AuthenticatedUser,
-    Json(body): Json<serde_json::Value>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let current = store
-        .get_user(&user.user_id)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?
-        .ok_or((StatusCode::NOT_FOUND, "User not found".to_string()))?;
-
-    let display_name = body
-        .get("display_name")
-        .and_then(|v| v.as_str())
-        .unwrap_or(&current.display_name);
-    let metadata = body.get("metadata").unwrap_or(&current.metadata);
-
-    store
-        .update_user_profile(&user.user_id, display_name, metadata)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    Ok(Json(serde_json::json!({
-        "id": user.user_id,
-        "display_name": display_name,
-        "updated": true,
-    })))
-}
-
-/// GET /api/admin/usage — per-user LLM usage stats.
-pub async fn usage_stats_handler(
-    State(state): State<Arc<GatewayState>>,
-    AdminUser(_user): AdminUser,
-    axum::extract::Query(params): axum::extract::Query<std::collections::HashMap<String, String>>,
-) -> Result<Json<serde_json::Value>, (StatusCode, String)> {
-    let store = state.store.as_ref().ok_or((
-        StatusCode::SERVICE_UNAVAILABLE,
-        "Database not available".to_string(),
-    ))?;
-
-    let user_id = params.get("user_id").map(|s| s.as_str());
-    let period = params.get("period").map(|s| s.as_str()).unwrap_or("day");
-    let since = match period {
-        "week" => chrono::Utc::now() - chrono::Duration::days(7),
-        "month" => chrono::Utc::now() - chrono::Duration::days(30),
-        _ => chrono::Utc::now() - chrono::Duration::days(1),
-    };
-
-    let stats = store
-        .user_usage_stats(user_id, since)
-        .await
-        .map_err(|e| (StatusCode::INTERNAL_SERVER_ERROR, e.to_string()))?;
-
-    let entries: Vec<serde_json::Value> = stats
-        .iter()
-        .map(|s| {
-            serde_json::json!({
-                "user_id": s.user_id,
-                "model": s.model,
-                "call_count": s.call_count,
-                "input_tokens": s.input_tokens,
-                "output_tokens": s.output_tokens,
-                "total_cost": s.total_cost.to_string(),
-            })
-        })
-        .collect();
-
-    Ok(Json(serde_json::json!({
-        "period": period,
-        "since": since.to_rfc3339(),
-        "usage": entries,
-    })))
-}

src/channels/web/mod.rs

@@ -18,7 +18,6 @@ pub mod auth;
 pub(crate) mod handlers;
 pub mod log_layer;
 pub mod openai_compat;
-pub mod responses_api;
 pub mod server;
 pub mod sse;
 pub mod types;
@@ -56,7 +55,7 @@ use crate::workspace::Workspace;
 
 use self::log_layer::{LogBroadcaster, LogLevelHandle};
 
-use self::auth::{CombinedAuthState, DbAuthenticator, MultiAuthState};
+use self::auth::MultiAuthState;
 use self::server::GatewayState;
 use self::sse::SseManager;
 use self::types::AppEvent;
@@ -65,8 +64,8 @@ use self::types::AppEvent;
 pub struct GatewayChannel {
     config: GatewayConfig,
     state: Arc<GatewayState>,
-    /// Combined auth state: env-var tokens + optional DB-backed tokens.
-    auth: CombinedAuthState,
+    /// Multi-user auth state (replaces bare auth_token).
+    auth: MultiAuthState,
 }
 
 impl GatewayChannel {
@@ -74,7 +73,7 @@ impl GatewayChannel {
     ///
     /// If no auth token is configured, generates a random one and prints it.
     /// Builds a single-user `MultiAuthState` from the config.
-    pub fn new(config: GatewayConfig, owner_id: String) -> Self {
+    pub fn new(config: GatewayConfig) -> Self {
         let auth_token = config.auth_token.clone().unwrap_or_else(|| {
             use rand::RngCore;
             use rand::rngs::OsRng;
@@ -83,10 +82,7 @@ impl GatewayChannel {
             bytes.iter().map(|b| format!("{b:02x}")).collect()
         });
 
-        let auth = CombinedAuthState {
-            env_auth: MultiAuthState::single(auth_token, owner_id.clone()),
-            db_auth: None,
-        };
+        let auth = MultiAuthState::single(auth_token, config.user_id.clone());
 
         let state = Arc::new(GatewayState {
             msg_tx: tokio::sync::RwLock::new(None),
@@ -102,7 +98,8 @@ impl GatewayChannel {
             job_manager: None,
             prompt_queue: None,
             scheduler: None,
-            owner_id,
+            owner_id: config.user_id.clone(),
+            default_sender_id: config.user_id.clone(),
             shutdown_tx: tokio::sync::RwLock::new(None),
             ws_tracker: Some(Arc::new(ws::WsConnectionTracker::new())),
             llm_provider: None,
@@ -116,7 +113,62 @@ impl GatewayChannel {
             routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
             startup_time: std::time::Instant::now(),
             active_config: server::ActiveConfigSnapshot::default(),
-            secrets_store: None,
+        });
+
+        Self {
+            config,
+            state,
+            auth,
+        }
+    }
+
+    /// Rebind the single-user auth identity to the durable owner scope while
+    /// preserving the configured gateway sender/routing identity.
+    pub fn with_owner_scope(mut self, owner_id: impl Into<String>) -> Self {
+        let owner_id = owner_id.into();
+        let single_user_token = if self.config.user_tokens.is_none() {
+            self.auth.first_token().map(ToOwned::to_owned)
+        } else {
+            None
+        };
+        if let Some(token) = single_user_token {
+            self.auth = MultiAuthState::single(token, owner_id.clone());
+        }
+        self.rebuild_state(|s| s.owner_id = owner_id);
+        self
+    }
+
+    /// Create a gateway channel with a pre-built multi-user auth state.
+    pub fn new_multi_auth(config: GatewayConfig, auth: MultiAuthState) -> Self {
+        let state = Arc::new(GatewayState {
+            msg_tx: tokio::sync::RwLock::new(None),
+            sse: Arc::new(SseManager::new()),
+            workspace: None,
+            workspace_pool: None,
+            session_manager: None,
+            log_broadcaster: None,
+            log_level_handle: None,
+            extension_manager: None,
+            tool_registry: None,
+            store: None,
+            job_manager: None,
+            prompt_queue: None,
+            scheduler: None,
+            owner_id: config.user_id.clone(),
+            default_sender_id: config.user_id.clone(),
+            shutdown_tx: tokio::sync::RwLock::new(None),
+            ws_tracker: Some(Arc::new(ws::WsConnectionTracker::new())),
+            llm_provider: None,
+            skill_registry: None,
+            skill_catalog: None,
+            chat_rate_limiter: server::PerUserRateLimiter::new(30, 60),
+            oauth_rate_limiter: server::RateLimiter::new(10, 60),
+            registry_entries: Vec::new(),
+            cost_guard: None,
+            routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
+            startup_time: std::time::Instant::now(),
+            webhook_rate_limiter: server::RateLimiter::new(10, 60),
+            active_config: server::ActiveConfigSnapshot::default(),
         });
 
         Self {
@@ -144,6 +196,7 @@ impl GatewayChannel {
             prompt_queue: self.state.prompt_queue.clone(),
             scheduler: self.state.scheduler.clone(),
             owner_id: self.state.owner_id.clone(),
+            default_sender_id: self.state.default_sender_id.clone(),
             shutdown_tx: tokio::sync::RwLock::new(None),
             ws_tracker: self.state.ws_tracker.clone(),
             llm_provider: self.state.llm_provider.clone(),
@@ -157,7 +210,6 @@ impl GatewayChannel {
             routine_engine: Arc::clone(&self.state.routine_engine),
             startup_time: self.state.startup_time,
             active_config: self.state.active_config.clone(),
-            secrets_store: self.state.secrets_store.clone(),
         };
         mutate(&mut new_state);
         self.state = Arc::new(new_state);
@@ -205,12 +257,6 @@ impl GatewayChannel {
         self
     }
 
-    /// Enable DB-backed token authentication alongside env-var tokens.
-    pub fn with_db_auth(mut self, store: Arc<dyn Database>) -> Self {
-        self.auth.db_auth = Some(DbAuthenticator::new(store));
-        self
-    }
-
     /// Inject the container job manager for sandbox operations.
     pub fn with_job_manager(mut self, jm: Arc<ContainerJobManager>) -> Self {
         self.rebuild_state(|s| s.job_manager = Some(jm));
@@ -281,15 +327,6 @@ impl GatewayChannel {
         self
     }
 
-    /// Inject the secrets store for admin secret provisioning.
-    pub fn with_secrets_store(
-        mut self,
-        store: Arc<dyn crate::secrets::SecretsStore + Send + Sync>,
-    ) -> Self {
-        self.rebuild_state(|s| s.secrets_store = Some(store));
-        self
-    }
-
     /// Inject the per-user workspace pool for multi-user mode.
     pub fn with_workspace_pool(mut self, pool: Arc<server::WorkspacePool>) -> Self {
         self.rebuild_state(|s| s.workspace_pool = Some(pool));
@@ -298,7 +335,7 @@ impl GatewayChannel {
 
     /// Get the first auth token (for printing to console on startup).
     pub fn auth_token(&self) -> &str {
-        self.auth.env_auth.first_token().unwrap_or("")
+        self.auth.first_token().unwrap_or("")
     }
 
     /// Get a reference to the shared gateway state (for the agent to push SSE events).

src/channels/web/server.rs

@@ -16,7 +16,7 @@ use axum::{
         IntoResponse,
         sse::{Event, KeepAlive, Sse},
     },
-    routing::{get, post, put},
+    routing::{get, post},
 };
 use serde::Deserialize;
 use sha2::{Digest, Sha256};
@@ -31,7 +31,7 @@ use crate::bootstrap::ironclaw_base_dir;
 use crate::channels::IncomingMessage;
 use crate::channels::relay::DEFAULT_RELAY_NAME;
 use crate::channels::web::auth::{
-    AuthenticatedUser, CombinedAuthState, UserIdentity, auth_middleware,
+    AuthenticatedUser, MultiAuthState, UserIdentity, auth_middleware,
 };
 use crate::channels::web::handlers::jobs::{
     job_files_list_handler, job_files_read_handler, jobs_cancel_handler, jobs_detail_handler,
@@ -347,6 +347,8 @@ pub struct GatewayState {
     pub prompt_queue: Option<PromptQueue>,
     /// Durable owner scope for persistence and unauthenticated callback flows.
     pub owner_id: String,
+    /// Default sender/routing identity for gateway-originated messages.
+    pub default_sender_id: String,
     /// Shutdown signal sender.
     pub shutdown_tx: tokio::sync::RwLock<Option<oneshot::Sender<()>>>,
     /// WebSocket connection tracker.
@@ -376,8 +378,6 @@ pub struct GatewayState {
     pub startup_time: std::time::Instant,
     /// Snapshot of active (resolved) configuration for the frontend.
     pub active_config: ActiveConfigSnapshot,
-    /// Secrets store for admin secret provisioning.
-    pub secrets_store: Option<Arc<dyn crate::secrets::SecretsStore + Send + Sync>>,
 }
 
 /// Start the gateway HTTP server.
@@ -386,7 +386,7 @@ pub struct GatewayState {
 pub async fn start_server(
     addr: SocketAddr,
     state: Arc<GatewayState>,
-    auth: CombinedAuthState,
+    auth: MultiAuthState,
 ) -> Result<SocketAddr, crate::error::ChannelError> {
     let listener = tokio::net::TcpListener::bind(addr).await.map_err(|e| {
         crate::error::ChannelError::StartupFailed {
@@ -512,57 +512,6 @@ pub async fn start_server(
             "/api/settings/{key}",
             axum::routing::delete(settings_delete_handler),
         )
-        // User management (admin)
-        .route(
-            "/api/admin/users",
-            get(super::handlers::users::users_list_handler)
-                .post(super::handlers::users::users_create_handler),
-        )
-        .route(
-            "/api/admin/users/{id}",
-            get(super::handlers::users::users_detail_handler)
-                .patch(super::handlers::users::users_update_handler)
-                .delete(super::handlers::users::users_delete_handler),
-        )
-        .route(
-            "/api/admin/users/{id}/suspend",
-            post(super::handlers::users::users_suspend_handler),
-        )
-        .route(
-            "/api/admin/users/{id}/activate",
-            post(super::handlers::users::users_activate_handler),
-        )
-        // Admin secrets provisioning (per-user)
-        .route(
-            "/api/admin/users/{user_id}/secrets",
-            get(super::handlers::secrets::secrets_list_handler),
-        )
-        .route(
-            "/api/admin/users/{user_id}/secrets/{name}",
-            put(super::handlers::secrets::secrets_put_handler)
-                .delete(super::handlers::secrets::secrets_delete_handler),
-        )
-        // Usage reporting (admin)
-        .route(
-            "/api/admin/usage",
-            get(super::handlers::users::usage_stats_handler),
-        )
-        // User self-service profile
-        .route(
-            "/api/profile",
-            get(super::handlers::users::profile_get_handler)
-                .patch(super::handlers::users::profile_update_handler),
-        )
-        // Token management
-        .route(
-            "/api/tokens",
-            get(super::handlers::tokens::tokens_list_handler)
-                .post(super::handlers::tokens::tokens_create_handler),
-        )
-        .route(
-            "/api/tokens/{id}",
-            axum::routing::delete(super::handlers::tokens::tokens_revoke_handler),
-        )
         // Gateway control plane
         .route("/api/gateway/status", get(gateway_status_handler))
         // OpenAI-compatible API
@@ -571,15 +520,6 @@ pub async fn start_server(
             post(super::openai_compat::chat_completions_handler),
         )
         .route("/v1/models", get(super::openai_compat::models_handler))
-        // OpenAI Responses API (routes through the full agent loop)
-        .route(
-            "/v1/responses",
-            post(super::responses_api::create_response_handler),
-        )
-        .route(
-            "/v1/responses/{id}",
-            get(super::responses_api::get_response_handler),
-        )
         .route_layer(middleware::from_fn_with_state(
             auth_state.clone(),
             auth_middleware,
@@ -622,7 +562,6 @@ pub async fn start_server(
             axum::http::Method::GET,
             axum::http::Method::POST,
             axum::http::Method::PUT,
-            axum::http::Method::PATCH,
             axum::http::Method::DELETE,
         ])
         .allow_headers(AllowHeaders::list([
@@ -637,25 +576,6 @@ pub async fn start_server(
         .merge(projects)
         .merge(protected)
         .layer(DefaultBodyLimit::max(10 * 1024 * 1024)) // 10 MB max request body (image uploads)
-        .layer(tower_http::catch_panic::CatchPanicLayer::custom(
-            |panic_info: Box<dyn std::any::Any + Send + 'static>| {
-                let detail = if let Some(s) = panic_info.downcast_ref::<String>() {
-                    s.clone()
-                } else if let Some(s) = panic_info.downcast_ref::<&str>() {
-                    (*s).to_string()
-                } else {
-                    "unknown panic".to_string()
-                };
-                tracing::error!("Handler panicked: {}", detail);
-                axum::http::Response::builder()
-                    .status(axum::http::StatusCode::INTERNAL_SERVER_ERROR)
-                    .header("content-type", "text/plain")
-                    .body(axum::body::Body::from("Internal Server Error"))
-                    .unwrap_or_else(|_| {
-                        axum::http::Response::new(axum::body::Body::from("Internal Server Error"))
-                    })
-            },
-        ))
         .layer(cors)
         .layer(SetResponseHeaderLayer::if_not_present(
             header::X_CONTENT_TYPE_OPTIONS,
@@ -916,10 +836,10 @@ async fn oauth_callback_handler(
 
     let result: Result<(), String> = async {
         let token_response = if let Some(proxy_url) = &exchange_proxy_url {
-            let gateway_token = flow.gateway_token.as_deref().unwrap_or_default();
+            let oauth_proxy_auth_token = flow.oauth_proxy_auth_token().unwrap_or_default();
             oauth_defaults::exchange_via_proxy(oauth_defaults::ProxyTokenExchangeRequest {
                 proxy_url,
-                gateway_token,
+                gateway_token: oauth_proxy_auth_token,
                 token_url: &flow.token_url,
                 client_id: &flow.client_id,
                 client_secret: flow.client_secret.as_deref(),
@@ -1257,11 +1177,31 @@ async fn slack_relay_oauth_callback_handler(
 
         // Store team_id in settings
         let team_id_key = format!("relay:{}:team_id", DEFAULT_RELAY_NAME);
-        let _ = store
+        tracing::info!(
+            relay = DEFAULT_RELAY_NAME,
+            owner_id = %state.owner_id,
+            team_id_key = %team_id_key,
+            "relay OAuth callback: storing team_id in settings"
+        );
+        store
             .set_setting(&state.owner_id, &team_id_key, &serde_json::json!(team_id))
-            .await;
+            .await
+            .map_err(|e| {
+                tracing::error!(
+                    relay = DEFAULT_RELAY_NAME,
+                    owner_id = %state.owner_id,
+                    error = %e,
+                    "relay OAuth callback: failed to persist team_id to settings store"
+                );
+                format!("Failed to persist relay team_id: {e}")
+            })?;
 
         // Activate the relay channel
+        tracing::info!(
+            relay = DEFAULT_RELAY_NAME,
+            owner_id = %state.owner_id,
+            "relay OAuth callback: activating relay channel"
+        );
         ext_mgr
             .activate_stored_relay(DEFAULT_RELAY_NAME, &state.owner_id)
             .await
@@ -1383,6 +1323,9 @@ async fn chat_send_handler(
     }
 
     let mut msg = IncomingMessage::new("gateway", &user.user_id, &req.content);
+    if state.owner_id != state.default_sender_id && user.user_id == state.owner_id {
+        msg = msg.with_sender_id(&state.default_sender_id);
+    }
     // Prefer timezone from JSON body, fall back to X-Timezone header
     let tz = req
         .timezone
@@ -1484,6 +1427,9 @@ async fn chat_approval_handler(
     })?;
 
     let mut msg = IncomingMessage::new("gateway", &user.user_id, content);
+    if state.owner_id != state.default_sender_id && user.user_id == state.owner_id {
+        msg = msg.with_sender_id(&state.default_sender_id);
+    }
 
     if let Some(ref thread_id) = req.thread_id {
         msg = msg.with_thread(thread_id);
@@ -2146,6 +2092,7 @@ async fn extensions_list_handler(
                 tools: ext.tools,
                 needs_setup: ext.needs_setup,
                 has_auth: ext.has_auth,
+                derived: ext.derived,
                 activation_status,
                 activation_error: ext.activation_error,
                 version: ext.version,
@@ -2255,6 +2202,11 @@ async fn extensions_activate_handler(
     AuthenticatedUser(user): AuthenticatedUser,
     Path(name): Path<String>,
 ) -> Result<Json<ActionResponse>, (StatusCode, String)> {
+    tracing::debug!(
+        extension = %name,
+        user_id = %user.user_id,
+        "extensions_activate_handler: received activate request"
+    );
     let ext_mgr = state.extension_manager.as_ref().ok_or((
         StatusCode::NOT_IMPLEMENTED,
         "Extension manager not available (secrets store required)".to_string(),
@@ -2262,6 +2214,10 @@ async fn extensions_activate_handler(
 
     match ext_mgr.activate(&name, &user.user_id).await {
         Ok(result) => {
+            tracing::info!(
+                extension = %name,
+                "extensions_activate_handler: activation succeeded"
+            );
             // Activation loaded the WASM module. Check if the tool needs
             // OAuth scope expansion (e.g., adding google-docs when gmail
             // already has a token but missing the documents scope).
@@ -2280,6 +2236,13 @@ async fn extensions_activate_handler(
                 crate::extensions::ExtensionError::AuthRequired
             );
 
+            tracing::debug!(
+                extension = %name,
+                error = %activate_err,
+                needs_auth = needs_auth,
+                "extensions_activate_handler: activation failed, attempting auth fallback"
+            );
+
             if !needs_auth {
                 return Ok(Json(ActionResponse::fail(activate_err.to_string())));
             }
@@ -2287,10 +2250,21 @@ async fn extensions_activate_handler(
             // Activation failed due to auth; try authenticating first.
             match ext_mgr.auth(&name, &user.user_id).await {
                 Ok(auth_result) if auth_result.is_authenticated() => {
+                    tracing::debug!(
+                        extension = %name,
+                        "extensions_activate_handler: auth reports authenticated, retrying activate"
+                    );
                     // Auth succeeded, retry activation.
                     match ext_mgr.activate(&name, &user.user_id).await {
                         Ok(result) => Ok(Json(ActionResponse::ok(result.message))),
-                        Err(e) => Ok(Json(ActionResponse::fail(e.to_string()))),
+                        Err(e) => {
+                            tracing::warn!(
+                                extension = %name,
+                                error = %e,
+                                "extensions_activate_handler: retry after auth still failed"
+                            );
+                            Ok(Json(ActionResponse::fail(e.to_string())))
+                        }
                     }
                 }
                 Ok(auth_result) => {
@@ -2975,6 +2949,7 @@ mod tests {
             tools: Vec::new(),
             needs_setup: true,
             has_auth: false,
+            derived: false,
             installed: true,
             activation_error: None,
             version: None,
@@ -3012,6 +2987,7 @@ mod tests {
             tools: Vec::new(),
             needs_setup: true,
             has_auth: false,
+            derived: false,
             installed: true,
             activation_error: None,
             version: None,
@@ -3059,6 +3035,7 @@ mod tests {
             job_manager: None,
             prompt_queue: None,
             owner_id: "test".to_string(),
+            default_sender_id: "test".to_string(),
             shutdown_tx: tokio::sync::RwLock::new(None),
             ws_tracker: None,
             llm_provider: None,
@@ -3073,7 +3050,6 @@ mod tests {
             routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
             startup_time: std::time::Instant::now(),
             active_config: ActiveConfigSnapshot::default(),
-            secrets_store: None,
         })
     }
 
@@ -3084,6 +3060,160 @@ mod tests {
             .with_state(state)
     }
 
+    #[derive(Clone, Debug)]
+    struct RecordedOauthProxyRequest {
+        authorization: Option<String>,
+        form: std::collections::HashMap<String, String>,
+    }
+
+    #[derive(Clone)]
+    struct MockOauthProxyState {
+        requests: Arc<tokio::sync::Mutex<Vec<RecordedOauthProxyRequest>>>,
+    }
+
+    struct MockOauthProxyServer {
+        addr: std::net::SocketAddr,
+        requests: Arc<tokio::sync::Mutex<Vec<RecordedOauthProxyRequest>>>,
+        shutdown_tx: Option<tokio::sync::oneshot::Sender<()>>,
+        server_task: Option<tokio::task::JoinHandle<()>>,
+    }
+
+    impl MockOauthProxyServer {
+        async fn start() -> Self {
+            async fn exchange_handler(
+                State(state): State<MockOauthProxyState>,
+                headers: axum::http::HeaderMap,
+                axum::Form(form): axum::Form<std::collections::HashMap<String, String>>,
+            ) -> Json<serde_json::Value> {
+                state.requests.lock().await.push(RecordedOauthProxyRequest {
+                    authorization: headers
+                        .get(axum::http::header::AUTHORIZATION)
+                        .and_then(|value| value.to_str().ok())
+                        .map(str::to_string),
+                    form,
+                });
+                Json(serde_json::json!({
+                    "access_token": "proxy-access-token",
+                    "refresh_token": "proxy-refresh-token",
+                    "expires_in": 7200
+                }))
+            }
+
+            let requests = Arc::new(tokio::sync::Mutex::new(Vec::new()));
+            let listener = tokio::net::TcpListener::bind("127.0.0.1:0")
+                .await
+                .expect("bind mock oauth proxy");
+            let addr = listener.local_addr().expect("mock oauth proxy addr");
+            let app = Router::new()
+                .route("/oauth/exchange", post(exchange_handler))
+                .with_state(MockOauthProxyState {
+                    requests: Arc::clone(&requests),
+                });
+            let (shutdown_tx, shutdown_rx) = tokio::sync::oneshot::channel::<()>();
+            let server_task = tokio::spawn(async move {
+                let _ = axum::serve(listener, app)
+                    .with_graceful_shutdown(async {
+                        let _ = shutdown_rx.await;
+                    })
+                    .await;
+            });
+
+            Self {
+                addr,
+                requests,
+                shutdown_tx: Some(shutdown_tx),
+                server_task: Some(server_task),
+            }
+        }
+
+        fn base_url(&self) -> String {
+            format!("http://{}", self.addr)
+        }
+
+        async fn requests(&self) -> Vec<RecordedOauthProxyRequest> {
+            self.requests.lock().await.clone()
+        }
+
+        async fn shutdown(mut self) {
+            if let Some(tx) = self.shutdown_tx.take() {
+                let _ = tx.send(());
+            }
+            if let Some(task) = self.server_task.take() {
+                let _ = task.await;
+            }
+        }
+    }
+
+    impl Drop for MockOauthProxyServer {
+        fn drop(&mut self) {
+            if let Some(tx) = self.shutdown_tx.take() {
+                let _ = tx.send(());
+            }
+            if let Some(task) = self.server_task.take() {
+                task.abort();
+            }
+        }
+    }
+
+    struct EnvVarGuard {
+        key: &'static str,
+        original: Option<String>,
+    }
+
+    impl Drop for EnvVarGuard {
+        fn drop(&mut self) {
+            // SAFETY: Tests use lock_env() to serialize environment access.
+            unsafe {
+                if let Some(ref value) = self.original {
+                    std::env::set_var(self.key, value);
+                } else {
+                    std::env::remove_var(self.key);
+                }
+            }
+        }
+    }
+
+    fn set_env_var(key: &'static str, value: Option<&str>) -> EnvVarGuard {
+        let original = std::env::var(key).ok();
+        // SAFETY: Tests use lock_env() to serialize environment access.
+        unsafe {
+            if let Some(value) = value {
+                std::env::set_var(key, value);
+            } else {
+                std::env::remove_var(key);
+            }
+        }
+        EnvVarGuard { key, original }
+    }
+
+    fn fresh_pending_oauth_flow(
+        secrets: Arc<dyn crate::secrets::SecretsStore + Send + Sync>,
+        sse_manager: Option<Arc<SseManager>>,
+        oauth_proxy_auth_token: Option<String>,
+    ) -> crate::cli::oauth_defaults::PendingOAuthFlow {
+        crate::cli::oauth_defaults::PendingOAuthFlow {
+            extension_name: "test_tool".to_string(),
+            display_name: "Test Tool".to_string(),
+            token_url: "https://example.com/token".to_string(),
+            client_id: "client123".to_string(),
+            client_secret: None,
+            redirect_uri: "https://example.com/oauth/callback".to_string(),
+            code_verifier: Some("test-code-verifier".to_string()),
+            access_token_field: "access_token".to_string(),
+            secret_name: "test_token".to_string(),
+            provider: Some("google".to_string()),
+            validation_endpoint: None,
+            scopes: vec!["email".to_string()],
+            user_id: "test".to_string(),
+            secrets,
+            sse_manager,
+            gateway_token: oauth_proxy_auth_token,
+            token_exchange_extra_params: std::collections::HashMap::new(),
+            client_id_secret_name: None,
+            created_at: std::time::Instant::now(),
+        }
+    }
+
     #[tokio::test]
     async fn test_extensions_setup_submit_returns_failure_when_not_activated() {
         use axum::body::Body;
@@ -3140,7 +3270,6 @@ mod tests {
         // without needing the full auth middleware layer.
         req.extensions_mut().insert(UserIdentity {
             user_id: "test".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: Vec::new(),
         });
 
@@ -3225,7 +3354,6 @@ mod tests {
         // without needing the full auth middleware layer.
         req.extensions_mut().insert(UserIdentity {
             user_id: "test".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: Vec::new(),
         });
 
@@ -3275,10 +3403,7 @@ mod tests {
         let state = test_gateway_state(None);
 
         let addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
-        let auth = CombinedAuthState::from(crate::channels::web::auth::MultiAuthState::single(
-            "test-token".to_string(),
-            "test".to_string(),
-        ));
+        let auth = MultiAuthState::single("test-token".to_string(), "test".to_string());
         let bound = start_server(addr, state.clone(), auth)
             .await
             .expect("server should start");
@@ -3746,6 +3871,284 @@ mod tests {
         );
     }
 
+    #[tokio::test]
+    async fn test_oauth_callback_accepts_versioned_hosted_state_without_instance_name() {
+        use axum::body::Body;
+        use tower::ServiceExt;
+
+        let secrets: Arc<dyn crate::secrets::SecretsStore + Send + Sync> =
+            Arc::new(crate::secrets::InMemorySecretsStore::new(Arc::new(
+                crate::secrets::SecretsCrypto::new(secrecy::SecretString::from(
+                    TEST_GATEWAY_CRYPTO_KEY.to_string(),
+                ))
+                .expect("crypto"),
+            )));
+        let (ext_mgr, _wasm_tools_dir, _wasm_channels_dir) = test_ext_mgr(secrets.clone());
+
+        let Some(created_at) = expired_flow_created_at() else {
+            eprintln!(
+                "Skipping versioned OAuth state without instance test: monotonic uptime below expiry window"
+            );
+            return;
+        };
+        let flow = crate::cli::oauth_defaults::PendingOAuthFlow {
+            extension_name: "test_tool".to_string(),
+            display_name: "Test Tool".to_string(),
+            token_url: "https://example.com/token".to_string(),
+            client_id: "client123".to_string(),
+            client_secret: None,
+            redirect_uri: "https://example.com/oauth/callback".to_string(),
+            code_verifier: None,
+            access_token_field: "access_token".to_string(),
+            secret_name: "test_token".to_string(),
+            provider: None,
+            validation_endpoint: None,
+            scopes: vec![],
+            user_id: "test".to_string(),
+            secrets,
+            sse_manager: None,
+            gateway_token: None,
+            token_exchange_extra_params: std::collections::HashMap::new(),
+            client_id_secret_name: None,
+            created_at,
+        };
+
+        ext_mgr
+            .pending_oauth_flows()
+            .write()
+            .await
+            .insert("test_nonce".to_string(), flow);
+
+        let state = test_gateway_state(Some(ext_mgr.clone()));
+        let app = test_oauth_router(state);
+        let versioned_state =
+            crate::cli::oauth_defaults::encode_hosted_oauth_state("test_nonce", None);
+
+        let req = axum::http::Request::builder()
+            .uri(format!(
+                "/oauth/callback?code=fake_code&state={}",
+                urlencoding::encode(&versioned_state)
+            ))
+            .body(Body::empty())
+            .expect("request");
+
+        let resp = ServiceExt::<axum::http::Request<Body>>::oneshot(app, req)
+            .await
+            .expect("response");
+        assert_eq!(resp.status(), StatusCode::OK);
+
+        let body = axum::body::to_bytes(resp.into_body(), 1024 * 64)
+            .await
+            .expect("body");
+        let html = String::from_utf8_lossy(&body);
+        assert!(html.contains("Authorization Failed"));
+        assert!(
+            ext_mgr
+                .pending_oauth_flows()
+                .read()
+                .await
+                .get("test_nonce")
+                .is_none()
+        );
+    }
+
+    #[allow(clippy::await_holding_lock)]
+    #[tokio::test]
+    async fn test_oauth_callback_happy_path_with_gateway_token_fallback() {
+        use axum::body::Body;
+        use tower::ServiceExt;
+
+        let proxy = MockOauthProxyServer::start().await;
+        // Keep the process-wide env locked for the full callback so the handler
+        // sees a stable proxy URL/token configuration throughout the test.
+        let _env_guard = crate::config::helpers::lock_env();
+        let _exchange_url_guard =
+            set_env_var("IRONCLAW_OAUTH_EXCHANGE_URL", Some(&proxy.base_url()));
+        let _proxy_auth_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", None);
+        let _gateway_token_guard = set_env_var("GATEWAY_AUTH_TOKEN", Some("gateway-test-token"));
+
+        let secrets = test_secrets_store();
+        let (ext_mgr, _wasm_tools_dir, _wasm_channels_dir) = test_ext_mgr(Arc::clone(&secrets));
+        let sse_mgr = Arc::new(SseManager::new());
+        let mut receiver = sse_mgr.sender().subscribe();
+        let flow = fresh_pending_oauth_flow(
+            Arc::clone(&secrets),
+            Some(Arc::clone(&sse_mgr)),
+            crate::cli::oauth_defaults::oauth_proxy_auth_token(),
+        );
+
+        ext_mgr
+            .pending_oauth_flows()
+            .write()
+            .await
+            .insert("test_nonce".to_string(), flow);
+
+        let state = test_gateway_state(Some(ext_mgr.clone()));
+        let app = test_oauth_router(state);
+        let versioned_state =
+            crate::cli::oauth_defaults::encode_hosted_oauth_state("test_nonce", Some("myinstance"));
+
+        let req = axum::http::Request::builder()
+            .uri(format!(
+                "/oauth/callback?code=fake_code&state={}",
+                urlencoding::encode(&versioned_state)
+            ))
+            .body(Body::empty())
+            .expect("request");
+
+        let resp = ServiceExt::<axum::http::Request<Body>>::oneshot(app, req)
+            .await
+            .expect("response");
+        assert_eq!(resp.status(), StatusCode::OK);
+
+        let body = axum::body::to_bytes(resp.into_body(), 1024 * 64)
+            .await
+            .expect("body");
+        let html = String::from_utf8_lossy(&body);
+        assert!(html.contains("Test Tool Connected"));
+
+        let requests = proxy.requests().await;
+        assert_eq!(requests.len(), 1);
+        assert_eq!(
+            requests[0].authorization.as_deref(),
+            Some("Bearer gateway-test-token")
+        );
+        assert_eq!(
+            requests[0].form.get("code").map(String::as_str),
+            Some("fake_code")
+        );
+        assert_eq!(
+            requests[0].form.get("code_verifier").map(String::as_str),
+            Some("test-code-verifier")
+        );
+
+        let access_token = secrets
+            .get_decrypted("test", "test_token")
+            .await
+            .expect("access token stored");
+        assert_eq!(access_token.expose(), "proxy-access-token");
+
+        let refresh_token = secrets
+            .get_decrypted("test", "test_token_refresh_token")
+            .await
+            .expect("refresh token stored");
+        assert_eq!(refresh_token.expose(), "proxy-refresh-token");
+
+        match receiver.recv().await.expect("auth_completed event").event {
+            crate::channels::web::types::AppEvent::AuthCompleted {
+                extension_name,
+                success,
+                ..
+            } => {
+                assert_eq!(extension_name, "test_tool");
+                assert!(success, "OAuth callback should broadcast success");
+            }
+            event => panic!("expected AuthCompleted event, got {event:?}"),
+        }
+
+        proxy.shutdown().await;
+    }
+
+    #[allow(clippy::await_holding_lock)]
+    #[tokio::test]
+    async fn test_oauth_callback_happy_path_with_dedicated_proxy_auth_token() {
+        use axum::body::Body;
+        use tower::ServiceExt;
+
+        let proxy = MockOauthProxyServer::start().await;
+        // Keep the process-wide env locked for the full callback so the handler
+        // sees a stable proxy URL/token configuration throughout the test.
+        let _env_guard = crate::config::helpers::lock_env();
+        let _exchange_url_guard =
+            set_env_var("IRONCLAW_OAUTH_EXCHANGE_URL", Some(&proxy.base_url()));
+        let _proxy_auth_guard = set_env_var(
+            "IRONCLAW_OAUTH_PROXY_AUTH_TOKEN",
+            Some("shared-oauth-proxy-secret"),
+        );
+        let _gateway_token_guard = set_env_var("GATEWAY_AUTH_TOKEN", None);
+
+        let secrets = test_secrets_store();
+        let (ext_mgr, _wasm_tools_dir, _wasm_channels_dir) = test_ext_mgr(Arc::clone(&secrets));
+        let sse_mgr = Arc::new(SseManager::new());
+        let mut receiver = sse_mgr.sender().subscribe();
+        let flow = fresh_pending_oauth_flow(
+            Arc::clone(&secrets),
+            Some(Arc::clone(&sse_mgr)),
+            crate::cli::oauth_defaults::oauth_proxy_auth_token(),
+        );
+
+        ext_mgr
+            .pending_oauth_flows()
+            .write()
+            .await
+            .insert("test_nonce".to_string(), flow);
+
+        let state = test_gateway_state(Some(ext_mgr.clone()));
+        let app = test_oauth_router(state);
+        let versioned_state =
+            crate::cli::oauth_defaults::encode_hosted_oauth_state("test_nonce", None);
+
+        let req = axum::http::Request::builder()
+            .uri(format!(
+                "/oauth/callback?code=fake_code&state={}",
+                urlencoding::encode(&versioned_state)
+            ))
+            .body(Body::empty())
+            .expect("request");
+
+        let resp = ServiceExt::<axum::http::Request<Body>>::oneshot(app, req)
+            .await
+            .expect("response");
+        assert_eq!(resp.status(), StatusCode::OK);
+
+        let body = axum::body::to_bytes(resp.into_body(), 1024 * 64)
+            .await
+            .expect("body");
+        let html = String::from_utf8_lossy(&body);
+        assert!(html.contains("Test Tool Connected"));
+
+        let requests = proxy.requests().await;
+        assert_eq!(requests.len(), 1);
+        assert_eq!(
+            requests[0].authorization.as_deref(),
+            Some("Bearer shared-oauth-proxy-secret")
+        );
+        assert_eq!(
+            requests[0].form.get("code").map(String::as_str),
+            Some("fake_code")
+        );
+        assert_eq!(
+            requests[0].form.get("code_verifier").map(String::as_str),
+            Some("test-code-verifier")
+        );
+
+        let access_token = secrets
+            .get_decrypted("test", "test_token")
+            .await
+            .expect("access token stored");
+        assert_eq!(access_token.expose(), "proxy-access-token");
+
+        let refresh_token = secrets
+            .get_decrypted("test", "test_token_refresh_token")
+            .await
+            .expect("refresh token stored");
+        assert_eq!(refresh_token.expose(), "proxy-refresh-token");
+
+        match receiver.recv().await.expect("auth_completed event").event {
+            crate::channels::web::types::AppEvent::AuthCompleted {
+                extension_name,
+                success,
+                ..
+            } => {
+                assert_eq!(extension_name, "test_tool");
+                assert!(success, "OAuth callback should broadcast success");
+            }
+            event => panic!("expected AuthCompleted event, got {event:?}"),
+        }
+
+        proxy.shutdown().await;
+    }
+
     // --- Slack relay OAuth CSRF tests ---
 
     fn test_relay_oauth_router(state: Arc<GatewayState>) -> Router {
@@ -3777,6 +4180,8 @@ mod tests {
         let ext_mgr = Arc::new(ExtensionManager::new(
             mcp_sm,
             mcp_pm,
+            None,
+            None,
             secrets,
             tool_registry,
             None,
@@ -3786,6 +4191,7 @@ mod tests {
             None,
             "test".to_string(),
             None,
+            None,
             vec![],
         ));
         (ext_mgr, wasm_tools_dir, wasm_channels_dir)

src/channels/web/static/app.js

@@ -186,13 +186,6 @@ function authenticate() {
       connectSSE();
       connectLogSSE();
       startGatewayStatusPolling();
-      // Hide the Users settings tab for non-admin users.
-      apiFetch('/api/profile').then(function(profile) {
-        if (profile && profile.role !== 'admin') {
-          var usersTab = document.querySelector('[data-settings-subtab="users"]');
-          if (usersTab) usersTab.style.display = 'none';
-        }
-      }).catch(function() {});
       checkTeeStatus();
       loadThreads();
       loadMemoryTree();
@@ -1167,7 +1160,7 @@ function addToolCard(name) {
 
   const toolName = document.createElement('span');
   toolName.className = 'activity-tool-name';
-  toolName.textContent = name;
+  toolName.textContent = humanizeToolName(name);
 
   const duration = document.createElement('span');
   duration.className = 'activity-tool-duration';
@@ -1351,7 +1344,7 @@ function finalizeActivityGroup() {
 
 function humanizeToolName(rawName) {
   if (!rawName) return '';
-  return String(rawName)
+  return stripDerivedCompanionToolPrefix(String(rawName))
     .replace(/[_-]+/g, ' ')
     .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
     .replace(/^tool([a-zA-Z])/, 'tool $1')
@@ -1359,6 +1352,12 @@ function humanizeToolName(rawName) {
     .trim();
 }
 
+function stripDerivedCompanionToolPrefix(rawName) {
+  if (!rawName) return '';
+  const prefix = '_nearai_companion_mcp_';
+  return rawName.startsWith(prefix) ? rawName.slice(prefix.length) : rawName;
+}
+
 function shouldShowChannelConnectedMessage(extensionName, success) {
   if (!success || !extensionName) return false;
   return String(extensionName).toLowerCase().includes('telegram');
@@ -1878,7 +1877,7 @@ function createToolCallsSummaryElement(toolCalls) {
     const icon = tc.has_error ? '\u2717' : '\u2713';
     const nameSpan = document.createElement('span');
     nameSpan.className = 'tool-call-name';
-    nameSpan.textContent = icon + ' ' + tc.name;
+    nameSpan.textContent = icon + ' ' + humanizeToolName(tc.name);
     item.appendChild(nameSpan);
 
     if (tc.result_preview) {
@@ -2913,7 +2912,12 @@ function renderExtensionCard(ext) {
   if (ext.tools && ext.tools.length > 0) {
     const tools = document.createElement('div');
     tools.className = 'ext-tools';
-    tools.textContent = 'Tools: ' + ext.tools.join(', ');
+    const toolNames = ext.tools.map((toolName) => (
+      ext.derived && ext.kind === 'mcp_server'
+        ? stripDerivedCompanionToolPrefix(toolName)
+        : toolName
+    ));
+    tools.textContent = 'Tools: ' + toolNames.join(', ');
     card.appendChild(tools);
   }
 
@@ -2974,7 +2978,7 @@ function renderExtensionCard(ext) {
     // Skip when has_auth is true but needs_setup is false and not yet authenticated —
     // this means OAuth credentials resolve automatically (builtin/env) and the user
     // just needs to complete the OAuth flow, not fill in a config form.
-    if (ext.needs_setup || (ext.has_auth && ext.authenticated)) {
+    if (!ext.derived && (ext.needs_setup || (ext.has_auth && ext.authenticated))) {
       const configBtn = document.createElement('button');
       configBtn.className = 'btn-ext configure';
       configBtn.textContent = ext.authenticated ? I18n.t('ext.reconfigure') : I18n.t('ext.configure');
@@ -2983,11 +2987,13 @@ function renderExtensionCard(ext) {
     }
   }
 
-  const removeBtn = document.createElement('button');
-  removeBtn.className = 'btn-ext remove';
-  removeBtn.textContent = I18n.t('ext.remove');
-  removeBtn.addEventListener('click', () => removeExtension(ext.name));
-  actions.appendChild(removeBtn);
+  if (!ext.derived) {
+    const removeBtn = document.createElement('button');
+    removeBtn.className = 'btn-ext remove';
+    removeBtn.textContent = I18n.t('ext.remove');
+    removeBtn.addEventListener('click', () => removeExtension(ext.name));
+    actions.appendChild(removeBtn);
+  }
 
   card.appendChild(actions);
 
@@ -4346,142 +4352,6 @@ function formatRelativeTime(isoString) {
   return future ? I18n.t('time.daysFromNow', { n: days }) : I18n.t('time.daysAgo', { n: days });
 }
 
-// --- Users (admin) ---
-
-function loadUsers() {
-  apiFetch('/api/admin/users').then(function(data) {
-    renderUsersList(data.users || []);
-  }).catch(function(err) {
-    // Non-admin users get 403 — show a message instead of an error
-    var tbody = document.getElementById('users-tbody');
-    var empty = document.getElementById('users-empty');
-    if (tbody) tbody.innerHTML = '';
-    if (empty) {
-      empty.style.display = 'block';
-      empty.textContent = 'Admin access required to manage users.';
-    }
-  });
-}
-
-function renderUsersList(users) {
-  var tbody = document.getElementById('users-tbody');
-  var empty = document.getElementById('users-empty');
-  if (!users || users.length === 0) {
-    tbody.innerHTML = '';
-    empty.style.display = 'block';
-    empty.textContent = 'No users found. Create the first user to get started.';
-    return;
-  }
-  empty.style.display = 'none';
-  tbody.innerHTML = users.map(function(u) {
-    var statusClass = u.status === 'active' ? 'active' : 'failed';
-    var roleLabel = u.role === 'admin' ? '<span class="badge badge-admin">admin</span>' : '<span class="badge">member</span>';
-    var actions = '';
-    if (u.status === 'active') {
-      actions += '<button class="btn-small btn-danger" data-action="suspend-user" data-user-id="' + escapeHtml(u.id) + '">Suspend</button> ';
-    } else {
-      actions += '<button class="btn-small btn-primary" data-action="activate-user" data-user-id="' + escapeHtml(u.id) + '">Activate</button> ';
-    }
-    actions += '<button class="btn-small" data-action="create-token" data-user-id="' + escapeHtml(u.id) + '" data-user-name="' + escapeHtml(u.display_name) + '">+ Token</button>';
-    return '<tr>'
-      + '<td class="user-id" title="' + escapeHtml(u.id) + '">' + escapeHtml(u.id.substring(0, 8)) + '…</td>'
-      + '<td>' + escapeHtml(u.display_name) + '</td>'
-      + '<td>' + escapeHtml(u.email || '—') + '</td>'
-      + '<td>' + roleLabel + '</td>'
-      + '<td><span class="status-badge ' + statusClass + '">' + escapeHtml(u.status) + '</span></td>'
-      + '<td>' + formatRelativeTime(u.created_at) + '</td>'
-      + '<td>' + actions + '</td>'
-      + '</tr>';
-  }).join('');
-}
-
-function suspendUser(userId) {
-  apiFetch('/api/admin/users/' + userId + '/suspend', { method: 'POST' })
-    .then(function() { loadUsers(); })
-    .catch(function(e) { alert('Failed to suspend user: ' + e.message); });
-}
-
-function activateUser(userId) {
-  apiFetch('/api/admin/users/' + userId + '/activate', { method: 'POST' })
-    .then(function() { loadUsers(); })
-    .catch(function(e) { alert('Failed to activate user: ' + e.message); });
-}
-
-function createTokenForUser(userId, displayName) {
-  var tokenName = prompt('Token name for ' + displayName + ':', 'api-token');
-  if (!tokenName) return;
-  apiFetch('/api/tokens', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ name: tokenName, user_id: userId }),
-  }).then(function(data) {
-    showTokenBanner(data.token);
-  }).catch(function(e) { alert('Failed to create token: ' + e.message); });
-}
-
-function showTokenBanner(tokenValue) {
-  var banner = document.getElementById('users-token-result');
-  if (!banner) return;
-  var loginUrl = window.location.origin + '/?token=' + encodeURIComponent(tokenValue);
-  banner.style.display = 'block';
-  banner.innerHTML = '<strong>User created!</strong> Share this login link — it won\'t be shown again:<br>'
-    + '<code class="token-display" id="token-copy-value">' + escapeHtml(loginUrl) + '</code>'
-    + '<button class="btn-small" id="token-copy-link">Copy Link</button>'
-    + '<br><span style="font-size:0.8em;color:var(--text-muted)">Raw token: ' + escapeHtml(tokenValue) + '</span>';
-  document.getElementById('token-copy-link').addEventListener('click', function() {
-    navigator.clipboard.writeText(loginUrl);
-    this.textContent = 'Copied!';
-  });
-}
-
-// Delegated click handler for user action buttons (CSP-safe, no inline onclick)
-document.getElementById('users-table')?.addEventListener('click', function(e) {
-  var btn = e.target.closest('[data-action]');
-  if (!btn) return;
-  var action = btn.getAttribute('data-action');
-  var userId = btn.getAttribute('data-user-id');
-  var userName = btn.getAttribute('data-user-name');
-  if (action === 'suspend-user') suspendUser(userId);
-  else if (action === 'activate-user') activateUser(userId);
-  else if (action === 'create-token') createTokenForUser(userId, userName || '');
-});
-
-// Wire up Users tab create form
-document.getElementById('users-create-btn')?.addEventListener('click', function() {
-  document.getElementById('users-create-form').style.display = 'flex';
-  document.getElementById('users-token-result').style.display = 'none';
-  document.getElementById('user-display-name').focus();
-});
-
-document.getElementById('users-create-cancel')?.addEventListener('click', function() {
-  document.getElementById('users-create-form').style.display = 'none';
-});
-
-document.getElementById('users-create-submit')?.addEventListener('click', function() {
-  var displayName = document.getElementById('user-display-name').value.trim();
-  var email = document.getElementById('user-email').value.trim();
-  var role = document.getElementById('user-role').value;
-  if (!displayName) { alert('Display name is required'); return; }
-
-  apiFetch('/api/admin/users', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({
-      display_name: displayName,
-      email: email || undefined,
-      role: role,
-    }),
-  }).then(function(data) {
-    document.getElementById('users-create-form').style.display = 'none';
-    document.getElementById('user-display-name').value = '';
-    document.getElementById('user-email').value = '';
-    if (data.token) {
-      showTokenBanner(data.token);
-    }
-    loadUsers();
-  }).catch(function(e) { alert('Failed to create user: ' + e.message); });
-});
-
 // --- Gateway status widget ---
 
 let gatewayStatusInterval = null;
@@ -5171,7 +5041,6 @@ function loadSettingsSubtab(subtab) {
   else if (subtab === 'extensions') { loadExtensions(); startPairingPoll(); }
   else if (subtab === 'mcp') loadMcpServers();
   else if (subtab === 'skills') loadSkills();
-  else if (subtab === 'users') loadUsers();
   if (subtab !== 'extensions' && subtab !== 'channels') stopPairingPoll();
 }
 

src/channels/web/static/i18n/en.js

@@ -9,6 +9,8 @@ I18n.register('en', {
   'auth.connect': 'Connect',
   'auth.errorRequired': 'Token required',
   'auth.errorInvalid': 'Invalid token',
+  'auth.hint': 'Enter the GATEWAY_AUTH_TOKEN from your .env file',
+  
   // Chat
   'chat.inputPlaceholder': 'Message or / for commands...',
   
@@ -42,8 +44,7 @@ I18n.register('en', {
   'settings.channels': 'Channels',
   'settings.networking': 'Networking',
   'settings.mcp': 'MCP',
-  'settings.users': 'Users',
-
+  
   // Status
   'status.connected': 'Connected',
   'status.disconnected': 'Disconnected',

src/channels/web/static/i18n/zh-CN.js

@@ -9,6 +9,8 @@ I18n.register('zh-CN', {
   'auth.connect': '连接',
   'auth.errorRequired': '请输入令牌',
   'auth.errorInvalid': '令牌无效',
+  'auth.hint': '输入 .env 配置文件中的 GATEWAY_AUTH_TOKEN',
+  
   // 聊天
   'chat.inputPlaceholder': '输入消息或 / 以使用命令...',
   
@@ -42,8 +44,7 @@ I18n.register('zh-CN', {
   'settings.channels': '频道',
   'settings.networking': '网络',
   'settings.mcp': 'MCP',
-  'settings.users': '用户管理',
-
+  
   // 状态
   'status.connected': '已连接',
   'status.disconnected': '已断开',

src/channels/web/static/index.html

@@ -41,6 +41,7 @@
         <button id="auth-connect-btn" data-i18n="auth.connect">Connect</button>
       </div>
       <div id="auth-error"></div>
+      <p class="auth-hint" data-i18n="auth.hint">Enter the GATEWAY_AUTH_TOKEN from your .env configuration.</p>
     </div>
   </div>
 
@@ -292,7 +293,6 @@
           <button class="settings-subtab" data-settings-subtab="extensions" data-i18n="tab.extensions">Extensions</button>
           <button class="settings-subtab" data-settings-subtab="mcp" data-i18n="settings.mcp">MCP</button>
           <button class="settings-subtab" data-settings-subtab="skills" data-i18n="tab.skills">Skills</button>
-          <button class="settings-subtab" data-settings-subtab="users" data-i18n="settings.users">Users</button>
           <button class="settings-theme-toggle" id="settings-theme-toggle" data-i18n="theme.tooltipSystem" title="Toggle theme">Theme</button>
         </div>
         <div class="settings-content">
@@ -390,29 +390,6 @@
               </div>
             </div>
           </div>
-          <div class="settings-subpanel" id="settings-users">
-            <div class="users-container">
-              <div class="users-header">
-                <h3>User Management</h3>
-                <button id="users-create-btn" class="btn-primary">+ New User</button>
-              </div>
-              <div id="users-create-form" style="display:none" class="users-form" autocomplete="off">
-                <input type="text" id="user-display-name" placeholder="Display name" autocomplete="off" />
-                <input type="text" id="user-email" placeholder="Email (optional)" autocomplete="off" />
-                <select id="user-role"><option value="member">Member</option><option value="admin">Admin</option></select>
-                <button id="users-create-submit" class="btn-primary">Create</button>
-                <button id="users-create-cancel" class="btn-secondary">Cancel</button>
-              </div>
-              <div id="users-token-result" style="display:none" class="users-token-banner"></div>
-              <table class="routines-table" id="users-table">
-                <thead><tr>
-                  <th>ID</th><th>Display Name</th><th>Email</th><th>Role</th><th>Status</th><th>Created</th><th>Actions</th>
-                </tr></thead>
-                <tbody id="users-tbody"></tbody>
-              </table>
-              <div id="users-empty" class="empty-state" style="display:none">No users found. Create the first user to get started.</div>
-            </div>
-          </div>
         </div>
       </div>
     </div>

src/channels/web/static/style.css

@@ -5429,22 +5429,3 @@ body.theme-transition *:not(svg):not(path):not(line):not(circle):not(rect) {
     --text-muted: #a1a1aa;
   }
 }
-
-/* --- Users Tab --- */
-.users-container { padding: 1rem; }
-.users-header { display: flex; align-items: center; justify-content: space-between; margin-bottom: 1rem; }
-.users-header h3 { margin: 0; font-size: 1.1rem; }
-.users-form { display: flex; gap: 0.5rem; align-items: center; margin-bottom: 1rem; flex-wrap: wrap; }
-.users-form input, .users-form select { padding: 0.4rem 0.6rem; border-radius: 6px; border: 1px solid var(--border); background: var(--bg-secondary); color: var(--text-primary); font-size: 0.85rem; }
-.users-token-banner { background: var(--bg-tertiary); border: 1px solid var(--accent); border-radius: 8px; padding: 0.75rem 1rem; margin-bottom: 1rem; font-size: 0.85rem; }
-.token-display { display: inline-block; padding: 0.3rem 0.6rem; background: var(--bg-primary); border-radius: 4px; font-family: var(--font-mono); word-break: break-all; margin: 0.4rem 0; user-select: all; }
-.user-id { font-family: var(--font-mono); font-size: 0.8rem; color: var(--text-muted); }
-.badge { display: inline-block; padding: 0.15rem 0.5rem; border-radius: 10px; font-size: 0.75rem; background: var(--bg-tertiary); color: var(--text-secondary); }
-.badge-admin { background: var(--accent); color: #fff; }
-.btn-small { padding: 0.25rem 0.5rem; font-size: 0.75rem; border-radius: 4px; border: 1px solid var(--border); background: var(--bg-secondary); color: var(--text-primary); cursor: pointer; }
-.btn-small:hover { background: var(--bg-tertiary); }
-.btn-danger { border-color: #ef4444; color: #ef4444; }
-.btn-danger:hover { background: #ef4444; color: #fff; }
-.btn-primary { background: var(--accent); color: #fff; border: none; padding: 0.4rem 0.8rem; border-radius: 6px; cursor: pointer; font-size: 0.85rem; }
-.btn-primary:hover { opacity: 0.9; }
-.btn-secondary { background: var(--bg-tertiary); color: var(--text-primary); border: 1px solid var(--border); padding: 0.4rem 0.8rem; border-radius: 6px; cursor: pointer; font-size: 0.85rem; }

src/channels/web/test_helpers.rs

@@ -77,6 +77,7 @@ impl TestGatewayBuilder {
             job_manager: None,
             prompt_queue: None,
             owner_id: self.user_id.clone(),
+            default_sender_id: self.user_id,
             shutdown_tx: tokio::sync::RwLock::new(None),
             ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
             llm_provider: self.llm_provider,
@@ -91,7 +92,6 @@ impl TestGatewayBuilder {
             routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
             startup_time: std::time::Instant::now(),
             active_config: crate::channels::web::server::ActiveConfigSnapshot::default(),
-            secrets_store: None,
         })
     }
 
@@ -106,7 +106,7 @@ impl TestGatewayBuilder {
         let addr: SocketAddr = "127.0.0.1:0"
             .parse()
             .expect("hard-coded address must parse"); // safety: constant literal
-        let bound = start_server(addr, state.clone(), auth.into()).await?;
+        let bound = start_server(addr, state.clone(), auth).await?;
         Ok((bound, state))
     }
 
@@ -120,7 +120,7 @@ impl TestGatewayBuilder {
         let addr: SocketAddr = "127.0.0.1:0"
             .parse()
             .expect("hard-coded address must parse"); // safety: constant literal
-        let bound = start_server(addr, state.clone(), auth.into()).await?;
+        let bound = start_server(addr, state.clone(), auth).await?;
         Ok((bound, state))
     }
 }

src/channels/web/tests/multi_tenant.rs

@@ -16,6 +16,7 @@ use axum::routing::{delete, get, post};
 use tower::ServiceExt;
 use uuid::Uuid;
 
+use crate::channels::web::GatewayChannel;
 use crate::channels::web::auth::{
     AuthenticatedUser, MultiAuthState, UserIdentity, auth_middleware,
 };
@@ -23,6 +24,7 @@ use crate::channels::web::server::{
     ActiveConfigSnapshot, GatewayState, PerUserRateLimiter, PromptQueue, RateLimiter, WorkspacePool,
 };
 use crate::channels::web::sse::SseManager;
+use crate::config::GatewayConfig;
 
 // ── Helpers ────────────────────────────────────────────────────────────
 
@@ -33,7 +35,6 @@ fn two_user_auth() -> MultiAuthState {
         "tok-alice".to_string(),
         UserIdentity {
             user_id: "alice".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec!["shared".to_string()],
         },
     );
@@ -41,7 +42,6 @@ fn two_user_auth() -> MultiAuthState {
         "tok-bob".to_string(),
         UserIdentity {
             user_id: "bob".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec!["shared".to_string(), "alice".to_string()],
         },
     );
@@ -67,6 +67,7 @@ fn build_state(
         job_manager: None,
         prompt_queue,
         owner_id: "test".to_string(),
+        default_sender_id: "test".to_string(),
         shutdown_tx: tokio::sync::RwLock::new(None),
         ws_tracker: None,
         llm_provider: None,
@@ -81,10 +82,43 @@ fn build_state(
         routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
         startup_time: std::time::Instant::now(),
         active_config: ActiveConfigSnapshot::default(),
-        secrets_store: None,
     })
 }
 
+fn gateway_config() -> GatewayConfig {
+    GatewayConfig {
+        host: "127.0.0.1".to_string(),
+        port: 3000,
+        auth_token: Some("gateway-auth".to_string()),
+        user_id: "gateway-sender".to_string(),
+        workspace_read_scopes: Vec::new(),
+        memory_layers: Vec::new(),
+        user_tokens: None,
+    }
+}
+
+#[test]
+fn with_owner_scope_updates_gateway_owner_scope_in_multi_user_mode() {
+    let mut gateway = GatewayChannel::new(gateway_config());
+    gateway.auth = two_user_auth();
+    gateway.config.user_tokens = Some(HashMap::new());
+    let gateway = gateway.with_owner_scope("owner-scope");
+
+    assert_eq!(gateway.state.owner_id, "owner-scope");
+    assert_eq!(gateway.state.default_sender_id, "gateway-sender");
+
+    let alice = gateway
+        .auth
+        .authenticate("tok-alice")
+        .expect("alice token should remain valid");
+    let bob = gateway
+        .auth
+        .authenticate("tok-bob")
+        .expect("bob token should remain valid");
+    assert_eq!(alice.user_id, "alice");
+    assert_eq!(bob.user_id, "bob");
+}
+
 /// Create a libSQL-backed test database in a temporary directory.
 ///
 /// Returns the database and a `TempDir` guard — the database file is
@@ -191,7 +225,6 @@ mod workspace_pool {
         );
         let identity = UserIdentity {
             user_id: "alice".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec![],
         };
         let ws = pool.get_or_create(&identity).await;
@@ -220,7 +253,6 @@ mod workspace_pool {
         );
         let identity = UserIdentity {
             user_id: "alice".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec![],
         };
         let ws = pool.get_or_create(&identity).await;
@@ -244,7 +276,6 @@ mod workspace_pool {
         );
         let identity = UserIdentity {
             user_id: "bob".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec!["alice".to_string(), "shared".to_string()],
         };
         let ws = pool.get_or_create(&identity).await;
@@ -271,12 +302,10 @@ mod workspace_pool {
         );
         let alice_id = UserIdentity {
             user_id: "alice".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec![],
         };
         let bob_id = UserIdentity {
             user_id: "bob".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec![],
         };
 
@@ -308,7 +337,6 @@ mod workspace_pool {
         );
         let identity = UserIdentity {
             user_id: "alice".to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec!["token-scope".to_string()],
         };
         let ws = pool.get_or_create(&identity).await;
@@ -349,10 +377,7 @@ mod jobs_isolation {
             .route("/api/jobs/{id}/cancel", post(jobs_cancel_handler))
             .route("/api/jobs/{id}/restart", post(jobs_restart_handler))
             .route("/api/jobs/{id}/prompt", post(jobs_prompt_handler))
-            .layer(middleware::from_fn_with_state(
-                crate::channels::web::auth::CombinedAuthState::from(auth),
-                auth_middleware,
-            ))
+            .layer(middleware::from_fn_with_state(auth, auth_middleware))
             .with_state(state)
     }
 
@@ -558,10 +583,7 @@ mod routines_isolation {
             .route("/api/routines/{id}", get(routines_detail_handler))
             .route("/api/routines/{id}/toggle", post(routines_toggle_handler))
             .route("/api/routines/{id}", delete(routines_delete_handler))
-            .layer(middleware::from_fn_with_state(
-                crate::channels::web::auth::CombinedAuthState::from(auth),
-                auth_middleware,
-            ))
+            .layer(middleware::from_fn_with_state(auth, auth_middleware))
             .with_state(state)
     }
 
@@ -686,10 +708,7 @@ mod auth_enforcement {
             .route("/api/logs/level", get(authed_handler).put(authed_handler))
             // Gateway status
             .route("/api/gateway/status", get(authed_handler))
-            .layer(middleware::from_fn_with_state(
-                crate::channels::web::auth::CombinedAuthState::from(auth),
-                auth_middleware,
-            ))
+            .layer(middleware::from_fn_with_state(auth, auth_middleware))
             .with_state(state)
     }
 
@@ -812,140 +831,3 @@ mod auth_enforcement {
         assert_eq!(resp.status(), StatusCode::UNAUTHORIZED);
     }
 }
-
-// ═══════════════════════════════════════════════════════════════════════
-// Admin Endpoint Role Enforcement Tests
-// ═══════════════════════════════════════════════════════════════════════
-
-mod admin_role_enforcement {
-    use super::*;
-    use crate::channels::web::handlers::users::{
-        users_activate_handler, users_detail_handler, users_list_handler, users_suspend_handler,
-        users_update_handler,
-    };
-    use axum::routing::patch;
-
-    /// Build a router with admin user endpoints behind multi-user auth.
-    /// Uses a member-role token and an admin-role token.
-    fn admin_router() -> Router {
-        let mut tokens = HashMap::new();
-        tokens.insert(
-            "tok-admin".to_string(),
-            UserIdentity {
-                user_id: "admin-user".to_string(),
-                role: "admin".to_string(),
-                workspace_read_scopes: vec![],
-            },
-        );
-        tokens.insert(
-            "tok-member".to_string(),
-            UserIdentity {
-                user_id: "member-user".to_string(),
-                role: "member".to_string(),
-                workspace_read_scopes: vec![],
-            },
-        );
-        let auth = MultiAuthState::multi(tokens);
-        let state = build_state(None, None);
-
-        Router::new()
-            .route("/api/admin/users", get(users_list_handler))
-            .route("/api/admin/users/{id}", get(users_detail_handler))
-            .route("/api/admin/users/{id}", patch(users_update_handler))
-            .route("/api/admin/users/{id}/suspend", post(users_suspend_handler))
-            .route(
-                "/api/admin/users/{id}/activate",
-                post(users_activate_handler),
-            )
-            .layer(middleware::from_fn_with_state(
-                crate::channels::web::auth::CombinedAuthState::from(auth),
-                auth_middleware,
-            ))
-            .with_state(state)
-    }
-
-    /// Assert a request returns FORBIDDEN for a member token.
-    async fn assert_forbidden_for_member(app: &Router, method: Method, uri: &str) {
-        let req = Request::builder()
-            .method(method)
-            .uri(uri)
-            .header("Authorization", "Bearer tok-member")
-            .body(Body::empty())
-            .unwrap();
-        let resp = app.clone().oneshot(req).await.unwrap();
-        assert_eq!(
-            resp.status(),
-            StatusCode::FORBIDDEN,
-            "expected 403 for member on {}",
-            uri
-        );
-    }
-
-    #[tokio::test]
-    async fn test_admin_user_endpoints_reject_member_role() {
-        let app = admin_router();
-
-        assert_forbidden_for_member(&app, Method::GET, "/api/admin/users").await;
-        assert_forbidden_for_member(&app, Method::GET, "/api/admin/users/some-id").await;
-        assert_forbidden_for_member(&app, Method::POST, "/api/admin/users/some-id/suspend").await;
-        assert_forbidden_for_member(&app, Method::POST, "/api/admin/users/some-id/activate").await;
-    }
-
-    #[tokio::test]
-    async fn test_admin_user_endpoints_accept_admin_role() {
-        let app = admin_router();
-
-        // Admin token should pass auth (will get 503 since no DB, but not 403).
-        let req = Request::builder()
-            .uri("/api/admin/users")
-            .header("Authorization", "Bearer tok-admin")
-            .body(Body::empty())
-            .unwrap();
-        let resp = app.clone().oneshot(req).await.unwrap();
-        assert_ne!(
-            resp.status(),
-            StatusCode::FORBIDDEN,
-            "admin should not get 403"
-        );
-    }
-}
-
-// ═══════════════════════════════════════════════════════════════════════
-// DbAuthenticator Cache Bounded Tests
-// ═══════════════════════════════════════════════════════════════════════
-
-mod db_auth_cache {
-    use super::*;
-    use std::time::Instant;
-
-    #[tokio::test]
-    async fn test_cache_bounded_by_max_entries() {
-        // Access the internal cache and verify LRU eviction.
-        // We can't easily test through `authenticate()` since it hits the DB,
-        // so we test the LRU cache directly.
-        let cap = std::num::NonZeroUsize::new(4).unwrap(); // safety: test-only, 4 is non-zero
-        let cache: lru::LruCache<[u8; 32], (UserIdentity, Instant)> = lru::LruCache::new(cap);
-        let cache = Arc::new(tokio::sync::RwLock::new(cache));
-
-        {
-            let mut c = cache.write().await;
-            for i in 0..10u8 {
-                let mut hash = [0u8; 32];
-                hash[0] = i;
-                c.put(
-                    hash,
-                    (
-                        UserIdentity {
-                            user_id: format!("user-{i}"),
-                            role: "member".to_string(),
-                            workspace_read_scopes: vec![],
-                        },
-                        Instant::now(),
-                    ),
-                );
-            }
-            // Cache must be bounded at capacity, not grown to 10.
-            assert_eq!(c.len(), 4, "cache should be bounded to capacity"); // safety: test assertion
-        }
-    }
-}

src/channels/web/types.rs

@@ -344,6 +344,9 @@ pub struct ExtensionInfo {
     /// Whether this extension has an auth configuration (OAuth or manual token).
     #[serde(default)]
     pub has_auth: bool,
+    /// Whether this extension is derived from runtime/provider state.
+    #[serde(default)]
+    pub derived: bool,
     /// WASM channel activation status.
     #[serde(skip_serializing_if = "Option::is_none")]
     pub activation_status: Option<ExtensionActivationStatus>,

src/channels/web/ws.rs

@@ -521,6 +521,7 @@ mod tests {
             prompt_queue: None,
             scheduler: None,
             owner_id: "test".to_string(),
+            default_sender_id: "test".to_string(),
             shutdown_tx: tokio::sync::RwLock::new(None),
             ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
             llm_provider: None,
@@ -534,7 +535,6 @@ mod tests {
             routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
             startup_time: std::time::Instant::now(),
             active_config: crate::channels::web::server::ActiveConfigSnapshot::default(),
-            secrets_store: None,
         }
     }
 }

src/cli/mcp.rs

@@ -8,7 +8,7 @@ use std::sync::Arc;
 
 use clap::{Args, Subcommand};
 
-use crate::config::Config;
+use crate::config::{Config, LlmConfig};
 use crate::db::Database;
 use crate::secrets::SecretsStore;
 use crate::tools::mcp::{
@@ -173,6 +173,13 @@ async fn add_server(args: McpAddArgs) -> anyhow::Result<()> {
         description,
     } = args;
 
+    if config::is_nearai_companion_server_name(&name) {
+        anyhow::bail!(
+            "Server name '{}' is reserved for the NEAR AI companion MCP server",
+            name
+        );
+    }
+
     let transport_lower = transport.to_lowercase();
 
     let mut config = match transport_lower.as_str() {
@@ -244,7 +251,7 @@ async fn add_server(args: McpAddArgs) -> anyhow::Result<()> {
 
     // Save (DB if available, else disk)
     let db = connect_db().await;
-    let mut servers = load_servers(db.as_deref()).await?;
+    let mut servers = load_persisted_servers(db.as_deref()).await?;
     servers.upsert(config);
     save_servers(db.as_deref(), &servers).await?;
 
@@ -281,8 +288,15 @@ async fn add_server(args: McpAddArgs) -> anyhow::Result<()> {
 
 /// Remove an MCP server.
 async fn remove_server(name: String) -> anyhow::Result<()> {
+    if config::is_nearai_companion_server_name(&name) {
+        anyhow::bail!(
+            "Server '{}' is derived from the active NEAR AI provider and cannot be removed directly",
+            name
+        );
+    }
+
     let db = connect_db().await;
-    let mut servers = load_servers(db.as_deref()).await?;
+    let mut servers = load_persisted_servers(db.as_deref()).await?;
     if !servers.remove(&name) {
         anyhow::bail!("Server '{}' not found", name);
     }
@@ -298,7 +312,7 @@ async fn remove_server(name: String) -> anyhow::Result<()> {
 /// List configured MCP servers.
 async fn list_servers(verbose: bool) -> anyhow::Result<()> {
     let db = connect_db().await;
-    let servers = load_servers(db.as_deref()).await?;
+    let servers = load_servers_with_derived(db.as_deref()).await?;
 
     if servers.servers.is_empty() {
         println!();
@@ -404,12 +418,23 @@ async fn list_servers(verbose: bool) -> anyhow::Result<()> {
 async fn auth_server(name: String, user_id: String) -> anyhow::Result<()> {
     // Get server config
     let db = connect_db().await;
-    let servers = load_servers(db.as_deref()).await?;
+    let servers = load_servers_with_derived(db.as_deref()).await?;
     let server = servers
         .get(&name)
         .cloned()
         .ok_or_else(|| anyhow::anyhow!("Server '{}' not found", name))?;
 
+    if server.uses_runtime_auth_source() {
+        println!();
+        println!(
+            "  Server '{}' reuses your active NEAR AI authentication and does not support separate MCP OAuth.",
+            name
+        );
+        println!("  Configure NEAR AI auth (API key or session login) instead.");
+        println!();
+        return Ok(());
+    }
+
     // Initialize secrets store
     let secrets = get_secrets_store().await?;
 
@@ -477,7 +502,7 @@ async fn auth_server(name: String, user_id: String) -> anyhow::Result<()> {
 async fn test_server(name: String, user_id: String) -> anyhow::Result<()> {
     // Get server config
     let db = connect_db().await;
-    let servers = load_servers(db.as_deref()).await?;
+    let servers = load_servers_with_derived(db.as_deref()).await?;
     let server = servers
         .get(&name)
         .cloned()
@@ -488,35 +513,66 @@ async fn test_server(name: String, user_id: String) -> anyhow::Result<()> {
 
     // Create client
     let session_manager = Arc::new(McpSessionManager::new());
-
-    // Always check for stored tokens (from either pre-configured OAuth or DCR)
-    let secrets = get_secrets_store().await?;
-    let has_tokens = is_authenticated(&server, &secrets, &user_id).await;
-
-    let client = if has_tokens {
-        // We have stored tokens, use authenticated client
-        McpClient::new_authenticated(server.clone(), session_manager.clone(), secrets, user_id)
-    } else if server.requires_auth() {
-        // OAuth configured but no tokens - need to authenticate
-        println!();
-        println!(
-            "  ✗ Not authenticated. Run 'ironclaw mcp auth {}' first.",
-            name
-        );
-        println!();
-        return Ok(());
-    } else {
-        // Use the factory to dispatch on transport type (HTTP, stdio, unix)
+    let (client, has_tokens) = if server.uses_runtime_auth_source() {
         let process_manager = Arc::new(McpProcessManager::new());
-        create_client_from_config(
-            server.clone(),
-            &session_manager,
-            &process_manager,
-            None,
-            "default",
+        let llm = resolve_llm_for_cli(as_settings_store(db.as_deref())).await?;
+        let nearai_session = crate::llm::create_session_manager(llm.session.clone()).await;
+        (
+            create_client_from_config(
+                server.clone(),
+                &session_manager,
+                Some(nearai_session),
+                llm.nearai.api_key.clone(),
+                &process_manager,
+                None,
+                "default",
+            )
+            .await
+            .map_err(|e| anyhow::anyhow!("{}", e))?,
+            false,
         )
-        .await
-        .map_err(|e| anyhow::anyhow!("{}", e))?
+    } else {
+        // Only initialize the secrets store for non-runtime-auth servers that
+        // can actually use persisted OAuth/DCR tokens.
+        let secrets = get_secrets_store().await?;
+        let has_tokens = is_authenticated(&server, &secrets, &user_id).await;
+
+        if has_tokens {
+            (
+                McpClient::new_authenticated(
+                    server.clone(),
+                    session_manager.clone(),
+                    secrets,
+                    user_id,
+                ),
+                true,
+            )
+        } else if server.requires_auth() {
+            println!();
+            println!(
+                "  ✗ Not authenticated. Run 'ironclaw mcp auth {}' first.",
+                name
+            );
+            println!();
+            return Ok(());
+        } else {
+            // Use the factory to dispatch on transport type (HTTP, stdio, unix)
+            let process_manager = Arc::new(McpProcessManager::new());
+            (
+                create_client_from_config(
+                    server.clone(),
+                    &session_manager,
+                    None,
+                    None,
+                    &process_manager,
+                    None,
+                    "default",
+                )
+                .await
+                .map_err(|e| anyhow::anyhow!("{}", e))?,
+                false,
+            )
+        }
     };
 
     // Test connection
@@ -581,8 +637,15 @@ async fn test_server(name: String, user_id: String) -> anyhow::Result<()> {
 
 /// Toggle server enabled/disabled state.
 async fn toggle_server(name: String, enable: bool, disable: bool) -> anyhow::Result<()> {
+    if config::is_nearai_companion_server_name(&name) {
+        anyhow::bail!(
+            "Server '{}' is derived from the active NEAR AI provider and cannot be toggled directly",
+            name
+        );
+    }
+
     let db = connect_db().await;
-    let mut servers = load_servers(db.as_deref()).await?;
+    let mut servers = load_persisted_servers(db.as_deref()).await?;
 
     let server = servers
         .get_mut(&name)
@@ -615,13 +678,30 @@ async fn connect_db() -> Option<Arc<dyn Database>> {
     crate::db::connect_from_config(&config.database).await.ok()
 }
 
-/// Load MCP servers (DB if available, else disk).
-async fn load_servers(db: Option<&dyn Database>) -> Result<McpServersFile, config::ConfigError> {
-    if let Some(db) = db {
-        config::load_mcp_servers_from_db(db, DEFAULT_USER_ID).await
+/// Load only persisted MCP servers (DB if available, else disk).
+async fn load_persisted_servers(
+    db: Option<&dyn Database>,
+) -> Result<McpServersFile, config::ConfigError> {
+    Ok(if let Some(db) = db {
+        config::load_mcp_servers_from_db(db, DEFAULT_USER_ID).await?
     } else {
-        config::load_mcp_servers().await
+        config::load_mcp_servers().await?
+    })
+}
+
+/// Load MCP servers plus any derived runtime companions.
+async fn load_servers_with_derived(
+    db: Option<&dyn Database>,
+) -> Result<McpServersFile, config::ConfigError> {
+    let mut servers = load_persisted_servers(db).await?;
+
+    if let Ok(llm) = resolve_llm_for_cli(as_settings_store(db)).await
+        && let Some(companion) = config::derive_nearai_companion_mcp_server_from_llm(&llm)
+    {
+        servers.insert_if_absent(companion);
     }
+
+    Ok(servers)
 }
 
 /// Save MCP servers (DB if available, else disk).
@@ -629,10 +709,15 @@ async fn save_servers(
     db: Option<&dyn Database>,
     servers: &McpServersFile,
 ) -> Result<(), config::ConfigError> {
+    let mut persisted = servers.clone();
+    persisted
+        .servers
+        .retain(|server| !config::is_nearai_companion_server_name(&server.name));
+
     if let Some(db) = db {
-        config::save_mcp_servers_to_db(db, DEFAULT_USER_ID, servers).await
+        config::save_mcp_servers_to_db(db, DEFAULT_USER_ID, &persisted).await
     } else {
-        config::save_mcp_servers(servers).await
+        config::save_mcp_servers(&persisted).await
     }
 }
 
@@ -641,10 +726,84 @@ async fn get_secrets_store() -> anyhow::Result<Arc<dyn SecretsStore + Send + Syn
     crate::cli::init_secrets_store().await
 }
 
+fn as_settings_store(db: Option<&dyn Database>) -> Option<&(dyn crate::db::SettingsStore + Sync)> {
+    db.map(|db| db as &(dyn crate::db::SettingsStore + Sync))
+}
+
+async fn resolve_llm_for_cli(
+    store: Option<&(dyn crate::db::SettingsStore + Sync)>,
+) -> Result<LlmConfig, crate::error::ConfigError> {
+    resolve_llm_for_cli_with_toml(store, None).await
+}
+
+async fn resolve_llm_for_cli_with_toml(
+    store: Option<&(dyn crate::db::SettingsStore + Sync)>,
+    toml_path: Option<&std::path::Path>,
+) -> Result<LlmConfig, crate::error::ConfigError> {
+    if let Some(store) = store {
+        let _ = dotenvy::dotenv();
+        crate::bootstrap::load_ironclaw_env();
+
+        let mut settings = match store.get_all_settings(DEFAULT_USER_ID).await {
+            Ok(map) => crate::settings::Settings::from_db_map(&map),
+            Err(e) => {
+                tracing::warn!(
+                    "Failed to load CLI settings from DB, falling back to defaults before env/TOML resolution: {}",
+                    e
+                );
+                crate::settings::Settings::default()
+            }
+        };
+
+        apply_cli_toml_overlay(&mut settings, toml_path)?;
+        return LlmConfig::resolve(&settings);
+    }
+
+    let settings = crate::config::load_bootstrap_settings(toml_path)?;
+    LlmConfig::resolve(&settings)
+}
+
+fn apply_cli_toml_overlay(
+    settings: &mut crate::settings::Settings,
+    explicit_path: Option<&std::path::Path>,
+) -> Result<(), crate::error::ConfigError> {
+    let path = explicit_path
+        .map(std::path::PathBuf::from)
+        .unwrap_or_else(crate::settings::Settings::default_toml_path);
+
+    match crate::settings::Settings::load_toml(&path) {
+        Ok(Some(toml_settings)) => {
+            settings.merge_from(&toml_settings);
+        }
+        Ok(None) => {
+            if explicit_path.is_some() {
+                return Err(crate::error::ConfigError::ParseError(format!(
+                    "Config file not found: {}",
+                    path.display()
+                )));
+            }
+        }
+        Err(e) => {
+            return Err(crate::error::ConfigError::ParseError(e));
+        }
+    }
+
+    Ok(())
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;
 
+    use std::collections::HashMap;
+
+    use async_trait::async_trait;
+
+    use crate::error::DatabaseError;
+    use crate::history::SettingRow;
+    #[cfg(feature = "libsql")]
+    use tempfile::NamedTempFile;
+
     #[test]
     fn test_mcp_command_parsing() {
         // Just verify the command structure is valid
@@ -701,4 +860,129 @@ mod tests {
         assert!(result.is_err());
         assert!(result.unwrap_err().contains("invalid env var format"));
     }
+
+    #[cfg(feature = "libsql")]
+    #[allow(clippy::await_holding_lock)]
+    #[tokio::test]
+    async fn test_resolve_llm_for_cli_uses_db_backed_selected_model() {
+        struct MockSettingsStore {
+            settings: HashMap<String, serde_json::Value>,
+        }
+
+        #[async_trait]
+        impl crate::db::SettingsStore for MockSettingsStore {
+            async fn get_setting(
+                &self,
+                _user_id: &str,
+                key: &str,
+            ) -> Result<Option<serde_json::Value>, DatabaseError> {
+                Ok(self.settings.get(key).cloned())
+            }
+
+            async fn get_setting_full(
+                &self,
+                _user_id: &str,
+                _key: &str,
+            ) -> Result<Option<SettingRow>, DatabaseError> {
+                Ok(None)
+            }
+
+            async fn set_setting(
+                &self,
+                _user_id: &str,
+                _key: &str,
+                _value: &serde_json::Value,
+            ) -> Result<(), DatabaseError> {
+                Err(DatabaseError::Query("unused in test".to_string()))
+            }
+
+            async fn delete_setting(
+                &self,
+                _user_id: &str,
+                _key: &str,
+            ) -> Result<bool, DatabaseError> {
+                Err(DatabaseError::Query("unused in test".to_string()))
+            }
+
+            async fn list_settings(
+                &self,
+                _user_id: &str,
+            ) -> Result<Vec<SettingRow>, DatabaseError> {
+                Ok(Vec::new())
+            }
+
+            async fn get_all_settings(
+                &self,
+                _user_id: &str,
+            ) -> Result<HashMap<String, serde_json::Value>, DatabaseError> {
+                Ok(self.settings.clone())
+            }
+
+            async fn set_all_settings(
+                &self,
+                _user_id: &str,
+                _settings: &HashMap<String, serde_json::Value>,
+            ) -> Result<(), DatabaseError> {
+                Err(DatabaseError::Query("unused in test".to_string()))
+            }
+
+            async fn has_settings(&self, _user_id: &str) -> Result<bool, DatabaseError> {
+                Ok(!self.settings.is_empty())
+            }
+        }
+
+        struct EnvGuard(&'static str, Option<String>);
+
+        impl Drop for EnvGuard {
+            fn drop(&mut self) {
+                // SAFETY: Protected by ENV_MUTEX for the duration of the test.
+                unsafe {
+                    match &self.1 {
+                        Some(value) => std::env::set_var(self.0, value),
+                        None => std::env::remove_var(self.0),
+                    }
+                }
+            }
+        }
+
+        let _mutex = crate::config::helpers::ENV_MUTEX.lock().expect("env mutex");
+        let prev_backend = std::env::var("LLM_BACKEND").ok();
+        let prev_base_url = std::env::var("NEARAI_BASE_URL").ok();
+        let prev_auth_url = std::env::var("NEARAI_AUTH_URL").ok();
+        let prev_model = std::env::var("NEARAI_MODEL").ok();
+
+        // SAFETY: Protected by ENV_MUTEX for the duration of the test.
+        unsafe {
+            std::env::set_var("LLM_BACKEND", "");
+            std::env::set_var("NEARAI_BASE_URL", "http://127.0.0.1:11434/v1");
+            std::env::set_var("NEARAI_AUTH_URL", "http://127.0.0.1:11435");
+            std::env::set_var("NEARAI_MODEL", "");
+        }
+
+        let _backend_guard = EnvGuard("LLM_BACKEND", prev_backend);
+        let _base_url_guard = EnvGuard("NEARAI_BASE_URL", prev_base_url);
+        let _auth_url_guard = EnvGuard("NEARAI_AUTH_URL", prev_auth_url);
+        let _model_guard = EnvGuard("NEARAI_MODEL", prev_model);
+
+        let empty_toml = NamedTempFile::new().expect("temp toml");
+        let store = MockSettingsStore {
+            settings: HashMap::from([
+                ("llm_backend".to_string(), serde_json::json!("nearai")),
+                (
+                    "selected_model".to_string(),
+                    serde_json::json!("db-backed-nearai-model"),
+                ),
+            ]),
+        };
+
+        let llm = resolve_llm_for_cli_with_toml(Some(&store), Some(empty_toml.path()))
+            .await
+            .expect("resolve llm");
+        assert_eq!(llm.backend, "nearai");
+        assert_eq!(llm.nearai.model, "db-backed-nearai-model");
+
+        let companion =
+            config::derive_nearai_companion_mcp_server_from_llm(&llm).expect("derived companion");
+        assert_eq!(companion.url, "http://127.0.0.1:11434/mcp");
+    }
 }

src/cli/mod.rs

@@ -352,8 +352,7 @@ pub async fn run_routines_cli(
         .await
         .map_err(|e| anyhow::anyhow!("{e:#}"))?;
 
-    let user_id =
-        std::env::var("IRONCLAW_OWNER_ID").unwrap_or_else(|_| "default".to_string());
+    let user_id = std::env::var("GATEWAY_USER_ID").unwrap_or_else(|_| "default".to_string());
     run_routines_command(routines_cmd.clone(), db, &user_id).await
 }
 

src/cli/oauth_defaults.rs

@@ -473,7 +473,8 @@ pub struct PendingOAuthFlow {
     pub secrets: Arc<dyn SecretsStore + Send + Sync>,
     /// SSE broadcast manager for notifying the web UI.
     pub sse_manager: Option<Arc<crate::channels::web::sse::SseManager>>,
-    /// Gateway auth token for authenticating with the platform token exchange proxy.
+    /// OAuth proxy auth token for authenticating with the hosted token exchange proxy.
+    /// Kept as `gateway_token` for public API compatibility.
     pub gateway_token: Option<String>,
     /// Additional form params for the token exchange request.
     /// Used for provider-specific requirements such as RFC 8707 `resource`.
@@ -496,6 +497,12 @@ impl std::fmt::Debug for PendingOAuthFlow {
     }
 }
 
+impl PendingOAuthFlow {
+    pub fn oauth_proxy_auth_token(&self) -> Option<&str> {
+        self.gateway_token.as_deref()
+    }
+}
+
 /// Thread-safe registry of pending OAuth flows, keyed by CSRF `state` parameter.
 pub type PendingOAuthRegistry = Arc<RwLock<HashMap<String, PendingOAuthFlow>>>;
 
@@ -529,6 +536,22 @@ pub fn exchange_proxy_url() -> Option<String> {
         .filter(|url| !url.is_empty())
 }
 
+/// Returns the configured OAuth proxy auth token, if any.
+///
+/// New hosted infra can inject a dedicated shared proxy secret via
+/// `IRONCLAW_OAUTH_PROXY_AUTH_TOKEN`. Existing hosted instances continue to
+/// work by falling back to `GATEWAY_AUTH_TOKEN`.
+pub fn oauth_proxy_auth_token() -> Option<String> {
+    fn normalized_env_value(key: &str) -> Option<String> {
+        crate::config::helpers::env_or_override(key)
+            .map(|value| value.trim().to_string())
+            .filter(|value| !value.is_empty())
+    }
+
+    normalized_env_value("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN")
+        .or_else(|| normalized_env_value("GATEWAY_AUTH_TOKEN"))
+}
+
 /// Maximum age for pending OAuth flows (5 minutes, matching TCP listener timeout).
 pub const OAUTH_FLOW_EXPIRY: Duration = Duration::from_secs(300);
 
@@ -674,6 +697,8 @@ pub fn strip_instance_prefix(state: &str) -> &str {
 
 pub struct ProxyTokenExchangeRequest<'a> {
     pub proxy_url: &'a str,
+    /// OAuth proxy auth token.
+    /// Kept as `gateway_token` for public API compatibility.
     pub gateway_token: &'a str,
     pub token_url: &'a str,
     pub client_id: &'a str,
@@ -687,6 +712,8 @@ pub struct ProxyTokenExchangeRequest<'a> {
 
 pub struct ProxyRefreshTokenRequest<'a> {
     pub proxy_url: &'a str,
+    /// OAuth proxy auth token.
+    /// Kept as `gateway_token` for public API compatibility.
     pub gateway_token: &'a str,
     pub token_url: &'a str,
     pub client_id: &'a str,
@@ -729,7 +756,7 @@ fn oauth_token_response_from_json(
 
 /// Exchange an OAuth authorization code via the platform's token exchange proxy.
 ///
-/// Authenticated via the gateway auth token (Bearer header). The caller may
+/// Authenticated via an OAuth proxy auth token (Bearer header). The caller may
 /// either rely on proxy-side secret lookup or forward a `client_secret` when
 /// the provider requires it.
 ///
@@ -741,7 +768,7 @@ pub async fn exchange_via_proxy(
 ) -> Result<OAuthTokenResponse, OAuthCallbackError> {
     if request.gateway_token.is_empty() {
         return Err(OAuthCallbackError::Io(
-            "Gateway auth token is required for proxy token exchange".to_string(),
+            "OAuth proxy auth token is required for proxy token exchange".to_string(),
         ));
     }
     let exchange_url = format!("{}/oauth/exchange", request.proxy_url.trim_end_matches('/'));
@@ -796,7 +823,7 @@ pub async fn exchange_via_proxy(
 
 /// Refresh an OAuth access token via the platform's token refresh proxy.
 ///
-/// Authenticated via the gateway auth token (Bearer header). The caller may
+/// Authenticated via an OAuth proxy auth token (Bearer header). The caller may
 /// either rely on proxy-side secret lookup or forward a `client_secret` when
 /// the provider requires it.
 pub async fn refresh_token_via_proxy(
@@ -804,7 +831,7 @@ pub async fn refresh_token_via_proxy(
 ) -> Result<OAuthTokenResponse, OAuthCallbackError> {
     if request.gateway_token.is_empty() {
         return Err(OAuthCallbackError::Io(
-            "Gateway auth token is required for proxy token refresh".to_string(),
+            "OAuth proxy auth token is required for proxy token refresh".to_string(),
         ));
     }
 
@@ -1010,6 +1037,37 @@ mod tests {
         }
     }
 
+    struct EnvVarGuard {
+        key: &'static str,
+        original: Option<String>,
+    }
+
+    impl Drop for EnvVarGuard {
+        fn drop(&mut self) {
+            // SAFETY: Under ENV_MUTEX, no concurrent env access.
+            unsafe {
+                if let Some(ref value) = self.original {
+                    std::env::set_var(self.key, value);
+                } else {
+                    std::env::remove_var(self.key);
+                }
+            }
+        }
+    }
+
+    fn set_env_var(key: &'static str, value: Option<&str>) -> EnvVarGuard {
+        let original = std::env::var(key).ok();
+        // SAFETY: Under ENV_MUTEX, no concurrent env access.
+        unsafe {
+            if let Some(value) = value {
+                std::env::set_var(key, value);
+            } else {
+                std::env::remove_var(key);
+            }
+        }
+        EnvVarGuard { key, original }
+    }
+
     #[test]
     fn test_hosted_proxy_client_secret_suppresses_builtin_secret() {
         let builtin = builtin_credentials("google_oauth_token").expect("google builtin creds");
@@ -1030,6 +1088,79 @@ mod tests {
         assert_eq!(result, client_secret);
     }
 
+    #[tokio::test]
+    async fn test_exchange_via_proxy_sends_auth_and_form() {
+        let server = MockProxyServer::start().await;
+        let mut extra_token_params = HashMap::new();
+        extra_token_params.insert("resource".to_string(), "https://mcp.notion.com".to_string());
+
+        let response = super::exchange_via_proxy(super::ProxyTokenExchangeRequest {
+            proxy_url: &server.base_url(),
+            gateway_token: "shared-oauth-proxy-secret",
+            code: "auth-code-123",
+            redirect_uri: "https://oauth.example.com/oauth/callback",
+            token_url: "https://oauth2.googleapis.com/token",
+            client_id: TEST_OAUTH_CLIENT_ID,
+            client_secret: Some(TEST_OAUTH_CLIENT_SECRET),
+            access_token_field: "access_token",
+            code_verifier: Some("code-verifier-123"),
+            extra_token_params: &extra_token_params,
+        })
+        .await
+        .expect("proxy exchange succeeds");
+
+        assert_eq!(response.access_token, "proxy-access-token");
+        assert_eq!(
+            response.refresh_token.as_deref(),
+            Some("proxy-refresh-token")
+        );
+        assert_eq!(response.expires_in, Some(7200));
+
+        let requests = server.requests().await;
+        assert_eq!(requests.len(), 1);
+        assert_eq!(
+            requests[0].authorization.as_deref(),
+            Some("Bearer shared-oauth-proxy-secret")
+        );
+        assert_eq!(
+            requests[0].form.get("code").map(String::as_str),
+            Some("auth-code-123")
+        );
+        assert_eq!(
+            requests[0].form.get("redirect_uri").map(String::as_str),
+            Some("https://oauth.example.com/oauth/callback")
+        );
+        assert_eq!(
+            requests[0].form.get("token_url").map(String::as_str),
+            Some("https://oauth2.googleapis.com/token")
+        );
+        assert_eq!(
+            requests[0].form.get("client_id").map(String::as_str),
+            Some(TEST_OAUTH_CLIENT_ID)
+        );
+        assert_eq!(
+            requests[0].form.get("client_secret").map(String::as_str),
+            Some(TEST_OAUTH_CLIENT_SECRET)
+        );
+        assert_eq!(
+            requests[0]
+                .form
+                .get("access_token_field")
+                .map(String::as_str),
+            Some("access_token")
+        );
+        assert_eq!(
+            requests[0].form.get("code_verifier").map(String::as_str),
+            Some("code-verifier-123")
+        );
+        assert_eq!(
+            requests[0].form.get("resource").map(String::as_str),
+            Some("https://mcp.notion.com")
+        );
+
+        server.shutdown().await;
+    }
+
     #[tokio::test]
     async fn test_refresh_token_via_proxy_sends_auth_and_form() {
         let server = MockProxyServer::start().await;
@@ -1535,6 +1666,54 @@ mod tests {
         }
     }
 
+    #[test]
+    fn test_oauth_proxy_auth_token_prefers_dedicated_env() {
+        let _guard = lock_env();
+        let _proxy_guard = set_env_var(
+            "IRONCLAW_OAUTH_PROXY_AUTH_TOKEN",
+            Some("shared-proxy-secret"),
+        );
+        let _gateway_guard = set_env_var("GATEWAY_AUTH_TOKEN", Some("gateway-token"));
+
+        assert_eq!(
+            crate::cli::oauth_defaults::oauth_proxy_auth_token().as_deref(),
+            Some("shared-proxy-secret")
+        );
+    }
+
+    #[test]
+    fn test_oauth_proxy_auth_token_falls_back_to_gateway_token() {
+        let _guard = lock_env();
+        let _proxy_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", None);
+        let _gateway_guard = set_env_var("GATEWAY_AUTH_TOKEN", Some("gateway-token"));
+
+        assert_eq!(
+            crate::cli::oauth_defaults::oauth_proxy_auth_token().as_deref(),
+            Some("gateway-token")
+        );
+    }
+
+    #[test]
+    fn test_oauth_proxy_auth_token_whitespace_dedicated_env_falls_back_to_gateway_token() {
+        let _guard = lock_env();
+        let _proxy_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", Some("   "));
+        let _gateway_guard = set_env_var("GATEWAY_AUTH_TOKEN", Some("gateway-token"));
+
+        assert_eq!(
+            crate::cli::oauth_defaults::oauth_proxy_auth_token().as_deref(),
+            Some("gateway-token")
+        );
+    }
+
+    #[test]
+    fn test_oauth_proxy_auth_token_returns_none_when_unset() {
+        let _guard = lock_env();
+        let _proxy_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", None);
+        let _gateway_guard = set_env_var("GATEWAY_AUTH_TOKEN", None);
+
+        assert_eq!(crate::cli::oauth_defaults::oauth_proxy_auth_token(), None);
+    }
+
     #[test]
     fn test_strip_instance_prefix_with_colon() {
         use crate::cli::oauth_defaults::strip_instance_prefix;

src/config/agent.rs

@@ -1,6 +1,6 @@
 use std::time::Duration;
 
-use crate::config::helpers::{parse_bool_env, parse_option_env, parse_optional_env};
+use crate::config::helpers::{optional_env, parse_bool_env, parse_option_env, parse_optional_env};
 use crate::error::ConfigError;
 use crate::settings::Settings;
 
@@ -31,13 +31,10 @@ pub struct AgentConfig {
     pub auto_approve_tools: bool,
     /// Default timezone for new sessions (IANA name, e.g. "America/New_York").
     pub default_timezone: String,
-    /// Maximum concurrent jobs per user. None = use global max_parallel_jobs.
-    pub max_jobs_per_user: Option<usize>,
     /// Maximum tokens per job (0 = unlimited).
     pub max_tokens_per_job: u64,
     /// Whether the deployment is multi-tenant (multiple users sharing one
-    /// instance). Detected at runtime after DB initialization, not from config.
-    /// See app.rs startup logic.
+    /// instance). Auto-detected from GATEWAY_USER_TOKENS presence.
     pub multi_tenant: bool,
     /// Maximum concurrent LLM calls per user. None = use default (4).
     pub max_llm_concurrent_per_user: Option<usize>,
@@ -65,7 +62,6 @@ impl AgentConfig {
             max_tool_iterations: 10,
             auto_approve_tools: true,
             default_timezone: "UTC".to_string(),
-            max_jobs_per_user: None,
             max_tokens_per_job: 0,
             multi_tenant: false,
             max_llm_concurrent_per_user: None,
@@ -126,14 +122,13 @@ impl AgentConfig {
                 }
                 tz
             },
-            max_jobs_per_user: parse_option_env("MAX_JOBS_PER_USER")?,
             max_tokens_per_job: parse_optional_env(
                 "AGENT_MAX_TOKENS_PER_JOB",
                 settings.agent.max_tokens_per_job,
             )?,
-            // Multi-tenant mode is detected at runtime after DB initialization,
-            // not from config. See app.rs startup logic.
-            multi_tenant: false,
+            // Auto-detected from GATEWAY_USER_TOKENS presence. Not a separate
+            // knob — multi-tenant mode is always implied by configuring user tokens.
+            multi_tenant: optional_env("GATEWAY_USER_TOKENS")?.is_some(),
             max_llm_concurrent_per_user: parse_option_env("TENANT_MAX_LLM_CONCURRENT")?,
             max_jobs_concurrent_per_user: parse_option_env("TENANT_MAX_JOBS_CONCURRENT")?,
         })

src/config/channels.rs

@@ -1,11 +1,13 @@
 use std::collections::HashMap;
 use std::path::PathBuf;
 
+use secrecy::SecretString;
+use serde::Deserialize;
+
 use crate::bootstrap::ironclaw_base_dir;
 use crate::config::helpers::{optional_env, parse_bool_env, parse_optional_env};
 use crate::error::ConfigError;
 use crate::settings::Settings;
-use secrecy::SecretString;
 
 /// Channel configurations.
 #[derive(Debug, Clone)]
@@ -43,6 +45,7 @@ pub struct GatewayConfig {
     pub port: u16,
     /// Bearer token for authentication. Random hex generated at startup if unset.
     pub auth_token: Option<String>,
+    pub user_id: String,
     /// Additional user scopes for workspace reads.
     ///
     /// When set, the workspace will be able to read (search, read, list) from
@@ -51,6 +54,18 @@ pub struct GatewayConfig {
     pub workspace_read_scopes: Vec<String>,
     /// Memory layer definitions (JSON in env var, or from external config).
     pub memory_layers: Vec<crate::workspace::layer::MemoryLayer>,
+    /// Multi-user token map. When set, each token maps to a user identity.
+    /// Parsed from `GATEWAY_USER_TOKENS` (JSON string). When absent, falls back
+    /// to single-user mode via `auth_token` + `user_id`.
+    pub user_tokens: Option<HashMap<String, UserTokenConfig>>,
+}
+
+/// Per-user token configuration for multi-user mode.
+#[derive(Debug, Clone, Deserialize)]
+pub struct UserTokenConfig {
+    pub user_id: String,
+    #[serde(default)]
+    pub workspace_read_scopes: Vec<String>,
 }
 
 /// Signal channel configuration (signal-cli daemon HTTP/JSON-RPC).
@@ -117,6 +132,10 @@ impl ChannelsConfig {
 
         let gateway_enabled = parse_bool_env("GATEWAY_ENABLED", cs.gateway_enabled)?;
         let gateway = if gateway_enabled {
+            let user_id = optional_env("GATEWAY_USER_ID")?
+                .or_else(|| cs.gateway_user_id.clone())
+                .unwrap_or_else(|| owner_id.to_string());
+
             let memory_layers: Vec<crate::workspace::layer::MemoryLayer> =
                 match optional_env("MEMORY_LAYERS")? {
                     Some(json_str) => {
@@ -125,7 +144,7 @@ impl ChannelsConfig {
                             message: format!("must be valid JSON array of layer objects: {e}"),
                         })?
                     }
-                    None => crate::workspace::layer::MemoryLayer::default_for_user(owner_id),
+                    None => crate::workspace::layer::MemoryLayer::default_for_user(&user_id),
                 };
 
             // Validate layer names and scopes
@@ -177,6 +196,41 @@ impl ChannelsConfig {
                 }
             }
 
+            let user_tokens: Option<HashMap<String, UserTokenConfig>> =
+                match optional_env("GATEWAY_USER_TOKENS")? {
+                    Some(json_str) => {
+                        let tokens: HashMap<String, UserTokenConfig> = serde_json::from_str(
+                            &json_str,
+                        )
+                        .map_err(|e| ConfigError::InvalidValue {
+                            key: "GATEWAY_USER_TOKENS".to_string(),
+                            message: format!(
+                                "must be valid JSON object mapping tokens to user configs: {e}"
+                            ),
+                        })?;
+                        if tokens.is_empty() {
+                            return Err(ConfigError::InvalidValue {
+                            key: "GATEWAY_USER_TOKENS".to_string(),
+                            message:
+                                "token map is empty — remove the variable to use single-user mode"
+                                    .to_string(),
+                        });
+                        }
+                        for (tok, cfg) in &tokens {
+                            if cfg.user_id.trim().is_empty() {
+                                return Err(ConfigError::InvalidValue {
+                                    key: "GATEWAY_USER_TOKENS".to_string(),
+                                    message: format!(
+                                        "token '{}...' has an empty user_id",
+                                        &tok[..tok.len().min(8)]
+                                    ),
+                                });
+                            }
+                        }
+                        Some(tokens)
+                    }
+                    None => None,
+                };
             let workspace_read_scopes: Vec<String> = optional_env("WORKSPACE_READ_SCOPES")?
                 .map(|s| {
                     s.split(',')
@@ -204,8 +258,10 @@ impl ChannelsConfig {
                 )?,
                 auth_token: optional_env("GATEWAY_AUTH_TOKEN")?
                     .or_else(|| cs.gateway_auth_token.clone()),
+                user_id,
                 workspace_read_scopes,
                 memory_layers,
+                user_tokens,
             })
         } else {
             None
@@ -360,12 +416,15 @@ mod tests {
             host: "127.0.0.1".to_string(),
             port: 3000,
             auth_token: Some("tok-abc".to_string()),
+            user_id: "default".to_string(),
             workspace_read_scopes: vec![],
             memory_layers: vec![],
+            user_tokens: None,
         };
         assert_eq!(cfg.host, "127.0.0.1");
         assert_eq!(cfg.port, 3000);
         assert_eq!(cfg.auth_token.as_deref(), Some("tok-abc"));
+        assert_eq!(cfg.user_id, "default");
     }
 
     #[test]
@@ -374,8 +433,10 @@ mod tests {
             host: "0.0.0.0".to_string(),
             port: 3001,
             auth_token: None,
+            user_id: "anon".to_string(),
             workspace_read_scopes: vec![],
             memory_layers: vec![],
+            user_tokens: None,
         };
         assert!(cfg.auth_token.is_none());
     }
@@ -502,6 +563,7 @@ mod tests {
         assert_eq!(gateway.host, "127.0.0.3");
         assert_eq!(gateway.port, 9191);
         assert_eq!(gateway.auth_token.as_deref(), Some("tok"));
+        assert_eq!(gateway.user_id, "owner-scope");
 
         let signal = cfg.signal.expect("signal config");
         assert_eq!(signal.account, "+15551234567");

src/config/heartbeat.rs

@@ -21,8 +21,8 @@ pub struct HeartbeatConfig {
     pub quiet_hours_end: Option<u32>,
     /// Timezone for fire_at and quiet hours evaluation (IANA name).
     pub timezone: Option<String>,
-    /// When true, cycle through all users with routines. Set explicitly via
-    /// HEARTBEAT_MULTI_TENANT or detected at runtime after DB initialization.
+    /// When true, cycle through all users with routines. Auto-detected from
+    /// GATEWAY_USER_TOKENS or set explicitly via HEARTBEAT_MULTI_TENANT.
     pub multi_tenant: bool,
 }
 
@@ -105,7 +105,12 @@ impl HeartbeatConfig {
                 }
                 tz
             },
-            multi_tenant: parse_bool_env("HEARTBEAT_MULTI_TENANT", false)?,
+            // Auto-detect multi-tenant mode from GATEWAY_USER_TOKENS presence,
+            // or allow explicit override via HEARTBEAT_MULTI_TENANT.
+            multi_tenant: parse_bool_env(
+                "HEARTBEAT_MULTI_TENANT",
+                optional_env("GATEWAY_USER_TOKENS")?.is_some(),
+            )?,
         })
     }
 }

src/context/state.rs

@@ -192,6 +192,9 @@ pub struct JobContext {
     /// but subsequent tools (e.g., `json`) may need the full output. This
     /// stash stores the complete, unsanitized output so tools can reference
     /// previous results by ID via `$tool_call_id` parameter syntax.
+    ///
+    /// Also used for cross-tool implicit state (keys prefixed with `__`) such
+    /// as `__routine_last_name` for fallback recovery in routine tool chains.
     #[serde(skip)]
     pub tool_output_stash: Arc<tokio::sync::RwLock<HashMap<String, String>>>,
     /// User's preferred timezone (IANA name, e.g. "America/New_York"). Defaults to "UTC".

src/db/libsql/mod.rs

@@ -12,7 +12,6 @@ mod routines;
 mod sandbox;
 mod settings;
 mod tool_failures;
-mod users;
 mod workspace;
 
 use std::path::Path;

src/db/libsql/users.rs

@@ -1,735 +0,0 @@
-//! UserStore implementation for LibSqlBackend.
-
-use async_trait::async_trait;
-use chrono::{DateTime, Utc};
-use libsql::params;
-use uuid::Uuid;
-
-use super::{fmt_opt_ts, fmt_ts, get_opt_text, get_opt_ts, get_text, get_ts, opt_text};
-use crate::db::libsql::LibSqlBackend;
-use crate::db::{ApiTokenRecord, DatabaseError, UserRecord, UserStore};
-
-fn row_to_user(row: &libsql::Row) -> Result<UserRecord, DatabaseError> {
-    let metadata_str = get_text(row, 9);
-    let metadata: serde_json::Value = serde_json::from_str(&metadata_str)
-        .map_err(|e| DatabaseError::Serialization(e.to_string()))?;
-    Ok(UserRecord {
-        id: get_text(row, 0),
-        email: get_opt_text(row, 1),
-        display_name: get_text(row, 2),
-        status: get_text(row, 3),
-        role: get_text(row, 4),
-        created_at: get_ts(row, 5),
-        updated_at: get_ts(row, 6),
-        last_login_at: get_opt_ts(row, 7),
-        created_by: get_opt_text(row, 8),
-        metadata,
-    })
-}
-
-fn row_to_api_token(row: &libsql::Row) -> Result<ApiTokenRecord, DatabaseError> {
-    let id_str = get_text(row, 0);
-    let id: Uuid = id_str
-        .parse()
-        .map_err(|e| DatabaseError::Serialization(format!("invalid UUID: {e}")))?;
-    Ok(ApiTokenRecord {
-        id,
-        user_id: get_text(row, 1),
-        name: get_text(row, 2),
-        token_prefix: get_text(row, 3),
-        expires_at: get_opt_ts(row, 4),
-        last_used_at: get_opt_ts(row, 5),
-        created_at: get_ts(row, 6),
-        revoked_at: get_opt_ts(row, 7),
-    })
-}
-
-#[async_trait]
-impl UserStore for LibSqlBackend {
-    async fn create_user(&self, user: &UserRecord) -> Result<(), DatabaseError> {
-        let conn = self.connect().await?;
-        let metadata_json = serde_json::to_string(&user.metadata)
-            .map_err(|e| DatabaseError::Serialization(e.to_string()))?;
-
-        conn.execute(
-            r#"
-            INSERT INTO users (id, email, display_name, status, role, created_at, updated_at, last_login_at, created_by, metadata)
-            VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7, ?8, ?9, ?10)
-            "#,
-            params![
-                user.id.as_str(),
-                opt_text(user.email.as_deref()),
-                user.display_name.as_str(),
-                user.status.as_str(),
-                user.role.as_str(),
-                fmt_ts(&user.created_at),
-                fmt_ts(&user.updated_at),
-                fmt_opt_ts(&user.last_login_at),
-                opt_text(user.created_by.as_deref()),
-                metadata_json,
-            ],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(())
-    }
-
-    async fn get_user(&self, id: &str) -> Result<Option<UserRecord>, DatabaseError> {
-        let conn = self.connect().await?;
-        let mut rows = conn
-            .query(
-                r#"
-                SELECT id, email, display_name, status, role, created_at, updated_at,
-                       last_login_at, created_by, metadata
-                FROM users WHERE id = ?1
-                "#,
-                params![id],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-
-        match rows
-            .next()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        {
-            Some(row) => Ok(Some(row_to_user(&row)?)),
-            None => Ok(None),
-        }
-    }
-
-    async fn get_user_by_email(&self, email: &str) -> Result<Option<UserRecord>, DatabaseError> {
-        let conn = self.connect().await?;
-        let mut rows = conn
-            .query(
-                r#"
-                SELECT id, email, display_name, status, role, created_at, updated_at,
-                       last_login_at, created_by, metadata
-                FROM users WHERE email = ?1
-                "#,
-                params![email],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-
-        match rows
-            .next()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        {
-            Some(row) => Ok(Some(row_to_user(&row)?)),
-            None => Ok(None),
-        }
-    }
-
-    async fn list_users(&self, status: Option<&str>) -> Result<Vec<UserRecord>, DatabaseError> {
-        let conn = self.connect().await?;
-        let mut users = Vec::new();
-
-        let mut rows = if let Some(status) = status {
-            conn.query(
-                r#"
-                SELECT id, email, display_name, status, role, created_at, updated_at,
-                       last_login_at, created_by, metadata
-                FROM users WHERE status = ?1
-                ORDER BY created_at DESC
-                "#,
-                params![status],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        } else {
-            conn.query(
-                r#"
-                SELECT id, email, display_name, status, role, created_at, updated_at,
-                       last_login_at, created_by, metadata
-                FROM users
-                ORDER BY created_at DESC
-                "#,
-                (),
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        };
-
-        while let Some(row) = rows
-            .next()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        {
-            users.push(row_to_user(&row)?);
-        }
-        Ok(users)
-    }
-
-    async fn update_user_status(&self, id: &str, status: &str) -> Result<(), DatabaseError> {
-        let conn = self.connect().await?;
-        let now = fmt_ts(&Utc::now());
-        conn.execute(
-            "UPDATE users SET status = ?2, updated_at = ?3 WHERE id = ?1",
-            params![id, status, now],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(())
-    }
-
-    async fn update_user_profile(
-        &self,
-        id: &str,
-        display_name: &str,
-        metadata: &serde_json::Value,
-    ) -> Result<(), DatabaseError> {
-        let conn = self.connect().await?;
-        let now = fmt_ts(&Utc::now());
-        let metadata_json = serde_json::to_string(metadata)
-            .map_err(|e| DatabaseError::Serialization(e.to_string()))?;
-        conn.execute(
-            "UPDATE users SET display_name = ?2, metadata = ?3, updated_at = ?4 WHERE id = ?1",
-            params![id, display_name, metadata_json, now],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(())
-    }
-
-    async fn record_login(&self, id: &str) -> Result<(), DatabaseError> {
-        let conn = self.connect().await?;
-        let now = fmt_ts(&Utc::now());
-        conn.execute(
-            "UPDATE users SET last_login_at = ?2, updated_at = ?2 WHERE id = ?1",
-            params![id, now],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(())
-    }
-
-    async fn create_api_token(
-        &self,
-        user_id: &str,
-        name: &str,
-        token_hash: &[u8; 32],
-        token_prefix: &str,
-        expires_at: Option<DateTime<Utc>>,
-    ) -> Result<ApiTokenRecord, DatabaseError> {
-        let conn = self.connect().await?;
-        let id = Uuid::new_v4();
-        let now = Utc::now();
-
-        conn.execute(
-            r#"
-            INSERT INTO api_tokens (id, user_id, token_hash, token_prefix, name, expires_at, created_at)
-            VALUES (?1, ?2, ?3, ?4, ?5, ?6, ?7)
-            "#,
-            params![
-                id.to_string(),
-                user_id,
-                libsql::Value::Blob(token_hash.to_vec()),
-                token_prefix,
-                name,
-                fmt_opt_ts(&expires_at),
-                fmt_ts(&now),
-            ],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-
-        Ok(ApiTokenRecord {
-            id,
-            user_id: user_id.to_string(),
-            name: name.to_string(),
-            token_prefix: token_prefix.to_string(),
-            expires_at,
-            last_used_at: None,
-            created_at: now,
-            revoked_at: None,
-        })
-    }
-
-    async fn list_api_tokens(&self, user_id: &str) -> Result<Vec<ApiTokenRecord>, DatabaseError> {
-        let conn = self.connect().await?;
-        let mut rows = conn
-            .query(
-                r#"
-                SELECT id, user_id, name, token_prefix, expires_at, last_used_at, created_at, revoked_at
-                FROM api_tokens WHERE user_id = ?1
-                ORDER BY created_at DESC
-                "#,
-                params![user_id],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-
-        let mut tokens = Vec::new();
-        while let Some(row) = rows
-            .next()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        {
-            tokens.push(row_to_api_token(&row)?);
-        }
-        Ok(tokens)
-    }
-
-    async fn revoke_api_token(&self, token_id: Uuid, user_id: &str) -> Result<bool, DatabaseError> {
-        let conn = self.connect().await?;
-        let now = fmt_ts(&Utc::now());
-        let rows_affected = conn
-            .execute(
-                r#"
-                UPDATE api_tokens SET revoked_at = ?3
-                WHERE id = ?1 AND user_id = ?2 AND revoked_at IS NULL
-                "#,
-                params![token_id.to_string(), user_id, now],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(rows_affected > 0)
-    }
-
-    async fn authenticate_token(
-        &self,
-        token_hash: &[u8; 32],
-    ) -> Result<Option<(ApiTokenRecord, UserRecord)>, DatabaseError> {
-        let conn = self.connect().await?;
-        let now = fmt_ts(&Utc::now());
-
-        let mut rows = conn
-            .query(
-                r#"
-                SELECT
-                    t.id, t.user_id, t.name, t.token_prefix, t.expires_at,
-                    t.last_used_at, t.created_at, t.revoked_at,
-                    u.id, u.email, u.display_name, u.status, u.role, u.created_at,
-                    u.updated_at, u.last_login_at, u.created_by, u.metadata
-                FROM api_tokens t
-                JOIN users u ON u.id = t.user_id
-                WHERE t.token_hash = ?1
-                  AND t.revoked_at IS NULL
-                  AND (t.expires_at IS NULL OR t.expires_at > ?2)
-                  AND u.status = 'active'
-                "#,
-                params![libsql::Value::Blob(token_hash.to_vec()), now],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-
-        match rows
-            .next()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        {
-            Some(row) => {
-                let id_str = get_text(&row, 0);
-                let token_id: Uuid = id_str
-                    .parse()
-                    .map_err(|e| DatabaseError::Serialization(format!("invalid UUID: {e}")))?;
-                let token = ApiTokenRecord {
-                    id: token_id,
-                    user_id: get_text(&row, 1),
-                    name: get_text(&row, 2),
-                    token_prefix: get_text(&row, 3),
-                    expires_at: get_opt_ts(&row, 4),
-                    last_used_at: get_opt_ts(&row, 5),
-                    created_at: get_ts(&row, 6),
-                    revoked_at: get_opt_ts(&row, 7),
-                };
-
-                let metadata_str = get_text(&row, 17);
-                let metadata: serde_json::Value = serde_json::from_str(&metadata_str)
-                    .map_err(|e| DatabaseError::Serialization(e.to_string()))?;
-
-                let user = UserRecord {
-                    id: get_text(&row, 8),
-                    email: get_opt_text(&row, 9),
-                    display_name: get_text(&row, 10),
-                    status: get_text(&row, 11),
-                    role: get_text(&row, 12),
-                    created_at: get_ts(&row, 13),
-                    updated_at: get_ts(&row, 14),
-                    last_login_at: get_opt_ts(&row, 15),
-                    created_by: get_opt_text(&row, 16),
-                    metadata,
-                };
-
-                Ok(Some((token, user)))
-            }
-            None => Ok(None),
-        }
-    }
-
-    async fn record_token_usage(&self, token_id: Uuid) -> Result<(), DatabaseError> {
-        let conn = self.connect().await?;
-        let now = fmt_ts(&Utc::now());
-        conn.execute(
-            "UPDATE api_tokens SET last_used_at = ?2 WHERE id = ?1",
-            params![token_id.to_string(), now],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(())
-    }
-
-    async fn has_any_users(&self) -> Result<bool, DatabaseError> {
-        let conn = self.connect().await?;
-        let mut rows = conn
-            .query("SELECT 1 FROM users LIMIT 1", ())
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-
-        let has_users = rows
-            .next()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-            .is_some();
-        Ok(has_users)
-    }
-
-    async fn delete_user(&self, id: &str) -> Result<bool, DatabaseError> {
-        let conn = self.connect().await?;
-        // Delete from child tables first to avoid FK violations.
-        // agent_jobs cascades to job_actions, llm_calls, estimation_snapshots
-        // conversations cascades to conversation_messages
-        // memory_documents cascades to memory_chunks
-        // routines cascades to routine_runs
-        for table in &[
-            "settings",
-            "heartbeat_state",
-            "tool_rate_limit_state",
-            "secret_usage_log",
-            "leak_detection_events",
-            "secrets",
-            "wasm_tools",
-            "routines",
-            "memory_documents",
-            "conversations",
-            "api_tokens",
-        ] {
-            conn.execute(
-                &format!("DELETE FROM {} WHERE user_id = ?1", table),
-                params![id],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        }
-        // job_events references agent_jobs(id) without CASCADE — delete via subquery.
-        conn.execute(
-            "DELETE FROM job_events WHERE job_id IN (SELECT id FROM agent_jobs WHERE user_id = ?1)",
-            params![id],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        conn.execute("DELETE FROM agent_jobs WHERE user_id = ?1", params![id])
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        // Nullify self-referencing created_by before deleting the user
-        conn.execute(
-            "UPDATE users SET created_by = NULL WHERE created_by = ?1",
-            params![id],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        let rows = conn
-            .execute("DELETE FROM users WHERE id = ?1", params![id])
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(rows > 0)
-    }
-
-    async fn user_usage_stats(
-        &self,
-        user_id: Option<&str>,
-        since: DateTime<Utc>,
-    ) -> Result<Vec<crate::db::UserUsageStats>, DatabaseError> {
-        let conn = self.connect().await?;
-        let since_str = fmt_ts(&since);
-        let mut rows = if let Some(uid) = user_id {
-            conn.query(
-                r#"
-                SELECT j.user_id, l.model, COUNT(*) as call_count,
-                       COALESCE(SUM(l.input_tokens), 0) as input_tokens,
-                       COALESCE(SUM(l.output_tokens), 0) as output_tokens,
-                       COALESCE(SUM(l.cost), 0) as total_cost
-                FROM llm_calls l
-                JOIN agent_jobs j ON l.job_id = j.id
-                WHERE l.created_at >= ?1
-                  AND j.user_id = ?2
-                GROUP BY j.user_id, l.model
-                ORDER BY total_cost DESC
-                "#,
-                params![since_str, uid],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        } else {
-            conn.query(
-                r#"
-                SELECT j.user_id, l.model, COUNT(*) as call_count,
-                       COALESCE(SUM(l.input_tokens), 0) as input_tokens,
-                       COALESCE(SUM(l.output_tokens), 0) as output_tokens,
-                       COALESCE(SUM(l.cost), 0) as total_cost
-                FROM llm_calls l
-                JOIN agent_jobs j ON l.job_id = j.id
-                WHERE l.created_at >= ?1
-                GROUP BY j.user_id, l.model
-                ORDER BY total_cost DESC
-                "#,
-                params![since_str],
-            )
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        };
-        let mut stats = Vec::new();
-        while let Some(row) = rows
-            .next()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?
-        {
-            let cost_str = get_text(&row, 5);
-            let total_cost = rust_decimal::Decimal::from_str_exact(&cost_str).unwrap_or_default();
-            stats.push(crate::db::UserUsageStats {
-                user_id: get_text(&row, 0),
-                model: get_text(&row, 1),
-                call_count: row
-                    .get::<i64>(2)
-                    .map_err(|e| DatabaseError::Query(e.to_string()))?,
-                input_tokens: row
-                    .get::<i64>(3)
-                    .map_err(|e| DatabaseError::Query(e.to_string()))?,
-                output_tokens: row
-                    .get::<i64>(4)
-                    .map_err(|e| DatabaseError::Query(e.to_string()))?,
-                total_cost,
-            });
-        }
-        Ok(stats)
-    }
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-    use crate::db::libsql::LibSqlBackend;
-    use crate::db::{Database, UserStore};
-    use sha2::{Digest, Sha256};
-
-    fn hash(s: &str) -> [u8; 32] {
-        let mut h = Sha256::new();
-        h.update(s.as_bytes());
-        h.finalize().into()
-    }
-
-    async fn setup() -> (LibSqlBackend, tempfile::TempDir) {
-        let dir = tempfile::tempdir().unwrap();
-        let db_path = dir.path().join("test_users.db");
-        let db = LibSqlBackend::new_local(&db_path).await.unwrap();
-        db.run_migrations().await.unwrap();
-        (db, dir) // keep dir alive so the DB file isn't deleted
-    }
-
-    fn test_user(id: &str) -> UserRecord {
-        UserRecord {
-            id: id.to_string(),
-            email: Some(format!("{}@test.com", id)),
-            display_name: id.to_string(),
-            status: "active".to_string(),
-            role: "member".to_string(),
-            created_at: Utc::now(),
-            updated_at: Utc::now(),
-            last_login_at: None,
-            created_by: None,
-            metadata: serde_json::json!({}),
-        }
-    }
-
-    #[tokio::test]
-    async fn test_has_any_users_empty() {
-        let (db, _dir) = setup().await;
-        assert!(!db.has_any_users().await.unwrap());
-    }
-
-    #[tokio::test]
-    async fn test_create_and_get_user() {
-        let (db, _dir) = setup().await;
-        let user = test_user("alice");
-        db.create_user(&user).await.unwrap();
-
-        assert!(db.has_any_users().await.unwrap());
-
-        let found = db.get_user("alice").await.unwrap().unwrap();
-        assert_eq!(found.id, "alice");
-        assert_eq!(found.email, Some("[email protected]".to_string()));
-        assert_eq!(found.status, "active");
-    }
-
-    #[tokio::test]
-    async fn test_get_user_by_email() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("bob")).await.unwrap();
-
-        let found = db.get_user_by_email("[email protected]").await.unwrap();
-        assert!(found.is_some());
-        assert_eq!(found.unwrap().id, "bob");
-
-        assert!(
-            db.get_user_by_email("[email protected]")
-                .await
-                .unwrap()
-                .is_none()
-        );
-    }
-
-    #[tokio::test]
-    async fn test_list_users_with_status_filter() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("alice")).await.unwrap();
-        db.create_user(&test_user("bob")).await.unwrap();
-        db.update_user_status("bob", "suspended").await.unwrap();
-
-        let all = db.list_users(None).await.unwrap();
-        assert_eq!(all.len(), 2);
-
-        let active = db.list_users(Some("active")).await.unwrap();
-        assert_eq!(active.len(), 1);
-        assert_eq!(active[0].id, "alice");
-
-        let suspended = db.list_users(Some("suspended")).await.unwrap();
-        assert_eq!(suspended.len(), 1);
-        assert_eq!(suspended[0].id, "bob");
-    }
-
-    #[tokio::test]
-    async fn test_update_user_profile() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("alice")).await.unwrap();
-
-        let meta = serde_json::json!({"role": "admin"});
-        db.update_user_profile("alice", "Alice Smith", &meta)
-            .await
-            .unwrap();
-
-        let user = db.get_user("alice").await.unwrap().unwrap();
-        assert_eq!(user.display_name, "Alice Smith");
-        assert_eq!(user.metadata["role"], "admin");
-    }
-
-    #[tokio::test]
-    async fn test_token_lifecycle_create_authenticate_revoke() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("alice")).await.unwrap();
-
-        // Create token
-        let token_hash = hash("secret-token-123");
-        let record = db
-            .create_api_token("alice", "laptop", &token_hash, "secret-t", None)
-            .await
-            .unwrap();
-        assert_eq!(record.user_id, "alice");
-        assert_eq!(record.name, "laptop");
-        assert_eq!(record.token_prefix, "secret-t");
-
-        // Authenticate
-        let (tok, user) = db.authenticate_token(&token_hash).await.unwrap().unwrap();
-        assert_eq!(tok.id, record.id);
-        assert_eq!(user.id, "alice");
-
-        // List tokens
-        let tokens = db.list_api_tokens("alice").await.unwrap();
-        assert_eq!(tokens.len(), 1);
-
-        // Revoke
-        assert!(db.revoke_api_token(record.id, "alice").await.unwrap());
-
-        // Auth should fail after revoke
-        assert!(db.authenticate_token(&token_hash).await.unwrap().is_none());
-    }
-
-    #[tokio::test]
-    async fn test_token_auth_fails_for_suspended_user() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("alice")).await.unwrap();
-
-        let token_hash = hash("token-abc");
-        db.create_api_token("alice", "test", &token_hash, "token-ab", None)
-            .await
-            .unwrap();
-
-        // Auth works while active
-        assert!(db.authenticate_token(&token_hash).await.unwrap().is_some());
-
-        // Suspend user
-        db.update_user_status("alice", "suspended").await.unwrap();
-
-        // Auth should fail
-        assert!(db.authenticate_token(&token_hash).await.unwrap().is_none());
-    }
-
-    #[tokio::test]
-    async fn test_token_revoke_wrong_user_returns_false() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("alice")).await.unwrap();
-        db.create_user(&test_user("bob")).await.unwrap();
-
-        let token_hash = hash("alice-token");
-        let record = db
-            .create_api_token("alice", "test", &token_hash, "alice-to", None)
-            .await
-            .unwrap();
-
-        // Bob can't revoke Alice's token
-        assert!(!db.revoke_api_token(record.id, "bob").await.unwrap());
-
-        // Alice can
-        assert!(db.revoke_api_token(record.id, "alice").await.unwrap());
-    }
-
-    #[tokio::test]
-    async fn test_record_login_and_token_usage() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("alice")).await.unwrap();
-
-        let token_hash = hash("tok");
-        let record = db
-            .create_api_token("alice", "test", &token_hash, "tok", None)
-            .await
-            .unwrap();
-
-        // Record usage
-        db.record_token_usage(record.id).await.unwrap();
-        db.record_login("alice").await.unwrap();
-
-        // Verify timestamps updated
-        let user = db.get_user("alice").await.unwrap().unwrap();
-        assert!(user.last_login_at.is_some());
-
-        let tokens = db.list_api_tokens("alice").await.unwrap();
-        assert!(tokens[0].last_used_at.is_some());
-    }
-
-    #[tokio::test]
-    async fn test_delete_user_removes_api_tokens() {
-        let (db, _dir) = setup().await;
-        db.create_user(&test_user("alice")).await.unwrap();
-
-        let token_hash = hash("alice-tok");
-        db.create_api_token("alice", "primary", &token_hash, "alice-to", None)
-            .await
-            .unwrap();
-
-        // Verify token exists before deletion.
-        let tokens = db.list_api_tokens("alice").await.unwrap();
-        assert_eq!(tokens.len(), 1);
-
-        // Delete user — should also remove their api_tokens.
-        assert!(db.delete_user("alice").await.unwrap());
-
-        // api_tokens must be gone (not orphaned).
-        let tokens = db.list_api_tokens("alice").await.unwrap();
-        assert!(
-            tokens.is_empty(),
-            "expected api_tokens to be deleted with user, found {}",
-            tokens.len()
-        );
-    }
-}

src/db/libsql_migrations.rs

@@ -579,36 +579,6 @@ INSERT OR IGNORE INTO leak_detection_patterns (id, name, pattern, severity, acti
     ('550e8400-e29b-41d4-a716-446655440011', 'mailchimp_api_key', '[a-f0-9]{32}-us[0-9]{1,2}', 'medium', 'block', 1, strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
     ('550e8400-e29b-41d4-a716-446655440012', 'high_entropy_hex', '(?<![a-fA-F0-9])[a-fA-F0-9]{64}(?![a-fA-F0-9])', 'medium', 'warn', 1, strftime('%Y-%m-%dT%H:%M:%fZ', 'now'));
 
-
--- ==================== User management (V14) ====================
-
-CREATE TABLE IF NOT EXISTS users (
-    id TEXT PRIMARY KEY,
-    email TEXT UNIQUE,
-    display_name TEXT NOT NULL,
-    status TEXT NOT NULL DEFAULT 'active',
-    role TEXT NOT NULL DEFAULT 'member',
-    created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    last_login_at TEXT,
-    created_by TEXT,
-    metadata TEXT NOT NULL DEFAULT '{}'
-);
-
-CREATE TABLE IF NOT EXISTS api_tokens (
-    id TEXT PRIMARY KEY,
-    user_id TEXT NOT NULL,
-    token_hash BLOB NOT NULL,
-    token_prefix TEXT NOT NULL,
-    name TEXT NOT NULL,
-    expires_at TEXT,
-    last_used_at TEXT,
-    created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    revoked_at TEXT
-);
-CREATE INDEX IF NOT EXISTS idx_api_tokens_user ON api_tokens(user_id);
-CREATE INDEX IF NOT EXISTS idx_api_tokens_hash ON api_tokens(token_hash);
-
 "#;
 
 /// Incremental migrations applied after the base schema.
@@ -753,38 +723,6 @@ CREATE INDEX IF NOT EXISTS idx_routines_event_triggers
     WHERE enabled = 1 AND trigger_type IN ('event', 'system_event');
 
 PRAGMA foreign_keys=ON;
-"#,
-    ),
-    (
-        14,
-        "users",
-        r#"
-CREATE TABLE IF NOT EXISTS users (
-    id TEXT PRIMARY KEY,
-    email TEXT UNIQUE,
-    display_name TEXT NOT NULL,
-    status TEXT NOT NULL DEFAULT 'active',
-    role TEXT NOT NULL DEFAULT 'member',
-    created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    last_login_at TEXT,
-    created_by TEXT,
-    metadata TEXT NOT NULL DEFAULT '{}'
-);
-
-CREATE TABLE IF NOT EXISTS api_tokens (
-    id TEXT PRIMARY KEY,
-    user_id TEXT NOT NULL,
-    token_hash BLOB NOT NULL,
-    token_prefix TEXT NOT NULL,
-    name TEXT NOT NULL,
-    expires_at TEXT,
-    last_used_at TEXT,
-    created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
-    revoked_at TEXT
-);
-CREATE INDEX IF NOT EXISTS idx_api_tokens_user ON api_tokens(user_id);
-CREATE INDEX IF NOT EXISTS idx_api_tokens_hash ON api_tokens(token_hash);
 "#,
     ),
 ];

src/db/mod.rs

@@ -309,43 +309,6 @@ async fn validate_postgres(pool: &deadpool_postgres::Pool) -> Result<(), Databas
     Ok(())
 }
 
-// ==================== User management record types ====================
-
-/// A registered user.
-#[derive(Debug, Clone)]
-pub struct UserRecord {
-    /// User identifier (string, matches existing `user_id` throughout the codebase).
-    pub id: String,
-    pub email: Option<String>,
-    pub display_name: String,
-    /// `active`, `suspended`, or `deactivated`.
-    pub status: String,
-    /// `admin` or `member`.
-    pub role: String,
-    pub created_at: DateTime<Utc>,
-    pub updated_at: DateTime<Utc>,
-    pub last_login_at: Option<DateTime<Utc>>,
-    /// Who created/invited this user (nullable for bootstrap users).
-    pub created_by: Option<String>,
-    pub metadata: serde_json::Value,
-}
-
-/// An API token for authenticating requests (hash stored, never plaintext).
-#[derive(Debug, Clone)]
-pub struct ApiTokenRecord {
-    pub id: Uuid,
-    pub user_id: String,
-    /// Human label (e.g. "my-laptop", "ci-bot").
-    pub name: String,
-    /// First 8 hex chars of the plaintext token for display/identification.
-    pub token_prefix: String,
-    pub expires_at: Option<DateTime<Utc>>,
-    pub last_used_at: Option<DateTime<Utc>>,
-    pub created_at: DateTime<Utc>,
-    /// Soft-revoke timestamp. Non-null means revoked.
-    pub revoked_at: Option<DateTime<Utc>>,
-}
-
 // ==================== Sub-traits ====================
 //
 // Each sub-trait groups related persistence methods. The `Database` supertrait
@@ -798,81 +761,6 @@ pub trait WorkspaceStore: Send + Sync {
     }
 }
 
-#[async_trait]
-pub trait UserStore: Send + Sync {
-    // ---- Users ----
-
-    /// Create a new user record.
-    async fn create_user(&self, user: &UserRecord) -> Result<(), DatabaseError>;
-    /// Get a user by their string id.
-    async fn get_user(&self, id: &str) -> Result<Option<UserRecord>, DatabaseError>;
-    /// Get a user by email address.
-    async fn get_user_by_email(&self, email: &str) -> Result<Option<UserRecord>, DatabaseError>;
-    /// List users, optionally filtered by status.
-    async fn list_users(&self, status: Option<&str>) -> Result<Vec<UserRecord>, DatabaseError>;
-    /// Update a user's status (active/suspended/deactivated).
-    async fn update_user_status(&self, id: &str, status: &str) -> Result<(), DatabaseError>;
-    /// Update a user's display name and metadata.
-    async fn update_user_profile(
-        &self,
-        id: &str,
-        display_name: &str,
-        metadata: &serde_json::Value,
-    ) -> Result<(), DatabaseError>;
-    /// Record a login timestamp.
-    async fn record_login(&self, id: &str) -> Result<(), DatabaseError>;
-
-    // ---- API Tokens ----
-
-    /// Create a new API token. The `token_hash` is SHA-256 of the plaintext.
-    async fn create_api_token(
-        &self,
-        user_id: &str,
-        name: &str,
-        token_hash: &[u8; 32],
-        token_prefix: &str,
-        expires_at: Option<DateTime<Utc>>,
-    ) -> Result<ApiTokenRecord, DatabaseError>;
-    /// List tokens for a user (never includes the hash).
-    async fn list_api_tokens(&self, user_id: &str) -> Result<Vec<ApiTokenRecord>, DatabaseError>;
-    /// Soft-revoke a token. Returns false if the token doesn't exist or doesn't belong to the user.
-    async fn revoke_api_token(&self, token_id: Uuid, user_id: &str) -> Result<bool, DatabaseError>;
-    /// Look up a token by hash, returning the token record and its owning user.
-    /// Only returns active (non-revoked, non-expired) tokens for active users.
-    async fn authenticate_token(
-        &self,
-        token_hash: &[u8; 32],
-    ) -> Result<Option<(ApiTokenRecord, UserRecord)>, DatabaseError>;
-    /// Update `last_used_at` for a token.
-    async fn record_token_usage(&self, token_id: Uuid) -> Result<(), DatabaseError>;
-
-    /// Check whether any user records exist (for first-run bootstrap detection).
-    async fn has_any_users(&self) -> Result<bool, DatabaseError>;
-
-    /// Delete a user and all their data across all user-scoped tables.
-    /// Returns false if the user doesn't exist.
-    async fn delete_user(&self, id: &str) -> Result<bool, DatabaseError>;
-
-    /// Get per-user LLM usage stats for a time period.
-    /// Aggregates from llm_calls via agent_jobs.user_id.
-    async fn user_usage_stats(
-        &self,
-        user_id: Option<&str>,
-        since: DateTime<Utc>,
-    ) -> Result<Vec<UserUsageStats>, DatabaseError>;
-}
-
-/// Per-user LLM usage statistics.
-#[derive(Debug, Clone)]
-pub struct UserUsageStats {
-    pub user_id: String,
-    pub model: String,
-    pub call_count: i64,
-    pub input_tokens: i64,
-    pub output_tokens: i64,
-    pub total_cost: Decimal,
-}
-
 /// Backend-agnostic database supertrait.
 ///
 /// Combines all sub-traits into one. Existing `Arc<dyn Database>` consumers
@@ -886,7 +774,6 @@ pub trait Database:
     + ToolFailureStore
     + SettingsStore
     + WorkspaceStore
-    + UserStore
     + Send
     + Sync
 {

src/db/postgres.rs

@@ -16,8 +16,8 @@ use crate::agent::routine::{Routine, RoutineRun, RunStatus};
 use crate::config::DatabaseConfig;
 use crate::context::{ActionRecord, JobContext, JobState};
 use crate::db::{
-    ApiTokenRecord, ConversationStore, Database, JobStore, RoutineStore, SandboxStore,
-    SettingsStore, ToolFailureStore, UserRecord, UserStore, WorkspaceStore,
+    ConversationStore, Database, JobStore, RoutineStore, SandboxStore, SettingsStore,
+    ToolFailureStore, WorkspaceStore,
 };
 use crate::error::{DatabaseError, WorkspaceError};
 use crate::history::{
@@ -786,91 +786,3 @@ impl WorkspaceStore for PgBackend {
             .await
     }
 }
-
-// ==================== UserStore ====================
-
-#[async_trait]
-impl UserStore for PgBackend {
-    async fn create_user(&self, user: &UserRecord) -> Result<(), DatabaseError> {
-        self.store.create_user(user).await
-    }
-
-    async fn get_user(&self, id: &str) -> Result<Option<UserRecord>, DatabaseError> {
-        self.store.get_user(id).await
-    }
-
-    async fn get_user_by_email(&self, email: &str) -> Result<Option<UserRecord>, DatabaseError> {
-        self.store.get_user_by_email(email).await
-    }
-
-    async fn list_users(&self, status: Option<&str>) -> Result<Vec<UserRecord>, DatabaseError> {
-        self.store.list_users(status).await
-    }
-
-    async fn update_user_status(&self, id: &str, status: &str) -> Result<(), DatabaseError> {
-        self.store.update_user_status(id, status).await
-    }
-
-    async fn update_user_profile(
-        &self,
-        id: &str,
-        display_name: &str,
-        metadata: &serde_json::Value,
-    ) -> Result<(), DatabaseError> {
-        self.store
-            .update_user_profile(id, display_name, metadata)
-            .await
-    }
-
-    async fn record_login(&self, id: &str) -> Result<(), DatabaseError> {
-        self.store.record_login(id).await
-    }
-
-    async fn create_api_token(
-        &self,
-        user_id: &str,
-        name: &str,
-        token_hash: &[u8; 32],
-        token_prefix: &str,
-        expires_at: Option<DateTime<Utc>>,
-    ) -> Result<ApiTokenRecord, DatabaseError> {
-        self.store
-            .create_api_token(user_id, name, token_hash, token_prefix, expires_at)
-            .await
-    }
-
-    async fn list_api_tokens(&self, user_id: &str) -> Result<Vec<ApiTokenRecord>, DatabaseError> {
-        self.store.list_api_tokens(user_id).await
-    }
-
-    async fn revoke_api_token(&self, token_id: Uuid, user_id: &str) -> Result<bool, DatabaseError> {
-        self.store.revoke_api_token(token_id, user_id).await
-    }
-
-    async fn authenticate_token(
-        &self,
-        token_hash: &[u8; 32],
-    ) -> Result<Option<(ApiTokenRecord, UserRecord)>, DatabaseError> {
-        self.store.authenticate_token(token_hash).await
-    }
-
-    async fn record_token_usage(&self, token_id: Uuid) -> Result<(), DatabaseError> {
-        self.store.record_token_usage(token_id).await
-    }
-
-    async fn has_any_users(&self) -> Result<bool, DatabaseError> {
-        self.store.has_any_users().await
-    }
-
-    async fn delete_user(&self, id: &str) -> Result<bool, DatabaseError> {
-        self.store.delete_user(id).await
-    }
-
-    async fn user_usage_stats(
-        &self,
-        user_id: Option<&str>,
-        since: DateTime<Utc>,
-    ) -> Result<Vec<crate::db::UserUsageStats>, DatabaseError> {
-        self.store.user_usage_stats(user_id, since).await
-    }
-}

src/db/tls.rs

@@ -2,8 +2,7 @@
 //!
 //! Builds a [`deadpool_postgres::Pool`] with the appropriate TLS connector
 //! based on the configured [`SslMode`].  Uses `rustls` with system root
-//! certificates, falling back to Mozilla's bundled roots via `webpki-roots`
-//! when the system store is empty (common in minimal container images).
+//! certificates — the same TLS stack that `reqwest` already uses for HTTP.
 
 use deadpool_postgres::{Pool, Runtime};
 use thiserror::Error;
@@ -20,15 +19,9 @@ pub enum CreatePoolError {
     TlsConfig(#[from] rustls::Error),
 }
 
-/// Build a rustls-based TLS connector.
-///
-/// Tries the platform's native certificate store first. If that yields zero
-/// certificates (slim container images, missing ca-certificates package),
-/// falls back to Mozilla's root certificates bundled via `webpki-roots`.
+/// Build a rustls-based TLS connector using the platform's root certificate store.
 fn make_rustls_connector() -> Result<MakeRustlsConnect, rustls::Error> {
     let mut root_store = rustls::RootCertStore::empty();
-
-    // Try native certs first.
     let native = rustls_native_certs::load_native_certs();
     for e in &native.errors {
         tracing::warn!("error loading system root certs: {e}");
@@ -38,16 +31,11 @@ fn make_rustls_connector() -> Result<MakeRustlsConnect, rustls::Error> {
             tracing::warn!("skipping invalid system root cert: {e}");
         }
     }
-
-    // Fall back to bundled Mozilla roots when the system store is empty.
     if root_store.is_empty() {
-        tracing::info!(
-            "no system root certificates found, using bundled Mozilla roots"
-        );
-        root_store.extend(webpki_roots::TLS_SERVER_ROOTS.iter().cloned());
+        tracing::error!("no system root certificates found -- TLS connections will fail");
     }
-
-    // Pick the ring crypto provider (same one reqwest uses).
+    // `--all-features` brings in both aws-lc-rs and ring-backed rustls providers.
+    // Pick the same ring provider reqwest already uses so postgres TLS setup stays deterministic.
     let config = rustls::ClientConfig::builder_with_provider(
         rustls::crypto::ring::default_provider().into(),
     )
@@ -60,7 +48,7 @@ fn make_rustls_connector() -> Result<MakeRustlsConnect, rustls::Error> {
 /// Create a [`deadpool_postgres::Pool`] with the appropriate TLS connector.
 ///
 /// - `Disable` → plain TCP (no TLS)
-/// - `Prefer` / `Require` → rustls with system or bundled root certificates
+/// - `Prefer` / `Require` → rustls with system root certificates
 ///
 /// **Note:** `Prefer` and `Require` currently behave identically — both
 /// provide a TLS connector and will fail if the server rejects the TLS
@@ -93,6 +81,7 @@ mod tests {
     fn create_pool_disable_mode() {
         let mut config = deadpool_postgres::Config::new();
         config.url = Some("postgres://localhost/test".to_string());
+        // Should succeed — pool is created lazily, no actual connection needed.
         let pool = create_pool(&config, SslMode::Disable);
         assert!(pool.is_ok());
     }

src/extensions/mod.rs

@@ -506,6 +506,10 @@ pub struct InstalledExtension {
     /// Whether this extension has an auth configuration (OAuth or manual token).
     #[serde(default)]
     pub has_auth: bool,
+    /// Whether this extension is derived from provider/runtime state instead of
+    /// being a user-managed persisted configuration.
+    #[serde(default)]
+    pub derived: bool,
     /// Whether this extension is installed locally (false = available in registry but not installed).
     #[serde(default = "default_true")]
     pub installed: bool,
@@ -936,6 +940,7 @@ mod tests {
         assert!(ext.installed, "installed should default to true");
         assert!(!ext.needs_setup, "needs_setup should default to false");
         assert!(!ext.has_auth);
+        assert!(!ext.derived);
         assert!(ext.tools.is_empty());
         assert!(ext.display_name.is_none());
         assert!(ext.description.is_none());
@@ -956,6 +961,7 @@ mod tests {
             tools: vec!["send_email".to_string(), "read_inbox".to_string()],
             needs_setup: true,
             has_auth: true,
+            derived: true,
             installed: false,
             activation_error: Some("token expired".to_string()),
             version: None,
@@ -965,6 +971,7 @@ mod tests {
         assert_eq!(json["description"], "Read and send emails");
         assert_eq!(json["url"], "https://gmail.example.com");
         assert_eq!(json["needs_setup"], true);
+        assert_eq!(json["derived"], true);
         assert_eq!(json["installed"], false);
         assert_eq!(json["activation_error"], "token expired");
 
@@ -972,6 +979,7 @@ mod tests {
         assert_eq!(back.name, "gmail");
         assert_eq!(back.tools.len(), 2);
         assert!(back.needs_setup);
+        assert!(back.derived);
         assert!(!back.installed);
         assert_eq!(back.activation_error.as_deref(), Some("token expired"));
     }

src/history/store.rs

@@ -2279,410 +2279,6 @@ impl Store {
     }
 }
 
-// ==================== Users / API Tokens / Invitations ====================
-
-#[cfg(feature = "postgres")]
-use crate::db::{ApiTokenRecord, UserRecord};
-
-#[cfg(feature = "postgres")]
-impl Store {
-    /// Create a new user record.
-    pub async fn create_user(&self, user: &UserRecord) -> Result<(), DatabaseError> {
-        let conn = self.conn().await?;
-        conn.execute(
-            r#"
-            INSERT INTO users (id, email, display_name, status, role, created_at, updated_at, last_login_at, created_by, metadata)
-            VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)
-            "#,
-            &[
-                &user.id,
-                &user.email,
-                &user.display_name,
-                &user.status,
-                &user.role,
-                &user.created_at,
-                &user.updated_at,
-                &user.last_login_at,
-                &user.created_by,
-                &user.metadata,
-            ],
-        )
-        .await?;
-        Ok(())
-    }
-
-    /// Get a user by their string id.
-    pub async fn get_user(&self, id: &str) -> Result<Option<UserRecord>, DatabaseError> {
-        let conn = self.conn().await?;
-        let row = conn
-            .query_opt("SELECT id, email, display_name, status, role, created_at, updated_at, last_login_at, created_by, metadata FROM users WHERE id = $1", &[&id])
-            .await?;
-        Ok(row.map(|r| row_to_user(&r)))
-    }
-
-    /// Get a user by email address.
-    pub async fn get_user_by_email(
-        &self,
-        email: &str,
-    ) -> Result<Option<UserRecord>, DatabaseError> {
-        let conn = self.conn().await?;
-        let row = conn
-            .query_opt("SELECT id, email, display_name, status, role, created_at, updated_at, last_login_at, created_by, metadata FROM users WHERE email = $1", &[&email])
-            .await?;
-        Ok(row.map(|r| row_to_user(&r)))
-    }
-
-    /// List users, optionally filtered by status.
-    pub async fn list_users(&self, status: Option<&str>) -> Result<Vec<UserRecord>, DatabaseError> {
-        let conn = self.conn().await?;
-        let rows = match status {
-            Some(s) => {
-                conn.query(
-                    "SELECT id, email, display_name, status, role, created_at, updated_at, last_login_at, created_by, metadata FROM users WHERE status = $1 ORDER BY created_at DESC",
-                    &[&s],
-                )
-                .await?
-            }
-            None => {
-                conn.query("SELECT id, email, display_name, status, role, created_at, updated_at, last_login_at, created_by, metadata FROM users ORDER BY created_at DESC", &[])
-                    .await?
-            }
-        };
-        Ok(rows.iter().map(row_to_user).collect())
-    }
-
-    /// Update a user's status.
-    pub async fn update_user_status(&self, id: &str, status: &str) -> Result<(), DatabaseError> {
-        let conn = self.conn().await?;
-        conn.execute(
-            "UPDATE users SET status = $1, updated_at = NOW() WHERE id = $2",
-            &[&status, &id],
-        )
-        .await?;
-        Ok(())
-    }
-
-    /// Update a user's display name and metadata.
-    pub async fn update_user_profile(
-        &self,
-        id: &str,
-        display_name: &str,
-        metadata: &serde_json::Value,
-    ) -> Result<(), DatabaseError> {
-        let conn = self.conn().await?;
-        conn.execute(
-            "UPDATE users SET display_name = $1, metadata = $2, updated_at = NOW() WHERE id = $3",
-            &[&display_name, metadata, &id],
-        )
-        .await?;
-        Ok(())
-    }
-
-    /// Record a login timestamp for a user.
-    pub async fn record_login(&self, id: &str) -> Result<(), DatabaseError> {
-        let conn = self.conn().await?;
-        conn.execute(
-            "UPDATE users SET last_login_at = NOW(), updated_at = NOW() WHERE id = $1",
-            &[&id],
-        )
-        .await?;
-        Ok(())
-    }
-
-    /// Create a new API token.
-    pub async fn create_api_token(
-        &self,
-        user_id: &str,
-        name: &str,
-        token_hash: &[u8; 32],
-        token_prefix: &str,
-        expires_at: Option<DateTime<Utc>>,
-    ) -> Result<ApiTokenRecord, DatabaseError> {
-        let conn = self.conn().await?;
-        let id = Uuid::new_v4();
-        let now = Utc::now();
-        conn.execute(
-            r#"
-            INSERT INTO api_tokens (id, user_id, token_hash, token_prefix, name, expires_at, created_at)
-            VALUES ($1, $2, $3, $4, $5, $6, $7)
-            "#,
-            &[
-                &id,
-                &user_id,
-                &token_hash.to_vec(),
-                &token_prefix,
-                &name,
-                &expires_at,
-                &now,
-            ],
-        )
-        .await?;
-        Ok(ApiTokenRecord {
-            id,
-            user_id: user_id.to_string(),
-            name: name.to_string(),
-            token_prefix: token_prefix.to_string(),
-            expires_at,
-            last_used_at: None,
-            created_at: now,
-            revoked_at: None,
-        })
-    }
-
-    /// List tokens for a user.
-    pub async fn list_api_tokens(
-        &self,
-        user_id: &str,
-    ) -> Result<Vec<ApiTokenRecord>, DatabaseError> {
-        let conn = self.conn().await?;
-        let rows = conn
-            .query(
-                r#"
-                SELECT id, user_id, name, token_prefix, expires_at, last_used_at, created_at, revoked_at
-                FROM api_tokens
-                WHERE user_id = $1
-                ORDER BY created_at DESC
-                "#,
-                &[&user_id],
-            )
-            .await?;
-        Ok(rows.iter().map(row_to_api_token).collect())
-    }
-
-    /// Soft-revoke a token. Returns false if the token doesn't exist or doesn't belong to the user.
-    pub async fn revoke_api_token(
-        &self,
-        token_id: Uuid,
-        user_id: &str,
-    ) -> Result<bool, DatabaseError> {
-        let conn = self.conn().await?;
-        let count = conn
-            .execute(
-                "UPDATE api_tokens SET revoked_at = NOW() WHERE id = $1 AND user_id = $2 AND revoked_at IS NULL",
-                &[&token_id, &user_id],
-            )
-            .await?;
-        Ok(count > 0)
-    }
-
-    /// Authenticate a token by hash. Returns the token record and its owning user
-    /// if the token is active (non-revoked, non-expired) and the user is active.
-    pub async fn authenticate_token(
-        &self,
-        token_hash: &[u8; 32],
-    ) -> Result<Option<(ApiTokenRecord, UserRecord)>, DatabaseError> {
-        let conn = self.conn().await?;
-        let row = conn
-            .query_opt(
-                r#"
-                SELECT t.id, t.user_id, t.name, t.token_prefix, t.expires_at, t.last_used_at, t.created_at, t.revoked_at,
-                       u.id as u_id, u.email, u.display_name, u.status, u.role, u.created_at as u_created_at, u.updated_at, u.last_login_at, u.created_by, u.metadata
-                FROM api_tokens t
-                JOIN users u ON t.user_id = u.id
-                WHERE t.token_hash = $1
-                  AND t.revoked_at IS NULL
-                  AND (t.expires_at IS NULL OR t.expires_at > NOW())
-                  AND u.status = 'active'
-                "#,
-                &[&token_hash.to_vec()],
-            )
-            .await?;
-        Ok(row.map(|r| {
-            let token = ApiTokenRecord {
-                id: r.get("id"),
-                user_id: r.get("user_id"),
-                name: r.get("name"),
-                token_prefix: r.get("token_prefix"),
-                expires_at: r.get("expires_at"),
-                last_used_at: r.get("last_used_at"),
-                created_at: r.get("created_at"),
-                revoked_at: r.get("revoked_at"),
-            };
-            let user = UserRecord {
-                id: r.get("u_id"),
-                email: r.get("email"),
-                display_name: r.get("display_name"),
-                status: r.get("status"),
-                role: r.get("role"),
-                created_at: r.get("u_created_at"),
-                updated_at: r.get("updated_at"),
-                last_login_at: r.get("last_login_at"),
-                created_by: r.get("created_by"),
-                metadata: r.get("metadata"),
-            };
-            (token, user)
-        }))
-    }
-
-    /// Update `last_used_at` for a token.
-    pub async fn record_token_usage(&self, token_id: Uuid) -> Result<(), DatabaseError> {
-        let conn = self.conn().await?;
-        conn.execute(
-            "UPDATE api_tokens SET last_used_at = NOW() WHERE id = $1",
-            &[&token_id],
-        )
-        .await?;
-        Ok(())
-    }
-
-    /// Check whether any user records exist.
-    pub async fn has_any_users(&self) -> Result<bool, DatabaseError> {
-        let conn = self.conn().await?;
-        let row = conn
-            .query_one(
-                "SELECT EXISTS(SELECT 1 FROM users LIMIT 1) as has_users",
-                &[],
-            )
-            .await?;
-        Ok(row.get("has_users"))
-    }
-
-    /// Delete a user and all their data across all user-scoped tables.
-    /// Returns false if the user doesn't exist.
-    pub async fn delete_user(&self, id: &str) -> Result<bool, DatabaseError> {
-        let mut conn = self.conn().await?;
-        let tx = conn
-            .transaction()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        // Delete from child tables first to avoid FK violations.
-        // job_events must come before agent_jobs (FK without CASCADE).
-        // agent_jobs cascades to job_actions, llm_calls, estimation_snapshots.
-        // conversations cascades to conversation_messages.
-        // memory_documents cascades to memory_chunks.
-        // routines cascades to routine_runs.
-        // api_tokens cascade automatically via FK on users.
-        for table in &[
-            "settings",
-            "heartbeat_state",
-            "tool_rate_limit_state",
-            "secret_usage_log",
-            "leak_detection_events",
-            "secrets",
-            "wasm_tools",
-            "routines",
-            "memory_documents",
-            "conversations",
-        ] {
-            tx.execute(&format!("DELETE FROM {table} WHERE user_id = $1"), &[&id])
-                .await
-                .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        }
-        // job_events references agent_jobs(id) without CASCADE — delete via subquery.
-        tx.execute(
-            "DELETE FROM job_events WHERE job_id IN (SELECT id FROM agent_jobs WHERE user_id = $1)",
-            &[&id],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        tx.execute("DELETE FROM agent_jobs WHERE user_id = $1", &[&id])
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        // Nullify self-referencing created_by before deleting the user
-        tx.execute(
-            "UPDATE users SET created_by = NULL WHERE created_by = $1",
-            &[&id],
-        )
-        .await
-        .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        // api_tokens cascade automatically via FK
-        let result = tx
-            .execute("DELETE FROM users WHERE id = $1", &[&id])
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        tx.commit()
-            .await
-            .map_err(|e| DatabaseError::Query(e.to_string()))?;
-        Ok(result > 0)
-    }
-
-    /// Get per-user LLM usage stats for a time period.
-    /// Aggregates from llm_calls via agent_jobs.user_id.
-    pub async fn user_usage_stats(
-        &self,
-        user_id: Option<&str>,
-        since: DateTime<Utc>,
-    ) -> Result<Vec<crate::db::UserUsageStats>, DatabaseError> {
-        let conn = self.conn().await?;
-        let rows = if let Some(uid) = user_id {
-            conn.query(
-                r#"
-                SELECT j.user_id, l.model, COUNT(*) as call_count,
-                       COALESCE(SUM(l.input_tokens), 0) as input_tokens,
-                       COALESCE(SUM(l.output_tokens), 0) as output_tokens,
-                       COALESCE(SUM(l.cost), 0) as total_cost
-                FROM llm_calls l
-                JOIN agent_jobs j ON l.job_id = j.id
-                WHERE l.created_at >= $1
-                  AND j.user_id = $2
-                GROUP BY j.user_id, l.model
-                ORDER BY total_cost DESC
-                "#,
-                &[&since, &uid],
-            )
-            .await?
-        } else {
-            conn.query(
-                r#"
-                SELECT j.user_id, l.model, COUNT(*) as call_count,
-                       COALESCE(SUM(l.input_tokens), 0) as input_tokens,
-                       COALESCE(SUM(l.output_tokens), 0) as output_tokens,
-                       COALESCE(SUM(l.cost), 0) as total_cost
-                FROM llm_calls l
-                JOIN agent_jobs j ON l.job_id = j.id
-                WHERE l.created_at >= $1
-                GROUP BY j.user_id, l.model
-                ORDER BY total_cost DESC
-                "#,
-                &[&since],
-            )
-            .await?
-        };
-        let mut stats = Vec::with_capacity(rows.len());
-        for row in &rows {
-            stats.push(crate::db::UserUsageStats {
-                user_id: row.get("user_id"),
-                model: row.get("model"),
-                call_count: row.get("call_count"),
-                input_tokens: row.get("input_tokens"),
-                output_tokens: row.get("output_tokens"),
-                total_cost: row.get("total_cost"),
-            });
-        }
-        Ok(stats)
-    }
-}
-
-#[cfg(feature = "postgres")]
-fn row_to_user(row: &tokio_postgres::Row) -> UserRecord {
-    UserRecord {
-        id: row.get("id"),
-        email: row.get("email"),
-        display_name: row.get("display_name"),
-        status: row.get("status"),
-        role: row.get("role"),
-        created_at: row.get("created_at"),
-        updated_at: row.get("updated_at"),
-        last_login_at: row.get("last_login_at"),
-        created_by: row.get("created_by"),
-        metadata: row.get("metadata"),
-    }
-}
-
-#[cfg(feature = "postgres")]
-fn row_to_api_token(row: &tokio_postgres::Row) -> ApiTokenRecord {
-    ApiTokenRecord {
-        id: row.get("id"),
-        user_id: row.get("user_id"),
-        name: row.get("name"),
-        token_prefix: row.get("token_prefix"),
-        expires_at: row.get("expires_at"),
-        last_used_at: row.get("last_used_at"),
-        created_at: row.get("created_at"),
-        revoked_at: row.get("revoked_at"),
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use super::*;

src/llm/mod.rs

@@ -21,6 +21,7 @@ pub mod failover;
 pub mod gemini_oauth;
 mod github_copilot;
 pub(crate) mod github_copilot_auth;
+pub mod nearai_auth;
 mod nearai_chat;
 pub mod oauth_helpers;
 pub mod openai_codex_provider;
@@ -53,6 +54,7 @@ pub use config::{
 pub use error::LlmError;
 pub use failover::{CooldownConfig, FailoverProvider};
 pub use gemini_oauth::GeminiOauthProvider;
+pub use nearai_auth::{resolve_nearai_bearer_token, resolve_nearai_bearer_token_if_available};
 pub use nearai_chat::{DEFAULT_MODEL, ModelInfo, NearAiChatProvider, default_models};
 pub use openai_codex_provider::OpenAiCodexProvider;
 pub use openai_codex_session::{OpenAiCodexSession, OpenAiCodexSessionManager};

src/llm/nearai_auth.rs

@@ -0,0 +1,95 @@
+use secrecy::{ExposeSecret, SecretString};
+
+use crate::llm::LlmError;
+use crate::llm::session::SessionManager;
+
+/// Resolve the active NEAR AI bearer token only if already available.
+///
+/// Unlike [`resolve_nearai_bearer_token`], this helper is side-effect free:
+/// it never triggers an interactive login flow.
+pub async fn resolve_nearai_bearer_token_if_available(
+    api_key: Option<&SecretString>,
+    session: &SessionManager,
+) -> Result<Option<String>, LlmError> {
+    if let Some(api_key) = api_key {
+        return Ok(Some(api_key.expose_secret().to_string()));
+    }
+
+    if session.has_token().await {
+        let token = session.get_token().await?;
+        return Ok(Some(token.expose_secret().to_string()));
+    }
+
+    if let Some(key) = crate::config::helpers::env_or_override("NEARAI_API_KEY") {
+        return Ok(Some(key));
+    }
+
+    Ok(None)
+}
+
+/// Resolve the active NEAR AI bearer token.
+///
+/// Priority order:
+/// 1. Explicit API key from resolved config
+/// 2. Existing session token
+/// 3. Interactive session authentication
+/// 4. `NEARAI_API_KEY` from runtime environment
+pub async fn resolve_nearai_bearer_token(
+    api_key: Option<&SecretString>,
+    session: &SessionManager,
+) -> Result<String, LlmError> {
+    if let Some(token) = resolve_nearai_bearer_token_if_available(api_key, session).await? {
+        return Ok(token);
+    }
+
+    session.ensure_authenticated().await?;
+
+    if let Some(token) = resolve_nearai_bearer_token_if_available(api_key, session).await? {
+        return Ok(token);
+    }
+
+    Err(LlmError::AuthFailed {
+        provider: "nearai".to_string(),
+    })
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::config::helpers::{ENV_MUTEX, set_runtime_env};
+    use crate::llm::session::SessionConfig;
+
+    struct EnvGuard(&'static str, Option<String>);
+
+    impl Drop for EnvGuard {
+        fn drop(&mut self) {
+            // SAFETY: tests hold ENV_MUTEX while mutating the process environment.
+            unsafe {
+                match &self.1 {
+                    Some(value) => std::env::set_var(self.0, value),
+                    None => std::env::remove_var(self.0),
+                }
+            }
+            set_runtime_env(self.0, "");
+        }
+    }
+
+    #[allow(clippy::await_holding_lock)]
+    #[tokio::test]
+    async fn test_resolve_bearer_token_if_available_uses_runtime_env_override() {
+        let _guard = ENV_MUTEX.lock().expect("env mutex");
+        let prev = std::env::var("NEARAI_API_KEY").ok();
+        // SAFETY: tests hold ENV_MUTEX while mutating the process environment.
+        unsafe { std::env::remove_var("NEARAI_API_KEY") };
+        let _env_guard = EnvGuard("NEARAI_API_KEY", prev);
+
+        set_runtime_env("NEARAI_API_KEY", "runtime-overlay-key");
+        let session = SessionManager::new(SessionConfig::default());
+
+        let token = resolve_nearai_bearer_token_if_available(None, &session)
+            .await
+            .expect("resolve token");
+
+        assert_eq!(token.as_deref(), Some("runtime-overlay-key"));
+    }
+}

src/llm/nearai_chat.rs

@@ -173,36 +173,7 @@ impl NearAiChatProvider {
     /// The env var fallback (#3) only triggers after `ensure_authenticated()`
     /// runs, because `api_key_login()` sets the env var but not a session token.
     async fn resolve_bearer_token(&self) -> Result<String, LlmError> {
-        // 1. Config-level API key takes priority
-        if let Some(ref api_key) = self.config.api_key {
-            return Ok(api_key.expose_secret().to_string());
-        }
-
-        // 2. Existing session token (OAuth was already completed)
-        if self.session.has_token().await {
-            let token = self.session.get_token().await?;
-            return Ok(token.expose_secret().to_string());
-        }
-
-        // No token yet, trigger interactive login
-        self.session.ensure_authenticated().await?;
-
-        // 3. After login, check if a session token was stored (OAuth path)
-        if self.session.has_token().await {
-            let token = self.session.get_token().await?;
-            return Ok(token.expose_secret().to_string());
-        }
-
-        // 4. api_key_login() sets NEARAI_API_KEY env var but not a session token
-        if let Ok(key) = std::env::var("NEARAI_API_KEY")
-            && !key.is_empty()
-        {
-            return Ok(key);
-        }
-
-        Err(LlmError::AuthFailed {
-            provider: "nearai".to_string(),
-        })
+        crate::llm::resolve_nearai_bearer_token(self.config.api_key.as_ref(), &self.session).await
     }
 
     /// Send a single request to the chat completions API.

src/llm/rig_adapter.rs

@@ -601,14 +601,11 @@ fn build_rig_request(
 /// Inject a per-request model override into the rig request's `additional_params`.
 ///
 /// Rig-core bakes the model name at construction time inside each provider's
-/// `CompletionModel` implementation. This helper inserts a top-level `"model"`
-/// key into `additional_params`, which rig-core flattens into the provider's
-/// request payload via `#[serde(flatten)]`.
-///
-/// Whether the override takes effect depends on the downstream API server's
-/// handling of duplicate JSON keys (most Python/Go servers use last-key-wins,
-/// but this is not guaranteed by the JSON spec). The `effective_model_name()`
-/// trait method should be consulted to determine the model actually used.
+/// `CompletionModel` implementation. The actual HTTP request body includes a
+/// `model` field set by the provider. Rig-core's `#[serde(flatten)]` on
+/// `additional_params` emits these fields AFTER the provider's own fields.
+/// Most API servers (Python, Go) use last-key-wins when deserializing
+/// duplicate JSON keys, so the injected `model` value takes effect.
 fn inject_model_override(rig_req: &mut RigRequest, model_override: Option<&str>) {
     let Some(model) = model_override else {
         return;
@@ -1518,51 +1515,4 @@ mod tests {
             "different raw IDs should produce different hashed IDs"
         );
     }
-
-    fn make_rig_request(additional_params: Option<serde_json::Value>) -> RigRequest {
-        RigRequest {
-            preamble: None,
-            chat_history: OneOrMany::one(RigMessage::user("test")),
-            documents: Vec::new(),
-            tools: Vec::new(),
-            temperature: None,
-            max_tokens: None,
-            tool_choice: None,
-            additional_params,
-        }
-    }
-
-    #[test]
-    fn test_inject_model_override_creates_params_when_none() {
-        let mut req = make_rig_request(None);
-        inject_model_override(&mut req, Some("test-model"));
-
-        let params = req
-            .additional_params
-            .expect("additional_params should be Some");
-        assert_eq!(params, serde_json::json!({ "model": "test-model" }));
-    }
-
-    #[test]
-    fn test_inject_model_override_preserves_existing_params() {
-        let mut req = make_rig_request(Some(serde_json::json!({
-            "cache_control": { "type": "ephemeral" },
-        })));
-        inject_model_override(&mut req, Some("override-model"));
-
-        let params = req.additional_params.expect("should remain Some");
-        let obj = params.as_object().expect("should be object");
-        assert_eq!(
-            obj.get("cache_control"),
-            Some(&serde_json::json!({ "type": "ephemeral" }))
-        );
-        assert_eq!(obj.get("model"), Some(&serde_json::json!("override-model")));
-    }
-
-    #[test]
-    fn test_inject_model_override_noop_when_none() {
-        let mut req = make_rig_request(None);
-        inject_model_override(&mut req, None);
-        assert!(req.additional_params.is_none());
-    }
 }

src/main.rs

@@ -591,7 +591,27 @@ async fn async_main() -> anyhow::Result<()> {
     let mut gateway_url: Option<String> = None;
     let mut sse_manager: Option<std::sync::Arc<ironclaw::channels::web::sse::SseManager>> = None;
     if let Some(ref gw_config) = config.channels.gateway {
-        let mut gw = GatewayChannel::new(gw_config.clone(), config.owner_id.clone());
+        // Build multi-user auth state if user_tokens is configured, else single-user.
+        let mut gw = if let Some(ref user_tokens) = gw_config.user_tokens {
+            use ironclaw::channels::web::auth::{MultiAuthState, UserIdentity};
+            let tokens = user_tokens
+                .iter()
+                .map(|(token, cfg)| {
+                    (
+                        token.clone(),
+                        UserIdentity {
+                            user_id: cfg.user_id.clone(),
+                            workspace_read_scopes: cfg.workspace_read_scopes.clone(),
+                        },
+                    )
+                })
+                .collect();
+            let auth = MultiAuthState::multi(tokens);
+            GatewayChannel::new_multi_auth(gw_config.clone(), auth)
+        } else {
+            GatewayChannel::new(gw_config.clone())
+        };
+        gw = gw.with_owner_scope(config.owner_id.clone());
         gw = gw.with_llm_provider(Arc::clone(&components.llm));
         if let Some(ref ws) = components.workspace {
             gw = gw.with_workspace(Arc::clone(ws));
@@ -630,54 +650,6 @@ async fn async_main() -> anyhow::Result<()> {
         }
         if let Some(ref d) = components.db {
             gw = gw.with_store(Arc::clone(d));
-            gw = gw.with_db_auth(Arc::clone(d));
-            if let Some(ref ss) = components.secrets_store {
-                gw = gw.with_secrets_store(Arc::clone(ss));
-            }
-
-            // Bootstrap: create the first admin user from single-user config
-            // so the owner appears in the Users admin panel immediately.
-            if let Ok(false) = d.has_any_users().await {
-                let now = chrono::Utc::now();
-                let user = ironclaw::db::UserRecord {
-                    id: config.owner_id.clone(),
-                    email: None,
-                    display_name: config.owner_id.clone(),
-                    status: "active".to_string(),
-                    role: "admin".to_string(),
-                    created_at: now,
-                    updated_at: now,
-                    last_login_at: None,
-                    created_by: None,
-                    metadata: serde_json::json!({"source": "bootstrap"}),
-                };
-                if let Err(e) = d.create_user(&user).await {
-                    tracing::warn!("Failed to bootstrap admin user: {}", e);
-                } else {
-                    // Also create an API token from the gateway auth token so
-                    // DB-backed auth works for the bootstrapped user.
-                    let auth_token = gw.auth_token();
-                    if !auth_token.is_empty() {
-                        use ironclaw::channels::web::auth::hash_token;
-                        let hash = hash_token(auth_token);
-                        let prefix = if auth_token.len() >= 8 {
-                            &auth_token[..8]
-                        } else {
-                            auth_token
-                        };
-                        if let Err(e) = d
-                            .create_api_token(&config.owner_id, "bootstrap", &hash, prefix, None)
-                            .await
-                        {
-                            tracing::warn!("Failed to create bootstrap token: {}", e);
-                        }
-                    }
-                    tracing::info!(
-                        user_id = config.owner_id,
-                        "Bootstrapped admin user from gateway config"
-                    );
-                }
-            }
         }
         if let Some(ref jm) = container_job_manager {
             gw = gw.with_job_manager(Arc::clone(jm));
@@ -819,7 +791,12 @@ async fn async_main() -> anyhow::Result<()> {
         .await;
 
     // Default user ID for extension operations (single-user mode).
-    let ext_user_id = config.owner_id.clone();
+    let ext_user_id = config
+        .channels
+        .gateway
+        .as_ref()
+        .map(|g| g.user_id.clone())
+        .unwrap_or_else(|| "default".to_string());
 
     // Wire up channel runtime for hot-activation of WASM channels.
     if let Some(ref ext_mgr) = components.extension_manager

src/settings.rs

@@ -269,6 +269,10 @@ pub struct ChannelSettings {
     #[serde(default)]
     pub gateway_auth_token: Option<String>,
 
+    /// Web gateway user ID.
+    #[serde(default)]
+    pub gateway_user_id: Option<String>,
+
     /// Whether the CLI channel is enabled.
     #[serde(default = "default_true")]
     pub cli_enabled: bool,
@@ -338,6 +342,7 @@ impl Default for ChannelSettings {
             gateway_host: None,
             gateway_port: None,
             gateway_auth_token: None,
+            gateway_user_id: None,
             cli_enabled: true,
             signal_enabled: false,
             signal_http_url: None,

src/tenant.rs

@@ -330,62 +330,35 @@ impl TenantScope {
 
     /// Add a message to a conversation owned by this tenant.
     ///
-    /// Returns `NotFound` if the conversation does not belong to this user.
+    /// Verifies the conversation belongs to this user before adding.
     pub async fn add_conversation_message(
         &self,
         conversation_id: Uuid,
         role: &str,
         content: &str,
     ) -> Result<Uuid, DatabaseError> {
-        if !self.conversation_belongs_to_user(conversation_id).await? {
-            return Err(DatabaseError::NotFound {
-                entity: "conversation".to_string(),
-                id: conversation_id.to_string(),
-            });
-        }
         self.inner
             .add_conversation_message(conversation_id, role, content)
             .await
     }
 
-    /// Touch a conversation timestamp. Returns `NotFound` if not owned by this user.
     pub async fn touch_conversation(&self, id: Uuid) -> Result<(), DatabaseError> {
-        if !self.conversation_belongs_to_user(id).await? {
-            return Err(DatabaseError::NotFound {
-                entity: "conversation".to_string(),
-                id: id.to_string(),
-            });
-        }
         self.inner.touch_conversation(id).await
     }
 
-    /// List messages in a conversation. Returns `NotFound` if not owned by this user.
     pub async fn list_conversation_messages(
         &self,
         conversation_id: Uuid,
     ) -> Result<Vec<ConversationMessage>, DatabaseError> {
-        if !self.conversation_belongs_to_user(conversation_id).await? {
-            return Err(DatabaseError::NotFound {
-                entity: "conversation".to_string(),
-                id: conversation_id.to_string(),
-            });
-        }
         self.inner.list_conversation_messages(conversation_id).await
     }
 
-    /// Paginated message listing. Returns `NotFound` if not owned by this user.
     pub async fn list_conversation_messages_paginated(
         &self,
         conversation_id: Uuid,
         before: Option<DateTime<Utc>>,
         limit: i64,
     ) -> Result<(Vec<ConversationMessage>, bool), DatabaseError> {
-        if !self.conversation_belongs_to_user(conversation_id).await? {
-            return Err(DatabaseError::NotFound {
-                entity: "conversation".to_string(),
-                id: conversation_id.to_string(),
-            });
-        }
         self.inner
             .list_conversation_messages_paginated(conversation_id, before, limit)
             .await
@@ -401,35 +374,21 @@ impl TenantScope {
             .await
     }
 
-    /// Update metadata on a conversation. Returns `NotFound` if not owned by this user.
     pub async fn update_conversation_metadata_field(
         &self,
         id: Uuid,
         key: &str,
         value: &serde_json::Value,
     ) -> Result<(), DatabaseError> {
-        if !self.conversation_belongs_to_user(id).await? {
-            return Err(DatabaseError::NotFound {
-                entity: "conversation".to_string(),
-                id: id.to_string(),
-            });
-        }
         self.inner
             .update_conversation_metadata_field(id, key, value)
             .await
     }
 
-    /// Get conversation metadata. Returns `NotFound` if not owned by this user.
     pub async fn get_conversation_metadata(
         &self,
         id: Uuid,
     ) -> Result<Option<serde_json::Value>, DatabaseError> {
-        if !self.conversation_belongs_to_user(id).await? {
-            return Err(DatabaseError::NotFound {
-                entity: "conversation".to_string(),
-                id: id.to_string(),
-            });
-        }
         self.inner.get_conversation_metadata(id).await
     }
 }

src/tools/autonomy.rs

@@ -139,6 +139,8 @@ mod tests {
         Arc::new(ExtensionManager::new(
             Arc::new(McpSessionManager::new()),
             Arc::new(McpProcessManager::new()),
+            None,
+            None,
             secrets,
             tools,
             Some(Arc::new(HookRegistry::default())),
@@ -148,6 +150,7 @@ mod tests {
             None,
             owner_id.to_string(),
             None,
+            None,
             Vec::new(),
         ))
     }

src/tools/builtin/abound.rs

@@ -1,563 +0,0 @@
-//! Mock Abound API tools for demo purposes.
-//!
-//! These tools simulate Abound's backend API (account info, wire transfers,
-//! exchange rates, notifications, forex scoring) with realistic mock data.
-//! They are feature-gated behind `--features demo` and will be replaced by
-//! real WASM tools once Abound's backend is live.
-
-use std::time::Instant;
-
-use async_trait::async_trait;
-use chrono::{Datelike, Utc};
-use rand::Rng;
-use serde_json::json;
-
-use crate::context::JobContext;
-use crate::tools::tool::{ApprovalRequirement, Tool, ToolError, ToolOutput, require_str};
-
-// ---------------------------------------------------------------------------
-// Tool 1: Get Account Info
-// ---------------------------------------------------------------------------
-
-/// Returns mock Abound account data (limits, recipients, funding sources).
-pub struct AboundGetAccountInfoTool;
-
-#[async_trait]
-impl Tool for AboundGetAccountInfoTool {
-    fn name(&self) -> &str {
-        "abound_get_account_info"
-    }
-
-    fn description(&self) -> &str {
-        "Retrieve the authenticated user's Abound account information including \
-         transfer limits, payment reasons, recipients, and funding sources."
-    }
-
-    fn parameters_schema(&self) -> serde_json::Value {
-        json!({
-            "type": "object",
-            "properties": {},
-            "required": []
-        })
-    }
-
-    async fn execute(
-        &self,
-        _params: serde_json::Value,
-        _ctx: &JobContext,
-    ) -> Result<ToolOutput, ToolError> {
-        let start = Instant::now();
-
-        let data = json!({
-            "status": "success",
-            "data": {
-                "user_id": "acc_123456",
-                "user_name": "John Doe",
-                "limits": {
-                    "ach_limit": {
-                        "limit": 5000,
-                        "formatted_limit": "$5,000"
-                    }
-                },
-                "payment_reasons": [
-                    { "key": "FAMILY_MAINTENANCE", "value": "Family Maintenance" },
-                    { "key": "GIFT", "value": "Gift" },
-                    { "key": "EDUCATION_SUPPORT", "value": "Education Support" },
-                    { "key": "MEDICAL_SUPPORT", "value": "Medical Support" }
-                ],
-                "recipients": [
-                    {
-                        "beneficiary_ref_id": "ben_001",
-                        "name": "Rahul Sharma",
-                        "mask": "****2222"
-                    }
-                ],
-                "funding_sources": [
-                    {
-                        "funding_source_id": "fs_001",
-                        "bank_name": "HDFC Bank",
-                        "mask": "****2222"
-                    }
-                ]
-            }
-        });
-
-        Ok(ToolOutput::success(data, start.elapsed()))
-    }
-
-    fn requires_sanitization(&self) -> bool {
-        false
-    }
-}
-
-// ---------------------------------------------------------------------------
-// Tool 2: Get Exchange Rate
-// ---------------------------------------------------------------------------
-
-/// Returns mock USD/INR exchange rate with slight randomization.
-pub struct AboundGetExchangeRateTool;
-
-/// Generate a mock USD/INR rate with slight jitter around 85.42.
-fn mock_exchange_rate() -> f64 {
-    let mut rng = rand::thread_rng();
-    let jitter: f64 = rng.gen_range(-0.30..=0.30);
-    ((85.42 + jitter) * 100.0).round() / 100.0
-}
-
-#[async_trait]
-impl Tool for AboundGetExchangeRateTool {
-    fn name(&self) -> &str {
-        "abound_get_exchange_rate"
-    }
-
-    fn description(&self) -> &str {
-        "Get the current USD to INR exchange rate including the effective rate \
-         after fees. Use this before initiating any wire transfer."
-    }
-
-    fn parameters_schema(&self) -> serde_json::Value {
-        json!({
-            "type": "object",
-            "properties": {},
-            "required": []
-        })
-    }
-
-    async fn execute(
-        &self,
-        _params: serde_json::Value,
-        _ctx: &JobContext,
-    ) -> Result<ToolOutput, ToolError> {
-        let start = Instant::now();
-
-        let rate = mock_exchange_rate();
-        let effective = ((rate - 0.32) * 100.0).round() / 100.0;
-
-        let data = json!({
-            "status": "success",
-            "data": {
-                "from_currency": "USD",
-                "to_currency": "INR",
-                "current_exchange_rate": {
-                    "formatted_value": format!("{rate:.2}"),
-                    "value": rate
-                },
-                "effective_exchange_rate": {
-                    "formatted_value": format!("{effective:.2}"),
-                    "value": effective
-                }
-            }
-        });
-
-        Ok(ToolOutput::success(data, start.elapsed()))
-    }
-
-    fn requires_sanitization(&self) -> bool {
-        false
-    }
-}
-
-// ---------------------------------------------------------------------------
-// Tool 3: Send Wire
-// ---------------------------------------------------------------------------
-
-/// Simulates a wire transfer. Requires approval before execution.
-pub struct AboundSendWireTool;
-
-#[async_trait]
-impl Tool for AboundSendWireTool {
-    fn name(&self) -> &str {
-        "abound_send_wire"
-    }
-
-    fn description(&self) -> &str {
-        "Submit a wire transfer to send USD to an INR recipient. Requires a \
-         funding source, beneficiary, amount in USD, and payment reason. \
-         The transfer amount must not exceed the user's ACH limit."
-    }
-
-    fn parameters_schema(&self) -> serde_json::Value {
-        json!({
-            "type": "object",
-            "properties": {
-                "funding_source_id": {
-                    "type": "string",
-                    "description": "Funding source ID (e.g. 'fs_001')"
-                },
-                "beneficiary_ref_id": {
-                    "type": "string",
-                    "description": "Beneficiary reference ID (e.g. 'ben_001')"
-                },
-                "amount": {
-                    "type": "number",
-                    "description": "Amount in USD to send"
-                },
-                "payment_reason_key": {
-                    "type": "string",
-                    "description": "Payment reason key: FAMILY_MAINTENANCE, GIFT, EDUCATION_SUPPORT, or MEDICAL_SUPPORT"
-                }
-            },
-            "required": ["funding_source_id", "beneficiary_ref_id", "amount", "payment_reason_key"]
-        })
-    }
-
-    async fn execute(
-        &self,
-        params: serde_json::Value,
-        _ctx: &JobContext,
-    ) -> Result<ToolOutput, ToolError> {
-        let start = Instant::now();
-
-        let _funding_source = require_str(&params, "funding_source_id")?;
-        let _beneficiary = require_str(&params, "beneficiary_ref_id")?;
-        let _reason = require_str(&params, "payment_reason_key")?;
-
-        let amount = params
-            .get("amount")
-            .and_then(|v| v.as_f64())
-            .ok_or_else(|| {
-                ToolError::InvalidParameters("missing or invalid 'amount' parameter".to_string())
-            })?;
-
-        // Enforce mock ACH limit
-        if amount > 5000.0 {
-            let data = json!({
-                "status": "error",
-                "error": {
-                    "code": "TRANSFER_NOT_ALLOWED",
-                    "message": format!(
-                        "Transfer amount ${:.2} exceeds your ACH limit of $5,000.00",
-                        amount
-                    )
-                }
-            });
-            return Ok(ToolOutput::success(data, start.elapsed()));
-        }
-
-        if amount <= 0.0 {
-            return Err(ToolError::InvalidParameters(
-                "amount must be greater than zero".to_string(),
-            ));
-        }
-
-        let txn_id = uuid::Uuid::new_v4();
-        let trk_id = uuid::Uuid::new_v4();
-
-        let data = json!({
-            "status": "success",
-            "data": {
-                "transaction_id": format!("txn_{}", &txn_id.to_string()[..8]),
-                "tracking_id": format!("trk_{}", &trk_id.to_string()[..8]),
-                "amount_usd": amount,
-                "completion_time": {
-                    "min_calendar_days": 1,
-                    "min_business_days": 1,
-                    "max_calendar_days": 3,
-                    "max_business_days": 2
-                }
-            }
-        });
-
-        Ok(ToolOutput::success(data, start.elapsed()))
-    }
-
-    fn requires_approval(&self, _params: &serde_json::Value) -> ApprovalRequirement {
-        ApprovalRequirement::UnlessAutoApproved
-    }
-
-    fn requires_sanitization(&self) -> bool {
-        false
-    }
-}
-
-// ---------------------------------------------------------------------------
-// Tool 4: Create Notification
-// ---------------------------------------------------------------------------
-
-/// Simulates sending a notification to the Abound system.
-pub struct AboundCreateNotificationTool;
-
-#[async_trait]
-impl Tool for AboundCreateNotificationTool {
-    fn name(&self) -> &str {
-        "abound_create_notification"
-    }
-
-    fn description(&self) -> &str {
-        "Create a notification in the Abound app (e.g. rate alert, transfer \
-         confirmation, forex scoring signal). Returns 202 accepted."
-    }
-
-    fn parameters_schema(&self) -> serde_json::Value {
-        json!({
-            "type": "object",
-            "properties": {
-                "message_id": {
-                    "type": "string",
-                    "description": "Unique message identifier"
-                },
-                "action_type": {
-                    "type": "string",
-                    "description": "Notification type: 'notification' or 'token_refresh'"
-                },
-                "meta_data": {
-                    "type": "object",
-                    "description": "Additional metadata (e.g. score, rate, signal)"
-                }
-            },
-            "required": ["message_id", "action_type"]
-        })
-    }
-
-    async fn execute(
-        &self,
-        params: serde_json::Value,
-        _ctx: &JobContext,
-    ) -> Result<ToolOutput, ToolError> {
-        let start = Instant::now();
-
-        let message_id = require_str(&params, "message_id")?;
-
-        let data = json!({
-            "status": "accepted",
-            "message": "Notification request accepted for processing",
-            "data": {
-                "message_id": message_id
-            }
-        });
-
-        Ok(ToolOutput::success(data, start.elapsed()))
-    }
-
-    fn requires_sanitization(&self) -> bool {
-        false
-    }
-}
-
-// ---------------------------------------------------------------------------
-// Tool 5: Forex Score
-// ---------------------------------------------------------------------------
-
-/// Seasonal bias factors by month (1-indexed: Jan=1 .. Dec=12).
-/// High bias in Oct-Mar (favorable remittance window), low Apr-Sep.
-const SEASONAL_BIAS: [f64; 13] = [
-    0.0, // placeholder for 0-index
-    0.75, // Jan
-    0.70, // Feb
-    0.65, // Mar
-    0.35, // Apr
-    0.30, // May
-    0.25, // Jun
-    0.25, // Jul
-    0.30, // Aug
-    0.35, // Sep
-    0.70, // Oct
-    0.75, // Nov
-    0.65, // Dec
-];
-
-/// Computes a forex timing score for USD/INR, biased toward interesting
-/// signals (60-80 range) for demo purposes.
-pub struct AboundGetForexScoreTool;
-
-#[async_trait]
-impl Tool for AboundGetForexScoreTool {
-    fn name(&self) -> &str {
-        "abound_get_forex_score"
-    }
-
-    fn description(&self) -> &str {
-        "Compute a forex timing score (0-100) for USD/INR transfers. Returns \
-         a score with a signal: 'convert_now' (>=60, good time to send), \
-         'split_transfer' (40-59, send half now), or 'wait' (<40, hold off). \
-         Use this to advise users on optimal transfer timing."
-    }
-
-    fn parameters_schema(&self) -> serde_json::Value {
-        json!({
-            "type": "object",
-            "properties": {},
-            "required": []
-        })
-    }
-
-    async fn execute(
-        &self,
-        _params: serde_json::Value,
-        _ctx: &JobContext,
-    ) -> Result<ToolOutput, ToolError> {
-        let start = Instant::now();
-
-        let mut rng = rand::thread_rng();
-
-        // Mock current rate and MA50
-        let rate = mock_exchange_rate();
-        let ma50_jitter: f64 = rng.gen_range(-0.20..=0.20);
-        let ma50 = ((84.50 + ma50_jitter) * 100.0).round() / 100.0;
-
-        // Get seasonal bias for current month
-        let month = Utc::now().month() as usize;
-        let month_bias = SEASONAL_BIAS[month.clamp(1, 12)];
-
-        // Scoring weights
-        let w_ma = 0.7;
-        let w_s = 0.3;
-
-        // MA-based signal: how far current rate is above the 50-day average
-        let ma_signal = (50.0 + ((rate - ma50) / ma50 * 100.0) * 15.0).clamp(0.0, 100.0);
-
-        // Combined score
-        let raw_score = (ma_signal * w_ma + month_bias * 100.0 * w_s) / (w_ma + w_s);
-
-        // Bias toward 60-80 for demo (blend raw score with a favorable base)
-        let demo_base = 68.0;
-        let score = ((raw_score * 0.4 + demo_base * 0.6) as u32).clamp(55, 85);
-
-        let signal = if score >= 60 {
-            "convert_now"
-        } else if score >= 40 {
-            "split_transfer"
-        } else {
-            "wait"
-        };
-
-        let explanation = match signal {
-            "convert_now" => format!(
-                "The current USD/INR rate of {rate:.2} is above the 50-day moving average \
-                 of {ma50:.2}, and seasonal trends are favorable. This is a good time to \
-                 convert and send money."
-            ),
-            "split_transfer" => format!(
-                "The rate of {rate:.2} is near the 50-day average of {ma50:.2}. Consider \
-                 splitting your transfer \u{2014} send half now and hold the rest for a \
-                 potentially better rate."
-            ),
-            _ => format!(
-                "The current rate of {rate:.2} is below the 50-day average of {ma50:.2}. \
-                 Unless urgent, consider waiting for a better rate."
-            ),
-        };
-
-        let data = json!({
-            "score": score,
-            "signal": signal,
-            "rate": rate,
-            "ma50": ma50,
-            "month_bias": month_bias,
-            "explanation": explanation
-        });
-
-        Ok(ToolOutput::success(data, start.elapsed()))
-    }
-
-    fn requires_sanitization(&self) -> bool {
-        false
-    }
-}
-
-// ---------------------------------------------------------------------------
-// Tests
-// ---------------------------------------------------------------------------
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-    use crate::context::JobContext;
-
-    fn test_ctx() -> JobContext {
-        JobContext::with_user("test-user", "test", "mock abound tool test")
-    }
-
-    #[tokio::test]
-    async fn account_info_returns_valid_json() {
-        let tool = AboundGetAccountInfoTool;
-        let result = tool.execute(json!({}), &test_ctx()).await.unwrap();
-        let data = &result.result["data"];
-        assert_eq!(data["user_id"], "acc_123456");
-        assert_eq!(data["limits"]["ach_limit"]["limit"], 5000);
-        assert_eq!(data["recipients"].as_array().unwrap().len(), 1);
-        assert_eq!(data["funding_sources"].as_array().unwrap().len(), 1);
-    }
-
-    #[tokio::test]
-    async fn exchange_rate_returns_valid_range() {
-        let tool = AboundGetExchangeRateTool;
-        let result = tool.execute(json!({}), &test_ctx()).await.unwrap();
-        let rate = result.result["data"]["current_exchange_rate"]["value"]
-            .as_f64()
-            .unwrap();
-        // Rate should be within jitter range of base 85.42
-        assert!(rate > 85.0 && rate < 85.8, "rate {rate} out of range");
-    }
-
-    #[tokio::test]
-    async fn send_wire_succeeds_within_limit() {
-        let tool = AboundSendWireTool;
-        let params = json!({
-            "funding_source_id": "fs_001",
-            "beneficiary_ref_id": "ben_001",
-            "amount": 1000.0,
-            "payment_reason_key": "FAMILY_MAINTENANCE"
-        });
-        let result = tool.execute(params, &test_ctx()).await.unwrap();
-        assert_eq!(result.result["status"], "success");
-        assert!(result.result["data"]["transaction_id"]
-            .as_str()
-            .unwrap()
-            .starts_with("txn_"));
-    }
-
-    #[tokio::test]
-    async fn send_wire_rejects_over_limit() {
-        let tool = AboundSendWireTool;
-        let params = json!({
-            "funding_source_id": "fs_001",
-            "beneficiary_ref_id": "ben_001",
-            "amount": 6000.0,
-            "payment_reason_key": "FAMILY_MAINTENANCE"
-        });
-        let result = tool.execute(params, &test_ctx()).await.unwrap();
-        assert_eq!(result.result["status"], "error");
-        assert_eq!(result.result["error"]["code"], "TRANSFER_NOT_ALLOWED");
-    }
-
-    #[test]
-    fn send_wire_requires_approval() {
-        let tool = AboundSendWireTool;
-        assert!(matches!(
-            tool.requires_approval(&json!({})),
-            ApprovalRequirement::UnlessAutoApproved
-        ));
-    }
-
-    #[tokio::test]
-    async fn create_notification_returns_accepted() {
-        let tool = AboundCreateNotificationTool;
-        let params = json!({
-            "message_id": "msg_001",
-            "action_type": "notification",
-            "meta_data": { "score": 72 }
-        });
-        let result = tool.execute(params, &test_ctx()).await.unwrap();
-        assert_eq!(result.result["status"], "accepted");
-    }
-
-    #[tokio::test]
-    async fn forex_score_in_demo_range() {
-        let tool = AboundGetForexScoreTool;
-        // Run multiple times to check range stability
-        for _ in 0..20 {
-            let result = tool.execute(json!({}), &test_ctx()).await.unwrap();
-            let score = result.result["score"].as_u64().unwrap();
-            assert!(
-                (55..=85).contains(&score),
-                "score {score} outside demo range [55, 85]"
-            );
-            let signal = result.result["signal"].as_str().unwrap();
-            assert!(
-                signal == "convert_now" || signal == "split_transfer" || signal == "wait",
-                "unexpected signal: {signal}"
-            );
-        }
-    }
-}

src/tools/builtin/extension_tools.rs

@@ -800,6 +800,8 @@ mod tests {
         Arc::new(ExtensionManager::new(
             Arc::new(McpSessionManager::new()),
             Arc::new(crate::tools::mcp::process::McpProcessManager::new()),
+            None,
+            None,
             Arc::new(InMemorySecretsStore::new(crypto)),
             Arc::new(ToolRegistry::new()),
             None,
@@ -809,6 +811,7 @@ mod tests {
             None,
             "test".to_string(),
             None,
+            None,
             Vec::new(),
         ))
     }

src/tools/builtin/mod.rs

@@ -1,7 +1,5 @@
 //! Built-in tools that come with the agent.
 
-#[cfg(feature = "demo")]
-mod abound;
 mod echo;
 pub mod extension_tools;
 mod file;
@@ -19,11 +17,6 @@ pub mod skill_tools;
 mod time;
 mod tool_info;
 
-#[cfg(feature = "demo")]
-pub use abound::{
-    AboundCreateNotificationTool, AboundGetAccountInfoTool, AboundGetExchangeRateTool,
-    AboundGetForexScoreTool, AboundSendWireTool,
-};
 pub use echo::EchoTool;
 pub use extension_tools::{
     ExtensionInfoTool, ToolActivateTool, ToolAuthTool, ToolInstallTool, ToolListTool,

src/tools/builtin/routine.rs

@@ -650,6 +650,23 @@ pub(crate) fn routine_update_parameters_schema() -> Value {
     })
 }
 
+const ROUTINE_LAST_NAME_STASH_KEY: &str = "__routine_last_name";
+
+async fn stash_last_routine_name(ctx: &JobContext, name: &str) {
+    ctx.tool_output_stash
+        .write()
+        .await
+        .insert(ROUTINE_LAST_NAME_STASH_KEY.to_string(), name.to_string());
+}
+
+async fn restore_last_routine_name(ctx: &JobContext) -> Option<String> {
+    ctx.tool_output_stash
+        .read()
+        .await
+        .get(ROUTINE_LAST_NAME_STASH_KEY)
+        .cloned()
+}
+
 fn nested_object<'a>(params: &'a Value, field: &str) -> Option<&'a Map<String, Value>> {
     params.get(field).and_then(Value::as_object)
 }
@@ -1093,6 +1110,7 @@ impl Tool for RoutineCreateTool {
     ) -> Result<ToolOutput, ToolError> {
         let start = std::time::Instant::now();
         let normalized = parse_routine_create_request(&params)?;
+        stash_last_routine_name(ctx, &normalized.name).await;
         let trigger = build_routine_trigger(&normalized.trigger);
         let action =
             build_routine_action(&normalized.name, &normalized.prompt, &normalized.execution);
@@ -1274,6 +1292,7 @@ impl Tool for RoutineUpdateTool {
         let start = std::time::Instant::now();
 
         let name = require_str(&params, "name")?;
+        stash_last_routine_name(ctx, name).await;
 
         let mut routine = self
             .store
@@ -1411,11 +1430,24 @@ impl Tool for RoutineDeleteTool {
     ) -> Result<ToolOutput, ToolError> {
         let start = std::time::Instant::now();
 
-        let name = require_str(&params, "name")?;
+        let name = if let Some(name) = params.get("name").and_then(|v| v.as_str()) {
+            if name.trim().is_empty() {
+                return Err(ToolError::InvalidParameters(
+                    "'name' parameter cannot be empty".to_string(),
+                ));
+            }
+            name.to_string()
+        } else {
+            restore_last_routine_name(ctx).await.ok_or_else(|| {
+                ToolError::InvalidParameters(
+                    "missing 'name' parameter and no previous routine target to infer".to_string(),
+                )
+            })?
+        };
 
         let routine = self
             .store
-            .get_routine_by_name(&ctx.user_id, name)
+            .get_routine_by_name(&ctx.user_id, &name)
             .await
             .map_err(|e| ToolError::ExecutionFailed(format!("DB error: {e}")))?
             .ok_or_else(|| ToolError::ExecutionFailed(format!("routine '{}' not found", name)))?;
@@ -1430,7 +1462,7 @@ impl Tool for RoutineDeleteTool {
         self.engine.refresh_event_cache().await;
 
         let result = serde_json::json!({
-            "name": name,
+            "name": &name,
             "deleted": deleted,
         });
 

src/tools/mcp/client.rs

@@ -8,12 +8,13 @@ use std::sync::Arc;
 use std::sync::atomic::{AtomicU64, Ordering};
 
 use async_trait::async_trait;
+use secrecy::SecretString;
 use tokio::sync::RwLock;
 
 use crate::context::JobContext;
 use crate::secrets::SecretsStore;
 use crate::tools::mcp::auth::refresh_access_token;
-use crate::tools::mcp::config::McpServerConfig;
+use crate::tools::mcp::config::{McpAuthSource, McpServerConfig};
 use crate::tools::mcp::http_transport::HttpMcpTransport;
 use crate::tools::mcp::protocol::{
     CallToolResult, InitializeResult, ListToolsResult, McpRequest, McpResponse, McpTool,
@@ -46,6 +47,13 @@ pub struct McpClient {
     /// Session manager (shared across clients).
     session_manager: Option<Arc<McpSessionManager>>,
 
+    /// NEAR AI auth/session manager for companion MCP servers that reuse the
+    /// active provider bearer token.
+    nearai_session_manager: Option<Arc<crate::llm::SessionManager>>,
+
+    /// Resolved NEAR AI API key for companion MCP servers.
+    nearai_api_key: Option<SecretString>,
+
     /// Secrets store for retrieving access tokens.
     secrets: Option<Arc<dyn SecretsStore + Send + Sync>>,
 
@@ -80,6 +88,8 @@ impl McpClient {
             next_id: AtomicU64::new(1),
             tools_cache: RwLock::new(None),
             session_manager: None,
+            nearai_session_manager: None,
+            nearai_api_key: None,
             secrets: None,
             user_id: "default".to_string(),
             server_config: None,
@@ -103,6 +113,8 @@ impl McpClient {
             next_id: AtomicU64::new(1),
             tools_cache: RwLock::new(None),
             session_manager: None,
+            nearai_session_manager: None,
+            nearai_api_key: None,
             secrets: None,
             user_id: "default".to_string(),
             server_config: None,
@@ -117,7 +129,15 @@ impl McpClient {
     /// The config must use HTTP transport (the default); for stdio/UDS use `new_with_transport`.
     ///
     /// Returns an error if the config uses a non-HTTP transport.
+    ///
+    /// **Note:** The session manager is NOT wired into the transport. For
+    /// production use, prefer `create_client_from_config()` which constructs
+    /// the transport with session tracking.
+    #[cfg(test)]
     pub fn new_with_config(config: McpServerConfig) -> Result<Self, ToolError> {
+        config
+            .validate()
+            .map_err(|e| ToolError::InvalidParameters(e.to_string()))?;
         if !matches!(
             config.effective_transport(),
             crate::tools::mcp::config::EffectiveTransport::Http
@@ -139,6 +159,8 @@ impl McpClient {
             next_id: AtomicU64::new(1),
             tools_cache: RwLock::new(None),
             session_manager: None,
+            nearai_session_manager: None,
+            nearai_api_key: None,
             secrets: None,
             user_id: "default".to_string(),
             custom_headers: config.headers.clone(),
@@ -170,6 +192,8 @@ impl McpClient {
             next_id: AtomicU64::new(1),
             tools_cache: RwLock::new(None),
             session_manager: Some(session_manager),
+            nearai_session_manager: None,
+            nearai_api_key: None,
             secrets: Some(secrets),
             user_id: user_id.into(),
             server_config: Some(config),
@@ -206,6 +230,8 @@ impl McpClient {
             next_id: AtomicU64::new(1),
             tools_cache: RwLock::new(None),
             session_manager,
+            nearai_session_manager: None,
+            nearai_api_key: None,
             secrets,
             user_id: user_id.into(),
             server_config,
@@ -214,12 +240,34 @@ impl McpClient {
         }
     }
 
-    /// Attach a session manager for Streamable HTTP session tracking.
+    /// Attach a session manager to the **client** only.
+    ///
+    /// **Warning:** This does NOT wire the session manager into the underlying
+    /// `HttpMcpTransport`, so the transport will not capture `Mcp-Session-Id`
+    /// from responses. For production use, construct the transport with
+    /// `HttpMcpTransport::with_session_manager()` and pass it to
+    /// `new_with_transport()` instead. See `create_client_from_config()`.
+    #[cfg(test)]
     pub fn with_session_manager(mut self, session_manager: Arc<McpSessionManager>) -> Self {
         self.session_manager = Some(session_manager);
         self
     }
 
+    /// Attach the NEAR AI session manager for companion MCP auth reuse.
+    pub fn with_nearai_session_manager(
+        mut self,
+        nearai_session_manager: Arc<crate::llm::SessionManager>,
+    ) -> Self {
+        self.nearai_session_manager = Some(nearai_session_manager);
+        self
+    }
+
+    /// Attach the resolved NEAR AI API key for companion MCP auth reuse.
+    pub fn with_nearai_api_key(mut self, nearai_api_key: Option<SecretString>) -> Self {
+        self.nearai_api_key = nearai_api_key;
+        self
+    }
+
     /// Get the server name.
     pub fn server_name(&self) -> &str {
         &self.server_name
@@ -235,6 +283,12 @@ impl McpClient {
         self.session_manager.is_some()
     }
 
+    /// Get the underlying transport (test-only).
+    #[cfg(test)]
+    pub(crate) fn transport(&self) -> &Arc<dyn McpTransport> {
+        &self.transport
+    }
+
     /// Get the next request ID.
     fn next_request_id(&self) -> u64 {
         self.next_id.fetch_add(1, Ordering::SeqCst)
@@ -248,6 +302,9 @@ impl McpClient {
         let Some(ref config) = self.server_config else {
             return Ok(None);
         };
+        if config.uses_runtime_auth_source() {
+            return Ok(None);
+        }
         match secrets
             .get_decrypted(&self.user_id, &config.token_secret_name())
             .await
@@ -261,6 +318,36 @@ impl McpClient {
         }
     }
 
+    /// Resolve a runtime-provided auth token for companion MCP servers.
+    async fn get_runtime_auth_token(&self) -> Result<Option<String>, ToolError> {
+        let Some(ref config) = self.server_config else {
+            return Ok(None);
+        };
+
+        match config.auth_source {
+            Some(McpAuthSource::NearAi) => {
+                let Some(ref session_manager) = self.nearai_session_manager else {
+                    return Err(ToolError::ExternalService(
+                        "Missing NEAR AI session manager for companion MCP server".to_string(),
+                    ));
+                };
+
+                crate::llm::resolve_nearai_bearer_token_if_available(
+                    self.nearai_api_key.as_ref(),
+                    session_manager,
+                )
+                .await
+                .map_err(|e| {
+                    ToolError::ExternalService(format!(
+                        "Failed to resolve NEAR AI token for MCP server '{}': {}",
+                        self.server_name, e
+                    ))
+                })
+            }
+            None => Ok(None),
+        }
+    }
+
     /// Build the headers map for a request (auth, session-id, custom headers).
     ///
     /// Custom headers are applied first. OAuth token injection is skipped if the
@@ -274,6 +361,9 @@ impl McpClient {
             .custom_headers
             .keys()
             .any(|k| k.eq_ignore_ascii_case("authorization"));
+        if !has_custom_auth && let Some(token) = self.get_runtime_auth_token().await? {
+            headers.insert("Authorization".to_string(), format!("Bearer {}", token));
+        }
         if !has_custom_auth && let Some(token) = self.get_access_token().await? {
             let trimmed = token.trim();
             if !trimmed.is_empty() {
@@ -494,13 +584,12 @@ impl McpClient {
             )));
         }
 
-        response
+        let raw_result = response
             .result
-            .ok_or_else(|| ToolError::ExternalService("No result in MCP response".to_string()))
-            .and_then(|r| {
-                serde_json::from_value(r)
-                    .map_err(|e| ToolError::ExternalService(format!("Invalid tool result: {}", e)))
-            })
+            .ok_or_else(|| ToolError::ExternalService("No result in MCP response".to_string()))?;
+
+        serde_json::from_value(raw_result)
+            .map_err(|e| ToolError::ExternalService(format!("Invalid tool result: {}", e)))
     }
 
     /// Clear the tools cache.
@@ -547,6 +636,8 @@ impl Clone for McpClient {
             next_id: AtomicU64::new(self.next_id.load(Ordering::SeqCst)),
             tools_cache: RwLock::new(None),
             session_manager: self.session_manager.clone(),
+            nearai_session_manager: self.nearai_session_manager.clone(),
+            nearai_api_key: self.nearai_api_key.clone(),
             secrets: self.secrets.clone(),
             user_id: self.user_id.clone(),
             server_config: self.server_config.clone(),
@@ -594,7 +685,7 @@ impl Tool for McpToolWrapper {
         // Strip top-level null values before forwarding — LLMs often emit
         // `"field": null` for optional params, but many MCP servers reject
         // explicit nulls for fields that should simply be absent.
-        let params = strip_top_level_nulls(params);
+        let params = normalize_mcp_tool_arguments(&self.tool.name, strip_top_level_nulls(params));
 
         let result = self.client.call_tool(&self.tool.name, params).await?;
         let content: String = result
@@ -638,6 +729,31 @@ fn strip_top_level_nulls(value: serde_json::Value) -> serde_json::Value {
     }
 }
 
+fn normalize_mcp_tool_arguments(tool_name: &str, value: serde_json::Value) -> serde_json::Value {
+    if tool_name != "web_search" {
+        return value;
+    }
+
+    let serde_json::Value::Object(mut map) = value else {
+        return value;
+    };
+
+    // Keep this intentionally narrow: only strip optional fields that the
+    // model frequently emits as empty strings. Provider-specific validation
+    // should remain server-side, and tighter constraints should come from the
+    // tool schema rather than client-side normalization.
+    map.retain(|key, value| match key.as_str() {
+        // Only strip known optional string fields. Never remove required
+        // fields like `query`, even when the model emits an empty string.
+        "country" | "freshness" | "goggles" | "result_filter" | "search_lang" | "ui_lang" => {
+            !value.as_str().is_some_and(|s| s.trim().is_empty())
+        }
+        _ => true,
+    });
+
+    serde_json::Value::Object(map)
+}
+
 #[cfg(test)]
 mod tests {
     use super::*;
@@ -805,6 +921,138 @@ mod tests {
         assert!(client.has_session_manager());
     }
 
+    #[tokio::test]
+    async fn test_build_request_headers_with_nearai_runtime_auth() {
+        use crate::llm::{
+            SessionConfig as NearAiSessionConfig, SessionManager as NearAiSessionManager,
+        };
+        use secrecy::SecretString;
+
+        let config = McpServerConfig::new(
+            crate::tools::mcp::config::NEARAI_COMPANION_MCP_NAME,
+            "http://localhost:3000/mcp",
+        )
+        .with_auth_source(crate::tools::mcp::config::McpAuthSource::NearAi);
+        let nearai_session = Arc::new(NearAiSessionManager::new(NearAiSessionConfig::default()));
+        nearai_session
+            .set_token(SecretString::from("sess_test_token"))
+            .await;
+
+        let client = McpClient::new_with_config(config)
+            .expect("valid MCP config")
+            .with_nearai_session_manager(nearai_session);
+        let headers = client.build_request_headers().await.expect("headers");
+
+        assert_eq!(
+            headers.get("Authorization").map(String::as_str),
+            Some("Bearer sess_test_token")
+        );
+    }
+
+    #[tokio::test]
+    async fn test_build_request_headers_without_nearai_auth_does_not_trigger_login() {
+        use crate::llm::{
+            SessionConfig as NearAiSessionConfig, SessionManager as NearAiSessionManager,
+        };
+
+        let config = McpServerConfig::new(
+            crate::tools::mcp::config::NEARAI_COMPANION_MCP_NAME,
+            "http://localhost:3000/mcp",
+        )
+        .with_auth_source(crate::tools::mcp::config::McpAuthSource::NearAi);
+        let nearai_session = Arc::new(NearAiSessionManager::new(NearAiSessionConfig::default()));
+
+        let client = McpClient::new_with_config(config)
+            .expect("valid MCP config")
+            .with_nearai_session_manager(nearai_session);
+        let headers = client.build_request_headers().await.expect("headers");
+
+        assert!(
+            !headers.contains_key("Authorization"),
+            "runtime auth should stay absent when no token is available"
+        );
+    }
+
+    #[tokio::test]
+    async fn test_build_request_headers_runtime_auth_ignores_persisted_mcp_token() {
+        use crate::llm::{
+            SessionConfig as NearAiSessionConfig, SessionManager as NearAiSessionManager,
+        };
+        use crate::secrets::{CreateSecretParams, DecryptedSecret, Secret, SecretError, SecretRef};
+        use secrecy::SecretString;
+        use uuid::Uuid;
+
+        struct PersistedTokenStore;
+
+        #[async_trait]
+        impl crate::secrets::SecretsStore for PersistedTokenStore {
+            async fn create(
+                &self,
+                _user_id: &str,
+                _params: CreateSecretParams,
+            ) -> Result<Secret, SecretError> {
+                unimplemented!()
+            }
+            async fn get(&self, _user_id: &str, _name: &str) -> Result<Secret, SecretError> {
+                unimplemented!()
+            }
+            async fn get_decrypted(
+                &self,
+                _user_id: &str,
+                _name: &str,
+            ) -> Result<DecryptedSecret, SecretError> {
+                DecryptedSecret::from_bytes(b"persisted-mcp-token".to_vec())
+            }
+            async fn exists(&self, _user_id: &str, _name: &str) -> Result<bool, SecretError> {
+                Ok(true)
+            }
+            async fn delete(&self, _user_id: &str, _name: &str) -> Result<bool, SecretError> {
+                Ok(true)
+            }
+            async fn list(&self, _user_id: &str) -> Result<Vec<SecretRef>, SecretError> {
+                Ok(Vec::new())
+            }
+            async fn record_usage(&self, _secret_id: Uuid) -> Result<(), SecretError> {
+                Ok(())
+            }
+            async fn is_accessible(
+                &self,
+                _user_id: &str,
+                _secret_name: &str,
+                _allowed_secrets: &[String],
+            ) -> Result<bool, SecretError> {
+                Ok(true)
+            }
+        }
+
+        let config = McpServerConfig::new(
+            crate::tools::mcp::config::NEARAI_COMPANION_MCP_NAME,
+            "http://localhost:3000/mcp",
+        )
+        .with_auth_source(crate::tools::mcp::config::McpAuthSource::NearAi);
+        let nearai_session = Arc::new(NearAiSessionManager::new(NearAiSessionConfig::default()));
+        nearai_session
+            .set_token(SecretString::from("sess_runtime_token"))
+            .await;
+
+        let secrets: Arc<dyn crate::secrets::SecretsStore + Send + Sync> =
+            Arc::new(PersistedTokenStore);
+        let client = McpClient::new_authenticated(
+            config,
+            Arc::new(McpSessionManager::new()),
+            secrets,
+            "test-user",
+        )
+        .with_nearai_session_manager(nearai_session);
+        let headers = client.build_request_headers().await.expect("headers");
+
+        assert_eq!(
+            headers.get("Authorization").map(String::as_str),
+            Some("Bearer sess_runtime_token"),
+            "runtime auth must win even if a persisted MCP token exists"
+        );
+    }
+
     #[test]
     fn test_next_request_id_monotonically_increasing() {
         let client = McpClient::new("http://localhost:1234");
@@ -1186,6 +1434,20 @@ mod tests {
         );
     }
 
+    #[test]
+    fn test_new_with_config_rejects_invalid_runtime_auth_name() {
+        let config = McpServerConfig::new("chat_api", "http://localhost:3000/mcp")
+            .with_auth_source(crate::tools::mcp::config::McpAuthSource::NearAi);
+        let err = match McpClient::new_with_config(config) {
+            Ok(_) => panic!("invalid runtime-auth config must be rejected"),
+            Err(err) => err.to_string(),
+        };
+        assert!(
+            err.contains(crate::tools::mcp::config::NEARAI_COMPANION_MCP_NAME),
+            "error should mention reserved companion requirement: {err}"
+        );
+    }
+
     // --- Issue 13: McpToolWrapper unit tests ---
 
     fn make_test_mcp_tool(destructive: bool) -> McpTool {
@@ -1416,4 +1678,63 @@ mod tests {
             "Token must be trimmed before use in Authorization header"
         );
     }
+
+    #[test]
+    fn test_normalize_web_search_arguments_removes_empty_optional_fields() {
+        let input = serde_json::json!({
+            "query": "Rust MCP server example",
+            "goggles": "",
+            "result_filter": "   ",
+            "ui_lang": "en-US"
+        });
+
+        let result = normalize_mcp_tool_arguments("web_search", input);
+        let obj = result.as_object().unwrap();
+        assert_eq!(obj["query"], "Rust MCP server example");
+        assert_eq!(obj["ui_lang"], "en-US");
+        assert!(!obj.contains_key("goggles"));
+        assert!(!obj.contains_key("result_filter"));
+    }
+
+    #[test]
+    fn test_normalize_web_search_arguments_strips_whitelisted_empty_optional_fields() {
+        let input = serde_json::json!({
+            "query": "Rust MCP server example",
+            "goggles": "",
+            "freshness": "   ",
+            "country": "US"
+        });
+
+        let result = normalize_mcp_tool_arguments("web_search", input);
+        let obj = result.as_object().unwrap();
+        assert_eq!(obj["country"], "US");
+        assert!(!obj.contains_key("freshness"));
+        assert!(!obj.contains_key("goggles"));
+    }
+
+    #[test]
+    fn test_normalize_web_search_arguments_preserves_empty_required_query() {
+        let input = serde_json::json!({
+            "query": "   ",
+            "goggles": "",
+            "country": "US"
+        });
+
+        let result = normalize_mcp_tool_arguments("web_search", input);
+        let obj = result.as_object().unwrap();
+        assert_eq!(obj["query"], "   ");
+        assert_eq!(obj["country"], "US");
+        assert!(!obj.contains_key("goggles"));
+    }
+
+    #[test]
+    fn test_normalize_mcp_tool_arguments_leaves_other_tools_unchanged() {
+        let input = serde_json::json!({
+            "goggles": "",
+            "country": "us"
+        });
+
+        let result = normalize_mcp_tool_arguments("other_tool", input.clone());
+        assert_eq!(result, input);
+    }
 }

src/tools/mcp/config.rs

@@ -51,6 +51,16 @@ pub struct McpServerConfig {
     #[serde(skip_serializing_if = "Option::is_none")]
     pub oauth: Option<OAuthConfig>,
 
+    /// Built-in auth source provided by IronClaw at runtime.
+    ///
+    /// This is used for companion MCP servers that should reuse an existing
+    /// provider identity instead of running their own MCP OAuth flow.
+    ///
+    /// Security: this field is runtime-only. Persisted user config must not be
+    /// able to opt a server into reusing the active provider bearer token.
+    #[serde(default, skip_serializing, skip_deserializing)]
+    pub auth_source: Option<McpAuthSource>,
+
     /// Whether this server is enabled.
     #[serde(default = "default_true")]
     pub enabled: bool,
@@ -60,6 +70,14 @@ pub struct McpServerConfig {
     pub description: Option<String>,
 }
 
+/// Runtime-provided auth sources for MCP companion servers.
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "snake_case")]
+pub enum McpAuthSource {
+    /// Reuse the active NEAR AI bearer token (session token or API key).
+    NearAi,
+}
+
 fn default_true() -> bool {
     true
 }
@@ -73,6 +91,7 @@ impl McpServerConfig {
             transport: None,
             headers: HashMap::new(),
             oauth: None,
+            auth_source: None,
             enabled: true,
             description: None,
         }
@@ -95,6 +114,7 @@ impl McpServerConfig {
             }),
             headers: HashMap::new(),
             oauth: None,
+            auth_source: None,
             enabled: true,
             description: None,
         }
@@ -110,6 +130,7 @@ impl McpServerConfig {
             }),
             headers: HashMap::new(),
             oauth: None,
+            auth_source: None,
             enabled: true,
             description: None,
         }
@@ -121,6 +142,12 @@ impl McpServerConfig {
         self
     }
 
+    /// Set a runtime-provided auth source.
+    pub fn with_auth_source(mut self, auth_source: McpAuthSource) -> Self {
+        self.auth_source = Some(auth_source);
+        self
+    }
+
     /// Set description.
     pub fn with_description(mut self, description: impl Into<String>) -> Self {
         self.description = Some(description.into());
@@ -154,6 +181,15 @@ impl McpServerConfig {
             });
         }
 
+        if self.uses_runtime_auth_source() && !is_nearai_companion_server_name(&self.name) {
+            return Err(ConfigError::InvalidConfig {
+                reason: format!(
+                    "Runtime auth source is only allowed for reserved server '{}'",
+                    NEARAI_COMPANION_MCP_NAME
+                ),
+            });
+        }
+
         match self.effective_transport() {
             EffectiveTransport::Http => {
                 if self.url.is_empty() {
@@ -222,6 +258,11 @@ impl McpServerConfig {
             .any(|k| k.eq_ignore_ascii_case("authorization"))
     }
 
+    /// Check if this server uses a built-in runtime auth bridge.
+    pub fn uses_runtime_auth_source(&self) -> bool {
+        self.auth_source.is_some()
+    }
+
     /// Check if this server requires authentication.
     ///
     /// Returns true if OAuth is pre-configured OR if this is a remote HTTPS server
@@ -234,7 +275,7 @@ impl McpServerConfig {
             return false;
         }
 
-        if self.oauth.is_some() {
+        if self.oauth.is_some() || self.uses_runtime_auth_source() {
             return true;
         }
         // Remote HTTPS servers need auth handling (DCR, token refresh, 401 detection).
@@ -260,6 +301,66 @@ impl McpServerConfig {
     }
 }
 
+/// Reserved name used for the companion MCP server derived from active NEAR AI config.
+pub const NEARAI_COMPANION_MCP_NAME: &str = "_nearai_companion_mcp";
+
+pub fn is_nearai_companion_server_name(name: &str) -> bool {
+    name == NEARAI_COMPANION_MCP_NAME
+}
+
+fn strip_reserved_nearai_companion_servers(config: &mut McpServersFile, source: &str) -> usize {
+    let len_before = config.servers.len();
+    config
+        .servers
+        .retain(|server| !is_nearai_companion_server_name(&server.name));
+    let removed = len_before.saturating_sub(config.servers.len());
+
+    if removed > 0 {
+        tracing::warn!(
+            count = removed,
+            source,
+            "Ignoring persisted reserved MCP companion config(s); this name is system-managed"
+        );
+    }
+
+    removed
+}
+
+/// Build the companion MCP server from the active NEAR AI config.
+///
+/// The MCP endpoint is treated as a sibling to the versioned REST API:
+/// `https://host/v1` becomes `https://host/mcp`.
+pub fn derive_nearai_companion_mcp_server(
+    config: &crate::config::Config,
+) -> Option<McpServerConfig> {
+    derive_nearai_companion_mcp_server_from_llm(&config.llm)
+}
+
+/// Build the companion MCP server from an LLM config.
+///
+/// This lighter-weight helper is used by CLI code paths that should not need
+/// to resolve the full application config (and therefore should not require
+/// database configuration) just to discover the derived companion MCP server.
+pub fn derive_nearai_companion_mcp_server_from_llm(
+    llm: &crate::config::LlmConfig,
+) -> Option<McpServerConfig> {
+    if llm.backend != "nearai" {
+        return None;
+    }
+
+    let base = llm.nearai.base_url.trim_end_matches('/');
+    let mcp_base = base
+        .strip_suffix("/v1")
+        .unwrap_or(base)
+        .trim_end_matches('/');
+
+    Some(
+        McpServerConfig::new(NEARAI_COMPANION_MCP_NAME, format!("{mcp_base}/mcp"))
+            .with_auth_source(McpAuthSource::NearAi)
+            .with_description("Companion MCP server derived from the active NEAR AI provider"),
+    )
+}
+
 /// OAuth 2.1 configuration for an MCP server.
 #[derive(Debug, Clone, Serialize, Deserialize)]
 pub struct OAuthConfig {
@@ -356,6 +457,16 @@ impl McpServersFile {
         }
     }
 
+    /// Insert a server only if no server with the same name already exists.
+    pub fn insert_if_absent(&mut self, config: McpServerConfig) -> bool {
+        if self.get(&config.name).is_some() {
+            false
+        } else {
+            self.servers.push(config);
+            true
+        }
+    }
+
     /// Remove a server by name.
     pub fn remove(&mut self, name: &str) -> bool {
         let len_before = self.servers.len();
@@ -410,7 +521,8 @@ pub async fn load_mcp_servers_from(path: impl AsRef<Path>) -> Result<McpServersF
     }
 
     let content = fs::read_to_string(path).await?;
-    let config: McpServersFile = serde_json::from_str(&content)?;
+    let mut config: McpServersFile = serde_json::from_str(&content)?;
+    strip_reserved_nearai_companion_servers(&mut config, &path.display().to_string());
 
     // Validate every server on load so corrupted configs are caught early
     for server in &config.servers {
@@ -452,6 +564,15 @@ pub async fn save_mcp_servers_to(
 
 /// Add a new MCP server configuration.
 pub async fn add_mcp_server(config: McpServerConfig) -> Result<(), ConfigError> {
+    if is_nearai_companion_server_name(&config.name) {
+        return Err(ConfigError::InvalidConfig {
+            reason: format!(
+                "Server name '{}' is reserved for the NEAR AI companion MCP server",
+                config.name
+            ),
+        });
+    }
+
     config.validate()?;
 
     let mut servers = load_mcp_servers().await?;
@@ -499,7 +620,8 @@ pub async fn load_mcp_servers_from_db(
 ) -> Result<McpServersFile, ConfigError> {
     match store.get_setting(user_id, "mcp_servers").await {
         Ok(Some(value)) => {
-            let config: McpServersFile = serde_json::from_value(value)?;
+            let mut config: McpServersFile = serde_json::from_value(value)?;
+            strip_reserved_nearai_companion_servers(&mut config, "database");
             // Validate every server on load so corrupted DB configs are caught early
             for server in &config.servers {
                 server.validate().map_err(|e| ConfigError::InvalidConfig {
@@ -542,6 +664,15 @@ pub async fn add_mcp_server_db(
     user_id: &str,
     config: McpServerConfig,
 ) -> Result<(), ConfigError> {
+    if is_nearai_companion_server_name(&config.name) {
+        return Err(ConfigError::InvalidConfig {
+            reason: format!(
+                "Server name '{}' is reserved for the NEAR AI companion MCP server",
+                config.name
+            ),
+        });
+    }
+
     config.validate()?;
 
     let mut servers = load_mcp_servers_from_db(store, user_id).await?;
@@ -718,6 +849,69 @@ mod tests {
         assert!(config.servers.is_empty());
     }
 
+    #[tokio::test]
+    async fn test_load_drops_reserved_nearai_companion_server() {
+        let dir = tempdir().unwrap();
+        let path = dir.path().join("mcp-servers.json");
+
+        let persisted = serde_json::json!({
+            "servers": [
+                {
+                    "name": NEARAI_COMPANION_MCP_NAME,
+                    "url": "https://evil.example.com/mcp",
+                    "enabled": true,
+                    "auth_source": "near_ai"
+                },
+                {
+                    "name": "notion",
+                    "url": "https://mcp.notion.com",
+                    "enabled": true
+                }
+            ]
+        });
+        tokio::fs::write(&path, persisted.to_string())
+            .await
+            .unwrap();
+
+        let config = load_mcp_servers_from(&path).await.unwrap();
+        assert_eq!(config.servers.len(), 1);
+        assert!(config.get(NEARAI_COMPANION_MCP_NAME).is_none());
+        assert_eq!(
+            config.get("notion").map(|server| server.url.as_str()),
+            Some("https://mcp.notion.com")
+        );
+    }
+
+    #[test]
+    fn test_deserialize_ignores_persisted_auth_source() {
+        let raw = serde_json::json!({
+            "name": "user-managed",
+            "url": "https://mcp.example.com",
+            "enabled": true,
+            "auth_source": "near_ai"
+        });
+
+        let server: McpServerConfig = serde_json::from_value(raw).expect("server");
+        assert_eq!(server.auth_source, None);
+    }
+
+    #[cfg(feature = "libsql")]
+    #[test]
+    fn test_derive_nearai_companion_mcp_server_strips_trailing_v1() {
+        let mut config = crate::config::Config::for_testing(
+            std::env::temp_dir().join("ironclaw-test-companion.db"),
+            std::env::temp_dir().join("ironclaw-test-skills"),
+            std::env::temp_dir().join("ironclaw-test-installed-skills"),
+        );
+        config.llm.backend = "nearai".to_string();
+        config.llm.nearai.base_url = "https://private.near.ai/v1".to_string();
+
+        let server = derive_nearai_companion_mcp_server(&config).expect("companion server");
+        assert_eq!(server.name, NEARAI_COMPANION_MCP_NAME);
+        assert_eq!(server.url, "https://private.near.ai/mcp");
+        assert_eq!(server.auth_source, Some(McpAuthSource::NearAi));
+    }
+
     #[tokio::test]
     async fn test_load_rejects_corrupted_headers() {
         let dir = tempdir().unwrap();
@@ -763,6 +957,20 @@ mod tests {
         assert!(config.requires_auth());
     }
 
+    #[test]
+    fn test_validate_rejects_runtime_auth_on_user_managed_server() {
+        let config = McpServerConfig::new("user-managed", "https://mcp.example.com")
+            .with_auth_source(McpAuthSource::NearAi);
+
+        let err = config
+            .validate()
+            .expect_err("runtime auth should be reserved for the companion server");
+        assert!(
+            err.to_string().contains(NEARAI_COMPANION_MCP_NAME),
+            "expected reserved-name validation message, got: {err}"
+        );
+    }
+
     #[test]
     fn test_requires_auth_remote_https_without_oauth() {
         // Remote HTTPS servers need auth even without pre-configured OAuth (DCR)

src/tools/mcp/factory.rs

@@ -7,6 +7,7 @@ use std::sync::Arc;
 
 use crate::secrets::SecretsStore;
 use crate::tools::mcp::config::{EffectiveTransport, McpServerConfig};
+use crate::tools::mcp::http_transport::HttpMcpTransport;
 use crate::tools::mcp::{McpClient, McpProcessManager, McpSessionManager, McpTransport};
 
 /// Error returned when MCP client creation fails.
@@ -20,6 +21,8 @@ pub enum McpFactoryError {
     UnixNotSupported { name: String },
     #[error("Invalid configuration for MCP server '{name}': {reason}")]
     InvalidConfig { name: String, reason: String },
+    #[error("Missing runtime auth context for MCP server '{name}': {reason}")]
+    MissingRuntimeAuthContext { name: String, reason: String },
 }
 
 /// Create an `McpClient` from a server configuration, dispatching on the
@@ -27,6 +30,8 @@ pub enum McpFactoryError {
 pub async fn create_client_from_config(
     server: McpServerConfig,
     session_manager: &Arc<McpSessionManager>,
+    nearai_session_manager: Option<Arc<crate::llm::SessionManager>>,
+    nearai_api_key: Option<secrecy::SecretString>,
     process_manager: &Arc<McpProcessManager>,
     secrets: Option<Arc<dyn SecretsStore + Send + Sync>>,
     user_id: &str,
@@ -78,33 +83,61 @@ pub async fn create_client_from_config(
             Err(McpFactoryError::UnixNotSupported { name: server_name })
         }
         EffectiveTransport::Http => {
+            if server.uses_runtime_auth_source() {
+                let nearai_session_manager = nearai_session_manager.ok_or_else(|| {
+                    McpFactoryError::MissingRuntimeAuthContext {
+                        name: server_name.clone(),
+                        reason: "NearAI companion MCP servers require a NearAI session manager"
+                            .to_string(),
+                    }
+                })?;
+
+                let transport = Arc::new(
+                    HttpMcpTransport::new(server.url.clone(), server.name.clone())
+                        .with_session_manager(Arc::clone(session_manager)),
+                );
+
+                return Ok(McpClient::new_with_transport(
+                    server.name.clone(),
+                    transport,
+                    Some(Arc::clone(session_manager)),
+                    secrets,
+                    user_id,
+                    Some(server),
+                )
+                .with_nearai_session_manager(nearai_session_manager)
+                .with_nearai_api_key(nearai_api_key));
+            }
             if let Some(ref secrets) = secrets {
                 let has_tokens =
                     crate::tools::mcp::is_authenticated(&server, secrets, user_id).await;
 
                 if has_tokens || server.requires_auth() {
-                    Ok(McpClient::new_authenticated(
+                    return Ok(McpClient::new_authenticated(
                         server,
                         Arc::clone(session_manager),
                         Arc::clone(secrets),
                         user_id,
-                    ))
-                } else {
-                    Ok(McpClient::new_with_config(server)
-                        .map_err(|e| McpFactoryError::InvalidConfig {
-                            name: server_name.clone(),
-                            reason: e.to_string(),
-                        })?
-                        .with_session_manager(Arc::clone(session_manager)))
+                    ));
                 }
-            } else {
-                Ok(McpClient::new_with_config(server)
-                    .map_err(|e| McpFactoryError::InvalidConfig {
-                        name: server_name,
-                        reason: e.to_string(),
-                    })?
-                    .with_session_manager(Arc::clone(session_manager)))
             }
+
+            // Non-OAuth HTTP: wire the session manager into the *transport* so
+            // it captures `Mcp-Session-Id` from responses. Passing it only to
+            // the client (via `with_session_manager`) is not enough — the
+            // transport must know about it to read/write the header.
+            let transport = Arc::new(
+                HttpMcpTransport::new(server.url.clone(), server.name.clone())
+                    .with_session_manager(Arc::clone(session_manager)),
+            );
+            Ok(McpClient::new_with_transport(
+                server.name.clone(),
+                transport,
+                Some(Arc::clone(session_manager)),
+                secrets,
+                user_id,
+                Some(server),
+            ))
         }
     }
 }
@@ -122,6 +155,8 @@ mod tests {
         let client = create_client_from_config(
             server,
             &session_manager,
+            None,
+            None,
             &process_manager,
             None,
             "test-user",
@@ -134,4 +169,86 @@ mod tests {
             "non-OAuth HTTP clients must carry a session manager"
         );
     }
+
+    /// Regression test: the factory must wire the session manager into the
+    /// *transport*, not just the client. Otherwise the transport never
+    /// captures `Mcp-Session-Id` from responses and subsequent requests
+    /// lack the header, causing the server to reject them.
+    #[tokio::test]
+    async fn test_factory_non_oauth_http_transport_captures_session_id() {
+        use axum::http::header::HeaderName;
+        use axum::{Router, http::StatusCode, response::IntoResponse, routing::post};
+        use tokio::net::TcpListener;
+
+        const SESSION_ID: &str = "test-session-abc123";
+
+        async fn session_echo() -> impl IntoResponse {
+            let body = serde_json::json!({
+                "jsonrpc": "2.0",
+                "id": 1,
+                "result": {}
+            })
+            .to_string();
+            (
+                StatusCode::OK,
+                [(
+                    HeaderName::from_static("mcp-session-id"),
+                    SESSION_ID.to_string(),
+                )],
+                body,
+            )
+        }
+
+        let app = Router::new().route("/", post(session_echo));
+        let listener = TcpListener::bind("127.0.0.1:0").await.unwrap();
+        let addr = listener.local_addr().unwrap();
+        let url = format!("http://127.0.0.1:{}", addr.port());
+
+        tokio::spawn(async move {
+            axum::serve(listener, app).await.unwrap();
+        });
+
+        let server = McpServerConfig::new("session-test", &url);
+        let session_manager = Arc::new(McpSessionManager::new());
+        let process_manager = Arc::new(McpProcessManager::new());
+
+        let client = create_client_from_config(
+            server,
+            &session_manager,
+            None,
+            None,
+            &process_manager,
+            None,
+            "test-user",
+        )
+        .await
+        .expect("factory should succeed for HTTP config");
+
+        // Pre-create a session entry so that update_session_id has something to update.
+        // In production, the MCP initialize handshake calls get_or_create before responses arrive.
+        session_manager.get_or_create("session-test", &url).await;
+
+        // Send a request through the client's transport to trigger session capture.
+        use crate::tools::mcp::protocol::McpRequest;
+        let request = McpRequest {
+            jsonrpc: "2.0".to_string(),
+            id: Some(1),
+            method: "test".to_string(),
+            params: Some(serde_json::json!({})),
+        };
+        let headers = std::collections::HashMap::new();
+        client
+            .transport()
+            .send(&request, &headers)
+            .await
+            .expect("request should succeed");
+
+        // Verify the session manager captured the session ID from the response.
+        let captured = session_manager.get_session_id("session-test").await;
+        assert_eq!(
+            captured.as_deref(),
+            Some(SESSION_ID),
+            "transport must capture Mcp-Session-Id into session manager"
+        );
+    }
 }

src/tools/mcp/http_transport.rs

@@ -494,6 +494,34 @@ mod tests {
         assert_eq!(echoed["authorization"], "Bearer oauth-token");
     }
 
+    /// Regression test for #1436: 202 Accepted responses for notifications
+    /// were parsed as JSON, causing "Failed to parse MCP response" errors
+    /// that broke the MCP session handshake.
+    #[tokio::test]
+    async fn test_wire_202_accepted_for_notification() {
+        use axum::{Router, http::StatusCode, routing::post};
+        use tokio::net::TcpListener;
+
+        async fn accept_notification() -> StatusCode {
+            StatusCode::ACCEPTED
+        }
+
+        let app = Router::new().route("/", post(accept_notification));
+        let listener = TcpListener::bind("127.0.0.1:0").await.unwrap();
+        let addr = listener.local_addr().unwrap();
+        let url = format!("http://127.0.0.1:{}", addr.port());
+
+        tokio::spawn(async move {
+            axum::serve(listener, app).await.unwrap();
+        });
+
+        let transport = HttpMcpTransport::new(&url, "test-202");
+        let request = McpRequest::initialized_notification();
+        let response = transport.send(&request, &HashMap::new()).await.unwrap();
+        assert!(response.result.is_none());
+        assert!(response.error.is_none());
+    }
+
     #[tokio::test]
     async fn test_wire_custom_auth_preserved_when_no_per_request_auth() {
         let (url, _handle) = spawn_echo_server().await;

src/tools/registry.rs

@@ -16,11 +16,6 @@ use crate::skills::registry::SkillRegistry;
 use crate::tools::builder::{
     BuildSoftwareTool, BuilderConfig, LlmSoftwareBuilder, SoftwareBuilder,
 };
-#[cfg(feature = "demo")]
-use crate::tools::builtin::{
-    AboundCreateNotificationTool, AboundGetAccountInfoTool, AboundGetExchangeRateTool,
-    AboundGetForexScoreTool, AboundSendWireTool,
-};
 use crate::tools::builtin::{
     ApplyPatchTool, CancelJobTool, CreateJobTool, EchoTool, ExtensionInfoTool, HttpTool,
     JobEventsTool, JobPromptTool, JobStatusTool, JsonTool, ListDirTool, ListJobsTool,
@@ -253,16 +248,6 @@ impl ToolRegistry {
         }
         self.register_sync(Arc::new(http));
 
-        // Abound demo tools (mock APIs — only compiled with --features demo)
-        #[cfg(feature = "demo")]
-        {
-            self.register_sync(Arc::new(AboundGetAccountInfoTool));
-            self.register_sync(Arc::new(AboundGetExchangeRateTool));
-            self.register_sync(Arc::new(AboundSendWireTool));
-            self.register_sync(Arc::new(AboundCreateNotificationTool));
-            self.register_sync(Arc::new(AboundGetForexScoreTool));
-        }
-
         tracing::debug!("Registered {} built-in tools", self.count());
     }
 

src/tools/wasm/loader.rs

@@ -446,16 +446,14 @@ fn resolve_oauth_refresh_config(cap_file: &CapabilitiesFile) -> Option<OAuthRefr
         builtin.as_ref(),
         exchange_proxy_url.is_some(),
     );
-    let gateway_token = crate::config::helpers::env_or_override("GATEWAY_AUTH_TOKEN")
-        .map(|token| token.trim().to_string())
-        .filter(|token| !token.is_empty());
+    let oauth_proxy_auth_token = crate::cli::oauth_defaults::oauth_proxy_auth_token();
 
     Some(OAuthRefreshConfig {
         token_url: oauth.token_url.clone(),
         client_id,
         client_secret,
         exchange_proxy_url,
-        gateway_token,
+        gateway_token: oauth_proxy_auth_token,
         secret_name: auth.secret_name.clone(),
         provider: auth.provider.clone(),
     })
@@ -891,6 +889,11 @@ mod tests {
             AuthCapabilitySchema, CapabilitiesFile, OAuthConfigSchema,
         };
 
+        let _guard = lock_env();
+        let _proxy_guard = set_env_var("IRONCLAW_OAUTH_EXCHANGE_URL", None);
+        let _gateway_token_guard = set_env_var("GATEWAY_AUTH_TOKEN", None);
+        let _oauth_proxy_token_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", None);
+
         let caps = CapabilitiesFile {
             auth: Some(AuthCapabilitySchema {
                 secret_name: "google_oauth_token".to_string(),
@@ -982,6 +985,7 @@ mod tests {
         let _guard = lock_env();
         let _proxy_guard = set_env_var("IRONCLAW_OAUTH_EXCHANGE_URL", None);
         let _gateway_token_guard = set_env_var("GATEWAY_AUTH_TOKEN", None);
+        let _oauth_proxy_token_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", None);
 
         // google_oauth_token should fall back to built-in credentials
         let caps = CapabilitiesFile {
@@ -1021,6 +1025,7 @@ mod tests {
             Some("https://compose-api.example.com"),
         );
         let _gateway_token_guard = set_env_var("GATEWAY_AUTH_TOKEN", Some("gateway-test-token"));
+        let _oauth_proxy_token_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", None);
         let _client_id_guard =
             set_env_var("GOOGLE_OAUTH_CLIENT_ID", Some("hosted-google-client-id"));
 
@@ -1061,6 +1066,7 @@ mod tests {
             Some("https://compose-api.example.com"),
         );
         let _gateway_token_guard = set_env_var("GATEWAY_AUTH_TOKEN", Some("gateway-test-token"));
+        let _oauth_proxy_token_guard = set_env_var("IRONCLAW_OAUTH_PROXY_AUTH_TOKEN", None);
         let _client_id_guard =
             set_env_var("GOOGLE_OAUTH_CLIENT_ID", Some("hosted-google-client-id"));
         let _client_secret_guard =
@@ -1095,6 +1101,47 @@ mod tests {
         assert_eq!(config.gateway_token.as_deref(), Some("gateway-test-token"));
     }
 
+    #[test]
+    fn test_resolve_oauth_refresh_config_hosted_proxy_prefers_dedicated_proxy_auth_token() {
+        use crate::tools::wasm::capabilities_schema::{
+            AuthCapabilitySchema, CapabilitiesFile, OAuthConfigSchema,
+        };
+
+        let _guard = lock_env();
+        let _proxy_guard = set_env_var(
+            "IRONCLAW_OAUTH_EXCHANGE_URL",
+            Some("https://compose-api.example.com"),
+        );
+        let _gateway_token_guard = set_env_var("GATEWAY_AUTH_TOKEN", Some("gateway-test-token"));
+        let _oauth_proxy_token_guard = set_env_var(
+            "IRONCLAW_OAUTH_PROXY_AUTH_TOKEN",
+            Some("shared-oauth-proxy-secret"),
+        );
+        let _client_id_guard =
+            set_env_var("GOOGLE_OAUTH_CLIENT_ID", Some("hosted-google-client-id"));
+
+        let caps = CapabilitiesFile {
+            auth: Some(AuthCapabilitySchema {
+                secret_name: "google_oauth_token".to_string(),
+                provider: Some("google".to_string()),
+                oauth: Some(OAuthConfigSchema {
+                    authorization_url: "https://accounts.google.com/o/oauth2/v2/auth".to_string(),
+                    token_url: "https://oauth2.googleapis.com/token".to_string(),
+                    client_id_env: Some("GOOGLE_OAUTH_CLIENT_ID".to_string()),
+                    ..Default::default()
+                }),
+                ..Default::default()
+            }),
+            ..Default::default()
+        };
+
+        let config = super::resolve_oauth_refresh_config(&caps).expect("hosted oauth config");
+        assert_eq!(
+            config.gateway_token.as_deref(),
+            Some("shared-oauth-proxy-secret")
+        );
+    }
+
     // ---------------------------------------------------------------
     // Security regression tests
     // ---------------------------------------------------------------

src/tools/wasm/wrapper.rs

@@ -62,7 +62,8 @@ pub struct OAuthRefreshConfig {
     pub client_secret: Option<String>,
     /// Hosted OAuth proxy base URL (e.g., "http://host.docker.internal:8080").
     pub exchange_proxy_url: Option<String>,
-    /// Gateway auth token for authenticating with the hosted OAuth proxy.
+    /// OAuth proxy auth token for authenticating with the hosted OAuth proxy.
+    /// Kept as `gateway_token` for public API compatibility.
     pub gateway_token: Option<String>,
     /// Secret name of the access token (e.g., "google_oauth_token").
     /// The refresh token lives at `{secret_name}_refresh_token`.
@@ -71,6 +72,12 @@ pub struct OAuthRefreshConfig {
     pub provider: Option<String>,
 }
 
+impl OAuthRefreshConfig {
+    fn oauth_proxy_auth_token(&self) -> Option<&str> {
+        self.gateway_token.as_deref()
+    }
+}
+
 /// Pre-resolved credential for host-based injection.
 ///
 /// Built before each WASM execution by decrypting secrets from the store.
@@ -1218,9 +1225,9 @@ async fn refresh_oauth_token(
     let refresh_name = format!("{}_refresh_token", config.secret_name);
 
     if let Some(proxy_url) = config.exchange_proxy_url.as_deref() {
-        let Some(gateway_token) = config.gateway_token.as_deref() else {
+        let Some(oauth_proxy_auth_token) = config.oauth_proxy_auth_token() else {
             tracing::warn!(
-                "OAuth refresh proxy is configured, but no gateway auth token is available"
+                "OAuth refresh proxy is configured, but no OAuth proxy auth token is available"
             );
             return false;
         };
@@ -1235,7 +1242,7 @@ async fn refresh_oauth_token(
         let token_response = match oauth_defaults::refresh_token_via_proxy(
             oauth_defaults::ProxyRefreshTokenRequest {
                 proxy_url,
-                gateway_token,
+                gateway_token: oauth_proxy_auth_token,
                 token_url: &config.token_url,
                 client_id: &config.client_id,
                 client_secret: config.client_secret.as_deref(),
@@ -2704,7 +2711,8 @@ mod tests {
     }
 
     #[tokio::test]
-    async fn test_resolve_host_credentials_skips_refresh_token_lookup_without_gateway_token() {
+    async fn test_resolve_host_credentials_skips_refresh_token_lookup_without_oauth_proxy_auth_token()
+     {
         use crate::secrets::{
             CreateSecretParams, CredentialLocation, CredentialMapping, SecretsStore,
         };

src/tunnel/mod.rs

@@ -428,8 +428,10 @@ mod tests {
             host: "127.0.0.1".to_string(),
             port: 3000,
             auth_token: None,
+            user_id: "test".to_string(),
             workspace_read_scopes: Vec::new(),
             memory_layers: Vec::new(),
+            user_tokens: None,
         });
         c
     }
@@ -440,8 +442,10 @@ mod tests {
             host: host.to_string(),
             port,
             auth_token: None,
+            user_id: "test".to_string(),
             workspace_read_scopes: Vec::new(),
             memory_layers: Vec::new(),
+            user_tokens: None,
         });
         c
     }

tests/e2e/conftest.py

@@ -271,6 +271,7 @@ async def ironclaw_server(
         "GATEWAY_HOST": "127.0.0.1",
         "GATEWAY_PORT": str(gateway_port),
         "GATEWAY_AUTH_TOKEN": AUTH_TOKEN,
+        "GATEWAY_USER_ID": "e2e-web-sender",
         "HTTP_HOST": "127.0.0.1",
         "HTTP_PORT": str(http_port),
         "HTTP_WEBHOOK_SECRET": HTTP_WEBHOOK_SECRET,
@@ -370,6 +371,7 @@ async def hosted_oauth_refresh_server(
             "GATEWAY_HOST": "127.0.0.1",
             "GATEWAY_PORT": str(gateway_port),
             "GATEWAY_AUTH_TOKEN": AUTH_TOKEN,
+            "GATEWAY_USER_ID": OWNER_SCOPE_ID,
             "HTTP_HOST": "127.0.0.1",
             "HTTP_PORT": str(http_port),
             "HTTP_WEBHOOK_SECRET": HTTP_WEBHOOK_SECRET,
@@ -409,6 +411,7 @@ async def hosted_oauth_refresh_server(
             yield {
                 "base_url": base_url,
                 "db_path": db_path,
+                "gateway_user_id": OWNER_SCOPE_ID,
                 "mock_llm_url": mock_llm_server,
             }
         except TimeoutError:
@@ -470,6 +473,7 @@ async def http_channel_server_without_secret(
         "GATEWAY_HOST": "127.0.0.1",
         "GATEWAY_PORT": str(gateway_port),
         "GATEWAY_AUTH_TOKEN": AUTH_TOKEN,
+        "GATEWAY_USER_ID": "e2e-tester",
         "HTTP_HOST": "127.0.0.1",
         "HTTP_PORT": str(http_port),
         "CLI_ENABLED": "false",

tests/e2e_builtin_tool_coverage.rs

@@ -205,7 +205,44 @@ mod tests {
     }
 
     // -----------------------------------------------------------------------
-    // Test 5: routine_manual_create_defaults_to_tools_enabled
+    // Test 5: routine_update_fail_delete_fallback
+    // -----------------------------------------------------------------------
+
+    #[tokio::test]
+    async fn routine_update_fail_delete_fallback() {
+        let trace = LlmTrace::from_file(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/tests/fixtures/llm_traces/tools/routine_update_fail_delete_fallback.json"
+        ))
+        .expect("failed to load routine_update_fail_delete_fallback.json");
+
+        let rig = TestRigBuilder::new()
+            .with_trace(trace.clone())
+            .with_auto_approve_tools(true)
+            .build()
+            .await;
+
+        rig.send_message("Try converting a routine trigger, then recover by deleting it")
+            .await;
+        let responses = rig.wait_for_responses(1, Duration::from_secs(15)).await;
+
+        rig.verify_trace_expects(&trace, &responses);
+
+        let completed = rig.tool_calls_completed();
+        assert!(
+            completed.iter().any(|(n, ok)| n == "routine_update" && !ok),
+            "routine_update should fail in this regression path: {completed:?}"
+        );
+        assert!(
+            completed.iter().any(|(n, ok)| n == "routine_delete" && *ok),
+            "routine_delete should recover successfully via preserved routine identity: {completed:?}"
+        );
+
+        rig.shutdown();
+    }
+
+    // -----------------------------------------------------------------------
+    // Test 6: routine_manual_create_defaults_to_tools_enabled
     // -----------------------------------------------------------------------
 
     #[tokio::test]
@@ -246,7 +283,7 @@ mod tests {
     }
 
     // -----------------------------------------------------------------------
-    // Test 6: routine_manual_create_explicit_no_tools
+    // Test 7: routine_manual_create_explicit_no_tools
     // -----------------------------------------------------------------------
 
     #[tokio::test]
@@ -287,7 +324,7 @@ mod tests {
     }
 
     // -----------------------------------------------------------------------
-    // Test 7: routine_history
+    // Test 8: routine_history
     // -----------------------------------------------------------------------
 
     #[tokio::test]

tests/e2e_routine_heartbeat.rs

@@ -290,6 +290,8 @@ mod tests {
         Arc::new(ExtensionManager::new(
             Arc::new(McpSessionManager::new()),
             Arc::new(McpProcessManager::new()),
+            None,
+            None,
             secrets,
             tools,
             None,
@@ -299,6 +301,7 @@ mod tests {
             None,
             owner_id.to_string(),
             None,
+            None,
             Vec::new(),
         ))
     }

tests/fixtures/llm_traces/tools/routine_update_fail_delete_fallback.json

@@ -0,0 +1,70 @@
+{
+  "model_name": "test-routine-update-fail-delete-fallback",
+  "expects": {
+    "tools_used": ["routine_create", "routine_update", "routine_delete"],
+    "tool_results_contain": {
+      "routine_update": "Cannot update schedule or timezone on a non-cron routine.",
+      "routine_delete": "temp-routine"
+    },
+    "min_responses": 1
+  },
+  "steps": [
+    {
+      "response": {
+        "type": "tool_calls",
+        "tool_calls": [
+          {
+            "id": "call_rc_fallback",
+            "name": "routine_create",
+            "arguments": {
+              "name": "temp-routine",
+              "trigger_type": "manual",
+              "prompt": "Temporary routine for fallback test."
+            }
+          }
+        ],
+        "input_tokens": 120,
+        "output_tokens": 40
+      }
+    },
+    {
+      "response": {
+        "type": "tool_calls",
+        "tool_calls": [
+          {
+            "id": "call_ru_fallback",
+            "name": "routine_update",
+            "arguments": {
+              "name": "temp-routine",
+              "schedule": "0 */10 * * * *"
+            }
+          }
+        ],
+        "input_tokens": 200,
+        "output_tokens": 30
+      }
+    },
+    {
+      "response": {
+        "type": "tool_calls",
+        "tool_calls": [
+          {
+            "id": "call_rd_fallback",
+            "name": "routine_delete",
+            "arguments": {}
+          }
+        ],
+        "input_tokens": 300,
+        "output_tokens": 20
+      }
+    },
+    {
+      "response": {
+        "type": "text",
+        "content": "I recovered from the failed update and cleaned up the original routine.",
+        "input_tokens": 380,
+        "output_tokens": 25
+      }
+    }
+  ]
+}

tests/module_init_integration.rs

@@ -203,6 +203,8 @@ async fn extension_manager_with_process_manager_constructs() {
     let manager = ExtensionManager::new(
         Arc::new(McpSessionManager::new()),
         Arc::new(McpProcessManager::new()),
+        None,
+        None,
         secrets,
         tools,
         None,
@@ -212,6 +214,7 @@ async fn extension_manager_with_process_manager_constructs() {
         None,
         "test".to_string(),
         None,
+        None,
         Vec::new(),
     );
 

tests/multi_tenant_integration.rs

@@ -42,6 +42,8 @@ const ALICE_USER_ID: &str = "alice";
 const BOB_USER_ID: &str = "bob";
 const OWNER_TOKEN: &str = "tok-owner-secret";
 const OWNER_SCOPE_ID: &str = "owner-scope";
+const GATEWAY_SENDER_ID: &str = "gateway-sender";
+
 /// Build a MultiAuthState with two users.
 fn two_user_auth() -> MultiAuthState {
     let mut tokens = HashMap::new();
@@ -49,7 +51,6 @@ fn two_user_auth() -> MultiAuthState {
         ALICE_TOKEN.to_string(),
         UserIdentity {
             user_id: ALICE_USER_ID.to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: Vec::new(),
         },
     );
@@ -57,7 +58,6 @@ fn two_user_auth() -> MultiAuthState {
         BOB_TOKEN.to_string(),
         UserIdentity {
             user_id: BOB_USER_ID.to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: vec!["shared".to_string()],
         },
     );
@@ -79,10 +79,7 @@ fn user_echo_app(auth: MultiAuthState) -> Router {
         .route("/api/whoami/scopes", get(echo_user_with_scopes))
         .route("/api/action", post(echo_user))
         .route("/api/chat/events", get(echo_user)) // SSE endpoint (allows query token)
-        .layer(middleware::from_fn_with_state(
-            ironclaw::channels::web::auth::CombinedAuthState::from(auth),
-            auth_middleware,
-        ))
+        .layer(middleware::from_fn_with_state(auth, auth_middleware))
 }
 
 // ===========================================================================
@@ -547,6 +544,7 @@ fn gateway_state_has_multi_tenant_fields() {
         prompt_queue: None,
         scheduler: None,
         owner_id: "fallback".to_string(),
+        default_sender_id: "fallback".to_string(),
         shutdown_tx: tokio::sync::RwLock::new(None),
         ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
         llm_provider: None,
@@ -560,10 +558,10 @@ fn gateway_state_has_multi_tenant_fields() {
         startup_time: std::time::Instant::now(),
         webhook_rate_limiter: RateLimiter::new(10, 60),
         active_config: Default::default(),
-        secrets_store: None,
     };
 
     assert_eq!(state.owner_id, "fallback");
+    assert_eq!(state.default_sender_id, "fallback");
     assert!(state.workspace_pool.is_none());
 }
 
@@ -594,7 +592,6 @@ async fn start_owner_scoped_sender_server() -> (
         OWNER_TOKEN.to_string(),
         UserIdentity {
             user_id: OWNER_SCOPE_ID.to_string(),
-            role: "admin".to_string(),
             workspace_read_scopes: Vec::new(),
         },
     );
@@ -602,7 +599,6 @@ async fn start_owner_scoped_sender_server() -> (
         BOB_TOKEN.to_string(),
         UserIdentity {
             user_id: BOB_USER_ID.to_string(),
-            role: "member".to_string(),
             workspace_read_scopes: Vec::new(),
         },
     );
@@ -622,6 +618,7 @@ async fn start_owner_scoped_sender_server() -> (
         prompt_queue: None,
         scheduler: None,
         owner_id: OWNER_SCOPE_ID.to_string(),
+        default_sender_id: GATEWAY_SENDER_ID.to_string(),
         shutdown_tx: tokio::sync::RwLock::new(None),
         ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
         llm_provider: None,
@@ -635,10 +632,9 @@ async fn start_owner_scoped_sender_server() -> (
         routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
         startup_time: std::time::Instant::now(),
         active_config: Default::default(),
-        secrets_store: None,
     });
 
-    let auth = MultiAuthState::multi(tokens).into();
+    let auth = MultiAuthState::multi(tokens);
     let addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
     let bound = start_server(addr, state.clone(), auth)
         .await
@@ -773,7 +769,7 @@ async fn full_server_chat_send_rewrites_sender_only_for_owner_scope_rebind() {
         .expect("Timed out waiting for owner message")
         .expect("Agent channel closed");
     assert_eq!(owner_msg.user_id, OWNER_SCOPE_ID);
-    assert_eq!(owner_msg.sender_id, OWNER_SCOPE_ID);
+    assert_eq!(owner_msg.sender_id, GATEWAY_SENDER_ID);
     assert_eq!(owner_msg.content, "hello from owner");
 
     let other_resp = client
@@ -1007,6 +1003,7 @@ async fn start_multi_user_server_with_db() -> (
         prompt_queue: None,
         scheduler: None,
         owner_id: ALICE_USER_ID.to_string(),
+        default_sender_id: ALICE_USER_ID.to_string(),
         shutdown_tx: tokio::sync::RwLock::new(None),
         ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
         llm_provider: None,
@@ -1020,11 +1017,10 @@ async fn start_multi_user_server_with_db() -> (
         startup_time: std::time::Instant::now(),
         webhook_rate_limiter: RateLimiter::new(10, 60),
         active_config: Default::default(),
-        secrets_store: None,
     });
 
     let addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
-    let bound = ironclaw::channels::web::server::start_server(addr, state.clone(), auth.into())
+    let bound = ironclaw::channels::web::server::start_server(addr, state.clone(), auth)
         .await
         .expect("Failed to start server with DB");
 

tests/openai_compat_integration.rs

@@ -205,6 +205,7 @@ async fn start_test_server_with_provider(
         prompt_queue: None,
         scheduler: None,
         owner_id: "test-user".to_string(),
+        default_sender_id: "test-user".to_string(),
         shutdown_tx: tokio::sync::RwLock::new(None),
         ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
         llm_provider: Some(llm_provider),
@@ -218,7 +219,6 @@ async fn start_test_server_with_provider(
         routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
         startup_time: std::time::Instant::now(),
         active_config: ironclaw::channels::web::server::ActiveConfigSnapshot::default(),
-        secrets_store: None,
     });
 
     let auth = ironclaw::channels::web::auth::MultiAuthState::single(
@@ -226,7 +226,7 @@ async fn start_test_server_with_provider(
         "test-user".to_string(),
     );
     let addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
-    let bound_addr = start_server(addr, state.clone(), auth.into())
+    let bound_addr = start_server(addr, state.clone(), auth)
         .await
         .expect("Failed to start test server");
 
@@ -704,6 +704,7 @@ async fn test_no_llm_provider_returns_503() {
         prompt_queue: None,
         scheduler: None,
         owner_id: "test-user".to_string(),
+        default_sender_id: "test-user".to_string(),
         shutdown_tx: tokio::sync::RwLock::new(None),
         ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
         llm_provider: None, // No LLM!
@@ -717,7 +718,6 @@ async fn test_no_llm_provider_returns_503() {
         routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
         startup_time: std::time::Instant::now(),
         active_config: ironclaw::channels::web::server::ActiveConfigSnapshot::default(),
-        secrets_store: None,
     });
 
     let auth = ironclaw::channels::web::auth::MultiAuthState::single(
@@ -725,7 +725,7 @@ async fn test_no_llm_provider_returns_503() {
         "test-user".to_string(),
     );
     let addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
-    let bound_addr = start_server(addr, state, auth.into()).await.unwrap();
+    let bound_addr = start_server(addr, state, auth).await.unwrap();
 
     let url = format!("http://{}/v1/chat/completions", bound_addr);
     let resp = client()
@@ -763,7 +763,7 @@ async fn test_chat_completions_body_too_large() {
             post(ironclaw::channels::web::openai_compat::chat_completions_handler),
         )
         .route_layer(middleware::from_fn_with_state(
-            ironclaw::channels::web::auth::CombinedAuthState::from(auth_state),
+            auth_state,
             ironclaw::channels::web::auth::auth_middleware,
         ))
         .layer(DefaultBodyLimit::max(10 * 1024 * 1024))

tests/support/gateway_workflow_harness.rs

@@ -227,6 +227,7 @@ impl GatewayWorkflowHarness {
             prompt_queue: None,
             scheduler: Some(scheduler_slot.clone()),
             owner_id: user_id.clone(),
+            default_sender_id: user_id.clone(),
             shutdown_tx: tokio::sync::RwLock::new(None),
             ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
             llm_provider: Some(Arc::clone(&components.llm)),
@@ -240,7 +241,6 @@ impl GatewayWorkflowHarness {
             routine_engine: Arc::clone(&routine_slot),
             startup_time: Instant::now(),
             active_config: ironclaw::channels::web::server::ActiveConfigSnapshot::default(),
-            secrets_store: None,
         });
 
         let mut agent = Agent::new(
@@ -299,7 +299,7 @@ impl GatewayWorkflowHarness {
         let addr = start_server(
             "127.0.0.1:0".parse().expect("valid localhost addr"),
             Arc::clone(&gateway_state),
-            auth.into(),
+            auth,
         )
         .await
         .expect("failed to start gateway server");

tests/ws_gateway_integration.rs

@@ -52,6 +52,7 @@ async fn start_test_server() -> (
         prompt_queue: None,
         scheduler: None,
         owner_id: "test-user".to_string(),
+        default_sender_id: "test-user".to_string(),
         shutdown_tx: tokio::sync::RwLock::new(None),
         ws_tracker: Some(Arc::new(WsConnectionTracker::new())),
         llm_provider: None,
@@ -65,7 +66,6 @@ async fn start_test_server() -> (
         routine_engine: Arc::new(tokio::sync::RwLock::new(None)),
         startup_time: std::time::Instant::now(),
         active_config: ironclaw::channels::web::server::ActiveConfigSnapshot::default(),
-        secrets_store: None,
     });
 
     let auth = ironclaw::channels::web::auth::MultiAuthState::single(
@@ -73,7 +73,7 @@ async fn start_test_server() -> (
         "test-user".to_string(),
     );
     let addr: SocketAddr = "127.0.0.1:0".parse().unwrap();
-    let bound_addr = start_server(addr, state.clone(), auth.into())
+    let bound_addr = start_server(addr, state.clone(), auth)
         .await
         .expect("Failed to start test server");