# @gram/client

## 0.33.6

### Patch Changes

- 2b2d423: added per-skill time series data to the hooks summary API to power skill usage charts.

## 0.34.0

### Minor Changes

- d8c6ce1: add support for publishing external servers into collections.
- 1ee9f95: Improved Hooks dashboard with new charts, refined visuals, and smarter default filters.

## 0.32.65

### Patch Changes

- e56314e: Captures token and cost metrics for Claude agent sessions

## 0.33.0

### Minor Changes

- f749a53: Add plugins feature for distributing MCP server bundles to teams and allowing zip distribution

### Patch Changes

- d2bf604: Adds a new project metrics summary endpoint containing new data to power the new homepage
- be476e6: feat: use pre-aggregated summary endpoint for hooks analytics charts and KPIs

## 0.33.0

### Minor Changes

- 98d322b: Add support for triggers across Gram.

  This introduces webhook and scheduled triggers end to end, including server APIs, worker execution for trigger dispatch and cron processing, SDK support, and dashboard UI for managing trigger definitions and instances.

## 0.33.0

### Minor Changes

- b328938: Add static platform tools to tool discovery and the built-in MCP logs server.

### Patch Changes

- 3a3acd3: Add editable OAuth proxy server configuration.

  Admins can now edit an existing OAuth proxy server's audience, authorization endpoint, token endpoint, scopes, token endpoint auth methods, and environment slug without having to unlink and recreate the configuration. The new `POST /rpc/toolsets.updateOAuthProxyServer` endpoint accepts partial updates with PATCH semantics (omit fields to leave them unchanged; pass an empty array to clear array fields). The dashboard's OAuth proxy details modal now exposes an Edit button that opens the existing OAuth modal in edit mode with the current values pre-filled.

  Slug and provider type remain immutable after creation. Gram-managed OAuth proxy servers stay view-only.

## 0.32.38

### Patch Changes

- 494f76c: Adds support for tracking skills in hooks dashboard

## 0.32.20

### Patch Changes

- 0a3af53: Adds support for full session capture from Claude. Complete transcripts of prompts, responses, and tool calls

## 0.33.0

### Minor Changes

- 658bef4: Adds new API endpoints for access and permissions management.

## 0.28.5

### Patch Changes

- 7ef727b: Add ability to detach an environment from an MCP server

## 0.28.0

### Minor Changes

- 8c72d8c: Renames attribute_filters to filters in searchLogs, and introduces "in" operator.

### Patch Changes

- d8133af: Suite of hooks improvements

## 0.27.20

### Patch Changes

- 1765931: Removes the logs enabled flag in the telemetry API responses.
- e616da7: Add admin-only cache purging functionality

## 0.27.24

### Patch Changes

- 0c90e1e: Add hooks dashboard page

## 0.28.0

### Minor Changes

- be6dcae: Upgrade zod to v4 across the monorepo. Bump @modelcontextprotocol/sdk

### Patch Changes

- 1821e46: Adds an initial pass "POC" implementation of Gram hooks for tool capture
- fb7439b: Improve settings page with tabs routing and logging API
- 998102f: Update telemetry search logs API response to sent unix nano timestamps as strings instead of int.

## 0.28.0

### Minor Changes

- f364cc0: Adds listAttributeKeys endpoint to retrieve distinct attribute keys for telemetry filtering.

### Patch Changes

- e2c00cb: Adds a new filtering option to the search logs endpoint to filter any attribute.

## 0.28.1

### Patch Changes

- 3cae542: Improve logs page timestamp display (no wrapping, remove comma, hide duplicate child timestamps)
  Fix tree line alignment with parent chevron in expanded log rows
  Fix loading state layout shift in expanded logs
  Filter out chat completion logs (urn:uuid:) from tool calls list
  Fix breadcrumb scrolling issue on insights page
  Add click-outside-to-close for AI Insights sidebar
  Remove Beta labels from AI Insights

## 0.28.0

### Minor Changes

- 0f4f5dd: Adds an opt-in toggle for recording tool call inputs/outputs in logs

## 0.27.0

### Minor Changes

- 514fce6: Improve observability chat logs with server-side sorting (sort_by/sort_order params), sticky pagination with page count, N/A score indicator with tooltip for unscored sessions, Shiki syntax highlighting for code blocks, character-based truncation with "Show more" button, System Prompt tab in chat detail panel, and Tool Result labeling for tool messages.

## 0.27.4

### Patch Changes

