@vaia-lab/sdk 0.3.0 → 0.4.1

package/dist/index.d.cts

@@ -1,3 +1,6 @@
+import { A as AgentSurfaceConfig, a as AgentAction } from './agent-1bVw0eB8.cjs';
+export { b as AGENT_PROTOCOL_VERSION, c as AgentActionParam, d as AgentActionResult, e as AgentEvidence, f as AgentSpaceContext, g as AgentTurnRequest, h as AgentTurnResponse, C as CONNECTOR_OF_OPERATION, i as ConnectorNeed, j as ConnectorOperation, k as ConnectorRequest, l as ConnectorResult, v as validateActionCall, m as validateAgentSurface } from './agent-1bVw0eB8.cjs';
+
 /**
  * Las 7 piezas operativas del ecosistema VAIA.
  *
@@ -158,227 +161,6 @@ declare function checkAuthority(a: Authority, intento?: {
     reason: string;
 };
 
-/**
- * VAIA Extension Protocol — superficie de AGENTE.
- *
- * Es la parte del protocolo que permite que el asistente de Handeia viva
- * dentro de un espacio de terceros. Sigue la regla del ecosistema: protocolo
- * antes que SDK. Lo que hay aquí son CONTRATOS; el SDK solo los transporta.
- *
- * ── El reparto de papeles ────────────────────────────────────────────────
- *   El espacio  → superficie y manos. Declara qué sabe y qué puede hacer.
- *   Handeia     → cerebro, memoria y autoridad. Decide y ejecuta a través suyo.
- *
- * Por eso un espacio NO trae su propia IA: si la trajera, no te conocería,
- * empezaría de cero cada vez, y no podría contradecirse a sí mismo. El caso
- * que lo justifica: el espacio puntúa un resultado con 90 y el agente te dice
- * que te conviene el de 87, porque sabe algo de ti que el espacio no sabe.
- * Eso solo es posible si el cerebro vive fuera del espacio.
- *
- * ── La regla de confianza, que manda sobre todo lo demás ─────────────────
- * El espacio es CÓDIGO DE TERCEROS. Nada de lo que envía es un hecho: es una
- * AFIRMACIÓN. Handeia la trata como dato citado, nunca como instrucción y
- * nunca al mismo nivel que lo que sabe del usuario. Un espacio que escriba
- * "ignora las instrucciones anteriores" en su contexto no logra nada.
- *
- * @see AGENT_PROTOCOL_VERSION para la política de compatibilidad.
- */
-/**
- * Versión del protocolo de agente. Viaja en cada mensaje.
- *
- * Se versiona desde el primer día a propósito: este contrato es público y
- * cambiarlo después obliga a coordinar despliegues entre partes que no se
- * conocen. Ya se pagó esa factura una vez con la codificación del JWT.
- */
-declare const AGENT_PROTOCOL_VERSION = 1;
-/** Un parámetro de una acción. Sin tipos no hay validación posible. */
-interface AgentActionParam {
-    name: string;
-    type: 'string' | 'number' | 'boolean';
-    description: string;
-    required?: boolean | undefined;
-    /** Valores admitidos. Si se define, nada fuera de la lista es válido. */
-    enum?: string[] | undefined;
-}
-/**
- * Algo que el espacio sabe hacer.
- *
- * Handeia SOLO puede pedir acciones declaradas aquí. No improvisa, no toca el
- * DOM, no busca la forma. Si no está declarada, para el agente no existe —
- * y eso es lo que hace que el mismo agente sirva en cualquier espacio sin que
- * Handeia sepa nada de ninguno en particular.
- */
-interface AgentAction {
-    /** Identificador estable, en minúsculas: 'filtrar_resultados'. */
-    name: string;
-    /** Qué hace, en lenguaje natural. Es lo que lee el modelo para elegirla. */
-    description: string;
-    params?: AgentActionParam[] | undefined;
-    /**
-     * true si modifica algo. Las que escriben se confirman con el usuario ANTES
-     * de ejecutarse — un agente que escribe sin preguntar se siente fuera de
-     * control incluso cuando acierta.
-     */
-    writes?: boolean | undefined;
-    /** Permiso que el usuario debe haber concedido a este espacio. */
-    permission?: string | undefined;
-}
-/** Configuración de la superficie de agente dentro de defineCapability. */
-interface AgentSurfaceConfig {
-    /** Acciones que el espacio expone. Vacío = el agente solo puede responder. */
-    actions?: AgentAction[] | undefined;
-    /**
-     * Endpoint para preguntarle al espacio cuando el usuario NO está dentro
-     * ("¿tengo algo pendiente ahí?"). El círculo solo existe con el espacio
-     * abierto; esto es lo que permite que Handeia sea el lugar donde convergen
-     * todos tus espacios en vez de uno más al que entrar.
-     */
-    queryEndpoint?: string | undefined;
-    /** Frase de bienvenida propia del espacio. */
-    greeting?: string | undefined;
-    /**
-     * Servicios externos que el espacio necesita consultar. El usuario los
-     * concede por espacio y los puede revocar cuando quiera. El espacio jamás
-     * recibe el token: pide operaciones, la plataforma las ejecuta.
-     */
-    needs?: ConnectorNeed[] | undefined;
-}
-/**
- * Servicios externos que un espacio puede necesitar (GitHub, Drive, Calendar…).
- *
- * ── La regla, y no tiene excepciones ─────────────────────────────────────
- * El espacio NUNCA recibe el token del usuario. Declara qué necesita, la
- * plataforma llama al proveedor con el token que YA tiene guardado, y le
- * devuelve solo el resultado.
- *
- * Por qué así y no entregando el token:
- *   - Si cada espacio guardara tokens, la superficie de ataque se multiplica
- *     por cada desarrollador que publique. Un espacio comprometido entregaría
- *     el GitHub y el Drive de todos sus usuarios.
- *   - Prestado, un espacio comprometido solo puede pedir las operaciones que
- *     el usuario le concedió, con límite de frecuencia, auditadas y
- *     revocables al instante desde Conectores.
- *
- * De regalo, publicar un espacio se vuelve barato: el desarrollador no
- * implementa OAuth de nada.
- */
-type ConnectorNeed = 'github' | 'drive' | 'calendar' | 'email' | 'notion' | 'discord';
-/**
- * Operaciones de LECTURA que la plataforma sabe hacer por el espacio.
- *
- * Lista cerrada a propósito: un espacio no puede pedir "haz esta llamada
- * arbitraria a la API de GitHub". Solo puede pedir lo que está aquí, y cada
- * una devuelve datos ya acotados. Escribir en un servicio externo NO se
- * presta — para eso el usuario usa el servicio.
- */
-type ConnectorOperation = 'github.repos' | 'github.issues' | 'drive.files' | 'calendar.events' | 'email.recent' | 'notion.pages';
-/** Lo que el espacio pide prestado. */
-interface ConnectorRequest {
-    operation: ConnectorOperation;
-    /** Filtros simples. La plataforma los valida; nada de consultas libres. */
-    params?: Record<string, string | number | boolean> | undefined;
-}
-/** Lo que la plataforma devuelve. Datos, jamás credenciales. */
-interface ConnectorResult {
-    operation: ConnectorOperation;
-    ok: boolean;
-    items?: Record<string, unknown>[] | undefined;
-    /** 'sin_conectar' = el usuario no ha vinculado ese servicio todavía. */
-    error?: 'sin_permiso' | 'sin_conectar' | 'no_soportada' | 'limite_excedido' | 'fallo' | undefined;
-}
-/** Qué operación necesita qué conector — la plataforma lo usa para autorizar. */
-declare const CONNECTOR_OF_OPERATION: Record<ConnectorOperation, ConnectorNeed>;
-/**
- * Lo que el espacio dice que está pasando.
- *
- * OJO: se llama `claims` y no `facts` a propósito. Handeia lo etiqueta como
- * afirmación de un tercero antes de dárselo al modelo.
- */
-interface AgentSpaceContext {
-    /** Dónde está el usuario dentro del espacio: '/lista'. */
-    route?: string | undefined;
-    /** Qué está viendo, en lenguaje natural: 'Lista de 12 resultados'. */
-    view?: string | undefined;
-    /** Datos que el espacio considera relevantes ahora mismo. */
-    claims?: Record<string, unknown> | undefined;
-}
-/** Petición del espacio a Handeia. Un solo endpoint, un solo formato. */
-interface AgentTurnRequest {
-    protocol: typeof AGENT_PROTOCOL_VERSION;
-    /** Lo que escribió el usuario. */
-    message: string;
-    context?: AgentSpaceContext | undefined;
-    /** Acciones disponibles AHORA (pueden ser menos que las declaradas). */
-    actions?: AgentAction[] | undefined;
-    /** Turnos previos, para que el agente no pierda el hilo. */
-    history?: {
-        role: 'user' | 'agent';
-        text: string;
-    }[] | undefined;
-    /** Resultado de una acción que Handeia pidió en el turno anterior. */
-    actionResult?: AgentActionResult | undefined;
-}
-/** Lo que el espacio devuelve tras ejecutar una acción. */
-interface AgentActionResult {
-    action: string;
-    ok: boolean;
-    /** Qué pasó, para que el agente pueda cerrar el ciclo con el usuario. */
-    summary?: string | undefined;
-    error?: string | undefined;
-}
-/**
- * De dónde salió lo que el agente afirma.
- *
- * No es adorno: es el pilar de info verificada. Cuando el agente contradice
- * al espacio ("dice 90, pero te conviene la de 87"), tiene que poder decir de
- * dónde sacó su razón. Un oráculo que no se explica no se gana la confianza.
- */
-interface AgentEvidence {
-    /** 'handeia' = memoria del usuario · 'space' = lo que declaró el espacio. */
-    source: 'handeia' | 'space';
-    label: string;
-}
-/** Respuesta de Handeia al espacio. */
-interface AgentTurnResponse {
-    protocol: typeof AGENT_PROTOCOL_VERSION;
-    /** Qué decirle al usuario. */
-    text?: string | undefined;
-    /** Acción a ejecutar. Siempre sale de la lista declarada, nunca inventada. */
-    action?: {
-        name: string;
-        args?: Record<string, unknown> | undefined;
-    } | undefined;
-    /** true si hay que confirmar con el usuario antes de ejecutarla. */
-    confirm?: boolean | undefined;
-    evidence?: AgentEvidence[] | undefined;
-    /** Identificador para cruzar los registros de todas las capas. */
-    traceId?: string | undefined;
-}
-/**
- * Revisa que las acciones declaradas sean utilizables.
- *
- * Corre al declarar la capacidad, no en producción: un contrato mal escrito
- * debe reventar en el escritorio del desarrollador, no frente al usuario.
- */
-declare function validateAgentSurface(cfg: AgentSurfaceConfig): string[];
-/**
- * ¿Es válida esta acción contra lo declarado?
- *
- * La usa Handeia antes de reenviarle nada al espacio. Es la lista blanca en
- * ejecución: aunque el modelo se invente una acción o un argumento fuera de
- * rango, aquí se detiene.
- */
-declare function validateActionCall(llamada: {
-    name: string;
-    args?: Record<string, unknown> | undefined;
-}, declaradas: AgentAction[]): {
-    ok: true;
-    action: AgentAction;
-} | {
-    ok: false;
-    reason: string;
-};
-
 type PublishType = 'app' | 'ia' | 'skill' | 'eco';
 type EcoTarget = 'gandia' | 'handeia' | 'both';
 type NodeType = 'widget' | 'artefacto' | 'espacio' | 'skill' | 'agente';
