@nebutra/agents 2.0.0 → 3.0.0

package/README.md

@@ -67,7 +67,7 @@ orchestrator.registerAgent(
   new VercelAIAgent({ id: "assistant", name: "Assistant", description: "Helpful", model: "openai/gpt-5.5", instructions: "..." }),
 );
 
-const ctx = createAgentContext("org_123", "user_456");
+const ctx = createAgentContext({ tenantId: "org_123", product: "app" }, "user_456");
 const response = await orchestrator.chat("Hello", ctx);
 // → response.usage tracks tokens for billing
 ```

package/dist/{agent-DDGWuUpe.d.ts → agent-DyyFxZf-.d.ts}

@@ -1,4 +1,4 @@
-import { c as AgentConfig, A as AgentMessage, a as AgentContext, b as AgentResponse } from './types-BytC-HfQ.js';
+import { c as AgentConfig, A as AgentMessage, a as AgentContext, b as AgentResponse } from './types-CRbPsTpE.js';
 
 /**
  * BaseAgent — abstract agent with memory, usage tracking, and tenant scoping.

package/dist/{chunk-RDOFKRI6.js → chunk-HAAM3SJN.js}

@@ -107,6 +107,7 @@ var BaseAgent = class {
     const durationMs = Date.now() - startTime;
     const usage = {
       tenantId: context.tenantId,
+      product: context.product,
       userId: context.userId,
       agentId: this.config.id,
       model: this.config.model,
@@ -145,6 +146,7 @@ var BaseAgent = class {
       const creditCost = Math.max(1, Math.ceil(totalTokens / 1e4));
       await deductCredits({
         organizationId: event.tenantId,
+        product: event.product,
         amount: creditCost,
         description: `Agent execution: ${event.model}`
       });

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-import { B as BaseAgent } from './agent-DDGWuUpe.js';
+import { B as BaseAgent } from './agent-DyyFxZf-.js';
 export { AgentsEnv, AgentsEnvSchema, FallbackProviderName, getAgentsEnv, isLangfuseConfigured } from './env.js';
 export { CreateFallbackModelOptions, EmbeddingFallbackOptions, FallbackResult, buildSystemWithCache, filterAvailableProviders, isRetryableError, runEmbedWithFallback, runWithFallback, withAnthropicCacheControl } from './fallback.js';
 export { GenerationCallOptions, GenerationContext, GenerationModality, GenerationProvider, GenerationResult, ImageGenerationRequest, VideoGenerationRequest, _resetGenerationRegistry, generateImage, generateVideo, listGenerationProviders, mockGenerationProvider, registerGenerationProvider } from './generation/index.js';
-import { A as AgentMessage, O as OrchestratorConfig, a as AgentContext, b as AgentResponse, R as RouterConfig, c as AgentConfig } from './types-BytC-HfQ.js';
-export { d as AgentTool, e as AgentUsageEvent, M as MemoryConfig, T as TokenUsage, f as ToolCallResult } from './types-BytC-HfQ.js';
+import { A as AgentMessage, O as OrchestratorConfig, a as AgentContext, b as AgentResponse, R as RouterConfig, c as AgentConfig } from './types-CRbPsTpE.js';
+export { d as AgentTool, e as AgentUsageEvent, M as MemoryConfig, T as TokenUsage, f as ToolCallResult } from './types-CRbPsTpE.js';
 export { TelemetryMetadata, buildTelemetryConfig, flushTelemetry, initLangfuse } from './observability.js';
 export { EmbedOptions, GenerateOptions, GenerateStructuredResult, OPENAI_MAX_PROPERTY_NAME_LENGTH, assertSafeOpenAIJsonPayload, configure, embed, embedMany, findOversizedPropertyName, generateStructured, generateText, getConfig, streamText, validateStructured } from './sdk/index.js';
 export { BUILT_IN_TOOLS, databaseQueryTool, knowledgeBaseTool, webSearchTool } from './tools.js';
@@ -153,15 +153,21 @@ declare class AgentRouter {
 /**
  * Create a fully-populated AgentContext.
  * Generates a random conversationId when none is provided.
+ *
+ * `scope` names the tenant and the product whose balance the run spends:
+ * balances are per product, so a run cannot be billed without one.
  */
-declare function createAgentContext(tenantId: string, userId: string, conversationId?: string, metadata?: Record<string, unknown>): AgentContext;
+declare function createAgentContext(scope: {
+    tenantId: string;
+    product: string;
+}, userId: string, conversationId?: string, metadata?: Record<string, unknown>): AgentContext;
 /**
  * Validate that a tenant has remaining quota for agent execution.
  *
  * Returns `{ allowed: true, remaining: -1 }` (unlimited) by default.
  * Integrate with @nebutra/billing entitlements for production usage.
  */
-declare function checkAgentQuota(tenantId: string): Promise<{
+declare function checkAgentQuota(tenantId: string, product: string): Promise<{
     allowed: boolean;
     remaining: number;
 }>;

package/dist/index.js

@@ -62,7 +62,7 @@ import {
   clearMemory,
   getMemory,
   saveMemory
-} from "./chunk-RDOFKRI6.js";
+} from "./chunk-HAAM3SJN.js";
 
 // src/context.ts
 var MAX_BIO_CHARS = 2e3;
@@ -229,18 +229,19 @@ ${agentList}`,
 };
 
 // src/tenant.ts
