modelcontextprotocol/ext-tasks
Watch
1
0
Fork
You've already forked ext-tasks
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Use SDK imports for TypeScript and remote refs for JSON Schema

Browse source 
- schema.ts: Import core MCP types from @modelcontextprotocol/sdk/types.js
  instead of inline stubs
- schema.json: Use remote \ URIs pointing to core MCP schema at
  https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/
  main/schema/2025-11-25/schema.json
- Add package.json with SDK and TypeScript as devDependencies
- Add .gitignore for node_modules
- Add skipLibCheck to tsconfig.json
- Add index signature to TaskStatusNotificationParams for SDK type compat

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
Caitie McCaffrey 2026-05-11 14:37:49 -07:00
commit 5cac9229cf
5 changed files with 71 additions and 171 deletions
Download patch file Download diff file Expand all files Collapse all files

2
.gitignore vendored Normal file
View file

@ -0,0 +1,2 @@
node_modules/
package-lock.json

14
package.json Normal file
View file

@ -0,0 +1,14 @@
{
"name": "@modelcontextprotocol/experimental-ext-tasks",
"private": true,
"version": "0.1.0",
"description": "MCP Tasks Extension - Experimental extension for task management in the Model Context Protocol",
"license": "Apache-2.0",
"scripts": {
"check:schema": "tsc --noEmit"
},
"devDependencies": {
"@modelcontextprotocol/sdk": "^1.29.0",
"typescript": "^5.0.0"
}
}

107
schema/draft/2025-11-25/schema.json
View file

