@christianmaf80/agentic-workflow 1.24.0-beta.3 → 1.25.0-beta.3

package/dist/agent/artifacts/task-20260130-chatkit-mainview/analysis.md

@@ -0,0 +1,156 @@
+---
+artifact: analysis
+phase: phase-2-analysis
+owner: architect-agent
+status: draft
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+---
+
+🏛️ **architect-agent**: Análisis de integración ChatKit avanzada en webview con servidor local y agentes dinámicos.
+
+# Analysis — task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+
+## 1. Resumen ejecutivo
+**Problema**
+- El webview actual no integra ChatKit ni un backend local para agentes dinámicos, y la UI no prueba el flujo real con OpenAI.
+
+**Objetivo**
+- Mostrar ChatKit embebido en `mainView` con botón “Test” que envíe “Hello I am the first agent called Neo”, usando agente dinámico `gpt-5` creado por sesión, API key segura y servidor local en extension host.
+
+**Criterio de éxito**
+- Se cumplen los AC: ChatKit embebido, backend local con `apiURL`, API key en SecretStorage, botón Test produce respuesta real del agente Neo y no hay filtración de secretos.
+
+---
+
+## 2. Estado del proyecto (As-Is)
+- **Estructura relevante**
+  - `src/extension/views/main-view.ts` renderiza HTML base.
+  - `package.json` define `mainView` en Activity Bar.
+- **Componentes existentes**
+  - `MainChatView` registra un `WebviewViewProvider` básico.
+  - No existe servidor local ni integración ChatKit.
+- **Nucleo / capas base**
+  - Extension host controla activación; no hay capa de backend HTTP local.
+- **Artifacts / tareas previas**
+  - Tarea previa corrigió el nonce y el webview ya renderiza HTML.
+- **Limitaciones detectadas**
+  - Webview no puede usar `localhost` directo en entornos remotos sin `asExternalUri`.
+  - API key no puede residir en webview.
+
+---
+
+## 3. Cobertura de Acceptance Criteria
+
+### AC-1
+- **Interpretación**: ChatKit debe renderizarse en el webview con `apiURL` apuntando al servidor local.
+- **Verificación**: UI visible, network calls al servidor local vía `asExternalUri`.
+- **Riesgos / ambigüedades**: configuración CSP y carga de `chatkit.js`.
+
+### AC-2
+- **Interpretación**: API key en SecretStorage y modelo `gpt-5` en creación del agente.
+- **Verificación**: comando para set key, lectura en extension host, creación de agente con modelo correcto.
+- **Riesgos / ambigüedades**: ausencia de key o permisos de SecretStorage.
+
+### AC-3
+- **Interpretación**: botón “Test” dispara mensaje y se ve respuesta real.
+- **Verificación**: click genera request y respuesta visible en UI.
+- **Riesgos / ambigüedades**: rate limits o fallos de red.
+
+### AC-4
+- **Interpretación**: no exponer API key; `mainView` único.
+- **Verificación**: no hay key en webview, `activationEvents` intactos.
+- **Riesgos / ambigüedades**: logging accidental en webview.
+
+### AC-5
+- **Interpretación**: flujo completo funciona en F5.
+- **Verificación**: prueba manual en VS Code.
+- **Riesgos / ambigüedades**: entorno remoto y acceso a servidor local.
+
+---
+
+## 4. Research técnico
+
+- **Alternativa A: asExternalUri + servidor local HTTP (recomendado)**
+  - Descripción: extension host levanta servidor local; webview usa `asExternalUri` para acceder incluso en Remote.
+  - Ventajas: compatibilidad con Remote/Codespaces; flujo standard.
+  - Inconvenientes: manejo de puertos y lifecycle del servidor.
+
+- **Alternativa B: message passing (postMessage) + proxy en extension host**
+  - Descripción: webview no llama a HTTP; usa `postMessage` y extension host ejecuta llamadas.
+  - Ventajas: evita problemas de red; sin servidor HTTP.
+  - Inconvenientes: no encaja bien con ChatKit embed que espera `apiURL` HTTP; más trabajo de adaptación.
+
+**Decisión recomendada (si aplica)**
+- **Usar asExternalUri + servidor local HTTP**, porque ChatKit embed necesita `apiURL` y el backend debe ser accesible como endpoint HTTP.
+
+---
+
+## 5. Agentes participantes
+- **vscode-specialist**
+  - Responsabilidades: integración webview, CSP, carga de ChatKit, UI botón “Test”.
+- **architect-agent**
+  - Responsabilidades: decisiones de arquitectura, seguridad de API key, flujo de agentes dinámicos.
+
+**Handoffs**
+- architect define arquitectura y requisitos; vscode-specialist implementa webview + wiring.
+
+**Componentes necesarios**
+- Crear servidor local HTTP en extension host.
+- Crear comando “Agentic: Set OpenAI Key”.
+- Modificar webview para embed ChatKit + botón Test.
+
+**Demo (si aplica)**
+- Sí: botón “Test” que dispara el mensaje del agente Neo.
+
+---
+
+## 6. Impacto de la tarea
+- **Arquitectura**: se agrega backend local (servidor HTTP) y flujo de agentes dinámicos.
+- **APIs / contratos**: nuevos endpoints internos para ChatKit.
+- **Compatibilidad**: requiere `asExternalUri` para Remote.
+- **Testing / verificación**: prueba manual en F5; validación de secret storage y flujo ChatKit.
+
+---
+
+## 7. Riesgos y mitigaciones
+- **Riesgo 1**: webview no accede a localhost en Remote.
+  - Impacto: chat no carga.
+  - Mitigación: usar `asExternalUri` para exponer el endpoint.
+- **Riesgo 2**: crear agente por sesión aumenta coste/latencia.
+  - Impacto: respuesta lenta y coste alto.
+  - Mitigación: limitar creación por sesión y reciclar mientras la vista esté abierta.
+- **Riesgo 3**: fuga de API key.
+  - Impacto: seguridad comprometida.
+  - Mitigación: SecretStorage + nunca exponer en webview.
+
+---
+
+## 8. Preguntas abiertas
+- Confirmar flujo exacto de creación del agente dinámico con ChatKit advanced en el server local.
+
+---
+
+## 9. TODO Backlog (Consulta obligatoria)
+
+**Referencia**: `.agent/todo/`
+
+**Estado actual**: vacío (directorio no existe)
+
+**Items relevantes para esta tarea**:
+- Ninguno
+
+**Impacto en el análisis**:
+- Sin impacto.
+
+---
+
+## 10. Aprobación
+Este análisis **requiere aprobación explícita del desarrollador**.
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-30T00:00:00Z
+    comments: null
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/architect/review.md

