Skip to content
Open
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 @@
{
".": "1.1.0"
".": "1.1.1"
}
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
# Changelog

## 1.1.1 (2025-10-09)

Full Changelog: [v1.1.0...v1.1.1](https://github.com/caesar-data/typescript-sdk/compare/v1.1.0...v1.1.1)

### Chores

* extract some types in mcp docs ([190cca3](https://github.com/caesar-data/typescript-sdk/commit/190cca35a1688c55856b7bf98fc6ff7b1846b054))
* **internal:** use npm pack for build uploads ([f3839b3](https://github.com/caesar-data/typescript-sdk/commit/f3839b3fd54b91eac9869c49daddf80db8fc98e2))

## 1.1.0 (2025-10-04)

Full Changelog: [v1.0.0...v1.1.0](https://github.com/caesar-data/typescript-sdk/compare/v1.0.0...v1.1.0)
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": "caesar-data",
"version": "1.1.0",
"version": "1.1.1",
"description": "The official TypeScript library for the Caesar API",
"author": "Caesar <dev@caesar.xyz>",
"types": "dist/index.d.ts",
Expand Down
2 changes: 1 addition & 1 deletion packages/mcp-server/package.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "caesar-mcp",
"version": "1.1.0",
"version": "1.1.1",
"description": "The official MCP Server for the Caesar API",
"author": "Caesar <dev@caesar.xyz>",
"types": "dist/index.d.ts",
Expand Down
2 changes: 1 addition & 1 deletion packages/mcp-server/src/server.ts
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ export const newMcpServer = () =>
new McpServer(
{
name: 'caesar_data_api',
version: '1.1.0',
version: '1.1.1',
},
{ capabilities: { tools: {}, logging: {} } },
);
Expand Down
2 changes: 1 addition & 1 deletion packages/mcp-server/src/tools/research/create-research.ts
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ export const metadata: Metadata = {
export const tool: Tool = {
name: 'create_research',
description:
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nStart a new research job using a query and optional file IDs.\n\n# Response Schema\n```json\n{\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Research job identifier.'\n },\n status: {\n type: 'string',\n description: 'Current status of the research job.',\n enum: [ 'queued',\n 'searching',\n 'summarizing',\n 'analyzing',\n 'completed',\n 'failed',\n 'researching'\n ]\n }\n },\n required: [ 'id',\n 'status'\n ]\n}\n```",
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nStart a new research job using a query and optional file IDs.\n\n# Response Schema\n```json\n{\n $ref: '#/$defs/research_create_response',\n $defs: {\n research_create_response: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Research job identifier.'\n },\n status: {\n type: 'string',\n description: 'Current status of the research job.',\n enum: [ 'queued',\n 'searching',\n 'summarizing',\n 'analyzing',\n 'completed',\n 'failed',\n 'researching'\n ]\n }\n },\n required: [ 'id',\n 'status'\n ]\n }\n }\n}\n```",
inputSchema: {
type: 'object',
properties: {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ export const metadata: Metadata = {
export const tool: Tool = {
name: 'create_research_files',
description:
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpload a file via multipart form and create a Research File object.\n\n# Response Schema\n```json\n{\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Unique identifier for the file.'\n },\n content_type: {\n type: 'string',\n description: 'MIME type of the file as detected/stored.'\n },\n file_name: {\n type: 'string',\n description: 'Original uploaded filename.'\n }\n },\n required: [ 'id',\n 'content_type',\n 'file_name'\n ]\n}\n```",
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpload a file via multipart form and create a Research File object.\n\n# Response Schema\n```json\n{\n $ref: '#/$defs/file_create_response',\n $defs: {\n file_create_response: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Unique identifier for the file.'\n },\n content_type: {\n type: 'string',\n description: 'MIME type of the file as detected/stored.'\n },\n file_name: {\n type: 'string',\n description: 'Original uploaded filename.'\n }\n },\n required: [ 'id',\n 'content_type',\n 'file_name'\n ]\n }\n }\n}\n```",
inputSchema: {
type: 'object',
properties: {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ export const metadata: Metadata = {
export const tool: Tool = {
name: 'list_research_files',
description:
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a paginated list of Research File objects.\n\n# Response Schema\n```json\n{\n type: 'object',\n properties: {\n data: {\n type: 'array',\n description: 'List of file objects.',\n items: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Unique identifier for the file.'\n },\n content_type: {\n type: 'string',\n description: 'MIME type of the file as detected/stored.'\n },\n file_name: {\n type: 'string',\n description: 'Original uploaded filename.'\n }\n },\n required: [ 'id',\n 'content_type',\n 'file_name'\n ]\n }\n },\n pagination: {\n type: 'object',\n properties: {\n has_next: {\n type: 'boolean',\n description: 'Whether another page is available.'\n },\n limit: {\n type: 'integer',\n description: 'Page size (items per page).'\n },\n page: {\n type: 'integer',\n description: 'Current page number (1-based).'\n },\n total: {\n type: 'integer',\n description: 'Total number of items (may be omitted).'\n }\n },\n required: [ 'has_next',\n 'limit',\n 'page'\n ]\n }\n },\n required: [ 'data',\n 'pagination'\n ]\n}\n```",
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a paginated list of Research File objects.\n\n# Response Schema\n```json\n{\n type: 'object',\n properties: {\n data: {\n type: 'array',\n description: 'List of file objects.',\n items: {\n $ref: '#/$defs/file_list_response'\n }\n },\n pagination: {\n type: 'object',\n properties: {\n has_next: {\n type: 'boolean',\n description: 'Whether another page is available.'\n },\n limit: {\n type: 'integer',\n description: 'Page size (items per page).'\n },\n page: {\n type: 'integer',\n description: 'Current page number (1-based).'\n },\n total: {\n type: 'integer',\n description: 'Total number of items (may be omitted).'\n }\n },\n required: [ 'has_next',\n 'limit',\n 'page'\n ]\n }\n },\n required: [ 'data',\n 'pagination'\n ],\n $defs: {\n file_list_response: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Unique identifier for the file.'\n },\n content_type: {\n type: 'string',\n description: 'MIME type of the file as detected/stored.'\n },\n file_name: {\n type: 'string',\n description: 'Original uploaded filename.'\n }\n },\n required: [ 'id',\n 'content_type',\n 'file_name'\n ]\n }\n }\n}\n```",
inputSchema: {
type: 'object',
properties: {
Expand Down
2 changes: 1 addition & 1 deletion packages/mcp-server/src/tools/research/list-research.ts
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ export const metadata: Metadata = {
export const tool: Tool = {
name: 'list_research',
description:
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a paginated list of research objects.\n\n# Response Schema\n```json\n{\n type: 'object',\n properties: {\n data: {\n type: 'array',\n description: 'List of research objects.',\n items: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Research job identifier.'\n },\n created_at: {\n type: 'string',\n description: 'ISO 8601 timestamp when the job was created.',\n format: 'date-time'\n },\n query: {\n type: 'string',\n description: 'Original query.'\n },\n results: {\n type: 'array',\n description: 'Ranked retrieval results and citations.',\n items: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Result object identifier.'\n },\n score: {\n type: 'number',\n description: 'Relevance score (0–1).'\n },\n title: {\n type: 'string',\n description: 'Result title.'\n },\n url: {\n type: 'string',\n description: 'Canonical URL of the result.'\n },\n citation_index: {\n type: 'integer',\n description: 'Index used for inline citations (if present).'\n }\n },\n required: [ 'id',\n 'score',\n 'title',\n 'url'\n ]\n }\n },\n status: {\n type: 'string',\n description: 'Current status of the research job.',\n enum: [ 'queued',\n 'searching',\n 'summarizing',\n 'analyzing',\n 'completed',\n 'failed',\n 'researching'\n ]\n },\n content: {\n type: 'string',\n description: 'Final content/synthesis (null until available).'\n },\n transformed_content: {\n type: 'string',\n description: 'Post-processed content (e.g., formatted/converted).'\n }\n },\n required: [ 'id',\n 'created_at',\n 'query',\n 'results',\n 'status'\n ]\n }\n },\n pagination: {\n type: 'object',\n properties: {\n has_next: {\n type: 'boolean',\n description: 'Whether another page is available.'\n },\n limit: {\n type: 'integer',\n description: 'Page size (items per page).'\n },\n page: {\n type: 'integer',\n description: 'Current page number (1-based).'\n },\n total: {\n type: 'integer',\n description: 'Total number of items (may be omitted).'\n }\n },\n required: [ 'has_next',\n 'limit',\n 'page'\n ]\n }\n },\n required: [ 'data',\n 'pagination'\n ]\n}\n```",
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns a paginated list of research objects.\n\n# Response Schema\n```json\n{\n type: 'object',\n properties: {\n data: {\n type: 'array',\n description: 'List of research objects.',\n items: {\n $ref: '#/$defs/research_list_response'\n }\n },\n pagination: {\n type: 'object',\n properties: {\n has_next: {\n type: 'boolean',\n description: 'Whether another page is available.'\n },\n limit: {\n type: 'integer',\n description: 'Page size (items per page).'\n },\n page: {\n type: 'integer',\n description: 'Current page number (1-based).'\n },\n total: {\n type: 'integer',\n description: 'Total number of items (may be omitted).'\n }\n },\n required: [ 'has_next',\n 'limit',\n 'page'\n ]\n }\n },\n required: [ 'data',\n 'pagination'\n ],\n $defs: {\n research_list_response: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Research job identifier.'\n },\n created_at: {\n type: 'string',\n description: 'ISO 8601 timestamp when the job was created.',\n format: 'date-time'\n },\n query: {\n type: 'string',\n description: 'Original query.'\n },\n results: {\n type: 'array',\n description: 'Ranked retrieval results and citations.',\n items: {\n type: 'object',\n properties: {\n id: {\n type: 'string',\n description: 'Result object identifier.'\n },\n score: {\n type: 'number',\n description: 'Relevance score (0–1).'\n },\n title: {\n type: 'string',\n description: 'Result title.'\n },\n url: {\n type: 'string',\n description: 'Canonical URL of the result.'\n },\n citation_index: {\n type: 'integer',\n description: 'Index used for inline citations (if present).'\n }\n },\n required: [ 'id',\n 'score',\n 'title',\n 'url'\n ]\n }\n },\n status: {\n type: 'string',\n description: 'Current status of the research job.',\n enum: [ 'queued',\n 'searching',\n 'summarizing',\n 'analyzing',\n 'completed',\n 'failed',\n 'researching'\n ]\n },\n content: {\n type: 'string',\n description: 'Final content/synthesis (null until available).'\n },\n transformed_content: {\n type: 'string',\n description: 'Post-processed content (e.g., formatted/converted).'\n }\n },\n required: [ 'id',\n 'created_at',\n 'query',\n 'results',\n 'status'\n ]\n }\n }\n}\n```",
inputSchema: {
type: 'object',
properties: {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ export const metadata: Metadata = {
export const tool: Tool = {
name: 'retrieve_content_research_results',
description:
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns the raw content for a specific result within a research object.\n\n\n# Response Schema\n```json\n{\n type: 'object',\n properties: {\n content: {\n type: 'string',\n description: 'Raw extracted content for this result (may include HTML, markdown, or plain text).'\n }\n },\n required: [ 'content'\n ]\n}\n```",
"When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nReturns the raw content for a specific result within a research object.\n\n\n# Response Schema\n```json\n{\n $ref: '#/$defs/result_retrieve_content_response',\n $defs: {\n result_retrieve_content_response: {\n type: 'object',\n properties: {\n content: {\n type: 'string',\n description: 'Raw extracted content for this result (may include HTML, markdown, or plain text).'\n }\n },\n required: [ 'content'\n ]\n }\n }\n}\n```",
inputSchema: {
type: 'object',
properties: {
Expand Down
Loading