@zackbart/connecta-eve 0.35.0 → 0.36.0

package/README.md

@@ -1,18 +1,18 @@
 # @zackbart/connecta-eve
 
 Connect an Eve agent to a Connecta agent pool and load its endpoint instructions
-at the start of each turn. The helper runs in the Eve app; the Connecta server
+once per turn. The helper runs in the Eve app; the Connecta server
 runs separately. No `@zackbart/connecta` dependency is installed by this package.
 
-Requires **Node 24+** and **Eve >=0.83.0 <0.84.0**. Development and consumer
-checks use real Eve 0.83.0. The range covers its patch line; newer minor releases
+Requires **Node 24+** and **Eve >=0.84.0 <0.85.0**. Development and consumer
+checks use real Eve 0.84.0. The range covers its patch line; newer minor releases
 need a compatibility check. Helper releases share Connecta's version and tag;
 choose the helper version matching your server release.
 
 ## Install and add two files
 
 ```sh
-npm install @zackbart/connecta-eve eve@0.83.0
+npm install @zackbart/connecta-eve eve@0.84.0
 ```
 
 The server must declare your agent, admit it to the named pool and issue its
@@ -55,9 +55,9 @@ again for each request, so rotation requires no process restart. A `getToken`
 callback can return a string or a promise of one; it overrides the environment.
 No user's identity is forwarded.
 
-## Eve 0.83.0 dependency override
+## Eve 0.84.0 dependency override
 
-Eve 0.83.0 pins undici 8.10.2. Connecta's development/test override does not ship
+Eve 0.84.0 pins undici 8.10.2. Connecta's development/test override does not ship
 with this helper, so the Eve app must apply its own override to 8.12.3 before
 installing. For an npm app, add this to its `package.json`, then reinstall and
 commit the lockfile:
@@ -66,7 +66,7 @@ commit the lockfile:
 { "overrides": { "eve": { "undici": "8.12.3" } } }
 ```
 
-For a pnpm app, add `overrides: { "eve@0.83.0>undici": "8.12.3" }` to its
+For a pnpm app, add `overrides: { "eve@0.84.0>undici": "8.12.3" }` to its
 `pnpm-workspace.yaml`. Check the resolved dependency graph and audit the app.
 Remove this override after upgrading to an Eve release that pins a fixed version
 and validating compatibility. The server's optional undici 6.29.1 peer is a
@@ -79,7 +79,8 @@ read-only Connecta pool when the agent must never write. For an interactive
 agent, add `gateWrites: true` to the connection to request user approval before
 any tool whose `readOnlyHint` is not `true`, including writable `execute_code`.
 `gateConnectaWrites` exports that policy for composition. An explicit Eve
-`approval` policy takes precedence over `gateWrites`.
+`approval`, either a policy or an approval configuration, takes precedence over
+`gateWrites`.
 
 The gate uses the host's cached annotations. If a read becomes a write before
 dispatch, Connecta applies its current classification; a writable pool can
@@ -92,8 +93,13 @@ Instructions use `server/discover` (MCP 2026-07-28), falling back to legacy
 non-OK status or an unsupported-method response. Network errors and timeouts
 never trigger initialize. Both JSON and SSE replies are accepted. Each request
 has a five-second timeout. Successful guidance is cached for ten minutes per
-resolver; `ttlMs` overrides that duration. A failed refresh keeps the last copy,
-or adds nothing if no fetch has succeeded, and waits 30 seconds before retrying.
+resolver; `ttlMs` overrides that duration. Eve evaluates instructions before
+every model call; the helper keeps one result per turn in Eve's memo, so a turn
+sees the same guidance throughout and at most one refresh. A failed refresh
+keeps the last copy, or adds nothing if no fetch has succeeded, and waits 30
+seconds before retrying.
+When Eve cancels an evaluation, the helper rethrows the cancellation instead of
+counting it as a failure: nothing is kept for that turn and no wait starts.
 Tools remain usable. Instructions do not grant access.
 
 ## Vercel OIDC token source
@@ -129,7 +135,7 @@ dependency on it and never switches credential types automatically.
 
 In a source checkout with dependencies installed and both packages built, run
 `pnpm --filter @zackbart/connecta-eve run probe:catalog --output /absolute/path/outside/checkout`
-on Node 24. This boots real Eve 0.83.0 with a packed, installed helper against
+on Node 24. This boots real Eve 0.84.0 with a packed, installed helper against
 seeded local catalogs of 40, 100, 250, 500, and 1,000 downstream tools on the
 meta, native, and native-plus-code surfaces. Native listings include two
 Connecta tools beyond the downstream count. A 1,001-tool native catalog must

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { type McpClientConnectionDefinition } from "eve/connections";
-import { type ApprovalPolicy } from "eve/tools/approval";
+import { type Approval, type ApprovalPolicy } from "eve/tools/approval";
 /** Where an Eve agent reaches Connecta and how it proves who it is. */
 export interface ConnectaEndpointOptions {
     /**
@@ -18,8 +18,8 @@ export interface ConnectaEndpointOptions {
 export interface ConnectaConnectionOptions extends ConnectaEndpointOptions {
     /** What the connection offers, for the model choosing which connection to search. */
     description: string;
-    /** Eve's approval policy for every Connecta tool. Defaults to `never()`. */
-    approval?: ApprovalPolicy;
+    /** Eve's approval for every Connecta tool: a policy or configuration. Defaults to `never()`. */
+    approval?: Approval;
     /**
      * Ask a person before every tool not annotated read-only: each write tool
      * on a native endpoint, and `execute_code` on a writable one. Ignored when
@@ -46,9 +46,10 @@ export declare const gateConnectaWrites: ApprovalPolicy;
  */
 export declare function connectaConnection(options: ConnectaConnectionOptions): McpClientConnectionDefinition;
 /**
- * Connecta's instructions as Eve system instructions, refreshed at turn start.
+ * Connecta's instructions as Eve system instructions, refreshed once per turn.
  * Eve does not pass an MCP server's `instructions` to the model, so this
  * fetches them and caches each success; a failure keeps the last copy, or adds
- * nothing, and the tools still work.
+ * nothing, and the tools still work. Eve evaluates the resolver before every
+ * model call; a memo keyed on the turn keeps one result for the whole turn.
  */
-export declare function connectaInstructions(options?: ConnectaInstructionsOptions): import("eve/connections").DynamicSentinel<import("eve/instructions").DynamicInstructionsResult>;
+export declare function connectaInstructions(options?: ConnectaInstructionsOptions): import("eve/connections").DynamicSentinel<import("eve/instructions").DynamicInstructionsResult, import("eve/connections").DynamicContext>;

package/dist/index.js

@@ -36,14 +36,14 @@ export function connectaConnection(options) {
         url: connectaEndpoint(options),
         description: options.description,
         auth: {
-            credentialOwner: "app",
+            principalType: "app",
             getToken: async () => ({ token: await tokenFor(options) }),
         },
         approval: options.approval ?? (options.gateWrites ? gateConnectaWrites : never()),
     });
 }
 /** Connecta's MCP `instructions` for one endpoint, or null when unavailable. */
-async function instructionRequest(options, method) {
+async function instructionRequest(options, method, signal) {
     const modern = method === "server/discover";
     const response = await (options.fetch ?? fetch)(connectaEndpoint(options), {
         method: "POST",
@@ -71,7 +71,7 @@ async function instructionRequest(options, method) {
                     clientInfo: { name: "connecta-eve-instructions", version: "1" },
                 },
         }),
-        signal: AbortSignal.timeout(5_000),
+        signal: AbortSignal.any([signal, AbortSignal.timeout(5_000)]),
     });
     if (!response.ok)
         return null;
@@ -88,39 +88,46 @@ async function instructionRequest(options, method) {
     const instructions = JSON.parse(json).result?.instructions;
     return typeof instructions === "string" && instructions.trim() ? instructions.trim() : null;
 }
-async function fetchConnectaInstructions(options) {
+async function fetchConnectaInstructions(options, signal) {
     // Only a completed discovery response can justify legacy negotiation.
     // Network failures and timeouts propagate to the resolver's fail-open path.
-    const discovered = await instructionRequest(options, "server/discover");
-    return discovered ?? instructionRequest(options, "initialize");
+    const discovered = await instructionRequest(options, "server/discover", signal);
+    return discovered ?? instructionRequest(options, "initialize", signal);
 }
 /**
- * Connecta's instructions as Eve system instructions, refreshed at turn start.
+ * Connecta's instructions as Eve system instructions, refreshed once per turn.
  * Eve does not pass an MCP server's `instructions` to the model, so this
  * fetches them and caches each success; a failure keeps the last copy, or adds
- * nothing, and the tools still work.
+ * nothing, and the tools still work. Eve evaluates the resolver before every
+ * model call; a memo keyed on the turn keeps one result for the whole turn.
  */
 export function connectaInstructions(options = {}) {
     const ttlMs = options.ttlMs ?? 600_000;
     let cached;
     let retryAfter = 0;
-    const current = async () => {
+    const current = async (signal) => {
+        signal.throwIfAborted();
         if (cached && Date.now() - cached.at <= ttlMs)
             return cached.content;
         if (Date.now() < retryAfter)
             return cached?.content ?? null;
-        const fresh = await fetchConnectaInstructions(options).catch(() => null);
+        let fresh;
+        try {
+            fresh = await fetchConnectaInstructions(options, signal);
+        }
+        catch {
+            // Eve's cancellation is not an endpoint failure: rethrowing keeps it out
+            // of the memo and the backoff, which every session of this resolver shares.
+            signal.throwIfAborted();
+            fresh = null;
+        }
         if (fresh)
             cached = { at: Date.now(), content: fresh };
         retryAfter = fresh ? 0 : Date.now() + 30_000;
         return fresh ?? cached?.content ?? null;
     };
-    return defineDynamic({
-        events: {
-            "turn.started": async () => {
-                const content = await current();
-                return content ? defineInstructions({ content: `Connecta guidance:\n${content}` }) : null;
-            },
-        },
+    return defineDynamic(async (ctx) => {
+        const content = await ctx.memo(["connecta-instructions", ctx.turn?.id ?? null], ({ abortSignal }) => current(abortSignal));
+        return content ? defineInstructions({ content: `Connecta guidance:\n${content}` }) : null;
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zackbart/connecta-eve",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "type": "module",
   "sideEffects": false,
   "description": "Eve connection and instructions helpers for Connecta agent endpoints.",
@@ -28,11 +28,11 @@
     }
   },
   "peerDependencies": {
-    "eve": ">=0.83.0 <0.84.0"
+    "eve": ">=0.84.0 <0.85.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
-    "eve": "0.83.0",
+    "eve": "0.84.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.6"
   },