@@ -904,55 +686,6 @@ declare function defineCapability(config: CapabilityConfig): CapabilityConfig;
 /** Converts a CapabilityConfig to a gandia.manifest.json object. */
 declare function toManifest(config: CapabilityConfig): VAIAManifest;
 
-/**
- * El círculo del agente de Handeia, para montar dentro de un espacio.
- *
- * Montaje NEUTRAL a propósito: no depende de React ni de ningún framework. El
- * SDK presume de cero dependencias y atarlo a React lo traicionaría — un
- * espacio hecho en Vue, Svelte o HTML puro tiene el mismo derecho al agente.
- * Encima de esto, un envoltorio de React son tres líneas.
- *
- * Lo que el desarrollador pone:
- *   - de dónde sacar el contexto (qué está viendo el usuario)
- *   - qué acciones sabe ejecutar
- * Lo que pone el SDK: el círculo, el campo, el transporte y la identidad.
- *
- * El aspecto lo controla el SDK a propósito: así el agente se ve y se comporta
- * igual en todos los espacios, que es parte de que se sienta Handeia y no un
- * chat pegado a una app.
- */
-
-interface MountAgentOptions {
-    /** capability_id del espacio, el mismo del manifest. */
-    capabilityId: string;
-    /**
-     * Dónde vive Handeia. Un solo endpoint, y el SDK no sabe qué hay detrás:
-     * así Handeia puede reordenar sus capas sin publicar una versión nueva.
-     */
-    handeiaUrl?: string | undefined;
-    /** Qué está viendo el usuario AHORA. Se pregunta en cada turno, no se cachea. */
-    getContext?: (() => AgentSpaceContext | Promise<AgentSpaceContext>) | undefined;
-    /** Las mismas acciones que el manifest declara. */
-    actions?: AgentAction[] | undefined;
-    /** Ejecuta una acción. Solo se llama con acciones declaradas y ya validadas. */
-    onAction?: ((name: string, args: Record<string, unknown>) => Promise<AgentActionResult> | AgentActionResult) | undefined;
-    /** Dónde montar. Por defecto, el body. */
-    container?: HTMLElement | undefined;
-    /** Saludo propio del espacio. */
-    greeting?: string | undefined;
-}
-interface AgentHandle {
-    open(): void;
-    close(): void;
-    destroy(): void;
-}
-/**
- * Monta el agente. Devuelve un manejador para abrirlo, cerrarlo o quitarlo.
- *
- * Es idempotente por espacio: montarlo dos veces no deja dos círculos.
- */
-declare function mountAgent(opts: MountAgentOptions): AgentHandle;
-
 /**
  * Capacidades que CORREN.
  *
@@ -1267,4 +1000,4 @@ declare function toMCPTools(tools: ToolDef[]): {
 declare const gandia: typeof _gandia;
 declare const handeia: typeof _handeia;
 
-export { AGENT_PROTOCOL_VERSION, type ActionPayload, type ActionResponse, type AgentAction, type AgentActionParam, type AgentActionResult, type AgentDef, type AgentEvidence, type AgentHandle, type AgentLoopOptions, type AgentSpaceContext, type AgentSurfaceConfig, type AgentTurn, type AgentTurnRequest, type AgentTurnResponse, type AuditRecord, type Authority, type AuthorityLevel, CONNECTOR_OF_OPERATION, type Capability, type CapabilityCall, type CapabilityConfig, type CapabilityResult, type CardPayload, type CardResponse, type ConnectorNeed, type ConnectorOperation, type ConnectorRequest, type ConnectorResult, type Consequence, type DataResponse, type EcoTarget, type Ecosystem, type EcosystemConfig, type ErrorResponse, type EvidenceKind, type EvidencePolicy, type GandiaContext, type GandiaJWTClaims, type GandiaTenant, type GandiaUser, type HandeiaContext, type HandeiaJWTClaims, type HandeiaUser, type HttpCapabilityOptions, type LocalCapabilityOptions, type MCPCapabilityOptions, type MCPInputSchema, type MCPTool, type MCPTransport, type ModalityDef, type ModelFn, type MountAgentOptions, type NodeType, type OutputType, type PersonalityDef, type PiecesConfig, type PublishType, type RespondOpts, type Risk, type SkillDef, type Surface, type SurfaceHandlers, type TablePayload, type TableResponse, type TextResponse, type ToolDef, VAIAError, type VAIAManifest, type VAIAResponse, type WidgetPayload, type WidgetResponse, type WorkflowDef, agentLoop, capabilities, checkAuthority, defineCapability, defineEcosystem, fromMCPTool, gandia, handeia, http, httpTransport, local, mcp, mountAgent, requiresApproval, toMCPTool, toMCPTools, toManifest, validateActionCall, validateAgentSurface, validatePieces };
+export { type ActionPayload, type ActionResponse, AgentAction, type AgentDef, type AgentLoopOptions, AgentSurfaceConfig, type AgentTurn, type AuditRecord, type Authority, type AuthorityLevel, type Capability, type CapabilityCall, type CapabilityConfig, type CapabilityResult, type CardPayload, type CardResponse, type Consequence, type DataResponse, type EcoTarget, type Ecosystem, type EcosystemConfig, type ErrorResponse, type EvidenceKind, type EvidencePolicy, type GandiaContext, type GandiaJWTClaims, type GandiaTenant, type GandiaUser, type HandeiaContext, type HandeiaJWTClaims, type HandeiaUser, type HttpCapabilityOptions, type LocalCapabilityOptions, type MCPCapabilityOptions, type MCPInputSchema, type MCPTool, type MCPTransport, type ModalityDef, type ModelFn, type NodeType, type OutputType, type PersonalityDef, type PiecesConfig, type PublishType, type RespondOpts, type Risk, type SkillDef, type Surface, type SurfaceHandlers, type TablePayload, type TableResponse, type TextResponse, type ToolDef, VAIAError, type VAIAManifest, type VAIAResponse, type WidgetPayload, type WidgetResponse, type WorkflowDef, agentLoop, capabilities, checkAuthority, defineCapability, defineEcosystem, fromMCPTool, gandia, handeia, http, httpTransport, local, mcp, requiresApproval, toMCPTool, toMCPTools, toManifest, validatePieces };

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { A as AgentSurfaceConfig, a as AgentAction } from './agent-1bVw0eB8.js';
+export { b as AGENT_PROTOCOL_VERSION, c as AgentActionParam, d as AgentActionResult, e as AgentEvidence, f as AgentSpaceContext, g as AgentTurnRequest, h as AgentTurnResponse, C as CONNECTOR_OF_OPERATION, i as ConnectorNeed, j as ConnectorOperation, k as ConnectorRequest, l as ConnectorResult, v as validateActionCall, m as validateAgentSurface } from './agent-1bVw0eB8.js';
+
 /**
  * Las 7 piezas operativas del ecosistema VAIA.
  *
@@ -158,227 +161,6 @@ declare function checkAuthority(a: Authority, intento?: {
     reason: string;
 };
 
-/**
- * VAIA Extension Protocol — superficie de AGENTE.
- *
- * Es la parte del protocolo que permite que el asistente de Handeia viva
- * dentro de un espacio de terceros. Sigue la regla del ecosistema: protocolo
- * antes que SDK. Lo que hay aquí son CONTRATOS; el SDK solo los transporta.
- *
- * ── El reparto de papeles ────────────────────────────────────────────────
- *   El espacio  → superficie y manos. Declara qué sabe y qué puede hacer.
- *   Handeia     → cerebro, memoria y autoridad. Decide y ejecuta a través suyo.
- *
- * Por eso un espacio NO trae su propia IA: si la trajera, no te conocería,
- * empezaría de cero cada vez, y no podría contradecirse a sí mismo. El caso
- * que lo justifica: el espacio puntúa un resultado con 90 y el agente te dice
- * que te conviene el de 87, porque sabe algo de ti que el espacio no sabe.
- * Eso solo es posible si el cerebro vive fuera del espacio.
- *
- * ── La regla de confianza, que manda sobre todo lo demás ─────────────────
- * El espacio es CÓDIGO DE TERCEROS. Nada de lo que envía es un hecho: es una
- * AFIRMACIÓN. Handeia la trata como dato citado, nunca como instrucción y
- * nunca al mismo nivel que lo que sabe del usuario. Un espacio que escriba
- * "ignora las instrucciones anteriores" en su contexto no logra nada.
- *
- * @see AGENT_PROTOCOL_VERSION para la política de compatibilidad.
- */
-/**
- * Versión del protocolo de agente. Viaja en cada mensaje.
- *
- * Se versiona desde el primer día a propósito: este contrato es público y
- * cambiarlo después obliga a coordinar despliegues entre partes que no se
- * conocen. Ya se pagó esa factura una vez con la codificación del JWT.
- */
-declare const AGENT_PROTOCOL_VERSION = 1;
-/** Un parámetro de una acción. Sin tipos no hay validación posible. */
-interface AgentActionParam {
-    name: string;
-    type: 'string' | 'number' | 'boolean';
-    description: string;
-    required?: boolean | undefined;
-    /** Valores admitidos. Si se define, nada fuera de la lista es válido. */
-    enum?: string[] | undefined;
-}
-/**
- * Algo que el espacio sabe hacer.
- *
- * Handeia SOLO puede pedir acciones declaradas aquí. No improvisa, no toca el
- * DOM, no busca la forma. Si no está declarada, para el agente no existe —
- * y eso es lo que hace que el mismo agente sirva en cualquier espacio sin que
- * Handeia sepa nada de ninguno en particular.
- */
-interface AgentAction {
-    /** Identificador estable, en minúsculas: 'filtrar_resultados'. */
-    name: string;
-    /** Qué hace, en lenguaje natural. Es lo que lee el modelo para elegirla. */
-    description: string;
-    params?: AgentActionParam[] | undefined;
-    /**
-     * true si modifica algo. Las que escriben se confirman con el usuario ANTES
-     * de ejecutarse — un agente que escribe sin preguntar se siente fuera de
-     * control incluso cuando acierta.
-     */
-    writes?: boolean | undefined;
-    /** Permiso que el usuario debe haber concedido a este espacio. */
-    permission?: string | undefined;
-}
-/** Configuración de la superficie de agente dentro de defineCapability. */
-interface AgentSurfaceConfig {
-    /** Acciones que el espacio expone. Vacío = el agente solo puede responder. */
-    actions?: AgentAction[] | undefined;
-    /**
-     * Endpoint para preguntarle al espacio cuando el usuario NO está dentro
-     * ("¿tengo algo pendiente ahí?"). El círculo solo existe con el espacio
-     * abierto; esto es lo que permite que Handeia sea el lugar donde convergen
-     * todos tus espacios en vez de uno más al que entrar.
-     */
-    queryEndpoint?: string | undefined;
-    /** Frase de bienvenida propia del espacio. */
-    greeting?: string | undefined;
-    /**
-     * Servicios externos que el espacio necesita consultar. El usuario los
-     * concede por espacio y los puede revocar cuando quiera. El espacio jamás
-     * recibe el token: pide operaciones, la plataforma las ejecuta.
-     */
-    needs?: ConnectorNeed[] | undefined;
-}
-/**
- * Servicios externos que un espacio puede necesitar (GitHub, Drive, Calendar…).
- *
- * ── La regla, y no tiene excepciones ─────────────────────────────────────
- * El espacio NUNCA recibe el token del usuario. Declara qué necesita, la
- * plataforma llama al proveedor con el token que YA tiene guardado, y le
- * devuelve solo el resultado.
- *
- * Por qué así y no entregando el token:
- *   - Si cada espacio guardara tokens, la superficie de ataque se multiplica
- *     por cada desarrollador que publique. Un espacio comprometido entregaría
- *     el GitHub y el Drive de todos sus usuarios.
- *   - Prestado, un espacio comprometido solo puede pedir las operaciones que
- *     el usuario le concedió, con límite de frecuencia, auditadas y
- *     revocables al instante desde Conectores.
- *
- * De regalo, publicar un espacio se vuelve barato: el desarrollador no
- * implementa OAuth de nada.
- */
-type ConnectorNeed = 'github' | 'drive' | 'calendar' | 'email' | 'notion' | 'discord';
-/**
- * Operaciones de LECTURA que la plataforma sabe hacer por el espacio.
- *
- * Lista cerrada a propósito: un espacio no puede pedir "haz esta llamada
- * arbitraria a la API de GitHub". Solo puede pedir lo que está aquí, y cada
- * una devuelve datos ya acotados. Escribir en un servicio externo NO se
- * presta — para eso el usuario usa el servicio.
- */
-type ConnectorOperation = 'github.repos' | 'github.issues' | 'drive.files' | 'calendar.events' | 'email.recent' | 'notion.pages';
-/** Lo que el espacio pide prestado. */
-interface ConnectorRequest {
-    operation: ConnectorOperation;
-    /** Filtros simples. La plataforma los valida; nada de consultas libres. */
-    params?: Record<string, string | number | boolean> | undefined;
-}
-/** Lo que la plataforma devuelve. Datos, jamás credenciales. */
-interface ConnectorResult {
-    operation: ConnectorOperation;
-    ok: boolean;
-    items?: Record<string, unknown>[] | undefined;
-    /** 'sin_conectar' = el usuario no ha vinculado ese servicio todavía. */
-    error?: 'sin_permiso' | 'sin_conectar' | 'no_soportada' | 'limite_excedido' | 'fallo' | undefined;
-}
-/** Qué operación necesita qué conector — la plataforma lo usa para autorizar. */
-declare const CONNECTOR_OF_OPERATION: Record<ConnectorOperation, ConnectorNeed>;
-/**
- * Lo que el espacio dice que está pasando.
- *
- * OJO: se llama `claims` y no `facts` a propósito. Handeia lo etiqueta como
- * afirmación de un tercero antes de dárselo al modelo.
- */
-interface AgentSpaceContext {
-    /** Dónde está el usuario dentro del espacio: '/lista'. */
-    route?: string | undefined;
-    /** Qué está viendo, en lenguaje natural: 'Lista de 12 resultados'. */
-    view?: string | undefined;
-    /** Datos que el espacio considera relevantes ahora mismo. */
-    claims?: Record<string, unknown> | undefined;
-}
-/** Petición del espacio a Handeia. Un solo endpoint, un solo formato. */
-interface AgentTurnRequest {
-    protocol: typeof AGENT_PROTOCOL_VERSION;
-    /** Lo que escribió el usuario. */
-    message: string;
-    context?: AgentSpaceContext | undefined;
-    /** Acciones disponibles AHORA (pueden ser menos que las declaradas). */
-    actions?: AgentAction[] | undefined;
-    /** Turnos previos, para que el agente no pierda el hilo. */
-    history?: {
-        role: 'user' | 'agent';
-        text: string;
-    }[] | undefined;
-    /** Resultado de una acción que Handeia pidió en el turno anterior. */
-    actionResult?: AgentActionResult | undefined;
-}
-/** Lo que el espacio devuelve tras ejecutar una acción. */
-interface AgentActionResult {
-    action: string;
-    ok: boolean;
-    /** Qué pasó, para que el agente pueda cerrar el ciclo con el usuario. */
-    summary?: string | undefined;
-    error?: string | undefined;
-}
-/**
- * De dónde salió lo que el agente afirma.
- *
- * No es adorno: es el pilar de info verificada. Cuando el agente contradice
- * al espacio ("dice 90, pero te conviene la de 87"), tiene que poder decir de
- * dónde sacó su razón. Un oráculo que no se explica no se gana la confianza.
- */
-interface AgentEvidence {
-    /** 'handeia' = memoria del usuario · 'space' = lo que declaró el espacio. */
-    source: 'handeia' | 'space';
-    label: string;
-}
-/** Respuesta de Handeia al espacio. */
-interface AgentTurnResponse {
-    protocol: typeof AGENT_PROTOCOL_VERSION;
-    /** Qué decirle al usuario. */
-    text?: string | undefined;
-    /** Acción a ejecutar. Siempre sale de la lista declarada, nunca inventada. */
-    action?: {
-        name: string;
-        args?: Record<string, unknown> | undefined;
-    } | undefined;
-    /** true si hay que confirmar con el usuario antes de ejecutarla. */
-    confirm?: boolean | undefined;
-    evidence?: AgentEvidence[] | undefined;
-    /** Identificador para cruzar los registros de todas las capas. */
-    traceId?: string | undefined;
-}
-/**
- * Revisa que las acciones declaradas sean utilizables.
- *
- * Corre al declarar la capacidad, no en producción: un contrato mal escrito
- * debe reventar en el escritorio del desarrollador, no frente al usuario.
- */
-declare function validateAgentSurface(cfg: AgentSurfaceConfig): string[];
-/**
- * ¿Es válida esta acción contra lo declarado?
- *
- * La usa Handeia antes de reenviarle nada al espacio. Es la lista blanca en
- * ejecución: aunque el modelo se invente una acción o un argumento fuera de
- * rango, aquí se detiene.
- */
-declare function validateActionCall(llamada: {
-    name: string;
-    args?: Record<string, unknown> | undefined;
-}, declaradas: AgentAction[]): {
-    ok: true;
-    action: AgentAction;
-} | {
-    ok: false;
-    reason: string;
-};
-
 type PublishType = 'app' | 'ia' | 'skill' | 'eco';
 type EcoTarget = 'gandia' | 'handeia' | 'both';
 type NodeType = 'widget' | 'artefacto' | 'espacio' | 'skill' | 'agente';
