GEODE

El modelo elige la siguiente acción; el host mantiene la frontera de ejecución.

El runtime, desde que una solicitud entra en una sesión, pasando por la llamada al modelo y las comprobaciones de autoridad de cada llamada a herramienta propuesta, hasta la ejecución, los resultados y los registros. Al elegir un flujo se resalta solo su ruta, con pasos numerados.

El modelo elige la siguiente acción; el runtime comprueba los permisos de las herramientas y decide cuándo el trabajo está terminado.

Los experimentos externos Scaffold Search / SIL comenzaron el May 15, 2026

Se instala desde el paquete geode-agent de PyPI o desde el repositorio público y se ejecuta en una terminal local. También se puede usar como servidor MCP.

Arquitectura del runtime · trazada a partir de las rutas de código en el commit fijado 9e2c041

Solicitud → llamada al modelo

Una solicitud de terminal llega por IPC, se compone una sesión y el bucle llama al modelo con el prompt del sistema, la conversación y los esquemas de herramientas.

Usuario de terminalflujo de datos: prompt · cli.sockCLIPoller · socket IPCcore/server
La CLI ligera envía la solicitud al socket IPC del daemon serve (~/.geode/cli.sock). El REPL ejecuta la misma composición de sesión dentro del proceso.
CLIPoller · socket IPCcore/serverautoridad · composición: create_session(IPC)SharedServices.create_sessionsupervised/services.py
Cada conexión compone una sesión. El modo fija el nivel de HITL, el presupuesto de tiempo y las herramientas denegadas, y proyecta el BoundToolPlan sobre el proveedor elegido.
CLIPoller · socket IPCcore/serverautoridad · composición: carril por solicitudLaneQueue · session · globalsupervised/services.py
Antes de ejecutar una solicitud se toman tanto el carril de sesión como el carril global, lo que limita las ejecuciones concurrentes.
SharedServices.create_sessionsupervised/services.pyautoridad · composición: ToolExecutor · AgenticLoopAgenticLoop · seis fasescore/agent/loop
Construye el ejecutor y el bucle como un par que comparte los hooks, MCP, las skills y los bloqueos de recursos.
LaneQueue · session · globalsupervised/services.pyflujo de datos: arun(prompt)AgenticLoop · seis fasescore/agent/loop
Ejecuta un turno de usuario en seis fases: preparar la entrada, preparar la llamada, llamar al proveedor, procesar herramientas, observar y compactar, terminar.
prompt del sistema · fuentes declaradascore/agent/loopflujo de datos: prompt del sistemaadapter.acomplete · clases de errorcore/llm/adapters
Se construye en cada turno a partir de fuentes declaradas, como secciones elegidas de GEODE.md y reglas. La fachada de cinco niveles de ContextAssembler solo se usa cuando se la llama explícitamente; no es la entrada del bucle por defecto.
mensajes · ConversationContextcore/agent/loopflujo de datos: mensajesadapter.acomplete · clases de errorcore/llm/adapters
La conversación y los resultados de herramientas anteriores viajan aparte del prompt del sistema.
BoundToolPlan · inmutablecore/tools/plan.pyautoridad · composición: esquemas de herramientasadapter.acomplete · clases de errorcore/llm/adapters
Solo las herramientas del BoundToolPlan vinculado a este paso son visibles para el modelo. Es una instantánea inmutable con una generación y un hash de contenido.
AgenticLoop · seis fasescore/agent/loopflujo de datos: StepSnapshot · solicitudadapter.acomplete · clases de errorcore/llm/adapters
El StepSnapshot fija el modelo, las herramientas y los ID de correlación de esta llamada. El middleware de LLM no puede cambiar un adaptador vinculado.
adapter.acomplete · clases de errorcore/llm/adaptersflujo de datos: HTTPSProveedores de LLM
Un adaptador por proveedor hace la llamada. Los fallos se clasifican y se reintentan solo dentro de un límite fijado, o terminan el turno con un motivo de terminación.
adapter.acomplete · clases de errorcore/llm/adaptersflujo de datos: respuesta · tool_useAgenticLoop · seis fasescore/agent/loop
El texto solo va a la terminación; tool_use va al procesamiento de herramientas.

Autoridad de la herramienta → efecto → resultado

Una propuesta tool_use solo se ejecuta tras superar todas las comprobaciones; denegaciones, resultados y errores vuelven todos del ejecutor y se convierten en la siguiente entrada del modelo.

