Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "0.10.0"
".": "0.11.0"
}
8 changes: 4 additions & 4 deletions .stats.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 36
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/contextual-ai%2Fsunrise-c8152db455001be3f09a3bc60d63711699d2c2a4ea5f7bbc1d71726efda0fd9b.yml
openapi_spec_hash: 97719df292ca220de5d35d36f9756b95
config_hash: fdaf751580ba8a60e222e560847af1ac
configured_endpoints: 40
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/contextual-ai%2Fsunrise-ca7f807eec8b98ae96fdd0aa6844e268696ffd9219152aed652631c963626a7c.yml
openapi_spec_hash: 85ecd2e4bb8d86a808aa03a9ada2d3c6
config_hash: 73a926de3d35acf984c7a39bbf08c99d
22 changes: 22 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,27 @@
# Changelog

## 0.11.0 (2026-01-13)

Full Changelog: [v0.10.0...v0.11.0](https://github.com/ContextualAI/contextual-client-node/compare/v0.10.0...v0.11.0)

### Features

* **api:** manual updates ([bdaa60d](https://github.com/ContextualAI/contextual-client-node/commit/bdaa60d96310fc66cb8cb43b91b763490237a389))


### Bug Fixes

* **mcp:** correct code tool API endpoint ([8c8bc54](https://github.com/ContextualAI/contextual-client-node/commit/8c8bc545d5f3d1b7ea90d2512ba3343fd0edc591))
* **mcp:** return correct lines on typescript errors ([88e0486](https://github.com/ContextualAI/contextual-client-node/commit/88e0486bdf24efec60fb85b184c8ee2136489c19))


### Chores

* break long lines in snippets into multiline ([38b2e46](https://github.com/ContextualAI/contextual-client-node/commit/38b2e466e843ff15f6d7fb6ad34773aea6356eef))
* **internal:** codegen related update ([d95b949](https://github.com/ContextualAI/contextual-client-node/commit/d95b9493430dac5f336186814f1d9bb49d9c605b))
* **internal:** codegen related update ([35acc42](https://github.com/ContextualAI/contextual-client-node/commit/35acc4287fe07f405bbee43b2b9831f4ced9c492))
* **internal:** codegen related update ([599b5e8](https://github.com/ContextualAI/contextual-client-node/commit/599b5e86fd8cdf3cc56a4300e2b5cdd4b4b34715))

## 0.10.0 (2025-11-11)

Full Changelog: [v0.9.0...v0.10.0](https://github.com/ContextualAI/contextual-client-node/compare/v0.9.0...v0.10.0)
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright 2025 Contextual AI
Copyright 2026 Contextual AI

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down
46 changes: 41 additions & 5 deletions api.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,21 @@
# Shared

Types:

- <code><a href="./src/resources/shared.ts">ParsedBlock</a></code>

# Datastores

Types:

- <code><a href="./src/resources/datastores/datastores.ts">ChunkingConfiguration</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">CreateDatastoreResponse</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">Datastore</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">DatastoreMetadata</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">DatastoreParseConfiguration</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">HTMLConfiguration</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">ListDatastoresResponse</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">UnstructuredDatastoreConfigModel</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">DatastoreUpdateResponse</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">DatastoreDeleteResponse</a></code>
- <code><a href="./src/resources/datastores/datastores.ts">DatastoreResetResponse</a></code>
Expand All @@ -15,9 +25,9 @@ Methods:
- <code title="post /datastores">client.datastores.<a href="./src/resources/datastores/datastores.ts">create</a>({ ...params }) -> CreateDatastoreResponse</code>
- <code title="put /datastores/{datastore_id}">client.datastores.<a href="./src/resources/datastores/datastores.ts">update</a>(datastoreId, { ...params }) -> DatastoreUpdateResponse</code>
- <code title="get /datastores">client.datastores.<a href="./src/resources/datastores/datastores.ts">list</a>({ ...params }) -> DatastoresDatastoresPage</code>
- <code title="delete /datastores/{datastore_id}">client.datastores.<a href="./src/resources/datastores/datastores.ts">delete</a>(datastoreId) -> unknown</code>
- <code title="delete /datastores/{datastore_id}">client.datastores.<a href="./src/resources/datastores/datastores.ts">delete</a>(datastoreId) -> DatastoreDeleteResponse</code>
- <code title="get /datastores/{datastore_id}/metadata">client.datastores.<a href="./src/resources/datastores/datastores.ts">metadata</a>(datastoreId) -> DatastoreMetadata</code>
- <code title="put /datastores/{datastore_id}/reset">client.datastores.<a href="./src/resources/datastores/datastores.ts">reset</a>(datastoreId) -> unknown</code>
- <code title="put /datastores/{datastore_id}/reset">client.datastores.<a href="./src/resources/datastores/datastores.ts">reset</a>(datastoreId) -> DatastoreResetResponse</code>

## Documents

Expand All @@ -34,7 +44,7 @@ Types:
Methods:

- <code title="get /datastores/{datastore_id}/documents">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">list</a>(datastoreId, { ...params }) -> DocumentMetadataDocumentsPage</code>
- <code title="delete /datastores/{datastore_id}/documents/{document_id}">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">delete</a>(datastoreId, documentId) -> unknown</code>
- <code title="delete /datastores/{datastore_id}/documents/{document_id}">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">delete</a>(datastoreId, documentId) -> DocumentDeleteResponse</code>
- <code title="get /datastores/{datastore_id}/documents/{document_id}/parse">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">getParseResult</a>(datastoreId, documentId, { ...params }) -> DocumentGetParseResultResponse</code>
- <code title="post /datastores/{datastore_id}/documents">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">ingest</a>(datastoreId, { ...params }) -> IngestionResponse</code>
- <code title="get /datastores/{datastore_id}/documents/{document_id}/metadata">client.datastores.documents.<a href="./src/resources/datastores/documents.ts">metadata</a>(datastoreId, documentId) -> DocumentMetadata</code>
Expand All @@ -52,10 +62,21 @@ Methods:
- <code title="get /datastores/{datastore_id}/contents">client.datastores.contents.<a href="./src/resources/datastores/contents.ts">list</a>(datastoreId, { ...params }) -> ContentListResponsesContentsPage</code>
- <code title="get /datastores/{datastore_id}/contents/{content_id}/metadata">client.datastores.contents.<a href="./src/resources/datastores/contents.ts">metadata</a>(datastoreId, contentId, { ...params }) -> ContentMetadataResponse</code>

## Chunks

Types:

- <code><a href="./src/resources/datastores/chunks.ts">ChunkUpdateContentResponse</a></code>

Methods:

- <code title="put /datastores/{datastore_id}/chunks/{content_id}/content">client.datastores.chunks.<a href="./src/resources/datastores/chunks.ts">updateContent</a>(datastoreId, contentId, { ...params }) -> ChunkUpdateContentResponse</code>

# Agents

Types:

- <code><a href="./src/resources/agents/agents.ts">ACLConfig</a></code>
- <code><a href="./src/resources/agents/agents.ts">Agent</a></code>
- <code><a href="./src/resources/agents/agents.ts">AgentConfigs</a></code>
- <code><a href="./src/resources/agents/agents.ts">AgentMetadata</a></code>
Expand All @@ -64,21 +85,25 @@ Types:
- <code><a href="./src/resources/agents/agents.ts">GenerateResponseConfig</a></code>
- <code><a href="./src/resources/agents/agents.ts">GlobalConfig</a></code>
- <code><a href="./src/resources/agents/agents.ts">ListAgentsResponse</a></code>
- <code><a href="./src/resources/agents/agents.ts">ReformulationConfig</a></code>
- <code><a href="./src/resources/agents/agents.ts">RetrievalConfig</a></code>
- <code><a href="./src/resources/agents/agents.ts">TranslationConfig</a></code>
- <code><a href="./src/resources/agents/agents.ts">AgentUpdateResponse</a></code>
- <code><a href="./src/resources/agents/agents.ts">AgentDeleteResponse</a></code>
- <code><a href="./src/resources/agents/agents.ts">AgentMetadataResponse</a></code>
- <code><a href="./src/resources/agents/agents.ts">AgentResetResponse</a></code>
- <code><a href="./src/resources/agents/agents.ts">AgentSaveTemplateResponse</a></code>

Methods:

- <code title="post /agents">client.agents.<a href="./src/resources/agents/agents.ts">create</a>({ ...params }) -> CreateAgentOutput</code>
- <code title="put /agents/{agent_id}">client.agents.<a href="./src/resources/agents/agents.ts">update</a>(agentId, { ...params }) -> unknown</code>
- <code title="put /agents/{agent_id}">client.agents.<a href="./src/resources/agents/agents.ts">update</a>(agentId, { ...params }) -> AgentUpdateResponse</code>
- <code title="get /agents">client.agents.<a href="./src/resources/agents/agents.ts">list</a>({ ...params }) -> AgentsPage</code>
- <code title="delete /agents/{agent_id}">client.agents.<a href="./src/resources/agents/agents.ts">delete</a>(agentId) -> unknown</code>
- <code title="delete /agents/{agent_id}">client.agents.<a href="./src/resources/agents/agents.ts">delete</a>(agentId) -> AgentDeleteResponse</code>
- <code title="post /agents/{agent_id}/copy">client.agents.<a href="./src/resources/agents/agents.ts">copy</a>(agentId) -> CreateAgentOutput</code>
- <code title="get /agents/{agent_id}/metadata">client.agents.<a href="./src/resources/agents/agents.ts">metadata</a>(agentId) -> AgentMetadataResponse</code>
- <code title="put /agents/{agent_id}/reset">client.agents.<a href="./src/resources/agents/agents.ts">reset</a>(agentId) -> unknown</code>
- <code title="post /agents/{agent_id}/template">client.agents.<a href="./src/resources/agents/agents.ts">saveTemplate</a>(agentId, { ...params }) -> unknown</code>

## Query

Expand All @@ -96,6 +121,17 @@ Methods:
- <code title="get /agents/{agent_id}/metrics">client.agents.query.<a href="./src/resources/agents/query.ts">metrics</a>(agentId, { ...params }) -> QueryMetricsResponse</code>
- <code title="get /agents/{agent_id}/query/{message_id}/retrieval/info">client.agents.query.<a href="./src/resources/agents/query.ts">retrievalInfo</a>(agentId, messageId, { ...params }) -> RetrievalInfoResponse</code>

## Templates

Types:

- <code><a href="./src/resources/agents/templates.ts">TemplateListResponse</a></code>

Methods:

- <code title="get /agents/templates/{template}">client.agents.templates.<a href="./src/resources/agents/templates.ts">retrieve</a>(template) -> AgentMetadata</code>
- <code title="get /agents/templates">client.agents.templates.<a href="./src/resources/agents/templates.ts">list</a>() -> TemplateListResponse</code>

# Users

Types:
Expand Down
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "contextual-client",
"version": "0.10.0",
"version": "0.11.0",
"description": "The official TypeScript library for the Contextual AI API",
"author": "Contextual AI <support@contextual.ai>",
"types": "dist/index.d.ts",
Expand Down
20 changes: 20 additions & 0 deletions src/index.ts
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ import {
Users,
} from './resources/users';
import {
ACLConfig,
Agent as AgentsAPIAgent,
AgentConfigs,
AgentCreateParams,
Expand All @@ -54,6 +55,8 @@ import {
AgentMetadata,
AgentMetadataResponse,
AgentResetResponse,
AgentSaveTemplateParams,
AgentSaveTemplateResponse,
AgentUpdateParams,
AgentUpdateResponse,
Agents,
Expand All @@ -63,21 +66,27 @@ import {
GenerateResponseConfig,
GlobalConfig,
ListAgentsResponse,
ReformulationConfig,
RetrievalConfig,
TranslationConfig,
} from './resources/agents/agents';
import {
ChunkingConfiguration,
CreateDatastoreResponse,
Datastore,
DatastoreCreateParams,
DatastoreDeleteResponse,
DatastoreListParams,
DatastoreMetadata,
DatastoreParseConfiguration,
DatastoreResetResponse,
DatastoreUpdateParams,
DatastoreUpdateResponse,
Datastores,
DatastoresDatastoresPage,
HTMLConfiguration,
ListDatastoresResponse,
UnstructuredDatastoreConfigModel,
} from './resources/datastores/datastores';

export interface ClientOptions {
Expand Down Expand Up @@ -288,10 +297,14 @@ export declare namespace ContextualAI {

export {
Datastores as Datastores,
type ChunkingConfiguration as ChunkingConfiguration,
type CreateDatastoreResponse as CreateDatastoreResponse,
type Datastore as Datastore,
type DatastoreMetadata as DatastoreMetadata,
type DatastoreParseConfiguration as DatastoreParseConfiguration,
type HTMLConfiguration as HTMLConfiguration,
type ListDatastoresResponse as ListDatastoresResponse,
type UnstructuredDatastoreConfigModel as UnstructuredDatastoreConfigModel,
type DatastoreUpdateResponse as DatastoreUpdateResponse,
type DatastoreDeleteResponse as DatastoreDeleteResponse,
type DatastoreResetResponse as DatastoreResetResponse,
Expand All @@ -303,6 +316,7 @@ export declare namespace ContextualAI {

export {
Agents as Agents,
type ACLConfig as ACLConfig,
type AgentsAPIAgent as Agent,
type AgentConfigs as AgentConfigs,
type AgentMetadata as AgentMetadata,
Expand All @@ -311,15 +325,19 @@ export declare namespace ContextualAI {
type GenerateResponseConfig as GenerateResponseConfig,
type GlobalConfig as GlobalConfig,
type ListAgentsResponse as ListAgentsResponse,
type ReformulationConfig as ReformulationConfig,
type RetrievalConfig as RetrievalConfig,
type TranslationConfig as TranslationConfig,
type AgentUpdateResponse as AgentUpdateResponse,
type AgentDeleteResponse as AgentDeleteResponse,
type AgentMetadataResponse as AgentMetadataResponse,
type AgentResetResponse as AgentResetResponse,
type AgentSaveTemplateResponse as AgentSaveTemplateResponse,
AgentsPage as AgentsPage,
type AgentCreateParams as AgentCreateParams,
type AgentUpdateParams as AgentUpdateParams,
type AgentListParams as AgentListParams,
type AgentSaveTemplateParams as AgentSaveTemplateParams,
};

export {
Expand Down Expand Up @@ -364,6 +382,8 @@ export declare namespace ContextualAI {
type ParseJobResultsParams as ParseJobResultsParams,
type ParseJobsParams as ParseJobsParams,
};

export type ParsedBlock = API.ParsedBlock;
}

export { toFile, fileFromPath } from './uploads';
Expand Down
Loading