Previsualiza el contexto que recibiría un agente
Responde «¿qué recibiría exactamente este agente para este issue?»: ensambla el paquete de contexto con la misma lógica que al reclamar una tarea (mismo nivel 1 del SDLC del issue), sin guardar nada. Primero se comprueba el issue: si no existe o no lo ves, 404. Después `agent_id`: si no es un uuid, 400 `agent_required`; si no es un agente de este workspace, 404. La rama del paquete es la del SDLC del issue o, si no tiene, `hqf/<prefijo en minúsculas>-<número>-<slug del agente>-preview`; la base, la rama por defecto del proyecto del issue o `main`. `prompt` hace de petición de la tarea.
Responde «¿qué recibiría exactamente este agente para este issue?»: ensambla el paquete de contexto con la misma lógica que al reclamar una tarea (mismo nivel 1 del SDLC del issue), sin guardar nada.
Primero se comprueba el issue: si no existe o no lo ves, 404. Después agent_id: si no es un uuid, 400
agent_required; si no es un agente de este workspace, 404. La rama del paquete es la del SDLC del issue o,
si no tiene, hqf/<prefijo en minúsculas>-<número>-<slug del agente>-preview; la base, la rama por defecto
del proyecto del issue o main. prompt hace de petición de la tarea.
AutorizaciónBearer <JWT>Sesión del navegador: el JWT que devuelve POST /api/auth/verify. Algunas rutas sólo la aceptan a ella
(middleware requireSession); un token de API recibe 403 session_required.
ws*stringSlug del workspace. Hay que ser miembro (si no, 404 workspace_not_found).
application/json- body
Cuerpo de la vista previa del contexto (struct anónimo, internal/api/context.go:536).
issue_number*integerNúmero del issue en el workspace.
agent_id*stringuuidprompt?stringLa petición de la tarea (opcional).
El paquete de contexto ensamblado.
application/json- response
El paquete de contexto ensamblado para un agente (contextmesh.Bundle, internal/contextmesh/assemble.go:88).
budget_tokens*integerVentana nominal del agente (24000 si el agente no tiene una).
target_tokens*integerPresupuesto × utilización objetivo (0.7 por defecto); tope duro de la selección.
used_tokens*integerutilization*numberincluded*array<>dropped*array<>clashes*array<>slots*Tokens por ranura (instructions, knowledge, tools, memory, state, query).
static_prefix*stringNivel 1 del prefijo, compartido entre los issues de un agente y proyecto.
issue_prefix*stringNivel 2, los nodos fijados de la capa issue; va al principio de dynamic_part.
dynamic_part*stringprefix_hash*stringissue_prefix_hash*stringrendered*stringEl texto final que recibiría el agente.
skills_mode*stringCon qué modo se ensambló el protocolo de skills.
prefix_tokens*integerTokens del nivel 1.
curl -X POST 'http://127.0.0.1:8080/api/w/string/context/preview' \ -H 'Content-Type: application/json' \ -d '{ "issue_number": 0, "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978"}'{ "budget_tokens": 0, "target_tokens": 0, "used_tokens": 0, "utilization": 0, "included": [ { "node_id": "6e0bdcac-9717-4a6f-972e-97489dffeb0c", "short_id": "string", "title": "string", "scope": "string", "slot": "string", "kind": "string", "tokens": 0, "score": 0, "reason": "string" } ], "dropped": [ { "node_id": "6e0bdcac-9717-4a6f-972e-97489dffeb0c", "short_id": "string", "title": "string", "scope": "string", "slot": "string", "kind": "string", "tokens": 0, "score": 0, "reason": "string" } ], "clashes": [ { "kept": "string", "dropped": "string", "relation": "string" } ], "slots": { "property1": 0, "property2": 0 }, "static_prefix": "string", "issue_prefix": "string", "dynamic_part": "string", "prefix_hash": "string", "issue_prefix_hash": "string", "rendered": "string", "skills_mode": "string", "prefix_tokens": 0}