@nebutra/agents 1.1.1 → 2.0.0

package/dist/sdk/models.d.ts

@@ -1,34 +1,26 @@
-/**
- * Model presets for common Nebutra use cases.
- *
- * All IDs use "vendor/model" format (OpenRouter / SiliconFlow).
- * When using direct OpenAI provider, only OpenAI models are valid.
- * When using Vercel AI Gateway, use "provider/model" format.
- * When using SiliconFlow, use "Vendor/Model" format (e.g. "Qwen/Qwen2.5-72B-Instruct").
- */
 declare const models: {
-    /** High-quality reasoning — default for complex tasks */
-    readonly flagship: "anthropic/claude-sonnet-4";
-    /** Deep reasoning for architecture and research */
-    readonly reasoning: "anthropic/claude-opus-4";
-    /** Fast + cheap — chat, summaries, classification */
-    readonly fast: "anthropic/claude-haiku-4";
-    /** OpenAI flagship */
-    readonly "openai-flagship": "openai/gpt-5.4";
-    /** Google flagship */
-    readonly "google-flagship": "google/gemini-2.5-pro";
-    /** Google fast */
-    readonly "google-fast": "google/gemini-2.5-flash";
+    /** SenseNova 6.7 Flash-Lite — small multimodal agent (default for i18n CI) */
+    readonly "sn-flash-lite": "sensenova-6.7-flash-lite";
+    /** DeepSeek V4 Flash via SenseNova Token Plan — long context, cheap */
+    readonly "sn-deepseek-flash": "deepseek-v4-flash";
+    /** Alias: prefer flash-lite for bulk translation */
+    readonly "sn-translate": "sensenova-6.7-flash-lite";
+    readonly "302-deepseek": "deepseek-v4-pro";
+    readonly "302-deepseek-fast": "deepseek-v4-flash";
+    readonly "302-qwen": "qwen3.8-max";
+    readonly "302-glm": "glm-5.3";
+    readonly "302-kimi": "kimi-k3";
+    readonly "302-minimax": "MiniMax-M3";
     /** Embedding model */
     readonly embedding: "openai/text-embedding-3-small";
     /** Embedding model (high-dimensional) */
     readonly "embedding-large": "openai/text-embedding-3-large";
-    /** SiliconFlow — Qwen 2.5 72B (flagship open-source) */
-    readonly "sf-qwen": "Qwen/Qwen2.5-72B-Instruct";
-    /** SiliconFlow — DeepSeek R1 reasoning (via SiliconFlow Pro) */
-    readonly "sf-deepseek-r1": "Pro/deepseek-ai/DeepSeek-R1";
-    /** SiliconFlow — DeepSeek V3 (fast, capable) */
-    readonly "sf-deepseek-v3": "deepseek-ai/DeepSeek-V3";
+    readonly reasoning: "anthropic/claude-opus-5";
+    readonly flagship: "anthropic/claude-sonnet-5";
+    readonly fast: "anthropic/claude-haiku-4.5";
+    readonly "openai-flagship": "openai/gpt-5.6-sol";
+    readonly "google-flagship": "google/gemini-3.1-pro-preview";
+    readonly "google-fast": "google/gemini-3.7-flash";
 };
 type ModelPreset = keyof typeof models;
 /**
@@ -36,5 +28,6 @@ type ModelPreset = keyof typeof models;
  * If the input is not a preset key, returns it as-is (passthrough).
  */
 declare function resolveModel(modelOrPreset: string): string;
+declare function toAi302ModelId(modelOrPreset: string): string;
 
-export { type ModelPreset, models, resolveModel };
+export { type ModelPreset, models, resolveModel, toAi302ModelId };

package/dist/sdk/models.js

@@ -1,8 +1,10 @@
 import {
   models,
-  resolveModel
-} from "../chunk-5JZJ5KMC.js";
+  resolveModel,
+  toAi302ModelId
+} from "../chunk-HVLFZW6E.js";
 export {
   models,
-  resolveModel
+  resolveModel,
+  toAi302ModelId
 };

