@agent-builder-lab/eve-kit 0.0.0-stage → 0.2.0

package/dist/rate-limit.js

@@ -0,0 +1,61 @@
+import {
+  labAccountOf
+} from "./chunk-LQIDQBNW.js";
+
+// src/rate-limit.ts
+function criarLimitePorPessoa(opcoes) {
+  const agora = opcoes.agora ?? Date.now;
+  const porChave = /* @__PURE__ */ new Map();
+  function contar(chave, regra, t) {
+    const janela = porChave.get(chave) ?? { marcas: [] };
+    janela.marcas = janela.marcas.filter((m) => t - m < regra.janelaMs);
+    porChave.set(chave, janela);
+    return janela.marcas.length >= regra.max;
+  }
+  function registrar(chaves, t) {
+    for (const chave of chaves) {
+      const janela = porChave.get(chave) ?? { marcas: [] };
+      janela.marcas.push(t);
+      porChave.set(chave, janela);
+    }
+  }
+  return (ctx) => {
+    const conta = labAccountOf(ctx);
+    const pessoa = conta ? conta.id : `sessao:${ctx.session.id}`;
+    const nome = conta?.name ?? "voc\xEA";
+    const t = agora();
+    const chavePessoa = `p:${pessoa}:${ctx.toolName}`;
+    if (contar(chavePessoa, opcoes.porPessoa, t)) {
+      return {
+        type: "denied",
+        reason: `Limite de uso: ${nome} j\xE1 usou ${ctx.toolName} ${opcoes.porPessoa.max} vez(es) no per\xEDodo. Tente de novo mais tarde.`
+      };
+    }
+    const chaves = [chavePessoa];
+    if (opcoes.porFerramenta) {
+      const chaveFerramenta = `f:${ctx.toolName}`;
+      if (contar(chaveFerramenta, opcoes.porFerramenta, t)) {
+        return {
+          type: "denied",
+          reason: `Limite de uso: ${ctx.toolName} atingiu o teto de chamadas do time no per\xEDodo.`
+        };
+      }
+      chaves.push(chaveFerramenta);
+    }
+    registrar(chaves, t);
+    return opcoes.next ? opcoes.next(ctx) : "not-applicable";
+  };
+}
+function limitePorCusto(opcoes) {
+  return ({ window }) => {
+    if (opcoes.maxUsd !== void 0 && (window.costUsd ?? 0) >= opcoes.maxUsd) return true;
+    if (opcoes.maxInputTokens !== void 0) {
+      if (window.inputTokens - window.cacheReadTokens >= opcoes.maxInputTokens) return true;
+    }
+    return false;
+  };
+}
+export {
+  criarLimitePorPessoa,
+  limitePorCusto
+};

package/dist/replay.d.ts

@@ -0,0 +1,36 @@
+import * as eve from 'eve';
+import { AgentStaticModelDefinition, DynamicResolveContext } from 'eve';
+
+/** O modelo de verdade: fixo ou escolhido a cada step, como num `defineDynamic`. */
+type LabModelChoice = AgentStaticModelDefinition | {
+    model: AgentStaticModelDefinition;
+    modelContextWindowTokens?: number;
+    reasoning?: "provider-default" | "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+};
+type LabModelResolver = (event: unknown, ctx: DynamicResolveContext) => LabModelChoice | Promise<LabModelChoice>;
+interface LabReplayOptions {
+    /** Porta local do conector. Padrão: `LAB_CONNECTOR_URL` ou http://127.0.0.1:2100. */
+    connectorUrl?: string;
+    /**
+     * Janela informada ao eve nos steps repetidos (o `mockModel` não está no catálogo do AI
+     * Gateway, e o eve recusa um modelo dinâmico sem janela). Padrão: 1 milhão de tokens.
+     */
+    replayContextWindowTokens?: number;
+}
+/**
+ * Modelo do agente com replay para o Agent Builder Lab, para o `model` do `agent.ts`:
+ *
+ * ```ts
+ * import { labReplayModel } from "@agent-builder-lab/eve-kit/replay";
+ * export default defineAgent({ model: labReplayModel("anthropic/claude-sonnet-5.5") });
+ * ```
+ *
+ * Fora de um fork do lab, devolve o seu modelo em todo step. Num fork (o canal do lab marca o
+ * turno com o id), repete os steps gravados antes da volta editada, inclusive ela, com um
+ * `mockModel`: mesmo texto, mesmas tool calls e mesmos ids. Assim as voltas anteriores saem
+ * iguais às originais e o modelo de verdade só entra depois do ponto editado. O `modelId` desses
+ * steps é `lab-replay/<modelo original>`.
+ */
+declare function labReplayModel(model: LabModelChoice | LabModelResolver, options?: LabReplayOptions): eve.DynamicSentinel<LabModelChoice>;
+
+export { type LabModelChoice, type LabModelResolver, type LabReplayOptions, labReplayModel };

package/dist/replay.js

@@ -0,0 +1,50 @@
+import {
+  LAB_FORK_ATTRIBUTE,
+  REPLAY_PROVIDER,
+  fetchForkPlan
+} from "./chunk-3IQOFBSQ.js";
+
+// src/replay.ts
+import { defineDynamic } from "eve";
+import { mockModel } from "eve/evals";
+function labReplayModel(model, options = {}) {
+  const real = (event, ctx) => typeof model === "function" ? model(event, ctx) : model;
+  return defineDynamic({
+    events: {
+      "step.started": async (event, ctx) => {
+        const forkId = ctx.session.auth.current?.attributes[LAB_FORK_ATTRIBUTE];
+        if (typeof forkId !== "string") return real(event, ctx);
+        const plan = await fetchForkPlan(forkId, options.connectorUrl).catch(() => void 0);
+        const step = plan?.replay?.steps[stepIndexOf(event)];
+        if (!step) return real(event, ctx);
+        return {
+          model: replayStep(step, plan?.replay?.modelId),
+          modelContextWindowTokens: options.replayContextWindowTokens ?? 1e6
+        };
+      }
+    }
+  });
+}
+function stepIndexOf(event) {
+  const record = event ?? {};
+  const index = record.data?.stepIndex ?? record.stepIndex;
+  return typeof index === "number" ? index : -1;
+}
+function replayStep(step, modelId = "modelo") {
+  return mockModel({
+    provider: REPLAY_PROVIDER,
+    modelId,
+    respond: () => ({
+      text: step.text || void 0,
+      toolCalls: step.toolCalls.map((call) => ({
+        id: call.id,
+        name: call.name,
+        input: call.input
+      })),
+      usage: step.usage
+    })
+  });
+}
+export {
+  labReplayModel
+};

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@agent-builder-lab/eve-kit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.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": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./authorization": {
+      "types": "./dist/authorization.d.ts",
+      "import": "./dist/authorization.js"
+    },
+    "./channel": {
+      "types": "./dist/channel.d.ts",
+      "import": "./dist/channel.js"
+    },
+    "./replay": {
+      "types": "./dist/replay.d.ts",
+      "import": "./dist/replay.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp.d.ts",
+      "import": "./dist/mcp.js"
+    },
+    "./limits": {
+      "types": "./dist/rate-limit.d.ts",
+      "import": "./dist/rate-limit.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "eve": ">=0.83.0 <0.84.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.19.2",
+    "eve": "0.83.2",
+    "tsup": "8.5.1",
+    "typescript": "6.0.3",
+    "vitest": "5.0.5",
+    "@lab/config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.