@@ -0,0 +1,141 @@
+---
+artifact: architect-review
+phase: phase-4-implementation
+owner: architect-agent
+status: approved
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+related_plan: .agent/artifacts/task-20260130-chatkit-mainview/plan.md
+---
+
+🏛️ **architect-agent**: Revisión arquitectónica de implementación.
+
+# Architectural Implementation Review — task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## 1. Resumen de la revisión
+- **Objetivo del review**  
+  Verificar que la implementación ejecutada cumple el **plan de implementación aprobado** sin desviaciones no autorizadas.
+
+- **Resultado global**  
+  - Estado: ☑ APROBADO ☐ RECHAZADO
+  - Fecha de revisión: 2026-01-31
+  - Arquitecto responsable: architect-agent
+
+---
+
+## 2. Verificación contra el plan de implementación
+Revisión directa y trazable **plan → implementación**.
+
+### 2.1 Pasos del plan
+Para **cada paso definido en `plan.md`**:
+
+| Paso del plan | Estado | Evidencia | Observaciones |
+|---------------|--------|-----------|---------------|
+| Paso 1 | ☑ OK ☐ NO OK | `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1-neo-agent-deps-chatkit.md`, `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1b-vscode-specialist-review-deps.md` | Dependencia `openai` añadida y revisada por vscode-specialist. |
+| Paso 2 | ☑ OK ☐ NO OK | `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/2-neo-agent-local-server.md` | Servidor ChatKit custom TS + SSE. |
+| Paso 3 | ☑ OK ☐ NO OK | `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/3-neo-agent-webview-ui.md` | Webview ChatKit + botón Test. |
+| Paso 4 | ☑ OK ☐ NO OK | `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/7-qa-agent-unit-tests.md` | Unit tests del protocolo ChatKit. |
+
+> Todos los pasos **DEBEN** estar en estado **OK** para aprobar la fase.
+
+---
+
+## 3. Subtareas por agente
+Revisión de las implementaciones individuales.
+
+### Agente: `vscode-specialist`
+- **Subtask document**:
+  - `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/2-neo-agent-local-server.md`
+  - `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/3-neo-agent-webview-ui.md`
+  - `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/5-vscode-specialist-api-key-ui.md`
+  - `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/6-vscode-specialist-refactor-protocol.md`
+- **Evaluación**:
+  - ☑ Cumple el plan
+  - ☐ Desviaciones detectadas (detallar abajo)
+
+**Notas del arquitecto**
+- Cambios realizados: servidor local ChatKit custom, integración webview, UX API key, refactor a módulo puro.
+- Decisiones técnicas: protocolo ChatKit custom, SSE, `openai` SDK para responses.
+- Coherencia con el resto del sistema: consistente con `constitution.vscode_extensions`.
+
+### Agente: `qa-agent`
+- **Subtask document**:
+  - `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/7-qa-agent-unit-tests.md`
+- **Evaluación**:
+  - ☑ Cumple el plan
+  - ☐ Desviaciones detectadas (detallar abajo)
+
+**Notas del arquitecto**
+- Cambios realizados: unit tests del módulo puro.
+- Decisiones técnicas: `node:test` para mantener tests livianos.
+- Coherencia con el resto del sistema: sin impacto en producción.
+
+### Agente: `neo-agent` (desviación controlada)
+- **Subtask document**:
+  - `.agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/1-neo-agent-deps-chatkit.md`
+- **Evaluación**:
+  - ☑ Cumple el plan
+  - ☑ Desviaciones detectadas (detallar abajo)
+
+**Notas del arquitecto**
+- Cambios realizados: dependencia `openai` añadida.
+- Desviación: tarea ejecutada por neo-agent y revisada/validada por vscode-specialist.
+
+---
+
+## 4. Acceptance Criteria (impacto)
+Verificación de que la implementación **no rompe** los acceptance criteria definidos.
+
+- ☑ Todos los AC siguen siendo válidos
+- ☐ Algún AC requiere revisión (detallar)
+
+**Observaciones**
+- AC afectados: ninguno.
+- Motivo: implementación alineada con AC de ChatKit custom + UI.
+
+---
+
+## 5. Coherencia arquitectónica
+Evaluación global del sistema tras la implementación.
+
+- ☑ Respeta arquitectura del proyecto
+- ☑ Respeta clean code
+- ☑ No introduce deuda técnica significativa
+- ☑ Mantiene compatibilidad esperada (multi-browser si aplica)
+
+**Observaciones arquitectónicas**
+- Impacto en estructura: nuevo módulo puro `chatkit-protocol.ts`.
+- Impacto en componentes: extensión integra servidor local y webview ChatKit.
+- Riesgos introducidos: dependencia de protocolo ChatKit custom sin SDK TS oficial.
+
+---
+
+## 6. Desviaciones del plan
+Registro explícito de desviaciones (si existen).
+
+- **Desviación**
+  - Descripción: Tarea 1 ejecutada por neo-agent, fuera del rol esperado.
+  - Justificación: se detectó y se solicitó revisión del vscode-specialist.
+  - ¿Estaba prevista en el plan? ☐ Sí ☑ No
+  - ¿Requiere replanificación? ☐ Sí ☑ No
+
+---
+
+## 7. Decisión final del arquitecto
+Decisión **severa y binaria**.
+
+```yaml
+decision:
+  architect:
+    result: APROBADO
+    date: 2026-01-31T00:00:00Z
+    comments: "Implementación alineada con el plan; desviación controlada en Tarea 1."
+final_approval:
+  developer:
+    decision: SI
+    date: 2026-01-31T00:00:00Z
+    comments: "Fase 4 aprobada."
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/changelog.md

@@ -0,0 +1,30 @@
+---
+artifact: changelog
+phase: phase-8-commit-push
+owner: architect-agent
+status: draft
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+target_branch: fix/mainview-provider
+---
+
+# Changelog — task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+
+## 1. Resumen general
+Descripción breve y clara de los cambios introducidos por esta tarea.
+
+- **Objetivo de la tarea**: Integrar ChatKit + base Lit + logging para webviews.
+- **Impacto principal**: Setup migrado a Lit con ciclo de vida común y logging AGW; CSP reforzada; tests y artifacts actualizados.
+- **Áreas afectadas** (componentes, workflows, etc.): `src/extension/**`, tests, rules/constitution, artifacts.
+
+---
+
+## 2. Commits incluidos
+Listado completo y ordenado de los commits realizados.
+
+### Commit 1
+- **Hash**: `546444b`
+- **Mensaje (Conventional Commit)**: `feat(vscode-extension): add Lit core base, CSP fixes, logging, and setup view`
+
+### Commit 2
+- **Hash**: `1571d65`
+- **Mensaje (Conventional Commit)**: `chore(agents): update artifacts, metrics, and compile gate`

package/dist/agent/artifacts/task-20260130-chatkit-mainview/metrics.md

@@ -0,0 +1,43 @@
+---
+artifact: task_metrics
+phase: phase-7-evaluation
+owner: architect-agent
+status: pending
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+---
+
+# Task Metrics — task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+
+## Identificacion del agente (OBLIGATORIA)
+🏛️ **architect-agent**: Evaluación de agentes y métricas de la tarea.
+
+## 1. Agentes evaluados
+- vscode-specialist
+- qa-agent
+- neo-agent
+- architect-agent
+
+---
+
+## 2. Puntuacion por agente (0-10)
+- **vscode-specialist**: 9 (dev score: 6)
+  - Justificacion: Implementación extensa, fixes iterativos, integración Lit + CSP + logging resueltas.
+- **qa-agent**: 8 (dev score: 7)
+  - Justificacion: Tests unitarios y cobertura 100% templates; verificación actualizada.
+- **neo-agent**: 7 (dev score: 5)
+  - Justificacion: Participación inicial en deps; tarea revisada posteriormente.
+- **architect-agent**: 8 (dev score: 5)
+  - Justificacion: Coordinación de fases y gates, control de constituciones.
+
+---
+
+## 3. Puntuacion global de la tarea
+- Promedio ponderado: 8.0
+- Observaciones: Resultado estable con Lit piloto y ChatKit operativo.
+
+---
+
+## 4. Validación del Desarrollador
+- Aprobado: SI
+- Puntuación del desarrollador (0-5): 3
+- Comentarios: null

package/dist/agent/artifacts/task-20260130-chatkit-mainview/plan.md

@@ -0,0 +1,151 @@
+---
+artifact: plan
+phase: phase-3-planning
+owner: architect-agent
+status: draft
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+---
+
+🏛️ **architect-agent**: Plan de implementación para integrar ChatKit avanzado en webview con backend local.
+
+# Implementation Plan — task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+
+## 1. Resumen del plan
+- **Contexto**: Se requiere integrar ChatKit (advanced) en `mainView` con agente dinámico Neo, API key segura y backend local.
+- **Resultado esperado**: Webview con ChatKit embebido + botón “Test”, servidor local en extension host que crea agente `gpt-5` por sesión y entrega `client_secret`.
+- **Alcance**: Solo rol Neo, sesión por vista; no se persiste `agent_id`. Excluye multi‑agentes y UI avanzada.
+
+---
+
+## 2. Inputs contractuales
+- **Task**: `.agent/artifacts/task-20260130-chatkit-mainview/task.md`
+- **Analysis**: `.agent/artifacts/task-20260130-chatkit-mainview/analysis.md`
+- **Acceptance Criteria**: AC-1..AC-5 en `acceptance.md`.
+
+**Dispatch de dominios (OBLIGATORIO si aplica)**
+```yaml
+plan:
+  workflows:
+    - domain: vscode-extension
+      action: refactor
+      workflow: extension.chatkit.advanced
+
+  dispatch:
+    - domain: core
+      action: create
+      workflow: extension.local-server
+```
+
+---
+
+## 3. Desglose de implementación (pasos)
+
+### Paso 1 — Dependencias y configuración
+- **Descripción**: Añadir dependencias necesarias de ChatKit/SDK y wiring básico.
+- **Dependencias**: npm deps oficiales de OpenAI/ChatKit.
+- **Entregables**: package.json actualizado y build OK.
+- **Agente responsable**: vscode-specialist.
+
+### Paso 2 — Servidor local ChatKit (extension host)
+- **Descripción**: Crear servidor HTTP local con endpoints ChatKit para crear sesión y agente Neo dinámico.
+- **Dependencias**: OpenAI SDK/Agents SDK; SecretStorage para API key.
+- **Entregables**: módulo servidor, comando “Agentic: Set OpenAI Key”.
+- **Agente responsable**: vscode-specialist.
+
+### Paso 3 — Webview embed + botón Test
+- **Descripción**: Renderizar ChatKit en `mainView`, configurar CSP/`asExternalUri`, botón Test que envía el mensaje.
+- **Dependencias**: servidor local disponible; `apiURL` resuelto.
+- **Entregables**: UI funcional en F5.
+- **Agente responsable**: vscode-specialist.
+
+### Paso 4 — Verificación y demo
+- **Descripción**: Validación manual end‑to‑end, con API key real.
+- **Dependencias**: API key configurada en SecretStorage.
+- **Entregables**: evidencia de “Hello I am the first agent called Neo”.
+- **Agente responsable**: QA (si aplica) + developer.
+
+---
+
+## 4. Asignación de responsabilidades (Agentes)
+- **Architect-Agent**
+  - Arquitectura, seguridad y gates.
+- **vscode-specialist**
+  - Implementación webview + backend local.
+- **QA / Verification-Agent**
+  - Verificación manual (si se asigna).
+
+**Handoffs**
+- Architect → vscode-specialist: diseño técnico + CSP/`asExternalUri` + SecretStorage.
+- vscode-specialist → Architect: implementación y comandos registrados.
+
+**Componentes (si aplica)**
+- Servidor local ChatKit (nuevo) en extension host.
+
+**Demo (si aplica)**
+- Botón “Test” dispara mensaje y respuesta en UI.
+
+---
+
+## 5. Estrategia de testing y validación
+- **Unit tests**: No previstos (integración UI + red).
+- **Integration tests**: `npm run compile`.
+- **E2E / Manual**: F5 + set API key + abrir view + botón Test.
+
+**Trazabilidad**
+- AC-1/3/5: validación manual de UI.
+- AC-2/4: verificación de SecretStorage y sin key en webview.
+
+---
+
+## 6. Plan de demo (si aplica)
+- **Objetivo de la demo**: Probar conversación real con el agente Neo.
+- **Escenario(s)**: Abrir `mainView`, click “Test”.
+- **Datos de ejemplo**: “Hello I am the first agent called Neo”.
+- **Criterios de éxito de la demo**: respuesta visible en el chat.
+
+---
+
+## 7. Estimaciones y pesos de implementación
+- Paso 1: bajo
+- Paso 2: alto
+- Paso 3: medio
+- Paso 4: medio
+
+---
+
+## 8. Puntos críticos y resolución
+- **Punto crítico 1**: `asExternalUri` para acceso al servidor local.
+  - Riesgo: sin acceso en Remote.
+  - Resolución: uso obligatorio de `asExternalUri`.
+- **Punto crítico 2**: ChatKit advanced requiere endpoints específicos.
+  - Riesgo: incompatibilidad si falta endpoint.
+  - Resolución: seguir contrato oficial de ChatKit advanced.
+
+---
+
+## 9. Dependencias y compatibilidad
+- **Dependencias internas**: `mainView`, activación, SecretStorage.
+- **Dependencias externas**: OpenAI ChatKit/Agents SDK.
+- **Compatibilidad entre navegadores**: N/A (Electron Webview).
+- **Restricciones arquitectónicas**: API key nunca en webview.
+
+---
+
+## 10. Criterios de finalización
+- UI ChatKit embebida con botón Test.
+- Agente Neo dinámico (gpt-5) por sesión.
+- API key en SecretStorage.
+- Demo validada en F5.
+
+---
+
+## 11. Aprobación del desarrollador (OBLIGATORIA)
+Este plan **requiere aprobación explícita y binaria**.
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-30T00:00:00Z
+    comments: null
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/research.md

@@ -0,0 +1,115 @@
+---
+artifact: research
+phase: phase-1-research
+owner: researcher-agent
+status: draft
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+---
+
+🔍 **researcher-agent**: Investigación de ChatKit avanzado, requisitos de servidor y consideraciones de webview/secretos en VS Code.
+
+# Research Report — task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+
+## 1. Resumen ejecutivo
+- Problema investigado: Integración de ChatKit en un webview de VS Code con backend local y agentes dinámicos.
+- Objetivo de la investigacion: Identificar requisitos de ChatKit avanzado, endpoints, seguridad y límites de webview para comunicación local.
+- Principales hallazgos: ChatKit avanzado requiere servidor propio y `apiURL`; webviews no pueden usar localhost directo en entornos remotos; SecretStorage es la vía recomendada para secretos.
+
+---
+
+## 2. Necesidades detectadas
+- Requisitos tecnicos identificados por el architect-agent
+  - Backend ChatKit propio (advanced) con endpoint `apiURL`.
+  - API key fuera del webview; uso de SecretStorage en el extension host.
+  - ChatKit embed en webview requiere cargar `chatkit.js` desde CDN y usar bindings JS/React.
+  - Para local server en webview: usar `asExternalUri` o message passing para entornos remotos.
+- Suposiciones y limites
+  - Se usará integración avanzada para agentes dinámicos.
+  - El servidor será local en el extension host (Node).
+
+---
+
+## 3. Hallazgos técnicos
+
+### ChatKit: integración avanzada (servidor propio)
+- Descripción: ChatKit avanzado permite usar infraestructura propia y un servidor ChatKit que procesa requests y emite eventos/stream.
+- Estado actual: activo.
+- Documentación oficial: guía de integración avanzada. citeturn0search3
+- Limitaciones conocidas: requiere implementar servidor y un `apiURL` para el cliente; el cliente embebe widget y se comunica con el servidor. citeturn0search3
+
+### ChatKit: integración recomendada (workflow fijo)
+- Descripción: ChatKit puede apuntar a un workflow de Agent Builder; requiere generar sesión y devolver `client_secret` desde un backend.
+- Estado actual: activo.
+-- Documentación oficial: guía principal de ChatKit. citeturn0search5
+-- Limitaciones conocidas: depende de workflow fijo; menos control para agentes dinámicos. citeturn0search5
+
+### ChatKit frontend (script + bindings)
+- Descripción: Para embebido, se carga `chatkit.js` desde CDN y se usan bindings (p. ej. `@openai/chatkit-react`) para montar el widget.
+- Estado actual: activo.
+-- Documentación oficial: guía ChatKit. citeturn0search5
+-- Limitaciones conocidas: requiere backend que entregue `client_secret` y configure `apiURL`. citeturn0search5
+
+### Agents SDK
+- Descripción: SDK para construir agentes con OpenAI (JS/Python), útil para crear agentes dinámicos en backend propio.
+- Estado actual: activo.
+-- Documentación oficial: guía Agents SDK. citeturn0search1
+-- Limitaciones conocidas: documentación principal remite a repositorios SDK. citeturn0search1
+
+### VS Code webviews y acceso a servidores locales
+- Descripción: En entornos remotos, el `localhost` del webview no apunta al extension host; se recomienda message passing o `asExternalUri`.
+- Estado actual: activo.
+-- Documentación oficial: Remote Extensions (`asExternalUri`, port mapping). citeturn0search2
+-- Limitaciones conocidas: webview no accede a localhost remoto sin `asExternalUri` o `portMapping`. citeturn0search2
+
+### VS Code SecretStorage
+- Descripción: `ExtensionContext.secrets` provee almacenamiento seguro cifrado para claves; recomendado por VS Code.
+- Estado actual: activo.
+-- Documentación oficial: Common Capabilities. citeturn0search6
+-- Limitaciones conocidas: secretos no se sincronizan entre máquinas. citeturn0search6
+
+---
+
+## 4. APIs relevantes
+- ChatKit `apiURL` (endpoint del servidor ChatKit propio). Estado: requerido en integración avanzada. citeturn0search3
+- `vscode.env.asExternalUri` para enrutar requests desde webviews a servidores locales remotos. Estado: soportado. citeturn0search2
+- `ExtensionContext.secrets` (SecretStorage). Estado: soportado. citeturn0search6
+
+---
+
+## 5. Compatibilidad multi-browser
+- Tabla de compatibilidad: Webviews corren en el motor de VS Code/Electron; no aplica compatibilidad multi‑browser clásica.
+-- Diferencias clave: en VS Code Web/Remote, webview no puede usar localhost sin `asExternalUri` o `portMapping`. citeturn0search2
+-- Estrategias de mitigacion: uso de `asExternalUri` o message passing. citeturn0search2
+
+---
+
+## 6. Oportunidades AI-first detectadas
+-- Uso de Agents SDK para crear agentes dinámicos en backend propio. citeturn0search1
+-- ChatKit advanced permite widgets y acciones para flujos guiados. citeturn0search3
+
+---
+
+## 7. Riesgos identificados
+-- Riesgo: webview no puede acceder a localhost remoto sin mecanismos especiales. Severidad: alta. Fuente: Remote Extensions doc. citeturn0search2
+-- Riesgo: secretos en cliente; debe evitarse. Severidad: alta. Fuente: SecretStorage doc. citeturn0search6
+-- Riesgo: integración avanzada requiere servidor propio y store; esfuerzo extra. Severidad: media. Fuente: ChatKit advanced guide. citeturn0search3
+
+---
+
+## 8. Fuentes
+-- OpenAI ChatKit (guía principal): https://platform.openai.com/docs/guides/chatkit citeturn0search5
+-- OpenAI ChatKit Advanced (custom): https://platform.openai.com/docs/guides/custom-chatkit citeturn0search3
+-- OpenAI Agents SDK: https://platform.openai.com/docs/guides/agents-sdk citeturn0search1
+-- VS Code Remote Extensions (asExternalUri/port mapping): https://code.visualstudio.com/api/advanced-topics/remote-extensions citeturn0search2
+-- VS Code SecretStorage: https://code.visualstudio.com/api/extension-capabilities/common-capabilities citeturn0search6
+
+---
+
+## 9. Aprobacion del desarrollador (OBLIGATORIA)
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-30T00:00:00Z
+    comments: null
+```