package/dist/sdk/provider.d.ts

@@ -9,6 +9,7 @@ import 'zod';
  * - "openrouter"   → @openrouter/ai-sdk-provider (300+ models, failover)
  * - "openai"       → @ai-sdk/openai (direct OpenAI API)
  * - "siliconflow"  → @ai-sdk/openai with SiliconFlow baseURL (OpenAI-compatible)
+ * - "sensenova"    → @ai-sdk/openai with SenseNova compatible-mode baseURL
  * - "gateway"      → Vercel AI Gateway via plain model string (OIDC auth)
  */
 declare function createModel(modelOrPreset: string, config: ResolvedNebutraAIConfig): LanguageModel;

package/dist/sdk/provider.js

@@ -1,9 +1,9 @@
 import {
   createEmbeddingModel,
   createModel
-} from "../chunk-RLWM437Q.js";
-import "../chunk-NVPE5EDI.js";
-import "../chunk-5JZJ5KMC.js";
+} from "../chunk-KC6SOI5Z.js";
+import "../chunk-YBCIJKC7.js";
+import "../chunk-HVLFZW6E.js";
 export {
   createEmbeddingModel,
   createModel

package/dist/tools.d.ts

@@ -1,4 +1,4 @@
-import { d as AgentTool } from './types-NtgB3pch.js';
+import { d as AgentTool } from './types-BytC-HfQ.js';
 
 /**
  * Built-in tool registry for agents.

package/dist/{types-NtgB3pch.d.ts → types-BytC-HfQ.d.ts}

@@ -73,10 +73,6 @@ interface RouterConfig {
     readonly strategy: "keyword" | "llm" | "custom";
     readonly customRouter?: (message: string, context: AgentContext) => Promise<string>;
 }
-interface PipelineStep {
-    readonly agentId: string;
-    readonly transformInput?: (prevOutput: string) => string;
-}
 interface AgentUsageEvent {
     readonly tenantId: string;
     readonly userId: string;
@@ -89,4 +85,4 @@ interface AgentUsageEvent {
     readonly timestamp: Date;
 }
 
-export type { AgentMessage as A, MemoryConfig as M, OrchestratorConfig as O, PipelineStep as P, RouterConfig as R, TokenUsage as T, AgentContext as a, AgentResponse as b, AgentConfig as c, AgentTool as d, AgentUsageEvent as e, ToolCallResult as f };
+export type { AgentMessage as A, MemoryConfig as M, OrchestratorConfig as O, RouterConfig as R, TokenUsage as T, AgentContext as a, AgentResponse as b, AgentConfig as c, AgentTool as d, AgentUsageEvent as e, ToolCallResult as f };

package/package.json

@@ -1,46 +1,97 @@
 {
   "name": "@nebutra/agents",
-  "version": "1.1.1",
+  "version": "2.0.0",
   "description": "Nebutra AI runtime: multi-agent orchestration + Vercel AI SDK helpers (absorbed @nebutra/ai-sdk in 1.0.0)",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "status": "wip",
+    "graph": "runtime",
     "featureId": "agents",
     "category": "ai",
     "surface": "model-runtime",
     "summary": "Nebutra AI runtime: multi-agent orchestration + Vercel AI SDK helpers"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./tools": "./src/tools.ts",
-    "./providers/vercel-ai": "./src/providers/vercel-ai.ts",
-    "./providers/langchain": "./src/providers/langchain.ts",
-    "./generation": "./src/generation/index.ts",
-    "./sdk": "./src/sdk/index.ts",
-    "./sdk/config": "./src/sdk/config.ts",
-    "./sdk/models": "./src/sdk/models.ts",
-    "./sdk/provider": "./src/sdk/provider.ts",
-    "./env": "./src/env.ts",
-    "./observability": "./src/observability.ts",
-    "./fallback": "./src/fallback.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "import": "./dist/tools.js",
+      "default": "./dist/tools.js"
+    },
+    "./providers/vercel-ai": {
+      "types": "./dist/providers/vercel-ai.d.ts",
+      "import": "./dist/providers/vercel-ai.js",
+      "default": "./dist/providers/vercel-ai.js"
+    },
+    "./providers/langchain": {
+      "types": "./dist/providers/langchain.d.ts",
+      "import": "./dist/providers/langchain.js",
+      "default": "./dist/providers/langchain.js"
+    },
+    "./generation": {
+      "types": "./dist/generation/index.d.ts",
+      "import": "./dist/generation/index.js",
+      "default": "./dist/generation/index.js"
+    },
+    "./sdk": {
+      "types": "./dist/sdk/index.d.ts",
+      "import": "./dist/sdk/index.js",
+      "default": "./dist/sdk/index.js"
+    },
+    "./sdk/config": {
+      "types": "./dist/sdk/config.d.ts",
+      "import": "./dist/sdk/config.js",
+      "default": "./dist/sdk/config.js"
+    },
+    "./sdk/models": {
+      "types": "./dist/sdk/models.d.ts",
+      "import": "./dist/sdk/models.js",
+      "default": "./dist/sdk/models.js"
+    },
+    "./sdk/provider": {
+      "types": "./dist/sdk/provider.d.ts",
+      "import": "./dist/sdk/provider.js",
+      "default": "./dist/sdk/provider.js"
+    },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "import": "./dist/env.js",
+      "default": "./dist/env.js"
+    },
+    "./observability": {
+      "types": "./dist/observability.d.ts",
+      "import": "./dist/observability.js",
+      "default": "./dist/observability.js"
+    },
+    "./fallback": {
+      "types": "./dist/fallback.d.ts",
+      "import": "./dist/fallback.js",
+      "default": "./dist/fallback.js"
+    }
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.76",
     "@ai-sdk/openai": "^3.0.41",
     "@openrouter/ai-sdk-provider": "^2.3.3",
     "ai": "^6.0.0",
+    "ajv": "^8.18.0",
     "langfuse": "^3.38.20",
     "langfuse-vercel": "^3.38.20",
     "zod": "^4.3.6",
-    "@nebutra/billing": "0.1.2",
-    "@nebutra/cache": "0.0.2",
-    "@nebutra/logger": "0.1.1"
+    "@nebutra/billing": "2.0.0",
+    "@nebutra/cache": "2.0.0",
+    "@nebutra/logger": "2.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.19.15",
+    "@types/node": "^25.9.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
@@ -57,6 +108,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",

package/.turbo/turbo-build.log

@@ -1,40 +0,0 @@
-
-> @nebutra/agents@1.1.1 build /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agents
-> tsup
-
-CLI Building entry: src/index.ts, src/tools.ts, src/providers/langchain.ts, src/providers/vercel-ai.ts, src/sdk/config.ts, src/sdk/index.ts, src/sdk/models.ts, src/sdk/provider.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agents/tsup.config.ts
-CLI Target: node20
-CLI Cleaning output folder
-ESM Build start
-ESM dist/index.js               16.08 KB
-ESM dist/providers/langchain.js 536.00 B
-ESM dist/sdk/config.js          166.00 B
-ESM dist/chunk-UVL2UVVM.js      1.26 KB
-ESM dist/tools.js               203.00 B
-ESM dist/providers/vercel-ai.js 2.43 KB
-ESM dist/chunk-B7XWL35G.js      1.51 KB
-ESM dist/chunk-RDOFKRI6.js      4.71 KB
-ESM dist/sdk/index.js           534.00 B
-ESM dist/chunk-NPQECBXL.js      2.37 KB
-ESM dist/chunk-5LX742GP.js      7.78 KB
-ESM dist/sdk/provider.js        190.00 B
-ESM dist/sdk/models.js          102.00 B
-ESM dist/chunk-RLWM437Q.js      1.63 KB
-ESM dist/chunk-NVPE5EDI.js      1.49 KB
-ESM dist/chunk-5JZJ5KMC.js      1.22 KB
-ESM ⚡️ Build success in 48ms
-DTS Build start
-DTS ⚡️ Build success in 5575ms
-DTS dist/index.d.ts               19.71 KB
-DTS dist/tools.d.ts               724.00 B
-DTS dist/providers/langchain.d.ts 546.00 B
-DTS dist/providers/vercel-ai.d.ts 569.00 B
-DTS dist/sdk/index.d.ts           3.88 KB
-DTS dist/sdk/models.d.ts          1.73 KB
-DTS dist/sdk/provider.d.ts        882.00 B
-DTS dist/sdk/config.d.ts          1.80 KB
-DTS dist/agent-CahnMASx.d.ts      1.10 KB
-DTS dist/types-NtgB3pch.d.ts      3.02 KB

package/.turbo/turbo-test.log

@@ -1,19 +0,0 @@
-
-> @nebutra/agents@1.1.1 test /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agents
-> vitest run
-
-
- RUN  v4.1.4 /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agents
-
- ✓ src/__tests__/fallback-wiring.test.ts (9 tests) 235ms
- ✓ src/__tests__/cost-observability.test.ts (18 tests) 510ms
-     ✓ falls through retryable errors and returns the next provider's result  335ms
- ✓ src/__tests__/public-api.test.ts (16 tests) 72ms
- ✓ src/__tests__/runtime-gateway.test.ts (3 tests) 80ms
- ✓ src/__tests__/generation.test.ts (7 tests) 61ms
-
- Test Files  5 passed (5)
-      Tests  53 passed (53)
-   Start at  08:15:21
-   Duration  4.98s (transform 2.66s, setup 0ms, import 7.42s, tests 958ms, environment 1ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/agents@1.1.1 typecheck /home/runner/work/Nebutra-Sailor/Nebutra-Sailor/packages/ai/agents
-> tsc --noEmit
-

package/AGENTS.md

@@ -1,63 +0,0 @@
-# AGENTS.md — packages/agents
-
-Execution contract for Nebutra's multi-agent runtime package.
-
-## Scope
-
-Applies to everything under `packages/ai/agents/`.
-
-This package owns agent lifecycle, orchestration, routing, tenant-aware memory,
-built-in tool stubs, and the shared AI SDK wrapper surface exported to the rest
-of the repo. It is the runtime layer for agent execution, not the place for
-app-specific prompts, UI behavior, or direct provider-specific business logic.
-
-## Source Of Truth
-
-- Public package surface and subpath exports: `package.json`, `src/index.ts`
-- Canonical agent and orchestration contracts: `src/types.ts`
-- Base agent lifecycle, memory loading, usage emission, and billing hook:
-  `src/agent.ts`
-- Multi-agent routing, quota checks, chat/pipeline/broadcast semantics:
-  `src/orchestrator.ts`, `src/router.ts`, `src/tenant.ts`
-- Built-in tool catalog and current stub behavior: `src/tools.ts`
-- Shared AI SDK wrapper config, model resolution, and provider helpers:
-  `src/sdk/`
-- Provider-specific runtime adapters: `src/providers/`
-- Public API coverage for exported surface: `src/__tests__/public-api.test.ts`
-
-Treat `README.md` as descriptive only. If docs drift, update the source files
-above instead of preserving outdated examples.
-
-## Contract Boundaries
-
-- Keep `package.json` exports and `src/index.ts` aligned. Do not ask consumers
-  to deep-import internals when a supported subpath export already exists.
-- Treat `src/types.ts` as the canonical contract for agent config, context,
-  memory, tool, usage, and orchestration semantics. Tightening these shapes is
-  a cross-package compatibility change.
-- Preserve the split between core runtime and provider adapters:
-  `src/agent.ts`, `src/orchestrator.ts`, and `src/router.ts` own generic agent
-  lifecycle semantics; `src/providers/` and `src/sdk/` own provider-specific
-  runtime behavior.
-- Keep quota and usage semantics centralized in `src/tenant.ts` and
-  `src/agent.ts`. Do not scatter billing deduction or quota checks into callers.
-- Keep built-in tools honest about current capability. `src/tools.ts` is still
-  stub-oriented; do not document or code against live search, RAG, or SQL
-  access unless the actual implementation is being added.
-- Memory semantics belong in `src/memory.ts` and the base lifecycle in
-  `src/agent.ts`. Do not invent parallel persistence paths in downstream apps.
-
-## Generated And Derived Files
-
-- Treat future `dist/` output from `tsup` as derived build output.
-- Do not hand-edit temporary runtime logs, cached memory snapshots, or ad hoc
-  generated provider metadata.
-- If public runtime behavior changes, update the source files above and rebuild
-  rather than patching emitted output.
-
-## Validation
-
-- Public API, routing, tool, or lifecycle changes:
-  `pnpm --filter @nebutra/agents test`
-- Export, type, or provider-surface changes:
-  `pnpm --filter @nebutra/agents typecheck`

package/CHANGELOG.md

@@ -1,36 +0,0 @@
-# @nebutra/agents
-
-## 1.1.1
-
-### Patch Changes
-
-- Publish registry package metadata under the MIT license.
-
-- Updated dependencies []:
-  - @nebutra/billing@0.1.2
-  - @nebutra/cache@0.0.2
-  - @nebutra/logger@0.1.1
-
-## 1.1.0
-
-### Minor Changes
-
-- [`092a1ce`](https://github.com/Nebutra/Nebutra-Sailor/commit/092a1ce810965e2d81767642e4bad05b80df81f4) Thanks [@TsekaLuk](https://github.com/TsekaLuk)! - Add the Atelier agentic creative-canvas capability.
-  - `@nebutra/agents`: new image/video **generation modality**
-    (`@nebutra/agents/generation`) on the same env-key-gated provider layer as
-    the LLM fallback chain, with a deterministic always-available mock provider.
-  - `@nebutra/atelier-canvas`: new package — server-authoritative non-overlap
-    placement, persist-then-broadcast consistency, per-`(tenant,canvas)`
-    serialization, tenant-scoped store (in-memory + Prisma adapter). The
-    `./agent` subpath adds the creative-direction prompt strategy + generation
-    tool + `AgentConfig` factory (optional `@nebutra/agents` peer).
-  - `@nebutra/feature-flags`: new `FLAGS.ATELIER_CANVAS` (off by default).
-
-  Additive `AtelierCanvas` Prisma model. A flag-gated `/atelier` demo route in
-  `apps/web` exercises the loop end-to-end with the mock provider (no AI key
-  required).
-
-### Patch Changes
-
-- Updated dependencies [[`5d3d7e6`](https://github.com/Nebutra/Nebutra-Sailor/commit/5d3d7e6c59cae5aa242bb988b75a9888cfd0db39)]:
-  - @nebutra/billing@0.1.1

package/dist/chunk-5JZJ5KMC.js

@@ -1,37 +0,0 @@
-// src/sdk/models.ts
-var models = {
-  /** High-quality reasoning — default for complex tasks */
-  flagship: "anthropic/claude-sonnet-4",
-  /** Deep reasoning for architecture and research */
-  reasoning: "anthropic/claude-opus-4",
-  /** Fast + cheap — chat, summaries, classification */
-  fast: "anthropic/claude-haiku-4",
-  /** OpenAI flagship */
-  "openai-flagship": "openai/gpt-5.4",
-  /** Google flagship */
-  "google-flagship": "google/gemini-2.5-pro",
-  /** Google fast */
-  "google-fast": "google/gemini-2.5-flash",
-  /** Embedding model */
-  embedding: "openai/text-embedding-3-small",
-  /** Embedding model (high-dimensional) */
-  "embedding-large": "openai/text-embedding-3-large",
-  // --- SiliconFlow presets (use with provider: "siliconflow") ---
-  /** SiliconFlow — Qwen 2.5 72B (flagship open-source) */
-  "sf-qwen": "Qwen/Qwen2.5-72B-Instruct",
-  /** SiliconFlow — DeepSeek R1 reasoning (via SiliconFlow Pro) */
-  "sf-deepseek-r1": "Pro/deepseek-ai/DeepSeek-R1",
-  /** SiliconFlow — DeepSeek V3 (fast, capable) */
-  "sf-deepseek-v3": "deepseek-ai/DeepSeek-V3"
-};
-function resolveModel(modelOrPreset) {
-  if (modelOrPreset in models) {
-    return models[modelOrPreset];
-  }
-  return modelOrPreset;
-}
-
-export {
-  models,
-  resolveModel
-};

