@agent-builder-lab/eve-kit 0.2.0 → 0.3.0

package/dist/channel.d.ts

@@ -28,6 +28,9 @@ interface LabChannelOptions extends Omit<EveChannelInput, "auth"> {
  *   para os atributos do auth do turno (`labAccount`), onde `labAuthorization()` confere cada
  *   tool call, e também sai do contexto que o modelo vê: a identidade vem do harness, nunca do
  *   texto.
+ * - Quando o pedido traz o modo do MCP da formação (`clientContext.labMcp`, o botão do lab), os
+ *   ataques vão para os atributos do auth do turno (`labMcp`) e saem do contexto do modelo:
+ *   `labMcpAtaquesOf(ctx)` (de `@agent-builder-lab/eve-kit/mcp`) lê na ferramenta.
  *
  * Em produção (`eve start`, Vercel) o acesso local não autentica nada e o canal se comporta como
  * o padrão com os autenticadores que você passar.

package/dist/channel.js

@@ -1,3 +1,8 @@
+import {
+  LAB_MCP_ATTRIBUTE,
+  LAB_MCP_CONTEXT_KEY,
+  labMcpAtaquesFromContext
+} from "./chunk-Z56XW2U4.js";
 import {
   LAB_ACCOUNT_ATTRIBUTE,
   LAB_ACCOUNT_CONTEXT_KEY,
@@ -31,11 +36,13 @@ function labOnMessage(options) {
     const context = ctx.eve.clientContext;
     const forkId = forkIdFromContext(context);
     const account = labAccountFromContext(context);
-    if (!forkId && !account && !hasLabKeys(context)) return base;
+    const mcpAtaques = labMcpAtaquesFromContext(context);
+    if (!forkId && !account && mcpAtaques === void 0 && !hasLabKeys(context)) return base;
     const plan = forkId ? await fetchForkPlan(forkId, options.connectorUrl) : void 0;
     const attributes = {
       ...forkId ? { [LAB_FORK_ATTRIBUTE]: forkId } : {},
-      ...account ? { [LAB_ACCOUNT_ATTRIBUTE]: JSON.stringify(account) } : {}
+      ...account ? { [LAB_ACCOUNT_ATTRIBUTE]: JSON.stringify(account) } : {},
+      ...mcpAtaques !== void 0 ? { [LAB_MCP_ATTRIBUTE]: JSON.stringify({ ataques: mcpAtaques }) } : {}
     };
     return {
       ...base,
@@ -68,7 +75,11 @@ function isLoopback(request) {
   const host = new URL(request.url).hostname.replace(/^\[|\]$/g, "");
   return host === "127.0.0.1" || host === "localhost" || host === "::1";
 }
-var LAB_KEYS = [LAB_FORK_CONTEXT_KEY, LAB_ACCOUNT_CONTEXT_KEY];
+var LAB_KEYS = [
+  LAB_FORK_CONTEXT_KEY,
+  LAB_ACCOUNT_CONTEXT_KEY,
+  LAB_MCP_CONTEXT_KEY
+];
 function hasLabKeys(context) {
   if (!context || typeof context !== "object" || Array.isArray(context)) return false;
   return LAB_KEYS.some((key) => key in context);

package/dist/chunk-Z56XW2U4.js

@@ -0,0 +1,33 @@
+// src/lab-mcp.ts
+var LAB_MCP_CONTEXT_KEY = "labMcp";
+var LAB_MCP_ATTRIBUTE = "labMcp";
+var ATAQUES_VALIDOS = /^[a-z_@, ]{0,200}$/;
+function labMcpAtaquesFromContext(context) {
+  if (!context || typeof context !== "object" || Array.isArray(context)) return void 0;
+  const value = context[LAB_MCP_CONTEXT_KEY];
+  if (!value || typeof value !== "object" || Array.isArray(value)) return void 0;
+  const v = value;
+  if (v.v !== 1 || typeof v.ataques !== "string") return void 0;
+  return ATAQUES_VALIDOS.test(v.ataques) ? v.ataques : void 0;
+}
+function labMcpAtaquesFromAuth(auth) {
+  const raw = auth?.attributes?.[LAB_MCP_ATTRIBUTE];
+  if (typeof raw !== "string") return void 0;
+  try {
+    const ataques = JSON.parse(raw)?.ataques;
+    return typeof ataques === "string" && ATAQUES_VALIDOS.test(ataques) ? ataques : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function labMcpAtaquesOf(ctx) {
+  return labMcpAtaquesFromAuth(ctx.session.auth.current);
+}
+
+export {
+  LAB_MCP_CONTEXT_KEY,
+  LAB_MCP_ATTRIBUTE,
+  labMcpAtaquesFromContext,
+  labMcpAtaquesFromAuth,
+  labMcpAtaquesOf
+};

package/dist/mcp.d.ts

@@ -1,5 +1,31 @@
 import { ApprovalPolicy } from 'eve/tools/approval';
 
+/** Chave do `clientContext` com o modo do MCP do turno. */
+declare const LAB_MCP_CONTEXT_KEY = "labMcp";
+/** Atributo do auth do turno com os ataques, em JSON (`{"ataques":"injecao"}`), para as ferramentas lerem. */
+declare const LAB_MCP_ATTRIBUTE = "labMcp";
+/**
+ * Os ataques que o lab mandou no `clientContext` do pedido: "" para o modo limpo, "injecao",
+ * "todos"… Undefined quando o pedido não traz o modo ou ele vem fora do formato.
+ */
+declare function labMcpAtaquesFromContext(context: unknown): string | undefined;
+type AuthLike = {
+    readonly attributes?: Readonly<Record<string, string | readonly string[]>>;
+};
+/** Os ataques guardados nos atributos de um auth (o `labChannel()` grava). */
+declare function labMcpAtaquesFromAuth(auth: AuthLike | null | undefined): string | undefined;
+/**
+ * Os ataques do MCP escolhidos no lab para este turno, para usar dentro de uma ferramenta:
+ * `labMcpAtaquesOf(ctx)`. "" é o modo limpo; undefined, sem escolha (vale a URL do agente).
+ */
+declare function labMcpAtaquesOf(ctx: {
+    readonly session: {
+        readonly auth: {
+            readonly current: AuthLike | null;
+        };
+    };
+}): string | undefined;
+
 interface ClienteMcp {
     chamar(nome: string, argumentos: Record<string, unknown>, signal?: AbortSignal): Promise<unknown>;
     listar(signal?: AbortSignal): Promise<Array<{
@@ -84,4 +110,4 @@ declare function aprovarEntradaExterna<TInput = Record<string, unknown>>(opcoes?
     readonly next?: ApprovalPolicy<TInput>;
 }): ApprovalPolicy<TInput>;
 
-export { type AchadoNoResultado, type ClienteMcp, type OpcoesDaFerramentaMcp, type OpcoesDeVarredura, type OpcoesDoCliente, type ResultadoDaVarredura, type ResultadoExterno, type SinalDeAtaque, aprovarEntradaExterna, chamarMcpVarrido, clienteMcpHttp, varrerResultado };
+export { type AchadoNoResultado, type ClienteMcp, LAB_MCP_ATTRIBUTE, LAB_MCP_CONTEXT_KEY, type OpcoesDaFerramentaMcp, type OpcoesDeVarredura, type OpcoesDoCliente, type ResultadoDaVarredura, type ResultadoExterno, type SinalDeAtaque, aprovarEntradaExterna, chamarMcpVarrido, clienteMcpHttp, labMcpAtaquesFromAuth, labMcpAtaquesFromContext, labMcpAtaquesOf, varrerResultado };

package/dist/mcp.js

@@ -1,3 +1,11 @@
+import {
+  LAB_MCP_ATTRIBUTE,
+  LAB_MCP_CONTEXT_KEY,
+  labMcpAtaquesFromAuth,
+  labMcpAtaquesFromContext,
+  labMcpAtaquesOf
+} from "./chunk-Z56XW2U4.js";
+
 // src/mcp-client.ts
 var PROTOCOLO = "2025-06-18";
 var ErroMcp = class extends Error {
@@ -270,8 +278,13 @@ function aprovarEntradaExterna(opcoes = {}) {
   };
 }
 export {
+  LAB_MCP_ATTRIBUTE,
+  LAB_MCP_CONTEXT_KEY,
   aprovarEntradaExterna,
   chamarMcpVarrido,
   clienteMcpHttp,
+  labMcpAtaquesFromAuth,
+  labMcpAtaquesFromContext,
+  labMcpAtaquesOf,
   varrerResultado
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-builder-lab/eve-kit",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Liga um agente eve ao Agent Builder Lab: instrumentação da janela de contexto, canal com history e stubs, replay e autorização por conta de teste.",
   "type": "module",
   "exports": {
@@ -43,7 +43,7 @@
   },
   "devDependencies": {
     "@types/node": "24.19.2",
-    "eve": "0.83.2",
+    "eve": "0.83.3",
     "tsup": "8.5.1",
     "typescript": "6.0.3",
     "vitest": "5.0.5",