AgenticLoop · seis fasescore/agent/loopflujo de datos: lote pendiente · guardado por rondaSQLite messages · state.jsonmemory/session_checkpoint.py
En una sesión con checkpointing configurado (un checkpoint y un session id), el lote propuesto se guarda antes de que se ejecute ninguna herramienta, y el lote no se ejecuta si no se puede guardar. El lote completado se guarda de nuevo. Quienes llaman sin checkpoint no tienen esta garantía.
AgenticLoop · seis fasescore/agent/loopflujo de datos: bloques tool_useToolCallProcessortool_executor/processor.py
Una propuesta del modelo no es un permiso. Cada llamada recibe un ToolContext con la identidad del modelo y del adaptador del bucle.
ToolCallProcessortool_executor/processor.pyflujo de datos: aexecutealcance · política · esquematool_executor/executor.py
Comprueba en orden el alcance de la sesión, las reescrituras del middleware de solicitudes, la política y el esquema. Se deniega una reescritura que rebaje el nivel de seguridad o la clase de datos personales.
BoundToolPlan · inmutablecore/tools/plan.pyautoridad · composición: permitido · nivel de seguridadalcance · política · esquematool_executor/executor.py
Los handlers ejecutables y los niveles de seguridad provienen del BoundToolPlan proyectado para la sesión.
PreToolUse · PostToolUsetool_executor/executor.pyautoridad · composición: PreToolUse · PostToolUseHookRegistry · decisionescore/hooks
Los hooks públicos deciden bloqueo, reescritura de argumentos o solicitud de permiso, y tras una reescritura se repiten las comprobaciones de alcance, política y esquema. Después de la ejecución, un hook puede añadir contexto o retener el resultado.
aprobación · HITLtool_executor/executor.pyautoridad · composición: solicitud de aprobaciónUsuario de terminal
En una sesión IPC, la solicitud de aprobación se transmite a la CLI ligera. Los modos sin una persona aplican por defecto la política de denegación; la única excepción es el computer use en DAEMON, cuando un operador lo habilita por separado (bloqueado en caso contrario).
tool_executor/executor.pydenegación antes de la ejecución: denegado antes de la ejecuciónToolCallProcessortool_executor/processor.py
Un rechazo de alcance, política o esquema, un bloqueo de PreToolUse o una aprobación denegada vuelve como resultado de error sin dispatch. En ese caso, no comenzó ningún efecto de esta llamada.
effect receipttool_executor/executor.pyflujo de datos: admisión del efecto · confirmaciónEffectReceiptStorememory/effect_receipts.py
Efectos como cambios de archivos, mensajes salientes o acciones administrativas se admiten antes de ejecutarse. Un resultado incierto no se vuelve a ejecutar; pide una conciliación.
bloqueo de recursos · dispatchtool_executor/executor.pyflujo de datos: llamada al handlerhandlers de herramientas · bash · computercore/tools
Despacha al handler vinculado tras bloquear sus claves de recurso. Una llamada abortada al vencer su plazo puede seguir ejecutándose fuera.
bloqueo de recursos · dispatchtool_executor/executor.pyflujo de datos: llamada MCPMCPServerManagercore/mcp/manager.py
Solo se llaman las herramientas MCP con una política de recursos declarada.
MCPServerManagercore/mcp/manager.pyflujo de datos: tools/callServidores MCP
El catálogo de servidores proviene de la configuración global y de la configuración de proyecto que superó la comprobación de confianza; esa comprobación solo se aplica a las entradas de proyecto. El gestor MCP aplica su política de extensiones y recursos.
handlers de herramientas · bash · computercore/toolsflujo de datos: cambios de archivos · git · procesosArchivos · git · procesos
Los cambios ejecutados quedan como estado externo. El checkpoint solo recupera la conversación y no los deshace.
tool_executor/executor.pyflujo de datos: resultado · error tras el dispatchToolCallProcessortool_executor/processor.py
Tras el dispatch, los resultados normales y los errores (incluidos tiempos de espera agotados y resultados inciertos) vuelven a través de PostToolUse. Un error o un tiempo de espera agotado no significa que el trabajo externo se detuviera o se deshiciera.
ToolCallProcessortool_executor/processor.pyflujo de datos: tool_resultmensajes · ConversationContextcore/agent/loop
Resultados, denegaciones y errores se serializan por igual como tool_result y se convierten en mensajes de la siguiente entrada del modelo.
ToolCallProcessortool_executor/processor.pyregistro · observación: observación de llamada · resultadoSessionTimeline · append-onlyobservability/session_timeline.py
Escribe la llamada y su resultado (ok o error) en la timeline, incluidas las llamadas denegadas antes de la ejecución. El registro es observación; no prueba que un efecto externo comenzara o tuviera éxito.

Registros · recuperación · finalización

El checkpoint, la timeline y las filas de evidencia se escriben por separado. No hay una transacción compartida, y el checkpoint solo recupera la conversación.