package/src/__tests__/cost-observability.test.ts

@@ -1,172 +0,0 @@
-/**
- * Cost & observability primitives:
- * - Anthropic prompt cache control wiring
- * - Multi-provider fallback chain on retryable errors
- * - Langfuse no-op when env missing
- */
-
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-
-import { _resetAgentsEnvCache } from "../env";
-import {
-  buildSystemWithCache,
-  isRetryableError,
-  runWithFallback,
-  withAnthropicCacheControl,
-} from "../fallback";
-import { _resetLangfuseCache, buildTelemetryConfig, initLangfuse } from "../observability";
-
-describe("withAnthropicCacheControl()", () => {
-  it("returns ephemeral cache control under the anthropic provider key", () => {
-    const opts = withAnthropicCacheControl();
-    expect(opts.anthropic.cacheControl.type).toBe("ephemeral");
-  });
-
-  it("wraps a system prompt with cache-control providerOptions", () => {
-    const wrapped = buildSystemWithCache("You are a helpful assistant.");
-    expect(wrapped.role).toBe("system");
-    expect(wrapped.content).toBe("You are a helpful assistant.");
-    expect(wrapped.providerOptions.anthropic.cacheControl.type).toBe("ephemeral");
-  });
-});
-
-describe("isRetryableError()", () => {
-  it.each([429, 500, 502, 503, 504, 408])("marks status %i as retryable", (statusCode: number) => {
-    expect(isRetryableError({ statusCode })).toBe(true);
-  });
-
-  it("marks ECONNRESET / ETIMEDOUT as retryable", () => {
-    expect(isRetryableError({ code: "ECONNRESET" })).toBe(true);
-    expect(isRetryableError({ code: "ETIMEDOUT" })).toBe(true);
-  });
-
-  it("marks 4xx auth/validation errors as non-retryable", () => {
-    expect(isRetryableError({ statusCode: 401 })).toBe(false);
-    expect(isRetryableError({ statusCode: 403 })).toBe(false);
-    expect(isRetryableError({ statusCode: 400 })).toBe(false);
-  });
-
-  it("returns false for null / undefined / non-objects", () => {
-    expect(isRetryableError(null)).toBe(false);
-    expect(isRetryableError(undefined)).toBe(false);
-    expect(isRetryableError("oops")).toBe(false);
-  });
-
-  it("respects an explicit isRetryable=true flag (AI SDK APICallError)", () => {
-    expect(isRetryableError({ isRetryable: true })).toBe(true);
-  });
-});
-
-describe("runWithFallback()", () => {
-  beforeEach(() => {
-    _resetAgentsEnvCache();
-    // Provide stub keys so buildModel() doesn't throw before invoke() runs.
-    vi.stubEnv("OPENROUTER_API_KEY", "test-or");
-    vi.stubEnv("ANTHROPIC_API_KEY", "test-an");
-    vi.stubEnv("OPENAI_API_KEY", "test-oa");
-  });
-
-  afterEach(() => {
-    vi.unstubAllEnvs();
-  });
-
-  it("falls through retryable errors and returns the next provider's result", async () => {
-    let calls = 0;
-    const result = await runWithFallback(
-      async () => {
-        calls += 1;
-        if (calls === 1) {
-          // simulate primary provider 503
-          const err = Object.assign(new Error("Service Unavailable"), {
-            statusCode: 503,
-          });
-          throw err;
-        }
-        return "ok-from-fallback" as const;
-      },
-      {
-        chain: ["openrouter", "anthropic"],
-        // Stub buildModel by injecting fake creds via env
-        model: "flagship",
-      },
-    );
-
-    expect(result.result).toBe("ok-from-fallback");
-    expect(result.attempts).toBe(2);
-    expect(result.provider).toBe("anthropic");
-  });
-
-  it("rethrows non-retryable errors immediately (no fallback)", async () => {
-    let calls = 0;
-    await expect(
-      runWithFallback(
-        async () => {
-          calls += 1;
-          throw Object.assign(new Error("Unauthorized"), { statusCode: 401 });
-        },
-        { chain: ["openrouter", "anthropic"] },
-      ),
-    ).rejects.toThrow(/Unauthorized/);
-    expect(calls).toBe(1);
-  });
-
-  it("throws an aggregate error when the entire chain fails with retryables", async () => {
-    await expect(
-      runWithFallback(
-        async () => {
-          throw Object.assign(new Error("503"), { statusCode: 503 });
-        },
-        { chain: ["openrouter", "anthropic", "openai"] },
-      ),
-    ).rejects.toThrow(/All LLM providers in fallback chain/);
-  });
-});
-
-describe("Langfuse telemetry — no-op when env missing", () => {
-  beforeEach(() => {
-    _resetLangfuseCache();
-    _resetAgentsEnvCache();
-    vi.unstubAllEnvs();
-    vi.stubEnv("LANGFUSE_PUBLIC_KEY", "");
-    vi.stubEnv("LANGFUSE_SECRET_KEY", "");
-  });
-
-  afterEach(() => {
-    vi.unstubAllEnvs();
-    _resetLangfuseCache();
-    _resetAgentsEnvCache();
-  });
-
-  it("initLangfuse() returns null when keys missing", async () => {
-    const client = await initLangfuse();
-    expect(client).toBeNull();
-  });
-
-  it("buildTelemetryConfig() returns isEnabled=false when keys missing", () => {
-    const cfg = buildTelemetryConfig({ functionId: "test-fn" });
-    expect(cfg.isEnabled).toBe(false);
-    expect(cfg.functionId).toBeUndefined();
-  });
-
-  it("buildTelemetryConfig() includes tenant/session metadata when configured", () => {
-    vi.stubEnv("LANGFUSE_PUBLIC_KEY", "pk-test");
-    vi.stubEnv("LANGFUSE_SECRET_KEY", "sk-test");
-    _resetAgentsEnvCache();
-
-    const cfg = buildTelemetryConfig({
-      functionId: "agent.support-bot",
-      metadata: {
-        tenantId: "org_123",
-        userId: "user_456",
-        sessionId: "conv_789",
-        agentId: "support-bot",
-      },
-    });
-
-    expect(cfg.isEnabled).toBe(true);
-    expect(cfg.functionId).toBe("agent.support-bot");
-    expect(cfg.metadata?.tenantId).toBe("org_123");
-    expect(cfg.metadata?.langfuseUserId).toBe("org_123");
-    expect(cfg.metadata?.langfuseSessionId).toBe("conv_789");
-  });
-});