-function createAgentContext(tenantId, userId, conversationId, metadata) {
+function createAgentContext(scope, userId, conversationId, metadata) {
   return {
-    tenantId,
+    tenantId: scope.tenantId,
+    product: scope.product,
     userId,
     conversationId: conversationId ?? crypto.randomUUID(),
     ...metadata !== void 0 ? { metadata } : {}
   };
 }
-async function checkAgentQuota(tenantId) {
+async function checkAgentQuota(tenantId, product) {
   try {
     const { getCreditBalance } = await import("@nebutra/billing/credits");
-    const balance = await getCreditBalance(tenantId);
+    const balance = await getCreditBalance(tenantId, product);
     if (balance.balance > 0) {
       return { allowed: true, remaining: balance.balance };
     }
@@ -276,7 +277,7 @@ var AgentOrchestrator = class {
   }
   /** Route a message to the best agent and execute. */
   async chat(message, context) {
-    await this.assertQuota(context.tenantId);
+    await this.assertQuota(context.tenantId, context.product);
     const agentConfigs = [...this.agents.values()].map((a) => a.config);
     const agentId = await this.router.route(message, agentConfigs, context, this.defaultAgentId);
     const agent = this.agents.get(agentId);
@@ -287,8 +288,8 @@ var AgentOrchestrator = class {
     return agent.run(messages, context);
   }
   /** Check tenant quota before execution. */
-  async assertQuota(tenantId) {
-    const { allowed } = await checkAgentQuota(tenantId);
+  async assertQuota(tenantId, product) {
+    const { allowed } = await checkAgentQuota(tenantId, product);
     if (!allowed) {
       throw new Error(`Tenant "${tenantId}" has exceeded agent execution quota`);
     }

package/dist/providers/langchain.d.ts

@@ -1,5 +1,5 @@
-import { B as BaseAgent } from '../agent-DDGWuUpe.js';
-import { c as AgentConfig } from '../types-BytC-HfQ.js';
+import { B as BaseAgent } from '../agent-DyyFxZf-.js';
+import { c as AgentConfig } from '../types-CRbPsTpE.js';
 
 /**
  * LangChain.js agent adapter — stub.

package/dist/providers/langchain.js

@@ -1,6 +1,6 @@
 import {
   BaseAgent
-} from "../chunk-RDOFKRI6.js";
+} from "../chunk-HAAM3SJN.js";
 
 // src/providers/langchain.ts
 var LangChainAgent = class extends BaseAgent {

package/dist/providers/vercel-ai.d.ts

@@ -1,5 +1,5 @@
-import { B as BaseAgent } from '../agent-DDGWuUpe.js';
-import { A as AgentMessage, a as AgentContext, b as AgentResponse } from '../types-BytC-HfQ.js';
+import { B as BaseAgent } from '../agent-DyyFxZf-.js';
+import { A as AgentMessage, a as AgentContext, b as AgentResponse } from '../types-CRbPsTpE.js';
 
 /**
  * Vercel AI SDK agent adapter.

package/dist/providers/vercel-ai.js

@@ -12,7 +12,7 @@ import "../chunk-HVLFZW6E.js";
 import "../chunk-FCXWOXII.js";
 import {
   BaseAgent
-} from "../chunk-RDOFKRI6.js";
+} from "../chunk-HAAM3SJN.js";
 
 // src/providers/vercel-ai.ts
 var VercelAIAgent = class extends BaseAgent {

package/dist/tools.d.ts

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

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

@@ -30,6 +30,8 @@ interface AgentTool {
 }
 interface AgentContext {
     readonly tenantId: string;
+    /** The product whose balance pays for this run (ADR 2026-09-27 product wallets). */
+    readonly product: string;
     readonly userId: string;
     readonly conversationId: string;
     readonly metadata?: Record<string, unknown>;
@@ -75,6 +77,7 @@ interface RouterConfig {
 }
 interface AgentUsageEvent {
     readonly tenantId: string;
+    readonly product: string;
     readonly userId: string;
     readonly agentId: string;
     readonly model: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nebutra/agents",
-  "version": "2.0.0",
+  "version": "3.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",
@@ -86,9 +86,9 @@
     "langfuse": "^3.38.20",
     "langfuse-vercel": "^3.38.20",
     "zod": "^4.3.6",
-    "@nebutra/billing": "2.0.0",
-    "@nebutra/cache": "2.0.0",
-    "@nebutra/logger": "2.0.0"
+    "@nebutra/billing": "3.0.0",
+    "@nebutra/cache": "3.0.0",
+    "@nebutra/logger": "3.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",