AgenticLoop · seis fasescore/agent/loopflujo de datos: lote pendiente · guardado por rondaSQLite messages · state.jsonmemory/session_checkpoint.py
En una sesión con checkpointing configurado (un checkpoint y un session id), el lote propuesto se guarda antes de que se ejecute ninguna herramienta, y el lote no se ejecuta si no se puede guardar. El lote completado se guarda de nuevo. Quienes llaman sin checkpoint no tienen esta garantía.
SQLite messages · state.jsonmemory/session_checkpoint.pyflujo de datos: restauración al reanudarAgenticLoop · seis fasescore/agent/loop
Una sola ruta de restauración recupera los mensajes, el estado cognitivo y los contadores de guardas. El TaskGraph local del proceso no se recupera.
AgenticLoop · seis fasescore/agent/loopregistro · observación: registro del turnoSessionTimeline · append-onlyobservability/session_timeline.py
Un historial de ejecución de solo anexado, nunca reproducido como estado.
AgenticLoop · seis fasescore/agent/loopautoridad · composición: comprobación de finalizaciónverify_turn_asynccore/agent/verify.py
La propuesta de parada del modelo solo se convierte en finalización a través de Verify.
verify_turn_asynccore/agent/verify.pyautoridad · composición: PostVerify · StopHookRegistry · decisionescore/hooks
Las decisiones de los hooks públicos indican si se continúa con una reparación, y las reparaciones solo ocurren dentro de un presupuesto fijado (dos por defecto).
AgenticLoop · seis fasescore/agent/loopregistro · observación: filas de evidencia · best-effortEvidenceLedger · JSONLagent/evidence_ledger.py
Filas de diagnóstico con datos ocultos. Los hashes sirven para la correlación; una fila no prueba que un efecto ocurriera, y no se escribe en una misma transacción con la timeline o el checkpoint.
AgenticLoop · seis fasescore/agent/loopregistro · observación: eventos cognitivos · de ciclo de vidaHookSystem · observacióncore/hooks
Los hooks de observación reciben y registran eventos; no deciden la ejecución.

Otras rutas de entrada

Las mensajerías entran como sesiones DAEMON del daemon serve; el run_agent de un host MCP externo entra en un bucle headless de ejecución única construido aparte.

Canal de mensajeríaflujo de datos: mensaje de canalpollers de mensajeríacore/server
Los pollers del daemon serve solo procesan mensajes de canales vinculados.
pollers de mensajeríacore/serverautoridad · composición: create_session(DAEMON)SharedServices.create_sessionsupervised/services.py
Un modo sin una persona que apruebe: se aplican la política de denegación por defecto y un presupuesto de tiempo. Solo el computer use puede habilitarlo por separado un operador; si no, sigue bloqueado.
pollers de mensajeríacore/serverflujo de datos: arun(message)AgenticLoop · seis fasescore/agent/loop
Un hilo conserva un session id fijo y continúa una sola cadena de checkpoints.
Host MCP externoflujo de datos: run_agent(prompt)run_agent · ejecución únicacore/mcp_server.py
Un host MCP externo llama a GEODE como herramienta.
run_agent · ejecución únicacore/mcp_server.pyflujo de datos: bucle headless de ejecución únicaAgenticLoop · seis fasescore/agent/loop
Un ejecutor y un bucle headless construidos aparte que evitan SharedServices. La lista de denegación por defecto se aplica tal cual, así que se quitan herramientas como run_bash, delegate_task y computer; la excepción de computer use de DAEMON no existe aquí.

Todas las conexiones con el mismo grosor. Elija un flujo para resaltar solo su recorrido, con pasos numerados.

Continua · dirección en que fluyen solicitudes, mensajes y resultados de herramientas
Discontinua · composición de sesión, autoridad o veredicto; no es una ruta de datos
Raya larga y punto · registros y observación; nunca se reproducen como estado
Guion corto · denegación antes de la ejecución, sin efecto
Línea negra gruesa · el flujo seleccionado; los números dan el orden
Recuadro · frontera dueña del código, con su ruta de origen en la cabecera
Chip interior · componente de esa frontera
Recuadro discontinuo · fuera del proceso del runtime
Contorno naranja · donde decide un modelo

Bucle de ejecución
Autoridad · veredictos
Almacenes de registros
Entrada · conexión · ejecución

Solo se dibujan las conexiones cuyas llamadas se confirmaron. La fachada de cinco niveles de ContextAssembler, el TaskGraph y experimentos de investigación como Jev, SIL y Crucible no están en esta ruta del runtime. La cancelación asíncrona no detiene el trabajo síncrono ya iniciado ni deshace los efectos ocurridos.

