Every command, route, and tool -- read straight from the code.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include_matrix": {
      "default": false,
      "description": "Also compute and include the per-adapter detection/capability matrix\n(`/api/matrix`'s equivalent). Defaults to false.",
      "type": "boolean"
    }
  },
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "adapter": {
      "description": "Exact adapter match (e.g. `claude_code`); valid values in the payload's facets.",
      "type": [
        "string",
        "null"
      ]
    },
    "model": {
      "description": "Exact model match over recorded per-session model usage. Optional.",
      "type": [
        "string",
        "null"
      ]
    },
    "repo": {
      "description": "Exact display-repo match over session source paths. Optional.",
      "type": [
        "string",
        "null"
      ]
    },
    "since": {
      "description": "RFC 3339 timestamp; only sessions (and stored human turns) starting at or after\nthis instant. Optional; omit for all-time.",
      "type": [
        "string",
        "null"
      ]
    },
    "until": {
      "description": "RFC 3339 timestamp; requires `since` -- a window needs a start.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "adapter": {
      "description": "Exact adapter match (e.g. `claude_code`); valid values in the payload's facets.",
      "type": [
        "string",
        "null"
      ]
    },
    "model": {
      "description": "Exact model match over recorded per-session model usage. Optional.",
      "type": [
        "string",
        "null"
      ]
    },
    "repo": {
      "description": "Exact display-repo match over session source paths. Optional.",
      "type": [
        "string",
        "null"
      ]
    },
    "since": {
      "description": "RFC 3339 timestamp; only sessions (and stored human turns) starting at or after\nthis instant. Optional; omit for all-time.",
      "type": [
        "string",
        "null"
      ]
    },
    "until": {
      "description": "RFC 3339 timestamp; requires `since` -- a window needs a start.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "file_path": {
      "description": "Substring pattern matched against recorded file-modification paths.",
      "type": "string"
    }
  },
  "required": [
    "file_path"
  ],
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "base": {
      "description": "Ref to diff against. Defaults to the branch's own upstream, then `origin/main`, then\n`origin/master`, then the most recent `max_commits` commits — the range the pre-push\nhook would sign.",
      "type": [
        "string",
        "null"
      ]
    },
    "branch": {
      "description": "Branch to walk. Defaults to `HEAD`.",
      "type": [
        "string",
        "null"
      ]
    },
    "include_spend": {
      "default": null,
      "description": "Put API-equivalent spend (micro-USD) in the preview, as `create --include-spend` would.\nDefaults to false: receipts carry tokens only.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "max_commits": {
      "description": "Ceiling on commits walked. Defaults to 200, hard-capped at 1000.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "repo": {
      "description": "Absolute path to a git checkout on this machine. Anything inside it works — the\nrepository root is resolved with `git rev-parse --show-toplevel`.",
      "type": "string"
    },
    "since": {
      "description": "RFC 3339 timestamp. Only consulted when `base` is absent.",
      "type": [
        "string",
        "null"
      ]
    },
    "window_hours": {
      "description": "How long before a commit a session's file touch still counts as having authored it.\nDefaults to 24.",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "repo"
  ],
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "base": {
      "description": "Ref to diff against. Defaults to the branch's own upstream, then `origin/main`, then\n`origin/master`, then the most recent `max_commits` commits.",
      "type": [
        "string",
        "null"
      ]
    },
    "branch": {
      "description": "Branch to walk. Defaults to `HEAD`.",
      "type": [
        "string",
        "null"
      ]
    },
    "max_commits": {
      "description": "Ceiling on commits walked. Defaults to 200, hard-capped at 1000.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "repo": {
      "description": "Absolute path to a git checkout on this machine. Anything inside it works — the\nrepository root is resolved with `git rev-parse --show-toplevel`.",
      "type": "string"
    },
    "since": {
      "description": "RFC 3339 timestamp. Only consulted when `base` is absent.",
      "type": [
        "string",
        "null"
      ]
    },
    "window_hours": {
      "description": "How long before a commit a session's file touch still counts as having authored it.\nDefaults to 24.",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "repo"
  ],
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include_raw": {
      "default": false,
      "description": "Return unredacted questions and answer excerpts. Defaults to false -- everything this\ntool returns is transcript text (docs/specs/mcp-server.md, \"What it must not expose\").",
      "type": "boolean"
    },
    "limit": {
      "description": "How many questions to return, newest first. Defaults to 50, hard ceiling 500. The\ntotals in the response describe the whole session regardless of this.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "session_id": {
      "description": "Session to index. Defaults to the most recent indexed session for the repository this\nserver process is running in, same default `session_handoff` uses.",
      "type": [
        "string",
        "null"
      ]
    },
    "since": {
      "description": "RFC 3339 timestamp; only questions asked at or after this instant.",
      "type": [
        "string",
        "null"
      ]
    },
    "unanswered_only": {
      "default": false,
      "description": "Only questions that are not `answered` -- still open, or handed back to the user.\nDefaults to false.",
      "type": "boolean"
    }
  },
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "session_id": {
      "description": "The session, by full id or a unique prefix. Defaults to the most recently active\nsession in the loop's own index, which is the caller itself in the normal case.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include_raw": {
      "default": false,
      "description": "Same per-call raw opt-in `session_handoff` has, applied to every handoff returned.",
      "type": "boolean"
    },
    "include_subagents": {
      "default": false,
      "description": "Include subagent transcripts as their own entries. Defaults to false: a subagent\nstarts after its parent and would otherwise win \"newest\" for a session the parent is\nstill running (docs/specs/wake.md).",
      "type": "boolean"
    },
    "max_lines": {
      "description": "Line budget for each rendered handoff. Defaults to 60, hard ceiling 120.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "n": {
      "description": "How many handoffs to return, newest first. Defaults to 3, ceiling 10.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "repo": {
      "description": "Repository/workspace key, as `session_list`'s `repo` and the handoff receipt report\nit (e.g. `unfoundbox/agentworth`). A repo's worktrees all answer to one value.",
      "type": "string"
    },
    "since": {
      "description": "RFC 3339 timestamp; only sessions started at or after this instant.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "repo"
  ],
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "session_id": {
      "description": "The session, by full id or a unique prefix. Defaults to the most recently active\nsession in the loop's own index, which is the caller itself in the normal case.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "classes": {
      "description": "Any of `decision`, `rejected`, `reason`. Defaults to all three. An unknown name is an\nerror, not an ignored filter.",
      "items": {
        "type": "string"
      },
      "type": [
        "array",
        "null"
      ]
    },
    "include_raw": {
      "default": false,
      "description": "Return unredacted sentences, paths and evidence labels. Defaults to false -- everything\nthis tool returns is transcript text (docs/specs/mcp-server.md, \"What it must not\nexpose\").",
      "type": "boolean"
    },
    "limit": {
      "description": "How many statements to return, newest first. Defaults to 20, hard ceiling 200. The\ntotals in the response describe the whole session regardless of this.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "round": {
      "description": "One 1-based compaction round. Defaults to every round.",
      "format": "uint32",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "session_id": {
      "description": "Session to diff. Defaults to the most recent indexed session for the repository this\nserver process is running in, which is what an agent asking \"what did I forget here\"\nmeans; pass one explicitly to reach any other session.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include_loose_ends": {
      "description": "Include the \"said it would, no evidence it did\" section. Defaults to true.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "include_raw": {
      "default": false,
      "description": "Return unredacted paths, commands and quoted sentences. Defaults to false -- redacted\nis the default for every tool that can carry event or file content\n(docs/specs/mcp-server.md, \"What it must not expose\").",
      "type": "boolean"
    },
    "max_lines": {
      "description": "Line budget for the rendered markdown. Defaults to 60, hard ceiling 120.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "session_id": {
      "description": "Session to hand over. Defaults to the most recent indexed session for the repository\nthis server process is running in, which is what an agent asking \"what did I just do\nhere\" means; pass one explicitly to reach any other session or repo.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$defs": {
    "SessionsOrderBy": {
      "description": "Mirrors `agentworth_storage::SessionOrderBy` with the same snake_case wire values. A local\ncopy rather than deriving `schemars::JsonSchema` on the storage crate's own enum, since\n`agentworth-storage` has no reason to take on a `schemars` dependency for one MCP-only need.",
      "enum": [
        "started_at_desc",
        "started_at_asc",
        "tokens_desc",
        "tokens_asc",
        "events_desc",
        "events_asc",
        "duration_desc",
        "score_desc",
        "score_asc"
      ],
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "adapter": {
      "description": "Exact adapter name match (e.g. `claude_code`, `codex`, `gemini`).",
      "type": [
        "string",
        "null"
      ]
    },
    "end_date": {
      "description": "RFC 3339 timestamp; only sessions started at or before this instant.",
      "type": [
        "string",
        "null"
      ]
    },
    "include_stubs": {
      "default": null,
      "description": "Include near-empty session stubs (defaults to excluding them).",
      "type": [
        "boolean",
        "null"
      ]
    },
    "limit": {
      "description": "Maximum rows to return. Required -- there is no silent default -- and capped at\n`SESSIONS_FIND_LIMIT_CEILING` (200).",
      "format": "uint",
      "minimum": 0,
      "type": "integer"
    },
    "min_tokens": {
      "description": "Only sessions with at least this many total tokens.",
      "format": "uint64",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "model": {
      "description": "Substring match against the session's recorded models.",
      "type": [
        "string",
        "null"
      ]
    },
    "offset": {
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "order_by": {
      "anyOf": [
        {
          "$ref": "#/$defs/SessionsOrderBy"
        },
        {
          "type": "null"
        }
      ],
      "description": "Sort order; defaults to `started_at_desc`."
    },
    "outcome": {
      "description": "Exact match against the stored primary outcome, snake_case (e.g. `commit_observed`).",
      "type": [
        "string",
        "null"
      ]
    },
    "repo": {
      "description": "Filter to sessions whose derived repository/workspace name matches exactly. Not a\nstored column -- computed per-row from `source_path` and post-filtered client-side,\nso combining this with `limit` may require over-fetching (see `truncated` in the\nresponse).",
      "type": [
        "string",
        "null"
      ]
    },
    "search": {
      "description": "Substring match across session ID, source path, models, and adapter.",
      "type": [
        "string",
        "null"
      ]
    },
    "start_date": {
      "description": "RFC 3339 timestamp; only sessions started at or after this instant.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "limit"
  ],
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "events_limit": {
      "default": null,
      "description": "Max number of events to return. Defaults to `SESSION_GET_DEFAULT_EVENTS_LIMIT` (500) so\na call can never receive a session's full event list by accident; pass an explicit,\nlarger value to see more. Must be greater than 0.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "events_offset": {
      "default": null,
      "description": "Zero-based offset into the trace's events. Defaults to 0.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "include_raw": {
      "default": false,
      "description": "Return the unredacted trace, outcomes, and recoveries. Defaults to false -- redacted\noutput is the default for every tool that can carry event or file content (see\ndocs/specs/mcp-server.md, \"What it must not expose\").",
      "type": "boolean"
    },
    "session_id": {
      "type": "string"
    }
  },
  "required": [
    "session_id"
  ],
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include_raw": {
      "default": false,
      "description": "Return unredacted paths, commands and quoted sentences. Defaults to false -- redacted\nis the default for every tool that can carry event or file content\n(docs/specs/mcp-server.md, \"What it must not expose\").",
      "type": "boolean"
    },
    "repo": {
      "description": "Repository/workspace key, as `session_list`'s `repo` and `session_carry_forward` take\nit (e.g. `unfoundbox/agentworth`). Defaults to the key derived from `workspace`.",
      "type": [
        "string",
        "null"
      ]
    },
    "workspace": {
      "description": "Directory to read the checkout from and to derive `repo` from when `repo` is absent.\nDefaults to the server's working directory.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$defs": {
    "LadderGroupByParam": {
      "description": "Mirrors `agentworth_storage::LadderGroupBy` with the same snake_case wire values -- a\nlocal copy for the same reason `OutcomeRateGroupByParam` is one.",
      "oneOf": [
        {
          "enum": [
            "model",
            "repo",
            "adapter"
          ],
          "type": "string"
        },
        {
          "const": "effort",
          "description": "Only Codex records an effort today; sessions without one are counted and named, not\ngiven a made-up value.",
          "type": "string"
        }
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "adapter": {
      "description": "Exact adapter name (`claude_code`, `codex`, `opencode`, ...).",
      "type": [
        "string",
        "null"
      ]
    },
    "by": {
      "$ref": "#/$defs/LadderGroupByParam",
      "description": "Axis for the cost-per-verified-outcome table. Defaults to `model`."
    },
    "include_stubs": {
      "default": null,
      "description": "Include near-empty session stubs in the population. Defaults to false.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "min_n": {
      "description": "A group with fewer than this many claimed sessions returns a null rate and a null\ncost rather than a number nothing supports. Defaults to 20.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "model": {
      "description": "Model substring (`sonnet`, `gpt-4o`, ...).",
      "type": [
        "string",
        "null"
      ]
    },
    "period": {
      "description": "Lookback window: `day`, `week`, `month`, `year` or `all`. Defaults to `month`\n(30 days). This is how far back the window reaches, not a rollup granularity.",
      "type": [
        "string",
        "null"
      ]
    },
    "repo": {
      "description": "Repository or workspace substring, as `session_list`'s `repo` reports it.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "type": "object"
}

{
  "$defs": {
    "OutcomeRateGroupByParam": {
      "description": "Mirrors `agentworth_storage::OutcomeRateGroupBy` with the same snake_case wire values -- a\nlocal copy for the same reason `SessionsOrderBy` is one (see its doc comment above).",
      "enum": [
        "model",
        "adapter",
        "repo"
      ],
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "group_by": {
      "$ref": "#/$defs/OutcomeRateGroupByParam"
    },
    "include_stubs": {
      "default": null,
      "description": "Include near-empty session stubs in the population. Defaults to false.",
      "type": [
        "boolean",
        "null"
      ]
    },
    "min_n": {
      "description": "Groups with fewer than this many claimed sessions are suppressed (counted in\n`suppressed_groups`) rather than returned as a row. Defaults to 20.",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "since": {
      "description": "RFC 3339 timestamp; only sessions started at or after this instant.",
      "type": [
        "string",
        "null"
      ]
    },
    "until": {
      "description": "RFC 3339 timestamp; only sessions started at or before this instant.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "group_by"
  ],
  "type": "object"
}

{
  "$defs": {
    "UsagePeriodParam": {
      "description": "Rollup period for the `stats_usage` tool, mirroring `Storage::get_daily_usage` /\n`get_weekly_usage` / `get_monthly_usage`.",
      "enum": [
        "day",
        "week",
        "month"
      ],
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "description": "Row cap; defaults match the HTTP route's own per-period defaults (30 / 20 / 12).",
      "format": "uint",
      "minimum": 0,
      "type": [
        "integer",
        "null"
      ]
    },
    "period": {
      "$ref": "#/$defs/UsagePeriodParam"
    }
  },
  "required": [
    "period"
  ],
  "type": "object"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "hours": {
      "description": "Rolling window size in hours; defaults to 5.",
      "format": "int64",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "type": "object"
}