@@ -904,55 +686,6 @@ declare function defineCapability(config: CapabilityConfig): CapabilityConfig;
 /** Converts a CapabilityConfig to a gandia.manifest.json object. */
 declare function toManifest(config: CapabilityConfig): VAIAManifest;
 
-/**
- * El círculo del agente de Handeia, para montar dentro de un espacio.
- *
- * Montaje NEUTRAL a propósito: no depende de React ni de ningún framework. El
- * SDK presume de cero dependencias y atarlo a React lo traicionaría — un
- * espacio hecho en Vue, Svelte o HTML puro tiene el mismo derecho al agente.
- * Encima de esto, un envoltorio de React son tres líneas.
- *
- * Lo que el desarrollador pone:
- *   - de dónde sacar el contexto (qué está viendo el usuario)
- *   - qué acciones sabe ejecutar
- * Lo que pone el SDK: el círculo, el campo, el transporte y la identidad.
- *
- * El aspecto lo controla el SDK a propósito: así el agente se ve y se comporta
- * igual en todos los espacios, que es parte de que se sienta Handeia y no un
- * chat pegado a una app.
- */
-
-interface MountAgentOptions {
-    /** capability_id del espacio, el mismo del manifest. */
-    capabilityId: string;
-    /**
-     * Dónde vive Handeia. Un solo endpoint, y el SDK no sabe qué hay detrás:
-     * así Handeia puede reordenar sus capas sin publicar una versión nueva.
-     */
-    handeiaUrl?: string | undefined;
-    /** Qué está viendo el usuario AHORA. Se pregunta en cada turno, no se cachea. */
-    getContext?: (() => AgentSpaceContext | Promise<AgentSpaceContext>) | undefined;
-    /** Las mismas acciones que el manifest declara. */
-    actions?: AgentAction[] | undefined;
-    /** Ejecuta una acción. Solo se llama con acciones declaradas y ya validadas. */
-    onAction?: ((name: string, args: Record<string, unknown>) => Promise<AgentActionResult> | AgentActionResult) | undefined;
-    /** Dónde montar. Por defecto, el body. */
-    container?: HTMLElement | undefined;
-    /** Saludo propio del espacio. */
-    greeting?: string | undefined;
-}
-interface AgentHandle {
-    open(): void;
-    close(): void;
-    destroy(): void;
-}
-/**
- * Monta el agente. Devuelve un manejador para abrirlo, cerrarlo o quitarlo.
- *
- * Es idempotente por espacio: montarlo dos veces no deja dos círculos.
- */
-declare function mountAgent(opts: MountAgentOptions): AgentHandle;
-
 /**
  * Capacidades que CORREN.
  *
@@ -1267,4 +1000,4 @@ declare function toMCPTools(tools: ToolDef[]): {
 declare const gandia: typeof _gandia;
 declare const handeia: typeof _handeia;
 
-export { AGENT_PROTOCOL_VERSION, type ActionPayload, type ActionResponse, type AgentAction, type AgentActionParam, type AgentActionResult, type AgentDef, type AgentEvidence, type AgentHandle, type AgentLoopOptions, type AgentSpaceContext, type AgentSurfaceConfig, type AgentTurn, type AgentTurnRequest, type AgentTurnResponse, type AuditRecord, type Authority, type AuthorityLevel, CONNECTOR_OF_OPERATION, type Capability, type CapabilityCall, type CapabilityConfig, type CapabilityResult, type CardPayload, type CardResponse, type ConnectorNeed, type ConnectorOperation, type ConnectorRequest, type ConnectorResult, type Consequence, type DataResponse, type EcoTarget, type Ecosystem, type EcosystemConfig, type ErrorResponse, type EvidenceKind, type EvidencePolicy, type GandiaContext, type GandiaJWTClaims, type GandiaTenant, type GandiaUser, type HandeiaContext, type HandeiaJWTClaims, type HandeiaUser, type HttpCapabilityOptions, type LocalCapabilityOptions, type MCPCapabilityOptions, type MCPInputSchema, type MCPTool, type MCPTransport, type ModalityDef, type ModelFn, type MountAgentOptions, type NodeType, type OutputType, type PersonalityDef, type PiecesConfig, type PublishType, type RespondOpts, type Risk, type SkillDef, type Surface, type SurfaceHandlers, type TablePayload, type TableResponse, type TextResponse, type ToolDef, VAIAError, type VAIAManifest, type VAIAResponse, type WidgetPayload, type WidgetResponse, type WorkflowDef, agentLoop, capabilities, checkAuthority, defineCapability, defineEcosystem, fromMCPTool, gandia, handeia, http, httpTransport, local, mcp, mountAgent, requiresApproval, toMCPTool, toMCPTools, toManifest, validateActionCall, validateAgentSurface, validatePieces };
+export { type ActionPayload, type ActionResponse, AgentAction, type AgentDef, type AgentLoopOptions, AgentSurfaceConfig, type AgentTurn, type AuditRecord, type Authority, type AuthorityLevel, type Capability, type CapabilityCall, type CapabilityConfig, type CapabilityResult, type CardPayload, type CardResponse, type Consequence, type DataResponse, type EcoTarget, type Ecosystem, type EcosystemConfig, type ErrorResponse, type EvidenceKind, type EvidencePolicy, type GandiaContext, type GandiaJWTClaims, type GandiaTenant, type GandiaUser, type HandeiaContext, type HandeiaJWTClaims, type HandeiaUser, type HttpCapabilityOptions, type LocalCapabilityOptions, type MCPCapabilityOptions, type MCPInputSchema, type MCPTool, type MCPTransport, type ModalityDef, type ModelFn, type NodeType, type OutputType, type PersonalityDef, type PiecesConfig, type PublishType, type RespondOpts, type Risk, type SkillDef, type Surface, type SurfaceHandlers, type TablePayload, type TableResponse, type TextResponse, type ToolDef, VAIAError, type VAIAManifest, type VAIAResponse, type WidgetPayload, type WidgetResponse, type WorkflowDef, agentLoop, capabilities, checkAuthority, defineCapability, defineEcosystem, fromMCPTool, gandia, handeia, http, httpTransport, local, mcp, requiresApproval, toMCPTool, toMCPTools, toManifest, validatePieces };