Skip to main content

Griptape/models

@webframp/griptape/modelsv2026.10.21.1· Apache-2.0· 5d agoBEHAVIORS
01README

Griptape Cloud Models — model configurations and provider auth configs

02Release Notes

2026.10.21.1

Changed: The README now opens with a Credentials section. Store the key with swamp vault put griptape API_KEY and set apiKey to ${{ vault.get("griptape", "API_KEY") }}. The previous example passed a placeholder literal (apiKey=GRIPTAPE_CLOUD_API_KEY).

Changed: The apiKey description and the missing-key error now point to the vault. The GT_CLOUD_API_KEY environment variable is still read when apiKey is unset, but it is now documented as a discouraged fallback because swamp does not redact it. Key resolution is unchanged.

Upgrade note: Documentation and message text only. No schema or behavioral changes.

03Behaviors1
@webframp/griptape/modelsv2026.10.21.1griptape/models.ts

Global Arguments

ArgumentTypeDescription
apiKey?stringGriptape Cloud API key. Store it in a swamp vault and wire it with a vault.get(...) expression, e.g. ${{ vault.get("griptape", "API_KEY") }}. The GT_CLOUD_API_KEY environment variable is read as a fallback, but it is not redacted and is not recommended.
baseUrl?stringGriptape Cloud API base URL; overrides the GT_CLOUD_BASE_URL environment variable and the built-in default.
fn list_models(page?: number, page_size?: number, model_type?: string, default?: boolean)
list operation
ArgumentTypeDescription
page?number
page_size?number
model_type?string
default?boolean
fn create_model(active?: boolean, auth_config_id: string, description?: string, kwargs?: unknown, model_name: string, model_type: unknown)
create operation
ArgumentTypeDescription
active?boolean
auth_config_idstring
description?string
kwargs?unknown
model_namestring
model_typeunknown
fn list_auth_configs(page?: number, page_size?: number)
list operation
ArgumentTypeDescription
page?number
page_size?number
fn create_auth_config(api_key_secret_id: string, base_url: string, kwargs?: unknown, name: string)
create operation
ArgumentTypeDescription
api_key_secret_idstring
base_urlstring
kwargs?unknown
namestring
fn get_auth_config(auth_config_id: string)
get operation
ArgumentTypeDescription
auth_config_idstring
fn update_auth_config(auth_config_id: string, api_key_secret_id?: string, base_url?: string, kwargs?: unknown, name?: string)
update operation
ArgumentTypeDescription
auth_config_idstring
api_key_secret_id?string
base_url?string
kwargs?unknown
name?string
fn delete_auth_config(auth_config_id: string)
delete operation
ArgumentTypeDescription
auth_config_idstring
fn get_model(model_config_id: string)
get operation
ArgumentTypeDescription
model_config_idstring
fn update_model(model_config_id: string, active?: boolean, auth_config_id?: string, description?: string, kwargs?: unknown, model_name?: string, model_type?: unknown)
update operation
ArgumentTypeDescription
model_config_idstring
active?boolean
auth_config_id?string
description?string
kwargs?unknown
model_name?string
model_type?unknown
fn delete_model(model_config_id: string)
delete operation
ArgumentTypeDescription
model_config_idstring

Resources

models(infinite)— list operation
model(infinite)— create operation
auth_configs(infinite)— list operation
auth_config(infinite)— create operation
04Previous Versions6
2026.10.14.1Apache-2.0(was none)

2026.10.14.1

Added: The manifest now declares license: Apache-2.0 (SPDX). The registry quality rubric scores a declared license separately from the bundled LICENSE.md.

Upgrade note: Metadata only. No code, schema, or behavioral changes.

2026.10.07.1

Fixed: An empty successful response (for example 202 Accepted) no longer fails with a JSON parse error. Mutating methods return no data handle for it, and list methods treat an empty page as the end of the results.

Fixed: A malformed JSON body now fails with an error that names the HTTP status, method, and path, instead of a bare SyntaxError.

Fixed: Requests no longer hang indefinitely. Each attempt has a 30-second deadline and fails with timed out after <n>ms: <METHOD> <path>. Set GT_CLOUD_TIMEOUT_MS to a positive integer up to 2147483647 to change it. Retry-After waits on HTTP 429 are capped at 30 seconds.