- f635e22: Support for [MCP tool annotations](https://modelcontextprotocol.io/legacy/concepts/tools#tool-annotations). Tool annotations provide additional metadata about a tool’s behavior,
  helping clients understand how to present and manage tools. These annotations are hints that describe the nature and impact of a tool, but should not be relied upon for security decisions.

  The MCP specification defines the following annotations for tools that Gram now supports for external mcp servers sourced from the Catalog as well as HTTP based tools.

  | Annotation        | Type    | Default | Description                                                                                                                          |
  | ----------------- | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------ |
  | `title`           | string  | -       | A human-readable title for the tool, useful for UI display                                                                           |
  | `readOnlyHint`    | boolean | false   | If true, indicates the tool does not modify its environment                                                                          |
  | `destructiveHint` | boolean | true    | If true, the tool may perform destructive updates (only meaningful when `readOnlyHint` is false)                                     |
  | `idempotentHint`  | boolean | false   | If true, calling the tool repeatedly with the same arguments has no additional effect (only meaningful when `readOnlyHint` is false) |
  | `openWorldHint`   | boolean | true    | If true, the tool may interact with an "open world" of external entities                                                             |

  Tool annotations can be edited in the playground or in the tools tab of a specific MCP server.

## 0.27.3

### Patch Changes

- b2347fc: Adds a new telemetry endpoint to fetch user usage data
- a34d18a: Adds chat resolution stats in telemetry metrics

## 0.27.1

### Patch Changes

- e08b45e: Adds support for forwarding and storing user feedback. Incorporates the stored user feedback into chat resolution analysis

## 0.26.18

### Patch Changes

- a7422f8: feat: add OAuth support for external MCP servers in the Playground
- a753172: feat: customize documentation button text on MCP install page
- 6e29702: Adds a new endpoint to get metrics per user. Allows filtering logs per user.
- 1f74200: Fixes issue with loading of metrics when logs are disabled.

## 0.26.13

### Patch Changes

- c9b74af: Adds a new endpoint to list chats grouped by ID

## 0.26.9

### Patch Changes

- 659d955: Add MCP JSON export API with API key authentication that allows customers to programmatically retrieve server information per MCP server
- afb9fbb: Adds new endpoint to retrieve summarized project metrics
- 90ad1ba: Add support for install page redirect URLs

## 0.27.0

### Minor Changes

- 834a770: Removes old tool toolmetrics logs logic and endpoints.

## 0.25.16

### Patch Changes

- 484bbe0: Enable renaming of MCP authorization headers and with user friendly display names. These names are used as the default names of environment variables on the user facing MCP config.

## 0.25.12

### Patch Changes

- 0fd8d39: Adds a new Gram endpoint to update a chat title

## 0.25.8

### Patch Changes

- d972d1b: Adds ability to filter telemetry logs by multiple Gram URNs
- 3a82c2e: Adds enabled field to telemetry API response indicating whether logging is enabled or not

## 0.24.2

### Patch Changes

- 7e5e7c8: Adds a new telemetry endpoint to the Gram API

## 0.24.0

### Minor Changes

- 8c865e1: Introduce the ability to browse entries from MCP-spec conformant registries from Gram Dashboard source import modal

### Patch Changes

- 811989e: Enable private MCP servers with Gram account authentication

  This change allows private MCP servers to require users to authenticate
  with their Gram account. When enabled, only users with access to the
  server's organization can utilize it.

  This is ideal for MCP servers that require sensitive credentials (such as API
  keys), as it allows organizations to:

  - Secure access to servers handling sensitive secrets (via Gram Environments)
  - Eliminate the need for individual users to configure credentials during installation
  - Centralize authentication and access control at the organization level

- 76beb93: Added support for ephemeral chat sessions, allowing secure invocation of chat completions from the browser

## 0.22.0

### Minor Changes

- 1c836a2: Proxy remote file uploads through gram server

## 0.21.6

### Patch Changes

- 949787b: update chat credit billing

## 0.21.2

### Patch Changes

- 4228c3e: Implements passthrough oauth support for function tools via oauthTarget indicator. Also simplifies the oauth proxy redirect for more recent usecases

## 0.20.1

### Patch Changes

- c2ea282: admin view for creating oauth proxies

## 0.19.0

### Minor Changes

- 6716410: Add the ability to attach gram environments at the toolset level for easier configuration set up

## 0.18.1

### Patch Changes

- cf3e81b: non blocking deployment creation

## 0.17.3

### Patch Changes

- 77446ee: fully connects server url tracking feature in opt in tool call logs

## 0.17.2

### Patch Changes

- bb37fed: creates the concept of user controllable product features, opens up logs to self-service enable/disable control

## 0.16.7

### Patch Changes

- 2db3a23: Add filtering support to the tool call logs table

## 0.16.3

### Patch Changes

- 7afda6e: Allows the MCP metadata map to accept arbitrary value types as supported by the server

## 0.15.3

### Patch Changes

- 5038166: Introduced the ability to register \_meta tags for tools and resources

## 0.14.17

### Patch Changes

- 3c00725: Set of improvements for functions onboarding UX, including better support for mixed OpenAPI / Functions projects

## 0.14.16

### Patch Changes

- d6f5579: Adds a basic toolset UX for managing resources in the system adding/subtracting them per toolset
- 2fb24e6: Adds UI hints for custom tools, indicating which "subtools" are missing (if any), or just surfacing the list of subtools otherwise. Begins tracking the required subtools more powerfully in order to support Gram Functions.

## 0.14.14

### Patch Changes

- f3cea34: The first major wave of work for supporting MCP resources through functions includes creating the function_resource_definitions data model with corresponding indexes and resource_urns columns in toolset versions. It also introduces the function manifest schema for resources and implements deployment processing for function resources. A new resource URN type is added, which parses uniqueness from the URI as the primary key for resources in MCP. Additionally, this work enables adding and returning resources throughout the toolsets data model, preserves resources within toolset versions, and updates current toolset caching to account for them.

## 0.14.11

### Patch Changes

- 660c110: Support variations on any tool type. Allows the names of Custom Tools to now be edited along with all fields of Functions.

## 0.14.7

### Patch Changes

- 8972d1d: feat: update client to account for function tool types"