@ -1,11 +1,11 @@
{ {
"$schema": "http://json-schema.org/draft-07/schema#", "$schema": "http://json-schema.org/draft-07/schema#",
"description": "MCP Tasks Extension Schema. Contains only task-related definitions from the MCP 2025-11-25 specification. Base types (Result, JSONRPCRequest, JSONRPCNotification, etc.) are defined in the core MCP schema.", "description": "MCP Tasks Extension Schema. Contains only task-related definitions from the MCP 2025-11-25 specification. Core MCP types are referenced via remote $ref pointing to the 2025-11-25 core schema.",
"$comment": "Extension Identifier: io.modelcontextprotocol/tasks. Core MCP types (Result, JSONRPCRequest, etc.) are structurally inlined in this schema for portability. The authoritative definitions are in the core schema at https://github.com/modelcontextprotocol/modelcontextprotocol/tree/main/schema/2025-11-25", "$comment": "Extension Identifier: io.modelcontextprotocol/tasks. Core schema: https://github.com/modelcontextprotocol/modelcontextprotocol/tree/2025-11-25/schema/2025-11-25",
"$defs": { "$defs": {
"TaskStatus": { "TaskStatus": {
"description": "The status of a task.", "description": "The status of a task.",
"enum": ["working", "input_required", "completed", "failed", "cancelled"], "enum": ["cancelled", "completed", "failed", "input_required", "working"],
"type": "string" "type": "string"
}, },
"TaskMetadata": { "TaskMetadata": {
@ -32,10 +32,18 @@
"Task": { "Task": {
"description": "Data associated with a task.", "description": "Data associated with a task.",
"properties": { "properties": {
"taskId": { "createdAt": {
"description": "The task identifier.", "description": "ISO 8601 timestamp when the task was created.",
"type": "string" "type": "string"
}, },
"lastUpdatedAt": {
"description": "ISO 8601 timestamp when the task was last updated.",
"type": "string"
},
"pollInterval": {
"description": "Suggested polling interval in milliseconds.",
"type": "integer"
},
"status": { "status": {
"$ref": "#/$defs/TaskStatus", "$ref": "#/$defs/TaskStatus",
"description": "Current task state." "description": "Current task state."
@ -44,24 +52,16 @@
"description": "Optional human-readable message describing the current task state.\nThis can provide context for any status, including:\n- Reasons for \"cancelled\" status\n- Summaries for \"completed\" status\n- Diagnostic information for \"failed\" status (e.g., error details, what went wrong)", "description": "Optional human-readable message describing the current task state.\nThis can provide context for any status, including:\n- Reasons for \"cancelled\" status\n- Summaries for \"completed\" status\n- Diagnostic information for \"failed\" status (e.g., error details, what went wrong)",
"type": "string" "type": "string"
}, },
"createdAt": { "taskId": {
"description": "ISO 8601 timestamp when the task was created.", "description": "The task identifier.",
"type": "string"
},
"lastUpdatedAt": {
"description": "ISO 8601 timestamp when the task was last updated.",
"type": "string" "type": "string"
}, },
"ttl": { "ttl": {
"description": "Actual retention duration from creation in milliseconds, null for unlimited.", "description": "Actual retention duration from creation in milliseconds, null for unlimited.",
"type": ["integer", "null"] "type": ["integer", "null"]
},
"pollInterval": {
"description": "Suggested polling interval in milliseconds.",
"type": "integer"
} }
}, },
"required": ["taskId", "status", "createdAt", "lastUpdatedAt", "ttl"], "required": ["createdAt", "lastUpdatedAt", "status", "taskId", "ttl"],
"type": "object" "type": "object"
}, },
"CreateTaskResult": { "CreateTaskResult": {
@ -69,7 +69,7 @@
"properties": { "properties": {
"_meta": { "_meta": {
"additionalProperties": {}, "additionalProperties": {},
"description": "See the core MCP specification for notes on `_meta` usage.", "description": "See [General fields: `_meta`](/specification/2025-11-25/basic/index#meta) for notes on `_meta` usage.",
"type": "object" "type": "object"
}, },
"task": { "task": {
@ -84,18 +84,18 @@
"properties": { "properties": {
"_meta": { "_meta": {
"additionalProperties": {}, "additionalProperties": {},
"description": "See the core MCP specification for notes on `_meta` usage.", "description": "See [General fields: `_meta`](/specification/2025-11-25/basic/index#meta) for notes on `_meta` usage.",
"properties": { "properties": {
"progressToken": { "progressToken": {
"description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications.", "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/ProgressToken",
"type": ["string", "integer"] "description": "If specified, the caller is requesting out-of-band progress notifications for this request (as represented by notifications/progress). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications."
} }
}, },
"type": "object" "type": "object"
}, },
"task": { "task": {
"$ref": "#/$defs/TaskMetadata", "$ref": "#/$defs/TaskMetadata",
"description": "If specified, the caller is requesting task-augmented execution for this request.\nThe request will return a CreateTaskResult immediately, and the actual result can be retrieved later via tasks/result.\n\nTask augmentation is subject to capability negotiation - receivers MUST declare support for task augmentation of specific request types in their capabilities." "description": "If specified, the caller is requesting task-augmented execution for this request.\nThe request will return a CreateTaskResult immediately, and the actual result can be\nretrieved later via tasks/result.\n\nTask augmentation is subject to capability negotiation - receivers MUST declare support\nfor task augmentation of specific request types in their capabilities."
} }
}, },
"type": "object" "type": "object"
@ -104,8 +104,7 @@
"description": "A request to retrieve the state of a task.", "description": "A request to retrieve the state of a task.",
"properties": { "properties": {
"id": { "id": {
"description": "A unique identifier for the request.", "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/RequestId"
"type": ["string", "integer"]
}, },
"jsonrpc": { "jsonrpc": {
"const": "2.0", "const": "2.0",
@ -130,29 +129,21 @@
"type": "object" "type": "object"
}, },
"GetTaskResult": { "GetTaskResult": {
"description": "The response to a tasks/get request.",
"allOf": [ "allOf": [
{ {
"properties": { "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/Result"
"_meta": {
"additionalProperties": {},
"description": "See the core MCP specification for notes on `_meta` usage.",
"type": "object"
}
},
"type": "object"
}, },
{ {
"$ref": "#/$defs/Task" "$ref": "#/$defs/Task"
} }
] ],
"description": "The response to a tasks/get request."
}, },
"GetTaskPayloadRequest": { "GetTaskPayloadRequest": {
"description": "A request to retrieve the result of a completed task.", "description": "A request to retrieve the result of a completed task.",
"properties": { "properties": {
"id": { "id": {
"description": "A unique identifier for the request.", "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/RequestId"
"type": ["string", "integer"]
}, },
"jsonrpc": { "jsonrpc": {
"const": "2.0", "const": "2.0",
@ -177,12 +168,12 @@
"type": "object" "type": "object"
}, },
"GetTaskPayloadResult": { "GetTaskPayloadResult": {
"description": "The response to a tasks/result request.\nThe structure matches the result type of the original request.\nFor example, a tools/call task would return the CallToolResult structure.",
"additionalProperties": {}, "additionalProperties": {},
"description": "The response to a tasks/result request.\nThe structure matches the result type of the original request.\nFor example, a tools/call task would return the CallToolResult structure.",
"properties": { "properties": {
"_meta": { "_meta": {
"additionalProperties": {}, "additionalProperties": {},
"description": "See the core MCP specification for notes on `_meta` usage.", "description": "See [General fields: `_meta`](/specification/2025-11-25/basic/index#meta) for notes on `_meta` usage.",
"type": "object" "type": "object"
} }
}, },
@ -192,8 +183,7 @@
"description": "A request to cancel a task.", "description": "A request to cancel a task.",
"properties": { "properties": {
"id": { "id": {
"description": "A unique identifier for the request.", "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/RequestId"
"type": ["string", "integer"]
}, },
"jsonrpc": { "jsonrpc": {
"const": "2.0", "const": "2.0",
@ -218,29 +208,21 @@
"type": "object" "type": "object"
}, },
"CancelTaskResult": { "CancelTaskResult": {
"description": "The response to a tasks/cancel request.",
"allOf": [ "allOf": [
{ {
"properties": { "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/Result"
"_meta": {
"additionalProperties": {},
"description": "See the core MCP specification for notes on `_meta` usage.",
"type": "object"
}
},
"type": "object"
}, },
{ {
"$ref": "#/$defs/Task" "$ref": "#/$defs/Task"
} }
] ],
"description": "The response to a tasks/cancel request."
}, },
"ListTasksRequest": { "ListTasksRequest": {
"description": "A request to retrieve a list of tasks.", "description": "A request to retrieve a list of tasks.",
"properties": { "properties": {
"id": { "id": {
"description": "A unique identifier for the request.", "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/RequestId"
"type": ["string", "integer"]
}, },
"jsonrpc": { "jsonrpc": {
"const": "2.0", "const": "2.0",
@ -251,13 +233,7 @@
"type": "string" "type": "string"
}, },
"params": { "params": {
"properties": { "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/PaginatedRequestParams"
"cursor": {
"description": "An opaque token representing the current pagination position.",
"type": "string"
}
},
"type": "object"
} }
}, },
"required": ["id", "jsonrpc", "method"], "required": ["id", "jsonrpc", "method"],
@ -268,7 +244,7 @@
"properties": { "properties": {
"_meta": { "_meta": {
"additionalProperties": {}, "additionalProperties": {},
"description": "See the core MCP specification for notes on `_meta` usage.", "description": "See [General fields: `_meta`](/specification/2025-11-25/basic/index#meta) for notes on `_meta` usage.",
"type": "object" "type": "object"
}, },
"nextCursor": { "nextCursor": {
@ -286,22 +262,15 @@
"type": "object" "type": "object"
}, },
"TaskStatusNotificationParams": { "TaskStatusNotificationParams": {
"description": "Parameters for a `notifications/tasks/status` notification.",
"allOf": [ "allOf": [
{ {
"properties": { "$ref": "https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/2025-11-25/schema.json#/$defs/NotificationParams"
"_meta": {
"additionalProperties": {},
"description": "See the core MCP specification for notes on `_meta` usage.",
"type": "object"
}
},
"type": "object"
}, },
{ {
"$ref": "#/$defs/Task" "$ref": "#/$defs/Task"
} }
] ],
"description": "Parameters for a `notifications/tasks/status` notification."
}, },
"TaskStatusNotification": { "TaskStatusNotification": {
"description": "An optional notification from the receiver to the requestor, informing them that a task's status has changed. Receivers are not required to send these notifications.", "description": "An optional notification from the receiver to the requestor, informing them that a task's status has changed. Receivers are not required to send these notifications.",

116
schema/draft/2025-11-25/schema.ts
View file

@ -3,110 +3,23 @@
* Extension Identifier: io.modelcontextprotocol/tasks * Extension Identifier: io.modelcontextprotocol/tasks
* *
* This file contains only the task-related types from the MCP 2025-11-25 specification. * This file contains only the task-related types from the MCP 2025-11-25 specification.
* Base types (Result, JSONRPCRequest, JSONRPCNotification, etc.) are defined in the * Base types are imported from the core MCP SDK.
* core MCP schema at https://github.com/modelcontextprotocol/modelcontextprotocol
* *
* @see https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/tasks * @see https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/tasks
*/ */
// ============================================================================ import type {
// Base type stubs (defined in core MCP schema) Cursor,
// ============================================================================ JSONRPCNotification,
// JSONRPCRequest,
// The following types are minimal stubs of core MCP types, provided solely so NotificationParams,
// that this file compiles. They are NOT part of the Tasks extension API. PaginatedRequest,
// Implementations MUST use the authoritative definitions from the core schema: PaginatedResult,
// https://github.com/modelcontextprotocol/modelcontextprotocol/tree/main/schema/2025-11-25 ProgressToken,
// ============================================================================ RequestId,
RequestParams,
/** Result,
* @internal Core MCP type stub — see core schema for authoritative definition. } from "@modelcontextprotocol/sdk/types.js";
*/
type ProgressToken = string | number;
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
type Cursor = string;
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
type RequestId = string | number;
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface RequestParams {
_meta?: {
progressToken?: ProgressToken;
[key: string]: unknown;
};
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface NotificationParams {
_meta?: { [key: string]: unknown };
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface Result {
_meta?: { [key: string]: unknown };
[key: string]: unknown;
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface Request {
method: string;
// eslint-disable-next-line @typescript-eslint/no-explicit-any
params?: { [key: string]: any };
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface Notification {
method: string;
// eslint-disable-next-line @typescript-eslint/no-explicit-any
params?: { [key: string]: any };
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface JSONRPCRequest extends Request {
jsonrpc: "2.0";
id: RequestId;
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface JSONRPCNotification extends Notification {
jsonrpc: "2.0";
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface PaginatedRequest extends JSONRPCRequest {
params?: RequestParams & {
cursor?: Cursor;
};
}
/**
* @internal Core MCP type stub — see core schema for authoritative definition.
*/
interface PaginatedResult extends Result {
nextCursor?: Cursor;
}
/* Tasks */ /* Tasks */
@ -301,7 +214,8 @@ export interface ListTasksResult extends PaginatedResult {
* *
* @category `notifications/tasks/status` * @category `notifications/tasks/status`
*/ */
export type TaskStatusNotificationParams = NotificationParams & Task; export type TaskStatusNotificationParams = NotificationParams &
Task & { [key: string]: unknown };
/** /**
* An optional notification from the receiver to the requestor, informing them that a task's status has changed. Receivers are not required to send these notifications. * An optional notification from the receiver to the requestor, informing them that a task's status has changed. Receivers are not required to send these notifications.

3
tsconfig.json
View file

@ -4,7 +4,8 @@
"noEmit": true, "noEmit": true,
"target": "ES2020", "target": "ES2020",
"module": "ES2020", "module": "ES2020",
"moduleResolution": "node" "moduleResolution": "node",
"skipLibCheck": true
}, },
"include": ["schema/**/*.ts"] "include": ["schema/**/*.ts"]
} }