Cline SDK

¿Qué es Cline SDK?

Cline SDK (@cline/sdk) es una base de runtime de agentes en TypeScript extraída de Cline, diseñada para impulsar flujos de coding por agentes en múltiples superficies (incluidos IDEs y CLI). Su propósito principal es proporcionar un “harness de agentes” modular y reutilizable, junto con una arquitectura que permita a los equipos crear y extender agentes sin depender del ciclo de vida de la interfaz de una sola aplicación.

En lugar de mantener el bucle del agente acoplado a una extensión de VS Code, el rediseño de Cline trata el runtime como un servicio compartido. Esto permite que el trabajo de larga duración continúe independientemente de los reinicios de la interfaz y admite mover sesiones entre superficies manteniendo el bucle de bajo nivel reutilizable y sin estado.

Características principales

• Arquitectura de runtime de agentes compartida: Separa el runtime de una implementación específica de IDE para que el trabajo dependa menos de los reinicios de la interfaz.
• Harness de agentes reutilizable (bucle sin estado): Mantiene el bucle de bajo nivel sin estado y reutilizable, mientras que el runtime que lo rodea puede ser duradero y portátil.
• Pila TypeScript por capas: Utiliza un diseño por capas donde cada capa tiene una única responsabilidad; puedes elegir la pila completa o paquetes individuales según tus necesidades.
• Sistema de plugins en la capa de runtime: Los plugins pueden registrar herramientas, observar eventos del ciclo de vida, añadir reglas/comandos y definir lo que ve el modelo.
• Carga y empaquetado flexible de plugins: Los plugins pueden cargarse desde rutas configuradas o ubicaciones del workspace y pueden comenzar como módulos locales .ts/.js antes de evolucionar a módulos empaquetados mediante un manifiesto cline.plugins.
• Soporte de LLM en la capa de proveedores (elección abierta): La capa de proveedores admite múltiples proveedores y endpoints compatibles con OpenAI; el cambio de proveedores se realiza mediante configuración.

Cómo usar Cline SDK

1. Instalar el SDK: Instala la pila completa con npm i -g @cline/sdk.
2. Seleccionar la superficie: Usa Cline SDK para impulsar agentes en VS Code, JetBrains y CLI (las propias superficies de Cline están construidas sobre el SDK).
3. Extender el comportamiento con plugins de runtime: Crea un módulo de plugin (o empaquétalo) que pueda registrar herramientas y reaccionar a eventos del ciclo de vida.
4. Configurar el acceso al modelo/proveedor: Usa la capa de proveedores para seleccionar qué modelo/proveedor debe llamar el agente mediante configuración.

Casos de uso

• Trabajo de agentes de larga duración entre reinicios: Ejecuta tareas de agentes sin que se interrumpan al reiniciar una interfaz, ya que el runtime está diseñado para ser duradero y no depender únicamente del ciclo de vida de una sola interfaz.
• Construir agentes que persisten en múltiples superficies: Mueve sesiones entre diferentes interfaces (por ejemplo, IDE y CLI) manteniendo el bucle del agente sin estado y reutilizable.
• Personalización de agentes específica del equipo mediante plugins: Añade comportamiento específico del dominio —como herramientas, reglas o comandos adicionales— cargando plugins sin bifurcar el runtime.
• Prototipar localmente y empaquetar después: Comienza con un plugin implementado como módulo local .ts/.js, luego empaquétalo en un directorio reutilizable cuando el equipo consolide la funcionalidad con un manifiesto cline.plugins.
• Runtimes de agentes serverless o componibles: Usa partes más pequeñas de la pila por capas (por ejemplo, la lógica de proveedores o el bucle sin estado) cuando quieras integrar el comportamiento del agente en otro modelo de runtime.

Preguntas frecuentes

• ¿Cline SDK está vinculado únicamente a la extensión de VS Code? No. El SDK está diseñado para impulsar Cline en VS Code, JetBrains y CLI, y permite que los equipos construyan sobre el runtime en lugar de reutilizar solo una implementación específica de IDE.

• ¿Qué significa “sin estado” en el bucle del agente? El rediseño mantiene el bucle de bajo nivel sin estado y reutilizable, mientras que el runtime que lo rodea proporciona durabilidad y portabilidad.

• ¿Cómo afectan los plugins al comportamiento del modelo? Los plugins pueden registrar herramientas, observar eventos del ciclo de vida y definir lo que ve el agente (incluidas reglas y comandos) antes o durante la ejecución.

• ¿Puedo cambiar de proveedor de LLM sin reescribir el agente? La capa de proveedores se describe como impulsada por configuración, con soporte para múltiples proveedores y endpoints compatibles con OpenAI.

• ¿Necesito la pila completa del SDK para empezar? El SDK se describe como por capas: puedes instalar la pila completa o usar paquetes individuales (como la capa de proveedores o el bucle sin estado) para superficies más pequeñas.

Alternativas

• Usar un framework de agentes existente con un runtime personalizado: Si necesitas control total sobre la persistencia de sesiones y la orquestación de herramientas, los enfoques basados en frameworks de agentes existentes pueden ser más adecuados cuando ya mantienes tu propio runtime.
• Construir sobre un modelo de extensión de agentes específico para IDE: Algunas soluciones mantienen el bucle del agente dentro de un plugin de IDE; estas pueden ser más simples de iniciar, pero pueden mantener el comportamiento del runtime más acoplado al ciclo de vida de la interfaz de usuario.
• Usar una capa general de orquestación de herramientas LLM: En lugar de una arquitectura de harness de agentes + runtime, un enfoque de orquestación de herramientas se centra en llamar a modelos y herramientas, dejando normalmente la persistencia de sesiones y la gestión del ciclo de vida al código de tu aplicación.