modelcontextprotocol / modelcontextprotocol/php-sdk
[Schema] SEP-2663 Tasks: Task shape, resultType discriminator, tasks/* request/result types
Nadie ha tomado este issue todavía.
- Lenguaje dominante
- PHP
- Estrellas
- 1.6k
- Forks
- 173
- Merge medio
- 2 d 49 min
- PR fusionados (30 d)
- 23
Descripción
Schema portion of SEP-2663 (Tasks extension, io.modelcontextprotocol/tasks) for the 2026-07-28 release. Tracked by umbrella #335; sits on the SEP-2133 extensions framework (#344).
Scope
Mcp\Schema\Task:taskId,status,createdAt,lastUpdatedAt,ttlMs,pollIntervalMs,statusMessage,result,error,inputRequests. Flat on the wire in both places it appears (no nestedtaskkey). Enforces the status semantics: a tool that ran and reported a problem iscompletedwithisError;failedis reserved for protocol-level errors and carries the error inlined.Mcp\Schema\Enum\TaskStatus:working,input_required,completed,failed,cancelled(what the merged spec and conformance suite use — notpending/running).Mcp\Schema\Enum\ResultType::Task("task") alongsideCompleteandInputRequired.CreateTaskResult— a result in its own right (resultType: "task"+ the task envelope), returned by any task-augmentable handler instead of a discriminator bolted ontoCallToolResult.TaskResultfortasks/get;tasks/updateandtasks/cancelanswerEmptyResult.TasksGetRequest,TasksUpdateRequest(taskId,inputResponses),TasksCancelRequest.inputRequestsreuse the multi round-trip (SEP-2322) encoding: a map of server-assigned keys to bare method/params pairs.
Notes
SEP-2663 supersedes SEP-1686 (#139, closed).
Guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Línea de trabajo
Comienza con los patrones de schema y enum existentes para TaskStatus, ResultType, CallToolResult y EmptyResult; después, revisa el framework de extensiones en #344 y el alcance general en #335. Implementa los tipos de envelope de tarea, resultado, request y enum indicados, preservando la forma plana del wire y la codificación de inputRequests; se considera terminado cuando todos los tipos nombrados y la semántica de estados coincidan con la especificación fusionada y las expectativas de conformidad.
Escrito por el modelo de indexación a partir del texto del issue.
Evaluación
- Stack tecnológico
- php
- Área
- api, backend-api-design
- Tipo de issue
- Nueva funcionalidad
- Dificultad
- 4/5
- Tiempo estimado
- 3-5 días
- Estado de actividad
- Tranquilo
- Claridad
- Bastante claro
- Aptitud para principiantes
- 48/100