Modelos compatibles · por proveedor

Las opciones del catálogo del código y los valores por defecto incluidos, no una lista en la que cada modelo haya superado una llamada real a la API. Las cadenas de fallback configuradas están vacías por defecto, y los ID exactos nunca se actualizan automáticamente a versiones más nuevas.

Anthropic
API
- PrincipalClaude Opus 5.5claude-opus-5-5Por defecto
- SecundarioClaude Sonnet 5claude-sonnet-5Por defecto
- EconómicoClaude Haiku 4.5claude-haiku-4-5-20251001Por defecto
Mostrar los 12 ID del catálogo
API
claude-fable-5-1
claude-opus-5-5por defecto
claude-opus-5
claude-sonnet-5por defecto
claude-haiku-4-5-20251001por defecto
claude-fable-5
claude-opus-4-8
claude-opus-4-7
claude-opus-4-6
claude-opus-4-5
claude-sonnet-4-6
claude-sonnet-4-5-20250929
El código rechaza la vía OAuth por suscripción.
- model_catalog.py#L75–87
OpenAI
API · suscripción a Codex
- Predeterminado de API y CodexGPT-6 Solgpt-6-solPor defecto
Mostrar los 11 ID del catálogo
API · suscripción a Codex
gpt-6-astra
gpt-6-solpor defecto
gpt-6-luna
gpt-5.6-sol
gpt-5.6-terra
gpt-5.6-luna
Solo API
gpt-5.5
gpt-5.3-codex
gpt-5.4
gpt-5.4-mini
gpt-5.4-nano
Dos vías de acceso a un mismo proveedor; el catálogo fija qué vías admite cada modelo.
- model_catalog.py#L88–98
- openai_payg.py#L239–251
Z.ai / GLM
PAYG
- PredeterminadoGLM-5.3glm-5.3Por defecto
Mostrar los 9 ID del catálogo
PAYG
glm-5.3por defecto
glm-5.3-flash
glm-5.3-flashx
glm-5.2
glm-5.1
glm-5
glm-4.7
glm-4.7-flashx
glm-4.7-flash
El código no admite la vía GLM Coding Plan.
- model_catalog.py#L99–107
OpenRouter
Servicio de enrutamiento
- SelectorFree (smoke)openrouter/openrouter/freeEnrutador
- SelectorAuto (variable)openrouter/openrouter/autoEnrutador
Selecciones del enrutador, no un modelo fijo. También se pueden conservar los ID configurados explícitamente.
- _state.py#L47–61
TypeSafe / Jev
Solo decisión · aparte de la generación de texto
- Directojev-1.13.0Solo decisión
- A través de OpenRoutertypesafe/jev-1.13Solo decisión
Un adaptador opcional que solo emite juicios; no es un modelo raíz de generación de texto. El motor de juicio por defecto es llm, y Jev hay que seleccionarlo. Las configuraciones propias del estudio Jev siguen los registros de la vista Jev.

FuenteGEODE main 373d420Commit público del October 7, 2026 · comprobado el October 8, 2026

Experimentos

Modelos y vías tal como se registraron en su momento, no valores por defecto actuales ni una lista completa de compatibilidad.

Informe de benchmark de GEODE
July 31, 2026
- GEODEGPT-5.6 Solgpt-5.6-solSuscripción a OpenAI · high
- 2026-07-31-gpt56-v1011-benchmark.md#L17–24
Terminal-Bench 2.1 · especificación pareada de Harbor 0.22.0
August 27, 2026
- GEODE · native CodexGPT-5.6 Solgpt-5.6-solsuscripción · max
Una especificación congelada; no todos los ensayos previstos dieron un resultado válido.
- run-spec.json#L14–26
- run-spec.json#L39–45
Ejecución archivada de SIL run-2606-broken-tool-use
- Andamiaje objetivoGPT-5.5gpt-5.5openai-codex
- Auditor · juezClaude Opus 4.8claude-opus-4-8PAYG
Un registro de roles separados, no dos valores por defecto intercambiables.
- run-2606-broken-tool-use.md#L9–15

GEODE runtime vocabulary

Antes de cambiar nada, encontró lo que ya existía.

Solicitud → llamada al modelo

Autoridad de la herramienta → efecto → resultado

Registros · recuperación · finalización

Otras rutas de entrada

Modelos compatibles · por proveedor

Anthropic

OpenAI

Z.ai / GLM

OpenRouter

TypeSafe / Jev

Experimentos

Informe de benchmark de GEODE

Terminal-Bench 2.1 · especificación pareada de Harbor 0.22.0

Ejecución archivada de SIL run-2606-broken-tool-use