@juspay/neurolink 11.16.2 → 11.17.0

package/dist/types/loopEngine.d.ts

@@ -27,6 +27,19 @@ export type AgenticLoopUsage = {
     cacheReadTokens?: number;
     cacheWriteTokens?: number;
     reasoningTokens?: number;
+    /**
+     * Cache writes split by time-to-live, which Anthropic reports separately
+     * from the total under `cache_creation.ephemeral_5m_input_tokens` and
+     * `ephemeral_1h_input_tokens`.
+     *
+     * Carried because the Claude-on-Vertex turn span reports both as
+     * `input_cache_creation_5m` / `_1h`, and `cacheWriteTokens` alone cannot
+     * reconstruct them — the two tiers are priced differently, so collapsing
+     * them loses the only signal that says which one a turn actually bought.
+     * Undefined for providers that never report the split.
+     */
+    cacheWrite5mTokens?: number;
+    cacheWrite1hTokens?: number;
 };
 export type AgenticLoopStepResult<TRaw = unknown> = {
     text: string;
@@ -191,15 +204,46 @@ export type AgenticLoopAdapter<TConversation = unknown, TRaw = unknown> = {
  * Anthropic has never had one, and setting it for both would change native
  * Anthropic's behaviour under the guise of a shared refactor.
  */
-export type AnthropicLoopAdapterConfig = {
-    client: Pick<Anthropic, "messages">;
+/**
+ * Construction input for `createAnthropicLoopAdapter`, shared by direct
+ * Anthropic and Claude-on-Vertex.
+ *
+ * Parameterized on the message shape because the two do NOT agree on it.
+ * Direct Anthropic uses the SDK's `MessageParam`; Claude-on-Vertex carries its
+ * own `VertexAnthropicMessage`, whose role union is narrower
+ * ("user" | "assistant", no "system") and whose image `media_type` is a plain
+ * string rather than the SDK's four-way union. Neither is assignable to the
+ * other, so pinning the adapter to one of them locked the other out entirely.
+ * The engine has been generic over its conversation type all along; this makes
+ * the adapter config match.
+ */
+export type AnthropicLoopAdapterConfig<TMessage = Anthropic.Messages.MessageParam> = {
+    /**
+     * Only `messages.create` is ever called, so only that is required.
+     *
+     * `Pick<Anthropic, "messages">` looked equivalent and is not: it demands the
+     * FULL `Messages` resource, including `batches` and the private `_client`.
+     * That excludes `AnthropicVertex`, whose `MessagesResource` is structurally
+     * smaller but has the one method this adapter uses — a client the adapter
+     * can drive perfectly, rejected for members it never touches.
+     */
+    client: {
+        messages: Pick<Anthropic["messages"], "create">;
+    };
     maxSteps: number;
     /**
      * Build one step's request. A closure so the per-turn work the caller
      * already does — system prompt, tool declarations, sampling, thinking
      * config, cache breakpoints — stays where it is rather than moving here.
      */
-    buildParams: (conversation: Anthropic.Messages.MessageParam[], step: number) => Anthropic.Messages.MessageCreateParams;
+    /**
+     * Returns the NON-streaming params. The adapter adds `stream: true` itself,
+     * so requiring the streaming variant here would force every caller to
+     * declare a literal `true` it does not control — and a caller whose params
+     * type carries `stream?: boolean` fails to match `stream: true` for a field
+     * the adapter is about to overwrite.
+     */
+    buildParams: (conversation: TMessage[], step: number) => Anthropic.Messages.MessageCreateParamsNonStreaming;
     /** The turn's live tool record, used for deferred-catalog resolution. */
     toolsRecord: Record<string, Tool>;
     /**
@@ -234,7 +278,7 @@ export type AnthropicLoopAdapterConfig = {
      * both every step with nothing else bounding growth, so a migration that
      * drops this overflows the window mid-turn.
      */
-    planReclaim?: (conversation: Anthropic.Messages.MessageParam[], step: number) => Anthropic.Messages.MessageParam[] | undefined;
+    planReclaim?: (conversation: TMessage[], step: number) => AgenticLoopReclaimResult<TMessage[]> | undefined;
     /**
      * Calibration feedback for the provider's reclaim guard: the FULL prompt
      * size for the step just made — uncached input plus both cache tiers.
@@ -268,6 +312,21 @@ export type GeminiToolExecutionGuards = {
      * legitimately slow tool reads as a stalled turn without this.
      */
     onProgress?: () => void;
+    /**
+     * Wrap one tool call in the provider's own observability.
+     *
+     * A function rather than a pair of start/end callbacks, because the caller
+     * needs the execution to happen INSIDE its span's context — spans opened by
+     * the tool itself must nest under the tool call, not dangle as siblings of
+     * the turn. Handing over the whole invocation is the only shape that lets a
+     * caller do `context.with(span, run)`.
+     *
+     * The caller awaits `run()` itself, so it sees the settled result and can
+     * mark a FAILURE THAT WAS RETURNED rather than thrown: MCP tools report
+     * errors in their payload, and an observation that only watches for
+     * exceptions records those calls as successful.
+     */
+    withToolSpan?: <T>(name: string, run: () => Promise<T>) => Promise<T>;
 };
 /** What one Gemini step produced, carried to `buildToolResultMessages`. */
 export type GeminiStepRaw = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "11.16.2",
+  "version": "11.17.0",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {
@@ -40,6 +40,8 @@
     "prepack": "svelte-kit sync && svelte-package && pnpm run build:react-hooks && pnpm run build:cli && pnpm run build:browser && publint",
     "build:react-hooks": "npx tsc --jsx react-jsx --module nodenext --moduleResolution nodenext --target esnext --esModuleInterop --skipLibCheck --outDir dist --declaration false src/lib/client/reactHooks.tsx",
     "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json && tsc --noEmit --strict",
+    "check:ci-scripts": "svelte-kit sync && tsc -p tsconfig.ci-scripts.json",
+    "check:test-parse": "node scripts/parse-check-tests.mjs",
     "check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
     "typecheck": "tsc --noEmit",
     "modelServer": "tsx scripts/modelServer.ts",