Fixed: Pagination ends on its own page counter and stops at the first empty page. A server that ignores the page parameter can no longer return page 1 up to 20 times, and a list response that is not a JSON object fails with a clear error instead of returning an empty result. A null total_pages no longer ends pagination after the first page, and a next_page value keeps a short page going.

Fixed: Descriptions in generated argument and resource schemas are shortened at a word boundary instead of mid-word.

Fixed: create, update, and delete methods now send their declared query parameters, as get, list, and action methods already did. No current endpoint declares one, so behavior is unchanged today.

Changed: Stored resource schemas are now tolerant of unexpected data. Enums are plain strings or numbers, pattern, length, and range constraints are dropped, every response field accepts null or absence, unknown keys are kept at every level, and spec defaults are no longer filled in. A response with a new enum member or a missing field is stored instead of failing the whole call. Argument validation for requests is unchanged.

Changed: A resource declared without a response body is now stored as a loose object, so whatever the API returns is kept instead of being stripped to {}.

Changed: Generated tests now exercise every method, assert the exact request (HTTP method, path, query string, auth header, JSON body) and the written resource, and cover the shared helper's error, timeout, retry, and empty-body paths.

Upgrade note: No migration is required. Schemas only loosen, so previously stored data stays valid, and the upgrade chain gains an identity entry. The upstream Griptape API spec also changed (tag profiles, tags, license info, and engine transports were added); none of those fall under this extension, so no method here changed because of it.

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.10.07.1

2026.10.07.1

Fixed: An empty successful response (for example 202 Accepted) no longer fails with a JSON parse error. Mutating methods return no data handle for it, and list methods treat an empty page as the end of the results.

Fixed: A malformed JSON body now fails with an error that names the HTTP status, method, and path, instead of a bare SyntaxError.

Fixed: Requests no longer hang indefinitely. Each attempt has a 30-second deadline and fails with timed out after <n>ms: <METHOD> <path>. Set GT_CLOUD_TIMEOUT_MS to a positive integer up to 2147483647 to change it. Retry-After waits on HTTP 429 are capped at 30 seconds.

Fixed: Pagination ends on its own page counter and stops at the first empty page. A server that ignores the page parameter can no longer return page 1 up to 20 times, and a list response that is not a JSON object fails with a clear error instead of returning an empty result. A null total_pages no longer ends pagination after the first page, and a next_page value keeps a short page going.

Fixed: Descriptions in generated argument and resource schemas are shortened at a word boundary instead of mid-word.

Fixed: create, update, and delete methods now send their declared query parameters, as get, list, and action methods already did. No current endpoint declares one, so behavior is unchanged today.

Changed: Stored resource schemas are now tolerant of unexpected data. Enums are plain strings or numbers, pattern, length, and range constraints are dropped, every response field accepts null or absence, unknown keys are kept at every level, and spec defaults are no longer filled in. A response with a new enum member or a missing field is stored instead of failing the whole call. Argument validation for requests is unchanged.

Changed: A resource declared without a response body is now stored as a loose object, so whatever the API returns is kept instead of being stripped to {}.

Changed: Generated tests now exercise every method, assert the exact request (HTTP method, path, query string, auth header, JSON body) and the written resource, and cover the shared helper's error, timeout, retry, and empty-body paths.

Upgrade note: No migration is required. Schemas only loosen, so previously stored data stays valid, and the upgrade chain gains an identity entry. The upstream Griptape API spec also changed (tag profiles, tags, license info, and engine transports were added); none of those fall under this extension, so no method here changed because of it.

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.09.18.1

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.09.17.1

2026.09.17.1

Regenerated from latest Griptape Cloud OpenAPI spec.

2026.09.15.1

Changed: Bump zod 4.4.3 → 4.6.5

2026.08.29.1

Added: Initial code-generated release of @webframp/griptape/models with 10 methods covering the Griptape Cloud models API surface.

2026.09.15.1

2026.09.15.1

Changed: Bump zod 4.4.3 → 4.6.5

2026.08.29.1

Added: Initial code-generated release of @webframp/griptape/models with 10 methods covering the Griptape Cloud models API surface.

2026.08.29.1

2026.08.29.1

Added: Initial code-generated release of @webframp/griptape/models with 10 methods covering the Griptape Cloud models API surface.

05Stats
A
100 / 100
Downloads
33
Archive size
15.9 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels